@ggraphic/editor 0.0.0-stage → 0.0.0

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 (847) hide show
  1. package/LICENSE +373 -0
  2. package/NOTICE +2 -0
  3. package/README.md +8 -2
  4. package/THIRD_PARTY_NOTICES +7 -0
  5. package/dist/CanvasEditorProvider.d.ts +214 -0
  6. package/dist/CanvasEditorProvider.js +10 -0
  7. package/dist/ai/applyOperation.d.ts +75 -0
  8. package/dist/ai/applyOperation.js +354 -0
  9. package/dist/ai/describeCanvasElements.d.ts +17 -0
  10. package/dist/ai/describeCanvasElements.js +148 -0
  11. package/dist/ai/illustrationCapability.d.ts +6 -0
  12. package/dist/ai/illustrationCapability.js +20 -0
  13. package/dist/ai/types.d.ts +91 -0
  14. package/dist/ai/types.js +1 -0
  15. package/dist/blocks/liftedBlock.d.ts +61 -0
  16. package/dist/blocks/liftedBlock.js +117 -0
  17. package/dist/brand/bindPick.d.ts +18 -0
  18. package/dist/brand/bindPick.js +28 -0
  19. package/dist/brand/bindableFields.d.ts +9 -0
  20. package/dist/brand/bindableFields.js +61 -0
  21. package/dist/brand/brandRegistry.d.ts +18 -0
  22. package/dist/brand/brandRegistry.js +41 -0
  23. package/dist/brand/composerBrand.d.ts +146 -0
  24. package/dist/brand/composerBrand.js +6 -0
  25. package/dist/collab/documentVersion.d.ts +36 -0
  26. package/dist/collab/documentVersion.js +139 -0
  27. package/dist/collab/pageElementStateKeys.d.ts +33 -0
  28. package/dist/collab/pageElementStateKeys.js +148 -0
  29. package/dist/collab/pagesDoc.d.ts +152 -0
  30. package/dist/collab/pagesDoc.js +434 -0
  31. package/dist/collab/useAwarenessState.d.ts +12 -0
  32. package/dist/collab/useAwarenessState.js +47 -0
  33. package/dist/collab/useEmitHostStateChanges.d.ts +18 -0
  34. package/dist/collab/useEmitHostStateChanges.js +40 -0
  35. package/dist/collab/useSelectionAwareness.d.ts +22 -0
  36. package/dist/collab/useSelectionAwareness.js +60 -0
  37. package/dist/collab/useYjsCanvasBinding.d.ts +7 -0
  38. package/dist/collab/useYjsCanvasBinding.js +21 -0
  39. package/dist/collab/useYjsPageStateSync.d.ts +20 -0
  40. package/dist/collab/useYjsPageStateSync.js +49 -0
  41. package/dist/collab/useYjsPages.d.ts +73 -0
  42. package/dist/collab/useYjsPages.js +396 -0
  43. package/dist/collab/wrapCallbacksWithPageSync.d.ts +3 -0
  44. package/dist/collab/wrapCallbacksWithPageSync.js +62 -0
  45. package/dist/collab/ydocKeys.d.ts +50 -0
  46. package/dist/collab/ydocKeys.js +50 -0
  47. package/dist/collab/yjsBinding.d.ts +27 -0
  48. package/dist/collab/yjsBinding.js +105 -0
  49. package/dist/common/Lightbox.d.ts +8 -0
  50. package/dist/common/Lightbox.js +8 -0
  51. package/dist/common/imageSourceTypes.d.ts +1 -0
  52. package/dist/common/imageSourceTypes.js +1 -0
  53. package/dist/components/AddPageButton.d.ts +13 -0
  54. package/dist/components/AddPageButton.js +13 -0
  55. package/dist/components/CanvasAnnouncer.d.ts +8 -0
  56. package/dist/components/CanvasAnnouncer.js +10 -0
  57. package/dist/components/CanvasContextMenu/CanvasActionSheet.d.ts +12 -0
  58. package/dist/components/CanvasContextMenu/CanvasActionSheet.js +145 -0
  59. package/dist/components/CanvasContextMenu/CanvasContextMenu.d.ts +33 -0
  60. package/dist/components/CanvasContextMenu/CanvasContextMenu.js +107 -0
  61. package/dist/components/CanvasContextMenu/canvasMenuModel.d.ts +68 -0
  62. package/dist/components/CanvasContextMenu/canvasMenuModel.js +203 -0
  63. package/dist/components/CanvasEditor/CanvasEditorShell.d.ts +32 -0
  64. package/dist/components/CanvasEditor/CanvasEditorShell.js +1138 -0
  65. package/dist/components/CanvasEditor/PageWrapper.d.ts +7 -0
  66. package/dist/components/CanvasEditor/PageWrapper.js +103 -0
  67. package/dist/components/CanvasEditor/autoSwitchTab.d.ts +11 -0
  68. package/dist/components/CanvasEditor/autoSwitchTab.js +15 -0
  69. package/dist/components/CanvasEditor/blockInsertContext.d.ts +22 -0
  70. package/dist/components/CanvasEditor/blockInsertContext.js +5 -0
  71. package/dist/components/CanvasEditor/editorShell.d.ts +99 -0
  72. package/dist/components/CanvasEditor/editorShell.js +20 -0
  73. package/dist/components/CanvasEditor/hooks/useCanvasContextMenu.d.ts +32 -0
  74. package/dist/components/CanvasEditor/hooks/useCanvasContextMenu.js +140 -0
  75. package/dist/components/CanvasEditor/hooks/useLoadedConfigs.d.ts +13 -0
  76. package/dist/components/CanvasEditor/hooks/useLoadedConfigs.js +29 -0
  77. package/dist/components/CanvasEditor/hooks/useMobileSheetFit.d.ts +14 -0
  78. package/dist/components/CanvasEditor/hooks/useMobileSheetFit.js +56 -0
  79. package/dist/components/CanvasEditor/hooks/usePageRefs.d.ts +18 -0
  80. package/dist/components/CanvasEditor/hooks/usePageRefs.js +36 -0
  81. package/dist/components/CanvasEditor/hooks/usePageUndoRedoShortcuts.d.ts +25 -0
  82. package/dist/components/CanvasEditor/hooks/usePageUndoRedoShortcuts.js +49 -0
  83. package/dist/components/CanvasEditor/hooks/usePrintImpressumGate.d.ts +17 -0
  84. package/dist/components/CanvasEditor/hooks/usePrintImpressumGate.js +70 -0
  85. package/dist/components/CanvasEditor/hooks/useScrollToAddedPage.d.ts +17 -0
  86. package/dist/components/CanvasEditor/hooks/useScrollToAddedPage.js +31 -0
  87. package/dist/components/CanvasEditor/hooks/useToolbarHandlers.d.ts +75 -0
  88. package/dist/components/CanvasEditor/hooks/useToolbarHandlers.js +69 -0
  89. package/dist/components/CanvasEditor/hooks/useWorkAreaDeselect.d.ts +6 -0
  90. package/dist/components/CanvasEditor/hooks/useWorkAreaDeselect.js +56 -0
  91. package/dist/components/CanvasEditor/layersTab.d.ts +13 -0
  92. package/dist/components/CanvasEditor/layersTab.js +27 -0
  93. package/dist/components/CanvasEditor/mobileSelectionArea.d.ts +8 -0
  94. package/dist/components/CanvasEditor/mobileSelectionArea.js +27 -0
  95. package/dist/components/CanvasEditor/types.d.ts +202 -0
  96. package/dist/components/CanvasEditor/types.js +1 -0
  97. package/dist/components/CanvasEditorSkeleton.d.ts +16 -0
  98. package/dist/components/CanvasEditorSkeleton.js +24 -0
  99. package/dist/components/CanvasMetaBar.d.ts +16 -0
  100. package/dist/components/CanvasMetaBar.js +33 -0
  101. package/dist/components/CanvasRenderLayer.d.ts +37 -0
  102. package/dist/components/CanvasRenderLayer.js +54 -0
  103. package/dist/components/CanvasTextOverlay.d.ts +126 -0
  104. package/dist/components/CanvasTextOverlay.js +525 -0
  105. package/dist/components/ConfigCanvas.d.ts +35 -0
  106. package/dist/components/ConfigCanvas.js +30 -0
  107. package/dist/components/CropGhostOverlay.d.ts +13 -0
  108. package/dist/components/CropGhostOverlay.js +56 -0
  109. package/dist/components/CustomColorSwatch.d.ts +35 -0
  110. package/dist/components/CustomColorSwatch.js +80 -0
  111. package/dist/components/DownloadNotice.d.ts +7 -0
  112. package/dist/components/DownloadNotice.js +7 -0
  113. package/dist/components/GenericCanvas.d.ts +309 -0
  114. package/dist/components/GenericCanvas.js +780 -0
  115. package/dist/components/GenericCanvasElement.d.ts +34 -0
  116. package/dist/components/GenericCanvasElement.js +267 -0
  117. package/dist/components/MobileSelectionPill.d.ts +40 -0
  118. package/dist/components/MobileSelectionPill.js +85 -0
  119. package/dist/components/MultiSelectionTransformer.d.ts +39 -0
  120. package/dist/components/MultiSelectionTransformer.js +107 -0
  121. package/dist/components/PagePreview.d.ts +14 -0
  122. package/dist/components/PagePreview.js +63 -0
  123. package/dist/components/PageThumbnailStrip.d.ts +25 -0
  124. package/dist/components/PageThumbnailStrip.js +46 -0
  125. package/dist/components/PageToolbar.d.ts +12 -0
  126. package/dist/components/PageToolbar.js +20 -0
  127. package/dist/components/PrintGuides.d.ts +13 -0
  128. package/dist/components/PrintGuides.js +28 -0
  129. package/dist/components/RemoteSelectionOverlay.d.ts +15 -0
  130. package/dist/components/RemoteSelectionOverlay.js +29 -0
  131. package/dist/components/RichTextField.d.ts +34 -0
  132. package/dist/components/RichTextField.js +212 -0
  133. package/dist/components/SelectionPill.d.ts +56 -0
  134. package/dist/components/SelectionPill.js +123 -0
  135. package/dist/components/SlideNotesPanel.d.ts +13 -0
  136. package/dist/components/SlideNotesPanel.js +28 -0
  137. package/dist/components/SlotBudgetStatus.d.ts +12 -0
  138. package/dist/components/SlotBudgetStatus.js +64 -0
  139. package/dist/components/StandaloneCanvas.d.ts +33 -0
  140. package/dist/components/StandaloneCanvas.js +61 -0
  141. package/dist/components/TextFormatButtons.d.ts +61 -0
  142. package/dist/components/TextFormatButtons.js +123 -0
  143. package/dist/components/TextFormatControls.d.ts +26 -0
  144. package/dist/components/TextFormatControls.js +73 -0
  145. package/dist/components/Toolbar.d.ts +40 -0
  146. package/dist/components/Toolbar.js +26 -0
  147. package/dist/components/ToolbarStateBridge.d.ts +72 -0
  148. package/dist/components/ToolbarStateBridge.js +298 -0
  149. package/dist/components/TopBar/AutoSaveIndicator.d.ts +8 -0
  150. package/dist/components/TopBar/AutoSaveIndicator.js +44 -0
  151. package/dist/components/TopBar/ContextControls.d.ts +107 -0
  152. package/dist/components/TopBar/ContextControls.js +319 -0
  153. package/dist/components/TopBar/ContextToolbar.d.ts +14 -0
  154. package/dist/components/TopBar/ContextToolbar.js +20 -0
  155. package/dist/components/TopBar/CropModeControls.d.ts +35 -0
  156. package/dist/components/TopBar/CropModeControls.js +84 -0
  157. package/dist/components/TopBar/DownloadSection.d.ts +47 -0
  158. package/dist/components/TopBar/DownloadSection.js +102 -0
  159. package/dist/components/TopBar/MobileSelectionBar.d.ts +16 -0
  160. package/dist/components/TopBar/MobileSelectionBar.js +26 -0
  161. package/dist/components/TopBar/MobileSelectionControls.d.ts +10 -0
  162. package/dist/components/TopBar/MobileSelectionControls.js +43 -0
  163. package/dist/components/TopBar/MultiSelectionToolbar.d.ts +19 -0
  164. package/dist/components/TopBar/MultiSelectionToolbar.js +30 -0
  165. package/dist/components/TopBar/ShareDropdown.d.ts +54 -0
  166. package/dist/components/TopBar/ShareDropdown.js +110 -0
  167. package/dist/components/TopBar/TopBar.d.ts +6 -0
  168. package/dist/components/TopBar/TopBar.js +6 -0
  169. package/dist/components/TopBar/barTiles.d.ts +15 -0
  170. package/dist/components/TopBar/barTiles.js +34 -0
  171. package/dist/components/TopBar/modules/FloatingAiSuggestionBanner.d.ts +28 -0
  172. package/dist/components/TopBar/modules/FloatingAiSuggestionBanner.js +26 -0
  173. package/dist/components/TopBar/modules/FloatingBackgroundControls.d.ts +38 -0
  174. package/dist/components/TopBar/modules/FloatingBackgroundControls.js +133 -0
  175. package/dist/components/TopBar/modules/FloatingColorPicker.d.ts +16 -0
  176. package/dist/components/TopBar/modules/FloatingColorPicker.js +87 -0
  177. package/dist/components/TopBar/modules/FloatingFontRoleControl.d.ts +17 -0
  178. package/dist/components/TopBar/modules/FloatingFontRoleControl.js +37 -0
  179. package/dist/components/TopBar/modules/FloatingFontSizeControl.d.ts +7 -0
  180. package/dist/components/TopBar/modules/FloatingFontSizeControl.js +22 -0
  181. package/dist/components/TopBar/modules/FloatingGradientControl.d.ts +9 -0
  182. package/dist/components/TopBar/modules/FloatingGradientControl.js +35 -0
  183. package/dist/components/TopBar/modules/FloatingHistoryControls.d.ts +11 -0
  184. package/dist/components/TopBar/modules/FloatingHistoryControls.js +19 -0
  185. package/dist/components/TopBar/modules/FloatingImageLookControl.d.ts +9 -0
  186. package/dist/components/TopBar/modules/FloatingImageLookControl.js +15 -0
  187. package/dist/components/TopBar/modules/FloatingLayerControls.d.ts +9 -0
  188. package/dist/components/TopBar/modules/FloatingLayerControls.js +9 -0
  189. package/dist/components/TopBar/modules/FloatingOpacityControl.d.ts +11 -0
  190. package/dist/components/TopBar/modules/FloatingOpacityControl.js +19 -0
  191. package/dist/components/TopBar/modules/FloatingOutlineControl.d.ts +11 -0
  192. package/dist/components/TopBar/modules/FloatingOutlineControl.js +31 -0
  193. package/dist/components/TopBar/modules/FloatingPositionControl.d.ts +38 -0
  194. package/dist/components/TopBar/modules/FloatingPositionControl.js +74 -0
  195. package/dist/components/TopBar/modules/FloatingShadowControl.d.ts +12 -0
  196. package/dist/components/TopBar/modules/FloatingShadowControl.js +40 -0
  197. package/dist/components/TopBar/modules/FloatingTextAlignControl.d.ts +12 -0
  198. package/dist/components/TopBar/modules/FloatingTextAlignControl.js +27 -0
  199. package/dist/components/TransformHud.d.ts +11 -0
  200. package/dist/components/TransformHud.js +121 -0
  201. package/dist/components/WholeTextFormatControls.d.ts +10 -0
  202. package/dist/components/WholeTextFormatControls.js +37 -0
  203. package/dist/components/ZoomableViewport.d.ts +6 -0
  204. package/dist/components/ZoomableViewport.js +4 -0
  205. package/dist/components/accentMark.d.ts +20 -0
  206. package/dist/components/accentMark.js +24 -0
  207. package/dist/components/canvasItemLock.d.ts +13 -0
  208. package/dist/components/canvasItemLock.js +12 -0
  209. package/dist/components/kindRenderers.d.ts +118 -0
  210. package/dist/components/kindRenderers.js +151 -0
  211. package/dist/components/markColor.d.ts +13 -0
  212. package/dist/components/markColor.js +21 -0
  213. package/dist/components/markerMark.d.ts +19 -0
  214. package/dist/components/markerMark.js +26 -0
  215. package/dist/composer/cardFollowsText.d.ts +17 -0
  216. package/dist/composer/cardFollowsText.js +34 -0
  217. package/dist/composer/marks.d.ts +4 -0
  218. package/dist/composer/marks.js +15 -0
  219. package/dist/composer/steckbriefLayout.d.ts +147 -0
  220. package/dist/composer/steckbriefLayout.js +468 -0
  221. package/dist/composer/textFit.d.ts +31 -0
  222. package/dist/composer/textFit.js +89 -0
  223. package/dist/configs/buildSharepicText.d.ts +5 -0
  224. package/dist/configs/buildSharepicText.js +58 -0
  225. package/dist/configs/configLoader.d.ts +34 -0
  226. package/dist/configs/configLoader.js +60 -0
  227. package/dist/configs/factory/actionFactories.d.ts +172 -0
  228. package/dist/configs/factory/actionFactories.js +611 -0
  229. package/dist/configs/factory/baseTypes.d.ts +150 -0
  230. package/dist/configs/factory/baseTypes.js +8 -0
  231. package/dist/configs/factory/carryInstanceState.d.ts +82 -0
  232. package/dist/configs/factory/carryInstanceState.js +121 -0
  233. package/dist/configs/factory/createTextElement.d.ts +63 -0
  234. package/dist/configs/factory/createTextElement.js +63 -0
  235. package/dist/configs/factory/defineSection.d.ts +45 -0
  236. package/dist/configs/factory/defineSection.js +45 -0
  237. package/dist/configs/factory/layoutAccessors.d.ts +15 -0
  238. package/dist/configs/factory/layoutAccessors.js +20 -0
  239. package/dist/configs/featureInjector.d.ts +40 -0
  240. package/dist/configs/featureInjector.js +184 -0
  241. package/dist/configs/pageInheritance.d.ts +8 -0
  242. package/dist/configs/pageInheritance.js +82 -0
  243. package/dist/configs/placeholders.d.ts +14 -0
  244. package/dist/configs/placeholders.js +33 -0
  245. package/dist/configs/shareSection.d.ts +11 -0
  246. package/dist/configs/shareSection.js +65 -0
  247. package/dist/configs/types.d.ts +420 -0
  248. package/dist/configs/types.js +1 -0
  249. package/dist/configs/unifiedTabs.d.ts +26 -0
  250. package/dist/configs/unifiedTabs.js +6 -0
  251. package/dist/editorSeamTypes.d.ts +41 -0
  252. package/dist/editorSeamTypes.js +1 -0
  253. package/dist/export/pptx/buildPptxModel.d.ts +44 -0
  254. package/dist/export/pptx/buildPptxModel.js +612 -0
  255. package/dist/export/pptx/exportPptxDeck.d.ts +23 -0
  256. package/dist/export/pptx/exportPptxDeck.js +77 -0
  257. package/dist/export/pptx/pptxFonts.d.ts +26 -0
  258. package/dist/export/pptx/pptxFonts.js +41 -0
  259. package/dist/export/pptx/pptxUnits.d.ts +27 -0
  260. package/dist/export/pptx/pptxUnits.js +54 -0
  261. package/dist/export/pptx/textModel.d.ts +13 -0
  262. package/dist/export/pptx/textModel.js +115 -0
  263. package/dist/export/pptx/types.d.ts +161 -0
  264. package/dist/export/pptx/types.js +11 -0
  265. package/dist/export/pptx/writePptx.d.ts +40 -0
  266. package/dist/export/pptx/writePptx.js +206 -0
  267. package/dist/export/pptx/writeText.d.ts +19 -0
  268. package/dist/export/pptx/writeText.js +120 -0
  269. package/dist/export/printExport.d.ts +42 -0
  270. package/dist/export/printExport.js +94 -0
  271. package/dist/export/printPdf.d.ts +103 -0
  272. package/dist/export/printPdf.js +144 -0
  273. package/dist/export/slidesPdf.d.ts +9 -0
  274. package/dist/export/slidesPdf.js +31 -0
  275. package/dist/formats/index.d.ts +115 -0
  276. package/dist/formats/index.js +287 -0
  277. package/dist/groups/pageGroups.d.ts +32 -0
  278. package/dist/groups/pageGroups.js +91 -0
  279. package/dist/hooks/index.d.ts +29 -0
  280. package/dist/hooks/index.js +19 -0
  281. package/dist/hooks/useAiImageGeneration.d.ts +15 -0
  282. package/dist/hooks/useAiImageGeneration.js +73 -0
  283. package/dist/hooks/useAnnounce.d.ts +27 -0
  284. package/dist/hooks/useAnnounce.js +47 -0
  285. package/dist/hooks/useBoxSnap.d.ts +37 -0
  286. package/dist/hooks/useBoxSnap.js +49 -0
  287. package/dist/hooks/useCanvasAutoSave.d.ts +33 -0
  288. package/dist/hooks/useCanvasAutoSave.js +259 -0
  289. package/dist/hooks/useCanvasElementHandlers.d.ts +182 -0
  290. package/dist/hooks/useCanvasElementHandlers.js +326 -0
  291. package/dist/hooks/useCanvasHistorySetup.d.ts +37 -0
  292. package/dist/hooks/useCanvasHistorySetup.js +113 -0
  293. package/dist/hooks/useCanvasInteractions.d.ts +31 -0
  294. package/dist/hooks/useCanvasInteractions.js +103 -0
  295. package/dist/hooks/useCanvasKeyboardHandlers.d.ts +37 -0
  296. package/dist/hooks/useCanvasKeyboardHandlers.js +280 -0
  297. package/dist/hooks/useCanvasStoreReset.d.ts +25 -0
  298. package/dist/hooks/useCanvasStoreReset.js +35 -0
  299. package/dist/hooks/useCanvasUndoRedo.d.ts +34 -0
  300. package/dist/hooks/useCanvasUndoRedo.js +213 -0
  301. package/dist/hooks/useContextPress.d.ts +14 -0
  302. package/dist/hooks/useContextPress.js +45 -0
  303. package/dist/hooks/useCropSession.d.ts +23 -0
  304. package/dist/hooks/useCropSession.js +69 -0
  305. package/dist/hooks/useDebounce.d.ts +1 -0
  306. package/dist/hooks/useDebounce.js +14 -0
  307. package/dist/hooks/useDeckAutoSave.d.ts +30 -0
  308. package/dist/hooks/useDeckAutoSave.js +234 -0
  309. package/dist/hooks/useDeepSelect.d.ts +18 -0
  310. package/dist/hooks/useDeepSelect.js +135 -0
  311. package/dist/hooks/useElementSnapping.d.ts +13 -0
  312. package/dist/hooks/useElementSnapping.js +26 -0
  313. package/dist/hooks/useEmojiCatalog.d.ts +3 -0
  314. package/dist/hooks/useEmojiCatalog.js +13 -0
  315. package/dist/hooks/useFloatingModuleHandlers.d.ts +52 -0
  316. package/dist/hooks/useFloatingModuleHandlers.js +285 -0
  317. package/dist/hooks/useFloatingModuleState.d.ts +83 -0
  318. package/dist/hooks/useFloatingModuleState.js +250 -0
  319. package/dist/hooks/useFontGeneration.d.ts +10 -0
  320. package/dist/hooks/useFontGeneration.js +77 -0
  321. package/dist/hooks/useFontLoader.d.ts +53 -0
  322. package/dist/hooks/useFontLoader.js +129 -0
  323. package/dist/hooks/useGeometryReporter.d.ts +19 -0
  324. package/dist/hooks/useGeometryReporter.js +41 -0
  325. package/dist/hooks/useHoverOutline.d.ts +8 -0
  326. package/dist/hooks/useHoverOutline.js +78 -0
  327. package/dist/hooks/useIconCatalog.d.ts +12 -0
  328. package/dist/hooks/useIconCatalog.js +30 -0
  329. package/dist/hooks/useIconSearch.d.ts +2 -0
  330. package/dist/hooks/useIconSearch.js +14 -0
  331. package/dist/hooks/useIconSetsFor.d.ts +8 -0
  332. package/dist/hooks/useIconSetsFor.js +30 -0
  333. package/dist/hooks/useImageCoverFit.d.ts +17 -0
  334. package/dist/hooks/useImageCoverFit.js +35 -0
  335. package/dist/hooks/useIsCanvasMobile.d.ts +3 -0
  336. package/dist/hooks/useIsCanvasMobile.js +19 -0
  337. package/dist/hooks/useMarqueeSelection.d.ts +27 -0
  338. package/dist/hooks/useMarqueeSelection.js +140 -0
  339. package/dist/hooks/useMobileSheet.d.ts +48 -0
  340. package/dist/hooks/useMobileSheet.js +282 -0
  341. package/dist/hooks/useMultiPageExport.d.ts +30 -0
  342. package/dist/hooks/useMultiPageExport.js +117 -0
  343. package/dist/hooks/usePageManager.d.ts +132 -0
  344. package/dist/hooks/usePageManager.js +399 -0
  345. package/dist/hooks/usePageThumbnails.d.ts +10 -0
  346. package/dist/hooks/usePageThumbnails.js +122 -0
  347. package/dist/hooks/usePaginatedIcons.d.ts +11 -0
  348. package/dist/hooks/usePaginatedIcons.js +46 -0
  349. package/dist/hooks/useRovingToolbar.d.ts +17 -0
  350. package/dist/hooks/useRovingToolbar.js +76 -0
  351. package/dist/hooks/useSelectionAnnouncement.d.ts +13 -0
  352. package/dist/hooks/useSelectionAnnouncement.js +68 -0
  353. package/dist/hooks/useSnapScheduler.d.ts +20 -0
  354. package/dist/hooks/useSnapScheduler.js +61 -0
  355. package/dist/hooks/useTrackUnsplashDownload.d.ts +6 -0
  356. package/dist/hooks/useTrackUnsplashDownload.js +19 -0
  357. package/dist/hooks/useZoomGestures.d.ts +35 -0
  358. package/dist/hooks/useZoomGestures.js +185 -0
  359. package/dist/hostServices.d.ts +308 -0
  360. package/dist/hostServices.js +107 -0
  361. package/dist/i18n/de.d.ts +895 -0
  362. package/dist/i18n/de.js +959 -0
  363. package/dist/i18n/en.d.ts +3 -0
  364. package/dist/i18n/en.js +948 -0
  365. package/dist/i18n/messages.d.ts +28 -0
  366. package/dist/i18n/messages.js +66 -0
  367. package/dist/layouts/CanvasEditorLayout.d.ts +28 -0
  368. package/dist/layouts/CanvasEditorLayout.js +56 -0
  369. package/dist/layouts/index.d.ts +2 -0
  370. package/dist/layouts/index.js +2 -0
  371. package/dist/primitives/AssetPrimitive.d.ts +24 -0
  372. package/dist/primitives/AssetPrimitive.js +158 -0
  373. package/dist/primitives/CanvasBackground.d.ts +33 -0
  374. package/dist/primitives/CanvasBackground.js +44 -0
  375. package/dist/primitives/CanvasIcons.d.ts +19 -0
  376. package/dist/primitives/CanvasIcons.js +46 -0
  377. package/dist/primitives/CanvasImage.d.ts +73 -0
  378. package/dist/primitives/CanvasImage.js +460 -0
  379. package/dist/primitives/CanvasRichText.d.ts +25 -0
  380. package/dist/primitives/CanvasRichText.js +281 -0
  381. package/dist/primitives/CanvasStage.d.ts +84 -0
  382. package/dist/primitives/CanvasStage.js +291 -0
  383. package/dist/primitives/CanvasText.d.ts +91 -0
  384. package/dist/primitives/CanvasText.js +293 -0
  385. package/dist/primitives/ChartPrimitive.d.ts +24 -0
  386. package/dist/primitives/ChartPrimitive.js +318 -0
  387. package/dist/primitives/CircleBadge.d.ts +43 -0
  388. package/dist/primitives/CircleBadge.js +233 -0
  389. package/dist/primitives/FramePrimitive.d.ts +14 -0
  390. package/dist/primitives/FramePrimitive.js +406 -0
  391. package/dist/primitives/IconPrimitive.d.ts +28 -0
  392. package/dist/primitives/IconPrimitive.js +119 -0
  393. package/dist/primitives/IllustrationPrimitive.d.ts +16 -0
  394. package/dist/primitives/IllustrationPrimitive.js +184 -0
  395. package/dist/primitives/PillBadge.d.ts +45 -0
  396. package/dist/primitives/PillBadge.js +237 -0
  397. package/dist/primitives/ShapePrimitive.d.ts +12 -0
  398. package/dist/primitives/ShapePrimitive.js +521 -0
  399. package/dist/primitives/SnapGuidelines.d.ts +19 -0
  400. package/dist/primitives/SnapGuidelines.js +34 -0
  401. package/dist/primitives/UserImagePrimitive.d.ts +30 -0
  402. package/dist/primitives/UserImagePrimitive.js +494 -0
  403. package/dist/primitives/index.d.ts +18 -0
  404. package/dist/primitives/index.js +11 -0
  405. package/dist/sidebar/SidebarPanel.d.ts +8 -0
  406. package/dist/sidebar/SidebarPanel.js +219 -0
  407. package/dist/sidebar/SidebarTabBar.d.ts +2 -0
  408. package/dist/sidebar/SidebarTabBar.js +31 -0
  409. package/dist/sidebar/SubsectionTabBar.d.ts +13 -0
  410. package/dist/sidebar/SubsectionTabBar.js +30 -0
  411. package/dist/sidebar/UserUploadsProvider.d.ts +31 -0
  412. package/dist/sidebar/UserUploadsProvider.js +139 -0
  413. package/dist/sidebar/components/AltTextField.d.ts +21 -0
  414. package/dist/sidebar/components/AltTextField.js +60 -0
  415. package/dist/sidebar/components/SidebarHint.d.ts +7 -0
  416. package/dist/sidebar/components/SidebarHint.js +38 -0
  417. package/dist/sidebar/components/SidebarSlider.d.ts +16 -0
  418. package/dist/sidebar/components/SidebarSlider.js +9 -0
  419. package/dist/sidebar/components/TextFieldPrimitives.d.ts +26 -0
  420. package/dist/sidebar/components/TextFieldPrimitives.js +56 -0
  421. package/dist/sidebar/sections/ChartSettingsSection.d.ts +9 -0
  422. package/dist/sidebar/sections/ChartSettingsSection.js +75 -0
  423. package/dist/sidebar/sections/CombinedTextSection.d.ts +16 -0
  424. package/dist/sidebar/sections/CombinedTextSection.js +42 -0
  425. package/dist/sidebar/sections/DiagrammeSection.d.ts +9 -0
  426. package/dist/sidebar/sections/DiagrammeSection.js +41 -0
  427. package/dist/sidebar/sections/EffectsSection.d.ts +20 -0
  428. package/dist/sidebar/sections/EffectsSection.js +23 -0
  429. package/dist/sidebar/sections/FormenSection.d.ts +26 -0
  430. package/dist/sidebar/sections/FormenSection.js +428 -0
  431. package/dist/sidebar/sections/FrameSettingsSection.d.ts +8 -0
  432. package/dist/sidebar/sections/FrameSettingsSection.js +26 -0
  433. package/dist/sidebar/sections/GenericShareSection.d.ts +26 -0
  434. package/dist/sidebar/sections/GenericShareSection.js +262 -0
  435. package/dist/sidebar/sections/IconsSection.d.ts +8 -0
  436. package/dist/sidebar/sections/IconsSection.js +55 -0
  437. package/dist/sidebar/sections/IllustrationSettings.d.ts +9 -0
  438. package/dist/sidebar/sections/IllustrationSettings.js +32 -0
  439. package/dist/sidebar/sections/IllustrationThumb.d.ts +7 -0
  440. package/dist/sidebar/sections/IllustrationThumb.js +15 -0
  441. package/dist/sidebar/sections/ImageAdjustSection.d.ts +13 -0
  442. package/dist/sidebar/sections/ImageAdjustSection.js +84 -0
  443. package/dist/sidebar/sections/LayersSection.d.ts +25 -0
  444. package/dist/sidebar/sections/LayersSection.js +155 -0
  445. package/dist/sidebar/sections/RahmenSection.d.ts +7 -0
  446. package/dist/sidebar/sections/RahmenSection.js +18 -0
  447. package/dist/sidebar/sections/StudioGallery.d.ts +33 -0
  448. package/dist/sidebar/sections/StudioGallery.js +58 -0
  449. package/dist/sidebar/sections/UploadsSection.d.ts +11 -0
  450. package/dist/sidebar/sections/UploadsSection.js +130 -0
  451. package/dist/sidebar/sections/assets/AssetsSection.d.ts +59 -0
  452. package/dist/sidebar/sections/assets/AssetsSection.js +27 -0
  453. package/dist/sidebar/sections/assets/BackgroundCatalog.d.ts +9 -0
  454. package/dist/sidebar/sections/assets/BackgroundCatalog.js +49 -0
  455. package/dist/sidebar/sections/assets/CategoryCard.d.ts +14 -0
  456. package/dist/sidebar/sections/assets/CategoryCard.js +15 -0
  457. package/dist/sidebar/sections/assets/ElementGrid.d.ts +14 -0
  458. package/dist/sidebar/sections/assets/ElementGrid.js +34 -0
  459. package/dist/sidebar/sections/assets/ElementThumb.d.ts +10 -0
  460. package/dist/sidebar/sections/assets/ElementThumb.js +59 -0
  461. package/dist/sidebar/sections/assets/ElementTile.d.ts +32 -0
  462. package/dist/sidebar/sections/assets/ElementTile.js +60 -0
  463. package/dist/sidebar/sections/assets/ElementsPanel.d.ts +7 -0
  464. package/dist/sidebar/sections/assets/ElementsPanel.js +249 -0
  465. package/dist/sidebar/sections/assets/EmojiTonePicker.d.ts +8 -0
  466. package/dist/sidebar/sections/assets/EmojiTonePicker.js +26 -0
  467. package/dist/sidebar/sections/assets/FotosCatalog.d.ts +12 -0
  468. package/dist/sidebar/sections/assets/FotosCatalog.js +41 -0
  469. package/dist/sidebar/sections/assets/IconifyCatalog.d.ts +14 -0
  470. package/dist/sidebar/sections/assets/IconifyCatalog.js +133 -0
  471. package/dist/sidebar/sections/assets/RecentCarousel.d.ts +7 -0
  472. package/dist/sidebar/sections/assets/RecentCarousel.js +42 -0
  473. package/dist/sidebar/sections/assets/StickerCatalog.d.ts +14 -0
  474. package/dist/sidebar/sections/assets/StickerCatalog.js +49 -0
  475. package/dist/sidebar/sections/assets/constants.d.ts +4 -0
  476. package/dist/sidebar/sections/assets/constants.js +15 -0
  477. package/dist/sidebar/sections/assets/elementPanelHost.d.ts +45 -0
  478. package/dist/sidebar/sections/assets/elementPanelHost.js +1 -0
  479. package/dist/sidebar/sections/assets/elementSearch.d.ts +10 -0
  480. package/dist/sidebar/sections/assets/elementSearch.js +38 -0
  481. package/dist/sidebar/sections/assets/elementTypes.d.ts +67 -0
  482. package/dist/sidebar/sections/assets/elementTypes.js +24 -0
  483. package/dist/sidebar/sections/assets/index.d.ts +3 -0
  484. package/dist/sidebar/sections/assets/index.js +3 -0
  485. package/dist/sidebar/sections/assets/useElementCatalog.d.ts +42 -0
  486. package/dist/sidebar/sections/assets/useElementCatalog.js +371 -0
  487. package/dist/sidebar/sections/assets/useRecentElements.d.ts +21 -0
  488. package/dist/sidebar/sections/assets/useRecentElements.js +67 -0
  489. package/dist/sidebar/sections/assets/useStockPhotos.d.ts +22 -0
  490. package/dist/sidebar/sections/assets/useStockPhotos.js +96 -0
  491. package/dist/sidebar/sections/effects/EffectCard.d.ts +11 -0
  492. package/dist/sidebar/sections/effects/EffectCard.js +14 -0
  493. package/dist/sidebar/sections/effects/GradientSettings.d.ts +10 -0
  494. package/dist/sidebar/sections/effects/GradientSettings.js +32 -0
  495. package/dist/sidebar/sections/effects/OutlineSettings.d.ts +12 -0
  496. package/dist/sidebar/sections/effects/OutlineSettings.js +28 -0
  497. package/dist/sidebar/sections/effects/ShadowSettings.d.ts +13 -0
  498. package/dist/sidebar/sections/effects/ShadowSettings.js +37 -0
  499. package/dist/sidebar/sections/effects/effectsFor.d.ts +16 -0
  500. package/dist/sidebar/sections/effects/effectsFor.js +24 -0
  501. package/dist/sidebar/sections/index.d.ts +28 -0
  502. package/dist/sidebar/sections/index.js +36 -0
  503. package/dist/sidebar/sections/lazyWithPreload.d.ts +11 -0
  504. package/dist/sidebar/sections/lazyWithPreload.js +29 -0
  505. package/dist/sidebar/sections/tools/AiCreateTool.d.ts +4 -0
  506. package/dist/sidebar/sections/tools/AiCreateTool.js +58 -0
  507. package/dist/sidebar/sections/tools/AiEditTool.d.ts +4 -0
  508. package/dist/sidebar/sections/tools/AiEditTool.js +57 -0
  509. package/dist/sidebar/sections/tools/AltTextTool.d.ts +11 -0
  510. package/dist/sidebar/sections/tools/AltTextTool.js +78 -0
  511. package/dist/sidebar/sections/tools/BlobCreatorTool.d.ts +5 -0
  512. package/dist/sidebar/sections/tools/BlobCreatorTool.js +85 -0
  513. package/dist/sidebar/sections/tools/GradientTextTool.d.ts +5 -0
  514. package/dist/sidebar/sections/tools/GradientTextTool.js +102 -0
  515. package/dist/sidebar/sections/tools/ImageInputPicker.d.ts +7 -0
  516. package/dist/sidebar/sections/tools/ImageInputPicker.js +68 -0
  517. package/dist/sidebar/sections/tools/QRCodeTool.d.ts +5 -0
  518. package/dist/sidebar/sections/tools/QRCodeTool.js +63 -0
  519. package/dist/sidebar/sections/tools/RemoveBackgroundTool.d.ts +4 -0
  520. package/dist/sidebar/sections/tools/RemoveBackgroundTool.js +52 -0
  521. package/dist/sidebar/sections/tools/TextPathCreatorTool.d.ts +5 -0
  522. package/dist/sidebar/sections/tools/TextPathCreatorTool.js +123 -0
  523. package/dist/sidebar/sections/tools/ToolPanel.d.ts +26 -0
  524. package/dist/sidebar/sections/tools/ToolPanel.js +13 -0
  525. package/dist/sidebar/sections/tools/ToolTiles.d.ts +5 -0
  526. package/dist/sidebar/sections/tools/ToolTiles.js +76 -0
  527. package/dist/sidebar/sections/tools/ToolsSection.d.ts +15 -0
  528. package/dist/sidebar/sections/tools/ToolsSection.js +149 -0
  529. package/dist/sidebar/sections/tools/UnsplashLimitNotice.d.ts +8 -0
  530. package/dist/sidebar/sections/tools/UnsplashLimitNotice.js +22 -0
  531. package/dist/sidebar/sections/tools/UnsplashTool.d.ts +10 -0
  532. package/dist/sidebar/sections/tools/UnsplashTool.js +47 -0
  533. package/dist/sidebar/sections/tools/index.d.ts +1 -0
  534. package/dist/sidebar/sections/tools/index.js +2 -0
  535. package/dist/sidebar/sections/tools/toolTiles.css +335 -0
  536. package/dist/sidebar/sections/tools/useToolImagePlacement.d.ts +19 -0
  537. package/dist/sidebar/sections/tools/useToolImagePlacement.js +23 -0
  538. package/dist/sidebar/sections/whenIdle.d.ts +2 -0
  539. package/dist/sidebar/sections/whenIdle.js +10 -0
  540. package/dist/sidebar/sidebarStyles.d.ts +60 -0
  541. package/dist/sidebar/sidebarStyles.js +61 -0
  542. package/dist/sidebar/tabTypes.d.ts +27 -0
  543. package/dist/sidebar/tabTypes.js +1 -0
  544. package/dist/sidebar/types.d.ts +43 -0
  545. package/dist/sidebar/types.js +1 -0
  546. package/dist/sidebar/useImagePlacement.d.ts +17 -0
  547. package/dist/sidebar/useImagePlacement.js +28 -0
  548. package/dist/stores/AutoSaveStoreProvider.d.ts +28 -0
  549. package/dist/stores/AutoSaveStoreProvider.js +45 -0
  550. package/dist/stores/CanvasStoreProvider.d.ts +43 -0
  551. package/dist/stores/CanvasStoreProvider.js +74 -0
  552. package/dist/stores/createAutoSaveStore.d.ts +50 -0
  553. package/dist/stores/createAutoSaveStore.js +42 -0
  554. package/dist/stores/createCanvasEditorStore.d.ts +126 -0
  555. package/dist/stores/createCanvasEditorStore.js +266 -0
  556. package/dist/stores/useAutoSaveStore.d.ts +12 -0
  557. package/dist/stores/useAutoSaveStore.js +12 -0
  558. package/dist/styles/editor.css +445 -0
  559. package/dist/styles/index.css +4 -0
  560. package/dist/styles/tailwind.css +239 -0
  561. package/dist/styles/tokens.css +199 -0
  562. package/dist/templates/fontWidths.generated.d.ts +1 -0
  563. package/dist/templates/fontWidths.generated.js +17 -0
  564. package/dist/templates/registry.d.ts +59 -0
  565. package/dist/templates/registry.js +40 -0
  566. package/dist/templates/templateGeometry.d.ts +32 -0
  567. package/dist/templates/templateGeometry.js +887 -0
  568. package/dist/templates/testKinds.d.ts +15 -0
  569. package/dist/templates/testKinds.js +151 -0
  570. package/dist/testing/fixtureTemplates.d.ts +13 -0
  571. package/dist/testing/fixtureTemplates.js +376 -0
  572. package/dist/testing/stampKind.d.ts +91 -0
  573. package/dist/testing/stampKind.js +56 -0
  574. package/dist/types/editorTypes.d.ts +65 -0
  575. package/dist/types/editorTypes.js +21 -0
  576. package/dist/ui/alert-dialog.d.ts +18 -0
  577. package/dist/ui/alert-dialog.js +42 -0
  578. package/dist/ui/button.d.ts +10 -0
  579. package/dist/ui/button.js +29 -0
  580. package/dist/ui/dialog.d.ts +15 -0
  581. package/dist/ui/dialog.js +53 -0
  582. package/dist/ui/icon-button.d.ts +18 -0
  583. package/dist/ui/icon-button.js +54 -0
  584. package/dist/ui/input.d.ts +3 -0
  585. package/dist/ui/input.js +6 -0
  586. package/dist/ui/label.d.ts +4 -0
  587. package/dist/ui/label.js +8 -0
  588. package/dist/ui/masonry-grid.d.ts +11 -0
  589. package/dist/ui/masonry-grid.js +43 -0
  590. package/dist/ui/popover.d.ts +10 -0
  591. package/dist/ui/popover.js +26 -0
  592. package/dist/ui/select.d.ts +15 -0
  593. package/dist/ui/select.js +38 -0
  594. package/dist/ui/skeleton.d.ts +2 -0
  595. package/dist/ui/skeleton.js +7 -0
  596. package/dist/ui/switch.d.ts +6 -0
  597. package/dist/ui/switch.js +8 -0
  598. package/dist/utils/__snapshots__/kindSelection.vitest.ts.snap +1086 -0
  599. package/dist/utils/alignment.d.ts +21 -0
  600. package/dist/utils/alignment.js +54 -0
  601. package/dist/utils/axisLock.d.ts +30 -0
  602. package/dist/utils/axisLock.js +78 -0
  603. package/dist/utils/backgroundPhotoCrop.d.ts +28 -0
  604. package/dist/utils/backgroundPhotoCrop.js +28 -0
  605. package/dist/utils/balkenUtils.d.ts +22 -0
  606. package/dist/utils/balkenUtils.js +8 -0
  607. package/dist/utils/canvasAssets.d.ts +134 -0
  608. package/dist/utils/canvasAssets.js +121 -0
  609. package/dist/utils/canvasClipboard.d.ts +51 -0
  610. package/dist/utils/canvasClipboard.js +37 -0
  611. package/dist/utils/canvasCommandRegistry.d.ts +207 -0
  612. package/dist/utils/canvasCommandRegistry.js +124 -0
  613. package/dist/utils/canvasCommands.d.ts +106 -0
  614. package/dist/utils/canvasCommands.js +564 -0
  615. package/dist/utils/canvasFontFamilies.d.ts +12 -0
  616. package/dist/utils/canvasFontFamilies.js +24 -0
  617. package/dist/utils/canvasIcons.d.ts +68 -0
  618. package/dist/utils/canvasIcons.js +293 -0
  619. package/dist/utils/canvasImageSource.d.ts +12 -0
  620. package/dist/utils/canvasImageSource.js +19 -0
  621. package/dist/utils/canvasItem.d.ts +102 -0
  622. package/dist/utils/canvasItem.js +1 -0
  623. package/dist/utils/canvasLayerManager.d.ts +51 -0
  624. package/dist/utils/canvasLayerManager.js +107 -0
  625. package/dist/utils/canvasValueResolver.d.ts +9 -0
  626. package/dist/utils/canvasValueResolver.js +13 -0
  627. package/dist/utils/captureStage.d.ts +59 -0
  628. package/dist/utils/captureStage.js +152 -0
  629. package/dist/utils/chartTypes.d.ts +6 -0
  630. package/dist/utils/chartTypes.js +2 -0
  631. package/dist/utils/chartUtils.d.ts +49 -0
  632. package/dist/utils/chartUtils.js +191 -0
  633. package/dist/utils/circleBadgeUtils.d.ts +28 -0
  634. package/dist/utils/circleBadgeUtils.js +85 -0
  635. package/dist/utils/cn.d.ts +2 -0
  636. package/dist/utils/cn.js +66 -0
  637. package/dist/utils/collectAltTextPages.d.ts +6 -0
  638. package/dist/utils/collectAltTextPages.js +20 -0
  639. package/dist/utils/colorLuminance.d.ts +3 -0
  640. package/dist/utils/colorLuminance.js +14 -0
  641. package/dist/utils/colorNames.d.ts +2 -0
  642. package/dist/utils/colorNames.js +8 -0
  643. package/dist/utils/colorOptions.d.ts +20 -0
  644. package/dist/utils/colorOptions.js +20 -0
  645. package/dist/utils/cornerRadius.d.ts +14 -0
  646. package/dist/utils/cornerRadius.js +27 -0
  647. package/dist/utils/cornerReservation.d.ts +19 -0
  648. package/dist/utils/cornerReservation.js +7 -0
  649. package/dist/utils/coverFit.d.ts +117 -0
  650. package/dist/utils/coverFit.js +207 -0
  651. package/dist/utils/cropAspect.d.ts +47 -0
  652. package/dist/utils/cropAspect.js +53 -0
  653. package/dist/utils/cropGhost.d.ts +63 -0
  654. package/dist/utils/cropGhost.js +216 -0
  655. package/dist/utils/cropSession.d.ts +23 -0
  656. package/dist/utils/cropSession.js +92 -0
  657. package/dist/utils/cropTarget.d.ts +22 -0
  658. package/dist/utils/cropTarget.js +33 -0
  659. package/dist/utils/deepSelect.d.ts +43 -0
  660. package/dist/utils/deepSelect.js +74 -0
  661. package/dist/utils/downloadError.d.ts +2 -0
  662. package/dist/utils/downloadError.js +13 -0
  663. package/dist/utils/duplicateElement.d.ts +127 -0
  664. package/dist/utils/duplicateElement.js +235 -0
  665. package/dist/utils/editorFocus.d.ts +36 -0
  666. package/dist/utils/editorFocus.js +67 -0
  667. package/dist/utils/editorToast.d.ts +21 -0
  668. package/dist/utils/editorToast.js +7 -0
  669. package/dist/utils/elementKinds.d.ts +212 -0
  670. package/dist/utils/elementKinds.js +137 -0
  671. package/dist/utils/emoji/emojiCatalog.d.ts +12 -0
  672. package/dist/utils/emoji/emojiCatalog.en.json +9997 -0
  673. package/dist/utils/emoji/emojiCatalog.js +53 -0
  674. package/dist/utils/emoji/emojiCatalog.json +9913 -0
  675. package/dist/utils/ensureFontsReady.d.ts +12 -0
  676. package/dist/utils/ensureFontsReady.js +23 -0
  677. package/dist/utils/expandImage.d.ts +17 -0
  678. package/dist/utils/expandImage.js +76 -0
  679. package/dist/utils/externalIcons.d.ts +67 -0
  680. package/dist/utils/externalIcons.js +168 -0
  681. package/dist/utils/filterCache.d.ts +16 -0
  682. package/dist/utils/filterCache.js +31 -0
  683. package/dist/utils/filterUtils.d.ts +2 -0
  684. package/dist/utils/filterUtils.js +89 -0
  685. package/dist/utils/followStage.d.ts +2 -0
  686. package/dist/utils/followStage.js +48 -0
  687. package/dist/utils/fontAliases.d.ts +14 -0
  688. package/dist/utils/fontAliases.js +32 -0
  689. package/dist/utils/fontMarkSupport.d.ts +25 -0
  690. package/dist/utils/fontMarkSupport.js +26 -0
  691. package/dist/utils/frameUtils.d.ts +19 -0
  692. package/dist/utils/frameUtils.js +282 -0
  693. package/dist/utils/gradientFill.d.ts +55 -0
  694. package/dist/utils/gradientFill.js +57 -0
  695. package/dist/utils/gradientHitArea.d.ts +22 -0
  696. package/dist/utils/gradientHitArea.js +94 -0
  697. package/dist/utils/grain.d.ts +29 -0
  698. package/dist/utils/grain.js +103 -0
  699. package/dist/utils/grainSpec.d.ts +2 -0
  700. package/dist/utils/grainSpec.js +3 -0
  701. package/dist/utils/groupSnap.d.ts +27 -0
  702. package/dist/utils/groupSnap.js +54 -0
  703. package/dist/utils/handDrawn.d.ts +92 -0
  704. package/dist/utils/handDrawn.js +523 -0
  705. package/dist/utils/historyStamp.d.ts +22 -0
  706. package/dist/utils/historyStamp.js +31 -0
  707. package/dist/utils/hostStorageKeys.d.ts +16 -0
  708. package/dist/utils/hostStorageKeys.js +27 -0
  709. package/dist/utils/iconInstances.d.ts +80 -0
  710. package/dist/utils/iconInstances.js +109 -0
  711. package/dist/utils/illustrations/gophers.d.ts +11 -0
  712. package/dist/utils/illustrations/gophers.js +1236 -0
  713. package/dist/utils/illustrations/humaaans.d.ts +8 -0
  714. package/dist/utils/illustrations/humaaans.js +265 -0
  715. package/dist/utils/illustrations/illlustrations.d.ts +11 -0
  716. package/dist/utils/illustrations/illlustrations.js +929 -0
  717. package/dist/utils/illustrations/kawaii.d.ts +6 -0
  718. package/dist/utils/illustrations/kawaii.js +73 -0
  719. package/dist/utils/illustrations/opendoodles.d.ts +6 -0
  720. package/dist/utils/illustrations/opendoodles.js +271 -0
  721. package/dist/utils/illustrations/openpeeps.d.ts +9 -0
  722. package/dist/utils/illustrations/openpeeps.js +1522 -0
  723. package/dist/utils/illustrations/prefetchAnalytics.d.ts +78 -0
  724. package/dist/utils/illustrations/prefetchAnalytics.js +162 -0
  725. package/dist/utils/illustrations/registry.d.ts +24 -0
  726. package/dist/utils/illustrations/registry.js +104 -0
  727. package/dist/utils/illustrations/svgCache.d.ts +60 -0
  728. package/dist/utils/illustrations/svgCache.js +342 -0
  729. package/dist/utils/illustrations/transhumans.d.ts +8 -0
  730. package/dist/utils/illustrations/transhumans.js +313 -0
  731. package/dist/utils/illustrations/types.d.ts +25 -0
  732. package/dist/utils/illustrations/types.js +45 -0
  733. package/dist/utils/imageElementComparison.d.ts +19 -0
  734. package/dist/utils/imageElementComparison.js +121 -0
  735. package/dist/utils/imageFilters.d.ts +92 -0
  736. package/dist/utils/imageFilters.js +303 -0
  737. package/dist/utils/imageLook.d.ts +16 -0
  738. package/dist/utils/imageLook.js +39 -0
  739. package/dist/utils/keyboardCrop.d.ts +25 -0
  740. package/dist/utils/keyboardCrop.js +98 -0
  741. package/dist/utils/keyboardOwnership.d.ts +30 -0
  742. package/dist/utils/keyboardOwnership.js +93 -0
  743. package/dist/utils/layerLabels.d.ts +39 -0
  744. package/dist/utils/layerLabels.js +181 -0
  745. package/dist/utils/layerLock.d.ts +24 -0
  746. package/dist/utils/layerLock.js +52 -0
  747. package/dist/utils/layerSelection.d.ts +24 -0
  748. package/dist/utils/layerSelection.js +16 -0
  749. package/dist/utils/markerBoxes.d.ts +23 -0
  750. package/dist/utils/markerBoxes.js +73 -0
  751. package/dist/utils/markerColors.d.ts +9 -0
  752. package/dist/utils/markerColors.js +39 -0
  753. package/dist/utils/mediaDrop.d.ts +76 -0
  754. package/dist/utils/mediaDrop.js +95 -0
  755. package/dist/utils/mediaPlacement.d.ts +6 -0
  756. package/dist/utils/mediaPlacement.js +17 -0
  757. package/dist/utils/motifSizes.d.ts +8 -0
  758. package/dist/utils/motifSizes.js +9 -0
  759. package/dist/utils/multiSelect.d.ts +44 -0
  760. package/dist/utils/multiSelect.js +139 -0
  761. package/dist/utils/notch.d.ts +17 -0
  762. package/dist/utils/notch.js +23 -0
  763. package/dist/utils/orientElement.d.ts +46 -0
  764. package/dist/utils/orientElement.js +108 -0
  765. package/dist/utils/orientation.d.ts +119 -0
  766. package/dist/utils/orientation.js +411 -0
  767. package/dist/utils/pageCounter.d.ts +15 -0
  768. package/dist/utils/pageCounter.js +17 -0
  769. package/dist/utils/pendingImages.d.ts +10 -0
  770. package/dist/utils/pendingImages.js +25 -0
  771. package/dist/utils/photoCredit.d.ts +9 -0
  772. package/dist/utils/photoCredit.js +29 -0
  773. package/dist/utils/photoCredits.d.ts +5 -0
  774. package/dist/utils/photoCredits.js +17 -0
  775. package/dist/utils/photoPlaceholder.d.ts +22 -0
  776. package/dist/utils/photoPlaceholder.js +36 -0
  777. package/dist/utils/pillBadgeUtils.d.ts +40 -0
  778. package/dist/utils/pillBadgeUtils.js +94 -0
  779. package/dist/utils/pixelHitArea.d.ts +13 -0
  780. package/dist/utils/pixelHitArea.js +33 -0
  781. package/dist/utils/plainTextLayout.d.ts +11 -0
  782. package/dist/utils/plainTextLayout.js +64 -0
  783. package/dist/utils/printImageInfo.d.ts +9 -0
  784. package/dist/utils/printImageInfo.js +14 -0
  785. package/dist/utils/recacheNextFrame.d.ts +6 -0
  786. package/dist/utils/recacheNextFrame.js +15 -0
  787. package/dist/utils/removeElement.d.ts +17 -0
  788. package/dist/utils/removeElement.js +47 -0
  789. package/dist/utils/renderedBoxes.d.ts +19 -0
  790. package/dist/utils/renderedBoxes.js +67 -0
  791. package/dist/utils/resolveElementValue.d.ts +44 -0
  792. package/dist/utils/resolveElementValue.js +72 -0
  793. package/dist/utils/scrollBehavior.d.ts +6 -0
  794. package/dist/utils/scrollBehavior.js +17 -0
  795. package/dist/utils/searchTranslations.d.ts +20 -0
  796. package/dist/utils/searchTranslations.js +366 -0
  797. package/dist/utils/selectionCapabilities.d.ts +53 -0
  798. package/dist/utils/selectionCapabilities.js +52 -0
  799. package/dist/utils/shade.d.ts +24 -0
  800. package/dist/utils/shade.js +55 -0
  801. package/dist/utils/shapeDevices.d.ts +72 -0
  802. package/dist/utils/shapeDevices.js +100 -0
  803. package/dist/utils/shapeTransform.d.ts +29 -0
  804. package/dist/utils/shapeTransform.js +69 -0
  805. package/dist/utils/shapes.d.ts +62 -0
  806. package/dist/utils/shapes.js +836 -0
  807. package/dist/utils/smartCrop.d.ts +30 -0
  808. package/dist/utils/smartCrop.js +163 -0
  809. package/dist/utils/snapping.d.ts +116 -0
  810. package/dist/utils/snapping.js +426 -0
  811. package/dist/utils/stageCssScale.d.ts +7 -0
  812. package/dist/utils/stageCssScale.js +11 -0
  813. package/dist/utils/stateTypeAssertions.d.ts +99 -0
  814. package/dist/utils/stateTypeAssertions.js +197 -0
  815. package/dist/utils/straighten.d.ts +51 -0
  816. package/dist/utils/straighten.js +254 -0
  817. package/dist/utils/surfaceGlow.d.ts +7 -0
  818. package/dist/utils/surfaceGlow.js +27 -0
  819. package/dist/utils/templateElementInstance.d.ts +43 -0
  820. package/dist/utils/templateElementInstance.js +100 -0
  821. package/dist/utils/templateRotation.d.ts +24 -0
  822. package/dist/utils/templateRotation.js +56 -0
  823. package/dist/utils/textAlign.d.ts +17 -0
  824. package/dist/utils/textAlign.js +30 -0
  825. package/dist/utils/textEditorOpeners.d.ts +12 -0
  826. package/dist/utils/textEditorOpeners.js +40 -0
  827. package/dist/utils/textRouting.d.ts +17 -0
  828. package/dist/utils/textRouting.js +22 -0
  829. package/dist/utils/textUtils.d.ts +102 -0
  830. package/dist/utils/textUtils.js +250 -0
  831. package/dist/utils/touchInput.d.ts +7 -0
  832. package/dist/utils/touchInput.js +19 -0
  833. package/dist/utils/transformHudLabel.d.ts +3 -0
  834. package/dist/utils/transformHudLabel.js +12 -0
  835. package/dist/utils/unsplashLinks.d.ts +2 -0
  836. package/dist/utils/unsplashLinks.js +7 -0
  837. package/dist/utils/userFacingError.d.ts +10 -0
  838. package/dist/utils/userFacingError.js +10 -0
  839. package/dist/utils/userImageCrop.d.ts +4 -0
  840. package/dist/utils/userImageCrop.js +26 -0
  841. package/dist/utils/userImageUtils.d.ts +44 -0
  842. package/dist/utils/userImageUtils.js +136 -0
  843. package/dist/utils/viewport.d.ts +16 -0
  844. package/dist/utils/viewport.js +30 -0
  845. package/dist/utils/zipPageImages.d.ts +8 -0
  846. package/dist/utils/zipPageImages.js +29 -0
  847. package/package.json +105 -3
@@ -0,0 +1,434 @@
1
+ // SPDX-License-Identifier: MPL-2.0
2
+ /**
3
+ * Page-document schema + pure helpers. Single source of truth for multi-page
4
+ * canvas structure in BOTH modes (collaborative Hocuspocus doc and the local
5
+ * Y.Doc a non-collab editor owns).
6
+ *
7
+ * Schema:
8
+ * meta Y.Map — `pagesSeeded` watermark, one-shot migration markers
9
+ * pagesById Y.Map<pageId, page>
10
+ * page Y.Map — { id, configId, pos, state: Y.Map, config: Y.Map }
11
+ *
12
+ * Ordering uses a fractional `pos` key (lexicographic, base-62): moving a page
13
+ * writes ONE key on the existing Y.Map, so the page keeps its CRDT identity —
14
+ * concurrent edits on a moved page survive, and concurrent reorders converge
15
+ * (ties broken by id). The legacy `pages` Y.Array (clone-delete-insert moves)
16
+ * is migrated once per doc via `migrateLegacyDoc`.
17
+ */
18
+ import { v4 as uuid } from 'uuid';
19
+ import * as Y from 'yjs';
20
+ import { YDOC_KEYS } from './ydocKeys.js';
21
+ // ── fractional ordering ─────────────────────────────────────────────────────
22
+ // ASCII-ordered so plain string comparison sorts correctly.
23
+ const POS_ALPHABET = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz';
24
+ /**
25
+ * A key strictly between `a` and `b` (lexicographic). `null` means unbounded.
26
+ * Generated keys never end in the smallest digit ('0'), which guarantees a
27
+ * midpoint always exists between any two previously generated keys.
28
+ */
29
+ export function posBetween(a, b) {
30
+ const lo = a ?? '';
31
+ const hi = b ?? '';
32
+ if (lo !== '' && hi !== '' && lo >= hi) {
33
+ throw new Error(`posBetween: '${lo}' >= '${hi}'`);
34
+ }
35
+ let result = '';
36
+ for (let i = 0;; i++) {
37
+ const ca = i < lo.length ? POS_ALPHABET.indexOf(lo[i]) : 0;
38
+ const cb = i < hi.length ? POS_ALPHABET.indexOf(hi[i]) : POS_ALPHABET.length;
39
+ if (cb - ca > 1) {
40
+ return result + POS_ALPHABET[ca + Math.ceil((cb - ca) / 2)];
41
+ }
42
+ result += POS_ALPHABET[ca];
43
+ }
44
+ }
45
+ // ── doc accessors ───────────────────────────────────────────────────────────
46
+ export const getPagesMap = (doc) => doc.getMap(YDOC_KEYS.pagesById);
47
+ export const getMetaMap = (doc) => doc.getMap(YDOC_KEYS.meta);
48
+ const stateEpochs = new WeakMap();
49
+ let nextStateEpoch = 1;
50
+ const epochOf = (stateY) => {
51
+ if (!(stateY instanceof Y.Map))
52
+ return 0;
53
+ let epoch = stateEpochs.get(stateY);
54
+ if (epoch === undefined) {
55
+ epoch = nextStateEpoch++;
56
+ stateEpochs.set(stateY, epoch);
57
+ }
58
+ return epoch;
59
+ };
60
+ const pageToView = (yMap) => {
61
+ const id = yMap.get(YDOC_KEYS.id);
62
+ const configId = yMap.get(YDOC_KEYS.configId);
63
+ const pos = yMap.get(YDOC_KEYS.pos);
64
+ if (typeof id !== 'string' || typeof configId !== 'string' || typeof pos !== 'string') {
65
+ return null;
66
+ }
67
+ const stateY = yMap.get(YDOC_KEYS.state);
68
+ const state = stateY instanceof Y.Map ? Object.fromEntries(stateY.entries()) : {};
69
+ return { id, configId, pos, state, yMap, stateEpoch: epochOf(stateY) };
70
+ };
71
+ /** All pages, sorted by (pos, id) — the canonical page order. */
72
+ export function readPages(doc) {
73
+ const views = [];
74
+ getPagesMap(doc).forEach((yMap) => {
75
+ const view = pageToView(yMap);
76
+ if (view)
77
+ views.push(view);
78
+ });
79
+ views.sort((a, b) => (a.pos < b.pos ? -1 : a.pos > b.pos ? 1 : a.id < b.id ? -1 : 1));
80
+ return views;
81
+ }
82
+ // ── page construction / cloning ─────────────────────────────────────────────
83
+ export function buildPage(def, pos) {
84
+ const page = new Y.Map();
85
+ page.set(YDOC_KEYS.id, def.id);
86
+ page.set(YDOC_KEYS.configId, def.configId);
87
+ page.set(YDOC_KEYS.pos, pos);
88
+ const state = new Y.Map();
89
+ for (const [k, v] of Object.entries(def.state))
90
+ state.set(k, v);
91
+ page.set(YDOC_KEYS.state, state);
92
+ // config is otherwise created on demand by bindCanvasStoreToYMap
93
+ // when the page first mounts in a GenericCanvas.
94
+ if (def.config && Object.keys(def.config).length > 0) {
95
+ const config = new Y.Map();
96
+ for (const [k, v] of Object.entries(def.config))
97
+ config.set(k, v);
98
+ page.set(YDOC_KEYS.config, config);
99
+ }
100
+ return page;
101
+ }
102
+ const cloneYMapShallow = (source) => {
103
+ const copy = new Y.Map();
104
+ // Plain values are copied, not shared: a duplicated page's arrays (`groups`,
105
+ // element lists) must not alias the source page's.
106
+ for (const [k, v] of source.entries()) {
107
+ copy.set(k, v instanceof Y.AbstractType ? v.clone() : structuredClone(v));
108
+ }
109
+ return copy;
110
+ };
111
+ /** Deep-clone a page's state and config into a fresh Y.Map. */
112
+ export function clonePage(source, newId, pos) {
113
+ const page = new Y.Map();
114
+ page.set(YDOC_KEYS.id, newId);
115
+ page.set(YDOC_KEYS.configId, source.get(YDOC_KEYS.configId) ?? 'unknown');
116
+ page.set(YDOC_KEYS.pos, pos);
117
+ const sourceState = source.get(YDOC_KEYS.state);
118
+ page.set(YDOC_KEYS.state, sourceState instanceof Y.Map ? cloneYMapShallow(sourceState) : new Y.Map());
119
+ const sourceConfig = source.get(YDOC_KEYS.config);
120
+ if (sourceConfig instanceof Y.Map) {
121
+ page.set(YDOC_KEYS.config, cloneYMapShallow(sourceConfig));
122
+ }
123
+ return page;
124
+ }
125
+ // ── mutations (call inside doc.transact with your origin) ───────────────────
126
+ /**
127
+ * Random suffix for user-initiated pos keys. posBetween is deterministic, so
128
+ * two clients concurrently appending after the same last page would mint the
129
+ * SAME pos for different ids — a tie posBetween can never split again. Two
130
+ * random non-'0' chars make that practically impossible while preserving
131
+ * strict betweenness (appending to a between-key keeps it between, given the
132
+ * no-trailing-'0' invariant). Seeds stay deterministic on purpose — identical
133
+ * racing seeds must converge, and ties across identical ids merge anyway.
134
+ */
135
+ const posJitter = (pos) => pos +
136
+ POS_ALPHABET[1 + Math.floor(Math.random() * (POS_ALPHABET.length - 1))] +
137
+ POS_ALPHABET[1 + Math.floor(Math.random() * (POS_ALPHABET.length - 1))];
138
+ /**
139
+ * Heal a doc whose pos keys collided (pre-jitter concurrent ops): re-space
140
+ * every page along a fresh chain in the current canonical order.
141
+ * Deterministic — two clients normalizing the same view write identical keys.
142
+ */
143
+ export function normalizePositions(doc) {
144
+ let pos = null;
145
+ for (const view of readPages(doc)) {
146
+ pos = posBetween(pos, null);
147
+ if (view.pos !== pos)
148
+ view.yMap.set(YDOC_KEYS.pos, pos);
149
+ }
150
+ }
151
+ /** pos strictly between the neighbors at `index`; normalizes tied keys first. */
152
+ export function posForInsert(doc, index) {
153
+ let views = readPages(doc);
154
+ const clamped = Math.max(0, Math.min(index, views.length));
155
+ let before = clamped > 0 ? views[clamped - 1].pos : null;
156
+ let after = clamped < views.length ? views[clamped].pos : null;
157
+ if (before !== null && after !== null && before >= after) {
158
+ normalizePositions(doc);
159
+ views = readPages(doc);
160
+ before = clamped > 0 ? views[clamped - 1].pos : null;
161
+ after = clamped < views.length ? views[clamped].pos : null;
162
+ }
163
+ return posJitter(posBetween(before, after));
164
+ }
165
+ export function insertPageAt(doc, index, def) {
166
+ getPagesMap(doc).set(def.id, buildPage(def, posForInsert(doc, index)));
167
+ }
168
+ export function appendPage(doc, def) {
169
+ getPagesMap(doc).set(def.id, buildPage(def, posForInsert(doc, Number.MAX_SAFE_INTEGER)));
170
+ }
171
+ /** Clone `sourceId` (state + config) and insert it right after the source. */
172
+ export function duplicatePageById(doc, sourceId, newId) {
173
+ const pagesMap = getPagesMap(doc);
174
+ const source = pagesMap.get(sourceId);
175
+ if (!source)
176
+ return false;
177
+ const idx = readPages(doc).findIndex((v) => v.id === sourceId);
178
+ pagesMap.set(newId, clonePage(source, newId, posForInsert(doc, idx + 1)));
179
+ return true;
180
+ }
181
+ export function removePageById(doc, id) {
182
+ getPagesMap(doc).delete(id);
183
+ }
184
+ /** Move one step up/down by rewriting only the page's `pos` key. */
185
+ export function movePageById(doc, id, direction) {
186
+ let views = readPages(doc);
187
+ let idx = views.findIndex((v) => v.id === id);
188
+ if (idx < 0)
189
+ return;
190
+ const target = direction === 'up' ? idx - 1 : idx + 1;
191
+ if (target < 0 || target >= views.length)
192
+ return;
193
+ const bounds = () => {
194
+ const neighbor = views[target];
195
+ const beyond = direction === 'up' ? views[target - 1] : views[target + 1];
196
+ return direction === 'up'
197
+ ? [beyond ? beyond.pos : null, neighbor.pos]
198
+ : [neighbor.pos, beyond ? beyond.pos : null];
199
+ };
200
+ let [lo, hi] = bounds();
201
+ if (lo !== null && hi !== null && lo >= hi) {
202
+ normalizePositions(doc);
203
+ views = readPages(doc);
204
+ idx = views.findIndex((v) => v.id === id);
205
+ [lo, hi] = bounds();
206
+ }
207
+ views[idx].yMap.set(YDOC_KEYS.pos, posJitter(posBetween(lo, hi)));
208
+ }
209
+ const jsonEqual = (a, b) => {
210
+ if (a === b)
211
+ return true;
212
+ if (typeof a !== 'object' || typeof b !== 'object' || a === null || b === null)
213
+ return false;
214
+ try {
215
+ return JSON.stringify(a) === JSON.stringify(b);
216
+ }
217
+ catch {
218
+ return false;
219
+ }
220
+ };
221
+ /**
222
+ * Patch primitive/plain-object fields on a page's `state` Y.Map. Structural
223
+ * (JSON) equality guard: Y.Map.set on an identical value still emits an
224
+ * update, and echoed updates ping-pong between clients via
225
+ * useYjsPageStateSync + GenericCanvas's synced-image-key re-emission.
226
+ */
227
+ export function updatePageStateById(doc, id, partial) {
228
+ const page = getPagesMap(doc).get(id);
229
+ if (!page)
230
+ return;
231
+ const stateY = page.get(YDOC_KEYS.state);
232
+ if (!(stateY instanceof Y.Map))
233
+ return;
234
+ for (const [k, v] of Object.entries(partial)) {
235
+ if (!jsonEqual(stateY.get(k), v))
236
+ stateY.set(k, v);
237
+ }
238
+ }
239
+ /**
240
+ * Convert a page to another template in place: replaces `configId` and the
241
+ * whole `state` map while keeping id and pos.
242
+ */
243
+ export function setPageConfigById(doc, id, configId, newState) {
244
+ const page = getPagesMap(doc).get(id);
245
+ if (!page)
246
+ return;
247
+ page.set(YDOC_KEYS.configId, configId);
248
+ const state = new Y.Map();
249
+ for (const [k, v] of Object.entries(newState))
250
+ state.set(k, v);
251
+ page.set(YDOC_KEYS.state, state);
252
+ }
253
+ /** Make a page's state map equal `state` in place: absent keys deleted, changed keys set. */
254
+ export function replacePageState(doc, pageId, state) {
255
+ const stateY = getPagesMap(doc).get(pageId)?.get(YDOC_KEYS.state);
256
+ if (!(stateY instanceof Y.Map))
257
+ return;
258
+ for (const key of Array.from(stateY.keys())) {
259
+ if (!(key in state))
260
+ stateY.delete(key);
261
+ }
262
+ for (const [k, v] of Object.entries(state)) {
263
+ if (!jsonEqual(stateY.get(k), v))
264
+ stateY.set(k, v);
265
+ }
266
+ }
267
+ const canonicalJson = (value) => JSON.stringify(value, (_key, v) => v !== null && typeof v === 'object' && !Array.isArray(v)
268
+ ? Object.fromEntries(Object.entries(v).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0)))
269
+ : v);
270
+ /**
271
+ * Equal as stored JSON: object key order and `undefined` members don't count
272
+ * — a value that crossed the wire comes back JSON-decoded.
273
+ */
274
+ export const sameStateValue = (a, b) => a === b || canonicalJson(a) === canonicalJson(b);
275
+ /**
276
+ * Write `target` into a page's state for each of `keys` the caller reports
277
+ * as untouched (given the live value); a key absent from `target` is deleted.
278
+ */
279
+ export function restorePageStateKeys(doc, pageId, target, keys, untouched) {
280
+ const stateY = getPagesMap(doc).get(pageId)?.get(YDOC_KEYS.state);
281
+ if (!(stateY instanceof Y.Map))
282
+ return;
283
+ for (const k of keys) {
284
+ if (!untouched(k, stateY.get(k)))
285
+ continue;
286
+ if (!Object.hasOwn(target, k)) {
287
+ if (stateY.has(k))
288
+ stateY.delete(k);
289
+ }
290
+ else if (!jsonEqual(stateY.get(k), target[k])) {
291
+ stateY.set(k, target[k]);
292
+ }
293
+ }
294
+ }
295
+ /**
296
+ * Apply a recomposed deck in ONE transaction (one undo step when `origin` is
297
+ * tracked). Unlike updatePageStateById the state map is replaced, not patched:
298
+ * a recomposed page may have dropped elements. The existing state Y.Map is
299
+ * mutated in place (not swapped) so observers on it — useYjsPageStateSync —
300
+ * keep firing. Order: updates, inserts (sequential), removes — so an insert
301
+ * may anchor on a page that is removed in the same call.
302
+ */
303
+ export function replaceDeck(doc, ops, origin) {
304
+ const insertedIds = [];
305
+ doc.transact(() => {
306
+ for (const { pageId, state } of ops.updates)
307
+ replacePageState(doc, pageId, state);
308
+ for (const ins of ops.inserts) {
309
+ const index = ins.afterPageId === null
310
+ ? 0
311
+ : readPages(doc).findIndex((v) => v.id === ins.afterPageId) + 1;
312
+ const id = ins.pageId ?? uuid();
313
+ insertPageAt(doc, index, { id, configId: ins.configId, state: ins.state });
314
+ insertedIds.push(id);
315
+ }
316
+ for (const id of ops.removes)
317
+ removePageById(doc, id);
318
+ }, origin);
319
+ return insertedIds;
320
+ }
321
+ // ── seeding ─────────────────────────────────────────────────────────────────
322
+ /**
323
+ * Deterministic seed ids: two clients racing to seed the same fresh doc write
324
+ * the same map keys, so the CRDT merge converges to ONE set of pages instead
325
+ * of duplicating them (the old Y.Array seed with uuid ids doubled the deck).
326
+ */
327
+ export const seedPageId = (index) => `seed-${index}`;
328
+ /**
329
+ * Seed a fresh page list. No-op when pages exist or the doc carries the
330
+ * server-authoritative seed watermark.
331
+ */
332
+ export function seedPagesIfEmpty(doc, defs) {
333
+ const pagesMap = getPagesMap(doc);
334
+ const meta = getMetaMap(doc);
335
+ if (pagesMap.size > 0 || meta.get(YDOC_KEYS.pagesSeeded) === true)
336
+ return false;
337
+ let pos = null;
338
+ for (const def of defs) {
339
+ pos = posBetween(pos, null);
340
+ pagesMap.set(def.id, buildPage(def, pos));
341
+ }
342
+ meta.set(YDOC_KEYS.pagesSeeded, true);
343
+ return true;
344
+ }
345
+ // ── serialization (deck autosave / exports) ─────────────────────────────────
346
+ export function serializeDeck(doc) {
347
+ return readPages(doc).map((view) => {
348
+ const configY = view.yMap.get(YDOC_KEYS.config);
349
+ return {
350
+ id: view.id,
351
+ configId: view.configId,
352
+ state: view.state,
353
+ config: configY instanceof Y.Map ? configY.toJSON() : {},
354
+ };
355
+ });
356
+ }
357
+ // ── legacy migration ────────────────────────────────────────────────────────
358
+ /**
359
+ * One-shot lazy migration of pre-`pagesById` docs. Handles, in order:
360
+ * 1. `pages` Y.Array (previous multi-page container) → pagesById with pos
361
+ * derived from array order.
362
+ * 2. `legacy_root` / top-level `config` (single-page collab docs from before
363
+ * pages existed) → one promoted page.
364
+ * Idempotent: marked in `meta` and skipped when pagesById already has pages.
365
+ * Runs inside one transaction — pass the caller's origin.
366
+ */
367
+ export function migrateLegacyDoc(doc) {
368
+ const pagesMap = getPagesMap(doc);
369
+ const meta = getMetaMap(doc);
370
+ if (pagesMap.size > 0 || meta.get(YDOC_KEYS.legacyMigrated) === true)
371
+ return;
372
+ const legacyPages = doc.getArray(YDOC_KEYS.pages);
373
+ if (legacyPages.length > 0) {
374
+ let pos = null;
375
+ for (const source of legacyPages.toArray()) {
376
+ const id = source.get(YDOC_KEYS.id);
377
+ if (typeof id !== 'string')
378
+ continue;
379
+ pos = posBetween(pos, null);
380
+ pagesMap.set(id, clonePage(source, id, pos));
381
+ }
382
+ legacyPages.delete(0, legacyPages.length);
383
+ meta.set(YDOC_KEYS.legacyMigrated, true);
384
+ meta.set(YDOC_KEYS.pagesSeeded, true);
385
+ return;
386
+ }
387
+ const legacyRoot = doc.getMap(YDOC_KEYS.legacyRoot);
388
+ const hasLegacyConfigType = doc.share.has(YDOC_KEYS.config);
389
+ const legacyConfig = hasLegacyConfigType ? doc.getMap(YDOC_KEYS.config) : null;
390
+ const legacyHasContent = legacyRoot.size > 0 || (legacyConfig !== null && legacyConfig.size > 0);
391
+ if (!legacyHasContent)
392
+ return;
393
+ const promoted = buildPage({ id: `legacy-${Date.now()}`, configId: 'unknown', state: {} }, posBetween(null, null));
394
+ if (legacyConfig && legacyConfig.size > 0) {
395
+ promoted.set(YDOC_KEYS.config, cloneYMapShallow(legacyConfig));
396
+ for (const k of Array.from(legacyConfig.keys()))
397
+ legacyConfig.delete(k);
398
+ }
399
+ pagesMap.set(promoted.get(YDOC_KEYS.id), promoted);
400
+ meta.set(YDOC_KEYS.legacyMigrated, true);
401
+ meta.set(YDOC_KEYS.pagesSeeded, true);
402
+ }
403
+ /**
404
+ * One-shot heal for docs whose template edits predate per-page dual-writes:
405
+ * they live only in the root `formState` Y.Map. Fold them into the single
406
+ * page's state (multi-page docs are marked folded WITHOUT folding —
407
+ * formState mixes the last edits of ALL pages and can't be attributed).
408
+ *
409
+ * MUST run immediately after the page seed (useYjsPages.seedIfEmpty calls it
410
+ * in the same transaction) — a doc with 0 pages returns without the marker,
411
+ * and folding on some LATER open would overwrite page-state edits the user
412
+ * made in between with the frozen formState snapshot.
413
+ */
414
+ export function foldLegacyFormStateIntoFirstPage(doc) {
415
+ const meta = getMetaMap(doc);
416
+ if (meta.get(YDOC_KEYS.formStateFolded) === true)
417
+ return;
418
+ const views = readPages(doc);
419
+ if (views.length === 0)
420
+ return;
421
+ const formState = doc.getMap(YDOC_KEYS.formState);
422
+ if (views.length === 1 && formState.size > 0) {
423
+ const stateY = views[0].yMap.get(YDOC_KEYS.state);
424
+ if (!(stateY instanceof Y.Map))
425
+ return;
426
+ formState.forEach((value, key) => {
427
+ if (key.startsWith('_'))
428
+ return;
429
+ if (stateY.get(key) !== value)
430
+ stateY.set(key, value);
431
+ });
432
+ }
433
+ meta.set(YDOC_KEYS.formStateFolded, true);
434
+ }
@@ -0,0 +1,12 @@
1
+ import type { HocuspocusProvider } from '@hocuspocus/provider';
2
+ type AwarenessStates = Map<number, Record<string, unknown>>;
3
+ /**
4
+ * Subscribe to Hocuspocus awareness state changes using useSyncExternalStore.
5
+ * Replaces the manual useEffect + setTimeout(0) + diffing pattern.
6
+ *
7
+ * The selector receives all awareness states and the local client ID,
8
+ * and should return the derived value. Results are compared with isEqual
9
+ * to avoid unnecessary re-renders.
10
+ */
11
+ export declare function useAwarenessState<T>(provider: HocuspocusProvider | null, selector: (states: AwarenessStates, localClientId: number) => T, isEqual?: (a: T, b: T) => boolean): T;
12
+ export {};
@@ -0,0 +1,47 @@
1
+ // SPDX-License-Identifier: MPL-2.0
2
+ import { useCallback, useRef, useSyncExternalStore } from 'react';
3
+ const EMPTY_SNAPSHOT = { states: new Map(), localClientId: 0 };
4
+ /**
5
+ * Subscribe to Hocuspocus awareness state changes using useSyncExternalStore.
6
+ * Replaces the manual useEffect + setTimeout(0) + diffing pattern.
7
+ *
8
+ * The selector receives all awareness states and the local client ID,
9
+ * and should return the derived value. Results are compared with isEqual
10
+ * to avoid unnecessary re-renders.
11
+ */
12
+ export function useAwarenessState(provider, selector, isEqual = Object.is) {
13
+ const cachedRef = useRef({
14
+ value: undefined,
15
+ initialized: false,
16
+ });
17
+ const subscribe = useCallback((onStoreChange) => {
18
+ const awareness = provider?.awareness;
19
+ if (!awareness)
20
+ return () => { };
21
+ awareness.on('change', onStoreChange);
22
+ return () => {
23
+ awareness.off('change', onStoreChange);
24
+ };
25
+ }, [provider]);
26
+ const getSnapshot = useCallback(() => {
27
+ const awareness = provider?.awareness;
28
+ if (!awareness) {
29
+ if (!cachedRef.current.initialized) {
30
+ cachedRef.current.value = selector(EMPTY_SNAPSHOT.states, 0);
31
+ cachedRef.current.initialized = true;
32
+ }
33
+ return cachedRef.current.value;
34
+ }
35
+ const next = selector(awareness.getStates(), awareness.clientID);
36
+ if (cachedRef.current.initialized && isEqual(cachedRef.current.value, next)) {
37
+ return cachedRef.current.value;
38
+ }
39
+ cachedRef.current.value = next;
40
+ cachedRef.current.initialized = true;
41
+ return next;
42
+ }, [provider, selector, isEqual]);
43
+ const getServerSnapshot = useCallback(() => {
44
+ return selector(EMPTY_SNAPSHOT.states, 0);
45
+ }, [selector]);
46
+ return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
47
+ }
@@ -0,0 +1,18 @@
1
+ /**
2
+ * Meldet Änderungen bestimmter Zustandsschlüssel als `on<Key>Change` an den Host.
3
+ *
4
+ * Die Vorlagen-Stores ändern diese Felder nur im lokalen Komponentenzustand —
5
+ * anders als Textfelder, die durch ihren eigenen Callback laufen. Ohne diese
6
+ * Brücke erreicht weder das gewählte Hintergrundbild noch ein freies Element
7
+ * den Seitenzustand, und beides ist nach dem Neuladen weg (#3416).
8
+ *
9
+ * Verglichen wird über die Referenz: `setState` legt bei jeder echten Änderung
10
+ * neue Objekte an, ein unveränderter Render behält sie. Ein trotzdem
11
+ * durchgereichter Gleichstand — nach einer Fernbearbeitung baut
12
+ * `createInitialState` alle Sammlungen neu auf — ist unschädlich, weil
13
+ * `updatePageStateById` strukturell vergleicht, bevor es schreibt.
14
+ *
15
+ * Für Schlüssel, die die aktive Vorlage nicht wirklich führt, passiert nichts:
16
+ * `callbacks` hat dann keinen passenden Eintrag.
17
+ */
18
+ export declare function useEmitHostStateChanges(state: Record<string, unknown>, callbacks: Record<string, ((val: unknown) => void) | undefined>, keys: readonly string[]): void;
@@ -0,0 +1,40 @@
1
+ // SPDX-License-Identifier: MPL-2.0
2
+ import { useEffect, useRef } from 'react';
3
+ /**
4
+ * Meldet Änderungen bestimmter Zustandsschlüssel als `on<Key>Change` an den Host.
5
+ *
6
+ * Die Vorlagen-Stores ändern diese Felder nur im lokalen Komponentenzustand —
7
+ * anders als Textfelder, die durch ihren eigenen Callback laufen. Ohne diese
8
+ * Brücke erreicht weder das gewählte Hintergrundbild noch ein freies Element
9
+ * den Seitenzustand, und beides ist nach dem Neuladen weg (#3416).
10
+ *
11
+ * Verglichen wird über die Referenz: `setState` legt bei jeder echten Änderung
12
+ * neue Objekte an, ein unveränderter Render behält sie. Ein trotzdem
13
+ * durchgereichter Gleichstand — nach einer Fernbearbeitung baut
14
+ * `createInitialState` alle Sammlungen neu auf — ist unschädlich, weil
15
+ * `updatePageStateById` strukturell vergleicht, bevor es schreibt.
16
+ *
17
+ * Für Schlüssel, die die aktive Vorlage nicht wirklich führt, passiert nichts:
18
+ * `callbacks` hat dann keinen passenden Eintrag.
19
+ */
20
+ export function useEmitHostStateChanges(state, callbacks, keys) {
21
+ const prevRef = useRef({});
22
+ const seededRef = useRef(false);
23
+ useEffect(() => {
24
+ if (!seededRef.current) {
25
+ // Beim ersten Render nur merken, sonst meldete der geladene Zustand
26
+ // sich selbst als Änderung zurück.
27
+ seededRef.current = true;
28
+ for (const key of keys)
29
+ prevRef.current[key] = state[key];
30
+ return;
31
+ }
32
+ for (const key of keys) {
33
+ const next = state[key];
34
+ if (next === prevRef.current[key])
35
+ continue;
36
+ prevRef.current[key] = next;
37
+ callbacks[`on${key.charAt(0).toUpperCase()}${key.slice(1)}Change`]?.(next);
38
+ }
39
+ }, [state, callbacks, keys]);
40
+ }
@@ -0,0 +1,22 @@
1
+ import type { HocuspocusProvider } from '@hocuspocus/provider';
2
+ interface RemoteSelection {
3
+ clientId: number;
4
+ userId: string;
5
+ userName: string;
6
+ color: string;
7
+ selectedLayerIds: string[];
8
+ /** Multi-page only — id of the page the remote user is currently editing. */
9
+ activePageId: string | null;
10
+ }
11
+ interface UseSelectionAwarenessOptions {
12
+ /** Multi-page only — the local user's currently active page id. */
13
+ activePageId?: string | null;
14
+ /**
15
+ * Whether this instance publishes the local selection. In multi-page mode
16
+ * every page mounts the hook on the same provider — only the active page
17
+ * may publish, or instances would overwrite each other.
18
+ */
19
+ publish?: boolean;
20
+ }
21
+ export declare function useSelectionAwareness(provider: HocuspocusProvider | null, options?: UseSelectionAwarenessOptions): RemoteSelection[];
22
+ export {};
@@ -0,0 +1,60 @@
1
+ // SPDX-License-Identifier: MPL-2.0
2
+ import { useEffect, useMemo } from 'react';
3
+ import { useAwarenessState } from '@ggraphic/editor/collab/useAwarenessState';
4
+ import { messages } from '@ggraphic/editor/i18n/messages';
5
+ import { useCanvasStoreSelector } from '@ggraphic/editor/stores/CanvasStoreProvider';
6
+ export function useSelectionAwareness(provider, options) {
7
+ // The whole selection; a single selected element is in it as well.
8
+ const localSelection = useCanvasStoreSelector((s) => s.selectedLayerIds);
9
+ const activePageId = options?.activePageId ?? null;
10
+ const publish = options?.publish ?? true;
11
+ useEffect(() => {
12
+ if (!provider?.awareness || !publish)
13
+ return;
14
+ provider.awareness.setLocalStateField('selectedLayerIds', localSelection);
15
+ }, [provider, localSelection, publish]);
16
+ useEffect(() => {
17
+ if (!provider?.awareness || !publish)
18
+ return;
19
+ provider.awareness.setLocalStateField('activePageId', activePageId);
20
+ }, [provider, activePageId, publish]);
21
+ const remote = useAwarenessState(provider, (states) => {
22
+ if (!provider?.awareness)
23
+ return [];
24
+ const selfClientId = provider.awareness.clientID;
25
+ const result = [];
26
+ states.forEach((value, clientId) => {
27
+ if (clientId === selfClientId)
28
+ return;
29
+ const record = value;
30
+ if (!record?.user?.id)
31
+ return;
32
+ result.push({
33
+ clientId,
34
+ userId: record.user.id,
35
+ userName: record.user.name || messages().common.anonymous,
36
+ color: record.user.color || '#888',
37
+ selectedLayerIds: record.selectedLayerIds || [],
38
+ activePageId: record.activePageId ?? null,
39
+ });
40
+ });
41
+ return result;
42
+ }, (a, b) => {
43
+ if (a.length !== b.length)
44
+ return false;
45
+ for (let i = 0; i < a.length; i++) {
46
+ if (a[i].clientId !== b[i].clientId)
47
+ return false;
48
+ if (a[i].activePageId !== b[i].activePageId)
49
+ return false;
50
+ if (a[i].selectedLayerIds.length !== b[i].selectedLayerIds.length)
51
+ return false;
52
+ for (let j = 0; j < a[i].selectedLayerIds.length; j++) {
53
+ if (a[i].selectedLayerIds[j] !== b[i].selectedLayerIds[j])
54
+ return false;
55
+ }
56
+ }
57
+ return true;
58
+ });
59
+ return useMemo(() => remote ?? [], [remote]);
60
+ }
@@ -0,0 +1,7 @@
1
+ import type * as Y from 'yjs';
2
+ interface Options {
3
+ parent: Y.Map<unknown> | null;
4
+ isSynced: boolean;
5
+ }
6
+ export declare function useYjsCanvasBinding({ parent, isSynced }: Options): void;
7
+ export {};
@@ -0,0 +1,21 @@
1
+ // SPDX-License-Identifier: MPL-2.0
2
+ import { useEffect } from 'react';
3
+ import { useCanvasStore } from '../stores/CanvasStoreProvider.js';
4
+ import { bindCanvasStoreToYMap, seedCanvasStoreFromYMap } from './yjsBinding.js';
5
+ export function useYjsCanvasBinding({ parent, isSynced }) {
6
+ const store = useCanvasStore();
7
+ useEffect(() => {
8
+ if (!parent?.doc) {
9
+ return undefined;
10
+ }
11
+ // Before the sync the page is a read-only preview of the cached doc.
12
+ if (!isSynced) {
13
+ seedCanvasStoreFromYMap(store, parent);
14
+ return undefined;
15
+ }
16
+ const binding = bindCanvasStoreToYMap({ store, parent });
17
+ return () => {
18
+ binding.destroy();
19
+ };
20
+ }, [store, parent, isSynced]);
21
+ }