@ckeditor/ckeditor5-engine 45.2.1 → 46.0.0-alpha.1

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 (241) hide show
  1. package/dist/index.js +2563 -2257
  2. package/dist/index.js.map +1 -1
  3. package/package.json +3 -3
  4. package/src/controller/datacontroller.d.ts +33 -32
  5. package/src/controller/datacontroller.js +29 -28
  6. package/src/controller/editingcontroller.d.ts +8 -8
  7. package/src/controller/editingcontroller.js +10 -10
  8. package/src/conversion/conversion.d.ts +18 -19
  9. package/src/conversion/conversion.js +4 -4
  10. package/src/conversion/conversionhelpers.d.ts +1 -1
  11. package/src/conversion/conversionhelpers.js +1 -1
  12. package/src/conversion/downcastdispatcher.d.ts +63 -69
  13. package/src/conversion/downcastdispatcher.js +16 -16
  14. package/src/conversion/downcasthelpers.d.ts +94 -83
  15. package/src/conversion/downcasthelpers.js +63 -53
  16. package/src/conversion/mapper.d.ts +27 -27
  17. package/src/conversion/mapper.js +15 -15
  18. package/src/conversion/modelconsumable.d.ts +26 -26
  19. package/src/conversion/modelconsumable.js +23 -23
  20. package/src/conversion/upcastdispatcher.d.ts +33 -32
  21. package/src/conversion/upcastdispatcher.js +19 -19
  22. package/src/conversion/upcasthelpers.d.ts +46 -38
  23. package/src/conversion/upcasthelpers.js +33 -24
  24. package/src/conversion/viewconsumable.d.ts +50 -45
  25. package/src/conversion/viewconsumable.js +32 -27
  26. package/src/dataprocessor/basichtmlwriter.d.ts +4 -2
  27. package/src/dataprocessor/basichtmlwriter.js +3 -1
  28. package/src/dataprocessor/dataprocessor.d.ts +7 -6
  29. package/src/dataprocessor/htmldataprocessor.d.ts +10 -10
  30. package/src/dataprocessor/htmldataprocessor.js +6 -6
  31. package/src/dataprocessor/htmlwriter.d.ts +1 -1
  32. package/src/dataprocessor/xmldataprocessor.d.ts +10 -10
  33. package/src/dataprocessor/xmldataprocessor.js +6 -6
  34. package/src/dev-utils/model.d.ts +25 -26
  35. package/src/dev-utils/model.js +35 -36
  36. package/src/dev-utils/operationreplayer.d.ts +5 -3
  37. package/src/dev-utils/operationreplayer.js +4 -2
  38. package/src/dev-utils/utils.d.ts +8 -0
  39. package/src/dev-utils/utils.js +8 -0
  40. package/src/dev-utils/view.d.ts +66 -63
  41. package/src/dev-utils/view.js +144 -134
  42. package/src/index.d.ts +135 -106
  43. package/src/index.js +120 -71
  44. package/src/legacyerrors.d.ts +5 -0
  45. package/src/legacyerrors.js +17 -0
  46. package/src/model/batch.d.ts +2 -15
  47. package/src/model/batch.js +1 -23
  48. package/src/model/differ.d.ts +54 -31
  49. package/src/model/differ.js +15 -15
  50. package/src/model/document.d.ts +31 -31
  51. package/src/model/document.js +13 -13
  52. package/src/model/documentfragment.d.ts +45 -45
  53. package/src/model/documentfragment.js +40 -40
  54. package/src/model/documentselection.d.ts +92 -92
  55. package/src/model/documentselection.js +71 -70
  56. package/src/model/element.d.ts +31 -31
  57. package/src/model/element.js +29 -29
  58. package/src/model/history.d.ts +3 -3
  59. package/src/model/history.js +2 -2
  60. package/src/model/item.d.ts +4 -5
  61. package/src/model/liveposition.d.ts +31 -31
  62. package/src/model/liveposition.js +18 -18
  63. package/src/model/liverange.d.ts +42 -38
  64. package/src/model/liverange.js +17 -16
  65. package/src/model/markercollection.d.ts +41 -40
  66. package/src/model/markercollection.js +22 -20
  67. package/src/model/model.d.ts +82 -81
  68. package/src/model/model.js +54 -54
  69. package/src/model/node.d.ts +48 -48
  70. package/src/model/node.js +31 -31
  71. package/src/model/nodelist.d.ts +17 -17
  72. package/src/model/nodelist.js +11 -11
  73. package/src/model/operation/attributeoperation.d.ts +10 -10
  74. package/src/model/operation/attributeoperation.js +7 -7
  75. package/src/model/operation/detachoperation.d.ts +11 -9
  76. package/src/model/operation/detachoperation.js +8 -6
  77. package/src/model/operation/insertoperation.d.ts +13 -13
  78. package/src/model/operation/insertoperation.js +15 -15
  79. package/src/model/operation/markeroperation.d.ts +12 -12
  80. package/src/model/operation/markeroperation.js +5 -5
  81. package/src/model/operation/mergeoperation.d.ts +16 -16
  82. package/src/model/operation/mergeoperation.js +18 -18
  83. package/src/model/operation/moveoperation.d.ts +16 -16
  84. package/src/model/operation/moveoperation.js +18 -15
  85. package/src/model/operation/nooperation.d.ts +4 -4
  86. package/src/model/operation/nooperation.js +2 -2
  87. package/src/model/operation/operation.d.ts +10 -10
  88. package/src/model/operation/operation.js +5 -5
  89. package/src/model/operation/operationfactory.d.ts +4 -4
  90. package/src/model/operation/operationfactory.js +12 -12
  91. package/src/model/operation/renameoperation.d.ts +10 -10
  92. package/src/model/operation/renameoperation.js +7 -7
  93. package/src/model/operation/rootattributeoperation.d.ts +12 -12
  94. package/src/model/operation/rootattributeoperation.js +8 -8
  95. package/src/model/operation/rootoperation.d.ts +8 -8
  96. package/src/model/operation/rootoperation.js +3 -3
  97. package/src/model/operation/splitoperation.d.ts +17 -17
  98. package/src/model/operation/splitoperation.js +19 -19
  99. package/src/model/operation/transform.d.ts +11 -8
  100. package/src/model/operation/transform.js +66 -49
  101. package/src/model/operation/utils.d.ts +24 -23
  102. package/src/model/operation/utils.js +20 -20
  103. package/src/model/position.d.ts +101 -97
  104. package/src/model/position.js +69 -64
  105. package/src/model/range.d.ts +90 -90
  106. package/src/model/range.js +87 -87
  107. package/src/model/rootelement.d.ts +11 -11
  108. package/src/model/rootelement.js +9 -9
  109. package/src/model/schema.d.ts +158 -154
  110. package/src/model/schema.js +93 -90
  111. package/src/model/selection.d.ts +73 -73
  112. package/src/model/selection.js +62 -62
  113. package/src/model/text.d.ts +11 -10
  114. package/src/model/text.js +11 -10
  115. package/src/model/textproxy.d.ts +39 -38
  116. package/src/model/textproxy.js +31 -30
  117. package/src/model/treewalker.d.ts +37 -37
  118. package/src/model/treewalker.js +14 -14
  119. package/src/model/typecheckable.d.ts +45 -45
  120. package/src/model/typecheckable.js +1 -1
  121. package/src/model/utils/autoparagraphing.d.ts +7 -7
  122. package/src/model/utils/deletecontent.d.ts +7 -5
  123. package/src/model/utils/deletecontent.js +13 -11
  124. package/src/model/utils/getselectedcontent.d.ts +6 -5
  125. package/src/model/utils/getselectedcontent.js +2 -1
  126. package/src/model/utils/insertcontent.d.ts +9 -8
  127. package/src/model/utils/insertcontent.js +41 -40
  128. package/src/model/utils/insertobject.d.ts +9 -9
  129. package/src/model/utils/insertobject.js +4 -4
  130. package/src/model/utils/modifyselection.d.ts +5 -4
  131. package/src/model/utils/modifyselection.js +12 -11
  132. package/src/model/utils/selection-post-fixer.d.ts +12 -8
  133. package/src/model/utils/selection-post-fixer.js +15 -11
  134. package/src/model/writer.d.ts +102 -101
  135. package/src/model/writer.js +99 -98
  136. package/src/view/attributeelement.d.ts +29 -29
  137. package/src/view/attributeelement.js +25 -25
  138. package/src/view/containerelement.d.ts +16 -15
  139. package/src/view/containerelement.js +15 -14
  140. package/src/view/datatransfer.d.ts +7 -7
  141. package/src/view/datatransfer.js +1 -1
  142. package/src/view/document.d.ts +25 -25
  143. package/src/view/document.js +15 -15
  144. package/src/view/documentfragment.d.ts +21 -21
  145. package/src/view/documentfragment.js +14 -14
  146. package/src/view/documentselection.d.ts +65 -63
  147. package/src/view/documentselection.js +27 -25
  148. package/src/view/domconverter.d.ts +96 -91
  149. package/src/view/domconverter.js +78 -73
  150. package/src/view/downcastwriter.d.ts +185 -181
  151. package/src/view/downcastwriter.js +222 -210
  152. package/src/view/editableelement.d.ts +13 -13
  153. package/src/view/editableelement.js +8 -8
  154. package/src/view/element.d.ts +75 -74
  155. package/src/view/element.js +58 -58
  156. package/src/view/elementdefinition.d.ts +3 -4
  157. package/src/view/emptyelement.d.ts +13 -13
  158. package/src/view/emptyelement.js +13 -13
  159. package/src/view/filler.d.ts +14 -3
  160. package/src/view/filler.js +12 -1
  161. package/src/view/item.d.ts +4 -5
  162. package/src/view/matcher.d.ts +22 -19
  163. package/src/view/matcher.js +6 -6
  164. package/src/view/node.d.ts +33 -33
  165. package/src/view/node.js +9 -9
  166. package/src/view/observer/arrowkeysobserver.d.ts +10 -10
  167. package/src/view/observer/arrowkeysobserver.js +5 -5
  168. package/src/view/observer/bubblingemittermixin.d.ts +5 -5
  169. package/src/view/observer/bubblingemittermixin.js +2 -9
  170. package/src/view/observer/bubblingeventinfo.d.ts +9 -9
  171. package/src/view/observer/bubblingeventinfo.js +1 -1
  172. package/src/view/observer/clickobserver.d.ts +8 -8
  173. package/src/view/observer/clickobserver.js +4 -4
  174. package/src/view/observer/compositionobserver.d.ts +19 -19
  175. package/src/view/observer/compositionobserver.js +6 -6
  176. package/src/view/observer/domeventdata.d.ts +9 -9
  177. package/src/view/observer/domeventdata.js +2 -2
  178. package/src/view/observer/domeventobserver.d.ts +3 -3
  179. package/src/view/observer/domeventobserver.js +5 -5
  180. package/src/view/observer/fakeselectionobserver.d.ts +9 -9
  181. package/src/view/observer/fakeselectionobserver.js +8 -8
  182. package/src/view/observer/focusobserver.d.ts +16 -16
  183. package/src/view/observer/focusobserver.js +7 -7
  184. package/src/view/observer/inputobserver.d.ts +18 -18
  185. package/src/view/observer/inputobserver.js +5 -5
  186. package/src/view/observer/keyobserver.d.ts +11 -11
  187. package/src/view/observer/keyobserver.js +3 -3
  188. package/src/view/observer/mouseobserver.d.ts +16 -16
  189. package/src/view/observer/mouseobserver.js +3 -3
  190. package/src/view/observer/mutationobserver.d.ts +21 -21
  191. package/src/view/observer/mutationobserver.js +7 -7
  192. package/src/view/observer/observer.d.ts +12 -12
  193. package/src/view/observer/observer.js +6 -6
  194. package/src/view/observer/selectionobserver.d.ts +33 -33
  195. package/src/view/observer/selectionobserver.js +14 -14
  196. package/src/view/observer/tabobserver.d.ts +10 -10
  197. package/src/view/observer/tabobserver.js +5 -5
  198. package/src/view/observer/touchobserver.d.ts +13 -13
  199. package/src/view/observer/touchobserver.js +3 -3
  200. package/src/view/placeholder.d.ts +21 -21
  201. package/src/view/placeholder.js +23 -23
  202. package/src/view/position.d.ts +49 -49
  203. package/src/view/position.js +42 -42
  204. package/src/view/range.d.ts +76 -74
  205. package/src/view/range.js +67 -65
  206. package/src/view/rawelement.d.ts +19 -19
  207. package/src/view/rawelement.js +16 -16
  208. package/src/view/renderer.d.ts +14 -14
  209. package/src/view/renderer.js +7 -7
  210. package/src/view/rooteditableelement.d.ts +8 -7
  211. package/src/view/rooteditableelement.js +7 -6
  212. package/src/view/selection.d.ts +66 -64
  213. package/src/view/selection.js +50 -48
  214. package/src/view/styles/background.d.ts +2 -2
  215. package/src/view/styles/background.js +9 -9
  216. package/src/view/styles/border.d.ts +2 -2
  217. package/src/view/styles/border.js +13 -13
  218. package/src/view/styles/margin.d.ts +2 -2
  219. package/src/view/styles/margin.js +5 -5
  220. package/src/view/styles/padding.d.ts +2 -2
  221. package/src/view/styles/padding.js +5 -5
  222. package/src/view/styles/utils.d.ts +24 -24
  223. package/src/view/styles/utils.js +25 -25
  224. package/src/view/stylesmap.d.ts +28 -32
  225. package/src/view/stylesmap.js +52 -39
  226. package/src/view/text.d.ts +11 -11
  227. package/src/view/text.js +10 -10
  228. package/src/view/textproxy.d.ts +33 -32
  229. package/src/view/textproxy.js +23 -22
  230. package/src/view/tokenlist.d.ts +14 -14
  231. package/src/view/tokenlist.js +10 -10
  232. package/src/view/treewalker.d.ts +42 -40
  233. package/src/view/treewalker.js +36 -35
  234. package/src/view/typecheckable.d.ts +76 -75
  235. package/src/view/typecheckable.js +1 -1
  236. package/src/view/uielement.d.ts +22 -21
  237. package/src/view/uielement.js +17 -16
  238. package/src/view/upcastwriter.d.ts +70 -70
  239. package/src/view/upcastwriter.js +42 -42
  240. package/src/view/view.d.ts +70 -69
  241. package/src/view/view.js +56 -55
@@ -7,23 +7,23 @@
7
7
  *
8
8
  * @module engine/conversion/downcasthelpers
9
9
  */
10
- import ModelRange from '../model/range.js';
11
- import ModelSelection from '../model/selection.js';
12
- import ModelDocumentSelection from '../model/documentselection.js';
13
- import ModelElement from '../model/element.js';
14
- import ModelPosition from '../model/position.js';
15
- import ViewAttributeElement from '../view/attributeelement.js';
16
- import ConversionHelpers from './conversionhelpers.js';
17
- import type { default as DowncastDispatcher, DowncastConversionApi } from './downcastdispatcher.js';
18
- import type ModelConsumable from './modelconsumable.js';
19
- import type ModelNode from '../model/node.js';
20
- import type ModelItem from '../model/item.js';
21
- import type ModelTextProxy from '../model/textproxy.js';
22
- import type ModelText from '../model/text.js';
23
- import type DowncastWriter from '../view/downcastwriter.js';
24
- import type ElementDefinition from '../view/elementdefinition.js';
25
- import type UIElement from '../view/uielement.js';
26
- import type ViewElement from '../view/element.js';
10
+ import { ModelRange } from '../model/range.js';
11
+ import { ModelSelection } from '../model/selection.js';
12
+ import { ModelDocumentSelection } from '../model/documentselection.js';
13
+ import { ModelElement } from '../model/element.js';
14
+ import { ModelPosition } from '../model/position.js';
15
+ import { ViewAttributeElement } from '../view/attributeelement.js';
16
+ import { ConversionHelpers } from './conversionhelpers.js';
17
+ import type { DowncastDispatcher, DowncastConversionApi } from './downcastdispatcher.js';
18
+ import { type ModelConsumable } from './modelconsumable.js';
19
+ import { type ModelNode } from '../model/node.js';
20
+ import { type ModelItem } from '../model/item.js';
21
+ import { type ModelTextProxy } from '../model/textproxy.js';
22
+ import { type ModelText } from '../model/text.js';
23
+ import { type ViewDowncastWriter } from '../view/downcastwriter.js';
24
+ import { type ViewElementDefinition } from '../view/elementdefinition.js';
25
+ import { type ViewUIElement } from '../view/uielement.js';
26
+ import { type ViewElement } from '../view/element.js';
27
27
  import { type EventInfo, type PriorityString } from '@ckeditor/ckeditor5-utils';
28
28
  /**
29
29
  * Downcast conversion helper functions.
@@ -32,7 +32,7 @@ import { type EventInfo, type PriorityString } from '@ckeditor/ckeditor5-utils';
32
32
  *
33
33
  * @extends module:engine/conversion/conversionhelpers~ConversionHelpers
34
34
  */
35
- export default class DowncastHelpers extends ConversionHelpers<DowncastDispatcher> {
35
+ export declare class DowncastHelpers extends ConversionHelpers<DowncastDispatcher> {
36
36
  /**
37
37
  * Model element to view element conversion helper.
38
38
  *
@@ -180,7 +180,7 @@ export default class DowncastHelpers extends ConversionHelpers<DowncastDispatche
180
180
  attributes?: string | Array<string>;
181
181
  children?: boolean;
182
182
  };
183
- view: ElementDefinition | ElementCreatorFunction;
183
+ view: ViewElementDefinition | DowncastElementCreatorFunction;
184
184
  converterPriority?: PriorityString;
185
185
  }): this;
186
186
  /**
@@ -297,7 +297,7 @@ export default class DowncastHelpers extends ConversionHelpers<DowncastDispatche
297
297
  name: string;
298
298
  attributes?: string | Array<string>;
299
299
  };
300
- view: StructureCreatorFunction;
300
+ view: DowncastStructureCreatorFunction;
301
301
  converterPriority?: PriorityString;
302
302
  }): this;
303
303
  /**
@@ -391,7 +391,7 @@ export default class DowncastHelpers extends ConversionHelpers<DowncastDispatche
391
391
  key: string;
392
392
  name?: string;
393
393
  };
394
- view: ElementDefinition | AttributeElementCreatorFunction;
394
+ view: ViewElementDefinition | DowncastAttributeElementCreatorFunction;
395
395
  converterPriority?: PriorityString;
396
396
  } | {
397
397
  model: {
@@ -399,7 +399,7 @@ export default class DowncastHelpers extends ConversionHelpers<DowncastDispatche
399
399
  name?: string;
400
400
  values: Array<TValues>;
401
401
  };
402
- view: Record<TValues, ElementDefinition | AttributeElementCreatorFunction>;
402
+ view: Record<TValues, ViewElementDefinition | DowncastAttributeElementCreatorFunction>;
403
403
  converterPriority?: PriorityString;
404
404
  }): this;
405
405
  /**
@@ -488,7 +488,7 @@ export default class DowncastHelpers extends ConversionHelpers<DowncastDispatche
488
488
  key: string;
489
489
  name?: string;
490
490
  };
491
- view: string | AttributeDescriptor | AttributeCreatorFunction;
491
+ view: string | DowncastAttributeDescriptor | DowncastAttributeCreatorFunction;
492
492
  converterPriority?: PriorityString;
493
493
  } | {
494
494
  model: {
@@ -496,7 +496,7 @@ export default class DowncastHelpers extends ConversionHelpers<DowncastDispatche
496
496
  name?: string;
497
497
  values?: Array<TValues>;
498
498
  };
499
- view: Record<TValues, AttributeDescriptor | AttributeCreatorFunction>;
499
+ view: Record<TValues, DowncastAttributeDescriptor | DowncastAttributeCreatorFunction>;
500
500
  converterPriority?: PriorityString;
501
501
  }): this;
502
502
  /**
@@ -550,7 +550,7 @@ export default class DowncastHelpers extends ConversionHelpers<DowncastDispatche
550
550
  * If a function is passed as the `config.view` parameter, it will be used to generate both boundary elements. The function
551
551
  * receives the `data` object and {@link module:engine/conversion/downcastdispatcher~DowncastConversionApi downcast conversion API}
552
552
  * as a parameters and should return an instance of the
553
- * {@link module:engine/view/uielement~UIElement view UI element}. The `data` object and
553
+ * {@link module:engine/view/uielement~ViewUIElement view UI element}. The `data` object and
554
554
  * {@link module:engine/conversion/downcastdispatcher~DowncastConversionApi `conversionApi`} are passed from
555
555
  * {@link module:engine/conversion/downcastdispatcher~DowncastDispatcher#event:addMarker}. Additionally,
556
556
  * the `data.isOpening` parameter is passed, which is set to `true` for the marker start boundary element, and `false` for
@@ -568,20 +568,20 @@ export default class DowncastHelpers extends ConversionHelpers<DowncastDispatche
568
568
  */
569
569
  markerToElement(config: {
570
570
  model: string;
571
- view: ElementDefinition | MarkerElementCreatorFunction;
571
+ view: ViewElementDefinition | DowncastMarkerElementCreatorFunction;
572
572
  converterPriority?: PriorityString;
573
573
  }): this;
574
574
  /**
575
575
  * Model marker to highlight conversion helper.
576
576
  *
577
577
  * This conversion results in creating a highlight on view nodes. For this kind of conversion,
578
- * the {@link module:engine/conversion/downcasthelpers~HighlightDescriptor} should be provided.
578
+ * the {@link module:engine/conversion/downcasthelpers~DowncastHighlightDescriptor} should be provided.
579
579
  *
580
- * For text nodes, a `<span>` {@link module:engine/view/attributeelement~AttributeElement} is created and it wraps all text nodes
580
+ * For text nodes, a `<span>` {@link module:engine/view/attributeelement~ViewAttributeElement} is created and it wraps all text nodes
581
581
  * in the converted marker range. For example, a model marker set like this: `<paragraph>F[oo b]ar</paragraph>` becomes
582
582
  * `<p>F<span class="comment">oo b</span>ar</p>` in the view.
583
583
  *
584
- * {@link module:engine/view/containerelement~ContainerElement} may provide a custom way of handling highlight. Most often,
584
+ * {@link module:engine/view/containerelement~ViewContainerElement} may provide a custom way of handling highlight. Most often,
585
585
  * the element itself is given classes and attributes described in the highlight descriptor (instead of being wrapped in `<span>`).
586
586
  * For example, a model marker set like this:
587
587
  * `[<imageInline src="foo.jpg"></imageInline>]` becomes `<img src="foo.jpg" class="comment"></img>` in the view.
@@ -616,7 +616,7 @@ export default class DowncastHelpers extends ConversionHelpers<DowncastDispatche
616
616
  * If a function is passed as the `config.view` parameter, it will be used to generate the highlight descriptor. The function
617
617
  * receives the `data` object and {@link module:engine/conversion/downcastdispatcher~DowncastConversionApi downcast conversion API}
618
618
  * as the parameters and should return a
619
- * {@link module:engine/conversion/downcasthelpers~HighlightDescriptor highlight descriptor}.
619
+ * {@link module:engine/conversion/downcasthelpers~DowncastHighlightDescriptor highlight descriptor}.
620
620
  * The `data` object properties are passed from {@link module:engine/conversion/downcastdispatcher~DowncastDispatcher#event:addMarker}.
621
621
  *
622
622
  * See {@link module:engine/conversion/conversion~Conversion#for `conversion.for()`} to learn how to add a converter
@@ -631,7 +631,7 @@ export default class DowncastHelpers extends ConversionHelpers<DowncastDispatche
631
631
  */
632
632
  markerToHighlight(config: {
633
633
  model: string;
634
- view: HighlightDescriptor | HighlightDescriptorCreatorFunction;
634
+ view: DowncastHighlightDescriptor | DowncastHighlightDescriptorCreatorFunction;
635
635
  converterPriority?: PriorityString;
636
636
  }): this;
637
637
  /**
@@ -756,7 +756,7 @@ export default class DowncastHelpers extends ConversionHelpers<DowncastDispatche
756
756
  */
757
757
  markerToData(config: {
758
758
  model: string;
759
- view?: MarkerDataCreatorFunction;
759
+ view?: DowncastMarkerDataCreatorFunction;
760
760
  converterPriority?: PriorityString;
761
761
  }): this;
762
762
  }
@@ -771,6 +771,7 @@ export default class DowncastHelpers extends ConversionHelpers<DowncastDispatche
771
771
  * ```
772
772
  *
773
773
  * @returns Insert text event converter.
774
+ * @internal
774
775
  */
775
776
  export declare function insertText(): (evt: EventInfo, data: {
776
777
  item: ModelText | ModelTextProxy;
@@ -780,6 +781,7 @@ export declare function insertText(): (evt: EventInfo, data: {
780
781
  * Function factory that creates a default downcast converter for triggering attributes and children conversion.
781
782
  *
782
783
  * @returns The converter.
784
+ * @internal
783
785
  */
784
786
  export declare function insertAttributesAndChildren(): (evt: unknown, data: {
785
787
  item: ModelItem;
@@ -793,20 +795,24 @@ export declare function insertAttributesAndChildren(): (evt: unknown, data: {
793
795
  * ```
794
796
  *
795
797
  * @returns Remove event converter.
798
+ * @internal
796
799
  */
797
800
  export declare function remove(): (evt: unknown, data: {
798
801
  position: ModelPosition;
799
802
  length: number;
800
803
  }, conversionApi: DowncastConversionApi) => void;
801
804
  /**
802
- * Creates a `<span>` {@link module:engine/view/attributeelement~AttributeElement view attribute element} from the information
803
- * provided by the {@link module:engine/conversion/downcasthelpers~HighlightDescriptor highlight descriptor} object. If the priority
805
+ * Creates a `<span>` {@link module:engine/view/attributeelement~ViewAttributeElement view attribute element} from the information
806
+ * provided by the {@link module:engine/conversion/downcasthelpers~DowncastHighlightDescriptor highlight descriptor} object. If the priority
804
807
  * is not provided in the descriptor, the default priority will be used.
808
+ *
809
+ * @internal
805
810
  */
806
- export declare function createViewElementFromHighlightDescriptor(writer: DowncastWriter, descriptor: HighlightDescriptor): ViewAttributeElement;
811
+ export declare function createViewElementFromDowncastHighlightDescriptor(writer: ViewDowncastWriter, descriptor: DowncastHighlightDescriptor): ViewAttributeElement;
807
812
  /**
808
- * Function factory that creates a converter which converts a non-collapsed {@link module:engine/model/selection~Selection model selection}
809
- * to a {@link module:engine/view/documentselection~DocumentSelection view selection}. The converter consumes appropriate
813
+ * Function factory that creates a converter which converts a non-collapsed
814
+ * {@link module:engine/model/selection~ModelSelection model selection}
815
+ * to a {@link module:engine/view/documentselection~ViewDocumentSelection view selection}. The converter consumes appropriate
810
816
  * value from the `consumable` object and maps model positions from the selection to view positions.
811
817
  *
812
818
  * ```ts
@@ -814,15 +820,17 @@ export declare function createViewElementFromHighlightDescriptor(writer: Downcas
814
820
  * ```
815
821
  *
816
822
  * @returns Selection converter.
823
+ * @internal
817
824
  */
818
825
  export declare function convertRangeSelection(): (evt: EventInfo, data: {
819
826
  selection: ModelSelection | ModelDocumentSelection;
820
827
  }, conversionApi: DowncastConversionApi) => void;
821
828
  /**
822
- * Function factory that creates a converter which converts a collapsed {@link module:engine/model/selection~Selection model selection} to
823
- * a {@link module:engine/view/documentselection~DocumentSelection view selection}. The converter consumes appropriate
829
+ * Function factory that creates a converter which converts a collapsed
830
+ * {@link module:engine/model/selection~ModelSelection model selection} to
831
+ * a {@link module:engine/view/documentselection~ViewDocumentSelection view selection}. The converter consumes appropriate
824
832
  * value from the `consumable` object, maps the model selection position to the view position and breaks
825
- * {@link module:engine/view/attributeelement~AttributeElement attribute elements} at the selection position.
833
+ * {@link module:engine/view/attributeelement~ViewAttributeElement attribute elements} at the selection position.
826
834
  *
827
835
  * ```ts
828
836
  * modelDispatcher.on( 'selection', convertCollapsedSelection() );
@@ -843,15 +851,16 @@ export declare function convertRangeSelection(): (evt: EventInfo, data: {
843
851
  * by merging attributes.
844
852
  *
845
853
  * @returns Selection converter.
854
+ * @internal
846
855
  */
847
856
  export declare function convertCollapsedSelection(): (evt: EventInfo, data: {
848
857
  selection: ModelSelection | ModelDocumentSelection;
849
858
  }, conversionApi: DowncastConversionApi) => void;
850
859
  /**
851
860
  * Function factory that creates a converter which cleans artifacts after the previous
852
- * {@link module:engine/model/selection~Selection model selection} conversion. It removes all empty
853
- * {@link module:engine/view/attributeelement~AttributeElement view attribute elements} and merges sibling attributes at all start and end
854
- * positions of all ranges.
861
+ * {@link module:engine/model/selection~ModelSelection model selection} conversion. It removes all empty
862
+ * {@link module:engine/view/attributeelement~ViewAttributeElement view attribute elements} and merges
863
+ * sibling attributes at all start and end positions of all ranges.
855
864
  *
856
865
  * ```
857
866
  * <p><strong>^</strong></p>
@@ -874,6 +883,7 @@ export declare function convertCollapsedSelection(): (evt: EventInfo, data: {
874
883
  * which does the opposite by breaking attributes in the selection position.
875
884
  *
876
885
  * @returns Selection converter.
886
+ * @internal
877
887
  */
878
888
  export declare function cleanSelection(): (evt: EventInfo, data: unknown, conversionApi: DowncastConversionApi) => void;
879
889
  /**
@@ -894,7 +904,7 @@ export declare function cleanSelection(): (evt: EventInfo, data: unknown, conver
894
904
  *
895
905
  * Passed `Function` will be provided with the attribute value and then all the parameters of the
896
906
  * {@link module:engine/conversion/downcastdispatcher~DowncastDispatcher#event:attribute `attribute` event}.
897
- * It is expected that the function returns an {@link module:engine/view/element~Element}.
907
+ * It is expected that the function returns an {@link module:engine/view/element~ViewElement}.
898
908
  * The result of the function will be the wrapping element.
899
909
  * When the provided `Function` does not return any element, no conversion will take place.
900
910
  *
@@ -911,7 +921,7 @@ export declare function cleanSelection(): (evt: EventInfo, data: unknown, conver
911
921
  * @param elementCreator Function returning a view element that will be used for wrapping.
912
922
  * @returns Set/change attribute converter.
913
923
  */
914
- export declare function wrap(elementCreator: AttributeElementCreatorFunction): (evt: EventInfo, data: {
924
+ export declare function wrap(elementCreator: DowncastAttributeElementCreatorFunction): (evt: EventInfo, data: {
915
925
  item: ModelItem | ModelSelection | ModelDocumentSelection;
916
926
  range: ModelRange;
917
927
  attributeKey: string;
@@ -922,7 +932,7 @@ export declare function wrap(elementCreator: AttributeElementCreatorFunction): (
922
932
  * Function factory that creates a converter which converts node insertion changes from the model to the view.
923
933
  * The function passed will be provided with all the parameters of the dispatcher's
924
934
  * {@link module:engine/conversion/downcastdispatcher~DowncastDispatcher#event:insert `insert` event}.
925
- * It is expected that the function returns an {@link module:engine/view/element~Element}.
935
+ * It is expected that the function returns an {@link module:engine/view/element~ViewElement}.
926
936
  * The result of the function will be inserted into the view.
927
937
  *
928
938
  * The converter automatically consumes the corresponding value from the consumables list and binds the model and view elements.
@@ -947,7 +957,7 @@ export declare function wrap(elementCreator: AttributeElementCreatorFunction): (
947
957
  * By default this function just consume passed item insertion.
948
958
  * @returns Insert element event converter.
949
959
  */
950
- export declare function insertElement(elementCreator: ElementCreatorFunction, consumer?: ConsumerFunction): (evt: unknown, data: {
960
+ export declare function insertElement(elementCreator: DowncastElementCreatorFunction, consumer?: ConsumerFunction): (evt: unknown, data: {
951
961
  item: ModelElement;
952
962
  range: ModelRange;
953
963
  reconversion?: boolean;
@@ -955,7 +965,7 @@ export declare function insertElement(elementCreator: ElementCreatorFunction, co
955
965
  /**
956
966
  * Function factory that creates a converter which converts a single model node insertion to a view structure.
957
967
  *
958
- * It is expected that the passed element creator function returns an {@link module:engine/view/element~Element} with attached slots
968
+ * It is expected that the passed element creator function returns an {@link module:engine/view/element~ViewElement} with attached slots
959
969
  * created with `writer.createSlot()` to indicate where child nodes should be converted.
960
970
  *
961
971
  * @see module:engine/conversion/downcasthelpers~DowncastHelpers#elementToStructure
@@ -966,14 +976,14 @@ export declare function insertElement(elementCreator: ElementCreatorFunction, co
966
976
  * that were used by the element creator.
967
977
  * @returns Insert element event converter.
968
978
  */
969
- export declare function insertStructure(elementCreator: StructureCreatorFunction, consumer: ConsumerFunction): (evt: unknown, data: {
979
+ export declare function insertStructure(elementCreator: DowncastStructureCreatorFunction, consumer: ConsumerFunction): (evt: unknown, data: {
970
980
  item: ModelElement;
971
981
  range: ModelRange;
972
982
  reconversion?: boolean;
973
983
  }, conversionApi: DowncastConversionApi) => void;
974
984
  /**
975
985
  * Function factory that creates a converter which converts marker adding change to the
976
- * {@link module:engine/view/uielement~UIElement view UI element}.
986
+ * {@link module:engine/view/uielement~ViewUIElement view UI element}.
977
987
  *
978
988
  * The view UI element that will be added to the view depends on the passed parameter. See {@link ~insertElement}.
979
989
  * In case of a non-collapsed range, the UI element will not wrap nodes but separate elements will be placed at the beginning
@@ -985,7 +995,7 @@ export declare function insertStructure(elementCreator: StructureCreatorFunction
985
995
  * @param elementCreator A view UI element or a function returning the view element that will be inserted.
986
996
  * @returns Insert element event converter.
987
997
  */
988
- export declare function insertUIElement(elementCreator: MarkerElementCreatorFunction): (evt: EventInfo, data: {
998
+ export declare function insertUIElement(elementCreator: DowncastMarkerElementCreatorFunction): (evt: EventInfo, data: {
989
999
  markerRange: ModelRange;
990
1000
  markerName: string;
991
1001
  isOpening?: boolean;
@@ -994,23 +1004,23 @@ export declare function insertUIElement(elementCreator: MarkerElementCreatorFunc
994
1004
  * An object describing how the marker highlight should be represented in the view.
995
1005
  *
996
1006
  * Each text node contained in a highlighted range will be wrapped in a `<span>`
997
- * {@link module:engine/view/attributeelement~AttributeElement view attribute element} with CSS class(es), attributes and a priority
1007
+ * {@link module:engine/view/attributeelement~ViewAttributeElement view attribute element} with CSS class(es), attributes and a priority
998
1008
  * described by this object.
999
1009
  *
1000
- * Additionally, each {@link module:engine/view/containerelement~ContainerElement container element} can handle displaying the highlight
1010
+ * Additionally, each {@link module:engine/view/containerelement~ViewContainerElement container element} can handle displaying the highlight
1001
1011
  * separately by providing the `addHighlight` and `removeHighlight` custom properties. In this case:
1002
1012
  *
1003
- * * The `HighlightDescriptor` object is passed to the `addHighlight` function upon conversion and should be used to apply the highlight to
1004
- * the element.
1013
+ * * The `DowncastHighlightDescriptor` object is passed to the `addHighlight` function upon conversion and
1014
+ * should be used to apply the highlight to the element.
1005
1015
  * * The descriptor `id` is passed to the `removeHighlight` function upon conversion and should be used to remove the highlight with the
1006
1016
  * given ID from the element.
1007
1017
  */
1008
- export interface HighlightDescriptor {
1018
+ export interface DowncastHighlightDescriptor {
1009
1019
  /**
1010
1020
  * A CSS class or an array of classes to set. If the descriptor is used to
1011
- * create an {@link module:engine/view/attributeelement~AttributeElement attribute element} over text nodes, these classes will be set
1012
- * on that attribute element. If the descriptor is applied to an element, usually these classes will be set on that element, however,
1013
- * this depends on how the element converts the descriptor.
1021
+ * create an {@link module:engine/view/attributeelement~ViewAttributeElement attribute element} over text nodes,
1022
+ * these classes will be set on that attribute element. If the descriptor is applied to an element, usually these
1023
+ * classes will be set on that element, however, this depends on how the element converts the descriptor.
1014
1024
  */
1015
1025
  classes: string | Array<string>;
1016
1026
  /**
@@ -1019,14 +1029,14 @@ export interface HighlightDescriptor {
1019
1029
  id?: string;
1020
1030
  /**
1021
1031
  * Descriptor priority. If not provided, it defaults to `10`. If the descriptor is used to create
1022
- * an {@link module:engine/view/attributeelement~AttributeElement attribute element}, it will be that element's
1023
- * {@link module:engine/view/attributeelement~AttributeElement#priority priority}. If the descriptor is applied to an element,
1032
+ * an {@link module:engine/view/attributeelement~ViewAttributeElement attribute element}, it will be that element's
1033
+ * {@link module:engine/view/attributeelement~ViewAttributeElement#priority priority}. If the descriptor is applied to an element,
1024
1034
  * the priority will be used to determine which descriptor is more important.
1025
1035
  */
1026
1036
  priority?: number;
1027
1037
  /**
1028
1038
  * Attributes to set. If the descriptor is used to create
1029
- * an {@link module:engine/view/attributeelement~AttributeElement attribute element} over text nodes, these attributes will be set
1039
+ * an {@link module:engine/view/attributeelement~ViewAttributeElement attribute element} over text nodes, these attributes will be set
1030
1040
  * on that attribute element. If the descriptor is applied to an element, usually these attributes will be set on that element, however,
1031
1041
  * this depends on how the element converts the descriptor.
1032
1042
  */
@@ -1034,24 +1044,24 @@ export interface HighlightDescriptor {
1034
1044
  }
1035
1045
  /**
1036
1046
  * A filtering function used to choose model child nodes to be downcasted into the specific view
1037
- * {@link module:engine/view/downcastwriter~DowncastWriter#createSlot "slot"} while executing the
1047
+ * {@link module:engine/view/downcastwriter~ViewDowncastWriter#createSlot "slot"} while executing the
1038
1048
  * {@link module:engine/conversion/downcasthelpers~DowncastHelpers#elementToStructure `elementToStructure()`} converter.
1039
1049
  *
1040
- * @callback module:engine/conversion/downcasthelpers~SlotFilter
1050
+ * @callback module:engine/conversion/downcasthelpers~DowncastSlotFilter
1041
1051
  *
1042
1052
  * @param node A model node.
1043
1053
  * @returns Whether the provided model node should be downcasted into this slot.
1044
1054
  *
1045
- * @see module:engine/view/downcastwriter~DowncastWriter#createSlot
1055
+ * @see module:engine/view/downcastwriter~ViewDowncastWriter#createSlot
1046
1056
  * @see module:engine/conversion/downcasthelpers~DowncastHelpers#elementToStructure
1047
1057
  * @see module:engine/conversion/downcasthelpers~insertStructure
1048
1058
  */
1049
- export type SlotFilter = (node: ModelNode) => boolean;
1059
+ export type DowncastSlotFilter = (node: ModelNode) => boolean;
1050
1060
  /**
1051
1061
  * A view element creator function that takes the model element and {@link module:engine/conversion/downcastdispatcher~DowncastConversionApi
1052
1062
  * downcast conversion API} as parameters and returns a view container element.
1053
1063
  *
1054
- * @callback module:engine/conversion/downcasthelpers~ElementCreatorFunction
1064
+ * @callback module:engine/conversion/downcasthelpers~DowncastElementCreatorFunction
1055
1065
  *
1056
1066
  * @param element The model element to be converted to the view structure.
1057
1067
  * @param conversionApi The conversion interface.
@@ -1064,7 +1074,7 @@ export type SlotFilter = (node: ModelNode) => boolean;
1064
1074
  * @see module:engine/conversion/downcasthelpers~DowncastHelpers#elementToElement
1065
1075
  * @see module:engine/conversion/downcasthelpers~insertElement
1066
1076
  */
1067
- export type ElementCreatorFunction = (element: ModelElement, conversionApi: DowncastConversionApi, data: {
1077
+ export type DowncastElementCreatorFunction = (element: ModelElement, conversionApi: DowncastConversionApi, data: {
1068
1078
  item: ModelItem;
1069
1079
  range: ModelRange;
1070
1080
  }) => ViewElement | null;
@@ -1072,7 +1082,7 @@ export type ElementCreatorFunction = (element: ModelElement, conversionApi: Down
1072
1082
  * A function that takes the model element and {@link module:engine/conversion/downcastdispatcher~DowncastConversionApi downcast
1073
1083
  * conversion API} as parameters and returns a view container element with slots for model child nodes to be converted into.
1074
1084
  *
1075
- * @callback module:engine/conversion/downcasthelpers~StructureCreatorFunction
1085
+ * @callback module:engine/conversion/downcasthelpers~DowncastStructureCreatorFunction
1076
1086
  *
1077
1087
  * @param element The model element to be converted to the view structure.
1078
1088
  * @param conversionApi The conversion interface.
@@ -1085,13 +1095,13 @@ export type ElementCreatorFunction = (element: ModelElement, conversionApi: Down
1085
1095
  * @see module:engine/conversion/downcasthelpers~DowncastHelpers#elementToStructure
1086
1096
  * @see module:engine/conversion/downcasthelpers~insertStructure
1087
1097
  */
1088
- export type StructureCreatorFunction = ElementCreatorFunction;
1098
+ export type DowncastStructureCreatorFunction = DowncastElementCreatorFunction;
1089
1099
  /**
1090
1100
  * A view element creator function that takes the model attribute value and
1091
1101
  * {@link module:engine/conversion/downcastdispatcher~DowncastConversionApi downcast conversion API} as parameters and returns a view
1092
1102
  * attribute element.
1093
1103
  *
1094
- * @callback module:engine/conversion/downcasthelpers~AttributeElementCreatorFunction
1104
+ * @callback module:engine/conversion/downcasthelpers~DowncastAttributeElementCreatorFunction
1095
1105
  *
1096
1106
  * @param attributeValue The model attribute value to be converted to the view attribute element.
1097
1107
  * @param conversionApi The conversion interface.
@@ -1107,7 +1117,7 @@ export type StructureCreatorFunction = ElementCreatorFunction;
1107
1117
  * @see module:engine/conversion/downcasthelpers~DowncastHelpers#attributeToElement
1108
1118
  * @see module:engine/conversion/downcasthelpers~wrap
1109
1119
  */
1110
- export type AttributeElementCreatorFunction = (attributeValue: any, conversionApi: DowncastConversionApi, data: {
1120
+ export type DowncastAttributeElementCreatorFunction = (attributeValue: any, conversionApi: DowncastConversionApi, data: {
1111
1121
  item: ModelItem | ModelSelection | ModelDocumentSelection;
1112
1122
  range: ModelRange;
1113
1123
  attributeKey: string;
@@ -1119,7 +1129,7 @@ export type AttributeElementCreatorFunction = (attributeValue: any, conversionAp
1119
1129
  * {@link module:engine/conversion/downcastdispatcher~DowncastConversionApi downcast conversion API}
1120
1130
  * as parameters.
1121
1131
  *
1122
- * @callback module:engine/conversion/downcasthelpers~AttributeCreatorFunction
1132
+ * @callback module:engine/conversion/downcasthelpers~DowncastAttributeCreatorFunction
1123
1133
  *
1124
1134
  * @param attributeValue The model attribute value to be converted to the view attribute element.
1125
1135
  * @param conversionApi The conversion interface.
@@ -1135,14 +1145,14 @@ export type AttributeElementCreatorFunction = (attributeValue: any, conversionAp
1135
1145
  *
1136
1146
  * @see module:engine/conversion/downcasthelpers~DowncastHelpers#attributeToAttribute
1137
1147
  */
1138
- export type AttributeCreatorFunction = (attributeValue: unknown, conversionApi: DowncastConversionApi, data: {
1148
+ export type DowncastAttributeCreatorFunction = (attributeValue: unknown, conversionApi: DowncastConversionApi, data: {
1139
1149
  item: ModelItem;
1140
1150
  range: ModelRange;
1141
1151
  attributeKey: string;
1142
1152
  attributeOldValue: unknown;
1143
1153
  attributeNewValue: unknown;
1144
- }) => AttributeDescriptor | null;
1145
- export type AttributeDescriptor = {
1154
+ }) => DowncastAttributeDescriptor | null;
1155
+ export type DowncastAttributeDescriptor = {
1146
1156
  key: 'class';
1147
1157
  value: string | Array<string>;
1148
1158
  } | {
@@ -1152,18 +1162,18 @@ export type AttributeDescriptor = {
1152
1162
  key: Exclude<string, 'class' | 'style'>;
1153
1163
  value: string;
1154
1164
  };
1155
- export type MarkerElementCreatorFunction = (data: {
1165
+ export type DowncastMarkerElementCreatorFunction = (data: {
1156
1166
  markerRange: ModelRange;
1157
1167
  markerName: string;
1158
1168
  isOpening?: boolean;
1159
- }, conversionApi: DowncastConversionApi) => UIElement | null;
1160
- export type HighlightDescriptorCreatorFunction = (data: {
1169
+ }, conversionApi: DowncastConversionApi) => ViewUIElement | null;
1170
+ export type DowncastHighlightDescriptorCreatorFunction = (data: {
1161
1171
  markerRange: ModelRange;
1162
1172
  markerName: string;
1163
- }, conversionApi: DowncastConversionApi) => HighlightDescriptor | null;
1164
- export type AddHighlightCallback = (viewElement: ViewElement, descriptor: HighlightDescriptor, writer: DowncastWriter) => void;
1165
- export type RemoveHighlightCallback = (viewElement: ViewElement, id: string, writer: DowncastWriter) => void;
1166
- export type MarkerDataCreatorFunction = (markerName: string, conversionApi: DowncastConversionApi) => {
1173
+ }, conversionApi: DowncastConversionApi) => DowncastHighlightDescriptor | null;
1174
+ export type DowncastAddHighlightCallback = (viewElement: ViewElement, descriptor: DowncastHighlightDescriptor, writer: ViewDowncastWriter) => void;
1175
+ export type DowncastRemoveHighlightCallback = (viewElement: ViewElement, id: string, writer: ViewDowncastWriter) => void;
1176
+ export type DowncastMarkerDataCreatorFunction = (markerName: string, conversionApi: DowncastConversionApi) => {
1167
1177
  name: string;
1168
1178
  group: string;
1169
1179
  } | null;
@@ -1172,6 +1182,7 @@ export type MarkerDataCreatorFunction = (markerName: string, conversionApi: Down
1172
1182
  *
1173
1183
  * @callback module:engine/conversion/downcasthelpers~ConsumerFunction
1174
1184
  *
1185
+ * @internal
1175
1186
  * @param element The model element to be converted to the view structure.
1176
1187
  * @param consumable The `ModelConsumable` same as in
1177
1188
  * {@link module:engine/conversion/downcastdispatcher~DowncastConversionApi#consumable `DowncastConversionApi.consumable`}.