@dxtmisha/wiki 0.57.3 → 0.57.6

package/src/media/functional/figma-code/classes/FigmaFrame/FigmaFrame.vi.mdx

@@ -1,61 +1,194 @@
-import {Meta} from '@storybook/addon-docs/blocks'
+import { Meta, Source } from '@storybook/addon-docs/blocks'
 
-<Meta title='@dxtmisha/vi/figma-code/Classes/FigmaFrame - Quản lý Frame'/>
+<Meta title='@dxtmisha/vi/figma-code/Classes/FigmaFrame - Phân tích cấu trúc Figma'/>
 
-# Lớp FigmaFrame
+# Lớp `FigmaFrame`
 
-Một tiện ích toàn diện để điều hướng và trích xuất dữ liệu từ các frame và section trong Figma. Lớp này hỗ trợ phân tích và nhóm các node theo cách đệ quy cho cả toàn bộ trang hoặc vùng chọn hiện tại.
+Một lớp tiện ích để phân tích và tương tác với cấu trúc của các trang hoặc các vùng lựa chọn trong Figma. Nó quét đệ quy cây node, lọc các phần tử theo loại và cung cấp các phương thức hỗ trợ để trích xuất văn bản và tạo ảnh chụp màn hình.
 
 ## Các tính năng chính
 
-- **Xử lý theo ngữ cảnh** — Tự động xử lý sự khác biệt logic giữa phân tích toàn bộ trang và phân tích theo vùng chọn.
-- **Lọc Node** — Các phương thức chuyên biệt để lấy riêng các frame, section hoặc text node từ hệ thống phân cấp.
-- **Tổng hợp văn bản** — Nhóm các node văn bản theo nội dung để dễ dàng dịch và phân tích.
-- **Xuất hàng loạt** — Tự động hóa việc chụp ảnh màn hình (screenshot) cho tất cả các phần tử chính trong ngữ cảnh hiện tại.
+- **Quét đệ quy** — Tự động lập chỉ mục cho tất cả các phần tử lồng nhau bên trong ngữ cảnh được cung cấp (trang hoặc vùng lựa chọn).
+- **Hỗ trợ lựa chọn** — Có thể được khởi tạo để nhắm mục tiêu vào toàn bộ trang tài liệu hoặc chỉ vùng lựa chọn hiện tại của người dùng.
+- **Tổng hợp văn bản** — Phương thức `getTexts()` nhóm các chuỗi văn bản giống hệt nhau lại với nhau, cung cấp danh sách các giá trị duy nhất và các ID node liên kết với chúng.
+- **Xuất dữ liệu tự động** — Đơn giản hóa quá trình tạo ảnh chụp màn hình cho các phần tử chính bên trong frame.
 
 ## Khởi tạo
 
-Để khởi tạo đối tượng, hãy gọi hàm dựng `FigmaFrame(page, selection)`.
-
-**Tham số:**
-- `page: UiFigmaNode` — Node gốc (thường là `figma.currentPage` hoặc một `PageNode`) để phân tích.
-- `selection: boolean = false` — Nếu `true`, thực thể sẽ chỉ xử lý các node trong vùng chọn hiện tại thay vì toàn bộ trang.
+Tạo một thực thể mới bằng cách cung cấp một node bắt đầu (thường là một trang) và chỉ định xem nó có nên tập trung vào vùng lựa chọn hay không.
 
 ```typescript
 import { FigmaFrame } from '@dxtmisha/figma-code'
 
-// 1. Khởi tạo cho toàn bộ trang
-const pageManager = new FigmaFrame(figma.currentPage)
+// Phân tích toàn bộ trang hiện tại
+const frameAnalyzer = new FigmaFrame(figma.currentPage)
+
+// Chỉ phân tích các mục được chọn
+const selectionAnalyzer = new FigmaFrame(figma.currentPage, true)
+```
+
+## Các phương thức
+
+### Trạng thái và Điều hướng
+
+- `isSelection(): boolean` — Kiểm tra xem trình phân tích có được khởi tạo để làm việc với vùng chọn hiện tại của người dùng hay không.
+- `getMainFrames(): FigmaItem[]` — Trích xuất các frame hoặc section chính từ gốc của ngữ cảnh hiện tại.
+
+### Lọc và Lựa chọn
+
+- `getItemsFrame(): FigmaItem<FrameNode>[]` — Trả về danh sách tất cả các node lồng nhau là frame.
+- `getItemsSection(): FigmaItem<SectionNode>[]` — Trả về danh sách tất cả các node lồng nhau là section.
+- `getItemsText(): FigmaItem<TextNode>[]` — Trả về danh sách tất cả các node văn bản lồng nhau.
+
+### Nội dung và Thông tin
+
+#### `getItemsInfo`
+
+Thu thập thông tin chi tiết (tên, ID, ảnh chụp màn hình) một cách không đồng bộ cho tất cả các mục trong frame.
+
+**Trả về:** `Promise<UiFigmaFramesList>` — Một promise chứa danh sách thông tin các mục.
+
+```typescript
+const infoList: UiFigmaFramesList = await frame.getItemsInfo()
+/*
+[
+  { id: '1:10', name: 'Button', image: Uint8Array[...] },
+  { id: '1:25', name: 'Card', image: 'data:image/png;base64...' }
+]
+*/
+```
+
+#### `getMainItemsInfo`
+
+Thu thập thông tin chi tiết một cách không đồng bộ chỉ cho các mục chính (cấp cao nhất).
+
+**Trả về:** `Promise<UiFigmaFramesList>` — Một promise chứa danh sách thông tin các mục chính.
+
+```typescript
+const mainInfoList: UiFigmaFramesList = await frame.getMainItemsInfo()
+/*
+[
+  { id: '1:10', name: 'Login Screen', image: Uint8Array[...] }
+]
+*/
+```
+
+#### `getTexts`
 
-// 2. Khởi tạo cụ thể cho vùng chọn đang hoạt động
-const selectionManager = new FigmaFrame(figma.currentPage, true)
+Nhóm các node văn bản theo nội dung của chúng, trả về các chuỗi duy nhất và danh sách các ID node tương ứng.
+
+**Trả về:** `UiFigmaItemText[]` — Một mảng các mục văn bản đã được nhóm.
+
+```typescript
+const groupedTexts: UiFigmaItemText[] = frame.getTexts()
+/*
+[
+  { id: ['1:10', '1:15'], text: 'Submit' },
+  { id: ['1:20'], text: 'Cancel' }
+]
+*/
+```
+
+### Phân tích Style
+
+#### `getItemsCss`
+
+Tạo một bản đồ các style CSS cho tất cả các mục trong frame.
+
+**Trả về:** `Promise<UiFigmaFrameStylesCssList>` — Một promise chứa bản đồ style được lập chỉ mục theo ID node.
+
+```typescript
+const cssStyles: UiFigmaFrameStylesCssList = await frame.getItemsCss()
+/*
+{
+  '1:10': { 'color': '#ff0000', 'font-size': '14px' },
+  '1:12': { 'background': '#ffffff', 'padding': '10px' }
+}
+*/
+```
+
+#### `getItemsStyles`
+
+Trích xuất dữ liệu style đầy đủ (cấu trúc JSON của tài liệu, văn bản, CSS) cho tất cả các mục.
+
+**Trả về:** `Promise<UiFigmaFrameStylesList>` — Một promise chứa danh sách dữ liệu style mở rộng.
+
+```typescript
+const stylesList: UiFigmaFrameStylesList = await frame.getItemsStyles()
+/*
+[
+  { 
+    id: '1:10', 
+    name: 'Label', 
+    text: 'Username', 
+    styles: { 'color': '#333' },
+    json: { document: {...}, styles: {...} }
+  }
+]
+*/
+```
+
+#### `getMainItemsStyles`
+
+Trích xuất dữ liệu style đầy đủ chỉ cho các mục chính, bao gồm cả style của các phần tử con của chúng.
+
+**Trả về:** `Promise<UiFigmaFrameStylesList>` — Một promise chứa danh sách dữ liệu style mở rộng cho các mục chính.
+
+```typescript
+const mainStylesList: UiFigmaFrameStylesList = await frame.getMainItemsStyles()
+/*
+[
+  { 
+    id: '1:10', 
+    name: 'Login Form', 
+    childrenStyles: {
+       '1:11': { 'color': '#000' },
+       '1:12': { 'margin-top': '20px' }
+    }
+  }
+]
+*/
 ```
 
-## Ngữ cảnh & Phân tích
+### Hành động và Xuất dữ liệu
 
-- `isSelection(): boolean` — Kiểm tra xem có đang làm việc với vùng chọn hay không. Ví dụ: `frameManager.isSelection()`
-- `getMainFrames(): FigmaItem[]` — Trả về các frame/section chính từ node gốc. Ví dụ: `const roots = frameManager.getMainFrames()`
+- `screenshot(): Promise<Uint8Array[]>` — Tạo ảnh chụp màn hình dưới định dạng JPG cho tất cả các mục chính.
 
-## Lọc hệ thống phân cấp
+## Các kiểu dữ liệu
 
-- `getItemsFrame(): FigmaItem<FrameNode>[]` — Lọc các node FRAME từ hệ thống phân cấp. Ví dụ: `const frames = frameManager.getItemsFrame()`
-- `getItemsSection(): FigmaItem<SectionNode>[]` — Lọc các node SECTION từ hệ thống phân cấp. Ví dụ: `const sections = frameManager.getItemsSection()`
-- `getItemsText(): FigmaItem<TextNode>[]` — Lọc các node TEXT từ hệ thống phân cấp. Ví dụ: `const textNodes = frameManager.getItemsText()`
+#### `UiFigmaNode`
+Kiểu cơ sở cho các node Figma. Nó đại diện cho một sự kết hợp của các node (`SceneNode | DocumentNode | PageNode | FrameNode`, v.v.) hỗ trợ lồng nhau và các thuộc tính tiêu chuẩn của Figma API.
 
-## Dữ liệu & Chụp ảnh (Capture)
+#### `UiFigmaItemText`
+Kết quả của việc nhóm các lớp văn bản theo nội dung của chúng.
+- `id: string[]` — Một mảng các định danh node duy nhất có cùng văn bản.
+- `text: string` — Chuỗi văn bản thực tế.
 
-- `getTexts(): UiFigmaItemText[]` — Tổng hợp các node văn bản được nhóm theo nội dung. Ví dụ: `const groups = frameManager.getTexts()`
-- `screenshot(): Promise<Uint8Array[]>` — Chụp ảnh JPG cho các phần tử chính. Ví dụ: `const images = await frameManager.screenshot()`
+#### `UiFigmaMessageTexts`
+Cấu trúc dữ liệu để truyền kết quả phân tích văn bản.
+- `frame: FigmaFrame` — Một thực thể của lớp trình phân tích.
+- `texts: UiFigmaItemText[]` — Danh sách các mục văn bản được tìm thấy và nhóm lại.
+- `screenshot: Uint8Array[]` — Một mảng các ảnh chụp màn hình cho các phần tử chính.
 
-## Các loại dữ liệu (Types)
+#### `UiFigmaFramesItem`
+Thông tin đơn giản hóa về một phần tử để hiển thị trong giao diện.
+- `name: string` — Tên của phần tử trong Figma.
+- `id: string` — Định danh duy nhất của node.
+- `image?: Uint8Array | string` — Ảnh chụp màn hình của phần tử (dữ liệu nhị phân hoặc base64).
 
-### `UiFigmaNode`
+#### `UiFigmaFrameStylesItem`
+Thông tin mở rộng về một phần tử, bao gồm style của nó. Kế thừa tất cả các trường từ `UiFigmaFramesItem`.
+- `json?: UiFigmaFrameStylesData` — Cấu trúc dữ liệu node và style dưới định dạng JSON.
+- `text?: string` — Nội dung văn bản (nếu node là một node văn bản).
+- `styles?: Record<string, string>` — Một đối tượng chứa các thuộc tính CSS của chính phần tử đó.
+- `childrenStyles?: Record<string, Record<string, string>>` — Bản đồ các style CSS cho tất cả các phần tử con, được lập chỉ mục theo ID của chúng.
 
-Một kiểu union đại diện cho bất kỳ node Figma nào có liên quan, có thể chứa các node con hoặc được xử lý bởi trình quản lý.
-- Bao gồm: `DocumentNode`, `PageNode`, `FrameNode`, `SectionNode`, `TextNode`, và các biến thể `SceneNode` khác.
+#### `UiFigmaFrameStylesData`
+- `document: UiFigmaFrameStylesJson` — Cây node dưới định dạng nén.
+- `styles: Record<string, any>` — Một từ điển các định nghĩa style của tài liệu.
 
-### `UiFigmaItemText`
+#### `UiFigmaFrameStylesList`
+Một mảng các đối tượng `UiFigmaFrameStylesItem`.
 
-Cấu trúc đối tượng được sử dụng để nhóm nội dung văn bản trong tài liệu.
-- `id: string[]` — Danh sách các ID node Figma duy nhất mà tại đó nội dung văn bản này được tìm thấy.
-- `text: string` — Nội dung văn bản thực tế đã được cắt bỏ khoảng trắng thừa.
+#### `UiFigmaFrameStylesCssList`
+Một đối tượng (`Record<string, Record<string, string>>`) trong đó khóa là ID node và giá trị là tập hợp các style CSS của nó.

package/src/media/functional/figma-code/classes/FigmaFramesSelected/FigmaFramesSelected.en.mdx

@@ -1,88 +1,42 @@
-import {Meta} from '@storybook/addon-docs/blocks'
+import { Meta, Source } from '@storybook/addon-docs/blocks'
 
-<Meta title='@dxtmisha/en/figma-code/Classes/FigmaFramesSelected - Selected Frames Management'/>
+<Meta title='@dxtmisha/en/figma-code/Classes/FigmaFramesSelected - Managing selected frames'/>
 
-# FigmaFramesSelected Class
+# Class `FigmaFramesSelected`
 
-A static utility class for managing, caching, and synchronizing the list of selected frames within the Figma plugin environment. It handles persistent storage and bidirectional communication between the plugin and the UI regarding the selection state.
+A static utility class for managing a list of frame identifiers selected by the user within the plugin context. It handles data persistence using Figma's storage and ensures synchronization between the plugin logic and the user interface.
 
 ## Key Features
 
-- **Persistent Storage** — Uses `FigmaStorage` to keep the list of selected frame IDs across plugin reloads.
-- **Automated Caching** — Efficiently manages a singleton-like cache of selected IDs for fast access.
-- **Messenger Integration** — Simplifies bidirectional communication for updating and retrieving the selection state.
+- **Data Persistence** — The list of selected IDs is saved via `FigmaStorage`, allowing the selection to persist across plugin sessions.
+- **Bi-directional Sync** — The `send()` method initializes listeners for UI messages, enabling seamless updates to the selection list.
+- **Efficient Caching** — Uses an internal cache to provide instant access to the selection list without frequent storage reads.
 
-## Static Methods
+## Initialization
 
-### `has`
-
-Checks if a frame with the given ID is currently selected.
-
-**Parameters:**
-- `id: string` — The unique Figma node ID of the frame.
-
-**Returns:** `boolean` — `true` if the frame is selected, `false` otherwise.
-
-```typescript
-const has = FigmaFramesSelected.has('123:456')
-```
-
-### `get`
-
-Retrieves the current list of selected frame IDs, using the cache if available.
-
-**Returns:** `string[]` — An array of selected frame IDs.
-
-```typescript
-const selectedIds = FigmaFramesSelected.get()
-```
-
-### `toggle`
-
-Toggles the selection state of a frame.
-
-**Parameters:**
-- `id: string` — The unique Figma node ID of the frame.
-- `selected: boolean` — Whether to select (`true`) or deselect (`false`) the frame.
-
-**Returns:** `void`
+Since this is a static class, no instantiation is required. Typically, you only need to call the communication setup in your main plugin file.
 
 ```typescript
-FigmaFramesSelected.toggle('123:456', true)
-```
-
-### `add`
-
-Adds a frame ID to the selection list and updates the storage.
+import { FigmaFramesSelected } from '@dxtmisha/figma-code'
 
-**Parameters:**
-- `id: string` — The unique Figma node ID of the frame to add.
-
-**Returns:** `void`
-
-```typescript
-FigmaFramesSelected.add('123:456')
+// Setup listeners for UI messages
+FigmaFramesSelected.send()
 ```
 
-### `remove`
+## Methods
 
-Removes a frame ID from the selection list and updates the storage.
+### Selection Management
 
-**Parameters:**
-- `id: string` — The unique Figma node ID of the frame to remove.
+Methods for interacting with the current list of selected frame IDs.
 
-**Returns:** `void`
+- `has(id: string): boolean` — Checks if a specific frame ID is in the selection list.
+- `get(): string[]` — Retrieves the current list of selected frame IDs (uses cache).
+- `add(id: string): void` — Adds a frame ID to the list and persists the change.
+- `remove(id: string): void` — Removes a frame ID from the list and persists the change.
+- `toggle(id: string, selected: boolean): void` — Adds or removes an ID based on the `selected` flag.
 
-```typescript
-FigmaFramesSelected.remove('123:456')
-```
-
-### `send`
-
-Sets up listeners via the plugin messenger to handle requests for the selection list and updates from the UI.
+### Communication
 
-**Returns:** `void`
+Methods for synchronizing state with the UI.
 
-```typescript
-FigmaFramesSelected.send()
-```
+- `send(): void` — Sets up `FigmaPluginMessenger` listeners to handle selection updates from the UI.

package/src/media/functional/figma-code/classes/FigmaFramesSelected/FigmaFramesSelected.ru.mdx

@@ -1,88 +1,42 @@
-import {Meta} from '@storybook/addon-docs/blocks'
+import { Meta, Source } from '@storybook/addon-docs/blocks'
 
 <Meta title='@dxtmisha/ru/figma-code/Classes/FigmaFramesSelected - Управление выбранными фреймами'/>
 
-# Класс FigmaFramesSelected
+# Класс `FigmaFramesSelected`
 
-Статический утилитарный класс для управления, кэширования и синхронизации списка выбранных фреймов в среде плагина Figma. Он отвечает за долговременное хранение и двустороннюю связь между плагином и UI плагина относительно состояния выбора фреймов.
+Статический утилитарный класс для управления списком идентификаторов фреймов, выбранных пользователем в контексте плагина. Он обеспечивает сохранение данных с использованием хранилища Figma и синхронизацию состояния между логикой плагина и пользовательским интерфейсом.
 
 ## Ключевые особенности
 
-- **Постоянное хранение** — Использует `FigmaStorage` для сохранения списка идентификаторов выбранных фреймов между перезагрузками плагина.
-- **Автоматическое кэширование** — Эффективно управляет кэшем выбранных идентификаторов по принципу синглтона для быстрого доступа.
-- **Интеграция с мессенджером** — Упрощает двустороннюю связь для получения и обновления состояния выбора.
+- **Постоянство данных** — Список выбранных ID сохраняется через `FigmaStorage`, что позволяет сохранять выборку между сессиями работы плагина.
+- **Двусторонняя синхронизация** — Метод `send()` инициализирует слушателей сообщений из UI, обеспечивая бесшовное обновление списка выбора.
+- **Эффективное кэширование** — Использует внутренний кэш для мгновенного доступа к списку без частого обращения к хранилищу.
 
-## Статические методы
+## Инициализация
 
-### `has`
-
-Проверяет, выбран ли в данный момент фрейм с указанным идентификатором.
-
-**Параметры:**
-- `id: string` — Уникальный идентификатор узла Figma (ID фрейма).
-
-**Возвращает:** `boolean` — `true`, если фрейм выбран, `false` в противном случае.
-
-```typescript
-const has = FigmaFramesSelected.has('123:456')
-```
-
-### `get`
-
-Получает текущий список идентификаторов выбранных фреймов, используя кэш при его наличии.
-
-**Возвращает:** `string[]` — Массив идентификаторов выбранных фреймов.
-
-```typescript
-const selectedIds = FigmaFramesSelected.get()
-```
-
-### `toggle`
-
-Переключает состояние выбора фрейма.
-
-**Параметры:**
-- `id: string` — Уникальный идентификатор узла Figma (ID фрейма).
-- `selected: boolean` — Выбрать (`true`) или отменить выбор (`false`) фрейма.
-
-**Возвращает:** `void`
+Поскольку это статический класс, создание экземпляра не требуется. Как правило, достаточно вызвать настройку связи в основном файле плагина.
 
 ```typescript
-FigmaFramesSelected.toggle('123:456', true)
-```
-
-### `add`
-
-Добавляет идентификатор фрейма в список выбора и обновляет хранилище.
+import { FigmaFramesSelected } from '@dxtmisha/figma-code'
 
-**Параметры:**
-- `id: string` — Уникальный идентификатор узла Figma (ID фрейма) для добавления.
-
-**Возвращает:** `void`
-
-```typescript
-FigmaFramesSelected.add('123:456')
+// Настройка слушателей для сообщений из UI
+FigmaFramesSelected.send()
 ```
 
-### `remove`
+## Методы
 
-Удаляет идентификатор фрейма из списка выбора и обновляет хранилище.
+### Управление выборкой
 
-**Параметры:**
-- `id: string` — Уникальный идентификатор узла Figma (ID фрейма) для удаления.
+Методы для взаимодействия с текущим списком идентификаторов выбранных фреймов.
 
-**Возвращает:** `void`
+- `has(id: string): boolean` — Проверяет, находится ли конкретный ID фрейма в списке выбора.
+- `get(): string[]` — Получает текущий список выбранных ID (использует кэш).
+- `add(id: string): void` — Добавляет ID фрейма в список и сохраняет изменения.
+- `remove(id: string): void` — Удаляет ID фрейма из списка и сохраняет изменения.
+- `toggle(id: string, selected: boolean): void` — Добавляет или удаляет ID в зависимости от флага `selected`.
 
-```typescript
-FigmaFramesSelected.remove('123:456')
-```
-
-### `send`
-
-Настраивает прослушиватели событий через мессенджер плагина для обработки запросов списка выбора и обновлений из UI.
+### Связь
 
-**Возвращает:** `void`
+Методы для синхронизации состояния с интерфейсом.
 
-```typescript
-FigmaFramesSelected.send()
-```
+- `send(): void` — Настраивает слушателей `FigmaPluginMessenger` для обработки обновлений выборки из UI.

package/src/media/functional/figma-code/classes/FigmaFramesSelected/FigmaFramesSelected.vi.mdx

@@ -1,88 +1,42 @@
-import {Meta} from '@storybook/addon-docs/blocks'
+import { Meta, Source } from '@storybook/addon-docs/blocks'
 
-<Meta title='@dxtmisha/vi/figma-code/Classes/FigmaFramesSelected - Quản lý các frame đang chọn'/>
+<Meta title='@dxtmisha/vi/figma-code/Classes/FigmaFramesSelected - Quản lý các frame được chọn'/>
 
-# Lớp FigmaFramesSelected
+# Lớp `FigmaFramesSelected`
 
-Một lớp tiện ích tĩnh dùng để quản lý, lưu trữ bộ nhớ đệm (cache) và đồng bộ hóa danh sách các frame đang được chọn trong môi trường plugin Figma. Nó chịu trách nhiệm lưu trữ lâu dài và giao tiếp hai chiều giữa plugin và giao diện người dùng (UI) về trạng thái lựa chọn.
+Một lớp tiện ích tĩnh để quản lý danh sách các định danh frame được người dùng chọn trong ngữ cảnh của plugin. Nó xử lý việc lưu trữ dữ liệu bền vững bằng cách sử dụng bộ nhớ của Figma và đảm bảo đồng bộ hóa giữa logic của plugin và giao diện người dùng.
 
 ## Các tính năng chính
 
-- **Lưu trữ lâu dài** — Sử dụng `FigmaStorage` để giữ danh sách các ID frame đang chọn ngay cả khi tải lại plugin.
-- **Tự động lưu bộ nhớ đệm** — Quản lý hiệu quả bộ nhớ đệm của các ID đang chọn để truy cập nhanh chóng.
-- **Tích hợp Messenger** — Đơn giản hóa việc giao tiếp hai chiều để cập nhật và lấy trạng thái lựa chọn.
+- **Lưu trữ dữ liệu bền vững** — Danh sách các ID được chọn được lưu qua `FigmaStorage`, cho phép lựa chọn tồn tại qua các phiên làm việc của plugin.
+- **Đồng bộ hóa hai chiều** — Phương thức `send()` khởi tạo các trình lắng nghe tin nhắn từ UI, cho phép cập nhật danh sách lựa chọn một cách liền mạch.
+- **Caching hiệu quả** — Sử dụng bộ nhớ đệm nội bộ để cung cấp quyền truy cập tức thì vào danh sách lựa chọn mà không cần đọc bộ nhớ thường xuyên.
 
-## Các phương thức tĩnh (Static Methods)
+## Khởi tạo
 
-### `has`
-
-Kiểm tra xem một frame với ID cụ thể có đang được chọn hay không.
-
-**Tham số:**
-- `id: string` — Mã định danh (ID) duy nhất của node Figma.
-
-**Trả về:** `boolean` — `true` nếu frame đang được chọn, `false` nếu ngược lại.
-
-```typescript
-const has = FigmaFramesSelected.has('123:456')
-```
-
-### `get`
-
-Lấy danh sách các ID frame đang được chọn hiện tại, sử dụng bộ nhớ đệm nếu có sẵn.
-
-**Trả về:** `string[]` — Một mảng chứa danh sách các ID các frame đang chọn.
-
-```typescript
-const selectedIds = FigmaFramesSelected.get()
-```
-
-### `toggle`
-
-Thay đổi trạng thái lựa chọn của một frame.
-
-**Tham số:**
-- `id: string` — Mã định danh (ID) duy nhất của node Figma.
-- `selected: boolean` — Chọn (`true`) hoặc bỏ chọn (`false`) frame.
-
-**Trả về:** `void`
+Vì đây là một lớp tĩnh, không cần khởi tạo thực thể. Thông thường, bạn chỉ cần gọi thiết lập giao tiếp trong tệp plugin chính của mình.
 
 ```typescript
-FigmaFramesSelected.toggle('123:456', true)
-```
-
-### `add`
-
-Thêm một ID frame vào danh sách lựa chọn và cập nhật bộ nhớ lưu trữ.
+import { FigmaFramesSelected } from '@dxtmisha/figma-code'
 
-**Tham số:**
-- `id: string` — Mã định danh (ID) duy nhất của frame Figma cần thêm.
-
-**Trả về:** `void`
-
-```typescript
-FigmaFramesSelected.add('123:456')
+// Thiết lập các trình lắng nghe tin nhắn từ UI
+FigmaFramesSelected.send()
 ```
 
-### `remove`
+## Các phương thức
 
-Xóa một ID frame khỏi danh sách lựa chọn và cập nhật bộ nhớ lưu trữ.
+### Quản lý lựa chọn (Selection Management)
 
-**Tham số:**
-- `id: string` — Mã định danh (ID) duy nhất của frame Figma cần xóa.
+Các phương thức để tương tác với danh sách ID frame được chọn hiện tại.
 
-**Trả về:** `void`
+- `has(id: string): boolean` — Kiểm tra xem một ID frame cụ thể có nằm trong danh sách lựa chọn hay không.
+- `get(): string[]` — Truy xuất danh sách ID frame được chọn hiện tại (sử dụng cache).
+- `add(id: string): void` — Thêm một ID frame vào danh sách và lưu thay đổi.
+- `remove(id: string): void` — Xóa một ID frame khỏi danh sách và lưu thay đổi.
+- `toggle(id: string, selected: boolean): void` — Thêm hoặc xóa một ID dựa trên cờ `selected`.
 
-```typescript
-FigmaFramesSelected.remove('123:456')
-```
-
-### `send`
-
-Thiết lập các listener qua messenger của plugin để xử lý các yêu cầu về danh sách lựa chọn và các cập nhật từ giao diện người dùng (UI).
+### Giao tiếp (Communication)
 
-**Trả về:** `void`
+Các phương thức để đồng bộ hóa trạng thái với UI.
 
-```typescript
-FigmaFramesSelected.send()
-```
+- `send(): void` — Thiết lập các trình lắng nghe `FigmaPluginMessenger` để xử lý các bản cập nhật lựa chọn từ UI.