@dxtmisha/wiki 0.57.3 → 0.57.6

package/src/media/functional/figma/functions/fetchFrameSelection/fetchFrameSelection.vi.mdx

@@ -0,0 +1,34 @@
+import { Meta, Source } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/figma/Functions/fetchFrameSelection - Lấy vùng chọn hiện tại'/>
+
+# `fetchFrameSelection`
+
+Một tiện ích để truy xuất và quan sát danh sách các phần tử hiện đang được người dùng chọn trong Figma. Nó cung cấp thông tin chi tiết về vùng chọn hiện tại, bao gồm tên, ID và ảnh chụp màn hình.
+
+**Tham số:**
+- `callback: (value: UiFigmaFramesList) => void` — Một hàm được gọi bất cứ khi nào vùng chọn được cập nhật.
+
+**Trả về:**
+`void`
+
+## Ví dụ sử dụng
+
+```typescript
+import { fetchFrameSelection } from '@dxtmisha/figma'
+
+fetchFrameSelection((frames) => {
+  console.log('Vùng chọn hiện tại đã được cập nhật:', frames)
+})
+```
+
+## Các kiểu dữ liệu
+
+#### `UiFigmaFramesItem`
+Đại diện cho một phần tử frame được đơn giản hóa cho UI.
+- `name: string` — Tên của frame.
+- `id: string` — Định danh duy nhất của phần tử.
+- `image: Uint8Array | string` — Hình ảnh của frame (tùy chọn).
+
+#### `UiFigmaFramesList`
+Một danh sách các đối tượng `UiFigmaFramesItem`.

package/src/media/functional/figma/functions/fetchFrameStyles/fetchFrameStyles.en.mdx

@@ -0,0 +1,49 @@
+import { Meta, Source } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/figma/Functions/fetchFrameStyles - Fetch frame styles'/>
+
+# `fetchFrameStyles`
+
+A utility for retrieving style information for specified frames from the Figma plugin. It allows access to CSS styles, JSON data, and text content for nodes and their children.
+
+**Parameters:**
+- `callback: (value: UiFigmaFrameStylesMessengerResponse) => void` — The function executed once the style data for the requested frames is received.
+
+
+**Returns:**
+`void`
+
+## Examples
+
+<Source
+  language='typescript'
+  code={`
+import { fetchFrameStyles } from '@dxtmisha/figma'
+
+// Fetch styles for frames and log the result
+fetchFrameStyles((response) => {
+  response.forEach(item => {
+    console.log('Frame ID:', item.id)
+    console.log('Style data:', item.data)
+  })
+})
+  `}
+/>
+
+## Types
+
+### UiFigmaFrameStylesMessengerResponse
+An array of `UiFigmaFrameStylesMessengerResponseItem` objects.
+
+### UiFigmaFrameStylesMessengerResponseItem
+- `id: string` — Unique frame identifier.
+- `data: UiFigmaFrameStylesList` — List of style data for the frame.
+
+### UiFigmaFrameStylesItem
+Extends `UiFigmaFramesItem`.
+- `name: string` — Frame name.
+- `id: string` — Unique element identifier.
+- `json?: UiFigmaFrameStylesData` — (Optional) Compact node data in JSON format.
+- `text?: string` — (Optional) Text content (for text nodes).
+- `styles?: UiFigmaFrameStylesCssItem` — (Optional) Map of CSS styles for the element.
+- `childrenStyles?: UiFigmaFrameStylesCssList` — (Optional) Map of CSS styles for children elements.

package/src/media/functional/figma/functions/fetchFrameStyles/fetchFrameStyles.ru.mdx

@@ -0,0 +1,49 @@
+import { Meta, Source } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/figma/Functions/fetchFrameStyles - Получение стилей фреймов'/>
+
+# `fetchFrameStyles`
+
+Утилита для получения информации о стилях указанных фреймов из плагина Figma. Позволяет получить доступ к CSS-стилям, JSON-данным и текстовому содержимому для узлов и их дочерних элементов.
+
+**Параметры:**
+- `callback: (value: UiFigmaFrameStylesMessengerResponse) => void` — Функция, которая будет вызвана после получения данных о стилях для запрошенных фреймов.
+
+
+**Возвращает:**
+`void`
+
+## Примеры
+
+<Source
+  language='typescript'
+  code={`
+import { fetchFrameStyles } from '@dxtmisha/figma'
+
+// Получить стили для фреймов и вывести результат в консоль
+fetchFrameStyles((response) => {
+  response.forEach(item => {
+    console.log('ID фрейма:', item.id)
+    console.log('Данные стилей:', item.data)
+  })
+})
+  `}
+/>
+
+## Типы
+
+### UiFigmaFrameStylesMessengerResponse
+Массив элементов `UiFigmaFrameStylesMessengerResponseItem`.
+
+### UiFigmaFrameStylesMessengerResponseItem
+- `id: string` — Уникальный идентификатор фрейма.
+- `data: UiFigmaFrameStylesList` — Список данных стилей для фрейма.
+
+### UiFigmaFrameStylesItem
+Расширяет `UiFigmaFramesItem`.
+- `name: string` — Название фрейма.
+- `id: string` — Уникальный идентификатор элемента.
+- `json?: UiFigmaFrameStylesData` — (Опционально) Компактные данные узла в формате JSON.
+- `text?: string` — (Опционально) Текстовое содержимое (для текстовых узлов).
+- `styles?: UiFigmaFrameStylesCssItem` — (Опционально) Карта CSS-стилей элемента.
+- `childrenStyles?: UiFigmaFrameStylesCssList` — (Опционально) Карта CSS-стилей дочерних элементов.

package/src/media/functional/figma/functions/fetchFrameStyles/fetchFrameStyles.vi.mdx

@@ -0,0 +1,49 @@
+import { Meta, Source } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/figma/Functions/fetchFrameStyles - Lấy styles của frame'/>
+
+# `fetchFrameStyles`
+
+Một tiện ích để lấy thông tin style của các frame được chỉ định từ Figma plugin. Nó cho phép truy cập vào CSS styles, dữ liệu JSON và nội dung văn bản cho các node và các node con của chúng.
+
+**Tham số:**
+- `callback: (value: UiFigmaFrameStylesMessengerResponse) => void` — Hàm được thực thi sau khi nhận được dữ liệu style cho các frame được yêu cầu.
+
+
+**Trả về:**
+`void`
+
+## Ví dụ
+
+<Source
+  language='typescript'
+  code={`
+import { fetchFrameStyles } from '@dxtmisha/figma'
+
+// Lấy styles cho các frame và log kết quả
+fetchFrameStyles((response) => {
+  response.forEach(item => {
+    console.log('Frame ID:', item.id)
+    console.log('Dữ liệu style:', item.data)
+  })
+})
+  `}
+/>
+
+## Các kiểu dữ liệu
+
+### UiFigmaFrameStylesMessengerResponse
+Một mảng các đối tượng `UiFigmaFrameStylesMessengerResponseItem`.
+
+### UiFigmaFrameStylesMessengerResponseItem
+- `id: string` — Định danh duy nhất của frame.
+- `data: UiFigmaFrameStylesList` — Danh sách dữ liệu style cho frame.
+
+### UiFigmaFrameStylesItem
+Mở rộng từ `UiFigmaFramesItem`.
+- `name: string` — Tên của frame.
+- `id: string` — Định danh duy nhất của phần tử.
+- `json?: UiFigmaFrameStylesData` — (Tùy chọn) Dữ liệu node thu gọn dưới định dạng JSON.
+- `text?: string` — (Tùy chọn) Nội dung văn bản (đối với các node văn bản).
+- `styles?: UiFigmaFrameStylesCssItem` — (Tùy chọn) Bản đồ các style CSS cho phần tử.
+- `childrenStyles?: UiFigmaFrameStylesCssList` — (Tùy chọn) Bản đồ các style CSS của các phần tử con.

package/src/media/functional/figma/functions/fetchFramesSelected/fetchFramesSelected.en.mdx

@@ -1,21 +1,32 @@
-import { Meta } from '@storybook/addon-docs/blocks'
+import { Meta, Source } from '@storybook/addon-docs/blocks'
 
-<Meta title='@dxtmisha/en/figma/Functions/fetchFramesSelected - Fetching selected frames'/>
+<Meta title='@dxtmisha/en/figma/Functions/fetchFramesSelected - Fetch selected frames'/>
 
 # `fetchFramesSelected`
 
-A utility that fetches the currently selected frames from the Figma plugin. It handles caching and prevents concurrent duplicate requests.
+A utility for retrieving the IDs of currently selected frames from the Figma plugin. It facilitates communication between the Figma UI and the plugin side to access the user's current selection.
 
 **Parameters:**
-- `callback: (selected: string[]) => void` — The function to call once the selected frame IDs are received.
+- `callback: (selected: string[]) => void` — The function executed once the list of selected frame IDs is received.
+
 
 **Returns:**
 `void`
 
-```javascript
+## Examples
+
+<Source
+  language='typescript'
+  code={`
 import { fetchFramesSelected } from '@dxtmisha/figma'
 
-fetchFramesSelected((selected) => {
-  console.log('Selected frames:', selected)
+// Fetch selected frames and log their IDs
+fetchFramesSelected((selectedIds) => {
+  if (selectedIds.length === 0) {
+    console.log('No frames selected')
+  } else {
+    console.log('Selected frame IDs:', selectedIds)
+  }
 })
-```
+  `}
+/>

package/src/media/functional/figma/functions/fetchFramesSelected/fetchFramesSelected.ru.mdx

@@ -1,21 +1,32 @@
-import { Meta } from '@storybook/addon-docs/blocks'
+import { Meta, Source } from '@storybook/addon-docs/blocks'
 
 <Meta title='@dxtmisha/ru/figma/Functions/fetchFramesSelected - Получение выбранных фреймов'/>
 
 # `fetchFramesSelected`
 
-Утилита, которая запрашивает текущие выбранные фреймы из плагина Figma. Она поддерживает кэширование и предотвращает дублирование одновременных запросов.
+Утилита для получения идентификаторов (ID) выбранных в данный момент фреймов в Figma. Обеспечивает связь между интерфейсом (UI) и основной частью плагина для доступа к текущему выбору пользователя.
 
 **Параметры:**
-- `callback: (selected: string[]) => void` — Функция, вызываемая после получения идентификаторов выбранных фреймов.
+- `callback: (selected: string[]) => void` — Функция, которая будет вызвана после получения списка ID выбранных фреймов.
+
 
 **Возвращает:**
 `void`
 
-```javascript
+## Примеры
+
+<Source
+  language='typescript'
+  code={`
 import { fetchFramesSelected } from '@dxtmisha/figma'
 
-fetchFramesSelected((selected) => {
-  console.log('Выбранные фреймы:', selected)
+// Получить выбранные фреймы и вывести их ID в консоль
+fetchFramesSelected((selectedIds) => {
+  if (selectedIds.length === 0) {
+    console.log('Фреймы не выбраны')
+  } else {
+    console.log('ID выбранных фреймов:', selectedIds)
+  }
 })
-```
+  `}
+/>

package/src/media/functional/figma/functions/fetchFramesSelected/fetchFramesSelected.vi.mdx

@@ -1,21 +1,32 @@
-import { Meta } from '@storybook/addon-docs/blocks'
+import { Meta, Source } from '@storybook/addon-docs/blocks'
 
-<Meta title='@dxtmisha/vi/figma/Functions/fetchFramesSelected - Lấy danh sách các frame đang chọn'/>
+<Meta title='@dxtmisha/vi/figma/Functions/fetchFramesSelected - Lấy các frame đang được chọn'/>
 
 # `fetchFramesSelected`
 
-Một tiện ích giúp lấy danh sách các frame hiện đang được chọn từ plugin Figma. Nó hỗ trợ lưu bộ nhớ đệm (caching) và ngăn chặn các yêu cầu trùng lặp đồng thời.
+Một tiện ích để lấy danh sách ID của các frame đang được chọn trong Figma. Nó tạo điều kiện giao tiếp giữa giao diện người dùng (UI) và phần plugin để truy cập vào lựa chọn hiện tại của người dùng.
 
 **Tham số:**
-- `callback: (selected: string[]) => void` — Hàm sẽ được gọi sau khi nhận được danh sách ID các frame đang chọn.
+- `callback: (selected: string[]) => void` — Hàm được thực thi sau khi nhận được danh sách ID của các frame được chọn.
+
 
 **Trả về:**
 `void`
 
-```javascript
+## Ví dụ
+
+<Source
+  language='typescript'
+  code={`
 import { fetchFramesSelected } from '@dxtmisha/figma'
 
-fetchFramesSelected((selected) => {
-  console.log('Các frame đang chọn:', selected)
+// Lấy các frame được chọn và log ID của chúng
+fetchFramesSelected((selectedIds) => {
+  if (selectedIds.length === 0) {
+    console.log('Không có frame nào được chọn')
+  } else {
+    console.log('ID các frame được chọn:', selectedIds)
+  }
 })
-```
+  `}
+/>

package/src/media/functional/figma/functions/fetchStorage/fetchStorage.en.mdx

@@ -0,0 +1,42 @@
+import { Meta, Source } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/figma/Functions/fetchStorage - Fetch shared storage data'/>
+
+# `fetchStorage`
+
+A utility for fetching data from Figma's shared storage. Unlike client storage, this data can be shared and associated with specific identifiers (e.g., node IDs).
+
+**Parameters:**
+- `name: string` — The name of the storage.
+- `callback: (value: T) => void` — The function executed once the data is retrieved.
+- `id?: string` — (Optional) An identifier to distinguish data within the same storage name.
+- `defaultValue?: T` — (Optional) A default value returned if the storage key does not exist.
+- `isOnce: boolean = true` — If `true`, the callback will be executed only once.
+
+**Returns:**
+`void`
+
+## Examples
+
+<Source
+  language='typescript'
+  code={`
+import { fetchStorage } from '@dxtmisha/figma'
+
+// 1. Basic usage
+fetchStorage<string>('project-status', (status) => {
+  console.log('Status:', status)
+}, undefined, 'active')
+
+// 2. Fetching data for a specific node
+const nodeId = '12:34'
+fetchStorage<object>('node-metadata', (data) => {
+  console.log('Node metadata:', data)
+}, nodeId)
+
+// 3. Persistent subscription
+fetchStorage<number>('global-counter', (count) => {
+  console.log('Counter update:', count)
+}, undefined, 0, false)
+  `}
+/>

package/src/media/functional/figma/functions/fetchStorage/fetchStorage.ru.mdx

@@ -0,0 +1,42 @@
+import { Meta, Source } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/figma/Functions/fetchStorage - Получение данных из общего хранилища'/>
+
+# `fetchStorage`
+
+Утилита для получения данных из общего хранилища Figma. В отличие от клиентского хранилища, эти данные могут быть связаны с конкретными идентификаторами (например, ID узлов) и доступны другим пользователям.
+
+**Параметры:**
+- `name: string` — Имя хранилища.
+- `callback: (value: T) => void` — Функция, которая будет вызвана после получения данных.
+- `id?: string` — (Опционально) Идентификатор для разделения данных (например, ID ноды).
+- `defaultValue?: T` — (Опционально) Значение по умолчанию, если данные отсутствуют.
+- `isOnce: boolean = true` — Если `true`, колбэк будет вызван только один раз.
+
+**Возвращает:**
+`void`
+
+## Примеры
+
+<Source
+  language='typescript'
+  code={`
+import { fetchStorage } from '@dxtmisha/figma'
+
+// 1. Базовое использование
+fetchStorage<string>('project-status', (status) => {
+  console.log('Статус:', status)
+}, undefined, 'active')
+
+// 2. Получение данных для конкретного узла (node)
+const nodeId = '12:34'
+fetchStorage<object>('node-metadata', (data) => {
+  console.log('Метаданные узла:', data)
+}, nodeId)
+
+// 3. Постоянная подписка
+fetchStorage<number>('global-counter', (count) => {
+  console.log('Обновление счетчика:', count)
+}, undefined, 0, false)
+  `}
+/>

package/src/media/functional/figma/functions/fetchStorage/fetchStorage.vi.mdx

@@ -0,0 +1,42 @@
+import { Meta, Source } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/figma/Functions/fetchStorage - Lấy dữ liệu từ bộ nhớ chung'/>
+
+# `fetchStorage`
+
+Một tiện ích để lấy dữ liệu từ bộ nhớ chung của Figma. Khác với bộ nhớ client, dữ liệu này có thể được chia sẻ và liên kết với các định danh cụ thể (ví dụ: ID của node).
+
+**Tham số:**
+- `name: string` — Tên của bộ nhớ.
+- `callback: (value: T) => void` — Hàm được thực thi sau khi dữ liệu được truy xuất.
+- `id?: string` — (Tùy chọn) Định danh để phân biệt dữ liệu trong cùng một tên bộ nhớ.
+- `defaultValue?: T` — (Tùy chọn) Giá trị mặc định được trả về nếu khóa bộ nhớ không tồn tại.
+- `isOnce: boolean = true` — Nếu `true`, hàm callback sẽ chỉ được thực thi một lần.
+
+**Trả về:**
+`void`
+
+## Ví dụ
+
+<Source
+  language='typescript'
+  code={`
+import { fetchStorage } from '@dxtmisha/figma'
+
+// 1. Cách sử dụng cơ bản
+fetchStorage<string>('project-status', (status) => {
+  console.log('Trạng thái:', status)
+}, undefined, 'active')
+
+// 2. Lấy dữ liệu cho một node cụ thể
+const nodeId = '12:34'
+fetchStorage<object>('node-metadata', (data) => {
+  console.log('Metadata của node:', data)
+}, nodeId)
+
+// 3. Đăng ký nhận cập nhật liên tục
+fetchStorage<number>('global-counter', (count) => {
+  console.log('Cập nhật bộ đếm:', count)
+}, undefined, 0, false)
+  `}
+/>

package/src/media/functional/figma/functions/fetchTopLevelFrames/fetchTopLevelFrames.en.mdx

@@ -1,21 +1,43 @@
-import { Meta } from '@storybook/addon-docs/blocks'
+import { Meta, Source } from '@storybook/addon-docs/blocks'
 
-<Meta title='@dxtmisha/en/figma/Functions/fetchTopLevelFrames - Fetching top-level frames'/>
+<Meta title='@dxtmisha/en/figma/Functions/fetchTopLevelFrames - Fetch top-level frames'/>
 
 # `fetchTopLevelFrames`
 
-A utility that fetches the top-level frames from the Figma plugin. It handles caching and prevents concurrent duplicate requests.
+A utility for retrieving the list of all top-level frames currently present in the Figma document. It facilitates communication between the Figma UI and the plugin side to access the document structure.
 
 **Parameters:**
-- `callback: (frames: UiFigmaFramesList) => void` — The function to call once the frames are received.
+- `callback: (frames: UiFigmaFramesList) => void` — The function executed once the list of top-level frames is received.
 
 **Returns:**
 `void`
 
-```javascript
+## Types
+
+### UiFigmaFramesList
+
+An array of `UiFigmaFramesItem`.
+
+### UiFigmaFramesItem
+
+- `name: string` — Name of the frame.
+- `id: string` — Unique identifier of the element.
+- `image?: Uint8Array | string` — (Optional) The frame's preview image as a byte array or Base64 string.
+
+## Examples
+
+<Source
+  language='typescript'
+  code={`
 import { fetchTopLevelFrames } from '@dxtmisha/figma'
 
+// Fetch all top-level frames and log their details
 fetchTopLevelFrames((frames) => {
-  console.log('Top level frames:', frames)
+  console.log('Top-level frames found:', frames.length)
+  
+  frames.forEach(frame => {
+    console.log(\`Frame: \${frame.name} (ID: \${frame.id})\`)
+  })
 })
-```
+  `}
+/>

package/src/media/functional/figma/functions/fetchTopLevelFrames/fetchTopLevelFrames.ru.mdx

@@ -1,21 +1,43 @@
-import { Meta } from '@storybook/addon-docs/blocks'
+import { Meta, Source } from '@storybook/addon-docs/blocks'
 
 <Meta title='@dxtmisha/ru/figma/Functions/fetchTopLevelFrames - Получение фреймов верхнего уровня'/>
 
 # `fetchTopLevelFrames`
 
-Утилита, которая запрашивает фреймы верхнего уровня из плагина Figma. Она поддерживает кэширование и предотвращает дублирование одновременных запросов.
+Утилита для получения списка всех фреймов верхнего уровня, присутствующих в документе Figma. Обеспечивает связь между интерфейсом (UI) и основной частью плагина для доступа к структуре документа.
 
 **Параметры:**
-- `callback: (frames: UiFigmaFramesList) => void` — Функция, вызываемая после получения фреймов.
+- `callback: (frames: UiFigmaFramesList) => void` — Функция, которая будет вызвана после получения списка фреймов верхнего уровня.
 
 **Возвращает:**
 `void`
 
-```javascript
+## Типы
+
+### UiFigmaFramesList
+
+Массив элементов `UiFigmaFramesItem`.
+
+### UiFigmaFramesItem
+
+- `name: string` — Название фрейма.
+- `id: string` — Уникальный идентификатор элемента.
+- `image?: Uint8Array | string` — (Опционально) Изображение фрейма в виде байтового массива или строки Base64.
+
+## Примеры
+
+<Source
+  language='typescript'
+  code={`
 import { fetchTopLevelFrames } from '@dxtmisha/figma'
 
+// Получить все фреймы верхнего уровня и вывести информацию о них
 fetchTopLevelFrames((frames) => {
-  console.log('Фреймы верхнего уровня:', frames)
+  console.log('Найдено фреймов верхнего уровня:', frames.length)
+  
+  frames.forEach(frame => {
+    console.log(\`Фрейм: \${frame.name} (ID: \${frame.id})\`)
+  })
 })
-```
+  `}
+/>

package/src/media/functional/figma/functions/fetchTopLevelFrames/fetchTopLevelFrames.vi.mdx

@@ -1,21 +1,43 @@
-import { Meta } from '@storybook/addon-docs/blocks'
+import { Meta, Source } from '@storybook/addon-docs/blocks'
 
-<Meta title='@dxtmisha/vi/figma/Functions/fetchTopLevelFrames - Lấy danh sách frame cấp cao nhất'/>
+<Meta title='@dxtmisha/vi/figma/Functions/fetchTopLevelFrames - Lấy các frame cấp cao nhất'/>
 
 # `fetchTopLevelFrames`
 
-Một tiện ích giúp lấy danh sách các frame cấp cao nhất từ plugin Figma. Nó hỗ trợ lưu bộ nhớ đệm (caching) và ngăn chặn các yêu cầu trùng lặp đồng thời.
+Một tiện ích để lấy danh sách tất cả các frame cấp cao nhất hiện có trong tài liệu Figma. Nó tạo điều kiện giao tiếp giữa giao diện người dùng (UI) và phần plugin để truy cập vào cấu trúc tài liệu.
 
 **Tham số:**
-- `callback: (frames: UiFigmaFramesList) => void` — Hàm sẽ được gọi sau khi nhận được danh sách frame.
+- `callback: (frames: UiFigmaFramesList) => void` — Hàm được thực thi sau khi nhận được danh sách các frame cấp cao nhất.
 
 **Trả về:**
 `void`
 
-```javascript
+## Các kiểu dữ liệu
+
+### UiFigmaFramesList
+
+Một mảng gồm các phần tử `UiFigmaFramesItem`.
+
+### UiFigmaFramesItem
+
+- `name: string` — Tên của frame.
+- `id: string` — Định danh duy nhất của phần tử.
+- `image?: Uint8Array | string` — (Tùy chọn) Hình ảnh xem trước của frame dưới dạng mảng byte hoặc chuỗi Base64.
+
+## Ví dụ
+
+<Source
+  language='typescript'
+  code={`
 import { fetchTopLevelFrames } from '@dxtmisha/figma'
 
+// Lấy tất cả các frame cấp cao nhất và log thông tin chi tiết
 fetchTopLevelFrames((frames) => {
-  console.log('Các frame cấp cao nhất:', frames)
+  console.log('Tìm thấy các frame cấp cao nhất:', frames.length)
+  
+  frames.forEach(frame => {
+    console.log(\`Frame: \${frame.name} (ID: \${frame.id})\`)
+  })
 })
-```
+  `}
+/>

package/src/media/functional/figma/functions/sendClientStorage/sendClientStorage.en.mdx

@@ -0,0 +1,29 @@
+import { Meta, Source } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/figma/Functions/sendClientStorage - Save data to client storage'/>
+
+# `sendClientStorage`
+
+A utility for saving data to Figma's client storage. It sends a message from the UI to the plugin side to store the provided value under a specific name.
+
+**Parameters:**
+- `name: string` — The key name in the client storage.
+- `value: T` — The data value to be stored.
+
+**Returns:**
+`void`
+
+## Examples
+
+<Source
+  language='typescript'
+  code={`
+import { sendClientStorage } from '@dxtmisha/figma'
+
+// 1. Storing a simple string
+sendClientStorage('user-theme', 'dark')
+
+// 2. Storing an object
+sendClientStorage('settings', { notifications: true, zoom: 100 })
+  `}
+/>

package/src/media/functional/figma/functions/sendClientStorage/sendClientStorage.ru.mdx

@@ -0,0 +1,29 @@
+import { Meta, Source } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/figma/Functions/sendClientStorage - Сохранение данных в клиентское хранилище'/>
+
+# `sendClientStorage`
+
+Утилита для сохранения данных в клиентское хранилище Figma (`clientStorage`). Отправляет сообщение из интерфейса (UI) в основную часть плагина для записи значения по указанному имени.
+
+**Параметры:**
+- `name: string` — Ключ (имя) в хранилище.
+- `value: T` — Данные для сохранения.
+
+**Возвращает:**
+`void`
+
+## Примеры
+
+<Source
+  language='typescript'
+  code={`
+import { sendClientStorage } from '@dxtmisha/figma'
+
+// 1. Сохранение простой строки
+sendClientStorage('user-theme', 'dark')
+
+// 2. Сохранение объекта
+sendClientStorage('settings', { notifications: true, zoom: 100 })
+  `}
+/>