js-draw 1.21.2 → 1.22.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (421) hide show
  1. package/README.md +103 -75
  2. package/build-config.json +2 -2
  3. package/dist/Editor.css +29 -16
  4. package/dist/bundle.js +2 -2
  5. package/dist/bundledStyles.js +1 -1
  6. package/dist/cjs/Editor.js +36 -22
  7. package/dist/cjs/EventDispatcher.js +1 -1
  8. package/dist/cjs/Pointer.js +3 -3
  9. package/dist/cjs/SVGLoader/SVGLoader.js +13 -6
  10. package/dist/cjs/UndoRedoHistory.js +1 -1
  11. package/dist/cjs/Viewport.js +4 -2
  12. package/dist/cjs/commands/Command.js +7 -5
  13. package/dist/cjs/commands/Duplicate.js +2 -2
  14. package/dist/cjs/commands/Erase.js +3 -4
  15. package/dist/cjs/commands/invertCommand.js +4 -4
  16. package/dist/cjs/commands/lib.d.ts +1 -1
  17. package/dist/cjs/commands/uniteCommands.js +4 -4
  18. package/dist/cjs/components/AbstractComponent.d.ts +1 -1
  19. package/dist/cjs/components/AbstractComponent.js +3 -3
  20. package/dist/cjs/components/BackgroundComponent.js +8 -6
  21. package/dist/cjs/components/ImageComponent.js +12 -5
  22. package/dist/cjs/components/RestylableComponent.js +1 -1
  23. package/dist/cjs/components/SVGGlobalAttributesObject.js +1 -2
  24. package/dist/cjs/components/Stroke.js +37 -24
  25. package/dist/cjs/components/TextComponent.js +13 -10
  26. package/dist/cjs/components/UnknownSVGObject.js +2 -3
  27. package/dist/cjs/components/builders/ArrowBuilder.d.ts +6 -0
  28. package/dist/cjs/components/builders/ArrowBuilder.js +9 -3
  29. package/dist/cjs/components/builders/CircleBuilder.d.ts +6 -0
  30. package/dist/cjs/components/builders/CircleBuilder.js +11 -4
  31. package/dist/cjs/components/builders/FreehandLineBuilder.d.ts +6 -0
  32. package/dist/cjs/components/builders/FreehandLineBuilder.js +10 -4
  33. package/dist/cjs/components/builders/LineBuilder.d.ts +6 -0
  34. package/dist/cjs/components/builders/LineBuilder.js +8 -4
  35. package/dist/cjs/components/builders/PolylineBuilder.d.ts +4 -1
  36. package/dist/cjs/components/builders/PolylineBuilder.js +9 -5
  37. package/dist/cjs/components/builders/PressureSensitiveFreehandLineBuilder.js +16 -10
  38. package/dist/cjs/components/builders/RectangleBuilder.d.ts +12 -0
  39. package/dist/cjs/components/builders/RectangleBuilder.js +17 -3
  40. package/dist/cjs/components/builders/autocorrect/makeShapeFitAutocorrect.js +5 -8
  41. package/dist/cjs/components/builders/autocorrect/makeSnapToGridAutocorrect.js +1 -1
  42. package/dist/cjs/components/builders/lib.d.ts +7 -0
  43. package/dist/cjs/components/builders/lib.js +18 -0
  44. package/dist/cjs/components/lib.d.ts +1 -4
  45. package/dist/cjs/components/lib.js +2 -9
  46. package/dist/cjs/components/util/StrokeSmoother.js +5 -6
  47. package/dist/cjs/dialogs/makeAboutDialog.js +1 -1
  48. package/dist/cjs/dialogs/makeMessageDialog.js +2 -2
  49. package/dist/cjs/image/EditorImage.js +13 -15
  50. package/dist/cjs/image/export/editorImageToSVG.js +1 -1
  51. package/dist/cjs/inputEvents.js +3 -3
  52. package/dist/cjs/lib.d.ts +2 -2
  53. package/dist/cjs/localizations/de.js +2 -2
  54. package/dist/cjs/localizations/es.js +7 -3
  55. package/dist/cjs/rendering/Display.js +7 -3
  56. package/dist/cjs/rendering/RenderablePathSpec.js +26 -11
  57. package/dist/cjs/rendering/RenderingStyle.js +22 -15
  58. package/dist/cjs/rendering/TextRenderingStyle.js +1 -1
  59. package/dist/cjs/rendering/caching/CacheRecord.js +1 -1
  60. package/dist/cjs/rendering/caching/CacheRecordManager.js +1 -1
  61. package/dist/cjs/rendering/caching/RenderingCache.js +1 -1
  62. package/dist/cjs/rendering/caching/RenderingCacheNode.js +26 -15
  63. package/dist/cjs/rendering/caching/testUtils.js +2 -2
  64. package/dist/cjs/rendering/renderers/AbstractRenderer.js +3 -1
  65. package/dist/cjs/rendering/renderers/CanvasRenderer.js +4 -3
  66. package/dist/cjs/rendering/renderers/DummyRenderer.js +1 -1
  67. package/dist/cjs/rendering/renderers/SVGRenderer.js +37 -19
  68. package/dist/cjs/rendering/renderers/TextOnlyRenderer.js +13 -15
  69. package/dist/cjs/shortcuts/KeyBinding.js +6 -12
  70. package/dist/cjs/shortcuts/KeyboardShortcutManager.js +2 -2
  71. package/dist/cjs/testing/createEditor.js +6 -1
  72. package/dist/cjs/testing/findNodeWithText.d.ts +4 -1
  73. package/dist/cjs/testing/findNodeWithText.js +12 -3
  74. package/dist/cjs/testing/getUniquePointerId.js +1 -1
  75. package/dist/cjs/testing/sendHtmlSwipe.js +7 -3
  76. package/dist/cjs/testing/sendPenEvent.js +1 -3
  77. package/dist/cjs/testing/sendTouchEvent.js +1 -4
  78. package/dist/cjs/testing/startPinchGesture.js +3 -1
  79. package/dist/cjs/toolbar/AbstractToolbar.js +7 -11
  80. package/dist/cjs/toolbar/EdgeToolbar.js +11 -15
  81. package/dist/cjs/toolbar/IconProvider.js +5 -3
  82. package/dist/cjs/toolbar/localization.js +3 -3
  83. package/dist/cjs/toolbar/utils/HelpDisplay.js +8 -6
  84. package/dist/cjs/toolbar/utils/makeDraggable.js +4 -7
  85. package/dist/cjs/toolbar/widgets/BaseToolWidget.js +3 -2
  86. package/dist/cjs/toolbar/widgets/BaseWidget.js +7 -7
  87. package/dist/cjs/toolbar/widgets/DocumentPropertiesWidget.js +2 -2
  88. package/dist/cjs/toolbar/widgets/EraserToolWidget.js +5 -3
  89. package/dist/cjs/toolbar/widgets/HandToolWidget.js +8 -6
  90. package/dist/cjs/toolbar/widgets/InsertImageWidget/InsertImageWidget.js +9 -10
  91. package/dist/cjs/toolbar/widgets/PenToolWidget.js +22 -13
  92. package/dist/cjs/toolbar/widgets/SelectionToolWidget.js +2 -2
  93. package/dist/cjs/toolbar/widgets/TextToolWidget.js +5 -5
  94. package/dist/cjs/toolbar/widgets/components/makeFileInput.js +7 -7
  95. package/dist/cjs/toolbar/widgets/components/makeGridSelector.js +5 -5
  96. package/dist/cjs/toolbar/widgets/components/makeSnappedList.js +9 -5
  97. package/dist/cjs/toolbar/widgets/keybindings.js +2 -2
  98. package/dist/cjs/toolbar/widgets/layout/DropdownLayoutManager.js +6 -6
  99. package/dist/cjs/tools/BaseTool.d.ts +61 -0
  100. package/dist/cjs/tools/BaseTool.js +181 -0
  101. package/dist/cjs/tools/Eraser.d.ts +60 -0
  102. package/dist/cjs/tools/Eraser.js +304 -0
  103. package/dist/cjs/tools/Eraser.test.d.ts +1 -0
  104. package/dist/cjs/tools/FindTool.d.ts +21 -0
  105. package/dist/cjs/tools/FindTool.js +137 -0
  106. package/dist/cjs/tools/FindTool.test.d.ts +1 -0
  107. package/dist/cjs/tools/InputFilter/ContextMenuRecognizer.d.ts +17 -0
  108. package/dist/cjs/tools/InputFilter/ContextMenuRecognizer.js +103 -0
  109. package/dist/cjs/tools/InputFilter/ContextMenuRecognizer.test.d.ts +1 -0
  110. package/dist/cjs/tools/InputFilter/FunctionMapper.d.ts +12 -0
  111. package/dist/cjs/tools/InputFilter/FunctionMapper.js +21 -0
  112. package/dist/cjs/tools/InputFilter/InputMapper.d.ts +23 -0
  113. package/dist/cjs/tools/InputFilter/InputMapper.js +38 -0
  114. package/dist/cjs/tools/InputFilter/InputPipeline.d.ts +15 -0
  115. package/dist/cjs/tools/InputFilter/InputPipeline.js +54 -0
  116. package/dist/cjs/tools/InputFilter/InputPipeline.test.d.ts +1 -0
  117. package/dist/cjs/tools/InputFilter/InputStabilizer.d.ts +29 -0
  118. package/dist/cjs/tools/InputFilter/InputStabilizer.js +188 -0
  119. package/dist/cjs/tools/InputFilter/StrokeKeyboardControl.d.ts +21 -0
  120. package/dist/cjs/tools/InputFilter/StrokeKeyboardControl.js +87 -0
  121. package/dist/cjs/tools/PanZoom.d.ts +125 -0
  122. package/dist/cjs/tools/PanZoom.js +522 -0
  123. package/dist/cjs/tools/PanZoom.test.d.ts +1 -0
  124. package/dist/cjs/tools/PasteHandler.d.ts +23 -0
  125. package/dist/cjs/tools/PasteHandler.js +115 -0
  126. package/dist/cjs/tools/Pen.d.ts +54 -0
  127. package/dist/cjs/tools/Pen.js +343 -0
  128. package/dist/cjs/tools/Pen.test.d.ts +1 -0
  129. package/dist/cjs/tools/PipetteTool.d.ts +28 -0
  130. package/dist/cjs/tools/PipetteTool.js +69 -0
  131. package/dist/cjs/tools/ScrollbarTool.d.ts +18 -0
  132. package/dist/cjs/tools/ScrollbarTool.js +86 -0
  133. package/dist/cjs/tools/SelectionTool/SelectAllShortcutHandler.d.ts +9 -0
  134. package/dist/cjs/tools/SelectionTool/SelectAllShortcutHandler.js +32 -0
  135. package/dist/cjs/tools/SelectionTool/Selection.d.ts +72 -0
  136. package/dist/cjs/tools/SelectionTool/Selection.js +638 -0
  137. package/dist/cjs/tools/SelectionTool/SelectionHandle.d.ts +62 -0
  138. package/dist/cjs/tools/SelectionTool/SelectionHandle.js +144 -0
  139. package/dist/cjs/tools/SelectionTool/SelectionMenuShortcut.d.ts +32 -0
  140. package/dist/cjs/tools/SelectionTool/SelectionMenuShortcut.js +88 -0
  141. package/dist/cjs/tools/SelectionTool/SelectionTool.d.ts +42 -0
  142. package/dist/cjs/tools/SelectionTool/SelectionTool.js +509 -0
  143. package/dist/cjs/tools/SelectionTool/SelectionTool.selecting.test.d.ts +1 -0
  144. package/dist/cjs/tools/SelectionTool/SelectionTool.test.d.ts +1 -0
  145. package/dist/cjs/tools/SelectionTool/ToPointerAutoscroller.d.ts +23 -0
  146. package/dist/cjs/tools/SelectionTool/ToPointerAutoscroller.js +83 -0
  147. package/dist/cjs/tools/SelectionTool/TransformMode.d.ts +42 -0
  148. package/dist/cjs/tools/SelectionTool/TransformMode.js +154 -0
  149. package/dist/cjs/tools/SelectionTool/keybindings.d.ts +15 -0
  150. package/dist/cjs/tools/SelectionTool/keybindings.js +38 -0
  151. package/dist/cjs/tools/SelectionTool/types.d.ts +35 -0
  152. package/dist/cjs/tools/SelectionTool/types.js +14 -0
  153. package/dist/cjs/tools/SelectionTool/util/makeClipboardErrorHandlers.d.ts +6 -0
  154. package/dist/cjs/tools/SelectionTool/util/makeClipboardErrorHandlers.js +71 -0
  155. package/dist/cjs/tools/SelectionTool/util/showSelectionContextMenu.d.ts +5 -0
  156. package/dist/cjs/tools/SelectionTool/util/showSelectionContextMenu.js +52 -0
  157. package/dist/cjs/tools/SoundUITool.d.ts +26 -0
  158. package/dist/cjs/tools/SoundUITool.js +173 -0
  159. package/dist/cjs/tools/TextTool.d.ts +36 -0
  160. package/dist/cjs/tools/TextTool.js +287 -0
  161. package/dist/cjs/tools/TextTool.test.d.ts +1 -0
  162. package/dist/cjs/tools/ToolController.d.ts +73 -0
  163. package/dist/cjs/tools/ToolController.js +310 -0
  164. package/dist/cjs/tools/ToolController.test.d.ts +1 -0
  165. package/dist/cjs/tools/ToolEnabledGroup.d.ts +6 -0
  166. package/dist/cjs/tools/ToolEnabledGroup.js +13 -0
  167. package/dist/cjs/tools/ToolSwitcherShortcut.d.ts +16 -0
  168. package/dist/cjs/tools/ToolSwitcherShortcut.js +40 -0
  169. package/dist/cjs/tools/ToolbarShortcutHandler.d.ts +12 -0
  170. package/dist/cjs/tools/ToolbarShortcutHandler.js +34 -0
  171. package/dist/cjs/tools/UndoRedoShortcut.d.ts +8 -0
  172. package/dist/cjs/tools/UndoRedoShortcut.js +27 -0
  173. package/dist/cjs/tools/UndoRedoShortcut.test.d.ts +1 -0
  174. package/dist/cjs/tools/keybindings.d.ts +16 -0
  175. package/dist/cjs/tools/keybindings.js +58 -0
  176. package/dist/cjs/tools/lib.d.ts +14 -0
  177. package/dist/cjs/tools/lib.js +36 -0
  178. package/dist/cjs/tools/localization.d.ts +45 -0
  179. package/dist/cjs/tools/localization.js +47 -0
  180. package/dist/cjs/tools/util/StationaryPenDetector.d.ts +25 -0
  181. package/dist/cjs/tools/util/StationaryPenDetector.js +107 -0
  182. package/dist/cjs/tools/util/createMenuOverlay.d.ts +10 -0
  183. package/dist/cjs/tools/util/createMenuOverlay.js +126 -0
  184. package/dist/cjs/tools/util/createMenuOverlay.test.d.ts +1 -0
  185. package/dist/cjs/util/ClipboardHandler.d.ts +1 -1
  186. package/dist/cjs/util/ClipboardHandler.js +19 -18
  187. package/dist/cjs/util/ReactiveValue.js +16 -12
  188. package/dist/cjs/util/adjustEditorThemeForContrast.js +6 -2
  189. package/dist/cjs/util/guessKeyCodeFromKey.js +1 -1
  190. package/dist/cjs/util/listenForKeyboardEventsFrom.js +8 -6
  191. package/dist/cjs/util/waitForAll.js +3 -3
  192. package/dist/cjs/util/waitForImageLoaded.js +3 -3
  193. package/dist/cjs/util/waitForTimeout.js +1 -1
  194. package/dist/cjs/version.js +1 -1
  195. package/dist/mjs/Editor.mjs +37 -23
  196. package/dist/mjs/EventDispatcher.mjs +1 -1
  197. package/dist/mjs/Pointer.mjs +3 -3
  198. package/dist/mjs/SVGLoader/SVGLoader.mjs +14 -7
  199. package/dist/mjs/UndoRedoHistory.mjs +1 -1
  200. package/dist/mjs/Viewport.mjs +4 -2
  201. package/dist/mjs/commands/Command.mjs +7 -5
  202. package/dist/mjs/commands/Duplicate.mjs +2 -2
  203. package/dist/mjs/commands/Erase.mjs +3 -4
  204. package/dist/mjs/commands/invertCommand.mjs +4 -4
  205. package/dist/mjs/commands/lib.d.ts +1 -1
  206. package/dist/mjs/commands/lib.mjs +1 -1
  207. package/dist/mjs/commands/uniteCommands.mjs +4 -4
  208. package/dist/mjs/components/AbstractComponent.d.ts +1 -1
  209. package/dist/mjs/components/AbstractComponent.mjs +3 -3
  210. package/dist/mjs/components/BackgroundComponent.mjs +10 -8
  211. package/dist/mjs/components/ImageComponent.mjs +12 -5
  212. package/dist/mjs/components/RestylableComponent.mjs +2 -2
  213. package/dist/mjs/components/SVGGlobalAttributesObject.mjs +1 -2
  214. package/dist/mjs/components/Stroke.mjs +40 -27
  215. package/dist/mjs/components/TextComponent.mjs +15 -12
  216. package/dist/mjs/components/UnknownSVGObject.mjs +2 -3
  217. package/dist/mjs/components/builders/ArrowBuilder.d.ts +6 -0
  218. package/dist/mjs/components/builders/ArrowBuilder.mjs +9 -3
  219. package/dist/mjs/components/builders/CircleBuilder.d.ts +6 -0
  220. package/dist/mjs/components/builders/CircleBuilder.mjs +11 -4
  221. package/dist/mjs/components/builders/FreehandLineBuilder.d.ts +6 -0
  222. package/dist/mjs/components/builders/FreehandLineBuilder.mjs +10 -4
  223. package/dist/mjs/components/builders/LineBuilder.d.ts +6 -0
  224. package/dist/mjs/components/builders/LineBuilder.mjs +8 -4
  225. package/dist/mjs/components/builders/PolylineBuilder.d.ts +4 -1
  226. package/dist/mjs/components/builders/PolylineBuilder.mjs +10 -6
  227. package/dist/mjs/components/builders/PressureSensitiveFreehandLineBuilder.mjs +17 -11
  228. package/dist/mjs/components/builders/RectangleBuilder.d.ts +12 -0
  229. package/dist/mjs/components/builders/RectangleBuilder.mjs +17 -3
  230. package/dist/mjs/components/builders/autocorrect/makeShapeFitAutocorrect.mjs +5 -8
  231. package/dist/mjs/components/builders/autocorrect/makeSnapToGridAutocorrect.mjs +1 -1
  232. package/dist/mjs/components/builders/lib.d.ts +7 -0
  233. package/dist/mjs/components/builders/lib.mjs +7 -0
  234. package/dist/mjs/components/lib.d.ts +1 -4
  235. package/dist/mjs/components/lib.mjs +2 -5
  236. package/dist/mjs/components/util/StrokeSmoother.mjs +5 -6
  237. package/dist/mjs/dialogs/makeAboutDialog.mjs +1 -1
  238. package/dist/mjs/dialogs/makeMessageDialog.mjs +2 -2
  239. package/dist/mjs/image/EditorImage.mjs +13 -15
  240. package/dist/mjs/image/export/editorImageToSVG.mjs +1 -1
  241. package/dist/mjs/inputEvents.mjs +3 -3
  242. package/dist/mjs/lib.d.ts +2 -2
  243. package/dist/mjs/lib.mjs +2 -2
  244. package/dist/mjs/localization.mjs +2 -2
  245. package/dist/mjs/localizations/de.mjs +2 -2
  246. package/dist/mjs/localizations/es.mjs +7 -3
  247. package/dist/mjs/rendering/Display.mjs +7 -3
  248. package/dist/mjs/rendering/RenderablePathSpec.mjs +26 -11
  249. package/dist/mjs/rendering/RenderingStyle.mjs +22 -15
  250. package/dist/mjs/rendering/TextRenderingStyle.mjs +1 -1
  251. package/dist/mjs/rendering/caching/CacheRecord.mjs +1 -1
  252. package/dist/mjs/rendering/caching/CacheRecordManager.mjs +1 -1
  253. package/dist/mjs/rendering/caching/RenderingCache.mjs +1 -1
  254. package/dist/mjs/rendering/caching/RenderingCacheNode.mjs +26 -15
  255. package/dist/mjs/rendering/caching/testUtils.mjs +2 -2
  256. package/dist/mjs/rendering/renderers/AbstractRenderer.mjs +3 -1
  257. package/dist/mjs/rendering/renderers/CanvasRenderer.mjs +4 -3
  258. package/dist/mjs/rendering/renderers/DummyRenderer.mjs +1 -1
  259. package/dist/mjs/rendering/renderers/SVGRenderer.mjs +38 -20
  260. package/dist/mjs/rendering/renderers/TextOnlyRenderer.mjs +13 -15
  261. package/dist/mjs/shortcuts/KeyBinding.mjs +6 -12
  262. package/dist/mjs/shortcuts/KeyboardShortcutManager.mjs +2 -2
  263. package/dist/mjs/testing/createEditor.mjs +6 -1
  264. package/dist/mjs/testing/findNodeWithText.d.ts +4 -1
  265. package/dist/mjs/testing/findNodeWithText.mjs +12 -3
  266. package/dist/mjs/testing/getUniquePointerId.mjs +1 -1
  267. package/dist/mjs/testing/sendHtmlSwipe.mjs +7 -3
  268. package/dist/mjs/testing/sendPenEvent.mjs +1 -3
  269. package/dist/mjs/testing/sendTouchEvent.mjs +1 -4
  270. package/dist/mjs/testing/startPinchGesture.mjs +3 -1
  271. package/dist/mjs/toolbar/AbstractToolbar.mjs +7 -11
  272. package/dist/mjs/toolbar/EdgeToolbar.mjs +11 -15
  273. package/dist/mjs/toolbar/IconProvider.mjs +5 -3
  274. package/dist/mjs/toolbar/localization.mjs +3 -3
  275. package/dist/mjs/toolbar/utils/HelpDisplay.mjs +8 -6
  276. package/dist/mjs/toolbar/utils/makeDraggable.mjs +4 -7
  277. package/dist/mjs/toolbar/widgets/BaseToolWidget.mjs +3 -2
  278. package/dist/mjs/toolbar/widgets/BaseWidget.mjs +8 -8
  279. package/dist/mjs/toolbar/widgets/DocumentPropertiesWidget.mjs +2 -2
  280. package/dist/mjs/toolbar/widgets/EraserToolWidget.mjs +5 -3
  281. package/dist/mjs/toolbar/widgets/HandToolWidget.mjs +8 -6
  282. package/dist/mjs/toolbar/widgets/InsertImageWidget/InsertImageWidget.mjs +9 -10
  283. package/dist/mjs/toolbar/widgets/PenToolWidget.mjs +23 -14
  284. package/dist/mjs/toolbar/widgets/SelectionToolWidget.mjs +2 -2
  285. package/dist/mjs/toolbar/widgets/TextToolWidget.mjs +5 -5
  286. package/dist/mjs/toolbar/widgets/components/makeFileInput.mjs +7 -7
  287. package/dist/mjs/toolbar/widgets/components/makeGridSelector.mjs +5 -5
  288. package/dist/mjs/toolbar/widgets/components/makeSnappedList.mjs +9 -5
  289. package/dist/mjs/toolbar/widgets/keybindings.mjs +2 -2
  290. package/dist/mjs/toolbar/widgets/layout/DropdownLayoutManager.mjs +6 -6
  291. package/dist/mjs/tools/BaseTool.d.ts +61 -0
  292. package/dist/mjs/tools/BaseTool.mjs +179 -0
  293. package/dist/mjs/tools/Eraser.d.ts +60 -0
  294. package/dist/mjs/tools/Eraser.mjs +297 -0
  295. package/dist/mjs/tools/Eraser.test.d.ts +1 -0
  296. package/dist/mjs/tools/FindTool.d.ts +21 -0
  297. package/dist/mjs/tools/FindTool.mjs +131 -0
  298. package/dist/mjs/tools/FindTool.test.d.ts +1 -0
  299. package/dist/mjs/tools/InputFilter/ContextMenuRecognizer.d.ts +17 -0
  300. package/dist/mjs/tools/InputFilter/ContextMenuRecognizer.mjs +74 -0
  301. package/dist/mjs/tools/InputFilter/ContextMenuRecognizer.test.d.ts +1 -0
  302. package/dist/mjs/tools/InputFilter/FunctionMapper.d.ts +12 -0
  303. package/dist/mjs/tools/InputFilter/FunctionMapper.mjs +15 -0
  304. package/dist/mjs/tools/InputFilter/InputMapper.d.ts +23 -0
  305. package/dist/mjs/tools/InputFilter/InputMapper.mjs +36 -0
  306. package/dist/mjs/tools/InputFilter/InputPipeline.d.ts +15 -0
  307. package/dist/mjs/tools/InputFilter/InputPipeline.mjs +49 -0
  308. package/dist/mjs/tools/InputFilter/InputPipeline.test.d.ts +1 -0
  309. package/dist/mjs/tools/InputFilter/InputStabilizer.d.ts +29 -0
  310. package/dist/mjs/tools/InputFilter/InputStabilizer.mjs +182 -0
  311. package/dist/mjs/tools/InputFilter/StrokeKeyboardControl.d.ts +21 -0
  312. package/dist/mjs/tools/InputFilter/StrokeKeyboardControl.mjs +81 -0
  313. package/dist/mjs/tools/PanZoom.d.ts +125 -0
  314. package/dist/mjs/tools/PanZoom.mjs +515 -0
  315. package/dist/mjs/tools/PanZoom.test.d.ts +1 -0
  316. package/dist/mjs/tools/PasteHandler.d.ts +23 -0
  317. package/dist/mjs/tools/PasteHandler.mjs +109 -0
  318. package/dist/mjs/tools/Pen.d.ts +54 -0
  319. package/dist/mjs/tools/Pen.mjs +314 -0
  320. package/dist/mjs/tools/Pen.test.d.ts +1 -0
  321. package/dist/mjs/tools/PipetteTool.d.ts +28 -0
  322. package/dist/mjs/tools/PipetteTool.mjs +63 -0
  323. package/dist/mjs/tools/ScrollbarTool.d.ts +18 -0
  324. package/dist/mjs/tools/ScrollbarTool.mjs +80 -0
  325. package/dist/mjs/tools/SelectionTool/SelectAllShortcutHandler.d.ts +9 -0
  326. package/dist/mjs/tools/SelectionTool/SelectAllShortcutHandler.mjs +26 -0
  327. package/dist/mjs/tools/SelectionTool/Selection.d.ts +72 -0
  328. package/dist/mjs/tools/SelectionTool/Selection.mjs +610 -0
  329. package/dist/mjs/tools/SelectionTool/SelectionHandle.d.ts +62 -0
  330. package/dist/mjs/tools/SelectionTool/SelectionHandle.mjs +140 -0
  331. package/dist/mjs/tools/SelectionTool/SelectionMenuShortcut.d.ts +32 -0
  332. package/dist/mjs/tools/SelectionTool/SelectionMenuShortcut.mjs +85 -0
  333. package/dist/mjs/tools/SelectionTool/SelectionTool.d.ts +42 -0
  334. package/dist/mjs/tools/SelectionTool/SelectionTool.mjs +502 -0
  335. package/dist/mjs/tools/SelectionTool/SelectionTool.selecting.test.d.ts +1 -0
  336. package/dist/mjs/tools/SelectionTool/SelectionTool.test.d.ts +1 -0
  337. package/dist/mjs/tools/SelectionTool/ToPointerAutoscroller.d.ts +23 -0
  338. package/dist/mjs/tools/SelectionTool/ToPointerAutoscroller.mjs +77 -0
  339. package/dist/mjs/tools/SelectionTool/TransformMode.d.ts +42 -0
  340. package/dist/mjs/tools/SelectionTool/TransformMode.mjs +145 -0
  341. package/dist/mjs/tools/SelectionTool/keybindings.d.ts +15 -0
  342. package/dist/mjs/tools/SelectionTool/keybindings.mjs +32 -0
  343. package/dist/mjs/tools/SelectionTool/types.d.ts +35 -0
  344. package/dist/mjs/tools/SelectionTool/types.mjs +11 -0
  345. package/dist/mjs/tools/SelectionTool/util/makeClipboardErrorHandlers.d.ts +6 -0
  346. package/dist/mjs/tools/SelectionTool/util/makeClipboardErrorHandlers.mjs +66 -0
  347. package/dist/mjs/tools/SelectionTool/util/showSelectionContextMenu.d.ts +5 -0
  348. package/dist/mjs/tools/SelectionTool/util/showSelectionContextMenu.mjs +47 -0
  349. package/dist/mjs/tools/SoundUITool.d.ts +26 -0
  350. package/dist/mjs/tools/SoundUITool.mjs +167 -0
  351. package/dist/mjs/tools/TextTool.d.ts +36 -0
  352. package/dist/mjs/tools/TextTool.mjs +281 -0
  353. package/dist/mjs/tools/TextTool.test.d.ts +1 -0
  354. package/dist/mjs/tools/ToolController.d.ts +73 -0
  355. package/dist/mjs/tools/ToolController.mjs +281 -0
  356. package/dist/mjs/tools/ToolController.test.d.ts +1 -0
  357. package/dist/mjs/tools/ToolEnabledGroup.d.ts +6 -0
  358. package/dist/mjs/tools/ToolEnabledGroup.mjs +10 -0
  359. package/dist/mjs/tools/ToolSwitcherShortcut.d.ts +16 -0
  360. package/dist/mjs/tools/ToolSwitcherShortcut.mjs +34 -0
  361. package/dist/mjs/tools/ToolbarShortcutHandler.d.ts +12 -0
  362. package/dist/mjs/tools/ToolbarShortcutHandler.mjs +28 -0
  363. package/dist/mjs/tools/UndoRedoShortcut.d.ts +8 -0
  364. package/dist/mjs/tools/UndoRedoShortcut.mjs +21 -0
  365. package/dist/mjs/tools/UndoRedoShortcut.test.d.ts +1 -0
  366. package/dist/mjs/tools/keybindings.d.ts +16 -0
  367. package/dist/mjs/tools/keybindings.mjs +38 -0
  368. package/dist/mjs/tools/lib.d.ts +14 -0
  369. package/dist/mjs/tools/lib.mjs +14 -0
  370. package/dist/mjs/tools/localization.d.ts +45 -0
  371. package/dist/mjs/tools/localization.mjs +44 -0
  372. package/dist/mjs/tools/util/StationaryPenDetector.d.ts +25 -0
  373. package/dist/mjs/tools/util/StationaryPenDetector.mjs +103 -0
  374. package/dist/mjs/tools/util/createMenuOverlay.d.ts +10 -0
  375. package/dist/mjs/tools/util/createMenuOverlay.mjs +121 -0
  376. package/dist/mjs/tools/util/createMenuOverlay.test.d.ts +1 -0
  377. package/dist/mjs/util/ClipboardHandler.d.ts +1 -1
  378. package/dist/mjs/util/ClipboardHandler.mjs +19 -18
  379. package/dist/mjs/util/ReactiveValue.mjs +16 -12
  380. package/dist/mjs/util/adjustEditorThemeForContrast.mjs +6 -2
  381. package/dist/mjs/util/guessKeyCodeFromKey.mjs +1 -1
  382. package/dist/mjs/util/listenForKeyboardEventsFrom.mjs +8 -6
  383. package/dist/mjs/util/waitForAll.mjs +3 -3
  384. package/dist/mjs/util/waitForImageLoaded.mjs +3 -3
  385. package/dist/mjs/util/waitForTimeout.mjs +1 -1
  386. package/dist/mjs/version.mjs +1 -1
  387. package/package.json +88 -88
  388. package/src/Coloris.css +6 -6
  389. package/src/Editor.scss +7 -5
  390. package/src/dialogs/dialogs.scss +3 -4
  391. package/src/dialogs/makeAboutDialog.scss +2 -2
  392. package/src/dialogs/makeMessageDialog.scss +11 -7
  393. package/src/styles.js +1 -1
  394. package/src/toolbar/AbstractToolbar.scss +20 -12
  395. package/src/toolbar/DropdownToolbar.scss +5 -4
  396. package/src/toolbar/EdgeToolbar.scss +65 -31
  397. package/src/toolbar/toolbar.scss +5 -5
  398. package/src/toolbar/utils/HelpDisplay.scss +48 -25
  399. package/src/toolbar/utils/labelVisibleOnHover.scss +39 -16
  400. package/src/toolbar/widgets/DocumentPropertiesWidget.scss +0 -1
  401. package/src/toolbar/widgets/HandToolWidget.scss +0 -1
  402. package/src/toolbar/widgets/InsertImageWidget/InsertImageWidget.scss +2 -3
  403. package/src/toolbar/widgets/OverflowWidget.css +1 -2
  404. package/src/toolbar/widgets/PenToolWidget.scss +0 -2
  405. package/src/toolbar/widgets/SelectionToolWidget.scss +1 -2
  406. package/src/toolbar/widgets/components/components.scss +6 -6
  407. package/src/toolbar/widgets/components/makeColorInput.scss +0 -2
  408. package/src/toolbar/widgets/components/makeFileInput.scss +5 -7
  409. package/src/toolbar/widgets/components/makeGridSelector.scss +6 -9
  410. package/src/toolbar/widgets/components/makeSnappedList.scss +3 -4
  411. package/src/toolbar/widgets/components/makeThicknessSlider.scss +1 -2
  412. package/src/toolbar/widgets/widgets.scss +7 -7
  413. package/src/tools/FindTool.css +6 -0
  414. package/src/tools/ScrollbarTool.scss +61 -0
  415. package/src/tools/SelectionTool/SelectionTool.scss +173 -0
  416. package/src/tools/SelectionTool/util/makeClipboardErrorHandlers.scss +14 -0
  417. package/src/tools/SoundUITool.scss +22 -0
  418. package/src/tools/tools.scss +5 -0
  419. package/src/tools/util/createMenuOverlay.scss +73 -0
  420. package/tsconfig.json +1 -3
  421. package/typedoc.json +1 -1
@@ -0,0 +1,502 @@
1
+ import { Mat33, Vec2 } from '@js-draw/math';
2
+ import { EditorEventType } from '../../types.mjs';
3
+ import Viewport from '../../Viewport.mjs';
4
+ import BaseTool from '../BaseTool.mjs';
5
+ import CanvasRenderer from '../../rendering/renderers/CanvasRenderer.mjs';
6
+ import SVGRenderer from '../../rendering/renderers/SVGRenderer.mjs';
7
+ import Selection from './Selection.mjs';
8
+ import TextComponent from '../../components/TextComponent.mjs';
9
+ import { duplicateSelectionShortcut, translateLeftSelectionShortcutId, translateRightSelectionShortcutId, selectAllKeyboardShortcut, sendToBackSelectionShortcut, snapToGridKeyboardShortcutId, translateDownSelectionShortcutId, translateUpSelectionShortcutId, rotateClockwiseSelectionShortcutId, rotateCounterClockwiseSelectionShortcutId, stretchXSelectionShortcutId, shrinkXSelectionShortcutId, shrinkYSelectionShortcutId, stretchYSelectionShortcutId, stretchXYSelectionShortcutId, shrinkXYSelectionShortcutId, } from '../keybindings.mjs';
10
+ import ToPointerAutoscroller from './ToPointerAutoscroller.mjs';
11
+ import showSelectionContextMenu from './util/showSelectionContextMenu.mjs';
12
+ export const cssPrefix = 'selection-tool-';
13
+ // Allows users to select/transform portions of the `EditorImage`.
14
+ // With respect to `extend`ing, `SelectionTool` is not stable.
15
+ export default class SelectionTool extends BaseTool {
16
+ constructor(editor, description) {
17
+ super(editor.notifier, description);
18
+ this.editor = editor;
19
+ // True if clearing and recreating the selectionBox has been deferred. This is used to prevent the selection
20
+ // from vanishing on pointerdown events that are intended to form other gestures (e.g. long press) that would
21
+ // ultimately restore the selection.
22
+ this.rebuildSelectionScheduled = false;
23
+ this.startPoint = null; // canvas position
24
+ this.expandingSelectionBox = false;
25
+ this.shiftKeyPressed = false;
26
+ this.snapToGrid = false;
27
+ this.lastPointer = null;
28
+ this.showContextMenu = async (canvasAnchor, preferSelectionMenu = true) => {
29
+ await showSelectionContextMenu(this.selectionBox, this.editor, canvasAnchor, preferSelectionMenu, () => this.clearSelection());
30
+ };
31
+ this.selectionBoxHandlingEvt = false;
32
+ this.lastSelectedObjects = [];
33
+ // Whether the last keypress corresponded to an action that didn't transform the
34
+ // selection (and thus does not need to be finalized on onKeyUp).
35
+ this.hasUnfinalizedTransformFromKeyPress = false;
36
+ this.autoscroller = new ToPointerAutoscroller(editor.viewport, (scrollBy) => {
37
+ editor.dispatch(Viewport.transformBy(Mat33.translation(scrollBy)), false);
38
+ // Update the selection box/content to match the new viewport.
39
+ if (this.lastPointer) {
40
+ // The viewport has changed -- ensure that the screen and canvas positions
41
+ // of the pointer are both correct
42
+ const updatedPointer = this.lastPointer.withScreenPosition(this.lastPointer.screenPos, editor.viewport);
43
+ this.onMainPointerUpdated(updatedPointer);
44
+ }
45
+ });
46
+ this.handleOverlay = document.createElement('div');
47
+ editor.createHTMLOverlay(this.handleOverlay);
48
+ this.handleOverlay.style.display = 'none';
49
+ this.handleOverlay.classList.add('handleOverlay');
50
+ editor.notifier.on(EditorEventType.ViewportChanged, (_data) => {
51
+ // The selection box could be using the wet ink display if its transformation
52
+ // hasn't been finalized yet. Clear before updating the UI.
53
+ this.editor.clearWetInk();
54
+ // If not currently selecting, ensure that the selection box
55
+ // is large enough.
56
+ if (!this.expandingSelectionBox) {
57
+ this.selectionBox?.padRegion();
58
+ }
59
+ this.selectionBox?.updateUI();
60
+ });
61
+ this.editor.handleKeyEventsFrom(this.handleOverlay);
62
+ this.editor.handlePointerEventsFrom(this.handleOverlay);
63
+ }
64
+ makeSelectionBox(selectionStartPos) {
65
+ this.prevSelectionBox = this.selectionBox;
66
+ this.selectionBox = new Selection(selectionStartPos, this.editor, this.showContextMenu);
67
+ if (!this.expandingSelectionBox) {
68
+ // Remove any previous selection rects
69
+ this.prevSelectionBox?.cancelSelection();
70
+ }
71
+ this.selectionBox.addTo(this.handleOverlay);
72
+ }
73
+ snapSelectionToGrid() {
74
+ if (!this.selectionBox)
75
+ throw new Error('No selection to snap!');
76
+ // Snap the top left corner of what we have selected.
77
+ const topLeftOfBBox = this.selectionBox.computeTightBoundingBox().topLeft;
78
+ const snappedTopLeft = this.editor.viewport.snapToGrid(topLeftOfBBox);
79
+ const snapDelta = snappedTopLeft.minus(topLeftOfBBox);
80
+ const oldTransform = this.selectionBox.getTransform();
81
+ this.selectionBox.setTransform(oldTransform.rightMul(Mat33.translation(snapDelta)));
82
+ this.selectionBox.finalizeTransform();
83
+ }
84
+ onContextMenu(event) {
85
+ const canShowSelectionMenu = this.selectionBox
86
+ ?.getScreenRegion()
87
+ ?.containsPoint(event.screenPos);
88
+ void this.showContextMenu(event.canvasPos, canShowSelectionMenu);
89
+ return true;
90
+ }
91
+ onPointerDown({ allPointers, current }) {
92
+ const snapToGrid = this.snapToGrid;
93
+ if (snapToGrid) {
94
+ current = current.snappedToGrid(this.editor.viewport);
95
+ }
96
+ // Don't rely on .isPrimary -- it's buggy in Firefox. See https://github.com/personalizedrefrigerator/js-draw/issues/71
97
+ if (allPointers.length === 1) {
98
+ this.startPoint = current.canvasPos;
99
+ let transforming = false;
100
+ if (this.selectionBox) {
101
+ if (snapToGrid) {
102
+ this.snapSelectionToGrid();
103
+ }
104
+ const dragStartResult = this.selectionBox.onDragStart(current);
105
+ if (dragStartResult) {
106
+ transforming = true;
107
+ this.selectionBoxHandlingEvt = true;
108
+ this.expandingSelectionBox = false;
109
+ }
110
+ }
111
+ if (!transforming) {
112
+ // Shift key: Combine the new and old selection boxes at the end of the gesture.
113
+ this.expandingSelectionBox = this.shiftKeyPressed;
114
+ this.rebuildSelectionScheduled = true;
115
+ }
116
+ else {
117
+ // Only autoscroll if we're transforming an existing selection
118
+ this.autoscroller.start();
119
+ }
120
+ return true;
121
+ }
122
+ return false;
123
+ }
124
+ onPointerMove(event) {
125
+ this.onMainPointerUpdated(event.current);
126
+ }
127
+ onMainPointerUpdated(currentPointer) {
128
+ this.lastPointer = currentPointer;
129
+ if (this.rebuildSelectionScheduled) {
130
+ this.rebuildSelectionScheduled = false;
131
+ this.makeSelectionBox(this.startPoint ?? currentPointer.canvasPos);
132
+ this.selectionBox?.setHandlesVisible(false);
133
+ }
134
+ if (!this.selectionBox)
135
+ return;
136
+ this.autoscroller.onPointerMove(currentPointer.screenPos);
137
+ if (!this.expandingSelectionBox && this.shiftKeyPressed && this.startPoint) {
138
+ const screenPos = this.editor.viewport.canvasToScreen(this.startPoint);
139
+ currentPointer = currentPointer.lockedToXYAxesScreen(screenPos, this.editor.viewport);
140
+ }
141
+ if (this.snapToGrid) {
142
+ currentPointer = currentPointer.snappedToGrid(this.editor.viewport);
143
+ }
144
+ if (this.selectionBoxHandlingEvt) {
145
+ this.selectionBox.onDragUpdate(currentPointer);
146
+ }
147
+ else {
148
+ this.selectionBox.setToPoint(currentPointer.canvasPos);
149
+ }
150
+ }
151
+ onPointerUp(event) {
152
+ this.onMainPointerUpdated(event.current);
153
+ this.autoscroller.stop();
154
+ if (!this.selectionBox)
155
+ return;
156
+ this.selectionBox.setHandlesVisible(true);
157
+ // Were we expanding the previous selection?
158
+ if (this.expandingSelectionBox && this.prevSelectionBox) {
159
+ // If so, finish expanding.
160
+ this.expandingSelectionBox = false;
161
+ this.selectionBox.resolveToObjects();
162
+ this.setSelection([
163
+ ...this.selectionBox.getSelectedObjects(),
164
+ ...this.prevSelectionBox.getSelectedObjects(),
165
+ ]);
166
+ }
167
+ else {
168
+ if (!this.selectionBoxHandlingEvt) {
169
+ // Expand/shrink the selection rectangle, if applicable
170
+ this.selectionBox.resolveToObjects();
171
+ this.onSelectionUpdated();
172
+ }
173
+ else {
174
+ this.selectionBox.onDragEnd();
175
+ }
176
+ this.selectionBoxHandlingEvt = false;
177
+ this.lastPointer = null;
178
+ }
179
+ }
180
+ onGestureCancel() {
181
+ this.autoscroller.stop();
182
+ if (this.selectionBoxHandlingEvt) {
183
+ this.selectionBox?.onDragCancel();
184
+ }
185
+ else if (!this.rebuildSelectionScheduled) {
186
+ // Revert to the previous selection, if any.
187
+ this.selectionBox?.cancelSelection();
188
+ this.selectionBox = this.prevSelectionBox;
189
+ this.selectionBox?.addTo(this.handleOverlay);
190
+ this.selectionBox?.recomputeRegion();
191
+ this.prevSelectionBox = null;
192
+ }
193
+ this.rebuildSelectionScheduled = false;
194
+ this.expandingSelectionBox = false;
195
+ this.lastPointer = null;
196
+ this.selectionBoxHandlingEvt = false;
197
+ }
198
+ onSelectionUpdated() {
199
+ const selectedItemCount = this.selectionBox?.getSelectedItemCount() ?? 0;
200
+ const selectedObjects = this.selectionBox?.getSelectedObjects() ?? [];
201
+ const hasDifferentSelection = this.lastSelectedObjects.length !== selectedItemCount ||
202
+ selectedObjects.some((obj, i) => this.lastSelectedObjects[i] !== obj);
203
+ if (hasDifferentSelection) {
204
+ this.lastSelectedObjects = selectedObjects;
205
+ // Note that the selection has changed
206
+ this.editor.notifier.dispatch(EditorEventType.ToolUpdated, {
207
+ kind: EditorEventType.ToolUpdated,
208
+ tool: this,
209
+ });
210
+ // Only fire the SelectionUpdated event if the selection really updated.
211
+ this.editor.notifier.dispatch(EditorEventType.SelectionUpdated, {
212
+ kind: EditorEventType.SelectionUpdated,
213
+ selectedComponents: selectedObjects,
214
+ tool: this,
215
+ });
216
+ if (selectedItemCount > 0) {
217
+ this.editor.announceForAccessibility(this.editor.localization.selectedElements(selectedItemCount));
218
+ this.zoomToSelection();
219
+ }
220
+ }
221
+ if (selectedItemCount === 0 && this.selectionBox) {
222
+ this.selectionBox.cancelSelection();
223
+ this.prevSelectionBox = this.selectionBox;
224
+ this.selectionBox = null;
225
+ }
226
+ }
227
+ zoomToSelection() {
228
+ if (this.selectionBox) {
229
+ const selectionRect = this.selectionBox.region;
230
+ this.editor.dispatchNoAnnounce(this.editor.viewport.zoomTo(selectionRect, false), false);
231
+ }
232
+ }
233
+ onKeyPress(event) {
234
+ const shortcucts = this.editor.shortcuts;
235
+ if (shortcucts.matchesShortcut(snapToGridKeyboardShortcutId, event)) {
236
+ this.snapToGrid = true;
237
+ return true;
238
+ }
239
+ if (this.selectionBox &&
240
+ (shortcucts.matchesShortcut(duplicateSelectionShortcut, event) ||
241
+ shortcucts.matchesShortcut(sendToBackSelectionShortcut, event))) {
242
+ // Handle duplication on key up — we don't want to accidentally duplicate
243
+ // many times.
244
+ return true;
245
+ }
246
+ else if (shortcucts.matchesShortcut(selectAllKeyboardShortcut, event)) {
247
+ this.setSelection(this.editor.image.getAllElements());
248
+ return true;
249
+ }
250
+ else if (event.ctrlKey) {
251
+ // Don't transform the selection with, for example, ctrl+i.
252
+ // Pass it to another tool, if apliccable.
253
+ return false;
254
+ }
255
+ else if (event.shiftKey || event.key === 'Shift') {
256
+ this.shiftKeyPressed = true;
257
+ if (event.key === 'Shift') {
258
+ return true;
259
+ }
260
+ }
261
+ let rotationSteps = 0;
262
+ let xTranslateSteps = 0;
263
+ let yTranslateSteps = 0;
264
+ let xScaleSteps = 0;
265
+ let yScaleSteps = 0;
266
+ if (shortcucts.matchesShortcut(translateLeftSelectionShortcutId, event)) {
267
+ xTranslateSteps -= 1;
268
+ }
269
+ else if (shortcucts.matchesShortcut(translateRightSelectionShortcutId, event)) {
270
+ xTranslateSteps += 1;
271
+ }
272
+ else if (shortcucts.matchesShortcut(translateUpSelectionShortcutId, event)) {
273
+ yTranslateSteps -= 1;
274
+ }
275
+ else if (shortcucts.matchesShortcut(translateDownSelectionShortcutId, event)) {
276
+ yTranslateSteps += 1;
277
+ }
278
+ else if (shortcucts.matchesShortcut(rotateClockwiseSelectionShortcutId, event)) {
279
+ rotationSteps += 1;
280
+ }
281
+ else if (shortcucts.matchesShortcut(rotateCounterClockwiseSelectionShortcutId, event)) {
282
+ rotationSteps -= 1;
283
+ }
284
+ else if (shortcucts.matchesShortcut(shrinkXSelectionShortcutId, event)) {
285
+ xScaleSteps -= 1;
286
+ }
287
+ else if (shortcucts.matchesShortcut(stretchXSelectionShortcutId, event)) {
288
+ xScaleSteps += 1;
289
+ }
290
+ else if (shortcucts.matchesShortcut(shrinkYSelectionShortcutId, event)) {
291
+ yScaleSteps -= 1;
292
+ }
293
+ else if (shortcucts.matchesShortcut(stretchYSelectionShortcutId, event)) {
294
+ yScaleSteps += 1;
295
+ }
296
+ else if (shortcucts.matchesShortcut(shrinkXYSelectionShortcutId, event)) {
297
+ xScaleSteps -= 1;
298
+ yScaleSteps -= 1;
299
+ }
300
+ else if (shortcucts.matchesShortcut(stretchXYSelectionShortcutId, event)) {
301
+ xScaleSteps += 1;
302
+ yScaleSteps += 1;
303
+ }
304
+ let handled = xTranslateSteps !== 0 ||
305
+ yTranslateSteps !== 0 ||
306
+ rotationSteps !== 0 ||
307
+ xScaleSteps !== 0 ||
308
+ yScaleSteps !== 0;
309
+ if (!this.selectionBox) {
310
+ handled = false;
311
+ }
312
+ else if (handled) {
313
+ const translateStepSize = 10 * this.editor.viewport.getSizeOfPixelOnCanvas();
314
+ const rotateStepSize = Math.PI / 8;
315
+ const scaleStepSize = 5 / 4;
316
+ const region = this.selectionBox.region;
317
+ const scaleFactor = Vec2.of(scaleStepSize ** xScaleSteps, scaleStepSize ** yScaleSteps);
318
+ const rotationMat = Mat33.zRotation(rotationSteps * rotateStepSize);
319
+ const roundedRotationMatrix = rotationMat.mapEntries((component) => Viewport.roundScaleRatio(component));
320
+ const regionCenter = this.editor.viewport.roundPoint(region.center);
321
+ const transform = Mat33.scaling2D(scaleFactor, this.editor.viewport.roundPoint(region.topLeft))
322
+ .rightMul(Mat33.translation(regionCenter)
323
+ .rightMul(roundedRotationMatrix)
324
+ .rightMul(Mat33.translation(regionCenter.times(-1))))
325
+ .rightMul(Mat33.translation(this.editor.viewport.roundPoint(Vec2.of(xTranslateSteps, yTranslateSteps).times(translateStepSize))));
326
+ const oldTransform = this.selectionBox.getTransform();
327
+ this.selectionBox.setTransform(oldTransform.rightMul(transform));
328
+ this.selectionBox.scrollTo();
329
+ // The transformation needs to be finalized at some point (on key up)
330
+ this.hasUnfinalizedTransformFromKeyPress = true;
331
+ }
332
+ if (this.selectionBox && !handled && (event.key === 'Delete' || event.key === 'Backspace')) {
333
+ this.editor.dispatch(this.selectionBox.deleteSelectedObjects());
334
+ this.clearSelection();
335
+ handled = true;
336
+ }
337
+ return handled;
338
+ }
339
+ onKeyUp(evt) {
340
+ const shortcucts = this.editor.shortcuts;
341
+ if (shortcucts.matchesShortcut(snapToGridKeyboardShortcutId, evt)) {
342
+ this.snapToGrid = false;
343
+ return true;
344
+ }
345
+ if (shortcucts.matchesShortcut(selectAllKeyboardShortcut, evt)) {
346
+ // Selected all in onKeyDown. Don't finalizeTransform.
347
+ return true;
348
+ }
349
+ if (this.selectionBox && shortcucts.matchesShortcut(duplicateSelectionShortcut, evt)) {
350
+ // Finalize duplicating the selection
351
+ this.selectionBox.duplicateSelectedObjects().then((command) => {
352
+ this.editor.dispatch(command);
353
+ });
354
+ return true;
355
+ }
356
+ if (this.selectionBox && shortcucts.matchesShortcut(sendToBackSelectionShortcut, evt)) {
357
+ const sendToBackCommand = this.selectionBox.sendToBack();
358
+ if (sendToBackCommand) {
359
+ this.editor.dispatch(sendToBackCommand);
360
+ }
361
+ return true;
362
+ }
363
+ // Here, we check if shiftKey === false because, as of this writing,
364
+ // evt.shiftKey is an optional property. Being falsey could just mean
365
+ // that it wasn't set.
366
+ if (evt.shiftKey === false) {
367
+ this.shiftKeyPressed = false;
368
+ // Don't return immediately -- event may be otherwise handled
369
+ }
370
+ // Also check for key === 'Shift' (for the case where shiftKey is undefined)
371
+ if (evt.key === 'Shift') {
372
+ this.shiftKeyPressed = false;
373
+ return true;
374
+ }
375
+ // If we don't need to finalize the transform
376
+ if (!this.hasUnfinalizedTransformFromKeyPress) {
377
+ return true;
378
+ }
379
+ if (this.selectionBox) {
380
+ this.selectionBox.finalizeTransform();
381
+ this.hasUnfinalizedTransformFromKeyPress = false;
382
+ return true;
383
+ }
384
+ return false;
385
+ }
386
+ onCopy(event) {
387
+ if (!this.selectionBox) {
388
+ return false;
389
+ }
390
+ const selectedElems = this.selectionBox.getSelectedObjects();
391
+ const bbox = this.selectionBox.region;
392
+ if (selectedElems.length === 0) {
393
+ return false;
394
+ }
395
+ const exportViewport = new Viewport(() => { });
396
+ const selectionScreenSize = this.selectionBox
397
+ .getScreenRegion()
398
+ .size.times(this.editor.display.getDevicePixelRatio());
399
+ // Update the viewport to have screen size roughly equal to the size of the selection box
400
+ let scaleFactor = selectionScreenSize.maximumEntryMagnitude() / (bbox.size.maximumEntryMagnitude() || 1);
401
+ // Round to a nearby power of two
402
+ scaleFactor = Math.pow(2, Math.ceil(Math.log2(scaleFactor)));
403
+ exportViewport.updateScreenSize(bbox.size.times(scaleFactor));
404
+ exportViewport.resetTransform(Mat33.scaling2D(scaleFactor)
405
+ // Move the selection onto the screen
406
+ .rightMul(Mat33.translation(bbox.topLeft.times(-1))));
407
+ const { element: svgExportElem, renderer: svgRenderer } = SVGRenderer.fromViewport(exportViewport, { sanitize: true, useViewBoxForPositioning: true });
408
+ const { element: canvas, renderer: canvasRenderer } = CanvasRenderer.fromViewport(exportViewport, { maxCanvasDimen: 4096 });
409
+ const text = [];
410
+ for (const elem of selectedElems) {
411
+ elem.render(svgRenderer);
412
+ elem.render(canvasRenderer);
413
+ if (elem instanceof TextComponent) {
414
+ text.push(elem.getText());
415
+ }
416
+ }
417
+ event.setData('image/svg+xml', svgExportElem.outerHTML);
418
+ event.setData('text/html', svgExportElem.outerHTML);
419
+ event.setData('image/png', new Promise((resolve, reject) => {
420
+ canvas.toBlob((blob) => {
421
+ if (blob) {
422
+ resolve(blob);
423
+ }
424
+ else {
425
+ reject(new Error('Failed to convert canvas to blob.'));
426
+ }
427
+ }, 'image/png');
428
+ }));
429
+ if (text.length > 0) {
430
+ event.setData('text/plain', text.join('\n'));
431
+ }
432
+ return true;
433
+ }
434
+ setEnabled(enabled) {
435
+ const wasEnabled = this.isEnabled();
436
+ super.setEnabled(enabled);
437
+ if (wasEnabled === enabled) {
438
+ return;
439
+ }
440
+ // Clear the selection
441
+ this.selectionBox?.cancelSelection();
442
+ this.onSelectionUpdated();
443
+ this.handleOverlay.replaceChildren();
444
+ this.selectionBox = null;
445
+ this.shiftKeyPressed = false;
446
+ this.snapToGrid = false;
447
+ this.handleOverlay.style.display = enabled ? 'block' : 'none';
448
+ if (enabled) {
449
+ this.handleOverlay.tabIndex = 0;
450
+ this.handleOverlay.setAttribute('aria-label', this.editor.localization.selectionToolKeyboardShortcuts);
451
+ }
452
+ else {
453
+ this.handleOverlay.tabIndex = -1;
454
+ }
455
+ }
456
+ // Get the object responsible for displaying this' selection.
457
+ // @internal
458
+ getSelection() {
459
+ return this.selectionBox;
460
+ }
461
+ getSelectedObjects() {
462
+ return this.selectionBox?.getSelectedObjects() ?? [];
463
+ }
464
+ // Select the given `objects`. Any non-selectable objects in `objects` are ignored.
465
+ setSelection(objects) {
466
+ // Only select selectable objects.
467
+ objects = objects.filter((obj) => obj.isSelectable());
468
+ // Sort by z-index
469
+ objects.sort((a, b) => a.getZIndex() - b.getZIndex());
470
+ // Remove duplicates
471
+ objects = objects.filter((current, idx) => {
472
+ if (idx > 0) {
473
+ return current !== objects[idx - 1];
474
+ }
475
+ return true;
476
+ });
477
+ let bbox = null;
478
+ for (const object of objects) {
479
+ if (bbox) {
480
+ bbox = bbox.union(object.getBBox());
481
+ }
482
+ else {
483
+ bbox = object.getBBox();
484
+ }
485
+ }
486
+ if (!bbox) {
487
+ return;
488
+ }
489
+ this.clearSelection();
490
+ if (!this.selectionBox) {
491
+ this.makeSelectionBox(bbox.topLeft);
492
+ }
493
+ this.selectionBox.setSelectedObjects(objects, bbox);
494
+ this.onSelectionUpdated();
495
+ }
496
+ clearSelection() {
497
+ this.handleOverlay.replaceChildren();
498
+ this.prevSelectionBox = this.selectionBox;
499
+ this.selectionBox = null;
500
+ this.onSelectionUpdated();
501
+ }
502
+ }
@@ -0,0 +1,23 @@
1
+ import { Point2, Vec2 } from '@js-draw/math';
2
+ import Viewport from '../../Viewport';
3
+ type ScrollByCallback = (delta: Vec2) => void;
4
+ /**
5
+ * Automatically scrolls the viewport such that the user's pointer is visible.
6
+ */
7
+ export default class ToPointerAutoscroller {
8
+ private viewport;
9
+ private scrollByCanvasDelta;
10
+ private started;
11
+ private updateLoopId;
12
+ private updateLoopRunning;
13
+ private targetPoint;
14
+ private scrollRate;
15
+ constructor(viewport: Viewport, scrollByCanvasDelta: ScrollByCallback);
16
+ private getScrollForPoint;
17
+ start(): void;
18
+ onPointerMove(pointerScreenPosition: Point2): void;
19
+ stop(): void;
20
+ private startUpdateLoop;
21
+ private stopUpdateLoop;
22
+ }
23
+ export {};
@@ -0,0 +1,77 @@
1
+ import { Rect2, Vec2 } from '@js-draw/math';
2
+ import untilNextAnimationFrame from '../../util/untilNextAnimationFrame.mjs';
3
+ /**
4
+ * Automatically scrolls the viewport such that the user's pointer is visible.
5
+ */
6
+ export default class ToPointerAutoscroller {
7
+ constructor(viewport, scrollByCanvasDelta) {
8
+ this.viewport = viewport;
9
+ this.scrollByCanvasDelta = scrollByCanvasDelta;
10
+ this.started = false;
11
+ this.updateLoopId = 0;
12
+ this.updateLoopRunning = false;
13
+ this.targetPoint = null;
14
+ this.scrollRate = 1000; // px/s
15
+ }
16
+ getScrollForPoint(screenPoint) {
17
+ const screenSize = this.viewport.getScreenRectSize();
18
+ const screenRect = new Rect2(0, 0, screenSize.x, screenSize.y);
19
+ // Starts autoscrolling when the cursor is **outside of** this region
20
+ const marginSize = 44;
21
+ const autoscrollBoundary = screenRect.grownBy(-marginSize);
22
+ if (autoscrollBoundary.containsPoint(screenPoint)) {
23
+ return Vec2.zero;
24
+ }
25
+ const closestEdgePoint = autoscrollBoundary.getClosestPointOnBoundaryTo(screenPoint);
26
+ const distToEdge = closestEdgePoint.distanceTo(screenPoint);
27
+ const toEdge = closestEdgePoint.minus(screenPoint);
28
+ // Go faster for points further away from the boundary.
29
+ const maximumScaleFactor = 1.25;
30
+ const scaleFactor = Math.min(distToEdge / marginSize, maximumScaleFactor);
31
+ return toEdge.normalizedOrZero().times(scaleFactor);
32
+ }
33
+ start() {
34
+ this.started = true;
35
+ }
36
+ onPointerMove(pointerScreenPosition) {
37
+ if (!this.started) {
38
+ return;
39
+ }
40
+ if (this.getScrollForPoint(pointerScreenPosition) === Vec2.zero) {
41
+ this.stopUpdateLoop();
42
+ }
43
+ else {
44
+ this.targetPoint = pointerScreenPosition;
45
+ this.startUpdateLoop();
46
+ }
47
+ }
48
+ stop() {
49
+ this.targetPoint = null;
50
+ this.started = false;
51
+ this.stopUpdateLoop();
52
+ }
53
+ startUpdateLoop() {
54
+ if (this.updateLoopRunning) {
55
+ return;
56
+ }
57
+ (async () => {
58
+ this.updateLoopId++;
59
+ const currentUpdateLoopId = this.updateLoopId;
60
+ let lastUpdateTime = performance.now();
61
+ while (this.updateLoopId === currentUpdateLoopId && this.targetPoint) {
62
+ this.updateLoopRunning = true;
63
+ const currentTime = performance.now();
64
+ const deltaTimeMs = currentTime - lastUpdateTime;
65
+ const scrollDirection = this.getScrollForPoint(this.targetPoint);
66
+ const screenScrollAmount = scrollDirection.times((this.scrollRate * deltaTimeMs) / 1000);
67
+ this.scrollByCanvasDelta(this.viewport.screenToCanvasTransform.transformVec3(screenScrollAmount));
68
+ lastUpdateTime = currentTime;
69
+ await untilNextAnimationFrame();
70
+ }
71
+ this.updateLoopRunning = false;
72
+ })();
73
+ }
74
+ stopUpdateLoop() {
75
+ this.updateLoopId++;
76
+ }
77
+ }
@@ -0,0 +1,42 @@
1
+ import Editor from '../../Editor';
2
+ import { Vec3 } from '@js-draw/math';
3
+ import Selection from './Selection';
4
+ import { ResizeMode } from './types';
5
+ export declare class DragTransformer {
6
+ private readonly editor;
7
+ private selection;
8
+ private dragStartPoint;
9
+ constructor(editor: Editor, selection: Selection);
10
+ onDragStart(startPoint: Vec3): void;
11
+ onDragUpdate(canvasPos: Vec3): void;
12
+ onDragEnd(): void | Promise<void>;
13
+ }
14
+ export declare class ResizeTransformer {
15
+ private readonly editor;
16
+ private selection;
17
+ private mode;
18
+ private dragStartPoint;
19
+ private transformOrigin;
20
+ private scaleRate;
21
+ constructor(editor: Editor, selection: Selection);
22
+ onDragStart(startPoint: Vec3, mode: ResizeMode): void;
23
+ private computeOriginAndScaleRate;
24
+ onDragUpdate(canvasPos: Vec3): void;
25
+ onDragEnd(): void | Promise<void>;
26
+ }
27
+ export declare class RotateTransformer {
28
+ private readonly editor;
29
+ private selection;
30
+ private startAngle;
31
+ private targetRotation;
32
+ private maximumDistFromStart;
33
+ private startPoint;
34
+ private startTime;
35
+ constructor(editor: Editor, selection: Selection);
36
+ private getAngle;
37
+ private roundAngle;
38
+ onDragStart(startPoint: Vec3): void;
39
+ private setRotationTo;
40
+ onDragUpdate(canvasPos: Vec3): void;
41
+ onDragEnd(): void | Promise<void>;
42
+ }