@dxtmisha/wiki 0.39.1 → 0.39.3

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

@@ -0,0 +1,52 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Classes/AiGoogleCli - Auto-configured Google Gemini AI via CLI'/>
+
+# AiGoogleCli Class
+
+A high-level implementation for interacting with Google's Gemini AI via a system command-line interface. The `AiGoogleCli` class extends `AiGoogleCliLite` and simplifies the process by automatically loading the required API key and model identifier from the project's configuration settings (`getConfigAi()`).
+
+> This implementation requires the `gemini` CLI utility to be installed and accessible in the system path.
+
+## Key Features
+
+- **Automated Configuration** — no manual initialization of keys or models is needed; it pulls everything from the project environment.
+- **CLI-based Execution** — leverages shell commands to perform AI requests, making it suitable for specific build environments.
+- **Temporary File Management** — handles the creation and cleanup of temporary prompt files (`./ai-tmp`) automatically.
+- **Concise Outputs** — uses optimized CLI flags to ensure the AI returns direct answers without conversational preamble.
+
+## Initialization
+
+The `AiGoogleCli` class is ready to use without any constructor arguments.
+
+```typescript
+import { AiGoogleCli } from '@dxtmisha/scripts'
+
+const ai = new AiGoogleCli()
+
+// Generate a response using project-defined settings
+const response = await ai.generate('Summarize the changes in the project.')
+```
+
+## Methods
+
+### Generation
+
+- `generate(contents: string): Promise<string>` — (Inherited) Analyzes input, manages temporary files, and executes the CLI command to get a response.
+
+### Configuration
+
+- `setKey(key: string): this` — (Inherited) Manually overrides the API key if necessary.
+- `setModel(model: string): this` — (Inherited) Switches to a different model ID.
+
+### Context Building
+
+- `addPrompt(prompt: string): void` — (Inherited) Sets a persistent text prefix for system instructions.
+- `addContent(content: string): this` — (Inherited) Adds a text part to the cumulative request.
+- `resetPrompt(): void` — (Inherited) Clears the persistent prefix.
+- `resetContents(): this` — (Inherited) Clears all accumulated text parts.
+
+## Limitations
+
+- **Multimodal Support** — like its base class, this implementation does not currently support image inputs.
+- **System Dependencies** — requires the `gemini` CLI tool and appropriate file system permissions for temporary data.

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

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

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

@@ -0,0 +1,52 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Classes/AiGoogleCli - Google Gemini AI tự động cấu hình qua CLI'/>
+
+# Lớp AiGoogleCli
+
+Một triển khai cấp cao để tương tác với Google Gemini AI thông qua giao diện dòng lệnh (CLI) của hệ thống. Lớp `AiGoogleCli` mở rộng từ `AiGoogleCliLite` và đơn giản hóa quy trình bằng cách tự động tải mã API và mã định danh mô hình được yêu cầu từ cấu hình của dự án (`getConfigAi()`).
+
+> Triển khai này yêu cầu tiện ích CLI `gemini` phải được cài đặt và có thể truy cập được trong đường dẫn hệ thống.
+
+## Tính năng chính
+
+- **Cấu hình Tự động** — không cần khởi tạo thủ công mã khoá hoặc mô hình; nó lấy mọi thứ từ môi trường dự án.
+- **Thực thi dựa trên CLI** — tận dụng các lệnh shell để thực hiện các yêu cầu AI, phù hợp cho các môi trường xây dựng cụ thể.
+- **Quản lý Tệp Tạm thời** — tự động xử lý việc tạo và dọn dẹp các tệp lời nhắc tạm thời (`./ai-tmp`).
+- **Phản hồi Ngắn gọn** — sử dụng các cờ CLI được tối ưu hóa để đảm bảo AI trả về câu trả lời trực tiếp mà không có phần dẫn dắt rườm rà.
+
+## Khởi tạo
+
+Lớp `AiGoogleCli` đã sẵn sàng để sử dụng mà không cần bất kỳ đối số hàm khởi tạo nào.
+
+```typescript
+import { AiGoogleCli } from '@dxtmisha/scripts'
+
+const ai = new AiGoogleCli()
+
+// Tạo phản hồi bằng các cài đặt được xác định trong dự án
+const response = await ai.generate('Tóm tắt các thay đổi trong dự án.')
+```
+
+## Phương thức
+
+### Tạo (Generation)
+
+- `generate(contents: string): Promise<string>` — (Kế thừa) Phân tích đầu vào, quản lý các tệp tạm thời và thực thi lệnh CLI để lấy phản hồi.
+
+### Cấu hình
+
+- `setKey(key: string): this` — (Kế thừa) Ghi đè mã API thủ công nếu cần thiết.
+- `setModel(model: string): this` — (Kế thừa) Chuyển đổi sang ID mô hình khác.
+
+### Xây dựng Ngữ cảnh
+
+- `addPrompt(prompt: string): void` — (Kế thừa) Thiết lập tiền tố văn bản cố định cho các hướng dẫn hệ thống.
+- `addContent(content: string): this` — (Kế thừa) Thêm một phần văn bản vào yêu cầu tích lũy.
+- `resetPrompt(): void` — (Kế thừa) Xóa tiền tố cố định.
+- `resetContents(): this` — (Kế thừa) Xóa tất cả các phần văn bản đã tích lũy.
+
+## Hạn chế
+
+- **Hỗ trợ Đa phương thức** — giống như lớp cơ sở của nó, triển khai này hiện không hỗ trợ đầu vào hình ảnh.
+- **Phụ thuộc Hệ thống** — yêu cầu công cụ CLI `gemini` và các quyền hệ thống tệp phù hợp cho dữ liệu tạm thời.

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

@@ -0,0 +1,56 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Classes/AiGoogleCliLite - Google Gemini AI via CLI'/>
+
+# AiGoogleCliLite Class
+
+A specialized implementation of the `AiAbstract` class that interacts with Google's Gemini AI using a system command-line interface (CLI). This approach is useful in environments where a direct SDK integration is not preferred or where existing CLI tools are leveraged.
+
+> This implementation requires the `gemini` CLI utility to be installed and accessible in the system path.
+
+## Key Features
+
+- **CLI-driven Workflow** — executes requests by constructing and running shell commands.
+- **Large Prompt Handling** — automatically creates temporary files to pass large prompt contents to the CLI, avoiding command-line length limitations.
+- **Clean Execution** — manages its own temporary storage (`./ai-tmp`) and performs cleanup after each request.
+- **YOLO Mode** — executes commands with strict output flags to ensure results are concise and free of conversational filler.
+
+## Initialization
+
+Initialize `AiGoogleCliLite` with your API key and intended model.
+
+**Parameters:**
+- `key: string` — your Google AI API key (passed to the CLI via environment variables).
+- `model: string` — the model identifier for the Gemini CLI.
+
+```typescript
+import { AiGoogleCliLite } from '@dxtmisha/scripts'
+
+const ai = new AiGoogleCliLite('YOUR_API_KEY', 'gemini-1.5-flash')
+
+// Generate a response
+const response = await ai.generate('Review this code snippet.')
+```
+
+## Methods
+
+### Generation
+
+- `generate(contents: string): Promise<string>` — the primary method for interaction. It compiles the context into temporary files, executes the CLI command, and returns the trimmed output.
+
+### Configuration
+
+- `setKey(key: string): this` — updates the API key for subsequent CLI calls.
+- `setModel(model: string): this` — switches the active model ID.
+
+### Context Building
+
+- `addPrompt(prompt: string): void` — sets a persistent text prefix.
+- `addContent(content: string): this` — adds a text part to the cumulative prompt.
+- `resetPrompt(): void` — clears the persistent prefix.
+- `resetContents(): this` — clears all accumulated text parts.
+
+## Limitations
+
+- **Images** — currently, the CLI implementation does not support image passing (`addImage` will have no effect on the generation).
+- **Environment** — relies on the availability of the `exec` function and the filesystem for temporary storage.

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

@@ -0,0 +1,56 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Classes/AiGoogleCliLite - Google Gemini AI через CLI'/>
+
+# Класс AiGoogleCliLite
+
+Специализированная реализация класса `AiAbstract`, которая взаимодействует с ИИ Google Gemini через интерфейс командной строки (CLI) системы. Этот подход полезен в средах, где прямое использование SDK нежелательно или где используются существующие инструменты CLI.
+
+> Для работы этой реализации требуется установленная утилита `gemini` CLI, доступная в переменной PATH вашей системы.
+
+## Ключевые особенности
+
+- **Работа через CLI** — выполняет запросы путем формирования и запуска системных команд оболочки.
+- **Обработка длинных промптов** — автоматически создает временные файлы для передачи объемного содержимого промптов в CLI, обходя ограничения на длину командной строки.
+- **Чистое выполнение** — управляет собственным временным хранилищем (`./ai-tmp`) и выполняет очистку после каждого запроса.
+- **Режим YOLO** — выполняет команды со строгими флагами вывода, чтобы результаты были лаконичными и не содержали лишних рассуждений ИИ.
+
+## Инициализация
+
+Инициализируйте `AiGoogleCliLite`, указав ваш API-ключ и нужную модель.
+
+**Параметры:**
+- `key: string` — ваш API-ключ Google AI (передается в CLI через переменные окружения).
+- `model: string` — идентификатор модели для Gemini CLI.
+
+```typescript
+import { AiGoogleCliLite } from '@dxtmisha/scripts'
+
+const ai = new AiGoogleCliLite('ВАШ_API_КЛЮЧ', 'gemini-1.5-flash')
+
+// Генерация ответа
+const response = await ai.generate('Проверь этот фрагмент кода.')
+```
+
+## Методы
+
+### Генерация
+
+- `generate(contents: string): Promise<string>` — основной метод взаимодействия. Компилирует контекст во временные файлы, выполняет команду CLI и возвращает очищенный результат.
+
+### Конфигурация
+
+- `setKey(key: string): this` — обновляет API-ключ для последующих вызовов CLI.
+- `setModel(model: string): this` — переключает идентификатор активной модели.
+
+### Сбор контекста
+
+- `addPrompt(prompt: string): void` — устанавливает постоянный текстовый префикс.
+- `addContent(content: string): this` — добавляет текстовую часть к накопительному промпту.
+- `resetPrompt(): void` — очищает постоянный префикс.
+- `resetContents(): this` — очищает все накопленные части текста.
+
+## Ограничения
+
+- **Изображения** — в настоящее время реализация CLI не поддерживает передачу изображений (вызов `addImage` не повлияет на генерацию).
+- **Окружение** — зависит от доступности функции `exec` и файловой системы для хранения временных данных.

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

@@ -0,0 +1,56 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Classes/AiGoogleCliLite - Google Gemini AI qua CLI'/>
+
+# Lớp AiGoogleCliLite
+
+Một triển khai chuyên biệt của lớp `AiAbstract` tương tác với Google Gemini AI thông qua giao diện dòng lệnh (CLI) của hệ thống. Cách tiếp cận này hữu ích trong các môi trường mà việc tích hợp trực tiếp SDK không được ưu tiên hoặc khi các công cụ CLI hiện có được tận dụng.
+
+> Triển khai này yêu cầu tiện ích CLI `gemini` phải được cài đặt và có thể truy cập được trong đường dẫn hệ thống.
+
+## Tính năng chính
+
+- **Quy trình làm việc qua CLI** — thực hiện các yêu cầu bằng cách xây dựng và chạy các lệnh shell.
+- **Xử lý Lời nhắc Lớn** — tự động tạo các tệp tạm thời để chuyển nội dung lời nhắc lớn cho CLI, tránh các giới hạn về độ dài dòng lệnh.
+- **Thực thi Sạch sẽ** — quản lý bộ lưu trữ tạm thời của riêng nó (`./ai-tmp`) và thực hiện dọn dẹp sau mỗi yêu cầu.
+- **Chế độ YOLO** — thực thi các lệnh với các cờ đầu ra nghiêm ngặt để đảm bảo kết quả ngắn gọn và không có các nội dung thừa.
+
+## Khởi tạo
+
+Khởi tạo `AiGoogleCliLite` bằng mã API và mô hình dự định của bạn.
+
+**Tham số:**
+- `key: string` — mã API Google AI của bạn (được chuyển đến CLI qua các biến môi trường).
+- `model: string` — mã định danh mô hình cho Gemini CLI.
+
+```typescript
+import { AiGoogleCliLite } from '@dxtmisha/scripts'
+
+const ai = new AiGoogleCliLite('YOUR_API_KEY', 'gemini-1.5-flash')
+
+// Tạo phản hồi
+const response = await ai.generate('Kiểm tra đoạn mã này.')
+```
+
+## Phương thức
+
+### Tạo (Generation)
+
+- `generate(contents: string): Promise<string>` — phương thức chính để tương tác. Nó biên dịch ngữ cảnh vào các tệp tạm thời, thực thi lệnh CLI và trả về đầu ra đã được cắt tỉa.
+
+### Cấu hình
+
+- `setKey(key: string): this` — cập nhật mã API cho các cuộc gọi CLI tiếp theo.
+- `setModel(model: string): this` — chuyển đổi ID mô hình hoạt động.
+
+### Xây dựng Ngữ cảnh
+
+- `addPrompt(prompt: string): void` — thiết lập tiền tố văn bản cố định.
+- `addContent(content: string): this` — thêm một phần văn bản vào lời nhắc tích lũy.
+- `resetPrompt(): void` — xóa tiền tố cố định.
+- `resetContents(): this` — xóa tất cả các phần văn bản đã tích lũy.
+
+## Hạn chế
+
+- **Hình ảnh** — hiện tại, triển khai CLI không hỗ trợ truyền hình ảnh (`addImage` sẽ không có tác dụng đối với việc tạo).
+- **Môi trường** — dựa trên tính khả dụng của hàm `exec` và hệ thống tệp cho lưu trữ tạm thời.

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

@@ -0,0 +1,71 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Classes/AiGoogleLite - Google Gemini AI Integration'/>
+
+# AiGoogleLite Class
+
+A concrete implementation of the `AiAbstract` class for Google's Gemini AI (via the `GoogleGenAI` client). This class provides a streamlined way to interact with Gemini models, handling authentication, context accumulation, and content generation.
+
+## Key Features
+
+- **Google Gemini Integration** — seamlessly connects to Google's generative AI models.
+- **Multimodal Support** — supports both text and image inputs for generation requests.
+- **Context Accumulation** — inherits a robust mechanics for building complex prompts, including images and multi-part text.
+- **Unified Workflow** — provides a consistent interface for model selection and generation, abstracting away low-level client details.
+
+## Initialization
+
+Initialize the `AiGoogleLite` by providing your API key and a target model ID.
+
+**Parameters:**
+- `key: string` — your Google AI API key.
+- `model: string` — the ID of the Gemini model to use (e.g., `'gemini-1.5-flash'`).
+
+```typescript
+import { AiGoogleLite } from '@dxtmisha/scripts'
+
+const ai = new AiGoogleLite('YOUR_API_KEY', 'gemini-1.5-flash')
+
+// Set an optional system prompt prefix
+ai.addPrompt('You are a technical writer.')
+
+// Generate a response
+const response = await ai.generate('Explain the AiGoogleLite class.')
+```
+
+## Methods
+
+### Generation
+
+- `generate(contents: string): Promise<string>` — the main entry point for AI interaction. It combines all accumulated context (prefix, images, parts) and performs the request.
+
+### Configuration
+
+- `setKey(key: string): this` — updates the API key and re-initializes the internal client.
+- `setModel(model: string): this` — switches the active model for subsequent requests.
+
+### Context Building
+
+These methods allow you to accumulate data before calling `generate()`:
+
+- `addPrompt(prompt: string): void` — appends a persistent text prefix (useful for system instructions).
+- `addContent(content: string): this` — adds a text part to the prompt.
+- `addImage(image: AiImageItem): this` — appends an image (base64) to the request.
+- `resetPrompt(): void` — clears the persistent prefix.
+- `resetContents(): this` — clears all accumulated text parts.
+- `resetImages(): this` — clears all accumulated images.
+
+### Information
+
+- `getContents(): string[]` — returns the list of accumulated text parts.
+- `getImages(): AiImageList` — returns the list of accumulated images.
+
+## Types
+
+### AiImageItem
+Represents an image for multimodal requests.
+- `mime: string` — the MIME type of the image (e.g., `'image/png'`).
+- `base64: string` — the image data in base64 format.
+
+### AiImageList
+An array of `AiImageItem`.

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

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

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

@@ -0,0 +1,71 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Classes/AiGoogleLite - Tích hợp Google Gemini AI'/>
+
+# Lớp AiGoogleLite
+
+Một triển khai cụ thể của lớp `AiAbstract` cho Google Gemini AI (thông qua ứng dụng khách `GoogleGenAI`). Lớp này cung cấp một cách tinh gọn để tương tác với các mô hình Gemini, xử lý xác thực, tích lũy ngữ cảnh và tạo nội dung.
+
+## Tính năng chính
+
+- **Tích hợp Google Gemini** — kết nối liền mạch với các mô hình AI tạo nảy của Google.
+- **Hỗ trợ Đa phương thức** — hỗ trợ cả đầu vào văn bản và hình ảnh cho các yêu cầu tạo.
+- **Tích lũy Ngữ cảnh** — kế thừa cơ chế mạnh mẽ để xây dựng các lời nhắc phức tạp, bao gồm hình ảnh và văn bản nhiều phần.
+- **Quy trình Thống nhất** — cung cấp một giao diện nhất quán để lựa chọn mô hình và tạo, trừu tượng hóa các chi tiết cấp thấp của ứng dụng khách.
+
+## Khởi tạo
+
+Khởi tạo `AiGoogleLite` bằng cách cung cấp mã API của bạn và ID mô hình mục tiêu.
+
+**Tham số:**
+- `key: string` — mã API Google AI của bạn.
+- `model: string` — ID của mô hình Gemini sẽ sử dụng (ví dụ: `'gemini-1.5-flash'`).
+
+```typescript
+import { AiGoogleLite } from '@dxtmisha/scripts'
+
+const ai = new AiGoogleLite('YOUR_API_KEY', 'gemini-1.5-flash')
+
+// Thiết lập tiền tố lời nhắc hệ thống tùy chọn
+ai.addPrompt('Bạn là một người viết tài liệu kỹ thuật.')
+
+// Tạo phản hồi
+const response = await ai.generate('Giải thích về lớp AiGoogleLite.')
+```
+
+## Phương thức
+
+### Tạo (Generation)
+
+- `generate(contents: string): Promise<string>` — điểm khởi đầu chính để tương tác với AI. Nó kết hợp tất cả ngữ cảnh đã tích lũy (tiền tố, hình ảnh, các phần văn bản) và thực hiện yêu cầu.
+
+### Cấu hình
+
+- `setKey(key: string): this` — 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` — chuyển đổi mô hình hoạt động cho các yêu cầu tiếp theo.
+
+### Xây dựng Ngữ cảnh
+
+Các phương thức này cho phép bạn tích lũy dữ liệu trước khi gọi `generate()`:
+
+- `addPrompt(prompt: string): void` — thêm tiền tố văn bản cố định (hữu ích cho các hướng dẫn hệ thống).
+- `addContent(content: string): this` — thêm một phần văn bản vào lời nhắc.
+- `addImage(image: AiImageItem): this` — thêm một hình ảnh (base64) vào yêu cầu.
+- `resetPrompt(): void` — xóa tiền tố cố định.
+- `resetContents(): this` — xóa tất cả các phần văn bản đã tích lũy.
+- `resetImages(): this` — xóa tất cả các hình ảnh đã tích lũy.
+
+### Thông tin
+
+- `getContents(): string[]` — trả về danh sách các phần văn bản đã tích lũy.
+- `getImages(): AiImageList` — trả về danh sách 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 (ví dụ: `'image/png'`).
+- `base64: string` — dữ liệu hình ảnh ở định dạng base64.
+
+### AiImageList
+Một mảng các `AiImageItem`.

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

@@ -0,0 +1,34 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Classes/BuildFunctional - Library Builder for Functional' />
+
+# BuildFunctional Class
+
+The `BuildFunctional` class is a utility responsible for generating a central export file for the functional library. It scans the `@dxtmisha/functional` package and creates a `functional.ts` file in the library directory, re-exporting all discovered members.
+
+## Key Features
+
+- **Automated Re-exports** — Automatically discovers and re-exports all members from the functional package.
+- **Type Support** — Includes `export type *` to ensure full TypeScript type availability.
+- **Library Integration** — Integrates with the project's library structure by writing to the configured library directory.
+
+## Initialization
+
+You can create an instance of `BuildFunctional` without any parameters.
+
+```typescript
+import { BuildFunctional } from './BuildFunctional'
+
+const builder = new BuildFunctional()
+builder.make()
+```
+
+## Methods
+
+### make
+
+- `make(): void` — Triggers the build process. It retrieves the list of members, formats the export code, and writes it to `src/library/functional.ts`.
+
+### getList
+
+- `getList(): string[]` — Returns an array of keys (exported members) from the `@dxtmisha/functional` package.

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

@@ -0,0 +1,34 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Classes/BuildFunctional - Сборщик библиотеки функционала' />
+
+# Класс BuildFunctional
+
+Класс `BuildFunctional` — это утилита, отвечающая за генерацию центрального файла экспорта для функциональной библиотеки. Он сканирует пакет `@dxtmisha/functional` и создает файл `functional.ts` в директории библиотеки, повторно экспортируя все обнаруженные элементы.
+
+## Ключевые особенности
+
+- **Автоматический реэкспорт** — автоматически обнаруживает и повторно экспортирует все элементы из функционального пакета.
+- **Поддержка типов** — включает `export type *` для обеспечения полной доступности типов TypeScript.
+- **Интеграция с библиотекой** — интегрируется со структурой библиотеки проекта, записывая данные в настроенную директорию библиотеки.
+
+## Инициализация
+
+Вы можете создать экземпляр `BuildFunctional` без параметров.
+
+```typescript
+import { BuildFunctional } from './BuildFunctional'
+
+const builder = new BuildFunctional()
+builder.make()
+```
+
+## Методы
+
+### make
+
+- `make(): void` — запускает процесс сборки. Он получает список элементов, форматирует код экспорта и записывает его в `src/library/functional.ts`.
+
+### getList
+
+- `getList(): string[]` — возвращает массив ключей (экспортируемых элементов) из пакета `@dxtmisha/functional`.

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

@@ -0,0 +1,34 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Classes/BuildFunctional - Bộ xây dựng thư viện chức năng' />
+
+# Lớp BuildFunctional
+
+Lớp `BuildFunctional` là một tiện ích chịu trách nhiệm tạo tệp xuất trung tâm cho thư viện chức năng. Nó quét gói `@dxtmisha/functional` và tạo tệp `functional.ts` trong thư mục thư viện, xuất lại tất cả các thành viên được tìm thấy.
+
+## Các tính năng chính
+
+- **Tự động xuất lại** — Tự động phát hiện và xuất lại tất cả các thành viên từ gói chức năng.
+- **Hỗ trợ Type** — Bao gồm `export type *` để đảm bảo tính khả dụng đầy đủ của kiểu TypeScript.
+- **Tích hợp thư viện** — Tích hợp với cấu trúc thư viện của dự án bằng cách ghi vào thư mục thư viện đã định cấu hình.
+
+## Khởi tạo
+
+Bạn có thể tạo một phiên bản của `BuildFunctional` mà không cần bất kỳ tham số nào.
+
+```typescript
+import { BuildFunctional } from './BuildFunctional'
+
+const builder = new BuildFunctional()
+builder.make()
+```
+
+## Các phương thức
+
+### make
+
+- `make(): void` — Kích hoạt quá trình xây dựng. Nó lấy danh sách các thành viên, định dạng mã xuất và ghi nó vào `src/library/functional.ts`.
+
+### getList
+
+- `getList(): string[]` — Trả về một mảng các khóa (thành viên được xuất) từ gói `@dxtmisha/functional`.