@dxtmisha/wiki 0.25.1 → 0.39.2

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`.

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

@@ -0,0 +1,49 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Classes/BuildItem - Component Build Manager'/>
+
+# BuildItem Class
+
+Responsible for orchestrating the build process of individual components using Vite. It manages temporary build configurations, executes the build pipeline, and aggregates the resulting output into a single code snapshot.
+
+## Key Features
+
+- **Configuration Isolation** — Safely renames existing Vite configs before build and restores them after completion.
+- **Vite Integration** — Generates dynamic Vite configurations based on a component-specific template.
+- **Output Aggregation** — Recursively reads all files from the temporary distribution directory and combines them into a single `code.txt` file.
+- **Error Propagation** — Monitors build status and handles environment exit codes on failure.
+- **Storage Management** — Provides utility methods for retrieving and cleaning up temporary distribution paths.
+
+## Initialization
+
+Initialize the `BuildItem` by providing the target component path.
+
+**Parameters:**
+- `path: string` — the target path to the component directory to be built.
+
+```typescript
+import { BuildItem } from '@dxtmisha/scripts'
+
+const builder = new BuildItem('packages/components/Button')
+
+// Trigger the build process
+await builder.make()
+```
+
+## Methods
+
+### Control
+
+- `make(): Promise<boolean>` — coordinates the full build lifecycle: configuration backup, build execution, and file restoration.
+- `getCode(): string` — retrieves the content of the aggregated code snapshot generated during the build.
+- `removeDir(): void` — permanently deletes the temporary distribution directory.
+
+## Internal Workflow
+
+The build process follows a strict lifecycle to ensure environment safety and consistent output:
+
+1.  **Configuration Backup** — Renames the existing `vite.config.ts` to `vite.config.workers.ts` to prevent it from being overwritten or interfering with the build.
+2.  **Template Synthesis** — Reads the component-specific Vite template and injects the target path dynamically.
+3.  **Shell Execution** — Triggers the `npm run build` command via a child process, capturing and logging all output.
+4.  **Restoration** — Safely restores the original `vite.config.ts` from the backup once the build completes.
+5.  **Aggregation** — Recursively scans the distribution directory, wraps each file's content in an identifier comment, and writes the final combined result to `code.txt`.

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

@@ -0,0 +1,49 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Classes/BuildItem - Менеджер сборки компонентов'/>
+
+# Класс BuildItem
+
+Отвечает за оркестрацию процесса сборки отдельных компонентов с использованием Vite. Класс управляет временными конфигурациями сборки, запускает конвейер компиляции и агрегирует полученные файлы в единый снимок кода.
+
+## Ключевые возможности
+
+- **Изоляция конфигурации** — Безопасно переименовывает существующие конфиги Vite перед сборкой и восстанавливает их по завершении.
+- **Интеграция с Vite** — Генерирует динамические конфигурации Vite на основе шаблона, специфичного для компонента.
+- **Агрегация результатов** — Рекурсивно считывает файлы из временной директории дистрибутива и объединяет их в один файл `code.txt`.
+- **Обработка ошибок** — Отслеживает статус сборки и обрабатывает коды выхода окружения при сбоях.
+- **Управление хранилищем** — Предоставляет методы для получения и очистки временных путей дистрибутива.
+
+## Инициализация
+
+Инициализируйте `BuildItem`, указав целевой путь к компоненту.
+
+**Параметры:**
+- `path: string` — целевой путь к директории компонента для сборки.
+
+```typescript
+import { BuildItem } from '@dxtmisha/scripts'
+
+const builder = new BuildItem('packages/components/Button')
+
+// Запуск процесса сборки
+await builder.make()
+```
+
+## Методы
+
+### Управление
+
+- `make(): Promise<boolean>` — координирует полный жизненный цикл сборки: резервное копирование конфига, выполнение сборки и восстановление файлов.
+- `getCode(): string` — возвращает содержимое агрегированного снимка кода, созданного в процессе сборки.
+- `removeDir(): void` — безвозвратно удаляет временную директорию дистрибутива.
+
+## Внутренний процесс сборки
+
+Процесс сборки следует строгому жизненному циклу для обеспечения безопасности окружения и согласованности вывода:
+
+1.  **Резервное копирование конфигурации** — Переименовывает существующий `vite.config.ts` в `vite.config.workers.ts`, чтобы предотвратить его перезапись или вмешательство в процесс сборки.
+2.  **Синтез шаблона** — Читает специальный шаблон Vite для компонентов и динамически подставляет в него целевой путь.
+3.  **Выполнение в оболочке** — Запускает команду `npm run build` через дочерний процесс, перехватывая и логируя весь вывод.
+4.  **Восстановление** — Безопасно восстанавливает оригинальный `vite.config.ts` из резервной копии сразу после завершения сборки.
+5.  **Агрегация** — Рекурсивно сканирует директорию дистрибутива, оборачивает содержимое каждого файла в идентифицирующий комментарий и записывает итоговый результат в `code.txt`.

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

@@ -0,0 +1,49 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Classes/BuildItem - Trình quản lý Build Component'/>
+
+# Lớp BuildItem
+
+Chịu trách nhiệm điều phối quy trình build của từng component riêng lẻ bằng Vite. Nó quản lý các cấu hình build tạm thời, thực thi quy trình build và tổng hợp đầu ra thu được thành một snapshot mã duy nhất.
+
+## Các tính năng chính
+
+- **Cô lập cấu hình** — Đổi tên các cấu hình Vite hiện có một cách an toàn trước khi build và khôi phục chúng sau khi hoàn tất.
+- **Tích hợp Vite** — Tạo các cấu hình Vite động dựa trên một template dành riêng cho component.
+- **Tổng hợp đầu ra** — Đọc đệ quy tất cả các tệp từ thư mục phân phối tạm thời và kết hợp chúng thành một tệp `code.txt` duy nhất.
+- **Lan truyền lỗi** — Theo dõi trạng thái build và xử lý các mã thoát (exit code) khi thất bại.
+- **Quản lý lưu trữ** — Cung cấp các phương thức để lấy và dọn dẹp các đường dẫn phân phối tạm thời.
+
+## Khởi tạo
+
+Khởi tạo `BuildItem` bằng cách cung cấp đường dẫn component mục tiêu.
+
+**Tham số:**
+- `path: string` — đường dẫn đích đến thư mục component cần build.
+
+```typescript
+import { BuildItem } from '@dxtmisha/scripts'
+
+const builder = new BuildItem('packages/components/Button')
+
+// Kích hoạt quy trình build
+await builder.make()
+```
+
+## Phương thức
+
+### Điều khiển
+
+- `make(): Promise<boolean>` — điều phối toàn bộ vòng đời build: sao lưu cấu hình, thực thi build và khôi phục tệp.
+- `getCode(): string` — lấy nội dung của snapshot mã tổng hợp được tạo ra trong quy trình build.
+- `removeDir(): void` — xóa vĩnh viễn thư mục phân phối tạm thời.
+
+## Quy trình làm việc nội bộ
+
+Quá trình build tuân theo một vòng đời nghiêm ngặt để đảm bảo an toàn cho môi trường và tính nhất quán của đầu ra:
+
+1.  **Sao lưu cấu hình** — Đổi tên `vite.config.ts` hiện có thành `vite.config.workers.ts` để ngăn nó bị ghi đè hoặc gây nhiễu cho quá trình build.
+2.  **Tổng hợp Template** — Đọc template Vite cụ thể của component và chèn đường dẫn đích một cách động.
+3.  **Thực thi Shell** — Kích hoạt lệnh `npm run build` thông qua một tiến trình con, thu thập và ghi lại toàn bộ đầu ra.
+4.  **Khôi phục** — Khôi phục an toàn `vite.config.ts` ban đầu từ bản sao lưu sau khi quá trình build hoàn tất.
+5.  **Tổng hợp** — Quét đệ quy thư mục phân phối, bao bọc nội dung của mỗi tệp trong một comment định danh và ghi kết quả kết hợp cuối cùng vào `code.txt`.

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

@@ -0,0 +1,41 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Classes/ComponentCreator - Automatic Component Scaffolding'/>
+
+# ComponentCreator Class
+
+A utility class for automating the creation of component skeletons in empty directories. It proactively identifies folders within the component directory that lack files and initializes them using the project's standard templates.
+
+## Key Features
+
+- **Automated Discovery** — scans the component directory recursively to find empty folders.
+- **Smart Scaffolding** — automatically triggers the creation process for each identified directory.
+- **Project Consistency** — ensures all new components start with the same baseline structure and files.
+
+## Initialization
+
+Initialize a new instance of `ComponentCreator`. It automatically targets the standard components directory defined in the project configuration.
+
+```typescript
+import { ComponentCreator } from '@dxtmisha/scripts'
+
+const creator = new ComponentCreator()
+```
+
+## Methods
+
+### `make`
+
+The primary orchestration method that performs a recursive scan of the components directory, identifies folders without files, and triggers the `ComponentItem` scaffolding process for each one.
+
+**Returns:** `void`
+
+## Examples
+
+### Complete Scaffolding Flow
+Running the creator as part of a build or preparation script ensures that even manually created empty folders are properly initialized with necessary files (`index.ts`, `types.ts`, etc.).
+
+```javascript
+const creator = new ComponentCreator()
+creator.make()
+```

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

@@ -0,0 +1,41 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Classes/ComponentCreator - Автоматическое создание компонентов'/>
+
+# Класс ComponentCreator
+
+Утилитный класс для автоматизации создания скелета компонентов в пустых директориях. Он проактивно идентифицирует папки внутри директории компонентов, в которых отсутствуют файлы, и инициализирует их, используя стандартные шаблоны проекта.
+
+## Ключевые особенности
+
+- **Автоматическое обнаружение** — рекурсивно сканирует директорию компонентов для поиска пустых папок.
+- **Умное создание (Scaffolding)** — автоматически запускает процесс создания для каждой идентифицированной директории.
+- **Согласованность проекта** — гарантирует, что все новые компоненты начинаются с одинаковой базовой структуры и файлов.
+
+## Инициализация
+
+Инициализируйте новый экземпляр `ComponentCreator`. Он автоматически нацеливается на стандартную директорию компонентов, определенную в конфигурации проекта.
+
+```typescript
+import { ComponentCreator } from '@dxtmisha/scripts'
+
+const creator = new ComponentCreator()
+```
+
+## Методы
+
+### `make`
+
+Основной метод оркестрации, который выполняет рекурсивное сканирование директории компонентов, идентифицирует папки без файлов и запускает процесс заполнения (`ComponentItem`) для каждой из них.
+
+**Возвращает:** `void`
+
+## Примеры
+
+### Полный процесс создания
+Запуск создателя как части сценария сборки или подготовки гарантирует, что даже созданные вручную пустые папки будут правильно инициализированы необходимыми файлами (`index.ts`, `types.ts` и т.д.).
+
+```javascript
+const creator = new ComponentCreator()
+creator.make()
+```

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

@@ -0,0 +1,41 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Classes/ComponentCreator - Tự động tạo thành phần'/>
+
+# Lớp ComponentCreator
+
+Một lớp tiện ích để tự động hóa việc tạo khung sườn (skeleton) của thành phần trong các thư mục trống. Nó chủ động xác định các thư mục trong thư mục thành phần còn thiếu tệp và khởi tạo chúng bằng các mẫu tiêu chuẩn của dự án.
+
+## Các tính năng chính
+
+- **Tự động khám phá** — quét thư mục thành phần theo cách đệ quy để tìm các thư mục trống.
+- **Tạo khung sườn thông minh** — tự động kích hoạt quá trình tạo cho mỗi thư mục được xác định.
+- **Tính nhất quán của dự án** — đảm bảo tất cả các thành phần mới đều bắt đầu với cùng một cấu trúc cơ bản và các tệp giống nhau.
+
+## Khởi tạo
+
+Khởi tạo một phiên bản mới của `ComponentCreator`. Nó tự động nhắm mục tiêu vào thư mục thành phần tiêu chuẩn được xác định trong cấu hình dự án.
+
+```typescript
+import { ComponentCreator } from '@dxtmisha/scripts'
+
+const creator = new ComponentCreator()
+```
+
+## Các phương thức
+
+### `make`
+
+Phương thức điều phối chính thực hiện quét đệ quy thư mục thành phần, xác định các thư mục không có tệp và kích hoạt quá trình tạo khung sườn `ComponentItem` cho mỗi thư mục đó.
+
+**Trả về:** `void`
+
+## Ví dụ
+
+### Quy trình tạo khung sườn hoàn chỉnh
+Chạy creator như một phần của kịch bản xây dựng hoặc chuẩn bị để đảm bảo rằng ngay cả các thư mục trống được tạo thủ công cũng được khởi tạo đúng cách với các tệp cần thiết (`index.ts`, `types.ts`, v.v.).
+
+```javascript
+const creator = new ComponentCreator()
+creator.make()
+```

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

@@ -0,0 +1,46 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Classes/ComponentItem - Component File Generator'/>
+
+# ComponentItem Class
+
+A specialized class for generating individual component files based on templates. It manages the entire creation process, from reading template samples to performing dynamic string replacements and setting correct file system permissions.
+
+## Key Features
+
+- **Template-Driven** — uses a centralized repository of component templates for consistent file generation.
+- **Dynamic Replacements** — automatically replaces markers like `ComponentDoc`, `[project]`, and `[path]` with context-specific values.
+- **Placeholder Support** — handles both camelCase (class names) and kebab-case (filenames) transformations.
+- **Permission Management** — ensures generated files have the correct execution and read/write permissions.
+
+## Initialization
+
+To initialize the object, call the `ComponentItem(path)` constructor.
+
+**Parameters:**
+- `path: string` — the relative or absolute path to the directory where the component will be created.
+
+```typescript
+import { ComponentItem } from '@dxtmisha/scripts'
+
+const component = new ComponentItem('src/components/MyComponent')
+
+// Generating files
+component.make()
+```
+
+## Methods
+
+### Control
+
+- `make(): void` — The main method that reads all template files and writes their processed versions to the component directory.
+
+## Examples
+
+### Manual Scaffolding
+While `ComponentCreator` handles batch creation, `ComponentItem` can be used directly for fine-grained control over a specific component.
+
+```javascript
+const item = new ComponentItem('packages/ui/src/components/Avatar')
+item.make()
+```

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

@@ -0,0 +1,46 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Classes/ComponentItem - Генератор файлов компонента'/>
+
+# Класс ComponentItem
+
+Специализированный класс для генерации отдельных файлов компонентов на основе шаблонов. Он управляет всем процессом создания: от чтения образцов шаблонов до выполнения динамических замен строк и установки правильных разрешений файловой системы.
+
+## Ключевые особенности
+
+- **На основе шаблонов** — использует централизованный репозиторий шаблонов компонентов для единообразной генерации файлов.
+- **Динамические замены** — автоматически заменяет маркеры, такие как `ComponentDoc`, `[project]` и `[path]`, на контекстные значения.
+- **Поддержка плейсхолдеров** — обрабатывает преобразования как в camelCase (имена классов), так и в kebab-case (имена файлов).
+- **Управление правами** — гарантирует, что сгенерированные файлы имеют правильные права на выполнение, чтение и запись.
+
+## Инициализация
+
+Для инициализации объекта вызовите конструктор `ComponentItem(path)`.
+
+**Параметры:**
+- `path: string` — относительный или абсолютный путь к директории, в которой будет создан компонент.
+
+```typescript
+import { ComponentItem } from '@dxtmisha/scripts'
+
+const component = new ComponentItem('src/components/MyComponent')
+
+// Генерация файлов
+component.make()
+```
+
+## Методы
+
+### Управление
+
+- `make(): void` — основной метод, который считывает все файлы шаблонов и записывает их обработанные версии в директорию компонента.
+
+## Примеры
+
+### Ручное создание заготовки
+В то время как `ComponentCreator` управляет пакетным созданием, `ComponentItem` можно использовать напрямую для точного контроля над конкретным компонентом.
+
+```javascript
+const item = new ComponentItem('packages/ui/src/components/Avatar')
+item.make()
+```