@zsviczian/excalidraw 0.17.1-obsidian-37 → 0.17.1-obsidian-39

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 (337) hide show
  1. package/dist/excalidraw.development.js +92 -81
  2. package/dist/excalidraw.production.min.js +1 -1
  3. package/dist/styles.development.css +70 -83
  4. package/dist/styles.production.css +3 -2
  5. package/main.js +2 -1
  6. package/package.json +1 -1
  7. package/types/excalidraw/actions/actionAddToLibrary.d.ts +584 -584
  8. package/types/excalidraw/actions/actionAlign.d.ts +108 -108
  9. package/types/excalidraw/actions/actionBoundText.d.ts +426 -426
  10. package/types/excalidraw/actions/actionCanvas.d.ts +2844 -2844
  11. package/types/excalidraw/actions/actionClipboard.d.ts +1457 -1457
  12. package/types/excalidraw/actions/actionDeleteSelected.d.ts +618 -618
  13. package/types/excalidraw/actions/actionDistribute.d.ts +34 -34
  14. package/types/excalidraw/actions/actionDuplicateSelection.d.ts +21 -21
  15. package/types/excalidraw/actions/actionElementLock.d.ts +414 -414
  16. package/types/excalidraw/actions/actionExport.d.ts +1817 -1817
  17. package/types/excalidraw/actions/actionFinalize.d.ts +395 -395
  18. package/types/excalidraw/actions/actionFlip.d.ts +34 -34
  19. package/types/excalidraw/actions/actionFrame.d.ts +827 -827
  20. package/types/excalidraw/actions/actionGroup.d.ts +424 -424
  21. package/types/excalidraw/actions/actionHistory.d.ts +7 -7
  22. package/types/excalidraw/actions/actionLinearEditor.d.ts +208 -208
  23. package/types/excalidraw/actions/actionLink.d.ts +208 -208
  24. package/types/excalidraw/actions/actionMenu.d.ts +603 -603
  25. package/types/excalidraw/actions/actionNavigate.d.ts +400 -400
  26. package/types/excalidraw/actions/actionProperties.d.ts +3051 -3051
  27. package/types/excalidraw/actions/actionSelectAll.d.ts +207 -207
  28. package/types/excalidraw/actions/actionStyles.d.ts +221 -221
  29. package/types/excalidraw/actions/actionTextAutoResize.d.ts +17 -17
  30. package/types/excalidraw/actions/actionToggleGridMode.d.ts +210 -210
  31. package/types/excalidraw/actions/actionToggleObjectsSnapMode.d.ts +208 -208
  32. package/types/excalidraw/actions/actionToggleStats.d.ts +208 -208
  33. package/types/excalidraw/actions/actionToggleViewMode.d.ts +209 -209
  34. package/types/excalidraw/actions/actionToggleZenMode.d.ts +209 -209
  35. package/types/excalidraw/actions/actionZindex.d.ts +74 -74
  36. package/types/excalidraw/actions/index.d.ts +25 -25
  37. package/types/excalidraw/actions/manager.d.ts +21 -21
  38. package/types/excalidraw/actions/register.d.ts +5 -5
  39. package/types/excalidraw/actions/shortcuts.d.ts +4 -4
  40. package/types/excalidraw/actions/types.d.ts +47 -47
  41. package/types/excalidraw/align.d.ts +6 -6
  42. package/types/excalidraw/analytics.d.ts +1 -1
  43. package/types/excalidraw/animated-trail.d.ts +33 -33
  44. package/types/excalidraw/animation-frame-handler.d.ts +16 -16
  45. package/types/excalidraw/appState.d.ts +83 -83
  46. package/types/excalidraw/binaryheap.d.ts +12 -12
  47. package/types/excalidraw/change.d.ts +191 -191
  48. package/types/excalidraw/charts.d.ts +27 -27
  49. package/types/excalidraw/clients.d.ts +14 -14
  50. package/types/excalidraw/clipboard.d.ts +44 -44
  51. package/types/excalidraw/colors.d.ts +61 -61
  52. package/types/excalidraw/components/Actions.d.ts +34 -34
  53. package/types/excalidraw/components/ActiveConfirmDialog.d.ts +4 -4
  54. package/types/excalidraw/components/App.d.ts +521 -520
  55. package/types/excalidraw/components/Avatar.d.ts +11 -11
  56. package/types/excalidraw/components/BraveMeasureTextError.d.ts +2 -2
  57. package/types/excalidraw/components/Button.d.ts +17 -17
  58. package/types/excalidraw/components/ButtonIcon.d.ts +14 -14
  59. package/types/excalidraw/components/ButtonIconCycle.d.ts +10 -10
  60. package/types/excalidraw/components/ButtonIconSelect.d.ts +19 -19
  61. package/types/excalidraw/components/ButtonSelect.d.ts +9 -9
  62. package/types/excalidraw/components/ButtonSeparator.d.ts +1 -1
  63. package/types/excalidraw/components/Card.d.ts +6 -6
  64. package/types/excalidraw/components/CheckboxItem.d.ts +8 -8
  65. package/types/excalidraw/components/ColorPicker/ColorInput.d.ts +9 -9
  66. package/types/excalidraw/components/ColorPicker/ColorPicker.d.ts +19 -19
  67. package/types/excalidraw/components/ColorPicker/CustomColorList.d.ts +8 -8
  68. package/types/excalidraw/components/ColorPicker/HotkeyLabel.d.ts +8 -8
  69. package/types/excalidraw/components/ColorPicker/Picker.d.ts +18 -18
  70. package/types/excalidraw/components/ColorPicker/PickerColorList.d.ts +10 -10
  71. package/types/excalidraw/components/ColorPicker/PickerHeading.d.ts +5 -5
  72. package/types/excalidraw/components/ColorPicker/ShadeList.d.ts +8 -8
  73. package/types/excalidraw/components/ColorPicker/TopPicks.d.ts +9 -9
  74. package/types/excalidraw/components/ColorPicker/colorPickerUtils.d.ts +21 -21
  75. package/types/excalidraw/components/ColorPicker/keyboardNavHandlers.d.ts +20 -20
  76. package/types/excalidraw/components/CommandPalette/CommandPalette.d.ts +18 -18
  77. package/types/excalidraw/components/CommandPalette/defaultCommandPaletteItems.d.ts +2 -2
  78. package/types/excalidraw/components/CommandPalette/types.d.ts +25 -25
  79. package/types/excalidraw/components/ConfirmDialog.d.ts +10 -10
  80. package/types/excalidraw/components/ContextMenu.d.ts +16 -16
  81. package/types/excalidraw/components/DarkModeToggle.d.ts +7 -7
  82. package/types/excalidraw/components/DefaultSidebar.d.ts +29 -29
  83. package/types/excalidraw/components/Dialog.d.ts +13 -13
  84. package/types/excalidraw/components/DialogActionButton.d.ts +10 -10
  85. package/types/excalidraw/components/ErrorDialog.d.ts +5 -5
  86. package/types/excalidraw/components/ExcalidrawLogo.d.ts +15 -15
  87. package/types/excalidraw/components/EyeDropper.d.ts +27 -27
  88. package/types/excalidraw/components/FilledButton.d.ts +17 -17
  89. package/types/excalidraw/components/FixedSideContainer.d.ts +9 -9
  90. package/types/excalidraw/components/FollowMode/FollowMode.d.ts +10 -10
  91. package/types/excalidraw/components/FontPicker/FontPicker.d.ts +21 -21
  92. package/types/excalidraw/components/FontPicker/FontPickerList.d.ts +25 -25
  93. package/types/excalidraw/components/FontPicker/FontPickerTrigger.d.ts +6 -6
  94. package/types/excalidraw/components/FontPicker/keyboardNavHandlers.d.ts +13 -13
  95. package/types/excalidraw/components/HandButton.d.ts +10 -10
  96. package/types/excalidraw/components/HelpButton.d.ts +7 -7
  97. package/types/excalidraw/components/HelpDialog.d.ts +4 -4
  98. package/types/excalidraw/components/HintViewer.d.ts +10 -10
  99. package/types/excalidraw/components/IconPicker.d.ts +14 -14
  100. package/types/excalidraw/components/ImageExportDialog.d.ts +14 -14
  101. package/types/excalidraw/components/InitializeApp.d.ts +10 -10
  102. package/types/excalidraw/components/InlineIcon.d.ts +3 -3
  103. package/types/excalidraw/components/Island.d.ts +10 -10
  104. package/types/excalidraw/components/JSONExportDialog.d.ts +15 -15
  105. package/types/excalidraw/components/LaserPointerButton.d.ts +10 -10
  106. package/types/excalidraw/components/LayerUI.d.ts +34 -34
  107. package/types/excalidraw/components/LibraryMenu.d.ts +24 -24
  108. package/types/excalidraw/components/LibraryMenuBrowseButton.d.ts +7 -7
  109. package/types/excalidraw/components/LibraryMenuControlButtons.d.ts +9 -9
  110. package/types/excalidraw/components/LibraryMenuHeaderContent.d.ts +17 -17
  111. package/types/excalidraw/components/LibraryMenuItems.d.ts +14 -14
  112. package/types/excalidraw/components/LibraryMenuSection.d.ts +23 -23
  113. package/types/excalidraw/components/LibraryUnit.d.ts +14 -14
  114. package/types/excalidraw/components/LoadingMessage.d.ts +5 -5
  115. package/types/excalidraw/components/LockButton.d.ts +10 -10
  116. package/types/excalidraw/components/MagicButton.d.ts +9 -9
  117. package/types/excalidraw/components/MagicSettings.d.ts +8 -8
  118. package/types/excalidraw/components/MobileMenu.d.ts +24 -24
  119. package/types/excalidraw/components/Modal.d.ts +14 -14
  120. package/types/excalidraw/components/OverwriteConfirm/OverwriteConfirm.d.ts +17 -17
  121. package/types/excalidraw/components/OverwriteConfirm/OverwriteConfirmActions.d.ts +17 -17
  122. package/types/excalidraw/components/OverwriteConfirm/OverwriteConfirmState.d.ts +22 -22
  123. package/types/excalidraw/components/Paragraph.d.ts +4 -4
  124. package/types/excalidraw/components/PasteChartDialog.d.ts +8 -8
  125. package/types/excalidraw/components/PenModeButton.d.ts +12 -12
  126. package/types/excalidraw/components/Popover.d.ts +15 -15
  127. package/types/excalidraw/components/ProjectName.d.ts +10 -10
  128. package/types/excalidraw/components/PropertiesPopover.d.ts +15 -15
  129. package/types/excalidraw/components/PublishLibrary.d.ts +16 -16
  130. package/types/excalidraw/components/QuickSearch.d.ts +9 -9
  131. package/types/excalidraw/components/RadioGroup.d.ts +13 -13
  132. package/types/excalidraw/components/SVGLayer.d.ts +7 -7
  133. package/types/excalidraw/components/ScrollableList.d.ts +8 -8
  134. package/types/excalidraw/components/Section.d.ts +6 -6
  135. package/types/excalidraw/components/ShareableLinkDialog.d.ts +7 -7
  136. package/types/excalidraw/components/Sidebar/Sidebar.d.ts +76 -76
  137. package/types/excalidraw/components/Sidebar/SidebarHeader.d.ts +7 -7
  138. package/types/excalidraw/components/Sidebar/SidebarTab.d.ts +8 -8
  139. package/types/excalidraw/components/Sidebar/SidebarTabTrigger.d.ts +9 -9
  140. package/types/excalidraw/components/Sidebar/SidebarTabTriggers.d.ts +6 -6
  141. package/types/excalidraw/components/Sidebar/SidebarTabs.d.ts +6 -6
  142. package/types/excalidraw/components/Sidebar/SidebarTrigger.d.ts +6 -6
  143. package/types/excalidraw/components/Sidebar/common.d.ts +33 -33
  144. package/types/excalidraw/components/Spinner.d.ts +7 -7
  145. package/types/excalidraw/components/Stack.d.ts +16 -16
  146. package/types/excalidraw/components/Stats/Angle.d.ts +11 -11
  147. package/types/excalidraw/components/Stats/Collapsible.d.ts +8 -8
  148. package/types/excalidraw/components/Stats/Dimension.d.ts +11 -11
  149. package/types/excalidraw/components/Stats/DragInput.d.ts +31 -31
  150. package/types/excalidraw/components/Stats/FontSize.d.ts +11 -11
  151. package/types/excalidraw/components/Stats/MultiAngle.d.ts +11 -11
  152. package/types/excalidraw/components/Stats/MultiDimension.d.ts +14 -14
  153. package/types/excalidraw/components/Stats/MultiFontSize.d.ts +12 -12
  154. package/types/excalidraw/components/Stats/MultiPosition.d.ts +14 -14
  155. package/types/excalidraw/components/Stats/Position.d.ts +12 -12
  156. package/types/excalidraw/components/Stats/index.d.ts +35 -15
  157. package/types/excalidraw/components/Stats/utils.d.ts +26 -26
  158. package/types/excalidraw/components/Stats.d.ts +11 -11
  159. package/types/excalidraw/components/Switch.d.ts +9 -9
  160. package/types/excalidraw/components/TTDDialog/MermaidToExcalidraw.d.ts +14 -14
  161. package/types/excalidraw/components/TTDDialog/TTDDialog.d.ts +29 -29
  162. package/types/excalidraw/components/TTDDialog/TTDDialogInput.d.ts +9 -9
  163. package/types/excalidraw/components/TTDDialog/TTDDialogOutput.d.ts +7 -7
  164. package/types/excalidraw/components/TTDDialog/TTDDialogPanel.d.ts +17 -17
  165. package/types/excalidraw/components/TTDDialog/TTDDialogPanels.d.ts +4 -4
  166. package/types/excalidraw/components/TTDDialog/TTDDialogSubmitShortcut.d.ts +1 -1
  167. package/types/excalidraw/components/TTDDialog/TTDDialogTab.d.ts +7 -7
  168. package/types/excalidraw/components/TTDDialog/TTDDialogTabTrigger.d.ts +8 -8
  169. package/types/excalidraw/components/TTDDialog/TTDDialogTabTriggers.d.ts +6 -6
  170. package/types/excalidraw/components/TTDDialog/TTDDialogTabs.d.ts +14 -14
  171. package/types/excalidraw/components/TTDDialog/TTDDialogTrigger.d.ts +8 -8
  172. package/types/excalidraw/components/TTDDialog/common.d.ts +32 -32
  173. package/types/excalidraw/components/TextField.d.ts +19 -19
  174. package/types/excalidraw/components/Toast.d.ts +9 -9
  175. package/types/excalidraw/components/ToolButton.d.ts +49 -49
  176. package/types/excalidraw/components/Tooltip.d.ts +18 -18
  177. package/types/excalidraw/components/Trans.d.ts +9 -9
  178. package/types/excalidraw/components/UserList.d.ts +18 -18
  179. package/types/excalidraw/components/canvases/InteractiveCanvas.d.ts +29 -29
  180. package/types/excalidraw/components/canvases/StaticCanvas.d.ts +19 -19
  181. package/types/excalidraw/components/canvases/index.d.ts +3 -3
  182. package/types/excalidraw/components/dropdownMenu/DropdownMenu.d.ts +85 -85
  183. package/types/excalidraw/components/dropdownMenu/DropdownMenuContent.d.ts +15 -15
  184. package/types/excalidraw/components/dropdownMenu/DropdownMenuGroup.d.ts +11 -11
  185. package/types/excalidraw/components/dropdownMenu/DropdownMenuItem.d.ts +45 -45
  186. package/types/excalidraw/components/dropdownMenu/DropdownMenuItemContent.d.ts +7 -7
  187. package/types/excalidraw/components/dropdownMenu/DropdownMenuItemContentRadio.d.ts +17 -17
  188. package/types/excalidraw/components/dropdownMenu/DropdownMenuItemCustom.d.ts +7 -7
  189. package/types/excalidraw/components/dropdownMenu/DropdownMenuItemLink.d.ts +14 -14
  190. package/types/excalidraw/components/dropdownMenu/DropdownMenuSeparator.d.ts +5 -5
  191. package/types/excalidraw/components/dropdownMenu/DropdownMenuTrigger.d.ts +10 -10
  192. package/types/excalidraw/components/dropdownMenu/common.d.ts +6 -6
  193. package/types/excalidraw/components/dropdownMenu/dropdownMenuUtils.d.ts +3 -3
  194. package/types/excalidraw/components/footer/Footer.d.ts +12 -12
  195. package/types/excalidraw/components/footer/FooterCenter.d.ts +8 -8
  196. package/types/excalidraw/components/hoc/withInternalFallback.d.ts +4 -4
  197. package/types/excalidraw/components/hyperlink/Hyperlink.d.ts +18 -18
  198. package/types/excalidraw/components/hyperlink/helpers.d.ts +7 -7
  199. package/types/excalidraw/components/icons.d.ts +211 -211
  200. package/types/excalidraw/components/live-collaboration/LiveCollaborationTrigger.d.ts +9 -9
  201. package/types/excalidraw/components/main-menu/DefaultItems.d.ts +58 -58
  202. package/types/excalidraw/components/main-menu/MainMenu.d.ts +79 -79
  203. package/types/excalidraw/components/welcome-screen/WelcomeScreen.Center.d.ts +59 -59
  204. package/types/excalidraw/components/welcome-screen/WelcomeScreen.Hints.d.ts +19 -19
  205. package/types/excalidraw/components/welcome-screen/WelcomeScreen.d.ts +86 -86
  206. package/types/excalidraw/constants.d.ts +312 -312
  207. package/types/excalidraw/context/tunnels.d.ts +20 -20
  208. package/types/excalidraw/context/ui-appState.d.ts +4 -4
  209. package/types/excalidraw/cursor.d.ts +6 -6
  210. package/types/excalidraw/data/EditorLocalStorage.d.ts +8 -8
  211. package/types/excalidraw/data/ai/types.d.ts +242 -242
  212. package/types/excalidraw/data/blob.d.ts +49 -49
  213. package/types/excalidraw/data/encode.d.ts +53 -53
  214. package/types/excalidraw/data/encryption.d.ts +9 -9
  215. package/types/excalidraw/data/filesystem.d.ts +20 -20
  216. package/types/excalidraw/data/image.d.ts +15 -15
  217. package/types/excalidraw/data/index.d.ts +22 -22
  218. package/types/excalidraw/data/json.d.ts +16 -16
  219. package/types/excalidraw/data/library.d.ts +106 -106
  220. package/types/excalidraw/data/magic.d.ts +23 -23
  221. package/types/excalidraw/data/reconcile.d.ts +6 -6
  222. package/types/excalidraw/data/resave.d.ts +5 -5
  223. package/types/excalidraw/data/restore.d.ts +21 -21
  224. package/types/excalidraw/data/transform.d.ts +81 -81
  225. package/types/excalidraw/data/types.d.ts +45 -45
  226. package/types/excalidraw/data/url.d.ts +8 -8
  227. package/types/excalidraw/deburr.d.ts +1 -1
  228. package/types/excalidraw/dist/excalidraw.development.d.ts +2 -2
  229. package/types/excalidraw/dist/excalidraw.production.min.d.ts +1 -1
  230. package/types/excalidraw/distribute.d.ts +6 -6
  231. package/types/excalidraw/element/ElementCanvasButtons.d.ts +7 -7
  232. package/types/excalidraw/element/Hyperlink.d.ts +220 -0
  233. package/types/excalidraw/element/binding.d.ts +97 -97
  234. package/types/excalidraw/element/bounds.d.ts +74 -74
  235. package/types/excalidraw/element/collision.d.ts +16 -16
  236. package/types/excalidraw/element/containerCache.d.ts +11 -11
  237. package/types/excalidraw/element/dragElements.d.ts +15 -15
  238. package/types/excalidraw/element/embeddable.d.ts +214 -214
  239. package/types/excalidraw/element/flowchart.d.ts +25 -25
  240. package/types/excalidraw/element/heading.d.ts +11 -11
  241. package/types/excalidraw/element/image.d.ts +32 -32
  242. package/types/excalidraw/element/index.d.ts +26 -26
  243. package/types/excalidraw/element/linearElementEditor.d.ts +347 -347
  244. package/types/excalidraw/element/mutateElement.d.ts +11 -11
  245. package/types/excalidraw/element/newElement.d.ts +105 -105
  246. package/types/excalidraw/element/resizeElements.d.ts +17 -17
  247. package/types/excalidraw/element/resizeTest.d.ts +14 -14
  248. package/types/excalidraw/element/routing.d.ts +10 -10
  249. package/types/excalidraw/element/showSelectedShapeActions.d.ts +3 -3
  250. package/types/excalidraw/element/sizeHelpers.d.ts +40 -35
  251. package/types/excalidraw/element/sortElements.d.ts +2 -2
  252. package/types/excalidraw/element/textElement.d.ts +68 -68
  253. package/types/excalidraw/element/textWysiwyg.d.ts +22 -22
  254. package/types/excalidraw/element/transformHandles.d.ts +54 -54
  255. package/types/excalidraw/element/typeChecks.d.ts +37 -36
  256. package/types/excalidraw/element/types.d.ts +244 -244
  257. package/types/excalidraw/emitter.d.ts +16 -16
  258. package/types/excalidraw/entry.d.ts +1 -1
  259. package/types/excalidraw/env.d.cts +1 -1
  260. package/types/excalidraw/env.d.ts +1 -1
  261. package/types/excalidraw/errors.d.ts +16 -16
  262. package/types/excalidraw/fonts/ExcalidrawFont.d.ts +21 -21
  263. package/types/excalidraw/fonts/index.d.ts +83 -83
  264. package/types/excalidraw/fonts/metadata.d.ts +35 -35
  265. package/types/excalidraw/fractionalIndex.d.ts +48 -48
  266. package/types/excalidraw/frame.d.ts +63 -63
  267. package/types/excalidraw/ga.d.ts +63 -63
  268. package/types/excalidraw/gadirections.d.ts +8 -8
  269. package/types/excalidraw/galines.d.ts +22 -22
  270. package/types/excalidraw/gapoints.d.ts +7 -7
  271. package/types/excalidraw/gatransforms.d.ts +10 -10
  272. package/types/excalidraw/gesture.d.ts +6 -6
  273. package/types/excalidraw/groups.d.ts +33 -33
  274. package/types/excalidraw/history.d.ts +40 -40
  275. package/types/excalidraw/hooks/useCallbackRefState.d.ts +1 -1
  276. package/types/excalidraw/hooks/useCreatePortalContainer.d.ts +7 -7
  277. package/types/excalidraw/hooks/useEmitter.d.ts +2 -2
  278. package/types/excalidraw/hooks/useLibraryItemSvg.d.ts +11 -11
  279. package/types/excalidraw/hooks/useOutsideClick.d.ts +19 -19
  280. package/types/excalidraw/hooks/useScrollPosition.d.ts +1 -1
  281. package/types/excalidraw/hooks/useStable.d.ts +1 -1
  282. package/types/excalidraw/hooks/useStableCallback.d.ts +4 -4
  283. package/types/excalidraw/hooks/useTransition.d.ts +2 -2
  284. package/types/excalidraw/i18n.d.ts +24 -24
  285. package/types/excalidraw/index-node.d.ts +1 -1
  286. package/types/excalidraw/index.d.ts +59 -58
  287. package/types/excalidraw/jotai.d.ts +34 -34
  288. package/types/excalidraw/keys.d.ts +82 -82
  289. package/types/excalidraw/laser-trails.d.ts +20 -20
  290. package/types/excalidraw/main.d.ts +2 -2
  291. package/types/excalidraw/math.d.ts +78 -78
  292. package/types/excalidraw/mermaid.d.ts +2 -2
  293. package/types/excalidraw/obsidianUtils.d.ts +16 -16
  294. package/types/excalidraw/points.d.ts +7 -7
  295. package/types/excalidraw/polyfill.d.ts +2 -2
  296. package/types/excalidraw/publicPath.d.ts +1 -1
  297. package/types/excalidraw/queue.d.ts +9 -9
  298. package/types/excalidraw/random.d.ts +4 -4
  299. package/types/excalidraw/reactUtils.d.ts +14 -14
  300. package/types/excalidraw/renderer/easingFunctions.d.ts +6 -6
  301. package/types/excalidraw/renderer/helpers.d.ts +13 -13
  302. package/types/excalidraw/renderer/interactiveScene.d.ts +20 -20
  303. package/types/excalidraw/renderer/renderElement.d.ts +27 -27
  304. package/types/excalidraw/renderer/renderScene.d.ts +23 -0
  305. package/types/excalidraw/renderer/renderSnaps.d.ts +2 -2
  306. package/types/excalidraw/renderer/roundRect.d.ts +11 -11
  307. package/types/excalidraw/renderer/staticScene.d.ts +11 -11
  308. package/types/excalidraw/renderer/staticSvgScene.d.ts +5 -5
  309. package/types/excalidraw/scene/Fonts.d.ts +21 -19
  310. package/types/excalidraw/scene/Renderer.d.ts +25 -25
  311. package/types/excalidraw/scene/Scene.d.ts +78 -78
  312. package/types/excalidraw/scene/Shape.d.ts +17 -17
  313. package/types/excalidraw/scene/ShapeCache.d.ts +25 -25
  314. package/types/excalidraw/scene/comparisons.d.ts +11 -11
  315. package/types/excalidraw/scene/export.d.ts +29 -29
  316. package/types/excalidraw/scene/index.d.ts +4 -4
  317. package/types/excalidraw/scene/scroll.d.ts +17 -17
  318. package/types/excalidraw/scene/scrollbars.d.ts +12 -12
  319. package/types/excalidraw/scene/selection.d.ts +32 -32
  320. package/types/excalidraw/scene/types.d.ts +101 -101
  321. package/types/excalidraw/scene/zoom.d.ts +13 -13
  322. package/types/excalidraw/shapes.d.ts +70 -70
  323. package/types/excalidraw/snapping.d.ts +108 -108
  324. package/types/excalidraw/store.d.ts +129 -129
  325. package/types/excalidraw/types.d.ts +692 -692
  326. package/types/excalidraw/utility-types.d.ts +31 -31
  327. package/types/excalidraw/utils.d.ts +242 -242
  328. package/types/excalidraw/webpack.dev.config.d.ts +81 -81
  329. package/types/excalidraw/webpack.prod.config.d.ts +97 -97
  330. package/types/excalidraw/zindex.d.ts +6 -6
  331. package/types/utils/bbox.d.ts +11 -11
  332. package/types/utils/collision.d.ts +4 -4
  333. package/types/utils/export.d.ts +44 -44
  334. package/types/utils/geometry/geometry.d.ts +89 -72
  335. package/types/utils/geometry/shape.d.ts +56 -56
  336. package/types/utils/index.d.ts +4 -4
  337. package/types/utils/withinBounds.d.ts +19 -19
@@ -1,520 +1,521 @@
1
- import React from "react";
2
- import type { RoughCanvas } from "roughjs/bin/canvas";
3
- import { ActionManager } from "../actions/manager";
4
- import type { ActionResult } from "../actions/types";
5
- import { type EXPORT_IMAGE_TYPES } from "../constants";
6
- import type { ExportedElements } from "../data";
7
- import { LinearElementEditor } from "../element/linearElementEditor";
8
- import type { ExcalidrawElement, ExcalidrawLinearElement, NonDeleted, NonDeletedExcalidrawElement, ExcalidrawFrameLikeElement, ExcalidrawIframeElement, ExcalidrawEmbeddableElement, Ordered } from "../element/types";
9
- import { History } from "../history";
10
- import Scene from "../scene/Scene";
11
- import type { AppClassProperties, AppProps, AppState, ExcalidrawImperativeAPI, BinaryFiles, LibraryItems, SceneData, Device, FrameNameBoundsCache, SidebarName, SidebarTabName, ToolType, OnUserFollowedPayload } from "../types";
12
- import type { FileSystemHandle } from "../data/filesystem";
13
- import { Fonts } from "../fonts";
14
- import { Renderer } from "../scene/Renderer";
15
- import { Emitter } from "../emitter";
16
- import { Store } from "../store";
17
- import { AnimationFrameHandler } from "../animation-frame-handler";
18
- import { AnimatedTrail } from "../animated-trail";
19
- import { LaserTrails } from "../laser-trails";
20
- import { FlowChartCreator } from "../element/flowchart";
21
- export declare const ExcalidrawContainerContext: React.Context<{
22
- container: HTMLDivElement | null;
23
- id: string | null;
24
- }>;
25
- export declare const useApp: () => AppClassProperties;
26
- export declare const useAppProps: () => AppProps;
27
- export declare const useDevice: () => Readonly<{
28
- viewport: {
29
- isMobile: boolean;
30
- isLandscape: boolean;
31
- };
32
- editor: {
33
- isMobile: boolean;
34
- canFitSidebar: boolean;
35
- };
36
- isTouchScreen: boolean;
37
- }>;
38
- export declare const useExcalidrawContainer: () => {
39
- container: HTMLDivElement | null;
40
- id: string | null;
41
- };
42
- export declare const useExcalidrawElements: () => readonly NonDeletedExcalidrawElement[];
43
- export declare const useExcalidrawAppState: () => AppState;
44
- export declare const useExcalidrawSetAppState: () => <K extends keyof AppState>(state: AppState | ((prevState: Readonly<AppState>, props: Readonly<any>) => AppState | Pick<AppState, K> | null) | Pick<AppState, K> | null, callback?: (() => void) | undefined) => void;
45
- export declare const useExcalidrawActionManager: () => ActionManager;
46
- declare class App extends React.Component<AppProps, AppState> {
47
- canvas: AppClassProperties["canvas"];
48
- interactiveCanvas: AppClassProperties["interactiveCanvas"];
49
- rc: RoughCanvas;
50
- unmounted: boolean;
51
- actionManager: ActionManager;
52
- device: Device;
53
- private excalidrawContainerRef;
54
- scene: Scene;
55
- fonts: Fonts;
56
- renderer: Renderer;
57
- private resizeObserver;
58
- private nearestScrollableContainer;
59
- library: AppClassProperties["library"];
60
- libraryItemsFromStorage: LibraryItems | undefined;
61
- id: string;
62
- private store;
63
- private history;
64
- private excalidrawContainerValue;
65
- files: BinaryFiles;
66
- imageCache: AppClassProperties["imageCache"];
67
- private iFrameRefs;
68
- /**
69
- * Indicates whether the embeddable's url has been validated for rendering.
70
- * If value not set, indicates that the validation is pending.
71
- * Initially or on url change the flag is not reset so that we can guarantee
72
- * the validation came from a trusted source (the editor).
73
- **/
74
- private embedsValidationStatus;
75
- /** embeds that have been inserted to DOM (as a perf optim, we don't want to
76
- * insert to DOM before user initially scrolls to them) */
77
- private initializedEmbeds;
78
- private elementsPendingErasure;
79
- flowChartCreator: FlowChartCreator;
80
- private flowChartNavigator;
81
- hitLinkElement?: NonDeletedExcalidrawElement;
82
- lastPointerDownEvent: React.PointerEvent<HTMLElement> | null;
83
- lastPointerUpEvent: React.PointerEvent<HTMLElement> | PointerEvent | null;
84
- lastPointerMoveEvent: PointerEvent | null;
85
- lastViewportPosition: {
86
- x: number;
87
- y: number;
88
- };
89
- allowMobileMode: boolean;
90
- animationFrameHandler: AnimationFrameHandler;
91
- laserTrails: LaserTrails;
92
- eraserTrail: AnimatedTrail;
93
- onChangeEmitter: Emitter<[elements: readonly ExcalidrawElement[], appState: AppState, files: BinaryFiles]>;
94
- onPointerDownEmitter: Emitter<[activeTool: {
95
- lastActiveTool: import("../types").ActiveTool | null;
96
- locked: boolean;
97
- } & import("../types").ActiveTool, pointerDownState: Readonly<{
98
- origin: Readonly<{
99
- x: number;
100
- y: number;
101
- }>;
102
- originInGrid: Readonly<{
103
- x: number;
104
- y: number;
105
- }>;
106
- scrollbars: {
107
- isOverEither: boolean;
108
- isOverHorizontal: boolean;
109
- isOverVertical: boolean;
110
- };
111
- lastCoords: {
112
- x: number;
113
- y: number;
114
- };
115
- originalElements: Map<string, NonDeleted<ExcalidrawElement>>;
116
- resize: {
117
- handleType: import("../element/transformHandles").MaybeTransformHandleType;
118
- isResizing: boolean;
119
- offset: {
120
- x: number;
121
- y: number;
122
- };
123
- arrowDirection: "origin" | "end";
124
- center: {
125
- x: number;
126
- y: number;
127
- };
128
- };
129
- hit: {
130
- element: NonDeleted<ExcalidrawElement> | null;
131
- allHitElements: NonDeleted<ExcalidrawElement>[];
132
- wasAddedToSelection: boolean;
133
- hasBeenDuplicated: boolean;
134
- hasHitCommonBoundingBoxOfSelectedElements: boolean;
135
- };
136
- withCmdOrCtrl: boolean;
137
- drag: {
138
- hasOccurred: boolean;
139
- offset: {
140
- x: number;
141
- y: number;
142
- } | null;
143
- };
144
- eventListeners: {
145
- onMove: {
146
- (...args: any[]): void;
147
- flush(): void;
148
- cancel(): void;
149
- } | null;
150
- onUp: ((event: PointerEvent) => void) | null;
151
- onKeyDown: ((event: KeyboardEvent) => void) | null;
152
- onKeyUp: ((event: KeyboardEvent) => void) | null;
153
- };
154
- boxSelection: {
155
- hasOccurred: boolean;
156
- };
157
- }>, event: React.PointerEvent<HTMLElement>]>;
158
- onPointerUpEmitter: Emitter<[activeTool: {
159
- lastActiveTool: import("../types").ActiveTool | null;
160
- locked: boolean;
161
- } & import("../types").ActiveTool, pointerDownState: Readonly<{
162
- origin: Readonly<{
163
- x: number;
164
- y: number;
165
- }>;
166
- originInGrid: Readonly<{
167
- x: number;
168
- y: number;
169
- }>;
170
- scrollbars: {
171
- isOverEither: boolean;
172
- isOverHorizontal: boolean;
173
- isOverVertical: boolean;
174
- };
175
- lastCoords: {
176
- x: number;
177
- y: number;
178
- };
179
- originalElements: Map<string, NonDeleted<ExcalidrawElement>>;
180
- resize: {
181
- handleType: import("../element/transformHandles").MaybeTransformHandleType;
182
- isResizing: boolean;
183
- offset: {
184
- x: number;
185
- y: number;
186
- };
187
- arrowDirection: "origin" | "end";
188
- center: {
189
- x: number;
190
- y: number;
191
- };
192
- };
193
- hit: {
194
- element: NonDeleted<ExcalidrawElement> | null;
195
- allHitElements: NonDeleted<ExcalidrawElement>[];
196
- wasAddedToSelection: boolean;
197
- hasBeenDuplicated: boolean;
198
- hasHitCommonBoundingBoxOfSelectedElements: boolean;
199
- };
200
- withCmdOrCtrl: boolean;
201
- drag: {
202
- hasOccurred: boolean;
203
- offset: {
204
- x: number;
205
- y: number;
206
- } | null;
207
- };
208
- eventListeners: {
209
- onMove: {
210
- (...args: any[]): void;
211
- flush(): void;
212
- cancel(): void;
213
- } | null;
214
- onUp: ((event: PointerEvent) => void) | null;
215
- onKeyDown: ((event: KeyboardEvent) => void) | null;
216
- onKeyUp: ((event: KeyboardEvent) => void) | null;
217
- };
218
- boxSelection: {
219
- hasOccurred: boolean;
220
- };
221
- }>, event: PointerEvent]>;
222
- onUserFollowEmitter: Emitter<[payload: OnUserFollowedPayload]>;
223
- onScrollChangeEmitter: Emitter<[scrollX: number, scrollY: number, zoom: Readonly<{
224
- value: import("../types").NormalizedZoomValue;
225
- }>]>;
226
- missingPointerEventCleanupEmitter: Emitter<[event: PointerEvent | null]>;
227
- onRemoveEventListenersEmitter: Emitter<[]>;
228
- constructor(props: AppProps);
229
- private onWindowMessage;
230
- private cacheEmbeddableRef;
231
- private getHTMLIFrameElement;
232
- private handleEmbeddableCenterClick;
233
- private isIframeLikeElementCenter;
234
- private updateEmbedValidationStatus;
235
- private updateEmbeddables;
236
- private renderEmbeddables;
237
- private getFrameNameDOMId;
238
- frameNameBoundsCache: FrameNameBoundsCache;
239
- private renderFrameNames;
240
- private toggleOverscrollBehavior;
241
- render(): JSX.Element;
242
- focusContainer: AppClassProperties["focusContainer"];
243
- getSceneElementsIncludingDeleted: () => readonly import("../element/types").OrderedExcalidrawElement[];
244
- getSceneElements: () => readonly Ordered<NonDeletedExcalidrawElement>[];
245
- onInsertElements: (elements: readonly ExcalidrawElement[]) => void;
246
- onExportImage: (type: keyof typeof EXPORT_IMAGE_TYPES, elements: ExportedElements, opts: {
247
- exportingFrame: ExcalidrawFrameLikeElement | null;
248
- }) => Promise<void>;
249
- private magicGenerations;
250
- private updateMagicGeneration;
251
- private getTextFromElements;
252
- private onMagicFrameGenerate;
253
- private onIframeSrcCopy;
254
- private get OPENAI_KEY();
255
- private set OPENAI_KEY(value);
256
- private OPENAI_KEY_IS_PERSISTED;
257
- private onOpenAIKeyChange;
258
- private onMagicSettingsConfirm;
259
- onMagicframeToolSelect: () => void;
260
- private openEyeDropper;
261
- dismissLinearEditor: () => void;
262
- syncActionResult: (actionResult: ActionResult) => void;
263
- private onBlur;
264
- private onUnload;
265
- private disableEvent;
266
- private resetHistory;
267
- private resetStore;
268
- /**
269
- * Resets scene & history.
270
- * ! Do not use to clear scene user action !
271
- */
272
- private resetScene;
273
- private initializeScene;
274
- private isMobileBreakpoint;
275
- private refreshViewportBreakpoints;
276
- private refreshEditorBreakpoints;
277
- componentDidMount(): Promise<void>;
278
- componentWillUnmount(): void;
279
- private onResize;
280
- /** generally invoked only if fullscreen was invoked programmatically */
281
- private onFullscreenChange;
282
- private removeEventListeners;
283
- private addEventListeners;
284
- componentDidUpdate(prevProps: AppProps, prevState: AppState): void;
285
- private renderInteractiveSceneCallback;
286
- private onScroll;
287
- private onCut;
288
- private onCopy;
289
- private static resetTapTwice;
290
- private onTouchStart;
291
- private onTouchEnd;
292
- pasteFromClipboard: (event: ClipboardEvent) => Promise<void>;
293
- addElementsFromPasteOrLibrary: (opts: {
294
- elements: readonly ExcalidrawElement[];
295
- files: BinaryFiles | null;
296
- position: {
297
- clientX: number;
298
- clientY: number;
299
- } | "cursor" | "center";
300
- retainSeed?: boolean;
301
- fitToContent?: boolean;
302
- }) => void;
303
- private addElementsFromMixedContentPaste;
304
- private addTextFromPaste;
305
- setAppState: React.Component<any, AppState>["setState"];
306
- removePointer: (event: React.PointerEvent<HTMLElement> | PointerEvent) => void;
307
- toggleLock: (source?: "keyboard" | "ui") => void;
308
- updateFrameRendering: (opts: Partial<{
309
- enabled: boolean;
310
- name: boolean;
311
- outline: boolean;
312
- clip: boolean;
313
- }> | ((prevState: AppState["frameRendering"]) => Partial<AppState["frameRendering"]>)) => void;
314
- togglePenMode: (force: boolean | null) => void;
315
- onHandToolToggle: () => void;
316
- /**
317
- * Zooms on canvas viewport center
318
- */
319
- zoomCanvas: (value: number) => void;
320
- private cancelInProgressAnimation;
321
- scrollToContent: (target?: ExcalidrawElement | readonly ExcalidrawElement[], opts?: {
322
- fitToContent?: boolean;
323
- fitToViewport?: never;
324
- viewportZoomFactor?: never;
325
- animate?: boolean;
326
- duration?: number;
327
- } | {
328
- fitToContent?: never;
329
- fitToViewport?: boolean;
330
- /** when fitToViewport=true, how much screen should the content cover,
331
- * between 0.1 (10%) and 1 (100%)
332
- */
333
- viewportZoomFactor?: number;
334
- animate?: boolean;
335
- duration?: number;
336
- }) => void;
337
- private maybeUnfollowRemoteUser;
338
- /** use when changing scrollX/scrollY/zoom based on user interaction */
339
- private translateCanvas;
340
- zoomToFit: (target?: readonly ExcalidrawElement[], maxZoom?: number, margin?: number) => void;
341
- startLineEditor: (el: ExcalidrawLinearElement, selectedPointsIndices?: number[] | null) => void;
342
- updateContainerSize: (containers: NonDeletedExcalidrawElement[]) => void;
343
- setToast: (toast: {
344
- message: string;
345
- closable?: boolean;
346
- duration?: number;
347
- } | null) => void;
348
- restoreFileFromShare: () => Promise<void>;
349
- /** adds supplied files to existing files in the appState */
350
- addFiles: ExcalidrawImperativeAPI["addFiles"];
351
- setMobileModeAllowed: ExcalidrawImperativeAPI["setMobileModeAllowed"];
352
- selectElements: ExcalidrawImperativeAPI["selectElements"];
353
- bringToFront: ExcalidrawImperativeAPI["bringToFront"];
354
- bringForward: ExcalidrawImperativeAPI["bringForward"];
355
- sendToBack: ExcalidrawImperativeAPI["sendToBack"];
356
- sendBackward: ExcalidrawImperativeAPI["sendBackward"];
357
- updateScene: <K extends keyof AppState>(sceneData: {
358
- elements?: SceneData["elements"];
359
- appState?: Pick<AppState, K> | null | undefined;
360
- collaborators?: SceneData["collaborators"];
361
- /** @default StoreAction.NONE */
362
- storeAction?: SceneData["storeAction"];
363
- forceFlushSync?: boolean | undefined;
364
- }) => void;
365
- private triggerRender;
366
- /**
367
- * @returns whether the menu was toggled on or off
368
- */
369
- toggleSidebar: ({ name, tab, force, }: {
370
- name: SidebarName | null;
371
- tab?: string | undefined;
372
- force?: boolean | undefined;
373
- }) => boolean;
374
- private updateCurrentCursorPosition;
375
- private onKeyDown;
376
- private onWheel;
377
- private onKeyUp;
378
- private isToolSupported;
379
- setActiveTool: (tool: (({
380
- type: Exclude<ToolType, "image">;
381
- } | {
382
- type: Extract<ToolType, "image">;
383
- insertOnCanvasDirectly?: boolean;
384
- }) | {
385
- type: "custom";
386
- customType: string;
387
- }) & {
388
- locked?: boolean;
389
- }) => void;
390
- setOpenDialog: (dialogType: AppState["openDialog"]) => void;
391
- private setCursor;
392
- private resetCursor;
393
- /**
394
- * returns whether user is making a gesture with >= 2 fingers (points)
395
- * on o touch screen (not on a trackpad). Currently only relates to Darwin
396
- * (iOS/iPadOS,MacOS), but may work on other devices in the future if
397
- * GestureEvent is standardized.
398
- */
399
- private isTouchScreenMultiTouchGesture;
400
- getName: () => string;
401
- private onGestureStart;
402
- private onGestureChange;
403
- private onGestureEnd;
404
- private handleTextWysiwyg;
405
- private deselectElements;
406
- private getTextElementAtPosition;
407
- private getElementAtPosition;
408
- private getElementsAtPosition;
409
- private getElementHitThreshold;
410
- private hitElement;
411
- private getTextBindableContainerAtPosition;
412
- private startTextEditing;
413
- private debounceDoubleClickTimestamp;
414
- private handleCanvasDoubleClick;
415
- private getElementLinkAtPosition;
416
- private redirectToLink;
417
- private getTopLayerFrameAtSceneCoords;
418
- private handleCanvasPointerMove;
419
- private handleEraser;
420
- private handleTouchMove;
421
- handleHoverSelectedLinearElement(linearElementEditor: LinearElementEditor, scenePointerX: number, scenePointerY: number): void;
422
- private handleCanvasPointerDown;
423
- private handleCanvasPointerUp;
424
- private maybeOpenContextMenuAfterPointerDownOnTouchDevices;
425
- private resetContextMenuTimer;
426
- /**
427
- * pointerup may not fire in certian cases (user tabs away...), so in order
428
- * to properly cleanup pointerdown state, we need to fire any hanging
429
- * pointerup handlers manually
430
- */
431
- private maybeCleanupAfterMissingPointerUp;
432
- private handleCanvasPanUsingWheelOrSpaceDrag;
433
- private updateGestureOnPointerDown;
434
- private initialPointerDownState;
435
- private handleDraggingScrollBar;
436
- private clearSelectionIfNotUsingSelection;
437
- /**
438
- * @returns whether the pointer event has been completely handled
439
- */
440
- private handleSelectionOnPointerDown;
441
- private isASelectedElement;
442
- private isHittingCommonBoundingBoxOfSelectedElements;
443
- private handleTextOnPointerDown;
444
- private handleFreeDrawElementOnPointerDown;
445
- insertIframeElement: ({ sceneX, sceneY, width, height, }: {
446
- sceneX: number;
447
- sceneY: number;
448
- width: number;
449
- height: number;
450
- }) => NonDeleted<ExcalidrawIframeElement>;
451
- insertEmbeddableElement: ({ sceneX, sceneY, link, }: {
452
- sceneX: number;
453
- sceneY: number;
454
- link: string;
455
- }) => NonDeleted<ExcalidrawEmbeddableElement> | undefined;
456
- private createImageElement;
457
- private handleLinearElementOnPointerDown;
458
- private getCurrentItemRoundness;
459
- private createGenericElementOnPointerDown;
460
- private createFrameElementOnPointerDown;
461
- private maybeCacheReferenceSnapPoints;
462
- private maybeCacheVisibleGaps;
463
- private onKeyDownFromPointerDownHandler;
464
- private onKeyUpFromPointerDownHandler;
465
- private onPointerMoveFromPointerDownHandler;
466
- private handlePointerMoveOverScrollbars;
467
- private onPointerUpFromPointerDownHandler;
468
- private restoreReadyToEraseElements;
469
- private eraseElements;
470
- private initializeImage;
471
- /**
472
- * inserts image into elements array and rerenders
473
- */
474
- private insertImageElement;
475
- private setImagePreviewCursor;
476
- private onImageAction;
477
- private initializeImageDimensions;
478
- /** updates image cache, refreshing updated elements and/or setting status
479
- to error for images that fail during <img> element creation */
480
- private updateImageCache;
481
- /** adds new images to imageCache and re-renders if needed */
482
- private addNewImagesToImageCache;
483
- /** generally you should use `addNewImagesToImageCache()` directly if you need
484
- * to render new images. This is just a failsafe */
485
- private scheduleImageRefresh;
486
- private updateBindingEnabledOnPointerMove;
487
- private maybeSuggestBindingAtCursor;
488
- private maybeSuggestBindingsForLinearElementAtCoords;
489
- setSelection(elements: readonly NonDeletedExcalidrawElement[]): void;
490
- private clearSelection;
491
- private handleInteractiveCanvasRef;
492
- private handleAppOnDrop;
493
- loadFileToCanvas: (file: File, fileHandle: FileSystemHandle | null) => Promise<void>;
494
- private handleCanvasContextMenu;
495
- private maybeDragNewGenericElement;
496
- private maybeHandleResize;
497
- private getContextMenuItems;
498
- private handleWheel;
499
- private getTextWysiwygSnappedToCenterPosition;
500
- private savePointer;
501
- private resetShouldCacheIgnoreZoomDebounced;
502
- private updateDOMRect;
503
- refresh: () => void;
504
- private getCanvasOffsets;
505
- private updateLanguage;
506
- }
507
- declare global {
508
- interface Window {
509
- h: {
510
- scene: Scene;
511
- elements: readonly ExcalidrawElement[];
512
- state: AppState;
513
- setState: React.Component<any, AppState>["setState"];
514
- app: InstanceType<typeof App>;
515
- history: History;
516
- store: Store;
517
- };
518
- }
519
- }
520
- export default App;
1
+ import React from "react";
2
+ import type { RoughCanvas } from "roughjs/bin/canvas";
3
+ import { ActionManager } from "../actions/manager";
4
+ import type { ActionResult } from "../actions/types";
5
+ import { type EXPORT_IMAGE_TYPES } from "../constants";
6
+ import type { ExportedElements } from "../data";
7
+ import { LinearElementEditor } from "../element/linearElementEditor";
8
+ import type { ExcalidrawElement, ExcalidrawLinearElement, NonDeleted, NonDeletedExcalidrawElement, ExcalidrawFrameLikeElement, ExcalidrawIframeElement, ExcalidrawEmbeddableElement, Ordered } from "../element/types";
9
+ import { History } from "../history";
10
+ import Scene from "../scene/Scene";
11
+ import type { AppClassProperties, AppProps, AppState, ExcalidrawImperativeAPI, BinaryFiles, LibraryItems, SceneData, Device, FrameNameBoundsCache, SidebarName, SidebarTabName, ToolType, OnUserFollowedPayload } from "../types";
12
+ import type { FileSystemHandle } from "../data/filesystem";
13
+ import { Fonts } from "../fonts";
14
+ import { Renderer } from "../scene/Renderer";
15
+ import { Emitter } from "../emitter";
16
+ import { Store } from "../store";
17
+ import { AnimationFrameHandler } from "../animation-frame-handler";
18
+ import { AnimatedTrail } from "../animated-trail";
19
+ import { LaserTrails } from "../laser-trails";
20
+ import { FlowChartCreator } from "../element/flowchart";
21
+ export declare const ExcalidrawContainerContext: React.Context<{
22
+ container: HTMLDivElement | null;
23
+ id: string | null;
24
+ }>;
25
+ export declare const useApp: () => AppClassProperties;
26
+ export declare const useAppProps: () => AppProps;
27
+ export declare const useDevice: () => Readonly<{
28
+ viewport: {
29
+ isMobile: boolean;
30
+ isLandscape: boolean;
31
+ };
32
+ editor: {
33
+ isMobile: boolean;
34
+ canFitSidebar: boolean;
35
+ };
36
+ isTouchScreen: boolean;
37
+ }>;
38
+ export declare const useExcalidrawContainer: () => {
39
+ container: HTMLDivElement | null;
40
+ id: string | null;
41
+ };
42
+ export declare const useExcalidrawElements: () => readonly NonDeletedExcalidrawElement[];
43
+ export declare const useExcalidrawAppState: () => AppState;
44
+ export declare const useExcalidrawSetAppState: () => <K extends keyof AppState>(state: AppState | ((prevState: Readonly<AppState>, props: Readonly<any>) => AppState | Pick<AppState, K> | null) | Pick<AppState, K> | null, callback?: (() => void) | undefined) => void;
45
+ export declare const useExcalidrawActionManager: () => ActionManager;
46
+ declare class App extends React.Component<AppProps, AppState> {
47
+ canvas: AppClassProperties["canvas"];
48
+ interactiveCanvas: AppClassProperties["interactiveCanvas"];
49
+ rc: RoughCanvas;
50
+ unmounted: boolean;
51
+ actionManager: ActionManager;
52
+ device: Device;
53
+ private excalidrawContainerRef;
54
+ scene: Scene;
55
+ fonts: Fonts;
56
+ renderer: Renderer;
57
+ private resizeObserver;
58
+ private nearestScrollableContainer;
59
+ library: AppClassProperties["library"];
60
+ libraryItemsFromStorage: LibraryItems | undefined;
61
+ id: string;
62
+ private store;
63
+ private history;
64
+ private excalidrawContainerValue;
65
+ files: BinaryFiles;
66
+ imageCache: AppClassProperties["imageCache"];
67
+ private iFrameRefs;
68
+ /**
69
+ * Indicates whether the embeddable's url has been validated for rendering.
70
+ * If value not set, indicates that the validation is pending.
71
+ * Initially or on url change the flag is not reset so that we can guarantee
72
+ * the validation came from a trusted source (the editor).
73
+ **/
74
+ private embedsValidationStatus;
75
+ /** embeds that have been inserted to DOM (as a perf optim, we don't want to
76
+ * insert to DOM before user initially scrolls to them) */
77
+ private initializedEmbeds;
78
+ private elementsPendingErasure;
79
+ flowChartCreator: FlowChartCreator;
80
+ private flowChartNavigator;
81
+ hitLinkElement?: NonDeletedExcalidrawElement;
82
+ lastPointerDownEvent: React.PointerEvent<HTMLElement> | null;
83
+ lastPointerUpEvent: React.PointerEvent<HTMLElement> | PointerEvent | null;
84
+ lastPointerMoveEvent: PointerEvent | null;
85
+ lastViewportPosition: {
86
+ x: number;
87
+ y: number;
88
+ };
89
+ allowMobileMode: boolean;
90
+ animationFrameHandler: AnimationFrameHandler;
91
+ laserTrails: LaserTrails;
92
+ eraserTrail: AnimatedTrail;
93
+ onChangeEmitter: Emitter<[elements: readonly ExcalidrawElement[], appState: AppState, files: BinaryFiles]>;
94
+ onPointerDownEmitter: Emitter<[activeTool: {
95
+ lastActiveTool: import("../types").ActiveTool | null;
96
+ locked: boolean;
97
+ } & import("../types").ActiveTool, pointerDownState: Readonly<{
98
+ origin: Readonly<{
99
+ x: number;
100
+ y: number;
101
+ }>;
102
+ originInGrid: Readonly<{
103
+ x: number;
104
+ y: number;
105
+ }>;
106
+ scrollbars: {
107
+ isOverEither: boolean;
108
+ isOverHorizontal: boolean;
109
+ isOverVertical: boolean;
110
+ };
111
+ lastCoords: {
112
+ x: number;
113
+ y: number;
114
+ };
115
+ originalElements: Map<string, NonDeleted<ExcalidrawElement>>;
116
+ resize: {
117
+ handleType: import("../element/transformHandles").MaybeTransformHandleType;
118
+ isResizing: boolean;
119
+ offset: {
120
+ x: number;
121
+ y: number;
122
+ };
123
+ arrowDirection: "origin" | "end";
124
+ center: {
125
+ x: number;
126
+ y: number;
127
+ };
128
+ };
129
+ hit: {
130
+ element: NonDeleted<ExcalidrawElement> | null;
131
+ allHitElements: NonDeleted<ExcalidrawElement>[];
132
+ wasAddedToSelection: boolean;
133
+ hasBeenDuplicated: boolean;
134
+ hasHitCommonBoundingBoxOfSelectedElements: boolean;
135
+ };
136
+ withCmdOrCtrl: boolean;
137
+ drag: {
138
+ hasOccurred: boolean;
139
+ offset: {
140
+ x: number;
141
+ y: number;
142
+ } | null;
143
+ };
144
+ eventListeners: {
145
+ onMove: {
146
+ (...args: any[]): void;
147
+ flush(): void;
148
+ cancel(): void;
149
+ } | null;
150
+ onUp: ((event: PointerEvent) => void) | null;
151
+ onKeyDown: ((event: KeyboardEvent) => void) | null;
152
+ onKeyUp: ((event: KeyboardEvent) => void) | null;
153
+ };
154
+ boxSelection: {
155
+ hasOccurred: boolean;
156
+ };
157
+ }>, event: React.PointerEvent<HTMLElement>]>;
158
+ onPointerUpEmitter: Emitter<[activeTool: {
159
+ lastActiveTool: import("../types").ActiveTool | null;
160
+ locked: boolean;
161
+ } & import("../types").ActiveTool, pointerDownState: Readonly<{
162
+ origin: Readonly<{
163
+ x: number;
164
+ y: number;
165
+ }>;
166
+ originInGrid: Readonly<{
167
+ x: number;
168
+ y: number;
169
+ }>;
170
+ scrollbars: {
171
+ isOverEither: boolean;
172
+ isOverHorizontal: boolean;
173
+ isOverVertical: boolean;
174
+ };
175
+ lastCoords: {
176
+ x: number;
177
+ y: number;
178
+ };
179
+ originalElements: Map<string, NonDeleted<ExcalidrawElement>>;
180
+ resize: {
181
+ handleType: import("../element/transformHandles").MaybeTransformHandleType;
182
+ isResizing: boolean;
183
+ offset: {
184
+ x: number;
185
+ y: number;
186
+ };
187
+ arrowDirection: "origin" | "end";
188
+ center: {
189
+ x: number;
190
+ y: number;
191
+ };
192
+ };
193
+ hit: {
194
+ element: NonDeleted<ExcalidrawElement> | null;
195
+ allHitElements: NonDeleted<ExcalidrawElement>[];
196
+ wasAddedToSelection: boolean;
197
+ hasBeenDuplicated: boolean;
198
+ hasHitCommonBoundingBoxOfSelectedElements: boolean;
199
+ };
200
+ withCmdOrCtrl: boolean;
201
+ drag: {
202
+ hasOccurred: boolean;
203
+ offset: {
204
+ x: number;
205
+ y: number;
206
+ } | null;
207
+ };
208
+ eventListeners: {
209
+ onMove: {
210
+ (...args: any[]): void;
211
+ flush(): void;
212
+ cancel(): void;
213
+ } | null;
214
+ onUp: ((event: PointerEvent) => void) | null;
215
+ onKeyDown: ((event: KeyboardEvent) => void) | null;
216
+ onKeyUp: ((event: KeyboardEvent) => void) | null;
217
+ };
218
+ boxSelection: {
219
+ hasOccurred: boolean;
220
+ };
221
+ }>, event: PointerEvent]>;
222
+ onUserFollowEmitter: Emitter<[payload: OnUserFollowedPayload]>;
223
+ onScrollChangeEmitter: Emitter<[scrollX: number, scrollY: number, zoom: Readonly<{
224
+ value: import("../types").NormalizedZoomValue;
225
+ }>]>;
226
+ missingPointerEventCleanupEmitter: Emitter<[event: PointerEvent | null]>;
227
+ onRemoveEventListenersEmitter: Emitter<[]>;
228
+ constructor(props: AppProps);
229
+ private onWindowMessage;
230
+ private cacheEmbeddableRef;
231
+ private getHTMLIFrameElement;
232
+ private handleEmbeddableCenterClick;
233
+ private isIframeLikeElementCenter;
234
+ private updateEmbedValidationStatus;
235
+ private updateEmbeddables;
236
+ private renderEmbeddables;
237
+ private getFrameNameDOMId;
238
+ frameNameBoundsCache: FrameNameBoundsCache;
239
+ private renderFrameNames;
240
+ private toggleOverscrollBehavior;
241
+ render(): JSX.Element;
242
+ focusContainer: AppClassProperties["focusContainer"];
243
+ getSceneElementsIncludingDeleted: () => readonly import("../element/types").OrderedExcalidrawElement[];
244
+ getSceneElements: () => readonly Ordered<NonDeletedExcalidrawElement>[];
245
+ onInsertElements: (elements: readonly ExcalidrawElement[]) => void;
246
+ onExportImage: (type: keyof typeof EXPORT_IMAGE_TYPES, elements: ExportedElements, opts: {
247
+ exportingFrame: ExcalidrawFrameLikeElement | null;
248
+ }) => Promise<void>;
249
+ private magicGenerations;
250
+ private updateMagicGeneration;
251
+ private getTextFromElements;
252
+ private onMagicFrameGenerate;
253
+ private onIframeSrcCopy;
254
+ private get OPENAI_KEY();
255
+ private set OPENAI_KEY(value);
256
+ private OPENAI_KEY_IS_PERSISTED;
257
+ private onOpenAIKeyChange;
258
+ private onMagicSettingsConfirm;
259
+ onMagicframeToolSelect: () => void;
260
+ private openEyeDropper;
261
+ dismissLinearEditor: () => void;
262
+ syncActionResult: (actionResult: ActionResult) => void;
263
+ private onBlur;
264
+ private onUnload;
265
+ private disableEvent;
266
+ private resetHistory;
267
+ private resetStore;
268
+ /**
269
+ * Resets scene & history.
270
+ * ! Do not use to clear scene user action !
271
+ */
272
+ private resetScene;
273
+ private initializeScene;
274
+ private isMobileBreakpoint;
275
+ private refreshViewportBreakpoints;
276
+ private refreshEditorBreakpoints;
277
+ componentDidMount(): Promise<void>;
278
+ componentWillUnmount(): void;
279
+ private onResize;
280
+ /** generally invoked only if fullscreen was invoked programmatically */
281
+ private onFullscreenChange;
282
+ private removeEventListeners;
283
+ private addEventListeners;
284
+ componentDidUpdate(prevProps: AppProps, prevState: AppState): void;
285
+ private renderInteractiveSceneCallback;
286
+ private onScroll;
287
+ private onCut;
288
+ private onCopy;
289
+ private static resetTapTwice;
290
+ private onTouchStart;
291
+ private onTouchEnd;
292
+ pasteFromClipboard: (event: ClipboardEvent) => Promise<void>;
293
+ addElementsFromPasteOrLibrary: (opts: {
294
+ elements: readonly ExcalidrawElement[];
295
+ files: BinaryFiles | null;
296
+ position: {
297
+ clientX: number;
298
+ clientY: number;
299
+ } | "cursor" | "center";
300
+ retainSeed?: boolean;
301
+ fitToContent?: boolean;
302
+ }) => void;
303
+ private addElementsFromMixedContentPaste;
304
+ private addTextFromPaste;
305
+ setAppState: React.Component<any, AppState>["setState"];
306
+ removePointer: (event: React.PointerEvent<HTMLElement> | PointerEvent) => void;
307
+ toggleLock: (source?: "keyboard" | "ui") => void;
308
+ updateFrameRendering: (opts: Partial<{
309
+ enabled: boolean;
310
+ name: boolean;
311
+ outline: boolean;
312
+ clip: boolean;
313
+ }> | ((prevState: AppState["frameRendering"]) => Partial<AppState["frameRendering"]>)) => void;
314
+ togglePenMode: (force: boolean | null) => void;
315
+ onHandToolToggle: () => void;
316
+ /**
317
+ * Zooms on canvas viewport center
318
+ */
319
+ zoomCanvas: (value: number) => void;
320
+ private cancelInProgressAnimation;
321
+ scrollToContent: (target?: ExcalidrawElement | readonly ExcalidrawElement[], opts?: {
322
+ fitToContent?: boolean;
323
+ fitToViewport?: never;
324
+ viewportZoomFactor?: number;
325
+ animate?: boolean;
326
+ duration?: number;
327
+ } | {
328
+ fitToContent?: never;
329
+ fitToViewport?: boolean;
330
+ /** when fitToViewport=true, how much screen should the content cover,
331
+ * between 0.1 (10%) and 1 (100%)
332
+ */
333
+ viewportZoomFactor?: number;
334
+ animate?: boolean;
335
+ duration?: number;
336
+ }) => void;
337
+ private maybeUnfollowRemoteUser;
338
+ /** use when changing scrollX/scrollY/zoom based on user interaction */
339
+ private translateCanvas;
340
+ zoomToFit: (target?: readonly ExcalidrawElement[], maxZoom?: number, margin?: number) => void;
341
+ startLineEditor: (el: ExcalidrawLinearElement, selectedPointsIndices?: number[] | null) => void;
342
+ updateContainerSize: (containers: NonDeletedExcalidrawElement[]) => void;
343
+ setToast: (toast: {
344
+ message: string;
345
+ closable?: boolean;
346
+ duration?: number;
347
+ } | null) => void;
348
+ restoreFileFromShare: () => Promise<void>;
349
+ /** adds supplied files to existing files in the appState */
350
+ addFiles: ExcalidrawImperativeAPI["addFiles"];
351
+ setMobileModeAllowed: ExcalidrawImperativeAPI["setMobileModeAllowed"];
352
+ selectElements: ExcalidrawImperativeAPI["selectElements"];
353
+ bringToFront: ExcalidrawImperativeAPI["bringToFront"];
354
+ bringForward: ExcalidrawImperativeAPI["bringForward"];
355
+ sendToBack: ExcalidrawImperativeAPI["sendToBack"];
356
+ sendBackward: ExcalidrawImperativeAPI["sendBackward"];
357
+ updateScene: <K extends keyof AppState>(sceneData: {
358
+ elements?: SceneData["elements"];
359
+ appState?: Pick<AppState, K> | null | undefined;
360
+ collaborators?: SceneData["collaborators"];
361
+ /** @default StoreAction.NONE */
362
+ storeAction?: SceneData["storeAction"];
363
+ forceFlushSync?: boolean | undefined;
364
+ }) => void;
365
+ private triggerRender;
366
+ /**
367
+ * @returns whether the menu was toggled on or off
368
+ */
369
+ toggleSidebar: ({ name, tab, force, }: {
370
+ name: SidebarName | null;
371
+ tab?: string | undefined;
372
+ force?: boolean | undefined;
373
+ }) => boolean;
374
+ private updateCurrentCursorPosition;
375
+ private getEditorUIOffsets;
376
+ private onKeyDown;
377
+ private onWheel;
378
+ private onKeyUp;
379
+ private isToolSupported;
380
+ setActiveTool: (tool: (({
381
+ type: Exclude<ToolType, "image">;
382
+ } | {
383
+ type: Extract<ToolType, "image">;
384
+ insertOnCanvasDirectly?: boolean;
385
+ }) | {
386
+ type: "custom";
387
+ customType: string;
388
+ }) & {
389
+ locked?: boolean;
390
+ }) => void;
391
+ setOpenDialog: (dialogType: AppState["openDialog"]) => void;
392
+ private setCursor;
393
+ private resetCursor;
394
+ /**
395
+ * returns whether user is making a gesture with >= 2 fingers (points)
396
+ * on o touch screen (not on a trackpad). Currently only relates to Darwin
397
+ * (iOS/iPadOS,MacOS), but may work on other devices in the future if
398
+ * GestureEvent is standardized.
399
+ */
400
+ private isTouchScreenMultiTouchGesture;
401
+ getName: () => string;
402
+ private onGestureStart;
403
+ private onGestureChange;
404
+ private onGestureEnd;
405
+ private handleTextWysiwyg;
406
+ private deselectElements;
407
+ private getTextElementAtPosition;
408
+ private getElementAtPosition;
409
+ private getElementsAtPosition;
410
+ private getElementHitThreshold;
411
+ private hitElement;
412
+ private getTextBindableContainerAtPosition;
413
+ private startTextEditing;
414
+ private debounceDoubleClickTimestamp;
415
+ private handleCanvasDoubleClick;
416
+ private getElementLinkAtPosition;
417
+ private redirectToLink;
418
+ private getTopLayerFrameAtSceneCoords;
419
+ private handleCanvasPointerMove;
420
+ private handleEraser;
421
+ private handleTouchMove;
422
+ handleHoverSelectedLinearElement(linearElementEditor: LinearElementEditor, scenePointerX: number, scenePointerY: number): void;
423
+ private handleCanvasPointerDown;
424
+ private handleCanvasPointerUp;
425
+ private maybeOpenContextMenuAfterPointerDownOnTouchDevices;
426
+ private resetContextMenuTimer;
427
+ /**
428
+ * pointerup may not fire in certian cases (user tabs away...), so in order
429
+ * to properly cleanup pointerdown state, we need to fire any hanging
430
+ * pointerup handlers manually
431
+ */
432
+ private maybeCleanupAfterMissingPointerUp;
433
+ private handleCanvasPanUsingWheelOrSpaceDrag;
434
+ private updateGestureOnPointerDown;
435
+ private initialPointerDownState;
436
+ private handleDraggingScrollBar;
437
+ private clearSelectionIfNotUsingSelection;
438
+ /**
439
+ * @returns whether the pointer event has been completely handled
440
+ */
441
+ private handleSelectionOnPointerDown;
442
+ private isASelectedElement;
443
+ private isHittingCommonBoundingBoxOfSelectedElements;
444
+ private handleTextOnPointerDown;
445
+ private handleFreeDrawElementOnPointerDown;
446
+ insertIframeElement: ({ sceneX, sceneY, width, height, }: {
447
+ sceneX: number;
448
+ sceneY: number;
449
+ width: number;
450
+ height: number;
451
+ }) => NonDeleted<ExcalidrawIframeElement>;
452
+ insertEmbeddableElement: ({ sceneX, sceneY, link, }: {
453
+ sceneX: number;
454
+ sceneY: number;
455
+ link: string;
456
+ }) => NonDeleted<ExcalidrawEmbeddableElement> | undefined;
457
+ private createImageElement;
458
+ private handleLinearElementOnPointerDown;
459
+ private getCurrentItemRoundness;
460
+ private createGenericElementOnPointerDown;
461
+ private createFrameElementOnPointerDown;
462
+ private maybeCacheReferenceSnapPoints;
463
+ private maybeCacheVisibleGaps;
464
+ private onKeyDownFromPointerDownHandler;
465
+ private onKeyUpFromPointerDownHandler;
466
+ private onPointerMoveFromPointerDownHandler;
467
+ private handlePointerMoveOverScrollbars;
468
+ private onPointerUpFromPointerDownHandler;
469
+ private restoreReadyToEraseElements;
470
+ private eraseElements;
471
+ private initializeImage;
472
+ /**
473
+ * inserts image into elements array and rerenders
474
+ */
475
+ private insertImageElement;
476
+ private setImagePreviewCursor;
477
+ private onImageAction;
478
+ private initializeImageDimensions;
479
+ /** updates image cache, refreshing updated elements and/or setting status
480
+ to error for images that fail during <img> element creation */
481
+ private updateImageCache;
482
+ /** adds new images to imageCache and re-renders if needed */
483
+ private addNewImagesToImageCache;
484
+ /** generally you should use `addNewImagesToImageCache()` directly if you need
485
+ * to render new images. This is just a failsafe */
486
+ private scheduleImageRefresh;
487
+ private updateBindingEnabledOnPointerMove;
488
+ private maybeSuggestBindingAtCursor;
489
+ private maybeSuggestBindingsForLinearElementAtCoords;
490
+ setSelection(elements: readonly NonDeletedExcalidrawElement[]): void;
491
+ private clearSelection;
492
+ private handleInteractiveCanvasRef;
493
+ private handleAppOnDrop;
494
+ loadFileToCanvas: (file: File, fileHandle: FileSystemHandle | null) => Promise<void>;
495
+ private handleCanvasContextMenu;
496
+ private maybeDragNewGenericElement;
497
+ private maybeHandleResize;
498
+ private getContextMenuItems;
499
+ private handleWheel;
500
+ private getTextWysiwygSnappedToCenterPosition;
501
+ private savePointer;
502
+ private resetShouldCacheIgnoreZoomDebounced;
503
+ private updateDOMRect;
504
+ refresh: () => void;
505
+ private getCanvasOffsets;
506
+ private updateLanguage;
507
+ }
508
+ declare global {
509
+ interface Window {
510
+ h: {
511
+ scene: Scene;
512
+ elements: readonly ExcalidrawElement[];
513
+ state: AppState;
514
+ setState: React.Component<any, AppState>["setState"];
515
+ app: InstanceType<typeof App>;
516
+ history: History;
517
+ store: Store;
518
+ };
519
+ }
520
+ }
521
+ export default App;