tldraw 4.2.2 → 4.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (621) hide show
  1. package/dist-cjs/index.d.ts +242 -311
  2. package/dist-cjs/index.js +5 -13
  3. package/dist-cjs/index.js.map +2 -2
  4. package/dist-cjs/lib/bindings/arrow/ArrowBindingUtil.js.map +2 -2
  5. package/dist-cjs/lib/canvas/TldrawSelectionForeground.js +4 -7
  6. package/dist-cjs/lib/canvas/TldrawSelectionForeground.js.map +2 -2
  7. package/dist-cjs/lib/defaultEmbedDefinitions.js.map +2 -2
  8. package/dist-cjs/lib/defaultExternalContentHandlers.js +5 -5
  9. package/dist-cjs/lib/defaultExternalContentHandlers.js.map +2 -2
  10. package/dist-cjs/lib/defaultSideEffects.js +1 -6
  11. package/dist-cjs/lib/defaultSideEffects.js.map +2 -2
  12. package/dist-cjs/lib/shapes/arrow/ArrowShapeUtil.js +13 -14
  13. package/dist-cjs/lib/shapes/arrow/ArrowShapeUtil.js.map +2 -2
  14. package/dist-cjs/lib/shapes/arrow/arrow-types.js.map +1 -1
  15. package/dist-cjs/lib/shapes/arrow/arrowLabel.js +1 -1
  16. package/dist-cjs/lib/shapes/arrow/arrowLabel.js.map +2 -2
  17. package/dist-cjs/lib/shapes/arrow/arrowTargetState.js +1 -1
  18. package/dist-cjs/lib/shapes/arrow/arrowTargetState.js.map +2 -2
  19. package/dist-cjs/lib/shapes/arrow/elbow/elbowArrowSnapLines.js.map +2 -2
  20. package/dist-cjs/lib/shapes/arrow/shared.js.map +2 -2
  21. package/dist-cjs/lib/shapes/arrow/toolStates/Idle.js +10 -4
  22. package/dist-cjs/lib/shapes/arrow/toolStates/Idle.js.map +2 -2
  23. package/dist-cjs/lib/shapes/arrow/toolStates/Pointing.js +4 -7
  24. package/dist-cjs/lib/shapes/arrow/toolStates/Pointing.js.map +2 -2
  25. package/dist-cjs/lib/shapes/bookmark/BookmarkShapeUtil.js +1 -1
  26. package/dist-cjs/lib/shapes/bookmark/BookmarkShapeUtil.js.map +2 -2
  27. package/dist-cjs/lib/shapes/bookmark/bookmarks.js.map +2 -2
  28. package/dist-cjs/lib/shapes/draw/DrawShapeUtil.js +22 -24
  29. package/dist-cjs/lib/shapes/draw/DrawShapeUtil.js.map +2 -2
  30. package/dist-cjs/lib/shapes/draw/getPath.js +11 -20
  31. package/dist-cjs/lib/shapes/draw/getPath.js.map +2 -2
  32. package/dist-cjs/lib/shapes/draw/toolStates/Drawing.js +86 -82
  33. package/dist-cjs/lib/shapes/draw/toolStates/Drawing.js.map +3 -3
  34. package/dist-cjs/lib/shapes/embed/EmbedShapeUtil.js +0 -6
  35. package/dist-cjs/lib/shapes/embed/EmbedShapeUtil.js.map +2 -2
  36. package/dist-cjs/lib/shapes/frame/FrameShapeTool.js.map +1 -1
  37. package/dist-cjs/lib/shapes/frame/FrameShapeUtil.js +5 -6
  38. package/dist-cjs/lib/shapes/frame/FrameShapeUtil.js.map +2 -2
  39. package/dist-cjs/lib/shapes/geo/GeoShapeUtil.js +142 -146
  40. package/dist-cjs/lib/shapes/geo/GeoShapeUtil.js.map +2 -2
  41. package/dist-cjs/lib/shapes/geo/toolStates/Idle.js +10 -5
  42. package/dist-cjs/lib/shapes/geo/toolStates/Idle.js.map +2 -2
  43. package/dist-cjs/lib/shapes/geo/toolStates/Pointing.js +3 -3
  44. package/dist-cjs/lib/shapes/geo/toolStates/Pointing.js.map +2 -2
  45. package/dist-cjs/lib/shapes/highlight/HighlightShapeUtil.js +21 -23
  46. package/dist-cjs/lib/shapes/highlight/HighlightShapeUtil.js.map +2 -2
  47. package/dist-cjs/lib/shapes/line/toolStates/Pointing.js +3 -3
  48. package/dist-cjs/lib/shapes/line/toolStates/Pointing.js.map +2 -2
  49. package/dist-cjs/lib/shapes/note/NoteShapeUtil.js +11 -6
  50. package/dist-cjs/lib/shapes/note/NoteShapeUtil.js.map +2 -2
  51. package/dist-cjs/lib/shapes/note/noteHelpers.js.map +2 -2
  52. package/dist-cjs/lib/shapes/note/toolStates/Pointing.js +10 -5
  53. package/dist-cjs/lib/shapes/note/toolStates/Pointing.js.map +2 -2
  54. package/dist-cjs/lib/shapes/shared/HyperlinkButton.js +2 -3
  55. package/dist-cjs/lib/shapes/shared/HyperlinkButton.js.map +2 -2
  56. package/dist-cjs/lib/shapes/shared/PlainTextLabel.js +2 -14
  57. package/dist-cjs/lib/shapes/shared/PlainTextLabel.js.map +3 -3
  58. package/dist-cjs/lib/shapes/shared/RichTextLabel.js +4 -12
  59. package/dist-cjs/lib/shapes/shared/RichTextLabel.js.map +3 -3
  60. package/dist-cjs/lib/shapes/shared/ShapeFill.js +2 -2
  61. package/dist-cjs/lib/shapes/shared/ShapeFill.js.map +2 -2
  62. package/dist-cjs/lib/shapes/shared/crop.js +0 -1
  63. package/dist-cjs/lib/shapes/shared/crop.js.map +2 -2
  64. package/dist-cjs/lib/shapes/shared/interpolate-props.js +3 -3
  65. package/dist-cjs/lib/shapes/shared/interpolate-props.js.map +2 -2
  66. package/dist-cjs/lib/shapes/shared/useEditablePlainText.js.map +2 -2
  67. package/dist-cjs/lib/shapes/shared/useEditableRichText.js.map +2 -2
  68. package/dist-cjs/lib/shapes/shared/{useEfficientZoomThreshold.js → useForceSolid.js} +7 -10
  69. package/dist-cjs/lib/shapes/shared/useForceSolid.js.map +7 -0
  70. package/dist-cjs/lib/shapes/shared/useImageOrVideoAsset.js +1 -1
  71. package/dist-cjs/lib/shapes/shared/useImageOrVideoAsset.js.map +2 -2
  72. package/dist-cjs/lib/shapes/text/RichTextArea.js +0 -5
  73. package/dist-cjs/lib/shapes/text/RichTextArea.js.map +2 -2
  74. package/dist-cjs/lib/shapes/text/TextShapeUtil.js +2 -5
  75. package/dist-cjs/lib/shapes/text/TextShapeUtil.js.map +2 -2
  76. package/dist-cjs/lib/shapes/text/toolStates/Idle.js +10 -4
  77. package/dist-cjs/lib/shapes/text/toolStates/Idle.js.map +2 -2
  78. package/dist-cjs/lib/shapes/text/toolStates/Pointing.js +5 -7
  79. package/dist-cjs/lib/shapes/text/toolStates/Pointing.js.map +2 -2
  80. package/dist-cjs/lib/shapes/video/VideoShapeUtil.js +1 -1
  81. package/dist-cjs/lib/shapes/video/VideoShapeUtil.js.map +2 -2
  82. package/dist-cjs/lib/tools/EraserTool/childStates/Erasing.js +5 -4
  83. package/dist-cjs/lib/tools/EraserTool/childStates/Erasing.js.map +2 -2
  84. package/dist-cjs/lib/tools/EraserTool/childStates/Pointing.js +4 -2
  85. package/dist-cjs/lib/tools/EraserTool/childStates/Pointing.js.map +2 -2
  86. package/dist-cjs/lib/tools/HandTool/HandTool.js +5 -3
  87. package/dist-cjs/lib/tools/HandTool/HandTool.js.map +2 -2
  88. package/dist-cjs/lib/tools/HandTool/childStates/Dragging.js +2 -3
  89. package/dist-cjs/lib/tools/HandTool/childStates/Dragging.js.map +2 -2
  90. package/dist-cjs/lib/tools/HandTool/childStates/Pointing.js +1 -1
  91. package/dist-cjs/lib/tools/HandTool/childStates/Pointing.js.map +2 -2
  92. package/dist-cjs/lib/tools/LaserTool/childStates/Lasering.js +1 -1
  93. package/dist-cjs/lib/tools/LaserTool/childStates/Lasering.js.map +2 -2
  94. package/dist-cjs/lib/tools/SelectTool/DragAndDropManager.js +11 -10
  95. package/dist-cjs/lib/tools/SelectTool/DragAndDropManager.js.map +2 -2
  96. package/dist-cjs/lib/tools/SelectTool/childStates/Brushing.js +5 -6
  97. package/dist-cjs/lib/tools/SelectTool/childStates/Brushing.js.map +2 -2
  98. package/dist-cjs/lib/tools/SelectTool/childStates/Crop/children/Cropping.js +6 -4
  99. package/dist-cjs/lib/tools/SelectTool/childStates/Crop/children/Cropping.js.map +2 -2
  100. package/dist-cjs/lib/tools/SelectTool/childStates/Crop/children/Idle.js +1 -1
  101. package/dist-cjs/lib/tools/SelectTool/childStates/Crop/children/Idle.js.map +2 -2
  102. package/dist-cjs/lib/tools/SelectTool/childStates/Crop/children/PointingCrop.js +1 -1
  103. package/dist-cjs/lib/tools/SelectTool/childStates/Crop/children/PointingCrop.js.map +2 -2
  104. package/dist-cjs/lib/tools/SelectTool/childStates/Crop/children/PointingCropHandle.js +1 -1
  105. package/dist-cjs/lib/tools/SelectTool/childStates/Crop/children/PointingCropHandle.js.map +2 -2
  106. package/dist-cjs/lib/tools/SelectTool/childStates/Crop/children/TranslatingCrop.js +1 -2
  107. package/dist-cjs/lib/tools/SelectTool/childStates/Crop/children/TranslatingCrop.js.map +2 -2
  108. package/dist-cjs/lib/tools/SelectTool/childStates/Crop/children/crop_helpers.js +1 -1
  109. package/dist-cjs/lib/tools/SelectTool/childStates/Crop/children/crop_helpers.js.map +2 -2
  110. package/dist-cjs/lib/tools/SelectTool/childStates/DraggingHandle.js +6 -8
  111. package/dist-cjs/lib/tools/SelectTool/childStates/DraggingHandle.js.map +2 -2
  112. package/dist-cjs/lib/tools/SelectTool/childStates/EditingShape.js +11 -38
  113. package/dist-cjs/lib/tools/SelectTool/childStates/EditingShape.js.map +2 -2
  114. package/dist-cjs/lib/tools/SelectTool/childStates/Idle.js +50 -42
  115. package/dist-cjs/lib/tools/SelectTool/childStates/Idle.js.map +2 -2
  116. package/dist-cjs/lib/tools/SelectTool/childStates/PointingArrowLabel.js +6 -6
  117. package/dist-cjs/lib/tools/SelectTool/childStates/PointingArrowLabel.js.map +2 -2
  118. package/dist-cjs/lib/tools/SelectTool/childStates/PointingCanvas.js +1 -1
  119. package/dist-cjs/lib/tools/SelectTool/childStates/PointingCanvas.js.map +2 -2
  120. package/dist-cjs/lib/tools/SelectTool/childStates/PointingHandle.js +14 -4
  121. package/dist-cjs/lib/tools/SelectTool/childStates/PointingHandle.js.map +2 -2
  122. package/dist-cjs/lib/tools/SelectTool/childStates/PointingResizeHandle.js +1 -1
  123. package/dist-cjs/lib/tools/SelectTool/childStates/PointingResizeHandle.js.map +2 -2
  124. package/dist-cjs/lib/tools/SelectTool/childStates/PointingRotateHandle.js +1 -1
  125. package/dist-cjs/lib/tools/SelectTool/childStates/PointingRotateHandle.js.map +2 -2
  126. package/dist-cjs/lib/tools/SelectTool/childStates/PointingSelection.js +2 -2
  127. package/dist-cjs/lib/tools/SelectTool/childStates/PointingSelection.js.map +2 -2
  128. package/dist-cjs/lib/tools/SelectTool/childStates/PointingShape.js +13 -4
  129. package/dist-cjs/lib/tools/SelectTool/childStates/PointingShape.js.map +2 -2
  130. package/dist-cjs/lib/tools/SelectTool/childStates/Resizing.js +6 -5
  131. package/dist-cjs/lib/tools/SelectTool/childStates/Resizing.js.map +2 -2
  132. package/dist-cjs/lib/tools/SelectTool/childStates/Rotating.js +3 -2
  133. package/dist-cjs/lib/tools/SelectTool/childStates/Rotating.js.map +2 -2
  134. package/dist-cjs/lib/tools/SelectTool/childStates/ScribbleBrushing.js +6 -7
  135. package/dist-cjs/lib/tools/SelectTool/childStates/ScribbleBrushing.js.map +2 -2
  136. package/dist-cjs/lib/tools/SelectTool/childStates/Translating.js +11 -13
  137. package/dist-cjs/lib/tools/SelectTool/childStates/Translating.js.map +2 -2
  138. package/dist-cjs/lib/tools/SelectTool/selectHelpers.js +4 -15
  139. package/dist-cjs/lib/tools/SelectTool/selectHelpers.js.map +2 -2
  140. package/dist-cjs/lib/tools/ZoomTool/ZoomTool.js +1 -1
  141. package/dist-cjs/lib/tools/ZoomTool/ZoomTool.js.map +2 -2
  142. package/dist-cjs/lib/tools/ZoomTool/childStates/Pointing.js +3 -3
  143. package/dist-cjs/lib/tools/ZoomTool/childStates/Pointing.js.map +2 -2
  144. package/dist-cjs/lib/tools/ZoomTool/childStates/ZoomBrushing.js +6 -5
  145. package/dist-cjs/lib/tools/ZoomTool/childStates/ZoomBrushing.js.map +2 -2
  146. package/dist-cjs/lib/tools/selection-logic/getHitShapeOnCanvasPointerDown.js +3 -1
  147. package/dist-cjs/lib/tools/selection-logic/getHitShapeOnCanvasPointerDown.js.map +2 -2
  148. package/dist-cjs/lib/{utils/test-helpers.js → tools/selection-logic/getShouldEnterCropModeOnPointerDown.js} +8 -21
  149. package/dist-cjs/lib/tools/selection-logic/getShouldEnterCropModeOnPointerDown.js.map +7 -0
  150. package/dist-cjs/lib/tools/selection-logic/selectOnCanvasPointerUp.js +1 -1
  151. package/dist-cjs/lib/tools/selection-logic/selectOnCanvasPointerUp.js.map +2 -2
  152. package/dist-cjs/lib/tools/selection-logic/updateHoveredShapeId.js +1 -1
  153. package/dist-cjs/lib/tools/selection-logic/updateHoveredShapeId.js.map +2 -2
  154. package/dist-cjs/lib/ui/TldrawUi.js +2 -2
  155. package/dist-cjs/lib/ui/TldrawUi.js.map +2 -2
  156. package/dist-cjs/lib/ui/components/ActionsMenu/DefaultActionsMenuContent.js +9 -3
  157. package/dist-cjs/lib/ui/components/ActionsMenu/DefaultActionsMenuContent.js.map +2 -2
  158. package/dist-cjs/lib/ui/components/ContextMenu/DefaultContextMenu.js +3 -1
  159. package/dist-cjs/lib/ui/components/ContextMenu/DefaultContextMenu.js.map +2 -2
  160. package/dist-cjs/lib/ui/components/CursorChatBubble.js +1 -1
  161. package/dist-cjs/lib/ui/components/CursorChatBubble.js.map +2 -2
  162. package/dist-cjs/lib/ui/components/DefaultDebugPanel.js +21 -1
  163. package/dist-cjs/lib/ui/components/DefaultDebugPanel.js.map +2 -2
  164. package/dist-cjs/lib/ui/components/EditLinkDialog.js +1 -11
  165. package/dist-cjs/lib/ui/components/EditLinkDialog.js.map +2 -2
  166. package/dist-cjs/lib/ui/components/HelperButtons/StopFollowing.js.map +2 -2
  167. package/dist-cjs/lib/ui/components/Minimap/DefaultMinimap.js +1 -1
  168. package/dist-cjs/lib/ui/components/Minimap/DefaultMinimap.js.map +2 -2
  169. package/dist-cjs/lib/ui/components/OfflineIndicator/OfflineIndicator.js +15 -2
  170. package/dist-cjs/lib/ui/components/OfflineIndicator/OfflineIndicator.js.map +3 -3
  171. package/dist-cjs/lib/ui/components/PageMenu/PageItemInput.js +1 -3
  172. package/dist-cjs/lib/ui/components/PageMenu/PageItemInput.js.map +2 -2
  173. package/dist-cjs/lib/ui/components/SharePanel/PeopleMenu.js +0 -6
  174. package/dist-cjs/lib/ui/components/SharePanel/PeopleMenu.js.map +2 -2
  175. package/dist-cjs/lib/ui/components/Toolbar/AltTextEditor.js.map +2 -2
  176. package/dist-cjs/lib/ui/components/Toolbar/DefaultImageToolbar.js +1 -1
  177. package/dist-cjs/lib/ui/components/Toolbar/DefaultImageToolbar.js.map +2 -2
  178. package/dist-cjs/lib/ui/components/Toolbar/DefaultRichTextToolbar.js +1 -1
  179. package/dist-cjs/lib/ui/components/Toolbar/DefaultRichTextToolbar.js.map +2 -2
  180. package/dist-cjs/lib/ui/components/TopPanel/CenteredTopPanelContainer.js.map +1 -1
  181. package/dist-cjs/lib/ui/components/TopPanel/DefaultTopPanel.js +32 -0
  182. package/dist-cjs/lib/ui/components/TopPanel/DefaultTopPanel.js.map +7 -0
  183. package/dist-cjs/lib/ui/components/menu-items.js +1 -3
  184. package/dist-cjs/lib/ui/components/menu-items.js.map +2 -2
  185. package/dist-cjs/lib/ui/components/primitives/TldrawUiContextualToolbar.js +1 -3
  186. package/dist-cjs/lib/ui/components/primitives/TldrawUiContextualToolbar.js.map +2 -2
  187. package/dist-cjs/lib/ui/components/primitives/TldrawUiSlider.js +1 -1
  188. package/dist-cjs/lib/ui/components/primitives/TldrawUiSlider.js.map +2 -2
  189. package/dist-cjs/lib/ui/components/primitives/TldrawUiTooltip.js +93 -149
  190. package/dist-cjs/lib/ui/components/primitives/TldrawUiTooltip.js.map +2 -2
  191. package/dist-cjs/lib/ui/components/primitives/menus/TldrawUiMenuActionCheckboxItem.js.map +2 -2
  192. package/dist-cjs/lib/ui/components/primitives/menus/TldrawUiMenuActionItem.js.map +2 -2
  193. package/dist-cjs/lib/ui/components/primitives/menus/TldrawUiMenuItem.js +1 -1
  194. package/dist-cjs/lib/ui/components/primitives/menus/TldrawUiMenuItem.js.map +2 -2
  195. package/dist-cjs/lib/ui/context/actions.js +8 -7
  196. package/dist-cjs/lib/ui/context/actions.js.map +2 -2
  197. package/dist-cjs/lib/ui/context/components.js +2 -1
  198. package/dist-cjs/lib/ui/context/components.js.map +2 -2
  199. package/dist-cjs/lib/ui/hooks/menu-hooks.js.map +2 -2
  200. package/dist-cjs/lib/ui/hooks/useClipboardEvents.js +2 -2
  201. package/dist-cjs/lib/ui/hooks/useClipboardEvents.js.map +2 -2
  202. package/dist-cjs/lib/ui/hooks/useFlatten.js.map +2 -2
  203. package/dist-cjs/lib/ui/hooks/useKeyboardShortcuts.js +2 -2
  204. package/dist-cjs/lib/ui/hooks/useKeyboardShortcuts.js.map +2 -2
  205. package/dist-cjs/lib/ui/hooks/useTools.js +5 -4
  206. package/dist-cjs/lib/ui/hooks/useTools.js.map +2 -2
  207. package/dist-cjs/lib/ui/version.js +3 -3
  208. package/dist-cjs/lib/ui/version.js.map +1 -1
  209. package/dist-cjs/lib/utils/excalidraw/putExcalidrawContent.js +6 -16
  210. package/dist-cjs/lib/utils/excalidraw/putExcalidrawContent.js.map +2 -2
  211. package/dist-cjs/lib/utils/export/exportAs.js.map +2 -2
  212. package/dist-cjs/lib/utils/frames/frames.js.map +2 -2
  213. package/dist-cjs/lib/utils/text/richText.js +2 -4
  214. package/dist-cjs/lib/utils/text/richText.js.map +2 -2
  215. package/dist-cjs/lib/utils/text/textDirection.js +51 -0
  216. package/dist-cjs/lib/utils/text/textDirection.js.map +7 -0
  217. package/dist-cjs/lib/utils/tldr/buildFromV1Document.js +2 -7
  218. package/dist-cjs/lib/utils/tldr/buildFromV1Document.js.map +2 -2
  219. package/dist-esm/index.d.mts +242 -311
  220. package/dist-esm/index.mjs +5 -14
  221. package/dist-esm/index.mjs.map +2 -2
  222. package/dist-esm/lib/bindings/arrow/ArrowBindingUtil.mjs.map +2 -2
  223. package/dist-esm/lib/canvas/TldrawSelectionForeground.mjs +4 -8
  224. package/dist-esm/lib/canvas/TldrawSelectionForeground.mjs.map +2 -2
  225. package/dist-esm/lib/defaultEmbedDefinitions.mjs.map +2 -2
  226. package/dist-esm/lib/defaultExternalContentHandlers.mjs +5 -5
  227. package/dist-esm/lib/defaultExternalContentHandlers.mjs.map +2 -2
  228. package/dist-esm/lib/defaultSideEffects.mjs +1 -6
  229. package/dist-esm/lib/defaultSideEffects.mjs.map +2 -2
  230. package/dist-esm/lib/shapes/arrow/ArrowShapeUtil.mjs +15 -15
  231. package/dist-esm/lib/shapes/arrow/ArrowShapeUtil.mjs.map +2 -2
  232. package/dist-esm/lib/shapes/arrow/arrowLabel.mjs +1 -1
  233. package/dist-esm/lib/shapes/arrow/arrowLabel.mjs.map +2 -2
  234. package/dist-esm/lib/shapes/arrow/arrowTargetState.mjs +1 -1
  235. package/dist-esm/lib/shapes/arrow/arrowTargetState.mjs.map +2 -2
  236. package/dist-esm/lib/shapes/arrow/elbow/elbowArrowSnapLines.mjs.map +2 -2
  237. package/dist-esm/lib/shapes/arrow/shared.mjs.map +2 -2
  238. package/dist-esm/lib/shapes/arrow/toolStates/Idle.mjs +10 -4
  239. package/dist-esm/lib/shapes/arrow/toolStates/Idle.mjs.map +2 -2
  240. package/dist-esm/lib/shapes/arrow/toolStates/Pointing.mjs +4 -7
  241. package/dist-esm/lib/shapes/arrow/toolStates/Pointing.mjs.map +2 -2
  242. package/dist-esm/lib/shapes/bookmark/BookmarkShapeUtil.mjs +1 -1
  243. package/dist-esm/lib/shapes/bookmark/BookmarkShapeUtil.mjs.map +2 -2
  244. package/dist-esm/lib/shapes/bookmark/bookmarks.mjs.map +2 -2
  245. package/dist-esm/lib/shapes/draw/DrawShapeUtil.mjs +24 -29
  246. package/dist-esm/lib/shapes/draw/DrawShapeUtil.mjs.map +2 -2
  247. package/dist-esm/lib/shapes/draw/getPath.mjs +11 -21
  248. package/dist-esm/lib/shapes/draw/getPath.mjs.map +2 -2
  249. package/dist-esm/lib/shapes/draw/toolStates/Drawing.mjs +86 -83
  250. package/dist-esm/lib/shapes/draw/toolStates/Drawing.mjs.map +3 -3
  251. package/dist-esm/lib/shapes/embed/EmbedShapeUtil.mjs +0 -6
  252. package/dist-esm/lib/shapes/embed/EmbedShapeUtil.mjs.map +2 -2
  253. package/dist-esm/lib/shapes/frame/FrameShapeTool.mjs.map +1 -1
  254. package/dist-esm/lib/shapes/frame/FrameShapeUtil.mjs +5 -6
  255. package/dist-esm/lib/shapes/frame/FrameShapeUtil.mjs.map +2 -2
  256. package/dist-esm/lib/shapes/geo/GeoShapeUtil.mjs +142 -147
  257. package/dist-esm/lib/shapes/geo/GeoShapeUtil.mjs.map +2 -2
  258. package/dist-esm/lib/shapes/geo/toolStates/Idle.mjs +10 -5
  259. package/dist-esm/lib/shapes/geo/toolStates/Idle.mjs.map +2 -2
  260. package/dist-esm/lib/shapes/geo/toolStates/Pointing.mjs +3 -3
  261. package/dist-esm/lib/shapes/geo/toolStates/Pointing.mjs.map +2 -2
  262. package/dist-esm/lib/shapes/highlight/HighlightShapeUtil.mjs +22 -24
  263. package/dist-esm/lib/shapes/highlight/HighlightShapeUtil.mjs.map +2 -2
  264. package/dist-esm/lib/shapes/line/toolStates/Pointing.mjs +3 -3
  265. package/dist-esm/lib/shapes/line/toolStates/Pointing.mjs.map +2 -2
  266. package/dist-esm/lib/shapes/note/NoteShapeUtil.mjs +12 -7
  267. package/dist-esm/lib/shapes/note/NoteShapeUtil.mjs.map +2 -2
  268. package/dist-esm/lib/shapes/note/noteHelpers.mjs.map +2 -2
  269. package/dist-esm/lib/shapes/note/toolStates/Pointing.mjs +10 -5
  270. package/dist-esm/lib/shapes/note/toolStates/Pointing.mjs.map +2 -2
  271. package/dist-esm/lib/shapes/shared/HyperlinkButton.mjs +3 -4
  272. package/dist-esm/lib/shapes/shared/HyperlinkButton.mjs.map +2 -2
  273. package/dist-esm/lib/shapes/shared/PlainTextLabel.mjs +2 -14
  274. package/dist-esm/lib/shapes/shared/PlainTextLabel.mjs.map +2 -2
  275. package/dist-esm/lib/shapes/shared/RichTextLabel.mjs +4 -12
  276. package/dist-esm/lib/shapes/shared/RichTextLabel.mjs.map +2 -2
  277. package/dist-esm/lib/shapes/shared/ShapeFill.mjs +2 -2
  278. package/dist-esm/lib/shapes/shared/ShapeFill.mjs.map +2 -2
  279. package/dist-esm/lib/shapes/shared/crop.mjs +0 -1
  280. package/dist-esm/lib/shapes/shared/crop.mjs.map +2 -2
  281. package/dist-esm/lib/shapes/shared/interpolate-props.mjs +4 -4
  282. package/dist-esm/lib/shapes/shared/interpolate-props.mjs.map +2 -2
  283. package/dist-esm/lib/shapes/shared/useEditablePlainText.mjs.map +2 -2
  284. package/dist-esm/lib/shapes/shared/useEditableRichText.mjs.map +2 -2
  285. package/dist-esm/lib/shapes/shared/useForceSolid.mjs +9 -0
  286. package/dist-esm/lib/shapes/shared/useForceSolid.mjs.map +7 -0
  287. package/dist-esm/lib/shapes/shared/useImageOrVideoAsset.mjs +1 -1
  288. package/dist-esm/lib/shapes/shared/useImageOrVideoAsset.mjs.map +2 -2
  289. package/dist-esm/lib/shapes/text/RichTextArea.mjs +0 -5
  290. package/dist-esm/lib/shapes/text/RichTextArea.mjs.map +2 -2
  291. package/dist-esm/lib/shapes/text/TextShapeUtil.mjs +2 -5
  292. package/dist-esm/lib/shapes/text/TextShapeUtil.mjs.map +2 -2
  293. package/dist-esm/lib/shapes/text/toolStates/Idle.mjs +10 -4
  294. package/dist-esm/lib/shapes/text/toolStates/Idle.mjs.map +2 -2
  295. package/dist-esm/lib/shapes/text/toolStates/Pointing.mjs +5 -7
  296. package/dist-esm/lib/shapes/text/toolStates/Pointing.mjs.map +2 -2
  297. package/dist-esm/lib/shapes/video/VideoShapeUtil.mjs +1 -1
  298. package/dist-esm/lib/shapes/video/VideoShapeUtil.mjs.map +2 -2
  299. package/dist-esm/lib/tools/EraserTool/childStates/Erasing.mjs +5 -4
  300. package/dist-esm/lib/tools/EraserTool/childStates/Erasing.mjs.map +2 -2
  301. package/dist-esm/lib/tools/EraserTool/childStates/Pointing.mjs +8 -3
  302. package/dist-esm/lib/tools/EraserTool/childStates/Pointing.mjs.map +2 -2
  303. package/dist-esm/lib/tools/HandTool/HandTool.mjs +5 -3
  304. package/dist-esm/lib/tools/HandTool/HandTool.mjs.map +2 -2
  305. package/dist-esm/lib/tools/HandTool/childStates/Dragging.mjs +2 -3
  306. package/dist-esm/lib/tools/HandTool/childStates/Dragging.mjs.map +2 -2
  307. package/dist-esm/lib/tools/HandTool/childStates/Pointing.mjs +1 -1
  308. package/dist-esm/lib/tools/HandTool/childStates/Pointing.mjs.map +2 -2
  309. package/dist-esm/lib/tools/LaserTool/childStates/Lasering.mjs +1 -1
  310. package/dist-esm/lib/tools/LaserTool/childStates/Lasering.mjs.map +2 -2
  311. package/dist-esm/lib/tools/SelectTool/DragAndDropManager.mjs +11 -10
  312. package/dist-esm/lib/tools/SelectTool/DragAndDropManager.mjs.map +2 -2
  313. package/dist-esm/lib/tools/SelectTool/childStates/Brushing.mjs +5 -6
  314. package/dist-esm/lib/tools/SelectTool/childStates/Brushing.mjs.map +2 -2
  315. package/dist-esm/lib/tools/SelectTool/childStates/Crop/children/Cropping.mjs +6 -4
  316. package/dist-esm/lib/tools/SelectTool/childStates/Crop/children/Cropping.mjs.map +2 -2
  317. package/dist-esm/lib/tools/SelectTool/childStates/Crop/children/Idle.mjs +1 -1
  318. package/dist-esm/lib/tools/SelectTool/childStates/Crop/children/Idle.mjs.map +2 -2
  319. package/dist-esm/lib/tools/SelectTool/childStates/Crop/children/PointingCrop.mjs +1 -1
  320. package/dist-esm/lib/tools/SelectTool/childStates/Crop/children/PointingCrop.mjs.map +2 -2
  321. package/dist-esm/lib/tools/SelectTool/childStates/Crop/children/PointingCropHandle.mjs +1 -1
  322. package/dist-esm/lib/tools/SelectTool/childStates/Crop/children/PointingCropHandle.mjs.map +2 -2
  323. package/dist-esm/lib/tools/SelectTool/childStates/Crop/children/TranslatingCrop.mjs +1 -2
  324. package/dist-esm/lib/tools/SelectTool/childStates/Crop/children/TranslatingCrop.mjs.map +2 -2
  325. package/dist-esm/lib/tools/SelectTool/childStates/Crop/children/crop_helpers.mjs +1 -1
  326. package/dist-esm/lib/tools/SelectTool/childStates/Crop/children/crop_helpers.mjs.map +2 -2
  327. package/dist-esm/lib/tools/SelectTool/childStates/DraggingHandle.mjs +6 -8
  328. package/dist-esm/lib/tools/SelectTool/childStates/DraggingHandle.mjs.map +2 -2
  329. package/dist-esm/lib/tools/SelectTool/childStates/EditingShape.mjs +11 -38
  330. package/dist-esm/lib/tools/SelectTool/childStates/EditingShape.mjs.map +2 -2
  331. package/dist-esm/lib/tools/SelectTool/childStates/Idle.mjs +51 -43
  332. package/dist-esm/lib/tools/SelectTool/childStates/Idle.mjs.map +2 -2
  333. package/dist-esm/lib/tools/SelectTool/childStates/PointingArrowLabel.mjs +6 -6
  334. package/dist-esm/lib/tools/SelectTool/childStates/PointingArrowLabel.mjs.map +2 -2
  335. package/dist-esm/lib/tools/SelectTool/childStates/PointingCanvas.mjs +1 -1
  336. package/dist-esm/lib/tools/SelectTool/childStates/PointingCanvas.mjs.map +2 -2
  337. package/dist-esm/lib/tools/SelectTool/childStates/PointingHandle.mjs +19 -6
  338. package/dist-esm/lib/tools/SelectTool/childStates/PointingHandle.mjs.map +2 -2
  339. package/dist-esm/lib/tools/SelectTool/childStates/PointingResizeHandle.mjs +1 -1
  340. package/dist-esm/lib/tools/SelectTool/childStates/PointingResizeHandle.mjs.map +2 -2
  341. package/dist-esm/lib/tools/SelectTool/childStates/PointingRotateHandle.mjs +1 -1
  342. package/dist-esm/lib/tools/SelectTool/childStates/PointingRotateHandle.mjs.map +2 -2
  343. package/dist-esm/lib/tools/SelectTool/childStates/PointingSelection.mjs +2 -2
  344. package/dist-esm/lib/tools/SelectTool/childStates/PointingSelection.mjs.map +2 -2
  345. package/dist-esm/lib/tools/SelectTool/childStates/PointingShape.mjs +13 -4
  346. package/dist-esm/lib/tools/SelectTool/childStates/PointingShape.mjs.map +2 -2
  347. package/dist-esm/lib/tools/SelectTool/childStates/Resizing.mjs +6 -5
  348. package/dist-esm/lib/tools/SelectTool/childStates/Resizing.mjs.map +2 -2
  349. package/dist-esm/lib/tools/SelectTool/childStates/Rotating.mjs +3 -2
  350. package/dist-esm/lib/tools/SelectTool/childStates/Rotating.mjs.map +2 -2
  351. package/dist-esm/lib/tools/SelectTool/childStates/ScribbleBrushing.mjs +6 -7
  352. package/dist-esm/lib/tools/SelectTool/childStates/ScribbleBrushing.mjs.map +2 -2
  353. package/dist-esm/lib/tools/SelectTool/childStates/Translating.mjs +11 -13
  354. package/dist-esm/lib/tools/SelectTool/childStates/Translating.mjs.map +2 -2
  355. package/dist-esm/lib/tools/SelectTool/selectHelpers.mjs +4 -17
  356. package/dist-esm/lib/tools/SelectTool/selectHelpers.mjs.map +2 -2
  357. package/dist-esm/lib/tools/ZoomTool/ZoomTool.mjs +1 -1
  358. package/dist-esm/lib/tools/ZoomTool/ZoomTool.mjs.map +2 -2
  359. package/dist-esm/lib/tools/ZoomTool/childStates/Pointing.mjs +3 -3
  360. package/dist-esm/lib/tools/ZoomTool/childStates/Pointing.mjs.map +2 -2
  361. package/dist-esm/lib/tools/ZoomTool/childStates/ZoomBrushing.mjs +6 -5
  362. package/dist-esm/lib/tools/ZoomTool/childStates/ZoomBrushing.mjs.map +2 -2
  363. package/dist-esm/lib/tools/selection-logic/getHitShapeOnCanvasPointerDown.mjs +3 -1
  364. package/dist-esm/lib/tools/selection-logic/getHitShapeOnCanvasPointerDown.mjs.map +2 -2
  365. package/dist-esm/lib/tools/selection-logic/getShouldEnterCropModeOnPointerDown.mjs +8 -0
  366. package/dist-esm/lib/tools/selection-logic/getShouldEnterCropModeOnPointerDown.mjs.map +7 -0
  367. package/dist-esm/lib/tools/selection-logic/selectOnCanvasPointerUp.mjs +1 -1
  368. package/dist-esm/lib/tools/selection-logic/selectOnCanvasPointerUp.mjs.map +2 -2
  369. package/dist-esm/lib/tools/selection-logic/updateHoveredShapeId.mjs +1 -1
  370. package/dist-esm/lib/tools/selection-logic/updateHoveredShapeId.mjs.map +2 -2
  371. package/dist-esm/lib/ui/TldrawUi.mjs +2 -2
  372. package/dist-esm/lib/ui/TldrawUi.mjs.map +2 -2
  373. package/dist-esm/lib/ui/components/ActionsMenu/DefaultActionsMenuContent.mjs +8 -2
  374. package/dist-esm/lib/ui/components/ActionsMenu/DefaultActionsMenuContent.mjs.map +2 -2
  375. package/dist-esm/lib/ui/components/ContextMenu/DefaultContextMenu.mjs +3 -1
  376. package/dist-esm/lib/ui/components/ContextMenu/DefaultContextMenu.mjs.map +2 -2
  377. package/dist-esm/lib/ui/components/CursorChatBubble.mjs +1 -1
  378. package/dist-esm/lib/ui/components/CursorChatBubble.mjs.map +2 -2
  379. package/dist-esm/lib/ui/components/DefaultDebugPanel.mjs +30 -3
  380. package/dist-esm/lib/ui/components/DefaultDebugPanel.mjs.map +2 -2
  381. package/dist-esm/lib/ui/components/EditLinkDialog.mjs +1 -11
  382. package/dist-esm/lib/ui/components/EditLinkDialog.mjs.map +2 -2
  383. package/dist-esm/lib/ui/components/HelperButtons/StopFollowing.mjs.map +2 -2
  384. package/dist-esm/lib/ui/components/Minimap/DefaultMinimap.mjs +1 -1
  385. package/dist-esm/lib/ui/components/Minimap/DefaultMinimap.mjs.map +2 -2
  386. package/dist-esm/lib/ui/components/OfflineIndicator/OfflineIndicator.mjs +6 -3
  387. package/dist-esm/lib/ui/components/OfflineIndicator/OfflineIndicator.mjs.map +2 -2
  388. package/dist-esm/lib/ui/components/PageMenu/PageItemInput.mjs +1 -3
  389. package/dist-esm/lib/ui/components/PageMenu/PageItemInput.mjs.map +2 -2
  390. package/dist-esm/lib/ui/components/SharePanel/PeopleMenu.mjs +0 -6
  391. package/dist-esm/lib/ui/components/SharePanel/PeopleMenu.mjs.map +2 -2
  392. package/dist-esm/lib/ui/components/Toolbar/AltTextEditor.mjs.map +2 -2
  393. package/dist-esm/lib/ui/components/Toolbar/DefaultImageToolbar.mjs +1 -1
  394. package/dist-esm/lib/ui/components/Toolbar/DefaultImageToolbar.mjs.map +2 -2
  395. package/dist-esm/lib/ui/components/Toolbar/DefaultRichTextToolbar.mjs +1 -1
  396. package/dist-esm/lib/ui/components/Toolbar/DefaultRichTextToolbar.mjs.map +2 -2
  397. package/dist-esm/lib/ui/components/TopPanel/CenteredTopPanelContainer.mjs.map +1 -1
  398. package/dist-esm/lib/ui/components/TopPanel/DefaultTopPanel.mjs +12 -0
  399. package/dist-esm/lib/ui/components/TopPanel/DefaultTopPanel.mjs.map +7 -0
  400. package/dist-esm/lib/ui/components/menu-items.mjs +5 -4
  401. package/dist-esm/lib/ui/components/menu-items.mjs.map +2 -2
  402. package/dist-esm/lib/ui/components/primitives/TldrawUiContextualToolbar.mjs +1 -3
  403. package/dist-esm/lib/ui/components/primitives/TldrawUiContextualToolbar.mjs.map +2 -2
  404. package/dist-esm/lib/ui/components/primitives/TldrawUiSlider.mjs +2 -2
  405. package/dist-esm/lib/ui/components/primitives/TldrawUiSlider.mjs.map +2 -2
  406. package/dist-esm/lib/ui/components/primitives/TldrawUiTooltip.mjs +95 -157
  407. package/dist-esm/lib/ui/components/primitives/TldrawUiTooltip.mjs.map +2 -2
  408. package/dist-esm/lib/ui/components/primitives/menus/TldrawUiMenuActionCheckboxItem.mjs.map +2 -2
  409. package/dist-esm/lib/ui/components/primitives/menus/TldrawUiMenuActionItem.mjs.map +2 -2
  410. package/dist-esm/lib/ui/components/primitives/menus/TldrawUiMenuItem.mjs +2 -2
  411. package/dist-esm/lib/ui/components/primitives/menus/TldrawUiMenuItem.mjs.map +2 -2
  412. package/dist-esm/lib/ui/context/actions.mjs +8 -7
  413. package/dist-esm/lib/ui/context/actions.mjs.map +2 -2
  414. package/dist-esm/lib/ui/context/components.mjs +2 -1
  415. package/dist-esm/lib/ui/context/components.mjs.map +2 -2
  416. package/dist-esm/lib/ui/hooks/menu-hooks.mjs +4 -1
  417. package/dist-esm/lib/ui/hooks/menu-hooks.mjs.map +2 -2
  418. package/dist-esm/lib/ui/hooks/useClipboardEvents.mjs +2 -2
  419. package/dist-esm/lib/ui/hooks/useClipboardEvents.mjs.map +2 -2
  420. package/dist-esm/lib/ui/hooks/useFlatten.mjs.map +2 -2
  421. package/dist-esm/lib/ui/hooks/useKeyboardShortcuts.mjs +2 -2
  422. package/dist-esm/lib/ui/hooks/useKeyboardShortcuts.mjs.map +2 -2
  423. package/dist-esm/lib/ui/hooks/useTools.mjs +5 -4
  424. package/dist-esm/lib/ui/hooks/useTools.mjs.map +2 -2
  425. package/dist-esm/lib/ui/version.mjs +3 -3
  426. package/dist-esm/lib/ui/version.mjs.map +1 -1
  427. package/dist-esm/lib/utils/excalidraw/putExcalidrawContent.mjs +6 -17
  428. package/dist-esm/lib/utils/excalidraw/putExcalidrawContent.mjs.map +2 -2
  429. package/dist-esm/lib/utils/export/exportAs.mjs +3 -1
  430. package/dist-esm/lib/utils/export/exportAs.mjs.map +2 -2
  431. package/dist-esm/lib/utils/frames/frames.mjs.map +2 -2
  432. package/dist-esm/lib/utils/text/richText.mjs +2 -5
  433. package/dist-esm/lib/utils/text/richText.mjs.map +2 -2
  434. package/dist-esm/lib/utils/text/textDirection.mjs +31 -0
  435. package/dist-esm/lib/utils/text/textDirection.mjs.map +7 -0
  436. package/dist-esm/lib/utils/tldr/buildFromV1Document.mjs +2 -8
  437. package/dist-esm/lib/utils/tldr/buildFromV1Document.mjs.map +2 -2
  438. package/package.json +16 -18
  439. package/src/index.ts +2 -6
  440. package/src/lib/Tldraw.test.tsx +1 -46
  441. package/src/lib/bindings/arrow/ArrowBindingUtil.ts +1 -1
  442. package/src/lib/canvas/TldrawSelectionForeground.tsx +9 -20
  443. package/src/lib/defaultEmbedDefinitions.ts +0 -1
  444. package/src/lib/defaultExternalContentHandlers.ts +14 -13
  445. package/src/lib/defaultSideEffects.ts +1 -6
  446. package/src/lib/shapes/arrow/ArrowShapeOptions.test.ts +133 -40
  447. package/src/lib/shapes/arrow/ArrowShapeTool.test.ts +8 -8
  448. package/src/lib/shapes/arrow/ArrowShapeUtil.test.ts +2 -2
  449. package/src/lib/shapes/arrow/ArrowShapeUtil.tsx +16 -16
  450. package/src/lib/shapes/arrow/arrow-types.ts +0 -2
  451. package/src/lib/shapes/arrow/arrowLabel.ts +2 -2
  452. package/src/lib/shapes/arrow/arrowTargetState.ts +2 -2
  453. package/src/lib/shapes/arrow/elbow/elbowArrowSnapLines.tsx +3 -3
  454. package/src/lib/shapes/arrow/shared.ts +4 -4
  455. package/src/lib/shapes/arrow/toolStates/Idle.tsx +14 -4
  456. package/src/lib/shapes/arrow/toolStates/Pointing.tsx +5 -8
  457. package/src/lib/shapes/bookmark/BookmarkShapeUtil.tsx +1 -1
  458. package/src/lib/shapes/bookmark/bookmarks.ts +3 -3
  459. package/src/lib/shapes/draw/DrawShapeUtil.tsx +26 -30
  460. package/src/lib/shapes/draw/getPath.ts +10 -31
  461. package/src/lib/shapes/draw/toolStates/Drawing.ts +90 -100
  462. package/src/lib/shapes/embed/EmbedShapeUtil.tsx +1 -8
  463. package/src/lib/shapes/frame/FrameShapeTool.ts +1 -1
  464. package/src/lib/shapes/frame/FrameShapeUtil.tsx +4 -10
  465. package/src/lib/shapes/geo/GeoShapeUtil.test.tsx +2 -10
  466. package/src/lib/shapes/geo/GeoShapeUtil.tsx +176 -228
  467. package/src/lib/shapes/geo/toolStates/Idle.ts +15 -5
  468. package/src/lib/shapes/geo/toolStates/Pointing.ts +6 -6
  469. package/src/lib/shapes/highlight/HighlightShapeUtil.tsx +24 -25
  470. package/src/lib/shapes/line/LineShapeTool.test.ts +6 -6
  471. package/src/lib/shapes/line/LineShapeUtil.test.tsx +5 -5
  472. package/src/lib/shapes/line/toolStates/Pointing.ts +4 -4
  473. package/src/lib/shapes/note/NoteShapeTool.test.ts +1 -2
  474. package/src/lib/shapes/note/NoteShapeUtil.tsx +10 -9
  475. package/src/lib/shapes/note/noteCloning.test.ts +1 -3
  476. package/src/lib/shapes/note/noteHelpers.ts +2 -2
  477. package/src/lib/shapes/note/toolStates/Pointing.ts +10 -5
  478. package/src/lib/shapes/shared/HyperlinkButton.tsx +3 -4
  479. package/src/lib/shapes/shared/PlainTextLabel.tsx +2 -12
  480. package/src/lib/shapes/shared/RichTextLabel.tsx +4 -14
  481. package/src/lib/shapes/shared/ShapeFill.tsx +2 -2
  482. package/src/lib/shapes/shared/crop.ts +0 -1
  483. package/src/lib/shapes/shared/interpolate-props.ts +4 -4
  484. package/src/lib/shapes/shared/useEditablePlainText.ts +3 -7
  485. package/src/lib/shapes/shared/useEditableRichText.ts +3 -7
  486. package/src/lib/shapes/shared/useForceSolid.ts +6 -0
  487. package/src/lib/shapes/shared/useImageOrVideoAsset.ts +1 -1
  488. package/src/lib/shapes/text/RichTextArea.tsx +0 -5
  489. package/src/lib/shapes/text/TextShapeTool.test.ts +4 -4
  490. package/src/lib/shapes/text/TextShapeUtil.tsx +0 -5
  491. package/src/lib/shapes/text/toolStates/Idle.ts +14 -4
  492. package/src/lib/shapes/text/toolStates/Pointing.ts +8 -8
  493. package/src/lib/shapes/video/VideoShapeUtil.tsx +1 -2
  494. package/src/lib/tools/EraserTool/childStates/Erasing.ts +10 -7
  495. package/src/lib/tools/EraserTool/childStates/Pointing.ts +20 -5
  496. package/src/lib/tools/HandTool/HandTool.ts +5 -3
  497. package/src/lib/tools/HandTool/childStates/Dragging.ts +2 -3
  498. package/src/lib/tools/HandTool/childStates/Pointing.ts +1 -1
  499. package/src/lib/tools/LaserTool/childStates/Lasering.ts +1 -1
  500. package/src/lib/tools/SelectTool/DragAndDropManager.ts +11 -14
  501. package/src/lib/tools/SelectTool/childStates/Brushing.ts +11 -8
  502. package/src/lib/tools/SelectTool/childStates/Crop/children/Cropping.ts +6 -7
  503. package/src/lib/tools/SelectTool/childStates/Crop/children/Idle.ts +4 -3
  504. package/src/lib/tools/SelectTool/childStates/Crop/children/PointingCrop.ts +1 -1
  505. package/src/lib/tools/SelectTool/childStates/Crop/children/PointingCropHandle.ts +1 -1
  506. package/src/lib/tools/SelectTool/childStates/Crop/children/TranslatingCrop.ts +1 -2
  507. package/src/lib/tools/SelectTool/childStates/Crop/children/crop_helpers.ts +1 -1
  508. package/src/lib/tools/SelectTool/childStates/DraggingHandle.tsx +12 -11
  509. package/src/lib/tools/SelectTool/childStates/EditingShape.ts +16 -57
  510. package/src/lib/tools/SelectTool/childStates/Idle.ts +81 -64
  511. package/src/lib/tools/SelectTool/childStates/PointingArrowLabel.ts +8 -7
  512. package/src/lib/tools/SelectTool/childStates/PointingCanvas.ts +1 -1
  513. package/src/lib/tools/SelectTool/childStates/PointingHandle.ts +17 -9
  514. package/src/lib/tools/SelectTool/childStates/PointingResizeHandle.ts +1 -1
  515. package/src/lib/tools/SelectTool/childStates/PointingRotateHandle.ts +1 -1
  516. package/src/lib/tools/SelectTool/childStates/PointingSelection.ts +4 -4
  517. package/src/lib/tools/SelectTool/childStates/PointingShape.ts +14 -4
  518. package/src/lib/tools/SelectTool/childStates/Resizing.ts +10 -8
  519. package/src/lib/tools/SelectTool/childStates/Rotating.ts +3 -2
  520. package/src/lib/tools/SelectTool/childStates/ScribbleBrushing.ts +10 -9
  521. package/src/lib/tools/SelectTool/childStates/Translating.ts +15 -16
  522. package/src/lib/tools/SelectTool/selectHelpers.ts +4 -39
  523. package/src/lib/tools/ZoomTool/ZoomTool.ts +1 -1
  524. package/src/lib/tools/ZoomTool/childStates/Pointing.ts +3 -3
  525. package/src/lib/tools/ZoomTool/childStates/ZoomBrushing.ts +6 -5
  526. package/src/lib/tools/selection-logic/getHitShapeOnCanvasPointerDown.ts +3 -1
  527. package/src/lib/tools/selection-logic/getShouldEnterCropModeOnPointerDown.ts +10 -0
  528. package/src/lib/tools/selection-logic/selectOnCanvasPointerUp.ts +1 -1
  529. package/src/lib/tools/selection-logic/updateHoveredShapeId.ts +1 -1
  530. package/src/lib/ui/TldrawUi.tsx +2 -5
  531. package/src/lib/ui/components/ActionsMenu/DefaultActionsMenuContent.tsx +9 -1
  532. package/src/lib/ui/components/ContextMenu/DefaultContextMenu.tsx +3 -1
  533. package/src/lib/ui/components/CursorChatBubble.tsx +2 -2
  534. package/src/lib/ui/components/DefaultDebugPanel.tsx +42 -3
  535. package/src/lib/ui/components/EditLinkDialog.tsx +6 -16
  536. package/src/lib/ui/components/HelperButtons/StopFollowing.tsx +2 -2
  537. package/src/lib/ui/components/Minimap/DefaultMinimap.tsx +1 -1
  538. package/src/lib/ui/components/OfflineIndicator/OfflineIndicator.tsx +5 -6
  539. package/src/lib/ui/components/PageMenu/PageItemInput.tsx +1 -3
  540. package/src/lib/ui/components/SharePanel/PeopleMenu.tsx +0 -8
  541. package/src/lib/ui/components/Toolbar/AltTextEditor.tsx +2 -2
  542. package/src/lib/ui/components/Toolbar/DefaultImageToolbar.tsx +1 -1
  543. package/src/lib/ui/components/Toolbar/DefaultRichTextToolbar.tsx +1 -1
  544. package/src/lib/ui/components/TopPanel/CenteredTopPanelContainer.tsx +1 -1
  545. package/src/lib/ui/components/TopPanel/DefaultTopPanel.tsx +10 -0
  546. package/src/lib/ui/components/menu-items.tsx +15 -9
  547. package/src/lib/ui/components/primitives/TldrawUiContextualToolbar.tsx +3 -5
  548. package/src/lib/ui/components/primitives/TldrawUiSlider.tsx +2 -2
  549. package/src/lib/ui/components/primitives/TldrawUiTooltip.tsx +113 -208
  550. package/src/lib/ui/components/primitives/menus/TldrawUiMenuActionCheckboxItem.tsx +1 -1
  551. package/src/lib/ui/components/primitives/menus/TldrawUiMenuActionItem.tsx +1 -1
  552. package/src/lib/ui/components/primitives/menus/TldrawUiMenuItem.tsx +2 -2
  553. package/src/lib/ui/context/actions.tsx +19 -15
  554. package/src/lib/ui/context/components.tsx +2 -1
  555. package/src/lib/ui/hooks/menu-hooks.ts +19 -9
  556. package/src/lib/ui/hooks/useClipboardEvents.ts +2 -2
  557. package/src/lib/ui/hooks/useFlatten.ts +2 -1
  558. package/src/lib/ui/hooks/useKeyboardShortcuts.ts +2 -2
  559. package/src/lib/ui/hooks/useTools.tsx +7 -5
  560. package/src/lib/ui/version.ts +3 -3
  561. package/src/lib/ui.css +29 -31
  562. package/src/lib/utils/excalidraw/__snapshots__/putExcalidrawContent.test.tsx.snap +48 -12
  563. package/src/lib/utils/excalidraw/putExcalidrawContent.ts +6 -19
  564. package/src/lib/utils/export/exportAs.ts +9 -2
  565. package/src/lib/utils/frames/frames.ts +1 -1
  566. package/src/lib/utils/text/richText.ts +5 -6
  567. package/src/lib/utils/text/textDirection.ts +32 -0
  568. package/src/lib/utils/tldr/buildFromV1Document.ts +19 -21
  569. package/src/test/Editor.test.tsx +41 -78
  570. package/src/test/EraserTool.test.ts +12 -10
  571. package/src/test/SelectTool.test.ts +19 -11
  572. package/src/test/TestEditor.ts +51 -49
  573. package/src/test/TldrawEditor.test.tsx +20 -24
  574. package/src/test/__snapshots__/drawing.test.ts.snap +1257 -3
  575. package/src/test/__snapshots__/resizing.test.ts.snap +12 -3
  576. package/src/test/arrows-megabus.test.tsx +1 -1
  577. package/src/test/bindings.test.tsx +25 -29
  578. package/src/test/bindingsIndex.test.tsx +4 -4
  579. package/src/test/commands/__snapshots__/getSvgString.test.ts.snap +10 -10
  580. package/src/test/commands/createShapes.test.ts +1 -15
  581. package/src/test/commands/getSvgString.test.ts +2 -2
  582. package/src/test/commands/putContent.test.ts +1 -80
  583. package/src/test/commands/setCamera.test.ts +11 -13
  584. package/src/test/commands/stackShapes.test.ts +8 -34
  585. package/src/test/commands/updateShapes.test.ts +5 -21
  586. package/src/test/commands/zoomToBounds.test.ts +3 -19
  587. package/src/test/commands/zoomToSelection.test.ts +3 -14
  588. package/src/test/custom-clipping.test.ts +44 -52
  589. package/src/test/customSnapping.test.tsx +62 -77
  590. package/src/test/drawing.test.ts +10 -17
  591. package/src/test/duplicate.test.ts +1 -1
  592. package/src/test/flipShapes.test.ts +0 -33
  593. package/src/test/frames.test.ts +2 -94
  594. package/src/test/getCulledShapes.test.tsx +3 -11
  595. package/src/test/getShapeAtPoint.test.ts +2 -2
  596. package/src/test/groups.test.tsx +4 -7
  597. package/src/test/modifiers.test.ts +6 -6
  598. package/src/test/resizing.test.ts +22 -16
  599. package/src/test/selection-omnibus.test.ts +13 -13
  600. package/src/test/shapeutils.test.ts +1 -1
  601. package/src/test/spacebarPanning.test.ts +10 -28
  602. package/src/test/styles2.test.tsx +1 -1
  603. package/src/test/styles3.test.ts +5 -5
  604. package/src/test/test-jsx.tsx +57 -72
  605. package/src/test/text.test.ts +17 -15
  606. package/src/test/translating.test.ts +8 -6
  607. package/tldraw.css +41 -45
  608. package/dist-cjs/lib/shapes/shared/useEfficientZoomThreshold.js.map +0 -7
  609. package/dist-cjs/lib/utils/test-helpers.js.map +0 -7
  610. package/dist-esm/lib/shapes/shared/useEfficientZoomThreshold.mjs +0 -12
  611. package/dist-esm/lib/shapes/shared/useEfficientZoomThreshold.mjs.map +0 -7
  612. package/dist-esm/lib/utils/test-helpers.mjs +0 -21
  613. package/dist-esm/lib/utils/test-helpers.mjs.map +0 -7
  614. package/src/lib/shapes/draw/DrawShapeUtil.test.ts +0 -146
  615. package/src/lib/shapes/highlight/HighlightShapeUtil.test.ts +0 -146
  616. package/src/lib/shapes/shared/useEfficientZoomThreshold.ts +0 -10
  617. package/src/lib/utils/test-helpers.ts +0 -60
  618. package/src/test/commands/cameraState.test.ts +0 -299
  619. package/src/test/commands/createShape.test.ts +0 -64
  620. package/src/test/commands/isShapeOfType.test.ts +0 -44
  621. package/src/test/commands/updateShape.test.ts +0 -67
@@ -1,146 +0,0 @@
1
- import { createShapeId, TLDrawShape } from '@tldraw/editor'
2
- import { TestEditor } from '../../../test/TestEditor'
3
- import { createDrawSegments, pointsToBase64 } from '../../utils/test-helpers'
4
-
5
- let editor: TestEditor
6
-
7
- beforeEach(() => {
8
- editor = new TestEditor()
9
- })
10
-
11
- afterEach(() => {
12
- editor?.dispose()
13
- })
14
-
15
- describe('DrawShapeUtil dot detection', () => {
16
- const shapeId = createShapeId('test-draw')
17
-
18
- function createDrawShape(segments: TLDrawShape['props']['segments']): TLDrawShape {
19
- editor.createShapes([
20
- {
21
- id: shapeId,
22
- type: 'draw',
23
- props: { segments },
24
- },
25
- ])
26
- return editor.getShape(shapeId) as TLDrawShape
27
- }
28
-
29
- describe('getIsDot behavior via hideResizeHandles', () => {
30
- it('treats a shape with one segment and zero points as a dot', () => {
31
- const shape = createDrawShape([{ type: 'free', points: '' }])
32
- const util = editor.getShapeUtil('draw')
33
- expect(util.hideResizeHandles(shape)).toBe(true)
34
- })
35
-
36
- it('treats a shape with one segment and one point as a dot', () => {
37
- const shape = createDrawShape(createDrawSegments([[{ x: 0, y: 0, z: 0.5 }]]))
38
- const util = editor.getShapeUtil('draw')
39
- expect(util.hideResizeHandles(shape)).toBe(true)
40
- })
41
-
42
- it('treats a shape with one segment and two points as NOT a dot', () => {
43
- const shape = createDrawShape(
44
- createDrawSegments([
45
- [
46
- { x: 0, y: 0, z: 0.5 },
47
- { x: 10, y: 10, z: 0.5 },
48
- ],
49
- ])
50
- )
51
- const util = editor.getShapeUtil('draw')
52
- expect(util.hideResizeHandles(shape)).toBe(false)
53
- })
54
-
55
- it('treats a shape with one segment and many points as NOT a dot', () => {
56
- const shape = createDrawShape(
57
- createDrawSegments([
58
- [
59
- { x: 0, y: 0, z: 0.5 },
60
- { x: 10, y: 10, z: 0.5 },
61
- { x: 20, y: 5, z: 0.5 },
62
- { x: 30, y: 15, z: 0.5 },
63
- ],
64
- ])
65
- )
66
- const util = editor.getShapeUtil('draw')
67
- expect(util.hideResizeHandles(shape)).toBe(false)
68
- })
69
-
70
- it('treats a shape with multiple segments as NOT a dot', () => {
71
- const shape = createDrawShape(
72
- createDrawSegments([[{ x: 0, y: 0, z: 0.5 }], [{ x: 10, y: 10, z: 0.5 }]])
73
- )
74
- const util = editor.getShapeUtil('draw')
75
- expect(util.hideResizeHandles(shape)).toBe(false)
76
- })
77
- })
78
-
79
- describe('hideRotateHandle mirrors hideResizeHandles for dots', () => {
80
- it('hides rotate handle for dots', () => {
81
- const shape = createDrawShape(createDrawSegments([[{ x: 0, y: 0, z: 0.5 }]]))
82
- const util = editor.getShapeUtil('draw')
83
- expect(util.hideRotateHandle(shape)).toBe(true)
84
- })
85
-
86
- it('shows rotate handle for non-dots', () => {
87
- const shape = createDrawShape(
88
- createDrawSegments([
89
- [
90
- { x: 0, y: 0, z: 0.5 },
91
- { x: 10, y: 10, z: 0.5 },
92
- ],
93
- ])
94
- )
95
- const util = editor.getShapeUtil('draw')
96
- expect(util.hideRotateHandle(shape)).toBe(false)
97
- })
98
- })
99
-
100
- describe('hideSelectionBoundsFg mirrors hideResizeHandles for dots', () => {
101
- it('hides selection bounds for dots', () => {
102
- const shape = createDrawShape(createDrawSegments([[{ x: 0, y: 0, z: 0.5 }]]))
103
- const util = editor.getShapeUtil('draw')
104
- expect(util.hideSelectionBoundsFg(shape)).toBe(true)
105
- })
106
-
107
- it('shows selection bounds for non-dots', () => {
108
- const shape = createDrawShape(
109
- createDrawSegments([
110
- [
111
- { x: 0, y: 0, z: 0.5 },
112
- { x: 10, y: 10, z: 0.5 },
113
- ],
114
- ])
115
- )
116
- const util = editor.getShapeUtil('draw')
117
- expect(util.hideSelectionBoundsFg(shape)).toBe(false)
118
- })
119
- })
120
-
121
- describe('base64 encoding boundary conditions', () => {
122
- it('correctly handles the boundary at exactly 16 base64 characters (2 points)', () => {
123
- // Each point is 8 base64 characters (3 Float16s = 6 bytes = 8 base64 chars)
124
- // 2 points = 16 characters, which should NOT be a dot
125
- const twoPointsBase64 = pointsToBase64([
126
- { x: 0, y: 0, z: 0.5 },
127
- { x: 1, y: 1, z: 0.5 },
128
- ])
129
- expect(twoPointsBase64.length).toBe(16)
130
-
131
- const shape = createDrawShape([{ type: 'free', points: twoPointsBase64 }])
132
- const util = editor.getShapeUtil('draw')
133
- expect(util.hideResizeHandles(shape)).toBe(false)
134
- })
135
-
136
- it('correctly handles the boundary at exactly 8 base64 characters (1 point)', () => {
137
- // 1 point = 8 characters, which should be a dot
138
- const onePointBase64 = pointsToBase64([{ x: 0, y: 0, z: 0.5 }])
139
- expect(onePointBase64.length).toBe(8)
140
-
141
- const shape = createDrawShape([{ type: 'free', points: onePointBase64 }])
142
- const util = editor.getShapeUtil('draw')
143
- expect(util.hideResizeHandles(shape)).toBe(true)
144
- })
145
- })
146
- })
@@ -1,146 +0,0 @@
1
- import { createShapeId, TLHighlightShape } from '@tldraw/editor'
2
- import { TestEditor } from '../../../test/TestEditor'
3
- import { createDrawSegments, pointsToBase64 } from '../../utils/test-helpers'
4
-
5
- let editor: TestEditor
6
-
7
- beforeEach(() => {
8
- editor = new TestEditor()
9
- })
10
-
11
- afterEach(() => {
12
- editor?.dispose()
13
- })
14
-
15
- describe('HighlightShapeUtil dot detection', () => {
16
- const shapeId = createShapeId('test-highlight')
17
-
18
- function createHighlightShape(segments: TLHighlightShape['props']['segments']): TLHighlightShape {
19
- editor.createShapes([
20
- {
21
- id: shapeId,
22
- type: 'highlight',
23
- props: { segments },
24
- },
25
- ])
26
- return editor.getShape(shapeId) as TLHighlightShape
27
- }
28
-
29
- describe('getIsDot behavior via hideResizeHandles', () => {
30
- it('treats a shape with one segment and zero points as a dot', () => {
31
- const shape = createHighlightShape([{ type: 'free', points: '' }])
32
- const util = editor.getShapeUtil('highlight')
33
- expect(util.hideResizeHandles(shape)).toBe(true)
34
- })
35
-
36
- it('treats a shape with one segment and one point as a dot', () => {
37
- const shape = createHighlightShape(createDrawSegments([[{ x: 0, y: 0, z: 0.5 }]]))
38
- const util = editor.getShapeUtil('highlight')
39
- expect(util.hideResizeHandles(shape)).toBe(true)
40
- })
41
-
42
- it('treats a shape with one segment and two points as NOT a dot', () => {
43
- const shape = createHighlightShape(
44
- createDrawSegments([
45
- [
46
- { x: 0, y: 0, z: 0.5 },
47
- { x: 10, y: 10, z: 0.5 },
48
- ],
49
- ])
50
- )
51
- const util = editor.getShapeUtil('highlight')
52
- expect(util.hideResizeHandles(shape)).toBe(false)
53
- })
54
-
55
- it('treats a shape with one segment and many points as NOT a dot', () => {
56
- const shape = createHighlightShape(
57
- createDrawSegments([
58
- [
59
- { x: 0, y: 0, z: 0.5 },
60
- { x: 10, y: 10, z: 0.5 },
61
- { x: 20, y: 5, z: 0.5 },
62
- { x: 30, y: 15, z: 0.5 },
63
- ],
64
- ])
65
- )
66
- const util = editor.getShapeUtil('highlight')
67
- expect(util.hideResizeHandles(shape)).toBe(false)
68
- })
69
-
70
- it('treats a shape with multiple segments as NOT a dot', () => {
71
- const shape = createHighlightShape(
72
- createDrawSegments([[{ x: 0, y: 0, z: 0.5 }], [{ x: 10, y: 10, z: 0.5 }]])
73
- )
74
- const util = editor.getShapeUtil('highlight')
75
- expect(util.hideResizeHandles(shape)).toBe(false)
76
- })
77
- })
78
-
79
- describe('hideRotateHandle mirrors hideResizeHandles for dots', () => {
80
- it('hides rotate handle for dots', () => {
81
- const shape = createHighlightShape(createDrawSegments([[{ x: 0, y: 0, z: 0.5 }]]))
82
- const util = editor.getShapeUtil('highlight')
83
- expect(util.hideRotateHandle(shape)).toBe(true)
84
- })
85
-
86
- it('shows rotate handle for non-dots', () => {
87
- const shape = createHighlightShape(
88
- createDrawSegments([
89
- [
90
- { x: 0, y: 0, z: 0.5 },
91
- { x: 10, y: 10, z: 0.5 },
92
- ],
93
- ])
94
- )
95
- const util = editor.getShapeUtil('highlight')
96
- expect(util.hideRotateHandle(shape)).toBe(false)
97
- })
98
- })
99
-
100
- describe('hideSelectionBoundsFg mirrors hideResizeHandles for dots', () => {
101
- it('hides selection bounds for dots', () => {
102
- const shape = createHighlightShape(createDrawSegments([[{ x: 0, y: 0, z: 0.5 }]]))
103
- const util = editor.getShapeUtil('highlight')
104
- expect(util.hideSelectionBoundsFg(shape)).toBe(true)
105
- })
106
-
107
- it('shows selection bounds for non-dots', () => {
108
- const shape = createHighlightShape(
109
- createDrawSegments([
110
- [
111
- { x: 0, y: 0, z: 0.5 },
112
- { x: 10, y: 10, z: 0.5 },
113
- ],
114
- ])
115
- )
116
- const util = editor.getShapeUtil('highlight')
117
- expect(util.hideSelectionBoundsFg(shape)).toBe(false)
118
- })
119
- })
120
-
121
- describe('base64 encoding boundary conditions', () => {
122
- it('correctly handles the boundary at exactly 16 base64 characters (2 points)', () => {
123
- // Each point is 8 base64 characters (3 Float16s = 6 bytes = 8 base64 chars)
124
- // 2 points = 16 characters, which should NOT be a dot
125
- const twoPointsBase64 = pointsToBase64([
126
- { x: 0, y: 0, z: 0.5 },
127
- { x: 1, y: 1, z: 0.5 },
128
- ])
129
- expect(twoPointsBase64.length).toBe(16)
130
-
131
- const shape = createHighlightShape([{ type: 'free', points: twoPointsBase64 }])
132
- const util = editor.getShapeUtil('highlight')
133
- expect(util.hideResizeHandles(shape)).toBe(false)
134
- })
135
-
136
- it('correctly handles the boundary at exactly 8 base64 characters (1 point)', () => {
137
- // 1 point = 8 characters, which should be a dot
138
- const onePointBase64 = pointsToBase64([{ x: 0, y: 0, z: 0.5 }])
139
- expect(onePointBase64.length).toBe(8)
140
-
141
- const shape = createHighlightShape([{ type: 'free', points: onePointBase64 }])
142
- const util = editor.getShapeUtil('highlight')
143
- expect(util.hideResizeHandles(shape)).toBe(true)
144
- })
145
- })
146
- })
@@ -1,10 +0,0 @@
1
- import { useEditor, useValue } from '@tldraw/editor'
2
-
3
- /** Returns true when zoomed out far enough that shapes should render in a simplified "solid" style. */
4
- export function useEfficientZoomThreshold(threshold = 0.25) {
5
- const editor = useEditor()
6
- return useValue('efficient zoom threshold', () => editor.getEfficientZoomLevel() < threshold, [
7
- editor,
8
- threshold,
9
- ])
10
- }
@@ -1,60 +0,0 @@
1
- import type { TLDrawShapeSegment, VecModel } from '@tldraw/editor'
2
- import { b64Vecs, compressLegacySegments } from '@tldraw/editor'
3
-
4
- /**
5
- * Helper function to convert draw shape points from VecModel[] to base64 string.
6
- * This is useful for tests that create draw shapes with the legacy array format.
7
- *
8
- * @example
9
- * ```ts
10
- * const segments = [{ type: 'free', points: pointsToBase64([{x: 0, y: 0, z: 0.5}]) }]
11
- * ```
12
- *
13
- * @public
14
- */
15
- export function pointsToBase64(points: VecModel[]): string {
16
- return b64Vecs.encodePoints(points)
17
- }
18
-
19
- /**
20
- * Helper function to convert base64 string back to VecModel[] points.
21
- * This is useful for tests that need to inspect draw shape points.
22
- *
23
- * @example
24
- * ```ts
25
- * const points = base64ToPoints(shape.props.segments[0].points)
26
- * expect(points[0].x).toBe(0)
27
- * ```
28
- *
29
- * @public
30
- */
31
- export function base64ToPoints(base64: string): VecModel[] {
32
- return b64Vecs.decodePoints(base64)
33
- }
34
-
35
- /**
36
- * Helper function to create draw shape segments from legacy array format.
37
- * This allows tests to use the old format while the shape uses the new base64 format.
38
- *
39
- * @example
40
- * ```ts
41
- * editor.createShapes([{
42
- * type: 'draw',
43
- * props: {
44
- * segments: createDrawSegments([[{x: 0, y: 0}, {x: 10, y: 10}]])
45
- * }
46
- * }])
47
- * ```
48
- * @public
49
- */
50
- export function createDrawSegments(
51
- pointArrays: VecModel[][],
52
- type: 'free' | 'straight' = 'free'
53
- ): TLDrawShapeSegment[] {
54
- return compressLegacySegments(
55
- pointArrays.map((points) => ({
56
- type,
57
- points,
58
- }))
59
- )
60
- }
@@ -1,299 +0,0 @@
1
- import { Box } from '@tldraw/editor'
2
- import { TestEditor } from '../TestEditor'
3
-
4
- let editor: TestEditor
5
-
6
- beforeEach(() => {
7
- editor = new TestEditor()
8
- editor.updateViewportScreenBounds(new Box(0, 0, 1600, 900))
9
- })
10
-
11
- describe('getCameraState', () => {
12
- it('starts as idle', () => {
13
- expect(editor.getCameraState()).toBe('idle')
14
- })
15
-
16
- it('becomes moving when the camera changes via setCamera', () => {
17
- expect(editor.getCameraState()).toBe('idle')
18
- editor.setCamera({ x: 100, y: 100, z: 1 })
19
- expect(editor.getCameraState()).toBe('moving')
20
- })
21
-
22
- it('becomes moving when the camera changes via pan', () => {
23
- expect(editor.getCameraState()).toBe('idle')
24
- editor.pan({ x: 100, y: 100 })
25
- expect(editor.getCameraState()).toBe('moving')
26
- })
27
-
28
- it('becomes moving when the camera changes via zoomIn', () => {
29
- expect(editor.getCameraState()).toBe('idle')
30
- editor.zoomIn(undefined, { immediate: true })
31
- expect(editor.getCameraState()).toBe('moving')
32
- })
33
-
34
- it('returns to idle after the timeout elapses', () => {
35
- expect(editor.getCameraState()).toBe('idle')
36
- editor.setCamera({ x: 100, y: 100, z: 1 })
37
- expect(editor.getCameraState()).toBe('moving')
38
-
39
- // The default timeout is 64ms (options.cameraMovingTimeoutMs)
40
- // Each tick is 16ms, so we need ~4 ticks to elapse
41
- editor.forceTick(5)
42
- expect(editor.getCameraState()).toBe('idle')
43
- })
44
-
45
- it('stays moving while camera continues to change', () => {
46
- expect(editor.getCameraState()).toBe('idle')
47
- editor.setCamera({ x: 100, y: 100, z: 1 })
48
- expect(editor.getCameraState()).toBe('moving')
49
-
50
- // Move again before timeout elapses
51
- editor.forceTick(2)
52
- editor.setCamera({ x: 200, y: 200, z: 1 })
53
- expect(editor.getCameraState()).toBe('moving')
54
-
55
- // Move again
56
- editor.forceTick(2)
57
- editor.setCamera({ x: 300, y: 300, z: 1 })
58
- expect(editor.getCameraState()).toBe('moving')
59
-
60
- // Now let it settle
61
- editor.forceTick(5)
62
- expect(editor.getCameraState()).toBe('idle')
63
- })
64
-
65
- it('stays idle when camera position does not actually change', () => {
66
- expect(editor.getCameraState()).toBe('idle')
67
-
68
- // Setting the same camera position should not trigger moving state
69
- const currentCamera = editor.getCamera()
70
- editor.setCamera({ x: currentCamera.x, y: currentCamera.y, z: currentCamera.z })
71
- expect(editor.getCameraState()).toBe('idle')
72
- })
73
-
74
- it('does not add multiple tick listeners when camera changes rapidly', () => {
75
- // This test verifies the fix: we should not have redundant listeners
76
- expect(editor.getCameraState()).toBe('idle')
77
-
78
- // Change camera multiple times rapidly
79
- editor.setCamera({ x: 100, y: 100, z: 1 })
80
- editor.setCamera({ x: 200, y: 200, z: 1 })
81
- editor.setCamera({ x: 300, y: 300, z: 1 })
82
-
83
- expect(editor.getCameraState()).toBe('moving')
84
-
85
- // After timeout, should return to idle exactly once
86
- // If there were multiple listeners, the state might behave unexpectedly
87
- editor.forceTick(5)
88
- expect(editor.getCameraState()).toBe('idle')
89
- })
90
-
91
- it('resets timeout when camera changes while already moving', () => {
92
- expect(editor.getCameraState()).toBe('idle')
93
- editor.setCamera({ x: 100, y: 100, z: 1 })
94
- expect(editor.getCameraState()).toBe('moving')
95
-
96
- // Wait almost until timeout
97
- editor.forceTick(3)
98
- expect(editor.getCameraState()).toBe('moving')
99
-
100
- // Change camera again - should reset timeout
101
- editor.setCamera({ x: 200, y: 200, z: 1 })
102
- expect(editor.getCameraState()).toBe('moving')
103
-
104
- // Wait 3 more ticks - would have been idle if timeout wasn't reset
105
- editor.forceTick(3)
106
- expect(editor.getCameraState()).toBe('moving')
107
-
108
- // Now let it fully settle
109
- editor.forceTick(3)
110
- expect(editor.getCameraState()).toBe('idle')
111
- })
112
- })
113
-
114
- describe('camera state with zoom', () => {
115
- it('becomes moving on zoomOut', () => {
116
- expect(editor.getCameraState()).toBe('idle')
117
- editor.zoomOut(undefined, { immediate: true })
118
- expect(editor.getCameraState()).toBe('moving')
119
- })
120
-
121
- it('becomes moving on centerOnPoint', () => {
122
- expect(editor.getCameraState()).toBe('idle')
123
- editor.centerOnPoint({ x: 500, y: 500 })
124
- expect(editor.getCameraState()).toBe('moving')
125
- })
126
-
127
- it('becomes moving on zoomToFit', () => {
128
- // Create a shape so zoomToFit has something to fit
129
- editor.createShape({ type: 'geo', x: 100, y: 100, props: { w: 200, h: 200 } })
130
- expect(editor.getCameraState()).toBe('idle')
131
- editor.zoomToFit({ immediate: true })
132
- expect(editor.getCameraState()).toBe('moving')
133
- })
134
- })
135
-
136
- describe('getDebouncedZoomLevel', () => {
137
- it('returns the current zoom level when camera is idle', () => {
138
- expect(editor.getCameraState()).toBe('idle')
139
- expect(editor.getDebouncedZoomLevel()).toBe(editor.getZoomLevel())
140
-
141
- // Change zoom and let it settle
142
- editor.zoomIn(undefined, { immediate: true })
143
- editor.forceTick(5)
144
- expect(editor.getCameraState()).toBe('idle')
145
- expect(editor.getDebouncedZoomLevel()).toBe(editor.getZoomLevel())
146
- })
147
-
148
- it('captures zoom when camera starts moving', () => {
149
- expect(editor.getCameraState()).toBe('idle')
150
-
151
- // Start zooming - the debounced zoom is captured when movement starts
152
- editor.zoomIn(undefined, { immediate: true })
153
- expect(editor.getCameraState()).toBe('moving')
154
-
155
- // The debounced zoom is captured at the moment movement starts (after first change)
156
- const capturedZoom = editor.getDebouncedZoomLevel()
157
- expect(capturedZoom).toBe(editor.getZoomLevel())
158
- })
159
-
160
- it('keeps captured zoom during continued camera movement', () => {
161
- // Start zooming
162
- editor.zoomIn(undefined, { immediate: true })
163
- const capturedZoom = editor.getDebouncedZoomLevel()
164
- expect(editor.getCameraState()).toBe('moving')
165
-
166
- // Zoom again while still moving - debounced value should stay the same
167
- editor.zoomIn(undefined, { immediate: true })
168
- expect(editor.getCameraState()).toBe('moving')
169
- expect(editor.getDebouncedZoomLevel()).toBe(capturedZoom)
170
-
171
- // But current zoom should have changed
172
- expect(editor.getZoomLevel()).not.toBe(capturedZoom)
173
- })
174
-
175
- it('updates debounced zoom when camera becomes idle again', () => {
176
- // Start zooming
177
- editor.zoomIn(undefined, { immediate: true })
178
- const capturedZoom = editor.getDebouncedZoomLevel()
179
-
180
- // Zoom again while moving to change the current zoom
181
- editor.zoomIn(undefined, { immediate: true })
182
- expect(editor.getDebouncedZoomLevel()).toBe(capturedZoom)
183
-
184
- // Let camera settle
185
- editor.forceTick(5)
186
- expect(editor.getCameraState()).toBe('idle')
187
-
188
- // Debounced zoom should now match current zoom
189
- expect(editor.getDebouncedZoomLevel()).toBe(editor.getZoomLevel())
190
- })
191
-
192
- it('captures new zoom at the start of each new movement', () => {
193
- // First zoom and settle
194
- editor.zoomIn(undefined, { immediate: true })
195
- const firstCapturedZoom = editor.getDebouncedZoomLevel()
196
- editor.forceTick(5)
197
- expect(editor.getCameraState()).toBe('idle')
198
-
199
- // Second zoom - should capture new zoom level
200
- editor.zoomIn(undefined, { immediate: true })
201
- expect(editor.getCameraState()).toBe('moving')
202
- // The captured zoom should be different from the first capture
203
- expect(editor.getDebouncedZoomLevel()).not.toBe(firstCapturedZoom)
204
- // And it should match the current zoom (since we just started moving)
205
- expect(editor.getDebouncedZoomLevel()).toBe(editor.getZoomLevel())
206
- })
207
-
208
- describe('with debouncedZoom option disabled', () => {
209
- let editorWithoutDebouncedZoom: TestEditor
210
-
211
- beforeEach(() => {
212
- editorWithoutDebouncedZoom = new TestEditor({
213
- options: { debouncedZoom: false },
214
- })
215
- editorWithoutDebouncedZoom.updateViewportScreenBounds(new Box(0, 0, 1600, 900))
216
- })
217
-
218
- it('always returns the current zoom level even when camera is moving', () => {
219
- const initialZoom = editorWithoutDebouncedZoom.getZoomLevel()
220
-
221
- editorWithoutDebouncedZoom.zoomIn(undefined, { immediate: true })
222
- expect(editorWithoutDebouncedZoom.getCameraState()).toBe('moving')
223
-
224
- // Should return the current zoom, not the captured one
225
- expect(editorWithoutDebouncedZoom.getDebouncedZoomLevel()).toBe(
226
- editorWithoutDebouncedZoom.getZoomLevel()
227
- )
228
- expect(editorWithoutDebouncedZoom.getDebouncedZoomLevel()).not.toBe(initialZoom)
229
- })
230
- })
231
- })
232
-
233
- describe('getEfficientZoomLevel', () => {
234
- it('returns current zoom level when below shape threshold', () => {
235
- // Default threshold is 500 shapes, we have 0
236
- expect(editor.getZoomLevel()).toBe(editor.getEfficientZoomLevel())
237
-
238
- // Add a few shapes - still below threshold
239
- for (let i = 0; i < 10; i++) {
240
- editor.createShape({ type: 'geo', x: i * 100, y: 0, props: { w: 50, h: 50 } })
241
- }
242
- expect(editor.getCurrentPageShapeIds().size).toBe(10)
243
-
244
- // Start zooming
245
- editor.zoomIn(undefined, { immediate: true })
246
- expect(editor.getCameraState()).toBe('moving')
247
-
248
- // Should still return current zoom because we're below threshold
249
- expect(editor.getEfficientZoomLevel()).toBe(editor.getZoomLevel())
250
- })
251
-
252
- describe('with many shapes above threshold', () => {
253
- let editorWithManyShapes: TestEditor
254
-
255
- beforeEach(() => {
256
- // Use a lower threshold for testing
257
- editorWithManyShapes = new TestEditor({
258
- options: { debouncedZoomThreshold: 5 },
259
- })
260
- editorWithManyShapes.updateViewportScreenBounds(new Box(0, 0, 1600, 900))
261
-
262
- // Add shapes above the threshold
263
- for (let i = 0; i < 10; i++) {
264
- editorWithManyShapes.createShape({
265
- type: 'geo',
266
- x: i * 100,
267
- y: 0,
268
- props: { w: 50, h: 50 },
269
- })
270
- }
271
- })
272
-
273
- it('returns debounced zoom level when above shape threshold and camera is moving', () => {
274
- // First zoom to capture a debounced value
275
- editorWithManyShapes.zoomIn(undefined, { immediate: true })
276
- const capturedZoom = editorWithManyShapes.getEfficientZoomLevel()
277
- expect(editorWithManyShapes.getCameraState()).toBe('moving')
278
-
279
- // Zoom again while still moving
280
- editorWithManyShapes.zoomIn(undefined, { immediate: true })
281
- expect(editorWithManyShapes.getCameraState()).toBe('moving')
282
-
283
- // Should return the captured zoom, not the current zoom
284
- expect(editorWithManyShapes.getEfficientZoomLevel()).toBe(capturedZoom)
285
- expect(editorWithManyShapes.getEfficientZoomLevel()).not.toBe(
286
- editorWithManyShapes.getZoomLevel()
287
- )
288
- })
289
-
290
- it('returns current zoom level when above threshold but camera is idle', () => {
291
- editorWithManyShapes.zoomIn(undefined, { immediate: true })
292
- editorWithManyShapes.forceTick(5)
293
- expect(editorWithManyShapes.getCameraState()).toBe('idle')
294
-
295
- // Should return current zoom because camera is idle
296
- expect(editorWithManyShapes.getEfficientZoomLevel()).toBe(editorWithManyShapes.getZoomLevel())
297
- })
298
- })
299
- })