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,1039 @@
1
+ import { cache } from '../../cache';
2
+ import { config } from '../../config';
3
+ import { halfPI, PiBy180 } from '../../constants';
4
+ import type { TMat2D, TRadian, TRectBounds } from '../../typedefs';
5
+ import { cos } from '../misc/cos';
6
+ import { multiplyTransformMatrices, transformPoint } from '../misc/matrix';
7
+ import { sin } from '../misc/sin';
8
+ import { toFixed } from '../misc/toFixed';
9
+ import type {
10
+ TCurveInfo,
11
+ TComplexPathData,
12
+ TParsedAbsoluteCubicCurveCommand,
13
+ TParsedCubicCurveCommand,
14
+ TPathSegmentInfo,
15
+ TPointAngle,
16
+ TSimpleParsedCommand,
17
+ TSimplePathData,
18
+ TPathSegmentCommandInfo,
19
+ TComplexParsedCommand,
20
+ TPathSegmentInfoCommon,
21
+ TEndPathInfo,
22
+ TParsedArcCommand,
23
+ } from './typedefs';
24
+ import type { XY } from '../../Point';
25
+ import { Point } from '../../Point';
26
+ import { rePathCommand } from './regex';
27
+ import { cleanupSvgAttribute } from '../internals/cleanupSvgAttribute';
28
+
29
+ /**
30
+ * Commands that may be repeated
31
+ */
32
+ const repeatedCommands: Record<string, string | undefined> = {
33
+ m: 'l',
34
+ M: 'L',
35
+ };
36
+
37
+ /**
38
+ * Convert an arc of a rotated ellipse to a Bezier Curve
39
+ * @param {TRadian} theta1 start of the arc
40
+ * @param {TRadian} theta2 end of the arc
41
+ * @param cosTh cosine of the angle of rotation
42
+ * @param sinTh sine of the angle of rotation
43
+ * @param rx x-axis radius (before rotation)
44
+ * @param ry y-axis radius (before rotation)
45
+ * @param cx1 center x of the ellipse
46
+ * @param cy1 center y of the ellipse
47
+ * @param mT
48
+ * @param fromX starting point of arc x
49
+ * @param fromY starting point of arc y
50
+ */
51
+ const segmentToBezier = (
52
+ theta1: TRadian,
53
+ theta2: TRadian,
54
+ cosTh: number,
55
+ sinTh: number,
56
+ rx: number,
57
+ ry: number,
58
+ cx1: number,
59
+ cy1: number,
60
+ mT: number,
61
+ fromX: number,
62
+ fromY: number
63
+ ): TParsedCubicCurveCommand => {
64
+ const costh1 = cos(theta1),
65
+ sinth1 = sin(theta1),
66
+ costh2 = cos(theta2),
67
+ sinth2 = sin(theta2),
68
+ toX = cosTh * rx * costh2 - sinTh * ry * sinth2 + cx1,
69
+ toY = sinTh * rx * costh2 + cosTh * ry * sinth2 + cy1,
70
+ cp1X = fromX + mT * (-cosTh * rx * sinth1 - sinTh * ry * costh1),
71
+ cp1Y = fromY + mT * (-sinTh * rx * sinth1 + cosTh * ry * costh1),
72
+ cp2X = toX + mT * (cosTh * rx * sinth2 + sinTh * ry * costh2),
73
+ cp2Y = toY + mT * (sinTh * rx * sinth2 - cosTh * ry * costh2);
74
+
75
+ return ['C', cp1X, cp1Y, cp2X, cp2Y, toX, toY];
76
+ };
77
+
78
+ /**
79
+ * Adapted from {@link http://dxr.mozilla.org/mozilla-central/source/dom/svg/SVGPathDataParser.cpp}
80
+ * by Andrea Bogazzi code is under MPL. if you don't have a copy of the license you can take it here
81
+ * http://mozilla.org/MPL/2.0/
82
+ * @param toX
83
+ * @param toY
84
+ * @param rx
85
+ * @param ry
86
+ * @param {number} large 0 or 1 flag
87
+ * @param {number} sweep 0 or 1 flag
88
+ * @param rotateX
89
+ */
90
+ const arcToSegments = (
91
+ toX: number,
92
+ toY: number,
93
+ rx: number,
94
+ ry: number,
95
+ large: number,
96
+ sweep: number,
97
+ rotateX: TRadian
98
+ ): TParsedAbsoluteCubicCurveCommand[] => {
99
+ if (rx === 0 || ry === 0) {
100
+ return [];
101
+ }
102
+ let fromX = 0,
103
+ fromY = 0,
104
+ root = 0;
105
+ const PI = Math.PI,
106
+ theta = rotateX * PiBy180,
107
+ sinTheta = sin(theta),
108
+ cosTh = cos(theta),
109
+ px = 0.5 * (-cosTh * toX - sinTheta * toY),
110
+ py = 0.5 * (-cosTh * toY + sinTheta * toX),
111
+ rx2 = rx ** 2,
112
+ ry2 = ry ** 2,
113
+ py2 = py ** 2,
114
+ px2 = px ** 2,
115
+ pl = rx2 * ry2 - rx2 * py2 - ry2 * px2;
116
+ let _rx = Math.abs(rx);
117
+ let _ry = Math.abs(ry);
118
+
119
+ if (pl < 0) {
120
+ const s = Math.sqrt(1 - pl / (rx2 * ry2));
121
+ _rx *= s;
122
+ _ry *= s;
123
+ } else {
124
+ root =
125
+ (large === sweep ? -1.0 : 1.0) * Math.sqrt(pl / (rx2 * py2 + ry2 * px2));
126
+ }
127
+
128
+ const cx = (root * _rx * py) / _ry,
129
+ cy = (-root * _ry * px) / _rx,
130
+ cx1 = cosTh * cx - sinTheta * cy + toX * 0.5,
131
+ cy1 = sinTheta * cx + cosTh * cy + toY * 0.5;
132
+ let mTheta = calcVectorAngle(1, 0, (px - cx) / _rx, (py - cy) / _ry);
133
+ let dtheta = calcVectorAngle(
134
+ (px - cx) / _rx,
135
+ (py - cy) / _ry,
136
+ (-px - cx) / _rx,
137
+ (-py - cy) / _ry
138
+ );
139
+
140
+ if (sweep === 0 && dtheta > 0) {
141
+ dtheta -= 2 * PI;
142
+ } else if (sweep === 1 && dtheta < 0) {
143
+ dtheta += 2 * PI;
144
+ }
145
+
146
+ // Convert into cubic bezier segments <= 90deg
147
+ const segments = Math.ceil(Math.abs((dtheta / PI) * 2)),
148
+ result = new Array(segments),
149
+ mDelta = dtheta / segments,
150
+ mT =
151
+ ((8 / 3) * Math.sin(mDelta / 4) * Math.sin(mDelta / 4)) /
152
+ Math.sin(mDelta / 2);
153
+ let th3 = mTheta + mDelta;
154
+
155
+ for (let i = 0; i < segments; i++) {
156
+ result[i] = segmentToBezier(
157
+ mTheta,
158
+ th3,
159
+ cosTh,
160
+ sinTheta,
161
+ _rx,
162
+ _ry,
163
+ cx1,
164
+ cy1,
165
+ mT,
166
+ fromX,
167
+ fromY
168
+ );
169
+ fromX = result[i][5];
170
+ fromY = result[i][6];
171
+ mTheta = th3;
172
+ th3 += mDelta;
173
+ }
174
+ return result;
175
+ };
176
+
177
+ /**
178
+ * @private
179
+ * Calculate the angle between two vectors
180
+ * @param ux u endpoint x
181
+ * @param uy u endpoint y
182
+ * @param vx v endpoint x
183
+ * @param vy v endpoint y
184
+ */
185
+ const calcVectorAngle = (
186
+ ux: number,
187
+ uy: number,
188
+ vx: number,
189
+ vy: number
190
+ ): TRadian => {
191
+ const ta = Math.atan2(uy, ux),
192
+ tb = Math.atan2(vy, vx);
193
+ if (tb >= ta) {
194
+ return tb - ta;
195
+ } else {
196
+ return 2 * Math.PI - (ta - tb);
197
+ }
198
+ };
199
+
200
+ // functions for the Cubic beizer
201
+ // taken from: https://github.com/konvajs/konva/blob/7.0.5/src/shapes/Path.ts#L350
202
+ const CB1 = (t: number) => t ** 3;
203
+ const CB2 = (t: number) => 3 * t ** 2 * (1 - t);
204
+ const CB3 = (t: number) => 3 * t * (1 - t) ** 2;
205
+ const CB4 = (t: number) => (1 - t) ** 3;
206
+
207
+ /**
208
+ * Calculate bounding box of a cubic Bezier curve
209
+ * Taken from http://jsbin.com/ivomiq/56/edit (no credits available)
210
+ * TODO: can we normalize this with the starting points set at 0 and then translated the bbox?
211
+ * @param {number} begx starting point
212
+ * @param {number} begy
213
+ * @param {number} cp1x first control point
214
+ * @param {number} cp1y
215
+ * @param {number} cp2x second control point
216
+ * @param {number} cp2y
217
+ * @param {number} endx end of bezier
218
+ * @param {number} endy
219
+ * @return {TRectBounds} the rectangular bounds
220
+ */
221
+ export function getBoundsOfCurve(
222
+ begx: number,
223
+ begy: number,
224
+ cp1x: number,
225
+ cp1y: number,
226
+ cp2x: number,
227
+ cp2y: number,
228
+ endx: number,
229
+ endy: number
230
+ ): TRectBounds {
231
+ let argsString: string;
232
+ if (config.cachesBoundsOfCurve) {
233
+ // eslint-disable-next-line
234
+ argsString = [...arguments].join();
235
+ if (cache.boundsOfCurveCache[argsString]) {
236
+ return cache.boundsOfCurveCache[argsString];
237
+ }
238
+ }
239
+
240
+ const sqrt = Math.sqrt,
241
+ abs = Math.abs,
242
+ tvalues = [],
243
+ bounds: [[x: number, y: number], [x: number, y: number]] = [
244
+ [0, 0],
245
+ [0, 0],
246
+ ];
247
+
248
+ let b = 6 * begx - 12 * cp1x + 6 * cp2x;
249
+ let a = -3 * begx + 9 * cp1x - 9 * cp2x + 3 * endx;
250
+ let c = 3 * cp1x - 3 * begx;
251
+
252
+ for (let i = 0; i < 2; ++i) {
253
+ if (i > 0) {
254
+ b = 6 * begy - 12 * cp1y + 6 * cp2y;
255
+ a = -3 * begy + 9 * cp1y - 9 * cp2y + 3 * endy;
256
+ c = 3 * cp1y - 3 * begy;
257
+ }
258
+
259
+ if (abs(a) < 1e-12) {
260
+ if (abs(b) < 1e-12) {
261
+ continue;
262
+ }
263
+ const t = -c / b;
264
+ if (0 < t && t < 1) {
265
+ tvalues.push(t);
266
+ }
267
+ continue;
268
+ }
269
+ const b2ac = b * b - 4 * c * a;
270
+ if (b2ac < 0) {
271
+ continue;
272
+ }
273
+ const sqrtb2ac = sqrt(b2ac);
274
+ const t1 = (-b + sqrtb2ac) / (2 * a);
275
+ if (0 < t1 && t1 < 1) {
276
+ tvalues.push(t1);
277
+ }
278
+ const t2 = (-b - sqrtb2ac) / (2 * a);
279
+ if (0 < t2 && t2 < 1) {
280
+ tvalues.push(t2);
281
+ }
282
+ }
283
+
284
+ let j = tvalues.length;
285
+ const jlen = j;
286
+ const iterator = getPointOnCubicBezierIterator(
287
+ begx,
288
+ begy,
289
+ cp1x,
290
+ cp1y,
291
+ cp2x,
292
+ cp2y,
293
+ endx,
294
+ endy
295
+ );
296
+ while (j--) {
297
+ const { x, y } = iterator(tvalues[j]);
298
+ bounds[0][j] = x;
299
+ bounds[1][j] = y;
300
+ }
301
+
302
+ bounds[0][jlen] = begx;
303
+ bounds[1][jlen] = begy;
304
+ bounds[0][jlen + 1] = endx;
305
+ bounds[1][jlen + 1] = endy;
306
+ const result: TRectBounds = [
307
+ new Point(Math.min(...bounds[0]), Math.min(...bounds[1])),
308
+ new Point(Math.max(...bounds[0]), Math.max(...bounds[1])),
309
+ ];
310
+ if (config.cachesBoundsOfCurve) {
311
+ cache.boundsOfCurveCache[argsString!] = result;
312
+ }
313
+ return result;
314
+ }
315
+
316
+ /**
317
+ * Converts arc to a bunch of cubic Bezier curves
318
+ * @param {number} fx starting point x
319
+ * @param {number} fy starting point y
320
+ * @param {TParsedArcCommand} coords Arc command
321
+ */
322
+ export const fromArcToBeziers = (
323
+ fx: number,
324
+ fy: number,
325
+ [_, rx, ry, rot, large, sweep, tx, ty]: TParsedArcCommand
326
+ ): TParsedAbsoluteCubicCurveCommand[] => {
327
+ const segsNorm = arcToSegments(tx - fx, ty - fy, rx, ry, large, sweep, rot);
328
+
329
+ for (let i = 0, len = segsNorm.length; i < len; i++) {
330
+ segsNorm[i][1] += fx;
331
+ segsNorm[i][2] += fy;
332
+ segsNorm[i][3] += fx;
333
+ segsNorm[i][4] += fy;
334
+ segsNorm[i][5] += fx;
335
+ segsNorm[i][6] += fy;
336
+ }
337
+ return segsNorm;
338
+ };
339
+
340
+ /**
341
+ * This function takes a parsed SVG path and makes it simpler for fabricJS logic.
342
+ * Simplification consist of:
343
+ * - All commands converted to absolute (lowercase to uppercase)
344
+ * - S converted to C
345
+ * - T converted to Q
346
+ * - A converted to C
347
+ * @param {TComplexPathData} path the array of commands of a parsed SVG path for `Path`
348
+ * @return {TSimplePathData} the simplified array of commands of a parsed SVG path for `Path`
349
+ * TODO: figure out how to remove the type assertions in a nice way
350
+ */
351
+ export const makePathSimpler = (path: TComplexPathData): TSimplePathData => {
352
+ // x and y represent the last point of the path, AKA the previous command point.
353
+ // we add them to each relative command to make it an absolute comment.
354
+ // we also swap the v V h H with L, because are easier to transform.
355
+ let x = 0,
356
+ y = 0;
357
+ // x1 and y1 represent the last point of the subpath. the subpath is started with
358
+ // m or M command. When a z or Z command is drawn, x and y need to be resetted to
359
+ // the last x1 and y1.
360
+ let x1 = 0,
361
+ y1 = 0;
362
+ // previous will host the letter of the previous command, to handle S and T.
363
+ // controlX and controlY will host the previous reflected control point
364
+ const destinationPath: TSimplePathData = [];
365
+ let previous,
366
+ // placeholders
367
+ controlX = 0,
368
+ controlY = 0;
369
+ for (const parsedCommand of path) {
370
+ const current: TComplexParsedCommand = [...parsedCommand];
371
+ let converted: TSimpleParsedCommand | undefined;
372
+ switch (
373
+ current[0] // first letter
374
+ ) {
375
+ case 'l': // lineto, relative
376
+ current[1] += x;
377
+ current[2] += y;
378
+ // falls through
379
+ case 'L':
380
+ x = current[1];
381
+ y = current[2];
382
+ converted = ['L', x, y];
383
+ break;
384
+ case 'h': // horizontal lineto, relative
385
+ current[1] += x;
386
+ // falls through
387
+ case 'H':
388
+ x = current[1];
389
+ converted = ['L', x, y];
390
+ break;
391
+ case 'v': // vertical lineto, relative
392
+ current[1] += y;
393
+ // falls through
394
+ case 'V':
395
+ y = current[1];
396
+ converted = ['L', x, y];
397
+ break;
398
+ case 'm': // moveTo, relative
399
+ current[1] += x;
400
+ current[2] += y;
401
+ // falls through
402
+ case 'M':
403
+ x = current[1];
404
+ y = current[2];
405
+ x1 = current[1];
406
+ y1 = current[2];
407
+ converted = ['M', x, y];
408
+ break;
409
+ case 'c': // bezierCurveTo, relative
410
+ current[1] += x;
411
+ current[2] += y;
412
+ current[3] += x;
413
+ current[4] += y;
414
+ current[5] += x;
415
+ current[6] += y;
416
+ // falls through
417
+ case 'C':
418
+ controlX = current[3];
419
+ controlY = current[4];
420
+ x = current[5];
421
+ y = current[6];
422
+ converted = ['C', current[1], current[2], controlX, controlY, x, y];
423
+ break;
424
+ case 's': // shorthand cubic bezierCurveTo, relative
425
+ current[1] += x;
426
+ current[2] += y;
427
+ current[3] += x;
428
+ current[4] += y;
429
+ // falls through
430
+ case 'S':
431
+ // would be sScC but since we are swapping sSc for C, we check just that.
432
+ if (previous === 'C') {
433
+ // calculate reflection of previous control points
434
+ controlX = 2 * x - controlX;
435
+ controlY = 2 * y - controlY;
436
+ } else {
437
+ // If there is no previous command or if the previous command was not a C, c, S, or s,
438
+ // the control point is coincident with the current point
439
+ controlX = x;
440
+ controlY = y;
441
+ }
442
+ x = current[3];
443
+ y = current[4];
444
+ converted = ['C', controlX, controlY, current[1], current[2], x, y];
445
+ // converted[3] and converted[4] are NOW the second control point.
446
+ // we keep it for the next reflection.
447
+ controlX = converted[3];
448
+ controlY = converted[4];
449
+ break;
450
+ case 'q': // quadraticCurveTo, relative
451
+ current[1] += x;
452
+ current[2] += y;
453
+ current[3] += x;
454
+ current[4] += y;
455
+ // falls through
456
+ case 'Q':
457
+ controlX = current[1];
458
+ controlY = current[2];
459
+ x = current[3];
460
+ y = current[4];
461
+ converted = ['Q', controlX, controlY, x, y];
462
+ break;
463
+ case 't': // shorthand quadraticCurveTo, relative
464
+ current[1] += x;
465
+ current[2] += y;
466
+ // falls through
467
+ case 'T':
468
+ if (previous === 'Q') {
469
+ // calculate reflection of previous control point
470
+ controlX = 2 * x - controlX;
471
+ controlY = 2 * y - controlY;
472
+ } else {
473
+ // If there is no previous command or if the previous command was not a Q, q, T or t,
474
+ // assume the control point is coincident with the current point
475
+ controlX = x;
476
+ controlY = y;
477
+ }
478
+ x = current[1];
479
+ y = current[2];
480
+ converted = ['Q', controlX, controlY, x, y];
481
+ break;
482
+ case 'a':
483
+ current[6] += x;
484
+ current[7] += y;
485
+ // falls through
486
+ case 'A':
487
+ fromArcToBeziers(x, y, current).forEach((b) => destinationPath.push(b));
488
+ x = current[6];
489
+ y = current[7];
490
+ break;
491
+ case 'z':
492
+ case 'Z':
493
+ x = x1;
494
+ y = y1;
495
+ converted = ['Z'];
496
+ break;
497
+ default:
498
+ }
499
+ if (converted) {
500
+ destinationPath.push(converted);
501
+ previous = converted[0];
502
+ } else {
503
+ previous = '';
504
+ }
505
+ }
506
+ return destinationPath;
507
+ };
508
+
509
+ // todo verify if we can just use the point class here
510
+ /**
511
+ * Calc length from point x1,y1 to x2,y2
512
+ * @param {number} x1 starting point x
513
+ * @param {number} y1 starting point y
514
+ * @param {number} x2 starting point x
515
+ * @param {number} y2 starting point y
516
+ * @return {number} length of segment
517
+ */
518
+ const calcLineLength = (
519
+ x1: number,
520
+ y1: number,
521
+ x2: number,
522
+ y2: number
523
+ ): number => Math.sqrt((x2 - x1) ** 2 + (y2 - y1) ** 2);
524
+
525
+ /**
526
+ * Get an iterator that takes a percentage and returns a point
527
+ * @param {number} begx
528
+ * @param {number} begy
529
+ * @param {number} cp1x
530
+ * @param {number} cp1y
531
+ * @param {number} cp2x
532
+ * @param {number} cp2y
533
+ * @param {number} endx
534
+ * @param {number} endy
535
+ */
536
+ const getPointOnCubicBezierIterator =
537
+ (
538
+ begx: number,
539
+ begy: number,
540
+ cp1x: number,
541
+ cp1y: number,
542
+ cp2x: number,
543
+ cp2y: number,
544
+ endx: number,
545
+ endy: number
546
+ ) =>
547
+ (pct: number) => {
548
+ const c1 = CB1(pct),
549
+ c2 = CB2(pct),
550
+ c3 = CB3(pct),
551
+ c4 = CB4(pct);
552
+ return new Point(
553
+ endx * c1 + cp2x * c2 + cp1x * c3 + begx * c4,
554
+ endy * c1 + cp2y * c2 + cp1y * c3 + begy * c4
555
+ );
556
+ };
557
+
558
+ const QB1 = (t: number) => t ** 2;
559
+ const QB2 = (t: number) => 2 * t * (1 - t);
560
+ const QB3 = (t: number) => (1 - t) ** 2;
561
+
562
+ const getTangentCubicIterator =
563
+ (
564
+ p1x: number,
565
+ p1y: number,
566
+ p2x: number,
567
+ p2y: number,
568
+ p3x: number,
569
+ p3y: number,
570
+ p4x: number,
571
+ p4y: number
572
+ ) =>
573
+ (pct: number) => {
574
+ const qb1 = QB1(pct),
575
+ qb2 = QB2(pct),
576
+ qb3 = QB3(pct),
577
+ tangentX =
578
+ 3 * (qb3 * (p2x - p1x) + qb2 * (p3x - p2x) + qb1 * (p4x - p3x)),
579
+ tangentY =
580
+ 3 * (qb3 * (p2y - p1y) + qb2 * (p3y - p2y) + qb1 * (p4y - p3y));
581
+ return Math.atan2(tangentY, tangentX);
582
+ };
583
+
584
+ const getPointOnQuadraticBezierIterator =
585
+ (
586
+ p1x: number,
587
+ p1y: number,
588
+ p2x: number,
589
+ p2y: number,
590
+ p3x: number,
591
+ p3y: number
592
+ ) =>
593
+ (pct: number) => {
594
+ const c1 = QB1(pct),
595
+ c2 = QB2(pct),
596
+ c3 = QB3(pct);
597
+ return new Point(
598
+ p3x * c1 + p2x * c2 + p1x * c3,
599
+ p3y * c1 + p2y * c2 + p1y * c3
600
+ );
601
+ };
602
+
603
+ const getTangentQuadraticIterator =
604
+ (
605
+ p1x: number,
606
+ p1y: number,
607
+ p2x: number,
608
+ p2y: number,
609
+ p3x: number,
610
+ p3y: number
611
+ ) =>
612
+ (pct: number) => {
613
+ const invT = 1 - pct,
614
+ tangentX = 2 * (invT * (p2x - p1x) + pct * (p3x - p2x)),
615
+ tangentY = 2 * (invT * (p2y - p1y) + pct * (p3y - p2y));
616
+ return Math.atan2(tangentY, tangentX);
617
+ };
618
+
619
+ // this will run over a path segment (a cubic or quadratic segment) and approximate it
620
+ // with 100 segments. This will good enough to calculate the length of the curve
621
+ const pathIterator = (
622
+ iterator: (pct: number) => Point,
623
+ x1: number,
624
+ y1: number
625
+ ) => {
626
+ let tempP = new Point(x1, y1),
627
+ tmpLen = 0;
628
+ for (let perc = 1; perc <= 100; perc += 1) {
629
+ const p = iterator(perc / 100);
630
+ tmpLen += calcLineLength(tempP.x, tempP.y, p.x, p.y);
631
+ tempP = p;
632
+ }
633
+ return tmpLen;
634
+ };
635
+
636
+ /**
637
+ * Given a pathInfo, and a distance in pixels, find the percentage from 0 to 1
638
+ * that correspond to that pixels run over the path.
639
+ * The percentage will be then used to find the correct point on the canvas for the path.
640
+ * @param {Array} segInfo fabricJS collection of information on a parsed path
641
+ * @param {number} distance from starting point, in pixels.
642
+ * @return {TPointAngle} info object with x and y ( the point on canvas ) and angle, the tangent on that point;
643
+ */
644
+ const findPercentageForDistance = (
645
+ segInfo: TCurveInfo<'Q' | 'C'>,
646
+ distance: number
647
+ ): TPointAngle => {
648
+ let perc = 0,
649
+ tmpLen = 0,
650
+ tempP: XY = { x: segInfo.x, y: segInfo.y },
651
+ p: XY = { ...tempP },
652
+ nextLen: number,
653
+ nextStep = 0.01,
654
+ lastPerc = 0;
655
+ // nextStep > 0.0001 covers 0.00015625 that 1/64th of 1/100
656
+ // the path
657
+ const iterator = segInfo.iterator,
658
+ angleFinder = segInfo.angleFinder;
659
+ while (tmpLen < distance && nextStep > 0.0001) {
660
+ p = iterator(perc);
661
+ lastPerc = perc;
662
+ nextLen = calcLineLength(tempP.x, tempP.y, p.x, p.y);
663
+ // compare tmpLen each cycle with distance, decide next perc to test.
664
+ if (nextLen + tmpLen > distance) {
665
+ // we discard this step and we make smaller steps.
666
+ perc -= nextStep;
667
+ nextStep /= 2;
668
+ } else {
669
+ tempP = p;
670
+ perc += nextStep;
671
+ tmpLen += nextLen;
672
+ }
673
+ }
674
+ return { ...p, angle: angleFinder(lastPerc) };
675
+ };
676
+
677
+ /**
678
+ * Run over a parsed and simplified path and extract some information (length of each command and starting point)
679
+ * @param {TSimplePathData} path parsed path commands
680
+ * @return {TPathSegmentInfo[]} path commands information
681
+ */
682
+ export const getPathSegmentsInfo = (
683
+ path: TSimplePathData
684
+ ): TPathSegmentInfo[] => {
685
+ let totalLength = 0,
686
+ //x2 and y2 are the coords of segment start
687
+ //x1 and y1 are the coords of the current point
688
+ x1 = 0,
689
+ y1 = 0,
690
+ x2 = 0,
691
+ y2 = 0,
692
+ iterator,
693
+ tempInfo: TPathSegmentInfo;
694
+ const info: TPathSegmentInfo[] = [];
695
+ for (const current of path) {
696
+ const basicInfo: TPathSegmentInfoCommon<keyof TPathSegmentCommandInfo> = {
697
+ x: x1,
698
+ y: y1,
699
+ command: current[0],
700
+ length: 0,
701
+ };
702
+ switch (
703
+ current[0] //first letter
704
+ ) {
705
+ case 'M':
706
+ tempInfo = <TPathSegmentInfoCommon<'M'>>basicInfo;
707
+ x2 = x1 = current[1];
708
+ y2 = y1 = current[2];
709
+ break;
710
+ case 'L':
711
+ tempInfo = <TPathSegmentInfoCommon<'L'>>basicInfo;
712
+ tempInfo.length = calcLineLength(x1, y1, current[1], current[2]);
713
+ x1 = current[1];
714
+ y1 = current[2];
715
+ break;
716
+ case 'C':
717
+ iterator = getPointOnCubicBezierIterator(
718
+ x1,
719
+ y1,
720
+ current[1],
721
+ current[2],
722
+ current[3],
723
+ current[4],
724
+ current[5],
725
+ current[6]
726
+ );
727
+ tempInfo = <TCurveInfo<'C'>>basicInfo;
728
+ tempInfo.iterator = iterator;
729
+ tempInfo.angleFinder = getTangentCubicIterator(
730
+ x1,
731
+ y1,
732
+ current[1],
733
+ current[2],
734
+ current[3],
735
+ current[4],
736
+ current[5],
737
+ current[6]
738
+ );
739
+ tempInfo.length = pathIterator(iterator, x1, y1);
740
+
741
+ x1 = current[5];
742
+ y1 = current[6];
743
+ break;
744
+ case 'Q':
745
+ iterator = getPointOnQuadraticBezierIterator(
746
+ x1,
747
+ y1,
748
+ current[1],
749
+ current[2],
750
+ current[3],
751
+ current[4]
752
+ );
753
+ tempInfo = <TCurveInfo<'Q'>>basicInfo;
754
+ tempInfo.iterator = iterator;
755
+ tempInfo.angleFinder = getTangentQuadraticIterator(
756
+ x1,
757
+ y1,
758
+ current[1],
759
+ current[2],
760
+ current[3],
761
+ current[4]
762
+ );
763
+ tempInfo.length = pathIterator(iterator, x1, y1);
764
+ x1 = current[3];
765
+ y1 = current[4];
766
+ break;
767
+ case 'Z':
768
+ // we add those in order to ease calculations later
769
+ tempInfo = <TEndPathInfo>basicInfo;
770
+ tempInfo.destX = x2;
771
+ tempInfo.destY = y2;
772
+ tempInfo.length = calcLineLength(x1, y1, x2, y2);
773
+ x1 = x2;
774
+ y1 = y2;
775
+ break;
776
+ }
777
+ totalLength += tempInfo.length;
778
+ info.push(tempInfo);
779
+ }
780
+ info.push({ length: totalLength, x: x1, y: y1 });
781
+ return info;
782
+ };
783
+
784
+ /**
785
+ * Get the point on the path that is distance along the path
786
+ * @param path
787
+ * @param distance
788
+ * @param infos
789
+ */
790
+ export const getPointOnPath = (
791
+ path: TSimplePathData,
792
+ distance: number,
793
+ infos: TPathSegmentInfo[] = getPathSegmentsInfo(path)
794
+ ): TPointAngle | undefined => {
795
+ let i = 0;
796
+ while (distance - infos[i].length > 0 && i < infos.length - 2) {
797
+ distance -= infos[i].length;
798
+ i++;
799
+ }
800
+ const segInfo = infos[i],
801
+ segPercent = distance / segInfo.length,
802
+ segment = path[i];
803
+
804
+ switch (segInfo.command) {
805
+ case 'M':
806
+ return { x: segInfo.x, y: segInfo.y, angle: 0 };
807
+ case 'Z':
808
+ return {
809
+ ...new Point(segInfo.x, segInfo.y).lerp(
810
+ new Point(segInfo.destX, segInfo.destY),
811
+ segPercent
812
+ ),
813
+ angle: Math.atan2(segInfo.destY - segInfo.y, segInfo.destX - segInfo.x),
814
+ };
815
+ case 'L':
816
+ return {
817
+ ...new Point(segInfo.x, segInfo.y).lerp(
818
+ new Point(segment[1]!, segment[2]!),
819
+ segPercent
820
+ ),
821
+ angle: Math.atan2(segment[2]! - segInfo.y, segment[1]! - segInfo.x),
822
+ };
823
+ case 'C':
824
+ return findPercentageForDistance(segInfo, distance);
825
+ case 'Q':
826
+ return findPercentageForDistance(segInfo, distance);
827
+ default:
828
+ // throw Error('Invalid command');
829
+ }
830
+ };
831
+
832
+ /**
833
+ *
834
+ * @param {string} pathString
835
+ * @return {TComplexPathData} An array of SVG path commands
836
+ * @example <caption>Usage</caption>
837
+ * parsePath('M 3 4 Q 3 5 2 1 4 0 Q 9 12 2 1 4 0') === [
838
+ * ['M', 3, 4],
839
+ * ['Q', 3, 5, 2, 1, 4, 0],
840
+ * ['Q', 9, 12, 2, 1, 4, 0],
841
+ * ];
842
+ *
843
+ */
844
+ export const parsePath = (pathString: string): TComplexPathData => {
845
+ // clean the string
846
+ // add spaces around the numbers
847
+ pathString = cleanupSvgAttribute(pathString);
848
+
849
+ const res: TComplexPathData = [];
850
+ for (const match of pathString.matchAll(new RegExp(rePathCommand, 'gi'))) {
851
+ let matchStr = match[0];
852
+ const chain: TComplexPathData = [];
853
+ let paramArr: RegExpExecArray | null;
854
+ do {
855
+ paramArr = new RegExp(rePathCommand, 'i').exec(matchStr);
856
+ if (!paramArr) {
857
+ break;
858
+ }
859
+ // ignore undefined match groups
860
+ const filteredGroups = paramArr.filter((g) => g);
861
+ // remove the first element from the match array since it's just the whole command
862
+ filteredGroups.shift();
863
+ // if we can't parse the number, just interpret it as a string
864
+ // (since it's probably the path command)
865
+ const command = filteredGroups.map((g) => {
866
+ const numParse = Number.parseFloat(g);
867
+ if (Number.isNaN(numParse)) {
868
+ return g;
869
+ } else {
870
+ return numParse;
871
+ }
872
+ });
873
+ chain.push(command as any);
874
+ // stop now if it's a z command
875
+ if (filteredGroups.length <= 1) {
876
+ break;
877
+ }
878
+ // remove the last part of the chained command
879
+ filteredGroups.shift();
880
+ // ` ?` is to support commands with optional spaces between flags
881
+ matchStr = matchStr.replace(
882
+ new RegExp(`${filteredGroups.join(' ?')} ?$`),
883
+ ''
884
+ );
885
+ } while (paramArr);
886
+ // add the chain, convert multiple m's to l's in the process
887
+ chain.reverse().forEach((c, idx) => {
888
+ const transformed = repeatedCommands[c[0]];
889
+ if (idx > 0 && (transformed == 'l' || transformed == 'L')) {
890
+ c[0] = transformed;
891
+ }
892
+ res.push(c);
893
+ });
894
+ }
895
+ return res;
896
+ };
897
+
898
+ /**
899
+ *
900
+ * Converts points to a smooth SVG path
901
+ * @param {XY[]} points Array of points
902
+ * @param {number} [correction] Apply a correction to the path (usually we use `width / 1000`). If value is undefined 0 is used as the correction value.
903
+ * @return {(string|number)[][]} An array of SVG path commands
904
+ */
905
+ export const getSmoothPathFromPoints = (
906
+ points: Point[],
907
+ correction = 0
908
+ ): TSimplePathData => {
909
+ let p1 = new Point(points[0]),
910
+ p2 = new Point(points[1]),
911
+ multSignX = 1,
912
+ multSignY = 0;
913
+ const path: TSimplePathData = [],
914
+ len = points.length,
915
+ manyPoints = len > 2;
916
+
917
+ if (manyPoints) {
918
+ multSignX = points[2].x < p2.x ? -1 : points[2].x === p2.x ? 0 : 1;
919
+ multSignY = points[2].y < p2.y ? -1 : points[2].y === p2.y ? 0 : 1;
920
+ }
921
+ path.push([
922
+ 'M',
923
+ p1.x - multSignX * correction,
924
+ p1.y - multSignY * correction,
925
+ ]);
926
+ let i;
927
+ for (i = 1; i < len; i++) {
928
+ if (!p1.eq(p2)) {
929
+ const midPoint = p1.midPointFrom(p2);
930
+ // p1 is our bezier control point
931
+ // midpoint is our endpoint
932
+ // start point is p(i-1) value.
933
+ path.push(['Q', p1.x, p1.y, midPoint.x, midPoint.y]);
934
+ }
935
+ p1 = points[i];
936
+ if (i + 1 < points.length) {
937
+ p2 = points[i + 1];
938
+ }
939
+ }
940
+ if (manyPoints) {
941
+ multSignX = p1.x > points[i - 2].x ? 1 : p1.x === points[i - 2].x ? 0 : -1;
942
+ multSignY = p1.y > points[i - 2].y ? 1 : p1.y === points[i - 2].y ? 0 : -1;
943
+ }
944
+ path.push([
945
+ 'L',
946
+ p1.x + multSignX * correction,
947
+ p1.y + multSignY * correction,
948
+ ]);
949
+ return path;
950
+ };
951
+
952
+ /**
953
+ * Transform a path by transforming each segment.
954
+ * it has to be a simplified path or it won't work.
955
+ * WARNING: this depends from pathOffset for correct operation
956
+ * @param {TSimplePathData} path fabricJS parsed and simplified path commands
957
+ * @param {TMat2D} transform matrix that represent the transformation
958
+ * @param {Point} [pathOffset] `Path.pathOffset`
959
+ * @returns {TSimplePathData} the transformed path
960
+ */
961
+ export const transformPath = (
962
+ path: TSimplePathData,
963
+ transform: TMat2D,
964
+ pathOffset: Point
965
+ ): TSimplePathData => {
966
+ if (pathOffset) {
967
+ transform = multiplyTransformMatrices(transform, [
968
+ 1,
969
+ 0,
970
+ 0,
971
+ 1,
972
+ -pathOffset.x,
973
+ -pathOffset.y,
974
+ ]);
975
+ }
976
+ return path.map((pathSegment) => {
977
+ const newSegment: TSimpleParsedCommand = [...pathSegment];
978
+ for (let i = 1; i < pathSegment.length - 1; i += 2) {
979
+ // TODO: is there a way to get around casting to any?
980
+ const { x, y } = transformPoint(
981
+ {
982
+ x: pathSegment[i] as number,
983
+ y: pathSegment[i + 1] as number,
984
+ },
985
+ transform
986
+ );
987
+ newSegment[i] = x;
988
+ newSegment[i + 1] = y;
989
+ }
990
+ return newSegment;
991
+ });
992
+ };
993
+
994
+ /**
995
+ * Returns an array of path commands to create a regular polygon
996
+ * @param {number} numVertexes
997
+ * @param {number} radius
998
+ * @returns {TSimplePathData} An array of SVG path commands
999
+ */
1000
+ export const getRegularPolygonPath = (
1001
+ numVertexes: number,
1002
+ radius: number
1003
+ ): TSimplePathData => {
1004
+ const interiorAngle = (Math.PI * 2) / numVertexes;
1005
+ // rotationAdjustment rotates the path by 1/2 the interior angle so that the polygon always has a flat side on the bottom
1006
+ // This isn't strictly necessary, but it's how we tend to think of and expect polygons to be drawn
1007
+ let rotationAdjustment = -halfPI;
1008
+ if (numVertexes % 2 === 0) {
1009
+ rotationAdjustment += interiorAngle / 2;
1010
+ }
1011
+ const d = new Array(numVertexes + 1);
1012
+ for (let i = 0; i < numVertexes; i++) {
1013
+ const rad = i * interiorAngle + rotationAdjustment;
1014
+ const { x, y } = new Point(cos(rad), sin(rad)).scalarMultiply(radius);
1015
+ d[i] = [i === 0 ? 'M' : 'L', x, y];
1016
+ }
1017
+ d[numVertexes] = ['Z'];
1018
+ return d;
1019
+ };
1020
+
1021
+ /**
1022
+ * Join path commands to go back to svg format
1023
+ * @param {TSimplePathData} pathData fabricJS parsed path commands
1024
+ * @param {number} fractionDigits number of fraction digits to "leave"
1025
+ * @return {String} joined path 'M 0 0 L 20 30'
1026
+ */
1027
+ export const joinPath = (pathData: TSimplePathData, fractionDigits?: number) =>
1028
+ pathData
1029
+ .map((segment) => {
1030
+ return segment
1031
+ .map((arg, i) => {
1032
+ if (i === 0) return arg;
1033
+ return fractionDigits === undefined
1034
+ ? arg
1035
+ : toFixed(arg, fractionDigits);
1036
+ })
1037
+ .join(' ');
1038
+ })
1039
+ .join(' ');