@dxtmisha/wiki 0.65.0 → 0.67.0

package/src/media/functional/scripts/bin/dxt-package/design-package.vi.mdx

@@ -0,0 +1,48 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/bin/dxt-package - Khởi tạo Cấu trúc Package'/>
+
+# dxt-package
+
+Lệnh `dxt-package` tự động hóa việc khởi tạo cấu trúc package mới và môi trường phát triển dựa trên các mẫu được xác định trước. Dưới mui xe, nó sử dụng các lớp `PackageInit` và `PackageInitItem` để xử lý các thư mục package trống và tạo bộ khung nền tảng cho chúng.
+
+## Các tính năng chính
+
+- **Tự động Quét Thư mục**: Tự động quét thư mục cơ sở được định cấu hình (mặc định là `packages/`) và xác định các thư mục package trống cần được khởi tạo.
+- **Tạo khung dựa trên mẫu**: Hỗ trợ áp dụng các mẫu cụ thể để tùy chỉnh quá trình tạo, điều chỉnh cấu trúc khung dựa trên `type` của package được cung cấp.
+- **Cấu hình Linh hoạt**: Cho phép ghi đè loại package mặc định, các mẫu và thư mục cơ sở đích thông qua các đối số dòng lệnh.
+
+## Cách thức hoạt động?
+
+Quy trình khởi tạo package giúp đơn giản hóa việc tạo các package mới:
+
+1. Script đọc các đối số được cung cấp để xác định `type` của package (mặc định là `library`), các `templates` và thư mục đích `dir`.
+2. Nó quét thư mục đích để tìm bất kỳ thư mục trống nào (các thư mục không chứa phần tử con).
+3. Đối với mỗi thư mục trống được tìm thấy, nó khởi tạo một phiên bản `PackageInitItem`, truyền vào đường dẫn package, loại và các mẫu.
+4. Sau đó, hệ thống xử lý các cấu hình này để tạo ra các tệp bắt buộc và cấu trúc môi trường cho package, giúp nó sẵn sàng để phát triển.
+
+## Cấu hình và khởi chạy
+
+Để khởi tạo các thư mục package trống mới được tạo với loại `library` mặc định, hãy chạy:
+```bash
+npx dxt-package
+```
+
+Để chỉ định một loại package tùy chỉnh (ví dụ: `vue`), hãy chạy:
+```bash
+npx dxt-package vue
+```
+
+Để chỉ định loại tùy chỉnh và áp dụng các mẫu cụ thể, hãy truyền chúng dưới dạng đối số:
+```bash
+npx dxt-package vue "template1,template2"
+```
+
+Bạn cũng có thể chỉ định một thư mục cơ sở tùy chỉnh làm đối số thứ ba:
+```bash
+npx dxt-package vue "template1" "packages/custom-dir"
+```
+
+## Cấu trúc được tạo
+
+Khi lệnh xử lý một thư mục trống, nó sẽ tạo ra các tệp cơ sở cần thiết cho loại package và các mẫu đã cho. Điều này thường bao gồm các tệp cấu trúc, cấu hình cơ bản và điểm truy cập, biến một thư mục trống thành một môi trường package đầy đủ chức năng trong không gian làm việc.

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

@@ -0,0 +1,34 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Classes/BuildPackages - Library Builder for Monorepo' />
+
+# BuildPackages Class
+
+The `BuildPackages` class is a utility responsible for rebuilding changed npm packages across the monorepo workspace. It scans the `packages` directory, determines version changes compared to a local log cache, and incrementally builds only packages with updated versions.
+
+## Key Features
+
+- **Automated Directory Scanning** — Scans the packages folder (`packages/`) for directories containing a valid `package.json`.
+- **Incremental Version-Based Caching** — Compares the package version with `./logs/ui-build.log.json` to prevent rebuilding unchanged code.
+- **Intelligent Script Resolution** — Runs `build-recovery` if defined in `package.json` scripts, otherwise falls back to `build`.
+- **Test Package Filtering** — Ignores packages marked with `"ui-test": true`.
+
+## Initialization
+
+You can create an instance of `BuildPackages` by optionally passing a custom packages directory path.
+
+```typescript
+import { BuildPackages } from './BuildPackages'
+
+const builder = new BuildPackages()
+await builder.make()
+```
+
+## Methods
+
+- `make(): Promise<void>` — Initiates scanning and triggers the incremental build process for each detected package.
+- `build(packageFile: PackageFile): Promise<boolean>` — Executes the actual build command (`npm run build-recovery` or `npm run build`) for the package.
+- `isUpdate(packageFile: PackageFile): boolean` — Checks whether the package's version in `package.json` is different from the version stored in the log file.
+- `getVersionLog(name: string): string` — Retrieves the cached version of the package from the build log.
+- `updateLog(packageFile: PackageFile): void` — Updates the in-memory build log with the current package version.
+- `saveLog(): void` — Saves the in-memory build log to the `./logs/ui-build.log.json` file.

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

@@ -0,0 +1,34 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Classes/BuildPackages - Сборщик пакетов монорепозитория' />
+
+# Класс BuildPackages
+
+Класс `BuildPackages` — это утилита, отвечающая за сборку измененных npm-пакетов в рабочем пространстве монорепозитория. Он сканирует директорию `packages`, определяет изменения версий по сравнению с локальным кэшем логов и выполняет инкрементальную сборку только тех пакетов, чьи версии обновились.
+
+## Ключевые особенности
+
+- **Автоматическое сканирование директорий** — сканирует папку пакетов (`packages/`) на наличие директорий с корректным файлом `package.json`.
+- **Инкрементальное кэширование по версиям** — сравнивает версию пакета с данными в `./logs/ui-build.log.json` для предотвращения повторной сборки неизмененного кода.
+- **Интеллектуальный выбор скрипта** — запускает `build-recovery`, если он объявлен в скриптах `package.json`, иначе переходит к стандартной сборке `build`.
+- **Фильтрация тестовых пакетов** — игнорирует пакеты, отмеченные свойством `"ui-test": true`.
+
+## Инициализация
+
+Вы можете создать экземпляр `BuildPackages`, опционально передав кастомный путь к директории пакетов.
+
+```typescript
+import { BuildPackages } from './BuildPackages'
+
+const builder = new BuildPackages()
+await builder.make()
+```
+
+## Методы
+
+- `make(): Promise<void>` — инициализирует сканирование и запускает инкрементальный процесс сборки для каждого обнаруженного пакета.
+- `build(packageFile: PackageFile): Promise<boolean>` — выполняет команду сборки (`npm run build-recovery` или `npm run build`) для указанного пакета.
+- `isUpdate(packageFile: PackageFile): boolean` — проверяет, отличается ли текущая версия пакета в `package.json` от версии, сохраненной в файле лога.
+- `getVersionLog(name: string): string` — возвращает кэшированную версию пакета из лога сборки.
+- `updateLog(packageFile: PackageFile): void` — обновляет оперативную копию лога сборки текущей версией пакета.
+- `saveLog(): void` — сохраняет лог сборки из оперативной памяти в файл `./logs/ui-build.log.json`.

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

@@ -0,0 +1,34 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Classes/BuildPackages - Bộ xây dựng gói Monorepo' />
+
+# Lớp BuildPackages
+
+Lớp `BuildPackages` là một tiện ích chịu trách nhiệm xây dựng lại các gói npm đã thay đổi trong không gian làm việc monorepo. Nó quét thư mục `packages`, xác định các thay đổi phiên bản so với bộ nhớ đệm nhật ký cục bộ và thực hiện biên dịch tăng dần chỉ cho các gói có phiên bản được cập nhật.
+
+## Các tính năng chính
+
+- **Tự động quét thư mục** — Quét thư mục gói (`packages/`) để tìm các thư mục chứa tệp `package.json` hợp lệ.
+- **Bộ nhớ đệm tăng dần theo phiên bản** — So sánh phiên bản gói với dữ liệu trong `./logs/ui-build.log.json` để ngăn việc xây dựng lại mã chưa thay đổi.
+- **Giải quyết tập lệnh thông minh** — Chạy `build-recovery` nếu được định nghĩa trong tập lệnh `package.json`, ngược lại sẽ chuyển sang xây dựng mặc định `build`.
+- **Lọc gói thử nghiệm** — Bỏ qua các gói được đánh dấu bằng thuộc tính `"ui-test": true`.
+
+## Khởi tạo
+
+Bạn có thể tạo một phiên bản của `BuildPackages` bằng cách truyền tùy chọn đường dẫn thư mục gói tùy chỉnh.
+
+```typescript
+import { BuildPackages } from './BuildPackages'
+
+const builder = new BuildPackages()
+await builder.make()
+```
+
+## Các phương thức
+
+- `make(): Promise<void>` — Khởi tạo quá trình quét và kích hoạt quy trình xây dựng tăng dần cho từng gói được phát hiện.
+- `build(packageFile: PackageFile): Promise<boolean>` — Thực thi lệnh xây dựng thực tế (`npm run build-recovery` hoặc `npm run build`) cho gói được chỉ định.
+- `isUpdate(packageFile: PackageFile): boolean` — Kiểm tra xem phiên bản hiện tại của gói trong `package.json` có khác với phiên bản được lưu trữ trong tệp nhật ký hay không.
+- `getVersionLog(name: string): string` — Lấy phiên bản được lưu trong bộ nhớ đệm của gói từ nhật ký xây dựng.
+- `updateLog(packageFile: PackageFile): void` — Cập nhật bản ghi nhật ký xây dựng trong bộ nhớ với phiên bản gói hiện tại.
+- `saveLog(): void` — Lưu nhật ký xây dựng từ bộ nhớ tạm vào tệp `./logs/ui-build.log.json`.

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

@@ -0,0 +1,33 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Classes/BuildPublishPackages - Monorepo Package Publisher' />
+
+# BuildPublishPackages Class
+
+The `BuildPublishPackages` class is a utility responsible for automated publishing of npm packages across the monorepo workspace. It scans the `packages` directory, determines version changes compared to a local log cache, and publishes updated packages to npm.
+
+## Key Features
+
+- **Automated Directory Scanning** — Scans the packages folder (`packages/`) for directories containing a valid `package.json`.
+- **Incremental Version-Based Caching** — Compares the package version with `./logs/ui-publish.log.json` to prevent republishing unchanged code.
+- **Intelligent Script Resolution** — Runs `publish-to-npm` if defined in `package.json` scripts, otherwise falls back to standard `npm publish --access public`.
+- **Publish Exclusion** — Skips packages marked as private (`"private": true`) or with `"ui-no-publish": true`.
+
+## Initialization
+
+You can create an instance of `BuildPublishPackages` by optionally passing a custom packages directory path.
+
+```typescript
+import { BuildPublishPackages } from './BuildPublishPackages'
+
+const publisher = new BuildPublishPackages()
+await publisher.make()
+```
+
+## Methods
+
+- `make(): Promise<void>` — Initiates scanning and triggers the publication process for each detected package.
+- `isUpdate(packageFile: PackageFile): boolean` — Checks whether the package's version in `package.json` is different from the version stored in the log file.
+- `getVersionLog(name: string): string` — Retrieves the cached version of the package from the publish log.
+- `updateLog(packageFile: PackageFile): void` — Updates the in-memory publish log with the current package version.
+- `saveLog(): void` — Saves the in-memory publish log to the `./logs/ui-publish.log.json` file.

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

@@ -0,0 +1,33 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Classes/BuildPublishPackages - Публикатор пакетов монорепозитория' />
+
+# Класс BuildPublishPackages
+
+Класс `BuildPublishPackages` — это утилита, отвечающая за автоматическую публикацию npm-пакетов в рабочем пространстве монорепозитория. Он сканирует директорию `packages`, определяет изменения версий по сравнению с локальным кэшем логов и публикует обновленные пакеты в npm.
+
+## Ключевые возможности
+
+- **Автоматическое сканирование директорий** — сканирует папку пакетов (`packages/`) на наличие директорий с корректным файлом `package.json`.
+- **Инкрементальное кэширование по версиям** — сравнивает версию пакета с данными в `./logs/ui-publish.log.json` для предотвращения повторной публикации неизмененного кода.
+- **Интеллектуальный выбор скрипта** — запускает `publish-to-npm`, если он объявлен в скриптах `package.json`, иначе переходит к стандартной публикации `npm publish --access public`.
+- **Исключение из публикации** — игнорирует пакеты, отмеченные свойством `"private": true` или `"ui-no-publish": true`.
+
+## Инициализация
+
+Вы можете создать экземпляр `BuildPublishPackages`, опционально передав кастомный путь к директории пакетов.
+
+```typescript
+import { BuildPublishPackages } from './BuildPublishPackages'
+
+const publisher = new BuildPublishPackages()
+await publisher.make()
+```
+
+## Методы
+
+- `make(): Promise<void>` — инициализирует сканирование и запускает процесс публикации для каждого обнаруженного пакета.
+- `isUpdate(packageFile: PackageFile): boolean` — проверяет, отличается ли текущая версия пакета в `package.json` от версии, сохраненной в файле лога.
+- `getVersionLog(name: string): string` — возвращает кэшированную версию пакета из лога публикации.
+- `updateLog(packageFile: PackageFile): void` — обновляет оперативную копию лога публикации текущей версией пакета.
+- `saveLog(): void` — сохраняет лог публикации из оперативной памяти в файл `./logs/ui-publish.log.json`.

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

@@ -0,0 +1,33 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Classes/BuildPublishPackages - Bộ công bố gói Monorepo' />
+
+# Lớp BuildPublishPackages
+
+Lớp `BuildPublishPackages` là một tiện ích chịu trách nhiệm công bố tự động các gói npm trong không gian làm việc monorepo. Nó quét thư mục `packages`, xác định các thay đổi phiên bản so với bộ nhớ đệm nhật ký cục bộ và công bố các gói đã cập nhật lên npm.
+
+## Các tính năng chính
+
+- **Tự động quét thư mục** — Quét thư mục gói (`packages/`) để tìm các thư mục chứa tệp `package.json` hợp lệ.
+- **Bộ nhớ đệm tăng dần theo phiên bản** — So sánh phiên bản gói với dữ liệu trong `./logs/ui-publish.log.json` để ngăn việc công bố lại mã chưa thay đổi.
+- **Giải quyết tập lệnh thông minh** — Chạy `publish-to-npm` nếu được định nghĩa trong tập lệnh `package.json`, ngược lại sẽ chuyển sang công bố mặc định `npm publish --access public`.
+- **Loại trừ công bố** — Bỏ qua các gói được đánh dấu bằng thuộc tính `"private": true` hoặc `"ui-no-publish": true`.
+
+## Khởi tạo
+
+Bạn có thể tạo một phiên bản của `BuildPublishPackages` bằng cách truyền tùy chọn đường dẫn thư mục gói tùy chỉnh.
+
+```typescript
+import { BuildPublishPackages } from './BuildPublishPackages'
+
+const publisher = new BuildPublishPackages()
+await publisher.make()
+```
+
+## Các phương thức
+
+- `make(): Promise<void>` — Khởi tạo quá trình quét và kích hoạt quy trình công bố cho từng gói được phát hiện.
+- `isUpdate(packageFile: PackageFile): boolean` — Kiểm tra xem phiên bản hiện tại của gói trong `package.json` có khác với phiên bản được lưu trữ trong tệp nhật ký hay không.
+- `getVersionLog(name: string): string` — Lấy phiên bản được lưu trong bộ nhớ đệm của gói từ nhật ký công bố.
+- `updateLog(packageFile: PackageFile): void` — Cập nhật bản ghi nhật ký công bố trong bộ nhớ với phiên bản gói hiện tại.
+- `saveLog(): void` — Lưu nhật ký công bố từ bộ nhớ tạm vào tệp `./logs/ui-publish.log.json`.

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

@@ -0,0 +1,54 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Classes/DesignFigma - Figma Layout Integrator Class'/>
+
+# DesignFigma Class
+
+The `DesignFigma` class provides the core controller behavior for connecting to Figma's REST API and extracting layout coordinates and vector image structures. It abstracts token authorization and simplifies batch node image requests into clean, async workflows.
+
+> **Warning**: A corporate Figma subscription (Figma Enterprise or Organization) is strictly required to utilize this class and communicate with the Figma target endpoints.
+
+## Key Features
+
+- **Decoupled API Authorizer** — automatically falls back to system properties to retrieve active Figma tokens.
+- **SVG Generation Options** — requests nodes with preserved ID tags and outline text parameters.
+- **Safe Network Execution** — handles network errors and API limitations gracefully, returning clean, undefined fallbacks.
+
+## Initialization
+
+Initialize a new `DesignFigma` instance with the required Figma file credentials.
+
+**Parameters:**
+- `fileKey: string` — The unique ID of the target Figma file.
+- `nodeId?: string` — The specific node ID inside the file to target.
+- `token?: string` — Optional Figma API token. Defaults to `PropertiesConfig.getFigmaToken()`.
+
+```typescript
+import { DesignFigma } from '@dxtmisha/scripts'
+
+const integrator = new DesignFigma('abc123xyz456', '1-24')
+await integrator.make()
+```
+
+## Methods
+
+### `make`
+
+The main orchestrator method that triggers vector asset retrieval and logs the output mapping to the console.
+
+**Returns:** `Promise<void>`
+
+```typescript
+await integrator.make()
+```
+
+### `initImage`
+
+Requests vector layout image URLs from the Figma API for the specified node IDs in SVG format.
+
+**Returns:** `Promise<Record<string, string> | undefined>` — A promise that resolves to an object mapping node IDs to their respective SVG URLs, or `undefined` on error.
+
+```typescript
+const images = await integrator.initImage()
+console.log(images) // { "1-24": "https://..." }
+```

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

@@ -0,0 +1,54 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Classes/DesignFigma - Класс интеграции макетов Figma'/>
+
+# Класс DesignFigma
+
+Класс `DesignFigma` обеспечивает базовое поведение контроллера для подключения к Figma REST API и извлечения координат макетов и структур векторных изображений. Он абстрагирует авторизацию токенов и упрощает пакетные запросы изображений узлов в чистые асинхронные рабочие процессы.
+
+> **Внимание**: Для использования этого класса и взаимодействия с целевыми эндпоинтами Figma строго требуется наличие корпоративной подписки Figma (Figma Enterprise или Organization).
+
+## Ключевые возможности
+
+- **Развязанная авторизация API** — автоматически использует системные свойства для получения активного токена Figma.
+- **Опции генерации SVG** — запрашивает узлы с сохранением тегов исходных идентификаторов и параметров обводки текста.
+- **Безопасное сетевое выполнение** — корректно обрабатывает сетевые ошибки и ограничения API, возвращая безопасные значения `undefined` в качестве альтернативы.
+
+## Инициализация
+
+Инициализируйте новый экземпляр `DesignFigma` с необходимыми учетными данными целевого файла Figma.
+
+**Параметры:**
+- `fileKey: string` — Уникальный идентификатор целевого файла Figma.
+- `nodeId?: string` — Конкретный идентификатор узла внутри файла для нацеливания.
+- `token?: string` — Необязательный токен Figma API. По умолчанию используется значение `PropertiesConfig.getFigmaToken()`.
+
+```typescript
+import { DesignFigma } from '@dxtmisha/scripts'
+
+const integrator = new DesignFigma('abc123xyz456', '1-24')
+await integrator.make()
+```
+
+## Методы
+
+### `make`
+
+Основной оркестрирующий метод, который запускает получение векторных ресурсов и выводит результирующее сопоставление в консоль.
+
+**Возвращает:** `Promise<void>`
+
+```typescript
+await integrator.make()
+```
+
+### `initImage`
+
+Запрашивает URL-адреса изображений векторных макетов из Figma API для указанных идентификаторов узлов в формате SVG.
+
+**Возвращает:** `Promise<Record<string, string> | undefined>` — Промис, разрешающийся в объект, сопоставляющий идентификаторы узлов с соответствующими URL-адресами SVG, или `undefined` в случае ошибки.
+
+```typescript
+const images = await integrator.initImage()
+console.log(images) // { "1-24": "https://..." }
+```

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

@@ -0,0 +1,54 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Classes/DesignFigma - Lớp tích hợp Layout Figma'/>
+
+# Lớp DesignFigma
+
+Lớp `DesignFigma` cung cấp hành vi bộ điều khiển cốt lõi để kết nối với REST API của Figma và trích xuất các tọa độ layout cũng như cấu trúc hình ảnh vector. Nó trừu tượng hóa việc ủy quyền mã thông báo và đơn giản hóa các yêu cầu hình ảnh nút hàng loạt thành các quy trình bất đồng bộ sạch sẽ.
+
+> **Lưu ý**: Yêu cầu bắt buộc phải có gói đăng ký Figma doanh nghiệp (Figma Enterprise hoặc Organization) để sử dụng lớp này và giao tiếp với các điểm cuối Figma mục tiêu.
+
+## Các tính năng chính
+
+- **Ủy quyền API Tách biệt** — Tự động tìm lại các thuộc tính hệ thống để truy xuất mã thông báo Figma đang hoạt động.
+- **Tùy chọn Tạo sinh SVG** — Yêu cầu các nút với thẻ ID được bảo toàn và tham số viền chữ.
+- **Thực thi Mạng An toàn** — Xử lý các lỗi mạng và giới hạn API một cách mượt mờ, trả về các giá trị dự phòng `undefined` an toàn.
+
+## Khởi tạo
+
+Khởi tạo một phiên bản `DesignFigma` mới với thông tin xác thực tệp Figma được yêu cầu.
+
+**Tham số:**
+- `fileKey: string` — ID duy nhất của tệp Figma mục tiêu.
+- `nodeId?: string` — ID nút cụ thể bên trong tệp cần nhắm mục tiêu.
+- `token?: string` — Mã thông báo Figma API tùy chọn. Mặc định là `PropertiesConfig.getFigmaToken()`.
+
+```typescript
+import { DesignFigma } from '@dxtmisha/scripts'
+
+const integrator = new DesignFigma('abc123xyz456', '1-24')
+await integrator.make()
+```
+
+## Các phương thức
+
+### `make`
+
+Phương thức điều phối chính kích hoạt quá trình truy xuất tài nguyên vector và in bản đồ kết quả ra console.
+
+**Trả về:** `Promise<void>`
+
+```typescript
+await integrator.make()
+```
+
+### `initImage`
+
+Yêu cầu các URL hình ảnh layout vector từ Figma API cho các ID nút được chỉ định dưới định dạng SVG.
+
+**Trả về:** `Promise<Record<string, string> | undefined>` — Một hứa hẹn (promise) phân giải thành một đối tượng ánh xạ các ID nút tới các URL SVG tương ứng của chúng, hoặc `undefined` khi xảy ra lỗi.
+
+```typescript
+const images = await integrator.initImage()
+console.log(images) // { "1-24": "https://..." }
+```

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

@@ -6,6 +6,8 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 The `DesignFlags` class provides an automated solution for generating optimized image sprites from a collection of SVG flag icons. It handles the canvas-based rendering, grid layout calculation, and the generation of CSS mapping files for efficient icon display using background positioning.
 
+> **Note**: This class is intended exclusively for internal use within the `dxt-ui` project repository.
+
 ## Key Features
 
 - **Automated Sprite Assembly** — Combines multiple individual SVG files into a single optimized `.webp` sprite.

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

@@ -6,6 +6,8 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 Класс `DesignFlags` предоставляет автоматизированное решение для генерации оптимизированных спрайтов изображений из коллекции SVG-иконок флагов. Он управляет рендерингом на основе холста, расчетом сетки и созданием файлов CSS-маппинга для эффективного отображения иконок с использованием позиционирования фона.
 
+> **Примечание**: Этот класс предназначен исключительно для внутреннего использования в репозитории проекта `dxt-ui`.
+
 ## Ключевые особенности
 
 - **Автоматическая сборка спрайта** — объединяет множество отдельных SVG-файлов в один оптимизированный спрайт формата `.webp`.

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

@@ -6,6 +6,8 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 Lớp `DesignFlags` cung cấp một giải pháp tự động để tạo các sprite hình ảnh được tối ưu hóa từ một bộ sưu tập các biểu tượng cờ SVG. Nó xử lý việc hiển thị dựa trên canvas, tính toán bố cục lưới và tạo các tệp ánh xạ CSS để hiển thị biểu tượng hiệu quả bằng cách sử dụng định vị nền (background positioning).
 
+> **Lưu ý**: Lớp này chỉ dành riêng cho việc sử dụng nội bộ bên trong kho lưu trữ dự án `dxt-ui`.
+
 ## Các tính năng chính
 
 - **Tự động đóng gói Sprite** — Kết hợp nhiều tệp SVG riêng lẻ thành một sprite `.webp` duy nhất được tối ưu hóa.

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

@@ -4,18 +4,18 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 # LibraryExport Class
 
-The `LibraryExport` class is responsible for aggregating and generating a unified export file for the library. It scans designated directories for TypeScript and Vue files, creating a single entry point that simplifies library imports.
+The `LibraryExport` class is responsible for aggregating and generating a unified export file for the library. It scans designated subfolders for TypeScript and Vue files, automatically compiling all exports into a single public interface to simplify library imports.
 
 ## Key Features
 
-- **Unified Export Generation** — creates a comprehensive entry point for all exportable components and utilities.
-- **Smart File Identification** — automatically handles exports for `.ts` files (using `export *`) and `.vue` files (using `import` then `export const`).
-- **Style Integration** — automatically includes global CSS or SCSS styles if they exist.
-- **Filtering** — excludes test files (`.test.`) and files marked with the `UI_FLAG_NOT_EXPORT` flag.
+- **Unified Export Generation** — Creates a comprehensive public entry point for all components, composables, functions, and classes.
+- **Smart Module Detection** — Automatically applies standard wildcard exports (`export *`) for TypeScript utilities and creates named exports for Vue SFC components.
+- **Style Integration** — Automatically checks for and integrates global CSS or SCSS stylesheets.
+- **Intelligent Filtering** — Excludes unit test files (`.test.`) and modules marked with the `// export:none` directive.
 
 ## Initialization
 
-Initialize and run the export generator using the `make` method.
+Initialize and execute the library export generator using the `make` method:
 
 ```typescript
 import { LibraryExport } from '@dxtmisha/scripts'
@@ -26,21 +26,37 @@ generator.make()
 
 ## Methods
 
-### Generation
+### Core Execution
 
-- `make(): void` — the main entry point that triggers the file discovery and generation process.
+#### `make`
+Triggers the main library compilation and entry point generation. It scans all configured subdirectories, collects the valid files, filters out test/none-export modules, and writes the unified import/export statements into the designated destination file.
 
-## Example of Generated Output
+**Parameters:**
+- No parameters required.
 
-The generated file aggregate imports and exports like this:
+**Returns:** `void` — Modifies the target `library.ts` file on the filesystem and logs progress to the console.
 
 ```typescript
-import './style.css'
-
-// Components
-import _DxtButton from './components/DxtButton/DxtButton.vue'
-export const DxtButton = _DxtButton
+import { LibraryExport } from '@dxtmisha/scripts'
 
-// Utilities
-export * from './functions/myFunction'
+new LibraryExport().make()
 ```
+
+### Helper Methods
+
+- `getPath(directory: string): string[]` — Returns the directory path components based on `UI_DIR_IN` and the specified directory name.
+- `isExport(path: string | string[]): boolean` — Evaluates if a file path is suitable for export by verifying it is not a test file and does not match `UI_FLAG_NOT_EXPORT`.
+- `getDirectory(): LibraryFiles` — Collects recursively all indexable files within the configured export folders and aggregates them.
+- `getName(name: string): string` — Converts the first character of the directory name to uppercase to standardize comments in the generated file.
+- `getFile(path: string | string[]): string` — Reads the file contents at the given path from the filesystem.
+- `initFile(): string` — Builds the raw content of the output library file, including imports, style setups, and wildcard/named exports.
+- `initStyles(): string` — Generates imports for global stylesheets (`style.scss` or `style.css`) if they are present in the root of the source directory.
+
+## Dependencies and Configurations
+
+The `LibraryExport` class interacts with several global configurations to perform structural generation:
+
+- `UI_DIRS_LIST_EXPORT` — Specifies the active folders that are scanned recursively for exports (`classes`, `components`, `composables`, `functions`, `global`, `types`).
+- `UI_DIRS_FILE_EXPORT` — Sets the destination output path of the compiled library file (`src/library.ts`).
+- `UI_DIR_IN` — Identifies the root source directory containing the modules (`src`).
+- `UI_FLAG_NOT_EXPORT` — Holds the regular expression matching the non-export directive (`/\/\/ *export:none/`).

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

@@ -4,18 +4,18 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 # Класс LibraryExport
 
-Класс `LibraryExport` отвечает за агрегацию и генерацию единого файла экспорта для библиотеки. Он сканирует назначенные директории на наличие файлов TypeScript и Vue, создавая единую точку входа, которая упрощает импорт библиотеки.
+Класс `LibraryExport` отвечает за агрегацию и генерацию единого файла экспорта для библиотеки. Он сканирует назначенные подпапки на наличие файлов TypeScript и Vue, автоматически компилируя все экспорты в единый публичный интерфейс для упрощения последующих импортов.
 
 ## Ключевые особенности
 
-- **Генерация единого экспорта** — создает комплексную точку входа для всех экспортируемых компонентов и утилит.
-- **Умная идентификация файлов** — автоматически обрабатывает экспорт для `.ts` файлов (используя `export *`) и `.vue` файлов (используя `import`, затем `export const`).
-- **Интеграция стилей** — автоматически включает глобальные стили CSS или SCSS, если они существуют.
-- **Фильтрация** — исключает файлы тестов (`.test.`) и файлы, помеченные флагом `UI_FLAG_NOT_EXPORT`.
+- **Генерация единого экспорта** — Создает комплексную публичную точку входа для всех компонентов, composables, функций и классов.
+- **Умное обнаружение модулей** — Автоматически применяет стандартные экспорты со звездочкой (`export *`) для TypeScript-утилит и создает именованные экспорты для Vue SFC компонентов.
+- **Интеграция стилей** — Автоматически проверяет наличие и интегрирует глобальные таблицы стилей CSS или SCSS.
+- **Интеллектуальная фильтрация** — Исключает файлы юнит-тестов (`.test.`) и модули, помеченные специальной директивой `// export:none`.
 
 ## Инициализация
 
-Инициализируйте и запустите генератор экспорта с помощью метода `make`.
+Инициализируйте и запустите генератор экспорта с помощью метода `make`:
 
 ```typescript
 import { LibraryExport } from '@dxtmisha/scripts'
@@ -26,21 +26,37 @@ generator.make()
 
 ## Методы
 
-### Генерация
+### Основное выполнение
 
-- `make(): void` — основная точка входа, которая запускает процесс поиска файлов и генерации.
+#### `make`
+Запускает компиляцию библиотеки и генерацию точки входа. Метод сканирует все настроенные поддиректории, собирает подходящие файлы, отфильтровывает тесты и файлы с признаком `export:none`, а затем записывает сгенерированные инструкции импорта и экспорта в целевой файл точки входа.
 
-## Пример сгенерированного вывода
+**Параметры:**
+- Параметры отсутствуют.
 
-Сгенерированный файл агрегирует импорты и экспорты следующим образом:
+**Возвращает:** `void` — Модифицирует целевой файл `library.ts` в файловой системе и выводит логи в консоль.
 
 ```typescript
-import './style.css'
-
-// Components
-import _DxtButton from './components/DxtButton/DxtButton.vue'
-export const DxtButton = _DxtButton
+import { LibraryExport } from '@dxtmisha/scripts'
 
-// Utilities
-export * from './functions/myFunction'
+new LibraryExport().make()
 ```
+
+### Вспомогательные методы
+
+- `getPath(directory: string): string[]` — Возвращает компоненты пути к директории на основе `UI_DIR_IN` и указанного имени директории.
+- `isExport(path: string | string[]): boolean` — Проверяет, подходит ли путь к файлу для экспорта, убеждаясь, что это не файл теста и он не совпадает с шаблоном `UI_FLAG_NOT_EXPORT`.
+- `getDirectory(): LibraryFiles` — Рекурсивно собирает все индексируемые файлы внутри настроенных папок экспорта и агрегирует их.
+- `getName(name: string): string` — Преобразует первый символ имени директории в верхний регистр для стандартизации комментариев в сгенерированном файле.
+- `getFile(path: string | string[]): string` — Считывает содержимое файла по указанному пути из файловой системы.
+- `initFile(): string` — Формирует необработанное содержимое выходного файла библиотеки, включая импорты, настройку стилей, а также wildcard и именованные экспорты.
+- `initStyles(): string` — Генерирует импорты для глобальных таблиц стилей (`style.scss` или `style.css`), если они присутствуют в корне исходной директории.
+
+## Зависимости и конфигурации
+
+Класс `LibraryExport` взаимодействует с несколькими глобальными конфигурациями для выполнения генерации:
+
+- `UI_DIRS_LIST_EXPORT` — Указывает активные папки, которые рекурсивно сканируются на наличие экспортов (`classes`, `components`, `composables`, `functions`, `global`, `types`).
+- `UI_DIRS_FILE_EXPORT` — Задает путь назначения скомпилированного файла библиотеки (`src/library.ts`).
+- `UI_DIR_IN` — Идентифицирует корневую директорию исходного кода, содержащую модули (`src`).
+- `UI_FLAG_NOT_EXPORT` — Содержит регулярное выражение, соответствующее директиве исключения экспорта (`/\/\/ *export:none/`).