@dxtmisha/wiki 0.39.1 → 0.39.3

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` — зарезервировано для дополнительных метаданных.

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

@@ -0,0 +1,49 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Classes/AiDocType - Trình Quản lý Loại Tài liệu AI'/>
+
+# Lớp AiDocType
+
+Một lớp quản lý đóng vai trò như một kho đăng ký và trình lựa chọn cho các loại tài liệu khác nhau. Nó xác định trình xử lý tài liệu chuyên biệt nào (ví dụ: cho lớp, hàm hoặc composable) sẽ được sử dụng cho một tệp nhất định dựa trên các đặc điểm của tệp đó.
+
+## Tính năng chính
+
+- **Đăng ký Động** — cho phép thêm các loại tài liệu mới vào hệ thống trong thời gian chạy.
+- **Lựa chọn Thông minh** — tự động xác định trình xử lý tài liệu chính xác cho tệp bằng cách lặp qua các loại đã đăng ký và thực thi logic kiểm tra của chúng.
+- **Ủy quyền** — điều phối việc khởi tạo và thực thi các trình xử lý tài liệu chuyên biệt (các triển khai của `AiDocItemAbstract`).
+- **API Tĩnh** — cung cấp một giao diện tĩnh thuận tiện cho việc quản lý tài liệu toàn cầu mà không cần khởi tạo đối tượng.
+
+## Khởi tạo
+
+`AiDocType` được thiết kế để sử dụng thông qua các phương thức tĩnh. Không cần khởi tạo.
+
+```typescript
+import { AiDocType } from '@dxtmisha/scripts'
+
+// Công cụ sử dụng lớp này nội bộ để xử lý các mục tệp:
+await AiDocType.make(gitFileItem)
+```
+
+## Phương thức
+
+### Quản lý Tài liệu
+
+- `make(item: GitFileItem): Promise<void>` — (Tĩnh) Phân tích mục tệp được cung cấp, chọn loại tài liệu phù hợp và kích hoạt quy trình tạo.
+
+### Kiểm soát Kho đăng ký
+
+- `add(type: AiDocTypeItem): void` — (Tĩnh) Đăng ký một loại tài liệu mới vào đầu danh sách ưu tiên.
+
+## Các kiểu dữ liệu
+
+### AiDocTypeItem
+Cấu hình cho trình xử lý loại tài liệu.
+- `check: (item: GitFileItem) => boolean` — hàm xác định xem trình xử lý này có phù hợp với tệp hay không.
+- `item: new (path: string, item: GitFileItem) => AiDocItemAbstract` — hàm khởi tạo lớp xử lý.
+
+### 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/AiGoogle/AiGoogle.en.mdx

@@ -0,0 +1,60 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Classes/AiGoogle - Auto-configured Google Gemini AI'/>
+
+# AiGoogle Class
+
+A high-level implementation of the Google Gemini AI integration. The `AiGoogle` class extends `AiGoogleLite` and automatically initializes itself with the API key and model ID specified in the project's configuration files.
+
+## Key Features
+
+- **Zero-config Initialization** — automatically loads API credentials and model settings from the project environment.
+- **Gemini Powered** — provides access to Google's state-of-the-art generative models.
+- **Inherited Robustness** — includes all features from `AiGoogleLite`, such as multimodal support (text + images) and complex prompt accumulation.
+- **Simplified Workflow** — ideal for use within the project's documentation engine where manual configuration is not needed.
+
+## Initialization
+
+Unlike `AiGoogleLite`, the `AiGoogle` class does not require constructor parameters as it pulls settings from `getConfigAi()`.
+
+```typescript
+import { AiGoogle } from '@dxtmisha/scripts'
+
+const ai = new AiGoogle()
+
+// Optionally override the model if needed
+ai.setModel('gemini-1.5-pro')
+
+// Generate a response
+const response = await ai.generate('Generate a brief description of the project.')
+```
+
+## Methods
+
+### Generation
+
+- `generate(contents: string): Promise<string>` — (Inherited) Combines accumulated context and performs the AI generation request.
+
+### Configuration
+
+- `setKey(key: string): this` — (Inherited) Updates the API key and re-initializes the internal client.
+- `setModel(model: string): this` — (Inherited) Switches the active model.
+
+### Context Building
+
+- `addPrompt(prompt: string): void` — (Inherited) Appends a persistent text prefix.
+- `addContent(content: string): this` — (Inherited) Adds a text part to the prompt.
+- `addImage(image: AiImageItem): this` — (Inherited) Appends an image (base64) to the request.
+- `resetPrompt(): void` — (Inherited) Clears the persistent prefix.
+- `resetContents(): this` — (Inherited) Clears accumulated text parts.
+- `resetImages(): this` — (Inherited) Clears accumulated images.
+
+## Types
+
+### AiImageItem
+Represents an image for multimodal requests.
+- `mime: string` — the MIME type of the image.
+- `base64: string` — the image data in base64 format.
+
+### AiImageList
+An array of `AiImageItem`.

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

@@ -0,0 +1,60 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Classes/AiGoogle - Автоконфигурируемый Google Gemini AI'/>
+
+# Класс AiGoogle
+
+Высокоуровневая реализация интеграции с Google Gemini AI. Класс `AiGoogle` расширяет `AiGoogleLite` и автоматически инициализирует себя, используя API-ключ и идентификатор модели, указанные в файлах конфигурации проекта.
+
+## Ключевые особенности
+
+- **Инициализация без конфигурации** — автоматически загружает учетные данные API и настройки модели из окружения проекта.
+- **На базе Gemini** — предоставляет доступ к современным генеративным моделям от Google.
+- **Наследуемая надежность** — включает все функции `AiGoogleLite`, такие как мультимодальная поддержка (текст + изображения) и накопление сложных промптов.
+- **Упрощенный процесс** — идеально подходит для использования внутри движка документирования проекта, где не требуется ручная настройка.
+
+## Инициализация
+
+В отличие от `AiGoogleLite`, класс `AiGoogle` не требует параметров конструктора, так как он получает настройки из `getConfigAi()`.
+
+```typescript
+import { AiGoogle } from '@dxtmisha/scripts'
+
+const ai = new AiGoogle()
+
+// При необходимости можно переключить модель
+ai.setModel('gemini-1.5-pro')
+
+// Генерация ответа
+const response = await ai.generate('Создайте краткое описание проекта.')
+```
+
+## Методы
+
+### Генерация
+
+- `generate(contents: string): Promise<string>` — (Унаследовано) Объединяет накопленный контекст и выполняет запрос к ИИ.
+
+### Конфигурация
+
+- `setKey(key: string): this` — (Унаследовано) Обновляет API-ключ и переинициализирует внутренний клиент.
+- `setModel(model: string): this` — (Унаследовано) Переключает активную модель.
+
+### Сбор контекста
+
+- `addPrompt(prompt: string): void` — (Унаследовано) Добавляет постоянный текстовый префикс.
+- `addContent(content: string): this` — (Унаследовано) Добавляет текстовую часть к промпту.
+- `addImage(image: AiImageItem): this` — (Унаследовано) Добавляет изображение (base64) к запросу.
+- `resetPrompt(): void` — (Унаследовано) Очищает постоянный префикс.
+- `resetContents(): this` — (Унаследовано) Очищает все накопленные части текста.
+- `resetImages(): this` — (Унаследовано) Очищает все накопленные изображения.
+
+## Типы
+
+### AiImageItem
+Представляет изображение для мультимодальных запросов.
+- `mime: string` — MIME-тип изображения.
+- `base64: string` — данные изображения в формате base64.
+
+### AiImageList
+Массив элементов `AiImageItem`.

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

@@ -0,0 +1,60 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Classes/AiGoogle - Google Gemini AI tự động cấu hình'/>
+
+# Lớp AiGoogle
+
+Một triển khai cấp cao về tích hợp Google Gemini AI. Lớp `AiGoogle` mở rộng từ `AiGoogleLite` và tự động khởi tạo với mã API và ID mô hình được chỉ định trong các tệp cấu hình của dự án.
+
+## Tính năng chính
+
+- **Khởi tạo không cần cấu hình** — tự động tải thông tin xác thực API và cài đặt mô hình từ môi trường dự án.
+- **Sức mạnh từ Gemini** — cung cấp quyền truy cập vào các mô hình tạo nảy tiên tiến nhất của Google.
+- **Độ tin cậy được kế thừa** — bao gồm tất cả các tính năng của `AiGoogleLite`, chẳng hạn như hỗ trợ đa phương thức (văn bản + hình ảnh) và tích lũy các lời nhắc phức tạp.
+- **Quy trình đơn giản hóa** — lý tưởng để sử dụng trong công cụ tài liệu của dự án khi không cần cấu hình thủ công.
+
+## Khởi tạo
+
+Khác với `AiGoogleLite`, lớp `AiGoogle` không yêu cầu tham số hàm khởi tạo vì nó lấy các cài đặt từ `getConfigAi()`.
+
+```typescript
+import { AiGoogle } from '@dxtmisha/scripts'
+
+const ai = new AiGoogle()
+
+// Tùy chọn thay đổi mô hình nếu cần
+ai.setModel('gemini-1.5-pro')
+
+// Tạo phản hồi
+const response = await ai.generate('Tạo một mô tả ngắn gọn về dự án.')
+```
+
+## Phương thức
+
+### Tạo (Generation)
+
+- `generate(contents: string): Promise<string>` — (Kế thừa) Kết hợp ngữ cảnh đã tích lũy và thực hiện yêu cầu tạo AI.
+
+### Cấu hình
+
+- `setKey(key: string): this` — (Kế thừa) Cập nhật mã API và khởi tạo lại ứng dụng khách nội bộ.
+- `setModel(model: string): this` — (Kế thừa) Chuyển đổi mô hình hoạt động.
+
+### Xây dựng Ngữ cảnh
+
+- `addPrompt(prompt: string): void` — (Kế thừa) Thêm tiền tố văn bản cố định.
+- `addContent(content: string): this` — (Kế thừa) Thêm một phần văn bản vào lời nhắc.
+- `addImage(image: AiImageItem): this` — (Kế thừa) Thêm một hình ảnh (base64) vào yêu cầu.
+- `resetPrompt(): void` — (Kế thừa) Xóa tiền tố cố định.
+- `resetContents(): this` — (Kế thừa) Xóa các phần văn bản đã tích lũy.
+- `resetImages(): this` — (Kế thừa) Xóa các hình ảnh đã tích lũy.
+
+## Các kiểu dữ liệu
+
+### AiImageItem
+Đại diện cho một hình ảnh cho các yêu cầu đa phương thức.
+- `mime: string` — loại MIME của hình ảnh.
+- `base64: string` — dữ liệu hình ảnh ở định dạng base64.
+
+### AiImageList
+Một mảng các `AiImageItem`.