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,669 @@
1
+ import { Point } from '../../Point';
2
+ import type { TCornerPoint, TDegree } from '../../typedefs';
3
+ import { FabricObject } from './Object';
4
+ import { degreesToRadians } from '../../util/misc/radiansDegreesConversion';
5
+ import type { TQrDecomposeOut } from '../../util/misc/matrix';
6
+ import {
7
+ createRotateMatrix,
8
+ createTranslateMatrix,
9
+ multiplyTransformMatrices,
10
+ qrDecompose,
11
+ } from '../../util/misc/matrix';
12
+ import type { Control } from '../../controls/Control';
13
+ import { sizeAfterTransform } from '../../util/misc/objectTransforms';
14
+ import type { ObjectEvents, TPointerEvent } from '../../EventTypeDefs';
15
+ import type { Canvas } from '../../canvas/Canvas';
16
+ import type { ControlRenderingStyleOverride } from '../../controls/controlRendering';
17
+ import type { FabricObjectProps } from './types/FabricObjectProps';
18
+ import type { TFabricObjectProps, SerializedObjectProps } from './types';
19
+ import { createObjectDefaultControls } from '../../controls/commonControls';
20
+
21
+ type TOCoord = Point & {
22
+ corner: TCornerPoint;
23
+ touchCorner: TCornerPoint;
24
+ };
25
+
26
+ type TControlSet = Record<string, Control>;
27
+
28
+ type TBorderRenderingStyleOverride = Partial<
29
+ Pick<InteractiveFabricObject, 'borderColor' | 'borderDashArray'>
30
+ >;
31
+
32
+ type TStyleOverride = ControlRenderingStyleOverride &
33
+ TBorderRenderingStyleOverride &
34
+ Partial<
35
+ Pick<InteractiveFabricObject, 'hasBorders' | 'hasControls'> & {
36
+ forActiveSelection: boolean;
37
+ }
38
+ >;
39
+
40
+ export interface DragMethods {
41
+ shouldStartDragging(): boolean;
42
+ onDragStart(e: DragEvent): boolean;
43
+ }
44
+
45
+ export type FabricObjectWithDragSupport = InteractiveFabricObject & DragMethods;
46
+
47
+ const interactiveDefaults = {};
48
+
49
+ export class InteractiveFabricObject<
50
+ Props extends TFabricObjectProps = Partial<FabricObjectProps>,
51
+ SProps extends SerializedObjectProps = SerializedObjectProps,
52
+ EventSpec extends ObjectEvents = ObjectEvents
53
+ >
54
+ extends FabricObject<Props, SProps, EventSpec>
55
+ implements FabricObjectProps
56
+ {
57
+ declare noScaleCache: boolean;
58
+ declare centeredScaling: false;
59
+
60
+ declare snapAngle?: TDegree;
61
+ declare snapThreshold?: TDegree;
62
+
63
+ declare lockMovementX: boolean;
64
+ declare lockMovementY: boolean;
65
+ declare lockRotation: boolean;
66
+ declare lockScalingX: boolean;
67
+ declare lockScalingY: boolean;
68
+ declare lockSkewingX: boolean;
69
+ declare lockSkewingY: boolean;
70
+ declare lockScalingFlip: boolean;
71
+
72
+ declare cornerSize: number;
73
+ declare touchCornerSize: number;
74
+ declare transparentCorners: boolean;
75
+ declare cornerColor: string;
76
+ declare cornerStrokeColor: string;
77
+ declare cornerStyle: 'rect' | 'circle';
78
+ declare cornerDashArray: number[] | null;
79
+ declare hasControls: boolean;
80
+
81
+ declare borderColor: string;
82
+ declare borderDashArray: number[] | null;
83
+ declare borderOpacityWhenMoving: number;
84
+ declare borderScaleFactor: number;
85
+ declare hasBorders: boolean;
86
+ declare selectionBackgroundColor: string;
87
+
88
+ declare selectable: boolean;
89
+ declare evented: boolean;
90
+ declare perPixelTargetFind: boolean;
91
+ declare activeOn: 'down' | 'up';
92
+
93
+ declare hoverCursor: CSSStyleDeclaration['cursor'] | null;
94
+ declare moveCursor: CSSStyleDeclaration['cursor'] | null;
95
+
96
+ /**
97
+ * Describe object's corner position in canvas element coordinates.
98
+ * properties are depending on control keys and padding the main controls.
99
+ * each property is an object with x, y and corner.
100
+ * The `corner` property contains in a similar manner the 4 points of the
101
+ * interactive area of the corner.
102
+ * The coordinates depends from the controls positionHandler and are used
103
+ * to draw and locate controls
104
+ */
105
+ declare oCoords: Record<string, TOCoord>;
106
+
107
+ /**
108
+ * keeps the value of the last hovered corner during mouse move.
109
+ * 0 is no corner, or 'mt', 'ml', 'mtr' etc..
110
+ * It should be private, but there is no harm in using it as
111
+ * a read-only property.
112
+ * this isn't cleaned automatically. Non selected objects may have wrong values
113
+ * @type [string]
114
+ */
115
+ declare __corner?: string;
116
+
117
+ /**
118
+ * a map of control visibility for this object.
119
+ * this was left when controls were introduced to not break the api too much
120
+ * this takes priority over the generic control visibility
121
+ */
122
+ declare _controlsVisibility: Record<string, boolean>;
123
+
124
+ /**
125
+ * holds the controls for the object.
126
+ * controls are added by default_controls.js
127
+ */
128
+ declare controls: TControlSet;
129
+
130
+ /**
131
+ * internal boolean to signal the code that the object is
132
+ * part of the move action.
133
+ */
134
+ declare isMoving?: boolean;
135
+
136
+ /**
137
+ * A boolean used from the gesture module to keep tracking of a scaling
138
+ * action when there is no scaling transform in place.
139
+ * This is an edge case and is used twice in all codebase.
140
+ * Probably added to keep track of some performance issues
141
+ * @TODO use git blame to investigate why it was added
142
+ * DON'T USE IT. WE WILL TRY TO REMOVE IT
143
+ */
144
+ declare _scaling?: boolean;
145
+
146
+ declare canvas?: Canvas;
147
+
148
+ static ownDefaults: Record<string, any> = interactiveDefaults;
149
+
150
+ static getDefaults(): Record<string, any> {
151
+ return {
152
+ ...super.getDefaults(),
153
+ controls: createObjectDefaultControls(),
154
+ ...InteractiveFabricObject.ownDefaults,
155
+ };
156
+ }
157
+
158
+ /**
159
+ * Update width and height of the canvas for cache
160
+ * returns true or false if canvas needed resize.
161
+ * @private
162
+ * @return {Boolean} true if the canvas has been resized
163
+ */
164
+ _updateCacheCanvas() {
165
+ const targetCanvas = this.canvas;
166
+ if (this.noScaleCache && targetCanvas && targetCanvas._currentTransform) {
167
+ const target = targetCanvas._currentTransform.target,
168
+ action = targetCanvas._currentTransform.action;
169
+ if (this === (target as unknown as this) && action.startsWith('scale')) {
170
+ return false;
171
+ }
172
+ }
173
+ return super._updateCacheCanvas();
174
+ }
175
+
176
+ /**
177
+ * Determines which corner is under the mouse cursor, represented by `pointer`.
178
+ * This function is return a corner only if the object is the active one.
179
+ * This is done to avoid selecting corner of non active object and activating transformations
180
+ * rather than drag action. The default behavior of fabricJS is that if you want to transform
181
+ * an object, first you select it to show the control set
182
+ * @private
183
+ * @param {Object} pointer The pointer indicating the mouse position
184
+ * @param {boolean} forTouch indicates if we are looking for interaction area with a touch action
185
+ * @return {String|Boolean} corner code (tl, tr, bl, br, etc.), or 0 if nothing is found.
186
+ */
187
+ _findTargetCorner(pointer: Point, forTouch = false): string {
188
+ if (!this.hasControls || !this.canvas) {
189
+ return '';
190
+ }
191
+
192
+ this.__corner = undefined;
193
+ // had to keep the reverse loop because was breaking tests
194
+ const cornerEntries = Object.entries(this.oCoords);
195
+ for (let i = cornerEntries.length - 1; i >= 0; i--) {
196
+ const [key, corner] = cornerEntries[i];
197
+ if (this.controls[key].shouldActivate(key, this)) {
198
+ const lines = this._getImageLines(
199
+ forTouch ? corner.touchCorner : corner.corner
200
+ );
201
+ const xPoints = this._findCrossPoints(pointer, lines);
202
+ if (xPoints !== 0 && xPoints % 2 === 1) {
203
+ this.__corner = key;
204
+ return key;
205
+ }
206
+ }
207
+
208
+ // // debugging
209
+ //
210
+ // this.canvas.contextTop.fillRect(lines.bottomline.d.x, lines.bottomline.d.y, 2, 2);
211
+ // this.canvas.contextTop.fillRect(lines.bottomline.o.x, lines.bottomline.o.y, 2, 2);
212
+ //
213
+ // this.canvas.contextTop.fillRect(lines.leftline.d.x, lines.leftline.d.y, 2, 2);
214
+ // this.canvas.contextTop.fillRect(lines.leftline.o.x, lines.leftline.o.y, 2, 2);
215
+ //
216
+ // this.canvas.contextTop.fillRect(lines.topline.d.x, lines.topline.d.y, 2, 2);
217
+ // this.canvas.contextTop.fillRect(lines.topline.o.x, lines.topline.o.y, 2, 2);
218
+ //
219
+ // this.canvas.contextTop.fillRect(lines.rightline.d.x, lines.rightline.d.y, 2, 2);
220
+ // this.canvas.contextTop.fillRect(lines.rightline.o.x, lines.rightline.o.y, 2, 2);
221
+ }
222
+ return '';
223
+ }
224
+
225
+ /**
226
+ * Calculates the coordinates of the center of each control plus the corners of the control itself
227
+ * This basically just delegates to each control positionHandler
228
+ * WARNING: changing what is passed to positionHandler is a breaking change, since position handler
229
+ * is a public api and should be done just if extremely necessary
230
+ * @return {Record<string, TOCoord>}
231
+ */
232
+ calcOCoords(): Record<string, TOCoord> {
233
+ const vpt = this.getViewportTransform(),
234
+ center = this.getCenterPoint(),
235
+ tMatrix = createTranslateMatrix(center.x, center.y),
236
+ rMatrix = createRotateMatrix({
237
+ angle: this.getTotalAngle() - (!!this.group && this.flipX ? 180 : 0),
238
+ }),
239
+ positionMatrix = multiplyTransformMatrices(tMatrix, rMatrix),
240
+ startMatrix = multiplyTransformMatrices(vpt, positionMatrix),
241
+ finalMatrix = multiplyTransformMatrices(startMatrix, [
242
+ 1 / vpt[0],
243
+ 0,
244
+ 0,
245
+ 1 / vpt[3],
246
+ 0,
247
+ 0,
248
+ ]),
249
+ transformOptions = this.group
250
+ ? qrDecompose(this.calcTransformMatrix())
251
+ : undefined,
252
+ dim = this._calculateCurrentDimensions(transformOptions),
253
+ coords: Record<string, TOCoord> = {};
254
+
255
+ this.forEachControl((control, key) => {
256
+ const position = control.positionHandler(dim, finalMatrix, this, control);
257
+ // coords[key] are sometimes used as points. Those are points to which we add
258
+ // the property corner and touchCorner from `_calcCornerCoords`.
259
+ // don't remove this assign for an object spread.
260
+ coords[key] = Object.assign(
261
+ position,
262
+ this._calcCornerCoords(control, position)
263
+ );
264
+ });
265
+
266
+ // debug code
267
+ /*
268
+ const canvas = this.canvas;
269
+ setTimeout(function () {
270
+ if (!canvas) return;
271
+ canvas.contextTop.clearRect(0, 0, 700, 700);
272
+ canvas.contextTop.fillStyle = 'green';
273
+ Object.keys(coords).forEach(function(key) {
274
+ const control = coords[key];
275
+ canvas.contextTop.fillRect(control.x, control.y, 3, 3);
276
+ });
277
+ } 50);
278
+ */
279
+ return coords;
280
+ }
281
+
282
+ /**
283
+ * Sets the coordinates that determine the interaction area of each control
284
+ * note: if we would switch to ROUND corner area, all of this would disappear.
285
+ * everything would resolve to a single point and a pythagorean theorem for the distance
286
+ * @todo evaluate simplification of code switching to circle interaction area at runtime
287
+ * @private
288
+ */
289
+ private _calcCornerCoords(control: Control, position: Point) {
290
+ const corner = control.calcCornerCoords(
291
+ this.angle,
292
+ this.cornerSize,
293
+ position.x,
294
+ position.y,
295
+ false
296
+ );
297
+ const touchCorner = control.calcCornerCoords(
298
+ this.angle,
299
+ this.touchCornerSize,
300
+ position.x,
301
+ position.y,
302
+ true
303
+ );
304
+ return { corner, touchCorner };
305
+ }
306
+
307
+ /**
308
+ * Sets corner and controls position coordinates based on current angle, width and height, left and top.
309
+ * oCoords are used to find the corners
310
+ * aCoords are used to quickly find an object on the canvas
311
+ * lineCoords are used to quickly find object during pointer events.
312
+ * See {@link https://github.com/fabricjs/fabric.js/wiki/When-to-call-setCoords} and {@link http://fabricjs.com/fabric-gotchas}
313
+ * @return {void}
314
+ */
315
+ setCoords(): void {
316
+ super.setCoords();
317
+ // set coordinates of the draggable boxes in the corners used to scale/rotate the image
318
+ this.oCoords = this.calcOCoords();
319
+ }
320
+
321
+ /**
322
+ * Calls a function for each control. The function gets called,
323
+ * with the control, the control's key and the object that is calling the iterator
324
+ * @param {Function} fn function to iterate over the controls over
325
+ */
326
+ forEachControl(
327
+ fn: (
328
+ control: Control,
329
+ key: string,
330
+ fabricObject: InteractiveFabricObject
331
+ ) => any
332
+ ) {
333
+ for (const i in this.controls) {
334
+ fn(this.controls[i], i, this);
335
+ }
336
+ }
337
+
338
+ /**
339
+ * Draws a colored layer behind the object, inside its selection borders.
340
+ * Requires public options: padding, selectionBackgroundColor
341
+ * this function is called when the context is transformed
342
+ * has checks to be skipped when the object is on a staticCanvas
343
+ * @todo evaluate if make this disappear in favor of a pre-render hook for objects
344
+ * this was added by Andrea Bogazzi to make possible some feature for work reasons
345
+ * it seemed a good option, now is an edge case
346
+ * @param {CanvasRenderingContext2D} ctx Context to draw on
347
+ */
348
+ drawSelectionBackground(ctx: CanvasRenderingContext2D): void {
349
+ if (
350
+ !this.selectionBackgroundColor ||
351
+ (this.canvas && !this.canvas.interactive) ||
352
+ (this.canvas && (this.canvas._activeObject as unknown as this) !== this)
353
+ ) {
354
+ return;
355
+ }
356
+ ctx.save();
357
+ const center = this.getRelativeCenterPoint(),
358
+ wh = this._calculateCurrentDimensions(),
359
+ vpt = this.getViewportTransform();
360
+ ctx.translate(center.x, center.y);
361
+ ctx.scale(1 / vpt[0], 1 / vpt[3]);
362
+ ctx.rotate(degreesToRadians(this.angle));
363
+ ctx.fillStyle = this.selectionBackgroundColor;
364
+ ctx.fillRect(-wh.x / 2, -wh.y / 2, wh.x, wh.y);
365
+ ctx.restore();
366
+ }
367
+
368
+ /**
369
+ * @public override this function in order to customize the drawing of the control box, e.g. rounded corners, different border style.
370
+ * @param {CanvasRenderingContext2D} ctx ctx is rotated and translated so that (0,0) is at object's center
371
+ * @param {Point} size the control box size used
372
+ */
373
+ strokeBorders(ctx: CanvasRenderingContext2D, size: Point): void {
374
+ ctx.strokeRect(-size.x / 2, -size.y / 2, size.x, size.y);
375
+ }
376
+
377
+ /**
378
+ * @private
379
+ * @param {CanvasRenderingContext2D} ctx Context to draw on
380
+ * @param {Point} size
381
+ * @param {TStyleOverride} styleOverride object to override the object style
382
+ */
383
+ _drawBorders(
384
+ ctx: CanvasRenderingContext2D,
385
+ size: Point,
386
+ styleOverride: TStyleOverride = {}
387
+ ): void {
388
+ const options = {
389
+ hasControls: this.hasControls,
390
+ borderColor: this.borderColor,
391
+ borderDashArray: this.borderDashArray,
392
+ ...styleOverride,
393
+ };
394
+ ctx.save();
395
+ ctx.strokeStyle = options.borderColor;
396
+ this._setLineDash(ctx, options.borderDashArray);
397
+ this.strokeBorders(ctx, size);
398
+ options.hasControls && this.drawControlsConnectingLines(ctx, size);
399
+ ctx.restore();
400
+ }
401
+
402
+ /**
403
+ * Renders controls and borders for the object
404
+ * the context here is not transformed
405
+ * @todo move to interactivity
406
+ * @param {CanvasRenderingContext2D} ctx Context to render on
407
+ * @param {TStyleOverride} [styleOverride] properties to override the object style
408
+ */
409
+ _renderControls(
410
+ ctx: CanvasRenderingContext2D,
411
+ styleOverride: TStyleOverride = {}
412
+ ) {
413
+ const { hasBorders, hasControls } = this;
414
+ const styleOptions = {
415
+ hasBorders,
416
+ hasControls,
417
+ ...styleOverride,
418
+ };
419
+ const vpt = this.getViewportTransform(),
420
+ shouldDrawBorders = styleOptions.hasBorders,
421
+ shouldDrawControls = styleOptions.hasControls;
422
+ const matrix = multiplyTransformMatrices(vpt, this.calcTransformMatrix());
423
+ const options = qrDecompose(matrix);
424
+ ctx.save();
425
+ ctx.translate(options.translateX, options.translateY);
426
+ ctx.lineWidth = 1 * this.borderScaleFactor;
427
+ if (!this.group) {
428
+ ctx.globalAlpha = this.isMoving ? this.borderOpacityWhenMoving : 1;
429
+ }
430
+ if (this.flipX) {
431
+ options.angle -= 180;
432
+ }
433
+ ctx.rotate(degreesToRadians(this.group ? options.angle : this.angle));
434
+ shouldDrawBorders && this.drawBorders(ctx, options, styleOverride);
435
+ shouldDrawControls && this.drawControls(ctx, styleOverride);
436
+ ctx.restore();
437
+ }
438
+
439
+ /**
440
+ * Draws borders of an object's bounding box.
441
+ * Requires public properties: width, height
442
+ * Requires public options: padding, borderColor
443
+ * @param {CanvasRenderingContext2D} ctx Context to draw on
444
+ * @param {object} options object representing current object parameters
445
+ * @param {TStyleOverride} [styleOverride] object to override the object style
446
+ */
447
+ drawBorders(
448
+ ctx: CanvasRenderingContext2D,
449
+ options: TQrDecomposeOut,
450
+ styleOverride: TStyleOverride
451
+ ): void {
452
+ let size;
453
+ if ((styleOverride && styleOverride.forActiveSelection) || this.group) {
454
+ const bbox = sizeAfterTransform(this.width, this.height, options),
455
+ stroke = (
456
+ this.strokeUniform
457
+ ? new Point().scalarAdd(this.canvas ? this.canvas.getZoom() : 1)
458
+ : // this is extremely confusing. options comes from the upper function
459
+ // and is the qrDecompose of a matrix that takes in account zoom too
460
+ new Point(options.scaleX, options.scaleY)
461
+ ).scalarMultiply(this.strokeWidth);
462
+ size = bbox.add(stroke).scalarAdd(this.borderScaleFactor);
463
+ } else {
464
+ size = this._calculateCurrentDimensions().scalarAdd(
465
+ this.borderScaleFactor
466
+ );
467
+ }
468
+ this._drawBorders(ctx, size, styleOverride);
469
+ }
470
+
471
+ /**
472
+ * Draws lines from a borders of an object's bounding box to controls that have `withConnection` property set.
473
+ * Requires public properties: width, height
474
+ * Requires public options: padding, borderColor
475
+ * @param {CanvasRenderingContext2D} ctx Context to draw on
476
+ * @param {Point} size object size x = width, y = height
477
+ */
478
+ drawControlsConnectingLines(
479
+ ctx: CanvasRenderingContext2D,
480
+ size: Point
481
+ ): void {
482
+ let shouldStroke = false;
483
+
484
+ ctx.beginPath();
485
+ this.forEachControl((control, key) => {
486
+ // in this moment, the ctx is centered on the object.
487
+ // width and height of the above function are the size of the bbox.
488
+ if (control.withConnection && control.getVisibility(this, key)) {
489
+ // reset movement for each control
490
+ shouldStroke = true;
491
+ ctx.moveTo(control.x * size.x, control.y * size.y);
492
+ ctx.lineTo(
493
+ control.x * size.x + control.offsetX,
494
+ control.y * size.y + control.offsetY
495
+ );
496
+ }
497
+ });
498
+ shouldStroke && ctx.stroke();
499
+ }
500
+
501
+ /**
502
+ * Draws corners of an object's bounding box.
503
+ * Requires public properties: width, height
504
+ * Requires public options: cornerSize, padding
505
+ * @param {CanvasRenderingContext2D} ctx Context to draw on
506
+ * @param {ControlRenderingStyleOverride} styleOverride object to override the object style
507
+ */
508
+ drawControls(
509
+ ctx: CanvasRenderingContext2D,
510
+ styleOverride: ControlRenderingStyleOverride = {}
511
+ ) {
512
+ ctx.save();
513
+ const retinaScaling = this.getCanvasRetinaScaling();
514
+ const { cornerStrokeColor, cornerDashArray, cornerColor } = this;
515
+ const options = {
516
+ cornerStrokeColor,
517
+ cornerDashArray,
518
+ cornerColor,
519
+ ...styleOverride,
520
+ };
521
+ ctx.setTransform(retinaScaling, 0, 0, retinaScaling, 0, 0);
522
+ ctx.strokeStyle = ctx.fillStyle = options.cornerColor;
523
+ if (!this.transparentCorners) {
524
+ ctx.strokeStyle = options.cornerStrokeColor;
525
+ }
526
+ this._setLineDash(ctx, options.cornerDashArray);
527
+ this.setCoords();
528
+ this.forEachControl((control, key) => {
529
+ if (control.getVisibility(this, key)) {
530
+ const p = this.oCoords[key];
531
+ control.render(ctx, p.x, p.y, options, this);
532
+ }
533
+ });
534
+ ctx.restore();
535
+ }
536
+
537
+ /**
538
+ * Returns true if the specified control is visible, false otherwise.
539
+ * @param {string} controlKey The key of the control. Possible values are usually 'tl', 'tr', 'br', 'bl', 'ml', 'mt', 'mr', 'mb', 'mtr',
540
+ * but since the control api allow for any control name, can be any string.
541
+ * @returns {boolean} true if the specified control is visible, false otherwise
542
+ */
543
+ isControlVisible(controlKey: string): boolean {
544
+ return (
545
+ this.controls[controlKey] &&
546
+ this.controls[controlKey].getVisibility(this, controlKey)
547
+ );
548
+ }
549
+
550
+ /**
551
+ * Sets the visibility of the specified control.
552
+ * please do not use.
553
+ * @param {String} controlKey The key of the control. Possible values are 'tl', 'tr', 'br', 'bl', 'ml', 'mt', 'mr', 'mb', 'mtr'.
554
+ * but since the control api allow for any control name, can be any string.
555
+ * @param {Boolean} visible true to set the specified control visible, false otherwise
556
+ * @todo discuss this overlap of priority here with the team. Andrea Bogazzi for details
557
+ */
558
+ setControlVisible(controlKey: string, visible: boolean) {
559
+ if (!this._controlsVisibility) {
560
+ this._controlsVisibility = {};
561
+ }
562
+ this._controlsVisibility[controlKey] = visible;
563
+ }
564
+
565
+ /**
566
+ * Sets the visibility state of object controls, this is just a bulk option for setControlVisible;
567
+ * @param {Record<string, boolean>} [options] with an optional key per control
568
+ * example: {Boolean} [options.bl] true to enable the bottom-left control, false to disable it
569
+ */
570
+ setControlsVisibility(options: Record<string, boolean> = {}) {
571
+ Object.entries(options).forEach(([controlKey, visibility]) =>
572
+ this.setControlVisible(controlKey, visibility)
573
+ );
574
+ }
575
+
576
+ /**
577
+ * Clears the canvas.contextTop in a specific area that corresponds to the object's bounding box
578
+ * that is in the canvas.contextContainer.
579
+ * This function is used to clear pieces of contextTop where we render ephemeral effects on top of the object.
580
+ * Example: blinking cursor text selection, drag effects.
581
+ * @todo discuss swapping restoreManually with a renderCallback, but think of async issues
582
+ * @param {Boolean} [restoreManually] When true won't restore the context after clear, in order to draw something else.
583
+ * @return {CanvasRenderingContext2D|undefined} canvas.contextTop that is either still transformed
584
+ * with the object transformMatrix, or restored to neutral transform
585
+ */
586
+ clearContextTop(
587
+ restoreManually?: boolean
588
+ ): CanvasRenderingContext2D | undefined {
589
+ if (!this.canvas) {
590
+ return;
591
+ }
592
+ const ctx = this.canvas.contextTop;
593
+ if (!ctx) {
594
+ return;
595
+ }
596
+ const v = this.canvas.viewportTransform;
597
+ ctx.save();
598
+ ctx.transform(v[0], v[1], v[2], v[3], v[4], v[5]);
599
+ this.transform(ctx);
600
+ // we add 4 pixel, to be sure to do not leave any pixel out
601
+ const width = this.width + 4,
602
+ height = this.height + 4;
603
+ ctx.clearRect(-width / 2, -height / 2, width, height);
604
+
605
+ restoreManually || ctx.restore();
606
+ return ctx;
607
+ }
608
+
609
+ /**
610
+ * This callback function is called every time _discardActiveObject or _setActiveObject
611
+ * try to to deselect this object. If the function returns true, the process is cancelled
612
+ * @param {Object} [options] options sent from the upper functions
613
+ * @param {TPointerEvent} [options.e] event if the process is generated by an event
614
+ * @param {FabricObject} [options.object] next object we are setting as active, and reason why
615
+ * this is being deselected
616
+
617
+ */
618
+ onDeselect(options?: { e?: TPointerEvent; object?: FabricObject }): boolean {
619
+ // implemented by sub-classes, as needed.
620
+ return false;
621
+ }
622
+
623
+ /**
624
+ * This callback function is called every time _discardActiveObject or _setActiveObject
625
+ * try to to select this object. If the function returns true, the process is cancelled
626
+ * @param {Object} [options] options sent from the upper functions
627
+ * @param {Event} [options.e] event if the process is generated by an event
628
+ */
629
+ onSelect(options?: { e?: TPointerEvent }): boolean {
630
+ // implemented by sub-classes, as needed.
631
+ return false;
632
+ }
633
+
634
+ /**
635
+ * Override to customize drag and drop behavior
636
+ * return true if the object currently dragged can be dropped on the target
637
+ * @public
638
+ * @param {DragEvent} e
639
+ * @returns {boolean}
640
+ */
641
+ canDrop(e: DragEvent): boolean {
642
+ return false;
643
+ }
644
+
645
+ /**
646
+ * Override to customize drag and drop behavior
647
+ * render a specific effect when an object is the source of a drag event
648
+ * example: render the selection status for the part of text that is being dragged from a text object
649
+ * @public
650
+ * @param {DragEvent} e
651
+ * @returns {boolean}
652
+ */
653
+ renderDragSourceEffect(e: DragEvent) {
654
+ // for subclasses
655
+ }
656
+
657
+ /**
658
+ * Override to customize drag and drop behavior
659
+ * render a specific effect when an object is the target of a drag event
660
+ * used to show that the underly object can receive a drop, or to show how the
661
+ * object will change when dropping. example: show the cursor where the text is about to be dropped
662
+ * @public
663
+ * @param {DragEvent} e
664
+ * @returns {boolean}
665
+ */
666
+ renderDropTargetEffect(e: DragEvent) {
667
+ // for subclasses
668
+ }
669
+ }