@dxtmisha/wiki 0.25.1 → 0.39.2

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

@@ -0,0 +1,61 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Classes/AiDocItemAbstract - Documentation Automation Base Class'/>
+
+# AiDocItemAbstract Class
+
+An abstract base class for automating documentation generation using AI. It manages the lifecycle of reading source files, gathering context (code, demos, prompts), and coordinating with an AI service to produce or update MDX and source files.
+
+## Key Features
+
+- **Automated Lifecycle** — orchestrates reading source code, running builds, and generating documentation updates.
+- **Context Management** — built-in logic to collect component code, original source, and fake demo data for AI context.
+- **Smart Updates** — automatically compares modification dates to determine if re-generation is needed.
+- **Template System** — supports prompt templates and dynamic title replacement (e.g., `[title]`).
+- **Build Integration** — integrates with `BuildItem` to ensure code is buildable before documenting.
+- **Selective Generation** — supports bypassing generation using the `// wiki:build-none` marker.
+
+## Initialization
+
+Since `AiDocItemAbstract` is an abstract class, it must be extended. Concrete classes must provide paths for demo files and prompt templates.
+
+**Constructor Parameters:**
+- `path: string` — The base directory path for the source files.
+- `item: GitFileItem` — Information about the specific file being documented.
+
+```typescript
+// Example of extending and using AiDocItemAbstract
+class MyComponentDoc extends AiDocItemAbstract {
+  protected pathDemo = ['path', 'to', 'demo.ts']
+  protected pathPrompt = ['path', 'to', 'prompt.txt']
+}
+
+const doc = new MyComponentDoc('/source/dir', gitFileItem)
+await doc.make() // Triggers the documentation cycle
+```
+
+## Methods
+
+### Lifecycle
+
+- `make(): Promise<void>` — The main entry point. Checks if updates are needed, prepares context, calls AI, and writes the results.
+- `isBuildDisabled(): boolean` — Checks if the source file contains the `// wiki:build-none` marker.
+
+## Abstract Methods (Implementation)
+
+- `getPathWiki(): string[]` — Logic to determine the target Wiki file path based on the source file location.
+- `getItemDate(): Date` — Retrieves the file modification date from the `GitFileItem`.
+- `getTitle(): string` — Composes a standardized title for the documentation.
+- `readDemo(): string` — Reads the content of the configured demo file.
+- `readPrompt(): string` — Reads and prepares the prompt template, replacing placeholders like `[wikiLanguage]`.
+- `makeAi(): void` — Populates the AI instance with relevant context (code, demos, etc.).
+- `initName(content: string): string` — Replaces the `[title]` placeholder in the generated content.
+
+## Types
+
+### GitFileItem
+Represents file information managed by Git.
+- `path: string` — Relative path to the file.
+- `pathByOS: string` — Absolute OS-specific path.
+- `date: string` — Last modification date.
+- `item: any` — Reserved for additional metadata.

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

@@ -0,0 +1,61 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Classes/AiDocItemAbstract - Базовый класс автоматизации документации'/>
+
+# Класс AiDocItemAbstract
+
+Абстрактный базовый класс для автоматизации генерации документации с использованием ИИ. Он управляет жизненным циклом чтения исходных файлов, сбора контекста (код, демо, промпты) и координации с сервисом ИИ для создания или обновления файлов MDX и исходного кода.
+
+## Ключевые особенности
+
+- **Автоматизированный жизненный цикл** — координирует чтение кода, выполнение сборки и генерацию обновлений документации.
+- **Управление контекстом** — встроенная логика для сбора кода компонентов, исходного кода и фиктивных демо-данных для контекста ИИ.
+- **Умные обновления** — автоматически сравнивает даты изменения, чтобы определить, требуется ли повторная генерация.
+- **Система шаблонов** — поддерживает шаблоны промптов и динамическую замену заголовков (например, `[title]`).
+- **Интеграция со сборкой** — взаимодействует с `BuildItem`, чтобы убедиться, что код собирается перед документированием.
+- **Выборочная генерация** — поддержка пропуска генерации с помощью маркера `// wiki:build-none`.
+
+## Инициализация
+
+Поскольку `AiDocItemAbstract` является абстрактным классом, его необходимо расширить. Конкретные классы должны предоставить пути к файлам демо и шаблонам промптов.
+
+**Параметры конструктора:**
+- `path: string` — базовый путь к директории исходных файлов.
+- `item: GitFileItem` — информация о конкретном документируемом файле.
+
+```typescript
+// Пример расширения и использования AiDocItemAbstract
+class MyComponentDoc extends AiDocItemAbstract {
+  protected pathDemo = ['path', 'to', 'demo.ts']
+  protected pathPrompt = ['path', 'to', 'prompt.txt']
+}
+
+const doc = new MyComponentDoc('/source/dir', gitFileItem)
+await doc.make() // Запускает цикл документирования
+```
+
+## Методы
+
+### Жизненный цикл
+
+- `make(): Promise<void>` — Основная точка входа. Проверяет необходимость обновления, подготавливает контекст, вызывает ИИ и записывает результаты.
+- `isBuildDisabled(): boolean` — Проверяет, содержит ли исходный файл маркер `// wiki:build-none`.
+
+## Абстрактные методы (Для реализации)
+
+- `getPathWiki(): string[]` — Логика определения пути к целевому файлу Wiki на основе расположения исходного файла.
+- `getItemDate(): Date` — Получает дату изменения файла из `GitFileItem`.
+- `getTitle(): string` — Формирует стандартизированный заголовок для документации.
+- `readDemo(): string` — Читает содержимое настроенного демо-файла.
+- `readPrompt(): string` — Читает и подготавливает шаблон промпта, заменяя плейсхолдеры, такие как `[wikiLanguage]`.
+- `makeAi(): void` — Наполняет экземпляр ИИ соответствующим контекстом (код, демо и т. д.).
+- `initName(content: string): string` — Заменяет плейсхолдер `[title]` в сгенерированном контенте.
+
+## Типы
+
+### GitFileItem
+Представляет информацию о файле, управляемом Git.
+- `path: string` — относительный путь к файлу.
+- `pathByOS: string` — абсолютный путь, специфичный для ОС.
+- `date: string` — дата последнего изменения.
+- `item: any` — зарезервировано для дополнительных метаданных.

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

@@ -0,0 +1,61 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Classes/AiDocItemAbstract - Lớp Cơ sở Tự động hóa Tài liệu'/>
+
+# Lớp AiDocItemAbstract
+
+Một lớp cơ sở trừu tượng để tự động hóa việc tạo tài liệu bằng AI. Nó quản lý vòng đời của việc đọc các tệp nguồn, thu thập ngữ cảnh (mã nguồn, bản demo, lời nhắc) và phối hợp với dịch vụ AI để tạo hoặc cập nhật các tệp MDX và tệp nguồn.
+
+## Tính năng chính
+
+- **Vòng đời Tự động** — điều phối việc đọc mã nguồn, chạy bản dựng và tạo các bản cập nhật tài liệu.
+- **Quản lý Ngữ cảnh** — logic tích hợp để thu thập mã thành phần, mã nguồn gốc và dữ liệu demo giả cho ngữ cảnh AI.
+- **Cập nhật Thông minh** — tự động so sánh ngày sửa đổi để xác định xem có cần tạo lại hay không.
+- **Hệ thống Mẫu** — hỗ trợ các mẫu lời nhắc và thay đổi tiêu đề động (ví dụ: `[title]`).
+- **Tích hợp Bản dựng** — tích hợp với `BuildItem` để đảm bảo mã có thể dựng được trước khi viết tài liệu.
+- **Tạo có Chọn lọc** — hỗ trợ bỏ qua việc tạo tài liệu bằng cách sử dụng đánh dấu `// wiki:build-none`.
+
+## Khởi tạo
+
+Vì `AiDocItemAbstract` là một lớp trừu tượng, nó phải được kế thừa. Các lớp cụ thể phải cung cấp đường dẫn cho các tệp demo và mẫu lời nhắc.
+
+**Tham số khởi tạo:**
+- `path: string` — Đường dẫn thư mục gốc cho các tệp nguồn.
+- `item: GitFileItem` — Thông tin về tệp cụ thể đang được viết tài liệu.
+
+```typescript
+// Ví dụ về việc kế thừa và sử dụng AiDocItemAbstract
+class MyComponentDoc extends AiDocItemAbstract {
+  protected pathDemo = ['path', 'to', 'demo.ts']
+  protected pathPrompt = ['path', 'to', 'prompt.txt']
+}
+
+const doc = new MyComponentDoc('/source/dir', gitFileItem)
+await doc.make() // Kích hoạt chu trình tạo tài liệu
+```
+
+## Phương thức
+
+### Vòng đời
+
+- `make(): Promise<void>` — Điểm bắt đầu chính. Kiểm tra xem có cần cập nhật không, chuẩn bị ngữ cảnh, gọi AI và ghi kết quả.
+- `isBuildDisabled(): boolean` — Kiểm tra xem tệp nguồn có chứa đánh dấu `// wiki:build-none` hay không.
+
+## Các phương thức trừu tượng (Để triển khai)
+
+- `getPathWiki(): string[]` — Logic để xác định đường dẫn tệp Wiki mục tiêu dựa trên vị trí tệp nguồn.
+- `getItemDate(): Date` — Lấy ngày sửa đổi tệp từ `GitFileItem`.
+- `getTitle(): string` — Soạn thảo tiêu đề chuẩn hóa cho tài liệu.
+- `readDemo(): string` — Đọc nội dung của tệp demo đã cấu hình.
+- `readPrompt(): string` — Đọc và chuẩn bị mẫu lời nhắc, thay thế các trình giữ chỗ như `[wikiLanguage]`.
+- `makeAi(): void` — Hỗ trợ cung cấp cho instance AI các ngữ cảnh liên quan (mã, bản demo, v.v.).
+- `initName(content: string): string` — Thay thế trình giữ chỗ `[title]` trong nội dung được tạo.
+
+## Các kiểu dữ liệu
+
+### GitFileItem
+Đại diện cho thông tin tệp được quản lý bởi Git.
+- `path: string` — Đường dẫn tương đối đến tệp.
+- `pathByOS: string` — Đường dẫn tuyệt đối đặc thù của hệ điều hành.
+- `date: string` — Ngày sửa đổi cuối cùng.
+- `item: any` — Dành riêng cho siêu dữ liệu bổ sung.

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

@@ -0,0 +1,53 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Classes/AiDocItemClasses - AI Class Documentation Generator'/>
+
+# AiDocItemClasses Class
+
+A dedicated class for generating and updating documentation for TypeScript classes using AI. It automates the entire process, including reading source code, collecting context, interacting with AI models, and generating standardized MDX documentation files.
+
+## Key Features
+
+- **Automated Generation** — handles the full lifecycle of creating documentation from a class definition.
+- **Template-driven** — uses specialized prompt templates (`aiDocClassPrompt.en.txt`) to ensure consistent AI output.
+- **Demo-aware** — incorporates reference demonstration files (`demoClassEn.mdx`) to guide the AI in visual formatting.
+- **Smart Logic** — automatically determines Wiki paths and titles based on the source file structure.
+- **Build Guard** — integrates with the build system to ensure only valid, compilable code is documented.
+
+## Initialization
+
+Initialize the `AiDocItemClasses` by providing the source path and the target file information.
+
+**Parameters:**
+- `path: string` — the base directory path of the project.
+- `item: GitFileItem` — information about the specific TypeScript class file.
+
+```typescript
+import { AiDocItemClasses } from '@dxtmisha/scripts'
+
+const classDoc = new AiDocItemClasses('/src/classes', gitFileItem)
+
+// Generate the documentation
+await classDoc.make()
+```
+
+## Methods
+
+### Control
+
+- `make(): Promise<void>` — starts the documentation cycle: checks for updates, prepares context, invokes AI, and writes results.
+
+### Metadata
+
+- `getTitle(): string` — generates a standardized title for the documentation page.
+- `getPathWiki(): string[]` — calculates the target storage path in the Wiki based on the file's location.
+- `isBuildDisabled(): boolean` — checks if the source file is marked with `// wiki:build-none` to skip processing.
+
+## Types
+
+### GitFileItem
+Represents file information managed by Git.
+- `path: string` — Relative path to the file.
+- `pathByOS: string` — Absolute OS-specific path.
+- `date: string` — Last modification date.
+- `item: any` — Reserved for additional metadata.

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

@@ -0,0 +1,53 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Classes/AiDocItemClasses - Генератор документации классов через ИИ'/>
+
+# Класс AiDocItemClasses
+
+Специализированный класс для генерации и обновления документации TypeScript-классов с помощью ИИ. Он автоматизирует весь процесс: от чтения исходного кода и сбора контекста до взаимодействия с моделями ИИ и создания стандартизированных MDX-файлов документации.
+
+## Ключевые особенности
+
+- **Автоматизированная генерация** — управляет полным циклом создания документации на основе определения класса.
+- **На основе шаблонов** — использует специализированные шаблоны промптов (`aiDocClassPrompt.en.txt`) для обеспечения согласованных ответов ИИ.
+- **Демо-ориентированность** — использует эталонные демонстрационные файлы (`demoClassEn.mdx`), чтобы помочь ИИ в визуальном форматировании.
+- **Умная логика** — автоматически определяет пути в Wiki и заголовки на основе структуры исходного файла.
+- **Защита процесса сборки** — интегрируется с системой сборки, гарантируя, что документируется только корректный, компилируемый код.
+
+## Инициализация
+
+Инициализируйте `AiDocItemClasses`, указав путь к исходному коду и информацию о целевом файле.
+
+**Параметры:**
+- `path: string` — базовый путь к директории проекта.
+- `item: GitFileItem` — информация о конкретном TypeScript-файле класса.
+
+```typescript
+import { AiDocItemClasses } from '@dxtmisha/scripts'
+
+const classDoc = new AiDocItemClasses('/src/classes', gitFileItem)
+
+// Запуск генерации документации
+await classDoc.make()
+```
+
+## Методы
+
+### Управление
+
+- `make(): Promise<void>` — запускает цикл документирования: проверяет наличие обновлений, подготавливает контекст, вызывает ИИ и записывает результаты.
+
+### Метаданные
+
+- `getTitle(): string` — формирует стандартизированный заголовок для страницы документации.
+- `getPathWiki(): string[]` — рассчитывает путь хранения в Wiki на основе расположения файла.
+- `isBuildDisabled(): boolean` — проверяет, помечен ли файл маркером `// wiki:build-none` для пропуска обработки.
+
+## Типы
+
+### GitFileItem
+Представляет информацию о файле, управляемом Git.
+- `path: string` — относительный путь к файлу.
+- `pathByOS: string` — абсолютный путь, специфичный для ОС.
+- `date: string` — дата последнего изменения.
+- `item: any` — зарезервировано для дополнительных метаданных.

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

@@ -0,0 +1,53 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Classes/AiDocItemClasses - Trình Tạo Tài liệu Lớp bằng AI'/>
+
+# Lớp AiDocItemClasses
+
+Một lớp chuyên biệt để tạo và cập nhật tài liệu cho các lớp (classes) TypeScript bằng AI. Nó tự động hóa toàn bộ quy trình: từ đọc mã nguồn và thu thập ngữ cảnh đến tương tác với các mô hình AI và tạo tệp tài liệu MDX chuẩn hóa.
+
+## Tính năng chính
+
+- **Tạo Tự động** — quản lý toàn bộ vòng đời tạo tài liệu từ định nghĩa lớp.
+- **Dựa trên Mẫu** — sử dụng các mẫu lời nhắc chuyên biệt (`aiDocClassPrompt.en.txt`) để đảm bảo đầu ra AI nhất quán.
+- **Hỗ trợ Demo** — tận dụng các tệp trình diễn tham chiếu (`demoClassEn.mdx`) để hướng dẫn AI trong việc định dạng giao diện.
+- **Logic Thông minh** — tự động xác định đường dẫn Wiki và tiêu đề dựa trên cấu trúc tệp nguồn.
+- **Bảo vệ Bản dựng** — tích hợp với hệ thống bản dựng để đảm bảo chỉ những mã hợp lệ, có thể biên dịch mới được viết tài liệu.
+
+## Khởi tạo
+
+Khởi tạo `AiDocItemClasses` bằng cách cung cấp đường dẫn mã nguồn và thông tin tệp đích.
+
+**Tham số:**
+- `path: string` — đường dẫn thư mục gốc của dự án.
+- `item: GitFileItem` — thông tin về tệp lớp TypeScript cụ thể.
+
+```typescript
+import { AiDocItemClasses } from '@dxtmisha/scripts'
+
+const classDoc = new AiDocItemClasses('/src/classes', gitFileItem)
+
+// Kích hoạt việc tạo tài liệu
+await classDoc.make()
+```
+
+## Phương thức
+
+### Điều khiển
+
+- `make(): Promise<void>` — bắt đầu chu trình tài liệu: kiểm tra cập nhật, chuẩn bị ngữ cảnh, gọi AI và ghi kết quả.
+
+### Siêu dữ liệu (Metadata)
+
+- `getTitle(): string` — tạo tiêu đề chuẩn hóa cho trang tài liệu.
+- `getPathWiki(): string[]` — tính toán đường dẫn lưu trữ trong Wiki dựa trên vị trí tệp.
+- `isBuildDisabled(): boolean` — kiểm tra xem tệp nguồn có được đánh dấu `// wiki:build-none` để bỏ qua xử lý hay không.
+
+## Các kiểu dữ liệu
+
+### GitFileItem
+Đại diện cho thông tin tệp được quản lý bởi Git.
+- `path: string` — Đường dẫn tương đối đến tệp.
+- `pathByOS: string` — Đường dẫn tuyệt đối đặc thù của hệ điều hành.
+- `date: string` — Ngày sửa đổi cuối cùng.
+- `item: any` — Dành riêng cho siêu dữ liệu bổ sung.

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

@@ -0,0 +1,52 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Classes/AiDocItemComposables - AI Composable Documentation Generator'/>
+
+# AiDocItemComposables Class
+
+A specialized class for generating and updating documentation for Vue Composables using AI. It automates the process of analyzing composition functions, gathering context, and producing high-quality MDX documentation.
+
+## Key Features
+
+- **Composition-focused** — uses specialized templates (`aiDocComposablePrompt.en.txt`) tailored for documenting Vue composables.
+- **Visual Demos** — incorporates reference data from `demoComposableEn.mdx` to maintain a consistent look for composable documentation.
+- **Full Automation** — handles the technical steps of reading code, checking build status, and writing the final results.
+- **Intelligent Routing** — automatically calculates the appropriate Wiki storage path and page title.
+
+## Initialization
+
+Initialize the `AiDocItemComposables` by providing the project source path and the target file metadata.
+
+**Parameters:**
+- `path: string` — the base directory path of the project.
+- `item: GitFileItem` — information about the specific composable file.
+
+```typescript
+import { AiDocItemComposables } from '@dxtmisha/scripts'
+
+const composableDoc = new AiDocItemComposables('/src/composables', gitFileItem)
+
+// Generate the documentation
+await composableDoc.make()
+```
+
+## Methods
+
+### Control
+
+- `make(): Promise<void>` — executes the full documentation cycle: checks for updates, prepares the AI context, and writes the output.
+
+### Metadata
+
+- `getTitle(): string` — generates a standardized title for the composable documentation.
+- `getPathWiki(): string[]` — calculates the Wiki path based on the file's location in the project.
+- `isBuildDisabled(): boolean` — checks if the source file contains `// wiki:build-none` to skip generation.
+
+## Types
+
+### GitFileItem
+Represents file information managed by Git.
+- `path: string` — Relative path to the file.
+- `pathByOS: string` — Absolute OS-specific path.
+- `date: string` — Last modification date.
+- `item: any` — Reserved for additional metadata.

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

@@ -0,0 +1,52 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Classes/AiDocItemComposables - Генератор документации композаблов через ИИ'/>
+
+# Класс AiDocItemComposables
+
+Специализированный класс для генерации и обновления документации Vue-композаблов (Composables) с помощью ИИ. Он автоматизирует процесс анализа функций композиции, сбора контекста и создания высококачественной MDX-документации.
+
+## Ключевые особенности
+
+- **Ориентированность на Composables** — использует специальные шаблоны (`aiDocComposablePrompt.en.txt`), адаптированные для документирования функций композиции.
+- **Визуальные демо** — включает эталонные данные из `demoComposableEn.mdx` для поддержания единого стиля документации композаблов.
+- **Полная автоматизация** — берет на себя технические этапы: чтение кода, проверку статуса сборки и запись финальных результатов.
+- **Умная маршрутизация** — автоматически рассчитывает подходящий путь хранения в Wiki и заголовок страницы.
+
+## Инициализация
+
+Инициализируйте `AiDocItemComposables`, указав путь к проекту и метаданные целевого файла.
+
+**Параметры:**
+- `path: string` — базовый путь к директории проекта.
+- `item: GitFileItem` — информация о конкретном файле композабла.
+
+```typescript
+import { AiDocItemComposables } from '@dxtmisha/scripts'
+
+const composableDoc = new AiDocItemComposables('/src/composables', gitFileItem)
+
+// Запуск генерации документации
+await composableDoc.make()
+```
+
+## Методы
+
+### Управление
+
+- `make(): Promise<void>` — выполняет полный цикл документирования: проверяет наличие обновлений, подготавливает контекст для ИИ и записывает результат.
+
+### Метаданные
+
+- `getTitle(): string` — формирует стандартизированный заголовок для документации композабла.
+- `getPathWiki(): string[]` — рассчитывает путь в Wiki на основе расположения файла в проекте.
+- `isBuildDisabled(): boolean` — проверяет, содержит ли исходный файл маркер `// wiki:build-none`, чтобы пропустить генерацию.
+
+## Типы
+
+### GitFileItem
+Представляет информацию о файле, управляемом Git.
+- `path: string` — относительный путь к файлу.
+- `pathByOS: string` — абсолютный путь, специфичный для ОС.
+- `date: string` — дата последнего изменения.
+- `item: any` — зарезервировано для дополнительных метаданных.

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

@@ -0,0 +1,52 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Classes/AiDocItemComposables - Trình Tạo Tài liệu Composable bằng AI'/>
+
+# Lớp AiDocItemComposables
+
+Một lớp chuyên biệt để tạo và cập nhật tài liệu cho các Vue Composables bằng AI. Nó tự động hóa quy trình phân tích các hàm composition, thu thập ngữ cảnh và tạo tài liệu MDX chất lượng cao.
+
+## Tính năng chính
+
+- **Tập trung vào Composable** — sử dụng các mẫu chuyên biệt (`aiDocComposablePrompt.en.txt`) được thiết kế riêng để viết tài liệu cho các hàm composition.
+- **Bản demo Trực quan** — tích hợp dữ liệu tham chiếu từ `demoComposableEn.mdx` để duy trì giao diện nhất quán cho tài liệu composable.
+- **Tự động hóa Hoàn toàn** — xử lý các bước kỹ thuật như đọc mã, kiểm tra trạng thái bản dựng và ghi kết quả cuối cùng.
+- **Định tuyến Thông minh** — tự động tính toán đường dẫn lưu trữ Wiki phù hợp và tiêu đề trang.
+
+## Khởi tạo
+
+Khởi tạo `AiDocItemComposables` bằng cách cung cấp đường dẫn nguồn của dự án và siêu dữ liệu tệp đích.
+
+**Tham số:**
+- `path: string` — đường dẫn thư mục gốc của dự án.
+- `item: GitFileItem` — thông tin về tệp composable cụ thể.
+
+```typescript
+import { AiDocItemComposables } from '@dxtmisha/scripts'
+
+const composableDoc = new AiDocItemComposables('/src/composables', gitFileItem)
+
+// Kích hoạt việc tạo tài liệu
+await composableDoc.make()
+```
+
+## Phương thức
+
+### Điều khiển
+
+- `make(): Promise<void>` — thực hiện chu trình tài liệu đầy đủ: kiểm tra cập nhật, chuẩn bị ngữ cảnh AI và ghi kết quả.
+
+### Siêu dữ liệu (Metadata)
+
+- `getTitle(): string` — tạo tiêu đề chuẩn hóa cho tài liệu composable.
+- `getPathWiki(): string[]` — tính toán đường dẫn Wiki dựa trên vị trí của tệp trong dự án.
+- `isBuildDisabled(): boolean` — kiểm tra xem tệp nguồn có chứa `// wiki:build-none` để bỏ qua việc tạo hay không.
+
+## Các kiểu dữ liệu
+
+### GitFileItem
+Đại diện cho thông tin tệp được quản lý bởi Git.
+- `path: string` — Đường dẫn tương đối đến tệp.
+- `pathByOS: string` — Đường dẫn tuyệt đối đặc thù của hệ điều hành.
+- `date: string` — Ngày sửa đổi cuối cùng.
+- `item: any` — Dành riêng cho siêu dữ liệu bổ sung.

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

@@ -0,0 +1,49 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Classes/AiDocType - AI Documentation Type Manager'/>
+
+# AiDocType Class
+
+A management class that acts as a registry and selector for different documentation types. It determines which specialized documentation handler (e.g., for classes, functions, or composables) should be used for a given file based on its characteristics.
+
+## Key Features
+
+- **Dynamic Registration** — allows adding new documentation types to the system at runtime.
+- **Smart Selection** — automatically identifies the correct documentation handler for a file by iterating through registered types and executing their check logic.
+- **Delegation** — orchestrates the instantiation and execution of specialized documentation handlers (`AiDocItemAbstract` implementations).
+- **Static API** — provides a convenient static interface for global documentation management without needing instantiation.
+
+## Initialization
+
+`AiDocType` is designed to be used via its static methods. No initialization is required.
+
+```typescript
+import { AiDocType } from '@dxtmisha/scripts'
+
+// The engine uses this class internally to process file items:
+await AiDocType.make(gitFileItem)
+```
+
+## Methods
+
+### Documentation Management
+
+- `make(item: GitFileItem): Promise<void>` — (Static) Analyzes the provided file item, selects the matching documentation type, and triggers the generation process.
+
+### Registry Control
+
+- `add(type: AiDocTypeItem): void` — (Static) Registers a new documentation type at the beginning of the priority list.
+
+## Types
+
+### AiDocTypeItem
+Configuration for a documentation type handler.
+- `check: (item: GitFileItem) => boolean` — function to determine if this handler is suitable for the file.
+- `item: new (path: string, item: GitFileItem) => AiDocItemAbstract` — the handler class constructor.
+
+### GitFileItem
+Represents file information managed by Git.
+- `path: string` — Relative path to the file.
+- `pathByOS: string` — Absolute OS-specific path.
+- `date: string` — Last modification date.
+- `item: any` — Reserved for additional metadata.

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

@@ -0,0 +1,49 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Classes/AiDocType - Менеджер типов AI-документации'/>
+
+# Класс AiDocType
+
+Управляющий класс, который выступает в роли реестра и селектора для различных типов документации. Он определяет, какой специализированный обработчик (например, для классов, функций или композаблов) следует использовать для конкретного файла на основе его характеристик.
+
+## Ключевые особенности
+
+- **Динамическая регистрация** — позволяет добавлять новые типы документации в систему во время выполнения.
+- **Умный выбор** — автоматически идентифицирует подходящий обработчик, перебирая зарегистрированные типы и выполняя их логику проверки.
+- **Делегирование** — координирует создание экземпляров и выполнение специализированных обработчиков документации (реализаций `AiDocItemAbstract`).
+- **Статический API** — предоставляет удобный статический интерфейс для глобального управления документацией без необходимости создания экземпляров класса.
+
+## Инициализация
+
+`AiDocType` предназначен для использования через статические методы. Инициализация не требуется.
+
+```typescript
+import { AiDocType } from '@dxtmisha/scripts'
+
+// Движок использует этот класс внутри для обработки элементов файлов:
+await AiDocType.make(gitFileItem)
+```
+
+## Методы
+
+### Управление документацией
+
+- `make(item: GitFileItem): Promise<void>` — (Статический) Анализирует переданный элемент файла, выбирает соответствующий тип документации и запускает процесс генерации.
+
+### Управление реестром
+
+- `add(type: AiDocTypeItem): void` — (Статический) Регистрирует новый тип документации, добавляя его в начало приоритетного списка.
+
+## Типы
+
+### AiDocTypeItem
+Конфигурация для обработчика типа документации.
+- `check: (item: GitFileItem) => boolean` — функция определения применимости обработчика к файлу.
+- `item: new (path: string, item: GitFileItem) => AiDocItemAbstract` — конструктор класса обработчика.
+
+### GitFileItem
+Представляет информацию о файле, управляемом Git.
+- `path: string` — относительный путь к файлу.
+- `pathByOS: string` — абсолютный путь, специфичный для ОС.
+- `date: string` — дата последнего изменения.
+- `item: any` — зарезервировано для дополнительных метаданных.