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,106 @@
1
+ export { cos } from './misc/cos';
2
+ export { sin } from './misc/sin';
3
+ export {
4
+ rotateVector,
5
+ createVector,
6
+ calcAngleBetweenVectors,
7
+ getUnitVector,
8
+ getBisector,
9
+ } from './misc/vectors';
10
+ export {
11
+ degreesToRadians,
12
+ radiansToDegrees,
13
+ } from './misc/radiansDegreesConversion';
14
+ export { rotatePoint } from './misc/rotatePoint';
15
+ export * from './misc/projectStroke';
16
+ export {
17
+ transformPoint,
18
+ invertTransform,
19
+ composeMatrix,
20
+ qrDecompose,
21
+ createTranslateMatrix,
22
+ createRotateMatrix,
23
+ createScaleMatrix,
24
+ createSkewXMatrix,
25
+ createSkewYMatrix,
26
+ calcDimensionsMatrix,
27
+ multiplyTransformMatrices,
28
+ multiplyTransformMatrixArray,
29
+ isIdentityMatrix,
30
+ } from './misc/matrix';
31
+ export type { TextStyleArray } from './misc/textStyles';
32
+ export {
33
+ stylesFromArray,
34
+ stylesToArray,
35
+ hasStyleChanged,
36
+ } from './misc/textStyles';
37
+ export {
38
+ createCanvasElement,
39
+ createImage,
40
+ copyCanvasElement,
41
+ toDataURL,
42
+ } from './misc/dom';
43
+ export { toFixed } from './misc/toFixed';
44
+ export {
45
+ matrixToSVG,
46
+ parsePreserveAspectRatioAttribute,
47
+ parseUnit,
48
+ getSvgAttributes,
49
+ } from './misc/svgParsing';
50
+ export { groupSVGElements } from './misc/groupSVGElements';
51
+ export { findScaleToFit, findScaleToCover } from './misc/findScaleTo';
52
+ export { capValue } from './misc/capValue';
53
+ export {
54
+ saveObjectTransform,
55
+ resetObjectTransform,
56
+ addTransformToObject,
57
+ applyTransformToObject,
58
+ removeTransformFromObject,
59
+ sizeAfterTransform,
60
+ } from './misc/objectTransforms';
61
+ export { makeBoundingBoxFromPoints } from './misc/boundingBoxFromPoints';
62
+ export {
63
+ calcPlaneChangeMatrix,
64
+ sendPointToPlane,
65
+ transformPointRelativeToCanvas,
66
+ sendObjectToPlane,
67
+ } from './misc/planeChange';
68
+ export * as string from './lang_string';
69
+ export type {
70
+ EnlivenObjectOptions,
71
+ LoadImageOptions,
72
+ } from './misc/objectEnlive';
73
+ export {
74
+ loadImage,
75
+ enlivenObjects,
76
+ enlivenObjectEnlivables,
77
+ } from './misc/objectEnlive';
78
+ export { pick } from './misc/pick';
79
+ export * from './path/typedefs';
80
+ export {
81
+ joinPath,
82
+ parsePath,
83
+ makePathSimpler,
84
+ getSmoothPathFromPoints,
85
+ getPathSegmentsInfo,
86
+ getBoundsOfCurve,
87
+ getPointOnPath,
88
+ transformPath,
89
+ getRegularPolygonPath,
90
+ } from './path';
91
+ export { setStyle } from './dom_style';
92
+ export { isTouchEvent, getPointer } from './dom_event';
93
+ export { isTransparent } from './misc/isTransparent';
94
+ export { mergeClipPaths } from './misc/mergeClipPaths';
95
+ export * from './animation';
96
+ export * as ease from './animation/easing';
97
+ export {
98
+ requestAnimFrame,
99
+ cancelAnimFrame,
100
+ } from './animation/AnimationFrameProvider';
101
+ export { removeFromArray } from './internals/removeFromArray';
102
+ export { getRandomInt } from './internals/getRandomInt';
103
+ export { request } from './dom_request';
104
+
105
+ // for test compatibility. We don't want to export it
106
+ export { removeTransformMatrixForSvgParsing } from './transform_matrix_removal';
@@ -0,0 +1,16 @@
1
+ import { cleanupSvgAttribute } from './cleanupSvgAttribute';
2
+
3
+ describe('cleanupSvgAttribute', () => {
4
+ it('add space around a single number', () => {
5
+ const cleaned = cleanupSvgAttribute('1');
6
+ expect(cleaned).toBe(' 1 ');
7
+ });
8
+ it('replace multiple spaces with a single one', () => {
9
+ const cleaned = cleanupSvgAttribute(' 1 ');
10
+ expect(cleaned).toBe(' 1 ');
11
+ });
12
+ it('replace commas with spaces or commas and multiple spaces with a single space', () => {
13
+ const cleaned = cleanupSvgAttribute('1,2 , 4');
14
+ expect(cleaned).toBe(' 1 2 4 ');
15
+ });
16
+ });
@@ -0,0 +1,8 @@
1
+ import { reNum } from '../../parser/constants';
2
+
3
+ export const cleanupSvgAttribute = (attributeValue: string) =>
4
+ attributeValue
5
+ .replace(new RegExp(`(${reNum})`, 'gi'), ' $1 ')
6
+ // replace annoying commas and arbitrary whitespace with single spaces
7
+ .replace(/,/gi, ' ')
8
+ .replace(/\s+/gi, ' ');
@@ -0,0 +1,16 @@
1
+ import { cloneDeep } from './cloneDeep';
2
+
3
+ describe('cloneDeep', () => {
4
+ it('clones an object deeply', () => {
5
+ const testObject = {
6
+ a: {
7
+ b: 3,
8
+ },
9
+ array: [1, 2, 3, 4],
10
+ test: '123',
11
+ };
12
+ const cloned = cloneDeep(testObject);
13
+ expect(cloned).toEqual(testObject);
14
+ expect(cloned).not.toBe(testObject);
15
+ });
16
+ });
@@ -0,0 +1,2 @@
1
+ export const cloneDeep = <T extends object>(object: T): T =>
2
+ JSON.parse(JSON.stringify(object));
@@ -0,0 +1,33 @@
1
+ import { getRandomInt } from './getRandomInt';
2
+
3
+ const originalMathRandom = global.Math.random;
4
+
5
+ describe('getRandomInt', () => {
6
+ beforeAll(() => {
7
+ global.Math.random = jest.fn(() => 0.1);
8
+ });
9
+ afterAll(() => {
10
+ global.Math.random = originalMathRandom;
11
+ });
12
+ it('return a number between min and max', () => {
13
+ (global.Math.random as jest.Mock).mockReturnValue(0.1);
14
+ const semiRandom = getRandomInt(0, 10);
15
+ expect(semiRandom).toBe(1);
16
+ });
17
+ it('it could return min', () => {
18
+ (global.Math.random as jest.Mock).mockReturnValue(0);
19
+ const semiRandom = getRandomInt(4, 9);
20
+ expect(semiRandom).toBe(4);
21
+ });
22
+ it('it can return max when approaching 1', () => {
23
+ (global.Math.random as jest.Mock).mockReturnValue(0.999999999999999);
24
+ const semiRandom = getRandomInt(4, 9);
25
+ expect(semiRandom).toBe(9);
26
+ });
27
+ it('thanks to js sillyness could also go out of bounds', () => {
28
+ // eslint-disable-next-line @typescript-eslint/no-loss-of-precision
29
+ (global.Math.random as jest.Mock).mockReturnValue(0.9999999999999999999);
30
+ const semiRandom = getRandomInt(4, 9);
31
+ expect(semiRandom).toBe(10);
32
+ });
33
+ });
@@ -0,0 +1,8 @@
1
+ /**
2
+ * Returns random number between 2 specified ones.
3
+ * @param {Number} min lower limit
4
+ * @param {Number} max upper limit
5
+ * @return {Number} random value (between min and max)
6
+ */
7
+ export const getRandomInt = (min: number, max: number): number =>
8
+ Math.floor(Math.random() * (max - min + 1)) + min;
@@ -0,0 +1,9 @@
1
+ /**
2
+ *
3
+ * @param value value to check if NaN
4
+ * @param [valueIfNaN]
5
+ * @returns `fallback` is `value is NaN
6
+ */
7
+ export const ifNaN = (value: number, valueIfNaN?: number) => {
8
+ return isNaN(value) && typeof valueIfNaN === 'number' ? valueIfNaN : value;
9
+ };
@@ -0,0 +1,3 @@
1
+ export { getRandomInt } from './getRandomInt';
2
+ export { ifNaN } from './ifNaN';
3
+ export { removeFromArray } from './removeFromArray';
@@ -0,0 +1,14 @@
1
+ /**
2
+ * Removes value from an array.
3
+ * Presence of value (and its position in an array) is determined via `Array.prototype.indexOf`
4
+ * @param {Array} array
5
+ * @param {*} value
6
+ * @return {Array} original array
7
+ */
8
+ export const removeFromArray = <T>(array: T[], value: T): T[] => {
9
+ const idx = array.indexOf(value);
10
+ if (idx !== -1) {
11
+ array.splice(idx, 1);
12
+ }
13
+ return array;
14
+ };
@@ -0,0 +1,3 @@
1
+ let id = 0;
2
+
3
+ export const uid = () => id++;
@@ -0,0 +1,79 @@
1
+ /**
2
+ * Capitalizes a string
3
+ * @param {String} string String to capitalize
4
+ * @param {Boolean} [firstLetterOnly] If true only first letter is capitalized
5
+ * and other letters stay untouched, if false first letter is capitalized
6
+ * and other letters are converted to lowercase.
7
+ * @return {String} Capitalized version of a string
8
+ */
9
+ export const capitalize = (string: string, firstLetterOnly = false): string =>
10
+ `${string.charAt(0).toUpperCase()}${
11
+ firstLetterOnly ? string.slice(1) : string.slice(1).toLowerCase()
12
+ }`;
13
+
14
+ /**
15
+ * Escapes XML in a string
16
+ * @param {String} string String to escape
17
+ * @return {String} Escaped version of a string
18
+ */
19
+ export const escapeXml = (string: string): string =>
20
+ string
21
+ .replace(/&/g, '&amp;')
22
+ .replace(/"/g, '&quot;')
23
+ .replace(/'/g, '&apos;')
24
+ .replace(/</g, '&lt;')
25
+ .replace(/>/g, '&gt;');
26
+
27
+ /**
28
+ * Divide a string in the user perceived single units
29
+ * @param {String} textstring String to escape
30
+ * @return {Array} array containing the graphemes
31
+ */
32
+ export const graphemeSplit = (textstring: string): string[] => {
33
+ const graphemes = [];
34
+ for (let i = 0, chr; i < textstring.length; i++) {
35
+ if ((chr = getWholeChar(textstring, i)) === false) {
36
+ continue;
37
+ }
38
+ graphemes.push(chr as string);
39
+ }
40
+ return graphemes;
41
+ };
42
+
43
+ // taken from mdn in the charAt doc page.
44
+ const getWholeChar = (str: string, i: number): string | boolean => {
45
+ const code = str.charCodeAt(i);
46
+ if (isNaN(code)) {
47
+ return ''; // Position not found
48
+ }
49
+ if (code < 0xd800 || code > 0xdfff) {
50
+ return str.charAt(i);
51
+ }
52
+
53
+ // High surrogate (could change last hex to 0xDB7F to treat high private
54
+ // surrogates as single characters)
55
+ if (0xd800 <= code && code <= 0xdbff) {
56
+ if (str.length <= i + 1) {
57
+ throw 'High surrogate without following low surrogate';
58
+ }
59
+ const next = str.charCodeAt(i + 1);
60
+ if (0xdc00 > next || next > 0xdfff) {
61
+ throw 'High surrogate without following low surrogate';
62
+ }
63
+ return str.charAt(i) + str.charAt(i + 1);
64
+ }
65
+ // Low surrogate (0xDC00 <= code && code <= 0xDFFF)
66
+ if (i === 0) {
67
+ throw 'Low surrogate without preceding high surrogate';
68
+ }
69
+ const prev = str.charCodeAt(i - 1);
70
+
71
+ // (could change last hex to 0xDB7F to treat high private
72
+ // surrogates as single characters)
73
+ if (0xd800 > prev || prev > 0xdbff) {
74
+ throw 'Low surrogate without preceding high surrogate';
75
+ }
76
+ // We can pass over low surrogates now as the second component
77
+ // in a pair which we have already processed
78
+ return false;
79
+ };
@@ -0,0 +1,38 @@
1
+ import type { XY } from '../../Point';
2
+ import { Point } from '../../Point';
3
+ import type { TBBox } from '../../typedefs';
4
+
5
+ /**
6
+ * Calculates bounding box (left, top, width, height) from given `points`
7
+ * @param {XY[]} points
8
+ * @return {Object} Object with left, top, width, height properties
9
+ */
10
+ export const makeBoundingBoxFromPoints = (points: XY[]): TBBox => {
11
+ if (points.length === 0) {
12
+ return {
13
+ left: 0,
14
+ top: 0,
15
+ width: 0,
16
+ height: 0,
17
+ };
18
+ }
19
+
20
+ const { min, max } = points.reduce(
21
+ ({ min, max }, curr) => {
22
+ return {
23
+ min: min.min(curr),
24
+ max: max.max(curr),
25
+ };
26
+ },
27
+ { min: new Point(points[0]), max: new Point(points[0]) }
28
+ );
29
+
30
+ const size = max.subtract(min);
31
+
32
+ return {
33
+ left: min.x,
34
+ top: min.y,
35
+ width: size.x,
36
+ height: size.y,
37
+ };
38
+ };
@@ -0,0 +1,2 @@
1
+ export const capValue = (min: number, value: number, max: number) =>
2
+ Math.max(min, Math.min(value, max));
@@ -0,0 +1,24 @@
1
+ import type { TRadian } from '../../typedefs';
2
+ import { halfPI } from '../../constants';
3
+
4
+ /**
5
+ * Calculate the cos of an angle, avoiding returning floats for known results
6
+ * This function is here just to avoid getting 0.999999999999999 when dealing
7
+ * with numbers that are really 1 or 0.
8
+ * @param {TRadian} angle the angle
9
+ * @return {Number} the cosin value for angle.
10
+ */
11
+ export const cos = (angle: TRadian): number => {
12
+ if (angle === 0) {
13
+ return 1;
14
+ }
15
+ const angleSlice = Math.abs(angle) / halfPI;
16
+ switch (angleSlice) {
17
+ case 1:
18
+ case 3:
19
+ return 0;
20
+ case 2:
21
+ return -1;
22
+ }
23
+ return Math.cos(angle);
24
+ };
@@ -0,0 +1,55 @@
1
+ import { getFabricDocument } from '../../env';
2
+ import type { ImageFormat } from '../../typedefs';
3
+ /**
4
+ * Creates canvas element
5
+ * @return {CanvasElement} initialized canvas element
6
+ */
7
+ export const createCanvasElement = (): HTMLCanvasElement => {
8
+ const element = getFabricDocument().createElement('canvas');
9
+ if (!element || typeof element.getContext === 'undefined') {
10
+ throw new Error('Failed to create `canvas` element');
11
+ }
12
+ return element;
13
+ };
14
+
15
+ /**
16
+ * Creates image element (works on client and node)
17
+ * @return {HTMLImageElement} HTML image element
18
+ */
19
+ export const createImage = (): HTMLImageElement =>
20
+ getFabricDocument().createElement('img');
21
+
22
+ /**
23
+ * Creates a canvas element that is a copy of another and is also painted
24
+ * @param {CanvasElement} canvas to copy size and content of
25
+ * @return {CanvasElement} initialized canvas element
26
+ */
27
+ export const copyCanvasElement = (
28
+ canvas: HTMLCanvasElement
29
+ ): HTMLCanvasElement => {
30
+ const newCanvas = createCanvasElement();
31
+ newCanvas.width = canvas.width;
32
+ newCanvas.height = canvas.height;
33
+ newCanvas.getContext('2d')?.drawImage(canvas, 0, 0);
34
+ return newCanvas;
35
+ };
36
+
37
+ /**
38
+ * since 2.6.0 moved from canvas instance to utility.
39
+ * possibly useless
40
+ * @param {CanvasElement} canvasEl to copy size and content of
41
+ * @param {String} format 'jpeg' or 'png', in some browsers 'webp' is ok too
42
+ * @param {Number} quality <= 1 and > 0
43
+ * @return {String} data url
44
+ */
45
+ export const toDataURL = (
46
+ canvasEl: HTMLCanvasElement,
47
+ format: ImageFormat,
48
+ quality: number
49
+ ) => canvasEl.toDataURL(`image/${format}`, quality);
50
+
51
+ export const isHTMLCanvas = (
52
+ canvas: HTMLCanvasElement | string
53
+ ): canvas is HTMLCanvasElement => {
54
+ return !!canvas && (canvas as HTMLCanvasElement).getContext !== undefined;
55
+ };
@@ -0,0 +1,29 @@
1
+ import type { TSize } from '../../typedefs';
2
+
3
+ /**
4
+ * Finds the scale for the object source to fit inside the object destination,
5
+ * keeping aspect ratio intact.
6
+ * respect the total allowed area for the cache.
7
+ * @param {TSize} source natural unscaled size of the object
8
+ * @param {TSize} destination natural unscaled size of the object
9
+ * @return {Number} scale factor to apply to source to fit into destination
10
+ */
11
+ export const findScaleToFit = (source: TSize, destination: TSize) =>
12
+ Math.min(
13
+ destination.width / source.width,
14
+ destination.height / source.height
15
+ );
16
+
17
+ /**
18
+ * Finds the scale for the object source to cover entirely the object destination,
19
+ * keeping aspect ratio intact.
20
+ * respect the total allowed area for the cache.
21
+ * @param {TSize} source natural unscaled size of the object
22
+ * @param {TSize} destination natural unscaled size of the object
23
+ * @return {Number} scale factor to apply to source to cover destination
24
+ */
25
+ export const findScaleToCover = (source: TSize, destination: TSize) =>
26
+ Math.max(
27
+ destination.width / source.width,
28
+ destination.height / source.height
29
+ );
@@ -0,0 +1,15 @@
1
+ import type { FabricObject } from '../../shapes/Object/FabricObject';
2
+ import { Group } from '../../shapes/Group';
3
+
4
+ /**
5
+ * Groups SVG elements (usually those retrieved from SVG document)
6
+ * @static
7
+ * @param {FabricObject[]} elements FabricObject(s) parsed from svg, to group
8
+ * @return {FabricObject | Group}
9
+ */
10
+ export const groupSVGElements = (elements: FabricObject[]) => {
11
+ if (elements && elements.length === 1) {
12
+ return elements[0];
13
+ }
14
+ return new Group(elements);
15
+ };
@@ -0,0 +1,28 @@
1
+ /**
2
+ * Returns true if context has transparent pixel
3
+ * at specified location (taking tolerance into account)
4
+ * @param {CanvasRenderingContext2D} ctx context
5
+ * @param {Number} x x coordinate in canvasElementCoordinate, not fabric space. integer
6
+ * @param {Number} y y coordinate in canvasElementCoordinate, not fabric space. integer
7
+ * @param {Number} tolerance Tolerance pixels around the point, not alpha tolerance, integer
8
+ * @return {boolean} true if transparent
9
+ */
10
+ export const isTransparent = (
11
+ ctx: CanvasRenderingContext2D,
12
+ x: number,
13
+ y: number,
14
+ tolerance: number
15
+ ): boolean => {
16
+ tolerance = Math.round(tolerance);
17
+ const size = tolerance * 2 + 1;
18
+ const { data } = ctx.getImageData(x - tolerance, y - tolerance, size, size);
19
+
20
+ // Split image data - for tolerance > 1, pixelDataSize = 4;
21
+ for (let i = 3; i < data.length; i += 4) {
22
+ const alphaChannel = data[i];
23
+ if (alphaChannel > 0) {
24
+ return false;
25
+ }
26
+ }
27
+ return true;
28
+ };