@ckeditor/ckeditor5-ui 40.1.0 → 41.0.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 (282) hide show
  1. package/CHANGELOG.md +34 -34
  2. package/LICENSE.md +1 -1
  3. package/lang/contexts.json +3 -1
  4. package/lang/translations/ar.po +9 -1
  5. package/lang/translations/ast.po +9 -1
  6. package/lang/translations/az.po +9 -1
  7. package/lang/translations/bg.po +9 -1
  8. package/lang/translations/bn.po +9 -1
  9. package/lang/translations/ca.po +9 -1
  10. package/lang/translations/cs.po +9 -1
  11. package/lang/translations/da.po +9 -1
  12. package/lang/translations/de-ch.po +9 -1
  13. package/lang/translations/de.po +9 -1
  14. package/lang/translations/el.po +9 -1
  15. package/lang/translations/en-au.po +9 -1
  16. package/lang/translations/en-gb.po +9 -1
  17. package/lang/translations/en.po +9 -1
  18. package/lang/translations/eo.po +9 -1
  19. package/lang/translations/es.po +14 -6
  20. package/lang/translations/et.po +9 -1
  21. package/lang/translations/eu.po +9 -1
  22. package/lang/translations/fa.po +9 -1
  23. package/lang/translations/fi.po +9 -1
  24. package/lang/translations/fr.po +9 -1
  25. package/lang/translations/gl.po +12 -4
  26. package/lang/translations/he.po +9 -1
  27. package/lang/translations/hi.po +9 -1
  28. package/lang/translations/hr.po +9 -1
  29. package/lang/translations/hu.po +9 -1
  30. package/lang/translations/id.po +9 -1
  31. package/lang/translations/it.po +9 -1
  32. package/lang/translations/ja.po +9 -1
  33. package/lang/translations/km.po +9 -1
  34. package/lang/translations/kn.po +9 -1
  35. package/lang/translations/ko.po +9 -1
  36. package/lang/translations/ku.po +9 -1
  37. package/lang/translations/lt.po +9 -1
  38. package/lang/translations/lv.po +9 -1
  39. package/lang/translations/ms.po +9 -1
  40. package/lang/translations/nb.po +9 -1
  41. package/lang/translations/ne.po +9 -1
  42. package/lang/translations/nl.po +9 -1
  43. package/lang/translations/no.po +9 -1
  44. package/lang/translations/pl.po +9 -1
  45. package/lang/translations/pt-br.po +9 -1
  46. package/lang/translations/pt.po +9 -1
  47. package/lang/translations/ro.po +9 -1
  48. package/lang/translations/ru.po +9 -1
  49. package/lang/translations/sk.po +9 -1
  50. package/lang/translations/sl.po +9 -1
  51. package/lang/translations/sq.po +9 -1
  52. package/lang/translations/sr-latn.po +14 -6
  53. package/lang/translations/sr.po +9 -1
  54. package/lang/translations/sv.po +9 -1
  55. package/lang/translations/th.po +9 -1
  56. package/lang/translations/tk.po +9 -1
  57. package/lang/translations/tr.po +9 -1
  58. package/lang/translations/tt.po +9 -1
  59. package/lang/translations/ug.po +9 -1
  60. package/lang/translations/uk.po +9 -1
  61. package/lang/translations/ur.po +9 -1
  62. package/lang/translations/uz.po +9 -1
  63. package/lang/translations/vi.po +9 -1
  64. package/lang/translations/zh-cn.po +9 -1
  65. package/lang/translations/zh.po +9 -1
  66. package/package.json +4 -3
  67. package/src/arialiveannouncer.d.ts +14 -10
  68. package/src/arialiveannouncer.js +11 -8
  69. package/src/augmentation.d.ts +3 -2
  70. package/src/augmentation.js +1 -1
  71. package/src/autocomplete/autocompleteview.d.ts +4 -4
  72. package/src/autocomplete/autocompleteview.js +4 -3
  73. package/src/bindings/addkeyboardhandlingforgrid.d.ts +2 -2
  74. package/src/bindings/addkeyboardhandlingforgrid.js +1 -1
  75. package/src/bindings/clickoutsidehandler.d.ts +1 -1
  76. package/src/bindings/clickoutsidehandler.js +1 -1
  77. package/src/bindings/csstransitiondisablermixin.d.ts +2 -2
  78. package/src/bindings/csstransitiondisablermixin.js +1 -1
  79. package/src/bindings/draggableviewmixin.d.ts +46 -0
  80. package/src/bindings/draggableviewmixin.js +144 -0
  81. package/src/bindings/injectcsstransitiondisabler.d.ts +2 -2
  82. package/src/bindings/injectcsstransitiondisabler.js +1 -1
  83. package/src/bindings/preventdefault.d.ts +3 -3
  84. package/src/bindings/preventdefault.js +1 -1
  85. package/src/bindings/submithandler.d.ts +2 -2
  86. package/src/bindings/submithandler.js +1 -1
  87. package/src/button/button.d.ts +1 -1
  88. package/src/button/button.js +1 -1
  89. package/src/button/buttonlabel.d.ts +2 -2
  90. package/src/button/buttonlabel.js +1 -1
  91. package/src/button/buttonlabelview.d.ts +3 -3
  92. package/src/button/buttonlabelview.js +2 -2
  93. package/src/button/buttonview.d.ts +6 -6
  94. package/src/button/buttonview.js +4 -4
  95. package/src/button/switchbuttonview.d.ts +3 -3
  96. package/src/button/switchbuttonview.js +3 -3
  97. package/src/collapsible/collapsibleview.d.ts +70 -0
  98. package/src/collapsible/collapsibleview.js +95 -0
  99. package/src/colorgrid/colorgridview.d.ts +5 -5
  100. package/src/colorgrid/colorgridview.js +4 -4
  101. package/src/colorgrid/colortileview.d.ts +2 -2
  102. package/src/colorgrid/colortileview.js +2 -2
  103. package/src/colorgrid/utils.d.ts +1 -1
  104. package/src/colorgrid/utils.js +1 -1
  105. package/src/colorpicker/colorpickerview.d.ts +4 -4
  106. package/src/colorpicker/colorpickerview.js +5 -5
  107. package/src/colorpicker/utils.d.ts +1 -1
  108. package/src/colorpicker/utils.js +1 -1
  109. package/src/colorselector/colorgridsfragmentview.d.ts +9 -8
  110. package/src/colorselector/colorgridsfragmentview.js +10 -10
  111. package/src/colorselector/colorpickerfragmentview.d.ts +9 -8
  112. package/src/colorselector/colorpickerfragmentview.js +7 -8
  113. package/src/colorselector/colorselectorview.d.ts +9 -9
  114. package/src/colorselector/colorselectorview.js +6 -6
  115. package/src/colorselector/documentcolorcollection.d.ts +2 -2
  116. package/src/colorselector/documentcolorcollection.js +1 -1
  117. package/src/componentfactory.d.ts +2 -2
  118. package/src/componentfactory.js +1 -1
  119. package/src/dialog/dialog.d.ts +273 -0
  120. package/src/dialog/dialog.js +261 -0
  121. package/src/dialog/dialogactionsview.d.ts +69 -0
  122. package/src/dialog/dialogactionsview.js +98 -0
  123. package/src/dialog/dialogcontentview.d.ts +27 -0
  124. package/src/dialog/dialogcontentview.js +35 -0
  125. package/src/dialog/dialogview.d.ts +256 -0
  126. package/src/dialog/dialogview.js +466 -0
  127. package/src/dropdown/button/dropdownbutton.d.ts +3 -3
  128. package/src/dropdown/button/dropdownbutton.js +1 -1
  129. package/src/dropdown/button/dropdownbuttonview.d.ts +4 -4
  130. package/src/dropdown/button/dropdownbuttonview.js +3 -3
  131. package/src/dropdown/button/splitbuttonview.d.ts +8 -7
  132. package/src/dropdown/button/splitbuttonview.js +10 -8
  133. package/src/dropdown/dropdownpanelfocusable.d.ts +1 -1
  134. package/src/dropdown/dropdownpanelfocusable.js +1 -1
  135. package/src/dropdown/dropdownpanelview.d.ts +4 -4
  136. package/src/dropdown/dropdownpanelview.js +2 -2
  137. package/src/dropdown/dropdownview.d.ts +8 -8
  138. package/src/dropdown/dropdownview.js +5 -4
  139. package/src/dropdown/utils.d.ts +11 -11
  140. package/src/dropdown/utils.js +18 -18
  141. package/src/editableui/editableuiview.d.ts +3 -3
  142. package/src/editableui/editableuiview.js +2 -2
  143. package/src/editableui/inline/inlineeditableuiview.d.ts +4 -4
  144. package/src/editableui/inline/inlineeditableuiview.js +2 -2
  145. package/src/editorui/bodycollection.d.ts +3 -3
  146. package/src/editorui/bodycollection.js +3 -3
  147. package/src/editorui/boxed/boxededitoruiview.d.ts +3 -3
  148. package/src/editorui/boxed/boxededitoruiview.js +3 -3
  149. package/src/editorui/editorui.d.ts +7 -7
  150. package/src/editorui/editorui.js +5 -5
  151. package/src/editorui/editoruiview.d.ts +4 -4
  152. package/src/editorui/editoruiview.js +3 -3
  153. package/src/editorui/poweredby.d.ts +1 -1
  154. package/src/editorui/poweredby.js +4 -4
  155. package/src/focuscycler.d.ts +27 -8
  156. package/src/focuscycler.js +44 -15
  157. package/src/formheader/formheaderview.d.ts +4 -4
  158. package/src/formheader/formheaderview.js +3 -3
  159. package/src/highlightedtext/highlightedtextview.d.ts +2 -2
  160. package/src/highlightedtext/highlightedtextview.js +2 -2
  161. package/src/icon/iconview.d.ts +2 -2
  162. package/src/icon/iconview.js +4 -3
  163. package/src/iframe/iframeview.d.ts +2 -2
  164. package/src/iframe/iframeview.js +2 -2
  165. package/src/index.d.ts +67 -67
  166. package/src/index.js +63 -64
  167. package/src/input/inputbase.d.ts +2 -2
  168. package/src/input/inputbase.js +2 -2
  169. package/src/input/inputview.d.ts +2 -2
  170. package/src/input/inputview.js +2 -2
  171. package/src/inputnumber/inputnumberview.d.ts +2 -2
  172. package/src/inputnumber/inputnumberview.js +2 -2
  173. package/src/inputtext/inputtextview.d.ts +2 -2
  174. package/src/inputtext/inputtextview.js +2 -2
  175. package/src/label/labelview.d.ts +2 -2
  176. package/src/label/labelview.js +2 -2
  177. package/src/labeledfield/labeledfieldview.d.ts +5 -5
  178. package/src/labeledfield/labeledfieldview.js +3 -3
  179. package/src/labeledfield/utils.d.ts +14 -14
  180. package/src/labeledfield/utils.js +13 -13
  181. package/src/labeledinput/labeledinputview.d.ts +4 -4
  182. package/src/labeledinput/labeledinputview.js +3 -3
  183. package/src/list/listitemgroupview.d.ts +6 -6
  184. package/src/list/listitemgroupview.js +11 -7
  185. package/src/list/listitemview.d.ts +4 -4
  186. package/src/list/listitemview.js +2 -2
  187. package/src/list/listseparatorview.d.ts +2 -2
  188. package/src/list/listseparatorview.js +2 -2
  189. package/src/list/listview.d.ts +10 -8
  190. package/src/list/listview.js +7 -6
  191. package/src/model.d.ts +1 -1
  192. package/src/model.js +1 -1
  193. package/src/notification/notification.d.ts +1 -1
  194. package/src/notification/notification.js +1 -1
  195. package/src/panel/balloon/balloonpanelview.d.ts +4 -4
  196. package/src/panel/balloon/balloonpanelview.js +5 -4
  197. package/src/panel/balloon/contextualballoon.d.ts +5 -5
  198. package/src/panel/balloon/contextualballoon.js +7 -9
  199. package/src/panel/sticky/stickypanelview.d.ts +9 -9
  200. package/src/panel/sticky/stickypanelview.js +7 -7
  201. package/src/search/filteredview.d.ts +2 -2
  202. package/src/search/filteredview.js +1 -1
  203. package/src/search/searchinfoview.d.ts +3 -3
  204. package/src/search/searchinfoview.js +2 -2
  205. package/src/search/searchresultsview.d.ts +5 -5
  206. package/src/search/searchresultsview.js +3 -3
  207. package/src/search/text/searchtextqueryview.d.ts +5 -5
  208. package/src/search/text/searchtextqueryview.js +5 -5
  209. package/src/search/text/searchtextview.d.ts +12 -12
  210. package/src/search/text/searchtextview.js +6 -6
  211. package/src/spinner/spinnerview.d.ts +2 -2
  212. package/src/spinner/spinnerview.js +2 -2
  213. package/src/template.d.ts +3 -3
  214. package/src/template.js +3 -3
  215. package/src/textarea/textareaview.d.ts +18 -2
  216. package/src/textarea/textareaview.js +46 -6
  217. package/src/toolbar/balloon/balloontoolbar.d.ts +3 -3
  218. package/src/toolbar/balloon/balloontoolbar.js +5 -5
  219. package/src/toolbar/block/blockbuttonview.d.ts +2 -2
  220. package/src/toolbar/block/blockbuttonview.js +2 -2
  221. package/src/toolbar/block/blocktoolbar.d.ts +4 -4
  222. package/src/toolbar/block/blocktoolbar.js +6 -6
  223. package/src/toolbar/normalizetoolbarconfig.d.ts +1 -1
  224. package/src/toolbar/normalizetoolbarconfig.js +1 -1
  225. package/src/toolbar/toolbarlinebreakview.d.ts +2 -2
  226. package/src/toolbar/toolbarlinebreakview.js +2 -2
  227. package/src/toolbar/toolbarseparatorview.d.ts +2 -2
  228. package/src/toolbar/toolbarseparatorview.js +2 -2
  229. package/src/toolbar/toolbarview.d.ts +7 -6
  230. package/src/toolbar/toolbarview.js +17 -15
  231. package/src/tooltipmanager.d.ts +3 -3
  232. package/src/tooltipmanager.js +5 -4
  233. package/src/view.d.ts +3 -3
  234. package/src/view.js +3 -3
  235. package/src/viewcollection.d.ts +2 -2
  236. package/src/viewcollection.js +1 -1
  237. package/theme/components/arialiveannouncer/arialiveannouncer.css +1 -1
  238. package/theme/components/autocomplete/autocomplete.css +2 -2
  239. package/theme/components/button/button.css +1 -1
  240. package/theme/components/button/switchbutton.css +1 -1
  241. package/theme/components/collapsible/collapsible.css +10 -0
  242. package/theme/components/colorgrid/colorgrid.css +1 -1
  243. package/theme/components/colorpicker/colorpicker.css +1 -1
  244. package/theme/components/colorselector/colorselector.css +1 -1
  245. package/theme/components/dialog/dialog.css +39 -0
  246. package/theme/components/dialog/dialogactions.css +11 -0
  247. package/theme/components/dropdown/dropdown.css +3 -3
  248. package/theme/components/dropdown/listdropdown.css +1 -1
  249. package/theme/components/dropdown/splitbutton.css +1 -1
  250. package/theme/components/dropdown/toolbardropdown.css +1 -1
  251. package/theme/components/editorui/editorui.css +1 -1
  252. package/theme/components/formheader/formheader.css +1 -1
  253. package/theme/components/highlightedtext/highlightedtext.css +1 -1
  254. package/theme/components/icon/icon.css +1 -1
  255. package/theme/components/input/input.css +1 -1
  256. package/theme/components/label/label.css +1 -1
  257. package/theme/components/labeledfield/labeledfieldview.css +1 -1
  258. package/theme/components/labeledinput/labeledinput.css +1 -1
  259. package/theme/components/list/list.css +1 -1
  260. package/theme/components/panel/balloonpanel.css +2 -2
  261. package/theme/components/panel/balloonrotator.css +1 -1
  262. package/theme/components/panel/fakepanel.css +2 -2
  263. package/theme/components/panel/stickypanel.css +2 -2
  264. package/theme/components/responsive-form/responsiveform.css +1 -1
  265. package/theme/components/search/search.css +1 -1
  266. package/theme/components/spinner/spinner.css +1 -1
  267. package/theme/components/textarea/textarea.css +1 -1
  268. package/theme/components/toolbar/blocktoolbar.css +1 -1
  269. package/theme/components/toolbar/toolbar.css +1 -1
  270. package/theme/components/tooltip/tooltip.css +2 -2
  271. package/theme/globals/_hidden.css +1 -1
  272. package/theme/globals/_poweredby.css +2 -2
  273. package/theme/globals/_reset.css +1 -1
  274. package/theme/globals/_transition.css +1 -1
  275. package/theme/globals/_zindex.css +3 -2
  276. package/theme/globals/globals.css +1 -1
  277. package/theme/mixins/_dir.css +1 -1
  278. package/theme/mixins/_rwd.css +1 -1
  279. package/theme/mixins/_unselectable.css +1 -1
  280. package/theme/icons/color-palette.svg +0 -1
  281. package/theme/icons/next-arrow.svg +0 -1
  282. package/theme/icons/previous-arrow.svg +0 -1
@@ -1,16 +1,16 @@
1
1
  /**
2
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
4
4
  */
5
5
  /**
6
6
  * @module ui/colorpicker/colorpickerview
7
7
  */
8
- import { convertColor, convertToHex } from './utils';
8
+ import { convertColor, convertToHex } from './utils.js';
9
9
  import { global, env } from '@ckeditor/ckeditor5-utils';
10
10
  import { debounce } from 'lodash-es';
11
- import View from '../view';
12
- import LabeledFieldView from '../labeledfield/labeledfieldview';
13
- import { createLabeledInputText } from '../labeledfield/utils';
11
+ import View from '../view.js';
12
+ import LabeledFieldView from '../labeledfield/labeledfieldview.js';
13
+ import { createLabeledInputText } from '../labeledfield/utils.js';
14
14
  import 'vanilla-colorful/hex-color-picker.js';
15
15
  import '../../theme/components/colorpicker/colorpicker.css';
16
16
  const waitingTime = 150;
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
4
4
  */
5
5
  /**
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
4
4
  */
5
5
  /**
@@ -1,17 +1,18 @@
1
1
  /**
2
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
4
4
  */
5
5
  /**
6
6
  * @module ui/colorselector/colorgridsfragmentview
7
7
  */
8
- import View from '../view';
9
- import ButtonView from '../button/buttonview';
10
- import ColorGridView, { type ColorDefinition } from '../colorgrid/colorgridview';
11
- import DocumentColorCollection from './documentcolorcollection';
8
+ import View from '../view.js';
9
+ import ButtonView from '../button/buttonview.js';
10
+ import ColorGridView, { type ColorDefinition } from '../colorgrid/colorgridview.js';
11
+ import DocumentColorCollection from './documentcolorcollection.js';
12
12
  import type { Model } from '@ckeditor/ckeditor5-engine';
13
13
  import type { FocusTracker, Locale } from '@ckeditor/ckeditor5-utils';
14
- import type ViewCollection from '../viewcollection';
14
+ import type ViewCollection from '../viewcollection.js';
15
+ import type { FocusableView } from '../focuscycler.js';
15
16
  /**
16
17
  * One of the fragments of {@link module:ui/colorselector/colorselectorview~ColorSelectorView}.
17
18
  *
@@ -94,7 +95,7 @@ export default class ColorGridsFragmentView extends View {
94
95
  *
95
96
  * @readonly
96
97
  */
97
- protected _focusables: ViewCollection;
98
+ protected _focusables: ViewCollection<FocusableView>;
98
99
  /**
99
100
  * Document color section's label.
100
101
  *
@@ -130,7 +131,7 @@ export default class ColorGridsFragmentView extends View {
130
131
  documentColorsLabel?: string;
131
132
  documentColorsCount?: number;
132
133
  focusTracker: FocusTracker;
133
- focusables: ViewCollection;
134
+ focusables: ViewCollection<FocusableView>;
134
135
  });
135
136
  /**
136
137
  * Scans through the editor model and searches for text node attributes with the given attribute name.
@@ -1,19 +1,19 @@
1
1
  /**
2
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
4
4
  */
5
5
  /**
6
6
  * @module ui/colorselector/colorgridsfragmentview
7
7
  */
8
- import View from '../view';
9
- import ButtonView from '../button/buttonview';
10
- import ColorGridView from '../colorgrid/colorgridview';
11
- import ColorTileView from '../colorgrid/colortileview';
12
- import LabelView from '../label/labelview';
13
- import Template from '../template';
14
- import DocumentColorCollection from './documentcolorcollection';
15
- import removeButtonIcon from '@ckeditor/ckeditor5-core/theme/icons/eraser.svg';
16
- import colorPaletteIcon from '../../theme/icons/color-palette.svg';
8
+ import View from '../view.js';
9
+ import ButtonView from '../button/buttonview.js';
10
+ import ColorGridView from '../colorgrid/colorgridview.js';
11
+ import ColorTileView from '../colorgrid/colortileview.js';
12
+ import LabelView from '../label/labelview.js';
13
+ import Template from '../template.js';
14
+ import DocumentColorCollection from './documentcolorcollection.js';
15
+ import { icons } from '@ckeditor/ckeditor5-core';
16
+ const { eraser: removeButtonIcon, colorPalette: colorPaletteIcon } = icons;
17
17
  /**
18
18
  * One of the fragments of {@link module:ui/colorselector/colorselectorview~ColorSelectorView}.
19
19
  *
@@ -1,16 +1,17 @@
1
1
  /**
2
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
4
4
  */
5
5
  /**
6
6
  * @module ui/colorselector/colorpickerfragmentview
7
7
  */
8
- import View from '../view';
9
- import ButtonView from '../button/buttonview';
10
- import type ViewCollection from '../viewcollection';
11
- import { default as ColorPickerView } from '../colorpicker/colorpickerview';
8
+ import View from '../view.js';
9
+ import ButtonView from '../button/buttonview.js';
10
+ import type ViewCollection from '../viewcollection.js';
11
+ import type { FocusableView } from '../focuscycler.js';
12
+ import { default as ColorPickerView } from '../colorpicker/colorpickerview.js';
12
13
  import type { FocusTracker, KeystrokeHandler, Locale } from '@ckeditor/ckeditor5-utils';
13
- import type { ColorPickerViewConfig } from '../colorpicker/utils';
14
+ import type { ColorPickerViewConfig } from '../colorpicker/utils.js';
14
15
  /**
15
16
  * One of the fragments of {@link module:ui/colorselector/colorselectorview~ColorSelectorView}.
16
17
  *
@@ -64,7 +65,7 @@ export default class ColorPickerFragmentView extends View {
64
65
  *
65
66
  * @readonly
66
67
  */
67
- protected _focusables: ViewCollection;
68
+ protected _focusables: ViewCollection<FocusableView>;
68
69
  /**
69
70
  * A reference to the configuration of {@link #colorPickerView}. `false` when the view was
70
71
  * configured without a color picker.
@@ -84,7 +85,7 @@ export default class ColorPickerFragmentView extends View {
84
85
  */
85
86
  constructor(locale: Locale, { focusTracker, focusables, keystrokes, colorPickerViewConfig }: {
86
87
  focusTracker: FocusTracker;
87
- focusables: ViewCollection;
88
+ focusables: ViewCollection<FocusableView>;
88
89
  keystrokes: KeystrokeHandler;
89
90
  colorPickerViewConfig: ColorPickerViewConfig | false;
90
91
  });
@@ -1,15 +1,14 @@
1
1
  /**
2
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
4
4
  */
5
5
  /**
6
6
  * @module ui/colorselector/colorpickerfragmentview
7
7
  */
8
- import View from '../view';
9
- import ButtonView from '../button/buttonview';
10
- import { default as ColorPickerView } from '../colorpicker/colorpickerview';
11
- import checkButtonIcon from '@ckeditor/ckeditor5-core/theme/icons/check.svg';
12
- import cancelButtonIcon from '@ckeditor/ckeditor5-core/theme/icons/cancel.svg';
8
+ import View from '../view.js';
9
+ import ButtonView from '../button/buttonview.js';
10
+ import { default as ColorPickerView } from '../colorpicker/colorpickerview.js';
11
+ import { icons } from '@ckeditor/ckeditor5-core';
13
12
  /**
14
13
  * One of the fragments of {@link module:ui/colorselector/colorselectorview~ColorSelectorView}.
15
14
  *
@@ -163,14 +162,14 @@ export default class ColorPickerFragmentView extends View {
163
162
  const saveButtonView = new ButtonView(locale);
164
163
  const cancelButtonView = new ButtonView(locale);
165
164
  saveButtonView.set({
166
- icon: checkButtonIcon,
165
+ icon: icons.check,
167
166
  class: 'ck-button-save',
168
167
  type: 'button',
169
168
  withText: false,
170
169
  label: t('Accept')
171
170
  });
172
171
  cancelButtonView.set({
173
- icon: cancelButtonIcon,
172
+ icon: icons.cancel,
174
173
  class: 'ck-button-cancel',
175
174
  type: 'button',
176
175
  withText: false,
@@ -1,19 +1,19 @@
1
1
  /**
2
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
4
4
  */
5
5
  /**
6
6
  * @module ui/colorselector/colorselectorview
7
7
  */
8
- import FocusCycler from '../focuscycler';
9
- import View from '../view';
10
- import ViewCollection from '../viewcollection';
8
+ import FocusCycler, { type FocusableView } from '../focuscycler.js';
9
+ import View from '../view.js';
10
+ import ViewCollection from '../viewcollection.js';
11
11
  import { FocusTracker, KeystrokeHandler, type Locale } from '@ckeditor/ckeditor5-utils';
12
- import type { ColorPickerViewConfig } from '../colorpicker/utils';
13
- import type { ColorDefinition } from '../colorgrid/colorgridview';
12
+ import type { ColorPickerViewConfig } from '../colorpicker/utils.js';
13
+ import type { ColorDefinition } from '../colorgrid/colorgridview.js';
14
14
  import type { Model } from '@ckeditor/ckeditor5-engine';
15
- import ColorGridsFragmentView from './colorgridsfragmentview';
16
- import ColorPickerFragmentView from './colorpickerfragmentview';
15
+ import ColorGridsFragmentView from './colorgridsfragmentview.js';
16
+ import ColorPickerFragmentView from './colorpickerfragmentview.js';
17
17
  import '../../theme/components/colorselector/colorselector.css';
18
18
  /**
19
19
  * The configurable color selector view class. It allows users to select colors from a predefined set of colors as well as from
@@ -111,7 +111,7 @@ export default class ColorSelectorView extends View {
111
111
  *
112
112
  * @readonly
113
113
  */
114
- protected _focusables: ViewCollection;
114
+ protected _focusables: ViewCollection<FocusableView>;
115
115
  /**
116
116
  * The configuration of color picker sub-component.
117
117
  */
@@ -1,16 +1,16 @@
1
1
  /**
2
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
4
4
  */
5
5
  /**
6
6
  * @module ui/colorselector/colorselectorview
7
7
  */
8
- import FocusCycler from '../focuscycler';
9
- import View from '../view';
10
- import ViewCollection from '../viewcollection';
8
+ import FocusCycler from '../focuscycler.js';
9
+ import View from '../view.js';
10
+ import ViewCollection from '../viewcollection.js';
11
11
  import { FocusTracker, KeystrokeHandler } from '@ckeditor/ckeditor5-utils';
12
- import ColorGridsFragmentView from './colorgridsfragmentview';
13
- import ColorPickerFragmentView from './colorpickerfragmentview';
12
+ import ColorGridsFragmentView from './colorgridsfragmentview.js';
13
+ import ColorPickerFragmentView from './colorpickerfragmentview.js';
14
14
  import '../../theme/components/colorselector/colorselector.css';
15
15
  /**
16
16
  * The configurable color selector view class. It allows users to select colors from a predefined set of colors as well as from
@@ -1,11 +1,11 @@
1
1
  /**
2
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
4
4
  */
5
5
  /**
6
6
  * @module ui/colorselector/documentcolorcollection
7
7
  */
8
- import type { ColorDefinition } from '../colorgrid/colorgridview';
8
+ import type { ColorDefinition } from '../colorgrid/colorgridview.js';
9
9
  import { Collection, type CollectionAddEvent, type CollectionRemoveEvent, type CollectionChangeEvent } from '@ckeditor/ckeditor5-utils';
10
10
  declare const DocumentColorCollection_base: import("@ckeditor/ckeditor5-utils").Mixed<{
11
11
  new (options?: {
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
4
4
  */
5
5
  import { Collection, ObservableMixin } from '@ckeditor/ckeditor5-utils';
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
4
4
  */
5
5
  /**
@@ -7,7 +7,7 @@
7
7
  */
8
8
  import { type Locale } from '@ckeditor/ckeditor5-utils';
9
9
  import type { Editor } from '@ckeditor/ckeditor5-core';
10
- import type View from './view';
10
+ import type View from './view.js';
11
11
  /**
12
12
  * A helper class implementing the UI component ({@link module:ui/view~View view}) factory.
13
13
  *
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
2
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
3
3
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
4
4
  */
5
5
  /**
@@ -0,0 +1,273 @@
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 ui/dialog/dialog
7
+ */
8
+ import type View from '../view.js';
9
+ import { type Editor, Plugin } from '@ckeditor/ckeditor5-core';
10
+ import DialogView, { DialogViewPosition } from './dialogview.js';
11
+ import type { DialogActionButtonDefinition } from './dialogactionsview.js';
12
+ /**
13
+ * The dialog controller class. It is used to show and hide the {@link module:ui/dialog/dialogview~DialogView}.
14
+ */
15
+ export default class Dialog extends Plugin {
16
+ /**
17
+ * The name of the currently visible dialog view instance.
18
+ *
19
+ * @observable
20
+ */
21
+ id: string | null;
22
+ /**
23
+ * The currently visible dialog view instance.
24
+ */
25
+ view?: DialogView;
26
+ /**
27
+ * The `Dialog` plugin instance which most recently showed the dialog.
28
+ *
29
+ * Only one dialog can be visible at once, even if there are many editor instances on the page.
30
+ * If an editor wants to show a dialog, it should first hide the dialog that is already opened.
31
+ * But only the `Dialog` instance that showed the dialog is able able to properly hide it.
32
+ * This is why we need to store it in a globally available space (static property).
33
+ * This way every `Dialog` plugin in every editor is able to correctly close any open dialog window.
34
+ */
35
+ private static _visibleDialogPlugin;
36
+ /**
37
+ * A flag indicating whether the dialog is currently visible.
38
+ *
39
+ * @observable
40
+ */
41
+ isOpen: boolean;
42
+ /**
43
+ * A configurable callback called when the dialog is hidden.
44
+ */
45
+ private _onHide;
46
+ /**
47
+ * @inheritDoc
48
+ */
49
+ static get pluginName(): "Dialog";
50
+ /**
51
+ * @inheritDoc
52
+ */
53
+ constructor(editor: Editor);
54
+ /**
55
+ * Initiates listeners for the `show` and `hide` events emitted by this plugin.
56
+ *
57
+ * We couldn't simply decorate the {@link #show} and {@link #hide} methods to fire events,
58
+ * because they would be fired in the wrong order - first would be `show` and then `hide`
59
+ * (because showing the dialog actually starts with hiding the previously visible one).
60
+ * Hence, we added private methods {@link #_show} and {@link #_hide} which are called on events
61
+ * in the desired sequence.
62
+ */
63
+ private _initShowHideListeners;
64
+ /**
65
+ * Initiates keystroke handler for toggling the focus between the editor and dialog view.
66
+ */
67
+ private _initFocusToggler;
68
+ /**
69
+ * Provides an integration between the root attaching and detaching and positioning of the view.
70
+ */
71
+ private _initMultiRootIntegration;
72
+ /**
73
+ * Displays a dialog window.
74
+ *
75
+ * This method requires a {@link ~DialogDefinition} that defines dialog's content, title, icon, action buttons, etc.
76
+ *
77
+ * For example, the following definition will create a dialog with:
78
+ * * a header consisting of an icon, a title and a "Close" button (it's added by default),
79
+ * * a content consisting of a view with a single paragraph,
80
+ * * a footer consisting of two buttons: "Yes" and "No".
81
+ *
82
+ * ```js
83
+ * // Create the view that will be used as the dialog's content.
84
+ * const textView = new View( locale );
85
+ *
86
+ * textView.setTemplate( {
87
+ * tag: 'div',
88
+ * attributes: {
89
+ * style: {
90
+ * padding: 'var(--ck-spacing-large)',
91
+ * whiteSpace: 'initial',
92
+ * width: '100%',
93
+ * maxWidth: '500px'
94
+ * },
95
+ * tabindex: -1
96
+ * },
97
+ * children: [
98
+ * 'Lorem ipsum dolor sit amet...'
99
+ * ]
100
+ * } );
101
+ *
102
+ * // Show the dialog.
103
+ * editor.plugins.get( 'Dialog' ).show( {
104
+ * id: 'myDialog',
105
+ * icon: 'myIcon', // this should be an SVG string
106
+ * title: 'My dialog',
107
+ * content: textView,
108
+ * actionButtons: [
109
+ * {
110
+ * label: t( 'Yes' ),
111
+ * class: 'ck-button-action',
112
+ * withText: true,
113
+ * onExecute: () => dialog.hide()
114
+ * },
115
+ * {
116
+ * label: t( 'No' ),
117
+ * withText: true,
118
+ * onExecute: () => dialog.hide()
119
+ * }
120
+ * ]
121
+ * } );
122
+ * ```
123
+ *
124
+ * By specifying the {@link ~DialogDefinition#onShow} and {@link ~DialogDefinition#onHide} callbacks
125
+ * it's also possible to add callbacks that will be called when the dialog is shown or hidden.
126
+ *
127
+ * For example, the callbacks in the following definition:
128
+ * * disable the default behavior of the `Esc` key,
129
+ * * fire a custom event when the dialog gets hidden.
130
+ *
131
+ * ```js
132
+ * editor.plugins.get( 'Dialog' ).show( {
133
+ * // ...
134
+ * onShow: dialog => {
135
+ * dialog.view.on( 'close', ( evt, data ) => {
136
+ * // Only prevent the event from `Esc` key - don't affect the other ways of closing the dialog.
137
+ * if ( data.source === 'escKeyPress' ) {
138
+ * evt.stop();
139
+ * }
140
+ * } );
141
+ * },
142
+ * onHide: dialog => {
143
+ * dialog.fire( 'dialogDestroyed' );
144
+ * }
145
+ * } );
146
+ * ```
147
+ *
148
+ * Internally, calling this method:
149
+ * 1. Hides the currently visible dialog (if any) calling the {@link #hide} method
150
+ * (fires the {@link ~DialogHideEvent hide event}).
151
+ * 2. Fires the {@link ~DialogShowEvent show event} which allows for adding callbacks that customize the
152
+ * behavior of the dialog.
153
+ * 3. Shows the dialog.
154
+ */
155
+ show(dialogDefinition: DialogDefinition): void;
156
+ /**
157
+ * Handles creating the {@link module:ui/dialog/dialogview~DialogView} instance and making it visible.
158
+ */
159
+ private _show;
160
+ /**
161
+ * Hides the dialog. This method is decorated to enable interacting on the {@link ~DialogHideEvent hide event}.
162
+ *
163
+ * See {@link #show}.
164
+ */
165
+ hide(): void;
166
+ /**
167
+ * Destroys the {@link module:ui/dialog/dialogview~DialogView} and cleans up the stored dialog state.
168
+ */
169
+ private _hide;
170
+ }
171
+ /**
172
+ * The definition that describes a dialog window and its content. Passed to the {@link module:ui/dialog/dialog~Dialog#show} method.
173
+ */
174
+ export interface DialogDefinition {
175
+ /**
176
+ * A unique identifier of the dialog. Allows for distinguishing between different dialogs and their visibility.
177
+ * For instance, when open, the id of currently visible dialog is stored in {@link module:ui/dialog/dialog~Dialog#id}.
178
+ *
179
+ * The `id` is also passed along the {@link module:ui/dialog/dialog~DialogShowEvent} and {@link module:ui/dialog/dialog~DialogHideEvent}
180
+ * events.
181
+ */
182
+ id: string;
183
+ /**
184
+ * The SVG string of an icon displayed in dialogs's header. Used only when {@link #title} is also set
185
+ * and the header is displayed.
186
+ *
187
+ * See more in {@link module:ui/icon/iconview~IconView#content}.
188
+ */
189
+ icon?: string;
190
+ /**
191
+ * A title displayed in dialogs's header. Also works as an accessible name of the dialog used by assistive technologies.
192
+ *
193
+ * When not set, the header is not displayed. Affects {@link #icon} and {@link #hasCloseButton}.
194
+ */
195
+ title?: string;
196
+ /**
197
+ * A flag indicating whether the dialog should have a close button in the header.
198
+ * `true` by default. Works when {@link #title} is also set and the header is displayed.
199
+ *
200
+ * **Note**: If you hide the close button, make sure that the dialog can be closed in another way.
201
+ */
202
+ hasCloseButton?: boolean;
203
+ /**
204
+ * The content of the dialog. It can be a single {@link module:ui/view~View} or an array of views.
205
+ */
206
+ content?: View | Array<View>;
207
+ /**
208
+ * The action buttons displayed in the dialog's footer.
209
+ */
210
+ actionButtons?: Array<DialogActionButtonDefinition>;
211
+ /**
212
+ * An additional CSS class set on the outermost (`.ck.ck-dialog`) container element allowing for visual customization.
213
+ */
214
+ className?: string;
215
+ /**
216
+ * When set `true`, the dialog will become a modal, i.e. it will block the UI until it is closed.
217
+ */
218
+ isModal?: boolean;
219
+ /**
220
+ * Available dialog positions. By default `DialogViewPosition.EDITOR_CENTER` is used for {@link #isModal non-modals}
221
+ * and `DialogViewPosition.SCREEN_CENTER` for modals.
222
+ *
223
+ * {@link module:ui/dialog/dialogview#DialogViewPosition Learn more} about available positions.
224
+ */
225
+ position?: typeof DialogViewPosition[keyof typeof DialogViewPosition];
226
+ /**
227
+ * A callback called when the dialog shows up with `low` priority. It allows for setting up the dialog's {@link #content}.
228
+ */
229
+ onShow?: (dialog: Dialog) => void;
230
+ /**
231
+ * A callback called when the dialog hides with `low` priority.
232
+ * It allows for cleaning up (e.g. resetting) the dialog's {@link #content}.
233
+ */
234
+ onHide?: (dialog: Dialog) => void;
235
+ }
236
+ /**
237
+ * An event fired after {@link module:ui/dialog/dialog~Dialog#show} is called. You can use it to customize behavior
238
+ * any dialog.
239
+ *
240
+ * ```js
241
+ * import { DialogViewPosition } from 'ckeditor5/src/ui.js';
242
+ *
243
+ * // ...
244
+ *
245
+ * // Changes the position of the "Find and Replace" dialog.
246
+ * editor.plugins.get( 'Dialog' ).on( 'show:findAndReplace', ( evt, data ) => {
247
+ * Object.assign( data, { position: DialogViewPosition.EDITOR_BOTTOM_CENTER } );
248
+ * }, { priority: 'high' } );
249
+ * ```
250
+ *
251
+ * @eventName ~Dialog#show
252
+ */
253
+ export type DialogShowEvent = {
254
+ name: 'show' | `show:${string}`;
255
+ args: [dialogDefinition: DialogDefinition];
256
+ };
257
+ /**
258
+ * An event fired after {@link module:ui/dialog/dialog~Dialog#hide} is called. You can use it to customize behavior
259
+ * any dialog.
260
+ *
261
+ * ```js
262
+ * // Logs after the "Find and Replace" dialog gets hidden
263
+ * editor.plugins.get( 'Dialog' ).on( 'hide:findAndReplace', () => {
264
+ * console.log( 'The "Find and Replace" dialog was hidden.' );
265
+ * } );
266
+ * ```
267
+ *
268
+ * @eventName ~Dialog#hide
269
+ */
270
+ export type DialogHideEvent = {
271
+ name: 'hide' | `hide:${string}`;
272
+ args: [];
273
+ };