@tldraw/editor 4.6.0-next.5a871ec02ff3 → 4.6.0-next.6594d48ace27

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 (448) hide show
  1. package/dist-cjs/index.d.ts +1316 -285
  2. package/dist-cjs/index.js +31 -26
  3. package/dist-cjs/index.js.map +3 -3
  4. package/dist-cjs/lib/TldrawEditor.js +62 -14
  5. package/dist-cjs/lib/TldrawEditor.js.map +3 -3
  6. package/dist-cjs/lib/components/MenuClickCapture.js +99 -38
  7. package/dist-cjs/lib/components/MenuClickCapture.js.map +2 -2
  8. package/dist-cjs/lib/components/default-components/CanvasOverlays.js +180 -0
  9. package/dist-cjs/lib/components/default-components/CanvasOverlays.js.map +7 -0
  10. package/dist-cjs/lib/components/default-components/DefaultCanvas.js +33 -236
  11. package/dist-cjs/lib/components/default-components/DefaultCanvas.js.map +3 -3
  12. package/dist-cjs/lib/components/default-components/DefaultErrorFallback.js.map +2 -2
  13. package/dist-cjs/lib/config/{createTLUser.js → createTLCurrentUser.js} +9 -9
  14. package/dist-cjs/lib/config/createTLCurrentUser.js.map +7 -0
  15. package/dist-cjs/lib/config/createTLStore.js +31 -1
  16. package/dist-cjs/lib/config/createTLStore.js.map +2 -2
  17. package/dist-cjs/lib/{components/default-components/DefaultShapeIndicatorErrorFallback.js → config/defaultAssets.js} +17 -9
  18. package/dist-cjs/lib/config/defaultAssets.js.map +7 -0
  19. package/dist-cjs/lib/config/defaultShapes.js.map +2 -2
  20. package/dist-cjs/lib/editor/Editor.js +921 -386
  21. package/dist-cjs/lib/editor/Editor.js.map +3 -3
  22. package/dist-cjs/lib/editor/assets/AssetUtil.js +67 -0
  23. package/dist-cjs/lib/editor/assets/AssetUtil.js.map +7 -0
  24. package/dist-cjs/lib/editor/bindings/BindingUtil.js +1 -0
  25. package/dist-cjs/lib/editor/bindings/BindingUtil.js.map +1 -1
  26. package/dist-cjs/lib/editor/managers/ClickManager/ClickManager.js +26 -64
  27. package/dist-cjs/lib/editor/managers/ClickManager/ClickManager.js.map +2 -2
  28. package/dist-cjs/lib/editor/managers/CollaboratorsManager/CollaboratorsManager.js +98 -0
  29. package/dist-cjs/lib/editor/managers/CollaboratorsManager/CollaboratorsManager.js.map +7 -0
  30. package/dist-cjs/lib/editor/managers/EdgeScrollManager/EdgeScrollManager.js +2 -1
  31. package/dist-cjs/lib/editor/managers/EdgeScrollManager/EdgeScrollManager.js.map +2 -2
  32. package/dist-cjs/lib/editor/managers/FocusManager/FocusManager.js +15 -53
  33. package/dist-cjs/lib/editor/managers/FocusManager/FocusManager.js.map +1 -1
  34. package/dist-cjs/lib/editor/managers/FontManager/FontManager.js +2 -0
  35. package/dist-cjs/lib/editor/managers/FontManager/FontManager.js.map +2 -2
  36. package/dist-cjs/lib/editor/managers/HistoryManager/HistoryManager.js +2 -0
  37. package/dist-cjs/lib/editor/managers/HistoryManager/HistoryManager.js.map +1 -1
  38. package/dist-cjs/lib/editor/managers/InputsManager/InputsManager.js +83 -112
  39. package/dist-cjs/lib/editor/managers/InputsManager/InputsManager.js.map +2 -2
  40. package/dist-cjs/lib/editor/managers/PerformanceManager/PerformanceApiAdapter.js +80 -0
  41. package/dist-cjs/lib/editor/managers/PerformanceManager/PerformanceApiAdapter.js.map +7 -0
  42. package/dist-cjs/lib/editor/managers/PerformanceManager/PerformanceManager.js +466 -0
  43. package/dist-cjs/lib/editor/managers/PerformanceManager/PerformanceManager.js.map +7 -0
  44. package/dist-cjs/lib/{components/default-components/DefaultHandles.js → editor/managers/PerformanceManager/perf-types.js} +3 -14
  45. package/dist-cjs/lib/editor/managers/PerformanceManager/perf-types.js.map +7 -0
  46. package/dist-cjs/lib/editor/managers/ScribbleManager/ScribbleManager.js +1 -0
  47. package/dist-cjs/lib/editor/managers/ScribbleManager/ScribbleManager.js.map +1 -1
  48. package/dist-cjs/lib/editor/managers/SnapManager/BoundsSnaps.js +22 -56
  49. package/dist-cjs/lib/editor/managers/SnapManager/BoundsSnaps.js.map +2 -2
  50. package/dist-cjs/lib/editor/managers/SnapManager/HandleSnaps.js +12 -52
  51. package/dist-cjs/lib/editor/managers/SnapManager/HandleSnaps.js.map +2 -2
  52. package/dist-cjs/lib/editor/managers/SnapManager/SnapManager.js +21 -57
  53. package/dist-cjs/lib/editor/managers/SnapManager/SnapManager.js.map +2 -2
  54. package/dist-cjs/lib/editor/managers/SpatialIndexManager/SpatialIndexManager.js +5 -4
  55. package/dist-cjs/lib/editor/managers/SpatialIndexManager/SpatialIndexManager.js.map +2 -2
  56. package/dist-cjs/lib/editor/managers/TextManager/TextManager.js +103 -30
  57. package/dist-cjs/lib/editor/managers/TextManager/TextManager.js.map +2 -2
  58. package/dist-cjs/lib/editor/managers/ThemeManager/ThemeManager.js +107 -0
  59. package/dist-cjs/lib/editor/managers/ThemeManager/ThemeManager.js.map +7 -0
  60. package/dist-cjs/lib/editor/managers/ThemeManager/defaultThemes.js +600 -0
  61. package/dist-cjs/lib/editor/managers/ThemeManager/defaultThemes.js.map +7 -0
  62. package/dist-cjs/lib/editor/managers/TickManager/TickManager.js +17 -55
  63. package/dist-cjs/lib/editor/managers/TickManager/TickManager.js.map +1 -1
  64. package/dist-cjs/lib/editor/managers/UserPreferencesManager/UserPreferencesManager.js +65 -72
  65. package/dist-cjs/lib/editor/managers/UserPreferencesManager/UserPreferencesManager.js.map +2 -2
  66. package/dist-cjs/lib/editor/overlays/OverlayManager.js +154 -0
  67. package/dist-cjs/lib/editor/overlays/OverlayManager.js.map +7 -0
  68. package/dist-cjs/lib/editor/overlays/OverlayUtil.js +92 -0
  69. package/dist-cjs/lib/editor/overlays/OverlayUtil.js.map +7 -0
  70. package/dist-cjs/lib/editor/overlays/ShapeIndicatorOverlayUtil.js +161 -0
  71. package/dist-cjs/lib/editor/overlays/ShapeIndicatorOverlayUtil.js.map +7 -0
  72. package/dist-cjs/lib/editor/shapes/BaseFrameLikeShapeUtil.js +76 -0
  73. package/dist-cjs/lib/editor/shapes/BaseFrameLikeShapeUtil.js.map +7 -0
  74. package/dist-cjs/lib/editor/shapes/ShapeUtil.js +35 -20
  75. package/dist-cjs/lib/editor/shapes/ShapeUtil.js.map +2 -2
  76. package/dist-cjs/lib/editor/shapes/group/GroupShapeUtil.js +33 -3
  77. package/dist-cjs/lib/editor/shapes/group/GroupShapeUtil.js.map +2 -2
  78. package/dist-cjs/lib/editor/shapes/shared/getPerfectDashProps.js +6 -0
  79. package/dist-cjs/lib/editor/shapes/shared/getPerfectDashProps.js.map +2 -2
  80. package/dist-cjs/lib/editor/tools/StateNode.js +15 -17
  81. package/dist-cjs/lib/editor/tools/StateNode.js.map +2 -2
  82. package/dist-cjs/lib/editor/types/SvgExportContext.js.map +2 -2
  83. package/dist-cjs/lib/editor/types/clipboard-types.js.map +1 -1
  84. package/dist-cjs/lib/editor/types/event-types.js.map +2 -2
  85. package/dist-cjs/lib/editor/types/external-content.js.map +1 -1
  86. package/dist-cjs/lib/exports/ExportDelay.js +13 -53
  87. package/dist-cjs/lib/exports/ExportDelay.js.map +1 -1
  88. package/dist-cjs/lib/exports/FontEmbedder.js +14 -57
  89. package/dist-cjs/lib/exports/FontEmbedder.js.map +1 -1
  90. package/dist-cjs/lib/exports/StyleEmbedder.js +2 -1
  91. package/dist-cjs/lib/exports/StyleEmbedder.js.map +2 -2
  92. package/dist-cjs/lib/exports/fetchCache.js +1 -1
  93. package/dist-cjs/lib/exports/fetchCache.js.map +2 -2
  94. package/dist-cjs/lib/exports/getSvgJsx.js +14 -8
  95. package/dist-cjs/lib/exports/getSvgJsx.js.map +2 -2
  96. package/dist-cjs/lib/globals/environment.js +18 -1
  97. package/dist-cjs/lib/globals/environment.js.map +2 -2
  98. package/dist-cjs/lib/hooks/EditorComponentsContext.js.map +2 -2
  99. package/dist-cjs/lib/hooks/useCanvasEvents.js +25 -4
  100. package/dist-cjs/lib/hooks/useCanvasEvents.js.map +2 -2
  101. package/dist-cjs/lib/hooks/{useIsDarkMode.js → useColorMode.js} +14 -10
  102. package/dist-cjs/lib/hooks/useColorMode.js.map +7 -0
  103. package/dist-cjs/lib/hooks/useCursor.js +3 -7
  104. package/dist-cjs/lib/hooks/useCursor.js.map +2 -2
  105. package/dist-cjs/lib/hooks/useDarkMode.js +4 -4
  106. package/dist-cjs/lib/hooks/useDarkMode.js.map +2 -2
  107. package/dist-cjs/lib/hooks/useEditorComponents.js +0 -28
  108. package/dist-cjs/lib/hooks/useEditorComponents.js.map +2 -2
  109. package/dist-cjs/lib/hooks/useGestureEvents.js +171 -127
  110. package/dist-cjs/lib/hooks/useGestureEvents.js.map +3 -3
  111. package/dist-cjs/lib/hooks/useLocalStore.js.map +2 -2
  112. package/dist-cjs/lib/hooks/usePeerIds.js +1 -36
  113. package/dist-cjs/lib/hooks/usePeerIds.js.map +2 -2
  114. package/dist-cjs/lib/hooks/useShapeCulling.js +2 -1
  115. package/dist-cjs/lib/hooks/useShapeCulling.js.map +2 -2
  116. package/dist-cjs/lib/options.js +4 -0
  117. package/dist-cjs/lib/options.js.map +2 -2
  118. package/dist-cjs/lib/primitives/Box.js +26 -26
  119. package/dist-cjs/lib/primitives/Box.js.map +2 -2
  120. package/dist-cjs/lib/primitives/Vec.js +4 -1
  121. package/dist-cjs/lib/primitives/Vec.js.map +2 -2
  122. package/dist-cjs/lib/primitives/geometry/Arc2d.js +2 -2
  123. package/dist-cjs/lib/primitives/geometry/Arc2d.js.map +2 -2
  124. package/dist-cjs/lib/primitives/geometry/Circle2d.js +3 -2
  125. package/dist-cjs/lib/primitives/geometry/Circle2d.js.map +2 -2
  126. package/dist-cjs/lib/primitives/geometry/CubicSpline2d.js +1 -1
  127. package/dist-cjs/lib/primitives/geometry/CubicSpline2d.js.map +1 -1
  128. package/dist-cjs/lib/primitives/geometry/Ellipse2d.js +4 -3
  129. package/dist-cjs/lib/primitives/geometry/Ellipse2d.js.map +2 -2
  130. package/dist-cjs/lib/primitives/geometry/Geometry2d.js +12 -9
  131. package/dist-cjs/lib/primitives/geometry/Geometry2d.js.map +2 -2
  132. package/dist-cjs/lib/primitives/geometry/Polyline2d.js +2 -2
  133. package/dist-cjs/lib/primitives/geometry/Polyline2d.js.map +2 -2
  134. package/dist-cjs/lib/primitives/geometry/Stadium2d.js +2 -1
  135. package/dist-cjs/lib/primitives/geometry/Stadium2d.js.map +2 -2
  136. package/dist-cjs/lib/utils/EditorAtom.js +2 -0
  137. package/dist-cjs/lib/utils/EditorAtom.js.map +1 -1
  138. package/dist-cjs/lib/utils/SharedStylesMap.js +1 -1
  139. package/dist-cjs/lib/utils/SharedStylesMap.js.map +1 -1
  140. package/dist-cjs/lib/utils/getSvgPathFromPoints.js.map +2 -2
  141. package/dist-cjs/lib/utils/reparenting.js +2 -1
  142. package/dist-cjs/lib/utils/reparenting.js.map +2 -2
  143. package/dist-cjs/lib/utils/richText.js.map +2 -2
  144. package/dist-cjs/lib/utils/runtime.js +2 -1
  145. package/dist-cjs/lib/utils/runtime.js.map +2 -2
  146. package/dist-cjs/lib/utils/sync/TLLocalSyncClient.js +8 -2
  147. package/dist-cjs/lib/utils/sync/TLLocalSyncClient.js.map +2 -2
  148. package/dist-cjs/lib/utils/sync/hardReset.js +0 -8
  149. package/dist-cjs/lib/utils/sync/hardReset.js.map +2 -2
  150. package/dist-cjs/version.js +3 -3
  151. package/dist-cjs/version.js.map +1 -1
  152. package/dist-esm/index.d.mts +1316 -285
  153. package/dist-esm/index.mjs +44 -48
  154. package/dist-esm/index.mjs.map +2 -2
  155. package/dist-esm/lib/TldrawEditor.mjs +65 -14
  156. package/dist-esm/lib/TldrawEditor.mjs.map +3 -3
  157. package/dist-esm/lib/components/MenuClickCapture.mjs +100 -39
  158. package/dist-esm/lib/components/MenuClickCapture.mjs.map +2 -2
  159. package/dist-esm/lib/components/default-components/CanvasOverlays.mjs +160 -0
  160. package/dist-esm/lib/components/default-components/CanvasOverlays.mjs.map +7 -0
  161. package/dist-esm/lib/components/default-components/DefaultCanvas.mjs +34 -237
  162. package/dist-esm/lib/components/default-components/DefaultCanvas.mjs.map +3 -3
  163. package/dist-esm/lib/components/default-components/DefaultErrorFallback.mjs.map +2 -2
  164. package/dist-esm/lib/config/{createTLUser.mjs → createTLCurrentUser.mjs} +6 -6
  165. package/dist-esm/lib/config/createTLCurrentUser.mjs.map +7 -0
  166. package/dist-esm/lib/config/createTLStore.mjs +37 -2
  167. package/dist-esm/lib/config/createTLStore.mjs.map +2 -2
  168. package/dist-esm/lib/config/defaultAssets.mjs +16 -0
  169. package/dist-esm/lib/config/defaultAssets.mjs.map +7 -0
  170. package/dist-esm/lib/config/defaultShapes.mjs.map +2 -2
  171. package/dist-esm/lib/editor/Editor.mjs +924 -389
  172. package/dist-esm/lib/editor/Editor.mjs.map +3 -3
  173. package/dist-esm/lib/editor/assets/AssetUtil.mjs +47 -0
  174. package/dist-esm/lib/editor/assets/AssetUtil.mjs.map +7 -0
  175. package/dist-esm/lib/editor/bindings/BindingUtil.mjs +1 -0
  176. package/dist-esm/lib/editor/bindings/BindingUtil.mjs.map +1 -1
  177. package/dist-esm/lib/editor/managers/ClickManager/ClickManager.mjs +26 -64
  178. package/dist-esm/lib/editor/managers/ClickManager/ClickManager.mjs.map +2 -2
  179. package/dist-esm/lib/editor/managers/CollaboratorsManager/CollaboratorsManager.mjs +83 -0
  180. package/dist-esm/lib/editor/managers/CollaboratorsManager/CollaboratorsManager.mjs.map +7 -0
  181. package/dist-esm/lib/editor/managers/EdgeScrollManager/EdgeScrollManager.mjs +2 -1
  182. package/dist-esm/lib/editor/managers/EdgeScrollManager/EdgeScrollManager.mjs.map +2 -2
  183. package/dist-esm/lib/editor/managers/FocusManager/FocusManager.mjs +15 -53
  184. package/dist-esm/lib/editor/managers/FocusManager/FocusManager.mjs.map +1 -1
  185. package/dist-esm/lib/editor/managers/FontManager/FontManager.mjs +2 -0
  186. package/dist-esm/lib/editor/managers/FontManager/FontManager.mjs.map +2 -2
  187. package/dist-esm/lib/editor/managers/HistoryManager/HistoryManager.mjs +2 -0
  188. package/dist-esm/lib/editor/managers/HistoryManager/HistoryManager.mjs.map +1 -1
  189. package/dist-esm/lib/editor/managers/InputsManager/InputsManager.mjs +83 -112
  190. package/dist-esm/lib/editor/managers/InputsManager/InputsManager.mjs.map +2 -2
  191. package/dist-esm/lib/editor/managers/PerformanceManager/PerformanceApiAdapter.mjs +60 -0
  192. package/dist-esm/lib/editor/managers/PerformanceManager/PerformanceApiAdapter.mjs.map +7 -0
  193. package/dist-esm/lib/editor/managers/PerformanceManager/PerformanceManager.mjs +438 -0
  194. package/dist-esm/lib/editor/managers/PerformanceManager/PerformanceManager.mjs.map +7 -0
  195. package/dist-esm/lib/editor/managers/PerformanceManager/perf-types.mjs +1 -0
  196. package/dist-esm/lib/editor/managers/PerformanceManager/perf-types.mjs.map +7 -0
  197. package/dist-esm/lib/editor/managers/ScribbleManager/ScribbleManager.mjs +1 -0
  198. package/dist-esm/lib/editor/managers/ScribbleManager/ScribbleManager.mjs.map +1 -1
  199. package/dist-esm/lib/editor/managers/SnapManager/BoundsSnaps.mjs +22 -56
  200. package/dist-esm/lib/editor/managers/SnapManager/BoundsSnaps.mjs.map +2 -2
  201. package/dist-esm/lib/editor/managers/SnapManager/HandleSnaps.mjs +12 -52
  202. package/dist-esm/lib/editor/managers/SnapManager/HandleSnaps.mjs.map +2 -2
  203. package/dist-esm/lib/editor/managers/SnapManager/SnapManager.mjs +21 -57
  204. package/dist-esm/lib/editor/managers/SnapManager/SnapManager.mjs.map +2 -2
  205. package/dist-esm/lib/editor/managers/SpatialIndexManager/SpatialIndexManager.mjs +5 -4
  206. package/dist-esm/lib/editor/managers/SpatialIndexManager/SpatialIndexManager.mjs.map +2 -2
  207. package/dist-esm/lib/editor/managers/TextManager/TextManager.mjs +103 -30
  208. package/dist-esm/lib/editor/managers/TextManager/TextManager.mjs.map +2 -2
  209. package/dist-esm/lib/editor/managers/ThemeManager/ThemeManager.mjs +89 -0
  210. package/dist-esm/lib/editor/managers/ThemeManager/ThemeManager.mjs.map +7 -0
  211. package/dist-esm/lib/editor/managers/ThemeManager/defaultThemes.mjs +582 -0
  212. package/dist-esm/lib/editor/managers/ThemeManager/defaultThemes.mjs.map +7 -0
  213. package/dist-esm/lib/editor/managers/TickManager/TickManager.mjs +17 -55
  214. package/dist-esm/lib/editor/managers/TickManager/TickManager.mjs.map +1 -1
  215. package/dist-esm/lib/editor/managers/UserPreferencesManager/UserPreferencesManager.mjs +65 -72
  216. package/dist-esm/lib/editor/managers/UserPreferencesManager/UserPreferencesManager.mjs.map +2 -2
  217. package/dist-esm/lib/editor/overlays/OverlayManager.mjs +136 -0
  218. package/dist-esm/lib/editor/overlays/OverlayManager.mjs.map +7 -0
  219. package/dist-esm/lib/editor/overlays/OverlayUtil.mjs +72 -0
  220. package/dist-esm/lib/editor/overlays/OverlayUtil.mjs.map +7 -0
  221. package/dist-esm/lib/editor/overlays/ShapeIndicatorOverlayUtil.mjs +141 -0
  222. package/dist-esm/lib/editor/overlays/ShapeIndicatorOverlayUtil.mjs.map +7 -0
  223. package/dist-esm/lib/editor/shapes/BaseFrameLikeShapeUtil.mjs +56 -0
  224. package/dist-esm/lib/editor/shapes/BaseFrameLikeShapeUtil.mjs.map +7 -0
  225. package/dist-esm/lib/editor/shapes/ShapeUtil.mjs +35 -20
  226. package/dist-esm/lib/editor/shapes/ShapeUtil.mjs.map +2 -2
  227. package/dist-esm/lib/editor/shapes/group/GroupShapeUtil.mjs +33 -3
  228. package/dist-esm/lib/editor/shapes/group/GroupShapeUtil.mjs.map +2 -2
  229. package/dist-esm/lib/editor/shapes/shared/getPerfectDashProps.mjs +6 -0
  230. package/dist-esm/lib/editor/shapes/shared/getPerfectDashProps.mjs.map +2 -2
  231. package/dist-esm/lib/editor/tools/StateNode.mjs +15 -17
  232. package/dist-esm/lib/editor/tools/StateNode.mjs.map +2 -2
  233. package/dist-esm/lib/editor/types/SvgExportContext.mjs.map +2 -2
  234. package/dist-esm/lib/editor/types/event-types.mjs.map +2 -2
  235. package/dist-esm/lib/exports/ExportDelay.mjs +13 -53
  236. package/dist-esm/lib/exports/ExportDelay.mjs.map +1 -1
  237. package/dist-esm/lib/exports/FontEmbedder.mjs +14 -57
  238. package/dist-esm/lib/exports/FontEmbedder.mjs.map +1 -1
  239. package/dist-esm/lib/exports/StyleEmbedder.mjs +2 -1
  240. package/dist-esm/lib/exports/StyleEmbedder.mjs.map +2 -2
  241. package/dist-esm/lib/exports/fetchCache.mjs +2 -2
  242. package/dist-esm/lib/exports/fetchCache.mjs.map +2 -2
  243. package/dist-esm/lib/exports/getSvgJsx.mjs +14 -11
  244. package/dist-esm/lib/exports/getSvgJsx.mjs.map +2 -2
  245. package/dist-esm/lib/globals/environment.mjs +18 -1
  246. package/dist-esm/lib/globals/environment.mjs.map +2 -2
  247. package/dist-esm/lib/hooks/EditorComponentsContext.mjs.map +2 -2
  248. package/dist-esm/lib/hooks/useCanvasEvents.mjs +25 -4
  249. package/dist-esm/lib/hooks/useCanvasEvents.mjs.map +2 -2
  250. package/dist-esm/lib/hooks/useColorMode.mjs +19 -0
  251. package/dist-esm/lib/hooks/useColorMode.mjs.map +7 -0
  252. package/dist-esm/lib/hooks/useCursor.mjs +3 -7
  253. package/dist-esm/lib/hooks/useCursor.mjs.map +2 -2
  254. package/dist-esm/lib/hooks/useDarkMode.mjs +4 -4
  255. package/dist-esm/lib/hooks/useDarkMode.mjs.map +2 -2
  256. package/dist-esm/lib/hooks/useEditorComponents.mjs +0 -28
  257. package/dist-esm/lib/hooks/useEditorComponents.mjs.map +2 -2
  258. package/dist-esm/lib/hooks/useGestureEvents.mjs +171 -127
  259. package/dist-esm/lib/hooks/useGestureEvents.mjs.map +3 -3
  260. package/dist-esm/lib/hooks/useLocalStore.mjs.map +2 -2
  261. package/dist-esm/lib/hooks/usePeerIds.mjs +2 -40
  262. package/dist-esm/lib/hooks/usePeerIds.mjs.map +2 -2
  263. package/dist-esm/lib/hooks/useShapeCulling.mjs +2 -1
  264. package/dist-esm/lib/hooks/useShapeCulling.mjs.map +2 -2
  265. package/dist-esm/lib/options.mjs +4 -0
  266. package/dist-esm/lib/options.mjs.map +2 -2
  267. package/dist-esm/lib/primitives/Box.mjs +26 -26
  268. package/dist-esm/lib/primitives/Box.mjs.map +2 -2
  269. package/dist-esm/lib/primitives/Vec.mjs +4 -1
  270. package/dist-esm/lib/primitives/Vec.mjs.map +2 -2
  271. package/dist-esm/lib/primitives/geometry/Arc2d.mjs +2 -2
  272. package/dist-esm/lib/primitives/geometry/Arc2d.mjs.map +2 -2
  273. package/dist-esm/lib/primitives/geometry/Circle2d.mjs +3 -2
  274. package/dist-esm/lib/primitives/geometry/Circle2d.mjs.map +2 -2
  275. package/dist-esm/lib/primitives/geometry/CubicSpline2d.mjs +1 -1
  276. package/dist-esm/lib/primitives/geometry/CubicSpline2d.mjs.map +1 -1
  277. package/dist-esm/lib/primitives/geometry/Ellipse2d.mjs +4 -3
  278. package/dist-esm/lib/primitives/geometry/Ellipse2d.mjs.map +2 -2
  279. package/dist-esm/lib/primitives/geometry/Geometry2d.mjs +12 -9
  280. package/dist-esm/lib/primitives/geometry/Geometry2d.mjs.map +2 -2
  281. package/dist-esm/lib/primitives/geometry/Polyline2d.mjs +2 -2
  282. package/dist-esm/lib/primitives/geometry/Polyline2d.mjs.map +2 -2
  283. package/dist-esm/lib/primitives/geometry/Stadium2d.mjs +2 -1
  284. package/dist-esm/lib/primitives/geometry/Stadium2d.mjs.map +2 -2
  285. package/dist-esm/lib/utils/EditorAtom.mjs +2 -0
  286. package/dist-esm/lib/utils/EditorAtom.mjs.map +1 -1
  287. package/dist-esm/lib/utils/SharedStylesMap.mjs +1 -1
  288. package/dist-esm/lib/utils/SharedStylesMap.mjs.map +1 -1
  289. package/dist-esm/lib/utils/getSvgPathFromPoints.mjs.map +2 -2
  290. package/dist-esm/lib/utils/reparenting.mjs +2 -1
  291. package/dist-esm/lib/utils/reparenting.mjs.map +2 -2
  292. package/dist-esm/lib/utils/richText.mjs.map +2 -2
  293. package/dist-esm/lib/utils/runtime.mjs +2 -1
  294. package/dist-esm/lib/utils/runtime.mjs.map +2 -2
  295. package/dist-esm/lib/utils/sync/TLLocalSyncClient.mjs +8 -2
  296. package/dist-esm/lib/utils/sync/TLLocalSyncClient.mjs.map +2 -2
  297. package/dist-esm/lib/utils/sync/hardReset.mjs +0 -8
  298. package/dist-esm/lib/utils/sync/hardReset.mjs.map +2 -2
  299. package/dist-esm/version.mjs +3 -3
  300. package/dist-esm/version.mjs.map +1 -1
  301. package/editor.css +16 -256
  302. package/package.json +7 -8
  303. package/src/index.ts +58 -52
  304. package/src/lib/TldrawEditor.tsx +108 -20
  305. package/src/lib/components/MenuClickCapture.tsx +129 -49
  306. package/src/lib/components/default-components/CanvasOverlays.tsx +208 -0
  307. package/src/lib/components/default-components/DefaultCanvas.tsx +38 -310
  308. package/src/lib/components/default-components/DefaultErrorFallback.tsx +1 -0
  309. package/src/lib/config/TLEditorSnapshot.test.ts +1 -1
  310. package/src/lib/config/{createTLUser.ts → createTLCurrentUser.ts} +9 -9
  311. package/src/lib/config/createTLStore.ts +58 -3
  312. package/src/lib/config/defaultAssets.ts +19 -0
  313. package/src/lib/config/defaultShapes.ts +1 -1
  314. package/src/lib/editor/Editor.test.ts +3 -1
  315. package/src/lib/editor/Editor.ts +610 -69
  316. package/src/lib/editor/assets/AssetUtil.ts +85 -0
  317. package/src/lib/editor/managers/ClickManager/ClickManager.ts +1 -1
  318. package/src/lib/editor/managers/CollaboratorsManager/CollaboratorsManager.ts +98 -0
  319. package/src/lib/editor/managers/EdgeScrollManager/EdgeScrollManager.ts +1 -1
  320. package/src/lib/editor/managers/FontManager/FontManager.test.ts +9 -2
  321. package/src/lib/editor/managers/FontManager/FontManager.ts +1 -67
  322. package/src/lib/editor/managers/InputsManager/InputsManager.ts +42 -30
  323. package/src/lib/editor/managers/PerformanceManager/PerformanceApiAdapter.ts +82 -0
  324. package/src/lib/editor/managers/PerformanceManager/PerformanceManager.test.ts +522 -0
  325. package/src/lib/editor/managers/PerformanceManager/PerformanceManager.ts +583 -0
  326. package/src/lib/editor/managers/PerformanceManager/perf-types.ts +196 -0
  327. package/src/lib/editor/managers/SnapManager/BoundsSnaps.ts +1 -1
  328. package/src/lib/editor/managers/SnapManager/HandleSnaps.ts +1 -1
  329. package/src/lib/editor/managers/SnapManager/SnapManager.test.ts +13 -2
  330. package/src/lib/editor/managers/SnapManager/SnapManager.ts +1 -1
  331. package/src/lib/editor/managers/SpatialIndexManager/SpatialIndexManager.ts +5 -5
  332. package/src/lib/editor/managers/TextManager/TextManager.test.ts +18 -4
  333. package/src/lib/editor/managers/TextManager/TextManager.ts +140 -34
  334. package/src/lib/editor/managers/ThemeManager/ThemeManager.ts +116 -0
  335. package/src/lib/editor/managers/ThemeManager/defaultThemes.ts +619 -0
  336. package/src/lib/editor/managers/UserPreferencesManager/UserPreferencesManager.test.ts +25 -31
  337. package/src/lib/editor/managers/UserPreferencesManager/UserPreferencesManager.ts +7 -5
  338. package/src/lib/editor/overlays/OverlayManager.ts +183 -0
  339. package/src/lib/editor/overlays/OverlayUtil.ts +143 -0
  340. package/src/lib/editor/overlays/ShapeIndicatorOverlayUtil.ts +216 -0
  341. package/src/lib/editor/shapes/BaseFrameLikeShapeUtil.tsx +123 -0
  342. package/src/lib/editor/shapes/ShapeUtil.ts +67 -30
  343. package/src/lib/editor/shapes/group/GroupShapeUtil.tsx +41 -4
  344. package/src/lib/editor/shapes/shared/getPerfectDashProps.ts +7 -0
  345. package/src/lib/editor/tools/StateNode.ts +16 -18
  346. package/src/lib/editor/types/SvgExportContext.tsx +5 -0
  347. package/src/lib/editor/types/clipboard-types.ts +2 -1
  348. package/src/lib/editor/types/event-types.ts +2 -0
  349. package/src/lib/editor/types/external-content.ts +1 -0
  350. package/src/lib/exports/StyleEmbedder.ts +1 -1
  351. package/src/lib/exports/fetchCache.ts +2 -4
  352. package/src/lib/exports/getSvgJsx.test.ts +3 -1
  353. package/src/lib/exports/getSvgJsx.tsx +24 -17
  354. package/src/lib/globals/environment.ts +18 -0
  355. package/src/lib/hooks/EditorComponentsContext.tsx +0 -27
  356. package/src/lib/hooks/useCanvasEvents.ts +40 -3
  357. package/src/lib/hooks/{useIsDarkMode.ts → useColorMode.ts} +9 -5
  358. package/src/lib/hooks/useCursor.ts +3 -7
  359. package/src/lib/hooks/useDarkMode.ts +4 -4
  360. package/src/lib/hooks/useEditorComponents.tsx +1 -29
  361. package/src/lib/hooks/useGestureEvents.ts +240 -168
  362. package/src/lib/hooks/useLocalStore.ts +1 -1
  363. package/src/lib/hooks/usePeerIds.ts +6 -55
  364. package/src/lib/hooks/useShapeCulling.tsx +3 -1
  365. package/src/lib/options.ts +115 -0
  366. package/src/lib/primitives/Box.test.ts +30 -0
  367. package/src/lib/primitives/Box.ts +26 -26
  368. package/src/lib/primitives/Vec.ts +1 -1
  369. package/src/lib/primitives/geometry/Arc2d.ts +2 -2
  370. package/src/lib/primitives/geometry/Circle2d.ts +2 -2
  371. package/src/lib/primitives/geometry/CubicSpline2d.ts +1 -1
  372. package/src/lib/primitives/geometry/Ellipse2d.ts +3 -3
  373. package/src/lib/primitives/geometry/Geometry2d.test.ts +21 -0
  374. package/src/lib/primitives/geometry/Geometry2d.ts +10 -9
  375. package/src/lib/primitives/geometry/Polyline2d.ts +2 -2
  376. package/src/lib/primitives/geometry/Stadium2d.ts +1 -1
  377. package/src/lib/utils/SharedStylesMap.ts +1 -1
  378. package/src/lib/utils/getSvgPathFromPoints.ts +1 -1
  379. package/src/lib/utils/reparenting.ts +6 -2
  380. package/src/lib/utils/richText.ts +1 -1
  381. package/src/lib/utils/runtime.ts +3 -1
  382. package/src/lib/utils/sync/TLLocalSyncClient.test.ts +1 -1
  383. package/src/lib/utils/sync/TLLocalSyncClient.ts +5 -1
  384. package/src/lib/utils/sync/hardReset.ts +0 -8
  385. package/src/version.ts +3 -3
  386. package/dist-cjs/lib/components/LiveCollaborators.js +0 -151
  387. package/dist-cjs/lib/components/LiveCollaborators.js.map +0 -7
  388. package/dist-cjs/lib/components/default-components/CanvasShapeIndicators.js +0 -227
  389. package/dist-cjs/lib/components/default-components/CanvasShapeIndicators.js.map +0 -7
  390. package/dist-cjs/lib/components/default-components/DefaultBrush.js +0 -38
  391. package/dist-cjs/lib/components/default-components/DefaultBrush.js.map +0 -7
  392. package/dist-cjs/lib/components/default-components/DefaultCollaboratorHint.js +0 -71
  393. package/dist-cjs/lib/components/default-components/DefaultCollaboratorHint.js.map +0 -7
  394. package/dist-cjs/lib/components/default-components/DefaultHandle.js +0 -56
  395. package/dist-cjs/lib/components/default-components/DefaultHandle.js.map +0 -7
  396. package/dist-cjs/lib/components/default-components/DefaultHandles.js.map +0 -7
  397. package/dist-cjs/lib/components/default-components/DefaultScribble.js +0 -51
  398. package/dist-cjs/lib/components/default-components/DefaultScribble.js.map +0 -7
  399. package/dist-cjs/lib/components/default-components/DefaultSelectionForeground.js +0 -69
  400. package/dist-cjs/lib/components/default-components/DefaultSelectionForeground.js.map +0 -7
  401. package/dist-cjs/lib/components/default-components/DefaultShapeIndicator.js +0 -107
  402. package/dist-cjs/lib/components/default-components/DefaultShapeIndicator.js.map +0 -7
  403. package/dist-cjs/lib/components/default-components/DefaultShapeIndicatorErrorFallback.js.map +0 -7
  404. package/dist-cjs/lib/components/default-components/DefaultShapeIndicators.js +0 -101
  405. package/dist-cjs/lib/components/default-components/DefaultShapeIndicators.js.map +0 -7
  406. package/dist-cjs/lib/components/default-components/DefaultSnapIndictor.js +0 -170
  407. package/dist-cjs/lib/components/default-components/DefaultSnapIndictor.js.map +0 -7
  408. package/dist-cjs/lib/config/createTLUser.js.map +0 -7
  409. package/dist-cjs/lib/hooks/useIsDarkMode.js.map +0 -7
  410. package/dist-esm/lib/components/LiveCollaborators.mjs +0 -134
  411. package/dist-esm/lib/components/LiveCollaborators.mjs.map +0 -7
  412. package/dist-esm/lib/components/default-components/CanvasShapeIndicators.mjs +0 -207
  413. package/dist-esm/lib/components/default-components/CanvasShapeIndicators.mjs.map +0 -7
  414. package/dist-esm/lib/components/default-components/DefaultBrush.mjs +0 -18
  415. package/dist-esm/lib/components/default-components/DefaultBrush.mjs.map +0 -7
  416. package/dist-esm/lib/components/default-components/DefaultCollaboratorHint.mjs +0 -41
  417. package/dist-esm/lib/components/default-components/DefaultCollaboratorHint.mjs.map +0 -7
  418. package/dist-esm/lib/components/default-components/DefaultHandle.mjs +0 -26
  419. package/dist-esm/lib/components/default-components/DefaultHandle.mjs.map +0 -7
  420. package/dist-esm/lib/components/default-components/DefaultHandles.mjs +0 -8
  421. package/dist-esm/lib/components/default-components/DefaultHandles.mjs.map +0 -7
  422. package/dist-esm/lib/components/default-components/DefaultScribble.mjs +0 -21
  423. package/dist-esm/lib/components/default-components/DefaultScribble.mjs.map +0 -7
  424. package/dist-esm/lib/components/default-components/DefaultSelectionForeground.mjs +0 -39
  425. package/dist-esm/lib/components/default-components/DefaultSelectionForeground.mjs.map +0 -7
  426. package/dist-esm/lib/components/default-components/DefaultShapeIndicator.mjs +0 -77
  427. package/dist-esm/lib/components/default-components/DefaultShapeIndicator.mjs.map +0 -7
  428. package/dist-esm/lib/components/default-components/DefaultShapeIndicatorErrorFallback.mjs +0 -8
  429. package/dist-esm/lib/components/default-components/DefaultShapeIndicatorErrorFallback.mjs.map +0 -7
  430. package/dist-esm/lib/components/default-components/DefaultShapeIndicators.mjs +0 -81
  431. package/dist-esm/lib/components/default-components/DefaultShapeIndicators.mjs.map +0 -7
  432. package/dist-esm/lib/components/default-components/DefaultSnapIndictor.mjs +0 -142
  433. package/dist-esm/lib/components/default-components/DefaultSnapIndictor.mjs.map +0 -7
  434. package/dist-esm/lib/config/createTLUser.mjs.map +0 -7
  435. package/dist-esm/lib/hooks/useIsDarkMode.mjs +0 -15
  436. package/dist-esm/lib/hooks/useIsDarkMode.mjs.map +0 -7
  437. package/src/lib/components/LiveCollaborators.tsx +0 -174
  438. package/src/lib/components/default-components/CanvasShapeIndicators.tsx +0 -289
  439. package/src/lib/components/default-components/DefaultBrush.tsx +0 -35
  440. package/src/lib/components/default-components/DefaultCollaboratorHint.tsx +0 -52
  441. package/src/lib/components/default-components/DefaultHandle.tsx +0 -42
  442. package/src/lib/components/default-components/DefaultHandles.tsx +0 -15
  443. package/src/lib/components/default-components/DefaultScribble.tsx +0 -31
  444. package/src/lib/components/default-components/DefaultSelectionForeground.tsx +0 -50
  445. package/src/lib/components/default-components/DefaultShapeIndicator.tsx +0 -104
  446. package/src/lib/components/default-components/DefaultShapeIndicatorErrorFallback.tsx +0 -9
  447. package/src/lib/components/default-components/DefaultShapeIndicators.tsx +0 -116
  448. package/src/lib/components/default-components/DefaultSnapIndictor.tsx +0 -174
@@ -0,0 +1,522 @@
1
+ import { describe, expect, it, vi } from 'vitest'
2
+ import { PerformanceManager } from './PerformanceManager'
3
+
4
+ function createMockEditor() {
5
+ const listeners: Record<string, ((...args: any[]) => void)[]> = {}
6
+ return {
7
+ on(event: string, handler: (...args: any[]) => void) {
8
+ ;(listeners[event] ??= []).push(handler)
9
+ },
10
+ off(event: string, handler: (...args: any[]) => void) {
11
+ const arr = listeners[event]
12
+ if (arr) {
13
+ const idx = arr.indexOf(handler)
14
+ if (idx !== -1) arr.splice(idx, 1)
15
+ }
16
+ },
17
+ emit(event: string, ...args: any[]) {
18
+ for (const handler of listeners[event] ?? []) {
19
+ handler(...args)
20
+ }
21
+ },
22
+ getSelectedShapes: () => [
23
+ { type: 'geo', id: '1' },
24
+ { type: 'geo', id: '2' },
25
+ { type: 'draw', id: '3' },
26
+ ],
27
+ getCurrentPageShapeIds: () => ({ size: 10 }),
28
+ getCulledShapes: () => ({ size: 3 }),
29
+ getCamera: () => ({ x: 0, y: 0, z: 1 }),
30
+ getShape: (id: string) => {
31
+ const shapes: Record<string, { type: string }> = {
32
+ 'shape:1': { type: 'geo' },
33
+ 'shape:2': { type: 'draw' },
34
+ 'shape:3': { type: 'geo' },
35
+ }
36
+ return shapes[id]
37
+ },
38
+ getViewportScreenBounds: () => ({ w: 1920, h: 1080 }),
39
+ timers: {
40
+ setTimeout: (fn: () => void, ms: number) => setTimeout(fn, ms),
41
+ },
42
+ _listeners: listeners,
43
+ } as any
44
+ }
45
+
46
+ describe('PerformanceManager', () => {
47
+ describe('listener management', () => {
48
+ it('returns an unsubscribe function from on()', () => {
49
+ const editor = createMockEditor()
50
+ const pm = new PerformanceManager(editor)
51
+ const fn = vi.fn()
52
+ const unsub = pm.on('interaction-end', fn)
53
+ expect(typeof unsub).toBe('function')
54
+ unsub()
55
+ })
56
+
57
+ it('attaches frame listener lazily when interaction listener subscribes', () => {
58
+ const editor = createMockEditor()
59
+ const pm = new PerformanceManager(editor)
60
+ expect(editor._listeners['frame'] ?? []).toHaveLength(0)
61
+
62
+ const unsub = pm.on('interaction-end', vi.fn())
63
+ expect(editor._listeners['frame']).toHaveLength(1)
64
+
65
+ unsub()
66
+ expect(editor._listeners['frame'] ?? []).toHaveLength(0)
67
+ })
68
+
69
+ it('attaches shape listeners lazily', () => {
70
+ const editor = createMockEditor()
71
+ const pm = new PerformanceManager(editor)
72
+
73
+ const unsub = pm.on('shapes-created', vi.fn())
74
+ expect(editor._listeners['created-shapes']).toHaveLength(1)
75
+
76
+ unsub()
77
+ expect(editor._listeners['created-shapes'] ?? []).toHaveLength(0)
78
+ })
79
+
80
+ it('does not double-attach frame listener', () => {
81
+ const editor = createMockEditor()
82
+ const pm = new PerformanceManager(editor)
83
+
84
+ const unsub1 = pm.on('interaction-end', vi.fn())
85
+ const unsub2 = pm.on('camera-end', vi.fn())
86
+ expect(editor._listeners['frame']).toHaveLength(1)
87
+
88
+ unsub1()
89
+ // still one camera-end listener
90
+ expect(editor._listeners['frame']).toHaveLength(1)
91
+
92
+ unsub2()
93
+ expect(editor._listeners['frame'] ?? []).toHaveLength(0)
94
+ })
95
+ })
96
+
97
+ describe('interaction tracking', () => {
98
+ it('emits interaction-start when notified', () => {
99
+ const editor = createMockEditor()
100
+ const pm = new PerformanceManager(editor)
101
+ const fn = vi.fn()
102
+ pm.on('interaction-start', fn)
103
+
104
+ pm._notifyInteractionStart('translating', 'select.translating')
105
+
106
+ expect(fn).toHaveBeenCalledTimes(1)
107
+ expect(fn.mock.calls[0][0]).toMatchObject({
108
+ name: 'translating',
109
+ path: 'select.translating',
110
+ })
111
+ expect(fn.mock.calls[0][0].timestamp).toBeGreaterThan(0)
112
+ })
113
+
114
+ it('emits interaction-end with frame stats', () => {
115
+ const editor = createMockEditor()
116
+ const pm = new PerformanceManager(editor)
117
+ const fn = vi.fn()
118
+ pm.on('interaction-end', fn)
119
+
120
+ pm._notifyInteractionStart('resizing', 'select.resizing')
121
+
122
+ // Simulate frames
123
+ editor.emit('frame', 16)
124
+ editor.emit('frame', 16)
125
+ editor.emit('frame', 32)
126
+ editor.emit('frame', 16)
127
+ editor.emit('frame', 50)
128
+
129
+ pm._notifyInteractionEnd()
130
+
131
+ expect(fn).toHaveBeenCalledTimes(1)
132
+ const event = fn.mock.calls[0][0]
133
+ expect(event.name).toBe('resizing')
134
+ expect(event.path).toBe('select.resizing')
135
+ expect(event.frameCount).toBe(5)
136
+ expect(event.frameTimes).toEqual([16, 16, 32, 16, 50])
137
+ expect(event.shapeCount).toBe(10)
138
+ expect(event.selectedShapeTypes).toEqual({ geo: 2, draw: 1 })
139
+ expect(event.avgFrameTime).toBe(26)
140
+ expect(event.duration).toBeGreaterThan(0)
141
+ })
142
+
143
+ it('does not emit when no listeners', () => {
144
+ const editor = createMockEditor()
145
+ const pm = new PerformanceManager(editor)
146
+
147
+ // Should not throw
148
+ pm._notifyInteractionStart('resizing', 'select.resizing')
149
+ pm._notifyInteractionEnd()
150
+ })
151
+
152
+ it('handles end without start gracefully', () => {
153
+ const editor = createMockEditor()
154
+ const pm = new PerformanceManager(editor)
155
+ const fn = vi.fn()
156
+ pm.on('interaction-end', fn)
157
+
158
+ pm._notifyInteractionEnd()
159
+ expect(fn).not.toHaveBeenCalled()
160
+ })
161
+ })
162
+
163
+ describe('camera tracking', () => {
164
+ it('emits camera-start and camera-end', () => {
165
+ vi.useFakeTimers()
166
+ const editor = createMockEditor()
167
+ // Override timers.setTimeout to use fake timers
168
+ editor.timers.setTimeout = (fn: () => void, ms: number) => setTimeout(fn, ms) as any
169
+ const pm = new PerformanceManager(editor)
170
+ const startFn = vi.fn()
171
+ const endFn = vi.fn()
172
+ pm.on('camera-start', startFn)
173
+ pm.on('camera-end', endFn)
174
+
175
+ pm._notifyCameraOperation('panning')
176
+ expect(startFn).toHaveBeenCalledTimes(1)
177
+ expect(startFn.mock.calls[0][0].type).toBe('panning')
178
+
179
+ // Simulate frames during camera operation
180
+ editor.emit('frame', 16)
181
+ editor.emit('frame', 16)
182
+
183
+ // Wait for debounce timeout
184
+ vi.advanceTimersByTime(100)
185
+
186
+ expect(endFn).toHaveBeenCalledTimes(1)
187
+ const event = endFn.mock.calls[0][0]
188
+ expect(event.type).toBe('panning')
189
+ expect(event.frameCount).toBe(2)
190
+ expect(event.viewportWidth).toBe(1920)
191
+ expect(event.viewportHeight).toBe(1080)
192
+
193
+ vi.useRealTimers()
194
+ })
195
+
196
+ it('extends camera session on repeated operations', () => {
197
+ vi.useFakeTimers()
198
+ const editor = createMockEditor()
199
+ editor.timers.setTimeout = (fn: () => void, ms: number) => setTimeout(fn, ms) as any
200
+ const pm = new PerformanceManager(editor)
201
+ const endFn = vi.fn()
202
+ pm.on('camera-end', endFn)
203
+
204
+ pm._notifyCameraOperation('panning')
205
+ editor.emit('frame', 16)
206
+ vi.advanceTimersByTime(30)
207
+
208
+ pm._notifyCameraOperation('panning')
209
+ editor.emit('frame', 16)
210
+ vi.advanceTimersByTime(30)
211
+
212
+ // Should not have ended yet
213
+ expect(endFn).not.toHaveBeenCalled()
214
+
215
+ vi.advanceTimersByTime(100)
216
+ expect(endFn).toHaveBeenCalledTimes(1)
217
+ expect(endFn.mock.calls[0][0].frameCount).toBe(2)
218
+
219
+ vi.useRealTimers()
220
+ })
221
+
222
+ it('ends old session and starts new on type change', () => {
223
+ vi.useFakeTimers()
224
+ const editor = createMockEditor()
225
+ editor.timers.setTimeout = (fn: () => void, ms: number) => setTimeout(fn, ms) as any
226
+ const pm = new PerformanceManager(editor)
227
+ const startFn = vi.fn()
228
+ const endFn = vi.fn()
229
+ pm.on('camera-start', startFn)
230
+ pm.on('camera-end', endFn)
231
+
232
+ pm._notifyCameraOperation('panning')
233
+ editor.emit('frame', 16)
234
+
235
+ pm._notifyCameraOperation('zooming')
236
+ // Panning session should have ended
237
+ expect(endFn).toHaveBeenCalledTimes(1)
238
+ expect(endFn.mock.calls[0][0].type).toBe('panning')
239
+ // Zooming session should have started
240
+ expect(startFn).toHaveBeenCalledTimes(2)
241
+
242
+ vi.advanceTimersByTime(100)
243
+ expect(endFn).toHaveBeenCalledTimes(2)
244
+ expect(endFn.mock.calls[1][0].type).toBe('zooming')
245
+
246
+ vi.useRealTimers()
247
+ })
248
+ })
249
+
250
+ describe('frame time stats', () => {
251
+ it('computes correct percentiles', () => {
252
+ const editor = createMockEditor()
253
+ const pm = new PerformanceManager(editor)
254
+ const fn = vi.fn()
255
+ pm.on('interaction-end', fn)
256
+
257
+ pm._notifyInteractionStart('translating', 'select.translating')
258
+
259
+ // 10 frames: 10, 11, 12, 13, 14, 15, 16, 17, 18, 100
260
+ for (let i = 10; i <= 18; i++) editor.emit('frame', i)
261
+ editor.emit('frame', 100)
262
+
263
+ pm._notifyInteractionEnd()
264
+
265
+ const event = fn.mock.calls[0][0]
266
+ expect(event.minFrameTime).toBe(10)
267
+ expect(event.maxFrameTime).toBe(100)
268
+ expect(event.medianFrameTime).toBe(14)
269
+ })
270
+
271
+ it('handles single frame', () => {
272
+ const editor = createMockEditor()
273
+ const pm = new PerformanceManager(editor)
274
+ const fn = vi.fn()
275
+ pm.on('interaction-end', fn)
276
+
277
+ pm._notifyInteractionStart('translating', 'select.translating')
278
+ editor.emit('frame', 42)
279
+ pm._notifyInteractionEnd()
280
+
281
+ const event = fn.mock.calls[0][0]
282
+ expect(event.avgFrameTime).toBe(42)
283
+ expect(event.medianFrameTime).toBe(42)
284
+ expect(event.p95FrameTime).toBe(42)
285
+ expect(event.p99FrameTime).toBe(42)
286
+ expect(event.minFrameTime).toBe(42)
287
+ expect(event.maxFrameTime).toBe(42)
288
+ })
289
+
290
+ it('handles zero frames', () => {
291
+ const editor = createMockEditor()
292
+ const pm = new PerformanceManager(editor)
293
+ const fn = vi.fn()
294
+ pm.on('interaction-end', fn)
295
+
296
+ pm._notifyInteractionStart('translating', 'select.translating')
297
+ pm._notifyInteractionEnd()
298
+
299
+ const event = fn.mock.calls[0][0]
300
+ expect(event.avgFrameTime).toBe(0)
301
+ expect(event.frameCount).toBe(0)
302
+ })
303
+ })
304
+
305
+ describe('undo/redo tracking', () => {
306
+ it('emits undo events', () => {
307
+ const editor = createMockEditor()
308
+ const pm = new PerformanceManager(editor)
309
+ const fn = vi.fn()
310
+ pm.on('undo', fn)
311
+
312
+ pm._notifyUndoRedo('undo', 5, 2)
313
+
314
+ expect(fn).toHaveBeenCalledWith({ type: 'undo', undoDepth: 5, redoDepth: 2 })
315
+ })
316
+
317
+ it('emits redo events', () => {
318
+ const editor = createMockEditor()
319
+ const pm = new PerformanceManager(editor)
320
+ const fn = vi.fn()
321
+ pm.on('redo', fn)
322
+
323
+ pm._notifyUndoRedo('redo', 4, 3)
324
+
325
+ expect(fn).toHaveBeenCalledWith({ type: 'redo', undoDepth: 4, redoDepth: 3 })
326
+ })
327
+
328
+ it('skips when no listeners', () => {
329
+ const editor = createMockEditor()
330
+ const pm = new PerformanceManager(editor)
331
+ // Should not throw
332
+ pm._notifyUndoRedo('undo', 1, 0)
333
+ })
334
+ })
335
+
336
+ describe('shape operation tracking', () => {
337
+ it('emits shapes-created events', () => {
338
+ const editor = createMockEditor()
339
+ const pm = new PerformanceManager(editor)
340
+ const fn = vi.fn()
341
+ pm.on('shapes-created', fn)
342
+
343
+ editor.emit('created-shapes', [
344
+ { typeName: 'shape', type: 'geo' },
345
+ { typeName: 'shape', type: 'geo' },
346
+ { typeName: 'shape', type: 'draw' },
347
+ ])
348
+
349
+ expect(fn).toHaveBeenCalledTimes(1)
350
+ expect(fn.mock.calls[0][0]).toMatchObject({
351
+ operation: 'create',
352
+ count: 3,
353
+ shapeTypes: { geo: 2, draw: 1 },
354
+ })
355
+ })
356
+
357
+ it('ignores non-shape records', () => {
358
+ const editor = createMockEditor()
359
+ const pm = new PerformanceManager(editor)
360
+ const fn = vi.fn()
361
+ pm.on('shapes-created', fn)
362
+
363
+ editor.emit('created-shapes', [{ typeName: 'page', type: 'page' }])
364
+
365
+ expect(fn).not.toHaveBeenCalled()
366
+ })
367
+
368
+ it('emits shapes-deleted with shape types', () => {
369
+ const editor = createMockEditor()
370
+ const pm = new PerformanceManager(editor)
371
+ const fn = vi.fn()
372
+ pm.on('shapes-deleted', fn)
373
+
374
+ editor.emit('deleted-shapes', ['shape:1', 'shape:2'])
375
+
376
+ expect(fn).toHaveBeenCalledTimes(1)
377
+ expect(fn.mock.calls[0][0]).toMatchObject({
378
+ operation: 'delete',
379
+ count: 2,
380
+ shapeTypes: { geo: 1, draw: 1 },
381
+ })
382
+ })
383
+ })
384
+
385
+ describe('frame event', () => {
386
+ it('emits frame events with shape counts', () => {
387
+ const editor = createMockEditor()
388
+ const pm = new PerformanceManager(editor)
389
+ const fn = vi.fn()
390
+ pm.on('frame', fn)
391
+
392
+ editor.emit('frame', 16)
393
+
394
+ expect(fn).toHaveBeenCalledWith({
395
+ elapsed: 16,
396
+ shapeCount: 10,
397
+ culledShapeCount: 3,
398
+ visibleShapeCount: 7,
399
+ })
400
+ })
401
+ })
402
+
403
+ describe('once()', () => {
404
+ it('fires callback only once', () => {
405
+ const editor = createMockEditor()
406
+ const pm = new PerformanceManager(editor)
407
+ const fn = vi.fn()
408
+ pm.once('interaction-start', fn)
409
+
410
+ pm._notifyInteractionStart('resizing', 'select.resizing')
411
+ pm._notifyInteractionEnd()
412
+ pm._notifyInteractionStart('resizing', 'select.resizing')
413
+
414
+ expect(fn).toHaveBeenCalledTimes(1)
415
+ })
416
+
417
+ it('detaches frame listener after once fires', () => {
418
+ const editor = createMockEditor()
419
+ const pm = new PerformanceManager(editor)
420
+
421
+ pm.once('interaction-start', vi.fn())
422
+ expect(editor._listeners['frame']).toHaveLength(1)
423
+
424
+ pm._notifyInteractionStart('resizing', 'select.resizing')
425
+ // frame listener should be detached after once fires
426
+ expect(editor._listeners['frame'] ?? []).toHaveLength(0)
427
+ })
428
+ })
429
+
430
+ describe('LoAF integration', () => {
431
+ it('attaches LoAF entries to interaction-end events', () => {
432
+ let observerCallback: ((list: any) => void) | null = null
433
+ const mockDisconnect = vi.fn()
434
+
435
+ const origPO = globalThis.PerformanceObserver
436
+ globalThis.PerformanceObserver = class MockPO {
437
+ constructor(cb: (list: any) => void) {
438
+ observerCallback = cb
439
+ }
440
+ observe() {}
441
+ disconnect = mockDisconnect
442
+ static supportedEntryTypes = ['long-animation-frame']
443
+ } as any
444
+
445
+ const editor = createMockEditor()
446
+ const pm = new PerformanceManager(editor)
447
+ const fn = vi.fn()
448
+ pm.on('interaction-end', fn)
449
+
450
+ pm._notifyInteractionStart('resizing', 'select.resizing')
451
+ editor.emit('frame', 16)
452
+
453
+ // Simulate a LoAF entry
454
+ observerCallback!({
455
+ getEntries: () => [
456
+ {
457
+ startTime: 100,
458
+ duration: 80,
459
+ blockingDuration: 60,
460
+ scripts: [{ sourceURL: 'app.js', invoker: 'onPointerMove', duration: 55 }],
461
+ },
462
+ ],
463
+ })
464
+
465
+ editor.emit('frame', 16)
466
+ pm._notifyInteractionEnd()
467
+
468
+ expect(fn).toHaveBeenCalledTimes(1)
469
+ const event = fn.mock.calls[0][0]
470
+ expect(event.longAnimationFrames).toHaveLength(1)
471
+ expect(event.longAnimationFrames[0]).toEqual({
472
+ startTime: 100,
473
+ duration: 80,
474
+ blockingDuration: 60,
475
+ scripts: [{ sourceURL: 'app.js', invoker: 'onPointerMove', duration: 55 }],
476
+ })
477
+
478
+ // Cleanup
479
+ pm.on('interaction-end', vi.fn())() // subscribe + unsub to trigger detach check
480
+ globalThis.PerformanceObserver = origPO
481
+ })
482
+
483
+ it('omits longAnimationFrames when none collected', () => {
484
+ const editor = createMockEditor()
485
+ const pm = new PerformanceManager(editor)
486
+ const fn = vi.fn()
487
+ pm.on('interaction-end', fn)
488
+
489
+ pm._notifyInteractionStart('resizing', 'select.resizing')
490
+ editor.emit('frame', 16)
491
+ pm._notifyInteractionEnd()
492
+
493
+ expect(fn.mock.calls[0][0].longAnimationFrames).toBeUndefined()
494
+ })
495
+
496
+ it('starts LoAF observer only when interaction-end or camera-end listeners exist', () => {
497
+ const origPO = globalThis.PerformanceObserver
498
+ const mockObserve = vi.fn()
499
+ globalThis.PerformanceObserver = class MockPO {
500
+ constructor(_cb: any) {}
501
+ observe = mockObserve
502
+ disconnect = vi.fn()
503
+ static supportedEntryTypes = ['long-animation-frame']
504
+ } as any
505
+
506
+ const editor = createMockEditor()
507
+ const pm = new PerformanceManager(editor)
508
+
509
+ // interaction-start alone should NOT start LoAF observer
510
+ const unsub1 = pm.on('interaction-start', vi.fn())
511
+ expect(mockObserve).not.toHaveBeenCalled()
512
+ unsub1()
513
+
514
+ // interaction-end should start LoAF observer
515
+ const unsub2 = pm.on('interaction-end', vi.fn())
516
+ expect(mockObserve).toHaveBeenCalledTimes(1)
517
+ unsub2()
518
+
519
+ globalThis.PerformanceObserver = origPO
520
+ })
521
+ })
522
+ })