@ckeditor/ckeditor5-engine 35.0.1 → 35.1.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 (124) hide show
  1. package/CHANGELOG.md +4 -4
  2. package/package.json +30 -24
  3. package/src/controller/datacontroller.js +467 -561
  4. package/src/controller/editingcontroller.js +168 -204
  5. package/src/conversion/conversion.js +541 -565
  6. package/src/conversion/conversionhelpers.js +24 -28
  7. package/src/conversion/downcastdispatcher.js +457 -686
  8. package/src/conversion/downcasthelpers.js +1583 -1965
  9. package/src/conversion/mapper.js +518 -707
  10. package/src/conversion/modelconsumable.js +240 -283
  11. package/src/conversion/upcastdispatcher.js +372 -718
  12. package/src/conversion/upcasthelpers.js +707 -818
  13. package/src/conversion/viewconsumable.js +524 -581
  14. package/src/dataprocessor/basichtmlwriter.js +12 -16
  15. package/src/dataprocessor/dataprocessor.js +5 -0
  16. package/src/dataprocessor/htmldataprocessor.js +100 -116
  17. package/src/dataprocessor/htmlwriter.js +1 -18
  18. package/src/dataprocessor/xmldataprocessor.js +116 -137
  19. package/src/dev-utils/model.js +260 -352
  20. package/src/dev-utils/operationreplayer.js +106 -126
  21. package/src/dev-utils/utils.js +34 -51
  22. package/src/dev-utils/view.js +632 -753
  23. package/src/index.js +0 -11
  24. package/src/model/batch.js +111 -127
  25. package/src/model/differ.js +988 -1233
  26. package/src/model/document.js +340 -449
  27. package/src/model/documentfragment.js +327 -364
  28. package/src/model/documentselection.js +996 -1189
  29. package/src/model/element.js +306 -410
  30. package/src/model/history.js +224 -262
  31. package/src/model/item.js +5 -0
  32. package/src/model/liveposition.js +84 -145
  33. package/src/model/liverange.js +108 -185
  34. package/src/model/markercollection.js +379 -480
  35. package/src/model/model.js +883 -1034
  36. package/src/model/node.js +419 -463
  37. package/src/model/nodelist.js +175 -201
  38. package/src/model/operation/attributeoperation.js +153 -182
  39. package/src/model/operation/detachoperation.js +64 -83
  40. package/src/model/operation/insertoperation.js +135 -166
  41. package/src/model/operation/markeroperation.js +114 -140
  42. package/src/model/operation/mergeoperation.js +163 -191
  43. package/src/model/operation/moveoperation.js +157 -187
  44. package/src/model/operation/nooperation.js +28 -38
  45. package/src/model/operation/operation.js +106 -125
  46. package/src/model/operation/operationfactory.js +30 -34
  47. package/src/model/operation/renameoperation.js +109 -135
  48. package/src/model/operation/rootattributeoperation.js +155 -188
  49. package/src/model/operation/splitoperation.js +196 -232
  50. package/src/model/operation/transform.js +1833 -2204
  51. package/src/model/operation/utils.js +140 -204
  52. package/src/model/position.js +899 -1053
  53. package/src/model/range.js +910 -1028
  54. package/src/model/rootelement.js +77 -97
  55. package/src/model/schema.js +1189 -1835
  56. package/src/model/selection.js +745 -862
  57. package/src/model/text.js +90 -114
  58. package/src/model/textproxy.js +204 -240
  59. package/src/model/treewalker.js +316 -397
  60. package/src/model/typecheckable.js +16 -0
  61. package/src/model/utils/autoparagraphing.js +32 -44
  62. package/src/model/utils/deletecontent.js +334 -418
  63. package/src/model/utils/findoptimalinsertionrange.js +25 -36
  64. package/src/model/utils/getselectedcontent.js +96 -118
  65. package/src/model/utils/insertcontent.js +654 -773
  66. package/src/model/utils/insertobject.js +96 -119
  67. package/src/model/utils/modifyselection.js +120 -158
  68. package/src/model/utils/selection-post-fixer.js +153 -201
  69. package/src/model/writer.js +1305 -1474
  70. package/src/view/attributeelement.js +189 -225
  71. package/src/view/containerelement.js +75 -85
  72. package/src/view/document.js +172 -215
  73. package/src/view/documentfragment.js +200 -249
  74. package/src/view/documentselection.js +338 -367
  75. package/src/view/domconverter.js +1370 -1617
  76. package/src/view/downcastwriter.js +1747 -2076
  77. package/src/view/editableelement.js +81 -97
  78. package/src/view/element.js +739 -890
  79. package/src/view/elementdefinition.js +5 -0
  80. package/src/view/emptyelement.js +82 -92
  81. package/src/view/filler.js +35 -50
  82. package/src/view/item.js +5 -0
  83. package/src/view/matcher.js +260 -559
  84. package/src/view/node.js +274 -360
  85. package/src/view/observer/arrowkeysobserver.js +19 -28
  86. package/src/view/observer/bubblingemittermixin.js +120 -263
  87. package/src/view/observer/bubblingeventinfo.js +47 -55
  88. package/src/view/observer/clickobserver.js +7 -13
  89. package/src/view/observer/compositionobserver.js +14 -24
  90. package/src/view/observer/domeventdata.js +57 -67
  91. package/src/view/observer/domeventobserver.js +40 -64
  92. package/src/view/observer/fakeselectionobserver.js +81 -96
  93. package/src/view/observer/focusobserver.js +45 -61
  94. package/src/view/observer/inputobserver.js +7 -13
  95. package/src/view/observer/keyobserver.js +17 -27
  96. package/src/view/observer/mouseobserver.js +7 -14
  97. package/src/view/observer/mutationobserver.js +220 -315
  98. package/src/view/observer/observer.js +81 -102
  99. package/src/view/observer/selectionobserver.js +191 -246
  100. package/src/view/observer/tabobserver.js +23 -36
  101. package/src/view/placeholder.js +128 -173
  102. package/src/view/position.js +350 -401
  103. package/src/view/range.js +453 -513
  104. package/src/view/rawelement.js +85 -112
  105. package/src/view/renderer.js +874 -1018
  106. package/src/view/rooteditableelement.js +80 -90
  107. package/src/view/selection.js +608 -689
  108. package/src/view/styles/background.js +43 -44
  109. package/src/view/styles/border.js +220 -276
  110. package/src/view/styles/margin.js +8 -17
  111. package/src/view/styles/padding.js +8 -16
  112. package/src/view/styles/utils.js +127 -160
  113. package/src/view/stylesmap.js +728 -905
  114. package/src/view/text.js +102 -126
  115. package/src/view/textproxy.js +144 -170
  116. package/src/view/treewalker.js +383 -479
  117. package/src/view/typecheckable.js +19 -0
  118. package/src/view/uielement.js +166 -187
  119. package/src/view/upcastwriter.js +395 -449
  120. package/src/view/view.js +569 -664
  121. package/src/dataprocessor/dataprocessor.jsdoc +0 -64
  122. package/src/model/item.jsdoc +0 -14
  123. package/src/view/elementdefinition.jsdoc +0 -59
  124. package/src/view/item.jsdoc +0 -14
@@ -2,15 +2,12 @@
2
2
  * @license Copyright (c) 2003-2022, 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
+ /* eslint-disable new-cap */
6
6
  /**
7
7
  * @module engine/view/editableelement
8
8
  */
9
-
10
9
  import ContainerElement from './containerelement';
11
- import mix from '@ckeditor/ckeditor5-utils/src/mix';
12
- import ObservableMixin from '@ckeditor/ckeditor5-utils/src/observablemixin';
13
-
10
+ import { default as ObservableMixin } from '@ckeditor/ckeditor5-utils/src/observablemixin';
14
11
  /**
15
12
  * Editable element which can be a {@link module:engine/view/rooteditableelement~RootEditableElement root}
16
13
  * or nested editable area in the editor.
@@ -23,96 +20,83 @@ import ObservableMixin from '@ckeditor/ckeditor5-utils/src/observablemixin';
23
20
  * @extends module:engine/view/containerelement~ContainerElement
24
21
  * @mixes module:utils/observablemixin~ObservableMixin
25
22
  */
26
- export default class EditableElement extends ContainerElement {
27
- /**
28
- * Creates an editable element.
29
- *
30
- * @see module:engine/view/downcastwriter~DowncastWriter#createEditableElement
31
- * @protected
32
- */
33
- constructor( document, name, attrs, children ) {
34
- super( document, name, attrs, children );
35
-
36
- /**
37
- * Whether the editable is in read-write or read-only mode.
38
- *
39
- * @observable
40
- * @member {Boolean} module:engine/view/editableelement~EditableElement#isReadOnly
41
- */
42
- this.set( 'isReadOnly', false );
43
-
44
- /**
45
- * Whether the editable is focused.
46
- *
47
- * This property updates when {@link module:engine/view/document~Document#isFocused document.isFocused} or view
48
- * selection is changed.
49
- *
50
- * @readonly
51
- * @observable
52
- * @member {Boolean} module:engine/view/editableelement~EditableElement#isFocused
53
- */
54
- this.set( 'isFocused', false );
55
-
56
- this.bind( 'isReadOnly' ).to( document );
57
-
58
- this.bind( 'isFocused' ).to(
59
- document,
60
- 'isFocused',
61
- isFocused => isFocused && document.selection.editableElement == this
62
- );
63
-
64
- // Update focus state based on selection changes.
65
- this.listenTo( document.selection, 'change', () => {
66
- this.isFocused = document.isFocused && document.selection.editableElement == this;
67
- } );
68
- }
69
-
70
- /**
71
- * Checks whether this object is of the given.
72
- *
73
- * editableElement.is( 'editableElement' ); // -> true
74
- * editableElement.is( 'element' ); // -> true
75
- * editableElement.is( 'node' ); // -> true
76
- * editableElement.is( 'view:editableElement' ); // -> true
77
- * editableElement.is( 'view:element' ); // -> true
78
- * editableElement.is( 'view:node' ); // -> true
79
- *
80
- * editableElement.is( 'model:element' ); // -> false
81
- * editableElement.is( 'documentFragment' ); // -> false
82
- *
83
- * Assuming that the object being checked is an editbale element, you can also check its
84
- * {@link module:engine/view/editableelement~EditableElement#name name}:
85
- *
86
- * editableElement.is( 'element', 'div' ); // -> true if this is a div element
87
- * editableElement.is( 'editableElement', 'div' ); // -> same as above
88
- * text.is( 'element', 'div' ); -> false
89
- *
90
- * {@link module:engine/view/node~Node#is Check the entire list of view objects} which implement the `is()` method.
91
- *
92
- * @param {String} type Type to check.
93
- * @param {String} [name] Element name.
94
- * @returns {Boolean}
95
- */
96
- is( type, name = null ) {
97
- if ( !name ) {
98
- return type === 'editableElement' || type === 'view:editableElement' ||
99
- // From super.is(). This is highly utilised method and cannot call super. See ckeditor/ckeditor5#6529.
100
- type === 'containerElement' || type === 'view:containerElement' ||
101
- type === 'element' || type === 'view:element' ||
102
- type === 'node' || type === 'view:node';
103
- } else {
104
- return name === this.name && (
105
- type === 'editableElement' || type === 'view:editableElement' ||
106
- // From super.is(). This is highly utilised method and cannot call super. See ckeditor/ckeditor5#6529.
107
- type === 'containerElement' || type === 'view:containerElement' ||
108
- type === 'element' || type === 'view:element'
109
- );
110
- }
111
- }
112
-
113
- destroy() {
114
- this.stopListening();
115
- }
23
+ export default class EditableElement extends ObservableMixin(ContainerElement) {
24
+ /**
25
+ * Creates an editable element.
26
+ *
27
+ * @see module:engine/view/downcastwriter~DowncastWriter#createEditableElement
28
+ * @protected
29
+ */
30
+ constructor(...args) {
31
+ super(...args);
32
+ const document = args[0];
33
+ /**
34
+ * Whether the editable is in read-write or read-only mode.
35
+ *
36
+ * @observable
37
+ * @member {Boolean} module:engine/view/editableelement~EditableElement#isReadOnly
38
+ */
39
+ this.set('isReadOnly', false);
40
+ /**
41
+ * Whether the editable is focused.
42
+ *
43
+ * This property updates when {@link module:engine/view/document~Document#isFocused document.isFocused} or view
44
+ * selection is changed.
45
+ *
46
+ * @readonly
47
+ * @observable
48
+ * @member {Boolean} module:engine/view/editableelement~EditableElement#isFocused
49
+ */
50
+ this.set('isFocused', false);
51
+ this.bind('isReadOnly').to(document);
52
+ this.bind('isFocused').to(document, 'isFocused', isFocused => isFocused && document.selection.editableElement == this);
53
+ // Update focus state based on selection changes.
54
+ this.listenTo(document.selection, 'change', () => {
55
+ this.isFocused = document.isFocused && document.selection.editableElement == this;
56
+ });
57
+ }
58
+ destroy() {
59
+ this.stopListening();
60
+ }
116
61
  }
117
-
118
- mix( EditableElement, ObservableMixin );
62
+ /**
63
+ * Checks whether this object is of the given.
64
+ *
65
+ * editableElement.is( 'editableElement' ); // -> true
66
+ * editableElement.is( 'element' ); // -> true
67
+ * editableElement.is( 'node' ); // -> true
68
+ * editableElement.is( 'view:editableElement' ); // -> true
69
+ * editableElement.is( 'view:element' ); // -> true
70
+ * editableElement.is( 'view:node' ); // -> true
71
+ *
72
+ * editableElement.is( 'model:element' ); // -> false
73
+ * editableElement.is( 'documentFragment' ); // -> false
74
+ *
75
+ * Assuming that the object being checked is an editbale element, you can also check its
76
+ * {@link module:engine/view/editableelement~EditableElement#name name}:
77
+ *
78
+ * editableElement.is( 'element', 'div' ); // -> true if this is a div element
79
+ * editableElement.is( 'editableElement', 'div' ); // -> same as above
80
+ * text.is( 'element', 'div' ); -> false
81
+ *
82
+ * {@link module:engine/view/node~Node#is Check the entire list of view objects} which implement the `is()` method.
83
+ *
84
+ * @param {String} type Type to check.
85
+ * @param {String} [name] Element name.
86
+ * @returns {Boolean}
87
+ */
88
+ EditableElement.prototype.is = function (type, name) {
89
+ if (!name) {
90
+ return type === 'editableElement' || type === 'view:editableElement' ||
91
+ // From super.is(). This is highly utilised method and cannot call super. See ckeditor/ckeditor5#6529.
92
+ type === 'containerElement' || type === 'view:containerElement' ||
93
+ type === 'element' || type === 'view:element' ||
94
+ type === 'node' || type === 'view:node';
95
+ }
96
+ else {
97
+ return name === this.name && (type === 'editableElement' || type === 'view:editableElement' ||
98
+ // From super.is(). This is highly utilised method and cannot call super. See ckeditor/ckeditor5#6529.
99
+ type === 'containerElement' || type === 'view:containerElement' ||
100
+ type === 'element' || type === 'view:element');
101
+ }
102
+ };