@tldraw/editor 4.6.0-next.0eb36d65eec3 → 4.6.0-next.1a05e8ec7833

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 (300) hide show
  1. package/dist-cjs/index.d.ts +816 -112
  2. package/dist-cjs/index.js +22 -6
  3. package/dist-cjs/index.js.map +3 -3
  4. package/dist-cjs/lib/TldrawEditor.js +59 -14
  5. package/dist-cjs/lib/TldrawEditor.js.map +3 -3
  6. package/dist-cjs/lib/components/LiveCollaborators.js +1 -0
  7. package/dist-cjs/lib/components/LiveCollaborators.js.map +2 -2
  8. package/dist-cjs/lib/components/MenuClickCapture.js +99 -38
  9. package/dist-cjs/lib/components/MenuClickCapture.js.map +2 -2
  10. package/dist-cjs/lib/components/default-components/CanvasShapeIndicators.js +10 -3
  11. package/dist-cjs/lib/components/default-components/CanvasShapeIndicators.js.map +3 -3
  12. package/dist-cjs/lib/components/default-components/DefaultCanvas.js +5 -2
  13. package/dist-cjs/lib/components/default-components/DefaultCanvas.js.map +2 -2
  14. package/dist-cjs/lib/components/default-components/DefaultShapeIndicator.js +1 -1
  15. package/dist-cjs/lib/components/default-components/DefaultShapeIndicator.js.map +2 -2
  16. package/dist-cjs/lib/components/default-components/DefaultShapeIndicators.js +1 -0
  17. package/dist-cjs/lib/components/default-components/DefaultShapeIndicators.js.map +2 -2
  18. package/dist-cjs/lib/config/{createTLUser.js → createTLCurrentUser.js} +9 -9
  19. package/dist-cjs/lib/config/createTLCurrentUser.js.map +7 -0
  20. package/dist-cjs/lib/config/createTLStore.js +30 -0
  21. package/dist-cjs/lib/config/createTLStore.js.map +2 -2
  22. package/dist-cjs/lib/config/defaultAssets.js +36 -0
  23. package/dist-cjs/lib/config/defaultAssets.js.map +7 -0
  24. package/dist-cjs/lib/editor/Editor.js +389 -13
  25. package/dist-cjs/lib/editor/Editor.js.map +3 -3
  26. package/dist-cjs/lib/editor/assets/AssetUtil.js +67 -0
  27. package/dist-cjs/lib/editor/assets/AssetUtil.js.map +7 -0
  28. package/dist-cjs/lib/editor/bindings/BindingUtil.js +1 -0
  29. package/dist-cjs/lib/editor/bindings/BindingUtil.js.map +1 -1
  30. package/dist-cjs/lib/editor/managers/ClickManager/ClickManager.js +1 -0
  31. package/dist-cjs/lib/editor/managers/ClickManager/ClickManager.js.map +1 -1
  32. package/dist-cjs/lib/editor/managers/EdgeScrollManager/EdgeScrollManager.js +1 -0
  33. package/dist-cjs/lib/editor/managers/EdgeScrollManager/EdgeScrollManager.js.map +1 -1
  34. package/dist-cjs/lib/editor/managers/FocusManager/FocusManager.js +1 -0
  35. package/dist-cjs/lib/editor/managers/FocusManager/FocusManager.js.map +1 -1
  36. package/dist-cjs/lib/editor/managers/FontManager/FontManager.js +2 -0
  37. package/dist-cjs/lib/editor/managers/FontManager/FontManager.js.map +2 -2
  38. package/dist-cjs/lib/editor/managers/HistoryManager/HistoryManager.js +2 -0
  39. package/dist-cjs/lib/editor/managers/HistoryManager/HistoryManager.js.map +1 -1
  40. package/dist-cjs/lib/editor/managers/InputsManager/InputsManager.js +12 -0
  41. package/dist-cjs/lib/editor/managers/InputsManager/InputsManager.js.map +2 -2
  42. package/dist-cjs/lib/editor/managers/PerformanceManager/PerformanceApiAdapter.js +80 -0
  43. package/dist-cjs/lib/editor/managers/PerformanceManager/PerformanceApiAdapter.js.map +7 -0
  44. package/dist-cjs/lib/editor/managers/PerformanceManager/PerformanceManager.js +466 -0
  45. package/dist-cjs/lib/editor/managers/PerformanceManager/PerformanceManager.js.map +7 -0
  46. package/dist-cjs/lib/editor/managers/PerformanceManager/perf-types.js +17 -0
  47. package/dist-cjs/lib/editor/managers/PerformanceManager/perf-types.js.map +7 -0
  48. package/dist-cjs/lib/editor/managers/ScribbleManager/ScribbleManager.js +1 -0
  49. package/dist-cjs/lib/editor/managers/ScribbleManager/ScribbleManager.js.map +1 -1
  50. package/dist-cjs/lib/editor/managers/SnapManager/BoundsSnaps.js +1 -0
  51. package/dist-cjs/lib/editor/managers/SnapManager/BoundsSnaps.js.map +1 -1
  52. package/dist-cjs/lib/editor/managers/SnapManager/HandleSnaps.js +1 -0
  53. package/dist-cjs/lib/editor/managers/SnapManager/HandleSnaps.js.map +1 -1
  54. package/dist-cjs/lib/editor/managers/SnapManager/SnapManager.js +2 -1
  55. package/dist-cjs/lib/editor/managers/SnapManager/SnapManager.js.map +2 -2
  56. package/dist-cjs/lib/editor/managers/SpatialIndexManager/SpatialIndexManager.js +1 -0
  57. package/dist-cjs/lib/editor/managers/SpatialIndexManager/SpatialIndexManager.js.map +1 -1
  58. package/dist-cjs/lib/editor/managers/TextManager/TextManager.js +1 -0
  59. package/dist-cjs/lib/editor/managers/TextManager/TextManager.js.map +1 -1
  60. package/dist-cjs/lib/editor/managers/ThemeManager/ThemeManager.js +107 -0
  61. package/dist-cjs/lib/editor/managers/ThemeManager/ThemeManager.js.map +7 -0
  62. package/dist-cjs/lib/editor/managers/ThemeManager/defaultThemes.js +586 -0
  63. package/dist-cjs/lib/editor/managers/ThemeManager/defaultThemes.js.map +7 -0
  64. package/dist-cjs/lib/editor/managers/TickManager/TickManager.js +1 -0
  65. package/dist-cjs/lib/editor/managers/TickManager/TickManager.js.map +1 -1
  66. package/dist-cjs/lib/editor/managers/UserPreferencesManager/UserPreferencesManager.js +8 -4
  67. package/dist-cjs/lib/editor/managers/UserPreferencesManager/UserPreferencesManager.js.map +2 -2
  68. package/dist-cjs/lib/editor/shapes/BaseFrameLikeShapeUtil.js +76 -0
  69. package/dist-cjs/lib/editor/shapes/BaseFrameLikeShapeUtil.js.map +7 -0
  70. package/dist-cjs/lib/editor/shapes/ShapeUtil.js +32 -2
  71. package/dist-cjs/lib/editor/shapes/ShapeUtil.js.map +2 -2
  72. package/dist-cjs/lib/editor/shapes/group/GroupShapeUtil.js +1 -1
  73. package/dist-cjs/lib/editor/shapes/group/GroupShapeUtil.js.map +2 -2
  74. package/dist-cjs/lib/editor/shapes/shared/getPerfectDashProps.js +6 -0
  75. package/dist-cjs/lib/editor/shapes/shared/getPerfectDashProps.js.map +2 -2
  76. package/dist-cjs/lib/editor/tools/StateNode.js +15 -17
  77. package/dist-cjs/lib/editor/tools/StateNode.js.map +2 -2
  78. package/dist-cjs/lib/editor/types/SvgExportContext.js.map +2 -2
  79. package/dist-cjs/lib/editor/types/clipboard-types.js.map +1 -1
  80. package/dist-cjs/lib/editor/types/external-content.js.map +1 -1
  81. package/dist-cjs/lib/exports/ExportDelay.js +1 -0
  82. package/dist-cjs/lib/exports/ExportDelay.js.map +1 -1
  83. package/dist-cjs/lib/exports/StyleEmbedder.js +1 -0
  84. package/dist-cjs/lib/exports/StyleEmbedder.js.map +1 -1
  85. package/dist-cjs/lib/exports/getSvgJsx.js +14 -8
  86. package/dist-cjs/lib/exports/getSvgJsx.js.map +2 -2
  87. package/dist-cjs/lib/globals/environment.js +18 -1
  88. package/dist-cjs/lib/globals/environment.js.map +2 -2
  89. package/dist-cjs/lib/hooks/useCanvasEvents.js +25 -4
  90. package/dist-cjs/lib/hooks/useCanvasEvents.js.map +2 -2
  91. package/dist-cjs/lib/hooks/{useIsDarkMode.js → useColorMode.js} +14 -10
  92. package/dist-cjs/lib/hooks/useColorMode.js.map +7 -0
  93. package/dist-cjs/lib/hooks/useCursor.js +3 -7
  94. package/dist-cjs/lib/hooks/useCursor.js.map +2 -2
  95. package/dist-cjs/lib/hooks/useDarkMode.js +4 -4
  96. package/dist-cjs/lib/hooks/useDarkMode.js.map +2 -2
  97. package/dist-cjs/lib/hooks/useGestureEvents.js +171 -127
  98. package/dist-cjs/lib/hooks/useGestureEvents.js.map +3 -3
  99. package/dist-cjs/lib/options.js +2 -0
  100. package/dist-cjs/lib/options.js.map +2 -2
  101. package/dist-cjs/lib/primitives/Vec.js +3 -0
  102. package/dist-cjs/lib/primitives/Vec.js.map +1 -1
  103. package/dist-cjs/lib/primitives/geometry/Circle2d.js +1 -0
  104. package/dist-cjs/lib/primitives/geometry/Circle2d.js.map +1 -1
  105. package/dist-cjs/lib/primitives/geometry/Ellipse2d.js +1 -0
  106. package/dist-cjs/lib/primitives/geometry/Ellipse2d.js.map +1 -1
  107. package/dist-cjs/lib/primitives/geometry/Geometry2d.js +2 -0
  108. package/dist-cjs/lib/primitives/geometry/Geometry2d.js.map +1 -1
  109. package/dist-cjs/lib/primitives/geometry/Stadium2d.js +1 -0
  110. package/dist-cjs/lib/primitives/geometry/Stadium2d.js.map +1 -1
  111. package/dist-cjs/lib/utils/EditorAtom.js +2 -0
  112. package/dist-cjs/lib/utils/EditorAtom.js.map +1 -1
  113. package/dist-cjs/lib/utils/reparenting.js +2 -1
  114. package/dist-cjs/lib/utils/reparenting.js.map +2 -2
  115. package/dist-cjs/lib/utils/richText.js.map +2 -2
  116. package/dist-cjs/lib/utils/runtime.js +2 -1
  117. package/dist-cjs/lib/utils/runtime.js.map +2 -2
  118. package/dist-cjs/lib/utils/sync/TLLocalSyncClient.js +2 -0
  119. package/dist-cjs/lib/utils/sync/TLLocalSyncClient.js.map +1 -1
  120. package/dist-cjs/lib/utils/sync/hardReset.js +0 -8
  121. package/dist-cjs/lib/utils/sync/hardReset.js.map +2 -2
  122. package/dist-cjs/version.js +3 -3
  123. package/dist-cjs/version.js.map +1 -1
  124. package/dist-esm/index.d.mts +816 -112
  125. package/dist-esm/index.mjs +27 -9
  126. package/dist-esm/index.mjs.map +2 -2
  127. package/dist-esm/lib/TldrawEditor.mjs +62 -14
  128. package/dist-esm/lib/TldrawEditor.mjs.map +3 -3
  129. package/dist-esm/lib/components/LiveCollaborators.mjs +1 -0
  130. package/dist-esm/lib/components/LiveCollaborators.mjs.map +2 -2
  131. package/dist-esm/lib/components/MenuClickCapture.mjs +100 -39
  132. package/dist-esm/lib/components/MenuClickCapture.mjs.map +2 -2
  133. package/dist-esm/lib/components/default-components/CanvasShapeIndicators.mjs +10 -3
  134. package/dist-esm/lib/components/default-components/CanvasShapeIndicators.mjs.map +3 -3
  135. package/dist-esm/lib/components/default-components/DefaultCanvas.mjs +5 -2
  136. package/dist-esm/lib/components/default-components/DefaultCanvas.mjs.map +2 -2
  137. package/dist-esm/lib/components/default-components/DefaultShapeIndicator.mjs +1 -1
  138. package/dist-esm/lib/components/default-components/DefaultShapeIndicator.mjs.map +2 -2
  139. package/dist-esm/lib/components/default-components/DefaultShapeIndicators.mjs +1 -0
  140. package/dist-esm/lib/components/default-components/DefaultShapeIndicators.mjs.map +2 -2
  141. package/dist-esm/lib/config/{createTLUser.mjs → createTLCurrentUser.mjs} +6 -6
  142. package/dist-esm/lib/config/createTLCurrentUser.mjs.map +7 -0
  143. package/dist-esm/lib/config/createTLStore.mjs +36 -1
  144. package/dist-esm/lib/config/createTLStore.mjs.map +2 -2
  145. package/dist-esm/lib/config/defaultAssets.mjs +16 -0
  146. package/dist-esm/lib/config/defaultAssets.mjs.map +7 -0
  147. package/dist-esm/lib/editor/Editor.mjs +391 -13
  148. package/dist-esm/lib/editor/Editor.mjs.map +3 -3
  149. package/dist-esm/lib/editor/assets/AssetUtil.mjs +47 -0
  150. package/dist-esm/lib/editor/assets/AssetUtil.mjs.map +7 -0
  151. package/dist-esm/lib/editor/bindings/BindingUtil.mjs +1 -0
  152. package/dist-esm/lib/editor/bindings/BindingUtil.mjs.map +1 -1
  153. package/dist-esm/lib/editor/managers/ClickManager/ClickManager.mjs +1 -0
  154. package/dist-esm/lib/editor/managers/ClickManager/ClickManager.mjs.map +1 -1
  155. package/dist-esm/lib/editor/managers/EdgeScrollManager/EdgeScrollManager.mjs +1 -0
  156. package/dist-esm/lib/editor/managers/EdgeScrollManager/EdgeScrollManager.mjs.map +1 -1
  157. package/dist-esm/lib/editor/managers/FocusManager/FocusManager.mjs +1 -0
  158. package/dist-esm/lib/editor/managers/FocusManager/FocusManager.mjs.map +1 -1
  159. package/dist-esm/lib/editor/managers/FontManager/FontManager.mjs +2 -0
  160. package/dist-esm/lib/editor/managers/FontManager/FontManager.mjs.map +2 -2
  161. package/dist-esm/lib/editor/managers/HistoryManager/HistoryManager.mjs +2 -0
  162. package/dist-esm/lib/editor/managers/HistoryManager/HistoryManager.mjs.map +1 -1
  163. package/dist-esm/lib/editor/managers/InputsManager/InputsManager.mjs +12 -0
  164. package/dist-esm/lib/editor/managers/InputsManager/InputsManager.mjs.map +2 -2
  165. package/dist-esm/lib/editor/managers/PerformanceManager/PerformanceApiAdapter.mjs +60 -0
  166. package/dist-esm/lib/editor/managers/PerformanceManager/PerformanceApiAdapter.mjs.map +7 -0
  167. package/dist-esm/lib/editor/managers/PerformanceManager/PerformanceManager.mjs +438 -0
  168. package/dist-esm/lib/editor/managers/PerformanceManager/PerformanceManager.mjs.map +7 -0
  169. package/dist-esm/lib/editor/managers/PerformanceManager/perf-types.mjs +1 -0
  170. package/dist-esm/lib/editor/managers/PerformanceManager/perf-types.mjs.map +7 -0
  171. package/dist-esm/lib/editor/managers/ScribbleManager/ScribbleManager.mjs +1 -0
  172. package/dist-esm/lib/editor/managers/ScribbleManager/ScribbleManager.mjs.map +1 -1
  173. package/dist-esm/lib/editor/managers/SnapManager/BoundsSnaps.mjs +1 -0
  174. package/dist-esm/lib/editor/managers/SnapManager/BoundsSnaps.mjs.map +1 -1
  175. package/dist-esm/lib/editor/managers/SnapManager/HandleSnaps.mjs +1 -0
  176. package/dist-esm/lib/editor/managers/SnapManager/HandleSnaps.mjs.map +1 -1
  177. package/dist-esm/lib/editor/managers/SnapManager/SnapManager.mjs +2 -1
  178. package/dist-esm/lib/editor/managers/SnapManager/SnapManager.mjs.map +2 -2
  179. package/dist-esm/lib/editor/managers/SpatialIndexManager/SpatialIndexManager.mjs +1 -0
  180. package/dist-esm/lib/editor/managers/SpatialIndexManager/SpatialIndexManager.mjs.map +1 -1
  181. package/dist-esm/lib/editor/managers/TextManager/TextManager.mjs +1 -0
  182. package/dist-esm/lib/editor/managers/TextManager/TextManager.mjs.map +1 -1
  183. package/dist-esm/lib/editor/managers/ThemeManager/ThemeManager.mjs +89 -0
  184. package/dist-esm/lib/editor/managers/ThemeManager/ThemeManager.mjs.map +7 -0
  185. package/dist-esm/lib/editor/managers/ThemeManager/defaultThemes.mjs +568 -0
  186. package/dist-esm/lib/editor/managers/ThemeManager/defaultThemes.mjs.map +7 -0
  187. package/dist-esm/lib/editor/managers/TickManager/TickManager.mjs +1 -0
  188. package/dist-esm/lib/editor/managers/TickManager/TickManager.mjs.map +1 -1
  189. package/dist-esm/lib/editor/managers/UserPreferencesManager/UserPreferencesManager.mjs +8 -4
  190. package/dist-esm/lib/editor/managers/UserPreferencesManager/UserPreferencesManager.mjs.map +2 -2
  191. package/dist-esm/lib/editor/shapes/BaseFrameLikeShapeUtil.mjs +56 -0
  192. package/dist-esm/lib/editor/shapes/BaseFrameLikeShapeUtil.mjs.map +7 -0
  193. package/dist-esm/lib/editor/shapes/ShapeUtil.mjs +32 -2
  194. package/dist-esm/lib/editor/shapes/ShapeUtil.mjs.map +2 -2
  195. package/dist-esm/lib/editor/shapes/group/GroupShapeUtil.mjs +1 -1
  196. package/dist-esm/lib/editor/shapes/group/GroupShapeUtil.mjs.map +2 -2
  197. package/dist-esm/lib/editor/shapes/shared/getPerfectDashProps.mjs +6 -0
  198. package/dist-esm/lib/editor/shapes/shared/getPerfectDashProps.mjs.map +2 -2
  199. package/dist-esm/lib/editor/tools/StateNode.mjs +15 -17
  200. package/dist-esm/lib/editor/tools/StateNode.mjs.map +2 -2
  201. package/dist-esm/lib/editor/types/SvgExportContext.mjs.map +2 -2
  202. package/dist-esm/lib/exports/ExportDelay.mjs +1 -0
  203. package/dist-esm/lib/exports/ExportDelay.mjs.map +1 -1
  204. package/dist-esm/lib/exports/StyleEmbedder.mjs +1 -0
  205. package/dist-esm/lib/exports/StyleEmbedder.mjs.map +1 -1
  206. package/dist-esm/lib/exports/getSvgJsx.mjs +14 -11
  207. package/dist-esm/lib/exports/getSvgJsx.mjs.map +2 -2
  208. package/dist-esm/lib/globals/environment.mjs +18 -1
  209. package/dist-esm/lib/globals/environment.mjs.map +2 -2
  210. package/dist-esm/lib/hooks/useCanvasEvents.mjs +25 -4
  211. package/dist-esm/lib/hooks/useCanvasEvents.mjs.map +2 -2
  212. package/dist-esm/lib/hooks/useColorMode.mjs +19 -0
  213. package/dist-esm/lib/hooks/useColorMode.mjs.map +7 -0
  214. package/dist-esm/lib/hooks/useCursor.mjs +3 -7
  215. package/dist-esm/lib/hooks/useCursor.mjs.map +2 -2
  216. package/dist-esm/lib/hooks/useDarkMode.mjs +4 -4
  217. package/dist-esm/lib/hooks/useDarkMode.mjs.map +2 -2
  218. package/dist-esm/lib/hooks/useGestureEvents.mjs +171 -127
  219. package/dist-esm/lib/hooks/useGestureEvents.mjs.map +3 -3
  220. package/dist-esm/lib/options.mjs +2 -0
  221. package/dist-esm/lib/options.mjs.map +2 -2
  222. package/dist-esm/lib/primitives/Vec.mjs +3 -0
  223. package/dist-esm/lib/primitives/Vec.mjs.map +1 -1
  224. package/dist-esm/lib/primitives/geometry/Circle2d.mjs +1 -0
  225. package/dist-esm/lib/primitives/geometry/Circle2d.mjs.map +1 -1
  226. package/dist-esm/lib/primitives/geometry/Ellipse2d.mjs +1 -0
  227. package/dist-esm/lib/primitives/geometry/Ellipse2d.mjs.map +1 -1
  228. package/dist-esm/lib/primitives/geometry/Geometry2d.mjs +2 -0
  229. package/dist-esm/lib/primitives/geometry/Geometry2d.mjs.map +1 -1
  230. package/dist-esm/lib/primitives/geometry/Stadium2d.mjs +1 -0
  231. package/dist-esm/lib/primitives/geometry/Stadium2d.mjs.map +1 -1
  232. package/dist-esm/lib/utils/EditorAtom.mjs +2 -0
  233. package/dist-esm/lib/utils/EditorAtom.mjs.map +1 -1
  234. package/dist-esm/lib/utils/reparenting.mjs +2 -1
  235. package/dist-esm/lib/utils/reparenting.mjs.map +2 -2
  236. package/dist-esm/lib/utils/richText.mjs.map +2 -2
  237. package/dist-esm/lib/utils/runtime.mjs +2 -1
  238. package/dist-esm/lib/utils/runtime.mjs.map +2 -2
  239. package/dist-esm/lib/utils/sync/TLLocalSyncClient.mjs +2 -0
  240. package/dist-esm/lib/utils/sync/TLLocalSyncClient.mjs.map +1 -1
  241. package/dist-esm/lib/utils/sync/hardReset.mjs +0 -8
  242. package/dist-esm/lib/utils/sync/hardReset.mjs.map +2 -2
  243. package/dist-esm/version.mjs +3 -3
  244. package/dist-esm/version.mjs.map +1 -1
  245. package/editor.css +13 -37
  246. package/package.json +8 -9
  247. package/src/index.ts +30 -7
  248. package/src/lib/TldrawEditor.tsx +98 -19
  249. package/src/lib/components/LiveCollaborators.tsx +8 -2
  250. package/src/lib/components/MenuClickCapture.tsx +129 -49
  251. package/src/lib/components/default-components/CanvasShapeIndicators.tsx +14 -3
  252. package/src/lib/components/default-components/DefaultCanvas.tsx +6 -2
  253. package/src/lib/components/default-components/DefaultShapeIndicator.tsx +2 -2
  254. package/src/lib/components/default-components/DefaultShapeIndicators.tsx +2 -0
  255. package/src/lib/config/{createTLUser.ts → createTLCurrentUser.ts} +6 -6
  256. package/src/lib/config/createTLStore.ts +57 -2
  257. package/src/lib/config/defaultAssets.ts +19 -0
  258. package/src/lib/editor/Editor.ts +526 -42
  259. package/src/lib/editor/assets/AssetUtil.ts +85 -0
  260. package/src/lib/editor/managers/FontManager/FontManager.test.ts +9 -2
  261. package/src/lib/editor/managers/FontManager/FontManager.ts +1 -67
  262. package/src/lib/editor/managers/InputsManager/InputsManager.ts +12 -0
  263. package/src/lib/editor/managers/PerformanceManager/PerformanceApiAdapter.ts +82 -0
  264. package/src/lib/editor/managers/PerformanceManager/PerformanceManager.test.ts +522 -0
  265. package/src/lib/editor/managers/PerformanceManager/PerformanceManager.ts +583 -0
  266. package/src/lib/editor/managers/PerformanceManager/perf-types.ts +196 -0
  267. package/src/lib/editor/managers/SnapManager/SnapManager.test.ts +13 -2
  268. package/src/lib/editor/managers/SnapManager/SnapManager.ts +1 -1
  269. package/src/lib/editor/managers/ThemeManager/ThemeManager.ts +116 -0
  270. package/src/lib/editor/managers/ThemeManager/defaultThemes.ts +605 -0
  271. package/src/lib/editor/managers/UserPreferencesManager/UserPreferencesManager.test.ts +25 -31
  272. package/src/lib/editor/managers/UserPreferencesManager/UserPreferencesManager.ts +7 -5
  273. package/src/lib/editor/shapes/BaseFrameLikeShapeUtil.tsx +121 -0
  274. package/src/lib/editor/shapes/ShapeUtil.ts +50 -3
  275. package/src/lib/editor/shapes/group/GroupShapeUtil.tsx +1 -1
  276. package/src/lib/editor/shapes/shared/getPerfectDashProps.ts +7 -0
  277. package/src/lib/editor/tools/StateNode.ts +16 -18
  278. package/src/lib/editor/types/SvgExportContext.tsx +5 -0
  279. package/src/lib/editor/types/clipboard-types.ts +2 -1
  280. package/src/lib/editor/types/external-content.ts +1 -0
  281. package/src/lib/exports/getSvgJsx.tsx +23 -16
  282. package/src/lib/globals/environment.ts +18 -0
  283. package/src/lib/hooks/useCanvasEvents.ts +40 -3
  284. package/src/lib/hooks/{useIsDarkMode.ts → useColorMode.ts} +9 -5
  285. package/src/lib/hooks/useCursor.ts +3 -7
  286. package/src/lib/hooks/useDarkMode.ts +4 -4
  287. package/src/lib/hooks/useGestureEvents.ts +240 -168
  288. package/src/lib/options.ts +14 -0
  289. package/src/lib/primitives/Box.test.ts +30 -0
  290. package/src/lib/primitives/geometry/Geometry2d.test.ts +21 -0
  291. package/src/lib/utils/reparenting.ts +6 -2
  292. package/src/lib/utils/richText.ts +1 -1
  293. package/src/lib/utils/runtime.ts +3 -1
  294. package/src/lib/utils/sync/hardReset.ts +0 -8
  295. package/src/version.ts +3 -3
  296. package/dist-cjs/lib/config/createTLUser.js.map +0 -7
  297. package/dist-cjs/lib/hooks/useIsDarkMode.js.map +0 -7
  298. package/dist-esm/lib/config/createTLUser.mjs.map +0 -7
  299. package/dist-esm/lib/hooks/useIsDarkMode.mjs +0 -15
  300. package/dist-esm/lib/hooks/useIsDarkMode.mjs.map +0 -7
@@ -1,7 +1,6 @@
1
- import type { AnyHandlerEventTypes, EventTypes, GestureKey, Handler } from '@use-gesture/core/types'
2
- import { createUseGesture, pinchAction, wheelAction } from '@use-gesture/react'
3
1
  import * as React from 'react'
4
2
  import { TLWheelEventInfo } from '../editor/types/event-types'
3
+ import { tlenv } from '../globals/environment'
5
4
  import { Vec } from '../primitives/Vec'
6
5
  import { preventDefault } from '../utils/dom'
7
6
  import { isAccelKey } from '../utils/keyboard'
@@ -12,27 +11,27 @@ import { useEditor } from './useEditor'
12
11
 
13
12
  # How does pinching work?
14
13
 
15
- The pinching handler is fired under two circumstances:
14
+ The pinching handler is fired under two circumstances:
16
15
  - when a user is on a MacBook trackpad and is ZOOMING with a two-finger pinch
17
16
  - when a user is on a touch device and is ZOOMING with a two-finger pinch
18
17
  - when a user is on a touch device and is PANNING with two fingers
19
18
 
20
- Zooming is much more expensive than panning (because it causes shapes to render),
21
- so we want to be sure that we don't zoom while two-finger panning.
19
+ Zooming is much more expensive than panning (because it causes shapes to render),
20
+ so we want to be sure that we don't zoom while two-finger panning.
22
21
 
23
22
  In order to do this, we keep track of a "pinchState", which is either:
24
23
  - "zooming"
25
24
  - "panning"
26
25
  - "not sure"
27
26
 
28
- If a user is on a trackpad, the pinchState will be set to "zooming".
27
+ If a user is on a trackpad, the pinchState will be set to "zooming".
29
28
 
30
29
  If the user is on a touch screen, then we start in the "not sure" state and switch back and forth
31
30
  between "zooming", "panning", and "not sure" based on what the user is doing with their fingers.
32
31
 
33
32
  In the "not sure" state, we examine whether the user has moved the center of the gesture far enough
34
33
  to suggest that they're panning; or else that they've moved their fingers further apart or closer
35
- together enough to suggest that they're zooming.
34
+ together enough to suggest that they're zooming.
36
35
 
37
36
  In the "panning" state, we check whether the user's fingers have moved far enough apart to suggest
38
37
  that they're zooming. If they have, we switch to the "zooming" state.
@@ -42,62 +41,37 @@ In the "zooming" state, we just stay zooming—it's not YET possible to switch b
42
41
  todo: compare velocities of change in order to determine whether the user has switched back to panning
43
42
  */
44
43
 
45
- type check<T extends AnyHandlerEventTypes, Key extends GestureKey> = undefined extends T[Key]
46
- ? EventTypes[Key]
47
- : T[Key]
48
- type PinchHandler = Handler<'pinch', check<EventTypes, 'pinch'>>
49
-
50
- const useGesture = createUseGesture([wheelAction, pinchAction])
51
-
52
- /**
53
- * GOTCHA
54
- *
55
- * UseGesture fires a wheel event 140ms after the gesture actually ends, with a momentum-adjusted
56
- * delta. This creates a messed up interaction where after you stop scrolling suddenly the dang page
57
- * jumps a tick. why do they do this? you are asking the wrong person. it seems intentional though.
58
- * anyway we want to ignore that last event, but there's no way to directly detect it so we need to
59
- * keep track of timestamps. Yes this is awful, I am sorry.
60
- */
61
- let lastWheelTime = undefined as undefined | number
62
-
63
- const isWheelEndEvent = (time: number) => {
64
- if (lastWheelTime === undefined) {
65
- lastWheelTime = time
66
- return false
67
- }
68
-
69
- if (time - lastWheelTime > 120 && time - lastWheelTime < 160) {
70
- lastWheelTime = time
71
- return true
72
- }
73
-
74
- lastWheelTime = time
75
- return false
44
+ /** Safari's non-standard GestureEvent */
45
+ interface GestureEvent extends Event {
46
+ scale: number
47
+ rotation: number
48
+ clientX: number
49
+ clientY: number
50
+ shiftKey: boolean
51
+ altKey: boolean
52
+ metaKey: boolean
53
+ ctrlKey: boolean
76
54
  }
77
55
 
78
56
  export function useGestureEvents(ref: React.RefObject<HTMLDivElement | null>) {
79
57
  const editor = useEditor()
80
58
 
81
- const events = React.useMemo(() => {
59
+ React.useEffect(() => {
60
+ const elm = ref.current
61
+ if (!elm) return
62
+
82
63
  let pinchState = 'not sure' as 'not sure' | 'zooming' | 'panning'
83
64
 
84
- const onWheel: Handler<'wheel', WheelEvent> = ({ event }) => {
65
+ // --- Wheel handling ---
66
+
67
+ function onWheel(event: WheelEvent) {
85
68
  if (!editor.getInstanceState().isFocused) {
86
69
  return
87
70
  }
88
71
 
89
72
  pinchState = 'not sure'
90
73
 
91
- if (isWheelEndEvent(Date.now())) {
92
- // ignore wheelEnd events
93
- return
94
- }
95
-
96
- // Awful tht we need to put this logic here, but basically
97
- // we don't want to handle the the wheel event (or call prevent
98
- // default on the evnet) if the user is wheeling over an a shape
99
- // that is scrollable which they're currently editing.
100
-
74
+ // Don't handle wheel events over a scrollable editing shape
101
75
  const editingShapeId = editor.getEditingShapeId()
102
76
  if (editingShapeId) {
103
77
  const shape = editor.getShape(editingShapeId)
@@ -133,43 +107,38 @@ export function useGestureEvents(ref: React.RefObject<HTMLDivElement | null>) {
133
107
  editor.dispatch(info)
134
108
  }
135
109
 
110
+ // --- Touch pinch handling ---
111
+
136
112
  let initDistanceBetweenFingers = 1 // the distance between the two fingers when the pinch starts
137
- let initZoom = 1 // the browser's zoom level when the pinch starts
113
+ let initZoom = 1 // the zoom level when the pinch starts
138
114
  let currDistanceBetweenFingers = 0
139
115
  const initPointBetweenFingers = new Vec()
140
116
  const prevPointBetweenFingers = new Vec()
141
117
 
142
- const onPinchStart: PinchHandler = (gesture) => {
143
- const elm = ref.current
144
- pinchState = 'not sure'
145
-
146
- const { event, origin, da } = gesture
147
-
148
- if (event instanceof WheelEvent) return
149
- if (!(event.target === elm || elm?.contains(event.target as Node))) return
150
-
151
- prevPointBetweenFingers.x = origin[0]
152
- prevPointBetweenFingers.y = origin[1]
153
- initPointBetweenFingers.x = origin[0]
154
- initPointBetweenFingers.y = origin[1]
155
- initDistanceBetweenFingers = da[0]
156
- initZoom = editor.getZoomLevel()
118
+ // Track active touches
119
+ let activeTouches: Touch[] = []
120
+
121
+ function getScaleBounds() {
122
+ const baseZoom = editor.getBaseZoom()
123
+ const { zoomSteps, zoomSpeed } = editor.getCameraOptions()
124
+ const zoomMin = zoomSteps[0] * baseZoom
125
+ const zoomMax = zoomSteps[zoomSteps.length - 1] * baseZoom
126
+ return {
127
+ min: zoomMin ** (1 / zoomSpeed),
128
+ max: zoomMax ** (1 / zoomSpeed),
129
+ }
130
+ }
157
131
 
158
- editor.dispatch({
159
- type: 'pinch',
160
- name: 'pinch_start',
161
- point: { x: origin[0], y: origin[1], z: editor.getZoomLevel() },
162
- delta: { x: 0, y: 0 },
163
- shiftKey: event.shiftKey,
164
- altKey: event.altKey,
165
- ctrlKey: event.metaKey || event.ctrlKey,
166
- metaKey: event.metaKey,
167
- accelKey: isAccelKey(event),
168
- })
132
+ function getScaleFrom() {
133
+ const { zoomSpeed } = editor.getCameraOptions()
134
+ return editor.getZoomLevel() ** (1 / zoomSpeed)
169
135
  }
170
136
 
171
- // let timeout: any
172
- const updatePinchState = (isSafariTrackpadPinch: boolean) => {
137
+ // Accumulated scale offset, clamped to bounds — replaces @use-gesture's offset[0]
138
+ let scaleOffset = 1
139
+ let initScaleFrom = 1 // the scale-space zoom level when the pinch started
140
+
141
+ function updatePinchState(isSafariTrackpadPinch: boolean) {
173
142
  if (isSafariTrackpadPinch) {
174
143
  pinchState = 'zooming'
175
144
  }
@@ -183,7 +152,7 @@ export function useGestureEvents(ref: React.RefObject<HTMLDivElement | null>) {
183
152
  // |----| |------------|
184
153
  // originDistance ^ ^ touchDistance
185
154
 
186
- // How far have the two touch points moved towards or away from eachother?
155
+ // How far have the two touch points moved towards or away from each other?
187
156
  const touchDistance = Math.abs(currDistanceBetweenFingers - initDistanceBetweenFingers)
188
157
  // How far has the point between the touches moved?
189
158
  const originDistance = Vec.Dist(initPointBetweenFingers, prevPointBetweenFingers)
@@ -207,123 +176,226 @@ export function useGestureEvents(ref: React.RefObject<HTMLDivElement | null>) {
207
176
  }
208
177
  }
209
178
 
210
- const onPinch: PinchHandler = (gesture) => {
211
- const elm = ref.current
212
- const { event, origin, offset, da } = gesture
179
+ function dispatchPinchEvent(
180
+ name: 'pinch_start' | 'pinch' | 'pinch_end',
181
+ origin: { x: number; y: number },
182
+ delta: { x: number; y: number },
183
+ zoom: number,
184
+ event: TouchEvent | GestureEvent
185
+ ) {
186
+ editor.dispatch({
187
+ type: 'pinch',
188
+ name,
189
+ point: { x: origin.x, y: origin.y, z: zoom },
190
+ delta,
191
+ shiftKey: event.shiftKey,
192
+ altKey: event.altKey,
193
+ ctrlKey: event.metaKey || event.ctrlKey,
194
+ metaKey: event.metaKey,
195
+ accelKey: isAccelKey(event),
196
+ })
197
+ }
198
+
199
+ function getOriginAndDistance(t0: Touch, t1: Touch) {
200
+ const origin = {
201
+ x: (t0.clientX + t1.clientX) / 2,
202
+ y: (t0.clientY + t1.clientY) / 2,
203
+ }
204
+ const distance = Math.hypot(t1.clientX - t0.clientX, t1.clientY - t0.clientY)
205
+ return { origin, distance }
206
+ }
213
207
 
214
- if (event instanceof WheelEvent) return
208
+ function onTouchStart(event: TouchEvent) {
215
209
  if (!(event.target === elm || elm?.contains(event.target as Node))) return
216
210
 
217
- // In (desktop) Safari, a two finger trackpad pinch will be a "gesturechange" event
218
- // and will have 0 touches; on iOS, a two-finger pinch will be a "pointermove" event
219
- // with two touches.
220
- const isSafariTrackpadPinch =
221
- gesture.type === 'gesturechange' || gesture.type === 'gestureend'
211
+ activeTouches = Array.from(event.touches)
212
+
213
+ if (activeTouches.length === 2) {
214
+ // Two fingers down — start pinch
215
+ pinchState = 'not sure'
216
+ const { origin, distance } = getOriginAndDistance(activeTouches[0], activeTouches[1])
217
+
218
+ prevPointBetweenFingers.x = origin.x
219
+ prevPointBetweenFingers.y = origin.y
220
+ initPointBetweenFingers.x = origin.x
221
+ initPointBetweenFingers.y = origin.y
222
+ initDistanceBetweenFingers = Math.max(distance, 1)
223
+ currDistanceBetweenFingers = distance
224
+ initZoom = editor.getZoomLevel()
225
+ initScaleFrom = getScaleFrom()
226
+ scaleOffset = initScaleFrom
222
227
 
223
- // The distance between the two touch points
224
- currDistanceBetweenFingers = da[0]
228
+ dispatchPinchEvent('pinch_start', origin, { x: 0, y: 0 }, editor.getZoomLevel(), event)
229
+ }
230
+ }
231
+
232
+ function onTouchMove(event: TouchEvent) {
233
+ activeTouches = Array.from(event.touches)
234
+
235
+ if (activeTouches.length < 2) return
236
+
237
+ const { origin, distance } = getOriginAndDistance(activeTouches[0], activeTouches[1])
238
+ currDistanceBetweenFingers = distance
239
+
240
+ const dx = origin.x - prevPointBetweenFingers.x
241
+ const dy = origin.y - prevPointBetweenFingers.y
242
+
243
+ prevPointBetweenFingers.x = origin.x
244
+ prevPointBetweenFingers.y = origin.y
245
+
246
+ updatePinchState(false)
225
247
 
226
248
  // Only update the zoom if the pointers are far enough apart;
227
249
  // a very small touchDistance means that the user has probably
228
250
  // pinched out and their fingers are touching; this produces
229
251
  // very unstable zooming behavior.
230
-
231
- const dx = origin[0] - prevPointBetweenFingers.x
232
- const dy = origin[1] - prevPointBetweenFingers.y
233
-
234
- prevPointBetweenFingers.x = origin[0]
235
- prevPointBetweenFingers.y = origin[1]
236
-
237
- updatePinchState(isSafariTrackpadPinch)
252
+ const bounds = getScaleBounds()
253
+ const rawScale = initScaleFrom * (distance / initDistanceBetweenFingers)
254
+ scaleOffset = Math.min(bounds.max, Math.max(bounds.min, rawScale))
238
255
 
239
256
  switch (pinchState) {
240
257
  case 'zooming': {
241
- const currZoom = offset[0] ** editor.getCameraOptions().zoomSpeed
242
-
243
- editor.dispatch({
244
- type: 'pinch',
245
- name: 'pinch',
246
- point: { x: origin[0], y: origin[1], z: currZoom },
247
- delta: { x: dx, y: dy },
248
- shiftKey: event.shiftKey,
249
- altKey: event.altKey,
250
- ctrlKey: event.metaKey || event.ctrlKey,
251
- metaKey: event.metaKey,
252
- accelKey: isAccelKey(event),
253
- })
258
+ const currZoom = scaleOffset ** editor.getCameraOptions().zoomSpeed
259
+ dispatchPinchEvent('pinch', origin, { x: dx, y: dy }, currZoom, event)
254
260
  break
255
261
  }
256
262
  case 'panning': {
257
- editor.dispatch({
258
- type: 'pinch',
259
- name: 'pinch',
260
- point: { x: origin[0], y: origin[1], z: initZoom },
261
- delta: { x: dx, y: dy },
262
- shiftKey: event.shiftKey,
263
- altKey: event.altKey,
264
- ctrlKey: event.metaKey || event.ctrlKey,
265
- metaKey: event.metaKey,
266
- accelKey: isAccelKey(event),
267
- })
263
+ dispatchPinchEvent('pinch', origin, { x: dx, y: dy }, initZoom, event)
268
264
  break
269
265
  }
270
266
  }
271
267
  }
272
268
 
273
- const onPinchEnd: PinchHandler = (gesture) => {
274
- const elm = ref.current
275
- const { event, origin, offset } = gesture
269
+ function onTouchEnd(event: TouchEvent) {
270
+ const wasPinching = activeTouches.length >= 2
271
+ activeTouches = Array.from(event.touches)
276
272
 
277
- if (event instanceof WheelEvent) return
278
- if (!(event.target === elm || elm?.contains(event.target as Node))) return
273
+ if (wasPinching && activeTouches.length < 2) {
274
+ // Pinch ended
275
+ const scale = scaleOffset ** editor.getCameraOptions().zoomSpeed
276
+ const origin = { ...prevPointBetweenFingers }
277
+ pinchState = 'not sure'
278
+
279
+ editor.timers.requestAnimationFrame(() => {
280
+ dispatchPinchEvent('pinch_end', origin, { x: origin.x, y: origin.y }, scale, event)
281
+ })
282
+ }
283
+ }
284
+
285
+ // --- Safari trackpad pinch (GestureEvent) ---
286
+
287
+ let safariGestureInitialScale = 1
288
+
289
+ function onGestureStart(event: Event) {
290
+ const e = event as GestureEvent
291
+ if (!(e.target === elm || elm?.contains(e.target as Node))) return
292
+
293
+ preventDefault(e)
294
+ e.stopPropagation()
295
+
296
+ pinchState = 'not sure'
297
+ safariGestureInitialScale = getScaleFrom()
298
+ scaleOffset = safariGestureInitialScale
299
+ initZoom = editor.getZoomLevel()
300
+
301
+ prevPointBetweenFingers.x = e.clientX
302
+ prevPointBetweenFingers.y = e.clientY
303
+ initPointBetweenFingers.x = e.clientX
304
+ initPointBetweenFingers.y = e.clientY
305
+ initDistanceBetweenFingers = 1
306
+ currDistanceBetweenFingers = 1
307
+
308
+ dispatchPinchEvent(
309
+ 'pinch_start',
310
+ { x: e.clientX, y: e.clientY },
311
+ { x: 0, y: 0 },
312
+ editor.getZoomLevel(),
313
+ e
314
+ )
315
+ }
316
+
317
+ function onGestureChange(event: Event) {
318
+ const e = event as GestureEvent
319
+ if (!(e.target === elm || elm?.contains(e.target as Node))) return
320
+
321
+ preventDefault(e)
322
+ e.stopPropagation()
323
+
324
+ const dx = e.clientX - prevPointBetweenFingers.x
325
+ const dy = e.clientY - prevPointBetweenFingers.y
326
+
327
+ prevPointBetweenFingers.x = e.clientX
328
+ prevPointBetweenFingers.y = e.clientY
329
+
330
+ // Safari GestureEvent.scale is a multiplier relative to gesture start
331
+ const bounds = getScaleBounds()
332
+ const rawScale = safariGestureInitialScale * e.scale
333
+ scaleOffset = Math.min(bounds.max, Math.max(bounds.min, rawScale))
334
+
335
+ // Update distance tracking for pinch state (treat scale change as distance change)
336
+ currDistanceBetweenFingers = e.scale * initDistanceBetweenFingers
337
+
338
+ updatePinchState(true)
279
339
 
280
- const scale = offset[0] ** editor.getCameraOptions().zoomSpeed
340
+ const currZoom = scaleOffset ** editor.getCameraOptions().zoomSpeed
281
341
 
342
+ dispatchPinchEvent('pinch', { x: e.clientX, y: e.clientY }, { x: dx, y: dy }, currZoom, e)
343
+ }
344
+
345
+ function onGestureEnd(event: Event) {
346
+ const e = event as GestureEvent
347
+ if (!(e.target === elm || elm?.contains(e.target as Node))) return
348
+
349
+ preventDefault(e)
350
+ e.stopPropagation()
351
+
352
+ const scale = scaleOffset ** editor.getCameraOptions().zoomSpeed
282
353
  pinchState = 'not sure'
283
354
 
284
355
  editor.timers.requestAnimationFrame(() => {
285
- editor.dispatch({
286
- type: 'pinch',
287
- name: 'pinch_end',
288
- point: { x: origin[0], y: origin[1], z: scale },
289
- delta: { x: origin[0], y: origin[1] },
290
- shiftKey: event.shiftKey,
291
- altKey: event.altKey,
292
- ctrlKey: event.metaKey || event.ctrlKey,
293
- metaKey: event.metaKey,
294
- accelKey: isAccelKey(event),
295
- })
356
+ dispatchPinchEvent(
357
+ 'pinch_end',
358
+ { x: e.clientX, y: e.clientY },
359
+ { x: e.clientX, y: e.clientY },
360
+ scale,
361
+ e
362
+ )
296
363
  })
297
364
  }
298
365
 
299
- return {
300
- onWheel,
301
- onPinchStart,
302
- onPinchEnd,
303
- onPinch,
366
+ // --- Attach event listeners ---
367
+
368
+ elm.addEventListener('wheel', onWheel, { passive: false })
369
+
370
+ // On touch devices (iOS), use pointer events for pinch.
371
+ // On non-touch Safari (macOS trackpad), use GestureEvent.
372
+ // Never use both simultaneously — on iOS Safari, both event types fire
373
+ // for the same pinch gesture, causing conflicting state updates.
374
+ const useGestureEvents = !tlenv.isIos && 'GestureEvent' in window
375
+
376
+ if (useGestureEvents) {
377
+ elm.addEventListener('gesturestart', onGestureStart)
378
+ elm.addEventListener('gesturechange', onGestureChange)
379
+ elm.addEventListener('gestureend', onGestureEnd)
380
+ } else {
381
+ elm.addEventListener('touchstart', onTouchStart)
382
+ elm.addEventListener('touchmove', onTouchMove)
383
+ elm.addEventListener('touchend', onTouchEnd)
384
+ elm.addEventListener('touchcancel', onTouchEnd)
304
385
  }
305
- }, [editor, ref])
306
386
 
307
- useGesture(events, {
308
- target: ref,
309
- eventOptions: { passive: false },
310
- pinch: {
311
- from: () => {
312
- const { zoomSpeed } = editor.getCameraOptions()
313
- const level = editor.getZoomLevel() ** (1 / zoomSpeed)
314
- return [level, 0]
315
- }, // Return the camera z to use when pinch starts
316
- scaleBounds: () => {
317
- const baseZoom = editor.getBaseZoom()
318
- const { zoomSteps, zoomSpeed } = editor.getCameraOptions()
319
- const zoomMin = zoomSteps[0] * baseZoom
320
- const zoomMax = zoomSteps[zoomSteps.length - 1] * baseZoom
321
-
322
- return {
323
- max: zoomMax ** (1 / zoomSpeed),
324
- min: zoomMin ** (1 / zoomSpeed),
325
- }
326
- },
327
- },
328
- })
387
+ return () => {
388
+ elm.removeEventListener('wheel', onWheel)
389
+ if (useGestureEvents) {
390
+ elm.removeEventListener('gesturestart', onGestureStart)
391
+ elm.removeEventListener('gesturechange', onGestureChange)
392
+ elm.removeEventListener('gestureend', onGestureEnd)
393
+ } else {
394
+ elm.removeEventListener('touchstart', onTouchStart)
395
+ elm.removeEventListener('touchmove', onTouchMove)
396
+ elm.removeEventListener('touchend', onTouchEnd)
397
+ elm.removeEventListener('touchcancel', onTouchEnd)
398
+ }
399
+ }
400
+ }, [editor, ref])
329
401
  }
@@ -154,6 +154,12 @@ export interface TldrawOptions {
154
154
  * When false, the spacebar will not pan the camera.
155
155
  */
156
156
  readonly spacebarPanning: boolean
157
+ /**
158
+ * Whether to allow right-click + drag to pan the camera. When true, right-click + drag pans the
159
+ * camera and a static right-click opens the context menu at the release position. When false,
160
+ * right-click opens the context menu on press (no drag-to-pan).
161
+ */
162
+ readonly rightClickPanning: boolean
157
163
  /**
158
164
  * The default padding (in pixels) used when zooming to fit content in the viewport.
159
165
  * This affects methods like `zoomToFit()`, `zoomToSelection()`, and `zoomToBounds()`.
@@ -196,6 +202,12 @@ export interface TldrawOptions {
196
202
  * viewport's page dimensions regardless of overview zoom changes.
197
203
  */
198
204
  readonly quickZoomPreservesScreenBounds: boolean
205
+ /**
206
+ * Whether to use 2D canvas rendering for shape indicators. When true (default),
207
+ * shapes that support it will render indicators on a 2D canvas for better
208
+ * performance. When false, all indicators use legacy SVG rendering.
209
+ */
210
+ readonly useCanvasIndicators: boolean
199
211
  /**
200
212
  * Called before content is written to the clipboard during a copy or cut operation.
201
213
  * Receives the serialized content (shapes, bindings, assets) and can filter or transform
@@ -326,11 +338,13 @@ export const defaultTldrawOptions = {
326
338
  debouncedZoom: true,
327
339
  debouncedZoomThreshold: 500,
328
340
  spacebarPanning: true,
341
+ rightClickPanning: true,
329
342
  zoomToFitPadding: 128,
330
343
  snapThreshold: 8,
331
344
  camera: DEFAULT_CAMERA_OPTIONS,
332
345
  text: {},
333
346
  deepLinks: undefined,
347
+ useCanvasIndicators: true,
334
348
  quickZoomPreservesScreenBounds: true,
335
349
  onBeforeCopyToClipboard: undefined,
336
350
  onBeforePasteFromClipboard: undefined,
@@ -728,4 +728,34 @@ describe('Box', () => {
728
728
  expect(result).not.toBe(zeroBox) // different object
729
729
  })
730
730
  })
731
+
732
+ describe('Box.isValid', () => {
733
+ it('returns true for normal box', () => {
734
+ expect(new Box(10, 20, 100, 200).isValid()).toBe(true)
735
+ })
736
+
737
+ it('returns false when x is NaN', () => {
738
+ expect(new Box(NaN, 0, 100, 100).isValid()).toBe(false)
739
+ })
740
+
741
+ it('returns false when y is NaN', () => {
742
+ expect(new Box(0, NaN, 100, 100).isValid()).toBe(false)
743
+ })
744
+
745
+ it('returns false when w is NaN', () => {
746
+ expect(new Box(0, 0, NaN, 100).isValid()).toBe(false)
747
+ })
748
+
749
+ it('returns false when h is NaN', () => {
750
+ expect(new Box(0, 0, 100, NaN).isValid()).toBe(false)
751
+ })
752
+
753
+ it('returns false for Infinity', () => {
754
+ expect(new Box(Infinity, 0, 100, 100).isValid()).toBe(false)
755
+ })
756
+
757
+ it('returns true for zero-sized box', () => {
758
+ expect(new Box(0, 0, 0, 0).isValid()).toBe(true)
759
+ })
760
+ })
731
761
  })
@@ -1,5 +1,6 @@
1
1
  import { Mat } from '../Mat'
2
2
  import { Vec, VecLike } from '../Vec'
3
+ import { Edge2d } from './Edge2d'
3
4
  import { Geometry2dFilters } from './Geometry2d'
4
5
  import { Group2d } from './Group2d'
5
6
  import { Rectangle2d } from './Rectangle2d'
@@ -456,6 +457,26 @@ describe('Group2d getBoundsVertices', () => {
456
457
  })
457
458
  })
458
459
 
460
+ describe('interpolateAlongEdge', () => {
461
+ it('returns vertex when segment has zero length', () => {
462
+ const edge = new Edge2d({ start: new Vec(5, 5), end: new Vec(5, 5) })
463
+ const result = edge.interpolateAlongEdge(0.5)
464
+ expect(result.x).toBe(5)
465
+ expect(result.y).toBe(5)
466
+ expect(Number.isFinite(result.x)).toBe(true)
467
+ expect(Number.isFinite(result.y)).toBe(true)
468
+ })
469
+ })
470
+
471
+ describe('uninterpolateAlongEdge', () => {
472
+ it('returns 0 when geometry has zero length', () => {
473
+ const edge = new Edge2d({ start: new Vec(5, 5), end: new Vec(5, 5) })
474
+ const result = edge.uninterpolateAlongEdge(new Vec(5, 5))
475
+ expect(result).toBe(0)
476
+ expect(Number.isFinite(result)).toBe(true)
477
+ })
478
+ })
479
+
459
480
  function expectApproxMatch(a: VecLike, b: VecLike) {
460
481
  expect(a.x).toBeCloseTo(b.x, 0.0001)
461
482
  expect(a.y).toBeCloseTo(b.y, 0.0001)
@@ -103,9 +103,13 @@ export function kickoutOccludedShapes(
103
103
  if (oldParentIndex > -1) {
104
104
  // If the old parent is a direct child of the new parent, then we'll add them above the old parent but below the next sibling.
105
105
  const siblingsIndexAbove = oldParentSiblingIds[oldParentIndex + 1]
106
- const indexKeyAbove = siblingsIndexAbove
106
+ const siblingAboveIndex = siblingsIndexAbove
107
107
  ? editor.getShape(siblingsIndexAbove)!.index
108
- : getIndexAbove(prevParent.index)
108
+ : undefined
109
+ const indexKeyAbove =
110
+ siblingAboveIndex && siblingAboveIndex > prevParent.index
111
+ ? siblingAboveIndex
112
+ : getIndexAbove(prevParent.index)
109
113
  insertIndexKey = getIndexBetween(prevParent.index, indexKeyAbove)
110
114
  } else {
111
115
  // If the old parent is not a direct child of the new parent, then we'll add them to the "top" of the new parent's children.
@@ -2,9 +2,9 @@ import { getSchema, JSONContent, Editor as TTEditor } from '@tiptap/core'
2
2
  import { Node, Schema } from '@tiptap/pm/model'
3
3
  import { EditorProviderProps } from '@tiptap/react'
4
4
  import { TLRichText } from '@tldraw/tlschema'
5
+ import { TLFontFace } from '@tldraw/tlschema'
5
6
  import { assert, WeakCache } from '@tldraw/utils'
6
7
  import type { Editor } from '../editor/Editor'
7
- import { TLFontFace } from '../editor/managers/FontManager/FontManager'
8
8
 
9
9
  /**
10
10
  * This is the TipTap editor! Docs are {@link https://tiptap.dev/docs}.
@@ -1,3 +1,5 @@
1
+ import { hardReset } from './sync/hardReset'
2
+
1
3
  /** @public */
2
4
  export const runtime: {
3
5
  openWindow(url: string, target: string, allowReferrer?: boolean): void
@@ -11,7 +13,7 @@ export const runtime: {
11
13
  window.location.reload()
12
14
  },
13
15
  async hardReset() {
14
- return await (window as any).__tldraw__hardReset?.()
16
+ return await hardReset({ shouldReload: true })
15
17
  },
16
18
  }
17
19