@dxtmisha/wiki 0.39.1 → 0.39.2

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.

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

@@ -0,0 +1,60 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Classes/DesignComponent - Генератор компонентов дизайна'/>
+
+# Класс DesignComponent
+
+Класс `DesignComponent` — это специализированная реализация `DesignCommand`, предназначенная для автоматизированного создания и обслуживания компонентов дизайн-системы. Он координирует генерацию множества типов файлов — от стилей и логики компонентов до документации и метаданных интеграции.
+
+## Ключевые особенности
+
+- **Полный цикл развертывания** — автоматически генерирует более 10 основных файлов для нового компонента (Vue, SCSS, TS, MDX).
+- **Интеллектуальное разрешение свойств** — использует `DesignTypescript` для внедрения свойств компонентов непосредственно в сгенерированные файлы.
+- **Автоматизация Storybook** — генерирует файлы `.stories.ts` и `.mdx` с автоматическим разрешением рендеринга и импорта.
+- **AI-усиленная Вики** — создает специальные сопутствующие компоненты для поиска и отображения документации с помощью ИИ.
+- **Интеграция с воркспейсом** — бесшовно регистрирует новые компоненты в корневом `package.json` и в глобальном списке экспорта библиотеки.
+- **Маппинг стилевых токенов** — автоматически преобразует структуры проекта в SCSS-токены стилей.
+
+## Инициализация
+
+Для инициализации экземпляра генератора используйте конструктор. Он настраивает целевую директорию на основе конфигурации проекта.
+
+**Параметры:**
+- `command: string` — идентификатор компонента (например, `'button'`, `'input'`).
+- `options: Record<string, string>` — необязательные конфигурационные флаги.
+
+```typescript
+import { DesignComponent } from '@dxtmisha/scripts'
+
+const generator = new DesignComponent('button')
+generator.make()
+```
+
+## Методы
+
+### Управление
+
+- `make(): void` — запускает комплексный процесс генерации для всех файлов, связанных с компонентом.
+
+## Операции
+
+### Структура генерируемых файлов
+
+При выполнении `make()` внутри директории компонента создается или обновляется следующая иерархия файлов:
+
+- `properties.json` — хранит основные данные маппинга для компонента.
+- `props.ts` — TypeScript-определение пропсов компонента, разрешенное из шаблонов конструктора.
+- `styleToken.scss` — токены стилей SCSS на основе структуры дизайна компонента.
+- `[Name].vue` — основной файл компонента Vue с предварительно настроенными классами и стилями.
+- `[Name]AiWiki.vue` — сопутствующий компонент для AI-усиленной вики-документации.
+- `index.ts` — точка входа компонента для публичного экспорта.
+- `wiki.ts` и `wikiData.ts` — метаданные и структурированная информация о свойствах для сайта документации.
+- `[Name].stories.ts` — автоматизированные истории Storybook с динамическим разрешением компонентов.
+- `[Name].mdx` — MDX-документация для Storybook с предварительно заполненными слотами и данными пропсов.
+
+### Процесс интеграции
+
+Класс обеспечивает полную интеграцию нового компонента в среду дизайн-системы:
+1. **Обновление пакета**: добавляет запись в корневой `package.json` в секцию `exports`.
+2. **Экспорт библиотеки**: создает прокси-файл в директории библиотеки для обеспечения возможности глобального импорта компонентов.
+3. **Сопоставление описаний Вики**: сканирует `wikiDescriptions` для автоматического заполнения историй Storybook соответствующими примерами.

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

@@ -0,0 +1,60 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Classes/DesignComponent - Trình tạo thành phần thiết kế'/>
+
+# Lớp DesignComponent
+
+Lớp `DesignComponent` là một triển khai chuyên biệt của `DesignCommand` dành riêng cho việc tự động tạo và bảo trì các thành phần hệ thống thiết kế. Nó điều phối việc tạo ra đa dạng các loại tệp — từ kiểu dáng và logic thành phần đến tài liệu và siêu dữ liệu tích hợp.
+
+## Các tính năng chính
+
+- **Tạo khung đầy đủ (Full-Cycle Scaffolding)** — Tự động tạo hơn 10 tệp thiết yếu cho một thành phần mới (Vue, SCSS, TS, MDX).
+- **Phân giải thuộc tính thông minh** — Sử dụng `DesignTypescript` để đưa các thuộc tính (props) của thành phần trực tiếp vào các tệp được tạo.
+- **Tự động hóa Storybook** — Tạo các tệp `.stories.ts` và `.mdx` với tính năng tự động phân giải render và import.
+- **Wiki tăng cường AI** — Tạo các thành phần bổ trợ chuyên biệt để tìm kiếm và hiển thị tài liệu do AI hỗ trợ.
+- **Tích hợp Workspace** — Đăng ký các thành phần mới một cách liền mạch trong tệp `package.json` gốc và danh sách xuất bản toàn cầu của thư viện.
+- **Ánh xạ Style Token** — Tự động chuyển đổi cấu trúc dự án thành các style token SCSS.
+
+## Khởi tạo
+
+Để khởi tạo một thực thể trình tạo, hãy sử dụng hàm khởi tạo. Lưu ý rằng nó sẽ thiết lập thư mục mục tiêu dựa trên cấu hình dự án.
+
+**Tham số:**
+- `command: string` — Mã định danh cho thành phần (ví dụ: `'button'`, `'input'`).
+- `options: Record<string, string>` — Các cờ cấu hình tùy chọn.
+
+```typescript
+import { DesignComponent } from '@dxtmisha/scripts'
+
+const generator = new DesignComponent('button')
+generator.make()
+```
+
+## Các phương thức
+
+### Điều khiển
+
+- `make(): void` — Bắt đầu quá trình tạo toàn diện cho tất cả các tệp liên quan đến thành phần.
+
+## Các thao tác (Operations)
+
+### Cấu trúc các tệp được tạo
+
+Khi `make()` được thực thi, hệ thống phân cấp tệp sau sẽ được tạo hoặc cập nhật trong thư mục của thành phần:
+
+- `properties.json` — Lưu trữ dữ liệu ánh xạ chính cho thành phần.
+- `props.ts` — Định nghĩa TypeScript cho các props của thành phần, được phân giải từ các mẫu constructor.
+- `styleToken.scss` — Các style token SCSS dựa trên cấu trúc thiết kế của thành phần.
+- `[Name].vue` — Tệp thành phần Vue chính với các lớp và kiểu dáng được cấu hình sẵn.
+- `[Name]AiWiki.vue` — Thành phần hỗ trợ cho tài liệu wiki tăng cường AI.
+- `index.ts` — Điểm nhập của thành phần cho các xuất bản công khai.
+- `wiki.ts` & `wikiData.ts` — Siêu dữ liệu và thông tin thuộc tính có cấu trúc cho trang web tài liệu.
+- `[Name].stories.ts` — Các câu chuyện Storybook tự động với phân giải thành phần động.
+- `[Name].mdx` — Tài liệu Markdown cho Storybook với các slot và dữ liệu props được điền sẵn.
+
+### Quy trình tích hợp
+
+Lớp này đảm bảo rằng thành phần mới được tích hợp hoàn toàn vào môi trường hệ thống thiết kế:
+1. **Cập nhật gói**: Thêm một mục vào `package.json` gốc trong phần `exports`.
+2. **Xuất bản thư viện**: Tạo một tệp proxy trong thư mục thư viện để cho phép nhập thành phần toàn cầu.
+3. **Khớp mô tả Wiki**: Quét `wikiDescriptions` để tự động điền các câu chuyện Storybook với các ví dụ liên quan.

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

@@ -0,0 +1,58 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Classes/DesignConstructor - Design Constructor Generator'/>
+
+# DesignConstructor Class
+
+The `DesignConstructor` class is a specialized implementation of `DesignCommand` focused on generating the internal logic and "constructors" for components. It automates the creation of property definitions, TypeScript types, and styling hooks that form the foundation of a component's behavioral layer.
+
+## Key Features
+
+- **Constructor Scaffolding** — Automatically generates the entire file set required for a component's behavioral logic.
+- **Type Safety Automation** — Generates `props.ts`, `types.ts`, and `basicTypes.ts` to ensure strict typing across the component.
+- **Styling Foundation** — Creates the initial `style.scss` file compatible with the constructor's class system.
+- **Unified Logic Generation** — Produces both `.ts` and `.tsx` files for flexible component logic implementation.
+- **System Integration** — Automatically updates `package.json` and creates library exports for the new constructor.
+
+## Initialization
+
+To initialize a generator instance, use the constructor. It automatically resolves the target directory within the `src/constructors` folder.
+
+**Parameters:**
+- `command: string` — The unique identifier for the component (e.g., `'button'`, `'list'`).
+- `options: Record<string, string>` — Optional configuration key-value pairs.
+
+```typescript
+import { DesignConstructor } from '@dxtmisha/scripts'
+
+const generator = new DesignConstructor('button')
+generator.make()
+```
+
+## Methods
+
+### Control
+
+- `make(): void` — Executes the full sequence of directory creation, file generation, and system registration.
+
+## Operations
+
+### Generated Files Structure
+
+When initialized, `DesignConstructor` processes several template-driven files:
+
+- `properties.json` — Mapping configuration for the constructor's internal properties.
+- `props.ts` — Property definitions including types and default values.
+- `types.ts` & `basicTypes.ts` — TypeScript interfaces and type definitions for component state and configuration.
+- `style.scss` — Initial style definitions linked to the constructor's class structure.
+- `Constructors.ts` — The main logic implementation file.
+- `ConstructorsDesign.tsx` — The visual/render layer implementation using TSX.
+- `index.ts` — The entry point for the constructor's exports.
+
+### Lifecycle of Execution
+
+The `make()` process executes in a precise order to maintain data integrity:
+1. **Directory Setup**: Resolves and confirms the target path in the `src/constructors` directory.
+2. **File Generation**: Sequentially calls specialized `make[File]()` methods to transform templates into project code.
+3. **Internal Integration**: Updates the project's root `package.json` mapping to expose the new constructor.
+4. **Library Publication**: Generates an export file in the library's root directory to enable global consumption.

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

@@ -0,0 +1,58 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Classes/DesignConstructor - Генератор конструктора дизайна'/>
+
+# Класс DesignConstructor
+
+Класс `DesignConstructor` — это специализированная реализация `DesignCommand`, ориентированная на генерацию внутренней логики и «конструкторов» компонентов. Он автоматизирует создание определений свойств, типов TypeScript и стилевых хуков, которые формируют основу поведенческого слоя компонента.
+
+## Ключевые особенности
+
+- **Развертывание конструктора** — автоматически генерирует полный набор файлов, необходимых для реализации поведенческой логики компонента.
+- **Автоматизация типизации** — создает `props.ts`, `types.ts` и `basicTypes.ts` для обеспечения строгой типизации всех частей компонента.
+- **Стилевой фундамент** — создает начальный файл `style.scss`, совместимый с системой классов конструктора.
+- **Генерация унифицированной логики** — создает файлы `.ts` и `.tsx` для гибкой реализации логики компонентов.
+- **Системная интеграция** — автоматически обновляет `package.json` и создает экспорты библиотеки для нового конструктора.
+
+## Инициализация
+
+Для инициализации экземпляра генератора используйте конструктор. Он автоматически определяет целевую директорию внутри папки `src/constructors`.
+
+**Параметры:**
+- `command: string` — уникальный идентификатор компонента (например, `'button'`, `'list'`).
+- `options: Record<string, string>` — дополнительные параметры конфигурации в формате ключ-значение.
+
+```typescript
+import { DesignConstructor } from '@dxtmisha/scripts'
+
+const generator = new DesignConstructor('button')
+generator.make()
+```
+
+## Методы
+
+### Управление
+
+- `make(): void` — запускает полную последовательность создания директорий, генерации файлов и системной регистрации.
+
+## Операции
+
+### Структура генерируемых файлов
+
+При инициализации `DesignConstructor` обрабатывает несколько файлов на основе шаблонов:
+
+- `properties.json` — конфигурация маппинга для внутренних свойств конструктора.
+- `props.ts` — определения свойств, включая типы и значения по умолчанию.
+- `types.ts` и `basicTypes.ts` — интерфейсы TypeScript и определения типов для состояния и конфигурации компонента.
+- `style.scss` — начальные определения стилей, связанные со структурой классов конструктора.
+- `Constructors.ts` — основной файл реализации логики.
+- `ConstructorsDesign.tsx` — реализация визуального слоя/рендеринга с использованием TSX.
+- `index.ts` — точка входа для экспортов конструктора.
+
+### Жизненный цикл выполнения
+
+Процесс `make()` выполняется в строгом порядке для сохранения целостности данных:
+1. **Настройка директорий**: определяет и подтверждает целевой путь в директории `src/constructors`.
+2. **Генерация файлов**: последовательно вызывает специализированные методы `make[File]()` для преобразования шаблонов в код проекта.
+3. **Внутренняя интеграция**: обновляет `package.json` проекта для предоставления доступа к новому конструктору.
+4. **Публикация библиотеки**: генерирует файл экспорта в корневой директории библиотеки для обеспечения глобального использования.