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,723 @@
1
+ import { Point } from '../Point';
2
+ import { FabricObject } from '../shapes/Object/FabricObject';
3
+ import type { CanvasEvents, ModifierKey, TOptionalModifierKey, TPointerEvent, Transform } from '../EventTypeDefs';
4
+ import type { TCanvasSizeOptions } from './StaticCanvas';
5
+ import { StaticCanvas } from './StaticCanvas';
6
+ import type { TMat2D, TOriginX, TOriginY, TSize } from '../typedefs';
7
+ import type { BaseBrush } from '../brushes/BaseBrush';
8
+ import type { TSVGReviver } from '../typedefs';
9
+ import { ActiveSelection } from '../shapes/ActiveSelection';
10
+ import { CanvasDOMManager } from './DOMManagers/CanvasDOMManager';
11
+ export declare const DefaultCanvasProperties: {
12
+ uniformScaling: boolean;
13
+ uniScaleKey: string;
14
+ centeredScaling: boolean;
15
+ centeredRotation: boolean;
16
+ centeredKey: string;
17
+ altActionKey: string;
18
+ selection: boolean;
19
+ selectionKey: string;
20
+ selectionColor: string;
21
+ selectionDashArray: never[];
22
+ selectionBorderColor: string;
23
+ selectionLineWidth: number;
24
+ selectionFullyContained: boolean;
25
+ hoverCursor: string;
26
+ moveCursor: string;
27
+ defaultCursor: string;
28
+ freeDrawingCursor: string;
29
+ notAllowedCursor: string;
30
+ containerClass: string;
31
+ perPixelTargetFind: boolean;
32
+ targetFindTolerance: number;
33
+ skipTargetFind: boolean;
34
+ preserveObjectStacking: boolean;
35
+ stopContextMenu: boolean;
36
+ fireRightClick: boolean;
37
+ fireMiddleClick: boolean;
38
+ enablePointerEvents: boolean;
39
+ };
40
+ /**
41
+ * Canvas class
42
+ * @class Canvas
43
+ * @extends StaticCanvas
44
+ * @tutorial {@link http://fabricjs.com/fabric-intro-part-1#canvas}
45
+ *
46
+ * @fires object:modified at the end of a transform
47
+ * @fires object:rotating while an object is being rotated from the control
48
+ * @fires object:scaling while an object is being scaled by controls
49
+ * @fires object:moving while an object is being dragged
50
+ * @fires object:skewing while an object is being skewed from the controls
51
+ *
52
+ * @fires before:transform before a transform is is started
53
+ * @fires before:selection:cleared
54
+ * @fires selection:cleared
55
+ * @fires selection:updated
56
+ * @fires selection:created
57
+ *
58
+ * @fires path:created after a drawing operation ends and the path is added
59
+ * @fires mouse:down
60
+ * @fires mouse:move
61
+ * @fires mouse:up
62
+ * @fires mouse:down:before on mouse down, before the inner fabric logic runs
63
+ * @fires mouse:move:before on mouse move, before the inner fabric logic runs
64
+ * @fires mouse:up:before on mouse up, before the inner fabric logic runs
65
+ * @fires mouse:over
66
+ * @fires mouse:out
67
+ * @fires mouse:dblclick whenever a native dbl click event fires on the canvas.
68
+ *
69
+ * @fires dragover
70
+ * @fires dragenter
71
+ * @fires dragleave
72
+ * @fires drag:enter object drag enter
73
+ * @fires drag:leave object drag leave
74
+ * @fires drop:before before drop event. Prepare for the drop event (same native event).
75
+ * @fires drop
76
+ * @fires drop:after after drop event. Run logic on canvas after event has been accepted/declined (same native event).
77
+ * @example
78
+ * let a: fabric.Object, b: fabric.Object;
79
+ * let flag = false;
80
+ * canvas.add(a, b);
81
+ * a.on('drop:before', opt => {
82
+ * // we want a to accept the drop even though it's below b in the stack
83
+ * flag = this.canDrop(opt.e);
84
+ * });
85
+ * b.canDrop = function(e) {
86
+ * !flag && this.draggableTextDelegate.canDrop(e);
87
+ * }
88
+ * b.on('dragover', opt => b.set('fill', opt.dropTarget === b ? 'pink' : 'black'));
89
+ * a.on('drop', opt => {
90
+ * opt.e.defaultPrevented // drop occurred
91
+ * opt.didDrop // drop occurred on canvas
92
+ * opt.target // drop target
93
+ * opt.target !== a && a.set('text', 'I lost');
94
+ * });
95
+ * canvas.on('drop:after', opt => {
96
+ * // inform user who won
97
+ * if(!opt.e.defaultPrevented) {
98
+ * // no winners
99
+ * }
100
+ * else if(!opt.didDrop) {
101
+ * // my objects didn't win, some other lucky object
102
+ * }
103
+ * else {
104
+ * // we have a winner it's opt.target!!
105
+ * }
106
+ * })
107
+ *
108
+ * @fires after:render at the end of the render process, receives the context in the callback
109
+ * @fires before:render at start the render process, receives the context in the callback
110
+ *
111
+ * @fires contextmenu:before
112
+ * @fires contextmenu
113
+ * @example
114
+ * let handler;
115
+ * targets.forEach(target => {
116
+ * target.on('contextmenu:before', opt => {
117
+ * // decide which target should handle the event before canvas hijacks it
118
+ * if (someCaseHappens && opt.targets.includes(target)) {
119
+ * handler = target;
120
+ * }
121
+ * });
122
+ * target.on('contextmenu', opt => {
123
+ * // do something fantastic
124
+ * });
125
+ * });
126
+ * canvas.on('contextmenu', opt => {
127
+ * if (!handler) {
128
+ * // no one takes responsibility, it's always left to me
129
+ * // let's show them how it's done!
130
+ * }
131
+ * });
132
+ *
133
+ */
134
+ export declare class SelectableCanvas<EventSpec extends CanvasEvents = CanvasEvents> extends StaticCanvas<EventSpec> {
135
+ _objects: FabricObject[];
136
+ /**
137
+ * When true, objects can be transformed by one side (unproportionally)
138
+ * when dragged on the corners that normally would not do that.
139
+ * @type Boolean
140
+ * @default
141
+ * @since fabric 4.0 // changed name and default value
142
+ */
143
+ uniformScaling: boolean;
144
+ /**
145
+ * Indicates which key switches uniform scaling.
146
+ * values: 'altKey', 'shiftKey', 'ctrlKey'.
147
+ * If `null` or 'none' or any other string that is not a modifier key
148
+ * feature is disabled.
149
+ * totally wrong named. this sounds like `uniform scaling`
150
+ * if Canvas.uniformScaling is true, pressing this will set it to false
151
+ * and viceversa.
152
+ * @since 1.6.2
153
+ * @type ModifierKey
154
+ * @default
155
+ */
156
+ uniScaleKey: TOptionalModifierKey;
157
+ /**
158
+ * When true, objects use center point as the origin of scale transformation.
159
+ * <b>Backwards incompatibility note:</b> This property replaces "centerTransform" (Boolean).
160
+ * @since 1.3.4
161
+ * @type Boolean
162
+ * @default
163
+ */
164
+ centeredScaling: boolean;
165
+ /**
166
+ * When true, objects use center point as the origin of rotate transformation.
167
+ * <b>Backwards incompatibility note:</b> This property replaces "centerTransform" (Boolean).
168
+ * @since 1.3.4
169
+ * @type Boolean
170
+ * @default
171
+ */
172
+ centeredRotation: boolean;
173
+ /**
174
+ * Indicates which key enable centered Transform
175
+ * values: 'altKey', 'shiftKey', 'ctrlKey'.
176
+ * If `null` or 'none' or any other string that is not a modifier key
177
+ * feature is disabled feature disabled.
178
+ * @since 1.6.2
179
+ * @type ModifierKey
180
+ * @default
181
+ */
182
+ centeredKey: TOptionalModifierKey;
183
+ /**
184
+ * Indicates which key enable alternate action on corner
185
+ * values: 'altKey', 'shiftKey', 'ctrlKey'.
186
+ * If `null` or 'none' or any other string that is not a modifier key
187
+ * feature is disabled feature disabled.
188
+ * @since 1.6.2
189
+ * @type ModifierKey
190
+ * @default
191
+ */
192
+ altActionKey: TOptionalModifierKey;
193
+ /**
194
+ * Indicates that canvas is interactive. This property should not be changed.
195
+ * @type Boolean
196
+ * @default
197
+ */
198
+ interactive: boolean;
199
+ /**
200
+ * Indicates whether group selection should be enabled
201
+ * @type Boolean
202
+ * @default
203
+ */
204
+ selection: boolean;
205
+ /**
206
+ * Indicates which key or keys enable multiple click selection
207
+ * Pass value as a string or array of strings
208
+ * values: 'altKey', 'shiftKey', 'ctrlKey'.
209
+ * If `null` or empty or containing any other string that is not a modifier key
210
+ * feature is disabled.
211
+ * @since 1.6.2
212
+ * @type ModifierKey|ModifierKey[]
213
+ * @default
214
+ */
215
+ selectionKey: TOptionalModifierKey | ModifierKey[];
216
+ /**
217
+ * Indicates which key enable alternative selection
218
+ * in case of target overlapping with active object
219
+ * values: 'altKey', 'shiftKey', 'ctrlKey'.
220
+ * For a series of reason that come from the general expectations on how
221
+ * things should work, this feature works only for preserveObjectStacking true.
222
+ * If `null` or 'none' or any other string that is not a modifier key
223
+ * feature is disabled.
224
+ * @since 1.6.5
225
+ * @type null|ModifierKey
226
+ * @default
227
+ */
228
+ altSelectionKey: TOptionalModifierKey;
229
+ /**
230
+ * Color of selection
231
+ * @type String
232
+ * @default
233
+ */
234
+ selectionColor: string;
235
+ /**
236
+ * Default dash array pattern
237
+ * If not empty the selection border is dashed
238
+ * @type Array
239
+ */
240
+ selectionDashArray: number[];
241
+ /**
242
+ * Color of the border of selection (usually slightly darker than color of selection itself)
243
+ * @type String
244
+ * @default
245
+ */
246
+ selectionBorderColor: string;
247
+ /**
248
+ * Width of a line used in object/group selection
249
+ * @type Number
250
+ * @default
251
+ */
252
+ selectionLineWidth: number;
253
+ /**
254
+ * Select only shapes that are fully contained in the dragged selection rectangle.
255
+ * @type Boolean
256
+ * @default
257
+ */
258
+ selectionFullyContained: boolean;
259
+ /**
260
+ * Default cursor value used when hovering over an object on canvas
261
+ * @type CSSStyleDeclaration['cursor']
262
+ * @default move
263
+ */
264
+ hoverCursor: CSSStyleDeclaration['cursor'];
265
+ /**
266
+ * Default cursor value used when moving an object on canvas
267
+ * @type CSSStyleDeclaration['cursor']
268
+ * @default move
269
+ */
270
+ moveCursor: CSSStyleDeclaration['cursor'];
271
+ /**
272
+ * Default cursor value used for the entire canvas
273
+ * @type String
274
+ * @default default
275
+ */
276
+ defaultCursor: CSSStyleDeclaration['cursor'];
277
+ /**
278
+ * Cursor value used during free drawing
279
+ * @type String
280
+ * @default crosshair
281
+ */
282
+ freeDrawingCursor: CSSStyleDeclaration['cursor'];
283
+ /**
284
+ * Cursor value used for disabled elements ( corners with disabled action )
285
+ * @type String
286
+ * @since 2.0.0
287
+ * @default not-allowed
288
+ */
289
+ notAllowedCursor: CSSStyleDeclaration['cursor'];
290
+ /**
291
+ * Default element class that's given to wrapper (div) element of canvas
292
+ * @type String
293
+ * @default
294
+ * @deprecated customize {@link CanvasDOMManager} instead or access {@link elements} directly
295
+ */
296
+ containerClass: string;
297
+ /**
298
+ * When true, object detection happens on per-pixel basis rather than on per-bounding-box
299
+ * @type Boolean
300
+ * @default
301
+ */
302
+ perPixelTargetFind: boolean;
303
+ /**
304
+ * Number of pixels around target pixel to tolerate (consider active) during object detection
305
+ * @type Number
306
+ * @default
307
+ */
308
+ targetFindTolerance: number;
309
+ /**
310
+ * When true, target detection is skipped. Target detection will return always undefined.
311
+ * click selection won't work anymore, events will fire with no targets.
312
+ * if something is selected before setting it to true, it will be deselected at the first click.
313
+ * area selection will still work. check the `selection` property too.
314
+ * if you deactivate both, you should look into staticCanvas.
315
+ * @type Boolean
316
+ * @default
317
+ */
318
+ skipTargetFind: boolean;
319
+ /**
320
+ * When true, mouse events on canvas (mousedown/mousemove/mouseup) result in free drawing.
321
+ * After mousedown, mousemove creates a shape,
322
+ * and then mouseup finalizes it and adds an instance of `fabric.Path` onto canvas.
323
+ * @tutorial {@link http://fabricjs.com/fabric-intro-part-4#free_drawing}
324
+ * @type Boolean
325
+ * @default
326
+ */
327
+ isDrawingMode: boolean;
328
+ /**
329
+ * Indicates whether objects should remain in current stack position when selected.
330
+ * When false objects are brought to top and rendered as part of the selection group
331
+ * @type Boolean
332
+ * @default
333
+ */
334
+ preserveObjectStacking: boolean;
335
+ /**
336
+ * Indicates if the right click on canvas can output the context menu or not
337
+ * @type Boolean
338
+ * @since 1.6.5
339
+ * @default
340
+ */
341
+ stopContextMenu: boolean;
342
+ /**
343
+ * Indicates if the canvas can fire right click events
344
+ * @type Boolean
345
+ * @since 1.6.5
346
+ * @default
347
+ */
348
+ fireRightClick: boolean;
349
+ /**
350
+ * Indicates if the canvas can fire middle click events
351
+ * @type Boolean
352
+ * @since 1.7.8
353
+ * @default
354
+ */
355
+ fireMiddleClick: boolean;
356
+ /**
357
+ * Keep track of the subTargets for Mouse Events
358
+ * @type FabricObject[]
359
+ */
360
+ targets: FabricObject[];
361
+ /**
362
+ * Keep track of the hovered target
363
+ * @type FabricObject | null
364
+ * @private
365
+ */
366
+ _hoveredTarget?: FabricObject;
367
+ /**
368
+ * hold the list of nested targets hovered
369
+ * @type FabricObject[]
370
+ * @private
371
+ */
372
+ _hoveredTargets: FabricObject[];
373
+ /**
374
+ * hold the list of objects to render
375
+ * @type FabricObject[]
376
+ * @private
377
+ */
378
+ _objectsToRender?: FabricObject[];
379
+ /**
380
+ * hold a referenfce to a data structure that contains information
381
+ * on the current on going transform
382
+ * @type
383
+ * @private
384
+ */
385
+ _currentTransform: Transform | null;
386
+ /**
387
+ * hold a reference to a data structure used to track the selection
388
+ * box on canvas drag
389
+ * on the current on going transform
390
+ * @type
391
+ * @private
392
+ */
393
+ protected _groupSelector: {
394
+ x: number;
395
+ y: number;
396
+ deltaX: number;
397
+ deltaY: number;
398
+ } | null;
399
+ /**
400
+ * internal flag used to understand if the context top requires a cleanup
401
+ * in case this is true, the contextTop will be cleared at the next render
402
+ * @type boolean
403
+ * @private
404
+ */
405
+ contextTopDirty: boolean;
406
+ /**
407
+ * During a mouse event we may need the pointer multiple times in multiple functions.
408
+ * _absolutePointer holds a reference to the pointer in fabricCanvas/design coordinates that is valid for the event
409
+ * lifespan. Every fabricJS mouse event create and delete the cache every time
410
+ * We do this because there are some HTML DOM inspection functions to get the actual pointer coordinates
411
+ * @type {Point}
412
+ */
413
+ protected _absolutePointer?: Point;
414
+ /**
415
+ * During a mouse event we may need the pointer multiple times in multiple functions.
416
+ * _pointer holds a reference to the pointer in html coordinates that is valid for the event
417
+ * lifespan. Every fabricJS mouse event create and delete the cache every time
418
+ * We do this because there are some HTML DOM inspection functions to get the actual pointer coordinates
419
+ * @type {Point}
420
+ */
421
+ protected _pointer?: Point;
422
+ /**
423
+ * During a mouse event we may need the target multiple times in multiple functions.
424
+ * _target holds a reference to the target that is valid for the event
425
+ * lifespan. Every fabricJS mouse event create and delete the cache every time
426
+ * @type {FabricObject}
427
+ */
428
+ protected _target?: FabricObject;
429
+ static ownDefaults: Record<string, any>;
430
+ static getDefaults(): Record<string, any>;
431
+ elements: CanvasDOMManager;
432
+ get upperCanvasEl(): HTMLCanvasElement;
433
+ get contextTop(): CanvasRenderingContext2D;
434
+ get wrapperEl(): HTMLDivElement;
435
+ private pixelFindCanvasEl;
436
+ private pixelFindContext;
437
+ protected _isCurrentlyDrawing: boolean;
438
+ freeDrawingBrush?: BaseBrush;
439
+ _activeObject?: FabricObject;
440
+ protected readonly _activeSelection: ActiveSelection;
441
+ constructor(el: string | HTMLCanvasElement, options?: {});
442
+ protected initElements(el: string | HTMLCanvasElement): void;
443
+ /**
444
+ * @private
445
+ * @param {FabricObject} obj Object that was added
446
+ */
447
+ _onObjectAdded(obj: FabricObject): void;
448
+ /**
449
+ * @private
450
+ * @param {FabricObject} obj Object that was removed
451
+ */
452
+ _onObjectRemoved(obj: FabricObject): void;
453
+ /**
454
+ * Divides objects in two groups, one to render immediately
455
+ * and one to render as activeGroup.
456
+ * @return {Array} objects to render immediately and pushes the other in the activeGroup.
457
+ */
458
+ _chooseObjectsToRender(): FabricObject[];
459
+ /**
460
+ * Renders both the top canvas and the secondary container canvas.
461
+ */
462
+ renderAll(): void;
463
+ /**
464
+ * text selection is rendered by the active text instance during the rendering cycle
465
+ */
466
+ renderTopLayer(ctx: CanvasRenderingContext2D): void;
467
+ /**
468
+ * Method to render only the top canvas.
469
+ * Also used to render the group selection box.
470
+ * Does not render text selection.
471
+ */
472
+ renderTop(): void;
473
+ /**
474
+ * Given a pointer on the canvas with a viewport applied,
475
+ * find out the pointer in object coordinates
476
+ * @private
477
+ */
478
+ _normalizePointer(object: FabricObject, pointer: Point): Point;
479
+ /**
480
+ * Set the canvas tolerance value for pixel taret find.
481
+ * Use only integer numbers.
482
+ * @private
483
+ */
484
+ setTargetFindTolerance(value: number): void;
485
+ /**
486
+ * Returns true if object is transparent at a certain location
487
+ * Clarification: this is `is target transparent at location X or are controls there`
488
+ * @TODO this seems dumb that we treat controls with transparency. we can find controls
489
+ * programmatically without painting them, the cache canvas optimization is always valid
490
+ * @param {FabricObject} target Object to check
491
+ * @param {Number} x Left coordinate
492
+ * @param {Number} y Top coordinate
493
+ * @return {Boolean}
494
+ */
495
+ isTargetTransparent(target: FabricObject, x: number, y: number): boolean;
496
+ /**
497
+ * takes an event and determines if selection key has been pressed
498
+ * @private
499
+ * @param {TPointerEvent} e Event object
500
+ */
501
+ _isSelectionKeyPressed(e: TPointerEvent): boolean;
502
+ /**
503
+ * @private
504
+ * @param {TPointerEvent} e Event object
505
+ * @param {FabricObject} target
506
+ */
507
+ _shouldClearSelection(e: TPointerEvent, target?: FabricObject): target is undefined;
508
+ /**
509
+ * This method will take in consideration a modifier key pressed and the control we are
510
+ * about to drag, and try to guess the anchor point ( origin ) of the transormation.
511
+ * This should be really in the realm of controls, and we should remove specific code for legacy
512
+ * embedded actions.
513
+ * @TODO this probably deserve discussion/rediscovery and change/refactor
514
+ * @private
515
+ * @deprecated
516
+ * @param {FabricObject} target
517
+ * @param {string} action
518
+ * @param {boolean} altKey
519
+ * @returns {boolean} true if the transformation should be centered
520
+ */
521
+ private _shouldCenterTransform;
522
+ /**
523
+ * Given the control clicked, determine the origin of the transform.
524
+ * This is bad because controls can totally have custom names
525
+ * should disappear before release 4.0
526
+ * @private
527
+ * @deprecated
528
+ */
529
+ _getOriginFromCorner(target: FabricObject, controlName: string): {
530
+ x: TOriginX;
531
+ y: TOriginY;
532
+ };
533
+ /**
534
+ * @private
535
+ * @param {Event} e Event object
536
+ * @param {FaricObject} target
537
+ */
538
+ _setupCurrentTransform(e: TPointerEvent, target: FabricObject, alreadySelected: boolean): void;
539
+ /**
540
+ * Set the cursor type of the canvas element
541
+ * @param {String} value Cursor type of the canvas element.
542
+ * @see http://www.w3.org/TR/css3-ui/#cursor
543
+ */
544
+ setCursor(value: CSSStyleDeclaration['cursor']): void;
545
+ /**
546
+ * @private
547
+ * @param {CanvasRenderingContext2D} ctx to draw the selection on
548
+ */
549
+ _drawSelection(ctx: CanvasRenderingContext2D): void;
550
+ /**
551
+ * Method that determines what object we are clicking on
552
+ * 11/09/2018 TODO: would be cool if findTarget could discern between being a full target
553
+ * or the outside part of the corner.
554
+ * @param {Event} e mouse event
555
+ * @return {FabricObject | null} the target found
556
+ */
557
+ findTarget(e: TPointerEvent): FabricObject | undefined;
558
+ /**
559
+ * Checks point is inside the object.
560
+ * @param {Object} [pointer] x,y object of point coordinates we want to check.
561
+ * @param {FabricObject} obj Object to test against
562
+ * @param {Object} [globalPointer] x,y object of point coordinates relative to canvas used to search per pixel target.
563
+ * @return {Boolean} true if point is contained within an area of given object
564
+ * @private
565
+ */
566
+ _checkTarget(pointer: Point, obj: FabricObject, globalPointer: Point): boolean;
567
+ /**
568
+ * Internal Function used to search inside objects an object that contains pointer in bounding box or that contains pointerOnCanvas when painted
569
+ * @param {Array} [objects] objects array to look into
570
+ * @param {Object} [pointer] x,y object of point coordinates we want to check.
571
+ * @return {FabricObject} **top most object from given `objects`** that contains pointer
572
+ * @private
573
+ */
574
+ _searchPossibleTargets(objects: FabricObject[], pointer: Point): FabricObject | undefined;
575
+ /**
576
+ * Function used to search inside objects an object that contains pointer in bounding box or that contains pointerOnCanvas when painted
577
+ * @see {@link fabric.Canvas#_searchPossibleTargets}
578
+ * @param {FabricObject[]} [objects] objects array to look into
579
+ * @param {Object} [pointer] x,y object of point coordinates we want to check.
580
+ * @return {FabricObject} **top most object on screen** that contains pointer
581
+ */
582
+ searchPossibleTargets(objects: FabricObject[], pointer: Point): FabricObject | undefined;
583
+ /**
584
+ * Returns pointer coordinates without the effect of the viewport
585
+ * @param {Object} pointer with "x" and "y" number values in canvas HTML coordinates
586
+ * @return {Object} object with "x" and "y" number values in fabricCanvas coordinates
587
+ */
588
+ restorePointerVpt(pointer: Point): Point;
589
+ /**
590
+ * Returns pointer coordinates relative to canvas.
591
+ * Can return coordinates with or without viewportTransform.
592
+ * ignoreVpt false gives back coordinates that represent
593
+ * the point clicked on canvas element.
594
+ * ignoreVpt true gives back coordinates after being processed
595
+ * by the viewportTransform ( sort of coordinates of what is displayed
596
+ * on the canvas where you are clicking.
597
+ * ignoreVpt true = HTMLElement coordinates relative to top,left
598
+ * ignoreVpt false, default = fabric space coordinates, the same used for shape position
599
+ * To interact with your shapes top and left you want to use ignoreVpt true
600
+ * most of the time, while ignoreVpt false will give you coordinates
601
+ * compatible with the object.oCoords system.
602
+ * of the time.
603
+ * @param {Event} e
604
+ * @param {Boolean} ignoreVpt
605
+ * @return {Point}
606
+ */
607
+ getPointer(e: TPointerEvent, ignoreVpt?: boolean): Point;
608
+ /**
609
+ * Internal use only
610
+ * @protected
611
+ */
612
+ protected _setDimensionsImpl(dimensions: TSize, options?: TCanvasSizeOptions): void;
613
+ protected _createCacheCanvas(): void;
614
+ /**
615
+ * Returns context of top canvas where interactions are drawn
616
+ * @returns {CanvasRenderingContext2D}
617
+ */
618
+ getTopContext(): CanvasRenderingContext2D;
619
+ /**
620
+ * Returns context of canvas where object selection is drawn
621
+ * @alias
622
+ * @return {CanvasRenderingContext2D}
623
+ */
624
+ getSelectionContext(): CanvasRenderingContext2D;
625
+ /**
626
+ * Returns &lt;canvas> element on which object selection is drawn
627
+ * @return {HTMLCanvasElement}
628
+ */
629
+ getSelectionElement(): HTMLCanvasElement;
630
+ /**
631
+ * Returns currently active object
632
+ * @return {FabricObject | null} active object
633
+ */
634
+ getActiveObject(): FabricObject | undefined;
635
+ /**
636
+ * Returns instance's active selection
637
+ */
638
+ getActiveSelection(): ActiveSelection;
639
+ /**
640
+ * Returns an array with the current selected objects
641
+ * @return {FabricObject[]} active objects array
642
+ */
643
+ getActiveObjects(): FabricObject[];
644
+ /**
645
+ * @private
646
+ * Compares the old activeObject with the current one and fires correct events
647
+ * @param {FabricObject[]} oldObjects old activeObject
648
+ * @param {TPointerEvent} e mouse event triggering the selection events
649
+ */
650
+ _fireSelectionEvents(oldObjects: FabricObject[], e?: TPointerEvent): void;
651
+ /**
652
+ * Sets given object as the only active object on canvas
653
+ * @param {FabricObject} object Object to set as an active one
654
+ * @param {TPointerEvent} [e] Event (passed along when firing "object:selected")
655
+ * @return {Boolean} true if the object has been selected
656
+ */
657
+ setActiveObject(object: FabricObject, e?: TPointerEvent): boolean;
658
+ /**
659
+ * This is supposed to be equivalent to setActiveObject but without firing
660
+ * any event. There is commitment to have this stay this way.
661
+ * This is the functional part of setActiveObject.
662
+ * @param {Object} object to set as active
663
+ * @param {Event} [e] Event (passed along when firing "object:selected")
664
+ * @return {Boolean} true if the object has been selected
665
+ */
666
+ _setActiveObject(object: FabricObject, e?: TPointerEvent): boolean;
667
+ /**
668
+ * This is supposed to be equivalent to discardActiveObject but without firing
669
+ * any selection events ( can still fire object transformation events ). There is commitment to have this stay this way.
670
+ * This is the functional part of discardActiveObject.
671
+ * @param {Event} [e] Event (passed along when firing "object:deselected")
672
+ * @param {Object} object the next object to set as active, reason why we are discarding this
673
+ * @return {Boolean} true if the active object has been discarded
674
+ */
675
+ _discardActiveObject(e?: TPointerEvent, object?: FabricObject): this is {
676
+ _activeObject: undefined;
677
+ };
678
+ /**
679
+ * Discards currently active object and fire events. If the function is called by fabric
680
+ * as a consequence of a mouse event, the event is passed as a parameter and
681
+ * sent to the fire function for the custom events. When used as a method the
682
+ * e param does not have any application.
683
+ * @param {event} e
684
+ * @return {Boolean} true if the active object has been discarded
685
+ */
686
+ discardActiveObject(e?: TPointerEvent): this is {
687
+ _activeObject: undefined;
688
+ };
689
+ /**
690
+ * Sets viewport transformation of this canvas instance
691
+ * @param {Array} vpt a Canvas 2D API transform matrix
692
+ */
693
+ setViewportTransform(vpt: TMat2D): void;
694
+ /**
695
+ * @override clears active selection ref and interactive canvas elements and contexts
696
+ */
697
+ destroy(): void;
698
+ /**
699
+ * Clears all contexts (background, main, top) of an instance
700
+ */
701
+ clear(): void;
702
+ /**
703
+ * Draws objects' controls (borders/controls)
704
+ * @param {CanvasRenderingContext2D} ctx Context to render controls on
705
+ */
706
+ drawControls(ctx: CanvasRenderingContext2D): void;
707
+ /**
708
+ * @private
709
+ */
710
+ _toObject(instance: FabricObject, methodName: 'toObject' | 'toDatalessObject', propertiesToInclude: string[]): Record<string, any>;
711
+ /**
712
+ * Realizes an object's group transformation on it
713
+ * @private
714
+ * @param {FabricObject} [instance] the object to transform (gets mutated)
715
+ * @returns the original values of instance which were changed
716
+ */
717
+ _realizeGroupTransformOnObject(instance: FabricObject): Partial<typeof instance>;
718
+ /**
719
+ * @private
720
+ */
721
+ _setSVGObject(markup: string[], instance: FabricObject, reviver: TSVGReviver): void;
722
+ }
723
+ //# sourceMappingURL=SelectableCanvas.d.ts.map