@dxtmisha/wiki 0.39.1 → 0.39.2

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.

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

@@ -0,0 +1,54 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Classes/DesignWikiStorm - IDE Metadata Generator'/>
+
+# DesignWikiStorm Class
+
+The `DesignWikiStorm` class is a specialized utility designed to bridge the gap between the design system's code and developer productivity tools. It automates the generation of `web-types.json`, a standardized metadata format used by JetBrains IDEs (WebStorm, IntelliJ IDEA) to provide advanced IntelliSense, auto-completion, and documentation tooltips for Vue components.
+
+## Key Features
+
+- **Web-Types Standard Compliance** — Generates metadata strictly adhering to the official Web-Types JSON schema.
+- **IntelliSense Optimization** — Transforms component properties, events, and slots into IDE-friendly definitions.
+- **Automated Directory Discovery** — Recursively scans the library to identify all components and their respective metadata.
+- **Dynamic Versioning** — Automatically synchronizes the generated metadata version with the current `package.json` version.
+- **Framework Integration** — Specifically configured for Vue.js, ensuring that component tags and attributes are correctly recognized in `.vue` files.
+
+## Initialization
+
+Initialize the generator by specifying the target directory where the `web-types.json` file should be stored.
+
+**Parameters:**
+- `dir: string` — The path to the output directory (default is `'dist'`).
+
+```typescript
+import { DesignWikiStorm } from '@dxtmisha/scripts'
+
+const generator = new DesignWikiStorm('dist')
+await generator.make()
+```
+
+## Methods
+
+### Control
+
+- `make(): Promise<void>` — Triggers the main generation process.
+
+## Operations
+
+### The Web-Types Generation Workflow
+
+When `make()` is called, the class coordinates a multi-stage data synthesis:
+1. **Context Acquisition**: It loads the `package.json` to retrieve the library name and current version.
+2. **Schema Bootstrapping**: It initializes an object based on the Web-Types schema, setting the framework to Vue and defining the documentation markup as Markdown.
+3. **Component Iteration**: It iterates through every component registered in `LibraryItems`.
+4. **Member Analysis**: For each component, it instantiates `DesignWikiStormItem`, which performs deep analysis of the component's source files to extract:
+    - **Tags**: Component names (e.g., `d1-button`).
+    - **Attributes**: Property names, types, and default values.
+    - **Events**: Emitted event names and their payloads.
+    - **Slots**: Available customization points and their scoped variables.
+5. **Persistence**: The final consolidated metadata object is written to `web-types.json` in the specified directory.
+
+### Impact on Developer Experience
+
+By generating `web-types.json`, the design system ensures that developers using JetBrains tools receive the same level of support as they would with native HTML elements. Property types are validated in real-time within the IDE, and documentation comments are displayed directly in the code editor, significantly reducing the need to consult external wiki pages.

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

@@ -0,0 +1,54 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Classes/DesignWikiStorm - Генератор метаданных для IDE'/>
+
+# Класс DesignWikiStorm
+
+Класс `DesignWikiStorm` — это специализированная утилита, предназначенная для сокращения разрыва между кодом дизайн-системы и инструментами продуктивности разработчиков. Он автоматизирует генерацию `web-types.json` — стандартизированного формата метаданных, используемого IDE от JetBrains (WebStorm, IntelliJ IDEA) для обеспечения продвинутого IntelliSense, автодополнения и подсказок по документации для компонентов Vue.
+
+## Ключевые особенности
+
+- **Соответствие стандарту Web-Types** — генерирует метаданные, строго соответствующие официальной JSON-схеме Web-Types.
+- **Оптимизация IntelliSense** — преобразует свойства компонентов, события и слоты в определения, удобные для IDE.
+- **Автоматическое обнаружение директорий** — рекурсивно сканирует библиотеку для идентификации всех компонентов и их соответствующих метаданных.
+- **Динамическое управление версиями** — автоматически синхронизирует версию сгенерированных метаданных с текущей версией в `package.json`.
+- **Интеграция с фреймворком** — специально настроен для Vue.js, что гарантирует правильное распознавание тегов и атрибутов компонентов в `.vue` файлах.
+
+## Инициализация
+
+Инициализируйте генератор, указав целевую директорию, в которой должен быть сохранен файл `web-types.json`.
+
+**Параметры:**
+- `dir: string` — путь к выходной директории (по умолчанию `'dist'`).
+
+```typescript
+import { DesignWikiStorm } from '@dxtmisha/scripts'
+
+const generator = new DesignWikiStorm('dist')
+await generator.make()
+```
+
+## Методы
+
+### Управление
+
+- `make(): Promise<void>` — запускает основной процесс генерации.
+
+## Операции
+
+### Рабочий процесс генерации Web-Types
+
+При вызове `make()` класс координирует многоэтапный синтез данных:
+1. **Получение контекста**: загружает `package.json` для получения имени библиотеки и текущей версии.
+2. **Инициализация схемы**: создает объект на основе схемы Web-Types, устанавливая фреймворк Vue и определяя разметку документации как Markdown.
+3. **Итерация компонентов**: обходит каждый компонент, зарегистрированный в `LibraryItems`.
+4. **Анализ элементов**: для каждого компонента создает экземпляр `DesignWikiStormItem`, который выполняет глубокий анализ исходных файлов компонента для извлечения:
+    - **Tags**: имена компонентов (например, `d1-button`).
+    - **Attributes**: имена свойств, типы и значения по умолчанию.
+    - **Events**: имена генерируемых событий и их полезная нагрузка.
+    - **Slots**: доступные точки настройки и их переменные области видимости.
+5. **Сохранение**: финальный консолидированный объект метаданных записывается в `web-types.json` в указанной директории.
+
+### Влияние на опыт разработчика
+
+Благодаря генерации `web-types.json`, дизайн-система гарантирует, что разработчики, использующие инструменты JetBrains, получают тот же уровень поддержки, что и при работе с нативными HTML-элементами. Типы свойств проверяются в реальном времени внутри IDE, а комментарии к документации отображаются прямо в редакторе кода, что значительно снижает необходимость обращения к внешним страницам вики.

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

@@ -0,0 +1,54 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Classes/DesignWikiStorm - Trình tạo siêu dữ liệu cho IDE'/>
+
+# Lớp DesignWikiStorm
+
+Lớp `DesignWikiStorm` là một tiện ích chuyên dụng được thiết kế để thu hẹp khoảng cách giữa mã nguồn của hệ thống thiết kế và các công cụ hỗ trợ năng suất cho nhà phát triển. Nó tự động hóa việc tạo `web-types.json`, một định dạng siêu dữ liệu chuẩn hóa được sử dụng bởi các IDE của JetBrains (WebStorm, IntelliJ IDEA) để cung cấp IntelliSense nâng cao, tự động hoàn thành và các mô tả tài liệu (tooltips) cho các thành phần Vue.
+
+## Các tính năng chính
+
+- **Tuân thủ tiêu chuẩn Web-Types** — Tạo siêu dữ liệu tuân thủ nghiêm ngặt giản đồ (schema) JSON chính thức của Web-Types.
+- **Tối ưu hóa IntelliSense** — Chuyển đổi các thuộc tính, sự kiện và slot của thành phần thành các định nghĩa thân thiện với IDE.
+- **Khám phá thư mục tự động** — Quét đệ quy thư viện để xác định tất cả các thành phần và siêu dữ liệu tương ứng của chúng.
+- **Tự động cập nhật phiên bản** — Tự động đồng bộ hóa phiên bản siêu dữ liệu được tạo ra với phiên bản hiện tại trong `package.json`.
+- **Tích hợp Framework** — Được cấu hình đặc biệt cho Vue.js, đảm bảo rằng các thẻ và thuộc tính thành phần được nhận diện chính xác trong các tệp `.vue`.
+
+## Khởi tạo
+
+Khởi tạo trình tạo bằng cách chỉ định thư mục đích nơi tệp `web-types.json` sẽ được lưu trữ.
+
+**Tham số:**
+- `dir: string` — Đường dẫn đến thư mục đầu ra (mặc định là `'dist'`).
+
+```typescript
+import { DesignWikiStorm } from '@dxtmisha/scripts'
+
+const generator = new DesignWikiStorm('dist')
+await generator.make()
+```
+
+## Các phương thức
+
+### Điều khiển
+
+- `make(): Promise<void>` — Kích hoạt quy trình tạo chính.
+
+## Các thao tác (Operations)
+
+### Quy trình tạo Web-Types (Web-Types Generation Workflow)
+
+Khi `make()` được gọi, lớp sẽ điều phối một quy trình tổng hợp dữ liệu đa giai đoạn:
+1. **Thu thập ngữ cảnh**: Nó tải `package.json` để lấy tên thư viện và phiên bản hiện tại.
+2. **Khởi tạo Giản đồ**: Nó khởi tạo một đối tượng dựa trên giản đồ Web-Types, đặt framework thành Vue và xác định định dạng tài liệu là Markdown.
+3. **Duyệt qua các thành phần**: Nó duyệt qua mọi thành phần được đăng ký trong `LibraryItems`.
+4. **Phân tích chi tiết**: Đối với mỗi thành phần, nó khởi tạo `DesignWikiStormItem`, thực hiện phân tích sâu các tệp mã nguồn của thành phần để trích xuất:
+    - **Tags**: Tên thành phần (ví dụ: `d1-button`).
+    - **Attributes**: Tên thuộc tính, kiểu dữ liệu và giá trị mặc định.
+    - **Events**: Tên các sự kiện được phát ra và dữ liệu kèm theo (payload).
+    - **Slots**: Các điểm tùy chỉnh có sẵn và các biến phạm vi (scoped variables) của chúng.
+5. **Lưu trữ**: Đối tượng siêu dữ liệu hợp nhất cuối cùng được ghi vào tệp `web-types.json` trong thư mục đã chỉ định.
+
+### Tác động đến trải nghiệm nhà phát triển
+
+Bằng cách tạo `web-types.json`, hệ thống thiết kế đảm bảo rằng các nhà phát triển sử dụng công cụ của JetBrains nhận được mức độ hỗ trợ tương đương với khi làm việc với các phần tử HTML gốc. Các kiểu thuộc tính được xác thực theo thời gian thực ngay trong IDE và các chú thích tài liệu được hiển thị trực tiếp trong trình soạn thảo mã, giảm đáng kể nhu cầu tham khảo các trang wiki bên ngoài.

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

@@ -0,0 +1,62 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Classes/DesignWikiStormItem - Component IDE Metadata Resolver'/>
+
+# DesignWikiStormItem Class
+
+The `DesignWikiStormItem` class is a granular resolver responsible for extracting, analyzing, and formatting metadata for a single UI component. It acts as the bridge between internal Storybook-oriented documentation and the `web-types.json` format, ensuring that every property and description is correctly mapped for IDE IntelliSense.
+
+## Key Features
+
+- **Storeybook-to-WebTypes Mapping** — Automatically converts `WikiStorybook` objects into JetBrains-compatible tag definitions.
+- **Dynamic Module Resolution** — Calculates the correct module paths for components to support "Jump to Definition" in IDEs.
+- **Context-Aware Documentation** — Preserves and formats component descriptions, property types, and default values.
+- **AST-Like Data Retrieval** — Programmatically imports and parses `wikiData.ts` files to retrieve live component metadata.
+- **Attribute Synthesis** — Iteratively builds attribute lists by resolving complex types into human-readable IDE strings.
+
+## Initialization
+
+Initialize the resolver by providing the project context, the structural path, and the component's library metadata.
+
+**Parameters:**
+- `project: string` — The name of the project (e.g., `'@dxtmisha/ui'`).
+- `path: string[]` — Segments of the file system path leading to the component folder.
+- `data: LibraryData` — Core metadata of the component (name, alias, directory).
+
+```typescript
+import { DesignWikiStormItem } from '@dxtmisha/scripts'
+
+const resolver = new DesignWikiStormItem(
+  '@dxtmisha/ui',
+  ['packages', 'core', 'src', 'components'],
+  componentData
+)
+await resolver.init()
+const tagMetadata = resolver.get()
+```
+
+## Methods
+
+### Information Acquisition
+
+- `get(): WebTypesTagItem | undefined` — Returns the consolidated tag definition containing the name, description, source, and attributes.
+- `getAttribute(item: WikiStorybookProp): WebTypesAttributeItem` — Transforms a single Storybook property into a Web-Types attribute definition.
+- `getAttributes(): WebTypesAttributes` — Compiles the full list of attributes for the component.
+
+### Control
+
+- `init(): Promise<this>` — Asynchronously initializes the internal `WikiStorybook` instance by loading the component's documentation data.
+
+## Operations
+
+### The Metadata Extraction Flow
+
+When the resolver is initialized and queried, it follows a structured data pipeline:
+1. **Wiki Data Loading (`initWiki`)**: It resolves the file path to the component's `wikiData.ts` and performs a dynamic import to fetch live metadata (props, defaults, design tokens).
+2. **Tag Synthesis (`get`)**: It constructs the IDE tag name by combining the design system alias with the internal component name.
+3. **Source Mapping**: It defines the `module` and `symbol` properties, allowing IDEs to link the metadata back to the actual source code.
+4. **Attribute Compilation (`getAttributes`)**: It traverses every property defined in the wiki, resolving its documentation comment, TypeScript type, and default value into a standardized JSON structure.
+
+### Role in the IDE Engine
+
+`DesignWikiStormItem` is the "workhorse" of the metadata generation suite. While `DesignWikiStorm` manages the overall file structure, this class handles the complexity of individual component analysis, ensuring that specialized UI logic is accurately represented in a format that development tools can understand.