tldraw 3.16.0-canary.d04b7fc312b4 → 3.16.0-canary.d354cc4340c1

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 (390) hide show
  1. package/dist-cjs/index.d.ts +316 -110
  2. package/dist-cjs/index.js +37 -14
  3. package/dist-cjs/index.js.map +2 -2
  4. package/dist-cjs/lib/Tldraw.js +12 -2
  5. package/dist-cjs/lib/Tldraw.js.map +2 -2
  6. package/dist-cjs/lib/defaultExternalContentHandlers.js +15 -4
  7. package/dist-cjs/lib/defaultExternalContentHandlers.js.map +2 -2
  8. package/dist-cjs/lib/shapes/arrow/arrow-types.js.map +1 -1
  9. package/dist-cjs/lib/shapes/arrow/arrowLabel.js +6 -0
  10. package/dist-cjs/lib/shapes/arrow/arrowLabel.js.map +3 -3
  11. package/dist-cjs/lib/shapes/arrow/arrowTargetState.js +3 -2
  12. package/dist-cjs/lib/shapes/arrow/arrowTargetState.js.map +2 -2
  13. package/dist-cjs/lib/shapes/arrow/toolStates/Pointing.js +1 -1
  14. package/dist-cjs/lib/shapes/arrow/toolStates/Pointing.js.map +2 -2
  15. package/dist-cjs/lib/shapes/bookmark/BookmarkShapeUtil.js +4 -4
  16. package/dist-cjs/lib/shapes/bookmark/BookmarkShapeUtil.js.map +2 -2
  17. package/dist-cjs/lib/shapes/frame/FrameShapeUtil.js +8 -1
  18. package/dist-cjs/lib/shapes/frame/FrameShapeUtil.js.map +2 -2
  19. package/dist-cjs/lib/shapes/frame/components/FrameLabelInput.js +8 -2
  20. package/dist-cjs/lib/shapes/frame/components/FrameLabelInput.js.map +2 -2
  21. package/dist-cjs/lib/shapes/geo/GeoShapeUtil.js +1 -0
  22. package/dist-cjs/lib/shapes/geo/GeoShapeUtil.js.map +2 -2
  23. package/dist-cjs/lib/shapes/image/ImageShapeUtil.js +3 -0
  24. package/dist-cjs/lib/shapes/image/ImageShapeUtil.js.map +2 -2
  25. package/dist-cjs/lib/shapes/note/NoteShapeUtil.js +2 -1
  26. package/dist-cjs/lib/shapes/note/NoteShapeUtil.js.map +2 -2
  27. package/dist-cjs/lib/shapes/shared/HyperlinkButton.js +4 -4
  28. package/dist-cjs/lib/shapes/shared/HyperlinkButton.js.map +2 -2
  29. package/dist-cjs/lib/shapes/shared/PlainTextLabel.js +1 -3
  30. package/dist-cjs/lib/shapes/shared/PlainTextLabel.js.map +2 -2
  31. package/dist-cjs/lib/shapes/shared/freehand/svg.js.map +2 -2
  32. package/dist-cjs/lib/shapes/shared/useEditablePlainText.js +3 -5
  33. package/dist-cjs/lib/shapes/shared/useEditablePlainText.js.map +2 -2
  34. package/dist-cjs/lib/shapes/shared/useImageOrVideoAsset.js +0 -2
  35. package/dist-cjs/lib/shapes/shared/useImageOrVideoAsset.js.map +2 -2
  36. package/dist-cjs/lib/shapes/text/PlainTextArea.js +3 -2
  37. package/dist-cjs/lib/shapes/text/PlainTextArea.js.map +2 -2
  38. package/dist-cjs/lib/shapes/text/RichTextArea.js +3 -3
  39. package/dist-cjs/lib/shapes/text/RichTextArea.js.map +2 -2
  40. package/dist-cjs/lib/tools/EraserTool/childStates/Erasing.js +25 -1
  41. package/dist-cjs/lib/tools/EraserTool/childStates/Erasing.js.map +2 -2
  42. package/dist-cjs/lib/tools/EraserTool/childStates/Pointing.js +12 -0
  43. package/dist-cjs/lib/tools/EraserTool/childStates/Pointing.js.map +2 -2
  44. package/dist-cjs/lib/tools/SelectTool/childStates/DraggingHandle.js +3 -1
  45. package/dist-cjs/lib/tools/SelectTool/childStates/DraggingHandle.js.map +2 -2
  46. package/dist-cjs/lib/ui/TldrawUi.js +13 -12
  47. package/dist-cjs/lib/ui/TldrawUi.js.map +2 -2
  48. package/dist-cjs/lib/ui/assetUrls.js +13 -10
  49. package/dist-cjs/lib/ui/assetUrls.js.map +2 -2
  50. package/dist-cjs/lib/ui/components/A11y.js +1 -1
  51. package/dist-cjs/lib/ui/components/A11y.js.map +2 -2
  52. package/dist-cjs/lib/ui/components/{FollowingIndicator.js → DefaultFollowingIndicator.js} +6 -6
  53. package/dist-cjs/lib/ui/components/DefaultFollowingIndicator.js.map +7 -0
  54. package/dist-cjs/lib/ui/components/KeyboardShortcutsDialog/DefaultKeyboardShortcutsDialogContent.js +6 -6
  55. package/dist-cjs/lib/ui/components/KeyboardShortcutsDialog/DefaultKeyboardShortcutsDialogContent.js.map +1 -1
  56. package/dist-cjs/lib/ui/components/LanguageMenu.js +1 -0
  57. package/dist-cjs/lib/ui/components/LanguageMenu.js.map +2 -2
  58. package/dist-cjs/lib/ui/components/Minimap/DefaultMinimap.js +2 -1
  59. package/dist-cjs/lib/ui/components/Minimap/DefaultMinimap.js.map +2 -2
  60. package/dist-cjs/lib/ui/components/PageMenu/DefaultPageMenu.js +1 -1
  61. package/dist-cjs/lib/ui/components/PageMenu/DefaultPageMenu.js.map +2 -2
  62. package/dist-cjs/lib/ui/components/StylePanel/DefaultStylePanel.js +9 -4
  63. package/dist-cjs/lib/ui/components/StylePanel/DefaultStylePanel.js.map +2 -2
  64. package/dist-cjs/lib/ui/components/StylePanel/DefaultStylePanelContent.js +255 -316
  65. package/dist-cjs/lib/ui/components/StylePanel/DefaultStylePanelContent.js.map +2 -2
  66. package/dist-cjs/lib/ui/components/StylePanel/StylePanelButtonPicker.js +147 -0
  67. package/dist-cjs/lib/ui/components/StylePanel/StylePanelButtonPicker.js.map +7 -0
  68. package/dist-cjs/lib/ui/components/StylePanel/StylePanelContext.js +68 -0
  69. package/dist-cjs/lib/ui/components/StylePanel/StylePanelContext.js.map +7 -0
  70. package/dist-cjs/lib/ui/components/StylePanel/{DoubleDropdownPicker.js → StylePanelDoubleDropdownPicker.js} +23 -22
  71. package/dist-cjs/lib/ui/components/StylePanel/StylePanelDoubleDropdownPicker.js.map +7 -0
  72. package/dist-cjs/lib/ui/components/StylePanel/{DropdownPicker.js → StylePanelDropdownPicker.js} +24 -21
  73. package/dist-cjs/lib/ui/components/StylePanel/StylePanelDropdownPicker.js.map +7 -0
  74. package/dist-cjs/lib/ui/components/StylePanel/StylePanelSubheading.js +28 -0
  75. package/dist-cjs/lib/ui/components/StylePanel/StylePanelSubheading.js.map +7 -0
  76. package/dist-cjs/lib/ui/components/Toolbar/AltTextEditor.js +2 -0
  77. package/dist-cjs/lib/ui/components/Toolbar/AltTextEditor.js.map +2 -2
  78. package/dist-cjs/lib/ui/components/Toolbar/DefaultImageToolbarContent.js +38 -9
  79. package/dist-cjs/lib/ui/components/Toolbar/DefaultImageToolbarContent.js.map +2 -2
  80. package/dist-cjs/lib/ui/components/Toolbar/DefaultVideoToolbarContent.js +15 -3
  81. package/dist-cjs/lib/ui/components/Toolbar/DefaultVideoToolbarContent.js.map +2 -2
  82. package/dist-cjs/lib/ui/components/Toolbar/LinkEditor.js +2 -1
  83. package/dist-cjs/lib/ui/components/Toolbar/LinkEditor.js.map +2 -2
  84. package/dist-cjs/lib/ui/components/Toolbar/OverflowingToolbar.js +1 -1
  85. package/dist-cjs/lib/ui/components/Toolbar/OverflowingToolbar.js.map +2 -2
  86. package/dist-cjs/lib/ui/components/Toolbar/ToggleToolLockedButton.js +6 -2
  87. package/dist-cjs/lib/ui/components/Toolbar/ToggleToolLockedButton.js.map +2 -2
  88. package/dist-cjs/lib/ui/components/primitives/TldrawUiContextualToolbar.js +11 -2
  89. package/dist-cjs/lib/ui/components/primitives/TldrawUiContextualToolbar.js.map +2 -2
  90. package/dist-cjs/lib/ui/components/primitives/TldrawUiInput.js +5 -3
  91. package/dist-cjs/lib/ui/components/primitives/TldrawUiInput.js.map +2 -2
  92. package/dist-cjs/lib/ui/components/primitives/TldrawUiSlider.js +18 -5
  93. package/dist-cjs/lib/ui/components/primitives/TldrawUiSlider.js.map +2 -2
  94. package/dist-cjs/lib/ui/components/primitives/TldrawUiToolbar.js +3 -0
  95. package/dist-cjs/lib/ui/components/primitives/TldrawUiToolbar.js.map +2 -2
  96. package/dist-cjs/lib/ui/components/primitives/TldrawUiTooltip.js +89 -40
  97. package/dist-cjs/lib/ui/components/primitives/TldrawUiTooltip.js.map +2 -2
  98. package/dist-cjs/lib/ui/components/primitives/menus/TldrawUiMenuCheckboxItem.js +3 -0
  99. package/dist-cjs/lib/ui/components/primitives/menus/TldrawUiMenuCheckboxItem.js.map +2 -2
  100. package/dist-cjs/lib/ui/components/primitives/menus/TldrawUiMenuItem.js +10 -9
  101. package/dist-cjs/lib/ui/components/primitives/menus/TldrawUiMenuItem.js.map +2 -2
  102. package/dist-cjs/lib/ui/context/actions.js +29 -10
  103. package/dist-cjs/lib/ui/context/actions.js.map +2 -2
  104. package/dist-cjs/lib/ui/context/components.js +2 -0
  105. package/dist-cjs/lib/ui/context/components.js.map +2 -2
  106. package/dist-cjs/lib/ui/context/events.js.map +1 -1
  107. package/dist-cjs/lib/ui/hooks/useClipboardEvents.js +1 -1
  108. package/dist-cjs/lib/ui/hooks/useClipboardEvents.js.map +2 -2
  109. package/dist-cjs/lib/ui/hooks/useExportAs.js +3 -2
  110. package/dist-cjs/lib/ui/hooks/useExportAs.js.map +2 -2
  111. package/dist-cjs/lib/ui/hooks/useTools.js +1 -1
  112. package/dist-cjs/lib/ui/hooks/useTools.js.map +2 -2
  113. package/dist-cjs/lib/ui/hooks/useTranslation/TLUiTranslationKey.js.map +1 -1
  114. package/dist-cjs/lib/ui/hooks/useTranslation/defaultTranslation.js +6 -2
  115. package/dist-cjs/lib/ui/hooks/useTranslation/defaultTranslation.js.map +2 -2
  116. package/dist-cjs/lib/ui/kbd-utils.js +9 -3
  117. package/dist-cjs/lib/ui/kbd-utils.js.map +2 -2
  118. package/dist-cjs/lib/ui/version.js +3 -3
  119. package/dist-cjs/lib/ui/version.js.map +1 -1
  120. package/dist-cjs/lib/utils/export/copyAs.js +1 -2
  121. package/dist-cjs/lib/utils/export/copyAs.js.map +2 -2
  122. package/dist-cjs/lib/utils/export/export.js +0 -20
  123. package/dist-cjs/lib/utils/export/export.js.map +2 -2
  124. package/dist-cjs/lib/utils/export/exportAs.js +1 -2
  125. package/dist-cjs/lib/utils/export/exportAs.js.map +2 -2
  126. package/dist-esm/index.d.mts +316 -110
  127. package/dist-esm/index.mjs +69 -29
  128. package/dist-esm/index.mjs.map +2 -2
  129. package/dist-esm/lib/Tldraw.mjs +14 -4
  130. package/dist-esm/lib/Tldraw.mjs.map +2 -2
  131. package/dist-esm/lib/defaultExternalContentHandlers.mjs +15 -4
  132. package/dist-esm/lib/defaultExternalContentHandlers.mjs.map +2 -2
  133. package/dist-esm/lib/shapes/arrow/arrowLabel.mjs +6 -0
  134. package/dist-esm/lib/shapes/arrow/arrowLabel.mjs.map +3 -3
  135. package/dist-esm/lib/shapes/arrow/arrowTargetState.mjs +3 -2
  136. package/dist-esm/lib/shapes/arrow/arrowTargetState.mjs.map +2 -2
  137. package/dist-esm/lib/shapes/arrow/toolStates/Pointing.mjs +1 -1
  138. package/dist-esm/lib/shapes/arrow/toolStates/Pointing.mjs.map +2 -2
  139. package/dist-esm/lib/shapes/bookmark/BookmarkShapeUtil.mjs +4 -5
  140. package/dist-esm/lib/shapes/bookmark/BookmarkShapeUtil.mjs.map +2 -2
  141. package/dist-esm/lib/shapes/frame/FrameShapeUtil.mjs +8 -1
  142. package/dist-esm/lib/shapes/frame/FrameShapeUtil.mjs.map +2 -2
  143. package/dist-esm/lib/shapes/frame/components/FrameLabelInput.mjs +9 -3
  144. package/dist-esm/lib/shapes/frame/components/FrameLabelInput.mjs.map +2 -2
  145. package/dist-esm/lib/shapes/geo/GeoShapeUtil.mjs +1 -0
  146. package/dist-esm/lib/shapes/geo/GeoShapeUtil.mjs.map +2 -2
  147. package/dist-esm/lib/shapes/image/ImageShapeUtil.mjs +3 -0
  148. package/dist-esm/lib/shapes/image/ImageShapeUtil.mjs.map +2 -2
  149. package/dist-esm/lib/shapes/note/NoteShapeUtil.mjs +2 -1
  150. package/dist-esm/lib/shapes/note/NoteShapeUtil.mjs.map +2 -2
  151. package/dist-esm/lib/shapes/shared/HyperlinkButton.mjs +5 -5
  152. package/dist-esm/lib/shapes/shared/HyperlinkButton.mjs.map +2 -2
  153. package/dist-esm/lib/shapes/shared/PlainTextLabel.mjs +1 -3
  154. package/dist-esm/lib/shapes/shared/PlainTextLabel.mjs.map +2 -2
  155. package/dist-esm/lib/shapes/shared/freehand/svg.mjs.map +2 -2
  156. package/dist-esm/lib/shapes/shared/useEditablePlainText.mjs +3 -6
  157. package/dist-esm/lib/shapes/shared/useEditablePlainText.mjs.map +2 -2
  158. package/dist-esm/lib/shapes/shared/useImageOrVideoAsset.mjs +0 -2
  159. package/dist-esm/lib/shapes/shared/useImageOrVideoAsset.mjs.map +2 -2
  160. package/dist-esm/lib/shapes/text/PlainTextArea.mjs +4 -3
  161. package/dist-esm/lib/shapes/text/PlainTextArea.mjs.map +2 -2
  162. package/dist-esm/lib/shapes/text/RichTextArea.mjs +3 -4
  163. package/dist-esm/lib/shapes/text/RichTextArea.mjs.map +2 -2
  164. package/dist-esm/lib/tools/EraserTool/childStates/Erasing.mjs +26 -1
  165. package/dist-esm/lib/tools/EraserTool/childStates/Erasing.mjs.map +2 -2
  166. package/dist-esm/lib/tools/EraserTool/childStates/Pointing.mjs +13 -0
  167. package/dist-esm/lib/tools/EraserTool/childStates/Pointing.mjs.map +2 -2
  168. package/dist-esm/lib/tools/SelectTool/childStates/DraggingHandle.mjs +3 -1
  169. package/dist-esm/lib/tools/SelectTool/childStates/DraggingHandle.mjs.map +2 -2
  170. package/dist-esm/lib/ui/TldrawUi.mjs +13 -12
  171. package/dist-esm/lib/ui/TldrawUi.mjs.map +2 -2
  172. package/dist-esm/lib/ui/assetUrls.mjs +13 -10
  173. package/dist-esm/lib/ui/assetUrls.mjs.map +2 -2
  174. package/dist-esm/lib/ui/components/A11y.mjs +1 -2
  175. package/dist-esm/lib/ui/components/A11y.mjs.map +2 -2
  176. package/dist-esm/lib/ui/components/{FollowingIndicator.mjs → DefaultFollowingIndicator.mjs} +3 -3
  177. package/dist-esm/lib/ui/components/DefaultFollowingIndicator.mjs.map +7 -0
  178. package/dist-esm/lib/ui/components/KeyboardShortcutsDialog/DefaultKeyboardShortcutsDialogContent.mjs +6 -6
  179. package/dist-esm/lib/ui/components/KeyboardShortcutsDialog/DefaultKeyboardShortcutsDialogContent.mjs.map +1 -1
  180. package/dist-esm/lib/ui/components/LanguageMenu.mjs +1 -0
  181. package/dist-esm/lib/ui/components/LanguageMenu.mjs.map +2 -2
  182. package/dist-esm/lib/ui/components/Minimap/DefaultMinimap.mjs +2 -1
  183. package/dist-esm/lib/ui/components/Minimap/DefaultMinimap.mjs.map +2 -2
  184. package/dist-esm/lib/ui/components/PageMenu/DefaultPageMenu.mjs +1 -2
  185. package/dist-esm/lib/ui/components/PageMenu/DefaultPageMenu.mjs.map +2 -2
  186. package/dist-esm/lib/ui/components/StylePanel/DefaultStylePanel.mjs +14 -5
  187. package/dist-esm/lib/ui/components/StylePanel/DefaultStylePanel.mjs.map +2 -2
  188. package/dist-esm/lib/ui/components/StylePanel/DefaultStylePanelContent.mjs +257 -320
  189. package/dist-esm/lib/ui/components/StylePanel/DefaultStylePanelContent.mjs.map +2 -2
  190. package/dist-esm/lib/ui/components/StylePanel/StylePanelButtonPicker.mjs +135 -0
  191. package/dist-esm/lib/ui/components/StylePanel/StylePanelButtonPicker.mjs.map +7 -0
  192. package/dist-esm/lib/ui/components/StylePanel/StylePanelContext.mjs +48 -0
  193. package/dist-esm/lib/ui/components/StylePanel/StylePanelContext.mjs.map +7 -0
  194. package/dist-esm/lib/ui/components/StylePanel/{DoubleDropdownPicker.mjs → StylePanelDoubleDropdownPicker.mjs} +20 -19
  195. package/dist-esm/lib/ui/components/StylePanel/StylePanelDoubleDropdownPicker.mjs.map +7 -0
  196. package/dist-esm/lib/ui/components/StylePanel/{DropdownPicker.mjs → StylePanelDropdownPicker.mjs} +21 -18
  197. package/dist-esm/lib/ui/components/StylePanel/StylePanelDropdownPicker.mjs.map +7 -0
  198. package/dist-esm/lib/ui/components/StylePanel/StylePanelSubheading.mjs +8 -0
  199. package/dist-esm/lib/ui/components/StylePanel/StylePanelSubheading.mjs.map +7 -0
  200. package/dist-esm/lib/ui/components/Toolbar/AltTextEditor.mjs +2 -0
  201. package/dist-esm/lib/ui/components/Toolbar/AltTextEditor.mjs.map +2 -2
  202. package/dist-esm/lib/ui/components/Toolbar/DefaultImageToolbarContent.mjs +38 -9
  203. package/dist-esm/lib/ui/components/Toolbar/DefaultImageToolbarContent.mjs.map +2 -2
  204. package/dist-esm/lib/ui/components/Toolbar/DefaultVideoToolbarContent.mjs +15 -3
  205. package/dist-esm/lib/ui/components/Toolbar/DefaultVideoToolbarContent.mjs.map +2 -2
  206. package/dist-esm/lib/ui/components/Toolbar/LinkEditor.mjs +2 -1
  207. package/dist-esm/lib/ui/components/Toolbar/LinkEditor.mjs.map +2 -2
  208. package/dist-esm/lib/ui/components/Toolbar/OverflowingToolbar.mjs +1 -1
  209. package/dist-esm/lib/ui/components/Toolbar/OverflowingToolbar.mjs.map +2 -2
  210. package/dist-esm/lib/ui/components/Toolbar/ToggleToolLockedButton.mjs +6 -2
  211. package/dist-esm/lib/ui/components/Toolbar/ToggleToolLockedButton.mjs.map +2 -2
  212. package/dist-esm/lib/ui/components/primitives/TldrawUiContextualToolbar.mjs +11 -3
  213. package/dist-esm/lib/ui/components/primitives/TldrawUiContextualToolbar.mjs.map +2 -2
  214. package/dist-esm/lib/ui/components/primitives/TldrawUiInput.mjs +6 -4
  215. package/dist-esm/lib/ui/components/primitives/TldrawUiInput.mjs.map +2 -2
  216. package/dist-esm/lib/ui/components/primitives/TldrawUiSlider.mjs +18 -5
  217. package/dist-esm/lib/ui/components/primitives/TldrawUiSlider.mjs.map +2 -2
  218. package/dist-esm/lib/ui/components/primitives/TldrawUiToolbar.mjs +3 -0
  219. package/dist-esm/lib/ui/components/primitives/TldrawUiToolbar.mjs.map +2 -2
  220. package/dist-esm/lib/ui/components/primitives/TldrawUiTooltip.mjs +90 -40
  221. package/dist-esm/lib/ui/components/primitives/TldrawUiTooltip.mjs.map +2 -2
  222. package/dist-esm/lib/ui/components/primitives/menus/TldrawUiMenuCheckboxItem.mjs +3 -0
  223. package/dist-esm/lib/ui/components/primitives/menus/TldrawUiMenuCheckboxItem.mjs.map +2 -2
  224. package/dist-esm/lib/ui/components/primitives/menus/TldrawUiMenuItem.mjs +10 -9
  225. package/dist-esm/lib/ui/components/primitives/menus/TldrawUiMenuItem.mjs.map +2 -2
  226. package/dist-esm/lib/ui/context/actions.mjs +29 -10
  227. package/dist-esm/lib/ui/context/actions.mjs.map +2 -2
  228. package/dist-esm/lib/ui/context/components.mjs +2 -0
  229. package/dist-esm/lib/ui/context/components.mjs.map +2 -2
  230. package/dist-esm/lib/ui/context/events.mjs.map +1 -1
  231. package/dist-esm/lib/ui/hooks/useClipboardEvents.mjs +1 -2
  232. package/dist-esm/lib/ui/hooks/useClipboardEvents.mjs.map +2 -2
  233. package/dist-esm/lib/ui/hooks/useExportAs.mjs +3 -2
  234. package/dist-esm/lib/ui/hooks/useExportAs.mjs.map +2 -2
  235. package/dist-esm/lib/ui/hooks/useTools.mjs +1 -1
  236. package/dist-esm/lib/ui/hooks/useTools.mjs.map +2 -2
  237. package/dist-esm/lib/ui/hooks/useTranslation/defaultTranslation.mjs +6 -2
  238. package/dist-esm/lib/ui/hooks/useTranslation/defaultTranslation.mjs.map +2 -2
  239. package/dist-esm/lib/ui/kbd-utils.mjs +9 -3
  240. package/dist-esm/lib/ui/kbd-utils.mjs.map +2 -2
  241. package/dist-esm/lib/ui/version.mjs +3 -3
  242. package/dist-esm/lib/ui/version.mjs.map +1 -1
  243. package/dist-esm/lib/utils/export/copyAs.mjs +1 -2
  244. package/dist-esm/lib/utils/export/copyAs.mjs.map +2 -2
  245. package/dist-esm/lib/utils/export/export.mjs +0 -20
  246. package/dist-esm/lib/utils/export/export.mjs.map +2 -2
  247. package/dist-esm/lib/utils/export/exportAs.mjs +1 -2
  248. package/dist-esm/lib/utils/export/exportAs.mjs.map +2 -2
  249. package/package.json +11 -34
  250. package/src/index.ts +51 -22
  251. package/src/lib/Tldraw.tsx +15 -2
  252. package/src/lib/defaultExternalContentHandlers.ts +26 -4
  253. package/src/lib/shapes/arrow/ArrowShapeOptions.test.ts +85 -14
  254. package/src/lib/shapes/arrow/ArrowShapeTool.test.ts +103 -8
  255. package/src/lib/shapes/arrow/ArrowShapeUtil.test.ts +48 -6
  256. package/src/lib/shapes/arrow/arrow-types.ts +3 -5
  257. package/src/lib/shapes/arrow/arrowLabel.ts +8 -0
  258. package/src/lib/shapes/arrow/arrowTargetState.ts +34 -3
  259. package/src/lib/shapes/arrow/toolStates/Pointing.tsx +1 -1
  260. package/src/lib/shapes/bookmark/BookmarkShapeUtil.tsx +4 -5
  261. package/src/lib/shapes/draw/DrawShapeTool.test.ts +0 -5
  262. package/src/lib/shapes/frame/FrameShapeUtil.tsx +9 -0
  263. package/src/lib/shapes/frame/components/FrameLabelInput.tsx +10 -3
  264. package/src/lib/shapes/geo/GeoShapeUtil.tsx +1 -0
  265. package/src/lib/shapes/image/ImageShapeUtil.tsx +3 -0
  266. package/src/lib/shapes/line/LineShapeUtil.test.tsx +4 -3
  267. package/src/lib/shapes/line/__snapshots__/LineShapeUtil.test.tsx.snap +2 -2
  268. package/src/lib/shapes/note/NoteShapeUtil.tsx +1 -0
  269. package/src/lib/shapes/shared/HyperlinkButton.tsx +5 -5
  270. package/src/lib/shapes/shared/PlainTextLabel.tsx +0 -6
  271. package/src/lib/shapes/shared/freehand/svg.ts +2 -0
  272. package/src/lib/shapes/shared/useEditablePlainText.ts +3 -10
  273. package/src/lib/shapes/shared/useImageOrVideoAsset.ts +0 -7
  274. package/src/lib/shapes/text/PlainTextArea.tsx +4 -3
  275. package/src/lib/shapes/text/RichTextArea.tsx +3 -4
  276. package/src/lib/shapes/text/TextShapeTool.test.ts +6 -5
  277. package/src/lib/tools/EraserTool/childStates/Erasing.ts +34 -1
  278. package/src/lib/tools/EraserTool/childStates/Pointing.ts +20 -0
  279. package/src/lib/tools/SelectTool/childStates/DraggingHandle.tsx +6 -2
  280. package/src/lib/ui/TldrawUi.tsx +16 -10
  281. package/src/lib/ui/assetUrls.ts +13 -10
  282. package/src/lib/ui/components/A11y.tsx +1 -2
  283. package/src/lib/ui/components/{FollowingIndicator.tsx → DefaultFollowingIndicator.tsx} +2 -1
  284. package/src/lib/ui/components/KeyboardShortcutsDialog/DefaultKeyboardShortcutsDialogContent.tsx +6 -6
  285. package/src/lib/ui/components/LanguageMenu.tsx +1 -0
  286. package/src/lib/ui/components/Minimap/DefaultMinimap.tsx +2 -1
  287. package/src/lib/ui/components/PageMenu/DefaultPageMenu.tsx +1 -2
  288. package/src/lib/ui/components/StylePanel/DefaultStylePanel.tsx +27 -13
  289. package/src/lib/ui/components/StylePanel/DefaultStylePanelContent.tsx +260 -381
  290. package/src/lib/ui/components/{primitives/TldrawUiButtonPicker.tsx → StylePanel/StylePanelButtonPicker.tsx} +70 -50
  291. package/src/lib/ui/components/StylePanel/StylePanelContext.tsx +63 -0
  292. package/src/lib/ui/components/StylePanel/{DoubleDropdownPicker.tsx → StylePanelDoubleDropdownPicker.tsx} +28 -19
  293. package/src/lib/ui/components/StylePanel/StylePanelDropdownPicker.tsx +119 -0
  294. package/src/lib/ui/components/StylePanel/StylePanelSubheading.tsx +9 -0
  295. package/src/lib/ui/components/Toolbar/AltTextEditor.tsx +2 -0
  296. package/src/lib/ui/components/Toolbar/DefaultImageToolbarContent.tsx +32 -15
  297. package/src/lib/ui/components/Toolbar/DefaultVideoToolbarContent.tsx +12 -4
  298. package/src/lib/ui/components/Toolbar/LinkEditor.tsx +1 -0
  299. package/src/lib/ui/components/Toolbar/OverflowingToolbar.tsx +1 -1
  300. package/src/lib/ui/components/Toolbar/ToggleToolLockedButton.tsx +9 -2
  301. package/src/lib/ui/components/primitives/TldrawUiContextualToolbar.tsx +7 -3
  302. package/src/lib/ui/components/primitives/TldrawUiInput.tsx +6 -3
  303. package/src/lib/ui/components/primitives/TldrawUiSlider.tsx +52 -32
  304. package/src/lib/ui/components/primitives/TldrawUiToolbar.tsx +5 -1
  305. package/src/lib/ui/components/primitives/TldrawUiTooltip.tsx +99 -28
  306. package/src/lib/ui/components/primitives/menus/TldrawUiMenuCheckboxItem.tsx +4 -0
  307. package/src/lib/ui/components/primitives/menus/TldrawUiMenuItem.tsx +12 -11
  308. package/src/lib/ui/context/actions.tsx +36 -10
  309. package/src/lib/ui/context/components.tsx +3 -0
  310. package/src/lib/ui/context/events.tsx +1 -1
  311. package/src/lib/ui/hooks/useClipboardEvents.ts +1 -2
  312. package/src/lib/ui/hooks/useExportAs.ts +3 -2
  313. package/src/lib/ui/hooks/useTools.tsx +1 -1
  314. package/src/lib/ui/hooks/useTranslation/TLUiTranslationKey.ts +4 -0
  315. package/src/lib/ui/hooks/useTranslation/defaultTranslation.ts +6 -2
  316. package/src/lib/ui/kbd-utils.ts +10 -3
  317. package/src/lib/ui/version.ts +3 -3
  318. package/src/lib/ui.css +33 -2
  319. package/src/lib/utils/excalidraw/__snapshots__/putExcalidrawContent.test.tsx.snap +5 -5
  320. package/src/lib/utils/export/copyAs.ts +1 -24
  321. package/src/lib/utils/export/export.ts +0 -36
  322. package/src/lib/utils/export/exportAs.ts +1 -32
  323. package/src/lib/utils/tldr/__snapshots__/buildFromV1Document.test.ts.snap +4 -4
  324. package/src/test/A11y.test.tsx +3 -2
  325. package/src/test/ClickManager.test.ts +7 -6
  326. package/src/test/Editor.test.tsx +20 -19
  327. package/src/test/EraserTool.test.ts +184 -13
  328. package/src/test/HandTool.test.ts +10 -9
  329. package/src/test/HighlightShape.test.ts +2 -1
  330. package/src/test/SelectTool.test.ts +3 -2
  331. package/src/test/TLUserPreferences.test.ts +4 -3
  332. package/src/test/TestEditor.ts +21 -17
  333. package/src/test/TldrawEditor.test.tsx +11 -10
  334. package/src/test/ZoomTool.test.ts +7 -6
  335. package/src/test/__snapshots__/drawing.test.ts.snap +2 -2
  336. package/src/test/__snapshots__/groups.test.tsx.snap +6 -6
  337. package/src/test/__snapshots__/resizing.test.ts.snap +2 -2
  338. package/src/test/arrows-megabus.test.tsx +5 -4
  339. package/src/test/bindings.test.tsx +24 -37
  340. package/src/test/bookmark-shapes.test.ts +1 -8
  341. package/src/test/commands/__snapshots__/getSvgString.test.ts.snap +23 -7
  342. package/src/test/commands/__snapshots__/packShapes.test.ts.snap +8 -8
  343. package/src/test/commands/__snapshots__/zoomToFit.test.ts.snap +2 -2
  344. package/src/test/commands/alignShapes.test.tsx +25 -24
  345. package/src/test/commands/animationSpeed.test.ts +2 -1
  346. package/src/test/commands/centerOnPoint.test.ts +3 -2
  347. package/src/test/commands/clipboard.test.ts +3 -2
  348. package/src/test/commands/createShapes.test.ts +2 -1
  349. package/src/test/commands/deleteShapes.test.ts +2 -1
  350. package/src/test/commands/distributeShapes.test.tsx +11 -10
  351. package/src/test/commands/getSvgString.test.ts +2 -1
  352. package/src/test/commands/packShapes.test.ts +5 -4
  353. package/src/test/commands/resizeShape.test.ts +2 -1
  354. package/src/test/commands/rotateShapes.test.ts +7 -6
  355. package/src/test/commands/setCamera.test.ts +4 -3
  356. package/src/test/commands/setCurrentPage.test.ts +3 -2
  357. package/src/test/commands/stackShapes.test.ts +11 -10
  358. package/src/test/commands/stretch.test.tsx +13 -12
  359. package/src/test/createDeepLink.test.tsx +2 -1
  360. package/src/test/cropping.test.ts +3 -2
  361. package/src/test/custom-clipping.test.ts +436 -0
  362. package/src/test/drawing.test.ts +2 -1
  363. package/src/test/flipShapes.test.ts +4 -3
  364. package/src/test/frames.test.ts +25 -24
  365. package/src/test/getCulledShapes.test.tsx +74 -4
  366. package/src/test/groups.test.tsx +1 -1
  367. package/src/test/handleDeepLink.test.tsx +2 -1
  368. package/src/test/maxShapes.test.ts +3 -2
  369. package/src/test/modifiers.test.ts +5 -4
  370. package/src/test/navigation.test.ts +12 -11
  371. package/src/test/panning.test.ts +2 -1
  372. package/src/test/perf/perf.test.ts +2 -1
  373. package/src/test/registerDeepLinkListener.test.tsx +10 -9
  374. package/src/test/resizing.test.ts +39 -38
  375. package/src/test/select.test.tsx +4 -3
  376. package/src/test/selection-omnibus.test.ts +11 -10
  377. package/src/test/shapeutils.test.ts +4 -3
  378. package/src/test/translating.test.ts +9 -8
  379. package/tldraw.css +49 -5
  380. package/dist-cjs/lib/ui/components/FollowingIndicator.js.map +0 -7
  381. package/dist-cjs/lib/ui/components/StylePanel/DoubleDropdownPicker.js.map +0 -7
  382. package/dist-cjs/lib/ui/components/StylePanel/DropdownPicker.js.map +0 -7
  383. package/dist-cjs/lib/ui/components/primitives/TldrawUiButtonPicker.js +0 -131
  384. package/dist-cjs/lib/ui/components/primitives/TldrawUiButtonPicker.js.map +0 -7
  385. package/dist-esm/lib/ui/components/FollowingIndicator.mjs.map +0 -7
  386. package/dist-esm/lib/ui/components/StylePanel/DoubleDropdownPicker.mjs.map +0 -7
  387. package/dist-esm/lib/ui/components/StylePanel/DropdownPicker.mjs.map +0 -7
  388. package/dist-esm/lib/ui/components/primitives/TldrawUiButtonPicker.mjs +0 -115
  389. package/dist-esm/lib/ui/components/primitives/TldrawUiButtonPicker.mjs.map +0 -7
  390. package/src/lib/ui/components/StylePanel/DropdownPicker.tsx +0 -110
@@ -1,4 +1,5 @@
1
1
  import { TLArrowShape, createShapeId } from '@tldraw/editor'
2
+ import { vi } from 'vitest'
2
3
  import { TestEditor } from '../../../test/TestEditor'
3
4
  import { ArrowShapeUtil } from './ArrowShapeUtil'
4
5
  import { updateArrowTargetState } from './arrowTargetState'
@@ -12,7 +13,7 @@ const ids = {
12
13
  arrow1: createShapeId('arrow1'),
13
14
  }
14
15
 
15
- jest.useFakeTimers()
16
+ vi.useFakeTimers()
16
17
 
17
18
  window.requestAnimationFrame = function requestAnimationFrame(cb) {
18
19
  return setTimeout(cb, 1000 / 60)
@@ -46,13 +47,21 @@ describe('ArrowShapeOptions', () => {
46
47
  it('should have correct default shouldBeExact behavior (alt key)', () => {
47
48
  const util = editor.getShapeUtil<ArrowShapeUtil>('arrow')
48
49
 
49
- // Test without alt key
50
+ // Test without alt key, not precise
50
51
  editor.inputs.altKey = false
51
- expect(util.options.shouldBeExact(editor)).toBe(false)
52
+ expect(util.options.shouldBeExact(editor, false)).toBe(false)
52
53
 
53
- // Test with alt key
54
+ // Test without alt key, precise
55
+ editor.inputs.altKey = false
56
+ expect(util.options.shouldBeExact(editor, true)).toBe(false)
57
+
58
+ // Test with alt key, not precise
59
+ editor.inputs.altKey = true
60
+ expect(util.options.shouldBeExact(editor, false)).toBe(true)
61
+
62
+ // Test with alt key, precise
54
63
  editor.inputs.altKey = true
55
- expect(util.options.shouldBeExact(editor)).toBe(true)
64
+ expect(util.options.shouldBeExact(editor, true)).toBe(true)
56
65
  })
57
66
 
58
67
  it('should have correct default shouldIgnoreTargets behavior (ctrl key)', () => {
@@ -185,7 +194,7 @@ describe('ArrowShapeOptions', () => {
185
194
  class CustomArrowShapeUtil extends ArrowShapeUtil {
186
195
  override options = {
187
196
  ...baseUtil.options,
188
- shouldBeExact: (editor: any) => editor.inputs.shiftKey, // Use shift instead of alt
197
+ shouldBeExact: (editor: any, _isPrecise: boolean) => editor.inputs.shiftKey, // Use shift instead of alt
189
198
  }
190
199
  }
191
200
 
@@ -194,12 +203,14 @@ describe('ArrowShapeOptions', () => {
194
203
  // Test with shift key
195
204
  editor.inputs.shiftKey = true
196
205
  editor.inputs.altKey = false
197
- expect(customUtil.options.shouldBeExact(editor)).toBe(true)
206
+ expect(customUtil.options.shouldBeExact(editor, false)).toBe(true)
207
+ expect(customUtil.options.shouldBeExact(editor, true)).toBe(true)
198
208
 
199
209
  // Test without shift key
200
210
  editor.inputs.shiftKey = false
201
211
  editor.inputs.altKey = true // Alt key should not matter for custom implementation
202
- expect(customUtil.options.shouldBeExact(editor)).toBe(false)
212
+ expect(customUtil.options.shouldBeExact(editor, false)).toBe(false)
213
+ expect(customUtil.options.shouldBeExact(editor, true)).toBe(false)
203
214
  })
204
215
 
205
216
  it('should allow customizing shouldIgnoreTargets behavior', () => {
@@ -231,9 +242,9 @@ describe('ArrowShapeOptions', () => {
231
242
  class CustomArrowShapeUtil extends ArrowShapeUtil {
232
243
  override options = {
233
244
  ...baseUtil.options,
234
- shouldBeExact: (editor: any) => {
235
- // Custom logic: exact when both alt and shift are pressed
236
- return editor.inputs.altKey && editor.inputs.shiftKey
245
+ shouldBeExact: (editor: any, isPrecise: boolean) => {
246
+ // Custom logic: exact when both alt and shift are pressed, and only if precise
247
+ return editor.inputs.altKey && editor.inputs.shiftKey && isPrecise
237
248
  },
238
249
  shouldIgnoreTargets: (editor: any) => {
239
250
  // Custom logic: ignore targets when any modifier key is pressed
@@ -244,15 +255,20 @@ describe('ArrowShapeOptions', () => {
244
255
 
245
256
  const customUtil = new CustomArrowShapeUtil(editor)
246
257
 
247
- // Test shouldBeExact with both keys
258
+ // Test shouldBeExact with both keys and precise
248
259
  editor.inputs.altKey = true
249
260
  editor.inputs.shiftKey = true
250
- expect(customUtil.options.shouldBeExact(editor)).toBe(true)
261
+ expect(customUtil.options.shouldBeExact(editor, true)).toBe(true)
262
+
263
+ // Test shouldBeExact with both keys but not precise
264
+ editor.inputs.altKey = true
265
+ editor.inputs.shiftKey = true
266
+ expect(customUtil.options.shouldBeExact(editor, false)).toBe(false)
251
267
 
252
268
  // Test shouldBeExact with only one key
253
269
  editor.inputs.altKey = true
254
270
  editor.inputs.shiftKey = false
255
- expect(customUtil.options.shouldBeExact(editor)).toBe(false)
271
+ expect(customUtil.options.shouldBeExact(editor, true)).toBe(false)
256
272
 
257
273
  // Test shouldIgnoreTargets with any key
258
274
  editor.inputs.altKey = false
@@ -282,6 +298,61 @@ describe('ArrowShapeOptions', () => {
282
298
  expect(editor.getCurrentToolId()).toBe('arrow')
283
299
  })
284
300
 
301
+ it('should allow custom shouldBeExact logic based on isPrecise - example from arrow precise-exact', () => {
302
+ // This replicates the logic from the arrows-precise-exact example
303
+ const baseUtil = editor.getShapeUtil<ArrowShapeUtil>('arrow')
304
+ class ExampleArrowShapeUtil extends ArrowShapeUtil {
305
+ override options = {
306
+ ...baseUtil.options,
307
+ shouldBeExact: (_editor: any, isPrecise: boolean) => isPrecise,
308
+ }
309
+ }
310
+
311
+ // Replace the util temporarily for testing
312
+ const customUtil = new ExampleArrowShapeUtil(editor)
313
+ const originalShouldBeExact = baseUtil.options.shouldBeExact
314
+ baseUtil.options.shouldBeExact = customUtil.options.shouldBeExact
315
+
316
+ try {
317
+ editor.setCurrentTool('arrow')
318
+ editor.inputs.ctrlKey = false // Allow binding
319
+
320
+ // Set up fast pointer velocity to ensure precise remains false
321
+ editor.inputs.pointerVelocity = { x: 2, y: 2, len: () => 2.8 } as any
322
+
323
+ const targetState = updateArrowTargetState({
324
+ editor,
325
+ pointInPageSpace: { x: 150, y: 150 },
326
+ arrow: undefined,
327
+ isPrecise: true, // Input precise
328
+ currentBinding: undefined,
329
+ oppositeBinding: undefined,
330
+ })
331
+
332
+ // With the custom logic, precise arrows should be exact
333
+ expect(targetState?.isExact).toBe(true)
334
+ expect(targetState?.isPrecise).toBe(true)
335
+
336
+ // Test with non-precise movement (and fast velocity to avoid auto-precise)
337
+ const nonPreciseTargetState = updateArrowTargetState({
338
+ editor,
339
+ pointInPageSpace: { x: 150, y: 150 },
340
+ arrow: undefined,
341
+ isPrecise: false, // Not precise
342
+ currentBinding: undefined,
343
+ oppositeBinding: undefined,
344
+ })
345
+
346
+ // Non-precise arrows should not be exact with this custom logic,
347
+ // but they might still become precise due to internal logic
348
+ // The key test is that shouldBeExact gets the final computed precise value
349
+ expect(nonPreciseTargetState).toBeDefined()
350
+ } finally {
351
+ // Restore original function
352
+ baseUtil.options.shouldBeExact = originalShouldBeExact
353
+ }
354
+ })
355
+
285
356
  it('should respect shouldIgnoreTargets when starting arrow creation', () => {
286
357
  editor.setCurrentTool('arrow')
287
358
 
@@ -1,5 +1,8 @@
1
1
  import { IndexKey, TLArrowShape, TLShapeId, Vec, createShapeId } from '@tldraw/editor'
2
+ import { vi } from 'vitest'
2
3
  import { TestEditor } from '../../../test/TestEditor'
4
+ import { defaultShapeUtils } from '../../defaultShapeUtils'
5
+ import { ArrowShapeUtil } from './ArrowShapeUtil'
3
6
  import { getArrowTargetState } from './arrowTargetState'
4
7
  import { getArrowBindings } from './shared'
5
8
 
@@ -13,7 +16,7 @@ global.cancelAnimationFrame = function cancelAnimationFrame(id) {
13
16
  clearTimeout(id)
14
17
  }
15
18
 
16
- jest.useFakeTimers()
19
+ vi.useFakeTimers()
17
20
 
18
21
  const ids = {
19
22
  box1: createShapeId('box1'),
@@ -25,8 +28,8 @@ function bindings(id: TLShapeId) {
25
28
  return getArrowBindings(editor, editor.getShape(id) as TLArrowShape)
26
29
  }
27
30
 
28
- beforeEach(() => {
29
- editor = new TestEditor()
31
+ function init(opts?: ConstructorParameters<typeof TestEditor>[0]) {
32
+ editor = new TestEditor(opts)
30
33
  editor
31
34
  .selectAll()
32
35
  .deleteShapes(editor.getSelectedShapeIds())
@@ -35,7 +38,9 @@ beforeEach(() => {
35
38
  { id: ids.box2, type: 'geo', x: 300, y: 300, props: { w: 100, h: 100 } },
36
39
  { id: ids.box3, type: 'geo', x: 350, y: 350, props: { w: 50, h: 50 } }, // overlapping box2, but smaller!
37
40
  ])
38
- })
41
+ }
42
+
43
+ beforeEach(init)
39
44
 
40
45
  it('enters the arrow state', () => {
41
46
  editor.setCurrentTool('arrow')
@@ -242,7 +247,7 @@ describe('When pointing an end shape', () => {
242
247
  },
243
248
  })
244
249
 
245
- jest.advanceTimersByTime(1000)
250
+ vi.advanceTimersByTime(1000)
246
251
 
247
252
  arrow = editor.getCurrentPageShapes()[editor.getCurrentPageShapes().length - 1]
248
253
 
@@ -306,7 +311,7 @@ describe('When pointing an end shape', () => {
306
311
  })
307
312
 
308
313
  // Give time for the velocity to die down
309
- jest.advanceTimersByTime(1000)
314
+ vi.advanceTimersByTime(1000)
310
315
 
311
316
  arrow = editor.getCurrentPageShapes()[editor.getCurrentPageShapes().length - 1]
312
317
 
@@ -568,12 +573,102 @@ describe('reparenting issue', () => {
568
573
  const arrow1BoundIndex = editor.getShape(arrow1Id)!.index
569
574
  const arrow2BoundIndex = editor.getShape(arrow2Id)!.index
570
575
  expect(arrow1BoundIndex).toBe('a1V')
571
- expect(arrow2BoundIndex).toBe('a1F')
576
+ expect(arrow2BoundIndex).toBe('a1G')
572
577
 
573
578
  // nudge everything around and make sure we all stay in the right order
574
579
  editor.selectAll().nudgeShapes(editor.getSelectedShapeIds(), { x: -1, y: 0 })
575
580
  expect(editor.getShape(arrow1Id)!.index).toBe('a1V')
576
- expect(editor.getShape(arrow2Id)!.index).toBe('a1F')
581
+ expect(editor.getShape(arrow2Id)!.index).toBe('a1G')
582
+ })
583
+ })
584
+
585
+ describe('precision timeout configuration', () => {
586
+ it('uses a timeout when dragging arrow handles', () => {
587
+ // Create an arrow first
588
+
589
+ editor.setCurrentTool('arrow').pointerDown(0, 0)
590
+ // Use high velocity to avoid precise mode immediately
591
+ editor.inputs.pointerVelocity = new Vec(1, 1)
592
+ editor.pointerMove(100, 100)
593
+
594
+ const arrow = editor.getCurrentPageShapes()[
595
+ editor.getCurrentPageShapes().length - 1
596
+ ] as TLArrowShape
597
+
598
+ editor.expectToBeIn('select.dragging_handle')
599
+
600
+ expect(bindings(arrow.id)).toMatchObject({
601
+ end: {
602
+ toId: ids.box1,
603
+ props: {
604
+ isPrecise: false,
605
+ },
606
+ },
607
+ })
608
+
609
+ vi.advanceTimersByTime(1000)
610
+
611
+ expect(bindings(arrow.id)).toMatchObject({
612
+ end: {
613
+ toId: ids.box1,
614
+ props: {
615
+ isPrecise: true,
616
+ },
617
+ },
618
+ })
619
+ })
620
+
621
+ it('allows configuring the pointingPreciseTimeout', () => {
622
+ init({
623
+ shapeUtils: [
624
+ ...defaultShapeUtils.map((s) =>
625
+ s.type === 'arrow' ? ArrowShapeUtil.configure({ pointingPreciseTimeout: 2000 }) : s
626
+ ),
627
+ ],
628
+ })
629
+ // Create an arrow first
630
+
631
+ editor.setCurrentTool('arrow').pointerDown(0, 0)
632
+ // Use high velocity to avoid precise mode immediately
633
+ editor.inputs.pointerVelocity = new Vec(1, 1)
634
+ editor.pointerMove(100, 100)
635
+
636
+ const arrow = editor.getCurrentPageShapes()[
637
+ editor.getCurrentPageShapes().length - 1
638
+ ] as TLArrowShape
639
+
640
+ editor.expectToBeIn('select.dragging_handle')
641
+
642
+ expect(bindings(arrow.id)).toMatchObject({
643
+ end: {
644
+ toId: ids.box1,
645
+ props: {
646
+ isPrecise: false,
647
+ },
648
+ },
649
+ })
650
+
651
+ vi.advanceTimersByTime(1000)
652
+
653
+ expect(bindings(arrow.id)).toMatchObject({
654
+ end: {
655
+ toId: ids.box1,
656
+ props: {
657
+ isPrecise: false,
658
+ },
659
+ },
660
+ })
661
+
662
+ vi.advanceTimersByTime(1000)
663
+
664
+ expect(bindings(arrow.id)).toMatchObject({
665
+ end: {
666
+ toId: ids.box1,
667
+ props: {
668
+ isPrecise: true,
669
+ },
670
+ },
671
+ })
577
672
  })
578
673
  })
579
674
 
@@ -1,4 +1,5 @@
1
1
  import { HALF_PI, TLArrowShape, TLShapeId, createShapeId, toRichText } from '@tldraw/editor'
2
+ import { vi } from 'vitest'
2
3
  import { TestEditor } from '../../../test/TestEditor'
3
4
  import { createOrUpdateArrowBinding, getArrowBindings } from './shared'
4
5
 
@@ -12,7 +13,7 @@ const ids = {
12
13
  arrow1: createShapeId('arrow1'),
13
14
  }
14
15
 
15
- jest.useFakeTimers()
16
+ vi.useFakeTimers()
16
17
 
17
18
  window.requestAnimationFrame = function requestAnimationFrame(cb) {
18
19
  return setTimeout(cb, 1000 / 60)
@@ -217,7 +218,7 @@ describe('Other cases when arrow are moved', () => {
217
218
  // When box one is not selected, unbinds box1 and keeps binding to box2
218
219
  editor.select(ids.arrow1, ids.box2, ids.box3)
219
220
  editor.alignShapes(editor.getSelectedShapeIds(), 'right')
220
- jest.advanceTimersByTime(1000)
221
+ vi.advanceTimersByTime(1000)
221
222
 
222
223
  expect(bindings()).toMatchObject({
223
224
  start: { toId: ids.box1, props: { isPrecise: false } },
@@ -227,7 +228,7 @@ describe('Other cases when arrow are moved', () => {
227
228
  // maintains bindings if they would still be over the same shape (but makes them precise), but unbinds others
228
229
  editor.select(ids.arrow1, ids.box3)
229
230
  editor.alignShapes(editor.getSelectedShapeIds(), 'top')
230
- jest.advanceTimersByTime(1000)
231
+ vi.advanceTimersByTime(1000)
231
232
 
232
233
  expect(bindings()).toMatchObject({
233
234
  start: { toId: ids.box1, props: { isPrecise: true } },
@@ -244,7 +245,7 @@ describe('Other cases when arrow are moved', () => {
244
245
  // When box one is not selected, unbinds box1 and keeps binding to box2
245
246
  editor.select(ids.arrow1, ids.box2, ids.box3)
246
247
  editor.distributeShapes(editor.getSelectedShapeIds(), 'horizontal')
247
- jest.advanceTimersByTime(1000)
248
+ vi.advanceTimersByTime(1000)
248
249
 
249
250
  expect(bindings()).toMatchObject({
250
251
  start: { toId: ids.box1, props: { isPrecise: false } },
@@ -254,7 +255,7 @@ describe('Other cases when arrow are moved', () => {
254
255
  // unbinds when only the arrow is selected (not its bound shapes) if the arrow itself has moved
255
256
  editor.select(ids.arrow1, ids.box3, ids.box4)
256
257
  editor.distributeShapes(editor.getSelectedShapeIds(), 'vertical')
257
- jest.advanceTimersByTime(1000)
258
+ vi.advanceTimersByTime(1000)
258
259
 
259
260
  // The arrow didn't actually move
260
261
  expect(bindings()).toMatchObject({
@@ -265,7 +266,7 @@ describe('Other cases when arrow are moved', () => {
265
266
  // The arrow will not move because it is still bound to another shape
266
267
  editor.updateShapes([{ id: ids.box4, type: 'geo', y: -600 }])
267
268
  editor.distributeShapes(editor.getSelectedShapeIds(), 'vertical')
268
- jest.advanceTimersByTime(1000)
269
+ vi.advanceTimersByTime(1000)
269
270
 
270
271
  expect(bindings()).toMatchObject({
271
272
  start: undefined,
@@ -578,3 +579,44 @@ describe("an arrow's parents", () => {
578
579
  })
579
580
  })
580
581
  })
582
+
583
+ describe('Arrow export bounds', () => {
584
+ it('excludes labels from shape bounds for export', () => {
585
+ editor.selectAll().deleteShapes(editor.getSelectedShapeIds())
586
+
587
+ // Create shapes for the arrow to bind to
588
+ editor.createShapes([
589
+ { id: ids.box1, type: 'geo', x: 100, y: 100, props: { w: 100, h: 100 } },
590
+ { id: ids.box2, type: 'geo', x: 300, y: 100, props: { w: 100, h: 100 } },
591
+ ])
592
+
593
+ // Create an arrow with a label
594
+ editor.createShapes([
595
+ {
596
+ id: ids.arrow1,
597
+ type: 'arrow',
598
+ x: 0,
599
+ y: 0,
600
+ props: {
601
+ start: { x: 0, y: 0 },
602
+ end: { x: 0, y: 100 },
603
+ richText: toRichText('Test Label'),
604
+ },
605
+ },
606
+ ])
607
+
608
+ // Get the page bounds (should exclude labels due to excludeFromShapeBounds flag)
609
+ const pageBounds = editor.getShapePageBounds(ids.arrow1)
610
+ expect(pageBounds).toBeDefined()
611
+
612
+ // The bounds should be smaller than if labels were included
613
+ // Since the arrow has a label that's excluded, the bounds should be minimal
614
+ expect(pageBounds!.width).toBeLessThan(200) // Should not include label width
615
+ expect(pageBounds!.height).toBeLessThan(200) // Should not include label height
616
+
617
+ // Verify that the arrow has a label (which should be excluded from shape bounds)
618
+ const arrow = editor.getShape(ids.arrow1) as TLArrowShape
619
+ expect(arrow.props.richText).toBeDefined()
620
+ expect(arrow.props.richText).not.toBeNull()
621
+ })
622
+ })
@@ -81,7 +81,7 @@ export interface ArrowShapeOptions {
81
81
  */
82
82
  readonly hoverPreciseTimeout: number
83
83
  /**
84
- * When pointing at a shape using the arrow tool or draggin an arrow terminal handle, how long
84
+ * When pointing at a shape using the arrow tool or dragging an arrow terminal handle, how long
85
85
  * should we wait before we assume the user is targeting precisely instead of imprecisely.
86
86
  */
87
87
  readonly pointingPreciseTimeout: number
@@ -90,13 +90,11 @@ export interface ArrowShapeOptions {
90
90
  * When creating an arrow, should it stop exactly at the pointer, or should
91
91
  * it stop at the edge of the target shape.
92
92
  */
93
- // eslint-disable-next-line @typescript-eslint/method-signature-style
94
- readonly shouldBeExact: (editor: Editor) => boolean
93
+ shouldBeExact(editor: Editor, isPrecise: boolean): boolean
95
94
  /**
96
95
  * When creating an arrow, should it bind to the target shape.
97
96
  */
98
- // eslint-disable-next-line @typescript-eslint/method-signature-style
99
- readonly shouldIgnoreTargets: (editor: Editor) => boolean
97
+ shouldIgnoreTargets(editor: Editor): boolean
100
98
  }
101
99
 
102
100
  /** @public */
@@ -227,6 +227,14 @@ interface ArrowheadInfo {
227
227
  hasEndArrowhead: boolean
228
228
  }
229
229
  export function getArrowLabelPosition(editor: Editor, shape: TLArrowShape) {
230
+ const isEditing = editor.getEditingShapeId() === shape.id
231
+ if (!isEditing && isEmptyRichText(shape.props.richText)) {
232
+ // Short-circuit for empty labels.
233
+ const bodyGeom = getArrowBodyGeometry(editor, shape)
234
+ const labelCenter = bodyGeom.interpolateAlongEdge(0.5)
235
+ return { box: Box.FromCenter(labelCenter, new Vec(0, 0)), debugGeom: [] }
236
+ }
237
+
230
238
  const debugGeom: Geometry2d[] = []
231
239
  const info = getArrowInfo(editor, shape)!
232
240
 
@@ -27,6 +27,11 @@ import {
27
27
  ElbowArrowSideDeltas,
28
28
  } from './elbow/definitions'
29
29
 
30
+ /**
31
+ * Options passed to {@link updateArrowTargetState}.
32
+ *
33
+ * @public
34
+ */
30
35
  export interface UpdateArrowTargetStateOpts {
31
36
  editor: Editor
32
37
  pointInPageSpace: VecLike
@@ -37,6 +42,13 @@ export interface UpdateArrowTargetStateOpts {
37
42
  oppositeBinding: TLArrowBinding | undefined
38
43
  }
39
44
 
45
+ /**
46
+ * State representing what we're pointing to when drawing or updating an arrow. You can get this
47
+ * state using {@link getArrowTargetState}, and update it as part of an arrow interaction with
48
+ * {@link updateArrowTargetState} or {@link clearArrowTargetState}.
49
+ *
50
+ * @public
51
+ */
40
52
  export interface ArrowTargetState {
41
53
  target: TLShape
42
54
  arrowKind: TLArrowShapeKind
@@ -63,14 +75,32 @@ function getArrowTargetAtom(editor: Editor) {
63
75
  return arrowTargetStore.get(editor, () => atom('arrowTarget', null))
64
76
  }
65
77
 
78
+ /**
79
+ * Get the current arrow target state for an editor. See {@link ArrowTargetState} for more
80
+ * information.
81
+ *
82
+ * @public
83
+ */
66
84
  export function getArrowTargetState(editor: Editor) {
67
85
  return getArrowTargetAtom(editor).get()
68
86
  }
69
87
 
88
+ /**
89
+ * Clear the current arrow target state for an editor. See {@link ArrowTargetState} for more
90
+ * information.
91
+ *
92
+ * @public
93
+ */
70
94
  export function clearArrowTargetState(editor: Editor) {
71
95
  getArrowTargetAtom(editor).set(null)
72
96
  }
73
97
 
98
+ /**
99
+ * Update the current arrow target state for an editor. See {@link ArrowTargetState} for more
100
+ * information.
101
+ *
102
+ * @public
103
+ */
74
104
  export function updateArrowTargetState({
75
105
  editor,
76
106
  pointInPageSpace,
@@ -87,8 +117,6 @@ export function updateArrowTargetState({
87
117
  return null
88
118
  }
89
119
 
90
- const isExact = util.options.shouldBeExact(editor)
91
-
92
120
  const arrowKind = arrow ? arrow.props.kind : editor.getStyleForNextShape(ArrowShapeKindStyle)
93
121
 
94
122
  const target = editor.getShapeAtPoint(pointInPageSpace, {
@@ -165,7 +193,7 @@ export function updateArrowTargetState({
165
193
  }
166
194
  }
167
195
 
168
- let precise = isPrecise || isExact
196
+ let precise = isPrecise
169
197
 
170
198
  if (!precise) {
171
199
  // If we're switching to a new bound shape, then precise only if moving slowly
@@ -186,6 +214,9 @@ export function updateArrowTargetState({
186
214
  }
187
215
  }
188
216
 
217
+ const isExact = util.options.shouldBeExact(editor, precise)
218
+ if (isExact) precise = true
219
+
189
220
  const shouldSnapCenter = !isExact && precise && targetGeometryInTargetSpace.isClosed
190
221
  // const shouldSnapEdges = !isExact && (precise || !targetGeometryInTargetSpace.isClosed)
191
222
  const shouldSnapEdges =
@@ -163,7 +163,7 @@ export class Pointing extends StateNode {
163
163
  const endHandle = handles.find((h) => h.id === 'end')!
164
164
  const change = util.onHandleDrag?.(this.editor.getShape(shape)!, {
165
165
  handle: { ...endHandle, x: point.x, y: point.y },
166
- isPrecise: false,
166
+ isPrecise: this.isPrecise,
167
167
  isCreatingShape: true,
168
168
  initial: initial,
169
169
  })
@@ -13,7 +13,6 @@ import {
13
13
  debounce,
14
14
  getHashForString,
15
15
  lerp,
16
- stopEventPropagation,
17
16
  tlenv,
18
17
  toDomPrecision,
19
18
  useEditor,
@@ -132,9 +131,9 @@ function BookmarkShapeComponent({ shape }: { shape: TLBookmarkShape }) {
132
131
  const [isFaviconValid, setIsFaviconValid] = useState(true)
133
132
  const onFaviconError = () => setIsFaviconValid(false)
134
133
 
135
- const useStopPropagationOnShiftKey = useCallback<PointerEventHandler>(
134
+ const markAsHandledOnShiftKey = useCallback<PointerEventHandler>(
136
135
  (e) => {
137
- if (!editor.inputs.shiftKey) stopEventPropagation(e)
136
+ if (!editor.inputs.shiftKey) editor.markEventAsHandled(e)
138
137
  },
139
138
  [editor]
140
139
  )
@@ -182,8 +181,8 @@ function BookmarkShapeComponent({ shape }: { shape: TLBookmarkShape }) {
182
181
  target="_blank"
183
182
  rel="noopener noreferrer"
184
183
  draggable={false}
185
- onPointerDown={useStopPropagationOnShiftKey}
186
- onPointerUp={useStopPropagationOnShiftKey}
184
+ onPointerDown={markAsHandledOnShiftKey}
185
+ onPointerUp={markAsHandledOnShiftKey}
187
186
  >
188
187
  {isFaviconValid && asset?.props.favicon ? (
189
188
  <img
@@ -1,5 +1,4 @@
1
1
  import { TestEditor } from '../../../test/TestEditor'
2
- import { DrawShapeTool } from './DrawShapeTool'
3
2
 
4
3
  let editor: TestEditor
5
4
 
@@ -10,10 +9,6 @@ afterEach(() => {
10
9
  editor?.dispose()
11
10
  })
12
11
 
13
- describe(DrawShapeTool, () => {
14
- return
15
- })
16
-
17
12
  describe('When in the idle state', () => {
18
13
  it('Returns to select on cancel', () => {
19
14
  editor.setCurrentTool('draw')
@@ -100,6 +100,10 @@ export class FrameShapeUtil extends BaseBoxShapeUtil<TLFrameShape> {
100
100
  return false
101
101
  }
102
102
 
103
+ override isExportBoundsContainer(): boolean {
104
+ return true
105
+ }
106
+
103
107
  override getDefaultProps(): TLFrameShape['props'] {
104
108
  return { w: 160 * 2, h: 90 * 2, name: '', color: 'black' }
105
109
  }
@@ -192,6 +196,7 @@ export class FrameShapeUtil extends BaseBoxShapeUtil<TLFrameShape> {
192
196
  height,
193
197
  isFilled: true,
194
198
  isLabel: true,
199
+ excludeFromShapeBounds: true,
195
200
  }),
196
201
  ],
197
202
  })
@@ -335,6 +340,10 @@ export class FrameShapeUtil extends BaseBoxShapeUtil<TLFrameShape> {
335
340
  return true
336
341
  }
337
342
 
343
+ override getClipPath(shape: TLFrameShape) {
344
+ return this.editor.getShapeGeometry(shape.id).vertices
345
+ }
346
+
338
347
  override canReceiveNewChildrenOfType(shape: TLShape) {
339
348
  return !shape.isLocked
340
349
  }
@@ -1,4 +1,4 @@
1
- import { TLFrameShape, TLShapeId, stopEventPropagation, useEditor } from '@tldraw/editor'
1
+ import { TLFrameShape, TLShapeId, useEditor } from '@tldraw/editor'
2
2
  import { forwardRef, useCallback } from 'react'
3
3
  import { defaultEmptyAs } from '../FrameShapeUtil'
4
4
 
@@ -8,12 +8,19 @@ export const FrameLabelInput = forwardRef<
8
8
  >(({ id, name, isEditing }, ref) => {
9
9
  const editor = useEditor()
10
10
 
11
+ const handlePointerDown = useCallback(
12
+ (e: React.PointerEvent) => {
13
+ if (isEditing) editor.markEventAsHandled(e)
14
+ },
15
+ [editor, isEditing]
16
+ )
17
+
11
18
  const handleKeyDown = useCallback(
12
19
  (e: React.KeyboardEvent<HTMLInputElement>) => {
13
20
  if (e.key === 'Enter' && !e.nativeEvent.isComposing) {
14
21
  // need to prevent the enter keydown making it's way up to the Idle state
15
22
  // and sending us back into edit mode
16
- stopEventPropagation(e)
23
+ editor.markEventAsHandled(e)
17
24
  e.currentTarget.blur()
18
25
  editor.setEditingShape(null)
19
26
  }
@@ -74,7 +81,7 @@ export const FrameLabelInput = forwardRef<
74
81
  onKeyDown={handleKeyDown}
75
82
  onBlur={handleBlur}
76
83
  onChange={handleChange}
77
- onPointerDown={isEditing ? stopEventPropagation : undefined}
84
+ onPointerDown={handlePointerDown}
78
85
  draggable={false}
79
86
  />
80
87
  {defaultEmptyAs(name, 'Frame') + String.fromCharCode(8203)}
@@ -126,6 +126,7 @@ export class GeoShapeUtil extends BaseBoxShapeUtil<TLGeoShape> {
126
126
  height: unscaledLabelHeight * shape.props.scale,
127
127
  isFilled: true,
128
128
  isLabel: true,
129
+ excludeFromShapeBounds: true,
129
130
  isEmptyLabel: isEmptyRichText(shape.props.richText),
130
131
  }),
131
132
  ],