@dxtmisha/wiki 0.25.1 → 0.39.2

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

@@ -0,0 +1,52 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Classes/LibraryAiWikiItem - AI Wiki Component Handler'/>
+
+# LibraryAiWikiItem Class
+
+The `LibraryAiWikiItem` class is a wrapper around component data, specifically designed to handle AI Wiki-related operations for a single component. It provides methods to check for the existence of AI Wiki files, generate component codes, and create import strings.
+
+## Key Features
+
+- **Status Checking**: Determines if a component has an associated AI Wiki implementation file.
+- **Import Generation**: Creates correct TypeScript import strings for the AI Wiki component.
+- **Path Management**: Handles the resolution of paths to the component's AI Wiki file.
+
+## Initialization
+
+Initialize `LibraryAiWikiItem` by providing a `LibraryData` object.
+
+**Parameters:**
+- `item: LibraryData` — An object containing component metadata (name, design, directory, etc.).
+
+```typescript
+import { LibraryAiWikiItem } from '@dxtmisha/scripts'
+
+const componentData = {
+  name: 'button',
+  design: 'dxt',
+  alias: 'dxt.button',
+  codeFull: 'DxtButton',
+  dir: 'DxtButton'
+}
+
+const aiItem = new LibraryAiWikiItem(componentData)
+
+// Check status
+if (aiItem.isAiWiki()) {
+  const importStr = aiItem.getImport()
+  // "import DxtButton from '../../components/DxtButton/DxtButtonAiWiki.vue'"
+}
+```
+
+## Methods
+
+### State
+
+- `isAiWiki(): boolean` — Checks if the corresponding `*AiWiki.vue` file exists in the component's directory.
+
+### Data Retrieval
+
+- `getCode(): string` — Returns the full code identifier of the component (e.g., `DxtButton`).
+- `getComponentFileNameAiWiki(): string` — Returns the expected filename for the AI Wiki implementation (e.g., `DxtButtonAiWiki.vue`).
+- `getImport(): string` — Generates a TypeScript import string for the AI Wiki component.

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

@@ -0,0 +1,52 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Classes/LibraryAiWikiItem - Обработчик компонента AI Wiki'/>
+
+# Класс LibraryAiWikiItem
+
+Класс `LibraryAiWikiItem` является оберткой над данными компонента, специально разработанной для обработки операций, связанных с AI Wiki, для отдельного компонента. Он предоставляет методы для проверки существования файлов AI Wiki, генерации кодов компонентов и создания строк импорта.
+
+## Ключевые особенности
+
+- **Проверка статуса**: Определяет, есть ли у компонента соответствующий файл реализации AI Wiki.
+- **Генерация импорта**: Создает корректные строки импорта TypeScript для компонента AI Wiki.
+- **Управление путями**: Обрабатывает разрешение путей к файлу AI Wiki компонента.
+
+## Инициализация
+
+Инициализируйте `LibraryAiWikiItem`, предоставив объект `LibraryData`.
+
+**Параметры:**
+- `item: LibraryData` — объект, содержащий метаданные компонента (имя, дизайн, директория и т. д.).
+
+```typescript
+import { LibraryAiWikiItem } from '@dxtmisha/scripts'
+
+const componentData = {
+  name: 'button',
+  design: 'dxt',
+  alias: 'dxt.button',
+  codeFull: 'DxtButton',
+  dir: 'DxtButton'
+}
+
+const aiItem = new LibraryAiWikiItem(componentData)
+
+// Проверка статуса
+if (aiItem.isAiWiki()) {
+  const importStr = aiItem.getImport()
+  // "import DxtButton from '../../components/DxtButton/DxtButtonAiWiki.vue'"
+}
+```
+
+## Методы
+
+### Состояние
+
+- `isAiWiki(): boolean` — проверяет, существует ли соответствующий файл `*AiWiki.vue` в директории компонента.
+
+### Получение данных
+
+- `getCode(): string` — возвращает полный идентификатор кода компонента (например, `DxtButton`).
+- `getComponentFileNameAiWiki(): string` — возвращает ожидаемое имя файла для реализации AI Wiki (например, `DxtButtonAiWiki.vue`).
+- `getImport(): string` — генерирует строку импорта TypeScript для компонента AI Wiki.

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

@@ -0,0 +1,52 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Classes/LibraryAiWikiItem - Trình xử lý thành phần AI Wiki'/>
+
+# Lớp LibraryAiWikiItem
+
+Lớp `LibraryAiWikiItem` là một lớp bao bọc các dữ liệu của thành phần, được thiết kế đặc biệt để xử lý các hoạt động liên quan đến AI Wiki cho một thành phần duy nhất. Nó cung cấp các phương thức để kiểm tra sự tồn tại của các tệp AI Wiki, tạo mã thành phần và tạo các chuỗi nhập (import).
+
+## Các tính năng chính
+
+- **Kiểm tra trạng thái**: Xác định xem một thành phần có tệp triển khai AI Wiki tương ứng hay không.
+- **Tạo lệnh nhập (import)**: Tạo các chuỗi nhập TypeScript chính xác cho thành phần AI Wiki.
+- **Quản lý đường dẫn**: Xử lý việc giải quyết các đường dẫn đến tệp AI Wiki của thành phần.
+
+## Khởi tạo
+
+Khởi tạo `LibraryAiWikiItem` bằng cách cung cấp một đối tượng `LibraryData`.
+
+**Tham số:**
+- `item: LibraryData` — một đối tượng chứa siêu dữ liệu của thành phần (tên, thiết kế, thư mục, v.v.).
+
+```typescript
+import { LibraryAiWikiItem } from '@dxtmisha/scripts'
+
+const componentData = {
+  name: 'button',
+  design: 'dxt',
+  alias: 'dxt.button',
+  codeFull: 'DxtButton',
+  dir: 'DxtButton'
+}
+
+const aiItem = new LibraryAiWikiItem(componentData)
+
+// Kiểm tra trạng thái
+if (aiItem.isAiWiki()) {
+  const importStr = aiItem.getImport()
+  // "import DxtButton from '../../components/DxtButton/DxtButtonAiWiki.vue'"
+}
+```
+
+## Các phương thức
+
+### Trạng thái
+
+- `isAiWiki(): boolean` — kiểm tra xem tệp `*AiWiki.vue` tương ứng có tồn tại trong thư mục của thành phần hay không.
+
+### Truy xuất dữ liệu
+
+- `getCode(): string` — trả về định danh mã đầy đủ của thành phần (ví dụ: `DxtButton`).
+- `getComponentFileNameAiWiki(): string` — trả về tên tệp dự kiến cho bản triển khai AI Wiki (ví dụ: `DxtButtonAiWiki.vue`).
+- `getImport(): string` — tạo chuỗi nhập TypeScript cho thành phần AI Wiki.

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

@@ -0,0 +1,46 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Classes/LibraryExport - Export Generator'/>
+
+# 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.
+
+## 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.
+
+## Initialization
+
+Initialize and run the export generator using the `make` method.
+
+```typescript
+import { LibraryExport } from '@dxtmisha/scripts'
+
+const generator = new LibraryExport()
+generator.make()
+```
+
+## Methods
+
+### Generation
+
+- `make(): void` — the main entry point that triggers the file discovery and generation process.
+
+## Example of Generated Output
+
+The generated file aggregate imports and exports like this:
+
+```typescript
+import './style.css'
+
+// Components
+import _DxtButton from './components/DxtButton/DxtButton.vue'
+export const DxtButton = _DxtButton
+
+// Utilities
+export * from './functions/myFunction'
+```

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

@@ -0,0 +1,46 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Classes/LibraryExport - Генератор экспорта'/>
+
+# Класс LibraryExport
+
+Класс `LibraryExport` отвечает за агрегацию и генерацию единого файла экспорта для библиотеки. Он сканирует назначенные директории на наличие файлов TypeScript и Vue, создавая единую точку входа, которая упрощает импорт библиотеки.
+
+## Ключевые особенности
+
+- **Генерация единого экспорта** — создает комплексную точку входа для всех экспортируемых компонентов и утилит.
+- **Умная идентификация файлов** — автоматически обрабатывает экспорт для `.ts` файлов (используя `export *`) и `.vue` файлов (используя `import`, затем `export const`).
+- **Интеграция стилей** — автоматически включает глобальные стили CSS или SCSS, если они существуют.
+- **Фильтрация** — исключает файлы тестов (`.test.`) и файлы, помеченные флагом `UI_FLAG_NOT_EXPORT`.
+
+## Инициализация
+
+Инициализируйте и запустите генератор экспорта с помощью метода `make`.
+
+```typescript
+import { LibraryExport } from '@dxtmisha/scripts'
+
+const generator = new LibraryExport()
+generator.make()
+```
+
+## Методы
+
+### Генерация
+
+- `make(): void` — основная точка входа, которая запускает процесс поиска файлов и генерации.
+
+## Пример сгенерированного вывода
+
+Сгенерированный файл агрегирует импорты и экспорты следующим образом:
+
+```typescript
+import './style.css'
+
+// Components
+import _DxtButton from './components/DxtButton/DxtButton.vue'
+export const DxtButton = _DxtButton
+
+// Utilities
+export * from './functions/myFunction'
+```

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

@@ -0,0 +1,46 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Classes/LibraryExport - Trình tạo xuất bản (Export)'/>
+
+# Lớp LibraryExport
+
+Lớp `LibraryExport` chịu trách nhiệm tổng hợp và tạo ra một tệp xuất bản (export) thống nhất cho thư viện. Nó quét các thư mục được chỉ định để tìm các tệp TypeScript và Vue, tạo ra một điểm nhập duy nhất giúp đơn giản hóa việc nhập thư viện.
+
+## Các tính năng chính
+
+- **Tạo xuất bản thống nhất** — tạo ra một điểm nhập toàn diện cho tất cả các thành phần và tiện ích có thể xuất bản.
+- **Nhận dạng tệp thông minh** — tự động xử lý xuất bản cho các tệp `.ts` (sử dụng `export *`) và các tệp `.vue` (sử dụng `import` sau đó là `export const`).
+- **Tích hợp phong cách (Style)** — tự động bao gồm các kiểu CSS hoặc SCSS toàn cục nếu chúng tồn tại.
+- **Bộ lọc** — loại trừ các tệp kiểm thử (`.test.`) và các tệp được đánh dấu bằng cờ `UI_FLAG_NOT_EXPORT`.
+
+## Khởi tạo
+
+Khởi tạo và chạy trình tạo xuất bản bằng phương thức `make`.
+
+```typescript
+import { LibraryExport } from '@dxtmisha/scripts'
+
+const generator = new LibraryExport()
+generator.make()
+```
+
+## Các phương thức
+
+### Tạo dữ liệu
+
+- `make(): void` — điểm nhập chính kích hoạt quá trình khám phá và tạo tệp.
+
+## Ví dụ về đầu ra được tạo
+
+Tệp được tạo tổng hợp các lệnh nhập và xuất bản như sau:
+
+```typescript
+import './style.css'
+
+// Components
+import _DxtButton from './components/DxtButton/DxtButton.vue'
+export const DxtButton = _DxtButton
+
+// Utilities
+export * from './functions/myFunction'
+```

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

@@ -0,0 +1,65 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Classes/LibraryFlags - Flags Connector Generator'/>
+
+# LibraryFlags Class
+
+The `LibraryFlags` class is responsible for generating files to connect country flags to the design system. It produces a TypeScript entry point for registering flags as icons and a JSON file containing a list of all available flag identifiers.
+
+## Key Features
+
+- **Flag Connection Generation** — Creates a TypeScript initialization file that registers flags as global icons.
+- **Identifier List Generation** — Produces a JSON file for metadata and automated flag selection.
+- **Naming Standardization** — Automatically formats flag identifiers to follow the `flag-[code]` convention.
+- **Automated Processing** — Scans and processes all available flags from the media library.
+
+## Initialization
+
+To initialize the object, call the `LibraryFlags(items)` constructor.
+
+**Parameters:**
+- `items: LibraryItems` — an object for working with the list of components and managing file writes.
+
+```typescript
+import { LibraryFlags, LibraryItems } from '@dxtmisha/scripts'
+
+// 1. Initialize LibraryItems
+const items = new LibraryItems()
+
+// 2. Initialize LibraryFlags
+const flagGenerator = new LibraryFlags(items)
+```
+
+## Methods
+
+### Control
+
+- `make(): void` — Triggers the generation of the flag connection files (TS and JSON).
+
+## Generated Files Structure
+
+The `make` method generates two main files to integrate flags into the library:
+
+### 1. Flag Connection (`flags.ts`)
+
+Registers flags as global icons using the `Icons` manager.
+
+**Example Structure:**
+```typescript
+import { Icons } from '@dxtmisha/functional'
+import flags from '@dxtmisha/media/flags'
+
+export const makeFlags = (): void => {
+  Icons.add('flag-us', flags.us)
+  Icons.add('flag-gb', flags.gb)
+}
+```
+
+### 2. Flag Identifiers (`flags.json`)
+
+A simple array of strings containing all generated flag keys.
+
+**Example Structure:**
+```json
+["flag-us", "flag-gb"]
+```

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

@@ -0,0 +1,65 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Classes/LibraryFlags - Генератор подключения флагов'/>
+
+# Класс LibraryFlags
+
+Класс `LibraryFlags` отвечает за формирование файлов подключения флагов стран к дизайн-системе. Он создает точку входа TypeScript для регистрации флагов в качестве иконок и JSON-файл, содержащий список всех доступных идентификаторов флагов.
+
+## Ключевые особенности
+
+- **Генерация подключения флагов** — создает файл инициализации TypeScript, который регистрирует флаги как глобальные иконки.
+- **Генерация списка идентификаторов** — формирует JSON-файл для метаданных и автоматизированного выбора флагов.
+- **Стандартизация именования** — автоматически форматирует идентификаторы флагов в соответствии с соглашением `flag-[code]`.
+- **Автоматическая обработка** — сканирует и обрабатывает все доступные флаги из медиа-библиотеки.
+
+## Инициализация
+
+Для инициализации объекта вызовите конструктор `LibraryFlags(items)`.
+
+**Параметры:**
+- `items: LibraryItems` — объект для работы со списком компонентов и управления записью файлов.
+
+```typescript
+import { LibraryFlags, LibraryItems } from '@dxtmisha/scripts'
+
+// 1. Инициализация LibraryItems
+const items = new LibraryItems()
+
+// 2. Инициализация LibraryFlags
+const flagGenerator = new LibraryFlags(items)
+```
+
+## Методы
+
+### Управление
+
+- `make(): void` — Запускает процесс генерации файлов подключения флагов (TS и JSON).
+
+## Структура сгенерированных файлов
+
+Метод `make` формирует два основных файла для интеграции флагов в библиотеку:
+
+### 1. Подключение флагов (`flags.ts`)
+
+Регистрирует флаги как глобальные иконки с помощью менеджера `Icons`.
+
+**Пример структуры:**
+```typescript
+import { Icons } from '@dxtmisha/functional'
+import flags from '@dxtmisha/media/flags'
+
+export const makeFlags = (): void => {
+  Icons.add('flag-ru', flags.ru)
+  Icons.add('flag-us', flags.us)
+}
+```
+
+### 2. Идентификаторы флагов (`flags.json`)
+
+Простой массив строк, содержащий все сгенерированные ключи флагов.
+
+**Пример структуры:**
+```json
+["flag-ru", "flag-us"]
+```

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

@@ -0,0 +1,65 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Classes/LibraryFlags - Trình tạo kết nối cờ (Flags)'/>
+
+# Lớp LibraryFlags
+
+Lớp `LibraryFlags` chịu trách nhiệm tạo các tệp để kết nối cờ quốc gia với hệ thống thiết kế. Nó tạo ra một điểm nhập TypeScript để đăng ký cờ dưới dạng biểu tượng và một tệp JSON chứa danh sách tất cả các mã định danh cờ có sẵn.
+
+## Các tính năng chính
+
+- **Tạo kết nối cờ** — Tạo tệp khởi tạo TypeScript đăng ký các cờ dưới dạng biểu tượng toàn cục.
+- **Tạo danh sách mã định danh** — Tạo tệp JSON cho siêu dữ liệu và lựa chọn cờ tự động.
+- **Tiêu chuẩn hóa đặt tên** — Tự động định dạng mã định danh cờ theo quy ước `flag-[code]`.
+- **Xử lý tự động** — Quét và xử lý tất cả các cờ có sẵn từ thư viện phương tiện.
+
+## Khởi tạo
+
+Để khởi tạo đối tượng, hãy gọi hàm khởi tạo `LibraryFlags(items)`.
+
+**Tham số:**
+- `items: LibraryItems` — một đối tượng để làm việc với danh sách các thành phần và quản lý việc ghi tệp.
+
+```typescript
+import { LibraryFlags, LibraryItems } from '@dxtmisha/scripts'
+
+// 1. Khởi tạo LibraryItems
+const items = new LibraryItems()
+
+// 2. Khởi tạo LibraryFlags
+const flagGenerator = new LibraryFlags(items)
+```
+
+## Các phương thức
+
+### Điều khiển
+
+- `make(): void` — Kích hoạt quá trình tạo các tệp kết nối cờ (TS và JSON).
+
+## Cấu trúc các tệp được tạo
+
+Phương thức `make` tạo ra hai tệp chính để tích hợp cờ vào thư viện:
+
+### 1. Kết nối cờ (`flags.ts`)
+
+Đăng ký cờ dưới dạng biểu tượng toàn cục bằng trình quản lý `Icons`.
+
+**Cấu trúc ví dụ:**
+```typescript
+import { Icons } from '@dxtmisha/functional'
+import flags from '@dxtmisha/media/flags'
+
+export const makeFlags = (): void => {
+  Icons.add('flag-vn', flags.vn)
+  Icons.add('flag-us', flags.us)
+}
+```
+
+### 2. Mã định danh cờ (`flags.json`)
+
+Một mảng chuỗi đơn giản chứa tất cả các khóa cờ được tạo.
+
+**Cấu trúc ví dụ:**
+```json
+["flag-vn", "flag-us"]
+```

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

@@ -0,0 +1,52 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Classes/LibraryItems - Component List Manager'/>
+
+# LibraryItems Class
+
+The `LibraryItems` class is responsible for managing the list of components within the design system. It provides utilities to retrieve component data, count components, determine component paths, and write data to the library directory.
+
+## Key Features
+
+- **Component Management** — Retrieves and organizes components by design groups.
+- **Path Resolution** — Determines the correct absolute paths for design system components.
+- **File Writing Utility** — Provides a standardized way to write TypeScript and JSON files to the library, including auto-generated headers.
+- **Design Configuration Integration** — Seamlessly integrates with `PropertiesConfig` and `PropertiesFile` for project-specific settings.
+
+## Initialization
+
+Initialize the `LibraryItems` class without arguments.
+
+```typescript
+import { LibraryItems } from '@dxtmisha/scripts'
+
+const items = new LibraryItems()
+```
+
+## Methods
+
+### Data Retrieval
+
+- `get(): LibraryAll` — returns the full list of components organized by design groups.
+- `getComponentList(): LibraryData[]` — returns a flat array of all components.
+- `getCount(): number` — returns the total number of components.
+- `getComponentsPath(): string[]` — returns the path elements for the components directory.
+
+## Operations
+
+### `write`
+
+Writes the provided data to a file within the library directory. Automatically adds a generation header for TypeScript files.
+
+**Parameters:**
+- `name: string` — the file name (without extension).
+- `data: string[]` — an array of strings to write. Each string will be separated by a newline character.
+- `extension: string = 'ts'` — the file extension. Defaults to `ts`. `json` is also supported.
+
+**Example:**
+```typescript
+items.write('my-feature', [
+  'export const active = true',
+  'export const count = 10'
+])
+```

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

@@ -0,0 +1,52 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Classes/LibraryItems - Менеджер списка компонентов'/>
+
+# Класс LibraryItems
+
+Класс `LibraryItems` отвечает за управление списком компонентов в дизайн-системе. Он предоставляет утилиты для получения данных о компонентах, подсчета их количества, определения путей и записи данных в директорию библиотеки.
+
+## Ключевые особенности
+
+- **Управление компонентами** — получает и организует компоненты по группам дизайна.
+- **Определение путей** — вычисляет правильные абсолютные пути для компонентов дизайн-системы.
+- **Утилита записи файлов** — предоставляет стандартизированный способ записи файлов TypeScript и JSON в библиотеку, включая автоматически сгенерированные заголовки.
+- **Интеграция с конфигурацией** — бесшовно работает с `PropertiesConfig` и `PropertiesFile` для получения специфичных для проекта настроек.
+
+## Инициализация
+
+Инициализируйте класс `LibraryItems` без аргументов.
+
+```typescript
+import { LibraryItems } from '@dxtmisha/scripts'
+
+const items = new LibraryItems()
+```
+
+## Методы
+
+### Получение данных
+
+- `get(): LibraryAll` — возвращает полный список компонентов, организованный по группам дизайна.
+- `getComponentList(): LibraryData[]` — возвращает плоский массив всех компонентов.
+- `getCount(): number` — возвращает общее количество компонентов.
+- `getComponentsPath(): string[]` — возвращает элементы пути к директории компонентов.
+
+## Операции
+
+### `write`
+
+Записывает переданные данные в файл внутри директории библиотеки. Автоматически добавляет заголовок о генерации файла для TypeScript файлов.
+
+**Параметры:**
+- `name: string` — название файла (без расширения).
+- `data: string[]` — массив строк для записи. Каждая строка будет разделена символом переноса строки.
+- `extension: string = 'ts'` — расширение файла. По умолчанию `ts`. Поддерживается также `json`.
+
+**Пример:**
+```typescript
+items.write('my-feature', [
+  'export const active = true',
+  'export const count = 10'
+])
+```

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

@@ -0,0 +1,52 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Classes/LibraryItems - Trình quản lý danh sách thành phần'/>
+
+# Lớp LibraryItems
+
+Lớp `LibraryItems` chịu trách nhiệm quản lý danh sách các thành phần (components) trong hệ thống thiết kế. Nó cung cấp các tiện ích để lấy dữ liệu thành phần, đếm số lượng thành phần, xác định đường dẫn và ghi dữ liệu vào thư mục thư viện.
+
+## Các tính năng chính
+
+- **Quản lý thành phần** — Lấy và sắp xếp các thành phần theo nhóm thiết kế.
+- **Xác định đường dẫn** — Xác định đường dẫn tuyệt đối chính xác cho các thành phần của hệ thống thiết kế.
+- **Tiện ích ghi tệp** — Cung cấp cách thức chuẩn hóa để ghi các tệp TypeScript và JSON vào thư viện, bao gồm cả tiêu đề được tạo tự động.
+- **Tích hợp cấu hình thiết kế** — Tích hợp liền mạch với `PropertiesConfig` và `PropertiesFile` cho các cài đặt cụ thể của dự án.
+
+## Khởi tạo
+
+Khởi tạo lớp `LibraryItems` mà không cần đối số.
+
+```typescript
+import { LibraryItems } from '@dxtmisha/scripts'
+
+const items = new LibraryItems()
+```
+
+## Các phương thức
+
+### Truy xuất dữ liệu
+
+- `get(): LibraryAll` — trả về danh sách đầy đủ các thành phần được sắp xếp theo nhóm thiết kế.
+- `getComponentList(): LibraryData[]` — trả về một mảng phẳng của tất cả các thành phần.
+- `getCount(): number` — trả về tổng số lượng thành phần.
+- `getComponentsPath(): string[]` — trả về các thành phần đường dẫn cho thư mục thành phần.
+
+## Các thao tác (Operations)
+
+### `write`
+
+Ghi dữ liệu được cung cấp vào một tệp trong thư mục thư viện. Tự động thêm tiêu đề cảnh báo tạo tự động cho các tệp TypeScript.
+
+**Tham số:**
+- `name: string` — tên tệp (không bao gồm phần mở rộng).
+- `data: string[]` — một mảng các chuỗi để ghi. Mỗi chuỗi sẽ được phân tách bởi một ký tự xuống dòng.
+- `extension: string = 'ts'` — phần mở rộng tệp. Mặc định là `ts`. `json` cũng được hỗ trợ.
+
+**Ví dụ:**
+```typescript
+items.write('my-feature', [
+  'export const active = true',
+  'export const count = 10'
+])
+```