@dxtmisha/wiki 0.57.3 → 0.57.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (151) hide show
  1. package/dist/{defineProperty-3CuEayIP.js → defineProperty-Dcl1xgfx.js} +4 -4
  2. package/dist/library.js +1 -1
  3. package/dist/storybook.js +1 -1
  4. package/package.json +1 -1
  5. package/src/media/functional/figma/classes/FigmaPostAbstract/FigmaPostAbstract.en.mdx +46 -0
  6. package/src/media/functional/figma/classes/FigmaPostAbstract/FigmaPostAbstract.ru.mdx +46 -0
  7. package/src/media/functional/figma/classes/FigmaPostAbstract/FigmaPostAbstract.vi.mdx +46 -0
  8. package/src/media/functional/figma/classes/FigmaPostCode/FigmaPostCode.en.mdx +3 -23
  9. package/src/media/functional/figma/classes/FigmaPostCode/FigmaPostCode.ru.mdx +3 -23
  10. package/src/media/functional/figma/classes/FigmaPostCode/FigmaPostCode.vi.mdx +3 -23
  11. package/src/media/functional/figma/functions/fetchClientStorage/fetchClientStorage.en.mdx +46 -0
  12. package/src/media/functional/figma/functions/fetchClientStorage/fetchClientStorage.ru.mdx +46 -0
  13. package/src/media/functional/figma/functions/fetchClientStorage/fetchClientStorage.vi.mdx +46 -0
  14. package/src/media/functional/figma/functions/fetchFrameSelection/fetchFrameSelection.en.mdx +34 -0
  15. package/src/media/functional/figma/functions/fetchFrameSelection/fetchFrameSelection.ru.mdx +34 -0
  16. package/src/media/functional/figma/functions/fetchFrameSelection/fetchFrameSelection.vi.mdx +34 -0
  17. package/src/media/functional/figma/functions/fetchFrameStyles/fetchFrameStyles.en.mdx +49 -0
  18. package/src/media/functional/figma/functions/fetchFrameStyles/fetchFrameStyles.ru.mdx +49 -0
  19. package/src/media/functional/figma/functions/fetchFrameStyles/fetchFrameStyles.vi.mdx +49 -0
  20. package/src/media/functional/figma/functions/fetchFramesSelected/fetchFramesSelected.en.mdx +19 -8
  21. package/src/media/functional/figma/functions/fetchFramesSelected/fetchFramesSelected.ru.mdx +18 -7
  22. package/src/media/functional/figma/functions/fetchFramesSelected/fetchFramesSelected.vi.mdx +19 -8
  23. package/src/media/functional/figma/functions/fetchStorage/fetchStorage.en.mdx +42 -0
  24. package/src/media/functional/figma/functions/fetchStorage/fetchStorage.ru.mdx +42 -0
  25. package/src/media/functional/figma/functions/fetchStorage/fetchStorage.vi.mdx +42 -0
  26. package/src/media/functional/figma/functions/fetchTopLevelFrames/fetchTopLevelFrames.en.mdx +29 -7
  27. package/src/media/functional/figma/functions/fetchTopLevelFrames/fetchTopLevelFrames.ru.mdx +28 -6
  28. package/src/media/functional/figma/functions/fetchTopLevelFrames/fetchTopLevelFrames.vi.mdx +29 -7
  29. package/src/media/functional/figma/functions/sendClientStorage/sendClientStorage.en.mdx +29 -0
  30. package/src/media/functional/figma/functions/sendClientStorage/sendClientStorage.ru.mdx +29 -0
  31. package/src/media/functional/figma/functions/sendClientStorage/sendClientStorage.vi.mdx +29 -0
  32. package/src/media/functional/figma/functions/sendFrameSelection/sendFrameSelection.en.mdx +28 -0
  33. package/src/media/functional/figma/functions/sendFrameSelection/sendFrameSelection.ru.mdx +28 -0
  34. package/src/media/functional/figma/functions/sendFrameSelection/sendFrameSelection.vi.mdx +28 -0
  35. package/src/media/functional/figma/functions/sendFrameStyles/sendFrameStyles.en.mdx +40 -0
  36. package/src/media/functional/figma/functions/sendFrameStyles/sendFrameStyles.ru.mdx +40 -0
  37. package/src/media/functional/figma/functions/sendFrameStyles/sendFrameStyles.vi.mdx +40 -0
  38. package/src/media/functional/figma/functions/sendFramesSelected/sendFramesSelected.en.mdx +29 -0
  39. package/src/media/functional/figma/functions/sendFramesSelected/sendFramesSelected.ru.mdx +29 -0
  40. package/src/media/functional/figma/functions/sendFramesSelected/sendFramesSelected.vi.mdx +29 -0
  41. package/src/media/functional/figma/functions/sendStorage/sendStorage.en.mdx +30 -0
  42. package/src/media/functional/figma/functions/sendStorage/sendStorage.ru.mdx +30 -0
  43. package/src/media/functional/figma/functions/sendStorage/sendStorage.vi.mdx +30 -0
  44. package/src/media/functional/figma-code/classes/FigmaClientStorage/FigmaClientStorage.en.mdx +64 -0
  45. package/src/media/functional/figma-code/classes/FigmaClientStorage/FigmaClientStorage.ru.mdx +64 -0
  46. package/src/media/functional/figma-code/classes/FigmaClientStorage/FigmaClientStorage.vi.mdx +64 -0
  47. package/src/media/functional/figma-code/classes/FigmaFrame/FigmaFrame.en.mdx +168 -35
  48. package/src/media/functional/figma-code/classes/FigmaFrame/FigmaFrame.ru.mdx +168 -35
  49. package/src/media/functional/figma-code/classes/FigmaFrame/FigmaFrame.vi.mdx +168 -35
  50. package/src/media/functional/figma-code/classes/FigmaFramesSelected/FigmaFramesSelected.en.mdx +23 -69
  51. package/src/media/functional/figma-code/classes/FigmaFramesSelected/FigmaFramesSelected.ru.mdx +22 -68
  52. package/src/media/functional/figma-code/classes/FigmaFramesSelected/FigmaFramesSelected.vi.mdx +23 -69
  53. package/src/media/functional/figma-code/classes/FigmaItem/FigmaItem.en.mdx +79 -56
  54. package/src/media/functional/figma-code/classes/FigmaItem/FigmaItem.ru.mdx +79 -56
  55. package/src/media/functional/figma-code/classes/FigmaItem/FigmaItem.vi.mdx +79 -56
  56. package/src/media/functional/figma-code/classes/FigmaPluginMessenger/FigmaPluginMessenger.en.mdx +18 -48
  57. package/src/media/functional/figma-code/classes/FigmaPluginMessenger/FigmaPluginMessenger.ru.mdx +18 -48
  58. package/src/media/functional/figma-code/classes/FigmaPluginMessenger/FigmaPluginMessenger.vi.mdx +18 -48
  59. package/src/media/functional/figma-code/classes/FigmaStorage/FigmaStorage.en.mdx +22 -67
  60. package/src/media/functional/figma-code/classes/FigmaStorage/FigmaStorage.ru.mdx +22 -67
  61. package/src/media/functional/figma-code/classes/FigmaStorage/FigmaStorage.vi.mdx +22 -67
  62. package/src/media/functional/figma-code/classes/FigmaStorageData/FigmaStorageData.en.mdx +57 -0
  63. package/src/media/functional/figma-code/classes/FigmaStorageData/FigmaStorageData.ru.mdx +57 -0
  64. package/src/media/functional/figma-code/classes/FigmaStorageData/FigmaStorageData.vi.mdx +57 -0
  65. package/src/media/functional/figma-code/classes/FigmaTopLevelFrames/FigmaTopLevelFrames.en.mdx +24 -27
  66. package/src/media/functional/figma-code/classes/FigmaTopLevelFrames/FigmaTopLevelFrames.ru.mdx +23 -26
  67. package/src/media/functional/figma-code/classes/FigmaTopLevelFrames/FigmaTopLevelFrames.vi.mdx +24 -27
  68. package/src/media/functional/figma-code/functions/getFigmaFrameById/getFigmaFrameById.en.mdx +28 -0
  69. package/src/media/functional/figma-code/functions/getFigmaFrameById/getFigmaFrameById.ru.mdx +28 -0
  70. package/src/media/functional/figma-code/functions/getFigmaFrameById/getFigmaFrameById.vi.mdx +28 -0
  71. package/src/media/functional/figma-code/functions/getFigmaItemById/getFigmaItemById.en.mdx +43 -0
  72. package/src/media/functional/figma-code/functions/getFigmaItemById/getFigmaItemById.ru.mdx +43 -0
  73. package/src/media/functional/figma-code/functions/getFigmaItemById/getFigmaItemById.vi.mdx +43 -0
  74. package/src/media/functional/figma-code/functions/getFigmaItemByIdOrRoot/getFigmaItemByIdOrRoot.en.mdx +30 -0
  75. package/src/media/functional/figma-code/functions/getFigmaItemByIdOrRoot/getFigmaItemByIdOrRoot.ru.mdx +30 -0
  76. package/src/media/functional/figma-code/functions/getFigmaItemByIdOrRoot/getFigmaItemByIdOrRoot.vi.mdx +30 -0
  77. package/src/media/functional/figma-code/functions/makeFigmaFrameSelection/makeFigmaFrameSelection.en.mdx +21 -0
  78. package/src/media/functional/figma-code/functions/makeFigmaFrameSelection/makeFigmaFrameSelection.ru.mdx +21 -0
  79. package/src/media/functional/figma-code/functions/makeFigmaFrameSelection/makeFigmaFrameSelection.vi.mdx +21 -0
  80. package/src/media/functional/figma-code/functions/makeFigmaTexts/makeFigmaTexts.en.mdx +28 -0
  81. package/src/media/functional/figma-code/functions/makeFigmaTexts/makeFigmaTexts.ru.mdx +28 -0
  82. package/src/media/functional/figma-code/functions/makeFigmaTexts/makeFigmaTexts.vi.mdx +28 -0
  83. package/src/media/functional/figma-code/functions/setupClientStorage/setupClientStorage.en.mdx +28 -0
  84. package/src/media/functional/figma-code/functions/setupClientStorage/setupClientStorage.ru.mdx +28 -0
  85. package/src/media/functional/figma-code/functions/setupClientStorage/setupClientStorage.vi.mdx +28 -0
  86. package/src/media/functional/figma-code/functions/setupFrameSelection/setupFrameSelection.en.mdx +22 -0
  87. package/src/media/functional/figma-code/functions/setupFrameSelection/setupFrameSelection.ru.mdx +22 -0
  88. package/src/media/functional/figma-code/functions/setupFrameSelection/setupFrameSelection.vi.mdx +22 -0
  89. package/src/media/functional/figma-code/functions/setupFrameStyles/setupFrameStyles.en.mdx +19 -0
  90. package/src/media/functional/figma-code/functions/setupFrameStyles/setupFrameStyles.ru.mdx +19 -0
  91. package/src/media/functional/figma-code/functions/setupFrameStyles/setupFrameStyles.vi.mdx +19 -0
  92. package/src/media/functional/figma-code/functions/setupStorage/setupStorage.en.mdx +28 -0
  93. package/src/media/functional/figma-code/functions/setupStorage/setupStorage.ru.mdx +28 -0
  94. package/src/media/functional/figma-code/functions/setupStorage/setupStorage.vi.mdx +28 -0
  95. package/src/media/functional/figma-code/functions/toFrameSelection/toFrameSelection.en.mdx +27 -0
  96. package/src/media/functional/figma-code/functions/toFrameSelection/toFrameSelection.ru.mdx +27 -0
  97. package/src/media/functional/figma-code/functions/toFrameSelection/toFrameSelection.vi.mdx +27 -0
  98. package/src/media/functional/figma-ref/composables/useFigmaClientStorage/useFigmaClientStorage.en.mdx +26 -0
  99. package/src/media/functional/figma-ref/composables/useFigmaClientStorage/useFigmaClientStorage.ru.mdx +26 -0
  100. package/src/media/functional/figma-ref/composables/useFigmaClientStorage/useFigmaClientStorage.vi.mdx +26 -0
  101. package/src/media/functional/figma-ref/composables/useFigmaFrameSelection/useFigmaFrameSelection.en.mdx +35 -0
  102. package/src/media/functional/figma-ref/composables/useFigmaFrameSelection/useFigmaFrameSelection.ru.mdx +35 -0
  103. package/src/media/functional/figma-ref/composables/useFigmaFrameSelection/useFigmaFrameSelection.vi.mdx +35 -0
  104. package/src/media/functional/figma-ref/composables/useFigmaFrameStyles/useFigmaFrameStyles.en.mdx +33 -0
  105. package/src/media/functional/figma-ref/composables/useFigmaFrameStyles/useFigmaFrameStyles.ru.mdx +33 -0
  106. package/src/media/functional/figma-ref/composables/useFigmaFrameStyles/useFigmaFrameStyles.vi.mdx +33 -0
  107. package/src/media/functional/figma-ref/composables/useFigmaStorage/useFigmaStorage.en.mdx +28 -0
  108. package/src/media/functional/figma-ref/composables/useFigmaStorage/useFigmaStorage.ru.mdx +28 -0
  109. package/src/media/functional/figma-ref/composables/useFigmaStorage/useFigmaStorage.vi.mdx +28 -0
  110. package/src/media/functional/figma-ref/composables/useFigmaUiFrames/useFigmaUiFrames.en.mdx +7 -12
  111. package/src/media/functional/figma-ref/composables/useFigmaUiFrames/useFigmaUiFrames.ru.mdx +7 -12
  112. package/src/media/functional/figma-ref/composables/useFigmaUiFrames/useFigmaUiFrames.vi.mdx +8 -13
  113. package/src/media/functional/figma-ref/composables/useFigmaUiSelected/useFigmaUiSelected.en.mdx +12 -17
  114. package/src/media/functional/figma-ref/composables/useFigmaUiSelected/useFigmaUiSelected.ru.mdx +13 -18
  115. package/src/media/functional/figma-ref/composables/useFigmaUiSelected/useFigmaUiSelected.vi.mdx +14 -19
  116. package/src/media/functional/functional/composables/useApiAsyncRef/useApiAsyncRef.en.mdx +2 -3
  117. package/src/media/functional/functional/composables/useApiAsyncRef/useApiAsyncRef.ru.mdx +2 -3
  118. package/src/media/functional/functional/composables/useApiAsyncRef/useApiAsyncRef.vi.mdx +2 -3
  119. package/src/media/functional/functional/composables/useApiManagementRef/useApiManagementAsyncRef.en.mdx +41 -0
  120. package/src/media/functional/functional/composables/useApiManagementRef/useApiManagementAsyncRef.ru.mdx +41 -0
  121. package/src/media/functional/functional/composables/useApiManagementRef/useApiManagementAsyncRef.vi.mdx +41 -0
  122. package/src/media/functional/functional/composables/useApiManagementRef/useApiManagementRef.en.mdx +12 -0
  123. package/src/media/functional/functional/composables/useApiManagementRef/useApiManagementRef.ru.mdx +12 -0
  124. package/src/media/functional/functional/composables/useApiManagementRef/useApiManagementRef.vi.mdx +6 -0
  125. package/src/media/functional/functional/composables/useApiRef/useApiRef.en.mdx +12 -9
  126. package/src/media/functional/functional/composables/useApiRef/useApiRef.ru.mdx +12 -9
  127. package/src/media/functional/functional/composables/useApiRef/useApiRef.vi.mdx +11 -9
  128. package/src/media/functional/nitro-basic/functions/getInject.en.mdx +27 -0
  129. package/src/media/functional/nitro-basic/functions/getInject.ru.mdx +27 -0
  130. package/src/media/functional/nitro-basic/functions/getInject.vi.mdx +20 -0
  131. package/src/media/functional/ui-figma/about/about.en.mdx +52 -0
  132. package/src/media/functional/ui-figma/about/about.ru.mdx +52 -0
  133. package/src/media/functional/ui-figma/about/about.vi.mdx +52 -0
  134. package/src/media/functional/ui-figma/frames/frames.en.mdx +58 -0
  135. package/src/media/functional/ui-figma/frames/frames.ru.mdx +58 -0
  136. package/src/media/functional/ui-figma/frames/frames.vi.mdx +58 -0
  137. package/src/media/functional/ui-figma/messenger/messenger.en.mdx +67 -0
  138. package/src/media/functional/ui-figma/messenger/messenger.ru.mdx +67 -0
  139. package/src/media/functional/ui-figma/messenger/messenger.vi.mdx +67 -0
  140. package/src/media/functional/ui-figma/selection/selection.en.mdx +65 -0
  141. package/src/media/functional/ui-figma/selection/selection.ru.mdx +65 -0
  142. package/src/media/functional/ui-figma/selection/selection.vi.mdx +65 -0
  143. package/src/media/functional/ui-figma/storage/storage.en.mdx +53 -0
  144. package/src/media/functional/ui-figma/storage/storage.ru.mdx +53 -0
  145. package/src/media/functional/ui-figma/storage/storage.vi.mdx +53 -0
  146. package/src/media/functional/ui-figma/styles/styles.en.mdx +57 -0
  147. package/src/media/functional/ui-figma/styles/styles.ru.mdx +57 -0
  148. package/src/media/functional/ui-figma/styles/styles.vi.mdx +57 -0
  149. /package/src/media/functional/ui/{wiki-data.en.mdx → wiki/wiki-data.en.mdx} +0 -0
  150. /package/src/media/functional/ui/{wiki-data.ru.mdx → wiki/wiki-data.ru.mdx} +0 -0
  151. /package/src/media/functional/ui/{wiki-data.vi.mdx → wiki/wiki-data.vi.mdx} +0 -0
@@ -0,0 +1,49 @@
1
+ import { Meta, Source } from '@storybook/addon-docs/blocks'
2
+
3
+ <Meta title='@dxtmisha/vi/figma/Functions/fetchFrameStyles - Lấy styles của frame'/>
4
+
5
+ # `fetchFrameStyles`
6
+
7
+ 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.
8
+
9
+ **Tham số:**
10
+ - `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.
11
+
12
+
13
+ **Trả về:**
14
+ `void`
15
+
16
+ ## Ví dụ
17
+
18
+ <Source
19
+ language='typescript'
20
+ code={`
21
+ import { fetchFrameStyles } from '@dxtmisha/figma'
22
+
23
+ // Lấy styles cho các frame và log kết quả
24
+ fetchFrameStyles((response) => {
25
+ response.forEach(item => {
26
+ console.log('Frame ID:', item.id)
27
+ console.log('Dữ liệu style:', item.data)
28
+ })
29
+ })
30
+ `}
31
+ />
32
+
33
+ ## Các kiểu dữ liệu
34
+
35
+ ### UiFigmaFrameStylesMessengerResponse
36
+ Một mảng các đối tượng `UiFigmaFrameStylesMessengerResponseItem`.
37
+
38
+ ### UiFigmaFrameStylesMessengerResponseItem
39
+ - `id: string` — Định danh duy nhất của frame.
40
+ - `data: UiFigmaFrameStylesList` — Danh sách dữ liệu style cho frame.
41
+
42
+ ### UiFigmaFrameStylesItem
43
+ Mở rộng từ `UiFigmaFramesItem`.
44
+ - `name: string` — Tên của frame.
45
+ - `id: string` — Định danh duy nhất của phần tử.
46
+ - `json?: UiFigmaFrameStylesData` — (Tùy chọn) Dữ liệu node thu gọn dưới định dạng JSON.
47
+ - `text?: string` — (Tùy chọn) Nội dung văn bản (đối với các node văn bản).
48
+ - `styles?: UiFigmaFrameStylesCssItem` — (Tùy chọn) Bản đồ các style CSS cho phần tử.
49
+ - `childrenStyles?: UiFigmaFrameStylesCssList` — (Tùy chọn) Bản đồ các style CSS của các phần tử con.
@@ -1,21 +1,32 @@
1
- import { Meta } from '@storybook/addon-docs/blocks'
1
+ import { Meta, Source } from '@storybook/addon-docs/blocks'
2
2
 
3
- <Meta title='@dxtmisha/en/figma/Functions/fetchFramesSelected - Fetching selected frames'/>
3
+ <Meta title='@dxtmisha/en/figma/Functions/fetchFramesSelected - Fetch selected frames'/>
4
4
 
5
5
  # `fetchFramesSelected`
6
6
 
7
- A utility that fetches the currently selected frames from the Figma plugin. It handles caching and prevents concurrent duplicate requests.
7
+ 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.
8
8
 
9
9
  **Parameters:**
10
- - `callback: (selected: string[]) => void` — The function to call once the selected frame IDs are received.
10
+ - `callback: (selected: string[]) => void` — The function executed once the list of selected frame IDs is received.
11
+
11
12
 
12
13
  **Returns:**
13
14
  `void`
14
15
 
15
- ```javascript
16
+ ## Examples
17
+
18
+ <Source
19
+ language='typescript'
20
+ code={`
16
21
  import { fetchFramesSelected } from '@dxtmisha/figma'
17
22
 
18
- fetchFramesSelected((selected) => {
19
- console.log('Selected frames:', selected)
23
+ // Fetch selected frames and log their IDs
24
+ fetchFramesSelected((selectedIds) => {
25
+ if (selectedIds.length === 0) {
26
+ console.log('No frames selected')
27
+ } else {
28
+ console.log('Selected frame IDs:', selectedIds)
29
+ }
20
30
  })
21
- ```
31
+ `}
32
+ />
@@ -1,21 +1,32 @@
1
- import { Meta } from '@storybook/addon-docs/blocks'
1
+ import { Meta, Source } from '@storybook/addon-docs/blocks'
2
2
 
3
3
  <Meta title='@dxtmisha/ru/figma/Functions/fetchFramesSelected - Получение выбранных фреймов'/>
4
4
 
5
5
  # `fetchFramesSelected`
6
6
 
7
- Утилита, которая запрашивает текущие выбранные фреймы из плагина Figma. Она поддерживает кэширование и предотвращает дублирование одновременных запросов.
7
+ Утилита для получения идентификаторов (ID) выбранных в данный момент фреймов в Figma. Обеспечивает связь между интерфейсом (UI) и основной частью плагина для доступа к текущему выбору пользователя.
8
8
 
9
9
  **Параметры:**
10
- - `callback: (selected: string[]) => void` — Функция, вызываемая после получения идентификаторов выбранных фреймов.
10
+ - `callback: (selected: string[]) => void` — Функция, которая будет вызвана после получения списка ID выбранных фреймов.
11
+
11
12
 
12
13
  **Возвращает:**
13
14
  `void`
14
15
 
15
- ```javascript
16
+ ## Примеры
17
+
18
+ <Source
19
+ language='typescript'
20
+ code={`
16
21
  import { fetchFramesSelected } from '@dxtmisha/figma'
17
22
 
18
- fetchFramesSelected((selected) => {
19
- console.log('Выбранные фреймы:', selected)
23
+ // Получить выбранные фреймы и вывести их ID в консоль
24
+ fetchFramesSelected((selectedIds) => {
25
+ if (selectedIds.length === 0) {
26
+ console.log('Фреймы не выбраны')
27
+ } else {
28
+ console.log('ID выбранных фреймов:', selectedIds)
29
+ }
20
30
  })
21
- ```
31
+ `}
32
+ />
@@ -1,21 +1,32 @@
1
- import { Meta } from '@storybook/addon-docs/blocks'
1
+ import { Meta, Source } from '@storybook/addon-docs/blocks'
2
2
 
3
- <Meta title='@dxtmisha/vi/figma/Functions/fetchFramesSelected - Lấy danh sách các frame đang chọn'/>
3
+ <Meta title='@dxtmisha/vi/figma/Functions/fetchFramesSelected - Lấy các frame đang được chọn'/>
4
4
 
5
5
  # `fetchFramesSelected`
6
6
 
7
- 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.
7
+ 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.
8
8
 
9
9
  **Tham số:**
10
- - `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.
10
+ - `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.
11
+
11
12
 
12
13
  **Trả về:**
13
14
  `void`
14
15
 
15
- ```javascript
16
+ ## Ví dụ
17
+
18
+ <Source
19
+ language='typescript'
20
+ code={`
16
21
  import { fetchFramesSelected } from '@dxtmisha/figma'
17
22
 
18
- fetchFramesSelected((selected) => {
19
- console.log('Các frame đang chọn:', selected)
23
+ // Lấy các frame được chọn và log ID của chúng
24
+ fetchFramesSelected((selectedIds) => {
25
+ if (selectedIds.length === 0) {
26
+ console.log('Không có frame nào được chọn')
27
+ } else {
28
+ console.log('ID các frame được chọn:', selectedIds)
29
+ }
20
30
  })
21
- ```
31
+ `}
32
+ />
@@ -0,0 +1,42 @@
1
+ import { Meta, Source } from '@storybook/addon-docs/blocks'
2
+
3
+ <Meta title='@dxtmisha/en/figma/Functions/fetchStorage - Fetch shared storage data'/>
4
+
5
+ # `fetchStorage`
6
+
7
+ 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).
8
+
9
+ **Parameters:**
10
+ - `name: string` — The name of the storage.
11
+ - `callback: (value: T) => void` — The function executed once the data is retrieved.
12
+ - `id?: string` — (Optional) An identifier to distinguish data within the same storage name.
13
+ - `defaultValue?: T` — (Optional) A default value returned if the storage key does not exist.
14
+ - `isOnce: boolean = true` — If `true`, the callback will be executed only once.
15
+
16
+ **Returns:**
17
+ `void`
18
+
19
+ ## Examples
20
+
21
+ <Source
22
+ language='typescript'
23
+ code={`
24
+ import { fetchStorage } from '@dxtmisha/figma'
25
+
26
+ // 1. Basic usage
27
+ fetchStorage<string>('project-status', (status) => {
28
+ console.log('Status:', status)
29
+ }, undefined, 'active')
30
+
31
+ // 2. Fetching data for a specific node
32
+ const nodeId = '12:34'
33
+ fetchStorage<object>('node-metadata', (data) => {
34
+ console.log('Node metadata:', data)
35
+ }, nodeId)
36
+
37
+ // 3. Persistent subscription
38
+ fetchStorage<number>('global-counter', (count) => {
39
+ console.log('Counter update:', count)
40
+ }, undefined, 0, false)
41
+ `}
42
+ />
@@ -0,0 +1,42 @@
1
+ import { Meta, Source } from '@storybook/addon-docs/blocks'
2
+
3
+ <Meta title='@dxtmisha/ru/figma/Functions/fetchStorage - Получение данных из общего хранилища'/>
4
+
5
+ # `fetchStorage`
6
+
7
+ Утилита для получения данных из общего хранилища Figma. В отличие от клиентского хранилища, эти данные могут быть связаны с конкретными идентификаторами (например, ID узлов) и доступны другим пользователям.
8
+
9
+ **Параметры:**
10
+ - `name: string` — Имя хранилища.
11
+ - `callback: (value: T) => void` — Функция, которая будет вызвана после получения данных.
12
+ - `id?: string` — (Опционально) Идентификатор для разделения данных (например, ID ноды).
13
+ - `defaultValue?: T` — (Опционально) Значение по умолчанию, если данные отсутствуют.
14
+ - `isOnce: boolean = true` — Если `true`, колбэк будет вызван только один раз.
15
+
16
+ **Возвращает:**
17
+ `void`
18
+
19
+ ## Примеры
20
+
21
+ <Source
22
+ language='typescript'
23
+ code={`
24
+ import { fetchStorage } from '@dxtmisha/figma'
25
+
26
+ // 1. Базовое использование
27
+ fetchStorage<string>('project-status', (status) => {
28
+ console.log('Статус:', status)
29
+ }, undefined, 'active')
30
+
31
+ // 2. Получение данных для конкретного узла (node)
32
+ const nodeId = '12:34'
33
+ fetchStorage<object>('node-metadata', (data) => {
34
+ console.log('Метаданные узла:', data)
35
+ }, nodeId)
36
+
37
+ // 3. Постоянная подписка
38
+ fetchStorage<number>('global-counter', (count) => {
39
+ console.log('Обновление счетчика:', count)
40
+ }, undefined, 0, false)
41
+ `}
42
+ />
@@ -0,0 +1,42 @@
1
+ import { Meta, Source } from '@storybook/addon-docs/blocks'
2
+
3
+ <Meta title='@dxtmisha/vi/figma/Functions/fetchStorage - Lấy dữ liệu từ bộ nhớ chung'/>
4
+
5
+ # `fetchStorage`
6
+
7
+ 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).
8
+
9
+ **Tham số:**
10
+ - `name: string` — Tên của bộ nhớ.
11
+ - `callback: (value: T) => void` — Hàm được thực thi sau khi dữ liệu được truy xuất.
12
+ - `id?: string` — (Tùy chọn) Định danh để phân biệt dữ liệu trong cùng một tên bộ nhớ.
13
+ - `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.
14
+ - `isOnce: boolean = true` — Nếu `true`, hàm callback sẽ chỉ được thực thi một lần.
15
+
16
+ **Trả về:**
17
+ `void`
18
+
19
+ ## Ví dụ
20
+
21
+ <Source
22
+ language='typescript'
23
+ code={`
24
+ import { fetchStorage } from '@dxtmisha/figma'
25
+
26
+ // 1. Cách sử dụng cơ bản
27
+ fetchStorage<string>('project-status', (status) => {
28
+ console.log('Trạng thái:', status)
29
+ }, undefined, 'active')
30
+
31
+ // 2. Lấy dữ liệu cho một node cụ thể
32
+ const nodeId = '12:34'
33
+ fetchStorage<object>('node-metadata', (data) => {
34
+ console.log('Metadata của node:', data)
35
+ }, nodeId)
36
+
37
+ // 3. Đăng ký nhận cập nhật liên tục
38
+ fetchStorage<number>('global-counter', (count) => {
39
+ console.log('Cập nhật bộ đếm:', count)
40
+ }, undefined, 0, false)
41
+ `}
42
+ />
@@ -1,21 +1,43 @@
1
- import { Meta } from '@storybook/addon-docs/blocks'
1
+ import { Meta, Source } from '@storybook/addon-docs/blocks'
2
2
 
3
- <Meta title='@dxtmisha/en/figma/Functions/fetchTopLevelFrames - Fetching top-level frames'/>
3
+ <Meta title='@dxtmisha/en/figma/Functions/fetchTopLevelFrames - Fetch top-level frames'/>
4
4
 
5
5
  # `fetchTopLevelFrames`
6
6
 
7
- A utility that fetches the top-level frames from the Figma plugin. It handles caching and prevents concurrent duplicate requests.
7
+ 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.
8
8
 
9
9
  **Parameters:**
10
- - `callback: (frames: UiFigmaFramesList) => void` — The function to call once the frames are received.
10
+ - `callback: (frames: UiFigmaFramesList) => void` — The function executed once the list of top-level frames is received.
11
11
 
12
12
  **Returns:**
13
13
  `void`
14
14
 
15
- ```javascript
15
+ ## Types
16
+
17
+ ### UiFigmaFramesList
18
+
19
+ An array of `UiFigmaFramesItem`.
20
+
21
+ ### UiFigmaFramesItem
22
+
23
+ - `name: string` — Name of the frame.
24
+ - `id: string` — Unique identifier of the element.
25
+ - `image?: Uint8Array | string` — (Optional) The frame's preview image as a byte array or Base64 string.
26
+
27
+ ## Examples
28
+
29
+ <Source
30
+ language='typescript'
31
+ code={`
16
32
  import { fetchTopLevelFrames } from '@dxtmisha/figma'
17
33
 
34
+ // Fetch all top-level frames and log their details
18
35
  fetchTopLevelFrames((frames) => {
19
- console.log('Top level frames:', frames)
36
+ console.log('Top-level frames found:', frames.length)
37
+
38
+ frames.forEach(frame => {
39
+ console.log(\`Frame: \${frame.name} (ID: \${frame.id})\`)
40
+ })
20
41
  })
21
- ```
42
+ `}
43
+ />
@@ -1,21 +1,43 @@
1
- import { Meta } from '@storybook/addon-docs/blocks'
1
+ import { Meta, Source } from '@storybook/addon-docs/blocks'
2
2
 
3
3
  <Meta title='@dxtmisha/ru/figma/Functions/fetchTopLevelFrames - Получение фреймов верхнего уровня'/>
4
4
 
5
5
  # `fetchTopLevelFrames`
6
6
 
7
- Утилита, которая запрашивает фреймы верхнего уровня из плагина Figma. Она поддерживает кэширование и предотвращает дублирование одновременных запросов.
7
+ Утилита для получения списка всех фреймов верхнего уровня, присутствующих в документе Figma. Обеспечивает связь между интерфейсом (UI) и основной частью плагина для доступа к структуре документа.
8
8
 
9
9
  **Параметры:**
10
- - `callback: (frames: UiFigmaFramesList) => void` — Функция, вызываемая после получения фреймов.
10
+ - `callback: (frames: UiFigmaFramesList) => void` — Функция, которая будет вызвана после получения списка фреймов верхнего уровня.
11
11
 
12
12
  **Возвращает:**
13
13
  `void`
14
14
 
15
- ```javascript
15
+ ## Типы
16
+
17
+ ### UiFigmaFramesList
18
+
19
+ Массив элементов `UiFigmaFramesItem`.
20
+
21
+ ### UiFigmaFramesItem
22
+
23
+ - `name: string` — Название фрейма.
24
+ - `id: string` — Уникальный идентификатор элемента.
25
+ - `image?: Uint8Array | string` — (Опционально) Изображение фрейма в виде байтового массива или строки Base64.
26
+
27
+ ## Примеры
28
+
29
+ <Source
30
+ language='typescript'
31
+ code={`
16
32
  import { fetchTopLevelFrames } from '@dxtmisha/figma'
17
33
 
34
+ // Получить все фреймы верхнего уровня и вывести информацию о них
18
35
  fetchTopLevelFrames((frames) => {
19
- console.log('Фреймы верхнего уровня:', frames)
36
+ console.log('Найдено фреймов верхнего уровня:', frames.length)
37
+
38
+ frames.forEach(frame => {
39
+ console.log(\`Фрейм: \${frame.name} (ID: \${frame.id})\`)
40
+ })
20
41
  })
21
- ```
42
+ `}
43
+ />
@@ -1,21 +1,43 @@
1
- import { Meta } from '@storybook/addon-docs/blocks'
1
+ import { Meta, Source } from '@storybook/addon-docs/blocks'
2
2
 
3
- <Meta title='@dxtmisha/vi/figma/Functions/fetchTopLevelFrames - Lấy danh sách frame cấp cao nhất'/>
3
+ <Meta title='@dxtmisha/vi/figma/Functions/fetchTopLevelFrames - Lấy các frame cấp cao nhất'/>
4
4
 
5
5
  # `fetchTopLevelFrames`
6
6
 
7
- 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.
7
+ Một tiện ích để lấy danh sách tất cả các frame cấp cao nhất hiện 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.
8
8
 
9
9
  **Tham số:**
10
- - `callback: (frames: UiFigmaFramesList) => void` — Hàm sẽ được gọi sau khi nhận được danh sách frame.
10
+ - `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.
11
11
 
12
12
  **Trả về:**
13
13
  `void`
14
14
 
15
- ```javascript
15
+ ## Các kiểu dữ liệu
16
+
17
+ ### UiFigmaFramesList
18
+
19
+ Một mảng gồm các phần tử `UiFigmaFramesItem`.
20
+
21
+ ### UiFigmaFramesItem
22
+
23
+ - `name: string` — Tên của frame.
24
+ - `id: string` — Định danh duy nhất của phần tử.
25
+ - `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.
26
+
27
+ ## Ví dụ
28
+
29
+ <Source
30
+ language='typescript'
31
+ code={`
16
32
  import { fetchTopLevelFrames } from '@dxtmisha/figma'
17
33
 
34
+ // Lấy tất cả các frame cấp cao nhất và log thông tin chi tiết
18
35
  fetchTopLevelFrames((frames) => {
19
- console.log('Các frame cấp cao nhất:', frames)
36
+ console.log('Tìm thấy các frame cấp cao nhất:', frames.length)
37
+
38
+ frames.forEach(frame => {
39
+ console.log(\`Frame: \${frame.name} (ID: \${frame.id})\`)
40
+ })
20
41
  })
21
- ```
42
+ `}
43
+ />
@@ -0,0 +1,29 @@
1
+ import { Meta, Source } from '@storybook/addon-docs/blocks'
2
+
3
+ <Meta title='@dxtmisha/en/figma/Functions/sendClientStorage - Save data to client storage'/>
4
+
5
+ # `sendClientStorage`
6
+
7
+ 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.
8
+
9
+ **Parameters:**
10
+ - `name: string` — The key name in the client storage.
11
+ - `value: T` — The data value to be stored.
12
+
13
+ **Returns:**
14
+ `void`
15
+
16
+ ## Examples
17
+
18
+ <Source
19
+ language='typescript'
20
+ code={`
21
+ import { sendClientStorage } from '@dxtmisha/figma'
22
+
23
+ // 1. Storing a simple string
24
+ sendClientStorage('user-theme', 'dark')
25
+
26
+ // 2. Storing an object
27
+ sendClientStorage('settings', { notifications: true, zoom: 100 })
28
+ `}
29
+ />
@@ -0,0 +1,29 @@
1
+ import { Meta, Source } from '@storybook/addon-docs/blocks'
2
+
3
+ <Meta title='@dxtmisha/ru/figma/Functions/sendClientStorage - Сохранение данных в клиентское хранилище'/>
4
+
5
+ # `sendClientStorage`
6
+
7
+ Утилита для сохранения данных в клиентское хранилище Figma (`clientStorage`). Отправляет сообщение из интерфейса (UI) в основную часть плагина для записи значения по указанному имени.
8
+
9
+ **Параметры:**
10
+ - `name: string` — Ключ (имя) в хранилище.
11
+ - `value: T` — Данные для сохранения.
12
+
13
+ **Возвращает:**
14
+ `void`
15
+
16
+ ## Примеры
17
+
18
+ <Source
19
+ language='typescript'
20
+ code={`
21
+ import { sendClientStorage } from '@dxtmisha/figma'
22
+
23
+ // 1. Сохранение простой строки
24
+ sendClientStorage('user-theme', 'dark')
25
+
26
+ // 2. Сохранение объекта
27
+ sendClientStorage('settings', { notifications: true, zoom: 100 })
28
+ `}
29
+ />
@@ -0,0 +1,29 @@
1
+ import { Meta, Source } from '@storybook/addon-docs/blocks'
2
+
3
+ <Meta title='@dxtmisha/vi/figma/Functions/sendClientStorage - Lưu dữ liệu vào bộ nhớ client'/>
4
+
5
+ # `sendClientStorage`
6
+
7
+ Một tiện ích để lưu dữ liệu vào bộ nhớ client (`clientStorage`) của Figma. Nó gửi một tin nhắn từ giao diện người dùng (UI) đến phía plugin để lưu trữ giá trị được cung cấp dưới một tên cụ thể.
8
+
9
+ **Tham số:**
10
+ - `name: string` — Tên khóa trong bộ nhớ client.
11
+ - `value: T` — Giá trị dữ liệu cần lưu trữ.
12
+
13
+ **Trả về:**
14
+ `void`
15
+
16
+ ## Ví dụ
17
+
18
+ <Source
19
+ language='typescript'
20
+ code={`
21
+ import { sendClientStorage } from '@dxtmisha/figma'
22
+
23
+ // 1. Lưu một chuỗi đơn giản
24
+ sendClientStorage('user-theme', 'dark')
25
+
26
+ // 2. Lưu một đối tượng (object)
27
+ sendClientStorage('settings', { notifications: true, zoom: 100 })
28
+ `}
29
+ />
@@ -0,0 +1,28 @@
1
+ import { Meta, Source } from '@storybook/addon-docs/blocks'
2
+
3
+ <Meta title='@dxtmisha/en/figma/Functions/sendFrameSelection - Request frame selection'/>
4
+
5
+ # `sendFrameSelection`
6
+
7
+ A utility for requesting the Figma plugin to select a specific frame in the document.
8
+
9
+ **Parameters:**
10
+ - `id?: string` — The ID of the frame to be selected. If not provided or empty, the selection might be cleared.
11
+
12
+ **Returns:**
13
+ `void`
14
+
15
+ ## Examples
16
+
17
+ <Source
18
+ language='typescript'
19
+ code={`
20
+ import { sendFrameSelection } from '@dxtmisha/figma'
21
+
22
+ // Select a frame by its ID
23
+ sendFrameSelection('12:34')
24
+
25
+ // Clear or reset selection (depending on plugin implementation)
26
+ sendFrameSelection()
27
+ `}
28
+ />
@@ -0,0 +1,28 @@
1
+ import { Meta, Source } from '@storybook/addon-docs/blocks'
2
+
3
+ <Meta title='@dxtmisha/ru/figma/Functions/sendFrameSelection - Запрос выделения фрейма'/>
4
+
5
+ # `sendFrameSelection`
6
+
7
+ Утилита для отправки запроса в плагин Figma на выделение конкретного фрейма в документе.
8
+
9
+ **Параметры:**
10
+ - `id?: string` — Идентификатор (ID) фрейма, который необходимо выделить. Если не указан, выделение может быть сброшено.
11
+
12
+ **Возвращает:**
13
+ `void`
14
+
15
+ ## Примеры
16
+
17
+ <Source
18
+ language='typescript'
19
+ code={`
20
+ import { sendFrameSelection } from '@dxtmisha/figma'
21
+
22
+ // Выделить фрейм по его ID
23
+ sendFrameSelection('12:34')
24
+
25
+ // Сбросить выделение
26
+ sendFrameSelection()
27
+ `}
28
+ />
@@ -0,0 +1,28 @@
1
+ import { Meta, Source } from '@storybook/addon-docs/blocks'
2
+
3
+ <Meta title='@dxtmisha/vi/figma/Functions/sendFrameSelection - Yêu cầu chọn frame'/>
4
+
5
+ # `sendFrameSelection`
6
+
7
+ Một tiện ích để yêu cầu plugin Figma chọn một frame cụ thể trong tài liệu.
8
+
9
+ **Tham số:**
10
+ - `id?: string` — ID của frame cần chọn. Nếu không được cung cấp, lựa chọn có thể bị xóa bỏ.
11
+
12
+ **Trả về:**
13
+ `void`
14
+
15
+ ## Ví dụ
16
+
17
+ <Source
18
+ language='typescript'
19
+ code={`
20
+ import { sendFrameSelection } from '@dxtmisha/figma'
21
+
22
+ // Chọn một frame bằng ID của nó
23
+ sendFrameSelection('12:34')
24
+
25
+ // Xóa hoặc đặt lại lựa chọn
26
+ sendFrameSelection()
27
+ `}
28
+ />