@dxtmisha/wiki 0.57.3 → 0.57.4

package/src/media/functional/figma-ref/composables/useFigmaFrameSelection/useFigmaFrameSelection.vi.mdx

@@ -0,0 +1,35 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/figma-ref/Composables/useFigmaFrameSelection - Quan sát lựa chọn frame (thông tin đầy đủ)'/>
+
+# `useFigmaFrameSelection`
+
+Một composable để truy xuất và quan sát danh sách chi tiết các frame hiện đang được chọn trong Figma. Không giống như `useFigmaUiSelected` (chỉ quản lý ID trong giao diện), composable này cung cấp thông tin đầy đủ về vùng chọn, bao gồm tên và ảnh chụp màn hình, bằng cách lắng nghe các sự kiện `selectionchange` trong Figma.
+
+**Trả về:**
+- `selection: ComputedRef<UiFigmaFramesList>` — Một tham chiếu được tính toán đến danh sách các frame được chọn (tên, ID và ảnh chụp màn hình).
+- `setSelection(id: string): void` — Một phương thức để thay đổi vùng chọn trong Figma sang một phần tử cụ thể.
+- `loading: ComputedRef<boolean>` — Một cờ phản hồi cho biết liệu dữ liệu vùng chọn có đang được lấy hay không.
+
+## Ví dụ sử dụng
+
+```typescript
+import { useFigmaFrameSelection } from '@dxtmisha/figma-ref'
+
+const { selection, setSelection, loading } = useFigmaFrameSelection()
+
+// 'selection' cập nhật bất cứ khi nào người dùng thay đổi vùng chọn của họ trong Figma
+// 'setSelection' có thể được sử dụng để thay đổi vùng chọn theo chương trình:
+setSelection('12:34')
+```
+
+## 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-ref/composables/useFigmaFrameStyles/useFigmaFrameStyles.en.mdx

@@ -0,0 +1,33 @@
+import { Meta, Source } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/figma-ref/Composables/useFigmaFrameStyles - Managing frame styles'/>
+
+# `useFigmaFrameStyles`
+
+A composable for managing and observing frame styles from Figma.
+
+**Returns:**
+- `styles: ComputedRef<UiFigmaFrameStylesMessengerResponse>` — A reactive list of frame styles.
+- `send(attributes: UiFigmaFrameStylesMessengerAttributes): void` — A method for sending a request to retrieve or update styles for specific nodes.
+
+## Examples
+
+```vue
+<script setup lang="ts">
+import { useFigmaFrameStyles } from '@dxtmisha/figma-ref'
+
+const { styles, send } = useFigmaFrameStyles()
+
+// Requesting styles for specific nodes
+const updateStyles = () => {
+  send({ ids: ['1:10', '1:20'], children: true })
+}
+</script>
+
+<template>
+  <div>
+    <button @click="updateStyles">Update Styles</button>
+    <pre>{{ styles }}</pre>
+  </div>
+</template>
+```

package/src/media/functional/figma-ref/composables/useFigmaFrameStyles/useFigmaFrameStyles.ru.mdx

@@ -0,0 +1,33 @@
+import { Meta, Source } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/figma-ref/Composables/useFigmaFrameStyles - Управление стилями фреймов'/>
+
+# `useFigmaFrameStyles`
+
+Композабл для управления и наблюдения за стилями фреймов из Figma.
+
+**Возвращает:**
+- `styles: ComputedRef<UiFigmaFrameStylesMessengerResponse>` — Реактивный список стилей фреймов.
+- `send(attributes: UiFigmaFrameStylesMessengerAttributes): void` — Метод для отправки запроса на получение или обновление стилей конкретных узлов.
+
+## Примеры
+
+```vue
+<script setup lang="ts">
+import { useFigmaFrameStyles } from '@dxtmisha/figma-ref'
+
+const { styles, send } = useFigmaFrameStyles()
+
+// Запрос стилей для конкретных нод
+const updateStyles = () => {
+  send({ ids: ['1:10', '1:20'], children: true })
+}
+</script>
+
+<template>
+  <div>
+    <button @click="updateStyles">Обновить стили</button>
+    <pre>{{ styles }}</pre>
+  </div>
+</template>
+```

package/src/media/functional/figma-ref/composables/useFigmaFrameStyles/useFigmaFrameStyles.vi.mdx

@@ -0,0 +1,33 @@
+import { Meta, Source } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/figma-ref/Composables/useFigmaFrameStyles - Quản lý style của frame'/>
+
+# `useFigmaFrameStyles`
+
+Một composable để quản lý và quan sát các style của frame từ Figma.
+
+**Trả về:**
+- `styles: ComputedRef<UiFigmaFrameStylesMessengerResponse>` — Danh sách phản hồi các style của frame.
+- `send(attributes: UiFigmaFrameStylesMessengerAttributes): void` — Phương thức để gửi yêu cầu lấy hoặc cập nhật style cho các node cụ thể.
+
+## Ví dụ
+
+```vue
+<script setup lang="ts">
+import { useFigmaFrameStyles } from '@dxtmisha/figma-ref'
+
+const { styles, send } = useFigmaFrameStyles()
+
+// Yêu cầu style cho các node cụ thể
+const updateStyles = () => {
+  send({ ids: ['1:10', '1:20'], children: true })
+}
+</script>
+
+<template>
+  <div>
+    <button @click="updateStyles">Cập nhật Styles</button>
+    <pre>{{ styles }}</pre>
+  </div>
+</template>
+```

package/src/media/functional/figma-ref/composables/useFigmaStorage/useFigmaStorage.en.mdx

@@ -0,0 +1,28 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/figma-ref/Composables/useFigmaStorage - Document storage management'/>
+
+# `useFigmaStorage`
+
+A reactive wrapper for Figma's shared storage (PluginData). It synchronizes a Vue `shallowRef` with data stored within the Figma document (either globally or on a specific node), enabling shared persistent data across all users of the file.
+
+**Parameters:**
+- `name: string` — The key name in the plugin storage.
+- `defaultValue?: T` — The default value if no data is found in storage.
+- `id?: string` — (Optional) The identifier (ID) of the node to attach the storage to. If not provided, the document root is used.
+
+**Returns:**
+- `item: Ref<T | undefined>` — A reactive reference to the stored value.
+- `loading: Ref<boolean>` — A reactive boolean indicating if the initial fetch is in progress.
+
+## Usage Example
+
+```typescript
+import { useFigmaStorage } from '@dxtmisha/figma-ref'
+
+// Access document-level storage
+const { item: projectConfig, loading } = useFigmaStorage('project-config', { version: '1.0' })
+
+// Updates are automatically saved to Figma's PluginData
+projectConfig.value.version = '1.1'
+```

package/src/media/functional/figma-ref/composables/useFigmaStorage/useFigmaStorage.ru.mdx

@@ -0,0 +1,28 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/figma-ref/Composables/useFigmaStorage - Управление хранилищем документа'/>
+
+# `useFigmaStorage`
+
+Реактивная обертка для общего хранилища Figma (PluginData). Она синхронизирует Vue `shallowRef` с данными, хранящимися внутри документа Figma (глобально или на конкретном узле), обеспечивая общий доступ к данным для всех пользователей файла.
+
+**Параметры:**
+- `name: string` — название ключа в хранилище плагина.
+- `defaultValue?: T` — значение по умолчанию, если в хранилище ничего не найдено.
+- `id?: string` — (Опционально) идентификатор (ID) узла, к которому привязано хранилище. Если не указан, используется корень документа.
+
+**Возвращает:**
+- `item: Ref<T | undefined>` — реактивная ссылка на сохраненное значение.
+- `loading: Ref<boolean>` — реактивный флаг, указывающий на процесс первичного получения данных.
+
+## Пример использования
+
+```typescript
+import { useFigmaStorage } from '@dxtmisha/figma-ref'
+
+// Доступ к хранилищу на уровне документа
+const { item: projectConfig, loading } = useFigmaStorage('project-config', { version: '1.0' })
+
+// Изменения автоматически сохраняются в PluginData Figma
+projectConfig.value.version = '1.1'
+```

package/src/media/functional/figma-ref/composables/useFigmaStorage/useFigmaStorage.vi.mdx

@@ -0,0 +1,28 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/figma-ref/Composables/useFigmaStorage - Quản lý bộ nhớ tài liệu'/>
+
+# `useFigmaStorage`
+
+Một lớp bọc phản hồi cho bộ nhớ chung của Figma (PluginData). Nó đồng bộ hóa một Vue `shallowRef` với dữ liệu được lưu trữ bên trong tài liệu Figma (toàn cục hoặc trên một node cụ thể), cho phép chia sẻ dữ liệu bền vững giữa tất cả người dùng của tệp.
+
+**Tham số:**
+- `name: string` — Tên khóa trong bộ nhớ plugin.
+- `defaultValue?: T` — Giá trị mặc định nếu không tìm thấy dữ liệu trong bộ nhớ.
+- `id?: string` — (Tùy chọn) Định danh (ID) của node để đính kèm bộ nhớ. Nếu không được cung cấp, gốc tài liệu sẽ được sử dụng.
+
+**Trả về:**
+- `item: Ref<T | undefined>` — Một tham chiếu phản hồi đến giá trị được lưu trữ.
+- `loading: Ref<boolean>` — Một giá trị logic phản hồi cho biết liệu quá trình lấy dữ liệu ban đầu có đang diễn ra hay không.
+
+## Ví dụ sử dụng
+
+```typescript
+import { useFigmaStorage } from '@dxtmisha/figma-ref'
+
+// Truy cập bộ nhớ cấp tài liệu
+const { item: projectConfig, loading } = useFigmaStorage('project-config', { version: '1.0' })
+
+// Các cập nhật sẽ tự động được lưu vào PluginData của Figma
+projectConfig.value.version = '1.1'
+```

package/src/media/functional/figma-ref/composables/useFigmaUiFrames/useFigmaUiFrames.en.mdx

@@ -1,26 +1,21 @@
 import { Meta } from '@storybook/addon-docs/blocks'
 
-<Meta title='@dxtmisha/en/figma-ref/Composables/useFigmaUiFrames - List of top-level frames'/>
+<Meta title='@dxtmisha/en/figma-ref/Composables/useFigmaUiFrames - Observing top-level frames'/>
 
 # `useFigmaUiFrames`
 
-Composable for managing and observing the list of top-level frames in the Figma UI.
+A composable for retrieving and observing the list of top-level frames and sections from the current Figma page. It uses global caching to ensure data consistency across multiple component instances.
 
 **Returns:**
-An object with the following properties:
-- `frames: ComputedRef<UiFigmaFramesList>` — A reactive list of top-level frames. Automatically updates when data is received.
-- `loading: ComputedRef<boolean>` — A reactive flag indicating whether the frames are currently being fetched from the Figma plugin.
+- `frames: ComputedRef<UiFigmaFramesList>` — A computed reference to the list of top-level frames (names, IDs, and screenshots).
+- `loading: ComputedRef<boolean>` — A reactive flag indicating if the frame list is being fetched.
+
+## Usage Example
 
 ```typescript
 import { useFigmaUiFrames } from '@dxtmisha/figma-ref'
 
 const { frames, loading } = useFigmaUiFrames()
 
-// Use loading to show a progress indicator
-if (loading.value) {
-  console.log('Fetching frames...')
-}
-
-// Use frames to render the list
-console.log('Frames:', frames.value)
+// 'frames' contains a list of frame objects with visual previews
 ```

package/src/media/functional/figma-ref/composables/useFigmaUiFrames/useFigmaUiFrames.ru.mdx

@@ -1,26 +1,21 @@
 import { Meta } from '@storybook/addon-docs/blocks'
 
-<Meta title='@dxtmisha/ru/figma-ref/Composables/useFigmaUiFrames - Список фреймов верхнего уровня'/>
+<Meta title='@dxtmisha/ru/figma-ref/Composables/useFigmaUiFrames - Наблюдение за фреймами верхнего уровня'/>
 
 # `useFigmaUiFrames`
 
-Композабл для управления и наблюдения за списком фреймов верхнего уровня в UI Figma.
+Composable для получения и наблюдения за списком фреймов и секций верхнего уровня на текущей странице Figma. Использует глобальное кэширование для обеспечения согласованности данных между несколькими экземплярами компонентов.
 
 **Возвращает:**
-Объект со следующими свойствами:
-- `frames: ComputedRef<UiFigmaFramesList>` — Реактивный список фреймов верхнего уровня. Автоматически обновляется при получении данных.
-- `loading: ComputedRef<boolean>` — Реактивный флаг, указывающий, загружаются ли в данный момент фреймы из плагина Figma.
+- `frames: ComputedRef<UiFigmaFramesList>` — вычисляемая ссылка на список фреймов (имена, ID и скриншоты).
+- `loading: ComputedRef<boolean>` — реактивный флаг, указывающий на процесс получения списка фреймов.
+
+## Пример использования
 
 ```typescript
 import { useFigmaUiFrames } from '@dxtmisha/figma-ref'
 
 const { frames, loading } = useFigmaUiFrames()
 
-// Используйте loading для отображения индикатора прогресса
-if (loading.value) {
-  console.log('Загрузка фреймов...')
-}
-
-// Используйте frames для рендеринга списка
-console.log('Фреймы:', frames.value)
+// 'frames' содержит список объектов фреймов с визуальным предпросмотром
 ```

package/src/media/functional/figma-ref/composables/useFigmaUiFrames/useFigmaUiFrames.vi.mdx

@@ -1,26 +1,21 @@
 import { Meta } from '@storybook/addon-docs/blocks'
 
-<Meta title='@dxtmisha/vi/figma-ref/Composables/useFigmaUiFrames - Danh sách các frame cấp cao nhất'/>
+<Meta title='@dxtmisha/vi/figma-ref/Composables/useFigmaUiFrames - Quan sát các frame cấp cao nhất'/>
 
 # `useFigmaUiFrames`
 
-Composable để quản lý và theo dõi danh sách các frame cấp cao nhất trong Figma UI.
+Một composable để truy xuất và quan sát danh sách các frame và section cấp cao nhất từ trang Figma hiện tại. Nó sử dụng cơ chế cache toàn cục để đảm bảo tính nhất quán của dữ liệu giữa nhiều thực thể component khác nhau.
 
-**Giá trị trả về:**
-Một đối tượng với các thuộc tính sau:
-- `frames: ComputedRef<UiFigmaFramesList>` — Một danh sách reactivity chứa các frame cấp cao nhất. Tự động cập nhật khi nhận được dữ liệu.
-- `loading: ComputedRef<boolean>` — Một biến reactivity cho biết các frame có đang được lấy từ plugin Figma hay không.
+**Trả về:**
+- `frames: ComputedRef<UiFigmaFramesList>` — Một tham chiếu được tính toán đến danh sách các frame cấp cao nhất (tên, ID và ảnh chụp màn hình).
+- `loading: ComputedRef<boolean>` — Một cờ phản hồi cho biết liệu danh sách frame có đang được lấy hay không.
+
+## Ví dụ sử dụng
 
 ```typescript
 import { useFigmaUiFrames } from '@dxtmisha/figma-ref'
 
 const { frames, loading } = useFigmaUiFrames()
 
-// Sử dụng loading để hiển thị chỉ báo tiến trình
-if (loading.value) {
-  console.log('Đang lấy danh sách frame...')
-}
-
-// Sử dụng frames để hiển thị danh sách
-console.log('Danh sách frame:', frames.value)
+// 'frames' chứa một danh sách các đối tượng frame với bản xem trước hình ảnh
 ```

package/src/media/functional/figma-ref/composables/useFigmaUiSelected/useFigmaUiSelected.en.mdx

@@ -1,32 +1,27 @@
 import { Meta } from '@storybook/addon-docs/blocks'
 
-<Meta title='@dxtmisha/en/figma-ref/Composables/useFigmaUiSelected - Selected frames'/>
+<Meta title='@dxtmisha/en/figma-ref/Composables/useFigmaUiSelected - Managing selected frames in UI'/>
 
 # `useFigmaUiSelected`
 
-Composable for managing and observing the list of selected frames in the Figma UI.
+A composable for managing and observing the list of frame identifiers selected by the user within the plugin's interface. It provides tools for checking selection state and toggling selections.
 
 **Returns:**
-An object with the following properties:
-- `selected: ComputedRef<string[]>` — A reactive list of selected frame IDs. Automatically updates when selection changes in Figma.
-- `loading: ComputedRef<boolean>` — A reactive flag indicating whether the selection data is currently being fetched from the Figma plugin.
-- `isSelected(id: string): ComputedRef<boolean>` — A function that returns a reactive boolean indicating if a specific frame ID is currently selected.
-- `toggleSelected(id: string, selected: boolean): void` — A function to update the selection state of a frame in Figma.
+- `selected: ComputedRef<string[]>` — A computed reference to the list of selected frame IDs.
+- `loading: ComputedRef<boolean>` — A reactive flag indicating if the selection list is being fetched.
+- `isSelected(id: string): ComputedRef<boolean>` — A helper function that returns a computed boolean indicating if a specific frame is selected.
+- `toggleSelected(id: string, selected: boolean): void` — A function to add or remove a frame from the selection list.
+
+## Usage Example
 
 ```typescript
 import { useFigmaUiSelected } from '@dxtmisha/figma-ref'
 
-const { selected, loading, isSelected, toggleSelected } = useFigmaUiSelected()
+const { selected, isSelected, toggleSelected } = useFigmaUiSelected()
 
-// Check if a specific frame is selected
-const frameId = '123:456'
-const isFrameSelected = isSelected(frameId)
+// Check if a frame is selected
+const active = isSelected('1:123')
 
 // Toggle selection
-const handleToggle = () => {
-  toggleSelected(frameId, !isFrameSelected.value)
-}
-
-// Watch for selection changes
-console.log('Currently selected IDs:', selected.value)
+toggleSelected('1:123', !active.value)
 ```

package/src/media/functional/figma-ref/composables/useFigmaUiSelected/useFigmaUiSelected.ru.mdx

@@ -1,32 +1,27 @@
 import { Meta } from '@storybook/addon-docs/blocks'
 
-<Meta title='@dxtmisha/ru/figma-ref/Composables/useFigmaUiSelected - Выбранные фреймы'/>
+<Meta title='@dxtmisha/ru/figma-ref/Composables/useFigmaUiSelected - Управление выбранными фреймами в UI'/>
 
 # `useFigmaUiSelected`
 
-Композабл для управления и наблюдения за списком выбранных фреймов в интерфейсе Figma.
+Composable для управления и наблюдения за списком идентификаторов фреймов, выбранных пользователем в интерфейсе плагина. Предоставляет инструменты для проверки состояния выбора и переключения выделения.
 
 **Возвращает:**
-Объект со следующими свойствами:
-- `selected: ComputedRef<string[]>` — Реактивный список ID выбранных фреймов. Автоматически обновляется при изменении выбора в Figma.
-- `loading: ComputedRef<boolean>` — Реактивный флаг, указывающий, загружаются ли в данный момент данные о выборе из плагина Figma.
-- `isSelected(id: string): ComputedRef<boolean>` — Функция, возвращающая реактивное логическое значение, указывающее, выбран ли в данный момент конкретный ID фрейма.
-- `toggleSelected(id: string, selected: boolean): void` — Функция для обновления состояния выбора фрейма в Figma.
+- `selected: ComputedRef<string[]>` — вычисляемая ссылка на список ID выбранных фреймов.
+- `loading: ComputedRef<boolean>` — реактивный флаг, указывающий на процесс получения списка выбранных фреймов.
+- `isSelected(id: string): ComputedRef<boolean>` — вспомогательная функция, возвращающая вычисляемое логическое значение (выбран ли фрейм).
+- `toggleSelected(id: string, selected: boolean): void` — функция для добавления или удаления фрейма из списка выбора.
+
+## Пример использования
 
 ```typescript
 import { useFigmaUiSelected } from '@dxtmisha/figma-ref'
 
-const { selected, loading, isSelected, toggleSelected } = useFigmaUiSelected()
-
-// Проверка, выбран ли конкретный фрейм
-const frameId = '123:456'
-const isFrameSelected = isSelected(frameId)
+const { selected, isSelected, toggleSelected } = useFigmaUiSelected()
 
-// Переключение выбора
-const handleToggle = () => {
-  toggleSelected(frameId, !isFrameSelected.value)
-}
+// Проверка, выбран ли фрейм
+const active = isSelected('1:123')
 
-// Наблюдение за изменениями выбора
-console.log('Текущие ID выбранных фреймов:', selected.value)
+// Переключение состояния выбора
+toggleSelected('1:123', !active.value)
 ```

package/src/media/functional/figma-ref/composables/useFigmaUiSelected/useFigmaUiSelected.vi.mdx

@@ -1,32 +1,27 @@
 import { Meta } from '@storybook/addon-docs/blocks'
 
-<Meta title='@dxtmisha/vi/figma-ref/Composables/useFigmaUiSelected - Các frame được chọn'/>
+<Meta title='@dxtmisha/vi/figma-ref/Composables/useFigmaUiSelected - Quản lý các frame được chọn trong UI'/>
 
 # `useFigmaUiSelected`
 
-Composable để quản lý và theo dõi danh sách các frame được chọn trong Figma UI.
+Một composable để quản lý và quan sát danh sách các định danh frame được người dùng chọn trong giao diện của plugin. Nó cung cấp các công cụ để kiểm tra trạng thái lựa chọn và chuyển đổi các lựa chọn.
 
-**Giá trị trả về:**
-Một đối tượng với các thuộc tính sau:
-- `selected: ComputedRef<string[]>` — Một danh sách reactivity chứa các ID của frame được chọn. Tự động cập nhật khi lựa chọn thay đổi trong Figma.
-- `loading: ComputedRef<boolean>` — Một biến reactivity cho biết dữ liệu lựa chọn có đang được lấy từ plugin Figma hay không.
-- `isSelected(id: string): ComputedRef<boolean>` — Một hàm trả về giá trị boolean reactivity cho biết một ID frame cụ thể có đang được chọn hay không.
-- `toggleSelected(id: string, selected: boolean): void` — Một hàm để cập nhật trạng thái chọn của một frame trong Figma.
+**Trả về:**
+- `selected: ComputedRef<string[]>` — Một tham chiếu được tính toán đến danh sách các ID frame được chọn.
+- `loading: ComputedRef<boolean>` — Một cờ phản hồi cho biết liệu danh sách lựa chọn có đang được lấy hay không.
+- `isSelected(id: string): ComputedRef<boolean>` — Một hàm hỗ trợ trả về một giá trị logic được tính toán cho biết liệu một frame cụ thể có được chọn hay không.
+- `toggleSelected(id: string, selected: boolean): void` — Một hàm để thêm hoặc xóa một frame khỏi danh sách lựa chọn.
+
+## Ví dụ sử dụng
 
 ```typescript
 import { useFigmaUiSelected } from '@dxtmisha/figma-ref'
 
-const { selected, loading, isSelected, toggleSelected } = useFigmaUiSelected()
-
-// Kiểm tra xem một frame cụ thể có được chọn không
-const frameId = '123:456'
-const isFrameSelected = isSelected(frameId)
+const { selected, isSelected, toggleSelected } = useFigmaUiSelected()
 
-// Chuyển đổi trạng thái chọn
-const handleToggle = () => {
-  toggleSelected(frameId, !isFrameSelected.value)
-}
+// Kiểm tra xem một frame có được chọn không
+const active = isSelected('1:123')
 
-// Theo dõi các ID hiện đang được chọn
-console.log('Các ID hiện đang được chọn:', selected.value)
+// Chuyển đổi trạng thái lựa chọn
+toggleSelected('1:123', !active.value)
 ```

package/src/media/functional/functional/composables/useApiAsyncRef/useApiAsyncRef.en.mdx

@@ -6,12 +6,11 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 `useApiAsyncRef` is an asynchronous wrapper over [`useApiRef`](./useApiRef.en.mdx) that performs immediate request initialization.
 
-Unlike the standard `useApiRef`, which is initialized "lazily" (on the first data access), this method calls `init()` immediately.
+Unlike the standard `useApiRef`, which is initialized "lazily" (on the first data access), this method calls `initSsr()` immediately.
 
 ## Key Features
 - **Immediate Initialization** — triggers the request as soon as the composable is called.
-- **Synchronous Recovery** — if the data is already in the cache, it is recovered synchronously before any asynchronous actions start.
-- **SSR Support** — utilizes `onServerPrefetch` to ensure data availability before rendering.
+- **SSR Support** — ensures data availability before rendering on the server.
 
 ## Parameters
 The parameters are identical to `useApiRef`.

package/src/media/functional/functional/composables/useApiAsyncRef/useApiAsyncRef.ru.mdx

@@ -6,12 +6,11 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 `useApiAsyncRef` — это асинхронная обертка над [`useApiRef`](./useApiRef.ru.mdx), которая выполняет немедленную инициализацию запроса.
 
-В отличие от стандартного `useApiRef`, который инициализируется "лениво" (при первом обращении к данным), этот метод вызывает `init()` сразу.
+В отличие от стандартного `useApiRef`, который инициализируется "лениво" (при первом обращении к данным), этот метод вызывает `initSsr()` сразу.
 
 ## Ключевые особенности
 - **Немедленная инициализация** — запускает запрос сразу при вызове хука.
-- **Синхронное восстановление** — если данные уже есть в кэше, они восстанавливаются синхронно до начала любых асинхронных действий.
-- **Поддержка SSR** — использует `onServerPrefetch` для гарантии получения данных при серверном рендеринге.
+- **Поддержка SSR** — гарантирует наличие данных перед рендерингом страницы на сервере.
 
 ## Параметры
 Параметры полностью идентичны `useApiRef`.

package/src/media/functional/functional/composables/useApiAsyncRef/useApiAsyncRef.vi.mdx

@@ -6,12 +6,11 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 `useApiAsyncRef` là một wrapper bất đồng bộ phía trên [`useApiRef`](./useApiRef.vi.mdx), thực hiện việc khởi tạo yêu cầu ngay lập tức.
 
-Khác với `useApiRef` tiêu chuẩn, vốn được khởi tạo "lười" (chỉ khi truy cập dữ liệu lần đầu), phương thức này gọi `init()` ngay lập tức.
+Khác với `useApiRef` tiêu chuẩn, vốn được khởi tạo "lười" (chỉ khi truy cập dữ liệu lần đầu), phương thức này gọi `initSsr()` ngay lập tức.
 
 ## Các tính năng chính
 - **Khởi tạo ngay lập tức** — kích hoạt yêu cầu ngay khi composable được gọi.
-- **Phục hồi đồng bộ** — nếu dữ liệu đã có trong cache, nó sẽ được phục hồi đồng bộ trước khi bắt đầu bất kỳ hành động không đồng bộ nào.
-- **Hỗ trợ SSR** — sử dụng `onServerPrefetch` để đảm bảo có dữ liệu trước khi render.
+- **Hỗ trợ SSR** — đảm bảo có dữ liệu trước khi render trang trên máy chủ.
 
 ## Tham số
 Các tham số hoàn toàn giống với `useApiRef`.

package/src/media/functional/functional/composables/useApiManagementRef/useApiManagementAsyncRef.en.mdx

@@ -0,0 +1,41 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional/Composables/useApiManagementAsyncRef - Async API Management Initialization'/>
+
+# `useApiManagementAsyncRef`
+
+`useApiManagementAsyncRef` is an asynchronous wrapper for [`useApiManagementRef`](./useApiManagementRef.en.mdx) that performs immediate request initialization.
+
+Unlike the standard `useApiManagementRef`, which initializes "lazily" (upon the first access to the list or data), this method calls `initSsr()` immediately upon creation. This makes it the ideal choice for use in SSR environments.
+
+## Key Features
+- **Immediate Initialization** — starts the GET request initialization process as soon as the hook is called.
+- **SSR Support** — ensures data is loaded on the server before the page is sent to the client.
+- **Full Management Functionality** — retains all features of `useApiManagementRef`, including formatters, search, and mutations.
+
+## Parameters
+Parameters are identical to [`useApiManagementRef`](./useApiManagementRef.en.mdx):
+
+- `propsGet: ApiManagementGet<Return, Type>` — main GET request settings.
+- `formattersOptions?: FormattersOptions` — formatting rules.
+- `searchOptions?: ApiManagementSearch<Item, Columns>` — search settings.
+- `postRequest / putRequest / deleteRequest` — mutation settings.
+- `action?: function` — callback after mutation.
+- `apiInstance?: ApiInstance` — API instance.
+
+## Returns
+Returns an API management object. The return object structure is identical to [`useApiManagementRef`](./useApiManagementRef.en.mdx).
+
+## Example
+
+```typescript
+import { useApiManagementAsyncRef } from '@dxtmisha/functional'
+
+// Initialization (and SSR pre-fetching) starts immediately
+const { list, loading } = useApiManagementAsyncRef(
+  { 
+    path: 'api/products',
+    skeleton: () => Array(3).fill({ id: 0, title: 'Loading...' })
+  }
+)
+```

package/src/media/functional/functional/composables/useApiManagementRef/useApiManagementAsyncRef.ru.mdx

@@ -0,0 +1,41 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional/Composables/useApiManagementAsyncRef - Асинхронная инициализация управления API'/>
+
+# `useApiManagementAsyncRef`
+
+`useApiManagementAsyncRef` — это асинхронная обертка над [`useApiManagementRef`](./useApiManagementRef.ru.mdx), которая выполняет немедленную инициализацию запроса.
+
+В отличие от стандартного `useApiManagementRef`, который инициализируется "лениво" (при первом обращении к списку или данным), этот метод вызывает `initSsr()` сразу при создании. Это делает его идеальным выбором для использования в SSR-окружении.
+
+## Ключевые особенности
+- **Немедленная инициализация** — запускает процесс инициализации GET-запроса сразу при вызове хука.
+- **Поддержка SSR** — гарантирует, что данные будут загружены на сервере до рендеринга страницы.
+- **Полная функциональность Management** — сохраняет все возможности `useApiManagementRef`, включая форматировщики, поиск и мутации.
+
+## Параметры
+Параметры полностью идентичны [`useApiManagementRef`](./useApiManagementRef.ru.mdx):
+
+- `propsGet: ApiManagementGet<Return, Type>` — настройки главного GET-запроса.
+- `formattersOptions?: FormattersOptions` — правила форматирования.
+- `searchOptions?: ApiManagementSearch<Item, Columns>` — настройки поиска.
+- `postRequest / putRequest / deleteRequest` — настройки мутаций.
+- `action?: function` — коллбэк после мутации.
+- `apiInstance?: ApiInstance` — экземпляр API.
+
+## Возвращаемое значение
+Возвращает объект управления API. Состав возвращаемого значения полностью идентичен [`useApiManagementRef`](./useApiManagementRef.ru.mdx).
+
+## Пример
+
+```typescript
+import { useApiManagementAsyncRef } from '@dxtmisha/functional'
+
+// Инициализация (и SSR-предзагрузка) запускается немедленно
+const { list, loading } = useApiManagementAsyncRef(
+  { 
+    path: 'api/products',
+    skeleton: () => Array(3).fill({ id: 0, title: 'Loading...' })
+  }
+)
+```