@dxtmisha/wiki 0.39.1 → 0.39.2

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

@@ -0,0 +1,88 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/figma-code/Classes/FigmaFramesSelected - Quản lý các frame đang chọn'/>
+
+# 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.
+
+## 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.
+
+## Các phương thức tĩnh (Static Methods)
+
+### `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`
+
+```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ữ.
+
+**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')
+```
+
+### `remove`
+
+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ữ.
+
+**Tham số:**
+- `id: string` — Mã định danh (ID) duy nhất của frame Figma cần xóa.
+
+**Trả về:** `void`
+
+```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).
+
+**Trả về:** `void`
+
+```typescript
+FigmaFramesSelected.send()
+```

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

@@ -0,0 +1,73 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/figma-code/Classes/FigmaItem - Node Wrapper'/>
+
+# FigmaItem Class
+
+A wrapper class for Figma nodes (`UiFigmaNode`) that provides a simplified, typed interface for common operations such as type checking, tree navigation, and asynchronous export.
+
+## Key Features
+
+- **Typed Access** — Provides type guard methods for `DOCUMENT`, `FRAME`, `SECTION`, and `TEXT` nodes.
+- **Simplified Navigation** — Easily access parent or child nodes wrapped in `FigmaItem` instances.
+- **Export Hook** — High-level methods for exporting nodes to JPG or JSON formats.
+- **Content Analysis** — Specialized logic for extracting and validating text content.
+
+## Initialization
+
+To initialize the object, call the `FigmaItem(item)` constructor.
+
+### Generic Constraints
+
+The class supports a generic parameter for strict typing:
+- `T extends UiFigmaNode` — The specific type of the wrapped Figma node.
+
+**Parameters:**
+- `item: T` — The native Figma node (e.g., `SceneNode`, `FrameNode`, `TextNode`) to be wrapped.
+
+```typescript
+import { FigmaItem } from '@dxtmisha/figma-code'
+
+// 1. Wrapping a selected node
+const item = new FigmaItem(figma.currentPage.selection[0])
+
+// 2. Using generics for specific node types
+const frameItem = new FigmaItem<FrameNode>(someFrameNode)
+```
+
+## Identification
+
+- `isDocument(): boolean` — Checks if the wrapped node is a `DOCUMENT`. Example: `item.isDocument()`
+- `isFrame(): boolean` — Checks if the wrapped node is a `FRAME`. Example: `item.isFrame()`
+- `isSection(): boolean` — Checks if the wrapped node is a `SECTION`. Example: `item.isSection()`
+- `isText(): boolean` — Checks if the wrapped node is a `TEXT` node. Example: `item.isText()`
+- `isTextNoValue(): boolean` — Filters for text nodes with meaningful content. Example: `item.isTextNoValue()`
+- `getType(): string | undefined` — Returns the string type constant of the node. Example: `const type = item.getType()`
+- `getId(): string` — Returns the unique ID of the node. Example: `const id = item.getId()`
+- `getName(): string` — Returns the display name of the node. Example: `const name = item.getName()`
+
+## Navigation
+
+- `getParent(): UiFigmaNode | undefined` — Returns the raw parent node. Example: `const parent = item.getParent()`
+- `getParentItem(): FigmaItem | undefined` — Returns the wrapped parent. Example: `const parentItem = item.getParentItem()`
+- `getChildren(): UiFigmaNode[]` — Returns an array of raw child nodes. Example: `const children = item.getChildren()`
+- `getChildrenItems(): FigmaItem[]` — Returns an array of wrapped child nodes. Example: `const items = item.getChildrenItems()`
+
+## Data & Export
+
+- `get(): T` — Returns the raw underlying Figma node. Example: `const raw = item.get()`
+- `exportJpg(): Promise<Uint8Array | string>` — Asynchronously exports the node in JPG format. Example: `const bytes = await item.exportJpg()`
+- `exportJson(): Promise<Uint8Array | string>` — Asynchronously exports the node in JSON format. Example: `const json = await item.exportJson()`
+- `getText(): string` — Retrieves the trimmed text content from the node. Example: `const content = item.getText()`
+
+## Types
+
+### `UiFigmaNode`
+
+A union type representing any relevant Figma node that can be wrapped by `FigmaItem`.
+- Includes: `DocumentNode`, `PageNode`, `FrameNode`, `SectionNode`, `TextNode`, and other `SceneNode` variants.
+
+### `UiFigmaExportFormat`
+
+Supported formats for node export operations.
+- Values: `'PNG'`, `'JPG'`, `'SVG'`, `'PDF'`, `'JSON_REST_V1'`.

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

@@ -0,0 +1,73 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/figma-code/Classes/FigmaItem - Обертка узла'/>
+
+# Класс FigmaItem
+
+Класс-обертка для узлов Figma (`UiFigmaNode`), который предоставляет упрощенный типизированный интерфейс для общих операций, таких как проверка типа, навигация по дереву и асинхронный экспорт.
+
+## Ключевые особенности
+
+- **Типизированный доступ** — Предоставляет методы-тайпгарды для узлов `DOCUMENT`, `FRAME`, `SECTION` и `TEXT`.
+- **Упрощенная навигация** — Легкий доступ к родительским или дочерним узлам, обернутым в экземпляры `FigmaItem`.
+- **Экспорт** — Высокоуровневые методы для экспорта узлов в форматы JPG или JSON.
+- **Анализ контента** — Специализированная логика для извлечения и валидации текстового содержимого.
+
+## Инициализация
+
+Для инициализации объекта вызовите конструктор `FigmaItem(item)`.
+
+### Ограничения универсальных типов (Generics)
+
+Класс поддерживает параметр универсального типа для строгой типизации:
+- `T extends UiFigmaNode` — Конкретный тип обернутого узла Figma.
+
+**Параметры:**
+- `item: T` — Нативный узел Figma (например, `SceneNode`, `FrameNode`, `TextNode`), который необходимо обернуть.
+
+```typescript
+import { FigmaItem } from '@dxtmisha/figma-code'
+
+// 1. Обертывание текущего выделенного узла
+const item = new FigmaItem(figma.currentPage.selection[0])
+
+// 2. Использование дженериков для конкретных типов узлов
+const frameItem = new FigmaItem<FrameNode>(someFrameNode)
+```
+
+## Идентификация узла
+
+- `isDocument(): boolean` — Проверяет, является ли узел документом. Пример: `item.isDocument()`
+- `isFrame(): boolean` — Проверяет, является ли узел фреймом. Пример: `item.isFrame()`
+- `isSection(): boolean` — Проверяет, является ли узел секцией. Пример: `item.isSection()`
+- `isText(): boolean` — Проверяет, является ли узел текстовым. Пример: `item.isText()`
+- `isTextNoValue(): boolean` — Фильтрует текстовые узлы со значимым контентом. Пример: `item.isTextNoValue()`
+- `getType(): string | undefined` — Возвращает строковую константу типа узла. Пример: `const type = item.getType()`
+- `getId(): string` — Возвращает уникальный ID узла. Пример: `const id = item.getId()`
+- `getName(): string` — Возвращает отображаемое имя узла. Пример: `const name = item.getName()`
+
+## Навигация
+
+- `getParent(): UiFigmaNode | undefined` — Возвращает нативный родительский узел. Пример: `const parent = item.getParent()`
+- `getParentItem(): FigmaItem | undefined` — Возвращает родителя, обернутого в `FigmaItem`. Пример: `const parentItem = item.getParentItem()`
+- `getChildren(): UiFigmaNode[]` — Возвращает массив нативных дочерних узлов. Пример: `const children = item.getChildren()`
+- `getChildrenItems(): FigmaItem[]` — Возвращает массив обернутых дочерних узлов. Пример: `const items = item.getChildrenItems()`
+
+## Данные и экспорт
+
+- `get(): T` — Возвращает исходный нативный узел Figma. Пример: `const raw = item.get()`
+- `exportJpg(): Promise<Uint8Array | string>` — Асинхронно экспортирует узел в JPG. Пример: `const bytes = await item.exportJpg()`
+- `exportJson(): Promise<Uint8Array | string>` — Асинхронно экспортирует узел в JSON. Пример: `const json = await item.exportJson()`
+- `getText(): string` — Извлекает очищенное текстовое содержимое. Пример: `const content = item.getText()`
+
+## Типы (Types)
+
+### `UiFigmaNode`
+
+Тип-объединение (union), представляющий любой релевантный узел Figma, который может быть обернут в `FigmaItem`.
+- Включает: `DocumentNode`, `PageNode`, `FrameNode`, `SectionNode`, `TextNode` и другие варианты `SceneNode`.
+
+### `UiFigmaExportFormat`
+
+Поддерживаемые форматы для операций экспорта узлов.
+- Значения: `'PNG'`, `'JPG'`, `'SVG'`, `'PDF'`, `'JSON_REST_V1'`.

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

@@ -0,0 +1,73 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/figma-code/Classes/FigmaItem - Node Wrapper'/>
+
+# Lớp FigmaItem
+
+Một lớp wrapper cho các node Figma (`UiFigmaNode`) cung cấp giao diện được định nghĩa kiểu dữ liệu đơn giản cho các thao tác phổ biến như kiểm tra loại node, điều hướng cây node và xuất dữ liệu không đồng bộ.
+
+## Các tính năng chính
+
+- **Truy cập có định kiểu** — Cung cấp các phương thức type guard cho các node `DOCUMENT`, `FRAME`, `SECTION`, và `TEXT`.
+- **Điều hướng đơn giản** — Dễ dàng truy cập các node cha hoặc con được bọc trong các thực thể `FigmaItem`.
+- **Hỗ trợ Export** — Các phương thức cấp cao để xuất các node sang định dạng JPG hoặc JSON.
+- **Phân tích nội dung** — Logic chuyên biệt để trích xuất và xác thực nội dung văn bản.
+
+## Khởi tạo
+
+Để khởi tạo đối tượng, hãy gọi hàm dựng `FigmaItem(item)`.
+
+### Ràng buộc Generics
+
+Lớp hỗ trợ một tham số generic để định kiểu nghiêm ngặt:
+- `T extends UiFigmaNode` — Loại cụ thể của node Figma được bọc.
+
+**Tham số:**
+- `item: T` — Node Figma gốc (ví dụ: `SceneNode`, `FrameNode`, `TextNode`) cần được bọc.
+
+```typescript
+import { FigmaItem } from '@dxtmisha/figma-code'
+
+// 1. Bọc một node đang được chọn
+const item = new FigmaItem(figma.currentPage.selection[0])
+
+// 2. Sử dụng generics cho các loại node cụ thể
+const frameItem = new FigmaItem<FrameNode>(someFrameNode)
+```
+
+## Định danh Node
+
+- `isDocument(): boolean` — Kiểm tra xem node được bọc có phải là DOCUMENT hay không. Ví dụ: `item.isDocument()`
+- `isFrame(): boolean` — Kiểm tra xem node có phải là FRAME hay không. Ví dụ: `item.isFrame()`
+- `isSection(): boolean` — Kiểm tra xem node có phải là SECTION hay không. Ví dụ: `item.isSection()`
+- `isText(): boolean` — Kiểm tra xem node có phải là TEXT hay không. Ví dụ: `item.isText()`
+- `isTextNoValue(): boolean` — Lọc các node văn bản có nội dung ý nghĩa. Ví dụ: `item.isTextNoValue()`
+- `getType(): string | undefined` — Trả về hằng số chuỗi loại của node. Ví dụ: `const type = item.getType()`
+- `getId(): string` — Trả về ID duy nhất của node. Ví dụ: `const id = item.getId()`
+- `getName(): string` — Trả về tên hiển thị của node. Ví dụ: `const name = item.getName()`
+
+## Điều hướng
+
+- `getParent(): UiFigmaNode | undefined` — Trả về node cha gốc. Ví dụ: `const parent = item.getParent()`
+- `getParentItem(): FigmaItem | undefined` — Trả về node cha được bọc. Ví dụ: `const parentItem = item.getParentItem()`
+- `getChildren(): UiFigmaNode[]` — Trả về một mảng các node con gốc. Ví dụ: `const children = item.getChildren()`
+- `getChildrenItems(): FigmaItem[]` — Trả về một mảng các node con đã bọc. Ví dụ: `const items = item.getChildrenItems()`
+
+## Dữ liệu & Xuất bản
+
+- `get(): T` — Trả về node Figma gốc bên dưới. Ví dụ: `const raw = item.get()`
+- `exportJpg(): Promise<Uint8Array | string>` — Xuất node sang định dạng JPG. Ví dụ: `const bytes = await item.exportJpg()`
+- `exportJson(): Promise<Uint8Array | string>` — Xuất node sang định dạng JSON. Ví dụ: `const json = await item.exportJson()`
+- `getText(): string` — Lấy nội dung văn bản đã làm sạch. Ví dụ: `const content = item.getText()`
+
+## Các loại dữ liệu (Types)
+
+### `UiFigmaNode`
+
+Một kiểu union đại diện cho bất kỳ node Figma nào có liên quan có thể được bọc bởi `FigmaItem`.
+- Bao gồm: `DocumentNode`, `PageNode`, `FrameNode`, `SectionNode`, `TextNode`, và các biến thể `SceneNode` khác.
+
+### `UiFigmaExportFormat`
+
+Các định dạng được hỗ trợ cho các thao tác xuất (export) node.
+- Các giá trị: `'PNG'`, `'JPG'`, `'SVG'`, `'PDF'`, `'JSON_REST_V1'`.

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

@@ -0,0 +1,63 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/figma-code/Classes/FigmaPluginMessenger - Backend Messenger'/>
+
+# FigmaPluginMessenger Class
+
+Messenger for the Figma plugin side (backend). It handles sending messages to the Figma UI and listening for messages from the UI using the internal Figma `figma.ui` API.
+
+## Initialization
+
+Extends `FigmaPostAbstract`.
+
+```typescript
+import { FigmaPluginMessenger } from '@dxtmisha/figma-code'
+
+const messenger = new FigmaPluginMessenger()
+  .make()
+  .add('hello-ui', (msg) => console.log('UI:', msg))
+```
+
+## Public Methods
+
+### `make`
+
+Initializes the message listener using the `figma.ui.onmessage` API. Should be called once to start receiving messages from the UI.
+
+**Returns:** `this`
+
+```javascript
+messenger.make()
+```
+
+### `add`
+
+Registers a listener for a specific message type coming from the UI.
+
+**Parameters:**
+- `type: string` — Unique identifier for the message type to listen for.
+- `callback: (message: Message) => void` — function to execute when a matching message arrives.
+
+**Returns:** `this`
+
+```javascript
+messenger.add('resize-ui', (data) => {
+  figma.ui.resize(data.width, data.height)
+})
+```
+
+### `post`
+
+Sends a message to the Figma UI side.
+
+**Parameters:**
+- `type: string` — The identifier of the message (type).
+- `message: Message` — (Optional) Data payload to send to the UI.
+
+**Returns:** `void`
+
+```javascript
+messenger.post('selection-data', { 
+  ids: figma.currentPage.selection.map(node => node.id) 
+})
+```

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

@@ -0,0 +1,63 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/figma-code/Classes/FigmaPluginMessenger - Мессенджер плагина'/>
+
+# Класс FigmaPluginMessenger
+
+Мессенджер для стороны плагина Figma (backend). Обрабатывает отправку сообщений в UI Figma и прослушивание сообщений из UI, используя внутренний API Figma `figma.ui`.
+
+## Инициализация
+
+Наследует `FigmaPostAbstract`.
+
+```typescript
+import { FigmaPluginMessenger } from '@dxtmisha/figma-code'
+
+const messenger = new FigmaPluginMessenger()
+  .make()
+  .add('hello-ui', (msg) => console.log('UI:', msg))
+```
+
+## Публичные методы
+
+### `make`
+
+Инициализирует слушатель сообщений, используя API `figma.ui.onmessage`. Должен быть вызван один раз для начала приема сообщений из UI.
+
+**Возвращает:** `this`
+
+```javascript
+messenger.make()
+```
+
+### `add`
+
+Регистрирует слушатель для определенного типа сообщения, поступающего из UI.
+
+**Параметры:**
+- `type: string` — Уникальный идентификатор типа сообщения для прослушивания.
+- `callback: (message: Message) => void` — функция, которую необходимо выполнить при получении соответствующего сообщения.
+
+**Возвращает:** `this`
+
+```javascript
+messenger.add('resize-ui', (data) => {
+  figma.ui.resize(data.width, data.height)
+})
+```
+
+### `post`
+
+Отправляет сообщение в UI Figma.
+
+**Параметры:**
+- `type: string` — Идентификатор сообщения (тип).
+- `message: Message` — (Опционально) Полезные данные для отправки в UI.
+
+**Возвращает:** `void`
+
+```javascript
+messenger.post('selection-data', { 
+  ids: figma.currentPage.selection.map(node => node.id) 
+})
+```

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

@@ -0,0 +1,63 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/figma-code/Classes/FigmaPluginMessenger - Trình nhắn tin Backend'/>
+
+# Lớp FigmaPluginMessenger
+
+Trình nhắn tin cho phía plugin Figma (backend). Nó xử lý việc gửi tin nhắn đến UI Figma và lắng nghe tin nhắn từ UI bằng API nội bộ của Figma `figma.ui`.
+
+## Khởi tạo
+
+Kế thừa từ `FigmaPostAbstract`.
+
+```typescript
+import { FigmaPluginMessenger } from '@dxtmisha/figma-code'
+
+const messenger = new FigmaPluginMessenger()
+  .make()
+  .add('hello-ui', (msg) => console.log('UI:', msg))
+```
+
+## Các phương thức công khai
+
+### `make`
+
+Khởi tạo trình lắng nghe tin nhắn bằng API `figma.ui.onmessage`. Nên được gọi một lần để bắt đầu nhận tin nhắn từ UI.
+
+**Trả về:** `this`
+
+```javascript
+messenger.make()
+```
+
+### `add`
+
+Đăng ký một trình lắng nghe cho một loại tin nhắn cụ thể đến từ UI.
+
+**Tham số:**
+- `type: string` — Mã định danh duy nhất cho loại tin nhắn cần lắng nghe.
+- `callback: (message: Message) => void` — hàm sẽ thực thi khi có một tin nhắn phù hợp đến.
+
+**Trả về:** `this`
+
+```javascript
+messenger.add('resize-ui', (data) => {
+  figma.ui.resize(data.width, data.height)
+})
+```
+
+### `post`
+
+Gửi một tin nhắn đến phía UI Figma.
+
+**Tham số:**
+- `type: string` — Mã định danh của tin nhắn (loại).
+- `message: Message` — (Tùy chọn) Dữ liệu payload để gửi đến UI.
+
+**Trả về:** `void`
+
+```javascript
+messenger.post('selection-data', { 
+  ids: figma.currentPage.selection.map(node => node.id) 
+})
+```

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

@@ -0,0 +1,90 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/figma-code/Classes/FigmaStorage - Storage Manager'/>
+
+# FigmaStorage Class
+
+A class for robust management of Figma's `PluginData`. It provides a high-level API for storing, retrieving, and expiring data on Figma nodes (defaulting to the root node), with support for in-memory caching and default values.
+
+## Key Features
+
+- **Persistence** — Wraps `getPluginData` and `setPluginData` for seamless data storage.
+- **In-Memory Caching** — Stores values in the instance for fast access during the current execution context.
+- **Expiration Logic** — Supports age-based caching to invalidate stale data.
+- **Functional Values** — Supports passing functions as values or default values for dynamic data generation.
+
+## Initialization
+
+To initialize the object, call the `FigmaStorage(name, item, cache)` constructor.
+
+### Generic Parameters
+
+The class supports a generic parameter for typed data management:
+- `T` — The type of the value being stored and retrieved.
+
+**Parameters:**
+- `name: string` — The unique key name for the storage item.
+- `item: PluginDataMixin = figma.root` — The Figma node where the data will be stored. Defaults to `figma.root`.
+- `cache: number` — (Optional) TTL in seconds for the stored data.
+
+```typescript
+import { FigmaStorage } from '@dxtmisha/figma-code'
+
+// 1. Initialize with implicit typing
+const settings = new FigmaStorage('plugin-settings')
+
+// 2. Initialize with explicit generic for strict typing
+interface MyData { theme: string; version: number }
+const typedSettings = new FigmaStorage<MyData>('app-data')
+
+// 3. Initialize with a 1-hour cache
+const cacheSettings = new FigmaStorage('cache', figma.root, 3600)
+```
+
+## Methods
+
+### `get`
+
+Retrieves data from storage with support for default values and cache validation.
+
+**Parameters:**
+- `defaultValue: T | (() => T)` — (Optional) Value returned (and saved) if storage is empty or expired.
+
+**Returns:** `T | undefined`
+
+```javascript
+const val = settings.get('default_val')
+```
+
+### `set`
+
+Updates the data in both the in-memory cache and the Figma node's `PluginData`.
+
+**Parameters:**
+- `value: T | (() => T)` — (Optional) New value or a function that returns the new value.
+
+**Returns:** `T | undefined`
+
+```javascript
+settings.set({ theme: 'dark' })
+```
+
+### `remove`
+
+Clears the data from both the in-memory cache and the Figma node's `PluginData`.
+
+**Returns:** `this`
+
+```javascript
+settings.remove()
+```
+
+### `getName`
+
+Returns the key name used for this storage instance.
+
+**Returns:** `string`
+
+```javascript
+console.log(settings.getName())
+```

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

@@ -0,0 +1,90 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/figma-code/Classes/FigmaStorage - Менеджер хранилища'/>
+
+# Класс FigmaStorage
+
+Класс для управления `PluginData` в Figma. Предоставляет высокоуровневый API для сохранения, получения и контроля срока жизни данных на узлах Figma (по умолчанию — корень документа), с поддержкой кэширования в памяти и значений по умолчанию.
+
+## Ключевые особенности
+
+- **Персистентность** — Обертка над `getPluginData` и `setPluginData` для удобного хранения данных.
+- **Кэширование в памяти** — Сохраняет значения в экземпляре для быстрого доступа во время выполнения.
+- **Логика истечения срока** — Поддержка кэширования на основе времени для инвалидации устаревших данных.
+- **Функциональные значения** — Поддержка передачи функций в качестве значений или значений по умолчанию для динамической генерации данных.
+
+## Инициализация
+
+Для инициализации объекта вызовите конструктор `FigmaStorage(name, item, cache)`.
+
+### Параметры универсального типа (Generics)
+
+Класс поддерживает параметр универсального типа для типизированного управления данными:
+- `T` — Тип сохраняемого и получаемого значения.
+
+**Параметры:**
+- `name: string` — Уникальное имя ключа для элемента хранилища.
+- `item: PluginDataMixin = figma.root` — Узел Figma, в котором будут храниться данные. По умолчанию — `figma.root`.
+- `cache: number` — (Опционально) Время жизни (TTL) данных в секундах.
+
+```typescript
+import { FigmaStorage } from '@dxtmisha/figma-code'
+
+// 1. Инициализация с неявной типизацией
+const settings = new FigmaStorage('plugin-settings')
+
+// 2. Использование дженериков для строгой типизации
+interface MyData { theme: string; version: number }
+const typedSettings = new FigmaStorage<MyData>('app-data')
+
+// 3. Инициализация с кэшированием на 1 час
+const cacheSettings = new FigmaStorage('cache', figma.root, 3600)
+```
+
+## Методы
+
+### `get`
+
+Получает данные из хранилища с поддержкой значений по умолчанию и проверки кэша.
+
+**Параметры:**
+- `defaultValue: T | (() => T)` — (Опционально) Значение, которое возвращается (и сохраняется), если хранилище пустое или срок действия данных истек.
+
+**Возвращает:** `T | undefined`
+
+```javascript
+const val = settings.get('default_val')
+```
+
+### `set`
+
+Обновляет данные как в кэше в памяти, так и в `PluginData` узла Figma.
+
+**Параметры:**
+- `value: T | (() => T)` — (Опционально) Новое значение или функция, возвращающая новое значение.
+
+**Возвращает:** `T | undefined`
+
+```javascript
+settings.set({ theme: 'dark' })
+```
+
+### `remove`
+
+Очищает данные как из кэша в памяти, так и из `PluginData` узла Figma.
+
+**Возвращает:** `this`
+
+```javascript
+settings.remove()
+```
+
+### `getName`
+
+Возвращает имя ключа, используемое этим экземпляром хранилища.
+
+**Возвращает:** `string`
+
+```javascript
+console.log(settings.getName())
+```