@dxtmisha/wiki 0.25.1 → 0.39.2

package/src/media/functional/scripts/classes/DesignTypes/DesignTypes.ru.mdx

@@ -0,0 +1,50 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Classes/DesignTypes - Генератор типов для ИИ'/>
+
+# Класс DesignTypes
+
+Класс `DesignTypes` — это специализированная утилита, предназначенная для сокращения разрыва между сложными определениями типов в коде и ИИ-помощниками по кодированию. Она автоматизирует извлечение, очистку и сжатие файлов деклараций TypeScript (`.d.ts`), используя ИИ для создания гипер-минималистичной версии системы типов проекта, которая обеспечивает максимальный контекст при минимальном потреблении токенов.
+
+## Ключевые особенности
+
+- **Автоматическое обнаружение** — рекурсивно сканирует директории сборки для поиска релевантных файлов деклараций типов.
+- **Интеллектуальная фильтрация** — автоматически исключает внутренние пропсы конструкторов и второстепенные типы логики, сохраняя публичные API.
+- **Сжатие на базе ИИ** — использует промпты LLM для удаления ненужных метаданных (импортов, комментариев, пустых строк) и консолидации определений.
+- **Единый вывод** — объединяет несколько фрагментированных файлов деклараций в одну связную библиотеку типов.
+- **Оптимизация контекста** — приоритизирует интерфейсы, перечисления и алиасы типов, наиболее важные для понимания ИИ.
+
+## Инициализация
+
+Инициализируйте генератор, указав исходную директорию, где расположены скомпилированные файлы деклараций.
+
+**Параметры:**
+- `dir: string` — путь к входной директории (по умолчанию `'dist'`).
+
+```typescript
+import { DesignTypes } from '@dxtmisha/scripts'
+
+const generator = new DesignTypes('packages/core/dist')
+generator.make()
+```
+
+## Методы
+
+### Управление
+
+- `make(): void` — запускает полный конвейер генерации: обнаружение, объединение, обработку ИИ и сохранение.
+
+## Операции
+
+### Конвейер генерации типов
+
+При выполнении `make()` класс координирует многоэтапный рабочий процесс:
+1. **Фильтрация файлов (`getListByFilter`)**: движок сканирует директорию на наличие файлов `.d.ts`, отфильтровывая детали внутренней реализации, такие как `props.d.ts` или `types.d.ts` внутри папок конструкторов.
+2. **Валидация контента (`isContent`)**: проверяет, что каждый файл действительно содержит значимые определения типов (интерфейсы, типы или перечисления) перед обработкой.
+3. **Консолидация (`toOneFile`)**: содержимое всех идентифицированных файлов объединяется в одну большую строку, помеченную путями к оригинальным файлам для контекста.
+4. **Трансформация ИИ (`toAiEdit`)**: объединенный контент отправляется ИИ-помощнику со специфическими инструкциями по удалению шаблонного кода, неанглийских комментариев и минимизации синтаксиса.
+5. **Сохранение (`save`)**: финальная библиотека типов высокой плотности сохраняется по настроенному пути вывода (обычно указанному в `UI_FILE_AI_TYPES`).
+
+### Кейс: Внедрение контекста для ИИ
+
+Основная цель этого класса — создание «артефакта знаний», который может быть внедрен в системный промпт LLM, работающих над проектом. Предоставляя чистый, сжатый обзор всех доступных типов и интерфейсов, ИИ может писать типобезопасный код и понимать архитектуру компонентов с значительно более высокой точностью и меньшими затратами.

package/src/media/functional/scripts/classes/DesignTypes/DesignTypes.vi.mdx

@@ -0,0 +1,50 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Classes/DesignTypes - Trình tạo kiểu AI'/>
+
+# Lớp DesignTypes
+
+Lớp `DesignTypes` là một tiện ích chuyên dụng được thiết kế để thu hẹp khoảng cách giữa các định nghĩa kiểu (type definitions) phức tạp trong mã nguồn và các trợ lý lập trình AI. Nó tự động hóa việc trích xuất, làm sạch và nén các tệp khai báo TypeScript (`.d.ts`), sử dụng AI để tạo ra phiên bản cực kỳ tối giản của hệ thống kiểu trong dự án, cung cấp ngữ cảnh tối đa với mức tiêu thụ token tối thiểu.
+
+## Các tính năng chính
+
+- **Khám phá tự động** — Quét đệ quy các thư mục phân phối để tìm các tệp khai báo kiểu có liên quan.
+- **Lọc thông minh** — Tự động loại trừ các props constructor nội bộ và các kiểu logic không thiết yếu trong khi vẫn giữ lại các API công khai.
+- **Nén dựa trên AI** — Sử dụng các gợi ý LLM để loại bỏ siêu dữ liệu không cần thiết (imports, chú thích tiếng Nga, dòng trống) и hợp nhất các định nghĩa.
+- **Đầu ra thống nhất** — Kết hợp nhiều tệp khai báo rời rạc thành một thư viện kiểu gắn kết duy nhất.
+- **Tối ưu hóa ngữ cảnh** — Ưu tiên các interfaces, enums và type aliases quan trọng nhất đối với sự hiểu biết của AI.
+
+## Khởi tạo
+
+Khởi tạo trình tạo bằng cách chỉ định thư mục nguồn nơi đặt các tệp khai báo đã biên dịch.
+
+**Tham số:**
+- `dir: string` — Đường dẫn đến thư mục đầu vào (mặc định là `'dist'`).
+
+```typescript
+import { DesignTypes } from '@dxtmisha/scripts'
+
+const generator = new DesignTypes('packages/core/dist')
+generator.make()
+```
+
+## Các phương thức
+
+### Điều khiển
+
+- `make(): void` — Bắt đầu toàn bộ quy trình tạo: khám phá, kết hợp, xử lý AI và lưu trữ.
+
+## Các thao tác (Operations)
+
+### Quy trình tạo kiểu (Type Generation Pipeline)
+
+Khi `make()` được thực thi, lớp sẽ điều phối một quy trình làm việc gồm nhiều giai đoạn:
+1. **Lọc tệp (`getListByFilter`)**: Động cơ quét thư mục để tìm các tệp `.d.ts`, lọc ra các chi tiết triển khai nội bộ như `props.d.ts` hoặc `types.d.ts` bên trong các thư mục constructor.
+2. **Xác thực nội dung (`isContent`)**: Nó xác minh rằng mỗi tệp thực sự chứa các định nghĩa kiểu có ý nghĩa (interfaces, types hoặc enums) trước khi xử lý.
+3. **Hợp nhất (`toOneFile`)**: Tất cả nội dung tệp được xác định sẽ được hợp nhất thành một chuỗi lớn duy nhất, được gắn thẻ với đường dẫn tệp gốc để cung cấp ngữ cảnh.
+4. **Chuyển đổi AI (`toAiEdit`)**: Nội dung đã hợp nhất được gửi đến trợ lý AI với các hướng dẫn cụ thể để loại bỏ mã mẫu (boilerplate), xóa các chú thích không phải tiếng Anh và tối thiểu hóa cú pháp.
+5. **Lưu trữ (`save`)**: Thư viện kiểu mật độ cao cuối cùng được lưu vào đường dẫn đầu ra đã định cấu hình (thường được chỉ định trong `UI_FILE_AI_TYPES`).
+
+### Trường hợp sử dụng: Tiêm ngữ cảnh AI
+
+Mục tiêu chính của lớp này là tạo ra một "kiến thức nhân tạo" có thể được tiêm vào hệ thống prompt của các LLM đang làm việc trong dự án. Bằng cách cung cấp một cái nhìn tổng quan sạch sẽ, cô đọng về tất cả các kiểu và interface có sẵn, AI có thể viết mã an toàn về kiểu (type-safe) và hiểu kiến trúc thành phần với độ chính xác cao hơn đáng kể và chi phí thấp hơn.

package/src/media/functional/scripts/classes/DesignTypescript/DesignTypescript.en.mdx

@@ -0,0 +1,55 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Classes/DesignTypescript - Type Metadata Analyzer'/>
+
+# DesignTypescript Class
+
+The `DesignTypescript` class provides a high-level wrapper around the TypeScript Compiler API, allowing programmatic analysis of source code metadata. It specializes in extracting structured information from interfaces and type aliases, making it an essential tool for generating documentation, validation schemas, or optimized type definitions for AI assistants.
+
+## Key Features
+
+- **Compiler API Integration** — Seamlessly interacts with TypeScript's internal program and type checker.
+- **Deep Type Extraction** — Resolves complex property types, literal unions, and optionality.
+- **Documentation Retrieval** — Automatically extracts JSDoc comments to preserve developer-written context.
+- **AST-Aware Parsing** — Navigates the Abstract Syntax Tree (AST) to reliably identify interfaces and type declarations.
+- **Literal Value Discovery** — Intelligently broadens literal unions into usable string/number options.
+
+## Initialization
+
+Initialize the analyzer by providing the path to a TypeScript source file. You can also specify custom compiler options to match your project's environment.
+
+**Parameters:**
+- `path: string` — The absolute or relative path to the `.ts` file (default is `''`).
+- `options: ts.CompilerOptions` — Optional TypeScript compiler configuration (default is `{}`).
+
+```typescript
+import { DesignTypescript } from '@dxtmisha/scripts'
+
+const analyzer = new DesignTypescript('src/types/component.ts')
+const types = analyzer.getTypes()
+```
+
+## Methods
+
+### Data Acquisition
+
+- `getTypes(): DesignTypescriptList` — Scans the source file and returns an array of all detected type and interface metadata.
+- `getType(name: string): DesignTypescriptItem | undefined` — Retrieves metadata for a specific type or interface by its name.
+
+## Operations
+
+### The Metadata Analysis Workflow
+
+When analyzing a file, `DesignTypescript` performs the following steps:
+1. **Program Creation**: It initializes a TypeScript Program and Type Checker for the specified file.
+2. **Node Traversal**: It visits every node in the AST, specifically seeking `TypeAliasDeclaration` and `InterfaceDeclaration` nodes.
+3. **Property Resolution**: For each identified type, it queries the Type Checker to retrieve its properties (even those inherited).
+4. **Information Synthesis**: For every property, it builds a metadata object containing:
+    - **Name**: The property identifier.
+    - **Type**: A clean string representation of the type (e.g., `'string | number'`).
+    - **Options**: If the property is a literal union, it extracts the actual values.
+    - **Description**: The associated JSDoc comment.
+
+### Role in the Toolchain
+
+This class is frequently used by other generators (like `DesignTypes` or `DesignCommand`) to bridge the gap between static code and dynamic logic. By providing a clean API to the complex TypeScript Compiler, it allows the design system to remain "type-aware" across all its automated processes.

package/src/media/functional/scripts/classes/DesignTypescript/DesignTypescript.ru.mdx

@@ -0,0 +1,55 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Classes/DesignTypescript - Анализатор метаданных типов'/>
+
+# Класс DesignTypescript
+
+Класс `DesignTypescript` предоставляет высокоуровневую обертку вокруг TypeScript Compiler API, позволяя программно анализировать метаданные исходного кода. Он специализируется на извлечении структурированной информации из интерфейсов и псевдонимов типов, что делает его важным инструментом для генерации документации, схем валидации или оптимизированных определений типов для ИИ-помощников.
+
+## Ключевые особенности
+
+- **Интеграция с Compiler API** — бесшовное взаимодействие с внутренней программой и средством проверки типов TypeScript.
+- **Глубокое извлечение типов** — разрешает сложные типы свойств, литеральные объединения и опциональность.
+- **Получение документации** — автоматически извлекает комментарии JSDoc для сохранения контекста, написанного разработчиком.
+- **AST-парсинг** — перемещается по абстрактному синтаксическому дереву (AST) для надежной идентификации интерфейсов и объявлений типов.
+- **Обнаружение литеральных значений** — интеллектуально расширяет литеральные объединения в используемые строковые или числовые опции.
+
+## Инициализация
+
+Инициализируйте анализатор, указав путь к исходному файлу TypeScript. Вы также можете указать пользовательские опции компилятора в соответствии с окружением вашего проекта.
+
+**Параметры:**
+- `path: string` — абсолютный или относительный путь к файлу `.ts` (по умолчанию `''`).
+- `options: ts.CompilerOptions` — необязательная конфигурация компилятора TypeScript (по умолчанию `{}`).
+
+```typescript
+import { DesignTypescript } from '@dxtmisha/scripts'
+
+const analyzer = new DesignTypescript('src/types/component.ts')
+const types = analyzer.getTypes()
+```
+
+## Методы
+
+### Получение данных
+
+- `getTypes(): DesignTypescriptList` — сканирует исходный файл и возвращает массив метаданных всех обнаруженных типов и интерфейсов.
+- `getType(name: string): DesignTypescriptItem | undefined` — получает метаданные для конкретного типа или интерфейса по его имени.
+
+## Операции
+
+### Рабочий процесс анализа метаданных
+
+При анализе файла `DesignTypescript` выполняет следующие шаги:
+1. **Создание программы**: инициализирует программу TypeScript и Type Checker для указанного файла.
+2. **Обход узлов**: посещает каждый узел в AST, специально разыскивая узлы `TypeAliasDeclaration` и `InterfaceDeclaration`.
+3. **Разрешение свойств**: для каждого идентифицированного типа опрашивает Type Checker для получения его свойств (включая наследуемые).
+4. **Синтез информации**: для каждого свойства строит объект метаданных, содержащий:
+    - **Name**: идентификатор свойства.
+    - **Type**: чистое строковое представление типа (например, `'string | number'`).
+    - **Options**: если свойство является литеральным объединением, извлекает фактические значения.
+    - **Description**: связанный комментарий JSDoc.
+
+### Роль в инструментарии
+
+Этот класс часто используется другими генераторами (такими как `DesignTypes` или `DesignCommand`) для преодоления разрыва между статическим кодом и динамической логикой. Предоставляя чистый API к сложному компилятору TypeScript, он позволяет дизайн-системе оставаться «знающей типы» во всех её автоматизированных процессах.

package/src/media/functional/scripts/classes/DesignTypescript/DesignTypescript.vi.mdx

@@ -0,0 +1,55 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Classes/DesignTypescript - Bộ phân tích siêu dữ liệu kiểu'/>
+
+# Lớp DesignTypescript
+
+Lớp `DesignTypescript` cung cấp một lớp bọc cấp cao xung quanh TypeScript Compiler API, cho phép phân tích theo chương trình các siêu dữ liệu của mã nguồn. Nó chuyên trích xuất thông tin có cấu trúc từ các interface và type alias, làm cho nó trở thành một công cụ thiết yếu để tạo tài liệu, lược đồ xác thực hoặc các định nghĩa kiểu được tối ưu hóa cho các trợ lý AI.
+
+## Các tính năng chính
+
+- **Tích hợp Compiler API** — Tương tác liền mạch với chương trình nội bộ và trình kiểm tra kiểu (type checker) của TypeScript.
+- **Trích xuất kiểu sâu** — Phân giải các kiểu thuộc tính phức tạp, literal unions và tính tùy chọn (optionality).
+- **Truy xuất tài liệu** — Tự động trích xuất các chú thích JSDoc để duy trì ngữ cảnh do nhà phát triển viết.
+- **Phân tích cú pháp dựa trên AST** — Điều hướng Cây Cú pháp Trừu tượng (AST) để xác định chính xác các interfaces và khai báo kiểu.
+- **Khám phá giá trị Literal** — Mở rộng các literal unions một cách thông minh thành các tùy chọn chuỗi/số có thể sử dụng.
+
+## Khởi tạo
+
+Khởi tạo bộ phân tích bằng cách cung cấp đường dẫn đến tệp nguồn TypeScript. Bạn cũng có thể chỉ định các tùy chọn trình biên dịch tùy chỉnh để phù hợp với môi trường dự án của mình.
+
+**Tham số:**
+- `path: string` — Đường dẫn tuyệt đối hoặc tương đối đến tệp `.ts` (mặc định là `''`).
+- `options: ts.CompilerOptions` — Cấu hình trình biên dịch TypeScript tùy chọn (mặc định là `{}`).
+
+```typescript
+import { DesignTypescript } from '@dxtmisha/scripts'
+
+const analyzer = new DesignTypescript('src/types/component.ts')
+const types = analyzer.getTypes()
+```
+
+## Các phương thức
+
+### Thu thập dữ liệu
+
+- `getTypes(): DesignTypescriptList` — Quét tệp nguồn và trả về một mảng siêu dữ liệu của tất cả các kiểu và interface được phát hiện.
+- `getType(name: string): DesignTypescriptItem | undefined` — Truy xuất siêu dữ liệu cho một kiểu hoặc interface cụ thể theo tên của nó.
+
+## Các thao tác (Operations)
+
+### Quy trình phân tích siêu dữ liệu
+
+Khi phân tích một tệp, `DesignTypescript` thực hiện các bước sau:
+1. **Tạo chương trình**: Nó khởi tạo một TypeScript Program và Type Checker cho tệp đã chỉ định.
+2. **Duyệt qua các nút**: Nó truy cập mọi nút trong AST, đặc biệt tìm kiếm các nút `TypeAliasDeclaration` và `InterfaceDeclaration`.
+3. **Phân giải thuộc tính**: Đối với mỗi kiểu được xác định, nó truy vấn Type Checker để lấy các thuộc tính của nó (ngay cả những thuộc tính được kế thừa).
+4. **Tổng hợp thông tin**: Đối với mỗi thuộc tính, nó xây dựng một đối tượng siêu dữ liệu chứa:
+    - **Name**: Mã định danh thuộc tính.
+    - **Type**: Một biểu diễn chuỗi sạch của kiểu (ví dụ: `'string | number'`).
+    - **Options**: Nếu thuộc tính là một literal union, nó sẽ trích xuất các giá trị thực tế.
+    - **Description**: Chú thích JSDoc liên quan.
+
+### Vai trò trong chuỗi công cụ
+
+Lớp này thường được sử dụng bởi các trình tạo khác (như `DesignTypes` hoặc `DesignCommand`) để thu hẹp khoảng cách giữa mã tĩnh và logic động. Bằng cách cung cấp một API sạch cho TypeScript Compiler phức tạp, nó cho phép hệ thống thiết kế luôn "nhận biết kiểu" trong tất cả các quy trình tự động của nó.

package/src/media/functional/scripts/classes/DesignUi/DesignUi.en.mdx

@@ -0,0 +1,60 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Classes/DesignUi - UI Infrastructure Orchestrator'/>
+
+# DesignUi Class
+
+The `DesignUi` class is the central orchestrator responsible for initializing and synchronizing the entire infrastructure of the UI library. It coordinates high-level tasks such as rebuilding styles, generating documentation, updating component architectures, and configuring package distribution metadata.
+
+## Key Features
+
+- **Centralized Orchestration** — Manages the execution flow of multiple specialized generators (Styles, Wiki, Components).
+- **Incremental Initialization** — Supports initializing either a single specific component or the entire library suite.
+- **Cache Management** — Automatically purges property caches to ensure all generated assets use the latest design system tokens.
+- **Package Auto-Configuration** — Dynamically updates `package.json` export maps to reflect the current build state.
+- **Library-Level Synthesis** — Triggers global updates for plugins, media assets, and type definitions across the entire workspace.
+
+## Initialization
+
+Initialize the orchestrator by optionally providing a component name. If no name is provided, the class operates on all components found in the library.
+
+**Parameters:**
+- `name: string` — The identifier of a specific component to process (optional, default is `''`).
+
+```typescript
+import { DesignUi } from '@dxtmisha/scripts'
+
+// To update everything:
+const ui = new DesignUi()
+ui.make()
+
+// To update a specific component:
+const buttonUi = new DesignUi('button')
+buttonUi.make()
+```
+
+## Methods
+
+### Control
+
+- `make(): void` — Executes the full initialization pipeline, sequentially triggering all infrastructure updates.
+
+## Operations
+
+### The UI Initialization Pipeline
+
+When `make()` is called, `DesignUi` coordinates a comprehensive multi-stage update:
+1. **Environment Reset**: Clears the `PropertiesCache` to prevent stale tokens from affecting the new build.
+2. **Infrastructure Generation**: Triggers global `Styles` and `DesignWiki` generation to prepare the visual and documentation foundations.
+3. **Component Syncing**: Executes `DesignComponent` for the target component(s), resolving their structural metadata and generating source files.
+4. **Distribution Preparation**: Updates `package.json` with the latest export mappings for CSS, SCSS, and script modules.
+5. **Library Synthesis**: Sequentially triggers dedicated library-level generators:
+    - `LibraryMedia`: Synchronizes icon and flag assets.
+    - `LibraryList`: Compiles the component registry.
+    - `LibraryPlugin`: Rebuilds the Vue/framework integration plugins.
+    - `LibraryAiWiki`: Generates AI-optimized documentation artifacts.
+    - `LibraryTypes`: Compiles global type definitions.
+
+### Role in the Ecosystem
+
+`DesignUi` acts as the primary entry point for developers and automated build tools. By abstracting the complexity of dozen of specialized classes, it provides a stable "one-click" interface for keeping the UI library synchronized with the design system's evolving specifications.

package/src/media/functional/scripts/classes/DesignUi/DesignUi.ru.mdx

@@ -0,0 +1,60 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Classes/DesignUi - Оркестратор UI-инфраструктуры'/>
+
+# Класс DesignUi
+
+Класс `DesignUi` — это центральный оркестратор, отвечающий за инициализацию и синхронизацию всей инфраструктуры UI-библиотеки. Он координирует высокоуровневые задачи, такие как пересборка стилей, генерация документации, обновление архитектуры компонентов и настройка метаданных дистрибутива пакета.
+
+## Ключевые особенности
+
+- **Централизованная оркестрация** — управляет потоком выполнения нескольких специализированных генераторов (Styles, Wiki, Components).
+- **Инкрементальная инициализация** — поддерживает инициализацию как отдельного компонента, так и всего набора библиотеки.
+- **Управление кэшем** — автоматически очищает кэш свойств, гарантируя, что все сгенерированные ресурсы используют актуальные токены дизайн-системы.
+- **Автоматическая настройка пакета** — динамически обновляет карту экспорта в `package.json` для соответствия текущему состоянию сборки.
+- **Синтез на уровне библиотеки** — запускает глобальные обновления для плагинов, медиа-ресурсов и определений типов во всем рабочем пространстве.
+
+## Инициализация
+
+Инициализируйте оркестратор, при необходимости указав имя компонента. Если имя не указано, класс обрабатывает все компоненты, найденные в библиотеке.
+
+**Параметры:**
+- `name: string` — идентификатор конкретного компонента для обработки (необязательно, по умолчанию `''`).
+
+```typescript
+import { DesignUi } from '@dxtmisha/scripts'
+
+// Для обновления всего:
+const ui = new DesignUi()
+ui.make()
+
+// Для обновления конкретного компонента:
+const buttonUi = new DesignUi('button')
+buttonUi.make()
+```
+
+## Методы
+
+### Управление
+
+- `make(): void` — выполняет полный конвейер инициализации, последовательно запуская все обновления инфраструктуры.
+
+## Операции
+
+### Конвейер инициализации UI
+
+При вызове `make()` класс `DesignUi` координирует комплексное многоэтапное обновление:
+1. **Сброс окружения**: очищает `PropertiesCache` для предотвращения влияния устаревших токенов на новую сборку.
+2. **Генерация инфраструктуры**: запускает генерацию глобальных стилей (`Styles`) и вики («DesignWiki») для подготовки визуального и документального фундамента.
+3. **Синхронизация компонентов**: выполняет `DesignComponent` для целевых компонентов, разрешая их структурные метаданные и генерируя исходные файлы.
+4. **Подготовка к дистрибуции**: обновляет `package.json` актуальными маппингами экспорта для CSS, SCSS и модулей скриптов.
+5. **Библиотечный синтез**: последовательно запускает специализированные библиотечные генераторы:
+    - `LibraryMedia`: синхронизирует иконки и флаги.
+    - `LibraryList`: компилирует реестр компонентов.
+    - `LibraryPlugin`: пересобирает плагины интеграции с Vue/фреймворками.
+    - `LibraryAiWiki`: генерирует оптимизированные для ИИ артефакты документации.
+    - `LibraryTypes`: компилирует глобальные определения типов.
+
+### Роль в экосистеме
+
+`DesignUi` служит основной точкой входа для разработчиков и автоматизированных инструментов сборки. Абстрагируя сложность десятков специализированных классов, он предоставляет стабильный интерфейс «в один клик» для поддержания синхронизации UI-библиотеки с развивающимися спецификациями дизайн-системы.

package/src/media/functional/scripts/classes/DesignUi/DesignUi.vi.mdx

@@ -0,0 +1,60 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Classes/DesignUi - Bộ điều phối cơ sở hạ tầng UI'/>
+
+# Lớp DesignUi
+
+Lớp `DesignUi` là bộ điều phối trung tâm chịu trách nhiệm khởi tạo và đồng bộ hóa toàn bộ cơ sở hạ tầng của thư viện UI. Nó điều phối các tác vụ cấp cao như xây dựng lại kiểu dáng, tạo tài liệu, cập nhật kiến trúc thành phần và cấu hình siêu dữ liệu phân phối gói.
+
+## Các tính năng chính
+
+- **Điều phối tập trung** — Quản lý luồng thực thi của nhiều trình tạo chuyên biệt (Styles, Wiki, Components).
+- **Khởi tạo tăng dần** — Hỗ trợ khởi tạo một thành phần cụ thể hoặc toàn bộ bộ thư viện.
+- **Quản lý bộ nhớ đệm** — Tự động xóa bộ nhớ đệm thuộc tính để đảm bảo tất cả các tài sản được tạo ra đều sử dụng các token hệ thống thiết kế mới nhất.
+- **Tự động cấu hình gói** — Cập nhật động bản đồ xuất (export maps) trong `package.json` để phản ánh trạng thái xây dựng hiện tại.
+- **Tổng hợp cấp thư viện** — Kích hoạt các bản cập nhật toàn cục cho các plugin, tài sản truyền thông và định nghĩa kiểu trên toàn bộ không gian làm việc.
+
+## Khởi tạo
+
+Khởi tạo bộ điều phối bằng cách tùy chọn cung cấp tên thành phần. Nếu không có tên nào được cung cấp, lớp sẽ hoạt động trên tất cả các thành phần được tìm thấy trong thư viện.
+
+**Tham số:**
+- `name: string` — Mã định danh của một thành phần cụ thể cần xử lý (tùy chọn, mặc định là `''`).
+
+```typescript
+import { DesignUi } from '@dxtmisha/scripts'
+
+// Để cập nhật mọi thứ:
+const ui = new DesignUi()
+ui.make()
+
+// Để cập nhật một thành phần cụ thể:
+const buttonUi = new DesignUi('button')
+buttonUi.make()
+```
+
+## Các phương thức
+
+### Điều khiển
+
+- `make(): void` — Thực hiện quy trình khởi tạo đầy đủ, kích hoạt tuần tự tất cả các bản cập nhật cơ sở hạ tầng.
+
+## Các thao tác (Operations)
+
+### Quy trình khởi tạo UI (The UI Initialization Pipeline)
+
+Khi `make()` được gọi, `DesignUi` điều phối một bản cập nhật đa giai đoạn toàn diện:
+1. **Đặt lại môi trường**: Xóa `PropertiesCache` để ngăn các token cũ ảnh hưởng đến bản xây dựng mới.
+2. **Tạo cơ sở hạ tầng**: Kích hoạt việc tạo `Styles` và `DesignWiki` toàn cục để chuẩn bị nền tảng hình ảnh và tài liệu.
+3. **Đồng bộ hóa thành phần**: Thực thi `DesignComponent` cho (các) thành phần mục tiêu, phân giải siêu dữ liệu cấu trúc và tạo các tệp nguồn.
+4. **Chuẩn bị phân phối**: Cập nhật `package.json` với các ánh xạ xuất mới nhất cho CSS, SCSS và các mô-đun tập lệnh.
+5. **Tổng hợp thư viện**: Kích hoạt tuần tự các trình tạo chuyên dụng cấp thư viện:
+    - `LibraryMedia`: Đồng bộ hóa các tài sản biểu tượng và cờ.
+    - `LibraryList`: Biên soạn danh mục thành phần.
+    - `LibraryPlugin`: Xây dựng lại các plugin tích hợp Vue/framework.
+    - `LibraryAiWiki`: Tạo các cấu phần tài liệu được tối ưu hóa cho AI.
+    - `LibraryTypes`: Biên soạn các định nghĩa kiểu toàn cục.
+
+### Vai trò trong hệ sinh thái
+
+`DesignUi` đóng vai trò là điểm nhập chính cho các nhà phát triển và các công cụ xây dựng tự động. Bằng cách trừu tượng hóa sự phức tạp của hàng chục lớp chuyên biệt, nó cung cấp một giao diện "một cú nhấp chuột" ổn định để giữ cho thư viện UI luôn đồng bộ với các thông số kỹ thuật đang phát triển của hệ thống thiết kế.

package/src/media/functional/scripts/classes/DesignWiki/DesignWiki.en.mdx

@@ -0,0 +1,47 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Classes/DesignWiki - Wiki Registry Generator'/>
+
+# DesignWiki Class
+
+The `DesignWiki` class provides essential infrastructure for the project's documentation system. It automates the creation and initialization of the central wiki configuration file, ensuring that the documentation engine (Storybook) has a stable and typed registry to store component arguments and metadata.
+
+## Key Features
+
+- **Automated Initialization** — Detects missing wiki configuration files and creates them with a standard structure.
+- **Typed Registry** — Generates configurations using the `StorybookArgsToList` type to ensure full integration with the documentation framework.
+- **Project-Specific Aliasing** — Uses the design system's name (from `PropertiesConfig`) to create unique, project-aware registry variables.
+- **Safe Execution** — Implements existence checks before writing, preventing accidental overwriting of existing documentation configurations.
+
+## Initialization
+
+The class does not require any parameters for initialization. It uses global configurations from the environment.
+
+```typescript
+import { DesignWiki } from '@dxtmisha/scripts'
+
+const wikiGenerator = new DesignWiki()
+wikiGenerator.make()
+```
+
+## Methods
+
+### Control
+
+- `make(): void` — Triggers the wiki initialization process.
+
+## Operations
+
+### The Wiki Initialization Flow
+
+When `make()` is executed, the class follows this internal logic:
+1. **Path Resolution**: It uses preconfigured directory paths (`UI_DIRS_WIKI`) and file names (`UI_FILE_NAME_WIKI`) to locate the target configuration file.
+2. **Existence Check**: It queries the file system via `PropertiesFile.is()` to determine if the `.ts` configuration file already exists.
+3. **Registry Generation**: If missing, it fetches the current design system name and constructs a TypeScript template:
+    - It imports the necessary `StorybookArgsToList` type.
+    - It exports a constant named `wiki[DesignName]`.
+4. **Persistence**: Writes the generated template to the file system, ensuring the documentation engine can immediately begin importing it.
+
+### Integration with Storybook
+
+By centralizing the creation of this registry, `DesignWiki` ensures that all developers working on components have a consistent place to document props and states. This registry acts as the "source of truth" for the interactive documentation, allowing Storybook to dynamically render component controls based on the metadata stored here.

package/src/media/functional/scripts/classes/DesignWiki/DesignWiki.ru.mdx

@@ -0,0 +1,47 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Classes/DesignWiki - Генератор вики-реестра'/>
+
+# Класс DesignWiki
+
+Класс `DesignWiki` обеспечивает базовую инфраструктуру для системы документации проекта. Он автоматизирует создание и инициализацию центрального конфигурационного файла вики, гарантируя, что движок документации (Storybook) имеет стабильный и типизированный реестр для хранения аргументов и метаданных компонентов.
+
+## Ключевые особенности
+
+- **Автоматическая инициализация** — обнаруживает отсутствие конфигурационных файлов вики и создает их по стандартному шаблону.
+- **Типизированный реестр** — генерирует конфигурации с использованием типа `StorybookArgsToList` для полной интеграции с фреймворком документации.
+- **Проектное именование (Aliasing)** — использует имя дизайн-системы (из `PropertiesConfig`) для создания уникальных переменных реестра, соответствующих проекту.
+- **Безопасное выполнение** — проверяет существование файла перед записью, предотвращая случайную перезапись существующих конфигураций документации.
+
+## Инициализация
+
+Класс не требует параметров для инициализации. Он использует глобальные конфигурации из окружения.
+
+```typescript
+import { DesignWiki } from '@dxtmisha/scripts'
+
+const wikiGenerator = new DesignWiki()
+wikiGenerator.make()
+```
+
+## Методы
+
+### Управление
+
+- `make(): void` — запускает процесс инициализации вики.
+
+## Операции
+
+### Рабочий процесс инициализации вики
+
+При выполнении `make()` класс следует внутренней логике:
+1. **Разрешение путей**: использует настроенные пути к директориям (`UI_DIRS_WIKI`) и имена файлов (`UI_FILE_NAME_WIKI`) для определения целевого файла конфигурации.
+2. **Проверка существования**: опрашивает файловую систему через `PropertiesFile.is()`, чтобы определить, существует ли уже конфигурационный файл `.ts`.
+3. **Генерация реестра**: если файл отсутствует, получает текущее имя дизайн-системы и конструирует шаблон TypeScript:
+    - импортирует необходимый тип `StorybookArgsToList`.
+    - экспортирует константу с именем `wiki[DesignName]`.
+4. **Сохранение**: записывает сгенерированный шаблон в файловую систему, гарантируя, что движок документации сможет немедленно начать его импорт.
+
+### Интеграция со Storybook
+
+Централизуя создание этого реестра, `DesignWiki` гарантирует, что у всех разработчиков, работающих над компонентами, есть единое место для документирования пропсов и состояний. Этот реестр выступает в качестве «источника истины» для интерактивной документации, позволяя Storybook динамически отрисовывать элементы управления компонентами на основе сохраненных здесь метаданных.

package/src/media/functional/scripts/classes/DesignWiki/DesignWiki.vi.mdx

@@ -0,0 +1,47 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Classes/DesignWiki - Trình tạo registry Wiki'/>
+
+# Lớp DesignWiki
+
+Lớp `DesignWiki` cung cấp cơ sở hạ tầng thiết yếu cho hệ thống tài liệu của dự án. Nó tự động hóa việc tạo và khởi tạo tệp cấu hình wiki trung tâm, đảm bảo rằng công cụ tài liệu (Storybook) có một registry ổn định và được định kiểu để lưu trữ các tham số (arguments) và siêu dữ liệu của thành phần.
+
+## Các tính năng chính
+
+- **Khởi tạo tự động** — Phát hiện các tệp cấu hình wiki còn thiếu và tạo chúng theo cấu trúc chuẩn.
+- **Registry được định kiểu** — Tạo các cấu hình bằng cách sử dụng kiểu `StorybookArgsToList` để đảm bảo tích hợp đầy đủ với framework tài liệu.
+- **Đặt bí danh theo dự án** — Sử dụng tên hệ thống thiết kế (từ `PropertiesConfig`) để tạo các biến registry duy nhất và nhận biết dự án.
+- **Thực thi an toàn** — Thực hiện kiểm tra sự tồn tại trước khi ghi, ngăn chặn việc vô tình ghi đè lên các cấu hình tài liệu hiện có.
+
+## Khởi tạo
+
+Lớp không yêu cầu bất kỳ tham số nào để khởi tạo. Nó sử dụng các cấu hình toàn cục từ môi trường.
+
+```typescript
+import { DesignWiki } from '@dxtmisha/scripts'
+
+const wikiGenerator = new DesignWiki()
+wikiGenerator.make()
+```
+
+## Các phương thức
+
+### Điều khiển
+
+- `make(): void` — Kích hoạt quá trình khởi tạo wiki.
+
+## Các thao tác (Operations)
+
+### Quy trình khởi tạo Wiki
+
+Khi `make()` được thực thi, lớp sẽ tuân theo logic nội bộ sau:
+1. **Phân giải đường dẫn**: Nó sử dụng các đường dẫn thư mục đã được cấu hình trước (`UI_DIRS_WIKI`) và tên tệp (`UI_FILE_NAME_WIKI`) để định vị tệp cấu hình mục tiêu.
+2. **Kiểm tra sự tồn tại**: Nó truy vấn hệ thống tệp thông qua `PropertiesFile.is()` để xác định xem tệp cấu hình `.ts` đã tồn tại hay chưa.
+3. **Tạo Registry**: Nếu thiếu, nó sẽ lấy tên hệ thống thiết kế hiện tại và xây dựng một mẫu TypeScript:
+    - Nó nhập (import) kiểu `StorybookArgsToList` cần thiết.
+    - Nó xuất (export) một hằng số có tên `wiki[DesignName]`.
+4. **Lưu trữ**: Ghi mẫu đã tạo vào hệ thống tệp, đảm bảo công cụ tài liệu có thể bắt đầu nhập nó ngay lập tức.
+
+### Tích hợp với Storybook
+
+Bằng cách tập trung hóa việc tạo registry này, `DesignWiki` đảm bảo rằng tất cả các nhà phát triển đang làm việc trên các thành phần đều có một nơi nhất quán để lập tài liệu cho các props và trạng thái. Registry này đóng vai trò là "nguồn sự thật" cho tài liệu tương tác, cho phép Storybook hiển thị động các điều khiển thành phần dựa trên siêu dữ liệu được lưu trữ tại đây.