fabric 5.3.0 → 6.0.0-beta10

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 (634) hide show
  1. package/.babelrc +11 -0
  2. package/.babelrcAlt +19 -0
  3. package/.browserslistrc +5 -0
  4. package/.eslintignore +3 -0
  5. package/.eslintrc.js +51 -0
  6. package/.eslintrc.json +38 -46
  7. package/.eslintrc_tests +12 -0
  8. package/.gitattributes +2 -0
  9. package/.gitpod.yml +17 -1
  10. package/.prettierignore +19 -0
  11. package/.prettierrc +4 -0
  12. package/CHANGELOG.md +615 -189
  13. package/CONTRIBUTING.md +233 -59
  14. package/README.md +200 -235
  15. package/babel-jest.config.js +6 -0
  16. package/bower.json +1 -3
  17. package/dist/fabric.d.ts +54 -0
  18. package/dist/index.d.ts +2 -0
  19. package/dist/index.js +28452 -0
  20. package/dist/index.js.map +1 -0
  21. package/dist/index.min.js +1 -0
  22. package/dist/index.mjs +28385 -0
  23. package/dist/index.mjs.map +1 -0
  24. package/dist/index.node.cjs +28538 -0
  25. package/dist/index.node.cjs.map +1 -0
  26. package/dist/index.node.d.ts +20 -0
  27. package/dist/index.node.mjs +28477 -0
  28. package/dist/index.node.mjs.map +1 -0
  29. package/dist/src/ClassRegistry.d.ts +13 -0
  30. package/dist/src/Collection.d.ts +136 -0
  31. package/dist/src/CommonMethods.d.ts +32 -0
  32. package/dist/src/EventTypeDefs.d.ts +227 -0
  33. package/dist/src/Intersection.d.ts +112 -0
  34. package/dist/src/Observable.d.ts +60 -0
  35. package/dist/src/Pattern/Pattern.d.ts +99 -0
  36. package/dist/src/Pattern/index.d.ts +3 -0
  37. package/dist/src/Pattern/types.d.ts +9 -0
  38. package/dist/src/Point.d.ts +232 -0
  39. package/dist/src/Shadow.d.ts +96 -0
  40. package/dist/src/brushes/BaseBrush.d.ts +101 -0
  41. package/dist/src/brushes/CircleBrush.d.ts +44 -0
  42. package/dist/src/brushes/CircleBrush.test.d.ts +2 -0
  43. package/dist/src/brushes/PatternBrush.d.ts +23 -0
  44. package/dist/src/brushes/PencilBrush.d.ts +92 -0
  45. package/dist/src/brushes/SprayBrush.d.ts +74 -0
  46. package/dist/src/brushes/typedefs.d.ts +18 -0
  47. package/dist/src/cache.d.ts +47 -0
  48. package/dist/src/canvas/Canvas.d.ts +364 -0
  49. package/dist/src/canvas/DOMManagers/CanvasDOMManager.d.ts +29 -0
  50. package/dist/src/canvas/DOMManagers/StaticCanvasDOMManager.d.ts +29 -0
  51. package/dist/src/canvas/DOMManagers/util.d.ts +24 -0
  52. package/dist/src/canvas/DOMManagers/util.spec.d.ts +2 -0
  53. package/dist/src/canvas/SelectableCanvas.d.ts +723 -0
  54. package/dist/src/canvas/StaticCanvas.d.ts +747 -0
  55. package/dist/src/canvas/TextEditingManager.d.ts +21 -0
  56. package/dist/src/canvas/canvas_gestures.mixin.d.ts +2 -0
  57. package/dist/src/color/Color.d.ts +152 -0
  58. package/dist/src/color/color_map.d.ts +155 -0
  59. package/dist/src/color/constants.d.ts +104 -0
  60. package/dist/src/color/typedefs.d.ts +16 -0
  61. package/dist/src/color/util.d.ts +27 -0
  62. package/dist/src/config.d.ts +115 -0
  63. package/dist/src/constants.d.ts +21 -0
  64. package/dist/src/controls/Control.d.ts +229 -0
  65. package/dist/src/controls/changeWidth.d.ts +13 -0
  66. package/dist/src/controls/commonControls.d.ts +28 -0
  67. package/dist/src/controls/controlRendering.d.ts +29 -0
  68. package/dist/src/controls/drag.d.ts +12 -0
  69. package/dist/src/controls/fireEvent.d.ts +3 -0
  70. package/dist/src/controls/index.d.ts +13 -0
  71. package/dist/src/controls/polyControl.d.ts +5 -0
  72. package/dist/src/controls/rotate.d.ts +12 -0
  73. package/dist/src/controls/scale.d.ts +47 -0
  74. package/dist/src/controls/scaleSkew.d.ts +39 -0
  75. package/dist/src/controls/skew.d.ts +33 -0
  76. package/dist/src/controls/util.d.ts +41 -0
  77. package/dist/src/controls/wrapWithFireEvent.d.ts +8 -0
  78. package/dist/src/controls/wrapWithFixedAnchor.d.ts +9 -0
  79. package/dist/src/env/browser.d.ts +3 -0
  80. package/dist/src/env/index.d.ts +28 -0
  81. package/dist/src/env/node.d.ts +6 -0
  82. package/dist/src/env/types.d.ts +15 -0
  83. package/dist/src/filters/BaseFilter.d.ts +160 -0
  84. package/dist/src/filters/BlendColor.d.ts +81 -0
  85. package/dist/src/filters/BlendImage.d.ts +93 -0
  86. package/dist/src/filters/Blur.d.ts +52 -0
  87. package/dist/src/filters/Boilerplate.d.ts +48 -0
  88. package/dist/src/filters/Brightness.d.ts +48 -0
  89. package/dist/src/filters/Canvas2dFilterBackend.d.ts +27 -0
  90. package/dist/src/filters/ColorMatrix.d.ts +64 -0
  91. package/dist/src/filters/ColorMatrixFilters.d.ts +537 -0
  92. package/dist/src/filters/Composed.d.ts +46 -0
  93. package/dist/src/filters/Contrast.d.ts +46 -0
  94. package/dist/src/filters/Convolute.d.ts +83 -0
  95. package/dist/src/filters/FilterBackend.d.ts +15 -0
  96. package/dist/src/filters/GLProbes/GLProbe.d.ts +7 -0
  97. package/dist/src/filters/GLProbes/NodeGLProbe.d.ts +11 -0
  98. package/dist/src/filters/GLProbes/WebGLProbe.d.ts +20 -0
  99. package/dist/src/filters/Gamma.d.ts +55 -0
  100. package/dist/src/filters/Grayscale.d.ts +47 -0
  101. package/dist/src/filters/HueRotation.d.ts +25 -0
  102. package/dist/src/filters/Invert.d.ts +56 -0
  103. package/dist/src/filters/Noise.d.ts +55 -0
  104. package/dist/src/filters/Pixelate.d.ts +45 -0
  105. package/dist/src/filters/RemoveColor.d.ts +64 -0
  106. package/dist/src/filters/Resize.d.ts +137 -0
  107. package/dist/src/filters/Saturation.d.ts +49 -0
  108. package/dist/src/filters/Vibrance.d.ts +49 -0
  109. package/dist/src/filters/WebGLFilterBackend.d.ts +128 -0
  110. package/dist/src/filters/filters.d.ts +21 -0
  111. package/dist/src/filters/index.d.ts +7 -0
  112. package/dist/src/filters/shaders/baseFilter.d.ts +4 -0
  113. package/dist/src/filters/shaders/blendColor.d.ts +13 -0
  114. package/dist/src/filters/shaders/blendImage.d.ts +3 -0
  115. package/dist/src/filters/shaders/blur.d.ts +2 -0
  116. package/dist/src/filters/shaders/brightness.d.ts +2 -0
  117. package/dist/src/filters/shaders/colorMatrix.d.ts +2 -0
  118. package/dist/src/filters/shaders/constrast.d.ts +2 -0
  119. package/dist/src/filters/shaders/convolute.d.ts +11 -0
  120. package/dist/src/filters/shaders/gamma.d.ts +2 -0
  121. package/dist/src/filters/shaders/grayscale.d.ts +3 -0
  122. package/dist/src/filters/shaders/invert.d.ts +2 -0
  123. package/dist/src/filters/shaders/noise.d.ts +2 -0
  124. package/dist/src/filters/shaders/pixelate.d.ts +2 -0
  125. package/dist/src/filters/shaders/removeColor.d.ts +2 -0
  126. package/dist/src/filters/shaders/saturation.d.ts +2 -0
  127. package/dist/src/filters/shaders/vibrance.d.ts +2 -0
  128. package/dist/src/filters/typedefs.d.ts +48 -0
  129. package/dist/src/filters/utils.d.ts +3 -0
  130. package/dist/src/gradient/Gradient.d.ts +150 -0
  131. package/dist/src/gradient/constants.d.ts +15 -0
  132. package/dist/src/gradient/index.d.ts +3 -0
  133. package/dist/src/gradient/parser/index.d.ts +4 -0
  134. package/dist/src/gradient/parser/misc.d.ts +4 -0
  135. package/dist/src/gradient/parser/parseColorStops.d.ts +3 -0
  136. package/dist/src/gradient/parser/parseCoords.d.ts +17 -0
  137. package/dist/src/gradient/typedefs.d.ts +93 -0
  138. package/dist/src/mixins/eraser_brush.mixin.d.ts +2 -0
  139. package/dist/src/parkinglot/canvas_animation.mixin.d.ts +2 -0
  140. package/dist/src/parkinglot/straighten.d.ts +2 -0
  141. package/dist/src/parser/applyViewboxTransform.d.ts +5 -0
  142. package/dist/src/parser/attributes.d.ts +6 -0
  143. package/dist/src/parser/constants.d.ts +53 -0
  144. package/dist/src/parser/doesSomeParentMatch.d.ts +2 -0
  145. package/dist/src/parser/elementById.d.ts +6 -0
  146. package/dist/src/parser/elementMatchesRule.d.ts +5 -0
  147. package/dist/src/parser/elements_parser.d.ts +3 -0
  148. package/dist/src/parser/getCSSRules.d.ts +7 -0
  149. package/dist/src/parser/getGlobalStylesForElement.d.ts +5 -0
  150. package/dist/src/parser/getGradientDefs.d.ts +7 -0
  151. package/dist/src/parser/getMultipleNodes.d.ts +2 -0
  152. package/dist/src/parser/getSvgRegex.d.ts +2 -0
  153. package/dist/src/parser/hasAncestorWithNodeName.d.ts +2 -0
  154. package/dist/src/parser/index.d.ts +9 -0
  155. package/dist/src/parser/loadSVGFromString.d.ts +18 -0
  156. package/dist/src/parser/loadSVGFromURL.d.ts +19 -0
  157. package/dist/src/parser/normalizeAttr.d.ts +2 -0
  158. package/dist/src/parser/normalizeValue.d.ts +2 -0
  159. package/dist/src/parser/parseAttributes.d.ts +9 -0
  160. package/dist/src/parser/parseFontDeclaration.d.ts +10 -0
  161. package/dist/src/parser/parsePointsAttribute.d.ts +12 -0
  162. package/dist/src/parser/parseSVGDocument.d.ts +23 -0
  163. package/dist/src/parser/parseStyleAttribute.d.ts +9 -0
  164. package/dist/src/parser/parseStyleObject.d.ts +2 -0
  165. package/dist/src/parser/parseStyleString.d.ts +2 -0
  166. package/dist/src/parser/parseTransformAttribute.d.ts +11 -0
  167. package/dist/src/parser/parseUseDirectives.d.ts +2 -0
  168. package/dist/src/parser/percent.d.ts +9 -0
  169. package/dist/src/parser/recursivelyParseGradientsXlink.d.ts +2 -0
  170. package/dist/src/parser/selectorMatches.d.ts +2 -0
  171. package/dist/src/parser/setStrokeFillOpacity.d.ts +6 -0
  172. package/dist/src/parser/typedefs.d.ts +9 -0
  173. package/dist/src/shapes/ActiveSelection.d.ts +83 -0
  174. package/dist/src/shapes/Circle.d.ts +99 -0
  175. package/dist/src/shapes/Ellipse.d.ts +84 -0
  176. package/dist/src/shapes/Group.d.ts +407 -0
  177. package/dist/src/shapes/IText/DraggableTextDelegate.d.ts +78 -0
  178. package/dist/src/shapes/IText/IText.d.ts +336 -0
  179. package/dist/src/shapes/IText/ITextBehavior.d.ts +287 -0
  180. package/dist/src/shapes/IText/ITextClickBehavior.d.ts +73 -0
  181. package/dist/src/shapes/IText/ITextKeyBehavior.d.ts +195 -0
  182. package/dist/src/shapes/IText/constants.d.ts +13 -0
  183. package/dist/src/shapes/Image.d.ts +309 -0
  184. package/dist/src/shapes/Line.d.ts +121 -0
  185. package/dist/src/shapes/Object/AnimatableObject.d.ts +33 -0
  186. package/dist/src/shapes/Object/FabricObject.d.ts +11 -0
  187. package/dist/src/shapes/Object/FabricObjectSVGExportMixin.d.ts +74 -0
  188. package/dist/src/shapes/Object/InteractiveObject.d.ts +296 -0
  189. package/dist/src/shapes/Object/Object.d.ts +599 -0
  190. package/dist/src/shapes/Object/ObjectGeometry.d.ts +327 -0
  191. package/dist/src/shapes/Object/ObjectOrigin.d.ts +109 -0
  192. package/dist/src/shapes/Object/StackedObject.d.ts +72 -0
  193. package/dist/src/shapes/Object/defaultValues.d.ts +76 -0
  194. package/dist/src/shapes/Object/types/BaseProps.d.ts +84 -0
  195. package/dist/src/shapes/Object/types/BorderProps.d.ts +37 -0
  196. package/dist/src/shapes/Object/types/ControlProps.d.ts +62 -0
  197. package/dist/src/shapes/Object/types/FabricObjectProps.d.ts +96 -0
  198. package/dist/src/shapes/Object/types/FillStrokeProps.d.ts +80 -0
  199. package/dist/src/shapes/Object/types/LockInteractionProps.d.ts +51 -0
  200. package/dist/src/shapes/Object/types/ObjectProps.d.ts +42 -0
  201. package/dist/src/shapes/Object/types/SerializedObjectProps.d.ts +66 -0
  202. package/dist/src/shapes/Object/types/index.d.ts +6 -0
  203. package/dist/src/shapes/Path.d.ts +214 -0
  204. package/dist/src/shapes/Polygon.d.ts +10 -0
  205. package/dist/src/shapes/Polyline.d.ts +147 -0
  206. package/dist/src/shapes/Rect.d.ts +82 -0
  207. package/dist/src/shapes/Text/StyledText.d.ts +123 -0
  208. package/dist/src/shapes/Text/Text.d.ts +688 -0
  209. package/dist/src/shapes/Text/TextSVGExportMixin.d.ts +32 -0
  210. package/dist/src/shapes/Text/constants.d.ts +13 -0
  211. package/dist/src/shapes/Textbox.d.ts +204 -0
  212. package/dist/src/shapes/Triangle.d.ts +26 -0
  213. package/dist/src/typedefs.d.ts +96 -0
  214. package/dist/src/util/animation/AnimationBase.d.ts +54 -0
  215. package/dist/src/util/animation/AnimationFrameProvider.d.ts +3 -0
  216. package/dist/src/util/animation/AnimationRegistry.d.ts +29 -0
  217. package/dist/src/util/animation/ArrayAnimation.d.ts +10 -0
  218. package/dist/src/util/animation/ColorAnimation.d.ts +11 -0
  219. package/dist/src/util/animation/ValueAnimation.d.ts +10 -0
  220. package/dist/src/util/animation/animate.d.ts +37 -0
  221. package/dist/src/util/animation/easing.d.ts +130 -0
  222. package/dist/src/util/animation/index.d.ts +3 -0
  223. package/dist/src/util/animation/types.d.ts +87 -0
  224. package/dist/src/util/applyMixins.d.ts +8 -0
  225. package/dist/src/util/dom_event.d.ts +5 -0
  226. package/dist/src/util/dom_misc.d.ts +12 -0
  227. package/dist/src/util/dom_request.d.ts +14 -0
  228. package/dist/src/util/dom_style.d.ts +7 -0
  229. package/dist/src/util/index.d.ts +36 -0
  230. package/dist/src/util/internals/cleanupSvgAttribute.d.ts +2 -0
  231. package/dist/src/util/internals/cleanupSvgAttribute.test.d.ts +2 -0
  232. package/dist/src/util/internals/cloneDeep.d.ts +2 -0
  233. package/dist/src/util/internals/cloneDeep.test.d.ts +2 -0
  234. package/dist/src/util/internals/getRandomInt.d.ts +8 -0
  235. package/dist/src/util/internals/getRandomInt.test.d.ts +2 -0
  236. package/dist/src/util/internals/ifNaN.d.ts +8 -0
  237. package/dist/src/util/internals/index.d.ts +4 -0
  238. package/dist/src/util/internals/removeFromArray.d.ts +9 -0
  239. package/dist/src/util/internals/uid.d.ts +2 -0
  240. package/dist/src/util/lang_string.d.ts +22 -0
  241. package/dist/src/util/misc/boundingBoxFromPoints.d.ts +9 -0
  242. package/dist/src/util/misc/capValue.d.ts +2 -0
  243. package/dist/src/util/misc/cos.d.ts +10 -0
  244. package/dist/src/util/misc/dom.d.ts +28 -0
  245. package/dist/src/util/misc/findScaleTo.d.ts +20 -0
  246. package/dist/src/util/misc/groupSVGElements.d.ts +9 -0
  247. package/dist/src/util/misc/isTransparent.d.ts +11 -0
  248. package/dist/src/util/misc/matrix.d.ts +168 -0
  249. package/dist/src/util/misc/mergeClipPaths.d.ts +23 -0
  250. package/dist/src/util/misc/objectEnlive.d.ts +41 -0
  251. package/dist/src/util/misc/objectTransforms.d.ts +68 -0
  252. package/dist/src/util/misc/pick.d.ts +9 -0
  253. package/dist/src/util/misc/planeChange.d.ts +81 -0
  254. package/dist/src/util/misc/projectStroke/StrokeLineCapProjections.d.ts +52 -0
  255. package/dist/src/util/misc/projectStroke/StrokeLineJoinProjections.d.ts +82 -0
  256. package/dist/src/util/misc/projectStroke/StrokeProjectionsBase.d.ts +26 -0
  257. package/dist/src/util/misc/projectStroke/index.d.ts +12 -0
  258. package/dist/src/util/misc/projectStroke/types.d.ts +23 -0
  259. package/dist/src/util/misc/radiansDegreesConversion.d.ts +14 -0
  260. package/dist/src/util/misc/resolveOrigin.d.ts +9 -0
  261. package/dist/src/util/misc/rotatePoint.d.ts +12 -0
  262. package/dist/src/util/misc/sin.d.ts +10 -0
  263. package/dist/src/util/misc/svgParsing.d.ts +45 -0
  264. package/dist/src/util/misc/textStyles.d.ts +32 -0
  265. package/dist/src/util/misc/toFixed.d.ts +8 -0
  266. package/dist/src/util/misc/vectors.d.ts +58 -0
  267. package/dist/src/util/path/index.d.ts +96 -0
  268. package/dist/src/util/path/regex.d.ts +2 -0
  269. package/dist/src/util/path/typechecks.d.ts +24 -0
  270. package/dist/src/util/path/typedefs.d.ts +220 -0
  271. package/dist/src/util/transform_matrix_removal.d.ts +14 -0
  272. package/dist/src/util/typeAssertions.d.ts +19 -0
  273. package/e2e/site/index.html +25 -0
  274. package/e2e/utils/objects.ts +36 -0
  275. package/fabric.ts +72 -0
  276. package/index.node.ts +43 -0
  277. package/index.ts +1 -0
  278. package/jest.config.js +194 -0
  279. package/lib/aligning_guidelines.js +2 -2
  280. package/package.json +110 -40
  281. package/playwright.config.ts +64 -0
  282. package/publish.js +0 -26
  283. package/rollup.config.mjs +99 -0
  284. package/rollup.test.config.js +24 -0
  285. package/scripts/build.mjs +50 -0
  286. package/scripts/buildLock.mjs +115 -0
  287. package/scripts/buildReporter.mjs +15 -0
  288. package/scripts/buildStats.mjs +139 -0
  289. package/scripts/dirname.mjs +14 -0
  290. package/scripts/git.mjs +36 -0
  291. package/scripts/index.mjs +564 -0
  292. package/scripts/sandbox.mjs +149 -0
  293. package/src/ClassRegistry.ts +56 -0
  294. package/src/Collection.ts +346 -0
  295. package/src/CommonMethods.ts +63 -0
  296. package/src/EventTypeDefs.ts +298 -0
  297. package/src/Intersection.ts +302 -0
  298. package/src/Observable.ts +181 -0
  299. package/src/Pattern/Pattern.ts +207 -0
  300. package/src/Pattern/index.ts +2 -0
  301. package/src/Pattern/types.ts +17 -0
  302. package/src/Point.ts +388 -0
  303. package/src/Shadow.ts +214 -0
  304. package/src/brushes/{base_brush.class.js → BaseBrush.ts} +63 -42
  305. package/src/brushes/CircleBrush.test.ts +11 -0
  306. package/src/brushes/CircleBrush.ts +140 -0
  307. package/src/brushes/PatternBrush.ts +70 -0
  308. package/src/brushes/PencilBrush.ts +300 -0
  309. package/src/brushes/SprayBrush.ts +214 -0
  310. package/src/brushes/typedefs.ts +18 -0
  311. package/src/cache.ts +90 -0
  312. package/src/canvas/Canvas.ts +1598 -0
  313. package/src/canvas/DOMManagers/CanvasDOMManager.ts +124 -0
  314. package/src/canvas/DOMManagers/StaticCanvasDOMManager.ts +80 -0
  315. package/src/canvas/DOMManagers/util.spec.ts +26 -0
  316. package/src/canvas/DOMManagers/util.ts +98 -0
  317. package/src/canvas/SelectableCanvas.ts +1506 -0
  318. package/src/canvas/StaticCanvas.ts +1634 -0
  319. package/src/canvas/TextEditingManager.ts +70 -0
  320. package/src/canvas/canvas_gestures.mixin.ts +207 -0
  321. package/src/color/Color.ts +320 -0
  322. package/src/color/color_map.ts +154 -0
  323. package/src/color/constants.ts +107 -0
  324. package/src/color/typedefs.ts +18 -0
  325. package/src/color/util.ts +93 -0
  326. package/src/config.ts +159 -0
  327. package/src/constants.ts +29 -0
  328. package/src/controls/Control.ts +385 -0
  329. package/src/controls/changeWidth.ts +53 -0
  330. package/src/controls/commonControls.ts +105 -0
  331. package/src/controls/controlRendering.ts +138 -0
  332. package/src/controls/drag.ts +32 -0
  333. package/src/controls/fireEvent.ts +18 -0
  334. package/src/controls/index.ts +22 -0
  335. package/src/controls/polyControl.ts +135 -0
  336. package/src/controls/rotate.ts +87 -0
  337. package/src/controls/scale.ts +277 -0
  338. package/src/controls/scaleSkew.ts +92 -0
  339. package/src/controls/skew.ts +243 -0
  340. package/src/controls/util.ts +155 -0
  341. package/src/controls/wrapWithFireEvent.ts +25 -0
  342. package/src/controls/wrapWithFixedAnchor.ts +20 -0
  343. package/src/env/browser.ts +32 -0
  344. package/src/env/index.ts +38 -0
  345. package/src/env/node.ts +58 -0
  346. package/src/env/types.ts +15 -0
  347. package/src/filters/{base_filter.class.js → BaseFilter.ts} +203 -151
  348. package/src/filters/BlendColor.ts +219 -0
  349. package/src/filters/BlendImage.ts +230 -0
  350. package/src/filters/Blur.ts +181 -0
  351. package/src/filters/Boilerplate.ts +94 -0
  352. package/src/filters/Brightness.ts +85 -0
  353. package/src/filters/Canvas2dFilterBackend.ts +65 -0
  354. package/src/filters/ColorMatrix.ts +147 -0
  355. package/src/filters/ColorMatrixFilters.ts +79 -0
  356. package/src/filters/Composed.ts +78 -0
  357. package/src/filters/Contrast.ts +84 -0
  358. package/src/filters/Convolute.ts +186 -0
  359. package/src/filters/FilterBackend.ts +38 -0
  360. package/src/filters/GLProbes/GLProbe.ts +7 -0
  361. package/src/filters/GLProbes/NodeGLProbe.ts +15 -0
  362. package/src/filters/GLProbes/WebGLProbe.ts +47 -0
  363. package/src/filters/Gamma.ts +112 -0
  364. package/src/filters/Grayscale.ts +104 -0
  365. package/src/filters/HueRotation.ts +64 -0
  366. package/src/filters/Invert.ts +101 -0
  367. package/src/filters/Noise.ts +96 -0
  368. package/src/filters/Pixelate.ts +98 -0
  369. package/src/filters/RemoveColor.ts +137 -0
  370. package/src/filters/Resize.ts +540 -0
  371. package/src/filters/Saturation.ts +89 -0
  372. package/src/filters/Vibrance.ts +90 -0
  373. package/src/filters/WebGLFilterBackend.ts +456 -0
  374. package/src/filters/filters.ts +28 -0
  375. package/src/filters/index.ts +12 -0
  376. package/src/filters/shaders/baseFilter.ts +17 -0
  377. package/src/filters/shaders/blendColor.ts +33 -0
  378. package/src/filters/shaders/blendImage.ts +32 -0
  379. package/src/filters/shaders/blur.ts +24 -0
  380. package/src/filters/shaders/brightness.ts +11 -0
  381. package/src/filters/shaders/colorMatrix.ts +12 -0
  382. package/src/filters/shaders/constrast.ts +11 -0
  383. package/src/filters/shaders/convolute.ts +154 -0
  384. package/src/filters/shaders/gamma.ts +15 -0
  385. package/src/filters/shaders/grayscale.ts +36 -0
  386. package/src/filters/shaders/invert.ts +19 -0
  387. package/src/filters/shaders/noise.ts +16 -0
  388. package/src/filters/shaders/pixelate.ts +19 -0
  389. package/src/filters/shaders/removeColor.ts +13 -0
  390. package/src/filters/shaders/saturation.ts +15 -0
  391. package/src/filters/shaders/vibrance.ts +16 -0
  392. package/src/filters/typedefs.ts +59 -0
  393. package/src/filters/utils.ts +7 -0
  394. package/src/gradient/Gradient.ts +409 -0
  395. package/src/gradient/constants.ts +12 -0
  396. package/src/gradient/index.ts +2 -0
  397. package/src/gradient/parser/index.ts +3 -0
  398. package/src/gradient/parser/misc.ts +13 -0
  399. package/src/gradient/parser/parseColorStops.ts +56 -0
  400. package/src/gradient/parser/parseCoords.ts +73 -0
  401. package/src/gradient/typedefs.ts +104 -0
  402. package/src/mixins/{eraser_brush.mixin.js → eraser_brush.mixin.ts} +350 -239
  403. package/src/parkinglot/canvas_animation.mixin.ts +121 -0
  404. package/src/parkinglot/straighten.ts +58 -0
  405. package/src/parser/applyViewboxTransform.ts +158 -0
  406. package/src/parser/attributes.ts +25 -0
  407. package/src/parser/constants.ts +116 -0
  408. package/src/parser/doesSomeParentMatch.ts +18 -0
  409. package/src/parser/elementById.ts +21 -0
  410. package/src/parser/elementMatchesRule.ts +16 -0
  411. package/src/parser/elements_parser.ts +158 -0
  412. package/src/parser/getCSSRules.ts +61 -0
  413. package/src/parser/getGlobalStylesForElement.ts +19 -0
  414. package/src/parser/getGradientDefs.ts +31 -0
  415. package/src/parser/getMultipleNodes.ts +15 -0
  416. package/src/parser/getSvgRegex.ts +3 -0
  417. package/src/parser/hasAncestorWithNodeName.ts +14 -0
  418. package/src/parser/index.ts +8 -0
  419. package/src/parser/loadSVGFromString.ts +29 -0
  420. package/src/parser/loadSVGFromURL.ts +47 -0
  421. package/src/parser/normalizeAttr.ts +10 -0
  422. package/src/parser/normalizeValue.ts +64 -0
  423. package/src/parser/parseAttributes.ts +90 -0
  424. package/src/parser/parseFontDeclaration.ts +44 -0
  425. package/src/parser/parsePointsAttribute.ts +34 -0
  426. package/src/parser/parseSVGDocument.ts +118 -0
  427. package/src/parser/parseStyleAttribute.ts +27 -0
  428. package/src/parser/parseStyleObject.ts +15 -0
  429. package/src/parser/parseStyleString.ts +16 -0
  430. package/src/parser/parseTransformAttribute.ts +94 -0
  431. package/src/parser/parseUseDirectives.ts +78 -0
  432. package/src/parser/percent.ts +27 -0
  433. package/src/parser/recursivelyParseGradientsXlink.ts +42 -0
  434. package/src/parser/selectorMatches.ts +25 -0
  435. package/src/parser/setStrokeFillOpacity.ts +40 -0
  436. package/src/parser/typedefs.ts +13 -0
  437. package/src/shapes/ActiveSelection.ts +192 -0
  438. package/src/shapes/Circle.ts +236 -0
  439. package/src/shapes/Ellipse.ts +177 -0
  440. package/src/shapes/Group.ts +1103 -0
  441. package/src/shapes/IText/DraggableTextDelegate.ts +385 -0
  442. package/src/shapes/IText/IText.ts +696 -0
  443. package/src/shapes/IText/ITextBehavior.ts +1073 -0
  444. package/src/shapes/IText/ITextClickBehavior.ts +292 -0
  445. package/src/shapes/IText/ITextKeyBehavior.ts +675 -0
  446. package/src/shapes/IText/constants.ts +53 -0
  447. package/src/shapes/Image.ts +848 -0
  448. package/src/shapes/Line.ts +285 -0
  449. package/src/shapes/Object/AnimatableObject.ts +103 -0
  450. package/src/shapes/Object/FabricObject.ts +29 -0
  451. package/src/shapes/Object/FabricObjectSVGExportMixin.ts +278 -0
  452. package/src/shapes/Object/InteractiveObject.ts +669 -0
  453. package/src/shapes/Object/Object.ts +1589 -0
  454. package/src/shapes/Object/ObjectGeometry.ts +814 -0
  455. package/src/shapes/Object/ObjectOrigin.ts +277 -0
  456. package/src/shapes/Object/StackedObject.ts +206 -0
  457. package/src/shapes/Object/defaultValues.ts +110 -0
  458. package/src/shapes/Object/types/BaseProps.ts +96 -0
  459. package/src/shapes/Object/types/BorderProps.ts +40 -0
  460. package/src/shapes/Object/types/ControlProps.ts +69 -0
  461. package/src/shapes/Object/types/FabricObjectProps.ts +111 -0
  462. package/src/shapes/Object/types/FillStrokeProps.ts +90 -0
  463. package/src/shapes/Object/types/LockInteractionProps.ts +57 -0
  464. package/src/shapes/Object/types/ObjectProps.ts +49 -0
  465. package/src/shapes/Object/types/SerializedObjectProps.ts +73 -0
  466. package/src/shapes/Object/types/index.ts +8 -0
  467. package/src/shapes/Path.ts +434 -0
  468. package/src/shapes/Polygon.ts +22 -0
  469. package/src/shapes/Polyline.ts +364 -0
  470. package/src/shapes/Rect.ts +230 -0
  471. package/src/shapes/Text/StyledText.ts +323 -0
  472. package/src/shapes/Text/Text.ts +1891 -0
  473. package/src/shapes/Text/TextSVGExportMixin.ts +289 -0
  474. package/src/shapes/Text/constants.ts +111 -0
  475. package/src/shapes/Textbox.ts +526 -0
  476. package/src/shapes/Triangle.ts +62 -0
  477. package/src/typedefs.ts +121 -0
  478. package/src/util/animation/AnimationBase.ts +166 -0
  479. package/src/util/animation/AnimationFrameProvider.ts +9 -0
  480. package/src/util/animation/AnimationRegistry.ts +58 -0
  481. package/src/util/animation/ArrayAnimation.ts +27 -0
  482. package/src/util/animation/ColorAnimation.ts +74 -0
  483. package/src/util/animation/ValueAnimation.ts +29 -0
  484. package/src/util/animation/animate.ts +74 -0
  485. package/src/util/animation/easing.ts +327 -0
  486. package/src/util/animation/index.ts +2 -0
  487. package/src/util/animation/types.ts +136 -0
  488. package/src/util/applyMixins.ts +22 -0
  489. package/src/util/dom_event.ts +28 -0
  490. package/src/util/dom_misc.ts +44 -0
  491. package/src/util/dom_request.ts +64 -0
  492. package/src/util/dom_style.ts +20 -0
  493. package/src/util/index.ts +106 -0
  494. package/src/util/internals/cleanupSvgAttribute.test.ts +16 -0
  495. package/src/util/internals/cleanupSvgAttribute.ts +8 -0
  496. package/src/util/internals/cloneDeep.test.ts +16 -0
  497. package/src/util/internals/cloneDeep.ts +2 -0
  498. package/src/util/internals/getRandomInt.test.ts +33 -0
  499. package/src/util/internals/getRandomInt.ts +8 -0
  500. package/src/util/internals/ifNaN.ts +9 -0
  501. package/src/util/internals/index.ts +3 -0
  502. package/src/util/internals/removeFromArray.ts +14 -0
  503. package/src/util/internals/uid.ts +3 -0
  504. package/src/util/lang_string.ts +79 -0
  505. package/src/util/misc/boundingBoxFromPoints.ts +38 -0
  506. package/src/util/misc/capValue.ts +2 -0
  507. package/src/util/misc/cos.ts +24 -0
  508. package/src/util/misc/dom.ts +55 -0
  509. package/src/util/misc/findScaleTo.ts +29 -0
  510. package/src/util/misc/groupSVGElements.ts +15 -0
  511. package/src/util/misc/isTransparent.ts +28 -0
  512. package/src/util/misc/matrix.ts +313 -0
  513. package/src/util/misc/mergeClipPaths.ts +40 -0
  514. package/src/util/misc/objectEnlive.ts +174 -0
  515. package/src/util/misc/objectTransforms.ts +130 -0
  516. package/src/util/misc/pick.ts +29 -0
  517. package/src/util/misc/planeChange.ts +127 -0
  518. package/src/util/misc/projectStroke/StrokeLineCapProjections.ts +113 -0
  519. package/src/util/misc/projectStroke/StrokeLineJoinProjections.ts +227 -0
  520. package/src/util/misc/projectStroke/StrokeProjectionsBase.ts +76 -0
  521. package/src/util/misc/projectStroke/index.ts +55 -0
  522. package/src/util/misc/projectStroke/types.ts +24 -0
  523. package/src/util/misc/radiansDegreesConversion.ts +18 -0
  524. package/src/util/misc/resolveOrigin.ts +22 -0
  525. package/src/util/misc/rotatePoint.ts +15 -0
  526. package/src/util/misc/sin.ts +26 -0
  527. package/src/util/misc/svgParsing.ts +171 -0
  528. package/src/util/misc/textStyles.ts +132 -0
  529. package/src/util/misc/toFixed.ts +8 -0
  530. package/src/util/misc/vectors.ts +83 -0
  531. package/src/util/path/index.ts +1039 -0
  532. package/src/util/path/regex.ts +39 -0
  533. package/src/util/path/typechecks.ts +145 -0
  534. package/src/util/path/typedefs.ts +305 -0
  535. package/src/util/transform_matrix_removal.ts +61 -0
  536. package/src/util/typeAssertions.ts +78 -0
  537. package/tsconfig.json +106 -0
  538. package/HEADER.js +0 -203
  539. package/build.js +0 -287
  540. package/dist/fabric.js +0 -31187
  541. package/dist/fabric.min.js +0 -1
  542. package/old-travis-reference.yml +0 -97
  543. package/src/brushes/circle_brush.class.js +0 -144
  544. package/src/brushes/pattern_brush.class.js +0 -61
  545. package/src/brushes/pencil_brush.class.js +0 -310
  546. package/src/brushes/spray_brush.class.js +0 -219
  547. package/src/canvas.class.js +0 -1312
  548. package/src/color.class.js +0 -636
  549. package/src/control.class.js +0 -339
  550. package/src/controls.actions.js +0 -740
  551. package/src/controls.render.js +0 -99
  552. package/src/elements_parser.js +0 -152
  553. package/src/filters/2d_backend.class.js +0 -65
  554. package/src/filters/blendcolor_filter.class.js +0 -251
  555. package/src/filters/blendimage_filter.class.js +0 -247
  556. package/src/filters/blur_filter.class.js +0 -217
  557. package/src/filters/brightness_filter.class.js +0 -113
  558. package/src/filters/colormatrix_filter.class.js +0 -159
  559. package/src/filters/composed_filter.class.js +0 -72
  560. package/src/filters/contrast_filter.class.js +0 -113
  561. package/src/filters/convolute_filter.class.js +0 -352
  562. package/src/filters/filter_boilerplate.js +0 -111
  563. package/src/filters/filter_generator.js +0 -85
  564. package/src/filters/gamma_filter.class.js +0 -136
  565. package/src/filters/grayscale_filter.class.js +0 -154
  566. package/src/filters/hue_rotation.class.js +0 -107
  567. package/src/filters/invert_filter.class.js +0 -111
  568. package/src/filters/noise_filter.class.js +0 -134
  569. package/src/filters/pixelate_filter.class.js +0 -137
  570. package/src/filters/removecolor_filter.class.js +0 -173
  571. package/src/filters/resize_filter.class.js +0 -490
  572. package/src/filters/saturate_filter.class.js +0 -119
  573. package/src/filters/vibrance_filter.class.js +0 -122
  574. package/src/filters/webgl_backend.class.js +0 -396
  575. package/src/globalFabric.js +0 -4
  576. package/src/gradient.class.js +0 -490
  577. package/src/intersection.class.js +0 -172
  578. package/src/log.js +0 -11
  579. package/src/mixins/animation.mixin.js +0 -231
  580. package/src/mixins/canvas_dataurl_exporter.mixin.js +0 -97
  581. package/src/mixins/canvas_events.mixin.js +0 -974
  582. package/src/mixins/canvas_gestures.mixin.js +0 -149
  583. package/src/mixins/canvas_grouping.mixin.js +0 -177
  584. package/src/mixins/canvas_serialization.mixin.js +0 -228
  585. package/src/mixins/collection.mixin.js +0 -170
  586. package/src/mixins/default_controls.js +0 -114
  587. package/src/mixins/itext.svg_export.js +0 -241
  588. package/src/mixins/itext_behavior.mixin.js +0 -940
  589. package/src/mixins/itext_click_behavior.mixin.js +0 -278
  590. package/src/mixins/itext_key_behavior.mixin.js +0 -694
  591. package/src/mixins/object.svg_export.js +0 -258
  592. package/src/mixins/object_geometry.mixin.js +0 -683
  593. package/src/mixins/object_interactivity.mixin.js +0 -314
  594. package/src/mixins/object_origin.mixin.js +0 -255
  595. package/src/mixins/object_stacking.mixin.js +0 -80
  596. package/src/mixins/object_straightening.mixin.js +0 -80
  597. package/src/mixins/observable.mixin.js +0 -141
  598. package/src/mixins/shared_methods.mixin.js +0 -94
  599. package/src/mixins/stateful.mixin.js +0 -107
  600. package/src/mixins/text_style.mixin.js +0 -324
  601. package/src/parser.js +0 -1090
  602. package/src/pattern.class.js +0 -189
  603. package/src/point.class.js +0 -337
  604. package/src/shadow.class.js +0 -195
  605. package/src/shapes/active_selection.class.js +0 -155
  606. package/src/shapes/circle.class.js +0 -210
  607. package/src/shapes/ellipse.class.js +0 -181
  608. package/src/shapes/group.class.js +0 -593
  609. package/src/shapes/image.class.js +0 -764
  610. package/src/shapes/itext.class.js +0 -526
  611. package/src/shapes/line.class.js +0 -324
  612. package/src/shapes/object.class.js +0 -2008
  613. package/src/shapes/path.class.js +0 -384
  614. package/src/shapes/polygon.class.js +0 -81
  615. package/src/shapes/polyline.class.js +0 -268
  616. package/src/shapes/rect.class.js +0 -187
  617. package/src/shapes/text.class.js +0 -1696
  618. package/src/shapes/textbox.class.js +0 -461
  619. package/src/shapes/triangle.class.js +0 -93
  620. package/src/static_canvas.class.js +0 -1881
  621. package/src/util/anim_ease.js +0 -398
  622. package/src/util/animate.js +0 -254
  623. package/src/util/animate_color.js +0 -74
  624. package/src/util/dom_event.js +0 -50
  625. package/src/util/dom_misc.js +0 -300
  626. package/src/util/dom_request.js +0 -54
  627. package/src/util/dom_style.js +0 -70
  628. package/src/util/lang_array.js +0 -94
  629. package/src/util/lang_class.js +0 -115
  630. package/src/util/lang_object.js +0 -75
  631. package/src/util/lang_string.js +0 -110
  632. package/src/util/misc.js +0 -1330
  633. package/src/util/named_accessors.mixin.js +0 -428
  634. package/src/util/path.js +0 -829
@@ -0,0 +1,1598 @@
1
+ import { LEFT_CLICK, MIDDLE_CLICK, NONE, RIGHT_CLICK } from '../constants';
2
+ import type {
3
+ CanvasEvents,
4
+ DragEventData,
5
+ ObjectEvents,
6
+ TPointerEvent,
7
+ TPointerEventInfo,
8
+ TPointerEventNames,
9
+ Transform,
10
+ } from '../EventTypeDefs';
11
+ import { Point } from '../Point';
12
+ import type { Group } from '../shapes/Group';
13
+ import type { IText } from '../shapes/IText/IText';
14
+ import type { FabricObject } from '../shapes/Object/FabricObject';
15
+ import { isTouchEvent, stopEvent } from '../util/dom_event';
16
+ import { getDocumentFromElement, getWindowFromElement } from '../util/dom_misc';
17
+ import { sendPointToPlane } from '../util/misc/planeChange';
18
+ import {
19
+ isFabricObjectWithDragSupport,
20
+ isInteractiveTextObject,
21
+ } from '../util/typeAssertions';
22
+ import { SelectableCanvas } from './SelectableCanvas';
23
+ import { TextEditingManager } from './TextEditingManager';
24
+
25
+ const addEventOptions = { passive: false } as EventListenerOptions;
26
+
27
+ function checkClick(e: TPointerEvent, value: number) {
28
+ return !!(e as MouseEvent).button && (e as MouseEvent).button === value - 1;
29
+ }
30
+
31
+ // just to be clear, the utils are now deprecated and those are here exactly as minifier helpers
32
+ // because el.addEventListener can't me be minified while a const yes and we use it 47 times in this file.
33
+ // few bytes but why give it away.
34
+ const addListener = (
35
+ el: HTMLElement | Document,
36
+ ...args: Parameters<HTMLElement['addEventListener']>
37
+ ) => el.addEventListener(...args);
38
+ const removeListener = (
39
+ el: HTMLElement | Document,
40
+ ...args: Parameters<HTMLElement['removeEventListener']>
41
+ ) => el.removeEventListener(...args);
42
+
43
+ const syntheticEventConfig = {
44
+ mouse: {
45
+ in: 'over',
46
+ out: 'out',
47
+ targetIn: 'mouseover',
48
+ targetOut: 'mouseout',
49
+ canvasIn: 'mouse:over',
50
+ canvasOut: 'mouse:out',
51
+ },
52
+ drag: {
53
+ in: 'enter',
54
+ out: 'leave',
55
+ targetIn: 'dragenter',
56
+ targetOut: 'dragleave',
57
+ canvasIn: 'drag:enter',
58
+ canvasOut: 'drag:leave',
59
+ },
60
+ } as const;
61
+
62
+ type TSyntheticEventContext = {
63
+ mouse: { e: TPointerEvent };
64
+ drag: DragEventData;
65
+ };
66
+
67
+ export class Canvas extends SelectableCanvas {
68
+ /**
69
+ * Contains the id of the touch event that owns the fabric transform
70
+ * @type Number
71
+ * @private
72
+ */
73
+ declare mainTouchId: null | number;
74
+
75
+ /**
76
+ * When the option is enabled, PointerEvent is used instead of TPointerEvent.
77
+ * @type Boolean
78
+ * @default
79
+ */
80
+ declare enablePointerEvents: boolean;
81
+
82
+ /**
83
+ * Holds a reference to a setTimeout timer for event synchronization
84
+ * @type number
85
+ * @private
86
+ */
87
+ private declare _willAddMouseDown: number;
88
+
89
+ /**
90
+ * Holds a reference to an object on the canvas that is receiving the drag over event.
91
+ * @type FabricObject
92
+ * @private
93
+ */
94
+ private declare _draggedoverTarget?: FabricObject;
95
+
96
+ /**
97
+ * Holds a reference to an object on the canvas from where the drag operation started
98
+ * @type FabricObject
99
+ * @private
100
+ */
101
+ private declare _dragSource?: FabricObject;
102
+
103
+ /**
104
+ * Holds a reference to an object on the canvas that is the current drop target
105
+ * May differ from {@link _draggedoverTarget}
106
+ * @todo inspect whether {@link _draggedoverTarget} and {@link _dropTarget} should be merged somehow
107
+ * @type FabricObject
108
+ * @private
109
+ */
110
+ private declare _dropTarget: FabricObject<ObjectEvents> | undefined;
111
+
112
+ declare currentTarget?: FabricObject;
113
+
114
+ declare currentSubTargets?: FabricObject[];
115
+
116
+ private _isClick: boolean;
117
+
118
+ textEditingManager = new TextEditingManager(this);
119
+
120
+ constructor(el: string | HTMLCanvasElement, options = {}) {
121
+ super(el, options);
122
+ // bind event handlers
123
+ (
124
+ [
125
+ '_onMouseDown',
126
+ '_onTouchStart',
127
+ '_onMouseMove',
128
+ '_onMouseUp',
129
+ '_onTouchEnd',
130
+ '_onResize',
131
+ // '_onGesture',
132
+ // '_onDrag',
133
+ // '_onShake',
134
+ // '_onLongPress',
135
+ // '_onOrientationChange',
136
+ '_onMouseWheel',
137
+ '_onMouseOut',
138
+ '_onMouseEnter',
139
+ '_onContextMenu',
140
+ '_onDoubleClick',
141
+ '_onDragStart',
142
+ '_onDragEnd',
143
+ '_onDragProgress',
144
+ '_onDragOver',
145
+ '_onDragEnter',
146
+ '_onDragLeave',
147
+ '_onDrop',
148
+ ] as (keyof this)[]
149
+ ).forEach((eventHandler) => {
150
+ this[eventHandler] = (this[eventHandler] as Function).bind(this);
151
+ });
152
+ // register event handlers
153
+ this.addOrRemove(addListener, 'add');
154
+ }
155
+
156
+ /**
157
+ * return an event prefix pointer or mouse.
158
+ * @private
159
+ */
160
+ private _getEventPrefix() {
161
+ return this.enablePointerEvents ? 'pointer' : 'mouse';
162
+ }
163
+
164
+ addOrRemove(functor: any, eventjsFunctor: 'add' | 'remove') {
165
+ const canvasElement = this.upperCanvasEl,
166
+ eventTypePrefix = this._getEventPrefix();
167
+ functor(getWindowFromElement(canvasElement), 'resize', this._onResize);
168
+ functor(canvasElement, eventTypePrefix + 'down', this._onMouseDown);
169
+ functor(
170
+ canvasElement,
171
+ `${eventTypePrefix}move`,
172
+ this._onMouseMove,
173
+ addEventOptions
174
+ );
175
+ functor(canvasElement, `${eventTypePrefix}out`, this._onMouseOut);
176
+ functor(canvasElement, `${eventTypePrefix}enter`, this._onMouseEnter);
177
+ functor(canvasElement, 'wheel', this._onMouseWheel);
178
+ functor(canvasElement, 'contextmenu', this._onContextMenu);
179
+ functor(canvasElement, 'dblclick', this._onDoubleClick);
180
+ functor(canvasElement, 'dragstart', this._onDragStart);
181
+ functor(canvasElement, 'dragend', this._onDragEnd);
182
+ functor(canvasElement, 'dragover', this._onDragOver);
183
+ functor(canvasElement, 'dragenter', this._onDragEnter);
184
+ functor(canvasElement, 'dragleave', this._onDragLeave);
185
+ functor(canvasElement, 'drop', this._onDrop);
186
+ if (!this.enablePointerEvents) {
187
+ functor(canvasElement, 'touchstart', this._onTouchStart, addEventOptions);
188
+ }
189
+ // if (typeof eventjs !== 'undefined' && eventjsFunctor in eventjs) {
190
+ // eventjs[eventjsFunctor](canvasElement, 'gesture', this._onGesture);
191
+ // eventjs[eventjsFunctor](canvasElement, 'drag', this._onDrag);
192
+ // eventjs[eventjsFunctor](
193
+ // canvasElement,
194
+ // 'orientation',
195
+ // this._onOrientationChange
196
+ // );
197
+ // eventjs[eventjsFunctor](canvasElement, 'shake', this._onShake);
198
+ // eventjs[eventjsFunctor](canvasElement, 'longpress', this._onLongPress);
199
+ // }
200
+ }
201
+
202
+ /**
203
+ * Removes all event listeners
204
+ */
205
+ removeListeners() {
206
+ this.addOrRemove(removeListener, 'remove');
207
+ // if you dispose on a mouseDown, before mouse up, you need to clean document to...
208
+ const eventTypePrefix = this._getEventPrefix();
209
+ const doc = getDocumentFromElement(this.upperCanvasEl);
210
+ removeListener(
211
+ doc,
212
+ `${eventTypePrefix}up`,
213
+ this._onMouseUp as EventListener
214
+ );
215
+ removeListener(
216
+ doc,
217
+ 'touchend',
218
+ this._onTouchEnd as EventListener,
219
+ addEventOptions
220
+ );
221
+ removeListener(
222
+ doc,
223
+ `${eventTypePrefix}move`,
224
+ this._onMouseMove as EventListener,
225
+ addEventOptions
226
+ );
227
+ removeListener(
228
+ doc,
229
+ 'touchmove',
230
+ this._onMouseMove as EventListener,
231
+ addEventOptions
232
+ );
233
+ }
234
+
235
+ /**
236
+ * @private
237
+ * @param {Event} [e] Event object fired on wheel event
238
+ */
239
+ private _onMouseWheel(e: MouseEvent) {
240
+ this.__onMouseWheel(e);
241
+ }
242
+
243
+ /**
244
+ * @private
245
+ * @param {Event} e Event object fired on mousedown
246
+ */
247
+ private _onMouseOut(e: TPointerEvent) {
248
+ const target = this._hoveredTarget;
249
+ const shared = {
250
+ e,
251
+ isClick: false,
252
+ pointer: this.getPointer(e),
253
+ absolutePointer: this.getPointer(e, true),
254
+ };
255
+ this.fire('mouse:out', { ...shared, target });
256
+ this._hoveredTarget = undefined;
257
+ target && target.fire('mouseout', { ...shared });
258
+ this._hoveredTargets.forEach((nestedTarget) => {
259
+ this.fire('mouse:out', { ...shared, target: nestedTarget });
260
+ nestedTarget && nestedTarget.fire('mouseout', { ...shared });
261
+ });
262
+ this._hoveredTargets = [];
263
+ }
264
+
265
+ /**
266
+ * @private
267
+ * @param {Event} e Event object fired on mouseenter
268
+ */
269
+ private _onMouseEnter(e: TPointerEvent) {
270
+ // This find target and consequent 'mouse:over' is used to
271
+ // clear old instances on hovered target.
272
+ // calling findTarget has the side effect of killing target.__corner.
273
+ // as a short term fix we are not firing this if we are currently transforming.
274
+ // as a long term fix we need to separate the action of finding a target with the
275
+ // side effects we added to it.
276
+ if (!this._currentTransform && !this.findTarget(e)) {
277
+ this.fire('mouse:over', {
278
+ e,
279
+ isClick: false,
280
+ pointer: this.getPointer(e),
281
+ absolutePointer: this.getPointer(e, true),
282
+ });
283
+ this._hoveredTarget = undefined;
284
+ this._hoveredTargets = [];
285
+ }
286
+ }
287
+
288
+ /**
289
+ * supports native like text dragging
290
+ * @private
291
+ * @param {DragEvent} e
292
+ */
293
+ private _onDragStart(e: DragEvent) {
294
+ this._isClick = false;
295
+ const activeObject = this.getActiveObject();
296
+ if (
297
+ isFabricObjectWithDragSupport(activeObject) &&
298
+ activeObject.onDragStart(e)
299
+ ) {
300
+ this._dragSource = activeObject;
301
+ const options = { e, target: activeObject };
302
+ this.fire('dragstart', options);
303
+ activeObject.fire('dragstart', options);
304
+ addListener(
305
+ this.upperCanvasEl,
306
+ 'drag',
307
+ this._onDragProgress as EventListener
308
+ );
309
+ return;
310
+ }
311
+ stopEvent(e);
312
+ }
313
+
314
+ /**
315
+ * First we clear top context where the effects are being rendered.
316
+ * Then we render the effects.
317
+ * Doing so will render the correct effect for all cases including an overlap between `source` and `target`.
318
+ * @private
319
+ */
320
+ private _renderDragEffects(
321
+ e: DragEvent,
322
+ source?: FabricObject,
323
+ target?: FabricObject
324
+ ) {
325
+ let dirty = false;
326
+ // clear top context
327
+ const dropTarget = this._dropTarget;
328
+ if (dropTarget && dropTarget !== source && dropTarget !== target) {
329
+ dropTarget.clearContextTop();
330
+ dirty = true;
331
+ }
332
+ source?.clearContextTop();
333
+ target !== source && target?.clearContextTop();
334
+ // render effects
335
+ const ctx = this.contextTop;
336
+ ctx.save();
337
+ ctx.transform(...this.viewportTransform);
338
+ if (source) {
339
+ ctx.save();
340
+ source.transform(ctx);
341
+ source.renderDragSourceEffect(e);
342
+ ctx.restore();
343
+ dirty = true;
344
+ }
345
+ if (target) {
346
+ ctx.save();
347
+ target.transform(ctx);
348
+ target.renderDropTargetEffect(e);
349
+ ctx.restore();
350
+ dirty = true;
351
+ }
352
+ ctx.restore();
353
+ dirty && (this.contextTopDirty = true);
354
+ }
355
+
356
+ /**
357
+ * supports native like text dragging
358
+ * https://developer.mozilla.org/en-US/docs/Web/API/HTML_Drag_and_Drop_API/Drag_operations#finishing_a_drag
359
+ * @private
360
+ * @param {DragEvent} e
361
+ */
362
+ private _onDragEnd(e: DragEvent) {
363
+ const didDrop = !!e.dataTransfer && e.dataTransfer.dropEffect !== NONE,
364
+ dropTarget = didDrop ? this._activeObject : undefined,
365
+ options = {
366
+ e,
367
+ target: this._dragSource as FabricObject,
368
+ subTargets: this.targets,
369
+ dragSource: this._dragSource as FabricObject,
370
+ didDrop,
371
+ dropTarget: dropTarget as FabricObject,
372
+ };
373
+ removeListener(
374
+ this.upperCanvasEl,
375
+ 'drag',
376
+ this._onDragProgress as EventListener
377
+ );
378
+ this.fire('dragend', options);
379
+ this._dragSource && this._dragSource.fire('dragend', options);
380
+ delete this._dragSource;
381
+ // we need to call mouse up synthetically because the browser won't
382
+ this._onMouseUp(e);
383
+ }
384
+
385
+ /**
386
+ * fire `drag` event on canvas and drag source
387
+ * @private
388
+ * @param {DragEvent} e
389
+ */
390
+ private _onDragProgress(e: DragEvent) {
391
+ const options = {
392
+ e,
393
+ target: this._dragSource as FabricObject | undefined,
394
+ dragSource: this._dragSource as FabricObject | undefined,
395
+ dropTarget: this._draggedoverTarget as FabricObject,
396
+ };
397
+ this.fire('drag', options);
398
+ this._dragSource && this._dragSource.fire('drag', options);
399
+ }
400
+
401
+ /**
402
+ * As opposed to {@link findTarget} we want the top most object to be returned w/o the active object cutting in line.
403
+ * Override at will
404
+ */
405
+ protected findDragTargets(e: DragEvent) {
406
+ this.targets = [];
407
+ const target = this._searchPossibleTargets(
408
+ this._objects,
409
+ this.getPointer(e, true)
410
+ );
411
+ return {
412
+ target,
413
+ targets: [...this.targets],
414
+ };
415
+ }
416
+
417
+ /**
418
+ * prevent default to allow drop event to be fired
419
+ * https://developer.mozilla.org/en-US/docs/Web/API/HTML_Drag_and_Drop_API/Drag_operations#specifying_drop_targets
420
+ * @private
421
+ * @param {DragEvent} [e] Event object fired on Event.js shake
422
+ */
423
+ private _onDragOver(e: DragEvent) {
424
+ const eventType = 'dragover';
425
+ const { target, targets } = this.findDragTargets(e);
426
+ const dragSource = this._dragSource as FabricObject;
427
+ const options = {
428
+ e,
429
+ target,
430
+ subTargets: targets,
431
+ dragSource,
432
+ canDrop: false,
433
+ dropTarget: undefined,
434
+ };
435
+ let dropTarget;
436
+ // fire on canvas
437
+ this.fire(eventType, options);
438
+ // make sure we fire dragenter events before dragover
439
+ // if dragleave is needed, object will not fire dragover so we don't need to trouble ourselves with it
440
+ this._fireEnterLeaveEvents(target, options);
441
+ if (target) {
442
+ if (target.canDrop(e)) {
443
+ dropTarget = target;
444
+ }
445
+ target.fire(eventType, options);
446
+ }
447
+ // propagate the event to subtargets
448
+ for (let i = 0; i < targets.length; i++) {
449
+ const subTarget = targets[i];
450
+ // accept event only if previous targets didn't (the accepting target calls `preventDefault` to inform that the event is taken)
451
+ // TODO: verify if those should loop in inverse order then?
452
+ // what is the order of subtargets?
453
+ if (subTarget.canDrop(e)) {
454
+ dropTarget = subTarget;
455
+ }
456
+ subTarget.fire(eventType, options);
457
+ }
458
+ // render drag effects now that relations between source and target is clear
459
+ this._renderDragEffects(e, dragSource, dropTarget);
460
+ this._dropTarget = dropTarget;
461
+ }
462
+
463
+ /**
464
+ * fire `dragleave` on `dragover` targets
465
+ * @private
466
+ * @param {Event} [e] Event object fired on Event.js shake
467
+ */
468
+ private _onDragEnter(e: DragEvent) {
469
+ const { target, targets } = this.findDragTargets(e);
470
+ const options = {
471
+ e,
472
+ target,
473
+ subTargets: targets,
474
+ dragSource: this._dragSource,
475
+ };
476
+ this.fire('dragenter', options);
477
+ // fire dragenter on targets
478
+ this._fireEnterLeaveEvents(target, options);
479
+ }
480
+
481
+ /**
482
+ * fire `dragleave` on `dragover` targets
483
+ * @private
484
+ * @param {Event} [e] Event object fired on Event.js shake
485
+ */
486
+ private _onDragLeave(e: DragEvent) {
487
+ const options = {
488
+ e,
489
+ target: this._draggedoverTarget,
490
+ subTargets: this.targets,
491
+ dragSource: this._dragSource,
492
+ };
493
+ this.fire('dragleave', options);
494
+
495
+ // fire dragleave on targets
496
+ this._fireEnterLeaveEvents(undefined, options);
497
+ this._renderDragEffects(e, this._dragSource);
498
+ this._dropTarget = undefined;
499
+ // clear targets
500
+ this.targets = [];
501
+ this._hoveredTargets = [];
502
+ }
503
+
504
+ /**
505
+ * `drop:before` is a an event that allows you to schedule logic
506
+ * before the `drop` event. Prefer `drop` event always, but if you need
507
+ * to run some drop-disabling logic on an event, since there is no way
508
+ * to handle event handlers ordering, use `drop:before`
509
+ * @private
510
+ * @param {Event} e
511
+ */
512
+ private _onDrop(e: DragEvent) {
513
+ const { target, targets } = this.findDragTargets(e);
514
+ const options = this._basicEventHandler('drop:before', {
515
+ e,
516
+ target,
517
+ subTargets: targets,
518
+ dragSource: this._dragSource,
519
+ pointer: this.getPointer(e),
520
+ });
521
+ // will be set by the drop target
522
+ options.didDrop = false;
523
+ // will be set by the drop target, used in case options.target refuses the drop
524
+ options.dropTarget = undefined;
525
+ // fire `drop`
526
+ this._basicEventHandler('drop', options);
527
+ // inform canvas of the drop
528
+ // we do this because canvas was unaware of what happened at the time the `drop` event was fired on it
529
+ // use for side effects
530
+ this.fire('drop:after', options);
531
+ }
532
+
533
+ /**
534
+ * @private
535
+ * @param {Event} e Event object fired on mousedown
536
+ */
537
+ private _onContextMenu(e: TPointerEvent): false {
538
+ const target = this.findTarget(e),
539
+ subTargets = this.targets || [];
540
+ const options = this._basicEventHandler('contextmenu:before', {
541
+ e,
542
+ target,
543
+ subTargets,
544
+ });
545
+ // TODO: this line is silly because the dev can subscribe to the event and prevent it themselves
546
+ this.stopContextMenu && stopEvent(e);
547
+ this._basicEventHandler('contextmenu', options);
548
+ return false;
549
+ }
550
+
551
+ /**
552
+ * @private
553
+ * @param {Event} e Event object fired on mousedown
554
+ */
555
+ private _onDoubleClick(e: TPointerEvent) {
556
+ this._cacheTransformEventData(e);
557
+ this._handleEvent(e, 'dblclick');
558
+ this._resetTransformEventData();
559
+ }
560
+
561
+ /**
562
+ * Return a the id of an event.
563
+ * returns either the pointerId or the identifier or 0 for the mouse event
564
+ * @private
565
+ * @param {Event} evt Event object
566
+ */
567
+ getPointerId(evt: TouchEvent | PointerEvent): number {
568
+ const changedTouches = (evt as TouchEvent).changedTouches;
569
+
570
+ if (changedTouches) {
571
+ return changedTouches[0] && changedTouches[0].identifier;
572
+ }
573
+
574
+ if (this.enablePointerEvents) {
575
+ return (evt as PointerEvent).pointerId;
576
+ }
577
+
578
+ return -1;
579
+ }
580
+
581
+ /**
582
+ * Determines if an event has the id of the event that is considered main
583
+ * @private
584
+ * @param {evt} event Event object
585
+ */
586
+ _isMainEvent(evt: TPointerEvent): boolean {
587
+ if ((evt as PointerEvent).isPrimary === true) {
588
+ return true;
589
+ }
590
+ if ((evt as PointerEvent).isPrimary === false) {
591
+ return false;
592
+ }
593
+ if (evt.type === 'touchend' && (evt as TouchEvent).touches.length === 0) {
594
+ return true;
595
+ }
596
+ if ((evt as TouchEvent).changedTouches) {
597
+ return (
598
+ (evt as TouchEvent).changedTouches[0].identifier === this.mainTouchId
599
+ );
600
+ }
601
+ return true;
602
+ }
603
+
604
+ /**
605
+ * @private
606
+ * @param {Event} e Event object fired on mousedown
607
+ */
608
+ _onTouchStart(e: TouchEvent) {
609
+ e.preventDefault();
610
+ if (this.mainTouchId === null) {
611
+ this.mainTouchId = this.getPointerId(e);
612
+ }
613
+ this.__onMouseDown(e);
614
+ this._resetTransformEventData();
615
+ const canvasElement = this.upperCanvasEl,
616
+ eventTypePrefix = this._getEventPrefix();
617
+ const doc = getDocumentFromElement(canvasElement);
618
+ addListener(
619
+ doc,
620
+ 'touchend',
621
+ this._onTouchEnd as EventListener,
622
+ addEventOptions
623
+ );
624
+ addListener(
625
+ doc,
626
+ 'touchmove',
627
+ this._onMouseMove as EventListener,
628
+ addEventOptions
629
+ );
630
+ // Unbind mousedown to prevent double triggers from touch devices
631
+ removeListener(
632
+ canvasElement,
633
+ `${eventTypePrefix}down`,
634
+ this._onMouseDown as EventListener
635
+ );
636
+ }
637
+
638
+ /**
639
+ * @private
640
+ * @param {Event} e Event object fired on mousedown
641
+ */
642
+ _onMouseDown(e: TPointerEvent) {
643
+ this.__onMouseDown(e);
644
+ this._resetTransformEventData();
645
+ const canvasElement = this.upperCanvasEl,
646
+ eventTypePrefix = this._getEventPrefix();
647
+ removeListener(
648
+ canvasElement,
649
+ `${eventTypePrefix}move`,
650
+ this._onMouseMove as EventListener,
651
+ addEventOptions
652
+ );
653
+ const doc = getDocumentFromElement(canvasElement);
654
+ addListener(doc, `${eventTypePrefix}up`, this._onMouseUp as EventListener);
655
+ addListener(
656
+ doc,
657
+ `${eventTypePrefix}move`,
658
+ this._onMouseMove as EventListener,
659
+ addEventOptions
660
+ );
661
+ }
662
+
663
+ /**
664
+ * @private
665
+ * @param {Event} e Event object fired on mousedown
666
+ */
667
+ _onTouchEnd(e: TouchEvent) {
668
+ if (e.touches.length > 0) {
669
+ // if there are still touches stop here
670
+ return;
671
+ }
672
+ this.__onMouseUp(e);
673
+ this._resetTransformEventData();
674
+ this.mainTouchId = null;
675
+ const eventTypePrefix = this._getEventPrefix();
676
+ const doc = getDocumentFromElement(this.upperCanvasEl);
677
+ removeListener(
678
+ doc,
679
+ 'touchend',
680
+ this._onTouchEnd as EventListener,
681
+ addEventOptions
682
+ );
683
+ removeListener(
684
+ doc,
685
+ 'touchmove',
686
+ this._onMouseMove as EventListener,
687
+ addEventOptions
688
+ );
689
+ if (this._willAddMouseDown) {
690
+ clearTimeout(this._willAddMouseDown);
691
+ }
692
+ this._willAddMouseDown = setTimeout(() => {
693
+ // Wait 400ms before rebinding mousedown to prevent double triggers
694
+ // from touch devices
695
+ addListener(
696
+ this.upperCanvasEl,
697
+ `${eventTypePrefix}down`,
698
+ this._onMouseDown as EventListener
699
+ );
700
+ this._willAddMouseDown = 0;
701
+ }, 400) as unknown as number;
702
+ }
703
+
704
+ /**
705
+ * @private
706
+ * @param {Event} e Event object fired on mouseup
707
+ */
708
+ _onMouseUp(e: TPointerEvent) {
709
+ this.__onMouseUp(e);
710
+ this._resetTransformEventData();
711
+ const canvasElement = this.upperCanvasEl,
712
+ eventTypePrefix = this._getEventPrefix();
713
+ if (this._isMainEvent(e)) {
714
+ const doc = getDocumentFromElement(this.upperCanvasEl);
715
+ removeListener(
716
+ doc,
717
+ `${eventTypePrefix}up`,
718
+ this._onMouseUp as EventListener
719
+ );
720
+ removeListener(
721
+ doc,
722
+ `${eventTypePrefix}move`,
723
+ this._onMouseMove as EventListener,
724
+ addEventOptions
725
+ );
726
+ addListener(
727
+ canvasElement,
728
+ `${eventTypePrefix}move`,
729
+ this._onMouseMove as EventListener,
730
+ addEventOptions
731
+ );
732
+ }
733
+ }
734
+
735
+ /**
736
+ * @private
737
+ * @param {Event} e Event object fired on mousemove
738
+ */
739
+ _onMouseMove(e: TPointerEvent) {
740
+ const activeObject = this.getActiveObject();
741
+ !this.allowTouchScrolling &&
742
+ (!activeObject ||
743
+ // a drag event sequence is started by the active object flagging itself on mousedown / mousedown:before
744
+ // we must not prevent the event's default behavior in order for the window to start dragging
745
+ (isFabricObjectWithDragSupport(activeObject) &&
746
+ !activeObject.shouldStartDragging())) &&
747
+ e.preventDefault &&
748
+ e.preventDefault();
749
+ this.__onMouseMove(e);
750
+ }
751
+
752
+ /**
753
+ * @private
754
+ */
755
+ _onResize() {
756
+ this.calcOffset();
757
+ this._resetTransformEventData();
758
+ }
759
+
760
+ /**
761
+ * Decides whether the canvas should be redrawn in mouseup and mousedown events.
762
+ * @private
763
+ * @param {Object} target
764
+ */
765
+ _shouldRender(target: FabricObject | undefined) {
766
+ const activeObject = this.getActiveObject();
767
+
768
+ // if just one of them is available or if they are both but are different objects
769
+ if (
770
+ !!activeObject !== !!target ||
771
+ (activeObject && target && activeObject !== target)
772
+ ) {
773
+ // this covers: switch of target, from target to no target, selection of target
774
+ // multiSelection with key and mouse
775
+ return true;
776
+ } else if (isInteractiveTextObject(activeObject)) {
777
+ // if we mouse up/down over a editing textbox a cursor change,
778
+ // there is no need to re render
779
+ return false;
780
+ }
781
+ return false;
782
+ }
783
+
784
+ /**
785
+ * Method that defines the actions when mouse is released on canvas.
786
+ * The method resets the currentTransform parameters, store the image corner
787
+ * position in the image object and render the canvas on top.
788
+ * @private
789
+ * @param {Event} e Event object fired on mouseup
790
+ */
791
+ __onMouseUp(e: TPointerEvent) {
792
+ const transform = this._currentTransform;
793
+ this._cacheTransformEventData(e);
794
+ const target = this._target;
795
+ const isClick = this._isClick;
796
+ this._handleEvent(e, 'up:before');
797
+ // if right/middle click just fire events and return
798
+ // target undefined will make the _handleEvent search the target
799
+ if (checkClick(e, RIGHT_CLICK)) {
800
+ if (this.fireRightClick) {
801
+ this._handleEvent(e, 'up', RIGHT_CLICK, isClick);
802
+ }
803
+ return;
804
+ }
805
+
806
+ if (checkClick(e, MIDDLE_CLICK)) {
807
+ if (this.fireMiddleClick) {
808
+ this._handleEvent(e, 'up', MIDDLE_CLICK, isClick);
809
+ }
810
+ this._resetTransformEventData();
811
+ return;
812
+ }
813
+
814
+ if (this.isDrawingMode && this._isCurrentlyDrawing) {
815
+ this._onMouseUpInDrawingMode(e);
816
+ return;
817
+ }
818
+
819
+ if (!this._isMainEvent(e)) {
820
+ return;
821
+ }
822
+ let shouldRender = false;
823
+ if (transform) {
824
+ this._finalizeCurrentTransform(e);
825
+ shouldRender = transform.actionPerformed;
826
+ }
827
+ if (!isClick) {
828
+ const targetWasActive = target === this._activeObject;
829
+ this.handleSelection(e);
830
+ if (!shouldRender) {
831
+ shouldRender =
832
+ this._shouldRender(target) ||
833
+ (!targetWasActive && target === this._activeObject);
834
+ }
835
+ }
836
+ let pointer, corner;
837
+ if (target) {
838
+ corner = target._findTargetCorner(
839
+ this.getPointer(e, true),
840
+ isTouchEvent(e)
841
+ );
842
+ if (
843
+ target.selectable &&
844
+ target !== this._activeObject &&
845
+ target.activeOn === 'up'
846
+ ) {
847
+ this.setActiveObject(target, e);
848
+ shouldRender = true;
849
+ } else {
850
+ const control = target.controls[corner as string];
851
+ const mouseUpHandler =
852
+ control && control.getMouseUpHandler(e, target, control);
853
+ if (mouseUpHandler) {
854
+ pointer = this.getPointer(e);
855
+ mouseUpHandler(e, transform!, pointer.x, pointer.y);
856
+ }
857
+ }
858
+ target.isMoving = false;
859
+ }
860
+ // if we are ending up a transform on a different control or a new object
861
+ // fire the original mouse up from the corner that started the transform
862
+ if (
863
+ transform &&
864
+ (transform.target !== target || transform.corner !== corner)
865
+ ) {
866
+ const originalControl =
867
+ transform.target && transform.target.controls[transform.corner],
868
+ originalMouseUpHandler =
869
+ originalControl &&
870
+ originalControl.getMouseUpHandler(
871
+ e,
872
+ transform.target,
873
+ originalControl
874
+ );
875
+ pointer = pointer || this.getPointer(e);
876
+ originalMouseUpHandler &&
877
+ originalMouseUpHandler(e, transform, pointer.x, pointer.y);
878
+ }
879
+ this._setCursorFromEvent(e, target);
880
+ this._handleEvent(e, 'up', LEFT_CLICK, isClick);
881
+ this._groupSelector = null;
882
+ this._currentTransform = null;
883
+ // reset the target information about which corner is selected
884
+ target && (target.__corner = undefined);
885
+ if (shouldRender) {
886
+ this.requestRenderAll();
887
+ } else if (
888
+ !isClick &&
889
+ !(
890
+ isInteractiveTextObject(this._activeObject) &&
891
+ this._activeObject.isEditing
892
+ )
893
+ ) {
894
+ this.renderTop();
895
+ }
896
+ }
897
+
898
+ _basicEventHandler<T extends keyof (CanvasEvents | ObjectEvents)>(
899
+ eventType: T,
900
+ options: (CanvasEvents & ObjectEvents)[T]
901
+ ) {
902
+ const { target, subTargets = [] } = options as {
903
+ target?: FabricObject;
904
+ subTargets: FabricObject[];
905
+ };
906
+ this.fire(eventType, options);
907
+ target && target.fire(eventType, options);
908
+ for (let i = 0; i < subTargets.length; i++) {
909
+ subTargets[i].fire(eventType, options);
910
+ }
911
+ return options;
912
+ }
913
+
914
+ /**
915
+ * @private
916
+ * Handle event firing for target and subtargets
917
+ * @param {Event} e event from mouse
918
+ * @param {String} eventType event to fire (up, down or move)
919
+ * @param {fabric.Object} targetObj receiving event
920
+ * @param {Number} [button] button used in the event 1 = left, 2 = middle, 3 = right
921
+ * @param {Boolean} isClick for left button only, indicates that the mouse up happened without move.
922
+ */
923
+ _handleEvent(
924
+ e: TPointerEvent,
925
+ eventType: TPointerEventNames,
926
+ button = LEFT_CLICK,
927
+ isClick = false
928
+ ) {
929
+ const target = this._target,
930
+ targets = this.targets || [],
931
+ options: TPointerEventInfo = {
932
+ e: e,
933
+ target: target,
934
+ subTargets: targets,
935
+ button,
936
+ isClick,
937
+ pointer: this.getPointer(e),
938
+ absolutePointer: this.getPointer(e, true),
939
+ transform: this._currentTransform,
940
+ };
941
+ if (eventType === 'up') {
942
+ options.currentTarget = this.findTarget(e);
943
+ options.currentSubTargets = this.targets;
944
+ }
945
+ this.fire(`mouse:${eventType}`, options);
946
+ // this may be a little be more complicated of what we want to handle
947
+ target && target.fire(`mouse${eventType}`, options);
948
+ for (let i = 0; i < targets.length; i++) {
949
+ targets[i].fire(`mouse${eventType}`, options);
950
+ }
951
+ }
952
+
953
+ /**
954
+ * End the current transform.
955
+ * You don't usually need to call this method unless you are interrupting a user initiated transform
956
+ * because of some other event ( a press of key combination, or something that block the user UX )
957
+ * @param {Event} [e] send the mouse event that generate the finalize down, so it can be used in the event
958
+ */
959
+ endCurrentTransform(e: TPointerEvent) {
960
+ const transform = this._currentTransform;
961
+ this._finalizeCurrentTransform(e);
962
+ if (transform && transform.target) {
963
+ // this could probably go inside _finalizeCurrentTransform
964
+ transform.target.isMoving = false;
965
+ }
966
+ this._currentTransform = null;
967
+ }
968
+
969
+ /**
970
+ * @private
971
+ * @param {Event} e send the mouse event that generate the finalize down, so it can be used in the event
972
+ */
973
+ _finalizeCurrentTransform(e: TPointerEvent) {
974
+ const transform = this._currentTransform!,
975
+ target = transform.target,
976
+ options = {
977
+ e,
978
+ target,
979
+ transform,
980
+ action: transform.action,
981
+ };
982
+
983
+ if (target._scaling) {
984
+ target._scaling = false;
985
+ }
986
+
987
+ target.setCoords();
988
+
989
+ if (transform.actionPerformed) {
990
+ this.fire('object:modified', options);
991
+ target.fire('modified', options);
992
+ }
993
+ }
994
+
995
+ /**
996
+ * @private
997
+ * @param {Event} e Event object fired on mousedown
998
+ */
999
+ _onMouseDownInDrawingMode(e: TPointerEvent) {
1000
+ this._isCurrentlyDrawing = true;
1001
+ if (this.getActiveObject()) {
1002
+ this.discardActiveObject(e);
1003
+ this.requestRenderAll();
1004
+ }
1005
+ const pointer = this.getPointer(e);
1006
+ this.freeDrawingBrush &&
1007
+ this.freeDrawingBrush.onMouseDown(pointer, { e, pointer });
1008
+ this._handleEvent(e, 'down');
1009
+ }
1010
+
1011
+ /**
1012
+ * @private
1013
+ * @param {Event} e Event object fired on mousemove
1014
+ */
1015
+ _onMouseMoveInDrawingMode(e: TPointerEvent) {
1016
+ if (this._isCurrentlyDrawing) {
1017
+ const pointer = this.getPointer(e);
1018
+ this.freeDrawingBrush &&
1019
+ this.freeDrawingBrush.onMouseMove(pointer, {
1020
+ e,
1021
+ pointer,
1022
+ });
1023
+ }
1024
+ this.setCursor(this.freeDrawingCursor);
1025
+ this._handleEvent(e, 'move');
1026
+ }
1027
+
1028
+ /**
1029
+ * @private
1030
+ * @param {Event} e Event object fired on mouseup
1031
+ */
1032
+ _onMouseUpInDrawingMode(e: TPointerEvent) {
1033
+ const pointer = this.getPointer(e);
1034
+ if (this.freeDrawingBrush) {
1035
+ this._isCurrentlyDrawing = !!this.freeDrawingBrush.onMouseUp({
1036
+ e: e,
1037
+ pointer: pointer,
1038
+ });
1039
+ } else {
1040
+ this._isCurrentlyDrawing = false;
1041
+ }
1042
+ this._handleEvent(e, 'up');
1043
+ }
1044
+
1045
+ /**
1046
+ * Method that defines the actions when mouse is clicked on canvas.
1047
+ * The method inits the currentTransform parameters and renders all the
1048
+ * canvas so the current image can be placed on the top canvas and the rest
1049
+ * in on the container one.
1050
+ * @private
1051
+ * @param {Event} e Event object fired on mousedown
1052
+ */
1053
+ __onMouseDown(e: TPointerEvent) {
1054
+ this._isClick = true;
1055
+ this._cacheTransformEventData(e);
1056
+ this._handleEvent(e, 'down:before');
1057
+ let target: FabricObject | undefined = this._target;
1058
+ // if right click just fire events
1059
+ if (checkClick(e, RIGHT_CLICK)) {
1060
+ if (this.fireRightClick) {
1061
+ this._handleEvent(e, 'down', RIGHT_CLICK);
1062
+ }
1063
+ return;
1064
+ }
1065
+
1066
+ if (checkClick(e, MIDDLE_CLICK)) {
1067
+ if (this.fireMiddleClick) {
1068
+ this._handleEvent(e, 'down', MIDDLE_CLICK);
1069
+ }
1070
+ return;
1071
+ }
1072
+
1073
+ if (this.isDrawingMode) {
1074
+ this._onMouseDownInDrawingMode(e);
1075
+ return;
1076
+ }
1077
+
1078
+ if (!this._isMainEvent(e)) {
1079
+ return;
1080
+ }
1081
+
1082
+ // ignore if some object is being transformed at this moment
1083
+ if (this._currentTransform) {
1084
+ return;
1085
+ }
1086
+
1087
+ let shouldRender = this._shouldRender(target);
1088
+ let grouped = false;
1089
+ if (this.handleMultiSelection(e, target)) {
1090
+ // active object might have changed while grouping
1091
+ target = this._activeObject;
1092
+ grouped = true;
1093
+ shouldRender = true;
1094
+ } else if (this._shouldClearSelection(e, target)) {
1095
+ this.discardActiveObject(e);
1096
+ }
1097
+ // we start a group selector rectangle if
1098
+ // selection is enabled
1099
+ // and there is no target, or the following 3 conditions are satisfied:
1100
+ // target is not selectable ( otherwise we selected it )
1101
+ // target is not editing
1102
+ // target is not already selected ( otherwise we drag )
1103
+ if (
1104
+ this.selection &&
1105
+ (!target ||
1106
+ (!target.selectable &&
1107
+ !(target as IText).isEditing &&
1108
+ target !== this._activeObject))
1109
+ ) {
1110
+ const p = this.getPointer(e);
1111
+ this._groupSelector = {
1112
+ x: p.x,
1113
+ y: p.y,
1114
+ deltaY: 0,
1115
+ deltaX: 0,
1116
+ };
1117
+ }
1118
+
1119
+ if (target) {
1120
+ const alreadySelected = target === this._activeObject;
1121
+ if (target.selectable && target.activeOn === 'down') {
1122
+ this.setActiveObject(target, e);
1123
+ }
1124
+ const corner = target._findTargetCorner(
1125
+ this.getPointer(e, true),
1126
+ isTouchEvent(e)
1127
+ );
1128
+ if (target === this._activeObject && (corner || !grouped)) {
1129
+ this._setupCurrentTransform(e, target, alreadySelected);
1130
+ const control = target.controls[corner],
1131
+ pointer = this.getPointer(e),
1132
+ mouseDownHandler =
1133
+ control && control.getMouseDownHandler(e, target, control);
1134
+ if (mouseDownHandler) {
1135
+ mouseDownHandler(e, this._currentTransform!, pointer.x, pointer.y);
1136
+ }
1137
+ }
1138
+ }
1139
+ // we clear `_objectsToRender` in case of a change in order to repopulate it at rendering
1140
+ // run before firing the `down` event to give the dev a chance to populate it themselves
1141
+ shouldRender && (this._objectsToRender = undefined);
1142
+ this._handleEvent(e, 'down');
1143
+ // we must renderAll so that we update the visuals
1144
+ shouldRender && this.requestRenderAll();
1145
+ }
1146
+
1147
+ /**
1148
+ * reset cache form common information needed during event processing
1149
+ * @private
1150
+ */
1151
+ _resetTransformEventData() {
1152
+ this._target = undefined;
1153
+ this._pointer = undefined;
1154
+ this._absolutePointer = undefined;
1155
+ }
1156
+
1157
+ /**
1158
+ * Cache common information needed during event processing
1159
+ * @private
1160
+ * @param {Event} e Event object fired on event
1161
+ */
1162
+ _cacheTransformEventData(e: TPointerEvent) {
1163
+ // reset in order to avoid stale caching
1164
+ this._resetTransformEventData();
1165
+ this._pointer = this.getPointer(e, true);
1166
+ this._absolutePointer = this.restorePointerVpt(this._pointer);
1167
+ this._target = this._currentTransform
1168
+ ? this._currentTransform.target
1169
+ : this.findTarget(e);
1170
+ }
1171
+
1172
+ /**
1173
+ * @private
1174
+ */
1175
+ _beforeTransform(e: TPointerEvent) {
1176
+ const t = this._currentTransform!;
1177
+ this.fire('before:transform', {
1178
+ e,
1179
+ transform: t,
1180
+ });
1181
+ }
1182
+
1183
+ /**
1184
+ * Method that defines the actions when mouse is hovering the canvas.
1185
+ * The currentTransform parameter will define whether the user is rotating/scaling/translating
1186
+ * an image or neither of them (only hovering). A group selection is also possible and would cancel
1187
+ * all any other type of action.
1188
+ * In case of an image transformation only the top canvas will be rendered.
1189
+ * @private
1190
+ * @param {Event} e Event object fired on mousemove
1191
+ */
1192
+ __onMouseMove(e: TPointerEvent) {
1193
+ this._isClick = false;
1194
+ this._handleEvent(e, 'move:before');
1195
+ this._cacheTransformEventData(e);
1196
+
1197
+ if (this.isDrawingMode) {
1198
+ this._onMouseMoveInDrawingMode(e);
1199
+ return;
1200
+ }
1201
+
1202
+ if (!this._isMainEvent(e)) {
1203
+ return;
1204
+ }
1205
+
1206
+ const groupSelector = this._groupSelector;
1207
+
1208
+ // We initially clicked in an empty area, so we draw a box for multiple selection
1209
+ if (groupSelector) {
1210
+ const pointer = this.getPointer(e);
1211
+
1212
+ groupSelector.deltaX = pointer.x - groupSelector.x;
1213
+ groupSelector.deltaY = pointer.y - groupSelector.y;
1214
+
1215
+ this.renderTop();
1216
+ } else if (!this._currentTransform) {
1217
+ const target = this.findTarget(e);
1218
+ this._setCursorFromEvent(e, target);
1219
+ this._fireOverOutEvents(e, target);
1220
+ } else {
1221
+ this._transformObject(e);
1222
+ }
1223
+ this.textEditingManager.onMouseMove(e);
1224
+ this._handleEvent(e, 'move');
1225
+ this._resetTransformEventData();
1226
+ }
1227
+
1228
+ /**
1229
+ * Manage the mouseout, mouseover events for the fabric object on the canvas
1230
+ * @param {Fabric.Object} target the target where the target from the mousemove event
1231
+ * @param {Event} e Event object fired on mousemove
1232
+ * @private
1233
+ */
1234
+ _fireOverOutEvents(e: TPointerEvent, target?: FabricObject) {
1235
+ const _hoveredTarget = this._hoveredTarget,
1236
+ _hoveredTargets = this._hoveredTargets,
1237
+ targets = this.targets,
1238
+ length = Math.max(_hoveredTargets.length, targets.length);
1239
+
1240
+ this.fireSyntheticInOutEvents('mouse', {
1241
+ e,
1242
+ target,
1243
+ oldTarget: _hoveredTarget,
1244
+ fireCanvas: true,
1245
+ });
1246
+ for (let i = 0; i < length; i++) {
1247
+ this.fireSyntheticInOutEvents('mouse', {
1248
+ e,
1249
+ target: targets[i],
1250
+ oldTarget: _hoveredTargets[i],
1251
+ });
1252
+ }
1253
+ this._hoveredTarget = target;
1254
+ this._hoveredTargets = this.targets.concat();
1255
+ }
1256
+
1257
+ /**
1258
+ * Manage the dragEnter, dragLeave events for the fabric objects on the canvas
1259
+ * @param {Fabric.Object} target the target where the target from the onDrag event
1260
+ * @param {Object} data Event object fired on dragover
1261
+ * @private
1262
+ */
1263
+ _fireEnterLeaveEvents(target: FabricObject | undefined, data: DragEventData) {
1264
+ const draggedoverTarget = this._draggedoverTarget,
1265
+ _hoveredTargets = this._hoveredTargets,
1266
+ targets = this.targets,
1267
+ length = Math.max(_hoveredTargets.length, targets.length);
1268
+
1269
+ this.fireSyntheticInOutEvents('drag', {
1270
+ ...data,
1271
+ target,
1272
+ oldTarget: draggedoverTarget,
1273
+ fireCanvas: true,
1274
+ });
1275
+ for (let i = 0; i < length; i++) {
1276
+ this.fireSyntheticInOutEvents('drag', {
1277
+ ...data,
1278
+ target: targets[i],
1279
+ oldTarget: _hoveredTargets[i],
1280
+ });
1281
+ }
1282
+ this._draggedoverTarget = target;
1283
+ }
1284
+
1285
+ /**
1286
+ * Manage the synthetic in/out events for the fabric objects on the canvas
1287
+ * @param {Fabric.Object} target the target where the target from the supported events
1288
+ * @param {Object} data Event object fired
1289
+ * @param {Object} config configuration for the function to work
1290
+ * @param {String} config.targetName property on the canvas where the old target is stored
1291
+ * @param {String} [config.canvasEvtOut] name of the event to fire at canvas level for out
1292
+ * @param {String} config.evtOut name of the event to fire for out
1293
+ * @param {String} [config.canvasEvtIn] name of the event to fire at canvas level for in
1294
+ * @param {String} config.evtIn name of the event to fire for in
1295
+ * @private
1296
+ */
1297
+ fireSyntheticInOutEvents<T extends keyof TSyntheticEventContext>(
1298
+ type: T,
1299
+ {
1300
+ target,
1301
+ oldTarget,
1302
+ fireCanvas,
1303
+ e,
1304
+ ...data
1305
+ }: TSyntheticEventContext[T] & {
1306
+ target?: FabricObject;
1307
+ oldTarget?: FabricObject;
1308
+ fireCanvas?: boolean;
1309
+ }
1310
+ ) {
1311
+ const { targetIn, targetOut, canvasIn, canvasOut } =
1312
+ syntheticEventConfig[type];
1313
+ const targetChanged = oldTarget !== target;
1314
+
1315
+ if (oldTarget && targetChanged) {
1316
+ const outOpt = {
1317
+ ...data,
1318
+ e,
1319
+ target: oldTarget,
1320
+ nextTarget: target,
1321
+ isClick: false,
1322
+ pointer: this.getPointer(e),
1323
+ absolutePointer: this.getPointer(e, true),
1324
+ };
1325
+ fireCanvas && this.fire(canvasIn, outOpt);
1326
+ oldTarget.fire(targetOut, outOpt);
1327
+ }
1328
+ if (target && targetChanged) {
1329
+ const inOpt: TPointerEventInfo = {
1330
+ ...data,
1331
+ e,
1332
+ target,
1333
+ previousTarget: oldTarget,
1334
+ isClick: false,
1335
+ pointer: this.getPointer(e),
1336
+ absolutePointer: this.getPointer(e, true),
1337
+ };
1338
+ fireCanvas && this.fire(canvasOut, inOpt);
1339
+ target.fire(targetIn, inOpt);
1340
+ }
1341
+ }
1342
+
1343
+ /**
1344
+ * Method that defines actions when an Event Mouse Wheel
1345
+ * @param {Event} e Event object fired on mouseup
1346
+ */
1347
+ __onMouseWheel(e: TPointerEvent) {
1348
+ this._cacheTransformEventData(e);
1349
+ this._handleEvent(e, 'wheel');
1350
+ this._resetTransformEventData();
1351
+ }
1352
+
1353
+ /**
1354
+ * @private
1355
+ * @param {Event} e Event fired on mousemove
1356
+ */
1357
+ _transformObject(e: TPointerEvent) {
1358
+ const pointer = this.getPointer(e),
1359
+ transform = this._currentTransform!,
1360
+ target = transform.target,
1361
+ // transform pointer to target's containing coordinate plane
1362
+ // both pointer and object should agree on every point
1363
+ localPointer = target.group
1364
+ ? sendPointToPlane(
1365
+ pointer,
1366
+ undefined,
1367
+ target.group.calcTransformMatrix()
1368
+ )
1369
+ : pointer;
1370
+ // seems used only here.
1371
+ // @TODO: investigate;
1372
+ transform.reset = false;
1373
+ transform.shiftKey = e.shiftKey;
1374
+ transform.altKey = !!this.centeredKey && e[this.centeredKey];
1375
+
1376
+ this._performTransformAction(e, transform, localPointer);
1377
+ transform.actionPerformed && this.requestRenderAll();
1378
+ }
1379
+
1380
+ /**
1381
+ * @private
1382
+ */
1383
+ _performTransformAction(
1384
+ e: TPointerEvent,
1385
+ transform: Transform,
1386
+ pointer: Point
1387
+ ) {
1388
+ const x = pointer.x,
1389
+ y = pointer.y,
1390
+ action = transform.action,
1391
+ actionHandler = transform.actionHandler;
1392
+ let actionPerformed = false;
1393
+ // this object could be created from the function in the control handlers
1394
+
1395
+ if (actionHandler) {
1396
+ actionPerformed = actionHandler(e, transform, x, y);
1397
+ }
1398
+ if (action === 'drag' && actionPerformed) {
1399
+ transform.target.isMoving = true;
1400
+ this.setCursor(transform.target.moveCursor || this.moveCursor);
1401
+ }
1402
+ transform.actionPerformed = transform.actionPerformed || actionPerformed;
1403
+ }
1404
+
1405
+ /**
1406
+ * Sets the cursor depending on where the canvas is being hovered.
1407
+ * Note: very buggy in Opera
1408
+ * @param {Event} e Event object
1409
+ * @param {Object} target Object that the mouse is hovering, if so.
1410
+ */
1411
+ _setCursorFromEvent(e: TPointerEvent, target?: FabricObject) {
1412
+ if (!target) {
1413
+ this.setCursor(this.defaultCursor);
1414
+ return;
1415
+ }
1416
+ let hoverCursor = target.hoverCursor || this.hoverCursor;
1417
+ const activeSelection =
1418
+ this._activeObject === this._activeSelection
1419
+ ? this._activeObject
1420
+ : null,
1421
+ // only show proper corner when group selection is not active
1422
+ corner =
1423
+ (!activeSelection || target.group !== activeSelection) &&
1424
+ // here we call findTargetCorner always with undefined for the touch parameter.
1425
+ // we assume that if you are using a cursor you do not need to interact with
1426
+ // the bigger touch area.
1427
+ target._findTargetCorner(this.getPointer(e, true));
1428
+
1429
+ if (!corner) {
1430
+ if ((target as Group).subTargetCheck) {
1431
+ // hoverCursor should come from top-most subTarget,
1432
+ // so we walk the array backwards
1433
+ this.targets
1434
+ .concat()
1435
+ .reverse()
1436
+ .map((_target) => {
1437
+ hoverCursor = _target.hoverCursor || hoverCursor;
1438
+ });
1439
+ }
1440
+ this.setCursor(hoverCursor);
1441
+ } else {
1442
+ const control = target.controls[corner];
1443
+ this.setCursor(control.cursorStyleHandler(e, control, target));
1444
+ }
1445
+ }
1446
+
1447
+ /**
1448
+ * ## Handles multiple selection
1449
+ * - toggles `target` selection (selects/deselects `target` if it isn't/is selected respectively)
1450
+ * - sets the active object in case it is not set or in case there is a single active object left under active selection.
1451
+ * ---
1452
+ * - If the active object is the active selection we add/remove `target` from it
1453
+ * - If not, add the active object and `target` to the active selection and make it the active object.
1454
+ * @private
1455
+ * @param {TPointerEvent} e Event object
1456
+ * @param {FabricObject} target target of event to select/deselect
1457
+ * @returns true if grouping occurred
1458
+ */
1459
+ protected handleMultiSelection(e: TPointerEvent, target?: FabricObject) {
1460
+ const activeObject = this._activeObject;
1461
+ const activeSelection = this._activeSelection;
1462
+ const isAS = activeObject === activeSelection;
1463
+ if (
1464
+ // check if an active object exists on canvas and if the user is pressing the `selectionKey` while canvas supports multi selection.
1465
+ !!activeObject &&
1466
+ this._isSelectionKeyPressed(e) &&
1467
+ this.selection &&
1468
+ // on top of that the user also has to hit a target that is selectable.
1469
+ !!target &&
1470
+ target.selectable &&
1471
+ // group target and active object only if they are different objects
1472
+ // else we try to find a subtarget of `ActiveSelection`
1473
+ (activeObject !== target || isAS) &&
1474
+ // make sure `activeObject` and `target` aren't ancestors of each other in case `activeObject` is not `ActiveSelection`
1475
+ // if it is then we want to remove `target` from it
1476
+ (isAS ||
1477
+ (!target.isDescendantOf(activeObject) &&
1478
+ !activeObject.isDescendantOf(target))) &&
1479
+ // target accepts selection
1480
+ !target.onSelect({ e }) &&
1481
+ // make sure we are not on top of a control
1482
+ !activeObject.__corner
1483
+ ) {
1484
+ if (isAS) {
1485
+ const prevActiveObjects =
1486
+ activeSelection.getObjects() as FabricObject[];
1487
+ if (target === activeSelection) {
1488
+ // find target from active objects
1489
+ target = this.searchPossibleTargets(
1490
+ prevActiveObjects,
1491
+ this.getPointer(e, true)
1492
+ );
1493
+ // if nothing is found bail out
1494
+ if (!target || !target.selectable) {
1495
+ return false;
1496
+ }
1497
+ }
1498
+ if (target.group === activeSelection) {
1499
+ // `target` is part of active selection => remove it
1500
+ activeSelection.remove(target);
1501
+ this._hoveredTarget = target;
1502
+ this._hoveredTargets = [...this.targets];
1503
+ if (activeSelection.size() === 1) {
1504
+ // activate last remaining object
1505
+ this._setActiveObject(activeSelection.item(0) as FabricObject, e);
1506
+ }
1507
+ } else {
1508
+ // `target` isn't part of active selection => add it
1509
+ activeSelection.multiSelectAdd(target);
1510
+ this._hoveredTarget = activeSelection;
1511
+ this._hoveredTargets = [...this.targets];
1512
+ }
1513
+ this._fireSelectionEvents(prevActiveObjects, e);
1514
+ } else {
1515
+ isInteractiveTextObject(activeObject) && activeObject.exitEditing();
1516
+ // add the active object and the target to the active selection and set it as the active object
1517
+ activeSelection.multiSelectAdd(activeObject, target);
1518
+ this._hoveredTarget = activeSelection;
1519
+ // ISSUE 4115: should we consider subTargets here?
1520
+ // this._hoveredTargets = [];
1521
+ // this._hoveredTargets = this.targets.concat();
1522
+ this._setActiveObject(activeSelection, e);
1523
+ this._fireSelectionEvents([activeObject], e);
1524
+ }
1525
+ return true;
1526
+ }
1527
+ return false;
1528
+ }
1529
+
1530
+ /**
1531
+ * ## Handles selection
1532
+ * - selects objects that are contained in (and possibly intersecting) the selection bounding box
1533
+ * - sets the active object
1534
+ * ---
1535
+ * runs on mouse up
1536
+ */
1537
+ protected handleSelection(e: TPointerEvent) {
1538
+ if (!this.selection || !this._groupSelector) {
1539
+ return false;
1540
+ }
1541
+ const { x, y, deltaX, deltaY } = this._groupSelector,
1542
+ point1 = new Point(x, y),
1543
+ point2 = point1.add(new Point(deltaX, deltaY)),
1544
+ tl = point1.min(point2),
1545
+ br = point1.max(point2),
1546
+ size = br.subtract(tl),
1547
+ isClick = point1.eq(point2);
1548
+
1549
+ const collectedObjects = this.collectObjects(
1550
+ {
1551
+ left: tl.x,
1552
+ top: tl.y,
1553
+ width: size.x,
1554
+ height: size.y,
1555
+ },
1556
+ { includeIntersecting: !this.selectionFullyContained }
1557
+ ) as FabricObject[];
1558
+
1559
+ const objects = isClick
1560
+ ? collectedObjects[0]
1561
+ ? [collectedObjects[0]]
1562
+ : []
1563
+ : collectedObjects.length > 1
1564
+ ? collectedObjects.filter((object) => !object.onSelect({ e })).reverse()
1565
+ : collectedObjects;
1566
+
1567
+ // set active object
1568
+ if (objects.length === 1) {
1569
+ // set as active object
1570
+ this.setActiveObject(objects[0], e);
1571
+ } else if (objects.length > 1) {
1572
+ // add to active selection and make it the active object
1573
+ this._activeSelection.add(...objects);
1574
+ this.setActiveObject(this._activeSelection, e);
1575
+ }
1576
+
1577
+ // cleanup
1578
+ this._groupSelector = null;
1579
+ return true;
1580
+ }
1581
+
1582
+ /**
1583
+ * @override clear {@link textEditingManager}
1584
+ */
1585
+ clear() {
1586
+ this.textEditingManager.clear();
1587
+ super.clear();
1588
+ }
1589
+
1590
+ /**
1591
+ * @override clear {@link textEditingManager}
1592
+ */
1593
+ destroy() {
1594
+ this.removeListeners();
1595
+ this.textEditingManager.dispose();
1596
+ super.destroy();
1597
+ }
1598
+ }