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,1073 @@
1
+ import type {
2
+ ObjectEvents,
3
+ TPointerEvent,
4
+ TPointerEventInfo,
5
+ } from '../../EventTypeDefs';
6
+ import { Point } from '../../Point';
7
+ import type { FabricObject } from '../Object/Object';
8
+ import { Text } from '../Text/Text';
9
+ import { animate } from '../../util/animation/animate';
10
+ import type { TOnAnimationChangeCallback } from '../../util/animation/types';
11
+ import type { ValueAnimation } from '../../util/animation/ValueAnimation';
12
+ import type { TextStyleDeclaration } from '../Text/StyledText';
13
+ import type { SerializedTextProps, TextProps } from '../Text/Text';
14
+ import type { TProps } from '../Object/types';
15
+ import { getDocumentFromElement } from '../../util/dom_misc';
16
+ import { LEFT, RIGHT, reNewline } from '../../constants';
17
+
18
+ /**
19
+ * extend this regex to support non english languages
20
+ *
21
+ * - ` ` Matches a SPACE character (char code 32).
22
+ * - `\n` Matches a LINE FEED character (char code 10).
23
+ * - `\.` Matches a "." character (char code 46).
24
+ * - `,` Matches a "," character (char code 44).
25
+ * - `;` Matches a ";" character (char code 59).
26
+ * - `!` Matches a "!" character (char code 33).
27
+ * - `\?` Matches a "?" character (char code 63).
28
+ * - `\-` Matches a "-" character (char code 45).
29
+ */
30
+ // eslint-disable-next-line no-useless-escape
31
+ const reNonWord = /[ \n\.,;!\?\-]/;
32
+
33
+ export type ITextEvents = ObjectEvents & {
34
+ 'selection:changed': never;
35
+ changed: never | { index: number; action: string };
36
+ tripleclick: TPointerEventInfo;
37
+ 'editing:entered': never | { e: TPointerEvent };
38
+ 'editing:exited': never;
39
+ };
40
+
41
+ export abstract class ITextBehavior<
42
+ Props extends TProps<TextProps> = Partial<TextProps>,
43
+ SProps extends SerializedTextProps = SerializedTextProps,
44
+ EventSpec extends ITextEvents = ITextEvents
45
+ > extends Text<Props, SProps, EventSpec> {
46
+ declare abstract isEditing: boolean;
47
+ declare abstract cursorDelay: number;
48
+ declare abstract selectionStart: number;
49
+ declare abstract selectionEnd: number;
50
+ declare abstract cursorDuration: number;
51
+ declare abstract editable: boolean;
52
+ declare abstract editingBorderColor: string;
53
+
54
+ declare abstract compositionStart: number;
55
+ declare abstract compositionEnd: number;
56
+
57
+ declare abstract hiddenTextarea: HTMLTextAreaElement | null;
58
+
59
+ /**
60
+ * Helps determining when the text is in composition, so that the cursor
61
+ * rendering is altered.
62
+ */
63
+ protected declare inCompositionMode: boolean;
64
+
65
+ protected declare _reSpace: RegExp;
66
+ private declare _currentTickState?: ValueAnimation;
67
+ private declare _currentTickCompleteState?: ValueAnimation;
68
+ protected _currentCursorOpacity = 1;
69
+ private declare _textBeforeEdit: string;
70
+ protected declare __selectionStartOnMouseDown: number;
71
+
72
+ protected declare selected: boolean;
73
+ protected declare cursorOffsetCache: { left?: number; top?: number };
74
+ protected declare _savedProps?: {
75
+ hasControls: boolean;
76
+ borderColor: string;
77
+ lockMovementX: boolean;
78
+ lockMovementY: boolean;
79
+ selectable: boolean;
80
+ hoverCursor: CSSStyleDeclaration['cursor'] | null;
81
+ defaultCursor?: CSSStyleDeclaration['cursor'];
82
+ moveCursor?: CSSStyleDeclaration['cursor'];
83
+ };
84
+ protected declare _selectionDirection: 'left' | 'right' | null;
85
+
86
+ abstract initHiddenTextarea(): void;
87
+ abstract _fireSelectionChanged(): void;
88
+ abstract renderCursorOrSelection(): void;
89
+ abstract getSelectionStartFromPointer(e: TPointerEvent): number;
90
+ abstract _getCursorBoundaries(
91
+ index: number,
92
+ skipCaching?: boolean
93
+ ): {
94
+ left: number;
95
+ top: number;
96
+ leftOffset: number;
97
+ topOffset: number;
98
+ };
99
+
100
+ /**
101
+ * Initializes all the interactive behavior of IText
102
+ */
103
+ initBehavior() {
104
+ this._tick = this._tick.bind(this);
105
+ this._onTickComplete = this._onTickComplete.bind(this);
106
+ this.updateSelectionOnMouseMove =
107
+ this.updateSelectionOnMouseMove.bind(this);
108
+ }
109
+
110
+ onDeselect(options?: { e?: TPointerEvent; object?: FabricObject }) {
111
+ this.isEditing && this.exitEditing();
112
+ this.selected = false;
113
+ return super.onDeselect(options);
114
+ }
115
+
116
+ /**
117
+ * @private
118
+ */
119
+ _animateCursor({
120
+ toValue,
121
+ duration,
122
+ delay,
123
+ onComplete,
124
+ }: {
125
+ toValue: number;
126
+ duration: number;
127
+ delay?: number;
128
+ onComplete?: TOnAnimationChangeCallback<number, void>;
129
+ }) {
130
+ return animate({
131
+ startValue: this._currentCursorOpacity,
132
+ endValue: toValue,
133
+ duration,
134
+ delay,
135
+ onComplete,
136
+ abort: () => {
137
+ return (
138
+ !this.canvas ||
139
+ // we do not want to animate a selection, only cursor
140
+ this.selectionStart !== this.selectionEnd
141
+ );
142
+ },
143
+ onChange: (value) => {
144
+ this._currentCursorOpacity = value;
145
+ this.renderCursorOrSelection();
146
+ },
147
+ });
148
+ }
149
+
150
+ private _tick(delay?: number) {
151
+ this._currentTickState = this._animateCursor({
152
+ toValue: 1,
153
+ duration: this.cursorDuration,
154
+ delay,
155
+ onComplete: this._onTickComplete,
156
+ });
157
+ }
158
+
159
+ private _onTickComplete() {
160
+ this._currentTickCompleteState?.abort();
161
+ this._currentTickCompleteState = this._animateCursor({
162
+ toValue: 0,
163
+ duration: this.cursorDuration / 2,
164
+ delay: 100,
165
+ onComplete: this._tick,
166
+ });
167
+ }
168
+
169
+ /**
170
+ * Initializes delayed cursor
171
+ */
172
+ initDelayedCursor(restart?: boolean) {
173
+ this.abortCursorAnimation();
174
+ this._tick(restart ? 0 : this.cursorDelay);
175
+ }
176
+
177
+ /**
178
+ * Aborts cursor animation, clears all timeouts and clear textarea context if necessary
179
+ */
180
+ abortCursorAnimation() {
181
+ let shouldClear = false;
182
+ [this._currentTickState, this._currentTickCompleteState].forEach(
183
+ (cursorAnimation) => {
184
+ if (cursorAnimation && !cursorAnimation.isDone()) {
185
+ shouldClear = true;
186
+ cursorAnimation.abort();
187
+ }
188
+ }
189
+ );
190
+
191
+ this._currentCursorOpacity = 1;
192
+
193
+ // make sure we clear context even if instance is not editing
194
+ if (shouldClear) {
195
+ this.clearContextTop();
196
+ }
197
+ }
198
+
199
+ restartCursorIfNeeded() {
200
+ if (
201
+ [this._currentTickState, this._currentTickCompleteState].some(
202
+ (cursorAnimation) => !cursorAnimation || cursorAnimation.isDone()
203
+ )
204
+ ) {
205
+ this.initDelayedCursor();
206
+ }
207
+ }
208
+
209
+ /**
210
+ * Selects entire text
211
+ */
212
+ selectAll() {
213
+ this.selectionStart = 0;
214
+ this.selectionEnd = this._text.length;
215
+ this._fireSelectionChanged();
216
+ this._updateTextarea();
217
+ return this;
218
+ }
219
+
220
+ /**
221
+ * Returns selected text
222
+ * @return {String}
223
+ */
224
+ getSelectedText(): string {
225
+ return this._text.slice(this.selectionStart, this.selectionEnd).join('');
226
+ }
227
+
228
+ /**
229
+ * Find new selection index representing start of current word according to current selection index
230
+ * @param {Number} startFrom Current selection index
231
+ * @return {Number} New selection index
232
+ */
233
+ findWordBoundaryLeft(startFrom: number): number {
234
+ let offset = 0,
235
+ index = startFrom - 1;
236
+
237
+ // remove space before cursor first
238
+ if (this._reSpace.test(this._text[index])) {
239
+ while (this._reSpace.test(this._text[index])) {
240
+ offset++;
241
+ index--;
242
+ }
243
+ }
244
+ while (/\S/.test(this._text[index]) && index > -1) {
245
+ offset++;
246
+ index--;
247
+ }
248
+
249
+ return startFrom - offset;
250
+ }
251
+
252
+ /**
253
+ * Find new selection index representing end of current word according to current selection index
254
+ * @param {Number} startFrom Current selection index
255
+ * @return {Number} New selection index
256
+ */
257
+ findWordBoundaryRight(startFrom: number): number {
258
+ let offset = 0,
259
+ index = startFrom;
260
+
261
+ // remove space after cursor first
262
+ if (this._reSpace.test(this._text[index])) {
263
+ while (this._reSpace.test(this._text[index])) {
264
+ offset++;
265
+ index++;
266
+ }
267
+ }
268
+ while (/\S/.test(this._text[index]) && index < this._text.length) {
269
+ offset++;
270
+ index++;
271
+ }
272
+
273
+ return startFrom + offset;
274
+ }
275
+
276
+ /**
277
+ * Find new selection index representing start of current line according to current selection index
278
+ * @param {Number} startFrom Current selection index
279
+ * @return {Number} New selection index
280
+ */
281
+ findLineBoundaryLeft(startFrom: number): number {
282
+ let offset = 0,
283
+ index = startFrom - 1;
284
+
285
+ while (!/\n/.test(this._text[index]) && index > -1) {
286
+ offset++;
287
+ index--;
288
+ }
289
+
290
+ return startFrom - offset;
291
+ }
292
+
293
+ /**
294
+ * Find new selection index representing end of current line according to current selection index
295
+ * @param {Number} startFrom Current selection index
296
+ * @return {Number} New selection index
297
+ */
298
+ findLineBoundaryRight(startFrom: number): number {
299
+ let offset = 0,
300
+ index = startFrom;
301
+
302
+ while (!/\n/.test(this._text[index]) && index < this._text.length) {
303
+ offset++;
304
+ index++;
305
+ }
306
+
307
+ return startFrom + offset;
308
+ }
309
+
310
+ /**
311
+ * Finds index corresponding to beginning or end of a word
312
+ * @param {Number} selectionStart Index of a character
313
+ * @param {Number} direction 1 or -1
314
+ * @return {Number} Index of the beginning or end of a word
315
+ */
316
+ searchWordBoundary(selectionStart: number, direction: 1 | -1): number {
317
+ const text = this._text;
318
+ // if we land on a space we move the cursor backwards
319
+ // if we are searching boundary end we move the cursor backwards ONLY if we don't land on a line break
320
+ let index =
321
+ selectionStart > 0 &&
322
+ this._reSpace.test(text[selectionStart]) &&
323
+ (direction === -1 || !reNewline.test(text[selectionStart - 1]))
324
+ ? selectionStart - 1
325
+ : selectionStart,
326
+ _char = text[index];
327
+ while (index > 0 && index < text.length && !reNonWord.test(_char)) {
328
+ index += direction;
329
+ _char = text[index];
330
+ }
331
+ if (direction === -1 && reNonWord.test(_char)) {
332
+ index++;
333
+ }
334
+ return index;
335
+ }
336
+
337
+ /**
338
+ * Selects a word based on the index
339
+ * @param {Number} selectionStart Index of a character
340
+ */
341
+ selectWord(selectionStart: number) {
342
+ selectionStart = selectionStart || this.selectionStart;
343
+ // search backwards
344
+ const newSelectionStart = this.searchWordBoundary(selectionStart, -1),
345
+ // search forward
346
+ newSelectionEnd = Math.max(
347
+ newSelectionStart,
348
+ this.searchWordBoundary(selectionStart, 1)
349
+ );
350
+
351
+ this.selectionStart = newSelectionStart;
352
+ this.selectionEnd = newSelectionEnd;
353
+ this._fireSelectionChanged();
354
+ this._updateTextarea();
355
+ this.renderCursorOrSelection();
356
+ }
357
+
358
+ /**
359
+ * Selects a line based on the index
360
+ * @param {Number} selectionStart Index of a character
361
+ */
362
+ selectLine(selectionStart: number) {
363
+ selectionStart = selectionStart || this.selectionStart;
364
+ const newSelectionStart = this.findLineBoundaryLeft(selectionStart),
365
+ newSelectionEnd = this.findLineBoundaryRight(selectionStart);
366
+
367
+ this.selectionStart = newSelectionStart;
368
+ this.selectionEnd = newSelectionEnd;
369
+ this._fireSelectionChanged();
370
+ this._updateTextarea();
371
+ return this;
372
+ }
373
+
374
+ /**
375
+ * Enters editing state
376
+ */
377
+ enterEditing(e: TPointerEvent) {
378
+ if (this.isEditing || !this.editable) {
379
+ return;
380
+ }
381
+ if (this.canvas) {
382
+ this.canvas.calcOffset();
383
+ this.canvas.textEditingManager.exitTextEditing();
384
+ }
385
+
386
+ this.isEditing = true;
387
+
388
+ this.initHiddenTextarea();
389
+ this.hiddenTextarea!.focus();
390
+ this.hiddenTextarea!.value = this.text;
391
+ this._updateTextarea();
392
+ this._saveEditingProps();
393
+ this._setEditingProps();
394
+ this._textBeforeEdit = this.text;
395
+
396
+ this._tick();
397
+ this.fire('editing:entered', { e });
398
+ this._fireSelectionChanged();
399
+ if (this.canvas) {
400
+ // @ts-expect-error in reality it is an IText instance
401
+ this.canvas.fire('text:editing:entered', { target: this, e });
402
+ this.canvas.requestRenderAll();
403
+ }
404
+ }
405
+
406
+ /**
407
+ * called by {@link canvas#textEditingManager}
408
+ */
409
+ updateSelectionOnMouseMove(e: TPointerEvent) {
410
+ if (this.__corner) {
411
+ return;
412
+ }
413
+
414
+ const el = this.hiddenTextarea!;
415
+ // regain focus
416
+ getDocumentFromElement(el).activeElement !== el && el.focus();
417
+
418
+ const newSelectionStart = this.getSelectionStartFromPointer(e),
419
+ currentStart = this.selectionStart,
420
+ currentEnd = this.selectionEnd;
421
+ if (
422
+ (newSelectionStart !== this.__selectionStartOnMouseDown ||
423
+ currentStart === currentEnd) &&
424
+ (currentStart === newSelectionStart || currentEnd === newSelectionStart)
425
+ ) {
426
+ return;
427
+ }
428
+ if (newSelectionStart > this.__selectionStartOnMouseDown) {
429
+ this.selectionStart = this.__selectionStartOnMouseDown;
430
+ this.selectionEnd = newSelectionStart;
431
+ } else {
432
+ this.selectionStart = newSelectionStart;
433
+ this.selectionEnd = this.__selectionStartOnMouseDown;
434
+ }
435
+ if (
436
+ this.selectionStart !== currentStart ||
437
+ this.selectionEnd !== currentEnd
438
+ ) {
439
+ this._fireSelectionChanged();
440
+ this._updateTextarea();
441
+ this.renderCursorOrSelection();
442
+ }
443
+ }
444
+
445
+ /**
446
+ * @private
447
+ */
448
+ _setEditingProps() {
449
+ this.hoverCursor = 'text';
450
+
451
+ if (this.canvas) {
452
+ this.canvas.defaultCursor = this.canvas.moveCursor = 'text';
453
+ }
454
+
455
+ this.borderColor = this.editingBorderColor;
456
+ this.hasControls = this.selectable = false;
457
+ this.lockMovementX = this.lockMovementY = true;
458
+ }
459
+
460
+ /**
461
+ * convert from textarea to grapheme indexes
462
+ */
463
+ fromStringToGraphemeSelection(start: number, end: number, text: string) {
464
+ const smallerTextStart = text.slice(0, start),
465
+ graphemeStart = this.graphemeSplit(smallerTextStart).length;
466
+ if (start === end) {
467
+ return { selectionStart: graphemeStart, selectionEnd: graphemeStart };
468
+ }
469
+ const smallerTextEnd = text.slice(start, end),
470
+ graphemeEnd = this.graphemeSplit(smallerTextEnd).length;
471
+ return {
472
+ selectionStart: graphemeStart,
473
+ selectionEnd: graphemeStart + graphemeEnd,
474
+ };
475
+ }
476
+
477
+ /**
478
+ * convert from fabric to textarea values
479
+ */
480
+ fromGraphemeToStringSelection(
481
+ start: number,
482
+ end: number,
483
+ graphemes: string[]
484
+ ) {
485
+ const smallerTextStart = graphemes.slice(0, start),
486
+ graphemeStart = smallerTextStart.join('').length;
487
+ if (start === end) {
488
+ return { selectionStart: graphemeStart, selectionEnd: graphemeStart };
489
+ }
490
+ const smallerTextEnd = graphemes.slice(start, end),
491
+ graphemeEnd = smallerTextEnd.join('').length;
492
+ return {
493
+ selectionStart: graphemeStart,
494
+ selectionEnd: graphemeStart + graphemeEnd,
495
+ };
496
+ }
497
+
498
+ /**
499
+ * @private
500
+ */
501
+ _updateTextarea() {
502
+ this.cursorOffsetCache = {};
503
+ if (!this.hiddenTextarea) {
504
+ return;
505
+ }
506
+ if (!this.inCompositionMode) {
507
+ const newSelection = this.fromGraphemeToStringSelection(
508
+ this.selectionStart,
509
+ this.selectionEnd,
510
+ this._text
511
+ );
512
+ this.hiddenTextarea.selectionStart = newSelection.selectionStart;
513
+ this.hiddenTextarea.selectionEnd = newSelection.selectionEnd;
514
+ }
515
+ this.updateTextareaPosition();
516
+ }
517
+
518
+ /**
519
+ * @private
520
+ */
521
+ updateFromTextArea() {
522
+ if (!this.hiddenTextarea) {
523
+ return;
524
+ }
525
+ this.cursorOffsetCache = {};
526
+ const textarea = this.hiddenTextarea;
527
+ this.text = textarea.value;
528
+ this.set('dirty', true);
529
+ this.initDimensions();
530
+ this.setCoords();
531
+ const newSelection = this.fromStringToGraphemeSelection(
532
+ textarea.selectionStart,
533
+ textarea.selectionEnd,
534
+ textarea.value
535
+ );
536
+ this.selectionEnd = this.selectionStart = newSelection.selectionEnd;
537
+ if (!this.inCompositionMode) {
538
+ this.selectionStart = newSelection.selectionStart;
539
+ }
540
+ this.updateTextareaPosition();
541
+ }
542
+
543
+ /**
544
+ * @private
545
+ */
546
+ updateTextareaPosition() {
547
+ if (this.selectionStart === this.selectionEnd) {
548
+ const style = this._calcTextareaPosition();
549
+ this.hiddenTextarea!.style.left = style.left;
550
+ this.hiddenTextarea!.style.top = style.top;
551
+ }
552
+ }
553
+
554
+ /**
555
+ * @private
556
+ * @return {Object} style contains style for hiddenTextarea
557
+ */
558
+ _calcTextareaPosition() {
559
+ if (!this.canvas) {
560
+ return { left: '1px', top: '1px' };
561
+ }
562
+ const desiredPosition = this.inCompositionMode
563
+ ? this.compositionStart
564
+ : this.selectionStart,
565
+ boundaries = this._getCursorBoundaries(desiredPosition),
566
+ cursorLocation = this.get2DCursorLocation(desiredPosition),
567
+ lineIndex = cursorLocation.lineIndex,
568
+ charIndex = cursorLocation.charIndex,
569
+ charHeight =
570
+ this.getValueOfPropertyAt(lineIndex, charIndex, 'fontSize') *
571
+ this.lineHeight,
572
+ leftOffset = boundaries.leftOffset,
573
+ retinaScaling = this.getCanvasRetinaScaling(),
574
+ upperCanvas = this.canvas.upperCanvasEl,
575
+ upperCanvasWidth = upperCanvas.width / retinaScaling,
576
+ upperCanvasHeight = upperCanvas.height / retinaScaling,
577
+ maxWidth = upperCanvasWidth - charHeight,
578
+ maxHeight = upperCanvasHeight - charHeight;
579
+
580
+ const p = new Point(
581
+ boundaries.left + leftOffset,
582
+ boundaries.top + boundaries.topOffset + charHeight
583
+ )
584
+ .transform(this.calcTransformMatrix())
585
+ .transform(this.canvas.viewportTransform)
586
+ .multiply(
587
+ new Point(
588
+ upperCanvas.clientWidth / upperCanvasWidth,
589
+ upperCanvas.clientHeight / upperCanvasHeight
590
+ )
591
+ );
592
+
593
+ if (p.x < 0) {
594
+ p.x = 0;
595
+ }
596
+ if (p.x > maxWidth) {
597
+ p.x = maxWidth;
598
+ }
599
+ if (p.y < 0) {
600
+ p.y = 0;
601
+ }
602
+ if (p.y > maxHeight) {
603
+ p.y = maxHeight;
604
+ }
605
+
606
+ // add canvas offset on document
607
+ p.x += this.canvas._offset.left;
608
+ p.y += this.canvas._offset.top;
609
+
610
+ return {
611
+ left: `${p.x}px`,
612
+ top: `${p.y}px`,
613
+ fontSize: `${charHeight}px`,
614
+ charHeight: charHeight,
615
+ };
616
+ }
617
+
618
+ /**
619
+ * @private
620
+ */
621
+ _saveEditingProps() {
622
+ this._savedProps = {
623
+ hasControls: this.hasControls,
624
+ borderColor: this.borderColor,
625
+ lockMovementX: this.lockMovementX,
626
+ lockMovementY: this.lockMovementY,
627
+ hoverCursor: this.hoverCursor,
628
+ selectable: this.selectable,
629
+ defaultCursor: this.canvas && this.canvas.defaultCursor,
630
+ moveCursor: this.canvas && this.canvas.moveCursor,
631
+ };
632
+ }
633
+
634
+ /**
635
+ * @private
636
+ */
637
+ _restoreEditingProps() {
638
+ if (!this._savedProps) {
639
+ return;
640
+ }
641
+
642
+ this.hoverCursor = this._savedProps.hoverCursor;
643
+ this.hasControls = this._savedProps.hasControls;
644
+ this.borderColor = this._savedProps.borderColor;
645
+ this.selectable = this._savedProps.selectable;
646
+ this.lockMovementX = this._savedProps.lockMovementX;
647
+ this.lockMovementY = this._savedProps.lockMovementY;
648
+
649
+ if (this.canvas) {
650
+ this.canvas.defaultCursor =
651
+ this._savedProps.defaultCursor || this.canvas.defaultCursor;
652
+ this.canvas.moveCursor =
653
+ this._savedProps.moveCursor || this.canvas.moveCursor;
654
+ }
655
+
656
+ delete this._savedProps;
657
+ }
658
+
659
+ /**
660
+ * runs the actual logic that exits from editing state, see {@link exitEditing}
661
+ */
662
+ protected _exitEditing() {
663
+ const hiddenTextarea = this.hiddenTextarea;
664
+ this.selected = false;
665
+ this.isEditing = false;
666
+
667
+ if (hiddenTextarea) {
668
+ hiddenTextarea.blur && hiddenTextarea.blur();
669
+ hiddenTextarea.parentNode &&
670
+ hiddenTextarea.parentNode.removeChild(hiddenTextarea);
671
+ }
672
+ this.hiddenTextarea = null;
673
+ this.abortCursorAnimation();
674
+ this.selectionStart !== this.selectionEnd && this.clearContextTop();
675
+ }
676
+
677
+ /**
678
+ * Exits from editing state and fires relevant events
679
+ */
680
+ exitEditing() {
681
+ const isTextChanged = this._textBeforeEdit !== this.text;
682
+ this._exitEditing();
683
+ this.selectionEnd = this.selectionStart;
684
+ this._restoreEditingProps();
685
+ if (this._forceClearCache) {
686
+ this.initDimensions();
687
+ this.setCoords();
688
+ }
689
+ this.fire('editing:exited');
690
+ isTextChanged && this.fire('modified');
691
+ if (this.canvas) {
692
+ // @ts-expect-error in reality it is an IText instance
693
+ this.canvas.fire('text:editing:exited', { target: this });
694
+ isTextChanged && this.canvas.fire('object:modified', { target: this });
695
+ }
696
+ return this;
697
+ }
698
+
699
+ /**
700
+ * @private
701
+ */
702
+ _removeExtraneousStyles() {
703
+ for (const prop in this.styles) {
704
+ if (!this._textLines[prop as unknown as number]) {
705
+ delete this.styles[prop];
706
+ }
707
+ }
708
+ }
709
+
710
+ /**
711
+ * remove and reflow a style block from start to end.
712
+ * @param {Number} start linear start position for removal (included in removal)
713
+ * @param {Number} end linear end position for removal ( excluded from removal )
714
+ */
715
+ removeStyleFromTo(start: number, end: number) {
716
+ const { lineIndex: lineStart, charIndex: charStart } =
717
+ this.get2DCursorLocation(start, true),
718
+ { lineIndex: lineEnd, charIndex: charEnd } = this.get2DCursorLocation(
719
+ end,
720
+ true
721
+ );
722
+ if (lineStart !== lineEnd) {
723
+ // step1 remove the trailing of lineStart
724
+ if (this.styles[lineStart]) {
725
+ for (
726
+ let i = charStart;
727
+ i < this._unwrappedTextLines[lineStart].length;
728
+ i++
729
+ ) {
730
+ delete this.styles[lineStart][i];
731
+ }
732
+ }
733
+ // step2 move the trailing of lineEnd to lineStart if needed
734
+ if (this.styles[lineEnd]) {
735
+ for (
736
+ let i = charEnd;
737
+ i < this._unwrappedTextLines[lineEnd].length;
738
+ i++
739
+ ) {
740
+ const styleObj = this.styles[lineEnd][i];
741
+ if (styleObj) {
742
+ this.styles[lineStart] || (this.styles[lineStart] = {});
743
+ this.styles[lineStart][charStart + i - charEnd] = styleObj;
744
+ }
745
+ }
746
+ }
747
+ // step3 detects lines will be completely removed.
748
+ for (let i = lineStart + 1; i <= lineEnd; i++) {
749
+ delete this.styles[i];
750
+ }
751
+ // step4 shift remaining lines.
752
+ this.shiftLineStyles(lineEnd, lineStart - lineEnd);
753
+ } else {
754
+ // remove and shift left on the same line
755
+ if (this.styles[lineStart]) {
756
+ const styleObj = this.styles[lineStart];
757
+ const diff = charEnd - charStart;
758
+ for (let i = charStart; i < charEnd; i++) {
759
+ delete styleObj[i];
760
+ }
761
+ for (const char in this.styles[lineStart]) {
762
+ const numericChar = parseInt(char, 10);
763
+ if (numericChar >= charEnd) {
764
+ styleObj[numericChar - diff] = styleObj[char];
765
+ delete styleObj[char];
766
+ }
767
+ }
768
+ }
769
+ }
770
+ }
771
+
772
+ /**
773
+ * Shifts line styles up or down
774
+ * @param {Number} lineIndex Index of a line
775
+ * @param {Number} offset Can any number?
776
+ */
777
+ shiftLineStyles(lineIndex: number, offset: number) {
778
+ const clonedStyles = Object.assign({}, this.styles);
779
+ for (const line in this.styles) {
780
+ const numericLine = parseInt(line, 10);
781
+ if (numericLine > lineIndex) {
782
+ this.styles[numericLine + offset] = clonedStyles[numericLine];
783
+ if (!clonedStyles[numericLine - offset]) {
784
+ delete this.styles[numericLine];
785
+ }
786
+ }
787
+ }
788
+ }
789
+
790
+ /**
791
+ * Handle insertion of more consecutive style lines for when one or more
792
+ * newlines gets added to the text. Since current style needs to be shifted
793
+ * first we shift the current style of the number lines needed, then we add
794
+ * new lines from the last to the first.
795
+ * @param {Number} lineIndex Index of a line
796
+ * @param {Number} charIndex Index of a char
797
+ * @param {Number} qty number of lines to add
798
+ * @param {Array} copiedStyle Array of objects styles
799
+ */
800
+ insertNewlineStyleObject(
801
+ lineIndex: number,
802
+ charIndex: number,
803
+ qty: number,
804
+ copiedStyle?: { [index: number]: TextStyleDeclaration }
805
+ ) {
806
+ const newLineStyles: { [index: number]: TextStyleDeclaration } = {};
807
+ const isEndOfLine =
808
+ this._unwrappedTextLines[lineIndex].length === charIndex;
809
+ let somethingAdded = false;
810
+ qty || (qty = 1);
811
+ this.shiftLineStyles(lineIndex, qty);
812
+ const currentCharStyle = this.styles[lineIndex]
813
+ ? this.styles[lineIndex][charIndex === 0 ? charIndex : charIndex - 1]
814
+ : undefined;
815
+
816
+ // we clone styles of all chars
817
+ // after cursor onto the current line
818
+ for (const index in this.styles[lineIndex]) {
819
+ const numIndex = parseInt(index, 10);
820
+ if (numIndex >= charIndex) {
821
+ somethingAdded = true;
822
+ newLineStyles[numIndex - charIndex] = this.styles[lineIndex][index];
823
+ // remove lines from the previous line since they're on a new line now
824
+ if (!(isEndOfLine && charIndex === 0)) {
825
+ delete this.styles[lineIndex][index];
826
+ }
827
+ }
828
+ }
829
+ let styleCarriedOver = false;
830
+ if (somethingAdded && !isEndOfLine) {
831
+ // if is end of line, the extra style we copied
832
+ // is probably not something we want
833
+ this.styles[lineIndex + qty] = newLineStyles;
834
+ styleCarriedOver = true;
835
+ }
836
+ if (styleCarriedOver) {
837
+ // skip the last line of since we already prepared it.
838
+ qty--;
839
+ }
840
+ // for the all the lines or all the other lines
841
+ // we clone current char style onto the next (otherwise empty) line
842
+ while (qty > 0) {
843
+ if (copiedStyle && copiedStyle[qty - 1]) {
844
+ this.styles[lineIndex + qty] = {
845
+ 0: { ...copiedStyle[qty - 1] },
846
+ };
847
+ } else if (currentCharStyle) {
848
+ this.styles[lineIndex + qty] = {
849
+ 0: { ...currentCharStyle },
850
+ };
851
+ } else {
852
+ delete this.styles[lineIndex + qty];
853
+ }
854
+ qty--;
855
+ }
856
+ this._forceClearCache = true;
857
+ }
858
+
859
+ /**
860
+ * Inserts style object for a given line/char index
861
+ * @param {Number} lineIndex Index of a line
862
+ * @param {Number} charIndex Index of a char
863
+ * @param {Number} quantity number Style object to insert, if given
864
+ * @param {Array} copiedStyle array of style objects
865
+ */
866
+ insertCharStyleObject(
867
+ lineIndex: number,
868
+ charIndex: number,
869
+ quantity: number,
870
+ copiedStyle?: TextStyleDeclaration[]
871
+ ) {
872
+ if (!this.styles) {
873
+ this.styles = {};
874
+ }
875
+ const currentLineStyles = this.styles[lineIndex],
876
+ currentLineStylesCloned = currentLineStyles
877
+ ? { ...currentLineStyles }
878
+ : {};
879
+
880
+ quantity || (quantity = 1);
881
+ // shift all char styles by quantity forward
882
+ // 0,1,2,3 -> (charIndex=2) -> 0,1,3,4 -> (insert 2) -> 0,1,2,3,4
883
+ for (const index in currentLineStylesCloned) {
884
+ const numericIndex = parseInt(index, 10);
885
+ if (numericIndex >= charIndex) {
886
+ currentLineStyles[numericIndex + quantity] =
887
+ currentLineStylesCloned[numericIndex];
888
+ // only delete the style if there was nothing moved there
889
+ if (!currentLineStylesCloned[numericIndex - quantity]) {
890
+ delete currentLineStyles[numericIndex];
891
+ }
892
+ }
893
+ }
894
+ this._forceClearCache = true;
895
+ if (copiedStyle) {
896
+ while (quantity--) {
897
+ if (!Object.keys(copiedStyle[quantity]).length) {
898
+ continue;
899
+ }
900
+ if (!this.styles[lineIndex]) {
901
+ this.styles[lineIndex] = {};
902
+ }
903
+ this.styles[lineIndex][charIndex + quantity] = {
904
+ ...copiedStyle[quantity],
905
+ };
906
+ }
907
+ return;
908
+ }
909
+ if (!currentLineStyles) {
910
+ return;
911
+ }
912
+ const newStyle = currentLineStyles[charIndex ? charIndex - 1 : 1];
913
+ while (newStyle && quantity--) {
914
+ this.styles[lineIndex][charIndex + quantity] = { ...newStyle };
915
+ }
916
+ }
917
+
918
+ /**
919
+ * Inserts style object(s)
920
+ * @param {Array} insertedText Characters at the location where style is inserted
921
+ * @param {Number} start cursor index for inserting style
922
+ * @param {Array} [copiedStyle] array of style objects to insert.
923
+ */
924
+ insertNewStyleBlock(
925
+ insertedText: string[],
926
+ start: number,
927
+ copiedStyle?: TextStyleDeclaration[]
928
+ ) {
929
+ const cursorLoc = this.get2DCursorLocation(start, true),
930
+ addedLines = [0];
931
+ let linesLength = 0;
932
+ // get an array of how many char per lines are being added.
933
+ for (let i = 0; i < insertedText.length; i++) {
934
+ if (insertedText[i] === '\n') {
935
+ linesLength++;
936
+ addedLines[linesLength] = 0;
937
+ } else {
938
+ addedLines[linesLength]++;
939
+ }
940
+ }
941
+ // for the first line copy the style from the current char position.
942
+ if (addedLines[0] > 0) {
943
+ this.insertCharStyleObject(
944
+ cursorLoc.lineIndex,
945
+ cursorLoc.charIndex,
946
+ addedLines[0],
947
+ copiedStyle
948
+ );
949
+ copiedStyle = copiedStyle && copiedStyle.slice(addedLines[0] + 1);
950
+ }
951
+ linesLength &&
952
+ this.insertNewlineStyleObject(
953
+ cursorLoc.lineIndex,
954
+ cursorLoc.charIndex + addedLines[0],
955
+ linesLength
956
+ );
957
+ let i;
958
+ for (i = 1; i < linesLength; i++) {
959
+ if (addedLines[i] > 0) {
960
+ this.insertCharStyleObject(
961
+ cursorLoc.lineIndex + i,
962
+ 0,
963
+ addedLines[i],
964
+ copiedStyle
965
+ );
966
+ } else if (copiedStyle) {
967
+ // this test is required in order to close #6841
968
+ // when a pasted buffer begins with a newline then
969
+ // this.styles[cursorLoc.lineIndex + i] and copiedStyle[0]
970
+ // may be undefined for some reason
971
+ if (this.styles[cursorLoc.lineIndex + i] && copiedStyle[0]) {
972
+ this.styles[cursorLoc.lineIndex + i][0] = copiedStyle[0];
973
+ }
974
+ }
975
+ copiedStyle = copiedStyle && copiedStyle.slice(addedLines[i] + 1);
976
+ }
977
+ if (addedLines[i] > 0) {
978
+ this.insertCharStyleObject(
979
+ cursorLoc.lineIndex + i,
980
+ 0,
981
+ addedLines[i],
982
+ copiedStyle
983
+ );
984
+ }
985
+ }
986
+
987
+ /**
988
+ * Removes characters from start/end
989
+ * start/end ar per grapheme position in _text array.
990
+ *
991
+ * @param {Number} start
992
+ * @param {Number} end default to start + 1
993
+ */
994
+ removeChars(start: number, end: number = start + 1) {
995
+ this.removeStyleFromTo(start, end);
996
+ this._text.splice(start, end - start);
997
+ this.text = this._text.join('');
998
+ this.set('dirty', true);
999
+ this.initDimensions();
1000
+ this.setCoords();
1001
+ this._removeExtraneousStyles();
1002
+ }
1003
+
1004
+ /**
1005
+ * insert characters at start position, before start position.
1006
+ * start equal 1 it means the text get inserted between actual grapheme 0 and 1
1007
+ * if style array is provided, it must be as the same length of text in graphemes
1008
+ * if end is provided and is bigger than start, old text is replaced.
1009
+ * start/end ar per grapheme position in _text array.
1010
+ *
1011
+ * @param {String} text text to insert
1012
+ * @param {Array} style array of style objects
1013
+ * @param {Number} start
1014
+ * @param {Number} end default to start + 1
1015
+ */
1016
+ insertChars(
1017
+ text: string,
1018
+ style: TextStyleDeclaration[] | undefined,
1019
+ start: number,
1020
+ end: number = start
1021
+ ) {
1022
+ if (end > start) {
1023
+ this.removeStyleFromTo(start, end);
1024
+ }
1025
+ const graphemes = this.graphemeSplit(text);
1026
+ this.insertNewStyleBlock(graphemes, start, style);
1027
+ this._text = [
1028
+ ...this._text.slice(0, start),
1029
+ ...graphemes,
1030
+ ...this._text.slice(end),
1031
+ ];
1032
+ this.text = this._text.join('');
1033
+ this.set('dirty', true);
1034
+ this.initDimensions();
1035
+ this.setCoords();
1036
+ this._removeExtraneousStyles();
1037
+ }
1038
+
1039
+ /**
1040
+ * Set the selectionStart and selectionEnd according to the new position of cursor
1041
+ * mimic the key - mouse navigation when shift is pressed.
1042
+ */
1043
+ setSelectionStartEndWithShift(
1044
+ start: number,
1045
+ end: number,
1046
+ newSelection: number
1047
+ ) {
1048
+ if (newSelection <= start) {
1049
+ if (end === start) {
1050
+ this._selectionDirection = LEFT;
1051
+ } else if (this._selectionDirection === RIGHT) {
1052
+ this._selectionDirection = LEFT;
1053
+ this.selectionEnd = start;
1054
+ }
1055
+ this.selectionStart = newSelection;
1056
+ } else if (newSelection > start && newSelection < end) {
1057
+ if (this._selectionDirection === RIGHT) {
1058
+ this.selectionEnd = newSelection;
1059
+ } else {
1060
+ this.selectionStart = newSelection;
1061
+ }
1062
+ } else {
1063
+ // newSelection is > selection start and end
1064
+ if (end === start) {
1065
+ this._selectionDirection = RIGHT;
1066
+ } else if (this._selectionDirection === LEFT) {
1067
+ this._selectionDirection = RIGHT;
1068
+ this.selectionStart = end;
1069
+ }
1070
+ this.selectionEnd = newSelection;
1071
+ }
1072
+ }
1073
+ }