@dxtmisha/wiki 0.25.1 → 0.39.2

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

@@ -0,0 +1,46 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Classes/ComponentItem - Trình tạo tệp thành phần'/>
+
+# Lớp ComponentItem
+
+Một lớp chuyên dụng để tạo các tệp thành phần riêng lẻ dựa trên các mẫu. Nó quản lý toàn bộ quá trình tạo, từ việc đọc các mẫu tệp đến việc thực hiện thay thế chuỗi động và đặt các quyền hệ thống tệp chính xác.
+
+## Các tính năng chính
+
+- **Dựa trên mẫu** — sử dụng kho lưu trữ tập trung các mẫu thành phần để tạo tệp nhất quán.
+- **Thay thế động** — tự động thay thế các dấu hiệu như `ComponentDoc`, `[project]` và `[path]` bằng các giá trị cụ thể theo ngữ cảnh.
+- **Hỗ trợ trình giữ chỗ** — xử lý các chuyển đổi cả camelCase (tên lớp) và kebab-case (tên tệp).
+- **Quản lý quyền** — đảm bảo các tệp được tạo có quyền thực thi và đọc/ghi chính xác.
+
+## Khởi tạo
+
+Để khởi tạo đối tượng, hãy gọi hàm tạo `ComponentItem(path)`.
+
+**Tham số:**
+- `path: string` — đường dẫn tương đối hoặc tuyệt đối đến thư mục nơi thành phần sẽ được tạo.
+
+```typescript
+import { ComponentItem } from '@dxtmisha/scripts'
+
+const component = new ComponentItem('src/components/MyComponent')
+
+// Tạo các tệp
+component.make()
+```
+
+## Các phương thức
+
+### Điều khiển
+
+- `make(): void` — Phương thức chính đọc tất cả các tệp mẫu và ghi các phiên bản đã xử lý của chúng vào thư mục thành phần.
+
+## Ví dụ
+
+### Tạo dàn giáo thủ công
+Trong khi `ComponentCreator` xử lý việc tạo hàng loạt, `ComponentItem` có thể được sử dụng trực tiếp để kiểm soát chi tiết một thành phần cụ thể.
+
+```javascript
+const item = new ComponentItem('packages/ui/src/components/Avatar')
+item.make()
+```

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

@@ -0,0 +1,47 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Classes/ComponentWiki - AI-Powered Wiki Generator'/>
+
+# ComponentWiki Class
+
+An advanced orchestration class that automates the generation of documentation, stories, and type definitions for components using AI. It coordinates temporary builds, code extraction, and AI processing to create comprehensive wiki artifacts.
+
+## Key Features
+
+- **AI-Driven Documentation** — leverages AI to analyze component code and generate meaningful MDX descriptions.
+- **Automatic Story Generation** — creates initial Storybook stories based on the component's implementation.
+- **Type Extraction** — identifies and extracts type definitions for inclusion in documentation.
+- **Process Orchestration** — handles the technical lifecycle including building items, extracting code snapshots, and cleanup.
+
+## Initialization
+
+Initialize the class with the target component path and optional custom prompt instructions.
+
+**Parameters:**
+- `path: string` — the relative path to the component directory.
+- `prompt: string = ''` — optional additional text to append to the AI prompt for specific documentation requirements.
+
+```typescript
+import { ComponentWiki } from '@dxtmisha/scripts'
+
+const wiki = new ComponentWiki('src/components/MyComponent', 'Focus on accessibility details.')
+
+// Start generation process
+wiki.make()
+```
+
+## Methods
+
+### Control
+
+- `make(): void` — The primary method that initiates building the code, preparing the AI context, and generating the wiki artifacts.
+
+## Examples
+
+### Batch Generation
+Commonly used in scripts to regenerate documentation for multiple components after API changes.
+
+```javascript
+const wiki = new ComponentWiki('src/components/BaseButton')
+wiki.make()
+```

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

@@ -0,0 +1,47 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Classes/ComponentWiki - Генератор Wiki на базе ИИ'/>
+
+# Класс ComponentWiki
+
+Продвинутый класс-оркестратор, который автоматизирует генерацию документации, историй (stories) и определений типов для компонентов с использованием ИИ. Он координирует временные сборки, извлечение кода и обработку ИИ для создания полных Wiki-артефактов.
+
+## Ключевые особенности
+
+- **Документация на базе ИИ** — использует ИИ для анализа кода компонентов и создания содержательных MDX-описаний.
+- **Автоматическая генерация историй** — создает начальные истории Storybook на основе реализации компонента.
+- **Извлечение типов** — идентифицирует и извлекает определения типов для включения в документацию.
+- **Оркестрация процессов** — управляет техническим жизненным циклом, включая сборку элементов, извлечение снимков кода и очистку.
+
+## Инициализация
+
+Инициализируйте класс, указав путь к целевому компоненту и необязательные инструкции для промпта.
+
+**Параметры:**
+- `path: string` — относительный путь к директории компонента.
+- `prompt: string = ''` — необязательный дополнительный текст для добавления к промпту ИИ для специфических требований к документации.
+
+```typescript
+import { ComponentWiki } from '@dxtmisha/scripts'
+
+const wiki = new ComponentWiki('src/components/MyComponent', 'Сфокусируйся на деталях доступности.')
+
+// Запуск процесса генерации
+wiki.make()
+```
+
+## Методы
+
+### Управление
+
+- `make(): void` — основной метод, который запускает сборку кода, подготовку контекста ИИ и генерацию Wiki-артефактов.
+
+## Примеры
+
+### Пакетная генерация
+Обычно используется в скриптах для перегенерации документации для нескольких компонентов после изменений API.
+
+```javascript
+const wiki = new ComponentWiki('src/components/BaseButton')
+wiki.make()
+```

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

@@ -0,0 +1,47 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Classes/ComponentWiki - Trình tạo Wiki hỗ trợ AI'/>
+
+# Lớp ComponentWiki
+
+Một lớp điều phối nâng cao tự động hóa việc tạo tài liệu, câu chuyện (stories) và định nghĩa kiểu cho các thành phần bằng AI. Nó điều phối các bản dựng tạm thời, trích xuất mã và xử lý AI để tạo ra các tạo tác wiki toàn diện.
+
+## Các tính năng chính
+
+- **Tài liệu do AI điều khiển** — tận dụng AI để phân tích mã thành phần và tạo các mô tả MDX có ý nghĩa.
+- **Tạo câu chuyện tự động** — tạo các câu chuyện Storybook ban đầu dựa trên việc triển khai thành phần.
+- **Trích xuất kiểu** — xác định và trích xuất các định nghĩa kiểu để đưa vào tài liệu.
+- **Điều phối quy trình** — xử lý vòng đời kỹ thuật bao gồm xây dựng các mục, trích xuất ảnh chụp nhanh mã và dọn dẹp.
+
+## Khởi tạo
+
+Khởi tạo lớp với đường dẫn thành phần mục tiêu và các hướng dẫn nhắc tùy chọn.
+
+**Tham số:**
+- `path: string` — đường dẫn tương đối đến thư mục thành phần.
+- `prompt: string = ''` — văn bản bổ sung tùy chọn để thêm vào lời nhắc AI cho các yêu cầu tài liệu cụ thể.
+
+```typescript
+import { ComponentWiki } from '@dxtmisha/scripts'
+
+const wiki = new ComponentWiki('src/components/MyComponent', 'Tập trung vào chi tiết khả năng truy cập.')
+
+// Bắt đầu quá trình tạo
+wiki.make()
+```
+
+## Các phương thức
+
+### Điều khiển
+
+- `make(): void` — Phương thức chính khởi tạo việc xây dựng mã, chuẩn bị ngữ cảnh AI và tạo các tạo tác wiki.
+
+## Ví dụ
+
+### Tạo hàng loạt
+Thường được sử dụng trong các tập lệnh để tạo lại tài liệu cho nhiều thành phần sau các thay đổi API.
+
+```javascript
+const wiki = new ComponentWiki('src/components/BaseButton')
+wiki.make()
+```

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

@@ -0,0 +1,51 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Classes/ComponentWikiFile - Wiki File Utility'/>
+
+# ComponentWikiFile Class
+
+A specialized utility class designed for handling individual files within the wiki generation process. It provides robust methods for reading, writing, and managing metadata like update dates and file versioning.
+
+## Key Features
+
+- **Metadata Management** — automatically extracts and updates the "**Date: ...**" marker within file content.
+- **Smart Writing** — automatically strips markdown code fences when saving and only writes if content has changed.
+- **Versioning Support** — optionally preserves the previous version of a file by renaming it with an `__old.txt` suffix.
+- **Path Abstraction** — integrates with `PropertiesFile` to handle file operations using consistent path segments.
+
+## Initialization
+
+Initialize with the path segments and configuration for date handling and versioning.
+
+**Parameters:**
+- `paths: string[]` — segments of the file path.
+- `isDate: boolean = false` — if `true`, automatically manages the date marker in the content.
+- `isOld: boolean = true` — if `true`, saves the previous version before overwriting.
+
+```typescript
+import { ComponentWikiFile } from '@dxtmisha/scripts'
+
+const file = new ComponentWikiFile(['docs', 'Guide.mdx'], true, true)
+```
+
+## Methods
+
+### Information
+
+- `getPath(): string` — Returns the full absolute path to the file.
+- `getDate(): Datetime` — Extracts and returns the date from the file's content.
+- `read(): string` — Reads and returns the entire file content.
+
+### Control
+
+- `write(content: string): void` — Writes processed content to the file, handling versioning and date updates if configured.
+
+## Examples
+
+### Managing Documentation Updates
+Automatically updating documentation while keeping a backup of the previous version.
+
+```typescript
+const docFile = new ComponentWikiFile(['wiki', 'MyComponent.mdx'], true, true)
+docFile.write('# New Content')
+```

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

@@ -0,0 +1,51 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Classes/ComponentWikiFile - Утилита для файлов Wiki'/>
+
+# Класс ComponentWikiFile
+
+Специализированный утилитный класс, предназначенный для работы с отдельными файлами в процессе генерации вики. Он предоставляет надежные методы для чтения, записи и управления метаданными, такими как даты обновления и версионность файлов.
+
+## Ключевые особенности
+
+- **Управление метаданными** — автоматически извлекает и обновляет маркер "**Date: ...**" внутри содержимого файла.
+- **Умная запись** — автоматически удаляет markdown-блоки кода при сохранении и выполняет запись только при изменении содержимого.
+- **Поддержка версионности** — опционально сохраняет предыдущую версию файла, переименовывая её с суффиксом `__old.txt`.
+- **Абстракция путей** — интегрируется с `PropertiesFile` для выполнения файловых операций с использованием согласованных сегментов пути.
+
+## Инициализация
+
+Инициализируйте с сегментами пути и конфигурацией для обработки даты и версионности.
+
+**Параметры:**
+- `paths: string[]` — сегменты пути к файлу.
+- `isDate: boolean = false` — если `true`, автоматически управляет маркером даты в содержимом.
+- `isOld: boolean = true` — если `true`, сохраняет предыдущую версию перед перезаписью.
+
+```typescript
+import { ComponentWikiFile } from '@dxtmisha/scripts'
+
+const file = new ComponentWikiFile(['docs', 'Guide.mdx'], true, true)
+```
+
+## Методы
+
+### Информация
+
+- `getPath(): string` — возвращает полный абсолютный путь к файлу.
+- `getDate(): Datetime` — извлекает и возвращает дату из содержимого файла.
+- `read(): string` — считывает и возвращает всё содержимое файла.
+
+### Управление
+
+- `write(content: string): void` — записывает обработанное содержимое в файл, обрабатывая версионность и обновление даты, если это настроено.
+
+## Примеры
+
+### Управление обновлениями документации
+Автоматическое обновление документации с сохранением резервной копии предыдущей версии.
+
+```typescript
+const docFile = new ComponentWikiFile(['wiki', 'MyComponent.mdx'], true, true)
+docFile.write('# Новое содержимое')
+```

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

@@ -0,0 +1,51 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Classes/ComponentWikiFile - Tiện ích tệp Wiki'/>
+
+# Lớp ComponentWikiFile
+
+Một lớp tiện ích chuyên dụng được thiết kế để xử lý các tệp riêng lẻ trong quá trình tạo wiki. Nó cung cấp các phương pháp mạnh mẽ để đọc, ghi và quản lý siêu dữ liệu như ngày cập nhật và phiên bản tệp.
+
+## Các tính năng chính
+
+- **Quản lý siêu dữ liệu** — tự động trích xuất và cập nhật dấu "**Date: ...**" trong nội dung tệp.
+- **Ghi thông minh** — tự động loại bỏ các hàng rào mã markdown khi lưu và chỉ ghi nếu nội dung đã thay đổi.
+- **Hỗ trợ lập phiên bản** — tùy chọn bảo tồn phiên bản trước của tệp bằng cách đổi tên tệp với hậu tố `__old.txt`.
+- **Trừu tượng hóa đường dẫn** — tích hợp với `PropertiesFile` để xử lý các hoạt động tệp bằng các phân đoạn đường dẫn nhất quán.
+
+## Khởi tạo
+
+Khởi tạo với các phân đoạn đường dẫn và cấu hình để xử lý ngày tháng và lập phiên bản.
+
+**Tham số:**
+- `paths: string[]` — các phân đoạn của đường dẫn tệp.
+- `isDate: boolean = false` — nếu `true`, tự động quản lý dấu ngày tháng trong nội dung.
+- `isOld: boolean = true` — nếu `true`, lưu phiên bản trước đó trước khi ghi đè.
+
+```typescript
+import { ComponentWikiFile } from '@dxtmisha/scripts'
+
+const file = new ComponentWikiFile(['docs', 'Guide.mdx'], true, true)
+```
+
+## Các phương thức
+
+### Thông tin
+
+- `getPath(): string` — Trả về đường dẫn tuyệt đối đầy đủ đến tệp.
+- `getDate(): Datetime` — Trích xuất và trả về ngày từ nội dung tệp.
+- `read(): string` — Đọc và trả về toàn bộ nội dung tệp.
+
+### Điều khiển
+
+- `write(content: string): void` — Ghi nội dung đã xử lý vào tệp, xử lý việc lập phiên bản và cập nhật ngày tháng nếu được cấu hình.
+
+## Ví dụ
+
+### Quản lý cập nhật tài liệu
+Tự động cập nhật tài liệu trong khi giữ bản sao lưu của phiên bản trước.
+
+```typescript
+const docFile = new ComponentWikiFile(['wiki', 'MyComponent.mdx'], true, true)
+docFile.write('# Nội dung mới')
+```

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

@@ -0,0 +1,64 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Classes/DesignCommand - Base Design Command Class'/>
+
+# DesignCommand Class
+
+The `DesignCommand` class is a base abstract class designed to standardize the generation of files and components within the design system. It provides a common framework for reading templates, performing replacements, and writing resulting code to the project structure.
+
+## Key Features
+
+- **Standardized Execution** — Provides a consistent `make()` entry point for all design-related generation tasks.
+- **Template Management** — Includes built-in methods for reading samples and applying transformations using specialized replace objects.
+- **Naming Conventions** — Automatically handles various naming formats (CamelCase, kebab-case, etc.) for both components and projects.
+- **Structural Integrity** — Utilizes `DesignStructure` to ensure generated files follow the established design system hierarchy.
+- **Package Integration** — Provides utilities for updating `package.json` with new configuration data.
+
+## Initialization
+
+As an abstract class, `DesignCommand` is not initialized directly but inherited by specific command implementations.
+
+**Parameters (for inheritors):**
+- `command: string` — The identifier for the component or action.
+- `options: Record<string, string>` — Additional configuration parameters.
+
+```typescript
+// Example of an inheritor's constructor
+class MyDesignCommand extends DesignCommand {
+  constructor(command: string, options: Record<string, string>) {
+    super(command, options)
+  }
+}
+```
+
+## Methods
+
+### Control
+
+- `make(): void` — Triggers the command execution and main initialization logic.
+
+### Protected API (for inheritors)
+
+- `isFile(name): boolean` — Checks if a file exists in the target directory.
+- `read(name): string` — Reads the content of a file from the target directory.
+- `readSample(name): string` — Reads a template file from the samples directory.
+- `readDefinable(name, callback?): DesignReplace` — Reads a file if it exists, otherwise falls back to its template.
+- `write(name, value): void` — Writes or overwrites a file with the provided content.
+- `updatePackage(path, value): this` — Updates a specific key in the project's `package.json`.
+
+## Operations
+
+### Command Execution Workflow
+
+The `make()` method follows a strict execution pattern:
+1. **Validation**: Verifies if a command identifier is provided.
+2. **Initialization**: Calls the abstract `initMain()` method (implemented by children) to perform specific file operations.
+3. **Logging**: Provides console feedback on the start and end of the command.
+
+### Name Resolution
+
+`DesignCommand` provides several helpers for consistent naming:
+- `getName()`: Returns the command name in CamelCase.
+- `getCode()`: Returns the command name in kebab-case.
+- `getFullName()`: Combines the design prefix with the command name.
+- `getProjectName()`: Returns the standardized project identifier.

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

@@ -0,0 +1,64 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Classes/DesignCommand - Базовый класс команд дизайна'/>
+
+# Класс DesignCommand
+
+Класс `DesignCommand` является базовым абстрактным классом, предназначенным для стандартизации генерации файлов и компонентов внутри дизайн-системы. Он предоставляет общую основу для чтения шаблонов, выполнения замен и записи результирующего кода в структуру проекта.
+
+## Ключевые особенности
+
+- **Стандартизированное выполнение** — обеспечивает единую точку входа `make()` для всех задач генерации, связанных с дизайном.
+- **Управление шаблонами** — включает встроенные методы для чтения образцов и применения трансформаций с использованием специализированных объектов замены.
+- **Соглашения об именовании** — автоматически обрабатывает различные форматы имен (CamelCase, kebab-case и т.д.) как для компонентов, так и для проектов.
+- **Структурная целостность** — использует `DesignStructure` для обеспечения соответствия сгенерированных файлов установленной иерархии дизайн-системы.
+- **Интеграция с пакетами** — предоставляет утилиты для обновления `package.json` новыми конфигурационными данными.
+
+## Инициализация
+
+Являясь абстрактным классом, `DesignCommand` не инициализируется напрямую, а наследуется конкретными реализациями команд.
+
+**Параметры (для наследников):**
+- `command: string` — идентификатор компонента или действия.
+- `options: Record<string, string>` — дополнительные параметры конфигурации.
+
+```typescript
+// Пример конструктора наследника
+class MyDesignCommand extends DesignCommand {
+  constructor(command: string, options: Record<string, string>) {
+    super(command, options)
+  }
+}
+```
+
+## Методы
+
+### Управление
+
+- `make(): void` — запускает выполнение команды и основную логику инициализации.
+
+### Защищенный API (для наследников)
+
+- `isFile(name): boolean` — проверяет наличие файла в целевой директории.
+- `read(name): string` — читает содержимое файла из целевой директории.
+- `readSample(name): string` — читает файл шаблона из директории образцов.
+- `readDefinable(name, callback?): DesignReplace` — читает файл, если он существует, в противном случае использует его шаблон.
+- `write(name, value): void` — записывает или перезаписывает файл с указанным содержимым.
+- `updatePackage(path, value): this` — обновляет конкретный ключ в `package.json` проекта.
+
+## Операции
+
+### Рабочий процесс выполнения команды
+
+Метод `make()` следует строгому паттерну выполнения:
+1. **Валидация**: проверяет, предоставлен ли идентификатор команды.
+2. **Инициализация**: вызывает абстрактный метод `initMain()` (реализуется дочерними классами) для выполнения специфических файловых операций.
+3. **Логирование**: обеспечивает вывод в консоль информации о начале и завершении команды.
+
+### Разрешение имен
+
+`DesignCommand` предоставляет несколько помощников для согласованного именования:
+- `getName()`: возвращает имя команды в CamelCase.
+- `getCode()`: возвращает имя команды в kebab-case.
+- `getFullName()`: комбинирует префикс дизайна с именем команды.
+- `getProjectName()`: возвращает стандартизированный идентификатор проекта.

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

@@ -0,0 +1,64 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Classes/DesignCommand - Lớp lệnh thiết kế cơ sở'/>
+
+# Lớp DesignCommand
+
+Lớp `DesignCommand` là một lớp trừu tượng cơ sở được thiết kế để tiêu chuẩn hóa việc tạo các tệp và thành phần trong hệ thống thiết kế. Nó cung cấp một khung chung để đọc các mẫu, thực hiện thay thế và ghi mã kết quả vào cấu trúc dự án.
+
+## Các tính năng chính
+
+- **Thực thi tiêu chuẩn hóa** — Cung cấp một điểm nhập `make()` nhất quán cho tất cả các tác vụ tạo liên quan đến thiết kế.
+- **Quản lý mẫu (Template Management)** — Bao gồm các phương thức tích hợp sẵn để đọc các mẫu và áp dụng các chuyển đổi bằng cách sử dụng các đối tượng thay thế chuyên dụng.
+- **Quy ước đặt tên** — Tự động xử lý các định dạng tên khác nhau (CamelCase, kebab-case, v.v.) cho cả thành phần và dự án.
+- **Tính toàn vẹn cấu trúc** — Sử dụng `DesignStructure` để đảm bảo các tệp được tạo tuân theo hệ thống phân cấp hệ thống thiết kế đã được thiết lập.
+- **Tích hợp gói** — Cung cấp các tiện ích để cập nhật `package.json` với dữ liệu cấu hình mới.
+
+## Khởi tạo
+
+Là một lớp trừu tượng, `DesignCommand` không được khởi tạo trực tiếp mà được kế thừa bởi các triển khai lệnh cụ thể.
+
+**Tham số (cho các lớp kế thừa):**
+- `command: string` — Mã định danh cho thành phần hoặc hành động.
+- `options: Record<string, string>` — Các tham số cấu hình bổ sung.
+
+```typescript
+// Ví dụ về hàm khởi tạo của lớp kế thừa
+class MyDesignCommand extends DesignCommand {
+  constructor(command: string, options: Record<string, string>) {
+    super(command, options)
+  }
+}
+```
+
+## Các phương thức
+
+### Điều khiển
+
+- `make(): void` — Kích hoạt việc thực thi lệnh và logic khởi tạo chính.
+
+### API được bảo vệ (cho các lớp kế thừa)
+
+- `isFile(name): boolean` — Kiểm tra xem tệp có tồn tại trong thư mục mục tiêu hay không.
+- `read(name): string` — Đọc nội dung của một tệp từ thư mục mục tiêu.
+- `readSample(name): string` — Đọc một tệp mẫu từ thư mục mẫu.
+- `readDefinable(name, callback?): DesignReplace` — Đọc một tệp nếu nó tồn tại, nếu không sẽ quay lại tệp mẫu của nó.
+- `write(name, value): void` — Ghi hoặc ghi đè một tệp với nội dung được cung cấp.
+- `updatePackage(path, value): this` — Cập nhật một khóa cụ thể trong tệp `package.json` của dự án.
+
+## Các thao tác (Operations)
+
+### Quy trình thực thi lệnh
+
+Phương thức `make()` tuân theo một mẫu thực thi nghiêm ngặt:
+1. **Xác thực**: Kiểm tra xem mã định danh lệnh có được cung cấp hay không.
+2. **Khởi tạo**: Gọi phương thức trừu tượng `initMain()` (được triển khai bởi các lớp con) để thực hiện các thao tác tệp cụ thể.
+3. **Ghi nhật ký (Logging)**: Cung cấp phản hồi trên bảng điều khiển (console) về việc bắt đầu và kết thúc lệnh.
+
+### Phân giải tên
+
+`DesignCommand` cung cấp một số hàm hỗ trợ để đặt tên nhất quán:
+- `getName()`: Trả về tên lệnh ở định dạng CamelCase.
+- `getCode()`: Trả về tên lệnh ở định dạng kebab-case.
+- `getFullName()`: Kết hợp tiền tố thiết kế với tên lệnh.
+- `getProjectName()`: Trả về mã định danh dự án tiêu chuẩn hóa.

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

@@ -0,0 +1,60 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Classes/DesignComponent - Design Component Generator'/>
+
+# DesignComponent Class
+
+The `DesignComponent` class is a specialized implementation of `DesignCommand` dedicated to the automated creation and maintenance of design system components. It orchestrates the generation of diverse file types—from styles and component logic to documentation and integration metadata.
+
+## Key Features
+
+- **Full-Cycle Scaffolding** — Automatically generates 10+ essential files for a new component (Vue, SCSS, TS, MDX).
+- **Intelligent Prop Resolution** — Uses `DesignTypescript` to bake component properties directly into generated files.
+- **Storybook Automation** — Generates `.stories.ts` and `.mdx` files with automated render and import resolution.
+- **AI-Enhanced Wiki** — Creates specialized companion components for AI-driven documentation search and display.
+- **Workspace Integration** — Seamlessly registers new components in the root `package.json` and the library's global export list.
+- **Style Token Mapping** — Transform project structures into SCSS style tokens automatically.
+
+## Initialization
+
+To initialize a generator instance, use the constructor. Note that it sets up the target directory based on the project configuration.
+
+**Parameters:**
+- `command: string` — The identifier for the component (e.g., `'button'`, `'input'`).
+- `options: Record<string, string>` — Optional configuration flags.
+
+```typescript
+import { DesignComponent } from '@dxtmisha/scripts'
+
+const generator = new DesignComponent('button')
+generator.make()
+```
+
+## Methods
+
+### Control
+
+- `make(): void` — Starts the comprehensive generation process for all component-related files.
+
+## Operations
+
+### Generated Files Structure
+
+When `make()` is executed, the following file hierarchy is created or updated within the component's directory:
+
+- `properties.json` — Stores primary mapping data for the component.
+- `props.ts` — The TypeScript definition for component props, resolved from constructor templates.
+- `styleToken.scss` — SCSS style tokens based on the component's design structure.
+- `[Name].vue` — The primary Vue component file with pre-configured classes and styles.
+- `[Name]AiWiki.vue` — A companion component for AI-enhanced wiki documentation.
+- `index.ts` — The component's entry point for public exports.
+- `wiki.ts` & `wikiData.ts` — Metadata and structured property information for the documentation site.
+- `[Name].stories.ts` — Automated Storybook stories with dynamic component resolution.
+- `[Name].mdx` — Markdown documentation for Storybook with pre-filled slots and props data.
+
+### Integration Process
+
+The class ensures that the new component is fully integrated into the design system environment:
+1. **Package Update**: Adds an entry to the root `package.json` under `exports`.
+2. **Library Export**: Creates a proxy file in the library directory to enable global component imports.
+3. **Wiki Description Matching**: Scans `wikiDescriptions` to automatically populate Storybook stories with relevant examples.