@ckeditor/ckeditor5-image 0.0.0-internal-20241017.0

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 (526) hide show
  1. package/CHANGELOG.md +4 -0
  2. package/LICENSE.md +21 -0
  3. package/README.md +26 -0
  4. package/build/image.js +5 -0
  5. package/build/translations/ar.js +1 -0
  6. package/build/translations/ast.js +1 -0
  7. package/build/translations/az.js +1 -0
  8. package/build/translations/bg.js +1 -0
  9. package/build/translations/bn.js +1 -0
  10. package/build/translations/bs.js +1 -0
  11. package/build/translations/ca.js +1 -0
  12. package/build/translations/cs.js +1 -0
  13. package/build/translations/da.js +1 -0
  14. package/build/translations/de-ch.js +1 -0
  15. package/build/translations/de.js +1 -0
  16. package/build/translations/el.js +1 -0
  17. package/build/translations/en-au.js +1 -0
  18. package/build/translations/en-gb.js +1 -0
  19. package/build/translations/eo.js +1 -0
  20. package/build/translations/es.js +1 -0
  21. package/build/translations/et.js +1 -0
  22. package/build/translations/eu.js +1 -0
  23. package/build/translations/fa.js +1 -0
  24. package/build/translations/fi.js +1 -0
  25. package/build/translations/fr.js +1 -0
  26. package/build/translations/gl.js +1 -0
  27. package/build/translations/he.js +1 -0
  28. package/build/translations/hi.js +1 -0
  29. package/build/translations/hr.js +1 -0
  30. package/build/translations/hu.js +1 -0
  31. package/build/translations/id.js +1 -0
  32. package/build/translations/it.js +1 -0
  33. package/build/translations/ja.js +1 -0
  34. package/build/translations/jv.js +1 -0
  35. package/build/translations/km.js +1 -0
  36. package/build/translations/kn.js +1 -0
  37. package/build/translations/ko.js +1 -0
  38. package/build/translations/ku.js +1 -0
  39. package/build/translations/lt.js +1 -0
  40. package/build/translations/lv.js +1 -0
  41. package/build/translations/ms.js +1 -0
  42. package/build/translations/nb.js +1 -0
  43. package/build/translations/ne.js +1 -0
  44. package/build/translations/nl.js +1 -0
  45. package/build/translations/no.js +1 -0
  46. package/build/translations/pl.js +1 -0
  47. package/build/translations/pt-br.js +1 -0
  48. package/build/translations/pt.js +1 -0
  49. package/build/translations/ro.js +1 -0
  50. package/build/translations/ru.js +1 -0
  51. package/build/translations/si.js +1 -0
  52. package/build/translations/sk.js +1 -0
  53. package/build/translations/sq.js +1 -0
  54. package/build/translations/sr-latn.js +1 -0
  55. package/build/translations/sr.js +1 -0
  56. package/build/translations/sv.js +1 -0
  57. package/build/translations/th.js +1 -0
  58. package/build/translations/ti.js +1 -0
  59. package/build/translations/tk.js +1 -0
  60. package/build/translations/tr.js +1 -0
  61. package/build/translations/ug.js +1 -0
  62. package/build/translations/uk.js +1 -0
  63. package/build/translations/ur.js +1 -0
  64. package/build/translations/uz.js +1 -0
  65. package/build/translations/vi.js +1 -0
  66. package/build/translations/zh-cn.js +1 -0
  67. package/build/translations/zh.js +1 -0
  68. package/ckeditor5-metadata.json +270 -0
  69. package/dist/augmentation.d.ts +61 -0
  70. package/dist/autoimage.d.ts +60 -0
  71. package/dist/image/converters.d.ts +70 -0
  72. package/dist/image/imageblockediting.d.ts +67 -0
  73. package/dist/image/imageediting.d.ts +38 -0
  74. package/dist/image/imageinlineediting.d.ts +68 -0
  75. package/dist/image/imageloadobserver.d.ts +52 -0
  76. package/dist/image/imageplaceholder.d.ts +47 -0
  77. package/dist/image/imagetypecommand.d.ts +48 -0
  78. package/dist/image/insertimagecommand.d.ts +72 -0
  79. package/dist/image/replaceimagesourcecommand.d.ts +55 -0
  80. package/dist/image/ui/utils.d.ts +29 -0
  81. package/dist/image/utils.d.ts +68 -0
  82. package/dist/image.d.ts +42 -0
  83. package/dist/imageblock.d.ts +42 -0
  84. package/dist/imagecaption/imagecaptionediting.d.ts +97 -0
  85. package/dist/imagecaption/imagecaptionui.d.ts +34 -0
  86. package/dist/imagecaption/imagecaptionutils.d.ts +46 -0
  87. package/dist/imagecaption/toggleimagecaptioncommand.d.ts +70 -0
  88. package/dist/imagecaption.d.ts +34 -0
  89. package/dist/imageconfig.d.ts +716 -0
  90. package/dist/imageinline.d.ts +42 -0
  91. package/dist/imageinsert/imageinsertui.d.ts +90 -0
  92. package/dist/imageinsert/imageinsertviaurlui.d.ts +74 -0
  93. package/dist/imageinsert/ui/imageinsertformview.d.ts +60 -0
  94. package/dist/imageinsert/ui/imageinserturlview.d.ts +68 -0
  95. package/dist/imageinsert.d.ts +41 -0
  96. package/dist/imageinsertviaurl.d.ts +39 -0
  97. package/dist/imageresize/imagecustomresizeui.d.ts +69 -0
  98. package/dist/imageresize/imageresizebuttons.d.ts +72 -0
  99. package/dist/imageresize/imageresizeediting.d.ts +49 -0
  100. package/dist/imageresize/imageresizehandles.d.ts +39 -0
  101. package/dist/imageresize/resizeimagecommand.d.ts +46 -0
  102. package/dist/imageresize/ui/imagecustomresizeformview.d.ts +133 -0
  103. package/dist/imageresize/utils/getselectedimageeditornodes.d.ts +28 -0
  104. package/dist/imageresize/utils/getselectedimagepossibleresizerange.d.ts +28 -0
  105. package/dist/imageresize/utils/getselectedimagewidthinunits.d.ts +22 -0
  106. package/dist/imageresize/utils/tryparsedimensionwithunit.d.ts +41 -0
  107. package/dist/imageresize.d.ts +36 -0
  108. package/dist/imagesizeattributes.d.ts +42 -0
  109. package/dist/imagestyle/converters.d.ts +28 -0
  110. package/dist/imagestyle/imagestylecommand.d.ts +72 -0
  111. package/dist/imagestyle/imagestyleediting.d.ts +58 -0
  112. package/dist/imagestyle/imagestyleui.d.ts +64 -0
  113. package/dist/imagestyle/utils.d.ts +105 -0
  114. package/dist/imagestyle.d.ts +40 -0
  115. package/dist/imagetextalternative/imagetextalternativecommand.d.ts +38 -0
  116. package/dist/imagetextalternative/imagetextalternativeediting.d.ts +36 -0
  117. package/dist/imagetextalternative/imagetextalternativeui.d.ts +76 -0
  118. package/dist/imagetextalternative/ui/textalternativeformview.d.ts +94 -0
  119. package/dist/imagetextalternative.d.ts +37 -0
  120. package/dist/imagetoolbar.d.ts +43 -0
  121. package/dist/imageupload/imageuploadediting.d.ts +119 -0
  122. package/dist/imageupload/imageuploadprogress.d.ts +50 -0
  123. package/dist/imageupload/imageuploadui.d.ts +55 -0
  124. package/dist/imageupload/uploadimagecommand.d.ts +78 -0
  125. package/dist/imageupload/utils.d.ts +37 -0
  126. package/dist/imageupload.d.ts +40 -0
  127. package/dist/imageutils.d.ts +133 -0
  128. package/dist/index-content.css +150 -0
  129. package/dist/index-editor.css +248 -0
  130. package/dist/index.css +579 -0
  131. package/dist/index.css.map +1 -0
  132. package/dist/index.d.ts +54 -0
  133. package/dist/index.js +6383 -0
  134. package/dist/index.js.map +1 -0
  135. package/dist/pictureediting.d.ts +96 -0
  136. package/dist/translations/ar.d.ts +8 -0
  137. package/dist/translations/ar.js +5 -0
  138. package/dist/translations/ar.umd.js +11 -0
  139. package/dist/translations/ast.d.ts +8 -0
  140. package/dist/translations/ast.js +5 -0
  141. package/dist/translations/ast.umd.js +11 -0
  142. package/dist/translations/az.d.ts +8 -0
  143. package/dist/translations/az.js +5 -0
  144. package/dist/translations/az.umd.js +11 -0
  145. package/dist/translations/bg.d.ts +8 -0
  146. package/dist/translations/bg.js +5 -0
  147. package/dist/translations/bg.umd.js +11 -0
  148. package/dist/translations/bn.d.ts +8 -0
  149. package/dist/translations/bn.js +5 -0
  150. package/dist/translations/bn.umd.js +11 -0
  151. package/dist/translations/bs.d.ts +8 -0
  152. package/dist/translations/bs.js +5 -0
  153. package/dist/translations/bs.umd.js +11 -0
  154. package/dist/translations/ca.d.ts +8 -0
  155. package/dist/translations/ca.js +5 -0
  156. package/dist/translations/ca.umd.js +11 -0
  157. package/dist/translations/cs.d.ts +8 -0
  158. package/dist/translations/cs.js +5 -0
  159. package/dist/translations/cs.umd.js +11 -0
  160. package/dist/translations/da.d.ts +8 -0
  161. package/dist/translations/da.js +5 -0
  162. package/dist/translations/da.umd.js +11 -0
  163. package/dist/translations/de-ch.d.ts +8 -0
  164. package/dist/translations/de-ch.js +5 -0
  165. package/dist/translations/de-ch.umd.js +11 -0
  166. package/dist/translations/de.d.ts +8 -0
  167. package/dist/translations/de.js +5 -0
  168. package/dist/translations/de.umd.js +11 -0
  169. package/dist/translations/el.d.ts +8 -0
  170. package/dist/translations/el.js +5 -0
  171. package/dist/translations/el.umd.js +11 -0
  172. package/dist/translations/en-au.d.ts +8 -0
  173. package/dist/translations/en-au.js +5 -0
  174. package/dist/translations/en-au.umd.js +11 -0
  175. package/dist/translations/en-gb.d.ts +8 -0
  176. package/dist/translations/en-gb.js +5 -0
  177. package/dist/translations/en-gb.umd.js +11 -0
  178. package/dist/translations/en.d.ts +8 -0
  179. package/dist/translations/en.js +5 -0
  180. package/dist/translations/en.umd.js +11 -0
  181. package/dist/translations/eo.d.ts +8 -0
  182. package/dist/translations/eo.js +5 -0
  183. package/dist/translations/eo.umd.js +11 -0
  184. package/dist/translations/es.d.ts +8 -0
  185. package/dist/translations/es.js +5 -0
  186. package/dist/translations/es.umd.js +11 -0
  187. package/dist/translations/et.d.ts +8 -0
  188. package/dist/translations/et.js +5 -0
  189. package/dist/translations/et.umd.js +11 -0
  190. package/dist/translations/eu.d.ts +8 -0
  191. package/dist/translations/eu.js +5 -0
  192. package/dist/translations/eu.umd.js +11 -0
  193. package/dist/translations/fa.d.ts +8 -0
  194. package/dist/translations/fa.js +5 -0
  195. package/dist/translations/fa.umd.js +11 -0
  196. package/dist/translations/fi.d.ts +8 -0
  197. package/dist/translations/fi.js +5 -0
  198. package/dist/translations/fi.umd.js +11 -0
  199. package/dist/translations/fr.d.ts +8 -0
  200. package/dist/translations/fr.js +5 -0
  201. package/dist/translations/fr.umd.js +11 -0
  202. package/dist/translations/gl.d.ts +8 -0
  203. package/dist/translations/gl.js +5 -0
  204. package/dist/translations/gl.umd.js +11 -0
  205. package/dist/translations/he.d.ts +8 -0
  206. package/dist/translations/he.js +5 -0
  207. package/dist/translations/he.umd.js +11 -0
  208. package/dist/translations/hi.d.ts +8 -0
  209. package/dist/translations/hi.js +5 -0
  210. package/dist/translations/hi.umd.js +11 -0
  211. package/dist/translations/hr.d.ts +8 -0
  212. package/dist/translations/hr.js +5 -0
  213. package/dist/translations/hr.umd.js +11 -0
  214. package/dist/translations/hu.d.ts +8 -0
  215. package/dist/translations/hu.js +5 -0
  216. package/dist/translations/hu.umd.js +11 -0
  217. package/dist/translations/id.d.ts +8 -0
  218. package/dist/translations/id.js +5 -0
  219. package/dist/translations/id.umd.js +11 -0
  220. package/dist/translations/it.d.ts +8 -0
  221. package/dist/translations/it.js +5 -0
  222. package/dist/translations/it.umd.js +11 -0
  223. package/dist/translations/ja.d.ts +8 -0
  224. package/dist/translations/ja.js +5 -0
  225. package/dist/translations/ja.umd.js +11 -0
  226. package/dist/translations/jv.d.ts +8 -0
  227. package/dist/translations/jv.js +5 -0
  228. package/dist/translations/jv.umd.js +11 -0
  229. package/dist/translations/km.d.ts +8 -0
  230. package/dist/translations/km.js +5 -0
  231. package/dist/translations/km.umd.js +11 -0
  232. package/dist/translations/kn.d.ts +8 -0
  233. package/dist/translations/kn.js +5 -0
  234. package/dist/translations/kn.umd.js +11 -0
  235. package/dist/translations/ko.d.ts +8 -0
  236. package/dist/translations/ko.js +5 -0
  237. package/dist/translations/ko.umd.js +11 -0
  238. package/dist/translations/ku.d.ts +8 -0
  239. package/dist/translations/ku.js +5 -0
  240. package/dist/translations/ku.umd.js +11 -0
  241. package/dist/translations/lt.d.ts +8 -0
  242. package/dist/translations/lt.js +5 -0
  243. package/dist/translations/lt.umd.js +11 -0
  244. package/dist/translations/lv.d.ts +8 -0
  245. package/dist/translations/lv.js +5 -0
  246. package/dist/translations/lv.umd.js +11 -0
  247. package/dist/translations/ms.d.ts +8 -0
  248. package/dist/translations/ms.js +5 -0
  249. package/dist/translations/ms.umd.js +11 -0
  250. package/dist/translations/nb.d.ts +8 -0
  251. package/dist/translations/nb.js +5 -0
  252. package/dist/translations/nb.umd.js +11 -0
  253. package/dist/translations/ne.d.ts +8 -0
  254. package/dist/translations/ne.js +5 -0
  255. package/dist/translations/ne.umd.js +11 -0
  256. package/dist/translations/nl.d.ts +8 -0
  257. package/dist/translations/nl.js +5 -0
  258. package/dist/translations/nl.umd.js +11 -0
  259. package/dist/translations/no.d.ts +8 -0
  260. package/dist/translations/no.js +5 -0
  261. package/dist/translations/no.umd.js +11 -0
  262. package/dist/translations/pl.d.ts +8 -0
  263. package/dist/translations/pl.js +5 -0
  264. package/dist/translations/pl.umd.js +11 -0
  265. package/dist/translations/pt-br.d.ts +8 -0
  266. package/dist/translations/pt-br.js +5 -0
  267. package/dist/translations/pt-br.umd.js +11 -0
  268. package/dist/translations/pt.d.ts +8 -0
  269. package/dist/translations/pt.js +5 -0
  270. package/dist/translations/pt.umd.js +11 -0
  271. package/dist/translations/ro.d.ts +8 -0
  272. package/dist/translations/ro.js +5 -0
  273. package/dist/translations/ro.umd.js +11 -0
  274. package/dist/translations/ru.d.ts +8 -0
  275. package/dist/translations/ru.js +5 -0
  276. package/dist/translations/ru.umd.js +11 -0
  277. package/dist/translations/si.d.ts +8 -0
  278. package/dist/translations/si.js +5 -0
  279. package/dist/translations/si.umd.js +11 -0
  280. package/dist/translations/sk.d.ts +8 -0
  281. package/dist/translations/sk.js +5 -0
  282. package/dist/translations/sk.umd.js +11 -0
  283. package/dist/translations/sq.d.ts +8 -0
  284. package/dist/translations/sq.js +5 -0
  285. package/dist/translations/sq.umd.js +11 -0
  286. package/dist/translations/sr-latn.d.ts +8 -0
  287. package/dist/translations/sr-latn.js +5 -0
  288. package/dist/translations/sr-latn.umd.js +11 -0
  289. package/dist/translations/sr.d.ts +8 -0
  290. package/dist/translations/sr.js +5 -0
  291. package/dist/translations/sr.umd.js +11 -0
  292. package/dist/translations/sv.d.ts +8 -0
  293. package/dist/translations/sv.js +5 -0
  294. package/dist/translations/sv.umd.js +11 -0
  295. package/dist/translations/th.d.ts +8 -0
  296. package/dist/translations/th.js +5 -0
  297. package/dist/translations/th.umd.js +11 -0
  298. package/dist/translations/ti.d.ts +8 -0
  299. package/dist/translations/ti.js +5 -0
  300. package/dist/translations/ti.umd.js +11 -0
  301. package/dist/translations/tk.d.ts +8 -0
  302. package/dist/translations/tk.js +5 -0
  303. package/dist/translations/tk.umd.js +11 -0
  304. package/dist/translations/tr.d.ts +8 -0
  305. package/dist/translations/tr.js +5 -0
  306. package/dist/translations/tr.umd.js +11 -0
  307. package/dist/translations/ug.d.ts +8 -0
  308. package/dist/translations/ug.js +5 -0
  309. package/dist/translations/ug.umd.js +11 -0
  310. package/dist/translations/uk.d.ts +8 -0
  311. package/dist/translations/uk.js +5 -0
  312. package/dist/translations/uk.umd.js +11 -0
  313. package/dist/translations/ur.d.ts +8 -0
  314. package/dist/translations/ur.js +5 -0
  315. package/dist/translations/ur.umd.js +11 -0
  316. package/dist/translations/uz.d.ts +8 -0
  317. package/dist/translations/uz.js +5 -0
  318. package/dist/translations/uz.umd.js +11 -0
  319. package/dist/translations/vi.d.ts +8 -0
  320. package/dist/translations/vi.js +5 -0
  321. package/dist/translations/vi.umd.js +11 -0
  322. package/dist/translations/zh-cn.d.ts +8 -0
  323. package/dist/translations/zh-cn.js +5 -0
  324. package/dist/translations/zh-cn.umd.js +11 -0
  325. package/dist/translations/zh.d.ts +8 -0
  326. package/dist/translations/zh.js +5 -0
  327. package/dist/translations/zh.umd.js +11 -0
  328. package/lang/contexts.json +46 -0
  329. package/lang/translations/ar.po +194 -0
  330. package/lang/translations/ast.po +194 -0
  331. package/lang/translations/az.po +194 -0
  332. package/lang/translations/bg.po +194 -0
  333. package/lang/translations/bn.po +194 -0
  334. package/lang/translations/bs.po +194 -0
  335. package/lang/translations/ca.po +194 -0
  336. package/lang/translations/cs.po +194 -0
  337. package/lang/translations/da.po +194 -0
  338. package/lang/translations/de-ch.po +194 -0
  339. package/lang/translations/de.po +194 -0
  340. package/lang/translations/el.po +194 -0
  341. package/lang/translations/en-au.po +194 -0
  342. package/lang/translations/en-gb.po +194 -0
  343. package/lang/translations/en.po +194 -0
  344. package/lang/translations/eo.po +194 -0
  345. package/lang/translations/es.po +194 -0
  346. package/lang/translations/et.po +194 -0
  347. package/lang/translations/eu.po +194 -0
  348. package/lang/translations/fa.po +194 -0
  349. package/lang/translations/fi.po +194 -0
  350. package/lang/translations/fr.po +194 -0
  351. package/lang/translations/gl.po +194 -0
  352. package/lang/translations/he.po +194 -0
  353. package/lang/translations/hi.po +194 -0
  354. package/lang/translations/hr.po +194 -0
  355. package/lang/translations/hu.po +194 -0
  356. package/lang/translations/id.po +194 -0
  357. package/lang/translations/it.po +194 -0
  358. package/lang/translations/ja.po +194 -0
  359. package/lang/translations/jv.po +194 -0
  360. package/lang/translations/km.po +194 -0
  361. package/lang/translations/kn.po +194 -0
  362. package/lang/translations/ko.po +194 -0
  363. package/lang/translations/ku.po +194 -0
  364. package/lang/translations/lt.po +194 -0
  365. package/lang/translations/lv.po +194 -0
  366. package/lang/translations/ms.po +194 -0
  367. package/lang/translations/nb.po +194 -0
  368. package/lang/translations/ne.po +194 -0
  369. package/lang/translations/nl.po +194 -0
  370. package/lang/translations/no.po +194 -0
  371. package/lang/translations/pl.po +194 -0
  372. package/lang/translations/pt-br.po +194 -0
  373. package/lang/translations/pt.po +194 -0
  374. package/lang/translations/ro.po +194 -0
  375. package/lang/translations/ru.po +194 -0
  376. package/lang/translations/si.po +194 -0
  377. package/lang/translations/sk.po +194 -0
  378. package/lang/translations/sq.po +194 -0
  379. package/lang/translations/sr-latn.po +194 -0
  380. package/lang/translations/sr.po +194 -0
  381. package/lang/translations/sv.po +194 -0
  382. package/lang/translations/th.po +194 -0
  383. package/lang/translations/ti.po +194 -0
  384. package/lang/translations/tk.po +194 -0
  385. package/lang/translations/tr.po +194 -0
  386. package/lang/translations/ug.po +194 -0
  387. package/lang/translations/uk.po +194 -0
  388. package/lang/translations/ur.po +194 -0
  389. package/lang/translations/uz.po +194 -0
  390. package/lang/translations/vi.po +194 -0
  391. package/lang/translations/zh-cn.po +194 -0
  392. package/lang/translations/zh.po +194 -0
  393. package/package.json +48 -0
  394. package/src/augmentation.d.ts +57 -0
  395. package/src/augmentation.js +5 -0
  396. package/src/autoimage.d.ts +56 -0
  397. package/src/autoimage.js +138 -0
  398. package/src/image/converters.d.ts +66 -0
  399. package/src/image/converters.js +232 -0
  400. package/src/image/imageblockediting.d.ts +63 -0
  401. package/src/image/imageblockediting.js +159 -0
  402. package/src/image/imageediting.d.ts +34 -0
  403. package/src/image/imageediting.js +69 -0
  404. package/src/image/imageinlineediting.d.ts +64 -0
  405. package/src/image/imageinlineediting.js +178 -0
  406. package/src/image/imageloadobserver.d.ts +48 -0
  407. package/src/image/imageloadobserver.js +52 -0
  408. package/src/image/imageplaceholder.d.ts +43 -0
  409. package/src/image/imageplaceholder.js +119 -0
  410. package/src/image/imagetypecommand.d.ts +44 -0
  411. package/src/image/imagetypecommand.js +80 -0
  412. package/src/image/insertimagecommand.d.ts +68 -0
  413. package/src/image/insertimagecommand.js +121 -0
  414. package/src/image/replaceimagesourcecommand.d.ts +51 -0
  415. package/src/image/replaceimagesourcecommand.js +75 -0
  416. package/src/image/ui/utils.d.ts +25 -0
  417. package/src/image/ui/utils.js +44 -0
  418. package/src/image/utils.d.ts +64 -0
  419. package/src/image/utils.js +121 -0
  420. package/src/image.d.ts +38 -0
  421. package/src/image.js +44 -0
  422. package/src/imageblock.d.ts +38 -0
  423. package/src/imageblock.js +44 -0
  424. package/src/imagecaption/imagecaptionediting.d.ts +93 -0
  425. package/src/imagecaption/imagecaptionediting.js +231 -0
  426. package/src/imagecaption/imagecaptionui.d.ts +30 -0
  427. package/src/imagecaption/imagecaptionui.js +67 -0
  428. package/src/imagecaption/imagecaptionutils.d.ts +42 -0
  429. package/src/imagecaption/imagecaptionutils.js +68 -0
  430. package/src/imagecaption/toggleimagecaptioncommand.d.ts +66 -0
  431. package/src/imagecaption/toggleimagecaptioncommand.js +138 -0
  432. package/src/imagecaption.d.ts +30 -0
  433. package/src/imagecaption.js +36 -0
  434. package/src/imageconfig.d.ts +712 -0
  435. package/src/imageconfig.js +5 -0
  436. package/src/imageinline.d.ts +38 -0
  437. package/src/imageinline.js +44 -0
  438. package/src/imageinsert/imageinsertui.d.ts +86 -0
  439. package/src/imageinsert/imageinsertui.js +217 -0
  440. package/src/imageinsert/imageinsertviaurlui.d.ts +70 -0
  441. package/src/imageinsert/imageinsertviaurlui.js +174 -0
  442. package/src/imageinsert/ui/imageinsertformview.d.ts +56 -0
  443. package/src/imageinsert/ui/imageinsertformview.js +95 -0
  444. package/src/imageinsert/ui/imageinserturlview.d.ts +64 -0
  445. package/src/imageinsert/ui/imageinserturlview.js +88 -0
  446. package/src/imageinsert.d.ts +37 -0
  447. package/src/imageinsert.js +43 -0
  448. package/src/imageinsertviaurl.d.ts +35 -0
  449. package/src/imageinsertviaurl.js +41 -0
  450. package/src/imageresize/imagecustomresizeui.d.ts +65 -0
  451. package/src/imageresize/imagecustomresizeui.js +174 -0
  452. package/src/imageresize/imageresizebuttons.d.ts +68 -0
  453. package/src/imageresize/imageresizebuttons.js +295 -0
  454. package/src/imageresize/imageresizeediting.d.ts +45 -0
  455. package/src/imageresize/imageresizeediting.js +183 -0
  456. package/src/imageresize/imageresizehandles.d.ts +35 -0
  457. package/src/imageresize/imageresizehandles.js +118 -0
  458. package/src/imageresize/resizeimagecommand.d.ts +42 -0
  459. package/src/imageresize/resizeimagecommand.js +63 -0
  460. package/src/imageresize/ui/imagecustomresizeformview.d.ts +129 -0
  461. package/src/imageresize/ui/imagecustomresizeformview.js +186 -0
  462. package/src/imageresize/utils/getselectedimageeditornodes.d.ts +24 -0
  463. package/src/imageresize/utils/getselectedimageeditornodes.js +24 -0
  464. package/src/imageresize/utils/getselectedimagepossibleresizerange.d.ts +24 -0
  465. package/src/imageresize/utils/getselectedimagepossibleresizerange.js +32 -0
  466. package/src/imageresize/utils/getselectedimagewidthinunits.d.ts +18 -0
  467. package/src/imageresize/utils/getselectedimagewidthinunits.js +41 -0
  468. package/src/imageresize/utils/tryparsedimensionwithunit.d.ts +37 -0
  469. package/src/imageresize/utils/tryparsedimensionwithunit.js +56 -0
  470. package/src/imageresize.d.ts +32 -0
  471. package/src/imageresize.js +38 -0
  472. package/src/imagesizeattributes.d.ts +38 -0
  473. package/src/imagesizeattributes.js +148 -0
  474. package/src/imagestyle/converters.d.ts +24 -0
  475. package/src/imagestyle/converters.js +79 -0
  476. package/src/imagestyle/imagestylecommand.d.ts +68 -0
  477. package/src/imagestyle/imagestylecommand.js +107 -0
  478. package/src/imagestyle/imagestyleediting.d.ts +54 -0
  479. package/src/imagestyle/imagestyleediting.js +114 -0
  480. package/src/imagestyle/imagestyleui.d.ts +60 -0
  481. package/src/imagestyle/imagestyleui.js +198 -0
  482. package/src/imagestyle/utils.d.ts +101 -0
  483. package/src/imagestyle/utils.js +328 -0
  484. package/src/imagestyle.d.ts +36 -0
  485. package/src/imagestyle.js +42 -0
  486. package/src/imagetextalternative/imagetextalternativecommand.d.ts +34 -0
  487. package/src/imagetextalternative/imagetextalternativecommand.js +44 -0
  488. package/src/imagetextalternative/imagetextalternativeediting.d.ts +32 -0
  489. package/src/imagetextalternative/imagetextalternativeediting.js +41 -0
  490. package/src/imagetextalternative/imagetextalternativeui.d.ts +72 -0
  491. package/src/imagetextalternative/imagetextalternativeui.js +179 -0
  492. package/src/imagetextalternative/ui/textalternativeformview.d.ts +90 -0
  493. package/src/imagetextalternative/ui/textalternativeformview.js +121 -0
  494. package/src/imagetextalternative.d.ts +33 -0
  495. package/src/imagetextalternative.js +39 -0
  496. package/src/imagetoolbar.d.ts +39 -0
  497. package/src/imagetoolbar.js +63 -0
  498. package/src/imageupload/imageuploadediting.d.ts +115 -0
  499. package/src/imageupload/imageuploadediting.js +361 -0
  500. package/src/imageupload/imageuploadprogress.d.ts +46 -0
  501. package/src/imageupload/imageuploadprogress.js +217 -0
  502. package/src/imageupload/imageuploadui.d.ts +51 -0
  503. package/src/imageupload/imageuploadui.js +134 -0
  504. package/src/imageupload/uploadimagecommand.d.ts +74 -0
  505. package/src/imageupload/uploadimagecommand.js +110 -0
  506. package/src/imageupload/utils.d.ts +33 -0
  507. package/src/imageupload/utils.js +112 -0
  508. package/src/imageupload.d.ts +36 -0
  509. package/src/imageupload.js +42 -0
  510. package/src/imageutils.d.ts +129 -0
  511. package/src/imageutils.js +312 -0
  512. package/src/index.d.ts +50 -0
  513. package/src/index.js +41 -0
  514. package/src/pictureediting.d.ts +92 -0
  515. package/src/pictureediting.js +136 -0
  516. package/theme/image.css +143 -0
  517. package/theme/imagecaption.css +51 -0
  518. package/theme/imagecustomresizeform.css +33 -0
  519. package/theme/imageinsert.css +14 -0
  520. package/theme/imageplaceholder.css +10 -0
  521. package/theme/imageresize.css +53 -0
  522. package/theme/imagestyle.css +120 -0
  523. package/theme/imageuploadicon.css +23 -0
  524. package/theme/imageuploadloader.css +18 -0
  525. package/theme/imageuploadprogress.css +19 -0
  526. package/theme/textalternativeform.css +32 -0
@@ -0,0 +1,112 @@
1
+ /**
2
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
3
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
4
+ */
5
+ import { global } from 'ckeditor5/src/utils.js';
6
+ /**
7
+ * Creates a regular expression used to test for image files.
8
+ *
9
+ * ```ts
10
+ * const imageType = createImageTypeRegExp( [ 'png', 'jpeg', 'svg+xml', 'vnd.microsoft.icon' ] );
11
+ *
12
+ * console.log( 'is supported image', imageType.test( file.type ) );
13
+ * ```
14
+ */
15
+ export function createImageTypeRegExp(types) {
16
+ // Sanitize the MIME type name which may include: "+", "-" or ".".
17
+ const regExpSafeNames = types.map(type => type.replace('+', '\\+'));
18
+ return new RegExp(`^image\\/(${regExpSafeNames.join('|')})$`);
19
+ }
20
+ /**
21
+ * Creates a promise that fetches the image local source (Base64 or blob) and resolves with a `File` object.
22
+ *
23
+ * @param image Image whose source to fetch.
24
+ * @returns A promise which resolves when an image source is fetched and converted to a `File` instance.
25
+ * It resolves with a `File` object. If there were any errors during file processing, the promise will be rejected.
26
+ */
27
+ export function fetchLocalImage(image) {
28
+ return new Promise((resolve, reject) => {
29
+ const imageSrc = image.getAttribute('src');
30
+ // Fetch works asynchronously and so does not block browser UI when processing data.
31
+ fetch(imageSrc)
32
+ .then(resource => resource.blob())
33
+ .then(blob => {
34
+ const mimeType = getImageMimeType(blob, imageSrc);
35
+ const ext = mimeType.replace('image/', '');
36
+ const filename = `image.${ext}`;
37
+ const file = new File([blob], filename, { type: mimeType });
38
+ resolve(file);
39
+ })
40
+ .catch(err => {
41
+ // Fetch fails only, if it can't make a request due to a network failure or if anything prevented the request
42
+ // from completing, i.e. the Content Security Policy rules. It is not possible to detect the exact cause of failure,
43
+ // so we are just trying the fallback solution, if general TypeError is thrown.
44
+ return err && err.name === 'TypeError' ?
45
+ convertLocalImageOnCanvas(imageSrc).then(resolve).catch(reject) :
46
+ reject(err);
47
+ });
48
+ });
49
+ }
50
+ /**
51
+ * Checks whether a given node is an image element with a local source (Base64 or blob).
52
+ *
53
+ * @param node The node to check.
54
+ */
55
+ export function isLocalImage(imageUtils, node) {
56
+ if (!imageUtils.isInlineImageView(node) || !node.getAttribute('src')) {
57
+ return false;
58
+ }
59
+ return !!node.getAttribute('src').match(/^data:image\/\w+;base64,/g) ||
60
+ !!node.getAttribute('src').match(/^blob:/g);
61
+ }
62
+ /**
63
+ * Extracts an image type based on its blob representation or its source.
64
+ * @param blob Image blob representation.
65
+ * @param src Image `src` attribute value.
66
+ */
67
+ function getImageMimeType(blob, src) {
68
+ if (blob.type) {
69
+ return blob.type;
70
+ }
71
+ else if (src.match(/data:(image\/\w+);base64/)) {
72
+ return src.match(/data:(image\/\w+);base64/)[1].toLowerCase();
73
+ }
74
+ else {
75
+ // Fallback to 'jpeg' as common extension.
76
+ return 'image/jpeg';
77
+ }
78
+ }
79
+ /**
80
+ * Creates a promise that converts the image local source (Base64 or blob) to a blob using canvas and resolves
81
+ * with a `File` object.
82
+ * @param imageSrc Image `src` attribute value.
83
+ * @returns A promise which resolves when an image source is converted to a `File` instance.
84
+ * It resolves with a `File` object. If there were any errors during file processing, the promise will be rejected.
85
+ */
86
+ function convertLocalImageOnCanvas(imageSrc) {
87
+ return getBlobFromCanvas(imageSrc).then(blob => {
88
+ const mimeType = getImageMimeType(blob, imageSrc);
89
+ const ext = mimeType.replace('image/', '');
90
+ const filename = `image.${ext}`;
91
+ return new File([blob], filename, { type: mimeType });
92
+ });
93
+ }
94
+ /**
95
+ * Creates a promise that resolves with a `Blob` object converted from the image source (Base64 or blob).
96
+ * @param imageSrc Image `src` attribute value.
97
+ */
98
+ function getBlobFromCanvas(imageSrc) {
99
+ return new Promise((resolve, reject) => {
100
+ const image = global.document.createElement('img');
101
+ image.addEventListener('load', () => {
102
+ const canvas = global.document.createElement('canvas');
103
+ canvas.width = image.width;
104
+ canvas.height = image.height;
105
+ const ctx = canvas.getContext('2d');
106
+ ctx.drawImage(image, 0, 0);
107
+ canvas.toBlob(blob => blob ? resolve(blob) : reject());
108
+ });
109
+ image.addEventListener('error', () => reject());
110
+ image.src = imageSrc;
111
+ });
112
+ }
@@ -0,0 +1,36 @@
1
+ /**
2
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
3
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
4
+ */
5
+ /**
6
+ * @module image/imageupload
7
+ */
8
+ import { Plugin } from 'ckeditor5/src/core.js';
9
+ import ImageUploadUI from './imageupload/imageuploadui.js';
10
+ import ImageUploadProgress from './imageupload/imageuploadprogress.js';
11
+ import ImageUploadEditing from './imageupload/imageuploadediting.js';
12
+ /**
13
+ * The image upload plugin.
14
+ *
15
+ * For a detailed overview, check the {@glink features/images/image-upload/image-upload image upload feature} documentation.
16
+ *
17
+ * This plugin does not do anything directly, but it loads a set of specific plugins to enable image uploading:
18
+ *
19
+ * * {@link module:image/imageupload/imageuploadediting~ImageUploadEditing},
20
+ * * {@link module:image/imageupload/imageuploadui~ImageUploadUI},
21
+ * * {@link module:image/imageupload/imageuploadprogress~ImageUploadProgress}.
22
+ */
23
+ export default class ImageUpload extends Plugin {
24
+ /**
25
+ * @inheritDoc
26
+ */
27
+ static get pluginName(): "ImageUpload";
28
+ /**
29
+ * @inheritDoc
30
+ */
31
+ static get isOfficialPlugin(): true;
32
+ /**
33
+ * @inheritDoc
34
+ */
35
+ static get requires(): readonly [typeof ImageUploadEditing, typeof ImageUploadUI, typeof ImageUploadProgress];
36
+ }
@@ -0,0 +1,42 @@
1
+ /**
2
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
3
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
4
+ */
5
+ /**
6
+ * @module image/imageupload
7
+ */
8
+ import { Plugin } from 'ckeditor5/src/core.js';
9
+ import ImageUploadUI from './imageupload/imageuploadui.js';
10
+ import ImageUploadProgress from './imageupload/imageuploadprogress.js';
11
+ import ImageUploadEditing from './imageupload/imageuploadediting.js';
12
+ /**
13
+ * The image upload plugin.
14
+ *
15
+ * For a detailed overview, check the {@glink features/images/image-upload/image-upload image upload feature} documentation.
16
+ *
17
+ * This plugin does not do anything directly, but it loads a set of specific plugins to enable image uploading:
18
+ *
19
+ * * {@link module:image/imageupload/imageuploadediting~ImageUploadEditing},
20
+ * * {@link module:image/imageupload/imageuploadui~ImageUploadUI},
21
+ * * {@link module:image/imageupload/imageuploadprogress~ImageUploadProgress}.
22
+ */
23
+ export default class ImageUpload extends Plugin {
24
+ /**
25
+ * @inheritDoc
26
+ */
27
+ static get pluginName() {
28
+ return 'ImageUpload';
29
+ }
30
+ /**
31
+ * @inheritDoc
32
+ */
33
+ static get isOfficialPlugin() {
34
+ return true;
35
+ }
36
+ /**
37
+ * @inheritDoc
38
+ */
39
+ static get requires() {
40
+ return [ImageUploadEditing, ImageUploadUI, ImageUploadProgress];
41
+ }
42
+ }
@@ -0,0 +1,129 @@
1
+ /**
2
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
3
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
4
+ */
5
+ /**
6
+ * @module image/imageutils
7
+ */
8
+ import type { Element, ViewElement, DocumentSelection, ViewDocumentSelection, Selection, ViewSelection, DowncastWriter, Position, ViewContainerElement } from 'ckeditor5/src/engine.js';
9
+ import { Plugin } from 'ckeditor5/src/core.js';
10
+ /**
11
+ * A set of helpers related to images.
12
+ */
13
+ export default class ImageUtils extends Plugin {
14
+ /**
15
+ * DOM Emitter.
16
+ */
17
+ private _domEmitter;
18
+ /**
19
+ * @inheritDoc
20
+ */
21
+ static get pluginName(): "ImageUtils";
22
+ /**
23
+ * @inheritDoc
24
+ */
25
+ static get isOfficialPlugin(): true;
26
+ /**
27
+ * Checks if the provided model element is an `image` or `imageInline`.
28
+ */
29
+ isImage(modelElement?: Element | null): modelElement is Element & {
30
+ name: 'imageInline' | 'imageBlock';
31
+ };
32
+ /**
33
+ * Checks if the provided view element represents an inline image.
34
+ *
35
+ * Also, see {@link module:image/imageutils~ImageUtils#isImageWidget}.
36
+ */
37
+ isInlineImageView(element?: ViewElement | null): boolean;
38
+ /**
39
+ * Checks if the provided view element represents a block image.
40
+ *
41
+ * Also, see {@link module:image/imageutils~ImageUtils#isImageWidget}.
42
+ */
43
+ isBlockImageView(element?: ViewElement | null): boolean;
44
+ /**
45
+ * Handles inserting single file. This method unifies image insertion using {@link module:widget/utils~findOptimalInsertionRange}
46
+ * method.
47
+ *
48
+ * ```ts
49
+ * const imageUtils = editor.plugins.get( 'ImageUtils' );
50
+ *
51
+ * imageUtils.insertImage( { src: 'path/to/image.jpg' } );
52
+ * ```
53
+ *
54
+ * @param attributes Attributes of the inserted image.
55
+ * This method filters out the attributes which are disallowed by the {@link module:engine/model/schema~Schema}.
56
+ * @param selectable Place to insert the image. If not specified,
57
+ * the {@link module:widget/utils~findOptimalInsertionRange} logic will be applied for the block images
58
+ * and `model.document.selection` for the inline images.
59
+ *
60
+ * **Note**: If `selectable` is passed, this helper will not be able to set selection attributes (such as `linkHref`)
61
+ * and apply them to the new image. In this case, make sure all selection attributes are passed in `attributes`.
62
+ *
63
+ * @param imageType Image type of inserted image. If not specified,
64
+ * it will be determined automatically depending of editor config or place of the insertion.
65
+ * @param options.setImageSizes Specifies whether the image `width` and `height` attributes should be set automatically.
66
+ * The default is `true`.
67
+ * @return The inserted model image element.
68
+ */
69
+ insertImage(attributes?: Record<string, unknown>, selectable?: Selection | Position | null, imageType?: ('imageBlock' | 'imageInline' | null), options?: {
70
+ setImageSizes?: boolean;
71
+ }): Element | null;
72
+ /**
73
+ * Reads original image sizes and sets them as `width` and `height`.
74
+ *
75
+ * The `src` attribute may not be available if the user is using an upload adapter. In such a case,
76
+ * this method is called again after the upload process is complete and the `src` attribute is available.
77
+ */
78
+ setImageNaturalSizeAttributes(imageElement: Element): void;
79
+ /**
80
+ * Returns an image widget editing view element if one is selected or is among the selection's ancestors.
81
+ */
82
+ getClosestSelectedImageWidget(selection: ViewSelection | ViewDocumentSelection): ViewElement | null;
83
+ /**
84
+ * Returns a image model element if one is selected or is among the selection's ancestors.
85
+ */
86
+ getClosestSelectedImageElement(selection: Selection | DocumentSelection): Element | null;
87
+ /**
88
+ * Returns an image widget editing view based on the passed image view.
89
+ */
90
+ getImageWidgetFromImageView(imageView: ViewElement): ViewContainerElement | null;
91
+ /**
92
+ * Checks if image can be inserted at current model selection.
93
+ *
94
+ * @internal
95
+ */
96
+ isImageAllowed(): boolean;
97
+ /**
98
+ * Converts a given {@link module:engine/view/element~Element} to an image widget:
99
+ * * Adds a {@link module:engine/view/element~Element#_setCustomProperty custom property} allowing to recognize the image widget
100
+ * element.
101
+ * * Calls the {@link module:widget/utils~toWidget} function with the proper element's label creator.
102
+ *
103
+ * @param writer An instance of the view writer.
104
+ * @param label The element's label. It will be concatenated with the image `alt` attribute if one is present.
105
+ */
106
+ toImageWidget(viewElement: ViewElement, writer: DowncastWriter, label: string): ViewElement;
107
+ /**
108
+ * Checks if a given view element is an image widget.
109
+ */
110
+ protected isImageWidget(viewElement: ViewElement): boolean;
111
+ /**
112
+ * Checks if the provided model element is an `image`.
113
+ */
114
+ isBlockImage(modelElement?: Element | null): boolean;
115
+ /**
116
+ * Checks if the provided model element is an `imageInline`.
117
+ */
118
+ isInlineImage(modelElement?: Element | null): boolean;
119
+ /**
120
+ * Get the view `<img>` from another view element, e.g. a widget (`<figure class="image">`), a link (`<a>`).
121
+ *
122
+ * The `<img>` can be located deep in other elements, so this helper performs a deep tree search.
123
+ */
124
+ findViewImgElement(figureView: ViewElement): ViewElement | undefined;
125
+ /**
126
+ * @inheritDoc
127
+ */
128
+ destroy(): void;
129
+ }
@@ -0,0 +1,312 @@
1
+ /**
2
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
3
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
4
+ */
5
+ import { Plugin } from 'ckeditor5/src/core.js';
6
+ import { findOptimalInsertionRange, isWidget, toWidget } from 'ckeditor5/src/widget.js';
7
+ import { determineImageTypeForInsertionAtSelection } from './image/utils.js';
8
+ import { DomEmitterMixin, global } from 'ckeditor5/src/utils.js';
9
+ const IMAGE_WIDGETS_CLASSES_MATCH_REGEXP = /^(image|image-inline)$/;
10
+ /**
11
+ * A set of helpers related to images.
12
+ */
13
+ export default class ImageUtils extends Plugin {
14
+ constructor() {
15
+ super(...arguments);
16
+ /**
17
+ * DOM Emitter.
18
+ */
19
+ this._domEmitter = new (DomEmitterMixin())();
20
+ }
21
+ /**
22
+ * @inheritDoc
23
+ */
24
+ static get pluginName() {
25
+ return 'ImageUtils';
26
+ }
27
+ /**
28
+ * @inheritDoc
29
+ */
30
+ static get isOfficialPlugin() {
31
+ return true;
32
+ }
33
+ /**
34
+ * Checks if the provided model element is an `image` or `imageInline`.
35
+ */
36
+ isImage(modelElement) {
37
+ return this.isInlineImage(modelElement) || this.isBlockImage(modelElement);
38
+ }
39
+ /**
40
+ * Checks if the provided view element represents an inline image.
41
+ *
42
+ * Also, see {@link module:image/imageutils~ImageUtils#isImageWidget}.
43
+ */
44
+ isInlineImageView(element) {
45
+ return !!element && element.is('element', 'img');
46
+ }
47
+ /**
48
+ * Checks if the provided view element represents a block image.
49
+ *
50
+ * Also, see {@link module:image/imageutils~ImageUtils#isImageWidget}.
51
+ */
52
+ isBlockImageView(element) {
53
+ return !!element && element.is('element', 'figure') && element.hasClass('image');
54
+ }
55
+ /**
56
+ * Handles inserting single file. This method unifies image insertion using {@link module:widget/utils~findOptimalInsertionRange}
57
+ * method.
58
+ *
59
+ * ```ts
60
+ * const imageUtils = editor.plugins.get( 'ImageUtils' );
61
+ *
62
+ * imageUtils.insertImage( { src: 'path/to/image.jpg' } );
63
+ * ```
64
+ *
65
+ * @param attributes Attributes of the inserted image.
66
+ * This method filters out the attributes which are disallowed by the {@link module:engine/model/schema~Schema}.
67
+ * @param selectable Place to insert the image. If not specified,
68
+ * the {@link module:widget/utils~findOptimalInsertionRange} logic will be applied for the block images
69
+ * and `model.document.selection` for the inline images.
70
+ *
71
+ * **Note**: If `selectable` is passed, this helper will not be able to set selection attributes (such as `linkHref`)
72
+ * and apply them to the new image. In this case, make sure all selection attributes are passed in `attributes`.
73
+ *
74
+ * @param imageType Image type of inserted image. If not specified,
75
+ * it will be determined automatically depending of editor config or place of the insertion.
76
+ * @param options.setImageSizes Specifies whether the image `width` and `height` attributes should be set automatically.
77
+ * The default is `true`.
78
+ * @return The inserted model image element.
79
+ */
80
+ insertImage(attributes = {}, selectable = null, imageType = null, options = {}) {
81
+ const editor = this.editor;
82
+ const model = editor.model;
83
+ const selection = model.document.selection;
84
+ const determinedImageType = determineImageTypeForInsertion(editor, selectable || selection, imageType);
85
+ // Mix declarative attributes with selection attributes because the new image should "inherit"
86
+ // the latter for best UX. For instance, inline images inserted into existing links
87
+ // should not split them. To do that, they need to have "linkHref" inherited from the selection.
88
+ attributes = {
89
+ ...Object.fromEntries(selection.getAttributes()),
90
+ ...attributes
91
+ };
92
+ for (const attributeName in attributes) {
93
+ if (!model.schema.checkAttribute(determinedImageType, attributeName)) {
94
+ delete attributes[attributeName];
95
+ }
96
+ }
97
+ return model.change(writer => {
98
+ const { setImageSizes = true } = options;
99
+ const imageElement = writer.createElement(determinedImageType, attributes);
100
+ model.insertObject(imageElement, selectable, null, {
101
+ setSelection: 'on',
102
+ // If we want to insert a block image (for whatever reason) then we don't want to split text blocks.
103
+ // This applies only when we don't have the selectable specified (i.e., we insert multiple block images at once).
104
+ findOptimalPosition: !selectable && determinedImageType != 'imageInline' ? 'auto' : undefined
105
+ });
106
+ // Inserting an image might've failed due to schema regulations.
107
+ if (imageElement.parent) {
108
+ if (setImageSizes) {
109
+ this.setImageNaturalSizeAttributes(imageElement);
110
+ }
111
+ return imageElement;
112
+ }
113
+ return null;
114
+ });
115
+ }
116
+ /**
117
+ * Reads original image sizes and sets them as `width` and `height`.
118
+ *
119
+ * The `src` attribute may not be available if the user is using an upload adapter. In such a case,
120
+ * this method is called again after the upload process is complete and the `src` attribute is available.
121
+ */
122
+ setImageNaturalSizeAttributes(imageElement) {
123
+ const src = imageElement.getAttribute('src');
124
+ if (!src) {
125
+ return;
126
+ }
127
+ if (imageElement.getAttribute('width') || imageElement.getAttribute('height')) {
128
+ return;
129
+ }
130
+ this.editor.model.change(writer => {
131
+ const img = new global.window.Image();
132
+ this._domEmitter.listenTo(img, 'load', () => {
133
+ if (!imageElement.getAttribute('width') && !imageElement.getAttribute('height')) {
134
+ // We use writer.batch to be able to undo (in a single step) width and height setting
135
+ // along with any change that triggered this action (e.g. image resize or image style change).
136
+ this.editor.model.enqueueChange(writer.batch, writer => {
137
+ writer.setAttribute('width', img.naturalWidth, imageElement);
138
+ writer.setAttribute('height', img.naturalHeight, imageElement);
139
+ });
140
+ }
141
+ this._domEmitter.stopListening(img, 'load');
142
+ });
143
+ img.src = src;
144
+ });
145
+ }
146
+ /**
147
+ * Returns an image widget editing view element if one is selected or is among the selection's ancestors.
148
+ */
149
+ getClosestSelectedImageWidget(selection) {
150
+ const selectionPosition = selection.getFirstPosition();
151
+ if (!selectionPosition) {
152
+ return null;
153
+ }
154
+ const viewElement = selection.getSelectedElement();
155
+ if (viewElement && this.isImageWidget(viewElement)) {
156
+ return viewElement;
157
+ }
158
+ let parent = selectionPosition.parent;
159
+ while (parent) {
160
+ if (parent.is('element') && this.isImageWidget(parent)) {
161
+ return parent;
162
+ }
163
+ parent = parent.parent;
164
+ }
165
+ return null;
166
+ }
167
+ /**
168
+ * Returns a image model element if one is selected or is among the selection's ancestors.
169
+ */
170
+ getClosestSelectedImageElement(selection) {
171
+ const selectedElement = selection.getSelectedElement();
172
+ return this.isImage(selectedElement) ? selectedElement : selection.getFirstPosition().findAncestor('imageBlock');
173
+ }
174
+ /**
175
+ * Returns an image widget editing view based on the passed image view.
176
+ */
177
+ getImageWidgetFromImageView(imageView) {
178
+ return imageView.findAncestor({ classes: IMAGE_WIDGETS_CLASSES_MATCH_REGEXP });
179
+ }
180
+ /**
181
+ * Checks if image can be inserted at current model selection.
182
+ *
183
+ * @internal
184
+ */
185
+ isImageAllowed() {
186
+ const model = this.editor.model;
187
+ const selection = model.document.selection;
188
+ return isImageAllowedInParent(this.editor, selection) && isNotInsideImage(selection);
189
+ }
190
+ /**
191
+ * Converts a given {@link module:engine/view/element~Element} to an image widget:
192
+ * * Adds a {@link module:engine/view/element~Element#_setCustomProperty custom property} allowing to recognize the image widget
193
+ * element.
194
+ * * Calls the {@link module:widget/utils~toWidget} function with the proper element's label creator.
195
+ *
196
+ * @param writer An instance of the view writer.
197
+ * @param label The element's label. It will be concatenated with the image `alt` attribute if one is present.
198
+ */
199
+ toImageWidget(viewElement, writer, label) {
200
+ writer.setCustomProperty('image', true, viewElement);
201
+ const labelCreator = () => {
202
+ const imgElement = this.findViewImgElement(viewElement);
203
+ const altText = imgElement.getAttribute('alt');
204
+ return altText ? `${altText} ${label}` : label;
205
+ };
206
+ return toWidget(viewElement, writer, { label: labelCreator });
207
+ }
208
+ /**
209
+ * Checks if a given view element is an image widget.
210
+ */
211
+ isImageWidget(viewElement) {
212
+ return !!viewElement.getCustomProperty('image') && isWidget(viewElement);
213
+ }
214
+ /**
215
+ * Checks if the provided model element is an `image`.
216
+ */
217
+ isBlockImage(modelElement) {
218
+ return !!modelElement && modelElement.is('element', 'imageBlock');
219
+ }
220
+ /**
221
+ * Checks if the provided model element is an `imageInline`.
222
+ */
223
+ isInlineImage(modelElement) {
224
+ return !!modelElement && modelElement.is('element', 'imageInline');
225
+ }
226
+ /**
227
+ * Get the view `<img>` from another view element, e.g. a widget (`<figure class="image">`), a link (`<a>`).
228
+ *
229
+ * The `<img>` can be located deep in other elements, so this helper performs a deep tree search.
230
+ */
231
+ findViewImgElement(figureView) {
232
+ if (this.isInlineImageView(figureView)) {
233
+ return figureView;
234
+ }
235
+ const editingView = this.editor.editing.view;
236
+ for (const { item } of editingView.createRangeIn(figureView)) {
237
+ if (this.isInlineImageView(item)) {
238
+ return item;
239
+ }
240
+ }
241
+ }
242
+ /**
243
+ * @inheritDoc
244
+ */
245
+ destroy() {
246
+ this._domEmitter.stopListening();
247
+ return super.destroy();
248
+ }
249
+ }
250
+ /**
251
+ * Checks if image is allowed by schema in optimal insertion parent.
252
+ */
253
+ function isImageAllowedInParent(editor, selection) {
254
+ const imageType = determineImageTypeForInsertion(editor, selection, null);
255
+ if (imageType == 'imageBlock') {
256
+ const parent = getInsertImageParent(selection, editor.model);
257
+ if (editor.model.schema.checkChild(parent, 'imageBlock')) {
258
+ return true;
259
+ }
260
+ }
261
+ else if (editor.model.schema.checkChild(selection.focus, 'imageInline')) {
262
+ return true;
263
+ }
264
+ return false;
265
+ }
266
+ /**
267
+ * Checks if selection is not placed inside an image (e.g. its caption).
268
+ */
269
+ function isNotInsideImage(selection) {
270
+ return [...selection.focus.getAncestors()].every(ancestor => !ancestor.is('element', 'imageBlock'));
271
+ }
272
+ /**
273
+ * Returns a node that will be used to insert image with `model.insertContent`.
274
+ */
275
+ function getInsertImageParent(selection, model) {
276
+ const insertionRange = findOptimalInsertionRange(selection, model);
277
+ const parent = insertionRange.start.parent;
278
+ if (parent.isEmpty && !parent.is('element', '$root')) {
279
+ return parent.parent;
280
+ }
281
+ return parent;
282
+ }
283
+ /**
284
+ * Determine image element type name depending on editor config or place of insertion.
285
+ *
286
+ * @param imageType Image element type name. Used to force return of provided element name,
287
+ * but only if there is proper plugin enabled.
288
+ */
289
+ function determineImageTypeForInsertion(editor, selectable, imageType) {
290
+ const schema = editor.model.schema;
291
+ const configImageInsertType = editor.config.get('image.insert.type');
292
+ if (!editor.plugins.has('ImageBlockEditing')) {
293
+ return 'imageInline';
294
+ }
295
+ if (!editor.plugins.has('ImageInlineEditing')) {
296
+ return 'imageBlock';
297
+ }
298
+ if (imageType) {
299
+ return imageType;
300
+ }
301
+ if (configImageInsertType === 'inline') {
302
+ return 'imageInline';
303
+ }
304
+ if (configImageInsertType !== 'auto') {
305
+ return 'imageBlock';
306
+ }
307
+ // Try to replace the selected widget (e.g. another image).
308
+ if (selectable.is('selection')) {
309
+ return determineImageTypeForInsertionAtSelection(schema, selectable);
310
+ }
311
+ return schema.checkChild(selectable, 'imageInline') ? 'imageInline' : 'imageBlock';
312
+ }
package/src/index.d.ts ADDED
@@ -0,0 +1,50 @@
1
+ /**
2
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
3
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
4
+ */
5
+ /**
6
+ * @module image
7
+ */
8
+ export { default as AutoImage } from './autoimage.js';
9
+ export { default as Image } from './image.js';
10
+ export { default as ImageEditing } from './image/imageediting.js';
11
+ export { default as ImageCaptionUtils } from './imagecaption/imagecaptionutils.js';
12
+ export { default as ImageCaption } from './imagecaption.js';
13
+ export { default as ImageCaptionEditing } from './imagecaption/imagecaptionediting.js';
14
+ export { default as ImageInsert } from './imageinsert.js';
15
+ export { default as ImageInsertUI } from './imageinsert/imageinsertui.js';
16
+ export { default as ImageResize } from './imageresize.js';
17
+ export { default as ImageResizeButtons } from './imageresize/imageresizebuttons.js';
18
+ export { default as ImageResizeEditing } from './imageresize/imageresizeediting.js';
19
+ export { default as ImageResizeHandles } from './imageresize/imageresizehandles.js';
20
+ export { default as ImageCustomResizeUI } from './imageresize/imagecustomresizeui.js';
21
+ export { default as ImageSizeAttributes } from './imagesizeattributes.js';
22
+ export { default as ImageStyle } from './imagestyle.js';
23
+ export { default as ImageStyleEditing } from './imagestyle/imagestyleediting.js';
24
+ export { default as ImageStyleUI } from './imagestyle/imagestyleui.js';
25
+ export { default as ImageTextAlternative } from './imagetextalternative.js';
26
+ export { default as ImageTextAlternativeEditing } from './imagetextalternative/imagetextalternativeediting.js';
27
+ export { default as ImageTextAlternativeUI } from './imagetextalternative/imagetextalternativeui.js';
28
+ export { default as ImageToolbar } from './imagetoolbar.js';
29
+ export { default as ImageUpload } from './imageupload.js';
30
+ export { default as ImageUploadEditing, type ImageUploadCompleteEvent } from './imageupload/imageuploadediting.js';
31
+ export { default as ImageUploadProgress } from './imageupload/imageuploadprogress.js';
32
+ export { default as ImageUploadUI } from './imageupload/imageuploadui.js';
33
+ export { default as PictureEditing } from './pictureediting.js';
34
+ export { default as ImageBlock } from './imageblock.js';
35
+ export { default as ImageInline } from './imageinline.js';
36
+ export { default as ImageInsertViaUrl } from './imageinsertviaurl.js';
37
+ export { default as ImageUtils } from './imageutils.js';
38
+ export { default as ImageBlockEditing } from './image/imageblockediting.js';
39
+ export { default as ImageCaptionUI } from './imagecaption/imagecaptionui.js';
40
+ export { createImageTypeRegExp } from './imageupload/utils.js';
41
+ export type { ImageConfig } from './imageconfig.js';
42
+ export type { default as ImageTypeCommand } from './image/imagetypecommand.js';
43
+ export type { default as InsertImageCommand } from './image/insertimagecommand.js';
44
+ export type { default as ReplaceImageSourceCommand } from './image/replaceimagesourcecommand.js';
45
+ export type { default as ToggleImageCaptionCommand } from './imagecaption/toggleimagecaptioncommand.js';
46
+ export type { default as ResizeImageCommand } from './imageresize/resizeimagecommand.js';
47
+ export type { default as ImageStyleCommand } from './imagestyle/imagestylecommand.js';
48
+ export type { default as ImageTextAlternativeCommand } from './imagetextalternative/imagetextalternativecommand.js';
49
+ export type { default as UploadImageCommand } from './imageupload/uploadimagecommand.js';
50
+ import './augmentation.js';