@dxtmisha/wiki 0.39.1 → 0.39.2

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

@@ -0,0 +1,88 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Classes/AiAbstract - Абстрактный базовый класс AI'/>
+
+# Класс AiAbstract
+
+Абстрактный базовый класс, предназначенный для обеспечения общей механики различных интеграций с ИИ. Он управляет накоплением промптов, выбором моделей и предоставляет унифицированный рабочий процесс для получения ответов от различных провайдеров ИИ.
+
+## Ключевые особенности
+
+- **Накопление промптов** — механизмы для сбора и компоновки контекста запроса перед его отправкой в модель.
+- **Управление моделями** — простое переключение между различными моделями ИИ в рамках одного экземпляра.
+- **Унифицированный процесс** — стандартизированный метод `generate`, который нормализует процесс получения ответа.
+- **Поддержка изображений и контента** — встроенные методы для накопления изображений и дополнительного текстового содержимого для мультимодальных моделей.
+- **Chainable API** — большинство методов настройки поддерживают цепочку вызовов (чейнинг) для удобства разработки.
+- **Точки расширения** — четкие хуки реализации (`init`, `response`, `toImages`, `toContents`) для конкретных сервисов ИИ (например, OpenAI, Anthropic).
+
+## Инициализация
+
+Поскольку `AiAbstract` является абстрактным классом, его нельзя инициализировать напрямую. Вы должны использовать конкретную реализацию (например, `AiOpenAI` или `AiAnthropic`).
+
+**Параметры конструктора:**
+- `key: string` — API-ключ для сервиса ИИ.
+- `model: string` — начальный идентификатор модели (например, 'gpt-4o').
+
+```typescript
+// Пример использования конкретной реализации
+const ai = new AiOpenAI(process.env.OPENAI_API_KEY, 'gpt-4o')
+
+// Добавление контекста
+ai.addPrompt('Вы — полезный помощник.')
+  .addContent('Объясните квантовую физику простыми словами.')
+
+// Генерация ответа
+const response = await ai.generate('Сделайте акцент на корпускулярно-волновом дуализме.')
+```
+
+## Методы
+
+### Информационные
+
+- `getImages(): AiImageList` — Возвращает список накопленных изображений.
+- `getContents(): string[]` — Возвращает список накопленного дополнительного содержимого.
+
+### Настройка (Сеттеры)
+
+Методы этой группы поддерживают цепочку вызовов.
+
+- `setKey(key: string): this` — Устанавливает или переключает API-ключ. Переинициализирует клиент, если он уже активен.
+- `setModel(model: string): this` — Переключает текущую модель для генерации.
+- `addPrompt(prompt: string): void` — Добавляет новую строку в постоянный буфер промпта.
+- `addImage(image: AiImageItem): this` — Добавляет изображение в список накопления.
+- `addContent(content: string): this` — Добавляет текстовый контент в список накопления.
+
+### Управление
+
+- `generate(contents: string): Promise<string>` — Основной метод для запуска генерации ИИ. Объединяет накопленный промпт с переданной строкой и вызывает конкретную реализацию.
+- `resetImages(): this` — Очищает список накопленных изображений.
+- `resetContents(): this` — Очищает список накопленного содержимого.
+- `resetPrompt(): void` — Полностью очищает постоянный префикс промпта.
+
+## Абстрактные методы (Для реализации)
+
+При наследовании от `AiAbstract` необходимо реализовать следующие защищенные методы:
+
+- `init(): void` — Обработка инициализации клиента, аутентификации и настройки транспорта.
+- `toImages(): void` — Логика преобразования накопленных изображений в формат, специфичный для провайдера.
+- `toContents(): void` — Логика преобразования накопленного содержимого в формат, специфичный для провайдера.
+- `response(model: string, contents: string): Promise<string>` — Основная логика вызова конкретной модели ИИ и возврата результата в виде строки.
+
+## Типы
+
+### AiImageList
+Массив объектов `AiImageItem`.
+```typescript
+type AiImageList = AiImageItem[]
+```
+
+### AiImageItem
+Представляет изображение в формате base64.
+- `mime: string` — MIME-тип изображения (например, 'image/png').
+- `base64: string` — данные изображения в кодировке base64.
+```typescript
+type AiImageItem = {
+  mime: string
+  base64: string
+}
+```

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

@@ -0,0 +1,88 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Classes/AiAbstract - Lớp Cơ sở AI Trừu tượng'/>
+
+# Lớp AiAbstract
+
+Một lớp cơ sở trừu tượng được thiết kế để cung cấp các cơ chế chung cho các tích hợp AI khác nhau. Nó xử lý việc tích lũy lời nhắc (prompt accumulation), lựa chọn mô hình và cung cấp một quy trình làm việc thống nhất để nhận phản hồi từ các nhà cung cấp AI khác nhau.
+
+## Tính năng chính
+
+- **Tích lũy Lời nhắc** — các cơ chế để thu thập và soạn thảo ngữ cảnh lời nhắc trước khi gửi đến mô hình.
+- **Quản lý Mô hình** — dễ dàng chuyển đổi giữa các mô hình AI khác nhau trong cùng một instance.
+- **Quy trình Thống nhất** — phương thức `generate` chuẩn hóa quy trình nhận phản hồi.
+- **Hỗ trợ Hình ảnh & Nội dung** — các phương thức tích hợp để tích lũy hình ảnh và nội dung văn bản bổ sung cho các mô hình đa phương thức.
+- **API dạng Chuỗi (Chainable)** — hầu hết các phương thức cấu hình đều hỗ trợ chuỗi lệnh để mang lại trải nghiệm lập trình mượt mà hơn.
+- **Điểm mở rộng (Hooks)** — các điểm mở rộng rõ ràng (`init`, `response`, `toImages`, `toContents`) cho các triển khai dịch vụ AI cụ thể (ví dụ: OpenAI, Anthropic).
+
+## Khởi tạo
+
+Vì `AiAbstract` là một lớp trừu tượng, nó không thể được khởi tạo trực tiếp. Bạn nên sử dụng một triển khai cụ thể (ví dụ: `AiOpenAI` hoặc `AiAnthropic`).
+
+**Tham số khởi tạo:**
+- `key: string` — API key cho dịch vụ AI.
+- `model: string` — Định danh mô hình ban đầu (ví dụ: 'gpt-4o').
+
+```typescript
+// Ví dụ về cách sử dụng một triển khai cụ thể
+const ai = new AiOpenAI(process.env.OPENAI_API_KEY, 'gpt-4o')
+
+// Thêm ngữ cảnh
+ai.addPrompt('Bạn là một trợ lý hữu ích.')
+  .addContent('Giải thích vật lý lượng tử bằng các thuật ngữ đơn giản.')
+
+// Tạo phản hồi
+const response = await ai.generate('Tập trung vào tính lưỡng tính sóng-hạt.')
+```
+
+## Phương thức
+
+### Thông tin
+
+- `getImages(): AiImageList` — Trả về danh sách các hình ảnh đã tích lũy.
+- `getContents(): string[]` — Trả về danh sách các nội dung bổ sung đã tích lũy.
+
+### Cấu hình (Setters)
+
+Các phương thức trong nhóm này hỗ trợ chuỗi lệnh.
+
+- `setKey(key: string): this` — Thiết lập hoặc thay đổi API key. Khởi tạo lại client nếu nó đã hoạt động.
+- `setModel(model: string): this` — Thay đổi mô hình hiện tại để tạo phản hồi.
+- `addPrompt(prompt: string): void` — Thêm một dòng mới vào bộ đệm lời nhắc cố định.
+- `addImage(image: AiImageItem): this` — Thêm một hình ảnh vào danh sách tích lũy.
+- `addContent(content: string): this` — Thêm nội dung văn bản vào danh sách tích lũy.
+
+### Điều khiển
+
+- `generate(contents: string): Promise<string>` — Phương thức chính để kích hoạt việc tạo phản hồi từ AI. Nó kết hợp lời nhắc đã tích lũy với chuỗi văn bản được cung cấp, sau đó gọi triển khai cụ thể.
+- `resetImages(): this` — Xóa danh sách hình ảnh đã tích lũy.
+- `resetContents(): this` — Xóa danh sách nội dung đã tích lũy.
+- `resetPrompt(): void` — Xóa tiền tố lời nhắc cố định.
+
+## Các phương thức trừu tượng (Để triển khai)
+
+Khi kế thừa `AiAbstract`, bạn phải triển khai các phương thức protected sau:
+
+- `init(): void` — Xử lý khởi tạo client, xác thực và thiết lập phương thức truyền tải.
+- `toImages(): void` — Logic để chuyển đổi các hình ảnh đã tích lũy sang định dạng cụ thể của nhà cung cấp.
+- `toContents(): void` — Logic để chuyển đổi các nội dung đã tích lũy sang định dạng cụ thể của nhà cung cấp.
+- `response(model: string, contents: string): Promise<string>` — Logic cốt lõi để gọi mô hình AI cụ thể và trả về kết quả dưới dạng văn bản.
+
+## Các kiểu dữ liệu
+
+### AiImageList
+Một mảng các đối tượng `AiImageItem`.
+```typescript
+type AiImageList = AiImageItem[]
+```
+
+### AiImageItem
+Đại diện cho một hình ảnh ở định dạng base64.
+- `mime: string` — Kiểu MIME của hình ảnh (ví dụ: 'image/png').
+- `base64: string` — Dữ liệu hình ảnh được mã hóa base64.
+```typescript
+type AiImageItem = {
+  mime: string
+  base64: string
+}
+```

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

@@ -0,0 +1,37 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Classes/AiDoc - AI Documentation Engine'/>
+
+# AiDoc Class
+
+The central engine for orchestrating AI-driven documentation generation across the project. It coordinates reading configuration, scanning directories, and delegating documentation tasks to specialized AI handlers.
+
+## Key Features
+
+- **Batch Processing** — automatically iterates through configured directories to generate documentation for multiple files.
+- **Project-wide Integration** — reads project settings via `PropertiesConfig` to determine target paths and scopes.
+- **Git Intelligence** — uses `GitRead` to identify relevant files and filter them based on repository status.
+- **Error Resilience** — robust error handling during the documentation process to ensure the engine fails gracefully or reports issues clearly.
+
+## Initialization
+
+The `AiDoc` class is typically instantiated as a singleton or a main coordinator to start the documentation build.
+
+```typescript
+import { AiDoc } from '@dxtmisha/scripts'
+
+const engine = new AiDoc()
+
+// Start processing all configured directories
+await engine.make()
+```
+
+## Methods
+
+### Control
+
+- `make(): Promise<void>` — the main entry point. Reads configuration and starts processing all defined documentation directories.
+- `makeDirectory(dir: string): Promise<void>` — processes all relevant files within a specific directory by delegating to specialized AI handlers.
+
+
+A high-level coordinator that doesn't expose public configuration properties or complex state.

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

@@ -0,0 +1,37 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Classes/AiDoc - Движок AI-документирования'/>
+
+# Класс AiDoc
+
+Центральный движок для координации процесса генерации AI-документации во всем проекте. Он управляет чтением конфигурации, сканированием директорий и делегированием задач по документированию специализированным обработчикам ИИ.
+
+## Ключевые особенности
+
+- **Пакетная обработка** — автоматически перебирает настроенные директории для генерации документации сразу для множества файлов.
+- **Интеграция на уровне проекта** — считывает настройки проекта через `PropertiesConfig` для определения целевых путей и областей охвата.
+- **Интеграция с Git** — использует `GitRead` для идентификации релевантных файлов и их фильтрации на основе статуса репозитория.
+- **Устойчивость к ошибкам** — надежная обработка исключений в процессе документирования для обеспечения стабильной работы или четкого сообщения о проблемах.
+
+## Инициализация
+
+Класс `AiDoc` обычно инициализируется как основной координатор для запуска процесса сборки документации.
+
+```typescript
+import { AiDoc } from '@dxtmisha/scripts'
+
+const engine = new AiDoc()
+
+// Запуск обработки всех настроенных директорий
+await engine.make()
+```
+
+## Методы
+
+### Управление
+
+- `make(): Promise<void>` — основная точка входа. Считывает конфигурацию и запускает обработку всех определенных директорий документации.
+- `makeDirectory(dir: string): Promise<void>` — обрабатывает все соответствующие файлы внутри конкретной директории, делегируя задачи специализированным обработчикам ИИ.
+
+
+Высокоуровневый координатор, который не предоставляет открытых свойств конфигурации или сложного внутреннего состояния.

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

@@ -0,0 +1,37 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Classes/AiDoc - Công cụ Tài liệu hóa bằng AI'/>
+
+# Lớp AiDoc
+
+Công cụ trung tâm để điều phối việc tạo tài liệu bằng AI trong toàn bộ dự án. Nó chịu trách nhiệm đọc cấu hình, quét các thư mục và phân phối các nhiệm vụ tài liệu cho các trình xử lý AI chuyên biệt.
+
+## Tính năng chính
+
+- **Xử lý Hàng loạt** — tự động lặp qua các thư mục đã cấu hình để tạo tài liệu cho nhiều tệp cùng lúc.
+- **Tích hợp Toàn diện** — đọc các thiết lập dự án thông qua `PropertiesConfig` để xác định các đường dẫn và phạm vi mục tiêu.
+- **Tích hợp Git** — sử dụng `GitRead` để nhận diện các tệp liên quan và lọc chúng dựa trên trạng thái của kho lưu trữ.
+- **Khả năng Chịu lỗi** — xử lý lỗi mạnh mẽ trong quá trình tạo tài liệu để đảm bảo hệ thống hoạt động ổn định hoặc báo cáo sự cố một cách rõ ràng.
+
+## Khởi tạo
+
+Lớp `AiDoc` thường được khởi tạo như một trình điều phối chính để bắt đầu quá trình tạo tài liệu.
+
+```typescript
+import { AiDoc } from '@dxtmisha/scripts'
+
+const engine = new AiDoc()
+
+// Bắt đầu xử lý tất cả các thư mục đã cấu hình
+await engine.make()
+```
+
+## Phương thức
+
+### Điều khiển
+
+- `make(): Promise<void>` — điểm bắt đầu chính. Đọc cấu hình và bắt đầu xử lý tất cả các thư mục tài liệu đã được xác định.
+- `makeDirectory(dir: string): Promise<void>` — xử lý tất cả các tệp liên quan trong một thư mục cụ thể bằng cách ủy quyền cho các trình xử lý AI chuyên biệt.
+
+
+Một trình điều phối cấp cao không công khai các thuộc tính cấu hình hoặc trạng thái phức tạp.

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

@@ -0,0 +1,52 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Classes/AiDocItem - AI Function Documentation Generator'/>
+
+# AiDocItem Class
+
+A dedicated class for generating and updating documentation for TypeScript functions using AI. It streamlines the creation of detailed function descriptions, parameter explanations, and usage examples.
+
+## Key Features
+
+- **Function-optimized** — uses specialized templates (`aiDocFunctionPrompt.en.txt`) designed for documenting logic-driven code.
+- **Visual Consistency** — leverages reference data from `demoDocEn.mdx` to produce documentation that fits the project's standard format.
+- **End-to-End Workflow** — handles everything from reading the source function to writing the final MDX file.
+- **Smart Metadata** — automatically determines the correct Wiki path and generates a standardized page title.
+
+## Initialization
+
+Initialize the `AiDocItem` 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 function file.
+
+```typescript
+import { AiDocItem } from '@dxtmisha/scripts'
+
+const functionDoc = new AiDocItem('/src/functions', gitFileItem)
+
+// Generate the documentation
+await functionDoc.make()
+```
+
+## Methods
+
+### Control
+
+- `make(): Promise<void>` — manages the complete documentation process: update checks, AI context preparation, and result writing.
+
+### Metadata
+
+- `getTitle(): string` — generates a standardized title for the function documentation page.
+- `getPathWiki(): string[]` — calculates the Wiki storage path based on the file's location.
+- `isBuildDisabled(): boolean` — checks if the source file is marked with `// 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/AiDocItem/AiDocItem.ru.mdx

@@ -0,0 +1,52 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Classes/AiDocItem - Генератор документации функций через ИИ'/>
+
+# Класс AiDocItem
+
+Специализированный класс для генерации и обновления документации TypeScript-функций с помощью ИИ. Он упрощает создание подробных описаний функций, пояснений к параметрам и примеров использования.
+
+## Ключевые особенности
+
+- **Оптимизация для функций** — использует специальные шаблоны (`aiDocFunctionPrompt.en.txt`), разработанные для документирования логики и алгоритмов.
+- **Визуальное единство** — использует эталонные данные из `demoDocEn.mdx` для создания документации, соответствующей стандартам проекта.
+- **Полный рабочий процесс** — берет на себя все этапы: от чтения исходной функции до записи финального MDX-файла.
+- **Умные метаданные** — автоматически определяет корректный путь в Wiki и формирует стандартизированный заголовок страницы.
+
+## Инициализация
+
+Инициализируйте `AiDocItem`, указав путь к проекту и метаданные целевого файла.
+
+**Параметры:**
+- `path: string` — базовый путь к директории проекта.
+- `item: GitFileItem` — информация о конкретном файле функции.
+
+```typescript
+import { AiDocItem } from '@dxtmisha/scripts'
+
+const functionDoc = new AiDocItem('/src/functions', gitFileItem)
+
+// Запуск генерации документации
+await functionDoc.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/AiDocItem/AiDocItem.vi.mdx

@@ -0,0 +1,52 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Classes/AiDocItem - Trình Tạo Tài liệu Hàm bằng AI'/>
+
+# Lớp AiDocItem
+
+Một lớp chuyên biệt để tạo và cập nhật tài liệu cho các hàm TypeScript bằng AI. Nó giúp hợp lý hóa việc tạo các mô tả hàm chi tiết, giải thích tham số và cung cấp các ví dụ sử dụng.
+
+## Tính năng chính
+
+- **Tối ưu cho Hàm** — sử dụng các mẫu chuyên biệt (`aiDocFunctionPrompt.en.txt`) được thiết kế để viết tài liệu cho các đoạn mã thiên về logic.
+- **Tính nhất quán Trực quan** — tận dụng dữ liệu tham chiếu từ `demoDocEn.mdx` để tạo ra tài liệu phù hợp với định dạng tiêu chuẩn của dự án.
+- **Quy trình Hoàn chỉnh** — xử lý mọi thứ từ việc đọc hàm nguồn đến việc ghi tệp MDX cuối cùng.
+- **Siêu dữ liệu Thông minh** — tự động xác định đường dẫn Wiki chính xác và tạo tiêu đề trang chuẩn hóa.
+
+## Khởi tạo
+
+Khởi tạo `AiDocItem` 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 hàm cụ thể.
+
+```typescript
+import { AiDocItem } from '@dxtmisha/scripts'
+
+const functionDoc = new AiDocItem('/src/functions', gitFileItem)
+
+// Kích hoạt việc tạo tài liệu
+await functionDoc.make()
+```
+
+## Phương thức
+
+### Điều khiển
+
+- `make(): Promise<void>` — quản lý toàn bộ quy trình tài liệu: 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 trang tài liệu hàm.
+- `getPathWiki(): string[]` — tính toán đường dẫn lưu trữ 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 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/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.