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,385 @@
1
+ /* eslint-disable @typescript-eslint/no-unused-vars */
2
+ import { halfPI } from '../constants';
3
+ import type {
4
+ ControlActionHandler,
5
+ TPointerEvent,
6
+ TransformActionHandler,
7
+ } from '../EventTypeDefs';
8
+ import { Point } from '../Point';
9
+ import type { InteractiveFabricObject } from '../shapes/Object/InteractiveObject';
10
+ import type { TDegree, TMat2D } from '../typedefs';
11
+ import { cos } from '../util/misc/cos';
12
+ import { degreesToRadians } from '../util/misc/radiansDegreesConversion';
13
+ import { sin } from '../util/misc/sin';
14
+ import type { ControlRenderingStyleOverride } from './controlRendering';
15
+ import { renderCircleControl, renderSquareControl } from './controlRendering';
16
+
17
+ export class Control {
18
+ /**
19
+ * keep track of control visibility.
20
+ * mainly for backward compatibility.
21
+ * if you do not want to see a control, you can remove it
22
+ * from the control set.
23
+ * @type {Boolean}
24
+ * @default true
25
+ */
26
+ visible = true;
27
+
28
+ /**
29
+ * Name of the action that the control will likely execute.
30
+ * This is optional. FabricJS uses to identify what the user is doing for some
31
+ * extra optimizations. If you are writing a custom control and you want to know
32
+ * somewhere else in the code what is going on, you can use this string here.
33
+ * you can also provide a custom getActionName if your control run multiple actions
34
+ * depending on some external state.
35
+ * default to scale since is the most common, used on 4 corners by default
36
+ * @type {String}
37
+ * @default 'scale'
38
+ */
39
+ actionName = 'scale';
40
+
41
+ /**
42
+ * Drawing angle of the control.
43
+ * NOT used for now, but name marked as needed for internal logic
44
+ * example: to reuse the same drawing function for different rotated controls
45
+ * @type {Number}
46
+ * @default 0
47
+ */
48
+ angle = 0;
49
+
50
+ /**
51
+ * Relative position of the control. X
52
+ * 0,0 is the center of the Object, while -0.5 (left) or 0.5 (right) are the extremities
53
+ * of the bounding box.
54
+ * @type {Number}
55
+ * @default 0
56
+ */
57
+ x = 0;
58
+
59
+ /**
60
+ * Relative position of the control. Y
61
+ * 0,0 is the center of the Object, while -0.5 (top) or 0.5 (bottom) are the extremities
62
+ * of the bounding box.
63
+ * @type {Number}
64
+ * @default 0
65
+ */
66
+ y = 0;
67
+
68
+ /**
69
+ * Horizontal offset of the control from the defined position. In pixels
70
+ * Positive offset moves the control to the right, negative to the left.
71
+ * It used when you want to have position of control that does not scale with
72
+ * the bounding box. Example: rotation control is placed at x:0, y: 0.5 on
73
+ * the boundind box, with an offset of 30 pixels vertically. Those 30 pixels will
74
+ * stay 30 pixels no matter how the object is big. Another example is having 2
75
+ * controls in the corner, that stay in the same position when the object scale.
76
+ * of the bounding box.
77
+ * @type {Number}
78
+ * @default 0
79
+ */
80
+ offsetX = 0;
81
+
82
+ /**
83
+ * Vertical offset of the control from the defined position. In pixels
84
+ * Positive offset moves the control to the bottom, negative to the top.
85
+ * @type {Number}
86
+ * @default 0
87
+ */
88
+ offsetY = 0;
89
+
90
+ /**
91
+ * Sets the length of the control. If null, defaults to object's cornerSize.
92
+ * Expects both sizeX and sizeY to be set when set.
93
+ * @type {?Number}
94
+ * @default null
95
+ */
96
+ sizeX: number | null = null;
97
+
98
+ /**
99
+ * Sets the height of the control. If null, defaults to object's cornerSize.
100
+ * Expects both sizeX and sizeY to be set when set.
101
+ * @type {?Number}
102
+ * @default null
103
+ */
104
+ sizeY: number | null = null;
105
+
106
+ /**
107
+ * Sets the length of the touch area of the control. If null, defaults to object's touchCornerSize.
108
+ * Expects both touchSizeX and touchSizeY to be set when set.
109
+ * @type {?Number}
110
+ * @default null
111
+ */
112
+ touchSizeX: number | null = null;
113
+
114
+ /**
115
+ * Sets the height of the touch area of the control. If null, defaults to object's touchCornerSize.
116
+ * Expects both touchSizeX and touchSizeY to be set when set.
117
+ * @type {?Number}
118
+ * @default null
119
+ */
120
+ touchSizeY: number | null = null;
121
+
122
+ /**
123
+ * Css cursor style to display when the control is hovered.
124
+ * if the method `cursorStyleHandler` is provided, this property is ignored.
125
+ * @type {String}
126
+ * @default 'crosshair'
127
+ */
128
+ cursorStyle = 'crosshair';
129
+
130
+ /**
131
+ * If controls has an offsetY or offsetX, draw a line that connects
132
+ * the control to the bounding box
133
+ * @type {Boolean}
134
+ * @default false
135
+ */
136
+ withConnection = false;
137
+
138
+ constructor(options: Partial<Control>) {
139
+ Object.assign(this, options);
140
+ }
141
+
142
+ /**
143
+ * The control actionHandler, provide one to handle action ( control being moved )
144
+ * @param {Event} eventData the native mouse event
145
+ * @param {Transform} transformData properties of the current transform
146
+ * @param {Number} x x position of the cursor
147
+ * @param {Number} y y position of the cursor
148
+ * @return {Boolean} true if the action/event modified the object
149
+ */
150
+ declare actionHandler: TransformActionHandler;
151
+
152
+ /**
153
+ * The control handler for mouse down, provide one to handle mouse down on control
154
+ * @param {Event} eventData the native mouse event
155
+ * @param {Transform} transformData properties of the current transform
156
+ * @param {Number} x x position of the cursor
157
+ * @param {Number} y y position of the cursor
158
+ * @return {Boolean} true if the action/event modified the object
159
+ */
160
+ declare mouseDownHandler?: ControlActionHandler;
161
+
162
+ /**
163
+ * The control mouseUpHandler, provide one to handle an effect on mouse up.
164
+ * @param {Event} eventData the native mouse event
165
+ * @param {Transform} transformData properties of the current transform
166
+ * @param {Number} x x position of the cursor
167
+ * @param {Number} y y position of the cursor
168
+ * @return {Boolean} true if the action/event modified the object
169
+ */
170
+ declare mouseUpHandler?: ControlActionHandler;
171
+
172
+ shouldActivate(controlKey: string, fabricObject: InteractiveFabricObject) {
173
+ // TODO: locking logic can be handled here instead of in the control handler logic
174
+ return (
175
+ fabricObject.canvas?.getActiveObject() === fabricObject &&
176
+ fabricObject.isControlVisible(controlKey)
177
+ );
178
+ }
179
+
180
+ /**
181
+ * Returns control actionHandler
182
+ * @param {Event} eventData the native mouse event
183
+ * @param {FabricObject} fabricObject on which the control is displayed
184
+ * @param {Control} control control for which the action handler is being asked
185
+ * @return {Function} the action handler
186
+ */
187
+ getActionHandler(
188
+ eventData: TPointerEvent,
189
+ fabricObject: InteractiveFabricObject,
190
+ control: Control
191
+ ): TransformActionHandler | undefined {
192
+ return this.actionHandler;
193
+ }
194
+
195
+ /**
196
+ * Returns control mouseDown handler
197
+ * @param {Event} eventData the native mouse event
198
+ * @param {FabricObject} fabricObject on which the control is displayed
199
+ * @param {Control} control control for which the action handler is being asked
200
+ * @return {Function} the action handler
201
+ */
202
+ getMouseDownHandler(
203
+ eventData: TPointerEvent,
204
+ fabricObject: InteractiveFabricObject,
205
+ control: Control
206
+ ): ControlActionHandler | undefined {
207
+ return this.mouseDownHandler;
208
+ }
209
+
210
+ /**
211
+ * Returns control mouseUp handler.
212
+ * During actions the fabricObject or the control can be of different obj
213
+ * @param {Event} eventData the native mouse event
214
+ * @param {FabricObject} fabricObject on which the control is displayed
215
+ * @param {Control} control control for which the action handler is being asked
216
+ * @return {Function} the action handler
217
+ */
218
+ getMouseUpHandler(
219
+ eventData: TPointerEvent,
220
+ fabricObject: InteractiveFabricObject,
221
+ control: Control
222
+ ): ControlActionHandler | undefined {
223
+ return this.mouseUpHandler;
224
+ }
225
+
226
+ /**
227
+ * Returns control cursorStyle for css using cursorStyle. If you need a more elaborate
228
+ * function you can pass one in the constructor
229
+ * the cursorStyle property
230
+ * @param {Event} eventData the native mouse event
231
+ * @param {Control} control the current control ( likely this)
232
+ * @param {FabricObject} object on which the control is displayed
233
+ * @return {String}
234
+ */
235
+ cursorStyleHandler(
236
+ eventData: TPointerEvent,
237
+ control: Control,
238
+ fabricObject: InteractiveFabricObject
239
+ ) {
240
+ return control.cursorStyle;
241
+ }
242
+
243
+ /**
244
+ * Returns the action name. The basic implementation just return the actionName property.
245
+ * @param {Event} eventData the native mouse event
246
+ * @param {Control} control the current control ( likely this)
247
+ * @param {FabricObject} object on which the control is displayed
248
+ * @return {String}
249
+ */
250
+ getActionName(
251
+ eventData: TPointerEvent,
252
+ control: Control,
253
+ fabricObject: InteractiveFabricObject
254
+ ) {
255
+ return control.actionName;
256
+ }
257
+
258
+ /**
259
+ * Returns controls visibility
260
+ * @param {FabricObject} object on which the control is displayed
261
+ * @param {String} controlKey key where the control is memorized on the
262
+ * @return {Boolean}
263
+ */
264
+ getVisibility(fabricObject: InteractiveFabricObject, controlKey: string) {
265
+ return fabricObject._controlsVisibility?.[controlKey] ?? this.visible;
266
+ }
267
+
268
+ /**
269
+ * Sets controls visibility
270
+ * @param {Boolean} visibility for the object
271
+ * @return {Void}
272
+ */
273
+ setVisibility(
274
+ visibility: boolean,
275
+ name: string,
276
+ fabricObject: InteractiveFabricObject
277
+ ) {
278
+ this.visible = visibility;
279
+ }
280
+
281
+ positionHandler(
282
+ dim: Point,
283
+ finalMatrix: TMat2D,
284
+ fabricObject: InteractiveFabricObject,
285
+ currentControl: Control
286
+ ) {
287
+ return new Point(
288
+ this.x * dim.x + this.offsetX,
289
+ this.y * dim.y + this.offsetY
290
+ ).transform(finalMatrix);
291
+ }
292
+
293
+ /**
294
+ * Returns the coords for this control based on object values.
295
+ * @param {Number} objectAngle angle from the fabric object holding the control
296
+ * @param {Number} objectCornerSize cornerSize from the fabric object holding the control (or touchCornerSize if
297
+ * isTouch is true)
298
+ * @param {Number} centerX x coordinate where the control center should be
299
+ * @param {Number} centerY y coordinate where the control center should be
300
+ * @param {boolean} isTouch true if touch corner, false if normal corner
301
+ */
302
+ calcCornerCoords(
303
+ objectAngle: TDegree,
304
+ objectCornerSize: number,
305
+ centerX: number,
306
+ centerY: number,
307
+ isTouch: boolean
308
+ ) {
309
+ let cosHalfOffset, sinHalfOffset, cosHalfOffsetComp, sinHalfOffsetComp;
310
+ const xSize = isTouch ? this.touchSizeX : this.sizeX,
311
+ ySize = isTouch ? this.touchSizeY : this.sizeY;
312
+ if (xSize && ySize && xSize !== ySize) {
313
+ // handle rectangular corners
314
+ const controlTriangleAngle = Math.atan2(ySize, xSize);
315
+ const cornerHypotenuse = Math.sqrt(xSize * xSize + ySize * ySize) / 2;
316
+ const newTheta = controlTriangleAngle - degreesToRadians(objectAngle);
317
+ const newThetaComp =
318
+ halfPI - controlTriangleAngle - degreesToRadians(objectAngle);
319
+ cosHalfOffset = cornerHypotenuse * cos(newTheta);
320
+ sinHalfOffset = cornerHypotenuse * sin(newTheta);
321
+ // use complementary angle for two corners
322
+ cosHalfOffsetComp = cornerHypotenuse * cos(newThetaComp);
323
+ sinHalfOffsetComp = cornerHypotenuse * sin(newThetaComp);
324
+ } else {
325
+ // handle square corners
326
+ // use default object corner size unless size is defined
327
+ const cornerSize = xSize && ySize ? xSize : objectCornerSize;
328
+ const cornerHypotenuse = cornerSize * Math.SQRT1_2;
329
+ // complementary angles are equal since they're both 45 degrees
330
+ const newTheta = degreesToRadians(45 - objectAngle);
331
+ cosHalfOffset = cosHalfOffsetComp = cornerHypotenuse * cos(newTheta);
332
+ sinHalfOffset = sinHalfOffsetComp = cornerHypotenuse * sin(newTheta);
333
+ }
334
+
335
+ return {
336
+ tl: new Point(centerX - sinHalfOffsetComp, centerY - cosHalfOffsetComp),
337
+ tr: new Point(centerX + cosHalfOffset, centerY - sinHalfOffset),
338
+ bl: new Point(centerX - cosHalfOffset, centerY + sinHalfOffset),
339
+ br: new Point(centerX + sinHalfOffsetComp, centerY + cosHalfOffsetComp),
340
+ };
341
+ }
342
+
343
+ /**
344
+ * Render function for the control.
345
+ * When this function runs the context is unscaled. unrotate. Just retina scaled.
346
+ * all the functions will have to translate to the point left,top before starting Drawing
347
+ * if they want to draw a control where the position is detected.
348
+ * left and top are the result of the positionHandler function
349
+ * @param {RenderingContext2D} ctx the context where the control will be drawn
350
+ * @param {Number} left position of the canvas where we are about to render the control.
351
+ * @param {Number} top position of the canvas where we are about to render the control.
352
+ * @param {Object} styleOverride
353
+ * @param {FabricObject} fabricObject the object where the control is about to be rendered
354
+ */
355
+ render(
356
+ ctx: CanvasRenderingContext2D,
357
+ left: number,
358
+ top: number,
359
+ styleOverride: ControlRenderingStyleOverride | undefined,
360
+ fabricObject: InteractiveFabricObject
361
+ ) {
362
+ styleOverride = styleOverride || {};
363
+ switch (styleOverride.cornerStyle || fabricObject.cornerStyle) {
364
+ case 'circle':
365
+ renderCircleControl.call(
366
+ this,
367
+ ctx,
368
+ left,
369
+ top,
370
+ styleOverride,
371
+ fabricObject
372
+ );
373
+ break;
374
+ default:
375
+ renderSquareControl.call(
376
+ this,
377
+ ctx,
378
+ left,
379
+ top,
380
+ styleOverride,
381
+ fabricObject
382
+ );
383
+ }
384
+ }
385
+ }
@@ -0,0 +1,53 @@
1
+ import type { TransformActionHandler } from '../EventTypeDefs';
2
+ import { CENTER, LEFT, RIGHT } from '../constants';
3
+ import { getLocalPoint, isTransformCentered } from './util';
4
+ import { wrapWithFireEvent } from './wrapWithFireEvent';
5
+ import { wrapWithFixedAnchor } from './wrapWithFixedAnchor';
6
+
7
+ /**
8
+ * Action handler to change object's width
9
+ * Needs to be wrapped with `wrapWithFixedAnchor` to be effective
10
+ * @param {Event} eventData javascript event that is doing the transform
11
+ * @param {Object} transform javascript object containing a series of information around the current transform
12
+ * @param {number} x current mouse x position, canvas normalized
13
+ * @param {number} y current mouse y position, canvas normalized
14
+ * @return {Boolean} true if some change happened
15
+ */
16
+ export const changeObjectWidth: TransformActionHandler = (
17
+ eventData,
18
+ transform,
19
+ x,
20
+ y
21
+ ) => {
22
+ const localPoint = getLocalPoint(
23
+ transform,
24
+ transform.originX,
25
+ transform.originY,
26
+ x,
27
+ y
28
+ );
29
+ // make sure the control changes width ONLY from it's side of target
30
+ if (
31
+ transform.originX === CENTER ||
32
+ (transform.originX === RIGHT && localPoint.x < 0) ||
33
+ (transform.originX === LEFT && localPoint.x > 0)
34
+ ) {
35
+ const { target } = transform,
36
+ strokePadding =
37
+ target.strokeWidth / (target.strokeUniform ? target.scaleX : 1),
38
+ multiplier = isTransformCentered(transform) ? 2 : 1,
39
+ oldWidth = target.width,
40
+ newWidth = Math.ceil(
41
+ Math.abs((localPoint.x * multiplier) / target.scaleX) - strokePadding
42
+ );
43
+ target.set('width', Math.max(newWidth, 0));
44
+ // check against actual target width in case `newWidth` was rejected
45
+ return oldWidth !== target.width;
46
+ }
47
+ return false;
48
+ };
49
+
50
+ export const changeWidth = wrapWithFireEvent(
51
+ 'resizing',
52
+ wrapWithFixedAnchor(changeObjectWidth)
53
+ );
@@ -0,0 +1,105 @@
1
+ import { changeWidth } from './changeWidth';
2
+ import { Control } from './Control';
3
+ import { rotationStyleHandler, rotationWithSnapping } from './rotate';
4
+ import { scaleCursorStyleHandler, scalingEqually } from './scale';
5
+ import {
6
+ scaleOrSkewActionName,
7
+ scaleSkewCursorStyleHandler,
8
+ scalingXOrSkewingY,
9
+ scalingYOrSkewingX,
10
+ } from './scaleSkew';
11
+
12
+ // use this function if you want to generate new controls for every instance
13
+ export const createObjectDefaultControls = () => ({
14
+ ml: new Control({
15
+ x: -0.5,
16
+ y: 0,
17
+ cursorStyleHandler: scaleSkewCursorStyleHandler,
18
+ actionHandler: scalingXOrSkewingY,
19
+ getActionName: scaleOrSkewActionName,
20
+ }),
21
+
22
+ mr: new Control({
23
+ x: 0.5,
24
+ y: 0,
25
+ cursorStyleHandler: scaleSkewCursorStyleHandler,
26
+ actionHandler: scalingXOrSkewingY,
27
+ getActionName: scaleOrSkewActionName,
28
+ }),
29
+
30
+ mb: new Control({
31
+ x: 0,
32
+ y: 0.5,
33
+ cursorStyleHandler: scaleSkewCursorStyleHandler,
34
+ actionHandler: scalingYOrSkewingX,
35
+ getActionName: scaleOrSkewActionName,
36
+ }),
37
+
38
+ mt: new Control({
39
+ x: 0,
40
+ y: -0.5,
41
+ cursorStyleHandler: scaleSkewCursorStyleHandler,
42
+ actionHandler: scalingYOrSkewingX,
43
+ getActionName: scaleOrSkewActionName,
44
+ }),
45
+
46
+ tl: new Control({
47
+ x: -0.5,
48
+ y: -0.5,
49
+ cursorStyleHandler: scaleCursorStyleHandler,
50
+ actionHandler: scalingEqually,
51
+ }),
52
+
53
+ tr: new Control({
54
+ x: 0.5,
55
+ y: -0.5,
56
+ cursorStyleHandler: scaleCursorStyleHandler,
57
+ actionHandler: scalingEqually,
58
+ }),
59
+
60
+ bl: new Control({
61
+ x: -0.5,
62
+ y: 0.5,
63
+ cursorStyleHandler: scaleCursorStyleHandler,
64
+ actionHandler: scalingEqually,
65
+ }),
66
+
67
+ br: new Control({
68
+ x: 0.5,
69
+ y: 0.5,
70
+ cursorStyleHandler: scaleCursorStyleHandler,
71
+ actionHandler: scalingEqually,
72
+ }),
73
+
74
+ mtr: new Control({
75
+ x: 0,
76
+ y: -0.5,
77
+ actionHandler: rotationWithSnapping,
78
+ cursorStyleHandler: rotationStyleHandler,
79
+ offsetY: -40,
80
+ withConnection: true,
81
+ actionName: 'rotate',
82
+ }),
83
+ });
84
+
85
+ export const createResizeControls = () => ({
86
+ mr: new Control({
87
+ x: 0.5,
88
+ y: 0,
89
+ actionHandler: changeWidth,
90
+ cursorStyleHandler: scaleSkewCursorStyleHandler,
91
+ actionName: 'resizing',
92
+ }),
93
+ ml: new Control({
94
+ x: -0.5,
95
+ y: 0,
96
+ actionHandler: changeWidth,
97
+ cursorStyleHandler: scaleSkewCursorStyleHandler,
98
+ actionName: 'resizing',
99
+ }),
100
+ });
101
+
102
+ export const createTextboxDefaultControls = () => ({
103
+ ...createObjectDefaultControls(),
104
+ ...createResizeControls(),
105
+ });
@@ -0,0 +1,138 @@
1
+ import { twoMathPi } from '../constants';
2
+ import type { InteractiveFabricObject } from '../shapes/Object/InteractiveObject';
3
+ import { degreesToRadians } from '../util/misc/radiansDegreesConversion';
4
+ import type { Control } from './Control';
5
+
6
+ export type ControlRenderingStyleOverride = Partial<
7
+ Pick<
8
+ InteractiveFabricObject,
9
+ | 'cornerStyle'
10
+ | 'cornerSize'
11
+ | 'cornerColor'
12
+ | 'cornerStrokeColor'
13
+ | 'cornerDashArray'
14
+ | 'transparentCorners'
15
+ >
16
+ >;
17
+
18
+ export type ControlRenderer = (
19
+ ctx: CanvasRenderingContext2D,
20
+ left: number,
21
+ top: number,
22
+ styleOverride: ControlRenderingStyleOverride,
23
+ fabricObject: InteractiveFabricObject
24
+ ) => void;
25
+
26
+ /**
27
+ * Render a round control, as per fabric features.
28
+ * This function is written to respect object properties like transparentCorners, cornerSize
29
+ * cornerColor, cornerStrokeColor
30
+ * plus the addition of offsetY and offsetX.
31
+ * @param {CanvasRenderingContext2D} ctx context to render on
32
+ * @param {Number} left x coordinate where the control center should be
33
+ * @param {Number} top y coordinate where the control center should be
34
+ * @param {Object} styleOverride override for FabricObject controls style
35
+ * @param {FabricObject} fabricObject the fabric object for which we are rendering controls
36
+ */
37
+ export function renderCircleControl(
38
+ this: Control,
39
+ ctx: CanvasRenderingContext2D,
40
+ left: number,
41
+ top: number,
42
+ styleOverride: ControlRenderingStyleOverride,
43
+ fabricObject: InteractiveFabricObject
44
+ ) {
45
+ styleOverride = styleOverride || {};
46
+ const xSize =
47
+ this.sizeX || styleOverride.cornerSize || fabricObject.cornerSize,
48
+ ySize = this.sizeY || styleOverride.cornerSize || fabricObject.cornerSize,
49
+ transparentCorners =
50
+ typeof styleOverride.transparentCorners !== 'undefined'
51
+ ? styleOverride.transparentCorners
52
+ : fabricObject.transparentCorners,
53
+ methodName = transparentCorners ? 'stroke' : 'fill',
54
+ stroke =
55
+ !transparentCorners &&
56
+ (styleOverride.cornerStrokeColor || fabricObject.cornerStrokeColor);
57
+ let myLeft = left,
58
+ myTop = top,
59
+ size;
60
+ ctx.save();
61
+ ctx.fillStyle = styleOverride.cornerColor || fabricObject.cornerColor || '';
62
+ ctx.strokeStyle =
63
+ styleOverride.cornerStrokeColor || fabricObject.cornerStrokeColor || '';
64
+ // TODO: use proper ellipse code.
65
+ if (xSize > ySize) {
66
+ size = xSize;
67
+ ctx.scale(1.0, ySize / xSize);
68
+ myTop = (top * xSize) / ySize;
69
+ } else if (ySize > xSize) {
70
+ size = ySize;
71
+ ctx.scale(xSize / ySize, 1.0);
72
+ myLeft = (left * ySize) / xSize;
73
+ } else {
74
+ size = xSize;
75
+ }
76
+ // this is still wrong
77
+ ctx.lineWidth = 1;
78
+ ctx.beginPath();
79
+ ctx.arc(myLeft, myTop, size / 2, 0, twoMathPi, false);
80
+ ctx[methodName]();
81
+ if (stroke) {
82
+ ctx.stroke();
83
+ }
84
+ ctx.restore();
85
+ }
86
+
87
+ /**
88
+ * Render a square control, as per fabric features.
89
+ * This function is written to respect object properties like transparentCorners, cornerSize
90
+ * cornerColor, cornerStrokeColor
91
+ * plus the addition of offsetY and offsetX.
92
+ * @param {CanvasRenderingContext2D} ctx context to render on
93
+ * @param {Number} left x coordinate where the control center should be
94
+ * @param {Number} top y coordinate where the control center should be
95
+ * @param {Object} styleOverride override for FabricObject controls style
96
+ * @param {FabricObject} fabricObject the fabric object for which we are rendering controls
97
+ */
98
+ export function renderSquareControl(
99
+ this: Control,
100
+ ctx: CanvasRenderingContext2D,
101
+ left: number,
102
+ top: number,
103
+ styleOverride: ControlRenderingStyleOverride,
104
+ fabricObject: InteractiveFabricObject
105
+ ) {
106
+ styleOverride = styleOverride || {};
107
+ const xSize =
108
+ this.sizeX || styleOverride.cornerSize || fabricObject.cornerSize,
109
+ ySize = this.sizeY || styleOverride.cornerSize || fabricObject.cornerSize,
110
+ transparentCorners =
111
+ typeof styleOverride.transparentCorners !== 'undefined'
112
+ ? styleOverride.transparentCorners
113
+ : fabricObject.transparentCorners,
114
+ methodName = transparentCorners ? 'stroke' : 'fill',
115
+ stroke =
116
+ !transparentCorners &&
117
+ (styleOverride.cornerStrokeColor || fabricObject.cornerStrokeColor),
118
+ xSizeBy2 = xSize / 2,
119
+ ySizeBy2 = ySize / 2;
120
+ ctx.save();
121
+ ctx.fillStyle = styleOverride.cornerColor || fabricObject.cornerColor || '';
122
+ ctx.strokeStyle =
123
+ styleOverride.cornerStrokeColor || fabricObject.cornerStrokeColor || '';
124
+ // this is still wrong
125
+ ctx.lineWidth = 1;
126
+ ctx.translate(left, top);
127
+ // angle is relative to canvas plane
128
+ const angle = fabricObject.getTotalAngle();
129
+ ctx.rotate(degreesToRadians(angle));
130
+ // this does not work, and fixed with ( && ) does not make sense.
131
+ // to have real transparent corners we need the controls on upperCanvas
132
+ // transparentCorners || ctx.clearRect(-xSizeBy2, -ySizeBy2, xSize, ySize);
133
+ ctx[`${methodName}Rect`](-xSizeBy2, -ySizeBy2, xSize, ySize);
134
+ if (stroke) {
135
+ ctx.strokeRect(-xSizeBy2, -ySizeBy2, xSize, ySize);
136
+ }
137
+ ctx.restore();
138
+ }