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,84 @@
1
+ import type { TClassProperties } from '../typedefs';
2
+ import { FabricObject } from './Object/FabricObject';
3
+ import type { FabricObjectProps, SerializedObjectProps, TProps } from './Object/types';
4
+ import type { ObjectEvents } from '../EventTypeDefs';
5
+ export declare const ellipseDefaultValues: UniqueEllipseProps;
6
+ interface UniqueEllipseProps {
7
+ rx: number;
8
+ ry: number;
9
+ }
10
+ export interface SerializedEllipseProps extends SerializedObjectProps, UniqueEllipseProps {
11
+ }
12
+ export interface EllipseProps extends FabricObjectProps, UniqueEllipseProps {
13
+ }
14
+ export declare class Ellipse<Props extends TProps<EllipseProps> = Partial<EllipseProps>, SProps extends SerializedEllipseProps = SerializedEllipseProps, EventSpec extends ObjectEvents = ObjectEvents> extends FabricObject<Props, SProps, EventSpec> implements EllipseProps {
15
+ /**
16
+ * Horizontal radius
17
+ * @type Number
18
+ * @default
19
+ */
20
+ rx: number;
21
+ /**
22
+ * Vertical radius
23
+ * @type Number
24
+ * @default
25
+ */
26
+ ry: number;
27
+ static type: string;
28
+ static cacheProperties: string[];
29
+ static ownDefaults: Record<string, any>;
30
+ static getDefaults(): {
31
+ [x: string]: any;
32
+ };
33
+ /**
34
+ * @private
35
+ * @param {String} key
36
+ * @param {*} value
37
+ * @return {Ellipse} thisArg
38
+ */
39
+ _set(key: string, value: any): this;
40
+ /**
41
+ * Returns horizontal radius of an object (according to how an object is scaled)
42
+ * @return {Number}
43
+ */
44
+ getRx(): number;
45
+ /**
46
+ * Returns Vertical radius of an object (according to how an object is scaled)
47
+ * @return {Number}
48
+ */
49
+ getRy(): number;
50
+ /**
51
+ * Returns object representation of an instance
52
+ * @param {Array} [propertiesToInclude] Any properties that you might want to additionally include in the output
53
+ * @return {Object} object representation of an instance
54
+ */
55
+ toObject<T extends Omit<Props & TClassProperties<this>, keyof SProps>, K extends keyof T = never>(propertiesToInclude?: K[]): Pick<T, K> & SProps;
56
+ /**
57
+ * Returns svg representation of an instance
58
+ * @return {Array} an array of strings with the specific svg representation
59
+ * of the instance
60
+ */
61
+ _toSVG(): (string | number)[];
62
+ /**
63
+ * @private
64
+ * @param {CanvasRenderingContext2D} ctx context to render on
65
+ */
66
+ _render(ctx: CanvasRenderingContext2D): void;
67
+ /**
68
+ * List of attribute names to account for when parsing SVG element (used by {@link Ellipse.fromElement})
69
+ * @static
70
+ * @memberOf Ellipse
71
+ * @see http://www.w3.org/TR/SVG/shapes.html#EllipseElement
72
+ */
73
+ static ATTRIBUTE_NAMES: string[];
74
+ /**
75
+ * Returns {@link Ellipse} instance from an SVG element
76
+ * @static
77
+ * @memberOf Ellipse
78
+ * @param {SVGElement} element Element to parse
79
+ * @return {Ellipse}
80
+ */
81
+ static fromElement(element: SVGElement): Promise<Ellipse<Record<string, any>, SerializedEllipseProps, ObjectEvents>>;
82
+ }
83
+ export {};
84
+ //# sourceMappingURL=Ellipse.d.ts.map
@@ -0,0 +1,407 @@
1
+ import type { CollectionEvents, ObjectEvents } from '../EventTypeDefs';
2
+ import { Point } from '../Point';
3
+ import type { TClassProperties, TSVGReviver } from '../typedefs';
4
+ import { FabricObject } from './Object/FabricObject';
5
+ import type { FabricObjectProps, SerializedObjectProps, TProps } from './Object/types';
6
+ export type LayoutContextType = 'initialization' | 'object_modified' | 'added' | 'removed' | 'layout_change' | 'imperative';
7
+ export type LayoutContext = {
8
+ type: LayoutContextType;
9
+ /**
10
+ * array of objects starting from the object that triggered the call to the current one
11
+ */
12
+ path?: Group[];
13
+ [key: string]: any;
14
+ };
15
+ export type GroupEvents = ObjectEvents & CollectionEvents & {
16
+ layout: {
17
+ context: LayoutContext;
18
+ result: LayoutResult;
19
+ diff: Point;
20
+ };
21
+ };
22
+ export type LayoutStrategy = 'fit-content' | 'fit-content-lazy' | 'fixed' | 'clip-path';
23
+ /**
24
+ * positioning and layout data **relative** to instance's parent
25
+ */
26
+ export type LayoutResult = {
27
+ /**
28
+ * new centerX as measured by the containing plane (same as `left` with `originX` set to `center`)
29
+ */
30
+ centerX: number;
31
+ /**
32
+ * new centerY as measured by the containing plane (same as `top` with `originY` set to `center`)
33
+ */
34
+ centerY: number;
35
+ /**
36
+ * correctionX to translate objects by, measured as `centerX`
37
+ */
38
+ correctionX?: number;
39
+ /**
40
+ * correctionY to translate objects by, measured as `centerY`
41
+ */
42
+ correctionY?: number;
43
+ width: number;
44
+ height: number;
45
+ };
46
+ export interface GroupOwnProps {
47
+ layout: LayoutStrategy;
48
+ subTargetCheck: boolean;
49
+ interactive: boolean;
50
+ }
51
+ export interface SerializedGroupProps extends SerializedObjectProps, GroupOwnProps {
52
+ objects: SerializedObjectProps[];
53
+ }
54
+ export interface GroupProps extends FabricObjectProps, GroupOwnProps {
55
+ }
56
+ export declare const groupDefaultValues: {
57
+ layout: string;
58
+ strokeWidth: number;
59
+ subTargetCheck: boolean;
60
+ interactive: boolean;
61
+ };
62
+ declare const Group_base: {
63
+ new (...args: any[]): {
64
+ _objects: import("../EventTypeDefs").BaseFabricObject[];
65
+ _onObjectAdded(object: import("../EventTypeDefs").BaseFabricObject): void;
66
+ _onObjectRemoved(object: import("../EventTypeDefs").BaseFabricObject): void;
67
+ _onStackOrderChanged(object: import("../EventTypeDefs").BaseFabricObject): void;
68
+ add(...objects: import("../EventTypeDefs").BaseFabricObject[]): number;
69
+ insertAt(index: number, ...objects: import("../EventTypeDefs").BaseFabricObject[]): number;
70
+ remove(...objects: import("../EventTypeDefs").BaseFabricObject[]): import("../EventTypeDefs").BaseFabricObject[];
71
+ forEachObject(callback: (object: import("../EventTypeDefs").BaseFabricObject, index: number, array: import("../EventTypeDefs").BaseFabricObject[]) => any): void;
72
+ getObjects(...types: string[]): import("../EventTypeDefs").BaseFabricObject[];
73
+ item(index: number): import("../EventTypeDefs").BaseFabricObject;
74
+ isEmpty(): boolean;
75
+ size(): number;
76
+ contains(object: import("../EventTypeDefs").BaseFabricObject, deep?: boolean | undefined): boolean;
77
+ complexity(): number;
78
+ sendObjectToBack(object: import("../EventTypeDefs").BaseFabricObject): boolean;
79
+ bringObjectToFront(object: import("../EventTypeDefs").BaseFabricObject): boolean;
80
+ sendObjectBackwards(object: import("../EventTypeDefs").BaseFabricObject, intersecting?: boolean | undefined): boolean;
81
+ bringObjectForward(object: import("../EventTypeDefs").BaseFabricObject, intersecting?: boolean | undefined): boolean;
82
+ moveObjectTo(object: import("../EventTypeDefs").BaseFabricObject, index: number): boolean;
83
+ findNewLowerIndex(object: import("../EventTypeDefs").BaseFabricObject, idx: number, intersecting?: boolean | undefined): number;
84
+ findNewUpperIndex(object: import("../EventTypeDefs").BaseFabricObject, idx: number, intersecting?: boolean | undefined): number;
85
+ collectObjects({ left, top, width, height }: import("../typedefs").TBBox, { includeIntersecting }?: {
86
+ includeIntersecting?: boolean | undefined;
87
+ }): import("./Object/InteractiveObject").InteractiveFabricObject<Partial<FabricObjectProps>, SerializedObjectProps, ObjectEvents>[];
88
+ };
89
+ } & {
90
+ new (options?: GroupProps): FabricObject<GroupProps, SerializedGroupProps, GroupEvents>;
91
+ ownDefaults: Record<string, any>;
92
+ getDefaults(): Record<string, any>;
93
+ stateProperties: string[];
94
+ cacheProperties: string[];
95
+ type: string;
96
+ _fromObject<S extends import("./Object/Object").FabricObject<Partial<import("./Object/types/ObjectProps").ObjectProps>, SerializedObjectProps, ObjectEvents>>(object: Record<string, unknown>, { extraParam, ...options }?: import("../typedefs").Abortable & {
97
+ extraParam?: string | undefined;
98
+ }): Promise<S>;
99
+ fromObject<T extends TProps<SerializedObjectProps>>(object: T, options?: import("../typedefs").Abortable | undefined): Promise<import("./Object/Object").FabricObject<Partial<import("./Object/types/ObjectProps").ObjectProps>, SerializedObjectProps, ObjectEvents>>;
100
+ };
101
+ /**
102
+ * @fires object:added
103
+ * @fires object:removed
104
+ * @fires layout once layout completes
105
+ */
106
+ export declare class Group extends Group_base {
107
+ /**
108
+ * Specifies the **layout strategy** for instance
109
+ * Used by `getLayoutStrategyResult` to calculate layout
110
+ * `fit-content`, `fit-content-lazy`, `fixed`, `clip-path` are supported out of the box
111
+ * @default
112
+ */
113
+ layout: LayoutStrategy;
114
+ /**
115
+ * Used to optimize performance
116
+ * set to `false` if you don't need contained objects to be targets of events
117
+ * @default
118
+ * @type boolean
119
+ */
120
+ subTargetCheck: boolean;
121
+ /**
122
+ * Used to allow targeting of object inside groups.
123
+ * set to true if you want to select an object inside a group.\
124
+ * **REQUIRES** `subTargetCheck` set to true
125
+ * @default
126
+ * @type boolean
127
+ */
128
+ interactive: boolean;
129
+ /**
130
+ * Used internally to optimize performance
131
+ * Once an object is selected, instance is rendered without the selected object.
132
+ * This way instance is cached only once for the entire interaction with the selected object.
133
+ * @private
134
+ */
135
+ protected _activeObjects: FabricObject[];
136
+ static stateProperties: string[];
137
+ static type: string;
138
+ static ownDefaults: Record<string, any>;
139
+ private __objectSelectionTracker;
140
+ private __objectSelectionDisposer;
141
+ private _firstLayoutDone;
142
+ static getDefaults(): Record<string, any>;
143
+ /**
144
+ * Constructor
145
+ *
146
+ * @param {FabricObject[]} [objects] instance objects
147
+ * @param {Object} [options] Options object
148
+ * @param {boolean} [objectsRelativeToGroup] true if objects exist in group coordinate plane
149
+ */
150
+ constructor(objects?: FabricObject[], options?: Partial<GroupProps>, objectsRelativeToGroup?: boolean);
151
+ /**
152
+ * Checks if object can enter group and logs relevant warnings
153
+ * @private
154
+ * @param {FabricObject} object
155
+ * @returns
156
+ */
157
+ canEnterGroup(object: FabricObject): boolean;
158
+ /**
159
+ * Override this method to enhance performance (for groups with a lot of objects).
160
+ * If Overriding, be sure not pass illegal objects to group - it will break your app.
161
+ * @private
162
+ */
163
+ protected _filterObjectsBeforeEnteringGroup(objects: FabricObject[]): FabricObject<Partial<FabricObjectProps>, SerializedObjectProps, ObjectEvents>[];
164
+ /**
165
+ * Add objects
166
+ * @param {...FabricObject[]} objects
167
+ */
168
+ add(...objects: FabricObject[]): number;
169
+ /**
170
+ * Inserts an object into collection at specified index
171
+ * @param {FabricObject[]} objects Object to insert
172
+ * @param {Number} index Index to insert object at
173
+ */
174
+ insertAt(index: number, ...objects: FabricObject[]): number;
175
+ /**
176
+ * Remove objects
177
+ * @param {...FabricObject[]} objects
178
+ * @returns {FabricObject[]} removed objects
179
+ */
180
+ remove(...objects: FabricObject[]): import("../EventTypeDefs").BaseFabricObject[];
181
+ _onObjectAdded(object: FabricObject): void;
182
+ _onRelativeObjectAdded(object: FabricObject): void;
183
+ /**
184
+ * @private
185
+ * @param {FabricObject} object
186
+ * @param {boolean} [removeParentTransform] true if object should exit group without applying group's transform to it
187
+ */
188
+ _onObjectRemoved(object: FabricObject, removeParentTransform?: boolean): void;
189
+ /**
190
+ * @private
191
+ * @param {'added'|'removed'} type
192
+ * @param {FabricObject[]} targets
193
+ */
194
+ _onAfterObjectsChange(type: 'added' | 'removed', targets: FabricObject[]): void;
195
+ _onStackOrderChanged(): void;
196
+ /**
197
+ * @private
198
+ * @param {string} key
199
+ * @param {*} value
200
+ */
201
+ _set(key: string, value: any): this;
202
+ /**
203
+ * @private
204
+ */
205
+ _shouldSetNestedCoords(): boolean;
206
+ /**
207
+ * Remove all objects
208
+ * @returns {FabricObject[]} removed objects
209
+ */
210
+ removeAll(): import("../EventTypeDefs").BaseFabricObject[];
211
+ /**
212
+ * invalidates layout on object modified
213
+ * @private
214
+ */
215
+ __objectMonitor(ev: ObjectEvents['modified']): void;
216
+ /**
217
+ * keeps track of the selected objects
218
+ * @private
219
+ */
220
+ __objectSelectionMonitor<T extends boolean>(selected: T, { target: object }: ObjectEvents[T extends true ? 'selected' : 'deselected']): void;
221
+ /**
222
+ * @private
223
+ * @param {boolean} watch
224
+ * @param {FabricObject} object
225
+ */
226
+ _watchObject(watch: boolean, object: FabricObject): void;
227
+ /**
228
+ * @private
229
+ * @param {FabricObject} object
230
+ * @param {boolean} [removeParentTransform] true if object is in canvas coordinate plane
231
+ * @returns {boolean} true if object entered group
232
+ */
233
+ enterGroup(object: FabricObject, removeParentTransform?: boolean): boolean;
234
+ /**
235
+ * @private
236
+ * @param {FabricObject} object
237
+ * @param {boolean} [removeParentTransform] true if object is in canvas coordinate plane
238
+ */
239
+ _enterGroup(object: FabricObject, removeParentTransform?: boolean): void;
240
+ /**
241
+ * @private
242
+ * @param {FabricObject} object
243
+ * @param {boolean} [removeParentTransform] true if object should exit group without applying group's transform to it
244
+ */
245
+ exitGroup(object: FabricObject, removeParentTransform?: boolean): void;
246
+ /**
247
+ * @private
248
+ * @param {FabricObject} object
249
+ * @param {boolean} [removeParentTransform] true if object should exit group without applying group's transform to it
250
+ */
251
+ _exitGroup(object: FabricObject, removeParentTransform?: boolean): void;
252
+ /**
253
+ * Decide if the object should cache or not. Create its own cache level
254
+ * needsItsOwnCache should be used when the object drawing method requires
255
+ * a cache step. None of the fabric classes requires it.
256
+ * Generally you do not cache objects in groups because the group is already cached.
257
+ * @return {Boolean}
258
+ */
259
+ shouldCache(): boolean;
260
+ /**
261
+ * Check if this object or a child object will cast a shadow
262
+ * @return {Boolean}
263
+ */
264
+ willDrawShadow(): boolean;
265
+ /**
266
+ * Check if instance or its group are caching, recursively up
267
+ * @return {Boolean}
268
+ */
269
+ isOnACache(): boolean;
270
+ /**
271
+ * Execute the drawing operation for an object on a specified context
272
+ * @param {CanvasRenderingContext2D} ctx Context to render on
273
+ */
274
+ drawObject(ctx: CanvasRenderingContext2D): void;
275
+ /**
276
+ * @override
277
+ * @return {Boolean}
278
+ */
279
+ setCoords(): void;
280
+ /**
281
+ * Renders instance on a given context
282
+ * @param {CanvasRenderingContext2D} ctx context to render instance on
283
+ */
284
+ render(ctx: CanvasRenderingContext2D): void;
285
+ /**
286
+ * @public
287
+ * @param {Partial<LayoutResult> & { layout?: string }} [context] pass values to use for layout calculations
288
+ */
289
+ triggerLayout<T extends this['layout']>(context?: Partial<LayoutResult> & {
290
+ layout?: T;
291
+ }): void;
292
+ /**
293
+ * @private
294
+ * @param {FabricObject} object
295
+ * @param {Point} diff
296
+ */
297
+ _adjustObjectPosition(object: FabricObject, diff: Point): void;
298
+ /**
299
+ * initial layout logic:
300
+ * calculate bbox of objects (if necessary) and translate it according to options received from the constructor (left, top, width, height)
301
+ * so it is placed in the center of the bbox received from the constructor
302
+ *
303
+ * @private
304
+ * @param {LayoutContext} context
305
+ */
306
+ _applyLayoutStrategy(context: LayoutContext): void;
307
+ /**
308
+ * Override this method to customize layout.
309
+ * If you need to run logic once layout completes use `onLayout`
310
+ * @public
311
+ * @param {string} layoutDirective
312
+ * @param {FabricObject[]} objects
313
+ * @param {LayoutContext} context
314
+ * @returns {LayoutResult | undefined}
315
+ */
316
+ getLayoutStrategyResult<T extends this['layout']>(layoutDirective: T, objects: FabricObject[], context: LayoutContext): any;
317
+ /**
318
+ * Override this method to customize layout.
319
+ * A wrapper around {@link Group#getObjectsBoundingBox}
320
+ * @public
321
+ * @param {string} layoutDirective
322
+ * @param {FabricObject[]} objects
323
+ * @param {LayoutContext} context
324
+ * @returns {LayoutResult | undefined}
325
+ */
326
+ prepareBoundingBox<T extends this['layout']>(layoutDirective: T, objects: FabricObject[], context: LayoutContext): any;
327
+ /**
328
+ * Calculates center taking into account originX, originY while not being sure that width/height are initialized
329
+ * @public
330
+ * @param {string} layoutDirective
331
+ * @param {FabricObject[]} objects
332
+ * @param {LayoutContext} context
333
+ * @returns {LayoutResult | undefined}
334
+ */
335
+ prepareInitialBoundingBox<T extends this['layout']>(layoutDirective: T, objects: FabricObject[], context: LayoutContext): {
336
+ centerX: number;
337
+ centerY: number;
338
+ correctionX: number;
339
+ correctionY: number;
340
+ width: number;
341
+ height: number;
342
+ } | undefined;
343
+ /**
344
+ * Calculate the bbox of objects relative to instance's containing plane
345
+ * @public
346
+ * @param {FabricObject[]} objects
347
+ * @returns {LayoutResult | null} bounding box
348
+ */
349
+ getObjectsBoundingBox(objects: FabricObject[], ignoreOffset?: boolean): LayoutResult | null;
350
+ /**
351
+ * Hook that is called once layout has completed.
352
+ * Provided for layout customization, override if necessary.
353
+ * Complements `getLayoutStrategyResult`, which is called at the beginning of layout.
354
+ * @public
355
+ * @param {LayoutContext} context layout context
356
+ * @param {LayoutResult} result layout result
357
+ */
358
+ onLayout(context: LayoutContext, result: LayoutResult): void;
359
+ /**
360
+ *
361
+ * @private
362
+ * @param {'toObject'|'toDatalessObject'} [method]
363
+ * @param {string[]} [propertiesToInclude] Any properties that you might want to additionally include in the output
364
+ * @returns {FabricObject[]} serialized objects
365
+ */
366
+ __serializeObjects(method: 'toObject' | 'toDatalessObject', propertiesToInclude?: string[]): any[];
367
+ /**
368
+ * Returns object representation of an instance
369
+ * @param {string[]} [propertiesToInclude] Any properties that you might want to additionally include in the output
370
+ * @return {Object} object representation of an instance
371
+ */
372
+ toObject<T extends Omit<GroupProps & TClassProperties<this>, keyof SerializedGroupProps>, K extends keyof T = never>(propertiesToInclude?: K[]): Pick<T, K> & SerializedGroupProps;
373
+ toString(): string;
374
+ dispose(): void;
375
+ /**
376
+ * @private
377
+ */
378
+ _createSVGBgRect(reviver?: TSVGReviver): string;
379
+ /**
380
+ * Returns svg representation of an instance
381
+ * @param {TSVGReviver} [reviver] Method for further parsing of svg representation.
382
+ * @return {String} svg representation of an instance
383
+ */
384
+ _toSVG(reviver?: TSVGReviver): string[];
385
+ /**
386
+ * Returns styles-string for svg-export, specific version for group
387
+ * @return {String}
388
+ */
389
+ getSvgStyles(): string;
390
+ /**
391
+ * Returns svg clipPath representation of an instance
392
+ * @param {Function} [reviver] Method for further parsing of svg representation.
393
+ * @return {String} svg representation of an instance
394
+ */
395
+ toClipPathSVG(reviver?: TSVGReviver): string;
396
+ /**
397
+ * @todo support loading from svg
398
+ * @private
399
+ * @static
400
+ * @memberOf Group
401
+ * @param {Object} object Object to create a group from
402
+ * @returns {Promise<Group>}
403
+ */
404
+ static fromObject<T extends TProps<SerializedGroupProps>>({ objects, ...options }: T): Promise<Group>;
405
+ }
406
+ export {};
407
+ //# sourceMappingURL=Group.d.ts.map
@@ -0,0 +1,78 @@
1
+ import type { DragEventData, DropEventData, TPointerEvent } from '../../EventTypeDefs';
2
+ import type { IText } from './IText';
3
+ /**
4
+ * #### Dragging IText/Textbox Lifecycle
5
+ * - {@link start} is called from `mousedown` {@link IText#_mouseDownHandler} and determines if dragging should start by testing {@link isPointerOverSelection}
6
+ * - if true `mousedown` {@link IText#_mouseDownHandler} is blocked to keep selection
7
+ * - if the pointer moves, canvas fires numerous mousemove {@link Canvas#_onMouseMove} that we make sure **aren't** prevented ({@link IText#shouldStartDragging}) in order for the window to start a drag session
8
+ * - once/if the session starts canvas calls {@link onDragStart} on the active object to determine if dragging should occur
9
+ * - canvas fires relevant drag events that are handled by the handlers defined in this scope
10
+ * - {@link end} is called from `mouseup` {@link IText#mouseUpHandler}, blocking IText default click behavior
11
+ * - in case the drag session didn't occur, {@link end} handles a click, since logic to do so was blocked during `mousedown`
12
+ */
13
+ export declare class DraggableTextDelegate {
14
+ readonly target: IText;
15
+ private __mouseDownInPlace;
16
+ private __dragStartFired;
17
+ private __isDraggingOver;
18
+ private __dragStartSelection?;
19
+ private __dragImageDisposer?;
20
+ private _dispose?;
21
+ constructor(target: IText);
22
+ isPointerOverSelection(e: TPointerEvent): boolean;
23
+ /**
24
+ * @public override this method to disable dragging and default to mousedown logic
25
+ */
26
+ start(e: TPointerEvent): boolean;
27
+ /**
28
+ * @public override this method to disable dragging without discarding selection
29
+ */
30
+ isActive(): boolean;
31
+ /**
32
+ * Ends interaction and sets cursor in case of a click
33
+ * @returns true if was active
34
+ */
35
+ end(e: TPointerEvent): boolean;
36
+ getDragStartSelection(): {
37
+ selectionStart: number;
38
+ selectionEnd: number;
39
+ } | undefined;
40
+ /**
41
+ * Override to customize the drag image
42
+ * https://developer.mozilla.org/en-US/docs/Web/API/DataTransfer/setDragImage
43
+ */
44
+ setDragImage(e: DragEvent, { selectionStart, selectionEnd, }: {
45
+ selectionStart: number;
46
+ selectionEnd: number;
47
+ }): void;
48
+ /**
49
+ * @returns {boolean} determines whether {@link target} should/shouldn't become a drag source
50
+ */
51
+ onDragStart(e: DragEvent): boolean;
52
+ /**
53
+ * use {@link targetCanDrop} to respect overriding
54
+ * @returns {boolean} determines whether {@link target} should/shouldn't become a drop target
55
+ */
56
+ canDrop(e: DragEvent): boolean;
57
+ /**
58
+ * in order to respect overriding {@link IText#canDrop} we call that instead of calling {@link canDrop} directly
59
+ */
60
+ protected targetCanDrop(e: DragEvent): boolean;
61
+ dragEnterHandler({ e }: DragEventData): void;
62
+ dragOverHandler(ev: DragEventData): void;
63
+ dragLeaveHandler(): void;
64
+ /**
65
+ * Override the `text/plain | application/fabric` types of {@link DragEvent#dataTransfer}
66
+ * in order to change the drop value or to customize styling respectively, by listening to the `drop:before` event
67
+ * https://developer.mozilla.org/en-US/docs/Web/API/HTML_Drag_and_Drop_API/Drag_operations#performing_a_drop
68
+ */
69
+ dropHandler(ev: DropEventData): void;
70
+ /**
71
+ * fired only on the drag source after drop (if occurred)
72
+ * handle changes to the drag source in case of a drop on another object or a cancellation
73
+ * https://developer.mozilla.org/en-US/docs/Web/API/HTML_Drag_and_Drop_API/Drag_operations#finishing_a_drag
74
+ */
75
+ dragEndHandler({ e }: DragEventData): void;
76
+ dispose(): void;
77
+ }
78
+ //# sourceMappingURL=DraggableTextDelegate.d.ts.map