tldraw 3.16.0-next.6611943ca24a → 3.16.0-next.8eb6d5c2d8f4

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 (336) hide show
  1. package/dist-cjs/index.d.ts +251 -114
  2. package/dist-cjs/index.js +34 -15
  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/useEditablePlainText.js +3 -5
  32. package/dist-cjs/lib/shapes/shared/useEditablePlainText.js.map +2 -2
  33. package/dist-cjs/lib/shapes/shared/useImageOrVideoAsset.js +0 -2
  34. package/dist-cjs/lib/shapes/shared/useImageOrVideoAsset.js.map +2 -2
  35. package/dist-cjs/lib/shapes/text/PlainTextArea.js +3 -2
  36. package/dist-cjs/lib/shapes/text/PlainTextArea.js.map +2 -2
  37. package/dist-cjs/lib/shapes/text/RichTextArea.js +3 -3
  38. package/dist-cjs/lib/shapes/text/RichTextArea.js.map +2 -2
  39. package/dist-cjs/lib/tools/SelectTool/childStates/DraggingHandle.js +3 -1
  40. package/dist-cjs/lib/tools/SelectTool/childStates/DraggingHandle.js.map +2 -2
  41. package/dist-cjs/lib/ui/TldrawUi.js +13 -12
  42. package/dist-cjs/lib/ui/TldrawUi.js.map +2 -2
  43. package/dist-cjs/lib/ui/components/A11y.js +1 -1
  44. package/dist-cjs/lib/ui/components/A11y.js.map +2 -2
  45. package/dist-cjs/lib/ui/components/AccessibilityMenu.js +1 -1
  46. package/dist-cjs/lib/ui/components/AccessibilityMenu.js.map +2 -2
  47. package/dist-cjs/lib/ui/components/{FollowingIndicator.js → DefaultFollowingIndicator.js} +6 -6
  48. package/dist-cjs/lib/ui/components/DefaultFollowingIndicator.js.map +7 -0
  49. package/dist-cjs/lib/ui/components/InputModeMenu.js +77 -0
  50. package/dist-cjs/lib/ui/components/InputModeMenu.js.map +7 -0
  51. package/dist-cjs/lib/ui/components/KeyboardShortcutsDialog/DefaultKeyboardShortcutsDialogContent.js +5 -5
  52. package/dist-cjs/lib/ui/components/KeyboardShortcutsDialog/DefaultKeyboardShortcutsDialogContent.js.map +1 -1
  53. package/dist-cjs/lib/ui/components/LanguageMenu.js +1 -0
  54. package/dist-cjs/lib/ui/components/LanguageMenu.js.map +2 -2
  55. package/dist-cjs/lib/ui/components/MainMenu/DefaultMainMenuContent.js +2 -0
  56. package/dist-cjs/lib/ui/components/MainMenu/DefaultMainMenuContent.js.map +2 -2
  57. package/dist-cjs/lib/ui/components/Minimap/DefaultMinimap.js +2 -1
  58. package/dist-cjs/lib/ui/components/Minimap/DefaultMinimap.js.map +2 -2
  59. package/dist-cjs/lib/ui/components/PageMenu/DefaultPageMenu.js +1 -1
  60. package/dist-cjs/lib/ui/components/PageMenu/DefaultPageMenu.js.map +2 -2
  61. package/dist-cjs/lib/ui/components/StylePanel/DefaultStylePanel.js +13 -6
  62. package/dist-cjs/lib/ui/components/StylePanel/DefaultStylePanel.js.map +2 -2
  63. package/dist-cjs/lib/ui/components/StylePanel/DefaultStylePanelContent.js +255 -316
  64. package/dist-cjs/lib/ui/components/StylePanel/DefaultStylePanelContent.js.map +2 -2
  65. package/dist-cjs/lib/ui/components/StylePanel/StylePanelButtonPicker.js +147 -0
  66. package/dist-cjs/lib/ui/components/StylePanel/StylePanelButtonPicker.js.map +7 -0
  67. package/dist-cjs/lib/ui/components/StylePanel/StylePanelContext.js +70 -0
  68. package/dist-cjs/lib/ui/components/StylePanel/StylePanelContext.js.map +7 -0
  69. package/dist-cjs/lib/ui/components/StylePanel/{DoubleDropdownPicker.js → StylePanelDoubleDropdownPicker.js} +23 -22
  70. package/dist-cjs/lib/ui/components/StylePanel/StylePanelDoubleDropdownPicker.js.map +7 -0
  71. package/dist-cjs/lib/ui/components/StylePanel/{DropdownPicker.js → StylePanelDropdownPicker.js} +23 -20
  72. package/dist-cjs/lib/ui/components/StylePanel/StylePanelDropdownPicker.js.map +7 -0
  73. package/dist-cjs/lib/ui/components/StylePanel/StylePanelSubheading.js +28 -0
  74. package/dist-cjs/lib/ui/components/StylePanel/StylePanelSubheading.js.map +7 -0
  75. package/dist-cjs/lib/ui/components/Toolbar/AltTextEditor.js +2 -0
  76. package/dist-cjs/lib/ui/components/Toolbar/AltTextEditor.js.map +2 -2
  77. package/dist-cjs/lib/ui/components/Toolbar/DefaultImageToolbarContent.js +38 -9
  78. package/dist-cjs/lib/ui/components/Toolbar/DefaultImageToolbarContent.js.map +2 -2
  79. package/dist-cjs/lib/ui/components/Toolbar/DefaultVideoToolbarContent.js +15 -3
  80. package/dist-cjs/lib/ui/components/Toolbar/DefaultVideoToolbarContent.js.map +2 -2
  81. package/dist-cjs/lib/ui/components/Toolbar/LinkEditor.js +2 -1
  82. package/dist-cjs/lib/ui/components/Toolbar/LinkEditor.js.map +2 -2
  83. package/dist-cjs/lib/ui/components/Toolbar/OverflowingToolbar.js +1 -1
  84. package/dist-cjs/lib/ui/components/Toolbar/OverflowingToolbar.js.map +2 -2
  85. package/dist-cjs/lib/ui/components/Toolbar/ToggleToolLockedButton.js +6 -2
  86. package/dist-cjs/lib/ui/components/Toolbar/ToggleToolLockedButton.js.map +2 -2
  87. package/dist-cjs/lib/ui/components/menu-items.js +6 -4
  88. package/dist-cjs/lib/ui/components/menu-items.js.map +2 -2
  89. package/dist-cjs/lib/ui/components/primitives/TldrawUiContextualToolbar.js +11 -2
  90. package/dist-cjs/lib/ui/components/primitives/TldrawUiContextualToolbar.js.map +2 -2
  91. package/dist-cjs/lib/ui/components/primitives/TldrawUiInput.js +5 -3
  92. package/dist-cjs/lib/ui/components/primitives/TldrawUiInput.js.map +2 -2
  93. package/dist-cjs/lib/ui/components/primitives/TldrawUiSlider.js +18 -5
  94. package/dist-cjs/lib/ui/components/primitives/TldrawUiSlider.js.map +2 -2
  95. package/dist-cjs/lib/ui/components/primitives/TldrawUiToolbar.js +3 -0
  96. package/dist-cjs/lib/ui/components/primitives/TldrawUiToolbar.js.map +2 -2
  97. package/dist-cjs/lib/ui/components/primitives/TldrawUiTooltip.js +63 -14
  98. package/dist-cjs/lib/ui/components/primitives/TldrawUiTooltip.js.map +2 -2
  99. package/dist-cjs/lib/ui/components/primitives/menus/TldrawUiMenuCheckboxItem.js +3 -0
  100. package/dist-cjs/lib/ui/components/primitives/menus/TldrawUiMenuCheckboxItem.js.map +2 -2
  101. package/dist-cjs/lib/ui/components/primitives/menus/TldrawUiMenuItem.js +8 -8
  102. package/dist-cjs/lib/ui/components/primitives/menus/TldrawUiMenuItem.js.map +2 -2
  103. package/dist-cjs/lib/ui/context/actions.js +18 -33
  104. package/dist-cjs/lib/ui/context/actions.js.map +2 -2
  105. package/dist-cjs/lib/ui/context/components.js +2 -0
  106. package/dist-cjs/lib/ui/context/components.js.map +2 -2
  107. package/dist-cjs/lib/ui/context/events.js.map +2 -2
  108. package/dist-cjs/lib/ui/hooks/useClipboardEvents.js +1 -1
  109. package/dist-cjs/lib/ui/hooks/useClipboardEvents.js.map +2 -2
  110. package/dist-cjs/lib/ui/hooks/useExportAs.js +3 -2
  111. package/dist-cjs/lib/ui/hooks/useExportAs.js.map +2 -2
  112. package/dist-cjs/lib/ui/hooks/useTools.js +1 -1
  113. package/dist-cjs/lib/ui/hooks/useTools.js.map +2 -2
  114. package/dist-cjs/lib/ui/hooks/useTranslation/TLUiTranslationKey.js.map +1 -1
  115. package/dist-cjs/lib/ui/hooks/useTranslation/defaultTranslation.js +13 -3
  116. package/dist-cjs/lib/ui/hooks/useTranslation/defaultTranslation.js.map +2 -2
  117. package/dist-cjs/lib/ui/kbd-utils.js +9 -3
  118. package/dist-cjs/lib/ui/kbd-utils.js.map +2 -2
  119. package/dist-cjs/lib/ui/version.js +3 -3
  120. package/dist-cjs/lib/ui/version.js.map +1 -1
  121. package/dist-cjs/lib/utils/export/copyAs.js +1 -2
  122. package/dist-cjs/lib/utils/export/copyAs.js.map +2 -2
  123. package/dist-cjs/lib/utils/export/export.js +0 -20
  124. package/dist-cjs/lib/utils/export/export.js.map +2 -2
  125. package/dist-cjs/lib/utils/export/exportAs.js +1 -2
  126. package/dist-cjs/lib/utils/export/exportAs.js.map +2 -2
  127. package/dist-esm/index.d.mts +251 -114
  128. package/dist-esm/index.mjs +67 -31
  129. package/dist-esm/index.mjs.map +2 -2
  130. package/dist-esm/lib/Tldraw.mjs +14 -4
  131. package/dist-esm/lib/Tldraw.mjs.map +2 -2
  132. package/dist-esm/lib/defaultExternalContentHandlers.mjs +15 -4
  133. package/dist-esm/lib/defaultExternalContentHandlers.mjs.map +2 -2
  134. package/dist-esm/lib/shapes/arrow/arrowLabel.mjs +6 -0
  135. package/dist-esm/lib/shapes/arrow/arrowLabel.mjs.map +3 -3
  136. package/dist-esm/lib/shapes/arrow/arrowTargetState.mjs +3 -2
  137. package/dist-esm/lib/shapes/arrow/arrowTargetState.mjs.map +2 -2
  138. package/dist-esm/lib/shapes/arrow/toolStates/Pointing.mjs +1 -1
  139. package/dist-esm/lib/shapes/arrow/toolStates/Pointing.mjs.map +2 -2
  140. package/dist-esm/lib/shapes/bookmark/BookmarkShapeUtil.mjs +4 -5
  141. package/dist-esm/lib/shapes/bookmark/BookmarkShapeUtil.mjs.map +2 -2
  142. package/dist-esm/lib/shapes/frame/FrameShapeUtil.mjs +8 -1
  143. package/dist-esm/lib/shapes/frame/FrameShapeUtil.mjs.map +2 -2
  144. package/dist-esm/lib/shapes/frame/components/FrameLabelInput.mjs +9 -3
  145. package/dist-esm/lib/shapes/frame/components/FrameLabelInput.mjs.map +2 -2
  146. package/dist-esm/lib/shapes/geo/GeoShapeUtil.mjs +1 -0
  147. package/dist-esm/lib/shapes/geo/GeoShapeUtil.mjs.map +2 -2
  148. package/dist-esm/lib/shapes/image/ImageShapeUtil.mjs +3 -0
  149. package/dist-esm/lib/shapes/image/ImageShapeUtil.mjs.map +2 -2
  150. package/dist-esm/lib/shapes/note/NoteShapeUtil.mjs +2 -1
  151. package/dist-esm/lib/shapes/note/NoteShapeUtil.mjs.map +2 -2
  152. package/dist-esm/lib/shapes/shared/HyperlinkButton.mjs +5 -5
  153. package/dist-esm/lib/shapes/shared/HyperlinkButton.mjs.map +2 -2
  154. package/dist-esm/lib/shapes/shared/PlainTextLabel.mjs +1 -3
  155. package/dist-esm/lib/shapes/shared/PlainTextLabel.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/SelectTool/childStates/DraggingHandle.mjs +3 -1
  165. package/dist-esm/lib/tools/SelectTool/childStates/DraggingHandle.mjs.map +2 -2
  166. package/dist-esm/lib/ui/TldrawUi.mjs +13 -12
  167. package/dist-esm/lib/ui/TldrawUi.mjs.map +2 -2
  168. package/dist-esm/lib/ui/components/A11y.mjs +1 -2
  169. package/dist-esm/lib/ui/components/A11y.mjs.map +2 -2
  170. package/dist-esm/lib/ui/components/AccessibilityMenu.mjs +3 -3
  171. package/dist-esm/lib/ui/components/AccessibilityMenu.mjs.map +2 -2
  172. package/dist-esm/lib/ui/components/{FollowingIndicator.mjs → DefaultFollowingIndicator.mjs} +3 -3
  173. package/dist-esm/lib/ui/components/DefaultFollowingIndicator.mjs.map +7 -0
  174. package/dist-esm/lib/ui/components/InputModeMenu.mjs +57 -0
  175. package/dist-esm/lib/ui/components/InputModeMenu.mjs.map +7 -0
  176. package/dist-esm/lib/ui/components/KeyboardShortcutsDialog/DefaultKeyboardShortcutsDialogContent.mjs +5 -5
  177. package/dist-esm/lib/ui/components/KeyboardShortcutsDialog/DefaultKeyboardShortcutsDialogContent.mjs.map +1 -1
  178. package/dist-esm/lib/ui/components/LanguageMenu.mjs +1 -0
  179. package/dist-esm/lib/ui/components/LanguageMenu.mjs.map +2 -2
  180. package/dist-esm/lib/ui/components/MainMenu/DefaultMainMenuContent.mjs +2 -0
  181. package/dist-esm/lib/ui/components/MainMenu/DefaultMainMenuContent.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 +18 -7
  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 +50 -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} +20 -17
  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/menu-items.mjs +6 -4
  213. package/dist-esm/lib/ui/components/menu-items.mjs.map +2 -2
  214. package/dist-esm/lib/ui/components/primitives/TldrawUiContextualToolbar.mjs +11 -3
  215. package/dist-esm/lib/ui/components/primitives/TldrawUiContextualToolbar.mjs.map +2 -2
  216. package/dist-esm/lib/ui/components/primitives/TldrawUiInput.mjs +6 -4
  217. package/dist-esm/lib/ui/components/primitives/TldrawUiInput.mjs.map +2 -2
  218. package/dist-esm/lib/ui/components/primitives/TldrawUiSlider.mjs +18 -5
  219. package/dist-esm/lib/ui/components/primitives/TldrawUiSlider.mjs.map +2 -2
  220. package/dist-esm/lib/ui/components/primitives/TldrawUiToolbar.mjs +3 -0
  221. package/dist-esm/lib/ui/components/primitives/TldrawUiToolbar.mjs.map +2 -2
  222. package/dist-esm/lib/ui/components/primitives/TldrawUiTooltip.mjs +64 -14
  223. package/dist-esm/lib/ui/components/primitives/TldrawUiTooltip.mjs.map +2 -2
  224. package/dist-esm/lib/ui/components/primitives/menus/TldrawUiMenuCheckboxItem.mjs +3 -0
  225. package/dist-esm/lib/ui/components/primitives/menus/TldrawUiMenuCheckboxItem.mjs.map +2 -2
  226. package/dist-esm/lib/ui/components/primitives/menus/TldrawUiMenuItem.mjs +8 -8
  227. package/dist-esm/lib/ui/components/primitives/menus/TldrawUiMenuItem.mjs.map +2 -2
  228. package/dist-esm/lib/ui/context/actions.mjs +18 -33
  229. package/dist-esm/lib/ui/context/actions.mjs.map +2 -2
  230. package/dist-esm/lib/ui/context/components.mjs +2 -0
  231. package/dist-esm/lib/ui/context/components.mjs.map +2 -2
  232. package/dist-esm/lib/ui/context/events.mjs.map +2 -2
  233. package/dist-esm/lib/ui/hooks/useClipboardEvents.mjs +1 -2
  234. package/dist-esm/lib/ui/hooks/useClipboardEvents.mjs.map +2 -2
  235. package/dist-esm/lib/ui/hooks/useExportAs.mjs +3 -2
  236. package/dist-esm/lib/ui/hooks/useExportAs.mjs.map +2 -2
  237. package/dist-esm/lib/ui/hooks/useTools.mjs +1 -1
  238. package/dist-esm/lib/ui/hooks/useTools.mjs.map +2 -2
  239. package/dist-esm/lib/ui/hooks/useTranslation/defaultTranslation.mjs +13 -3
  240. package/dist-esm/lib/ui/hooks/useTranslation/defaultTranslation.mjs.map +2 -2
  241. package/dist-esm/lib/ui/kbd-utils.mjs +9 -3
  242. package/dist-esm/lib/ui/kbd-utils.mjs.map +2 -2
  243. package/dist-esm/lib/ui/version.mjs +3 -3
  244. package/dist-esm/lib/ui/version.mjs.map +1 -1
  245. package/dist-esm/lib/utils/export/copyAs.mjs +1 -2
  246. package/dist-esm/lib/utils/export/copyAs.mjs.map +2 -2
  247. package/dist-esm/lib/utils/export/export.mjs +0 -20
  248. package/dist-esm/lib/utils/export/export.mjs.map +2 -2
  249. package/dist-esm/lib/utils/export/exportAs.mjs +1 -2
  250. package/dist-esm/lib/utils/export/exportAs.mjs.map +2 -2
  251. package/package.json +3 -3
  252. package/src/index.ts +49 -23
  253. package/src/lib/Tldraw.tsx +15 -2
  254. package/src/lib/defaultExternalContentHandlers.ts +26 -4
  255. package/src/lib/shapes/arrow/ArrowShapeOptions.test.ts +83 -13
  256. package/src/lib/shapes/arrow/ArrowShapeTool.test.ts +99 -5
  257. package/src/lib/shapes/arrow/ArrowShapeUtil.test.ts +41 -0
  258. package/src/lib/shapes/arrow/arrow-types.ts +3 -5
  259. package/src/lib/shapes/arrow/arrowLabel.ts +8 -0
  260. package/src/lib/shapes/arrow/arrowTargetState.ts +34 -3
  261. package/src/lib/shapes/arrow/toolStates/Pointing.tsx +1 -1
  262. package/src/lib/shapes/bookmark/BookmarkShapeUtil.tsx +4 -5
  263. package/src/lib/shapes/frame/FrameShapeUtil.tsx +9 -0
  264. package/src/lib/shapes/frame/components/FrameLabelInput.tsx +10 -3
  265. package/src/lib/shapes/geo/GeoShapeUtil.tsx +1 -0
  266. package/src/lib/shapes/image/ImageShapeUtil.tsx +3 -0
  267. package/src/lib/shapes/note/NoteShapeUtil.tsx +1 -0
  268. package/src/lib/shapes/shared/HyperlinkButton.tsx +5 -5
  269. package/src/lib/shapes/shared/PlainTextLabel.tsx +0 -6
  270. package/src/lib/shapes/shared/useEditablePlainText.ts +3 -10
  271. package/src/lib/shapes/shared/useImageOrVideoAsset.ts +0 -7
  272. package/src/lib/shapes/text/PlainTextArea.tsx +4 -3
  273. package/src/lib/shapes/text/RichTextArea.tsx +3 -4
  274. package/src/lib/tools/SelectTool/childStates/DraggingHandle.tsx +6 -2
  275. package/src/lib/ui/TldrawUi.tsx +16 -10
  276. package/src/lib/ui/components/A11y.tsx +1 -2
  277. package/src/lib/ui/components/AccessibilityMenu.tsx +2 -2
  278. package/src/lib/ui/components/{FollowingIndicator.tsx → DefaultFollowingIndicator.tsx} +2 -1
  279. package/src/lib/ui/components/InputModeMenu.tsx +65 -0
  280. package/src/lib/ui/components/KeyboardShortcutsDialog/DefaultKeyboardShortcutsDialogContent.tsx +5 -5
  281. package/src/lib/ui/components/LanguageMenu.tsx +1 -0
  282. package/src/lib/ui/components/MainMenu/DefaultMainMenuContent.tsx +4 -0
  283. package/src/lib/ui/components/Minimap/DefaultMinimap.tsx +2 -1
  284. package/src/lib/ui/components/PageMenu/DefaultPageMenu.tsx +1 -2
  285. package/src/lib/ui/components/StylePanel/DefaultStylePanel.tsx +30 -14
  286. package/src/lib/ui/components/StylePanel/DefaultStylePanelContent.tsx +262 -381
  287. package/src/lib/ui/components/{primitives/TldrawUiButtonPicker.tsx → StylePanel/StylePanelButtonPicker.tsx} +70 -50
  288. package/src/lib/ui/components/StylePanel/StylePanelContext.tsx +65 -0
  289. package/src/lib/ui/components/StylePanel/{DoubleDropdownPicker.tsx → StylePanelDoubleDropdownPicker.tsx} +28 -19
  290. package/src/lib/ui/components/StylePanel/StylePanelDropdownPicker.tsx +119 -0
  291. package/src/lib/ui/components/StylePanel/StylePanelSubheading.tsx +9 -0
  292. package/src/lib/ui/components/Toolbar/AltTextEditor.tsx +2 -0
  293. package/src/lib/ui/components/Toolbar/DefaultImageToolbarContent.tsx +32 -15
  294. package/src/lib/ui/components/Toolbar/DefaultVideoToolbarContent.tsx +12 -4
  295. package/src/lib/ui/components/Toolbar/LinkEditor.tsx +1 -0
  296. package/src/lib/ui/components/Toolbar/OverflowingToolbar.tsx +1 -1
  297. package/src/lib/ui/components/Toolbar/ToggleToolLockedButton.tsx +9 -2
  298. package/src/lib/ui/components/menu-items.tsx +5 -3
  299. package/src/lib/ui/components/primitives/TldrawUiContextualToolbar.tsx +7 -3
  300. package/src/lib/ui/components/primitives/TldrawUiInput.tsx +6 -3
  301. package/src/lib/ui/components/primitives/TldrawUiSlider.tsx +52 -32
  302. package/src/lib/ui/components/primitives/TldrawUiToolbar.tsx +5 -1
  303. package/src/lib/ui/components/primitives/TldrawUiTooltip.tsx +88 -29
  304. package/src/lib/ui/components/primitives/menus/TldrawUiMenuCheckboxItem.tsx +4 -0
  305. package/src/lib/ui/components/primitives/menus/TldrawUiMenuItem.tsx +9 -9
  306. package/src/lib/ui/context/actions.tsx +25 -35
  307. package/src/lib/ui/context/components.tsx +3 -0
  308. package/src/lib/ui/context/events.tsx +3 -2
  309. package/src/lib/ui/hooks/useClipboardEvents.ts +1 -2
  310. package/src/lib/ui/hooks/useExportAs.ts +3 -2
  311. package/src/lib/ui/hooks/useTools.tsx +1 -1
  312. package/src/lib/ui/hooks/useTranslation/TLUiTranslationKey.ts +12 -2
  313. package/src/lib/ui/hooks/useTranslation/defaultTranslation.ts +13 -3
  314. package/src/lib/ui/kbd-utils.ts +10 -3
  315. package/src/lib/ui/version.ts +3 -3
  316. package/src/lib/ui.css +41 -4
  317. package/src/lib/utils/export/copyAs.ts +1 -24
  318. package/src/lib/utils/export/export.ts +0 -36
  319. package/src/lib/utils/export/exportAs.ts +1 -32
  320. package/src/test/TestEditor.ts +8 -2
  321. package/src/test/commands/setCamera.test.ts +13 -0
  322. package/src/test/custom-clipping.test.ts +436 -0
  323. package/src/test/frames.test.ts +15 -0
  324. package/src/test/getCulledShapes.test.tsx +71 -2
  325. package/tldraw.css +57 -7
  326. package/dist-cjs/lib/ui/components/FollowingIndicator.js.map +0 -7
  327. package/dist-cjs/lib/ui/components/StylePanel/DoubleDropdownPicker.js.map +0 -7
  328. package/dist-cjs/lib/ui/components/StylePanel/DropdownPicker.js.map +0 -7
  329. package/dist-cjs/lib/ui/components/primitives/TldrawUiButtonPicker.js +0 -131
  330. package/dist-cjs/lib/ui/components/primitives/TldrawUiButtonPicker.js.map +0 -7
  331. package/dist-esm/lib/ui/components/FollowingIndicator.mjs.map +0 -7
  332. package/dist-esm/lib/ui/components/StylePanel/DoubleDropdownPicker.mjs.map +0 -7
  333. package/dist-esm/lib/ui/components/StylePanel/DropdownPicker.mjs.map +0 -7
  334. package/dist-esm/lib/ui/components/primitives/TldrawUiButtonPicker.mjs +0 -115
  335. package/dist-esm/lib/ui/components/primitives/TldrawUiButtonPicker.mjs.map +0 -7
  336. package/src/lib/ui/components/StylePanel/DropdownPicker.tsx +0 -110
@@ -144,7 +144,7 @@ export async function defaultHandleExternalFileAsset(
144
144
  { file, assetId }: TLFileExternalAsset,
145
145
  options: TLDefaultExternalContentHandlerOpts
146
146
  ) {
147
- const isSuccess = runFileChecks(file, options)
147
+ const isSuccess = notifyIfFileNotAllowed(file, options)
148
148
  if (!isSuccess) assert(false, 'File checks failed')
149
149
 
150
150
  const assetInfo = await getAssetInfo(file, options, assetId)
@@ -161,7 +161,7 @@ export async function defaultHandleExternalFileReplaceContent(
161
161
  { file, shapeId, isImage }: TLFileReplaceExternalContent,
162
162
  options: TLDefaultExternalContentHandlerOpts
163
163
  ) {
164
- const isSuccess = runFileChecks(file, options)
164
+ const isSuccess = notifyIfFileNotAllowed(file, options)
165
165
  if (!isSuccess) assert(false, 'File checks failed')
166
166
 
167
167
  const shape = editor.getShape(shapeId)
@@ -399,7 +399,7 @@ export async function defaultHandleExternalFileContent(
399
399
  file: File
400
400
  }[] = []
401
401
  for (const file of files) {
402
- const isSuccess = runFileChecks(file, options)
402
+ const isSuccess = notifyIfFileNotAllowed(file, options)
403
403
  if (!isSuccess) continue
404
404
 
405
405
  const assetInfo = await getAssetInfo(file, options)
@@ -873,7 +873,15 @@ export function createEmptyBookmarkShape(
873
873
  return editor.getShape(partial.id) as TLBookmarkShape
874
874
  }
875
875
 
876
- function runFileChecks(file: File, options: TLDefaultExternalContentHandlerOpts) {
876
+ /**
877
+ * Checks if a file is allowed to be uploaded. If it is not, it will show a toast explaining why to the user.
878
+ *
879
+ * @param file - The file to check
880
+ * @param options - The options for the external content handler
881
+ * @returns True if the file is allowed, false otherwise
882
+ * @public
883
+ */
884
+ export function notifyIfFileNotAllowed(file: File, options: TLDefaultExternalContentHandlerOpts) {
877
885
  const {
878
886
  acceptedImageMimeTypes = DEFAULT_SUPPORTED_IMAGE_TYPES,
879
887
  acceptedVideoMimeTypes = DEFAULT_SUPPORT_VIDEO_TYPES,
@@ -893,8 +901,22 @@ function runFileChecks(file: File, options: TLDefaultExternalContentHandlerOpts)
893
901
  }
894
902
 
895
903
  if (file.size > maxAssetSize) {
904
+ const formatBytes = (bytes: number): string => {
905
+ if (bytes === 0) return '0 bytes'
906
+
907
+ const units = ['bytes', 'KB', 'MB', 'GB', 'TB', 'PB']
908
+ const base = 1024
909
+ const unitIndex = Math.floor(Math.log(bytes) / Math.log(base))
910
+
911
+ const value = bytes / Math.pow(base, unitIndex)
912
+ const formatted = value % 1 === 0 ? value.toString() : value.toFixed(1)
913
+
914
+ return `${formatted} ${units[unitIndex]}`
915
+ }
916
+
896
917
  toasts.addToast({
897
918
  title: msg('assets.files.size-too-big'),
919
+ description: msg('assets.files.maximum-size').replace('{size}', formatBytes(maxAssetSize)),
898
920
  severity: 'error',
899
921
  })
900
922
  return false
@@ -47,13 +47,21 @@ describe('ArrowShapeOptions', () => {
47
47
  it('should have correct default shouldBeExact behavior (alt key)', () => {
48
48
  const util = editor.getShapeUtil<ArrowShapeUtil>('arrow')
49
49
 
50
- // Test without alt key
50
+ // Test without alt key, not precise
51
51
  editor.inputs.altKey = false
52
- expect(util.options.shouldBeExact(editor)).toBe(false)
52
+ expect(util.options.shouldBeExact(editor, false)).toBe(false)
53
53
 
54
- // 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
55
63
  editor.inputs.altKey = true
56
- expect(util.options.shouldBeExact(editor)).toBe(true)
64
+ expect(util.options.shouldBeExact(editor, true)).toBe(true)
57
65
  })
58
66
 
59
67
  it('should have correct default shouldIgnoreTargets behavior (ctrl key)', () => {
@@ -186,7 +194,7 @@ describe('ArrowShapeOptions', () => {
186
194
  class CustomArrowShapeUtil extends ArrowShapeUtil {
187
195
  override options = {
188
196
  ...baseUtil.options,
189
- 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
190
198
  }
191
199
  }
192
200
 
@@ -195,12 +203,14 @@ describe('ArrowShapeOptions', () => {
195
203
  // Test with shift key
196
204
  editor.inputs.shiftKey = true
197
205
  editor.inputs.altKey = false
198
- 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)
199
208
 
200
209
  // Test without shift key
201
210
  editor.inputs.shiftKey = false
202
211
  editor.inputs.altKey = true // Alt key should not matter for custom implementation
203
- 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)
204
214
  })
205
215
 
206
216
  it('should allow customizing shouldIgnoreTargets behavior', () => {
@@ -232,9 +242,9 @@ describe('ArrowShapeOptions', () => {
232
242
  class CustomArrowShapeUtil extends ArrowShapeUtil {
233
243
  override options = {
234
244
  ...baseUtil.options,
235
- shouldBeExact: (editor: any) => {
236
- // Custom logic: exact when both alt and shift are pressed
237
- 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
238
248
  },
239
249
  shouldIgnoreTargets: (editor: any) => {
240
250
  // Custom logic: ignore targets when any modifier key is pressed
@@ -245,15 +255,20 @@ describe('ArrowShapeOptions', () => {
245
255
 
246
256
  const customUtil = new CustomArrowShapeUtil(editor)
247
257
 
248
- // Test shouldBeExact with both keys
258
+ // Test shouldBeExact with both keys and precise
249
259
  editor.inputs.altKey = true
250
260
  editor.inputs.shiftKey = true
251
- 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)
252
267
 
253
268
  // Test shouldBeExact with only one key
254
269
  editor.inputs.altKey = true
255
270
  editor.inputs.shiftKey = false
256
- expect(customUtil.options.shouldBeExact(editor)).toBe(false)
271
+ expect(customUtil.options.shouldBeExact(editor, true)).toBe(false)
257
272
 
258
273
  // Test shouldIgnoreTargets with any key
259
274
  editor.inputs.altKey = false
@@ -283,6 +298,61 @@ describe('ArrowShapeOptions', () => {
283
298
  expect(editor.getCurrentToolId()).toBe('arrow')
284
299
  })
285
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
+
286
356
  it('should respect shouldIgnoreTargets when starting arrow creation', () => {
287
357
  editor.setCurrentTool('arrow')
288
358
 
@@ -1,6 +1,8 @@
1
1
  import { IndexKey, TLArrowShape, TLShapeId, Vec, createShapeId } from '@tldraw/editor'
2
2
  import { vi } from 'vitest'
3
3
  import { TestEditor } from '../../../test/TestEditor'
4
+ import { defaultShapeUtils } from '../../defaultShapeUtils'
5
+ import { ArrowShapeUtil } from './ArrowShapeUtil'
4
6
  import { getArrowTargetState } from './arrowTargetState'
5
7
  import { getArrowBindings } from './shared'
6
8
 
@@ -26,8 +28,8 @@ function bindings(id: TLShapeId) {
26
28
  return getArrowBindings(editor, editor.getShape(id) as TLArrowShape)
27
29
  }
28
30
 
29
- beforeEach(() => {
30
- editor = new TestEditor()
31
+ function init(opts?: ConstructorParameters<typeof TestEditor>[0]) {
32
+ editor = new TestEditor(opts)
31
33
  editor
32
34
  .selectAll()
33
35
  .deleteShapes(editor.getSelectedShapeIds())
@@ -36,7 +38,9 @@ beforeEach(() => {
36
38
  { id: ids.box2, type: 'geo', x: 300, y: 300, props: { w: 100, h: 100 } },
37
39
  { id: ids.box3, type: 'geo', x: 350, y: 350, props: { w: 50, h: 50 } }, // overlapping box2, but smaller!
38
40
  ])
39
- })
41
+ }
42
+
43
+ beforeEach(init)
40
44
 
41
45
  it('enters the arrow state', () => {
42
46
  editor.setCurrentTool('arrow')
@@ -569,12 +573,102 @@ describe('reparenting issue', () => {
569
573
  const arrow1BoundIndex = editor.getShape(arrow1Id)!.index
570
574
  const arrow2BoundIndex = editor.getShape(arrow2Id)!.index
571
575
  expect(arrow1BoundIndex).toBe('a1V')
572
- expect(arrow2BoundIndex).toBe('a1F')
576
+ expect(arrow2BoundIndex).toBe('a1G')
573
577
 
574
578
  // nudge everything around and make sure we all stay in the right order
575
579
  editor.selectAll().nudgeShapes(editor.getSelectedShapeIds(), { x: -1, y: 0 })
576
580
  expect(editor.getShape(arrow1Id)!.index).toBe('a1V')
577
- 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
+ })
578
672
  })
579
673
  })
580
674
 
@@ -579,3 +579,44 @@ describe("an arrow's parents", () => {
579
579
  })
580
580
  })
581
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
@@ -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
  ],
@@ -57,6 +57,9 @@ export class ImageShapeUtil extends BaseBoxShapeUtil<TLImageShape> {
57
57
  override canCrop() {
58
58
  return true
59
59
  }
60
+ override isExportBoundsContainer(): boolean {
61
+ return true
62
+ }
60
63
 
61
64
  override getDefaultProps(): TLImageShape['props'] {
62
65
  return {
@@ -147,6 +147,7 @@ export class NoteShapeUtil extends ShapeUtil<TLNoteShape> {
147
147
  height: lh,
148
148
  isFilled: true,
149
149
  isLabel: true,
150
+ excludeFromShapeBounds: true,
150
151
  }),
151
152
  ],
152
153
  })