@dxtmisha/wiki 0.25.1 → 0.39.2

package/src/media/functional/scripts/bin/dxt-component-wiki/design-component-wiki.vi.mdx

@@ -0,0 +1,54 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/bin/dxt-component-wiki - Tài Liệu Thành Phần Bằng AI'/>
+
+# dxt-component-wiki
+
+Lệnh `dxt-component-wiki` chịu trách nhiệm tự động hóa việc tạo ra các tài liệu AI chuyên sâu bao gồm tài liệu định dạng MDX, khai báo TypeScript theo loại (`types.ts`) và các bản phân tích Storybook cho hệ thống thiết kế.
+
+## Các tính năng chính
+
+- **Sinh Tệp Phân mảnh bằng AI**: Với một đường dẫn đến các thành phần gốc, bộ thực thi AI có khả năng định nghĩa hoàn toàn mới hoặc cập nhật thông minh cho những tệp định hướng tiêu chuẩn như ghi chú `MDX`, cấu trúc `types.ts`, hay `stories.ts`.
+- **Cơ chế Sao lưu Kế thừa**: Tiện ích lưu trữ an toàn các phiên bản trước được thay thế của tệp bằng cách gán thêm hậu tố `__old.txt` mỗi khi có những biến đổi dữ liệu, ngăn chặn sự mất mát mã nguồn vô ý.
+- **Tùy biến Thao tác AI**: Bao gồm khả năng tích hợp sẵn nhằm dễ dàng đính kèm lệnh hoặc dòng mô tả bổ sung của người dùng vào với câu lện prompt trước khi thực thi.
+
+## Nó hoạt động như thế nào?
+
+Luồng Tạo sinh Tài liệu AI xử lý dựa trên một đường dẫn thành phần đã có hiệu lực từ trước:
+1. Nó chạy tiến trình nền thiết kế mô phỏng nhằm đồng bộ tài nguyên xuất ra một hệ sinh thái phân phối tạm thời. Cho phép hệ thống ghi chú chính xác các hành vi của TypeScript.
+2. Nó truy vấn cấu hình cài đặt của bạn thông qua vị trí tệp để đặt bộ định dạng ngôn ngữ nội bộ cho prompt (ví dụ: `componentPrompt.vi.txt`) cũng như tổng hợp cả dữ liệu thực sự nguyên bản (Ghi chú MDX, nguồn Vue gốc, việc xây dựng mẫu storybook).
+3. Một hồi đáp hợp nhất được gửi về từ mô hình ngôn ngữ lớn có khả năng chia tách các phân đoạn mã hóa mới trên bộ trích xuất `ComponentWikiFile` trực tiếp đổ vào bên trong hệ thống kho lưu trữ của bạn.
+
+## Cách thiết lập và khởi chạy
+
+Cấu hình của trình tạo AI được định nghĩa tập trung trong tệp `design.config.json` của dự án của bạn. **Hãy tạo tệp này tại thư mục gốc của dự án.** Làm theo các bước sau để thiết lập:
+
+1. **Thiết lập các tham số AI trong `design.config.json`**:
+   Bạn cần thêm trực tiếp khóa API (API key), loại mô hình mục tiêu và ngôn ngữ tạo tài liệu vào trong đối tượng cấu hình dự án. Tham số `wikiLanguage` chịu trách nhiệm quy định cả ngôn ngữ phân tích bên trong MDX và cả câu lệnh (prompt) cơ sở tự động được triệu hồi cho riêng ngôn ngữ đó (ví dụ, `componentPrompt.vi.txt`).
+   ```json
+   {
+     "wikiLanguage": "vi",
+     "aiType": "gemini",
+     "aiModel": "gemini-2.0-flash",
+     "aiKey": "API_KEY_CUA_BAN"
+   }
+   ```
+2. **Thực thi Tạo sinh Tài liệu AI đối với một thành phần**:
+   Trong tình huống cần phân tích qua AI đối với 1 thành phần cụ thể, vui lòng đáp ứng tên của đường dẫn tương đối trỏ đến nó (ví dụ như `Button`). Bên cạnh đó, bạn cũng có quyền tùy chọn đính kèm riêng chỉ thị thông qua thông số tùy biến cuối:
+   ```bash
+   npx dxt-component-wiki <component-path> "[optional-prompt-instruction]"
+   ```
+   **Ví dụ:**
+   ```bash
+   npx dxt-component-wiki "ButtonBase" "Hãy đảm bảo rằng tài liệu đề cập đến việc nó bị vô hiệu hóa (disabled) theo mặc định"
+   ```
+
+## Thông tin chi tiết bổ sung
+
+### Phụ thuộc vào quá trình Biên dịch cấu trúc hệ thống
+
+Khả năng sinh tự động với bộ chứa dữ liệu AI phối hợp cực kỳ chặt chẽ với những trạng thái chương trình thời gian thực. Theo đó kĩ thuật sẽ khởi tạo ra luồng thông dịch `npm run build` trong suốt môi trường chạy `dist-temporary`. **Nếu dự án hiện tại rơi vào thất bại từ quá trình biên dịch dữ liệu hay cấu trúc TypeScript của hệ thống sinh ra lỗi chập chội bất kỳ, tài nguyên thực thi văn cảnh tài liệu tự sinh bởi AI đó sẽ ngay lập tức đối mặt với thất bại lỗi toàn tập.**
+
+### Sinh cơ chế Lưu Trữ Tự động (`__old.txt`)
+
+Ngay khi cơ chế của tệp `ComponentWikiFile` kết luận rằng sự đổi mới đến từ tài nguyên sau khi xử lý chênh lệch tính phân bổ về mã với độ đậm khác xa so với cấu tạo sẵn có. Một mô hình hoạt động thông minh sẽ tích cực lưu giữ lại thực thể dữ liệu gốc với đuôi mở rộng dưới dạng `[tên_tệp]__old.txt` thiết lập nên khả năng quay về phương pháp mã hồi phục (roll-back) không phức tạp nào.

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

@@ -0,0 +1,88 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Classes/AiAbstract - Abstract AI Base Class'/>
+
+# AiAbstract Class
+
+An abstract base class designed to provide common mechanics for various AI integrations. It handles prompt accumulation, model selection, and provides a unified workflow for receiving responses from different AI providers.
+
+## Key Features
+
+- **Prompt Accumulation** — mechanisms to collect and compose prompt context before sending it to the model.
+- **Model Management** — easy switching between different AI models within the same instance.
+- **Unified Workflow** — a standardized `generate` method that normalizes the process of getting a response.
+- **Image & Content Support** — built-in methods to accumulate images and additional text contents for multimodal models.
+- **Chainable API** — most configuration methods support chaining for a more fluent developer experience.
+- **Implementation Hooks** — clear extension points (`init`, `response`, `toImages`, `toContents`) for concrete AI service implementations (e.g., OpenAI, Anthropic).
+
+## Initialization
+
+Since `AiAbstract` is an abstract class, it cannot be instantiated directly. You should use a concrete implementation (e.g., `AiOpenAI` or `AiAnthropic`).
+
+**Constructor Parameters:**
+- `key: string` — The API key for the AI service.
+- `model: string` — The initial model identifier (e.g., 'gpt-4o').
+
+```typescript
+// Example of a concrete implementation usage
+const ai = new AiOpenAI(process.env.OPENAI_API_KEY, 'gpt-4o')
+
+// Adding context
+ai.addPrompt('You are a helpful assistant.')
+  .addContent('Explain quantum physics in simple terms.')
+
+// Generating response
+const response = await ai.generate('Focus on wave-particle duality.')
+```
+
+## Methods
+
+### Information
+
+- `getImages(): AiImageList` — Returns the list of accumulated images.
+- `getContents(): string[]` — Returns the list of accumulated additional contents.
+
+### Configuration (Setters)
+
+Methods in this group support chaining.
+
+- `setKey(key: string): this` — Sets or switches the API key. Re-initializes the client if it's already active.
+- `setModel(model: string): this` — Switches the current model for generation.
+- `addPrompt(prompt: string): void` — Appends a new line to the persistent prompt buffer.
+- `addImage(image: AiImageItem): this` — Adds an image to the accumulation list.
+- `addContent(content: string): this` — Adds text content to the accumulation list.
+
+### Control
+
+- `generate(contents: string): Promise<string>` — The main method to trigger AI generation. It combines the accumulated prompt and the provided string, then calls the concrete implementation.
+- `resetImages(): this` — Clears the accumulated image list.
+- `resetContents(): this` — Clears the accumulated contents.
+- `resetPrompt(): void` — Clears the persistent prompt prefix.
+
+## Abstract Methods (Implementation)
+
+When extending `AiAbstract`, you must implement the following protected methods:
+
+- `init(): void` — Handle client initialization, authentication, and transport setup.
+- `toImages(): void` — Logic to convert accumulated images to a provider-specific format.
+- `toContents(): void` — Logic to convert accumulated contents to a provider-specific format.
+- `response(model: string, contents: string): Promise<string>` — The core logic to invoke the specific AI model and return the result as a string.
+
+## Types
+
+### AiImageList
+An array of `AiImageItem` objects.
+```typescript
+type AiImageList = AiImageItem[]
+```
+
+### AiImageItem
+Represents an image in base64 format.
+- `mime: string` — The MIME type of the image (e.g., 'image/png').
+- `base64: string` — The base64 encoded image data.
+```typescript
+type AiImageItem = {
+  mime: string
+  base64: string
+}
+```

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.