tldraw 3.16.0-canary.7cd3b8a5bfd6 → 3.16.0-canary.7facbd2d2b7f

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 +315 -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 +75 -37
  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 +315 -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 +76 -37
  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 +82 -30
  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 +43 -3
  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 +59 -6
  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
@@ -7,9 +7,15 @@ function kbd(str) {
7
7
  return str.split(",")[0].split(/(\[\[[^\]]+\]\])/g).map(
8
8
  (s) => s.startsWith("[[") ? s.replace(/[[\]]/g, "") : s.replace(/cmd\+/g, cmdKey).replace(/ctrl\+/g, ctrlKey).replace(/alt\+/g, altKey).replace(/shift\+/g, "\u21E7").replace(/\$/g, cmdKey).replace(/\?/g, altKey).replace(/!/g, "\u21E7").match(/__CTRL__|__ALT__|./g) || []
9
9
  ).flat().map((sub, index) => {
10
- if (sub === "__CTRL__") return "Ctrl";
11
- if (sub === "__ALT__") return "Alt";
12
- const modifiedKey = sub[0].toUpperCase() + sub.slice(1);
10
+ if (sub[0] === "+") return [];
11
+ let modifiedKey;
12
+ if (sub === "__CTRL__") {
13
+ modifiedKey = "Ctrl";
14
+ } else if (sub === "__ALT__") {
15
+ modifiedKey = "Alt";
16
+ } else {
17
+ modifiedKey = sub[0].toUpperCase() + sub.slice(1);
18
+ }
13
19
  return tlenv.isDarwin || !index ? modifiedKey : ["+", modifiedKey];
14
20
  }).flat();
15
21
  }
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../src/lib/ui/kbd-utils.ts"],
4
- "sourcesContent": ["import { tlenv } from '@tldraw/editor'\n\n// N.B. We rework these Windows placeholders down below.\nconst cmdKey = tlenv.isDarwin ? '\u2318' : '__CTRL__'\nconst ctrlKey = tlenv.isDarwin ? '\u2303' : '__CTRL__'\nconst altKey = tlenv.isDarwin ? '\u2325' : '__ALT__'\n\n/** @public */\nexport function kbd(str: string) {\n\tif (str === ',') return [',']\n\n\treturn (\n\t\tstr\n\t\t\t.split(',')[0]\n\t\t\t// If the string contains [[Tab]], we don't split these up\n\t\t\t// as they're meant to be atomic.\n\t\t\t.split(/(\\[\\[[^\\]]+\\]\\])/g)\n\t\t\t.map((s) =>\n\t\t\t\ts.startsWith('[[')\n\t\t\t\t\t? s.replace(/[[\\]]/g, '')\n\t\t\t\t\t: s\n\t\t\t\t\t\t\t.replace(/cmd\\+/g, cmdKey)\n\t\t\t\t\t\t\t.replace(/ctrl\\+/g, ctrlKey)\n\t\t\t\t\t\t\t.replace(/alt\\+/g, altKey)\n\t\t\t\t\t\t\t.replace(/shift\\+/g, '\u21E7')\n\t\t\t\t\t\t\t// Backwards compatibility with the old system.\n\t\t\t\t\t\t\t.replace(/\\$/g, cmdKey)\n\t\t\t\t\t\t\t.replace(/\\?/g, altKey)\n\t\t\t\t\t\t\t.replace(/!/g, '\u21E7')\n\t\t\t\t\t\t\t.match(/__CTRL__|__ALT__|./g) || []\n\t\t\t)\n\t\t\t.flat()\n\t\t\t.map((sub, index) => {\n\t\t\t\tif (sub === '__CTRL__') return 'Ctrl'\n\t\t\t\tif (sub === '__ALT__') return 'Alt'\n\t\t\t\tconst modifiedKey = sub[0].toUpperCase() + sub.slice(1)\n\t\t\t\treturn tlenv.isDarwin || !index ? modifiedKey : ['+', modifiedKey]\n\t\t\t})\n\t\t\t.flat()\n\t)\n}\n\n/** @public */\nexport function kbdStr(str: string) {\n\treturn '\u2014 ' + kbd(str).join('\u2009')\n}\n"],
5
- "mappings": "AAAA,SAAS,aAAa;AAGtB,MAAM,SAAS,MAAM,WAAW,WAAM;AACtC,MAAM,UAAU,MAAM,WAAW,WAAM;AACvC,MAAM,SAAS,MAAM,WAAW,WAAM;AAG/B,SAAS,IAAI,KAAa;AAChC,MAAI,QAAQ,IAAK,QAAO,CAAC,GAAG;AAE5B,SACC,IACE,MAAM,GAAG,EAAE,CAAC,EAGZ,MAAM,mBAAmB,EACzB;AAAA,IAAI,CAAC,MACL,EAAE,WAAW,IAAI,IACd,EAAE,QAAQ,UAAU,EAAE,IACtB,EACC,QAAQ,UAAU,MAAM,EACxB,QAAQ,WAAW,OAAO,EAC1B,QAAQ,UAAU,MAAM,EACxB,QAAQ,YAAY,QAAG,EAEvB,QAAQ,OAAO,MAAM,EACrB,QAAQ,OAAO,MAAM,EACrB,QAAQ,MAAM,QAAG,EACjB,MAAM,qBAAqB,KAAK,CAAC;AAAA,EACtC,EACC,KAAK,EACL,IAAI,CAAC,KAAK,UAAU;AACpB,QAAI,QAAQ,WAAY,QAAO;AAC/B,QAAI,QAAQ,UAAW,QAAO;AAC9B,UAAM,cAAc,IAAI,CAAC,EAAE,YAAY,IAAI,IAAI,MAAM,CAAC;AACtD,WAAO,MAAM,YAAY,CAAC,QAAQ,cAAc,CAAC,KAAK,WAAW;AAAA,EAClE,CAAC,EACA,KAAK;AAET;AAGO,SAAS,OAAO,KAAa;AACnC,SAAO,YAAO,IAAI,GAAG,EAAE,KAAK,QAAG;AAChC;",
4
+ "sourcesContent": ["import { tlenv } from '@tldraw/editor'\n\n// N.B. We rework these Windows placeholders down below.\nconst cmdKey = tlenv.isDarwin ? '\u2318' : '__CTRL__'\nconst ctrlKey = tlenv.isDarwin ? '\u2303' : '__CTRL__'\nconst altKey = tlenv.isDarwin ? '\u2325' : '__ALT__'\n\n/** @public */\nexport function kbd(str: string) {\n\tif (str === ',') return [',']\n\n\treturn (\n\t\tstr\n\t\t\t.split(',')[0]\n\t\t\t// If the string contains [[Tab]], we don't split these up\n\t\t\t// as they're meant to be atomic.\n\t\t\t.split(/(\\[\\[[^\\]]+\\]\\])/g)\n\t\t\t.map((s) =>\n\t\t\t\ts.startsWith('[[')\n\t\t\t\t\t? s.replace(/[[\\]]/g, '')\n\t\t\t\t\t: s\n\t\t\t\t\t\t\t.replace(/cmd\\+/g, cmdKey)\n\t\t\t\t\t\t\t.replace(/ctrl\\+/g, ctrlKey)\n\t\t\t\t\t\t\t.replace(/alt\\+/g, altKey)\n\t\t\t\t\t\t\t.replace(/shift\\+/g, '\u21E7')\n\t\t\t\t\t\t\t// Backwards compatibility with the old system.\n\t\t\t\t\t\t\t.replace(/\\$/g, cmdKey)\n\t\t\t\t\t\t\t.replace(/\\?/g, altKey)\n\t\t\t\t\t\t\t.replace(/!/g, '\u21E7')\n\t\t\t\t\t\t\t.match(/__CTRL__|__ALT__|./g) || []\n\t\t\t)\n\t\t\t.flat()\n\t\t\t.map((sub, index) => {\n\t\t\t\tif (sub[0] === '+') return []\n\n\t\t\t\tlet modifiedKey\n\t\t\t\tif (sub === '__CTRL__') {\n\t\t\t\t\tmodifiedKey = 'Ctrl'\n\t\t\t\t} else if (sub === '__ALT__') {\n\t\t\t\t\tmodifiedKey = 'Alt'\n\t\t\t\t} else {\n\t\t\t\t\tmodifiedKey = sub[0].toUpperCase() + sub.slice(1)\n\t\t\t\t}\n\t\t\t\treturn tlenv.isDarwin || !index ? modifiedKey : ['+', modifiedKey]\n\t\t\t})\n\t\t\t.flat()\n\t)\n}\n\n/** @public */\nexport function kbdStr(str: string) {\n\treturn '\u2014 ' + kbd(str).join('\u2009')\n}\n"],
5
+ "mappings": "AAAA,SAAS,aAAa;AAGtB,MAAM,SAAS,MAAM,WAAW,WAAM;AACtC,MAAM,UAAU,MAAM,WAAW,WAAM;AACvC,MAAM,SAAS,MAAM,WAAW,WAAM;AAG/B,SAAS,IAAI,KAAa;AAChC,MAAI,QAAQ,IAAK,QAAO,CAAC,GAAG;AAE5B,SACC,IACE,MAAM,GAAG,EAAE,CAAC,EAGZ,MAAM,mBAAmB,EACzB;AAAA,IAAI,CAAC,MACL,EAAE,WAAW,IAAI,IACd,EAAE,QAAQ,UAAU,EAAE,IACtB,EACC,QAAQ,UAAU,MAAM,EACxB,QAAQ,WAAW,OAAO,EAC1B,QAAQ,UAAU,MAAM,EACxB,QAAQ,YAAY,QAAG,EAEvB,QAAQ,OAAO,MAAM,EACrB,QAAQ,OAAO,MAAM,EACrB,QAAQ,MAAM,QAAG,EACjB,MAAM,qBAAqB,KAAK,CAAC;AAAA,EACtC,EACC,KAAK,EACL,IAAI,CAAC,KAAK,UAAU;AACpB,QAAI,IAAI,CAAC,MAAM,IAAK,QAAO,CAAC;AAE5B,QAAI;AACJ,QAAI,QAAQ,YAAY;AACvB,oBAAc;AAAA,IACf,WAAW,QAAQ,WAAW;AAC7B,oBAAc;AAAA,IACf,OAAO;AACN,oBAAc,IAAI,CAAC,EAAE,YAAY,IAAI,IAAI,MAAM,CAAC;AAAA,IACjD;AACA,WAAO,MAAM,YAAY,CAAC,QAAQ,cAAc,CAAC,KAAK,WAAW;AAAA,EAClE,CAAC,EACA,KAAK;AAET;AAGO,SAAS,OAAO,KAAa;AACnC,SAAO,YAAO,IAAI,GAAG,EAAE,KAAK,QAAG;AAChC;",
6
6
  "names": []
7
7
  }
@@ -1,8 +1,8 @@
1
- const version = "3.16.0-canary.7cd3b8a5bfd6";
1
+ const version = "3.16.0-canary.7facbd2d2b7f";
2
2
  const publishDates = {
3
3
  major: "2024-09-13T14:36:29.063Z",
4
- minor: "2025-08-14T11:59:40.260Z",
5
- patch: "2025-08-14T11:59:40.260Z"
4
+ minor: "2025-09-18T12:50:07.641Z",
5
+ patch: "2025-09-18T12:50:07.641Z"
6
6
  };
7
7
  export {
8
8
  publishDates,
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../src/lib/ui/version.ts"],
4
- "sourcesContent": ["// This file is automatically generated by internal/scripts/refresh-assets.ts.\n// Do not edit manually. Or do, I'm a comment, not a cop.\n\nexport const version = '3.16.0-canary.7cd3b8a5bfd6'\nexport const publishDates = {\n\tmajor: '2024-09-13T14:36:29.063Z',\n\tminor: '2025-08-14T11:59:40.260Z',\n\tpatch: '2025-08-14T11:59:40.260Z',\n}\n"],
4
+ "sourcesContent": ["// This file is automatically generated by internal/scripts/refresh-assets.ts.\n// Do not edit manually. Or do, I'm a comment, not a cop.\n\nexport const version = '3.16.0-canary.7facbd2d2b7f'\nexport const publishDates = {\n\tmajor: '2024-09-13T14:36:29.063Z',\n\tminor: '2025-09-18T12:50:07.641Z',\n\tpatch: '2025-09-18T12:50:07.641Z',\n}\n"],
5
5
  "mappings": "AAGO,MAAM,UAAU;AAChB,MAAM,eAAe;AAAA,EAC3B,OAAO;AAAA,EACP,OAAO;AAAA,EACP,OAAO;AACR;",
6
6
  "names": []
7
7
  }
@@ -8,8 +8,7 @@ import {
8
8
  getAdditionalClipboardWriteType
9
9
  } from "../clipboard.mjs";
10
10
  import { exportToImagePromiseForClipboard } from "./export.mjs";
11
- function copyAs(...args) {
12
- const [editor, ids, opts] = typeof args[2] === "string" ? [args[0], args[1], { ...args[3], format: args[2] }] : args;
11
+ function copyAs(editor, ids, opts) {
13
12
  if (!navigator.clipboard) return Promise.reject(new Error("Copy not supported"));
14
13
  if (navigator.clipboard.write) {
15
14
  const { blobPromise, mimeType } = exportToImagePromiseForClipboard(editor, ids, opts);
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../src/lib/utils/export/copyAs.ts"],
4
- "sourcesContent": ["import {\n\tEditor,\n\tFileHelpers,\n\tTLImageExportOptions,\n\tTLShapeId,\n\texhaustiveSwitchError,\n} from '@tldraw/editor'\nimport {\n\tclipboardWrite,\n\tdoesClipboardSupportType,\n\tgetAdditionalClipboardWriteType,\n} from '../clipboard'\nimport { exportToImagePromiseForClipboard } from './export'\n\n/** @public */\nexport type TLCopyType = 'svg' | 'png'\n\n/** @public */\nexport interface CopyAsOptions extends TLImageExportOptions {\n\t/** The format to copy as. */\n\tformat: TLCopyType\n}\n\n/**\n * Copy the given shapes to the clipboard.\n *\n * @param editor - The editor instance.\n * @param ids - The ids of the shapes to copy.\n * @param format - The format to copy as. Defaults to png.\n * @param opts - Options for the copy.\n *\n * @public\n */\nexport function copyAs(editor: Editor, ids: TLShapeId[], opts: CopyAsOptions): Promise<void>\n/**\n * @deprecated The format parameter is now part of the opts object.\n * @public\n */\nexport function copyAs(\n\teditor: Editor,\n\tids: TLShapeId[],\n\tformat: TLCopyType,\n\topts?: TLImageExportOptions & { format?: undefined }\n): Promise<void>\nexport function copyAs(\n\t...args:\n\t\t| [editor: Editor, ids: TLShapeId[], opts: TLImageExportOptions & { format: TLCopyType }]\n\t\t| [\n\t\t\t\teditor: Editor,\n\t\t\t\tids: TLShapeId[],\n\t\t\t\tformat: TLCopyType,\n\t\t\t\topts?: TLImageExportOptions & { format?: undefined },\n\t\t ]\n) {\n\tconst [editor, ids, opts] =\n\t\ttypeof args[2] === 'string' ? [args[0], args[1], { ...args[3], format: args[2] }] : args\n\n\t// Note: it's important that this function itself isn't async and doesn't really use promises -\n\t// we need to create the relevant `ClipboardItem`s and call navigator.clipboard.write\n\t// synchronously to make sure safari knows that the user _wants_ to copy See\n\t// https://bugs.webkit.org/show_bug.cgi?id=222262\n\n\tif (!navigator.clipboard) return Promise.reject(new Error('Copy not supported'))\n\tif (navigator.clipboard.write as any) {\n\t\tconst { blobPromise, mimeType } = exportToImagePromiseForClipboard(editor, ids, opts)\n\n\t\tconst types: Record<string, Promise<Blob>> = { [mimeType]: blobPromise }\n\t\tconst additionalMimeType = getAdditionalClipboardWriteType(opts.format)\n\t\tif (additionalMimeType && doesClipboardSupportType(additionalMimeType)) {\n\t\t\ttypes[additionalMimeType] = blobPromise.then((blob) =>\n\t\t\t\tFileHelpers.rewriteMimeType(blob, additionalMimeType)\n\t\t\t)\n\t\t}\n\n\t\treturn clipboardWrite(types)\n\t}\n\n\tswitch (opts.format) {\n\t\tcase 'svg': {\n\t\t\treturn fallbackWriteTextAsync(async () => {\n\t\t\t\tconst result = await editor.getSvgString(ids, opts)\n\n\t\t\t\tif (!result) throw new Error('Failed to copy')\n\t\t\t\treturn result.svg\n\t\t\t})\n\t\t}\n\n\t\tcase 'png':\n\t\t\tthrow new Error('Copy not supported')\n\t\tdefault:\n\t\t\texhaustiveSwitchError(opts.format)\n\t}\n}\n\nasync function fallbackWriteTextAsync(getText: () => Promise<string>) {\n\tawait navigator.clipboard?.writeText?.(await getText())\n}\n"],
5
- "mappings": "AAAA;AAAA,EAEC;AAAA,EAGA;AAAA,OACM;AACP;AAAA,EACC;AAAA,EACA;AAAA,EACA;AAAA,OACM;AACP,SAAS,wCAAwC;AAgC1C,SAAS,UACZ,MAQF;AACD,QAAM,CAAC,QAAQ,KAAK,IAAI,IACvB,OAAO,KAAK,CAAC,MAAM,WAAW,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,GAAG,QAAQ,KAAK,CAAC,EAAE,CAAC,IAAI;AAOrF,MAAI,CAAC,UAAU,UAAW,QAAO,QAAQ,OAAO,IAAI,MAAM,oBAAoB,CAAC;AAC/E,MAAI,UAAU,UAAU,OAAc;AACrC,UAAM,EAAE,aAAa,SAAS,IAAI,iCAAiC,QAAQ,KAAK,IAAI;AAEpF,UAAM,QAAuC,EAAE,CAAC,QAAQ,GAAG,YAAY;AACvE,UAAM,qBAAqB,gCAAgC,KAAK,MAAM;AACtE,QAAI,sBAAsB,yBAAyB,kBAAkB,GAAG;AACvE,YAAM,kBAAkB,IAAI,YAAY;AAAA,QAAK,CAAC,SAC7C,YAAY,gBAAgB,MAAM,kBAAkB;AAAA,MACrD;AAAA,IACD;AAEA,WAAO,eAAe,KAAK;AAAA,EAC5B;AAEA,UAAQ,KAAK,QAAQ;AAAA,IACpB,KAAK,OAAO;AACX,aAAO,uBAAuB,YAAY;AACzC,cAAM,SAAS,MAAM,OAAO,aAAa,KAAK,IAAI;AAElD,YAAI,CAAC,OAAQ,OAAM,IAAI,MAAM,gBAAgB;AAC7C,eAAO,OAAO;AAAA,MACf,CAAC;AAAA,IACF;AAAA,IAEA,KAAK;AACJ,YAAM,IAAI,MAAM,oBAAoB;AAAA,IACrC;AACC,4BAAsB,KAAK,MAAM;AAAA,EACnC;AACD;AAEA,eAAe,uBAAuB,SAAgC;AACrE,QAAM,UAAU,WAAW,YAAY,MAAM,QAAQ,CAAC;AACvD;",
4
+ "sourcesContent": ["import {\n\tEditor,\n\tFileHelpers,\n\tTLImageExportOptions,\n\tTLShapeId,\n\texhaustiveSwitchError,\n} from '@tldraw/editor'\nimport {\n\tclipboardWrite,\n\tdoesClipboardSupportType,\n\tgetAdditionalClipboardWriteType,\n} from '../clipboard'\nimport { exportToImagePromiseForClipboard } from './export'\n\n/** @public */\nexport type TLCopyType = 'svg' | 'png'\n\n/** @public */\nexport interface CopyAsOptions extends TLImageExportOptions {\n\t/** The format to copy as. */\n\tformat: TLCopyType\n}\n\n/**\n * Copy the given shapes to the clipboard.\n *\n * @param editor - The editor instance.\n * @param ids - The ids of the shapes to copy.\n * @param format - The format to copy as. Defaults to png.\n * @param opts - Options for the copy.\n *\n * @public\n */\nexport function copyAs(editor: Editor, ids: TLShapeId[], opts: CopyAsOptions): Promise<void> {\n\t// Note: it's important that this function itself isn't async and doesn't really use promises -\n\t// we need to create the relevant `ClipboardItem`s and call navigator.clipboard.write\n\t// synchronously to make sure safari knows that the user _wants_ to copy See\n\t// https://bugs.webkit.org/show_bug.cgi?id=222262\n\n\tif (!navigator.clipboard) return Promise.reject(new Error('Copy not supported'))\n\tif (navigator.clipboard.write as any) {\n\t\tconst { blobPromise, mimeType } = exportToImagePromiseForClipboard(editor, ids, opts)\n\n\t\tconst types: Record<string, Promise<Blob>> = { [mimeType]: blobPromise }\n\t\tconst additionalMimeType = getAdditionalClipboardWriteType(opts.format)\n\t\tif (additionalMimeType && doesClipboardSupportType(additionalMimeType)) {\n\t\t\ttypes[additionalMimeType] = blobPromise.then((blob) =>\n\t\t\t\tFileHelpers.rewriteMimeType(blob, additionalMimeType)\n\t\t\t)\n\t\t}\n\n\t\treturn clipboardWrite(types)\n\t}\n\n\tswitch (opts.format) {\n\t\tcase 'svg': {\n\t\t\treturn fallbackWriteTextAsync(async () => {\n\t\t\t\tconst result = await editor.getSvgString(ids, opts)\n\n\t\t\t\tif (!result) throw new Error('Failed to copy')\n\t\t\t\treturn result.svg\n\t\t\t})\n\t\t}\n\n\t\tcase 'png':\n\t\t\tthrow new Error('Copy not supported')\n\t\tdefault:\n\t\t\texhaustiveSwitchError(opts.format)\n\t}\n}\n\nasync function fallbackWriteTextAsync(getText: () => Promise<string>) {\n\tawait navigator.clipboard?.writeText?.(await getText())\n}\n"],
5
+ "mappings": "AAAA;AAAA,EAEC;AAAA,EAGA;AAAA,OACM;AACP;AAAA,EACC;AAAA,EACA;AAAA,EACA;AAAA,OACM;AACP,SAAS,wCAAwC;AAqB1C,SAAS,OAAO,QAAgB,KAAkB,MAAoC;AAM5F,MAAI,CAAC,UAAU,UAAW,QAAO,QAAQ,OAAO,IAAI,MAAM,oBAAoB,CAAC;AAC/E,MAAI,UAAU,UAAU,OAAc;AACrC,UAAM,EAAE,aAAa,SAAS,IAAI,iCAAiC,QAAQ,KAAK,IAAI;AAEpF,UAAM,QAAuC,EAAE,CAAC,QAAQ,GAAG,YAAY;AACvE,UAAM,qBAAqB,gCAAgC,KAAK,MAAM;AACtE,QAAI,sBAAsB,yBAAyB,kBAAkB,GAAG;AACvE,YAAM,kBAAkB,IAAI,YAAY;AAAA,QAAK,CAAC,SAC7C,YAAY,gBAAgB,MAAM,kBAAkB;AAAA,MACrD;AAAA,IACD;AAEA,WAAO,eAAe,KAAK;AAAA,EAC5B;AAEA,UAAQ,KAAK,QAAQ;AAAA,IACpB,KAAK,OAAO;AACX,aAAO,uBAAuB,YAAY;AACzC,cAAM,SAAS,MAAM,OAAO,aAAa,KAAK,IAAI;AAElD,YAAI,CAAC,OAAQ,OAAM,IAAI,MAAM,gBAAgB;AAC7C,eAAO,OAAO;AAAA,MACf,CAAC;AAAA,IACF;AAAA,IAEA,KAAK;AACJ,YAAM,IAAI,MAAM,oBAAoB;AAAA,IACrC;AACC,4BAAsB,KAAK,MAAM;AAAA,EACnC;AACD;AAEA,eAAe,uBAAuB,SAAgC;AACrE,QAAM,UAAU,WAAW,YAAY,MAAM,QAAQ,CAAC;AACvD;",
6
6
  "names": []
7
7
  }
@@ -23,25 +23,6 @@ async function exportToString(editor, ids, format, opts = {}) {
23
23
  }
24
24
  }
25
25
  }
26
- async function exportToBlob({
27
- editor,
28
- ids,
29
- format,
30
- opts = {}
31
- }) {
32
- const idsToUse = ids?.length ? ids : [...editor.getCurrentPageShapeIds()];
33
- switch (format) {
34
- case "jpeg":
35
- case "png":
36
- case "webp":
37
- case "svg": {
38
- return (await editor.toImage(idsToUse, { ...opts, format })).blob;
39
- }
40
- default: {
41
- exhaustiveSwitchError(format);
42
- }
43
- }
44
- }
45
26
  const clipboardMimeTypesByFormat = {
46
27
  jpeg: "image/jpeg",
47
28
  png: "image/png",
@@ -59,7 +40,6 @@ function exportToImagePromiseForClipboard(editor, ids, opts = {}) {
59
40
  };
60
41
  }
61
42
  export {
62
- exportToBlob,
63
43
  exportToImagePromiseForClipboard,
64
44
  exportToString
65
45
  };
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../src/lib/utils/export/export.ts"],
4
- "sourcesContent": ["import {\n\tEditor,\n\tFileHelpers,\n\tTLExportType,\n\tTLImageExportOptions,\n\tTLShapeId,\n\texhaustiveSwitchError,\n} from '@tldraw/editor'\n\nasync function getSvgString(editor: Editor, ids: TLShapeId[], opts: TLImageExportOptions) {\n\tconst svg = await editor.getSvgString(ids, opts)\n\tif (!svg) {\n\t\tthrow new Error('Could not construct SVG.')\n\t}\n\treturn svg\n}\n\nexport async function exportToString(\n\teditor: Editor,\n\tids: TLShapeId[],\n\tformat: 'svg' | 'json',\n\topts: TLImageExportOptions = {}\n) {\n\tswitch (format) {\n\t\tcase 'svg': {\n\t\t\treturn (await getSvgString(editor, ids, opts))?.svg\n\t\t}\n\t\tcase 'json': {\n\t\t\tconst data = await editor.resolveAssetsInContent(editor.getContentFromCurrentPage(ids))\n\t\t\treturn JSON.stringify(data)\n\t\t}\n\t\tdefault: {\n\t\t\texhaustiveSwitchError(format)\n\t\t}\n\t}\n}\n\n/**\n * Export the given shapes as a blob.\n * @param editor - The editor instance.\n * @param ids - The ids of the shapes to export.\n * @param format - The format to export as.\n * @param opts - Rendering options.\n * @returns A promise that resolves to a blob.\n * @deprecated Use {@link @tldraw/editor#Editor.toImage} instead.\n * @public\n */\nexport async function exportToBlob({\n\teditor,\n\tids,\n\tformat,\n\topts = {},\n}: {\n\teditor: Editor\n\tids: TLShapeId[]\n\tformat: TLExportType\n\topts?: TLImageExportOptions\n}): Promise<Blob> {\n\tconst idsToUse = ids?.length ? ids : [...editor.getCurrentPageShapeIds()]\n\tswitch (format) {\n\t\tcase 'jpeg':\n\t\tcase 'png':\n\t\tcase 'webp':\n\t\tcase 'svg': {\n\t\t\treturn (await editor.toImage(idsToUse, { ...opts, format })).blob\n\t\t}\n\t\tdefault: {\n\t\t\texhaustiveSwitchError(format)\n\t\t}\n\t}\n}\n\nconst clipboardMimeTypesByFormat = {\n\tjpeg: 'image/jpeg',\n\tpng: 'image/png',\n\twebp: 'image/webp',\n\tsvg: 'text/plain',\n}\n\nexport function exportToImagePromiseForClipboard(\n\teditor: Editor,\n\tids: TLShapeId[],\n\topts: TLImageExportOptions = {}\n): { blobPromise: Promise<Blob>; mimeType: string } {\n\tconst idsToUse = ids?.length ? ids : [...editor.getCurrentPageShapeIds()]\n\tconst format = opts.format ?? 'png'\n\treturn {\n\t\tblobPromise: editor\n\t\t\t.toImage(idsToUse, opts)\n\t\t\t.then((result) =>\n\t\t\t\tFileHelpers.rewriteMimeType(result.blob, clipboardMimeTypesByFormat[format])\n\t\t\t),\n\t\tmimeType: clipboardMimeTypesByFormat[format],\n\t}\n}\n"],
5
- "mappings": "AAAA;AAAA,EAEC;AAAA,EAIA;AAAA,OACM;AAEP,eAAe,aAAa,QAAgB,KAAkB,MAA4B;AACzF,QAAM,MAAM,MAAM,OAAO,aAAa,KAAK,IAAI;AAC/C,MAAI,CAAC,KAAK;AACT,UAAM,IAAI,MAAM,0BAA0B;AAAA,EAC3C;AACA,SAAO;AACR;AAEA,eAAsB,eACrB,QACA,KACA,QACA,OAA6B,CAAC,GAC7B;AACD,UAAQ,QAAQ;AAAA,IACf,KAAK,OAAO;AACX,cAAQ,MAAM,aAAa,QAAQ,KAAK,IAAI,IAAI;AAAA,IACjD;AAAA,IACA,KAAK,QAAQ;AACZ,YAAM,OAAO,MAAM,OAAO,uBAAuB,OAAO,0BAA0B,GAAG,CAAC;AACtF,aAAO,KAAK,UAAU,IAAI;AAAA,IAC3B;AAAA,IACA,SAAS;AACR,4BAAsB,MAAM;AAAA,IAC7B;AAAA,EACD;AACD;AAYA,eAAsB,aAAa;AAAA,EAClC;AAAA,EACA;AAAA,EACA;AAAA,EACA,OAAO,CAAC;AACT,GAKkB;AACjB,QAAM,WAAW,KAAK,SAAS,MAAM,CAAC,GAAG,OAAO,uBAAuB,CAAC;AACxE,UAAQ,QAAQ;AAAA,IACf,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK,OAAO;AACX,cAAQ,MAAM,OAAO,QAAQ,UAAU,EAAE,GAAG,MAAM,OAAO,CAAC,GAAG;AAAA,IAC9D;AAAA,IACA,SAAS;AACR,4BAAsB,MAAM;AAAA,IAC7B;AAAA,EACD;AACD;AAEA,MAAM,6BAA6B;AAAA,EAClC,MAAM;AAAA,EACN,KAAK;AAAA,EACL,MAAM;AAAA,EACN,KAAK;AACN;AAEO,SAAS,iCACf,QACA,KACA,OAA6B,CAAC,GACqB;AACnD,QAAM,WAAW,KAAK,SAAS,MAAM,CAAC,GAAG,OAAO,uBAAuB,CAAC;AACxE,QAAM,SAAS,KAAK,UAAU;AAC9B,SAAO;AAAA,IACN,aAAa,OACX,QAAQ,UAAU,IAAI,EACtB;AAAA,MAAK,CAAC,WACN,YAAY,gBAAgB,OAAO,MAAM,2BAA2B,MAAM,CAAC;AAAA,IAC5E;AAAA,IACD,UAAU,2BAA2B,MAAM;AAAA,EAC5C;AACD;",
4
+ "sourcesContent": ["import {\n\tEditor,\n\tFileHelpers,\n\tTLImageExportOptions,\n\tTLShapeId,\n\texhaustiveSwitchError,\n} from '@tldraw/editor'\n\nasync function getSvgString(editor: Editor, ids: TLShapeId[], opts: TLImageExportOptions) {\n\tconst svg = await editor.getSvgString(ids, opts)\n\tif (!svg) {\n\t\tthrow new Error('Could not construct SVG.')\n\t}\n\treturn svg\n}\n\nexport async function exportToString(\n\teditor: Editor,\n\tids: TLShapeId[],\n\tformat: 'svg' | 'json',\n\topts: TLImageExportOptions = {}\n) {\n\tswitch (format) {\n\t\tcase 'svg': {\n\t\t\treturn (await getSvgString(editor, ids, opts))?.svg\n\t\t}\n\t\tcase 'json': {\n\t\t\tconst data = await editor.resolveAssetsInContent(editor.getContentFromCurrentPage(ids))\n\t\t\treturn JSON.stringify(data)\n\t\t}\n\t\tdefault: {\n\t\t\texhaustiveSwitchError(format)\n\t\t}\n\t}\n}\n\nconst clipboardMimeTypesByFormat = {\n\tjpeg: 'image/jpeg',\n\tpng: 'image/png',\n\twebp: 'image/webp',\n\tsvg: 'text/plain',\n}\n\nexport function exportToImagePromiseForClipboard(\n\teditor: Editor,\n\tids: TLShapeId[],\n\topts: TLImageExportOptions = {}\n): { blobPromise: Promise<Blob>; mimeType: string } {\n\tconst idsToUse = ids?.length ? ids : [...editor.getCurrentPageShapeIds()]\n\tconst format = opts.format ?? 'png'\n\treturn {\n\t\tblobPromise: editor\n\t\t\t.toImage(idsToUse, opts)\n\t\t\t.then((result) =>\n\t\t\t\tFileHelpers.rewriteMimeType(result.blob, clipboardMimeTypesByFormat[format])\n\t\t\t),\n\t\tmimeType: clipboardMimeTypesByFormat[format],\n\t}\n}\n"],
5
+ "mappings": "AAAA;AAAA,EAEC;AAAA,EAGA;AAAA,OACM;AAEP,eAAe,aAAa,QAAgB,KAAkB,MAA4B;AACzF,QAAM,MAAM,MAAM,OAAO,aAAa,KAAK,IAAI;AAC/C,MAAI,CAAC,KAAK;AACT,UAAM,IAAI,MAAM,0BAA0B;AAAA,EAC3C;AACA,SAAO;AACR;AAEA,eAAsB,eACrB,QACA,KACA,QACA,OAA6B,CAAC,GAC7B;AACD,UAAQ,QAAQ;AAAA,IACf,KAAK,OAAO;AACX,cAAQ,MAAM,aAAa,QAAQ,KAAK,IAAI,IAAI;AAAA,IACjD;AAAA,IACA,KAAK,QAAQ;AACZ,YAAM,OAAO,MAAM,OAAO,uBAAuB,OAAO,0BAA0B,GAAG,CAAC;AACtF,aAAO,KAAK,UAAU,IAAI;AAAA,IAC3B;AAAA,IACA,SAAS;AACR,4BAAsB,MAAM;AAAA,IAC7B;AAAA,EACD;AACD;AAEA,MAAM,6BAA6B;AAAA,EAClC,MAAM;AAAA,EACN,KAAK;AAAA,EACL,MAAM;AAAA,EACN,KAAK;AACN;AAEO,SAAS,iCACf,QACA,KACA,OAA6B,CAAC,GACqB;AACnD,QAAM,WAAW,KAAK,SAAS,MAAM,CAAC,GAAG,OAAO,uBAAuB,CAAC;AACxE,QAAM,SAAS,KAAK,UAAU;AAC9B,SAAO;AAAA,IACN,aAAa,OACX,QAAQ,UAAU,IAAI,EACtB;AAAA,MAAK,CAAC,WACN,YAAY,gBAAgB,OAAO,MAAM,2BAA2B,MAAM,CAAC;AAAA,IAC5E;AAAA,IACD,UAAU,2BAA2B,MAAM;AAAA,EAC5C;AACD;",
6
6
  "names": []
7
7
  }
@@ -1,8 +1,7 @@
1
1
  import {
2
2
  sanitizeId
3
3
  } from "@tldraw/editor";
4
- async function exportAs(...args) {
5
- const [editor, ids, opts] = typeof args[2] === "object" ? args : [args[0], args[1], { ...args[4], format: args[2] ?? "png", name: args[3] }];
4
+ async function exportAs(editor, ids, opts) {
6
5
  let name = opts.name;
7
6
  if (!name) {
8
7
  name = `shapes at ${getTimestamp()}`;
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../src/lib/utils/export/exportAs.ts"],
4
- "sourcesContent": ["import {\n\tEditor,\n\tsanitizeId,\n\tTLExportType,\n\tTLFrameShape,\n\tTLImageExportOptions,\n\tTLShapeId,\n} from '@tldraw/editor'\n\n/** @public */\nexport interface ExportAsOptions extends TLImageExportOptions {\n\t/** {@inheritdoc @tldraw/editor#TLImageExportOptions.format} */\n\tformat: TLExportType\n\t/** Name of the exported file. If undefined a predefined name, based on the selection, will be used. */\n\tname?: string\n}\n\n/**\n * Export the given shapes as files.\n *\n * @param editor - The editor instance.\n * @param ids - The ids of the shapes to export.\n * @param opts - Options for the export.\n *\n * @public\n */\nexport async function exportAs(\n\teditor: Editor,\n\tids: TLShapeId[],\n\topts: ExportAsOptions\n): Promise<void>\n/**\n * @deprecated The format & name parameters are now part of the opts object.\n * @public\n */\nexport async function exportAs(\n\teditor: Editor,\n\tids: TLShapeId[],\n\tformat?: TLExportType,\n\tname?: string,\n\topts?: TLImageExportOptions\n): Promise<void>\nexport async function exportAs(\n\t...args:\n\t\t| [\n\t\t\t\teditor: Editor,\n\t\t\t\tids: TLShapeId[],\n\t\t\t\topts: TLImageExportOptions & { format: TLExportType; name?: string },\n\t\t ]\n\t\t| [\n\t\t\t\teditor: Editor,\n\t\t\t\tids: TLShapeId[],\n\t\t\t\tformat?: TLExportType,\n\t\t\t\tname?: string,\n\t\t\t\topts?: TLImageExportOptions,\n\t\t ]\n) {\n\tconst [editor, ids, opts] =\n\t\ttypeof args[2] === 'object'\n\t\t\t? args\n\t\t\t: [args[0], args[1], { ...args[4], format: args[2] ?? 'png', name: args[3] }]\n\n\t// If we don't get name then use a predefined one\n\tlet name = opts.name\n\tif (!name) {\n\t\tname = `shapes at ${getTimestamp()}`\n\t\tif (ids.length === 1) {\n\t\t\tconst first = editor.getShape(ids[0])!\n\t\t\tif (editor.isShapeOfType<TLFrameShape>(first, 'frame')) {\n\t\t\t\tname = first.props.name || 'frame'\n\t\t\t} else {\n\t\t\t\tname = `${sanitizeId(first.id)} at ${getTimestamp()}`\n\t\t\t}\n\t\t}\n\t}\n\tname += `.${opts.format}`\n\n\tconst { blob } = await editor.toImage(ids, opts)\n\tconst file = new File([blob], name, { type: blob.type })\n\tdownloadFile(file)\n}\n\nfunction getTimestamp() {\n\tconst now = new Date()\n\n\tconst year = String(now.getFullYear()).slice(2)\n\tconst month = String(now.getMonth() + 1).padStart(2, '0')\n\tconst day = String(now.getDate()).padStart(2, '0')\n\tconst hours = String(now.getHours()).padStart(2, '0')\n\tconst minutes = String(now.getMinutes()).padStart(2, '0')\n\tconst seconds = String(now.getSeconds()).padStart(2, '0')\n\n\treturn `${year}-${month}-${day} ${hours}.${minutes}.${seconds}`\n}\n\n/** @internal */\nexport function downloadFile(file: File) {\n\tconst link = document.createElement('a')\n\tconst url = URL.createObjectURL(file)\n\tlink.href = url\n\tlink.download = file.name\n\tlink.click()\n\tURL.revokeObjectURL(url)\n}\n"],
5
- "mappings": "AAAA;AAAA,EAEC;AAAA,OAKM;AAmCP,eAAsB,YAClB,MAaF;AACD,QAAM,CAAC,QAAQ,KAAK,IAAI,IACvB,OAAO,KAAK,CAAC,MAAM,WAChB,OACA,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,GAAG,QAAQ,KAAK,CAAC,KAAK,OAAO,MAAM,KAAK,CAAC,EAAE,CAAC;AAG9E,MAAI,OAAO,KAAK;AAChB,MAAI,CAAC,MAAM;AACV,WAAO,aAAa,aAAa,CAAC;AAClC,QAAI,IAAI,WAAW,GAAG;AACrB,YAAM,QAAQ,OAAO,SAAS,IAAI,CAAC,CAAC;AACpC,UAAI,OAAO,cAA4B,OAAO,OAAO,GAAG;AACvD,eAAO,MAAM,MAAM,QAAQ;AAAA,MAC5B,OAAO;AACN,eAAO,GAAG,WAAW,MAAM,EAAE,CAAC,OAAO,aAAa,CAAC;AAAA,MACpD;AAAA,IACD;AAAA,EACD;AACA,UAAQ,IAAI,KAAK,MAAM;AAEvB,QAAM,EAAE,KAAK,IAAI,MAAM,OAAO,QAAQ,KAAK,IAAI;AAC/C,QAAM,OAAO,IAAI,KAAK,CAAC,IAAI,GAAG,MAAM,EAAE,MAAM,KAAK,KAAK,CAAC;AACvD,eAAa,IAAI;AAClB;AAEA,SAAS,eAAe;AACvB,QAAM,MAAM,oBAAI,KAAK;AAErB,QAAM,OAAO,OAAO,IAAI,YAAY,CAAC,EAAE,MAAM,CAAC;AAC9C,QAAM,QAAQ,OAAO,IAAI,SAAS,IAAI,CAAC,EAAE,SAAS,GAAG,GAAG;AACxD,QAAM,MAAM,OAAO,IAAI,QAAQ,CAAC,EAAE,SAAS,GAAG,GAAG;AACjD,QAAM,QAAQ,OAAO,IAAI,SAAS,CAAC,EAAE,SAAS,GAAG,GAAG;AACpD,QAAM,UAAU,OAAO,IAAI,WAAW,CAAC,EAAE,SAAS,GAAG,GAAG;AACxD,QAAM,UAAU,OAAO,IAAI,WAAW,CAAC,EAAE,SAAS,GAAG,GAAG;AAExD,SAAO,GAAG,IAAI,IAAI,KAAK,IAAI,GAAG,IAAI,KAAK,IAAI,OAAO,IAAI,OAAO;AAC9D;AAGO,SAAS,aAAa,MAAY;AACxC,QAAM,OAAO,SAAS,cAAc,GAAG;AACvC,QAAM,MAAM,IAAI,gBAAgB,IAAI;AACpC,OAAK,OAAO;AACZ,OAAK,WAAW,KAAK;AACrB,OAAK,MAAM;AACX,MAAI,gBAAgB,GAAG;AACxB;",
4
+ "sourcesContent": ["import {\n\tEditor,\n\tsanitizeId,\n\tTLExportType,\n\tTLFrameShape,\n\tTLImageExportOptions,\n\tTLShapeId,\n} from '@tldraw/editor'\n\n/** @public */\nexport interface ExportAsOptions extends TLImageExportOptions {\n\t/** {@inheritdoc @tldraw/editor#TLImageExportOptions.format} */\n\tformat: TLExportType\n\t/** Name of the exported file. If undefined a predefined name, based on the selection, will be used. */\n\tname?: string\n}\n\n/**\n * Export the given shapes as files.\n *\n * @param editor - The editor instance.\n * @param ids - The ids of the shapes to export.\n * @param opts - Options for the export.\n *\n * @public\n */\nexport async function exportAs(\n\teditor: Editor,\n\tids: TLShapeId[],\n\topts: ExportAsOptions\n): Promise<void> {\n\t// If we don't get name then use a predefined one\n\tlet name = opts.name\n\tif (!name) {\n\t\tname = `shapes at ${getTimestamp()}`\n\t\tif (ids.length === 1) {\n\t\t\tconst first = editor.getShape(ids[0])!\n\t\t\tif (editor.isShapeOfType<TLFrameShape>(first, 'frame')) {\n\t\t\t\tname = first.props.name || 'frame'\n\t\t\t} else {\n\t\t\t\tname = `${sanitizeId(first.id)} at ${getTimestamp()}`\n\t\t\t}\n\t\t}\n\t}\n\tname += `.${opts.format}`\n\n\tconst { blob } = await editor.toImage(ids, opts)\n\tconst file = new File([blob], name, { type: blob.type })\n\tdownloadFile(file)\n}\n\nfunction getTimestamp() {\n\tconst now = new Date()\n\n\tconst year = String(now.getFullYear()).slice(2)\n\tconst month = String(now.getMonth() + 1).padStart(2, '0')\n\tconst day = String(now.getDate()).padStart(2, '0')\n\tconst hours = String(now.getHours()).padStart(2, '0')\n\tconst minutes = String(now.getMinutes()).padStart(2, '0')\n\tconst seconds = String(now.getSeconds()).padStart(2, '0')\n\n\treturn `${year}-${month}-${day} ${hours}.${minutes}.${seconds}`\n}\n\n/** @internal */\nexport function downloadFile(file: File) {\n\tconst link = document.createElement('a')\n\tconst url = URL.createObjectURL(file)\n\tlink.href = url\n\tlink.download = file.name\n\tlink.click()\n\tURL.revokeObjectURL(url)\n}\n"],
5
+ "mappings": "AAAA;AAAA,EAEC;AAAA,OAKM;AAmBP,eAAsB,SACrB,QACA,KACA,MACgB;AAEhB,MAAI,OAAO,KAAK;AAChB,MAAI,CAAC,MAAM;AACV,WAAO,aAAa,aAAa,CAAC;AAClC,QAAI,IAAI,WAAW,GAAG;AACrB,YAAM,QAAQ,OAAO,SAAS,IAAI,CAAC,CAAC;AACpC,UAAI,OAAO,cAA4B,OAAO,OAAO,GAAG;AACvD,eAAO,MAAM,MAAM,QAAQ;AAAA,MAC5B,OAAO;AACN,eAAO,GAAG,WAAW,MAAM,EAAE,CAAC,OAAO,aAAa,CAAC;AAAA,MACpD;AAAA,IACD;AAAA,EACD;AACA,UAAQ,IAAI,KAAK,MAAM;AAEvB,QAAM,EAAE,KAAK,IAAI,MAAM,OAAO,QAAQ,KAAK,IAAI;AAC/C,QAAM,OAAO,IAAI,KAAK,CAAC,IAAI,GAAG,MAAM,EAAE,MAAM,KAAK,KAAK,CAAC;AACvD,eAAa,IAAI;AAClB;AAEA,SAAS,eAAe;AACvB,QAAM,MAAM,oBAAI,KAAK;AAErB,QAAM,OAAO,OAAO,IAAI,YAAY,CAAC,EAAE,MAAM,CAAC;AAC9C,QAAM,QAAQ,OAAO,IAAI,SAAS,IAAI,CAAC,EAAE,SAAS,GAAG,GAAG;AACxD,QAAM,MAAM,OAAO,IAAI,QAAQ,CAAC,EAAE,SAAS,GAAG,GAAG;AACjD,QAAM,QAAQ,OAAO,IAAI,SAAS,CAAC,EAAE,SAAS,GAAG,GAAG;AACpD,QAAM,UAAU,OAAO,IAAI,WAAW,CAAC,EAAE,SAAS,GAAG,GAAG;AACxD,QAAM,UAAU,OAAO,IAAI,WAAW,CAAC,EAAE,SAAS,GAAG,GAAG;AAExD,SAAO,GAAG,IAAI,IAAI,KAAK,IAAI,GAAG,IAAI,KAAK,IAAI,OAAO,IAAI,OAAO;AAC9D;AAGO,SAAS,aAAa,MAAY;AACxC,QAAM,OAAO,SAAS,cAAc,GAAG;AACvC,QAAM,MAAM,IAAI,gBAAgB,IAAI;AACpC,OAAK,OAAO;AACZ,OAAK,WAAW,KAAK;AACrB,OAAK,MAAM;AACX,MAAI,gBAAgB,GAAG;AACxB;",
6
6
  "names": []
7
7
  }
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "tldraw",
3
3
  "description": "A tiny little drawing editor.",
4
- "version": "3.16.0-canary.7cd3b8a5bfd6",
4
+ "version": "3.16.0-canary.7facbd2d2b7f",
5
5
  "author": {
6
6
  "name": "tldraw Inc.",
7
7
  "email": "hello@tldraw.com"
@@ -27,9 +27,9 @@
27
27
  ],
28
28
  "main": "dist-cjs/index.js",
29
29
  "scripts": {
30
- "test-ci": "lazy inherit",
31
- "test": "yarn run -T jest",
32
- "test-coverage": "lazy inherit",
30
+ "test-ci": "yarn run -T vitest run --passWithNoTests",
31
+ "test": "yarn run -T vitest --passWithNoTests",
32
+ "test-coverage": "yarn run -T vitest run --coverage --passWithNoTests",
33
33
  "predev": "node ./scripts/copy-css-files.mjs",
34
34
  "dev": "chokidar '../{editor/editor,tldraw/src/lib/ui}.css' -c 'node ./scripts/copy-css-files.mjs'",
35
35
  "prebuild": "node ./scripts/copy-css-files.mjs",
@@ -38,7 +38,8 @@
38
38
  "prepack": "yarn run -T tsx ../../internal/scripts/prepack.ts",
39
39
  "postpack": "../../internal/scripts/postpack.sh",
40
40
  "pack-tarball": "yarn pack",
41
- "lint": "yarn run -T tsx ../../internal/scripts/lint.ts"
41
+ "lint": "yarn run -T tsx ../../internal/scripts/lint.ts",
42
+ "context": "yarn run -T tsx ../../internal/scripts/context.ts"
42
43
  },
43
44
  "files": [
44
45
  "tldraw.css",
@@ -54,13 +55,13 @@
54
55
  "@tiptap/pm": "^2.9.1",
55
56
  "@tiptap/react": "^2.9.1",
56
57
  "@tiptap/starter-kit": "^2.9.1",
57
- "@tldraw/editor": "3.16.0-canary.7cd3b8a5bfd6",
58
- "@tldraw/store": "3.16.0-canary.7cd3b8a5bfd6",
58
+ "@tldraw/editor": "3.16.0-canary.7facbd2d2b7f",
59
+ "@tldraw/store": "3.16.0-canary.7facbd2d2b7f",
59
60
  "classnames": "^2.5.1",
60
61
  "hotkeys-js": "^3.13.9",
61
62
  "idb": "^7.1.1",
62
63
  "lz-string": "^1.5.0",
63
- "radix-ui": "^1.3.4"
64
+ "radix-ui": "^1.4.2"
64
65
  },
65
66
  "peerDependencies": {
66
67
  "react": "^18.2.0 || ^19.0.0",
@@ -68,40 +69,16 @@
68
69
  },
69
70
  "devDependencies": {
70
71
  "@peculiar/webcrypto": "^1.5.0",
71
- "@testing-library/jest-dom": "^5.17.0",
72
72
  "@testing-library/react": "^15.0.7",
73
73
  "@types/classnames": "^2.3.4",
74
74
  "@types/lz-string": "^1.5.0",
75
75
  "@types/react": "^18.3.18",
76
76
  "chokidar-cli": "^3.0.0",
77
- "jest-canvas-mock": "^2.5.2",
78
- "jest-environment-jsdom": "^29.7.0",
79
77
  "lazyrepo": "0.0.0-alpha.27",
80
78
  "react": "^18.3.1",
81
79
  "react-dom": "^18.3.1",
82
- "resize-observer-polyfill": "^1.5.1"
83
- },
84
- "jest": {
85
- "preset": "../../internal/config/jest/node/jest-preset.js",
86
- "testEnvironment": "../../../packages/utils/patchedJestJsDom.js",
87
- "fakeTimers": {
88
- "enableGlobally": true
89
- },
90
- "testPathIgnorePatterns": [
91
- "^.+\\.*.css$"
92
- ],
93
- "moduleNameMapper": {
94
- "^~(.*)": "<rootDir>/src/$1",
95
- "\\.(css|less|scss|sass)$": "identity-obj-proxy"
96
- },
97
- "setupFiles": [
98
- "raf/polyfill",
99
- "jest-canvas-mock",
100
- "<rootDir>/setupTests.js"
101
- ],
102
- "setupFilesAfterEnv": [
103
- "../../internal/config/setupJest.ts"
104
- ]
80
+ "resize-observer-polyfill": "^1.5.1",
81
+ "vitest": "^3.2.4"
105
82
  },
106
83
  "module": "dist-esm/index.mjs",
107
84
  "source": "src/index.ts",
package/src/index.ts CHANGED
@@ -24,6 +24,7 @@ export { usePrefersReducedMotion } from './lib/shapes/shared/usePrefersReducedMo
24
24
  export { DefaultA11yAnnouncer, useSelectedShapesAnnouncer } from './lib/ui/components/A11y'
25
25
  export { AccessibilityMenu } from './lib/ui/components/AccessibilityMenu'
26
26
  export { ColorSchemeMenu } from './lib/ui/components/ColorSchemeMenu'
27
+ export { DefaultFollowingIndicator } from './lib/ui/components/DefaultFollowingIndicator'
27
28
  export { DefaultDialogs } from './lib/ui/components/Dialogs'
28
29
  export {
29
30
  TldrawUiColumn,
@@ -85,6 +86,7 @@ export {
85
86
  defaultHandleExternalUrlContent,
86
87
  getAssetInfo,
87
88
  getMediaAssetInfoPartial,
89
+ notifyIfFileNotAllowed,
88
90
  registerDefaultExternalContentHandlers,
89
91
  type TLDefaultExternalContentHandlerOpts,
90
92
  type TLExternalContentProps,
@@ -104,6 +106,13 @@ export {
104
106
  } from './lib/shapes/arrow/arrow-types'
105
107
  export { ArrowShapeTool } from './lib/shapes/arrow/ArrowShapeTool'
106
108
  export { ArrowShapeUtil } from './lib/shapes/arrow/ArrowShapeUtil'
109
+ export {
110
+ clearArrowTargetState,
111
+ getArrowTargetState,
112
+ updateArrowTargetState,
113
+ type ArrowTargetState,
114
+ type UpdateArrowTargetStateOpts,
115
+ } from './lib/shapes/arrow/arrowTargetState'
107
116
  export {
108
117
  type ElbowArrowBox,
109
118
  type ElbowArrowBoxEdges,
@@ -166,11 +175,10 @@ export {
166
175
  type TLDefaultFont,
167
176
  type TLDefaultFonts,
168
177
  } from './lib/shapes/shared/defaultFonts'
169
- export {
170
- PlainTextLabel,
171
- TextLabel,
172
- type PlainTextLabelProps,
173
- } from './lib/shapes/shared/PlainTextLabel'
178
+ export { getStrokePoints } from './lib/shapes/shared/freehand/getStrokePoints'
179
+ export { getSvgPathFromStrokePoints } from './lib/shapes/shared/freehand/svg'
180
+ export { type StrokeOptions, type StrokePoint } from './lib/shapes/shared/freehand/types'
181
+ export { PlainTextLabel, type PlainTextLabelProps } from './lib/shapes/shared/PlainTextLabel'
174
182
  export {
175
183
  RichTextLabel,
176
184
  RichTextSVG,
@@ -178,10 +186,9 @@ export {
178
186
  type RichTextSVGProps,
179
187
  } from './lib/shapes/shared/RichTextLabel'
180
188
  export { useDefaultColorTheme } from './lib/shapes/shared/useDefaultColorTheme'
181
- export { useEditablePlainText, useEditableText } from './lib/shapes/shared/useEditablePlainText'
189
+ export { useEditablePlainText } from './lib/shapes/shared/useEditablePlainText'
182
190
  export { useEditableRichText } from './lib/shapes/shared/useEditableRichText'
183
191
  export {
184
- useAsset,
185
192
  useImageOrVideoAsset,
186
193
  type UseImageOrVideoAssetOptions,
187
194
  } from './lib/shapes/shared/useImageOrVideoAsset'
@@ -360,10 +367,6 @@ export {
360
367
  TldrawUiMenuSubmenu,
361
368
  type TLUiMenuSubmenuProps,
362
369
  } from './lib/ui/components/primitives/menus/TldrawUiMenuSubmenu'
363
- export {
364
- TldrawUiButtonPicker,
365
- type TLUiButtonPickerProps,
366
- } from './lib/ui/components/primitives/TldrawUiButtonPicker'
367
370
  export {
368
371
  TldrawUiContextualToolbar,
369
372
  type TLUiContextualToolbarProps,
@@ -443,17 +446,44 @@ export {
443
446
  type TLUiStylePanelProps,
444
447
  } from './lib/ui/components/StylePanel/DefaultStylePanel'
445
448
  export {
446
- ArrowheadStylePickerSet,
447
- CommonStylePickerSet,
448
449
  DefaultStylePanelContent,
449
- GeoStylePickerSet,
450
- OpacitySlider,
451
- SplineStylePickerSet,
452
- TextStylePickerSet,
453
- type StylePickerSetProps,
454
- type ThemeStylePickerSetProps,
455
- type TLUiStylePanelContentProps,
450
+ StylePanelArrowheadPicker,
451
+ StylePanelArrowKindPicker,
452
+ StylePanelColorPicker,
453
+ StylePanelDashPicker,
454
+ StylePanelFillPicker,
455
+ StylePanelFontPicker,
456
+ StylePanelGeoShapePicker,
457
+ StylePanelLabelAlignPicker,
458
+ StylePanelOpacityPicker,
459
+ StylePanelSection,
460
+ StylePanelSizePicker,
461
+ StylePanelSplinePicker,
462
+ StylePanelTextAlignPicker,
463
+ type StylePanelSectionProps,
456
464
  } from './lib/ui/components/StylePanel/DefaultStylePanelContent'
465
+ export {
466
+ StylePanelButtonPicker,
467
+ type StylePanelButtonPickerProps,
468
+ } from './lib/ui/components/StylePanel/StylePanelButtonPicker'
469
+ export {
470
+ StylePanelContextProvider,
471
+ useStylePanelContext,
472
+ type StylePanelContext,
473
+ type StylePanelContextProviderProps,
474
+ } from './lib/ui/components/StylePanel/StylePanelContext'
475
+ export {
476
+ StylePanelDoubleDropdownPicker,
477
+ type StylePanelDoubleDropdownPickerProps,
478
+ } from './lib/ui/components/StylePanel/StylePanelDoubleDropdownPicker'
479
+ export {
480
+ StylePanelDropdownPicker,
481
+ type StylePanelDropdownPickerProps,
482
+ } from './lib/ui/components/StylePanel/StylePanelDropdownPicker'
483
+ export {
484
+ StylePanelSubheading,
485
+ type StylePanelSubheadingProps,
486
+ } from './lib/ui/components/StylePanel/StylePanelSubheading'
457
487
  export {
458
488
  DefaultImageToolbar,
459
489
  type TLUiImageToolbarProps,
@@ -625,13 +655,12 @@ export {
625
655
  } from './lib/ui/hooks/useTranslation/useTranslation'
626
656
  export { type TLUiIconType } from './lib/ui/icon-types'
627
657
  export { useDefaultHelpers, type TLUiOverrideHelpers, type TLUiOverrides } from './lib/ui/overrides'
628
- export { TldrawUi, type TldrawUiProps } from './lib/ui/TldrawUi'
658
+ export { TldrawUi, TldrawUiInFrontOfTheCanvas, type TldrawUiProps } from './lib/ui/TldrawUi'
629
659
  export { containBoxSize, downsizeImage, type BoxWidthHeight } from './lib/utils/assets/assets'
630
660
  export { preloadFont, type TLTypeFace } from './lib/utils/assets/preload-font'
631
661
  export { getEmbedInfo, type TLEmbedResult } from './lib/utils/embeds/embeds'
632
662
  export { putExcalidrawContent } from './lib/utils/excalidraw/putExcalidrawContent'
633
663
  export { copyAs, type CopyAsOptions, type TLCopyType } from './lib/utils/export/copyAs'
634
- export { exportToBlob } from './lib/utils/export/export'
635
664
  export { downloadFile, exportAs, type ExportAsOptions } from './lib/utils/export/exportAs'
636
665
  export { fitFrameToContent, removeFrame } from './lib/utils/frames/frames'
637
666
  export {
@@ -33,7 +33,7 @@ import { registerDefaultSideEffects } from './defaultSideEffects'
33
33
  import { defaultTools } from './defaultTools'
34
34
  import { EmbedShapeUtil } from './shapes/embed/EmbedShapeUtil'
35
35
  import { allDefaultFontFaces } from './shapes/shared/defaultFonts'
36
- import { TldrawUi, TldrawUiProps } from './ui/TldrawUi'
36
+ import { TldrawUi, TldrawUiInFrontOfTheCanvas, TldrawUiProps } from './ui/TldrawUi'
37
37
  import { TLUiAssetUrlOverrides, useDefaultUiAssetUrlsWithOverrides } from './ui/assetUrls'
38
38
  import { LoadingScreen } from './ui/components/LoadingScreen'
39
39
  import { Spinner } from './ui/components/Spinner'
@@ -118,6 +118,18 @@ export function Tldraw(props: TldrawProps) {
118
118
 
119
119
  const _components = useShallowObjectIdentity(components)
120
120
 
121
+ const CustomInFrontOfTheCanvas = components?.InFrontOfTheCanvas
122
+ const InFrontOfTheCanvas = useMemo(() => {
123
+ if (rest.hideUi) return CustomInFrontOfTheCanvas ?? null
124
+ if (!CustomInFrontOfTheCanvas) return TldrawUiInFrontOfTheCanvas
125
+
126
+ return () => (
127
+ <>
128
+ <TldrawUiInFrontOfTheCanvas />
129
+ <CustomInFrontOfTheCanvas />
130
+ </>
131
+ )
132
+ }, [rest.hideUi, CustomInFrontOfTheCanvas])
121
133
  const componentsWithDefault = useMemo(
122
134
  () => ({
123
135
  Scribble: TldrawScribble,
@@ -129,8 +141,9 @@ export function Tldraw(props: TldrawProps) {
129
141
  Spinner,
130
142
  LoadingScreen,
131
143
  ..._components,
144
+ InFrontOfTheCanvas,
132
145
  }),
133
- [_components]
146
+ [_components, InFrontOfTheCanvas]
134
147
  )
135
148
 
136
149
  const _shapeUtils = useShallowArrayIdentity(shapeUtils)
@@ -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