@ggraphic/editor 0.1.0-alpha.1 → 0.1.0-alpha.3

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 (671) hide show
  1. package/LICENSE +661 -373
  2. package/NOTICE +2 -1
  3. package/README.md +5 -5
  4. package/THIRD_PARTY_NOTICES +12 -3
  5. package/dist/CanvasEditorProvider.d.ts +8 -8
  6. package/dist/CanvasEditorProvider.js +1 -1
  7. package/dist/ai/applyOperation.d.ts +6 -6
  8. package/dist/ai/applyOperation.js +5 -5
  9. package/dist/ai/describeCanvasElements.d.ts +2 -2
  10. package/dist/ai/describeCanvasElements.js +5 -5
  11. package/dist/ai/illustrationCapability.d.ts +1 -1
  12. package/dist/ai/illustrationCapability.js +2 -2
  13. package/dist/blocks/liftedBlock.d.ts +5 -5
  14. package/dist/blocks/liftedBlock.js +3 -3
  15. package/dist/brand/bindPick.js +1 -1
  16. package/dist/brand/brandRegistry.js +1 -1
  17. package/dist/collab/documentVersion.js +1 -1
  18. package/dist/collab/pageElementStateKeys.js +1 -1
  19. package/dist/collab/pagesDoc.js +1 -1
  20. package/dist/collab/useAwarenessState.js +1 -1
  21. package/dist/collab/useEmitHostStateChanges.js +1 -1
  22. package/dist/collab/useSelectionAwareness.js +4 -4
  23. package/dist/collab/useYjsCanvasBinding.js +1 -1
  24. package/dist/collab/useYjsPageStateSync.d.ts +1 -15
  25. package/dist/collab/useYjsPageStateSync.js +77 -7
  26. package/dist/collab/useYjsPages.d.ts +2 -2
  27. package/dist/collab/useYjsPages.js +4 -4
  28. package/dist/collab/wrapCallbacksWithPageSync.js +1 -1
  29. package/dist/collab/ydocKeys.js +1 -1
  30. package/dist/collab/yjsBinding.js +2 -2
  31. package/dist/common/Lightbox.js +3 -3
  32. package/dist/components/AddPageButton.js +3 -3
  33. package/dist/components/CanvasAnnouncer.js +1 -1
  34. package/dist/components/CanvasContextMenu/CanvasActionSheet.d.ts +1 -1
  35. package/dist/components/CanvasContextMenu/CanvasActionSheet.js +5 -5
  36. package/dist/components/CanvasContextMenu/CanvasContextMenu.d.ts +2 -2
  37. package/dist/components/CanvasContextMenu/CanvasContextMenu.js +1 -1
  38. package/dist/components/CanvasContextMenu/canvasMenuModel.d.ts +1 -1
  39. package/dist/components/CanvasContextMenu/canvasMenuModel.js +3 -3
  40. package/dist/components/CanvasEditor/CanvasEditorShell.d.ts +2 -2
  41. package/dist/components/CanvasEditor/CanvasEditorShell.js +102 -79
  42. package/dist/components/CanvasEditor/PageWrapper.d.ts +1 -1
  43. package/dist/components/CanvasEditor/PageWrapper.js +17 -17
  44. package/dist/components/CanvasEditor/blockInsertContext.d.ts +2 -2
  45. package/dist/components/CanvasEditor/blockInsertContext.js +1 -1
  46. package/dist/components/CanvasEditor/editorShell.d.ts +13 -7
  47. package/dist/components/CanvasEditor/hooks/useCanvasContextMenu.d.ts +1 -1
  48. package/dist/components/CanvasEditor/hooks/useCanvasContextMenu.js +4 -4
  49. package/dist/components/CanvasEditor/hooks/useLoadedConfigs.d.ts +1 -1
  50. package/dist/components/CanvasEditor/hooks/useLoadedConfigs.js +1 -1
  51. package/dist/components/CanvasEditor/hooks/useMobileSheetFit.js +1 -1
  52. package/dist/components/CanvasEditor/hooks/usePageRefs.d.ts +1 -1
  53. package/dist/components/CanvasEditor/hooks/usePageRefs.js +1 -1
  54. package/dist/components/CanvasEditor/hooks/usePageUndoRedoShortcuts.d.ts +1 -1
  55. package/dist/components/CanvasEditor/hooks/usePageUndoRedoShortcuts.js +3 -3
  56. package/dist/components/CanvasEditor/hooks/usePrintImpressumGate.d.ts +1 -1
  57. package/dist/components/CanvasEditor/hooks/usePrintImpressumGate.js +6 -6
  58. package/dist/components/CanvasEditor/hooks/useScrollToAddedPage.js +1 -1
  59. package/dist/components/CanvasEditor/hooks/useToolbarHandlers.d.ts +9 -9
  60. package/dist/components/CanvasEditor/hooks/useToolbarHandlers.js +2 -2
  61. package/dist/components/CanvasEditor/hooks/useWorkAreaDeselect.js +2 -2
  62. package/dist/components/CanvasEditor/layersTab.js +2 -2
  63. package/dist/components/CanvasEditor/mobileSelectionArea.d.ts +1 -1
  64. package/dist/components/CanvasEditor/types.d.ts +17 -6
  65. package/dist/components/CanvasEditorSkeleton.js +4 -4
  66. package/dist/components/CanvasMetaBar.js +2 -2
  67. package/dist/components/CanvasRenderLayer.d.ts +3 -3
  68. package/dist/components/CanvasRenderLayer.js +6 -6
  69. package/dist/components/CanvasTextOverlay.js +6 -6
  70. package/dist/components/ConfigCanvas.js +2 -2
  71. package/dist/components/CropGhostOverlay.js +2 -2
  72. package/dist/components/CustomColorSwatch.js +4 -4
  73. package/dist/components/GenericCanvas.d.ts +21 -10
  74. package/dist/components/GenericCanvas.js +104 -46
  75. package/dist/components/GenericCanvasElement.d.ts +2 -2
  76. package/dist/components/GenericCanvasElement.js +11 -9
  77. package/dist/components/MultiSelectionTransformer.js +5 -5
  78. package/dist/components/PagePreview.js +3 -3
  79. package/dist/components/PageThumbnailStrip.d.ts +1 -1
  80. package/dist/components/PageThumbnailStrip.js +3 -3
  81. package/dist/components/PageToolbar.js +2 -2
  82. package/dist/components/PrintGuides.js +1 -1
  83. package/dist/components/RemoteSelectionOverlay.js +1 -1
  84. package/dist/components/RichTextField.js +5 -5
  85. package/dist/components/SelectionPill.d.ts +1 -1
  86. package/dist/components/SelectionPill.js +6 -6
  87. package/dist/components/SlideNotesPanel.js +2 -2
  88. package/dist/components/SlotBudgetStatus.js +1 -1
  89. package/dist/components/StandaloneCanvas.d.ts +3 -3
  90. package/dist/components/StandaloneCanvas.js +4 -4
  91. package/dist/components/TextFormatButtons.js +4 -4
  92. package/dist/components/TextFormatControls.js +2 -2
  93. package/dist/components/Toolbar.js +6 -6
  94. package/dist/components/ToolbarStateBridge.d.ts +4 -4
  95. package/dist/components/ToolbarStateBridge.js +5 -5
  96. package/dist/components/TopBar/AutoSaveIndicator.js +4 -4
  97. package/dist/components/TopBar/ContextControls.d.ts +8 -8
  98. package/dist/components/TopBar/ContextControls.js +18 -18
  99. package/dist/components/TopBar/ContextToolbar.d.ts +1 -1
  100. package/dist/components/TopBar/ContextToolbar.js +2 -2
  101. package/dist/components/TopBar/CropModeControls.d.ts +1 -1
  102. package/dist/components/TopBar/CropModeControls.js +5 -5
  103. package/dist/components/TopBar/DownloadSection.d.ts +3 -3
  104. package/dist/components/TopBar/DownloadSection.js +20 -20
  105. package/dist/components/TopBar/MobileSelectionBar.d.ts +1 -1
  106. package/dist/components/TopBar/MobileSelectionBar.js +7 -7
  107. package/dist/components/TopBar/MobileSelectionControls.d.ts +1 -1
  108. package/dist/components/TopBar/MobileSelectionControls.js +7 -7
  109. package/dist/components/TopBar/MultiSelectionToolbar.d.ts +1 -1
  110. package/dist/components/TopBar/MultiSelectionToolbar.js +4 -4
  111. package/dist/components/TopBar/ShareDropdown.js +12 -12
  112. package/dist/components/TopBar/barTiles.js +2 -2
  113. package/dist/components/TopBar/modules/FloatingAiSuggestionBanner.d.ts +1 -1
  114. package/dist/components/TopBar/modules/FloatingAiSuggestionBanner.js +5 -5
  115. package/dist/components/TopBar/modules/FloatingBackgroundControls.d.ts +2 -2
  116. package/dist/components/TopBar/modules/FloatingBackgroundControls.js +10 -10
  117. package/dist/components/TopBar/modules/FloatingColorPicker.d.ts +1 -1
  118. package/dist/components/TopBar/modules/FloatingColorPicker.js +6 -6
  119. package/dist/components/TopBar/modules/FloatingFontRoleControl.js +6 -6
  120. package/dist/components/TopBar/modules/FloatingFontSizeControl.js +3 -3
  121. package/dist/components/TopBar/modules/FloatingHistoryControls.js +2 -2
  122. package/dist/components/TopBar/modules/FloatingImageLookControl.d.ts +1 -1
  123. package/dist/components/TopBar/modules/FloatingImageLookControl.js +3 -3
  124. package/dist/components/TopBar/modules/FloatingLayerControls.js +2 -2
  125. package/dist/components/TopBar/modules/FloatingOpacityControl.js +4 -4
  126. package/dist/components/TopBar/modules/FloatingPositionControl.d.ts +1 -1
  127. package/dist/components/TopBar/modules/FloatingPositionControl.js +6 -6
  128. package/dist/components/TopBar/modules/FloatingTextAlignControl.d.ts +1 -1
  129. package/dist/components/TopBar/modules/FloatingTextAlignControl.js +4 -4
  130. package/dist/components/TransformHud.js +1 -1
  131. package/dist/components/WholeTextFormatControls.js +1 -1
  132. package/dist/components/accentMark.js +1 -1
  133. package/dist/components/canvasItemLock.js +1 -1
  134. package/dist/components/kindRenderers.d.ts +6 -6
  135. package/dist/components/kindRenderers.js +10 -10
  136. package/dist/components/markColor.js +1 -1
  137. package/dist/components/markerMark.js +1 -1
  138. package/dist/composer/cardFollowsText.d.ts +2 -2
  139. package/dist/composer/cardFollowsText.js +2 -2
  140. package/dist/composer/marks.js +1 -1
  141. package/dist/composer/steckbriefLayout.d.ts +1 -1
  142. package/dist/composer/steckbriefLayout.js +2 -2
  143. package/dist/composer/textFit.js +1 -1
  144. package/dist/configs/buildCanvasText.d.ts +5 -0
  145. package/dist/configs/buildCanvasText.js +58 -0
  146. package/dist/configs/buildSharepicText.d.ts +2 -5
  147. package/dist/configs/buildSharepicText.js +3 -58
  148. package/dist/configs/configLoader.d.ts +1 -1
  149. package/dist/configs/configLoader.js +3 -3
  150. package/dist/configs/factory/actionFactories.d.ts +17 -13
  151. package/dist/configs/factory/actionFactories.js +41 -25
  152. package/dist/configs/factory/baseTypes.d.ts +10 -10
  153. package/dist/configs/factory/baseTypes.js +1 -1
  154. package/dist/configs/factory/carryInstanceState.d.ts +8 -8
  155. package/dist/configs/factory/carryInstanceState.js +3 -3
  156. package/dist/configs/factory/createTextElement.d.ts +1 -1
  157. package/dist/configs/factory/createTextElement.js +2 -2
  158. package/dist/configs/factory/defineSection.d.ts +1 -1
  159. package/dist/configs/factory/layoutAccessors.d.ts +1 -1
  160. package/dist/configs/featureInjector.d.ts +2 -2
  161. package/dist/configs/featureInjector.js +3 -3
  162. package/dist/configs/pageInheritance.d.ts +10 -1
  163. package/dist/configs/pageInheritance.js +38 -10
  164. package/dist/configs/placeholders.js +2 -2
  165. package/dist/configs/shareSection.d.ts +3 -3
  166. package/dist/configs/shareSection.js +13 -9
  167. package/dist/configs/types.d.ts +14 -6
  168. package/dist/configs/unifiedTabs.js +1 -1
  169. package/dist/embed/EmbeddedEditor.d.ts +4 -0
  170. package/dist/embed/EmbeddedEditor.js +68 -0
  171. package/dist/embed/GgraphicEditor.d.ts +2 -0
  172. package/dist/embed/GgraphicEditor.js +16 -0
  173. package/dist/embed/blankPage.d.ts +6 -0
  174. package/dist/embed/blankPage.js +7 -0
  175. package/dist/embed/index.d.ts +7 -0
  176. package/dist/embed/index.js +6 -0
  177. package/dist/embed/loadTemplatePack.d.ts +8 -0
  178. package/dist/embed/loadTemplatePack.js +9 -0
  179. package/dist/embed/types.d.ts +44 -0
  180. package/dist/embed/types.js +1 -0
  181. package/dist/entries/ai.d.ts +5 -0
  182. package/dist/entries/ai.js +5 -0
  183. package/dist/entries/brand.d.ts +4 -0
  184. package/dist/entries/brand.js +5 -0
  185. package/dist/entries/canvas.d.ts +5 -0
  186. package/dist/entries/canvas.js +6 -0
  187. package/dist/entries/collab.d.ts +6 -0
  188. package/dist/entries/collab.js +7 -0
  189. package/dist/entries/config.d.ts +12 -0
  190. package/dist/entries/config.js +9 -0
  191. package/dist/entries/elements.d.ts +21 -0
  192. package/dist/entries/elements.js +17 -0
  193. package/dist/entries/embed.d.ts +2 -0
  194. package/dist/entries/embed.js +7 -0
  195. package/dist/entries/export.d.ts +8 -0
  196. package/dist/entries/export.js +7 -0
  197. package/dist/entries/host.d.ts +31 -0
  198. package/dist/entries/host.js +11 -0
  199. package/dist/entries/hostReact.d.ts +9 -0
  200. package/dist/entries/hostReact.js +11 -0
  201. package/dist/entries/i18n.d.ts +2 -0
  202. package/dist/entries/i18n.js +3 -0
  203. package/dist/entries/illustrations/gophers.d.ts +2 -0
  204. package/dist/entries/illustrations/gophers.js +3 -0
  205. package/dist/entries/illustrations/humaaans.d.ts +2 -0
  206. package/dist/entries/illustrations/humaaans.js +3 -0
  207. package/dist/entries/illustrations/illlustrations.d.ts +2 -0
  208. package/dist/entries/illustrations/illlustrations.js +3 -0
  209. package/dist/entries/illustrations/kawaii.d.ts +2 -0
  210. package/dist/entries/illustrations/kawaii.js +3 -0
  211. package/dist/entries/illustrations/opendoodles.d.ts +2 -0
  212. package/dist/entries/illustrations/opendoodles.js +3 -0
  213. package/dist/entries/illustrations/openpeeps.d.ts +2 -0
  214. package/dist/entries/illustrations/openpeeps.js +3 -0
  215. package/dist/entries/illustrations/transhumans.d.ts +2 -0
  216. package/dist/entries/illustrations/transhumans.js +3 -0
  217. package/dist/entries/kinds.d.ts +101 -0
  218. package/dist/entries/kinds.js +100 -0
  219. package/dist/entries/page.d.ts +13 -0
  220. package/dist/entries/page.js +13 -0
  221. package/dist/entries/services.d.ts +6 -0
  222. package/dist/entries/services.js +4 -0
  223. package/dist/entries/shell.d.ts +14 -0
  224. package/dist/entries/shell.js +13 -0
  225. package/dist/entries/sidebar.d.ts +15 -0
  226. package/dist/entries/sidebar.js +13 -0
  227. package/dist/entries/store.d.ts +3 -0
  228. package/dist/entries/store.js +4 -0
  229. package/dist/entries/templates.d.ts +4 -0
  230. package/dist/entries/templates.js +5 -0
  231. package/dist/entries/text.d.ts +6 -0
  232. package/dist/entries/text.js +7 -0
  233. package/dist/export/pptx/buildPptxModel.d.ts +1 -1
  234. package/dist/export/pptx/buildPptxModel.js +10 -10
  235. package/dist/export/pptx/exportPptxDeck.d.ts +2 -2
  236. package/dist/export/pptx/exportPptxDeck.js +3 -3
  237. package/dist/export/pptx/pptxFonts.js +1 -1
  238. package/dist/export/pptx/pptxUnits.js +1 -1
  239. package/dist/export/pptx/textModel.d.ts +1 -1
  240. package/dist/export/pptx/textModel.js +1 -1
  241. package/dist/export/pptx/types.js +1 -1
  242. package/dist/export/pptx/writePptx.d.ts +5 -2
  243. package/dist/export/pptx/writePptx.js +7 -4
  244. package/dist/export/pptx/writeText.d.ts +60 -6
  245. package/dist/export/pptx/writeText.js +3 -3
  246. package/dist/export/printExport.d.ts +1 -1
  247. package/dist/export/printExport.js +3 -3
  248. package/dist/export/printPdf.js +1 -1
  249. package/dist/export/slidesPdf.js +2 -2
  250. package/dist/formats/index.d.ts +39 -15
  251. package/dist/formats/index.js +52 -96
  252. package/dist/formats/legacyCatalog.d.ts +21 -0
  253. package/dist/formats/legacyCatalog.js +76 -0
  254. package/dist/groups/pageGroups.js +1 -1
  255. package/dist/hooks/editorBox.d.ts +20 -0
  256. package/dist/hooks/editorBox.js +65 -0
  257. package/dist/hooks/index.d.ts +13 -13
  258. package/dist/hooks/index.js +10 -10
  259. package/dist/hooks/stageFit.d.ts +24 -0
  260. package/dist/hooks/stageFit.js +76 -0
  261. package/dist/hooks/useAiImageGeneration.js +3 -3
  262. package/dist/hooks/useAnnounce.js +1 -1
  263. package/dist/hooks/useBoxSnap.js +1 -1
  264. package/dist/hooks/useCanvasAutoSave.js +2 -2
  265. package/dist/hooks/useCanvasElementHandlers.d.ts +6 -6
  266. package/dist/hooks/useCanvasElementHandlers.js +1 -1
  267. package/dist/hooks/useCanvasHistorySetup.d.ts +2 -0
  268. package/dist/hooks/useCanvasHistorySetup.js +3 -2
  269. package/dist/hooks/useCanvasInteractions.d.ts +1 -1
  270. package/dist/hooks/useCanvasInteractions.js +2 -2
  271. package/dist/hooks/useCanvasKeyboardHandlers.d.ts +1 -1
  272. package/dist/hooks/useCanvasKeyboardHandlers.js +5 -5
  273. package/dist/hooks/useCanvasStoreReset.js +1 -1
  274. package/dist/hooks/useCanvasUndoRedo.d.ts +2 -0
  275. package/dist/hooks/useCanvasUndoRedo.js +8 -4
  276. package/dist/hooks/useContextPress.js +4 -4
  277. package/dist/hooks/useCropSession.js +2 -2
  278. package/dist/hooks/useDebounce.js +1 -1
  279. package/dist/hooks/useDeckAutoSave.js +4 -4
  280. package/dist/hooks/useDeepSelect.js +3 -3
  281. package/dist/hooks/useElementSnapping.js +1 -1
  282. package/dist/hooks/useEmojiCatalog.js +1 -1
  283. package/dist/hooks/useFloatingModuleHandlers.d.ts +3 -3
  284. package/dist/hooks/useFloatingModuleHandlers.js +2 -2
  285. package/dist/hooks/useFloatingModuleState.d.ts +3 -3
  286. package/dist/hooks/useFloatingModuleState.js +2 -2
  287. package/dist/hooks/useFontGeneration.d.ts +1 -9
  288. package/dist/hooks/useFontGeneration.js +4 -49
  289. package/dist/hooks/useFontLoader.d.ts +1 -9
  290. package/dist/hooks/useFontLoader.js +3 -17
  291. package/dist/hooks/useGeometryReporter.js +1 -1
  292. package/dist/hooks/useHoverOutline.js +1 -1
  293. package/dist/hooks/useIconCatalog.js +1 -1
  294. package/dist/hooks/useIconSearch.js +1 -1
  295. package/dist/hooks/useIconSetsFor.js +2 -2
  296. package/dist/hooks/useImageCoverFit.js +1 -1
  297. package/dist/hooks/useIsCanvasMobile.d.ts +5 -1
  298. package/dist/hooks/useIsCanvasMobile.js +11 -3
  299. package/dist/hooks/useMarqueeSelection.js +3 -3
  300. package/dist/hooks/useMobileSheet.js +1 -1
  301. package/dist/hooks/useMultiPageExport.d.ts +1 -1
  302. package/dist/hooks/useMultiPageExport.js +4 -4
  303. package/dist/hooks/usePageManager.d.ts +3 -2
  304. package/dist/hooks/usePageManager.js +11 -9
  305. package/dist/hooks/usePageThumbnails.js +1 -1
  306. package/dist/hooks/usePaginatedIcons.js +1 -1
  307. package/dist/hooks/useRovingToolbar.js +1 -1
  308. package/dist/hooks/useSelectionAnnouncement.js +3 -3
  309. package/dist/hooks/useSnapScheduler.js +1 -1
  310. package/dist/hooks/useTrackUnsplashDownload.d.ts +1 -1
  311. package/dist/hooks/useTrackUnsplashDownload.js +2 -2
  312. package/dist/hooks/useZoomGestures.js +1 -1
  313. package/dist/hostServices.d.ts +53 -31
  314. package/dist/hostServices.js +7 -5
  315. package/dist/i18n/catalogue.d.ts +21 -0
  316. package/dist/i18n/catalogue.js +58 -0
  317. package/dist/i18n/de.d.ts +14 -15
  318. package/dist/i18n/de.js +17 -33
  319. package/dist/i18n/en.js +16 -32
  320. package/dist/i18n/messages.d.ts +1 -13
  321. package/dist/i18n/messages.js +3 -53
  322. package/dist/layouts/CanvasEditorLayout.d.ts +1 -1
  323. package/dist/layouts/CanvasEditorLayout.js +12 -8
  324. package/dist/layouts/index.js +1 -1
  325. package/dist/page/actions.d.ts +9 -9
  326. package/dist/page/actions.js +9 -9
  327. package/dist/page/config.d.ts +1 -1
  328. package/dist/page/config.js +53 -16
  329. package/dist/page/fitting.js +2 -2
  330. package/dist/page/hug.js +2 -2
  331. package/dist/page/instantiate.js +3 -3
  332. package/dist/page/logoSize.js +1 -1
  333. package/dist/page/pageState.d.ts +1 -1
  334. package/dist/page/pageState.js +2 -2
  335. package/dist/page/templatePack.js +1 -1
  336. package/dist/page/typography.js +1 -1
  337. package/dist/primitives/AssetPrimitive.d.ts +2 -2
  338. package/dist/primitives/AssetPrimitive.js +16 -14
  339. package/dist/primitives/CanvasBackground.js +1 -1
  340. package/dist/primitives/CanvasIcons.js +2 -2
  341. package/dist/primitives/CanvasImage.d.ts +4 -4
  342. package/dist/primitives/CanvasImage.js +10 -10
  343. package/dist/primitives/CanvasRichText.js +14 -14
  344. package/dist/primitives/CanvasStage.d.ts +7 -1
  345. package/dist/primitives/CanvasStage.js +30 -17
  346. package/dist/primitives/CanvasText.d.ts +6 -6
  347. package/dist/primitives/CanvasText.js +12 -12
  348. package/dist/primitives/ChartPrimitive.d.ts +2 -2
  349. package/dist/primitives/ChartPrimitive.js +7 -7
  350. package/dist/primitives/CircleBadge.d.ts +1 -1
  351. package/dist/primitives/CircleBadge.js +9 -9
  352. package/dist/primitives/FramePrimitive.d.ts +2 -2
  353. package/dist/primitives/FramePrimitive.js +6 -6
  354. package/dist/primitives/IconPrimitive.js +1 -1
  355. package/dist/primitives/IllustrationPrimitive.d.ts +2 -2
  356. package/dist/primitives/IllustrationPrimitive.js +7 -7
  357. package/dist/primitives/PillBadge.d.ts +1 -1
  358. package/dist/primitives/PillBadge.js +11 -11
  359. package/dist/primitives/ShapePrimitive.d.ts +2 -2
  360. package/dist/primitives/ShapePrimitive.js +10 -10
  361. package/dist/primitives/SnapGuidelines.js +1 -1
  362. package/dist/primitives/UserImagePrimitive.d.ts +2 -2
  363. package/dist/primitives/UserImagePrimitive.js +26 -20
  364. package/dist/primitives/index.d.ts +12 -12
  365. package/dist/primitives/index.js +8 -8
  366. package/dist/sidebar/SidebarPanel.d.ts +1 -1
  367. package/dist/sidebar/SidebarPanel.js +8 -8
  368. package/dist/sidebar/SidebarTabBar.d.ts +1 -1
  369. package/dist/sidebar/SidebarTabBar.js +6 -6
  370. package/dist/sidebar/SubsectionTabBar.js +6 -6
  371. package/dist/sidebar/UserUploadsProvider.js +3 -3
  372. package/dist/sidebar/components/AltTextField.js +4 -4
  373. package/dist/sidebar/components/SidebarHint.js +3 -3
  374. package/dist/sidebar/components/SidebarSlider.js +1 -1
  375. package/dist/sidebar/components/TextFieldPrimitives.d.ts +1 -1
  376. package/dist/sidebar/components/TextFieldPrimitives.js +2 -2
  377. package/dist/sidebar/coreSidebar.d.ts +23 -0
  378. package/dist/sidebar/coreSidebar.js +12 -0
  379. package/dist/sidebar/coreSidebarParts.d.ts +3 -0
  380. package/dist/sidebar/coreSidebarParts.js +20 -0
  381. package/dist/sidebar/sections/AssetGallery.d.ts +33 -0
  382. package/dist/sidebar/sections/AssetGallery.js +58 -0
  383. package/dist/sidebar/sections/ChartSettingsSection.d.ts +1 -1
  384. package/dist/sidebar/sections/ChartSettingsSection.js +7 -7
  385. package/dist/sidebar/sections/ChartsSection.d.ts +9 -0
  386. package/dist/sidebar/sections/ChartsSection.js +40 -0
  387. package/dist/sidebar/sections/CombinedTextSection.d.ts +2 -2
  388. package/dist/sidebar/sections/CombinedTextSection.js +8 -8
  389. package/dist/sidebar/sections/DiagrammeSection.d.ts +6 -9
  390. package/dist/sidebar/sections/DiagrammeSection.js +5 -40
  391. package/dist/sidebar/sections/EffectsSection.d.ts +3 -3
  392. package/dist/sidebar/sections/EffectsSection.js +5 -5
  393. package/dist/sidebar/sections/FormenSection.d.ts +6 -28
  394. package/dist/sidebar/sections/FormenSection.js +5 -440
  395. package/dist/sidebar/sections/FrameSettingsSection.d.ts +1 -1
  396. package/dist/sidebar/sections/FrameSettingsSection.js +4 -4
  397. package/dist/sidebar/sections/FramesSection.d.ts +7 -0
  398. package/dist/sidebar/sections/FramesSection.js +18 -0
  399. package/dist/sidebar/sections/GenericShareSection.js +9 -9
  400. package/dist/sidebar/sections/IconsSection.js +7 -5
  401. package/dist/sidebar/sections/IllustrationSettings.d.ts +1 -1
  402. package/dist/sidebar/sections/IllustrationSettings.js +6 -6
  403. package/dist/sidebar/sections/IllustrationThumb.d.ts +1 -1
  404. package/dist/sidebar/sections/IllustrationThumb.js +3 -3
  405. package/dist/sidebar/sections/ImageAdjustSection.d.ts +1 -1
  406. package/dist/sidebar/sections/ImageAdjustSection.js +9 -9
  407. package/dist/sidebar/sections/LayersSection.d.ts +2 -2
  408. package/dist/sidebar/sections/LayersSection.js +4 -4
  409. package/dist/sidebar/sections/RahmenSection.d.ts +2 -7
  410. package/dist/sidebar/sections/RahmenSection.js +3 -18
  411. package/dist/sidebar/sections/ShapesSection.d.ts +28 -0
  412. package/dist/sidebar/sections/ShapesSection.js +440 -0
  413. package/dist/sidebar/sections/StudioGallery.d.ts +4 -33
  414. package/dist/sidebar/sections/StudioGallery.js +5 -58
  415. package/dist/sidebar/sections/UploadsSection.js +12 -12
  416. package/dist/sidebar/sections/assets/AssetsSection.d.ts +8 -8
  417. package/dist/sidebar/sections/assets/AssetsSection.js +3 -3
  418. package/dist/sidebar/sections/assets/BackgroundCatalog.d.ts +1 -1
  419. package/dist/sidebar/sections/assets/BackgroundCatalog.js +8 -8
  420. package/dist/sidebar/sections/assets/CategoryCard.js +2 -2
  421. package/dist/sidebar/sections/assets/ElementGrid.js +1 -1
  422. package/dist/sidebar/sections/assets/ElementThumb.js +11 -9
  423. package/dist/sidebar/sections/assets/ElementTile.js +5 -5
  424. package/dist/sidebar/sections/assets/ElementsPanel.js +13 -13
  425. package/dist/sidebar/sections/assets/EmojiTonePicker.js +3 -3
  426. package/dist/sidebar/sections/assets/FotosCatalog.js +6 -6
  427. package/dist/sidebar/sections/assets/IconifyCatalog.d.ts +1 -1
  428. package/dist/sidebar/sections/assets/IconifyCatalog.js +5 -5
  429. package/dist/sidebar/sections/assets/RecentCarousel.js +5 -5
  430. package/dist/sidebar/sections/assets/StickerCatalog.js +6 -6
  431. package/dist/sidebar/sections/assets/constants.d.ts +1 -1
  432. package/dist/sidebar/sections/assets/constants.js +1 -1
  433. package/dist/sidebar/sections/assets/elementPanelHost.d.ts +2 -2
  434. package/dist/sidebar/sections/assets/elementSearch.js +2 -2
  435. package/dist/sidebar/sections/assets/elementTypes.d.ts +6 -6
  436. package/dist/sidebar/sections/assets/elementTypes.js +2 -2
  437. package/dist/sidebar/sections/assets/index.js +1 -1
  438. package/dist/sidebar/sections/assets/useElementCatalog.d.ts +4 -4
  439. package/dist/sidebar/sections/assets/useElementCatalog.js +14 -14
  440. package/dist/sidebar/sections/assets/useRecentElements.js +3 -3
  441. package/dist/sidebar/sections/assets/useStockPhotos.d.ts +2 -2
  442. package/dist/sidebar/sections/assets/useStockPhotos.js +4 -4
  443. package/dist/sidebar/sections/effects/EffectCard.js +3 -3
  444. package/dist/sidebar/sections/effects/GradientSettings.d.ts +1 -1
  445. package/dist/sidebar/sections/effects/GradientSettings.js +7 -7
  446. package/dist/sidebar/sections/effects/OutlineSettings.js +6 -6
  447. package/dist/sidebar/sections/effects/ShadowSettings.d.ts +1 -1
  448. package/dist/sidebar/sections/effects/ShadowSettings.js +6 -6
  449. package/dist/sidebar/sections/effects/effectsFor.d.ts +1 -1
  450. package/dist/sidebar/sections/effects/effectsFor.js +2 -2
  451. package/dist/sidebar/sections/index.d.ts +6 -2
  452. package/dist/sidebar/sections/index.js +6 -4
  453. package/dist/sidebar/sections/lazyWithPreload.js +1 -1
  454. package/dist/sidebar/sections/registerBundledIconSets.d.ts +6 -0
  455. package/dist/sidebar/sections/registerBundledIconSets.js +11 -0
  456. package/dist/sidebar/sections/tools/AiCreateTool.js +4 -4
  457. package/dist/sidebar/sections/tools/AiEditTool.js +6 -6
  458. package/dist/sidebar/sections/tools/AltTextTool.d.ts +1 -1
  459. package/dist/sidebar/sections/tools/AltTextTool.js +6 -6
  460. package/dist/sidebar/sections/tools/BlobCreatorTool.js +6 -6
  461. package/dist/sidebar/sections/tools/GradientTextTool.js +8 -8
  462. package/dist/sidebar/sections/tools/ImageInputPicker.js +7 -7
  463. package/dist/sidebar/sections/tools/QRCodeTool.js +6 -6
  464. package/dist/sidebar/sections/tools/RemoveBackgroundTool.js +5 -5
  465. package/dist/sidebar/sections/tools/TextPathCreatorTool.js +8 -8
  466. package/dist/sidebar/sections/tools/ToolPanel.js +3 -3
  467. package/dist/sidebar/sections/tools/ToolTiles.js +2 -2
  468. package/dist/sidebar/sections/tools/ToolsSection.d.ts +2 -2
  469. package/dist/sidebar/sections/tools/ToolsSection.js +18 -18
  470. package/dist/sidebar/sections/tools/UnsplashLimitNotice.js +3 -3
  471. package/dist/sidebar/sections/tools/UnsplashTool.d.ts +1 -1
  472. package/dist/sidebar/sections/tools/UnsplashTool.js +9 -9
  473. package/dist/sidebar/sections/tools/index.js +1 -1
  474. package/dist/sidebar/sections/tools/toolTiles.css +1 -1
  475. package/dist/sidebar/sections/tools/useToolImagePlacement.js +1 -1
  476. package/dist/sidebar/sections/usePreloadSections.d.ts +16 -0
  477. package/dist/sidebar/sections/usePreloadSections.js +29 -0
  478. package/dist/sidebar/sections/whenIdle.js +1 -1
  479. package/dist/sidebar/sidebarStyles.js +1 -1
  480. package/dist/sidebar/tabTypes.d.ts +1 -1
  481. package/dist/sidebar/types.d.ts +4 -4
  482. package/dist/sidebar/useImagePlacement.d.ts +1 -1
  483. package/dist/sidebar/useImagePlacement.js +5 -5
  484. package/dist/stores/AutoSaveStoreProvider.js +1 -1
  485. package/dist/stores/CanvasStoreProvider.js +1 -1
  486. package/dist/stores/createAutoSaveStore.js +1 -1
  487. package/dist/stores/createCanvasEditorStore.d.ts +15 -4
  488. package/dist/stores/createCanvasEditorStore.js +49 -3
  489. package/dist/stores/useAutoSaveStore.js +1 -1
  490. package/dist/styles/compiled.css +2 -2
  491. package/dist/styles/editor.css +34 -42
  492. package/dist/styles/index.css +1 -1
  493. package/dist/styles/tailwind.css +21 -4
  494. package/dist/styles/tokens.css +4 -3
  495. package/dist/templates/fontWidths.generated.js +1 -1
  496. package/dist/templates/registry.js +1 -1
  497. package/dist/templates/templateGeometry.js +27 -2
  498. package/dist/templates/testKinds.d.ts +1 -1
  499. package/dist/templates/testKinds.js +2 -2
  500. package/dist/testing/documentBrandPacks.js +1 -1
  501. package/dist/testing/fixtureTemplates.d.ts +1 -1
  502. package/dist/testing/fixtureTemplates.js +2 -2
  503. package/dist/testing/stampKind.js +1 -1
  504. package/dist/types/editorTypes.js +1 -1
  505. package/dist/ui/alert-dialog.js +1 -1
  506. package/dist/ui/button.js +1 -1
  507. package/dist/ui/dialog.js +2 -2
  508. package/dist/ui/editorScope.js +1 -1
  509. package/dist/ui/icon-button.js +1 -1
  510. package/dist/ui/label.js +1 -1
  511. package/dist/ui/masonry-grid.js +1 -1
  512. package/dist/ui/popover.js +1 -1
  513. package/dist/ui/select.js +1 -1
  514. package/dist/ui/skeleton.js +1 -1
  515. package/dist/ui/switch.js +1 -1
  516. package/dist/utils/alignment.js +1 -1
  517. package/dist/utils/axisLock.js +1 -1
  518. package/dist/utils/backgroundPhotoCrop.js +1 -1
  519. package/dist/utils/canvasAssets.d.ts +3 -3
  520. package/dist/utils/canvasAssets.js +1 -1
  521. package/dist/utils/canvasClipboard.js +1 -1
  522. package/dist/utils/canvasCommandRegistry.js +2 -2
  523. package/dist/utils/canvasCommands.d.ts +3 -3
  524. package/dist/utils/canvasCommands.js +8 -8
  525. package/dist/utils/canvasFontFamilies.js +1 -1
  526. package/dist/utils/canvasIcons.d.ts +7 -0
  527. package/dist/utils/canvasIcons.js +17 -5
  528. package/dist/utils/canvasItem.d.ts +7 -7
  529. package/dist/utils/canvasLayerManager.d.ts +11 -7
  530. package/dist/utils/canvasLayerManager.js +12 -7
  531. package/dist/utils/captureStage.d.ts +1 -1
  532. package/dist/utils/captureStage.js +2 -2
  533. package/dist/utils/chartTypes.js +1 -1
  534. package/dist/utils/chartUtils.d.ts +2 -2
  535. package/dist/utils/chartUtils.js +4 -4
  536. package/dist/utils/circleBadgeUtils.js +3 -3
  537. package/dist/utils/cn.js +1 -1
  538. package/dist/utils/collectAltTextPages.d.ts +2 -2
  539. package/dist/utils/collectAltTextPages.js +2 -2
  540. package/dist/utils/colorLuminance.js +1 -1
  541. package/dist/utils/colorNames.js +3 -3
  542. package/dist/utils/colorOptions.js +1 -1
  543. package/dist/utils/coverFit.js +1 -1
  544. package/dist/utils/cropAspect.js +2 -2
  545. package/dist/utils/cropGhost.d.ts +1 -1
  546. package/dist/utils/cropGhost.js +1 -1
  547. package/dist/utils/cropSession.d.ts +1 -1
  548. package/dist/utils/cropSession.js +2 -2
  549. package/dist/utils/cropTarget.d.ts +1 -1
  550. package/dist/utils/cropTarget.js +1 -1
  551. package/dist/utils/deepSelect.js +1 -1
  552. package/dist/utils/downloadError.js +2 -2
  553. package/dist/utils/duplicateElement.d.ts +7 -7
  554. package/dist/utils/duplicateElement.js +1 -1
  555. package/dist/utils/editorFocus.js +1 -1
  556. package/dist/utils/elementKinds.js +1 -1
  557. package/dist/utils/emoji/emojiCatalog.d.ts +1 -1
  558. package/dist/utils/emoji/emojiCatalog.js +3 -3
  559. package/dist/utils/ensureFontsReady.d.ts +8 -2
  560. package/dist/utils/ensureFontsReady.js +20 -10
  561. package/dist/utils/expandImage.js +2 -2
  562. package/dist/utils/externalIcons.js +2 -2
  563. package/dist/utils/filterCache.js +1 -1
  564. package/dist/utils/filterUtils.js +1 -1
  565. package/dist/utils/fontAliases.js +1 -1
  566. package/dist/utils/fontGeneration.d.ts +16 -0
  567. package/dist/utils/fontGeneration.js +56 -0
  568. package/dist/utils/fontMarkSupport.js +2 -2
  569. package/dist/utils/fontSpecs.d.ts +9 -0
  570. package/dist/utils/fontSpecs.js +17 -0
  571. package/dist/utils/framePresets.d.ts +19 -0
  572. package/dist/utils/framePresets.js +260 -0
  573. package/dist/utils/frameUtils.d.ts +3 -18
  574. package/dist/utils/frameUtils.js +2 -261
  575. package/dist/utils/gradientFill.js +1 -1
  576. package/dist/utils/gradientHitArea.js +1 -1
  577. package/dist/utils/grain.js +1 -1
  578. package/dist/utils/grainSpec.js +1 -1
  579. package/dist/utils/groupSnap.js +1 -1
  580. package/dist/utils/handDrawn.js +1 -1
  581. package/dist/utils/historyStamp.js +1 -1
  582. package/dist/utils/hostStorageKeys.js +1 -1
  583. package/dist/utils/iconInstances.d.ts +1 -1
  584. package/dist/utils/iconInstances.js +1 -1
  585. package/dist/utils/illustrations/gophers.d.ts +1 -1
  586. package/dist/utils/illustrations/gophers.js +1 -1
  587. package/dist/utils/illustrations/humaaans.d.ts +1 -1
  588. package/dist/utils/illustrations/humaaans.js +1 -1
  589. package/dist/utils/illustrations/illlustrations.d.ts +1 -1
  590. package/dist/utils/illustrations/illlustrations.js +1 -1
  591. package/dist/utils/illustrations/kawaii.d.ts +1 -1
  592. package/dist/utils/illustrations/kawaii.js +1 -1
  593. package/dist/utils/illustrations/opendoodles.d.ts +1 -1
  594. package/dist/utils/illustrations/opendoodles.js +1 -1
  595. package/dist/utils/illustrations/openpeeps.d.ts +1 -1
  596. package/dist/utils/illustrations/openpeeps.js +1 -1
  597. package/dist/utils/illustrations/prefetchAnalytics.js +1 -1
  598. package/dist/utils/illustrations/registry.d.ts +3 -3
  599. package/dist/utils/illustrations/registry.js +3 -3
  600. package/dist/utils/illustrations/svgCache.d.ts +1 -1
  601. package/dist/utils/illustrations/svgCache.js +1 -1
  602. package/dist/utils/illustrations/transhumans.d.ts +1 -1
  603. package/dist/utils/illustrations/transhumans.js +1 -1
  604. package/dist/utils/illustrations/types.js +2 -2
  605. package/dist/utils/imageElementComparison.js +4 -4
  606. package/dist/utils/imageFilters.d.ts +1 -3
  607. package/dist/utils/imageFilters.js +8 -12
  608. package/dist/utils/imageLook.js +1 -1
  609. package/dist/utils/keyboardCrop.d.ts +1 -1
  610. package/dist/utils/keyboardCrop.js +4 -4
  611. package/dist/utils/keyboardOwnership.js +1 -1
  612. package/dist/utils/layerLabels.js +3 -3
  613. package/dist/utils/layerLock.js +1 -1
  614. package/dist/utils/layerSelection.js +1 -1
  615. package/dist/utils/markerColors.js +2 -2
  616. package/dist/utils/mediaDrop.d.ts +13 -7
  617. package/dist/utils/mediaDrop.js +13 -7
  618. package/dist/utils/mediaPlacement.js +3 -3
  619. package/dist/utils/motifSizes.js +1 -1
  620. package/dist/utils/multiSelect.js +1 -1
  621. package/dist/utils/notch.js +1 -1
  622. package/dist/utils/orientElement.js +1 -1
  623. package/dist/utils/orientation.js +1 -1
  624. package/dist/utils/pageCounter.js +1 -1
  625. package/dist/utils/pendingImages.d.ts +17 -4
  626. package/dist/utils/pendingImages.js +18 -14
  627. package/dist/utils/photoCredit.js +2 -2
  628. package/dist/utils/photoCredits.d.ts +1 -1
  629. package/dist/utils/photoCredits.js +2 -2
  630. package/dist/utils/photoPlaceholder.js +2 -2
  631. package/dist/utils/pillBadgeUtils.js +3 -3
  632. package/dist/utils/plainTextLayout.js +1 -1
  633. package/dist/utils/rebaseHistoryState.d.ts +71 -0
  634. package/dist/utils/rebaseHistoryState.js +208 -0
  635. package/dist/utils/removeElement.js +1 -1
  636. package/dist/utils/renderedBoxes.d.ts +5 -5
  637. package/dist/utils/renderedBoxes.js +3 -3
  638. package/dist/utils/resolveElementValue.js +2 -2
  639. package/dist/utils/scrollBehavior.js +1 -1
  640. package/dist/utils/searchTranslations.js +1 -1
  641. package/dist/utils/selectionCapabilities.js +1 -1
  642. package/dist/utils/shade.js +1 -1
  643. package/dist/utils/shapeTransform.js +1 -1
  644. package/dist/utils/shapes.d.ts +2 -2
  645. package/dist/utils/shapes.js +2 -2
  646. package/dist/utils/smartCrop.d.ts +2 -2
  647. package/dist/utils/smartCrop.js +5 -5
  648. package/dist/utils/snapping.js +1 -1
  649. package/dist/utils/stateTypeAssertions.js +1 -1
  650. package/dist/utils/straighten.js +1 -1
  651. package/dist/utils/surfaceGlow.js +2 -2
  652. package/dist/utils/templateElementInstance.js +2 -2
  653. package/dist/utils/templateRotation.js +2 -2
  654. package/dist/utils/textAlign.js +1 -1
  655. package/dist/utils/textEditorOpeners.js +1 -1
  656. package/dist/utils/textRouting.js +1 -1
  657. package/dist/utils/textUtils.js +2 -2
  658. package/dist/utils/transformHudLabel.js +1 -1
  659. package/dist/utils/unsplashLinks.js +2 -2
  660. package/dist/utils/userImageCrop.d.ts +1 -1
  661. package/dist/utils/userImageCrop.js +3 -3
  662. package/dist/utils/userImageUtils.d.ts +2 -0
  663. package/dist/utils/userImageUtils.js +6 -1
  664. package/dist/utils/viewport.d.ts +12 -8
  665. package/dist/utils/viewport.js +18 -14
  666. package/dist/utils/zipPageImages.js +2 -2
  667. package/dist/vendor/pptxgen.LICENSES.txt +1023 -0
  668. package/dist/vendor/pptxgen.d.ts +2679 -0
  669. package/dist/vendor/pptxgen.js +8831 -0
  670. package/package.json +180 -25
  671. package/skills/ggraphic-embed/SKILL.md +174 -53
@@ -1,11 +1,11 @@
1
1
  export type CanvasFormatCategory = 'digital' | 'print';
2
2
  /**
3
- * UI-level grouping shown as section headers on the /studio page. 3:4 is its
4
- * own group because only freeform lays out on it; the templates stay 4:5.
5
- * The square belongs to the profile picture alone. `print` is not one of the
6
- * studio groups (see canvasFormatGroupOrder).
3
+ * UI-level grouping a host's format picker shows as section headers. `slides`
4
+ * is what makes a format a slide deck (`isSlideFormat`). `print` holds no
5
+ * built-in format; it is there for a host's print formats and is not one of
6
+ * the picker groups (see canvasFormatGroupOrder).
7
7
  */
8
- export type BuiltInCanvasFormatGroup = 'sharepic' | 'sharepic-tall' | 'profilbild' | 'praesentation' | 'print';
8
+ export type BuiltInCanvasFormatGroup = 'post' | 'square' | 'slides' | 'print';
9
9
  /** A built-in group, or the id of a host group (see `registerCanvasFormatGroups`). */
10
10
  export type CanvasFormatGroup = BuiltInCanvasFormatGroup | (string & {});
11
11
  export type CanvasFormatIconKey = 'portrait' | 'square' | 'landscape';
@@ -19,18 +19,21 @@ export interface CanvasPrintSpec {
19
19
  bleedMm: number;
20
20
  safeMm: number;
21
21
  exportDpi: number;
22
- seiten: number;
22
+ /** Printed sides: 1 single-sided, 2 front and back, more for folded or bound sheets. */
23
+ pageCount: number;
23
24
  /**
24
- * Where the V.i.S.d.P. / Impressum must stand: on every page (a poster set
25
- * of separate sheets), on the first or last page only, or nowhere (cards,
26
- * letterheads).
25
+ * Where the imprint (V.i.S.d.P. / Impressum) must stand: on every page (a
26
+ * poster set of separate sheets), on the first or last page only, or nowhere
27
+ * (cards, letterheads).
27
28
  */
28
- impressum: PrintImpressumSeite | null;
29
+ imprint: PrintImprintPlacement | null;
29
30
  }
30
- export type PrintImpressumSeite = 'jede-seite' | 'erste-seite' | 'letzte-seite';
31
+ export type PrintImprintPlacement = 'every-page' | 'first-page' | 'last-page';
31
32
  export interface CanvasFormat {
32
33
  id: string;
34
+ /** The name in the format's original language; show `formatLabel(format)`, which follows the catalogue. */
33
35
  label: string;
36
+ /** The size line in the original language; show `formatDescription(format)`. */
34
37
  description: string;
35
38
  group: CanvasFormatGroup;
36
39
  category: CanvasFormatCategory;
@@ -47,6 +50,17 @@ export type PrintCanvasFormat = CanvasFormat & {
47
50
  category: 'print';
48
51
  print: CanvasPrintSpec;
49
52
  };
53
+ /**
54
+ * Where the built-in picker groups sit, with gaps so a host group can go between them
55
+ * (`CanvasFormatGroupDef.order`, e.g. `CANVAS_FORMAT_GROUP_ORDER.post + 50` for right after posts).
56
+ * Print stays out: a host lists its print formats where it creates print canvases.
57
+ */
58
+ export declare const CANVAS_FORMAT_GROUP_ORDER: Readonly<Record<'post' | 'square' | 'slides', number>>;
59
+ /**
60
+ * The built-in formats: a 4:5 post, a square and a 16:9 slide. Everything else
61
+ * (stories, print, …) is the host's, added with `registerCanvasFormats`. The
62
+ * formats built in up to 0.1.0-alpha.1 are in `./legacyCatalog`.
63
+ */
50
64
  export declare const CANVAS_FORMATS: ReadonlyArray<CanvasFormat>;
51
65
  export declare const DEFAULT_FORMAT_ID = "post-portrait";
52
66
  /** Replaces the host's formats (an empty list clears them). Ids must be unique and not built-in; groups must be built-in or registered. */
@@ -54,6 +68,11 @@ export declare function registerCanvasFormats(formats: ReadonlyArray<CanvasForma
54
68
  export interface CanvasFormatGroupDef {
55
69
  id: string;
56
70
  label: string;
71
+ /**
72
+ * Position in the picker, against `CANVAS_FORMAT_GROUP_ORDER`. Without it the group follows all
73
+ * positioned ones, in registration order. Equal positions keep registration order.
74
+ */
75
+ order?: number;
57
76
  }
58
77
  /**
59
78
  * Replaces the host's format groups (an empty list clears them). Ids must be
@@ -62,13 +81,14 @@ export interface CanvasFormatGroupDef {
62
81
  * clear or re-register the formats first.
63
82
  */
64
83
  export declare function registerCanvasFormatGroups(groups: ReadonlyArray<CanvasFormatGroupDef>): void;
65
- /** The studio groups, host groups after the built-ins. Read lazily. */
84
+ /** The picker groups by position: the built-ins, host groups where their `order` puts them, unpositioned ones last. Read lazily. */
66
85
  export declare function canvasFormatGroupOrder(): ReadonlyArray<CanvasFormatGroup>;
67
86
  /** Display label of a group: the active catalogue for built-ins, the host's label otherwise. */
68
87
  export declare function canvasFormatGroupLabel(id: CanvasFormatGroup): string;
69
88
  /** The built-in formats followed by the registered ones. */
70
89
  export declare function canvasFormats(): ReadonlyArray<CanvasFormat>;
71
- export declare function pinnedFormatId(templateId: string): string | null;
90
+ /** @deprecated Moved to `./legacyCatalog`: the template ids are the host's. Removed in the next alpha. */
91
+ export { pinnedFormatId } from './legacyCatalog.js';
72
92
  /**
73
93
  * The digital format of exactly this size, for a template that comes without
74
94
  * one: the stage scales the template's space onto its format per axis, so the
@@ -76,7 +96,7 @@ export declare function pinnedFormatId(templateId: string): string | null;
76
96
  */
77
97
  export declare function formatIdForSize(width: number, height: number): string | null;
78
98
  export declare function getCanvasFormat(id: string): CanvasFormat | null;
79
- /** Die eine Stelle, die beantwortet: ist das eine Präsentation? */
99
+ /** The one place that answers: is this a slide deck? A host's slide format joins the `slides` group. */
80
100
  export declare function isSlideFormat(format: CanvasFormat): boolean;
81
101
  /**
82
102
  * Startgröße neu eingefügter Elemente (Text, Formen, Icons, Grafiken,
@@ -94,7 +114,11 @@ export declare class UnsupportedCanvasFormatError extends Error {
94
114
  readonly formatId: string;
95
115
  constructor(formatId: string);
96
116
  }
97
- /** Unknown digital ids fall back to the default; unknown print ids throw. */
117
+ /**
118
+ * Unknown digital ids fall back to the default, with a warning once per id:
119
+ * a host that forgot to register its formats would otherwise ship them as
120
+ * 4:5 without a trace. Unknown print ids throw.
121
+ */
98
122
  export declare function getCanvasFormatOrDefault(id: string | null | undefined): CanvasFormat;
99
123
  export declare function mmToPx(format: PrintCanvasFormat, mm: number): number;
100
124
  export interface PrintRect {
@@ -1,49 +1,32 @@
1
- // SPDX-License-Identifier: MPL-2.0
2
- import { messages } from '../i18n/messages.js';
1
+ // SPDX-License-Identifier: AGPL-3.0-only
2
+ import { messages } from '../i18n/catalogue.js';
3
3
  const BUILT_IN_GROUPS = [
4
- 'sharepic',
5
- 'sharepic-tall',
6
- 'profilbild',
7
- 'praesentation',
4
+ 'post',
5
+ 'square',
6
+ 'slides',
8
7
  'print',
9
8
  ];
10
- /** The studio groups. Print stays out until the studio picker can create print canvases. */
11
- const STUDIO_GROUPS = [
12
- 'sharepic',
13
- 'sharepic-tall',
14
- 'profilbild',
15
- 'praesentation',
16
- ];
17
- const PRINT_BLEED_MM = 3;
18
- const PRINT_EXPORT_DPI = 300;
19
- /** Large formats print from a distance: 150 dpi, the usual large-format rate. */
20
- const PRINT_LARGE_EXPORT_DPI = 150;
21
- /** Working resolution: the long side including bleed is 2000 px. */
22
- const PRINT_LONG_SIDE_PX = 2000;
23
- function printFormat(id, name, trimMm, safeMm, seiten, exportDpi = PRINT_EXPORT_DPI, impressum = seiten === 1 ? 'jede-seite' : null) {
24
- const pxPerMm = PRINT_LONG_SIDE_PX / (Math.max(trimMm.w, trimMm.h) + 2 * PRINT_BLEED_MM);
25
- return {
26
- id,
27
- label: `${name} · ${trimMm.w} × ${trimMm.h} mm`,
28
- description: `${trimMm.w} × ${trimMm.h} mm · ${PRINT_BLEED_MM} mm Beschnitt · ${seiten === 1 ? 'einseitig' : seiten === 2 ? 'Vorder- und Rückseite' : `${seiten} Seiten`}`,
29
- group: 'print',
30
- category: 'print',
31
- width: Math.round((trimMm.w + 2 * PRINT_BLEED_MM) * pxPerMm),
32
- height: Math.round((trimMm.h + 2 * PRINT_BLEED_MM) * pxPerMm),
33
- dpi: exportDpi,
34
- iconKey: trimMm.w > trimMm.h ? 'landscape' : 'portrait',
35
- defaultExport: 'pdf',
36
- exportable: ['pdf', 'png'],
37
- print: { trimMm, bleedMm: PRINT_BLEED_MM, safeMm, exportDpi, seiten, impressum },
38
- };
39
- }
9
+ /**
10
+ * Where the built-in picker groups sit, with gaps so a host group can go between them
11
+ * (`CanvasFormatGroupDef.order`, e.g. `CANVAS_FORMAT_GROUP_ORDER.post + 50` for right after posts).
12
+ * Print stays out: a host lists its print formats where it creates print canvases.
13
+ */
14
+ export const CANVAS_FORMAT_GROUP_ORDER = {
15
+ post: 100,
16
+ square: 200,
17
+ slides: 300,
18
+ };
19
+ /**
20
+ * The built-in formats: a 4:5 post, a square and a 16:9 slide. Everything else
21
+ * (stories, print, …) is the host's, added with `registerCanvasFormats`. The
22
+ * formats built in up to 0.1.0-alpha.1 are in `./legacyCatalog`.
23
+ */
40
24
  export const CANVAS_FORMATS = [
41
- // ── Sharepics ────────────────────────────────────────────────────────────
42
25
  {
43
26
  id: 'post-portrait',
44
- label: 'Sharepic',
27
+ label: 'Beitrag 4:5',
45
28
  description: '1080 × 1350 · 4:5 · Instagram, Facebook',
46
- group: 'sharepic',
29
+ group: 'post',
47
30
  category: 'digital',
48
31
  width: 1080,
49
32
  height: 1350,
@@ -53,26 +36,11 @@ export const CANVAS_FORMATS = [
53
36
  exportable: ['png', 'jpeg'],
54
37
  print: null,
55
38
  },
56
- {
57
- id: 'post-portrait-tall',
58
- label: 'Sharepic 3:4',
59
- description: '1080 × 1440 · 3:4 · Instagram',
60
- group: 'sharepic-tall',
61
- category: 'digital',
62
- width: 1080,
63
- height: 1440,
64
- dpi: 72,
65
- iconKey: 'portrait',
66
- defaultExport: 'png',
67
- exportable: ['png', 'jpeg'],
68
- print: null,
69
- },
70
- // ── Profilbild ───────────────────────────────────────────────────────────
71
39
  {
72
40
  id: 'profile-square',
73
- label: 'Profilbild',
41
+ label: 'Quadrat 1:1',
74
42
  description: '1080 × 1080 · 1:1',
75
- group: 'profilbild',
43
+ group: 'square',
76
44
  category: 'digital',
77
45
  width: 1080,
78
46
  height: 1080,
@@ -82,12 +50,11 @@ export const CANVAS_FORMATS = [
82
50
  exportable: ['png', 'jpeg'],
83
51
  print: null,
84
52
  },
85
- // ── Präsentation ─────────────────────────────────────────────────────────
86
53
  {
87
54
  id: 'slide-16-9',
88
55
  label: 'Präsentation',
89
56
  description: '1920 × 1080 · 16:9 · Folien',
90
- group: 'praesentation',
57
+ group: 'slides',
91
58
  category: 'digital',
92
59
  width: 1920,
93
60
  height: 1080,
@@ -97,24 +64,6 @@ export const CANVAS_FORMATS = [
97
64
  exportable: ['pptx', 'pdf', 'png'],
98
65
  print: null,
99
66
  },
100
- // ── Print ────────────────────────────────────────────────────────────────
101
- printFormat('print-visitenkarte-quer', 'Visitenkarte quer', { w: 85, h: 55 }, 3, 2),
102
- printFormat('print-visitenkarte-hoch', 'Visitenkarte hoch', { w: 55, h: 85 }, 3, 2),
103
- printFormat('print-a3-hoch', 'Plakat A3 hoch', { w: 297, h: 420 }, 4, 1),
104
- printFormat('print-a4-hoch', 'Plakat A4 hoch', { w: 210, h: 297 }, 4, 1),
105
- printFormat('print-a3-quer', 'Plakat A3 quer', { w: 420, h: 297 }, 4, 1),
106
- printFormat('print-a1-hoch', 'Plakat A1 hoch', { w: 594, h: 841 }, 10, 1, PRINT_LARGE_EXPORT_DPI),
107
- printFormat('print-a1-quer', 'Plakat A1 quer', { w: 841, h: 594 }, 10, 1, PRINT_LARGE_EXPORT_DPI),
108
- // 18/1 billboard: the artwork is supplied at A2 and enlarged (print spec).
109
- printFormat('print-grossflaeche', 'Großfläche 18/1 (Vorlage A2)', { w: 594, h: 420 }, 10, 1, PRINT_LARGE_EXPORT_DPI),
110
- // Visible area 230 × 342 mm (print spec): the safe zone ends inside it.
111
- printFormat('print-citylight', 'Citylight', { w: 237, h: 350 }, 8, 1, PRINT_LARGE_EXPORT_DPI),
112
- // Roll fold to DIN lang: panels 100 / 100 / 97 mm, outside and inside (print spec).
113
- printFormat('print-flyer-dinlang', 'Flyer DIN lang (A4 quer, Wickelfalz)', { w: 297, h: 210 }, 4, 2, PRINT_EXPORT_DPI, 'erste-seite'),
114
- printFormat('print-a6-hoch', 'Flyer A6 hoch', { w: 105, h: 148 }, 3, 2, PRINT_EXPORT_DPI, 'letzte-seite'),
115
- printFormat('print-a6-quer', 'Flyer A6 quer', { w: 148, h: 105 }, 3, 2, PRINT_EXPORT_DPI, 'letzte-seite'),
116
- printFormat('print-briefbogen-a4', 'Briefbogen A4', { w: 210, h: 297 }, 5, 2),
117
- printFormat('print-zeitung-a4', 'Zeitung A4', { w: 210, h: 297 }, 5, 4, PRINT_EXPORT_DPI, 'letzte-seite'),
118
67
  ];
119
68
  export const DEFAULT_FORMAT_ID = 'post-portrait';
120
69
  /**
@@ -153,6 +102,9 @@ export function registerCanvasFormatGroups(groups) {
153
102
  for (const g of groups) {
154
103
  if (seen.has(g.id))
155
104
  throw new Error(`Canvas format group id '${g.id}' is already taken`);
105
+ if (g.order !== undefined && !Number.isFinite(g.order)) {
106
+ throw new Error(`Canvas format group '${g.id}' has no finite order`);
107
+ }
156
108
  seen.add(g.id);
157
109
  }
158
110
  for (const f of hostFormats) {
@@ -162,9 +114,14 @@ export function registerCanvasFormatGroups(groups) {
162
114
  }
163
115
  hostGroups = [...groups];
164
116
  }
165
- /** The studio groups, host groups after the built-ins. Read lazily. */
117
+ /** The picker groups by position: the built-ins, host groups where their `order` puts them, unpositioned ones last. Read lazily. */
166
118
  export function canvasFormatGroupOrder() {
167
- return [...STUDIO_GROUPS, ...hostGroups.map((g) => g.id)];
119
+ const builtIn = Object.entries(CANVAS_FORMAT_GROUP_ORDER).map(([id, order]) => ({ id, order }));
120
+ const host = hostGroups.map((g) => ({ id: g.id, order: g.order ?? Number.POSITIVE_INFINITY }));
121
+ // Array#sort is stable: equal positions keep built-ins first, then registration order.
122
+ return [...builtIn, ...host]
123
+ .sort((a, b) => (a.order === b.order ? 0 : a.order - b.order))
124
+ .map((g) => g.id);
168
125
  }
169
126
  /** Display label of a group: the active catalogue for built-ins, the host's label otherwise. */
170
127
  export function canvasFormatGroupLabel(id) {
@@ -178,19 +135,8 @@ export function canvasFormatGroupLabel(id) {
178
135
  export function canvasFormats() {
179
136
  return hostFormats.length === 0 ? CANVAS_FORMATS : [...CANVAS_FORMATS, ...hostFormats];
180
137
  }
181
- /**
182
- * Templates whose fixed sheet is not 4:5. A document of such a template must
183
- * carry exactly this format: the stage takes the document's format and scales
184
- * the sheet to it per axis, so the square profile picture on a 4:5 document
185
- * came out stretched by 1.25 (#4087).
186
- */
187
- const PINNED_TEMPLATE_FORMATS = {
188
- profilbild: 'profile-square',
189
- sticker: 'profile-square',
190
- };
191
- export function pinnedFormatId(templateId) {
192
- return PINNED_TEMPLATE_FORMATS[templateId] ?? null;
193
- }
138
+ /** @deprecated Moved to `./legacyCatalog`: the template ids are the host's. Removed in the next alpha. */
139
+ export { pinnedFormatId } from './legacyCatalog.js';
194
140
  /**
195
141
  * The digital format of exactly this size, for a template that comes without
196
142
  * one: the stage scales the template's space onto its format per axis, so the
@@ -203,9 +149,9 @@ export function formatIdForSize(width, height) {
203
149
  export function getCanvasFormat(id) {
204
150
  return canvasFormats().find((f) => f.id === id) ?? null;
205
151
  }
206
- /** Die eine Stelle, die beantwortet: ist das eine Präsentation? */
152
+ /** The one place that answers: is this a slide deck? A host's slide format joins the `slides` group. */
207
153
  export function isSlideFormat(format) {
208
- return format.group === 'praesentation';
154
+ return format.group === 'slides';
209
155
  }
210
156
  /**
211
157
  * Startgröße neu eingefügter Elemente (Text, Formen, Icons, Grafiken,
@@ -233,7 +179,13 @@ export class UnsupportedCanvasFormatError extends Error {
233
179
  this.name = 'UnsupportedCanvasFormatError';
234
180
  }
235
181
  }
236
- /** Unknown digital ids fall back to the default; unknown print ids throw. */
182
+ /** Unknown ids already warned about: a document resolves its format on every render. */
183
+ const warnedUnknownIds = new Set();
184
+ /**
185
+ * Unknown digital ids fall back to the default, with a warning once per id:
186
+ * a host that forgot to register its formats would otherwise ship them as
187
+ * 4:5 without a trace. Unknown print ids throw.
188
+ */
237
189
  export function getCanvasFormatOrDefault(id) {
238
190
  if (id) {
239
191
  const found = getCanvasFormat(id);
@@ -241,6 +193,10 @@ export function getCanvasFormatOrDefault(id) {
241
193
  return found;
242
194
  if (isUnsupportedFormatId(id))
243
195
  throw new UnsupportedCanvasFormatError(id);
196
+ if (!warnedUnknownIds.has(id)) {
197
+ warnedUnknownIds.add(id);
198
+ console.warn(`unknown canvas format '${id}', falling back to '${DEFAULT_FORMAT_ID}'; register it with registerCanvasFormats`);
199
+ }
244
200
  }
245
201
  const fallback = getCanvasFormat(DEFAULT_FORMAT_ID);
246
202
  if (!fallback) {
@@ -278,8 +234,8 @@ export function formatLabel(format) {
278
234
  export function formatDescription(format) {
279
235
  const m = messages().formats;
280
236
  if (format.print) {
281
- const { trimMm, bleedMm, seiten } = format.print;
282
- return m.printDescription(`${trimMm.w} × ${trimMm.h} mm`, bleedMm, seiten);
237
+ const { trimMm, bleedMm, pageCount } = format.print;
238
+ return m.printDescription(`${trimMm.w} × ${trimMm.h} mm`, bleedMm, pageCount);
283
239
  }
284
240
  if (format.id === 'slide-16-9')
285
241
  return m.slidesDescription('1920 × 1080 · 16:9');
@@ -0,0 +1,21 @@
1
+ /**
2
+ * The formats, the group and the template pinning the editor shipped built in
3
+ * up to 0.1.0-alpha.1, kept unchanged so a host that relied on them can
4
+ * register them itself:
5
+ *
6
+ * ```ts
7
+ * registerCanvasFormatGroups(LEGACY_CANVAS_FORMAT_GROUPS);
8
+ * registerCanvasFormats(LEGACY_CANVAS_FORMATS);
9
+ * ```
10
+ *
11
+ * The ids are the ones stored in documents, so stored documents keep opening.
12
+ *
13
+ * @deprecated Copy what you need into the host; this module is removed in the next alpha.
14
+ */
15
+ import type { CanvasFormat, CanvasFormatGroupDef } from './index.js';
16
+ /** @deprecated See the module comment. */
17
+ export declare const LEGACY_CANVAS_FORMAT_GROUPS: ReadonlyArray<CanvasFormatGroupDef>;
18
+ /** @deprecated See the module comment. */
19
+ export declare const LEGACY_CANVAS_FORMATS: ReadonlyArray<CanvasFormat>;
20
+ /** @deprecated The template ids are the host's; keep this map in the host. */
21
+ export declare function pinnedFormatId(templateId: string): string | null;
@@ -0,0 +1,76 @@
1
+ const PRINT_BLEED_MM = 3;
2
+ const PRINT_EXPORT_DPI = 300;
3
+ /** Large formats print from a distance: 150 dpi, the usual large-format rate. */
4
+ const PRINT_LARGE_EXPORT_DPI = 150;
5
+ /** Working resolution: the long side including bleed is 2000 px. */
6
+ const PRINT_LONG_SIDE_PX = 2000;
7
+ function printFormat(id, name, trimMm, safeMm, pageCount, exportDpi = PRINT_EXPORT_DPI, imprint = pageCount === 1 ? 'every-page' : null) {
8
+ const pxPerMm = PRINT_LONG_SIDE_PX / (Math.max(trimMm.w, trimMm.h) + 2 * PRINT_BLEED_MM);
9
+ return {
10
+ id,
11
+ label: `${name} · ${trimMm.w} × ${trimMm.h} mm`,
12
+ description: `${trimMm.w} × ${trimMm.h} mm · ${PRINT_BLEED_MM} mm Beschnitt · ${pageCount === 1 ? 'einseitig' : pageCount === 2 ? 'Vorder- und Rückseite' : `${pageCount} Seiten`}`,
13
+ group: 'print',
14
+ category: 'print',
15
+ width: Math.round((trimMm.w + 2 * PRINT_BLEED_MM) * pxPerMm),
16
+ height: Math.round((trimMm.h + 2 * PRINT_BLEED_MM) * pxPerMm),
17
+ dpi: exportDpi,
18
+ iconKey: trimMm.w > trimMm.h ? 'landscape' : 'portrait',
19
+ defaultExport: 'pdf',
20
+ exportable: ['pdf', 'png'],
21
+ print: { trimMm, bleedMm: PRINT_BLEED_MM, safeMm, exportDpi, pageCount, imprint },
22
+ };
23
+ }
24
+ /** @deprecated See the module comment. */
25
+ export const LEGACY_CANVAS_FORMAT_GROUPS = [
26
+ // 3:4 is its own group because only freeform lays out on it.
27
+ { id: 'sharepic-tall', label: 'Sharepics 3:4' },
28
+ ];
29
+ /** @deprecated See the module comment. */
30
+ export const LEGACY_CANVAS_FORMATS = [
31
+ {
32
+ id: 'post-portrait-tall',
33
+ label: 'Sharepic 3:4',
34
+ description: '1080 × 1440 · 3:4 · Instagram',
35
+ group: 'sharepic-tall',
36
+ category: 'digital',
37
+ width: 1080,
38
+ height: 1440,
39
+ dpi: 72,
40
+ iconKey: 'portrait',
41
+ defaultExport: 'png',
42
+ exportable: ['png', 'jpeg'],
43
+ print: null,
44
+ },
45
+ printFormat('print-visitenkarte-quer', 'Visitenkarte quer', { w: 85, h: 55 }, 3, 2),
46
+ printFormat('print-visitenkarte-hoch', 'Visitenkarte hoch', { w: 55, h: 85 }, 3, 2),
47
+ printFormat('print-a3-hoch', 'Plakat A3 hoch', { w: 297, h: 420 }, 4, 1),
48
+ printFormat('print-a4-hoch', 'Plakat A4 hoch', { w: 210, h: 297 }, 4, 1),
49
+ printFormat('print-a3-quer', 'Plakat A3 quer', { w: 420, h: 297 }, 4, 1),
50
+ printFormat('print-a1-hoch', 'Plakat A1 hoch', { w: 594, h: 841 }, 10, 1, PRINT_LARGE_EXPORT_DPI),
51
+ printFormat('print-a1-quer', 'Plakat A1 quer', { w: 841, h: 594 }, 10, 1, PRINT_LARGE_EXPORT_DPI),
52
+ // 18/1 billboard: the artwork is supplied at A2 and enlarged (print spec).
53
+ printFormat('print-grossflaeche', 'Großfläche 18/1 (Vorlage A2)', { w: 594, h: 420 }, 10, 1, PRINT_LARGE_EXPORT_DPI),
54
+ // Visible area 230 × 342 mm (print spec): the safe zone ends inside it.
55
+ printFormat('print-citylight', 'Citylight', { w: 237, h: 350 }, 8, 1, PRINT_LARGE_EXPORT_DPI),
56
+ // Roll fold to DIN lang: panels 100 / 100 / 97 mm, outside and inside (print spec).
57
+ printFormat('print-flyer-dinlang', 'Flyer DIN lang (A4 quer, Wickelfalz)', { w: 297, h: 210 }, 4, 2, PRINT_EXPORT_DPI, 'first-page'),
58
+ printFormat('print-a6-hoch', 'Flyer A6 hoch', { w: 105, h: 148 }, 3, 2, PRINT_EXPORT_DPI, 'last-page'),
59
+ printFormat('print-a6-quer', 'Flyer A6 quer', { w: 148, h: 105 }, 3, 2, PRINT_EXPORT_DPI, 'last-page'),
60
+ printFormat('print-briefbogen-a4', 'Briefbogen A4', { w: 210, h: 297 }, 5, 2),
61
+ printFormat('print-zeitung-a4', 'Zeitung A4', { w: 210, h: 297 }, 5, 4, PRINT_EXPORT_DPI, 'last-page'),
62
+ ];
63
+ /**
64
+ * Templates whose fixed sheet is not 4:5. A document of such a template must
65
+ * carry exactly this format: the stage takes the document's format and scales
66
+ * the sheet to it per axis, so the square profile picture on a 4:5 document
67
+ * came out stretched by 1.25 (#4087).
68
+ */
69
+ const PINNED_TEMPLATE_FORMATS = {
70
+ profilbild: 'profile-square',
71
+ sticker: 'profile-square',
72
+ };
73
+ /** @deprecated The template ids are the host's; keep this map in the host. */
74
+ export function pinnedFormatId(templateId) {
75
+ return PINNED_TEMPLATE_FORMATS[templateId] ?? null;
76
+ }
@@ -1,4 +1,4 @@
1
- // SPDX-License-Identifier: MPL-2.0
1
+ // SPDX-License-Identifier: AGPL-3.0-only
2
2
  /**
3
3
  * Groups on a page: the page state key `groups` (F0, shapes only grow) lists
4
4
  * element ids that belong together, such as the parts of a placed block.
@@ -0,0 +1,20 @@
1
+ import { type ReactNode } from 'react';
2
+ /** The part of the window the editor occupies: its root's size, clipped to the window. */
3
+ export interface EditorBox {
4
+ width: number;
5
+ height: number;
6
+ }
7
+ /**
8
+ * Measures the editor root (`useEditorBoxRef`) so layout and canvas fit follow the box the host
9
+ * gives the editor, not the window. Clipped to the window, a full-screen host measures exactly
10
+ * the window, also where `min-h-[500px]` makes the root taller than a landscape phone.
11
+ */
12
+ export declare function EditorBoxProvider({ children }: {
13
+ children: ReactNode;
14
+ }): import("react").JSX.Element;
15
+ /** Ref for the editor root; without an `EditorBoxProvider` it measures nothing. */
16
+ export declare function useEditorBoxRef(): ((root: HTMLElement | null) => (() => void) | undefined) | undefined;
17
+ /** The measured box, or `null` outside an editor or before its root mounted. */
18
+ export declare function useMeasuredEditorBox(): EditorBox | null;
19
+ /** The editor's box; the window where nothing was measured (a canvas outside the editor). */
20
+ export declare function useEditorBox(): EditorBox;
@@ -0,0 +1,65 @@
1
+ import { jsx as _jsx } from "react/jsx-runtime";
2
+ // SPDX-License-Identifier: AGPL-3.0-only
3
+ import { createContext, useCallback, useContext, useMemo, useState, useSyncExternalStore, } from 'react';
4
+ const EditorBoxContext = createContext(null);
5
+ /**
6
+ * Measures the editor root (`useEditorBoxRef`) so layout and canvas fit follow the box the host
7
+ * gives the editor, not the window. Clipped to the window, a full-screen host measures exactly
8
+ * the window, also where `min-h-[500px]` makes the root taller than a landscape phone.
9
+ */
10
+ export function EditorBoxProvider({ children }) {
11
+ const [box, setBox] = useState(null);
12
+ const measure = useCallback((root) => {
13
+ if (!root)
14
+ return undefined;
15
+ const update = () => {
16
+ const rect = root.getBoundingClientRect();
17
+ // A root without a box (hidden by the host, or no layout at all) says nothing about the
18
+ // space the editor will get; until it has one, the window decides.
19
+ if (rect.width === 0 || rect.height === 0) {
20
+ setBox(null);
21
+ return;
22
+ }
23
+ const width = Math.min(rect.width, window.innerWidth);
24
+ const height = Math.min(rect.height, window.innerHeight);
25
+ setBox((prev) => prev?.width === width && prev.height === height ? prev : { width, height });
26
+ };
27
+ // Measured while React commits, so the first paint already uses the box.
28
+ update();
29
+ const observer = new ResizeObserver(update);
30
+ observer.observe(root);
31
+ window.addEventListener('resize', update);
32
+ return () => {
33
+ observer.disconnect();
34
+ window.removeEventListener('resize', update);
35
+ };
36
+ }, []);
37
+ const value = useMemo(() => ({ box, measure }), [box, measure]);
38
+ return _jsx(EditorBoxContext.Provider, { value: value, children: children });
39
+ }
40
+ /** Ref for the editor root; without an `EditorBoxProvider` it measures nothing. */
41
+ export function useEditorBoxRef() {
42
+ return useContext(EditorBoxContext)?.measure;
43
+ }
44
+ /** The measured box, or `null` outside an editor or before its root mounted. */
45
+ export function useMeasuredEditorBox() {
46
+ return useContext(EditorBoxContext)?.box ?? null;
47
+ }
48
+ const SERVER_WINDOW = { width: Infinity, height: Infinity };
49
+ let windowBox = SERVER_WINDOW;
50
+ function readWindow() {
51
+ const { innerWidth: width, innerHeight: height } = window;
52
+ if (windowBox.width !== width || windowBox.height !== height)
53
+ windowBox = { width, height };
54
+ return windowBox;
55
+ }
56
+ function subscribeWindow(onChange) {
57
+ window.addEventListener('resize', onChange);
58
+ return () => window.removeEventListener('resize', onChange);
59
+ }
60
+ /** The editor's box; the window where nothing was measured (a canvas outside the editor). */
61
+ export function useEditorBox() {
62
+ const measured = useMeasuredEditorBox();
63
+ const viewport = useSyncExternalStore(subscribeWindow, readWindow, () => SERVER_WINDOW);
64
+ return measured ?? viewport;
65
+ }
@@ -1,13 +1,13 @@
1
- export { useElementSnapping } from '@ggraphic/editor/hooks/useElementSnapping';
2
- export type { UseElementSnappingResult } from '@ggraphic/editor/hooks/useElementSnapping';
3
- export { useCanvasUndoRedo } from '@ggraphic/editor/hooks/useCanvasUndoRedo';
1
+ export { useElementSnapping } from './useElementSnapping.js';
2
+ export type { UseElementSnappingResult } from './useElementSnapping.js';
3
+ export { useCanvasUndoRedo } from './useCanvasUndoRedo.js';
4
4
  export { useCanvasInteractions } from './useCanvasInteractions.js';
5
5
  export type { UseCanvasInteractionsOptions, UseCanvasInteractionsResult, } from './useCanvasInteractions.js';
6
- export { useCanvasStoreReset } from '@ggraphic/editor/hooks/useCanvasStoreReset';
7
- export { useCanvasHistorySetup } from '@ggraphic/editor/hooks/useCanvasHistorySetup';
8
- export type { UseCanvasHistorySetupResult } from '@ggraphic/editor/hooks/useCanvasHistorySetup';
9
- export { useImageCoverFit } from '@ggraphic/editor/hooks/useImageCoverFit';
10
- export type { CoverFitDimensions } from '@ggraphic/editor/hooks/useImageCoverFit';
6
+ export { useCanvasStoreReset } from './useCanvasStoreReset.js';
7
+ export { useCanvasHistorySetup } from './useCanvasHistorySetup.js';
8
+ export type { UseCanvasHistorySetupResult } from './useCanvasHistorySetup.js';
9
+ export { useImageCoverFit } from './useImageCoverFit.js';
10
+ export type { CoverFitDimensions } from './useImageCoverFit.js';
11
11
  export { useFloatingModuleState } from './useFloatingModuleState.js';
12
12
  export type { FloatingModuleState, UseFloatingModuleStateOptions, } from './useFloatingModuleState.js';
13
13
  export { useFloatingModuleHandlers } from './useFloatingModuleHandlers.js';
@@ -16,14 +16,14 @@ export { useCanvasElementHandlers } from './useCanvasElementHandlers.js';
16
16
  export type { UseCanvasElementHandlersOptions, UseCanvasElementHandlersResult, } from './useCanvasElementHandlers.js';
17
17
  export { useCanvasKeyboardHandlers } from './useCanvasKeyboardHandlers.js';
18
18
  export type { UseCanvasKeyboardHandlersOptions } from './useCanvasKeyboardHandlers.js';
19
- export { useFontGeneration } from '@ggraphic/editor/hooks/useFontGeneration';
20
- export { useFontLoader } from '@ggraphic/editor/hooks/useFontLoader';
21
- export type { UseFontLoaderOptions, UseFontLoaderResult, } from '@ggraphic/editor/hooks/useFontLoader';
22
- export { usePaginatedIcons } from '@ggraphic/editor/hooks/usePaginatedIcons';
19
+ export { useFontGeneration } from './useFontGeneration.js';
20
+ export { useFontLoader } from './useFontLoader.js';
21
+ export type { UseFontLoaderOptions, UseFontLoaderResult } from './useFontLoader.js';
22
+ export { usePaginatedIcons } from './usePaginatedIcons.js';
23
23
  export { useMultiPageExport } from './useMultiPageExport.js';
24
24
  export type { UseMultiPageExportProps, UseMultiPageExportReturn, ExportProgress, } from './useMultiPageExport.js';
25
25
  export { usePageManager, parseInitialPages, readInitialDocument } from './usePageManager.js';
26
26
  export { useDeckAutoSave, SHARE_ORIGINAL_IMAGE_SRC } from './useDeckAutoSave.js';
27
27
  export type { InitialPageDef, UsePageManagerOptions, UsePageManagerReturn, } from './usePageManager.js';
28
28
  export { usePageThumbnails } from './usePageThumbnails.js';
29
- export { useMobileSheet } from '@ggraphic/editor/hooks/useMobileSheet';
29
+ export { useMobileSheet } from './useMobileSheet.js';
@@ -1,19 +1,19 @@
1
- // SPDX-License-Identifier: MPL-2.0
2
- export { useElementSnapping } from '@ggraphic/editor/hooks/useElementSnapping';
3
- export { useCanvasUndoRedo } from '@ggraphic/editor/hooks/useCanvasUndoRedo';
1
+ // SPDX-License-Identifier: AGPL-3.0-only
2
+ export { useElementSnapping } from './useElementSnapping.js';
3
+ export { useCanvasUndoRedo } from './useCanvasUndoRedo.js';
4
4
  export { useCanvasInteractions } from './useCanvasInteractions.js';
5
- export { useCanvasStoreReset } from '@ggraphic/editor/hooks/useCanvasStoreReset';
6
- export { useCanvasHistorySetup } from '@ggraphic/editor/hooks/useCanvasHistorySetup';
7
- export { useImageCoverFit } from '@ggraphic/editor/hooks/useImageCoverFit';
5
+ export { useCanvasStoreReset } from './useCanvasStoreReset.js';
6
+ export { useCanvasHistorySetup } from './useCanvasHistorySetup.js';
7
+ export { useImageCoverFit } from './useImageCoverFit.js';
8
8
  export { useFloatingModuleState } from './useFloatingModuleState.js';
9
9
  export { useFloatingModuleHandlers } from './useFloatingModuleHandlers.js';
10
10
  export { useCanvasElementHandlers } from './useCanvasElementHandlers.js';
11
11
  export { useCanvasKeyboardHandlers } from './useCanvasKeyboardHandlers.js';
12
- export { useFontGeneration } from '@ggraphic/editor/hooks/useFontGeneration';
13
- export { useFontLoader } from '@ggraphic/editor/hooks/useFontLoader';
14
- export { usePaginatedIcons } from '@ggraphic/editor/hooks/usePaginatedIcons';
12
+ export { useFontGeneration } from './useFontGeneration.js';
13
+ export { useFontLoader } from './useFontLoader.js';
14
+ export { usePaginatedIcons } from './usePaginatedIcons.js';
15
15
  export { useMultiPageExport } from './useMultiPageExport.js';
16
16
  export { usePageManager, parseInitialPages, readInitialDocument } from './usePageManager.js';
17
17
  export { useDeckAutoSave, SHARE_ORIGINAL_IMAGE_SRC } from './useDeckAutoSave.js';
18
18
  export { usePageThumbnails } from './usePageThumbnails.js';
19
- export { useMobileSheet } from '@ggraphic/editor/hooks/useMobileSheet';
19
+ export { useMobileSheet } from './useMobileSheet.js';
@@ -0,0 +1,24 @@
1
+ /** The largest size a page's stage may take, in CSS px at zoom 100 %. */
2
+ export interface StageFit {
3
+ width: number;
4
+ height: number;
5
+ }
6
+ /** Set by the editor shell; the pages inside fit their stage to it. */
7
+ export declare const StageFitProvider: import("react").Provider<StageFit | null>;
8
+ /** The measured fit, or `null` (previews, a canvas outside the editor). */
9
+ export declare function useStageFit(): StageFit | null;
10
+ /**
11
+ * The part of the canvas area a page can use without anything covering it: the scrolling main
12
+ * column, minus what sits above the first stage (context bar slot, padding, page toolbar), the
13
+ * bottom bar and a gap above it as wide as the gap above the page (canvas and container padding). Every value is laid out by the
14
+ * editor, never by the stage itself, so a stage that grows or shrinks to the result measures the
15
+ * same result again. Layout sizes (`offset*`, `client*`), not rects: the zoom scales the pages
16
+ * container, and the fit is the size at 100 %.
17
+ */
18
+ export declare function measureStageFit(container: HTMLElement): StageFit | null;
19
+ /**
20
+ * Measures `measureStageFit` for the pages container while `enabled`, and again on every resize.
21
+ * While `hold`, the last fit stays and nothing is measured: an open mobile sheet takes space from
22
+ * the main column and shifts the pages, and `useMobileSheetFit` already scales them into what is left.
23
+ */
24
+ export declare function useMeasuredStageFit(container: HTMLElement | null, enabled: boolean, hold?: boolean): StageFit | null;