@excalidraw/math 0.18.0-4a5c9e9 → 0.18.0-4ce8305

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 (246) hide show
  1. package/dist/dev/index.js +313 -115
  2. package/dist/dev/index.js.map +4 -4
  3. package/dist/prod/index.js +1 -1
  4. package/dist/types/common/src/colors.d.ts +23 -1
  5. package/dist/types/common/src/constants.d.ts +66 -7
  6. package/dist/types/common/src/keys.d.ts +4 -0
  7. package/dist/types/common/src/points.d.ts +1 -1
  8. package/dist/types/common/src/random.d.ts +7 -0
  9. package/dist/types/common/src/utils.d.ts +13 -44
  10. package/dist/types/element/src/Scene.d.ts +7 -5
  11. package/dist/types/element/src/align.d.ts +5 -2
  12. package/dist/types/element/src/arrowEndpointText.d.ts +49 -0
  13. package/dist/types/element/src/arrows/focus.d.ts +5 -2
  14. package/dist/types/element/src/binding.d.ts +64 -13
  15. package/dist/types/element/src/bounds.d.ts +31 -8
  16. package/dist/types/element/src/bucketFill.d.ts +110 -0
  17. package/dist/types/element/src/collision.d.ts +21 -5
  18. package/dist/types/element/src/comparisons.d.ts +8 -5
  19. package/dist/types/element/src/convertToShape.d.ts +23 -0
  20. package/dist/types/element/src/cropElement.d.ts +36 -4
  21. package/dist/types/element/src/delta.d.ts +30 -2
  22. package/dist/types/element/src/distribute.d.ts +5 -2
  23. package/dist/types/element/src/dragElements.d.ts +34 -2
  24. package/dist/types/element/src/duplicate.d.ts +64 -3
  25. package/dist/types/element/src/elbowArrow.d.ts +5 -0
  26. package/dist/types/element/src/embeddable.d.ts +3 -2
  27. package/dist/types/element/src/flowchart.d.ts +11 -7
  28. package/dist/types/element/src/fractionalIndex.d.ts +2 -2
  29. package/dist/types/element/src/frame.d.ts +11 -10
  30. package/dist/types/element/src/groups.d.ts +10 -15
  31. package/dist/types/element/src/image.d.ts +5 -2
  32. package/dist/types/element/src/index.d.ts +7 -1
  33. package/dist/types/element/src/linearElementEditor.d.ts +31 -11
  34. package/dist/types/element/src/listMarker.d.ts +39 -0
  35. package/dist/types/element/src/mutateElement.d.ts +1 -1
  36. package/dist/types/element/src/newElement.d.ts +55 -3
  37. package/dist/types/element/src/renderElement.d.ts +31 -7
  38. package/dist/types/element/src/renderEnvironment.d.ts +66 -0
  39. package/dist/types/element/src/resizeElements.d.ts +14 -4
  40. package/dist/types/element/src/selection.d.ts +6 -12
  41. package/dist/types/element/src/shape.d.ts +29 -1
  42. package/dist/types/element/src/sizeHelpers.d.ts +6 -0
  43. package/dist/types/element/src/sortElements.d.ts +10 -0
  44. package/dist/types/element/src/stickyNote.d.ts +191 -0
  45. package/dist/types/element/src/textElement.d.ts +22 -10
  46. package/dist/types/element/src/textMeasurements.d.ts +15 -11
  47. package/dist/types/element/src/textWrapping.d.ts +3 -2
  48. package/dist/types/element/src/transform.d.ts +31 -8
  49. package/dist/types/element/src/typeChecks.d.ts +29 -27
  50. package/dist/types/element/src/types.d.ts +43 -7
  51. package/dist/types/element/src/utils.d.ts +15 -4
  52. package/dist/types/element/src/zindex.d.ts +2 -2
  53. package/dist/types/excalidraw/actions/actionAddToLibrary.d.ts +87 -18
  54. package/dist/types/excalidraw/actions/actionAlign.d.ts +6 -6
  55. package/dist/types/excalidraw/actions/actionBoundText.d.ts +74 -203
  56. package/dist/types/excalidraw/actions/actionCanvas.d.ts +271 -946
  57. package/dist/types/excalidraw/actions/actionClipboard.d.ts +58 -12
  58. package/dist/types/excalidraw/actions/actionCropEditor.d.ts +29 -6
  59. package/dist/types/excalidraw/actions/actionDeleteSelected.d.ts +4 -518
  60. package/dist/types/excalidraw/actions/actionDeselect.d.ts +31 -8
  61. package/dist/types/excalidraw/actions/actionDistribute.d.ts +2 -3
  62. package/dist/types/excalidraw/actions/actionElementLink.d.ts +29 -6
  63. package/dist/types/excalidraw/actions/actionElementLock.d.ts +59 -13
  64. package/dist/types/excalidraw/actions/actionExport.d.ts +66 -20
  65. package/dist/types/excalidraw/actions/actionFinalize.d.ts +1 -0
  66. package/dist/types/excalidraw/actions/actionFrame.d.ts +114 -651
  67. package/dist/types/excalidraw/actions/actionGroup.d.ts +73 -27
  68. package/dist/types/excalidraw/actions/actionLinearEditor.d.ts +84 -9
  69. package/dist/types/excalidraw/actions/actionLink.d.ts +30 -7
  70. package/dist/types/excalidraw/actions/actionMenu.d.ts +29 -6
  71. package/dist/types/excalidraw/actions/actionProperties.d.ts +96 -34
  72. package/dist/types/excalidraw/actions/actionSelectAll.d.ts +35 -12
  73. package/dist/types/excalidraw/actions/actionStyles.d.ts +30 -7
  74. package/dist/types/excalidraw/actions/actionTextAutoResize.d.ts +1 -1
  75. package/dist/types/excalidraw/actions/actionToggleArrowBinding.d.ts +30 -7
  76. package/dist/types/excalidraw/actions/actionToggleGridMode.d.ts +33 -11
  77. package/dist/types/excalidraw/actions/actionToggleMidpointSnapping.d.ts +30 -7
  78. package/dist/types/excalidraw/actions/actionToggleObjectsSnapMode.d.ts +30 -7
  79. package/dist/types/excalidraw/actions/actionToggleSearchMenu.d.ts +33 -11
  80. package/dist/types/excalidraw/actions/actionToggleShapeSwitch.d.ts +1 -1
  81. package/dist/types/excalidraw/actions/{actionEmbeddable.d.ts → actionToggleShowHints.d.ts} +45 -19
  82. package/dist/types/excalidraw/actions/actionToggleStats.d.ts +30 -7
  83. package/dist/types/excalidraw/actions/actionToggleViewMode.d.ts +31 -8
  84. package/dist/types/excalidraw/actions/actionToggleWrap.d.ts +12 -0
  85. package/dist/types/excalidraw/actions/actionToggleZenMode.d.ts +30 -7
  86. package/dist/types/excalidraw/actions/colorTargets.d.ts +39 -0
  87. package/dist/types/excalidraw/actions/index.d.ts +3 -2
  88. package/dist/types/excalidraw/actions/manager.d.ts +1 -0
  89. package/dist/types/excalidraw/actions/shortcuts.d.ts +1 -1
  90. package/dist/types/excalidraw/actions/types.d.ts +8 -4
  91. package/dist/types/excalidraw/{animated-trail.d.ts → animatedTrail.d.ts} +4 -3
  92. package/dist/types/excalidraw/appState.d.ts +36 -12
  93. package/dist/types/excalidraw/charts/charts.bar.d.ts +2 -1
  94. package/dist/types/excalidraw/charts/charts.helpers.d.ts +6 -5
  95. package/dist/types/excalidraw/charts/charts.line.d.ts +2 -1
  96. package/dist/types/excalidraw/charts/charts.radar.d.ts +2 -1
  97. package/dist/types/excalidraw/charts/index.d.ts +2 -1
  98. package/dist/types/excalidraw/components/Actions.d.ts +17 -12
  99. package/dist/types/excalidraw/components/ActiveConfirmDialog.d.ts +1 -1
  100. package/dist/types/excalidraw/components/App.arrowText.d.ts +70 -0
  101. package/dist/types/excalidraw/components/App.bucketFill.d.ts +48 -0
  102. package/dist/types/excalidraw/components/App.clipboard.d.ts +31 -0
  103. package/dist/types/excalidraw/components/App.cursor.d.ts +38 -0
  104. package/dist/types/excalidraw/components/App.d.ts +332 -110
  105. package/dist/types/excalidraw/components/App.drawshape.d.ts +55 -0
  106. package/dist/types/excalidraw/components/App.duplicate.d.ts +101 -0
  107. package/dist/types/excalidraw/components/App.flowchart.d.ts +21 -0
  108. package/dist/types/excalidraw/components/App.host.d.ts +102 -0
  109. package/dist/types/excalidraw/components/App.modifiers.d.ts +38 -0
  110. package/dist/types/excalidraw/components/App.pan.d.ts +62 -0
  111. package/dist/types/excalidraw/components/App.selection.d.ts +265 -0
  112. package/dist/types/excalidraw/components/App.selectionTool.d.ts +93 -0
  113. package/dist/types/excalidraw/components/App.text.d.ts +146 -0
  114. package/dist/types/excalidraw/components/App.textTool.d.ts +140 -0
  115. package/dist/types/excalidraw/components/App.toolDrag.d.ts +63 -0
  116. package/dist/types/excalidraw/components/App.viewport.d.ts +123 -0
  117. package/dist/types/excalidraw/components/App.wheel.d.ts +26 -0
  118. package/dist/types/excalidraw/components/App.wrap.d.ts +31 -0
  119. package/dist/types/excalidraw/components/ColorPicker/ColorPicker.d.ts +9 -3
  120. package/dist/types/excalidraw/components/ColorPicker/CustomColorList.d.ts +3 -1
  121. package/dist/types/excalidraw/components/ColorPicker/Picker.d.ts +5 -1
  122. package/dist/types/excalidraw/components/ColorPicker/PickerColorList.d.ts +9 -2
  123. package/dist/types/excalidraw/components/ColorPicker/ShadeList.d.ts +4 -2
  124. package/dist/types/excalidraw/components/ColorPicker/TopPicks.d.ts +8 -1
  125. package/dist/types/excalidraw/components/ColorPicker/colorPickerUtils.d.ts +1 -1
  126. package/dist/types/excalidraw/components/ColorPicker/colorTopPicksDnD.d.ts +11 -0
  127. package/dist/types/excalidraw/components/ColorPicker/keyboardNavHandlers.d.ts +2 -1
  128. package/dist/types/excalidraw/components/CommandPalette/defaultCommandPaletteItems.d.ts +1 -2
  129. package/dist/types/excalidraw/components/ConvertElementTypePopup.d.ts +4 -3
  130. package/dist/types/excalidraw/components/CursorHint.d.ts +46 -0
  131. package/dist/types/excalidraw/components/EyeDropper.d.ts +1 -1
  132. package/dist/types/excalidraw/components/FileDropOverlay.d.ts +2 -0
  133. package/dist/types/excalidraw/components/FontPicker/FontPicker.d.ts +4 -1
  134. package/dist/types/excalidraw/components/FontPicker/FontPickerList.d.ts +6 -1
  135. package/dist/types/excalidraw/components/FontPicker/fontTopPicksDnD.d.ts +12 -0
  136. package/dist/types/excalidraw/components/IconButton.d.ts +48 -0
  137. package/dist/types/excalidraw/components/Island.d.ts +7 -0
  138. package/dist/types/excalidraw/components/LaserPointerButton.d.ts +2 -4
  139. package/dist/types/excalidraw/components/LayerUI.d.ts +5 -2
  140. package/dist/types/excalidraw/components/LibraryMenu.d.ts +1 -1
  141. package/dist/types/excalidraw/components/LibraryMenuSection.d.ts +6 -2
  142. package/dist/types/excalidraw/components/LibraryUnit.d.ts +7 -2
  143. package/dist/types/excalidraw/components/LockButton.d.ts +3 -4
  144. package/dist/types/excalidraw/components/MagicButton.d.ts +0 -2
  145. package/dist/types/excalidraw/components/MobileMenu.d.ts +4 -4
  146. package/dist/types/excalidraw/components/MobileToolbar.d.ts +9 -0
  147. package/dist/types/excalidraw/components/OverwriteConfirm/OverwriteConfirmState.d.ts +1 -1
  148. package/dist/types/excalidraw/components/PenModeButton.d.ts +2 -5
  149. package/dist/types/excalidraw/components/Popover.d.ts +1 -3
  150. package/dist/types/excalidraw/components/{ButtonIcon.d.ts → RadioButton.d.ts} +2 -5
  151. package/dist/types/excalidraw/components/SVGLayer.d.ts +1 -1
  152. package/dist/types/excalidraw/components/SearchMenu.d.ts +1 -1
  153. package/dist/types/excalidraw/components/Sidebar/Sidebar.d.ts +1 -1
  154. package/dist/types/excalidraw/components/Stats/Angle.d.ts +2 -2
  155. package/dist/types/excalidraw/components/Stats/Dimension.d.ts +2 -2
  156. package/dist/types/excalidraw/components/Stats/DragInput.d.ts +2 -2
  157. package/dist/types/excalidraw/components/Stats/MultiAngle.d.ts +2 -2
  158. package/dist/types/excalidraw/components/Stats/MultiDimension.d.ts +2 -2
  159. package/dist/types/excalidraw/components/Stats/MultiPosition.d.ts +2 -2
  160. package/dist/types/excalidraw/components/Stats/Position.d.ts +3 -3
  161. package/dist/types/excalidraw/components/Stats/utils.d.ts +4 -2
  162. package/dist/types/excalidraw/components/TTDDialog/MermaidToExcalidraw.d.ts +2 -1
  163. package/dist/types/excalidraw/components/TTDDialog/TTDContext.d.ts +4 -4
  164. package/dist/types/excalidraw/components/TTDDialog/TTDDialogOutput.d.ts +5 -2
  165. package/dist/types/excalidraw/components/TTDDialog/TTDPreviewPanel.d.ts +5 -2
  166. package/dist/types/excalidraw/components/TTDDialog/TextToDiagram.d.ts +2 -1
  167. package/dist/types/excalidraw/components/TTDDialog/common.d.ts +4 -1
  168. package/dist/types/excalidraw/components/TTDDialog/hooks/useTextGeneration.d.ts +3 -2
  169. package/dist/types/excalidraw/components/TTDDialog/types.d.ts +14 -1
  170. package/dist/types/excalidraw/components/TTDDialog/useTTDChatStorage.d.ts +3 -3
  171. package/dist/types/excalidraw/components/TTDDialog/utils/mermaidError.d.ts +27 -1
  172. package/dist/types/excalidraw/components/ToolPopover.d.ts +3 -6
  173. package/dist/types/excalidraw/components/Toolbar.d.ts +11 -0
  174. package/dist/types/excalidraw/components/Tools.d.ts +151 -0
  175. package/dist/types/excalidraw/components/Tooltip.d.ts +26 -2
  176. package/dist/types/excalidraw/components/TopPicksDnD/TopPicksContextMenu.d.ts +14 -0
  177. package/dist/types/excalidraw/components/TopPicksDnD/TopPicksTip.d.ts +11 -0
  178. package/dist/types/excalidraw/components/TopPicksDnD/topPicksDnD.d.ts +58 -0
  179. package/dist/types/excalidraw/components/UserList.d.ts +3 -2
  180. package/dist/types/excalidraw/components/ViewportStatusFrame/ViewportStatusFrame.d.ts +11 -0
  181. package/dist/types/excalidraw/components/canvases/InteractiveCanvas.d.ts +3 -2
  182. package/dist/types/excalidraw/components/canvases/NewElementCanvas.d.ts +3 -0
  183. package/dist/types/excalidraw/components/canvases/StaticCanvas.d.ts +1 -1
  184. package/dist/types/excalidraw/components/dropdownMenu/DropdownMenuItemContentRadio.d.ts +2 -1
  185. package/dist/types/excalidraw/components/footer/Footer.d.ts +3 -1
  186. package/dist/types/excalidraw/components/hyperlink/Hyperlink.d.ts +3 -2
  187. package/dist/types/excalidraw/components/hyperlink/helpers.d.ts +15 -4
  188. package/dist/types/excalidraw/components/icons.d.ts +7 -1
  189. package/dist/types/excalidraw/components/main-menu/DefaultItems.d.ts +10 -4
  190. package/dist/types/excalidraw/components/positionElementBesideCursor.d.ts +26 -0
  191. package/dist/types/excalidraw/components/shapeActionPredicates.d.ts +39 -0
  192. package/dist/types/excalidraw/data/blob.d.ts +74 -28
  193. package/dist/types/excalidraw/data/index.d.ts +7 -7
  194. package/dist/types/excalidraw/data/json.d.ts +43 -20
  195. package/dist/types/excalidraw/data/library.d.ts +1 -1
  196. package/dist/types/excalidraw/drawShapeTrail.d.ts +16 -0
  197. package/dist/types/excalidraw/eraser/index.d.ts +2 -3
  198. package/dist/types/excalidraw/fonts/Fonts.d.ts +12 -8
  199. package/dist/types/excalidraw/history.d.ts +10 -4
  200. package/dist/types/excalidraw/hooks/useAppStateValue.d.ts +29 -0
  201. package/dist/types/excalidraw/hooks/useLibraryItemSvg.d.ts +1 -1
  202. package/dist/types/excalidraw/hooks/useTextEditorFocus.d.ts +5 -5
  203. package/dist/types/excalidraw/{laser-trails.d.ts → laserTrails.d.ts} +5 -7
  204. package/dist/types/excalidraw/lasso/index.d.ts +2 -3
  205. package/dist/types/excalidraw/lasso/utils.d.ts +2 -0
  206. package/dist/types/excalidraw/reactUtils.d.ts +1 -1
  207. package/dist/types/excalidraw/renderOverrides.d.ts +9 -0
  208. package/dist/types/excalidraw/renderer/animation.d.ts +15 -4
  209. package/dist/types/excalidraw/renderer/helpers.d.ts +25 -0
  210. package/dist/types/excalidraw/renderer/interactiveScene.d.ts +2 -4
  211. package/dist/types/excalidraw/renderer/staticScene.d.ts +11 -6
  212. package/dist/types/excalidraw/scene/Renderer.d.ts +490 -21
  213. package/dist/types/excalidraw/scene/export.d.ts +344 -21
  214. package/dist/types/excalidraw/scene/index.d.ts +2 -2
  215. package/dist/types/excalidraw/scene/types.d.ts +30 -5
  216. package/dist/types/excalidraw/snapping.d.ts +7 -7
  217. package/dist/types/excalidraw/types.d.ts +579 -29
  218. package/dist/types/excalidraw/viewport.d.ts +302 -0
  219. package/dist/types/excalidraw/wysiwyg/textWysiwyg.d.ts +13 -3
  220. package/dist/types/fractional-indexing/src/index.d.ts +29 -0
  221. package/dist/types/laser-pointer/src/index.d.ts +2 -0
  222. package/dist/types/laser-pointer/src/math.d.ts +16 -0
  223. package/dist/types/laser-pointer/src/simplify.d.ts +2 -0
  224. package/dist/types/laser-pointer/src/state.d.ts +36 -0
  225. package/dist/types/math/src/constants.d.ts +0 -1
  226. package/dist/types/math/src/curve.d.ts +23 -13
  227. package/dist/types/math/src/index.d.ts +1 -0
  228. package/dist/types/math/src/pca.d.ts +79 -0
  229. package/dist/types/math/src/point.d.ts +1 -0
  230. package/dist/types/math/src/polygon.d.ts +25 -1
  231. package/dist/types/math/src/segment.d.ts +6 -0
  232. package/dist/types/utils/src/index.d.ts +4 -3
  233. package/dist/types/utils/src/shape.d.ts +2 -2
  234. package/package.json +2 -2
  235. package/dist/types/excalidraw/animation-frame-handler.d.ts +0 -16
  236. package/dist/types/excalidraw/components/FollowMode/FollowMode.d.ts +0 -10
  237. package/dist/types/excalidraw/components/HandButton.d.ts +0 -10
  238. package/dist/types/excalidraw/components/MobileToolBar.d.ts +0 -10
  239. package/dist/types/excalidraw/components/ToolButton.d.ts +0 -49
  240. package/dist/types/excalidraw/components/shapes.d.ts +0 -263
  241. package/dist/types/excalidraw/cursor.d.ts +0 -5
  242. package/dist/types/excalidraw/scene/scroll.d.ts +0 -18
  243. package/dist/types/excalidraw/scene/zoom.d.ts +0 -12
  244. package/dist/types/utils/src/bbox.d.ts +0 -9
  245. package/dist/types/utils/src/export.d.ts +0 -35
  246. package/dist/types/utils/src/withinBounds.d.ts +0 -19
@@ -1,21 +1,41 @@
1
1
  import React from "react";
2
2
  import { AppEventBus, type EXPORT_IMAGE_TYPES, Emitter, type EditorInterface, type StylesPanelMode } from "@excalidraw/common";
3
- import { LinearElementEditor, FlowChartCreator, Scene, Store, type ElementUpdate, StoreDelta, type ApplyToOptions } from "@excalidraw/element";
3
+ import { LinearElementEditor, Scene, Store, type ElementUpdate, StoreDelta, type ApplyToOptions } from "@excalidraw/element";
4
4
  import type { ExcalidrawElement, NonDeleted, NonDeletedExcalidrawElement, ExcalidrawFrameLikeElement, ExcalidrawIframeElement, ExcalidrawEmbeddableElement, Ordered, SceneElementsMap } from "@excalidraw/element/types";
5
+ import type { RenderEnvironment, TransformHandleDirection } from "@excalidraw/element";
5
6
  import type { Mutable } from "@excalidraw/common/utility-types";
6
7
  import { ActionManager } from "../actions/manager";
7
- import { AnimationFrameHandler } from "../animation-frame-handler";
8
8
  import { History } from "../history";
9
9
  import { Fonts } from "../fonts";
10
10
  import { type WritableAtom } from "../editor-jotai";
11
11
  import { Renderer } from "../scene/Renderer";
12
- import { LaserTrails } from "../laser-trails";
12
+ import { type SetViewportOptions } from "../viewport";
13
+ import { LaserTrails } from "../laserTrails";
13
14
  import { isOverScrollBars } from "../scene/scrollbars";
14
15
  import { LassoTrail } from "../lasso";
15
16
  import { EraserTrail } from "../eraser";
17
+ import { AppArrowText } from "./App.arrowText";
18
+ import { AppClipboard } from "./App.clipboard";
19
+ import { AppText } from "./App.text";
20
+ import { AppTextTool } from "./App.textTool";
21
+ import { AppBucketFill } from "./App.bucketFill";
22
+ import { AppToolDrag } from "./App.toolDrag";
23
+ import { AppCursor } from "./App.cursor";
24
+ import { AppDrawShape } from "./App.drawshape";
25
+ import { AppDuplicate } from "./App.duplicate";
26
+ import { AppFlowchart } from "./App.flowchart";
27
+ import { AppModifiers } from "./App.modifiers";
28
+ import { AppPan } from "./App.pan";
29
+ import { AppViewport } from "./App.viewport";
30
+ import { AppWheel } from "./App.wheel";
31
+ import { AppSelection } from "./App.selection";
32
+ import { AppSelectionTool } from "./App.selectionTool";
33
+ import { AppWrap } from "./App.wrap";
34
+ import { AppHost } from "./App.host";
35
+ import { CursorHints } from "./CursorHint";
16
36
  import { type OnStateChange } from "./AppStateObserver";
17
37
  import type { ExportedElements } from "../data";
18
- import type { AppClassProperties, AppProps, AppState, ExcalidrawImperativeAPI, BinaryFiles, LibraryItems, SceneData, FrameNameBoundsCache, SidebarName, SidebarTabName, ToolType, OnUserFollowedPayload, ExcalidrawImperativeAPIEventMap, GenerateDiagramToCode, NullableGridSize, Offsets } from "../types";
38
+ import type { AppClassProperties, AppProps, AppState, ElementRenderOverrides, ExcalidrawImperativeAPI, BinaryFiles, LibraryItems, PointerDownState, SceneData, FrameNameBoundsCache, SidebarName, SidebarTabName, KeyboardModifiersObject, ToolType, OnUserFollowedPayload, ExcalidrawImperativeAPIEventMap, GenerateDiagramToCode, NullableGridSize, UIConfig } from "../types";
19
39
  import type { RoughCanvas } from "roughjs/bin/canvas";
20
40
  import type { ActionResult } from "../actions/types";
21
41
  declare const editorLifecycleEventBehavior: {
@@ -74,15 +94,29 @@ declare class App extends React.Component<AppProps, AppState> {
74
94
  editorInterface: EditorInterface;
75
95
  private stylesPanelMode;
76
96
  private excalidrawContainerRef;
97
+ private zenModeTransitionTimer;
98
+ get ownerDocument(): Document;
99
+ get ownerWindow(): Window & typeof globalThis;
100
+ /**
101
+ * Everything binding this editor to the document/window it renders into
102
+ * (render environment, hyperlink tooltip ownership). Delegated to so the
103
+ * cross-document ownership rules live in one place.
104
+ */
105
+ host: AppHost;
106
+ /** @see AppHost.renderEnvironment */
107
+ get renderEnvironment(): RenderEnvironment;
77
108
  scene: Scene;
78
109
  fonts: Fonts;
79
110
  renderer: Renderer;
80
111
  visibleElements: readonly NonDeletedExcalidrawElement[];
112
+ /** whether the last render had any renderable elements (excludes e.g. the
113
+ * in-progress `newElement` and the edited text element) */
114
+ private hasRenderableElements;
81
115
  private resizeObserver;
82
116
  library: AppClassProperties["library"];
83
117
  libraryItemsFromStorage: LibraryItems | undefined;
84
118
  id: string;
85
- private store;
119
+ store: Store;
86
120
  private history;
87
121
  excalidrawContainerValue: {
88
122
  container: HTMLDivElement | null;
@@ -107,11 +141,31 @@ declare class App extends React.Component<AppProps, AppState> {
107
141
  onEvent: AppEventBus<ExcalidrawImperativeAPIEventMap, typeof editorLifecycleEventBehavior>["on"];
108
142
  private appStateObserver;
109
143
  onStateChange: OnStateChange;
110
- flowChartCreator: FlowChartCreator;
111
- private flowChartNavigator;
144
+ bucketFill: AppBucketFill;
145
+ duplicate: AppDuplicate;
146
+ toolDrag: AppToolDrag;
147
+ flowchart: AppFlowchart;
148
+ cursor: AppCursor;
149
+ arrowText: AppArrowText;
150
+ pan: AppPan;
151
+ textTool: AppTextTool;
152
+ clipboard: AppClipboard;
153
+ text: AppText;
154
+ viewport: AppViewport;
155
+ wheel: AppWheel;
156
+ selection: AppSelection;
157
+ selectionTool: AppSelectionTool;
158
+ wrap: AppWrap;
112
159
  bindModeHandler: ReturnType<typeof setTimeout> | null;
113
160
  hitLinkElement?: NonDeletedExcalidrawElement;
114
161
  lastPointerDownEvent: React.PointerEvent<HTMLElement> | null;
162
+ /**
163
+ * the handle of the resize in progress while `state.isResizing` — for UI
164
+ * that words itself by handle (a sticky note's corners resize
165
+ * proportionally, its edges freely); not app state, so it costs no
166
+ * re-render of its own
167
+ */
168
+ activeResizeHandle: TransformHandleDirection | null;
115
169
  lastPointerUpEvent: React.PointerEvent<HTMLElement> | PointerEvent | null;
116
170
  lastPointerUpIsDoubleClick: boolean;
117
171
  lastPointerMoveEvent: PointerEvent | null;
@@ -121,19 +175,11 @@ declare class App extends React.Component<AppProps, AppState> {
121
175
  y: number;
122
176
  } | null;
123
177
  private lastCompletedCanvasClicks;
124
- /** previous frame pointer coords */
125
- previousPointerMoveCoords: {
126
- x: number;
127
- y: number;
128
- } | null;
129
- lastViewportPosition: {
130
- x: number;
131
- y: number;
132
- };
133
- animationFrameHandler: AnimationFrameHandler;
178
+ drawShape: AppDrawShape;
134
179
  laserTrails: LaserTrails;
135
180
  eraserTrail: EraserTrail;
136
181
  lassoTrail: LassoTrail;
182
+ cursorHints: CursorHints;
137
183
  onChangeEmitter: Emitter<[elements: readonly ExcalidrawElement[], appState: AppState, files: BinaryFiles]>;
138
184
  onPointerDownEmitter: Emitter<[activeTool: {
139
185
  lastActiveTool: import("../types").ActiveTool | null;
@@ -171,8 +217,12 @@ declare class App extends React.Component<AppProps, AppState> {
171
217
  element: NonDeleted<ExcalidrawElement> | null;
172
218
  allHitElements: NonDeleted<ExcalidrawElement>[];
173
219
  wasAddedToSelection: boolean;
220
+ cycleTarget: NonDeleted<ExcalidrawElement> | null;
174
221
  hasBeenDuplicated: boolean;
222
+ advancedListMarkers: readonly import("@excalidraw/element").ListMarkerAdvance[];
223
+ editedTextId: import("@excalidraw/element/types").ExcalidrawTextElement["id"] | null;
175
224
  hasHitCommonBoundingBoxOfSelectedElements: boolean;
225
+ arrowLabel: boolean;
176
226
  };
177
227
  withCmdOrCtrl: boolean;
178
228
  drag: {
@@ -185,6 +235,10 @@ declare class App extends React.Component<AppProps, AppState> {
185
235
  x: number;
186
236
  y: number;
187
237
  };
238
+ lastOffset: {
239
+ x: number;
240
+ y: number;
241
+ };
188
242
  blockDragging: boolean;
189
243
  };
190
244
  eventListeners: {
@@ -233,8 +287,12 @@ declare class App extends React.Component<AppProps, AppState> {
233
287
  element: NonDeleted<ExcalidrawElement> | null;
234
288
  allHitElements: NonDeleted<ExcalidrawElement>[];
235
289
  wasAddedToSelection: boolean;
290
+ cycleTarget: NonDeleted<ExcalidrawElement> | null;
236
291
  hasBeenDuplicated: boolean;
292
+ advancedListMarkers: readonly import("@excalidraw/element").ListMarkerAdvance[];
293
+ editedTextId: import("@excalidraw/element/types").ExcalidrawTextElement["id"] | null;
237
294
  hasHitCommonBoundingBoxOfSelectedElements: boolean;
295
+ arrowLabel: boolean;
238
296
  };
239
297
  withCmdOrCtrl: boolean;
240
298
  drag: {
@@ -247,6 +305,10 @@ declare class App extends React.Component<AppProps, AppState> {
247
305
  x: number;
248
306
  y: number;
249
307
  };
308
+ lastOffset: {
309
+ x: number;
310
+ y: number;
311
+ };
250
312
  blockDragging: boolean;
251
313
  };
252
314
  eventListeners: {
@@ -265,9 +327,85 @@ declare class App extends React.Component<AppProps, AppState> {
265
327
  }>]>;
266
328
  missingPointerEventCleanupEmitter: Emitter<[event: PointerEvent | null]>;
267
329
  onRemoveEventListenersEmitter: Emitter<[]>;
330
+ modifiers: AppModifiers;
268
331
  api: ExcalidrawImperativeAPI;
332
+ private elementRenderOverrides;
333
+ /** offsets of `elementRenderOverrides`; keeps its identity while they don't change */
334
+ private elementRenderOffsets;
335
+ private renderOverridesUpdatePending;
336
+ private getRenderOverrideConfig;
337
+ private getElementRenderState;
269
338
  private createExcalidrawAPI;
270
339
  constructor(props: AppProps);
340
+ /**
341
+ * Whether the editor accepts user input (pointer, keyboard, wheel, touch,
342
+ * clipboard, drag&drop). When `false`, the editor is fully inert for the
343
+ * user, but remains controllable through the imperative API.
344
+ *
345
+ * All user-input entry points must consult this getter (directly or by
346
+ * not being attached/rendered at all).
347
+ */
348
+ isInteractionEnabled(props?: Pick<AppProps, "interaction">): boolean;
349
+ /**
350
+ * Whether element links render their link icon and are clickable.
351
+ * True when fully interactive, or when `interaction: { enabled: { links:
352
+ * true } }`
353
+ * (in which case clicking anywhere on a linked element opens the link,
354
+ * same as in view mode).
355
+ */
356
+ isLinksEnabled(props?: Pick<AppProps, "interaction">): boolean;
357
+ /**
358
+ * Whether canvas navigation — panning & zooming, view-mode style — is
359
+ * enabled. True when fully interactive, or when `interaction: { enabled:
360
+ * { navigation: true } }`. Respects `appState.scrollConstraints`.
361
+ */
362
+ isNavigationEnabled(props?: Pick<AppProps, "interaction">): boolean;
363
+ /**
364
+ * Whether embeddable & iframe elements are interactive (hover & click to
365
+ * activate, view-mode style). True when fully interactive, or when
366
+ * allowed via `interaction.enabled.embeds` / `.interactiveContent`.
367
+ */
368
+ isEmbedsEnabled(props?: Pick<AppProps, "interaction">): boolean;
369
+ /**
370
+ * Whether the browser's own zoom (ctrl/cmd + wheel, pinch, keyboard
371
+ * shortcuts) stays available over the non-interactive editor.
372
+ * Prevented by default.
373
+ */
374
+ isBrowserZoomEnabled(props?: Pick<AppProps, "interaction">): boolean;
375
+ /**
376
+ * Whether the tool can be activated & driven by user input. False when
377
+ * disabled via `UIOptions.tools`, or when the editor is non-interactive
378
+ * and the tool isn't kept user-driven via `interaction.enabled.tools`.
379
+ *
380
+ * (Once UI tool availability is split from input availability — e.g.
381
+ * `props.ui.tools` vs `interaction.disabled.tools` — the UI axis moves
382
+ * out into its own predicate.)
383
+ *
384
+ * We purposely widen the `tool` type so this helper can be called with
385
+ * any tool without having to type check it.
386
+ */
387
+ isToolSupported: <T extends ToolType | "custom">(tool: T, props?: Pick<AppProps, "interaction" | "UIOptions">) => boolean;
388
+ /**
389
+ * Whether the active tool is locked in place — via the tool lock
390
+ * (padlock / Q) or by being host-forced (`props.activeTool`). A locked
391
+ * tool doesn't revert to the selection tool after use, and elements drawn
392
+ * with it aren't selected. Forcing deliberately does not mutate
393
+ * `activeTool.locked`, which is the user's persisted padlock preference.
394
+ */
395
+ isToolLocked(): boolean;
396
+ /**
397
+ * Whether the active tool captures the primary pointer instead of the
398
+ * view-mode drag-to-pan — the laser and host-implemented custom tools do;
399
+ * while non-interactive, any tool allowed via
400
+ * `interaction.enabled.tools` does. (Editing tools capture the pointer
401
+ * trivially since view mode implies they're not active; this predicate only
402
+ * matters where view-mode gates apply.)
403
+ */
404
+ isActiveToolPointerCapturing(): boolean;
405
+ /** Whether Excalidraw's full default UI is rendered. */
406
+ isDefaultUIEnabled(props?: Pick<AppProps, "ui">): boolean;
407
+ /** Whether an individual default UI control is rendered. */
408
+ isUIControlEnabled(control: keyof UIConfig["enabled"], props?: Pick<AppProps, "ui">): boolean;
271
409
  updateEditorAtom: <Value, Args extends unknown[], Result>(atom: WritableAtom<Value, Args, Result>, ...args: Args) => Result;
272
410
  private onWindowMessage;
273
411
  private handleSkipBindMode;
@@ -280,8 +418,12 @@ declare class App extends React.Component<AppProps, AppState> {
280
418
  * If disabled, returns null.
281
419
  */
282
420
  getEffectiveGridSize: () => NullableGridSize;
283
- private getTextCreationGridPoint;
284
421
  private getHTMLIFrameElement;
422
+ /**
423
+ * AI-generated iframe elements aren't interactive while their generation
424
+ * is still in progress (the partial content is render-only).
425
+ */
426
+ private isIframeLikeInteractive;
285
427
  private handleIframeLikeElementHover;
286
428
  /** @returns true if iframe-like element click handled */
287
429
  private handleIframeLikeCenterClick;
@@ -302,7 +444,7 @@ declare class App extends React.Component<AppProps, AppState> {
302
444
  getSceneElements: () => readonly Ordered<NonDeletedExcalidrawElement>[];
303
445
  onInsertElements: (elements: readonly ExcalidrawElement[]) => void;
304
446
  onExportImage: (type: keyof typeof EXPORT_IMAGE_TYPES, elements: ExportedElements, opts: {
305
- exportingFrame: ExcalidrawFrameLikeElement | null;
447
+ exportingFrame: NonDeleted<ExcalidrawFrameLikeElement> | null;
306
448
  }) => Promise<void>;
307
449
  private magicGenerations;
308
450
  private updateMagicGeneration;
@@ -318,9 +460,35 @@ declare class App extends React.Component<AppProps, AppState> {
318
460
  private openEyeDropper;
319
461
  dismissLinearEditor: () => void;
320
462
  syncActionResult: (actionResult: ActionResult) => void;
463
+ scheduleCapture: () => void;
321
464
  private onBlur;
322
465
  private onUnload;
323
466
  private disableEvent;
467
+ private isFileDropEnabled;
468
+ private onDragOver;
469
+ private handleNavigationModeKeyDown;
470
+ /**
471
+ * PageUp/PageDown scroll the canvas by a page — vertically, or
472
+ * horizontally with shift. Respects `appState.scrollConstraints`
473
+ * (via `viewport.translate`).
474
+ */
475
+ private maybeHandlePageScrollKeyDown;
476
+ private preventBrowserZoomKeyDown;
477
+ /** Ends active input sessions before switching to a view-mode/non-interactive
478
+ * mode. */
479
+ private terminateActiveInteraction;
480
+ private handleInteractionStateChange;
481
+ /** whether the two values reference the same tool (incl. custom subtype) */
482
+ private isSameForcedTool;
483
+ /**
484
+ * Keeps `state.activeTool` synced to the host-controlled
485
+ * `props.activeTool`. `setActiveTool` refuses non-matching activations
486
+ * while forced (user input, API); this backstop covers the writers that
487
+ * bypass the funnel (`actionFinalize`/`actionDeselect`, `restore()` on
488
+ * scene load, ...) and re-applies the tool once it becomes activatable
489
+ * (e.g. `interaction` config changes).
490
+ */
491
+ private handleForcedToolChange;
324
492
  private resetHistory;
325
493
  private resetStore;
326
494
  /**
@@ -342,16 +510,20 @@ declare class App extends React.Component<AppProps, AppState> {
342
510
  private onFullscreenChange;
343
511
  private removeEventListeners;
344
512
  private addEventListeners;
513
+ getSnapshotBeforeUpdate(prevProps: AppProps, prevState: AppState): null;
514
+ /**
515
+ * Flags the container while toggling zen mode so that UI chrome
516
+ * (backgrounds etc.) animates only then, and hover transitions stay
517
+ * instant. A data attribute so that React doesn't reset it on re-render.
518
+ */
519
+ private markZenModeTransition;
520
+ private unmarkZenModeTransition;
345
521
  componentDidUpdate(prevProps: AppProps, prevState: AppState): void;
346
522
  private renderInteractiveSceneCallback;
347
523
  private onScroll;
348
- private onCut;
349
- private onCopy;
350
524
  private static resetTapTwice;
351
525
  private onTouchStart;
352
526
  private onTouchEnd;
353
- private insertClipboardContent;
354
- pasteFromClipboard: (event: ClipboardEvent) => Promise<void>;
355
527
  addElementsFromPasteOrLibrary: (opts: {
356
528
  elements: readonly ExcalidrawElement[];
357
529
  files: BinaryFiles | null;
@@ -360,57 +532,25 @@ declare class App extends React.Component<AppProps, AppState> {
360
532
  clientY: number;
361
533
  } | "cursor" | "center";
362
534
  retainSeed?: boolean;
363
- fitToContent?: boolean;
535
+ fit?: SetViewportOptions["fit"];
536
+ preserveFrameChildrenOrder?: boolean;
364
537
  }) => void;
365
- private addElementsFromMixedContentPaste;
366
- private addTextFromPaste;
367
538
  setAppState: React.Component<any, AppState>["setState"];
368
539
  removePointer: (event: React.PointerEvent<HTMLElement> | PointerEvent) => void;
369
540
  toggleLock: (source?: "keyboard" | "ui") => void;
370
541
  updateFrameRendering: (opts: Partial<AppState["frameRendering"]> | ((prevState: AppState["frameRendering"]) => Partial<AppState["frameRendering"]>)) => void;
371
542
  togglePenMode: (force: boolean | null) => void;
372
- onHandToolToggle: () => void;
373
- /**
374
- * Zooms on canvas viewport center
375
- */
376
- zoomCanvas: (
377
- /**
378
- * Decimal fraction, auto-clamped between MIN_ZOOM and MAX_ZOOM.
379
- * 1 = 100% zoom, 2 = 200% zoom, 0.5 = 50% zoom
380
- */
381
- value: number) => void;
382
- private cancelInProgressAnimation;
383
- scrollToContent: (
384
- /**
385
- * target to scroll to
386
- *
387
- * - string - id of element or group, or url containing elementLink
388
- * - ExcalidrawElement | ExcalidrawElement[] - element(s) objects
389
- */
390
- target?: string | ExcalidrawElement | readonly ExcalidrawElement[], opts?: ({
391
- fitToContent?: boolean;
392
- fitToViewport?: never;
393
- viewportZoomFactor?: number;
394
- animate?: boolean;
395
- duration?: number;
396
- } | {
397
- fitToContent?: never;
398
- fitToViewport?: boolean;
399
- /** when fitToViewport=true, how much screen should the content cover,
400
- * between 0.1 (10%) and 1 (100%)
401
- */
402
- viewportZoomFactor?: number;
403
- animate?: boolean;
404
- duration?: number;
405
- }) & {
406
- minZoom?: number;
407
- maxZoom?: number;
408
- canvasOffsets?: Offsets;
409
- }) => void;
410
- private maybeUnfollowRemoteUser;
411
- /** use when changing scrollX/scrollY/zoom based on user interaction */
412
- private translateCanvas;
543
+ revealIfHidden: (elements: NonDeletedExcalidrawElement[]) => void;
544
+ /** emits a follow/unfollow intent to the host (which owns the
545
+ * `userToFollow` state) via both the `onUserFollow` prop and the
546
+ * imperative API emitter */
547
+ emitUserFollowIntent: (payload: OnUserFollowedPayload) => void;
548
+ /** emits an UNFOLLOW intent if currently following someone — use on
549
+ * viewport changes that take the view over from the followed user (user
550
+ * pans and zooms, `setViewport` navigation) */
551
+ requestUnfollow: () => void;
413
552
  setToast: (toast: AppState["toast"]) => void;
553
+ private showSceneReplacedToast;
414
554
  restoreFileFromShare: () => Promise<void>;
415
555
  /**
416
556
  * adds supplied files to existing files in the appState.
@@ -435,9 +575,15 @@ declare class App extends React.Component<AppProps, AppState> {
435
575
  */
436
576
  captureUpdate?: SceneData["captureUpdate"];
437
577
  }) => void;
578
+ /**
579
+ * see {@link ExcalidrawImperativeAPI.setElementRenderOverrides} for details
580
+ */
581
+ setElementRenderOverrides: (overrides: ElementRenderOverrides | null) => void;
438
582
  applyDeltas: (deltas: StoreDelta[], options?: ApplyToOptions) => [SceneElementsMap, AppState, boolean];
439
583
  mutateElement: <TElement extends Mutable<ExcalidrawElement>>(element: TElement, updates: ElementUpdate<TElement>, informMutation?: boolean) => TElement;
440
- private triggerRender;
584
+ triggerRender: (
585
+ /** force always re-renders canvas even if no change */
586
+ force?: boolean) => void;
441
587
  /**
442
588
  * @returns whether the menu was toggled on or off
443
589
  */
@@ -447,10 +593,8 @@ declare class App extends React.Component<AppProps, AppState> {
447
593
  force?: boolean;
448
594
  }) => boolean;
449
595
  private updateCurrentCursorPosition;
450
- getEditorUIOffsets: () => Offsets;
451
596
  private onKeyDown;
452
597
  private onKeyUp;
453
- private isToolSupported;
454
598
  setActiveTool: (tool: ({
455
599
  type: ToolType;
456
600
  } | {
@@ -459,10 +603,18 @@ declare class App extends React.Component<AppProps, AppState> {
459
603
  }) & {
460
604
  locked?: boolean;
461
605
  fromSelection?: boolean;
462
- }, keepSelection?: boolean) => void;
606
+ }, opts?: {
607
+ keepSelection?: boolean;
608
+ /**
609
+ * When `true`, re-activating an already-active toggle tool (see
610
+ * `TOGGLE_TOOLS`) switches back to the previously active tool.
611
+ * Activation is idempotent by default; toggle tools always record the
612
+ * previously active tool regardless (so ESC and the next `toggle`
613
+ * activation can switch back to it).
614
+ */
615
+ toggle?: boolean;
616
+ }) => void;
463
617
  setOpenDialog: (dialogType: AppState["openDialog"]) => void;
464
- private setCursor;
465
- private resetCursor;
466
618
  /**
467
619
  * returns whether user is making a gesture with >= 2 fingers (points)
468
620
  * on o touch screen (not on a trackpad). Currently only relates to Darwin
@@ -474,32 +626,93 @@ declare class App extends React.Component<AppProps, AppState> {
474
626
  private onGestureStart;
475
627
  private onGestureChange;
476
628
  private onGestureEnd;
477
- private handleTextWysiwyg;
478
- private deselectElements;
479
- private getSelectedTextElement;
480
- private getSelectedTextEditingContainerAtPosition;
481
- private getTextElementAtPosition;
482
- private isHittingTextAutoResizeHandle;
483
- private handleTextAutoResizeHandlePointerDown;
484
- private getElementAtPosition;
485
- private getElementsAtPosition;
629
+ getElementAtPosition(x: number, y: number, opts?: ({
630
+ includeBoundTextElement?: boolean;
631
+ includeLockedElements?: boolean;
632
+ } | {
633
+ allHitElements: NonDeleted<ExcalidrawElement>[];
634
+ }) & {
635
+ preferSelected?: boolean;
636
+ }): NonDeleted<ExcalidrawElement> | null;
637
+ getElementsAtPosition(x: number, y: number, opts?: {
638
+ includeBoundTextElement?: boolean;
639
+ includeLockedElements?: boolean;
640
+ }): NonDeleted<ExcalidrawElement>[];
641
+ /**
642
+ * Whether the element's frame clips it away at the position — hitting a
643
+ * frame's element from outside the frame is not considered a hit.
644
+ */
645
+ isClippedByFrameAt(x: number, y: number, element: ExcalidrawElement): boolean;
486
646
  getElementHitThreshold(element: ExcalidrawElement): number;
487
- private hitElement;
488
- private getTextBindableContainerAtPosition;
489
- private startTextEditing;
647
+ hitElement(x: number, y: number, element: NonDeletedExcalidrawElement, considerBoundingBox?: boolean): boolean;
490
648
  private startImageCropping;
491
- private finishImageCropping;
649
+ finishImageCropping: () => void;
492
650
  private shouldHandleBrowserCanvasDoubleClick;
493
651
  private handleCanvasDoubleClick;
494
652
  private handleCanvasClick;
495
- private getElementLinkAtPosition;
653
+ getElementLinkAtPosition: (scenePointer: Readonly<{
654
+ x: number;
655
+ y: number;
656
+ }>, hitElementMightBeLocked: NonDeletedExcalidrawElement | null) => NonDeletedExcalidrawElement | undefined;
496
657
  private handleElementLinkClick;
497
- private getTopLayerFrameAtSceneCoords;
658
+ /**
659
+ * Applies (or clears) the element-link hover affordances — pointer cursor
660
+ * and tooltip — based on the current `hitLinkElement`. Returns whether a
661
+ * link is being hovered.
662
+ */
663
+ private applyElementLinkHoverAffordance;
664
+ /**
665
+ * On touchscreens (where no hover precedes the tap) re-derives
666
+ * `hitLinkElement`, then opens the hit element link, if any.
667
+ * Returns whether a link click was handled.
668
+ */
669
+ private maybeHandleElementLinkClick;
670
+ /**
671
+ * Restricted pointer handling for the non-interactive editor with links
672
+ * and/or embeds allowed (`interaction.enabled.links` / `.embeds` /
673
+ * `.interactiveContent`) — runs only the element-link & embed concerns
674
+ * (shared with the full pointer handlers above) so they behave like in
675
+ * view mode without the rest of the canvas pointer machinery.
676
+ */
677
+ private handleInteractiveContentPointerMove;
678
+ private handleInteractiveContentPointerUp;
679
+ /**
680
+ * finds candidate frame under cursor (when dragging frame children/elements
681
+ * inside frames)
682
+ */
683
+ getTopLayerFrameAtSceneCoords: (
684
+ /**
685
+ * should be already grid aligned (basically should be what the call site
686
+ * sets the element's coords to, if applicable)
687
+ */
688
+ sceneCoords: {
689
+ x: number;
690
+ y: number;
691
+ }, opts?: {
692
+ /** to exclude selected elements when dragging, etc. */
693
+ excludeElementIds?: AppState["selectedElementIds"];
694
+ currentFrameId?: ExcalidrawElement["frameId"];
695
+ }) => NonDeleted<ExcalidrawFrameLikeElement> | null;
696
+ updateFrameToHighlight: (frameToHighlight: AppState["frameToHighlight"]) => void;
697
+ private maybeUpdateFrameToHighlightOnPointerMove;
698
+ insertNewElements: (elements: readonly ExcalidrawElement[]) => void;
699
+ insertNewElement: (element: ExcalidrawElement) => void;
498
700
  private handleCanvasPointerMove;
499
701
  private handleEraser;
500
702
  private handleTouchMove;
703
+ /**
704
+ * Applies the hover affordances of a selected linear element: the cursor,
705
+ * plus the hovered-handle state that renders them highlighted.
706
+ */
501
707
  handleHoverSelectedLinearElement(linearElementEditor: LinearElementEditor, scenePointerX: number, scenePointerY: number): void;
502
708
  private handleCanvasPointerDown;
709
+ /**
710
+ * The browser took the pointer over (scroll, pinch, palm rejection): no
711
+ * pointerup will follow, so the gesture is torn down here and now — the
712
+ * same cleanup a lost pointerup gets at the next press, only not left
713
+ * lying in wait for it, where its replay would tangle with that press.
714
+ */
715
+ private handleCanvasPointerCancel;
503
716
  private handleCanvasPointerUp;
504
717
  private maybeOpenContextMenuAfterPointerDownOnTouchDevices;
505
718
  private resetContextMenuTimer;
@@ -509,18 +722,14 @@ declare class App extends React.Component<AppProps, AppState> {
509
722
  * pointerup handlers manually
510
723
  */
511
724
  private maybeCleanupAfterMissingPointerUp;
512
- handleCanvasPanUsingWheelOrSpaceDrag: (event: React.PointerEvent<HTMLElement> | MouseEvent) => boolean;
513
725
  private updateGestureOnPointerDown;
514
- private initialPointerDownState;
515
- private handleDraggingScrollBar;
516
- private clearSelectionIfNotUsingSelection;
517
726
  /**
518
- * @returns whether the pointer event has been completely handled
727
+ * Tracks the pointer within the ongoing multi-touch gesture and applies
728
+ * the two-finger pinch zoom/pan, if any.
519
729
  */
520
- private handleSelectionOnPointerDown;
521
- private isASelectedElement;
522
- private isHittingCommonBoundingBoxOfSelectedElements;
523
- private handleTextOnPointerDown;
730
+ private updateMultiTouchGesture;
731
+ private initialPointerDownState;
732
+ private handleDraggingScrollBar;
524
733
  private handleFreeDrawElementOnPointerDown;
525
734
  insertIframeElement: ({ sceneX, sceneY, width, height, }: {
526
735
  sceneX: number;
@@ -535,11 +744,14 @@ declare class App extends React.Component<AppProps, AppState> {
535
744
  }) => NonDeleted<ExcalidrawEmbeddableElement> | undefined;
536
745
  private newImagePlaceholder;
537
746
  private handleLinearElementOnPointerDown;
538
- private getCurrentItemRoundness;
747
+ getCurrentItemRoundness(elementType: "selection" | "rectangle" | "stickynote" | "diamond" | "ellipse" | "iframe" | "embeddable"): {
748
+ type: 2 | 3;
749
+ } | null;
750
+ getCurrentItemStrokeWidth(elementType: ExcalidrawElement["type"]): number;
539
751
  private createGenericElementOnPointerDown;
540
752
  private createFrameElementOnPointerDown;
541
- private maybeCacheReferenceSnapPoints;
542
- private maybeCacheVisibleGaps;
753
+ maybeCacheReferenceSnapPoints(event: KeyboardModifiersObject, selectedElements: readonly NonDeletedExcalidrawElement[], recomputeAnyways?: boolean): void;
754
+ maybeCacheVisibleGaps(event: KeyboardModifiersObject, selectedElements: readonly NonDeletedExcalidrawElement[], recomputeAnyways?: boolean): void;
543
755
  private onKeyDownFromPointerDownHandler;
544
756
  private onKeyUpFromPointerDownHandler;
545
757
  private onPointerMoveFromPointerDownHandler;
@@ -564,20 +776,30 @@ declare class App extends React.Component<AppProps, AppState> {
564
776
  /** generally you should use `addNewImagesToImageCache()` directly if you need
565
777
  * to render new images. This is just a failsafe */
566
778
  private scheduleImageRefresh;
567
- private clearSelection;
568
779
  private handleInteractiveCanvasRef;
569
- private insertImages;
780
+ insertImages: (imageFiles: File[], sceneX: number, sceneY: number) => Promise<void>;
570
781
  private handleAppOnDrop;
571
- loadFileToCanvas: (file: File, fileHandle: FileSystemFileHandle | null) => Promise<void>;
782
+ /** @returns true if the file replaced the scene */
783
+ loadFileToCanvas: (file: File, fileHandle: FileSystemFileHandle | null, insertPosition?: {
784
+ clientX: number;
785
+ clientY: number;
786
+ }) => Promise<true | undefined>;
572
787
  private handleCanvasContextMenu;
573
- private maybeDragNewGenericElement;
574
- private maybeHandleCrop;
575
- private maybeHandleResize;
788
+ /** opens the context menu for the element under the pointer, or the canvas */
789
+ openContextMenu: (pointer: {
790
+ clientX: number;
791
+ clientY: number;
792
+ button?: number;
793
+ pointerType?: string;
794
+ }) => void;
795
+ maybeDragNewGenericElement: (pointerDownState: PointerDownState, event: MouseEvent | KeyboardEvent, informMutation?: boolean) => void;
576
796
  private getContextMenuItems;
577
- private handleWheel;
578
- private getTextWysiwygSnappedToCenterPosition;
579
- private savePointer;
580
- private resetShouldCacheIgnoreZoomDebounced;
797
+ savePointer: (x: number, y: number, button: "up" | "down") => void;
798
+ resetShouldCacheIgnoreZoomDebounced: {
799
+ (): void;
800
+ flush(): void;
801
+ cancel(): void;
802
+ };
581
803
  private updateDOMRect;
582
804
  refresh: () => void;
583
805
  private getCanvasOffsets;