tldraw 5.2.0-next.ee0fa4d6244f → 5.2.0

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 (474) hide show
  1. package/DOCS.md +20294 -0
  2. package/README.md +13 -1
  3. package/RELEASE_NOTES.md +2908 -0
  4. package/dist-cjs/index.d.ts +110 -25
  5. package/dist-cjs/index.js +3 -3
  6. package/dist-cjs/index.js.map +2 -2
  7. package/dist-cjs/lib/TldrawImage.js +0 -1
  8. package/dist-cjs/lib/TldrawImage.js.map +2 -2
  9. package/dist-cjs/lib/bindings/arrow/ArrowBindingUtil.js +2 -1
  10. package/dist-cjs/lib/bindings/arrow/ArrowBindingUtil.js.map +2 -2
  11. package/dist-cjs/lib/defaultEmbedDefinitions.js +3 -2
  12. package/dist-cjs/lib/defaultEmbedDefinitions.js.map +2 -2
  13. package/dist-cjs/lib/defaultOverlayUtils.js +11 -11
  14. package/dist-cjs/lib/defaultOverlayUtils.js.map +2 -2
  15. package/dist-cjs/lib/overlays/SelectionForegroundOverlayUtil.js +76 -64
  16. package/dist-cjs/lib/overlays/SelectionForegroundOverlayUtil.js.map +2 -2
  17. package/dist-cjs/lib/overlays/ShapeHandleOverlayUtil.js +1 -1
  18. package/dist-cjs/lib/overlays/ShapeHandleOverlayUtil.js.map +2 -2
  19. package/dist-cjs/lib/overlays/ShapeIndicatorOverlayUtil.js +107 -0
  20. package/dist-cjs/lib/overlays/ShapeIndicatorOverlayUtil.js.map +7 -0
  21. package/dist-cjs/lib/shapes/arrow/toolStates/Pointing.js +3 -0
  22. package/dist-cjs/lib/shapes/arrow/toolStates/Pointing.js.map +2 -2
  23. package/dist-cjs/lib/shapes/bookmark/BookmarkShapeUtil.js +12 -3
  24. package/dist-cjs/lib/shapes/bookmark/BookmarkShapeUtil.js.map +2 -2
  25. package/dist-cjs/lib/shapes/bookmark/bookmarks.js +54 -6
  26. package/dist-cjs/lib/shapes/bookmark/bookmarks.js.map +2 -2
  27. package/dist-cjs/lib/shapes/draw/DrawShapeUtil.js +2 -1
  28. package/dist-cjs/lib/shapes/draw/DrawShapeUtil.js.map +2 -2
  29. package/dist-cjs/lib/shapes/draw/getPath.js +1 -1
  30. package/dist-cjs/lib/shapes/draw/getPath.js.map +2 -2
  31. package/dist-cjs/lib/shapes/draw/toolStates/Drawing.js +45 -47
  32. package/dist-cjs/lib/shapes/draw/toolStates/Drawing.js.map +2 -2
  33. package/dist-cjs/lib/shapes/embed/EmbedShapeUtil.js +2 -1
  34. package/dist-cjs/lib/shapes/embed/EmbedShapeUtil.js.map +2 -2
  35. package/dist-cjs/lib/shapes/frame/FrameShapeTool.js +23 -18
  36. package/dist-cjs/lib/shapes/frame/FrameShapeTool.js.map +2 -2
  37. package/dist-cjs/lib/shapes/geo/GeoShapeUtil.js +1 -1
  38. package/dist-cjs/lib/shapes/geo/GeoShapeUtil.js.map +2 -2
  39. package/dist-cjs/lib/shapes/geo/toolStates/Pointing.js +3 -0
  40. package/dist-cjs/lib/shapes/geo/toolStates/Pointing.js.map +2 -2
  41. package/dist-cjs/lib/shapes/highlight/HighlightShapeUtil.js +11 -7
  42. package/dist-cjs/lib/shapes/highlight/HighlightShapeUtil.js.map +2 -2
  43. package/dist-cjs/lib/shapes/image/ImageShapeUtil.js +3 -11
  44. package/dist-cjs/lib/shapes/image/ImageShapeUtil.js.map +2 -2
  45. package/dist-cjs/lib/shapes/line/toolStates/Pointing.js +5 -1
  46. package/dist-cjs/lib/shapes/line/toolStates/Pointing.js.map +2 -2
  47. package/dist-cjs/lib/shapes/note/NoteShapeUtil.js +31 -41
  48. package/dist-cjs/lib/shapes/note/NoteShapeUtil.js.map +2 -2
  49. package/dist-cjs/lib/shapes/note/noteHelpers.js +1 -1
  50. package/dist-cjs/lib/shapes/note/noteHelpers.js.map +2 -2
  51. package/dist-cjs/lib/shapes/note/toolStates/Pointing.js +28 -6
  52. package/dist-cjs/lib/shapes/note/toolStates/Pointing.js.map +2 -2
  53. package/dist-cjs/lib/shapes/shared/PlainTextLabel.js +3 -2
  54. package/dist-cjs/lib/shapes/shared/PlainTextLabel.js.map +2 -2
  55. package/dist-cjs/lib/shapes/shared/RichTextLabel.js +3 -3
  56. package/dist-cjs/lib/shapes/shared/RichTextLabel.js.map +2 -2
  57. package/dist-cjs/lib/shapes/shared/defaultStyleDefs.js +17 -3
  58. package/dist-cjs/lib/shapes/shared/defaultStyleDefs.js.map +2 -2
  59. package/dist-cjs/lib/shapes/shared/freehand/core.js +424 -0
  60. package/dist-cjs/lib/shapes/shared/freehand/core.js.map +7 -0
  61. package/dist-cjs/lib/shapes/shared/freehand/fmt.js +106 -0
  62. package/dist-cjs/lib/shapes/shared/freehand/fmt.js.map +7 -0
  63. package/dist-cjs/lib/shapes/shared/freehand/getStroke.js +6 -6
  64. package/dist-cjs/lib/shapes/shared/freehand/getStroke.js.map +2 -2
  65. package/dist-cjs/lib/shapes/shared/freehand/getStrokeOutlinePoints.js +320 -86
  66. package/dist-cjs/lib/shapes/shared/freehand/getStrokeOutlinePoints.js.map +3 -3
  67. package/dist-cjs/lib/shapes/shared/freehand/getStrokePoints.js +20 -96
  68. package/dist-cjs/lib/shapes/shared/freehand/getStrokePoints.js.map +3 -3
  69. package/dist-cjs/lib/shapes/shared/freehand/svg.js +55 -19
  70. package/dist-cjs/lib/shapes/shared/freehand/svg.js.map +2 -2
  71. package/dist-cjs/lib/shapes/shared/freehand/svgInk.js +189 -97
  72. package/dist-cjs/lib/shapes/shared/freehand/svgInk.js.map +3 -3
  73. package/dist-cjs/lib/shapes/shared/freehand/types.js.map +1 -1
  74. package/dist-cjs/lib/shapes/shared/interpolate-props.js +6 -2
  75. package/dist-cjs/lib/shapes/shared/interpolate-props.js.map +2 -2
  76. package/dist-cjs/lib/shapes/text/toolStates/Pointing.js +3 -0
  77. package/dist-cjs/lib/shapes/text/toolStates/Pointing.js.map +2 -2
  78. package/dist-cjs/lib/tools/HandTool/HandTool.js +14 -25
  79. package/dist-cjs/lib/tools/HandTool/HandTool.js.map +2 -2
  80. package/dist-cjs/lib/tools/HandTool/childStates/Dragging.js +10 -1
  81. package/dist-cjs/lib/tools/HandTool/childStates/Dragging.js.map +2 -2
  82. package/dist-cjs/lib/tools/HandTool/childStates/OneFingerZooming.js +84 -0
  83. package/dist-cjs/lib/tools/HandTool/childStates/OneFingerZooming.js.map +7 -0
  84. package/dist-cjs/lib/tools/SelectTool/childStates/Crop/Crop.js +3 -1
  85. package/dist-cjs/lib/tools/SelectTool/childStates/Crop/Crop.js.map +2 -2
  86. package/dist-cjs/lib/tools/SelectTool/childStates/Crop/children/Idle.js +1 -1
  87. package/dist-cjs/lib/tools/SelectTool/childStates/Crop/children/Idle.js.map +2 -2
  88. package/dist-cjs/lib/tools/SelectTool/childStates/Crop/children/PointingCrop.js +7 -0
  89. package/dist-cjs/lib/tools/SelectTool/childStates/Crop/children/PointingCrop.js.map +2 -2
  90. package/dist-cjs/lib/tools/SelectTool/childStates/Crop/children/PointingCropHandle.js +7 -0
  91. package/dist-cjs/lib/tools/SelectTool/childStates/Crop/children/PointingCropHandle.js.map +2 -2
  92. package/dist-cjs/lib/tools/SelectTool/childStates/Idle.js +13 -1
  93. package/dist-cjs/lib/tools/SelectTool/childStates/Idle.js.map +2 -2
  94. package/dist-cjs/lib/tools/SelectTool/childStates/PointingCanvas.js +7 -0
  95. package/dist-cjs/lib/tools/SelectTool/childStates/PointingCanvas.js.map +2 -2
  96. package/dist-cjs/lib/tools/SelectTool/childStates/PointingHandle.js +7 -0
  97. package/dist-cjs/lib/tools/SelectTool/childStates/PointingHandle.js.map +2 -2
  98. package/dist-cjs/lib/tools/SelectTool/childStates/PointingResizeHandle.js +7 -0
  99. package/dist-cjs/lib/tools/SelectTool/childStates/PointingResizeHandle.js.map +2 -2
  100. package/dist-cjs/lib/tools/SelectTool/childStates/PointingRotateHandle.js +7 -0
  101. package/dist-cjs/lib/tools/SelectTool/childStates/PointingRotateHandle.js.map +2 -2
  102. package/dist-cjs/lib/tools/SelectTool/childStates/PointingSelection.js +4 -1
  103. package/dist-cjs/lib/tools/SelectTool/childStates/PointingSelection.js.map +2 -2
  104. package/dist-cjs/lib/tools/SelectTool/childStates/PointingShape.js +14 -1
  105. package/dist-cjs/lib/tools/SelectTool/childStates/PointingShape.js.map +2 -2
  106. package/dist-cjs/lib/tools/SelectTool/childStates/Resizing.js +107 -46
  107. package/dist-cjs/lib/tools/SelectTool/childStates/Resizing.js.map +2 -2
  108. package/dist-cjs/lib/ui/TldrawUi.js +4 -3
  109. package/dist-cjs/lib/ui/TldrawUi.js.map +2 -2
  110. package/dist-cjs/lib/ui/components/A11y.js +2 -0
  111. package/dist-cjs/lib/ui/components/A11y.js.map +2 -2
  112. package/dist-cjs/lib/ui/components/ContextMenu/DefaultContextMenu.js +14 -1
  113. package/dist-cjs/lib/ui/components/ContextMenu/DefaultContextMenu.js.map +2 -2
  114. package/dist-cjs/lib/ui/components/ContextMenu/DefaultContextMenuContent.js +0 -6
  115. package/dist-cjs/lib/ui/components/ContextMenu/DefaultContextMenuContent.js.map +2 -2
  116. package/dist-cjs/lib/ui/components/DefaultFollowingIndicator.js.map +2 -2
  117. package/dist-cjs/lib/ui/components/Dialogs.js +17 -37
  118. package/dist-cjs/lib/ui/components/Dialogs.js.map +2 -2
  119. package/dist-cjs/lib/ui/components/HelperButtons/BackToContent.js +19 -4
  120. package/dist-cjs/lib/ui/components/HelperButtons/BackToContent.js.map +2 -2
  121. package/dist-cjs/lib/ui/components/KeyboardShortcutsDialog/DefaultKeyboardShortcutsDialogContent.js +12 -2
  122. package/dist-cjs/lib/ui/components/KeyboardShortcutsDialog/DefaultKeyboardShortcutsDialogContent.js.map +2 -2
  123. package/dist-cjs/lib/ui/components/Minimap/DefaultMinimap.js +47 -70
  124. package/dist-cjs/lib/ui/components/Minimap/DefaultMinimap.js.map +2 -2
  125. package/dist-cjs/lib/ui/components/Minimap/MinimapManager.js +25 -46
  126. package/dist-cjs/lib/ui/components/Minimap/MinimapManager.js.map +2 -2
  127. package/dist-cjs/lib/ui/components/SharePanel/DefaultPeopleMenuAvatar.js.map +2 -2
  128. package/dist-cjs/lib/ui/components/SharePanel/DefaultPeopleMenuContent.js.map +2 -2
  129. package/dist-cjs/lib/ui/components/SharePanel/DefaultPeopleMenuFacePile.js.map +2 -2
  130. package/dist-cjs/lib/ui/components/SharePanel/DefaultPeopleMenuItem.js +1 -1
  131. package/dist-cjs/lib/ui/components/SharePanel/DefaultPeopleMenuItem.js.map +2 -2
  132. package/dist-cjs/lib/ui/components/StylePanel/StylePanelButtonPicker.js +1 -0
  133. package/dist-cjs/lib/ui/components/StylePanel/StylePanelButtonPicker.js.map +2 -2
  134. package/dist-cjs/lib/ui/components/StylePanel/StylePanelDropdownPicker.js +2 -1
  135. package/dist-cjs/lib/ui/components/StylePanel/StylePanelDropdownPicker.js.map +2 -2
  136. package/dist-cjs/lib/ui/components/menu-items.js +7 -0
  137. package/dist-cjs/lib/ui/components/menu-items.js.map +2 -2
  138. package/dist-cjs/lib/ui/components/primitives/TldrawUiDropdownMenu.js +2 -1
  139. package/dist-cjs/lib/ui/components/primitives/TldrawUiDropdownMenu.js.map +2 -2
  140. package/dist-cjs/lib/ui/components/primitives/TldrawUiIcon.js +14 -3
  141. package/dist-cjs/lib/ui/components/primitives/TldrawUiIcon.js.map +2 -2
  142. package/dist-cjs/lib/ui/components/primitives/TldrawUiInput.js +2 -0
  143. package/dist-cjs/lib/ui/components/primitives/TldrawUiInput.js.map +2 -2
  144. package/dist-cjs/lib/ui/components/primitives/TldrawUiPopover.js +2 -0
  145. package/dist-cjs/lib/ui/components/primitives/TldrawUiPopover.js.map +2 -2
  146. package/dist-cjs/lib/ui/components/primitives/menus/TldrawUiMenuCheckboxItem.js +0 -2
  147. package/dist-cjs/lib/ui/components/primitives/menus/TldrawUiMenuCheckboxItem.js.map +2 -2
  148. package/dist-cjs/lib/ui/components/primitives/menus/TldrawUiMenuSubmenu.js +1 -2
  149. package/dist-cjs/lib/ui/components/primitives/menus/TldrawUiMenuSubmenu.js.map +2 -2
  150. package/dist-cjs/lib/ui/context/actions.js +70 -1
  151. package/dist-cjs/lib/ui/context/actions.js.map +2 -2
  152. package/dist-cjs/lib/ui/context/asset-urls.js +5 -8
  153. package/dist-cjs/lib/ui/context/asset-urls.js.map +2 -2
  154. package/dist-cjs/lib/ui/context/events.js.map +2 -2
  155. package/dist-cjs/lib/ui/hooks/useKeyboardShortcuts.js +13 -0
  156. package/dist-cjs/lib/ui/hooks/useKeyboardShortcuts.js.map +2 -2
  157. package/dist-cjs/lib/ui/hooks/useTools.js +1 -1
  158. package/dist-cjs/lib/ui/hooks/useTools.js.map +2 -2
  159. package/dist-cjs/lib/ui/hooks/useTranslation/TLUiTranslationKey.js.map +1 -1
  160. package/dist-cjs/lib/ui/hooks/useTranslation/defaultTranslation.js +2 -0
  161. package/dist-cjs/lib/ui/hooks/useTranslation/defaultTranslation.js.map +2 -2
  162. package/dist-cjs/lib/ui/version.js +3 -3
  163. package/dist-cjs/lib/ui/version.js.map +1 -1
  164. package/dist-cjs/lib/utils/embeds/embeds.js +4 -4
  165. package/dist-cjs/lib/utils/embeds/embeds.js.map +2 -2
  166. package/dist-cjs/lib/utils/test-helpers.js +2 -2
  167. package/dist-cjs/lib/utils/test-helpers.js.map +2 -2
  168. package/dist-cjs/lib/utils/text/richText.js +3 -1
  169. package/dist-cjs/lib/utils/text/richText.js.map +2 -2
  170. package/dist-esm/index.d.mts +110 -25
  171. package/dist-esm/index.mjs +5 -3
  172. package/dist-esm/index.mjs.map +2 -2
  173. package/dist-esm/lib/TldrawImage.mjs +0 -1
  174. package/dist-esm/lib/TldrawImage.mjs.map +2 -2
  175. package/dist-esm/lib/bindings/arrow/ArrowBindingUtil.mjs +2 -1
  176. package/dist-esm/lib/bindings/arrow/ArrowBindingUtil.mjs.map +2 -2
  177. package/dist-esm/lib/defaultEmbedDefinitions.mjs +3 -2
  178. package/dist-esm/lib/defaultEmbedDefinitions.mjs.map +2 -2
  179. package/dist-esm/lib/defaultOverlayUtils.mjs +11 -11
  180. package/dist-esm/lib/defaultOverlayUtils.mjs.map +2 -2
  181. package/dist-esm/lib/overlays/SelectionForegroundOverlayUtil.mjs +77 -65
  182. package/dist-esm/lib/overlays/SelectionForegroundOverlayUtil.mjs.map +2 -2
  183. package/dist-esm/lib/overlays/ShapeHandleOverlayUtil.mjs +1 -1
  184. package/dist-esm/lib/overlays/ShapeHandleOverlayUtil.mjs.map +2 -2
  185. package/dist-esm/lib/overlays/ShapeIndicatorOverlayUtil.mjs +87 -0
  186. package/dist-esm/lib/overlays/ShapeIndicatorOverlayUtil.mjs.map +7 -0
  187. package/dist-esm/lib/shapes/arrow/toolStates/Pointing.mjs +9 -1
  188. package/dist-esm/lib/shapes/arrow/toolStates/Pointing.mjs.map +2 -2
  189. package/dist-esm/lib/shapes/bookmark/BookmarkShapeUtil.mjs +15 -3
  190. package/dist-esm/lib/shapes/bookmark/BookmarkShapeUtil.mjs.map +2 -2
  191. package/dist-esm/lib/shapes/bookmark/bookmarks.mjs +54 -6
  192. package/dist-esm/lib/shapes/bookmark/bookmarks.mjs.map +2 -2
  193. package/dist-esm/lib/shapes/draw/DrawShapeUtil.mjs +3 -1
  194. package/dist-esm/lib/shapes/draw/DrawShapeUtil.mjs.map +2 -2
  195. package/dist-esm/lib/shapes/draw/getPath.mjs +1 -1
  196. package/dist-esm/lib/shapes/draw/getPath.mjs.map +2 -2
  197. package/dist-esm/lib/shapes/draw/toolStates/Drawing.mjs +46 -47
  198. package/dist-esm/lib/shapes/draw/toolStates/Drawing.mjs.map +2 -2
  199. package/dist-esm/lib/shapes/embed/EmbedShapeUtil.mjs +2 -1
  200. package/dist-esm/lib/shapes/embed/EmbedShapeUtil.mjs.map +2 -2
  201. package/dist-esm/lib/shapes/frame/FrameShapeTool.mjs +23 -18
  202. package/dist-esm/lib/shapes/frame/FrameShapeTool.mjs.map +2 -2
  203. package/dist-esm/lib/shapes/geo/GeoShapeUtil.mjs +2 -1
  204. package/dist-esm/lib/shapes/geo/GeoShapeUtil.mjs.map +2 -2
  205. package/dist-esm/lib/shapes/geo/toolStates/Pointing.mjs +4 -0
  206. package/dist-esm/lib/shapes/geo/toolStates/Pointing.mjs.map +2 -2
  207. package/dist-esm/lib/shapes/highlight/HighlightShapeUtil.mjs +12 -7
  208. package/dist-esm/lib/shapes/highlight/HighlightShapeUtil.mjs.map +2 -2
  209. package/dist-esm/lib/shapes/image/ImageShapeUtil.mjs +3 -11
  210. package/dist-esm/lib/shapes/image/ImageShapeUtil.mjs.map +2 -2
  211. package/dist-esm/lib/shapes/line/toolStates/Pointing.mjs +6 -1
  212. package/dist-esm/lib/shapes/line/toolStates/Pointing.mjs.map +2 -2
  213. package/dist-esm/lib/shapes/note/NoteShapeUtil.mjs +32 -42
  214. package/dist-esm/lib/shapes/note/NoteShapeUtil.mjs.map +2 -2
  215. package/dist-esm/lib/shapes/note/noteHelpers.mjs +1 -1
  216. package/dist-esm/lib/shapes/note/noteHelpers.mjs.map +2 -2
  217. package/dist-esm/lib/shapes/note/toolStates/Pointing.mjs +29 -6
  218. package/dist-esm/lib/shapes/note/toolStates/Pointing.mjs.map +2 -2
  219. package/dist-esm/lib/shapes/shared/PlainTextLabel.mjs +3 -2
  220. package/dist-esm/lib/shapes/shared/PlainTextLabel.mjs.map +2 -2
  221. package/dist-esm/lib/shapes/shared/RichTextLabel.mjs +4 -3
  222. package/dist-esm/lib/shapes/shared/RichTextLabel.mjs.map +2 -2
  223. package/dist-esm/lib/shapes/shared/defaultStyleDefs.mjs +17 -3
  224. package/dist-esm/lib/shapes/shared/defaultStyleDefs.mjs.map +2 -2
  225. package/dist-esm/lib/shapes/shared/freehand/core.mjs +404 -0
  226. package/dist-esm/lib/shapes/shared/freehand/core.mjs.map +7 -0
  227. package/dist-esm/lib/shapes/shared/freehand/fmt.mjs +86 -0
  228. package/dist-esm/lib/shapes/shared/freehand/fmt.mjs.map +7 -0
  229. package/dist-esm/lib/shapes/shared/freehand/getStroke.mjs +7 -7
  230. package/dist-esm/lib/shapes/shared/freehand/getStroke.mjs.map +2 -2
  231. package/dist-esm/lib/shapes/shared/freehand/getStrokeOutlinePoints.mjs +332 -86
  232. package/dist-esm/lib/shapes/shared/freehand/getStrokeOutlinePoints.mjs.map +3 -3
  233. package/dist-esm/lib/shapes/shared/freehand/getStrokePoints.mjs +31 -96
  234. package/dist-esm/lib/shapes/shared/freehand/getStrokePoints.mjs.map +3 -3
  235. package/dist-esm/lib/shapes/shared/freehand/svg.mjs +55 -19
  236. package/dist-esm/lib/shapes/shared/freehand/svg.mjs.map +2 -2
  237. package/dist-esm/lib/shapes/shared/freehand/svgInk.mjs +214 -99
  238. package/dist-esm/lib/shapes/shared/freehand/svgInk.mjs.map +3 -3
  239. package/dist-esm/lib/shapes/shared/interpolate-props.mjs +6 -2
  240. package/dist-esm/lib/shapes/shared/interpolate-props.mjs.map +2 -2
  241. package/dist-esm/lib/shapes/text/toolStates/Pointing.mjs +4 -0
  242. package/dist-esm/lib/shapes/text/toolStates/Pointing.mjs.map +2 -2
  243. package/dist-esm/lib/tools/HandTool/HandTool.mjs +14 -25
  244. package/dist-esm/lib/tools/HandTool/HandTool.mjs.map +2 -2
  245. package/dist-esm/lib/tools/HandTool/childStates/Dragging.mjs +10 -1
  246. package/dist-esm/lib/tools/HandTool/childStates/Dragging.mjs.map +2 -2
  247. package/dist-esm/lib/tools/HandTool/childStates/OneFingerZooming.mjs +64 -0
  248. package/dist-esm/lib/tools/HandTool/childStates/OneFingerZooming.mjs.map +7 -0
  249. package/dist-esm/lib/tools/SelectTool/childStates/Crop/Crop.mjs +3 -1
  250. package/dist-esm/lib/tools/SelectTool/childStates/Crop/Crop.mjs.map +2 -2
  251. package/dist-esm/lib/tools/SelectTool/childStates/Crop/children/Idle.mjs +1 -1
  252. package/dist-esm/lib/tools/SelectTool/childStates/Crop/children/Idle.mjs.map +2 -2
  253. package/dist-esm/lib/tools/SelectTool/childStates/Crop/children/PointingCrop.mjs +7 -0
  254. package/dist-esm/lib/tools/SelectTool/childStates/Crop/children/PointingCrop.mjs.map +2 -2
  255. package/dist-esm/lib/tools/SelectTool/childStates/Crop/children/PointingCropHandle.mjs +7 -0
  256. package/dist-esm/lib/tools/SelectTool/childStates/Crop/children/PointingCropHandle.mjs.map +2 -2
  257. package/dist-esm/lib/tools/SelectTool/childStates/Idle.mjs +13 -1
  258. package/dist-esm/lib/tools/SelectTool/childStates/Idle.mjs.map +2 -2
  259. package/dist-esm/lib/tools/SelectTool/childStates/PointingCanvas.mjs +7 -0
  260. package/dist-esm/lib/tools/SelectTool/childStates/PointingCanvas.mjs.map +2 -2
  261. package/dist-esm/lib/tools/SelectTool/childStates/PointingHandle.mjs +11 -1
  262. package/dist-esm/lib/tools/SelectTool/childStates/PointingHandle.mjs.map +2 -2
  263. package/dist-esm/lib/tools/SelectTool/childStates/PointingResizeHandle.mjs +10 -1
  264. package/dist-esm/lib/tools/SelectTool/childStates/PointingResizeHandle.mjs.map +2 -2
  265. package/dist-esm/lib/tools/SelectTool/childStates/PointingRotateHandle.mjs +7 -0
  266. package/dist-esm/lib/tools/SelectTool/childStates/PointingRotateHandle.mjs.map +2 -2
  267. package/dist-esm/lib/tools/SelectTool/childStates/PointingSelection.mjs +4 -1
  268. package/dist-esm/lib/tools/SelectTool/childStates/PointingSelection.mjs.map +2 -2
  269. package/dist-esm/lib/tools/SelectTool/childStates/PointingShape.mjs +14 -1
  270. package/dist-esm/lib/tools/SelectTool/childStates/PointingShape.mjs.map +2 -2
  271. package/dist-esm/lib/tools/SelectTool/childStates/Resizing.mjs +108 -46
  272. package/dist-esm/lib/tools/SelectTool/childStates/Resizing.mjs.map +2 -2
  273. package/dist-esm/lib/ui/TldrawUi.mjs +4 -3
  274. package/dist-esm/lib/ui/TldrawUi.mjs.map +2 -2
  275. package/dist-esm/lib/ui/components/A11y.mjs +2 -0
  276. package/dist-esm/lib/ui/components/A11y.mjs.map +2 -2
  277. package/dist-esm/lib/ui/components/ContextMenu/DefaultContextMenu.mjs +21 -2
  278. package/dist-esm/lib/ui/components/ContextMenu/DefaultContextMenu.mjs.map +2 -2
  279. package/dist-esm/lib/ui/components/ContextMenu/DefaultContextMenuContent.mjs +0 -6
  280. package/dist-esm/lib/ui/components/ContextMenu/DefaultContextMenuContent.mjs.map +2 -2
  281. package/dist-esm/lib/ui/components/DefaultFollowingIndicator.mjs.map +2 -2
  282. package/dist-esm/lib/ui/components/Dialogs.mjs +19 -39
  283. package/dist-esm/lib/ui/components/Dialogs.mjs.map +2 -2
  284. package/dist-esm/lib/ui/components/HelperButtons/BackToContent.mjs +20 -5
  285. package/dist-esm/lib/ui/components/HelperButtons/BackToContent.mjs.map +2 -2
  286. package/dist-esm/lib/ui/components/KeyboardShortcutsDialog/DefaultKeyboardShortcutsDialogContent.mjs +12 -2
  287. package/dist-esm/lib/ui/components/KeyboardShortcutsDialog/DefaultKeyboardShortcutsDialogContent.mjs.map +2 -2
  288. package/dist-esm/lib/ui/components/Minimap/DefaultMinimap.mjs +47 -70
  289. package/dist-esm/lib/ui/components/Minimap/DefaultMinimap.mjs.map +2 -2
  290. package/dist-esm/lib/ui/components/Minimap/MinimapManager.mjs +25 -46
  291. package/dist-esm/lib/ui/components/Minimap/MinimapManager.mjs.map +2 -2
  292. package/dist-esm/lib/ui/components/SharePanel/DefaultPeopleMenuAvatar.mjs.map +2 -2
  293. package/dist-esm/lib/ui/components/SharePanel/DefaultPeopleMenuContent.mjs.map +2 -2
  294. package/dist-esm/lib/ui/components/SharePanel/DefaultPeopleMenuFacePile.mjs.map +2 -2
  295. package/dist-esm/lib/ui/components/SharePanel/DefaultPeopleMenuItem.mjs +1 -1
  296. package/dist-esm/lib/ui/components/SharePanel/DefaultPeopleMenuItem.mjs.map +2 -2
  297. package/dist-esm/lib/ui/components/StylePanel/StylePanelButtonPicker.mjs +1 -0
  298. package/dist-esm/lib/ui/components/StylePanel/StylePanelButtonPicker.mjs.map +2 -2
  299. package/dist-esm/lib/ui/components/StylePanel/StylePanelDropdownPicker.mjs +2 -1
  300. package/dist-esm/lib/ui/components/StylePanel/StylePanelDropdownPicker.mjs.map +2 -2
  301. package/dist-esm/lib/ui/components/menu-items.mjs +7 -0
  302. package/dist-esm/lib/ui/components/menu-items.mjs.map +2 -2
  303. package/dist-esm/lib/ui/components/primitives/TldrawUiDropdownMenu.mjs +2 -1
  304. package/dist-esm/lib/ui/components/primitives/TldrawUiDropdownMenu.mjs.map +2 -2
  305. package/dist-esm/lib/ui/components/primitives/TldrawUiIcon.mjs +14 -3
  306. package/dist-esm/lib/ui/components/primitives/TldrawUiIcon.mjs.map +2 -2
  307. package/dist-esm/lib/ui/components/primitives/TldrawUiInput.mjs +2 -0
  308. package/dist-esm/lib/ui/components/primitives/TldrawUiInput.mjs.map +2 -2
  309. package/dist-esm/lib/ui/components/primitives/TldrawUiPopover.mjs +2 -0
  310. package/dist-esm/lib/ui/components/primitives/TldrawUiPopover.mjs.map +2 -2
  311. package/dist-esm/lib/ui/components/primitives/menus/TldrawUiMenuCheckboxItem.mjs +0 -2
  312. package/dist-esm/lib/ui/components/primitives/menus/TldrawUiMenuCheckboxItem.mjs.map +2 -2
  313. package/dist-esm/lib/ui/components/primitives/menus/TldrawUiMenuSubmenu.mjs +1 -2
  314. package/dist-esm/lib/ui/components/primitives/menus/TldrawUiMenuSubmenu.mjs.map +2 -2
  315. package/dist-esm/lib/ui/context/actions.mjs +71 -1
  316. package/dist-esm/lib/ui/context/actions.mjs.map +2 -2
  317. package/dist-esm/lib/ui/context/asset-urls.mjs +5 -8
  318. package/dist-esm/lib/ui/context/asset-urls.mjs.map +2 -2
  319. package/dist-esm/lib/ui/context/events.mjs.map +2 -2
  320. package/dist-esm/lib/ui/hooks/useKeyboardShortcuts.mjs +13 -0
  321. package/dist-esm/lib/ui/hooks/useKeyboardShortcuts.mjs.map +2 -2
  322. package/dist-esm/lib/ui/hooks/useTools.mjs +1 -1
  323. package/dist-esm/lib/ui/hooks/useTools.mjs.map +2 -2
  324. package/dist-esm/lib/ui/hooks/useTranslation/defaultTranslation.mjs +2 -0
  325. package/dist-esm/lib/ui/hooks/useTranslation/defaultTranslation.mjs.map +2 -2
  326. package/dist-esm/lib/ui/version.mjs +3 -3
  327. package/dist-esm/lib/ui/version.mjs.map +1 -1
  328. package/dist-esm/lib/utils/embeds/embeds.mjs +4 -4
  329. package/dist-esm/lib/utils/embeds/embeds.mjs.map +2 -2
  330. package/dist-esm/lib/utils/test-helpers.mjs +2 -2
  331. package/dist-esm/lib/utils/test-helpers.mjs.map +2 -2
  332. package/dist-esm/lib/utils/text/richText.mjs +3 -1
  333. package/dist-esm/lib/utils/text/richText.mjs.map +2 -2
  334. package/package.json +11 -6
  335. package/src/index.ts +6 -1
  336. package/src/lib/TldrawImage.tsx +2 -2
  337. package/src/lib/bindings/arrow/ArrowBindingUtil.ts +5 -1
  338. package/src/lib/defaultEmbedDefinitions.ts +28 -6
  339. package/src/lib/defaultOverlayUtils.ts +11 -11
  340. package/src/lib/overlays/SelectionForegroundOverlayUtil.ts +91 -72
  341. package/src/lib/overlays/ShapeHandleOverlayUtil.ts +3 -1
  342. package/src/lib/overlays/ShapeIndicatorOverlayUtil.ts +133 -0
  343. package/src/lib/shapes/arrow/toolStates/Pointing.tsx +11 -1
  344. package/src/lib/shapes/bookmark/BookmarkShapeUtil.tsx +16 -3
  345. package/src/lib/shapes/bookmark/bookmarks.ts +105 -15
  346. package/src/lib/shapes/draw/DrawShapeUtil.tsx +7 -5
  347. package/src/lib/shapes/draw/getPath.ts +1 -1
  348. package/src/lib/shapes/draw/toolStates/Drawing.ts +55 -48
  349. package/src/lib/shapes/embed/EmbedShapeUtil.tsx +14 -4
  350. package/src/lib/shapes/frame/FrameShapeTool.ts +35 -24
  351. package/src/lib/shapes/geo/GeoShapeUtil.test.tsx +46 -0
  352. package/src/lib/shapes/geo/GeoShapeUtil.tsx +2 -1
  353. package/src/lib/shapes/geo/toolStates/Pointing.ts +5 -0
  354. package/src/lib/shapes/highlight/HighlightShapeUtil.tsx +14 -11
  355. package/src/lib/shapes/image/ImageShapeUtil.tsx +7 -11
  356. package/src/lib/shapes/line/LineShapeTool.test.ts +41 -0
  357. package/src/lib/shapes/line/toolStates/Pointing.ts +12 -2
  358. package/src/lib/shapes/note/NoteShapeUtil.tsx +36 -51
  359. package/src/lib/shapes/note/noteCloning.test.ts +5 -5
  360. package/src/lib/shapes/note/noteHelpers.ts +1 -1
  361. package/src/lib/shapes/note/toolStates/Pointing.ts +40 -7
  362. package/src/lib/shapes/shared/PlainTextLabel.tsx +3 -3
  363. package/src/lib/shapes/shared/RichTextLabel.tsx +4 -3
  364. package/src/lib/shapes/shared/defaultStyleDefs.tsx +25 -3
  365. package/src/lib/shapes/shared/freehand/core.ts +547 -0
  366. package/src/lib/shapes/shared/freehand/fmt.ts +106 -0
  367. package/src/lib/shapes/shared/freehand/getStroke.ts +7 -7
  368. package/src/lib/shapes/shared/freehand/getStrokeOutlinePoints.ts +451 -139
  369. package/src/lib/shapes/shared/freehand/getStrokePoints.ts +33 -153
  370. package/src/lib/shapes/shared/freehand/svg.ts +72 -23
  371. package/src/lib/shapes/shared/freehand/svgInk.ts +281 -136
  372. package/src/lib/shapes/shared/freehand/types.ts +0 -1
  373. package/src/lib/shapes/shared/interpolate-props.ts +6 -2
  374. package/src/lib/shapes/text/toolStates/Pointing.ts +5 -0
  375. package/src/lib/tools/HandTool/HandTool.ts +17 -28
  376. package/src/lib/tools/HandTool/childStates/Dragging.ts +17 -1
  377. package/src/lib/tools/HandTool/childStates/OneFingerZooming.ts +79 -0
  378. package/src/lib/tools/SelectTool/childStates/Crop/Crop.ts +3 -1
  379. package/src/lib/tools/SelectTool/childStates/Crop/children/Idle.ts +2 -2
  380. package/src/lib/tools/SelectTool/childStates/Crop/children/PointingCrop.ts +15 -1
  381. package/src/lib/tools/SelectTool/childStates/Crop/children/PointingCropHandle.ts +15 -1
  382. package/src/lib/tools/SelectTool/childStates/Idle.ts +17 -3
  383. package/src/lib/tools/SelectTool/childStates/PointingCanvas.ts +15 -1
  384. package/src/lib/tools/SelectTool/childStates/PointingHandle.ts +23 -1
  385. package/src/lib/tools/SelectTool/childStates/PointingResizeHandle.ts +21 -1
  386. package/src/lib/tools/SelectTool/childStates/PointingRotateHandle.ts +15 -1
  387. package/src/lib/tools/SelectTool/childStates/PointingSelection.ts +11 -2
  388. package/src/lib/tools/SelectTool/childStates/PointingShape.ts +26 -2
  389. package/src/lib/tools/SelectTool/childStates/Resizing.ts +137 -49
  390. package/src/lib/ui/TldrawUi.tsx +3 -3
  391. package/src/lib/ui/components/A11y.tsx +2 -0
  392. package/src/lib/ui/components/ContextMenu/DefaultContextMenu.tsx +32 -2
  393. package/src/lib/ui/components/ContextMenu/DefaultContextMenuContent.tsx +5 -6
  394. package/src/lib/ui/components/DefaultFollowingIndicator.tsx +2 -2
  395. package/src/lib/ui/components/Dialogs.tsx +20 -23
  396. package/src/lib/ui/components/HelperButtons/BackToContent.tsx +32 -4
  397. package/src/lib/ui/components/KeyboardShortcutsDialog/DefaultKeyboardShortcutsDialogContent.tsx +10 -0
  398. package/src/lib/ui/components/Minimap/DefaultMinimap.tsx +60 -74
  399. package/src/lib/ui/components/Minimap/MinimapManager.ts +35 -57
  400. package/src/lib/ui/components/SharePanel/DefaultPeopleMenuAvatar.tsx +2 -2
  401. package/src/lib/ui/components/SharePanel/DefaultPeopleMenuContent.tsx +2 -1
  402. package/src/lib/ui/components/SharePanel/DefaultPeopleMenuFacePile.tsx +2 -1
  403. package/src/lib/ui/components/SharePanel/DefaultPeopleMenuItem.tsx +3 -3
  404. package/src/lib/ui/components/StylePanel/StylePanelButtonPicker.tsx +5 -0
  405. package/src/lib/ui/components/StylePanel/StylePanelDropdownPicker.tsx +8 -1
  406. package/src/lib/ui/components/menu-items.tsx +9 -0
  407. package/src/lib/ui/components/primitives/TldrawUiDropdownMenu.tsx +3 -1
  408. package/src/lib/ui/components/primitives/TldrawUiIcon.tsx +15 -3
  409. package/src/lib/ui/components/primitives/TldrawUiInput.tsx +4 -0
  410. package/src/lib/ui/components/primitives/TldrawUiPopover.tsx +7 -0
  411. package/src/lib/ui/components/primitives/menus/TldrawUiMenuCheckboxItem.tsx +0 -2
  412. package/src/lib/ui/components/primitives/menus/TldrawUiMenuSubmenu.tsx +0 -1
  413. package/src/lib/ui/context/actions.tsx +88 -1
  414. package/src/lib/ui/context/asset-urls.tsx +9 -8
  415. package/src/lib/ui/context/events.tsx +2 -0
  416. package/src/lib/ui/hooks/useKeyboardShortcuts.ts +45 -7
  417. package/src/lib/ui/hooks/useTools.tsx +7 -1
  418. package/src/lib/ui/hooks/useTranslation/TLUiTranslationKey.ts +2 -0
  419. package/src/lib/ui/hooks/useTranslation/defaultTranslation.ts +2 -0
  420. package/src/lib/ui/version.ts +3 -3
  421. package/src/lib/ui.css +20 -9
  422. package/src/lib/utils/embeds/embeds.test.ts +14 -12
  423. package/src/lib/utils/embeds/embeds.ts +10 -4
  424. package/src/lib/utils/test-helpers.ts +3 -3
  425. package/src/lib/utils/text/richText.test.ts +36 -0
  426. package/src/lib/utils/text/richText.ts +9 -1
  427. package/src/test/ClickManager.test.ts +33 -28
  428. package/src/test/HandTool.test.ts +98 -34
  429. package/src/test/ImageShapeUtil.test.ts +88 -0
  430. package/src/test/SelectTool.test.ts +102 -1
  431. package/src/test/__snapshots__/drawing.test.ts.snap +2 -1
  432. package/src/test/attribution.test.ts +40 -29
  433. package/src/test/bookmark-shapes.test.ts +256 -28
  434. package/src/test/commands/__snapshots__/getSvgString.test.ts.snap +4 -6
  435. package/src/test/commands/clipboardCallbacks.test.ts +3 -1
  436. package/src/test/commands/getSvgString.test.ts +30 -0
  437. package/src/test/commands/penmode.test.ts +97 -1
  438. package/src/test/commands/setCamera.test.ts +109 -1
  439. package/src/test/cropping.test.ts +7 -0
  440. package/src/test/dragFromToolbar.test.ts +67 -0
  441. package/src/test/drawing.test.ts +48 -7
  442. package/src/test/frames.test.ts +72 -0
  443. package/src/test/freehand/corpus/presets.ts +71 -0
  444. package/src/test/freehand/corpus/real.ts +370 -0
  445. package/src/test/freehand/corpus/strokes.ts +50 -0
  446. package/src/test/freehand/svg.test.ts +20 -0
  447. package/src/test/freehand/wellformed.test.ts +30 -0
  448. package/src/test/long-press-create.test.ts +102 -0
  449. package/src/test/overlays/CollaboratorBrushOverlayUtil.test.ts +4 -4
  450. package/src/test/overlays/CollaboratorCursorOverlayUtil.test.ts +18 -18
  451. package/src/test/overlays/CollaboratorHintOverlayUtil.test.ts +7 -7
  452. package/src/test/overlays/CollaboratorScribbleOverlayUtil.test.ts +3 -3
  453. package/src/test/overlays/OverlayManager.test.ts +1 -1
  454. package/src/test/overlays/SelectionForegroundOverlayUtil.test.ts +58 -0
  455. package/src/test/overlays/ShapeHandleOverlayUtil.test.ts +2 -2
  456. package/src/test/overlays/ShapeIndicatorOverlayUtil.test.ts +36 -0
  457. package/src/test/pinch-dom.test.tsx +170 -0
  458. package/src/test/pinch.test.ts +139 -0
  459. package/src/test/resizing.test.ts +250 -0
  460. package/src/test/right-click-context-menu.test.ts +90 -0
  461. package/src/test/rightClickPanning.test.ts +11 -0
  462. package/src/test/selection-omnibus.test.ts +19 -6
  463. package/src/test/spatialIndex.test.ts +132 -0
  464. package/src/test/translating.test.ts +0 -6
  465. package/src/test/ui/ContextMenu.test.tsx +146 -3
  466. package/src/test/ui/Dialogs.test.tsx +256 -0
  467. package/src/test/ui/copyHoveredStyles.test.tsx +154 -0
  468. package/src/test/ui/keyboardShortcuts.test.tsx +266 -0
  469. package/tldraw.css +35 -12
  470. package/dist-cjs/lib/shapes/shared/freehand/setStrokePointRadii.js +0 -100
  471. package/dist-cjs/lib/shapes/shared/freehand/setStrokePointRadii.js.map +0 -7
  472. package/dist-esm/lib/shapes/shared/freehand/setStrokePointRadii.mjs +0 -80
  473. package/dist-esm/lib/shapes/shared/freehand/setStrokePointRadii.mjs.map +0 -7
  474. package/src/lib/shapes/shared/freehand/setStrokePointRadii.ts +0 -127
package/README.md CHANGED
@@ -32,6 +32,18 @@ export default function () {
32
32
 
33
33
  Visit [tldraw.dev](https://tldraw.dev) to learn more.
34
34
 
35
+ ## Documentation
36
+
37
+ Documentation for the most recent release can be found on [tldraw.dev/docs](https://tldraw.dev/docs), including [reference docs](https://tldraw.dev/reference/editor/Editor). Our release notes can be found [here](https://tldraw.dev/releases).
38
+
39
+ For more agent-friendly docs, see our [LLMs.txt](https://tldraw.dev/llms.txt).
40
+
41
+ From 5.1.x onward, this package also includes a `DOCS.md` file with the appropriate docs-site content and a generated `RELEASE_NOTES.md` file with versioned release notes. If you or your coding agent need release notes for your installed version specifically, check these files alongside the source in your `node_modules` folder.
42
+
43
+ ## Who's using tldraw
44
+
45
+ The tldraw SDK powers canvas experiences in products from [Google](https://about.google), [Shopify](https://www.shopify.com), [BlackRock](https://www.blackrock.com), [Autodesk](https://blogs.autodesk.com/forma/2024/06/20/forma-board-collaborative-tool-for-architects/), [ClickUp](https://tldraw.dev/blog/clickup), [Replit](https://docs.replit.com/replitai/canvas), [Google Stitch](https://stitch.withgoogle.com), [Luma](https://lumalabs.ai/dream-machine), [Runway](https://runwayml.com), [Padlet](https://tldraw.dev/blog/padlet), [Mobbin](https://tldraw.dev/blog/mobbin), [Jam](https://tldraw.dev/blog/jam), [Craft](https://support.craft.do/en/write-and-edit/whiteboards), [Honeycomb](https://www.honeycomb.io/platform/canvas), [SchoolAI](https://schoolai.com/products/powerups), [Brisk](https://www.briskteaching.com/post/boost-whiteboard), and many more. See our [showcase](https://tldraw.dev/showcase) for case studies.
46
+
35
47
  ## Package development
36
48
 
37
49
  To start the local development server:
@@ -56,7 +68,7 @@ You can find tldraw on npm [here](https://www.npmjs.com/package/@tldraw/tldraw?a
56
68
 
57
69
  ## Contribution
58
70
 
59
- Please see our [contributing guide](https://github.com/tldraw/tldraw/blob/main/CONTRIBUTING.md). Found a bug? Please [submit an issue](https://github.com/tldraw/tldraw/issues/new).
71
+ Found a bug? Please [submit an issue](https://github.com/tldraw/tldraw/issues/new).
60
72
 
61
73
  ## Community
62
74