@dxtmisha/wiki 0.39.1 → 0.39.3

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

@@ -0,0 +1,49 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Classes/BuildItem - Component Build Manager'/>
+
+# BuildItem Class
+
+Responsible for orchestrating the build process of individual components using Vite. It manages temporary build configurations, executes the build pipeline, and aggregates the resulting output into a single code snapshot.
+
+## Key Features
+
+- **Configuration Isolation** — Safely renames existing Vite configs before build and restores them after completion.
+- **Vite Integration** — Generates dynamic Vite configurations based on a component-specific template.
+- **Output Aggregation** — Recursively reads all files from the temporary distribution directory and combines them into a single `code.txt` file.
+- **Error Propagation** — Monitors build status and handles environment exit codes on failure.
+- **Storage Management** — Provides utility methods for retrieving and cleaning up temporary distribution paths.
+
+## Initialization
+
+Initialize the `BuildItem` by providing the target component path.
+
+**Parameters:**
+- `path: string` — the target path to the component directory to be built.
+
+```typescript
+import { BuildItem } from '@dxtmisha/scripts'
+
+const builder = new BuildItem('packages/components/Button')
+
+// Trigger the build process
+await builder.make()
+```
+
+## Methods
+
+### Control
+
+- `make(): Promise<boolean>` — coordinates the full build lifecycle: configuration backup, build execution, and file restoration.
+- `getCode(): string` — retrieves the content of the aggregated code snapshot generated during the build.
+- `removeDir(): void` — permanently deletes the temporary distribution directory.
+
+## Internal Workflow
+
+The build process follows a strict lifecycle to ensure environment safety and consistent output:
+
+1.  **Configuration Backup** — Renames the existing `vite.config.ts` to `vite.config.workers.ts` to prevent it from being overwritten or interfering with the build.
+2.  **Template Synthesis** — Reads the component-specific Vite template and injects the target path dynamically.
+3.  **Shell Execution** — Triggers the `npm run build` command via a child process, capturing and logging all output.
+4.  **Restoration** — Safely restores the original `vite.config.ts` from the backup once the build completes.
+5.  **Aggregation** — Recursively scans the distribution directory, wraps each file's content in an identifier comment, and writes the final combined result to `code.txt`.

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

@@ -0,0 +1,49 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Classes/BuildItem - Менеджер сборки компонентов'/>
+
+# Класс BuildItem
+
+Отвечает за оркестрацию процесса сборки отдельных компонентов с использованием Vite. Класс управляет временными конфигурациями сборки, запускает конвейер компиляции и агрегирует полученные файлы в единый снимок кода.
+
+## Ключевые возможности
+
+- **Изоляция конфигурации** — Безопасно переименовывает существующие конфиги Vite перед сборкой и восстанавливает их по завершении.
+- **Интеграция с Vite** — Генерирует динамические конфигурации Vite на основе шаблона, специфичного для компонента.
+- **Агрегация результатов** — Рекурсивно считывает файлы из временной директории дистрибутива и объединяет их в один файл `code.txt`.
+- **Обработка ошибок** — Отслеживает статус сборки и обрабатывает коды выхода окружения при сбоях.
+- **Управление хранилищем** — Предоставляет методы для получения и очистки временных путей дистрибутива.
+
+## Инициализация
+
+Инициализируйте `BuildItem`, указав целевой путь к компоненту.
+
+**Параметры:**
+- `path: string` — целевой путь к директории компонента для сборки.
+
+```typescript
+import { BuildItem } from '@dxtmisha/scripts'
+
+const builder = new BuildItem('packages/components/Button')
+
+// Запуск процесса сборки
+await builder.make()
+```
+
+## Методы
+
+### Управление
+
+- `make(): Promise<boolean>` — координирует полный жизненный цикл сборки: резервное копирование конфига, выполнение сборки и восстановление файлов.
+- `getCode(): string` — возвращает содержимое агрегированного снимка кода, созданного в процессе сборки.
+- `removeDir(): void` — безвозвратно удаляет временную директорию дистрибутива.
+
+## Внутренний процесс сборки
+
+Процесс сборки следует строгому жизненному циклу для обеспечения безопасности окружения и согласованности вывода:
+
+1.  **Резервное копирование конфигурации** — Переименовывает существующий `vite.config.ts` в `vite.config.workers.ts`, чтобы предотвратить его перезапись или вмешательство в процесс сборки.
+2.  **Синтез шаблона** — Читает специальный шаблон Vite для компонентов и динамически подставляет в него целевой путь.
+3.  **Выполнение в оболочке** — Запускает команду `npm run build` через дочерний процесс, перехватывая и логируя весь вывод.
+4.  **Восстановление** — Безопасно восстанавливает оригинальный `vite.config.ts` из резервной копии сразу после завершения сборки.
+5.  **Агрегация** — Рекурсивно сканирует директорию дистрибутива, оборачивает содержимое каждого файла в идентифицирующий комментарий и записывает итоговый результат в `code.txt`.

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

@@ -0,0 +1,49 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Classes/BuildItem - Trình quản lý Build Component'/>
+
+# Lớp BuildItem
+
+Chịu trách nhiệm điều phối quy trình build của từng component riêng lẻ bằng Vite. Nó quản lý các cấu hình build tạm thời, thực thi quy trình build và tổng hợp đầu ra thu được thành một snapshot mã duy nhất.
+
+## Các tính năng chính
+
+- **Cô lập cấu hình** — Đổi tên các cấu hình Vite hiện có một cách an toàn trước khi build và khôi phục chúng sau khi hoàn tất.
+- **Tích hợp Vite** — Tạo các cấu hình Vite động dựa trên một template dành riêng cho component.
+- **Tổng hợp đầu ra** — Đọc đệ quy tất cả các tệp từ thư mục phân phối tạm thời và kết hợp chúng thành một tệp `code.txt` duy nhất.
+- **Lan truyền lỗi** — Theo dõi trạng thái build và xử lý các mã thoát (exit code) khi thất bại.
+- **Quản lý lưu trữ** — Cung cấp các phương thức để lấy và dọn dẹp các đường dẫn phân phối tạm thời.
+
+## Khởi tạo
+
+Khởi tạo `BuildItem` bằng cách cung cấp đường dẫn component mục tiêu.
+
+**Tham số:**
+- `path: string` — đường dẫn đích đến thư mục component cần build.
+
+```typescript
+import { BuildItem } from '@dxtmisha/scripts'
+
+const builder = new BuildItem('packages/components/Button')
+
+// Kích hoạt quy trình build
+await builder.make()
+```
+
+## Phương thức
+
+### Điều khiển
+
+- `make(): Promise<boolean>` — điều phối toàn bộ vòng đời build: sao lưu cấu hình, thực thi build và khôi phục tệp.
+- `getCode(): string` — lấy nội dung của snapshot mã tổng hợp được tạo ra trong quy trình build.
+- `removeDir(): void` — xóa vĩnh viễn thư mục phân phối tạm thời.
+
+## Quy trình làm việc nội bộ
+
+Quá trình build tuân theo một vòng đời nghiêm ngặt để đảm bảo an toàn cho môi trường và tính nhất quán của đầu ra:
+
+1.  **Sao lưu cấu hình** — Đổi tên `vite.config.ts` hiện có thành `vite.config.workers.ts` để ngăn nó bị ghi đè hoặc gây nhiễu cho quá trình build.
+2.  **Tổng hợp Template** — Đọc template Vite cụ thể của component và chèn đường dẫn đích một cách động.
+3.  **Thực thi Shell** — Kích hoạt lệnh `npm run build` thông qua một tiến trình con, thu thập và ghi lại toàn bộ đầu ra.
+4.  **Khôi phục** — Khôi phục an toàn `vite.config.ts` ban đầu từ bản sao lưu sau khi quá trình build hoàn tất.
+5.  **Tổng hợp** — Quét đệ quy thư mục phân phối, bao bọc nội dung của mỗi tệp trong một comment định danh và ghi kết quả kết hợp cuối cùng vào `code.txt`.

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

@@ -0,0 +1,41 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Classes/ComponentCreator - Automatic Component Scaffolding'/>
+
+# ComponentCreator Class
+
+A utility class for automating the creation of component skeletons in empty directories. It proactively identifies folders within the component directory that lack files and initializes them using the project's standard templates.
+
+## Key Features
+
+- **Automated Discovery** — scans the component directory recursively to find empty folders.
+- **Smart Scaffolding** — automatically triggers the creation process for each identified directory.
+- **Project Consistency** — ensures all new components start with the same baseline structure and files.
+
+## Initialization
+
+Initialize a new instance of `ComponentCreator`. It automatically targets the standard components directory defined in the project configuration.
+
+```typescript
+import { ComponentCreator } from '@dxtmisha/scripts'
+
+const creator = new ComponentCreator()
+```
+
+## Methods
+
+### `make`
+
+The primary orchestration method that performs a recursive scan of the components directory, identifies folders without files, and triggers the `ComponentItem` scaffolding process for each one.
+
+**Returns:** `void`
+
+## Examples
+
+### Complete Scaffolding Flow
+Running the creator as part of a build or preparation script ensures that even manually created empty folders are properly initialized with necessary files (`index.ts`, `types.ts`, etc.).
+
+```javascript
+const creator = new ComponentCreator()
+creator.make()
+```

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

@@ -0,0 +1,41 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Classes/ComponentCreator - Автоматическое создание компонентов'/>
+
+# Класс ComponentCreator
+
+Утилитный класс для автоматизации создания скелета компонентов в пустых директориях. Он проактивно идентифицирует папки внутри директории компонентов, в которых отсутствуют файлы, и инициализирует их, используя стандартные шаблоны проекта.
+
+## Ключевые особенности
+
+- **Автоматическое обнаружение** — рекурсивно сканирует директорию компонентов для поиска пустых папок.
+- **Умное создание (Scaffolding)** — автоматически запускает процесс создания для каждой идентифицированной директории.
+- **Согласованность проекта** — гарантирует, что все новые компоненты начинаются с одинаковой базовой структуры и файлов.
+
+## Инициализация
+
+Инициализируйте новый экземпляр `ComponentCreator`. Он автоматически нацеливается на стандартную директорию компонентов, определенную в конфигурации проекта.
+
+```typescript
+import { ComponentCreator } from '@dxtmisha/scripts'
+
+const creator = new ComponentCreator()
+```
+
+## Методы
+
+### `make`
+
+Основной метод оркестрации, который выполняет рекурсивное сканирование директории компонентов, идентифицирует папки без файлов и запускает процесс заполнения (`ComponentItem`) для каждой из них.
+
+**Возвращает:** `void`
+
+## Примеры
+
+### Полный процесс создания
+Запуск создателя как части сценария сборки или подготовки гарантирует, что даже созданные вручную пустые папки будут правильно инициализированы необходимыми файлами (`index.ts`, `types.ts` и т.д.).
+
+```javascript
+const creator = new ComponentCreator()
+creator.make()
+```

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

@@ -0,0 +1,41 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Classes/ComponentCreator - Tự động tạo thành phần'/>
+
+# Lớp ComponentCreator
+
+Một lớp tiện ích để tự động hóa việc tạo khung sườn (skeleton) của thành phần trong các thư mục trống. Nó chủ động xác định các thư mục trong thư mục thành phần còn thiếu tệp và khởi tạo chúng bằng các mẫu tiêu chuẩn của dự án.
+
+## Các tính năng chính
+
+- **Tự động khám phá** — quét thư mục thành phần theo cách đệ quy để tìm các thư mục trống.
+- **Tạo khung sườn thông minh** — tự động kích hoạt quá trình tạo cho mỗi thư mục được xác định.
+- **Tính nhất quán của dự án** — đảm bảo tất cả các thành phần mới đều bắt đầu với cùng một cấu trúc cơ bản và các tệp giống nhau.
+
+## Khởi tạo
+
+Khởi tạo một phiên bản mới của `ComponentCreator`. Nó tự động nhắm mục tiêu vào thư mục thành phần tiêu chuẩn được xác định trong cấu hình dự án.
+
+```typescript
+import { ComponentCreator } from '@dxtmisha/scripts'
+
+const creator = new ComponentCreator()
+```
+
+## Các phương thức
+
+### `make`
+
+Phương thức điều phối chính thực hiện quét đệ quy thư mục thành phần, xác định các thư mục không có tệp và kích hoạt quá trình tạo khung sườn `ComponentItem` cho mỗi thư mục đó.
+
+**Trả về:** `void`
+
+## Ví dụ
+
+### Quy trình tạo khung sườn hoàn chỉnh
+Chạy creator như một phần của kịch bản xây dựng hoặc chuẩn bị để đảm bảo rằng ngay cả các thư mục trống được tạo thủ công cũng được khởi tạo đúng cách với các tệp cần thiết (`index.ts`, `types.ts`, v.v.).
+
+```javascript
+const creator = new ComponentCreator()
+creator.make()
+```

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

@@ -0,0 +1,46 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Classes/ComponentItem - Component File Generator'/>
+
+# ComponentItem Class
+
+A specialized class for generating individual component files based on templates. It manages the entire creation process, from reading template samples to performing dynamic string replacements and setting correct file system permissions.
+
+## Key Features
+
+- **Template-Driven** — uses a centralized repository of component templates for consistent file generation.
+- **Dynamic Replacements** — automatically replaces markers like `ComponentDoc`, `[project]`, and `[path]` with context-specific values.
+- **Placeholder Support** — handles both camelCase (class names) and kebab-case (filenames) transformations.
+- **Permission Management** — ensures generated files have the correct execution and read/write permissions.
+
+## Initialization
+
+To initialize the object, call the `ComponentItem(path)` constructor.
+
+**Parameters:**
+- `path: string` — the relative or absolute path to the directory where the component will be created.
+
+```typescript
+import { ComponentItem } from '@dxtmisha/scripts'
+
+const component = new ComponentItem('src/components/MyComponent')
+
+// Generating files
+component.make()
+```
+
+## Methods
+
+### Control
+
+- `make(): void` — The main method that reads all template files and writes their processed versions to the component directory.
+
+## Examples
+
+### Manual Scaffolding
+While `ComponentCreator` handles batch creation, `ComponentItem` can be used directly for fine-grained control over a specific component.
+
+```javascript
+const item = new ComponentItem('packages/ui/src/components/Avatar')
+item.make()
+```

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

@@ -0,0 +1,46 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Classes/ComponentItem - Генератор файлов компонента'/>
+
+# Класс ComponentItem
+
+Специализированный класс для генерации отдельных файлов компонентов на основе шаблонов. Он управляет всем процессом создания: от чтения образцов шаблонов до выполнения динамических замен строк и установки правильных разрешений файловой системы.
+
+## Ключевые особенности
+
+- **На основе шаблонов** — использует централизованный репозиторий шаблонов компонентов для единообразной генерации файлов.
+- **Динамические замены** — автоматически заменяет маркеры, такие как `ComponentDoc`, `[project]` и `[path]`, на контекстные значения.
+- **Поддержка плейсхолдеров** — обрабатывает преобразования как в camelCase (имена классов), так и в kebab-case (имена файлов).
+- **Управление правами** — гарантирует, что сгенерированные файлы имеют правильные права на выполнение, чтение и запись.
+
+## Инициализация
+
+Для инициализации объекта вызовите конструктор `ComponentItem(path)`.
+
+**Параметры:**
+- `path: string` — относительный или абсолютный путь к директории, в которой будет создан компонент.
+
+```typescript
+import { ComponentItem } from '@dxtmisha/scripts'
+
+const component = new ComponentItem('src/components/MyComponent')
+
+// Генерация файлов
+component.make()
+```
+
+## Методы
+
+### Управление
+
+- `make(): void` — основной метод, который считывает все файлы шаблонов и записывает их обработанные версии в директорию компонента.
+
+## Примеры
+
+### Ручное создание заготовки
+В то время как `ComponentCreator` управляет пакетным созданием, `ComponentItem` можно использовать напрямую для точного контроля над конкретным компонентом.
+
+```javascript
+const item = new ComponentItem('packages/ui/src/components/Avatar')
+item.make()
+```

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

@@ -0,0 +1,46 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Classes/ComponentItem - Trình tạo tệp thành phần'/>
+
+# Lớp ComponentItem
+
+Một lớp chuyên dụng để tạo các tệp thành phần riêng lẻ dựa trên các mẫu. Nó quản lý toàn bộ quá trình tạo, từ việc đọc các mẫu tệp đến việc thực hiện thay thế chuỗi động và đặt các quyền hệ thống tệp chính xác.
+
+## Các tính năng chính
+
+- **Dựa trên mẫu** — sử dụng kho lưu trữ tập trung các mẫu thành phần để tạo tệp nhất quán.
+- **Thay thế động** — tự động thay thế các dấu hiệu như `ComponentDoc`, `[project]` và `[path]` bằng các giá trị cụ thể theo ngữ cảnh.
+- **Hỗ trợ trình giữ chỗ** — xử lý các chuyển đổi cả camelCase (tên lớp) và kebab-case (tên tệp).
+- **Quản lý quyền** — đảm bảo các tệp được tạo có quyền thực thi và đọc/ghi chính xác.
+
+## Khởi tạo
+
+Để khởi tạo đối tượng, hãy gọi hàm tạo `ComponentItem(path)`.
+
+**Tham số:**
+- `path: string` — đường dẫn tương đối hoặc tuyệt đối đến thư mục nơi thành phần sẽ được tạo.
+
+```typescript
+import { ComponentItem } from '@dxtmisha/scripts'
+
+const component = new ComponentItem('src/components/MyComponent')
+
+// Tạo các tệp
+component.make()
+```
+
+## Các phương thức
+
+### Điều khiển
+
+- `make(): void` — Phương thức chính đọc tất cả các tệp mẫu và ghi các phiên bản đã xử lý của chúng vào thư mục thành phần.
+
+## Ví dụ
+
+### Tạo dàn giáo thủ công
+Trong khi `ComponentCreator` xử lý việc tạo hàng loạt, `ComponentItem` có thể được sử dụng trực tiếp để kiểm soát chi tiết một thành phần cụ thể.
+
+```javascript
+const item = new ComponentItem('packages/ui/src/components/Avatar')
+item.make()
+```

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

@@ -0,0 +1,47 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Classes/ComponentWiki - AI-Powered Wiki Generator'/>
+
+# ComponentWiki Class
+
+An advanced orchestration class that automates the generation of documentation, stories, and type definitions for components using AI. It coordinates temporary builds, code extraction, and AI processing to create comprehensive wiki artifacts.
+
+## Key Features
+
+- **AI-Driven Documentation** — leverages AI to analyze component code and generate meaningful MDX descriptions.
+- **Automatic Story Generation** — creates initial Storybook stories based on the component's implementation.
+- **Type Extraction** — identifies and extracts type definitions for inclusion in documentation.
+- **Process Orchestration** — handles the technical lifecycle including building items, extracting code snapshots, and cleanup.
+
+## Initialization
+
+Initialize the class with the target component path and optional custom prompt instructions.
+
+**Parameters:**
+- `path: string` — the relative path to the component directory.
+- `prompt: string = ''` — optional additional text to append to the AI prompt for specific documentation requirements.
+
+```typescript
+import { ComponentWiki } from '@dxtmisha/scripts'
+
+const wiki = new ComponentWiki('src/components/MyComponent', 'Focus on accessibility details.')
+
+// Start generation process
+wiki.make()
+```
+
+## Methods
+
+### Control
+
+- `make(): void` — The primary method that initiates building the code, preparing the AI context, and generating the wiki artifacts.
+
+## Examples
+
+### Batch Generation
+Commonly used in scripts to regenerate documentation for multiple components after API changes.
+
+```javascript
+const wiki = new ComponentWiki('src/components/BaseButton')
+wiki.make()
+```

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

@@ -0,0 +1,47 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Classes/ComponentWiki - Генератор Wiki на базе ИИ'/>
+
+# Класс ComponentWiki
+
+Продвинутый класс-оркестратор, который автоматизирует генерацию документации, историй (stories) и определений типов для компонентов с использованием ИИ. Он координирует временные сборки, извлечение кода и обработку ИИ для создания полных Wiki-артефактов.
+
+## Ключевые особенности
+
+- **Документация на базе ИИ** — использует ИИ для анализа кода компонентов и создания содержательных MDX-описаний.
+- **Автоматическая генерация историй** — создает начальные истории Storybook на основе реализации компонента.
+- **Извлечение типов** — идентифицирует и извлекает определения типов для включения в документацию.
+- **Оркестрация процессов** — управляет техническим жизненным циклом, включая сборку элементов, извлечение снимков кода и очистку.
+
+## Инициализация
+
+Инициализируйте класс, указав путь к целевому компоненту и необязательные инструкции для промпта.
+
+**Параметры:**
+- `path: string` — относительный путь к директории компонента.
+- `prompt: string = ''` — необязательный дополнительный текст для добавления к промпту ИИ для специфических требований к документации.
+
+```typescript
+import { ComponentWiki } from '@dxtmisha/scripts'
+
+const wiki = new ComponentWiki('src/components/MyComponent', 'Сфокусируйся на деталях доступности.')
+
+// Запуск процесса генерации
+wiki.make()
+```
+
+## Методы
+
+### Управление
+
+- `make(): void` — основной метод, который запускает сборку кода, подготовку контекста ИИ и генерацию Wiki-артефактов.
+
+## Примеры
+
+### Пакетная генерация
+Обычно используется в скриптах для перегенерации документации для нескольких компонентов после изменений API.
+
+```javascript
+const wiki = new ComponentWiki('src/components/BaseButton')
+wiki.make()
+```

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

@@ -0,0 +1,47 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Classes/ComponentWiki - Trình tạo Wiki hỗ trợ AI'/>
+
+# Lớp ComponentWiki
+
+Một lớp điều phối nâng cao tự động hóa việc tạo tài liệu, câu chuyện (stories) và định nghĩa kiểu cho các thành phần bằng AI. Nó điều phối các bản dựng tạm thời, trích xuất mã và xử lý AI để tạo ra các tạo tác wiki toàn diện.
+
+## Các tính năng chính
+
+- **Tài liệu do AI điều khiển** — tận dụng AI để phân tích mã thành phần và tạo các mô tả MDX có ý nghĩa.
+- **Tạo câu chuyện tự động** — tạo các câu chuyện Storybook ban đầu dựa trên việc triển khai thành phần.
+- **Trích xuất kiểu** — xác định và trích xuất các định nghĩa kiểu để đưa vào tài liệu.
+- **Điều phối quy trình** — xử lý vòng đời kỹ thuật bao gồm xây dựng các mục, trích xuất ảnh chụp nhanh mã và dọn dẹp.
+
+## Khởi tạo
+
+Khởi tạo lớp với đường dẫn thành phần mục tiêu và các hướng dẫn nhắc tùy chọn.
+
+**Tham số:**
+- `path: string` — đường dẫn tương đối đến thư mục thành phần.
+- `prompt: string = ''` — văn bản bổ sung tùy chọn để thêm vào lời nhắc AI cho các yêu cầu tài liệu cụ thể.
+
+```typescript
+import { ComponentWiki } from '@dxtmisha/scripts'
+
+const wiki = new ComponentWiki('src/components/MyComponent', 'Tập trung vào chi tiết khả năng truy cập.')
+
+// Bắt đầu quá trình tạo
+wiki.make()
+```
+
+## Các phương thức
+
+### Điều khiển
+
+- `make(): void` — Phương thức chính khởi tạo việc xây dựng mã, chuẩn bị ngữ cảnh AI và tạo các tạo tác wiki.
+
+## Ví dụ
+
+### Tạo hàng loạt
+Thường được sử dụng trong các tập lệnh để tạo lại tài liệu cho nhiều thành phần sau các thay đổi API.
+
+```javascript
+const wiki = new ComponentWiki('src/components/BaseButton')
+wiki.make()
+```

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

@@ -0,0 +1,51 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Classes/ComponentWikiFile - Wiki File Utility'/>
+
+# ComponentWikiFile Class
+
+A specialized utility class designed for handling individual files within the wiki generation process. It provides robust methods for reading, writing, and managing metadata like update dates and file versioning.
+
+## Key Features
+
+- **Metadata Management** — automatically extracts and updates the "**Date: ...**" marker within file content.
+- **Smart Writing** — automatically strips markdown code fences when saving and only writes if content has changed.
+- **Versioning Support** — optionally preserves the previous version of a file by renaming it with an `__old.txt` suffix.
+- **Path Abstraction** — integrates with `PropertiesFile` to handle file operations using consistent path segments.
+
+## Initialization
+
+Initialize with the path segments and configuration for date handling and versioning.
+
+**Parameters:**
+- `paths: string[]` — segments of the file path.
+- `isDate: boolean = false` — if `true`, automatically manages the date marker in the content.
+- `isOld: boolean = true` — if `true`, saves the previous version before overwriting.
+
+```typescript
+import { ComponentWikiFile } from '@dxtmisha/scripts'
+
+const file = new ComponentWikiFile(['docs', 'Guide.mdx'], true, true)
+```
+
+## Methods
+
+### Information
+
+- `getPath(): string` — Returns the full absolute path to the file.
+- `getDate(): Datetime` — Extracts and returns the date from the file's content.
+- `read(): string` — Reads and returns the entire file content.
+
+### Control
+
+- `write(content: string): void` — Writes processed content to the file, handling versioning and date updates if configured.
+
+## Examples
+
+### Managing Documentation Updates
+Automatically updating documentation while keeping a backup of the previous version.
+
+```typescript
+const docFile = new ComponentWikiFile(['wiki', 'MyComponent.mdx'], true, true)
+docFile.write('# New Content')
+```