@ckeditor/ckeditor5-engine 38.1.1 → 38.2.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.
- package/package.json +3 -2
- package/src/controller/datacontroller.d.ts +334 -334
- package/src/controller/datacontroller.js +481 -481
- package/src/controller/editingcontroller.d.ts +98 -98
- package/src/controller/editingcontroller.js +191 -191
- package/src/conversion/conversion.d.ts +478 -478
- package/src/conversion/conversion.js +601 -601
- package/src/conversion/conversionhelpers.d.ts +26 -26
- package/src/conversion/conversionhelpers.js +32 -32
- package/src/conversion/downcastdispatcher.d.ts +547 -547
- package/src/conversion/downcastdispatcher.js +538 -538
- package/src/conversion/downcasthelpers.d.ts +1226 -1226
- package/src/conversion/downcasthelpers.js +2183 -2183
- package/src/conversion/mapper.d.ts +503 -503
- package/src/conversion/mapper.js +536 -536
- package/src/conversion/modelconsumable.d.ts +201 -201
- package/src/conversion/modelconsumable.js +333 -333
- package/src/conversion/upcastdispatcher.d.ts +492 -492
- package/src/conversion/upcastdispatcher.js +460 -460
- package/src/conversion/upcasthelpers.d.ts +499 -499
- package/src/conversion/upcasthelpers.js +950 -950
- package/src/conversion/viewconsumable.d.ts +369 -369
- package/src/conversion/viewconsumable.js +532 -532
- package/src/dataprocessor/basichtmlwriter.d.ts +18 -18
- package/src/dataprocessor/basichtmlwriter.js +19 -19
- package/src/dataprocessor/dataprocessor.d.ts +61 -61
- package/src/dataprocessor/dataprocessor.js +5 -5
- package/src/dataprocessor/htmldataprocessor.d.ts +76 -76
- package/src/dataprocessor/htmldataprocessor.js +96 -96
- package/src/dataprocessor/htmlwriter.d.ts +16 -16
- package/src/dataprocessor/htmlwriter.js +5 -5
- package/src/dataprocessor/xmldataprocessor.d.ts +90 -90
- package/src/dataprocessor/xmldataprocessor.js +108 -108
- package/src/dev-utils/model.d.ts +124 -124
- package/src/dev-utils/model.js +395 -395
- package/src/dev-utils/operationreplayer.d.ts +51 -51
- package/src/dev-utils/operationreplayer.js +112 -112
- package/src/dev-utils/utils.d.ts +37 -37
- package/src/dev-utils/utils.js +73 -73
- package/src/dev-utils/view.d.ts +319 -319
- package/src/dev-utils/view.js +967 -967
- package/src/index.d.ts +113 -113
- package/src/index.js +77 -77
- package/src/model/batch.d.ts +106 -106
- package/src/model/batch.js +96 -96
- package/src/model/differ.d.ts +373 -373
- package/src/model/differ.js +1090 -1090
- package/src/model/document.d.ts +266 -264
- package/src/model/document.js +356 -356
- package/src/model/documentfragment.d.ts +200 -200
- package/src/model/documentfragment.js +306 -306
- package/src/model/documentselection.d.ts +420 -420
- package/src/model/documentselection.js +990 -987
- package/src/model/element.d.ts +165 -165
- package/src/model/element.js +281 -281
- package/src/model/history.d.ts +114 -114
- package/src/model/history.js +207 -207
- package/src/model/item.d.ts +14 -14
- package/src/model/item.js +5 -5
- package/src/model/liveposition.d.ts +77 -77
- package/src/model/liveposition.js +93 -93
- package/src/model/liverange.d.ts +102 -102
- package/src/model/liverange.js +120 -120
- package/src/model/markercollection.d.ts +335 -335
- package/src/model/markercollection.js +403 -403
- package/src/model/model.d.ts +920 -920
- package/src/model/model.js +843 -843
- package/src/model/node.d.ts +256 -256
- package/src/model/node.js +375 -375
- package/src/model/nodelist.d.ts +91 -91
- package/src/model/nodelist.js +163 -163
- package/src/model/operation/attributeoperation.d.ts +103 -103
- package/src/model/operation/attributeoperation.js +148 -148
- package/src/model/operation/detachoperation.d.ts +60 -60
- package/src/model/operation/detachoperation.js +77 -77
- package/src/model/operation/insertoperation.d.ts +90 -90
- package/src/model/operation/insertoperation.js +135 -135
- package/src/model/operation/markeroperation.d.ts +91 -91
- package/src/model/operation/markeroperation.js +107 -107
- package/src/model/operation/mergeoperation.d.ts +100 -100
- package/src/model/operation/mergeoperation.js +167 -167
- package/src/model/operation/moveoperation.d.ts +96 -96
- package/src/model/operation/moveoperation.js +164 -164
- package/src/model/operation/nooperation.d.ts +38 -38
- package/src/model/operation/nooperation.js +48 -48
- package/src/model/operation/operation.d.ts +96 -96
- package/src/model/operation/operation.js +62 -62
- package/src/model/operation/operationfactory.d.ts +18 -18
- package/src/model/operation/operationfactory.js +44 -44
- package/src/model/operation/renameoperation.d.ts +83 -83
- package/src/model/operation/renameoperation.js +115 -115
- package/src/model/operation/rootattributeoperation.d.ts +98 -98
- package/src/model/operation/rootattributeoperation.js +155 -155
- package/src/model/operation/rootoperation.d.ts +80 -80
- package/src/model/operation/rootoperation.js +114 -114
- package/src/model/operation/splitoperation.d.ts +109 -109
- package/src/model/operation/splitoperation.js +194 -194
- package/src/model/operation/transform.d.ts +100 -100
- package/src/model/operation/transform.js +1985 -1985
- package/src/model/operation/utils.d.ts +71 -71
- package/src/model/operation/utils.js +213 -213
- package/src/model/position.d.ts +539 -539
- package/src/model/position.js +979 -979
- package/src/model/range.d.ts +458 -458
- package/src/model/range.js +875 -875
- package/src/model/rootelement.d.ts +54 -54
- package/src/model/rootelement.js +68 -68
- package/src/model/schema.d.ts +1186 -1176
- package/src/model/schema.js +1237 -1237
- package/src/model/selection.d.ts +482 -482
- package/src/model/selection.js +789 -789
- package/src/model/text.d.ts +66 -66
- package/src/model/text.js +85 -85
- package/src/model/textproxy.d.ts +144 -144
- package/src/model/textproxy.js +189 -189
- package/src/model/treewalker.d.ts +186 -186
- package/src/model/treewalker.js +244 -244
- package/src/model/typecheckable.d.ts +285 -285
- package/src/model/typecheckable.js +16 -16
- package/src/model/utils/autoparagraphing.d.ts +37 -37
- package/src/model/utils/autoparagraphing.js +64 -64
- package/src/model/utils/deletecontent.d.ts +58 -58
- package/src/model/utils/deletecontent.js +488 -488
- package/src/model/utils/findoptimalinsertionrange.d.ts +32 -32
- package/src/model/utils/findoptimalinsertionrange.js +57 -57
- package/src/model/utils/getselectedcontent.d.ts +30 -30
- package/src/model/utils/getselectedcontent.js +125 -125
- package/src/model/utils/insertcontent.d.ts +46 -46
- package/src/model/utils/insertcontent.js +705 -705
- package/src/model/utils/insertobject.d.ts +44 -44
- package/src/model/utils/insertobject.js +139 -139
- package/src/model/utils/modifyselection.d.ts +48 -48
- package/src/model/utils/modifyselection.js +186 -186
- package/src/model/utils/selection-post-fixer.d.ts +74 -74
- package/src/model/utils/selection-post-fixer.js +260 -260
- package/src/model/writer.d.ts +851 -851
- package/src/model/writer.js +1306 -1306
- package/src/view/attributeelement.d.ts +108 -108
- package/src/view/attributeelement.js +184 -184
- package/src/view/containerelement.d.ts +49 -49
- package/src/view/containerelement.js +80 -80
- package/src/view/datatransfer.d.ts +79 -79
- package/src/view/datatransfer.js +98 -98
- package/src/view/document.d.ts +184 -184
- package/src/view/document.js +120 -120
- package/src/view/documentfragment.d.ts +149 -149
- package/src/view/documentfragment.js +228 -228
- package/src/view/documentselection.d.ts +306 -306
- package/src/view/documentselection.js +256 -256
- package/src/view/domconverter.d.ts +634 -650
- package/src/view/domconverter.js +1407 -1373
- package/src/view/downcastwriter.d.ts +996 -996
- package/src/view/downcastwriter.js +1696 -1696
- package/src/view/editableelement.d.ts +52 -52
- package/src/view/editableelement.js +61 -61
- package/src/view/element.d.ts +468 -468
- package/src/view/element.js +724 -724
- package/src/view/elementdefinition.d.ts +87 -87
- package/src/view/elementdefinition.js +5 -5
- package/src/view/emptyelement.d.ts +41 -41
- package/src/view/emptyelement.js +73 -73
- package/src/view/filler.d.ts +111 -111
- package/src/view/filler.js +150 -148
- package/src/view/item.d.ts +14 -14
- package/src/view/item.js +5 -5
- package/src/view/matcher.d.ts +486 -486
- package/src/view/matcher.js +507 -507
- package/src/view/node.d.ts +163 -163
- package/src/view/node.js +228 -228
- package/src/view/observer/arrowkeysobserver.d.ts +45 -45
- package/src/view/observer/arrowkeysobserver.js +40 -40
- package/src/view/observer/bubblingemittermixin.d.ts +166 -166
- package/src/view/observer/bubblingemittermixin.js +172 -172
- package/src/view/observer/bubblingeventinfo.d.ts +47 -47
- package/src/view/observer/bubblingeventinfo.js +37 -37
- package/src/view/observer/clickobserver.d.ts +43 -43
- package/src/view/observer/clickobserver.js +29 -29
- package/src/view/observer/compositionobserver.d.ts +82 -82
- package/src/view/observer/compositionobserver.js +60 -60
- package/src/view/observer/domeventdata.d.ts +50 -50
- package/src/view/observer/domeventdata.js +47 -47
- package/src/view/observer/domeventobserver.d.ts +73 -73
- package/src/view/observer/domeventobserver.js +79 -79
- package/src/view/observer/fakeselectionobserver.d.ts +47 -47
- package/src/view/observer/fakeselectionobserver.js +91 -91
- package/src/view/observer/focusobserver.d.ts +82 -82
- package/src/view/observer/focusobserver.js +86 -86
- package/src/view/observer/inputobserver.d.ts +86 -86
- package/src/view/observer/inputobserver.js +164 -164
- package/src/view/observer/keyobserver.d.ts +66 -66
- package/src/view/observer/keyobserver.js +39 -39
- package/src/view/observer/mouseobserver.d.ts +89 -89
- package/src/view/observer/mouseobserver.js +29 -29
- package/src/view/observer/mutationobserver.d.ts +86 -86
- package/src/view/observer/mutationobserver.js +206 -206
- package/src/view/observer/observer.d.ts +89 -89
- package/src/view/observer/observer.js +84 -84
- package/src/view/observer/selectionobserver.d.ts +148 -148
- package/src/view/observer/selectionobserver.js +202 -202
- package/src/view/observer/tabobserver.d.ts +46 -46
- package/src/view/observer/tabobserver.js +42 -42
- package/src/view/placeholder.d.ts +85 -85
- package/src/view/placeholder.js +230 -230
- package/src/view/position.d.ts +189 -189
- package/src/view/position.js +324 -324
- package/src/view/range.d.ts +279 -279
- package/src/view/range.js +430 -430
- package/src/view/rawelement.d.ts +73 -73
- package/src/view/rawelement.js +105 -105
- package/src/view/renderer.d.ts +265 -265
- package/src/view/renderer.js +1000 -1000
- package/src/view/rooteditableelement.d.ts +41 -41
- package/src/view/rooteditableelement.js +69 -69
- package/src/view/selection.d.ts +375 -375
- package/src/view/selection.js +559 -559
- package/src/view/styles/background.d.ts +33 -33
- package/src/view/styles/background.js +74 -74
- package/src/view/styles/border.d.ts +43 -43
- package/src/view/styles/border.js +316 -316
- package/src/view/styles/margin.d.ts +29 -29
- package/src/view/styles/margin.js +34 -34
- package/src/view/styles/padding.d.ts +29 -29
- package/src/view/styles/padding.js +34 -34
- package/src/view/styles/utils.d.ts +93 -93
- package/src/view/styles/utils.js +219 -219
- package/src/view/stylesmap.d.ts +675 -675
- package/src/view/stylesmap.js +766 -766
- package/src/view/text.d.ts +74 -74
- package/src/view/text.js +93 -93
- package/src/view/textproxy.d.ts +97 -97
- package/src/view/textproxy.js +124 -124
- package/src/view/treewalker.d.ts +195 -195
- package/src/view/treewalker.js +327 -327
- package/src/view/typecheckable.d.ts +448 -448
- package/src/view/typecheckable.js +19 -19
- package/src/view/uielement.d.ts +96 -96
- package/src/view/uielement.js +182 -182
- package/src/view/upcastwriter.d.ts +417 -417
- package/src/view/upcastwriter.js +359 -359
- package/src/view/view.d.ts +480 -480
- package/src/view/view.js +534 -534
|
@@ -1,51 +1,51 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
|
|
3
|
-
* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
|
|
4
|
-
*/
|
|
5
|
-
import type Model from '../model/model';
|
|
6
|
-
import type Operation from '../model/operation/operation';
|
|
7
|
-
/**
|
|
8
|
-
* Operation replayer is a development tool created for easy replaying of operations on the document from stringified operations.
|
|
9
|
-
*/
|
|
10
|
-
export default class OperationReplayer {
|
|
11
|
-
private _model;
|
|
12
|
-
private _logSeparator;
|
|
13
|
-
private _operationsToReplay;
|
|
14
|
-
/**
|
|
15
|
-
* @param model Data model.
|
|
16
|
-
* @param logSeparator Separator between operations.
|
|
17
|
-
* @param stringifiedOperations Operations to replay.
|
|
18
|
-
*/
|
|
19
|
-
constructor(model: Model, logSeparator: string, stringifiedOperations: string);
|
|
20
|
-
/**
|
|
21
|
-
* Parses the given string containing stringified operations and sets parsed operations as operations to replay.
|
|
22
|
-
*
|
|
23
|
-
* @param stringifiedOperations Stringified operations to replay.
|
|
24
|
-
*/
|
|
25
|
-
setStringifiedOperations(stringifiedOperations: string): void;
|
|
26
|
-
/**
|
|
27
|
-
* Returns operations to replay.
|
|
28
|
-
*/
|
|
29
|
-
getOperationsToReplay(): Array<Operation>;
|
|
30
|
-
/**
|
|
31
|
-
* Applies all operations with a delay between actions.
|
|
32
|
-
*
|
|
33
|
-
* @param timeInterval Time between applying operations.
|
|
34
|
-
*/
|
|
35
|
-
play(timeInterval?: number): Promise<void>;
|
|
36
|
-
/**
|
|
37
|
-
* Applies `numberOfOperations` operations, beginning after the last applied operation (or first, if no operations were applied).
|
|
38
|
-
*
|
|
39
|
-
* @param numberOfOperations The number of operations to apply.
|
|
40
|
-
*/
|
|
41
|
-
applyOperations(numberOfOperations: number): Promise<void> | undefined;
|
|
42
|
-
/**
|
|
43
|
-
* Applies all operations to replay at once.
|
|
44
|
-
*/
|
|
45
|
-
applyAllOperations(): Promise<void>;
|
|
46
|
-
/**
|
|
47
|
-
* Applies the next operation to replay. Returns a promise with the `isFinished` parameter that is `true` if the last
|
|
48
|
-
* operation in the replayer has been applied, `false` otherwise.
|
|
49
|
-
*/
|
|
50
|
-
applyNextOperation(): Promise<boolean>;
|
|
51
|
-
}
|
|
1
|
+
/**
|
|
2
|
+
* @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
|
|
3
|
+
* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
|
|
4
|
+
*/
|
|
5
|
+
import type Model from '../model/model.js';
|
|
6
|
+
import type Operation from '../model/operation/operation.js';
|
|
7
|
+
/**
|
|
8
|
+
* Operation replayer is a development tool created for easy replaying of operations on the document from stringified operations.
|
|
9
|
+
*/
|
|
10
|
+
export default class OperationReplayer {
|
|
11
|
+
private _model;
|
|
12
|
+
private _logSeparator;
|
|
13
|
+
private _operationsToReplay;
|
|
14
|
+
/**
|
|
15
|
+
* @param model Data model.
|
|
16
|
+
* @param logSeparator Separator between operations.
|
|
17
|
+
* @param stringifiedOperations Operations to replay.
|
|
18
|
+
*/
|
|
19
|
+
constructor(model: Model, logSeparator: string, stringifiedOperations: string);
|
|
20
|
+
/**
|
|
21
|
+
* Parses the given string containing stringified operations and sets parsed operations as operations to replay.
|
|
22
|
+
*
|
|
23
|
+
* @param stringifiedOperations Stringified operations to replay.
|
|
24
|
+
*/
|
|
25
|
+
setStringifiedOperations(stringifiedOperations: string): void;
|
|
26
|
+
/**
|
|
27
|
+
* Returns operations to replay.
|
|
28
|
+
*/
|
|
29
|
+
getOperationsToReplay(): Array<Operation>;
|
|
30
|
+
/**
|
|
31
|
+
* Applies all operations with a delay between actions.
|
|
32
|
+
*
|
|
33
|
+
* @param timeInterval Time between applying operations.
|
|
34
|
+
*/
|
|
35
|
+
play(timeInterval?: number): Promise<void>;
|
|
36
|
+
/**
|
|
37
|
+
* Applies `numberOfOperations` operations, beginning after the last applied operation (or first, if no operations were applied).
|
|
38
|
+
*
|
|
39
|
+
* @param numberOfOperations The number of operations to apply.
|
|
40
|
+
*/
|
|
41
|
+
applyOperations(numberOfOperations: number): Promise<void> | undefined;
|
|
42
|
+
/**
|
|
43
|
+
* Applies all operations to replay at once.
|
|
44
|
+
*/
|
|
45
|
+
applyAllOperations(): Promise<void>;
|
|
46
|
+
/**
|
|
47
|
+
* Applies the next operation to replay. Returns a promise with the `isFinished` parameter that is `true` if the last
|
|
48
|
+
* operation in the replayer has been applied, `false` otherwise.
|
|
49
|
+
*/
|
|
50
|
+
applyNextOperation(): Promise<boolean>;
|
|
51
|
+
}
|
|
@@ -1,112 +1,112 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @license Copyright (c) 2003-2023, 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 engine/dev-utils/operationreplayer
|
|
7
|
-
*/
|
|
8
|
-
/* global setTimeout */
|
|
9
|
-
import OperationFactory from '../model/operation/operationfactory';
|
|
10
|
-
/**
|
|
11
|
-
* Operation replayer is a development tool created for easy replaying of operations on the document from stringified operations.
|
|
12
|
-
*/
|
|
13
|
-
export default class OperationReplayer {
|
|
14
|
-
/**
|
|
15
|
-
* @param model Data model.
|
|
16
|
-
* @param logSeparator Separator between operations.
|
|
17
|
-
* @param stringifiedOperations Operations to replay.
|
|
18
|
-
*/
|
|
19
|
-
constructor(model, logSeparator, stringifiedOperations) {
|
|
20
|
-
this._model = model;
|
|
21
|
-
this._logSeparator = logSeparator;
|
|
22
|
-
this.setStringifiedOperations(stringifiedOperations);
|
|
23
|
-
}
|
|
24
|
-
/**
|
|
25
|
-
* Parses the given string containing stringified operations and sets parsed operations as operations to replay.
|
|
26
|
-
*
|
|
27
|
-
* @param stringifiedOperations Stringified operations to replay.
|
|
28
|
-
*/
|
|
29
|
-
setStringifiedOperations(stringifiedOperations) {
|
|
30
|
-
if (stringifiedOperations === '') {
|
|
31
|
-
this._operationsToReplay = [];
|
|
32
|
-
return;
|
|
33
|
-
}
|
|
34
|
-
this._operationsToReplay = stringifiedOperations
|
|
35
|
-
.split(this._logSeparator)
|
|
36
|
-
.map(stringifiedOperation => JSON.parse(stringifiedOperation));
|
|
37
|
-
}
|
|
38
|
-
/**
|
|
39
|
-
* Returns operations to replay.
|
|
40
|
-
*/
|
|
41
|
-
getOperationsToReplay() {
|
|
42
|
-
return this._operationsToReplay;
|
|
43
|
-
}
|
|
44
|
-
/**
|
|
45
|
-
* Applies all operations with a delay between actions.
|
|
46
|
-
*
|
|
47
|
-
* @param timeInterval Time between applying operations.
|
|
48
|
-
*/
|
|
49
|
-
play(timeInterval = 1000) {
|
|
50
|
-
// eslint-disable-next-line @typescript-eslint/no-this-alias, consistent-this
|
|
51
|
-
const operationReplayer = this;
|
|
52
|
-
return new Promise((res, rej) => {
|
|
53
|
-
play();
|
|
54
|
-
function play() {
|
|
55
|
-
operationReplayer.applyNextOperation().then(isFinished => {
|
|
56
|
-
if (isFinished) {
|
|
57
|
-
return res();
|
|
58
|
-
}
|
|
59
|
-
setTimeout(play, timeInterval);
|
|
60
|
-
}).catch(err => {
|
|
61
|
-
rej(err);
|
|
62
|
-
});
|
|
63
|
-
}
|
|
64
|
-
});
|
|
65
|
-
}
|
|
66
|
-
/**
|
|
67
|
-
* Applies `numberOfOperations` operations, beginning after the last applied operation (or first, if no operations were applied).
|
|
68
|
-
*
|
|
69
|
-
* @param numberOfOperations The number of operations to apply.
|
|
70
|
-
*/
|
|
71
|
-
applyOperations(numberOfOperations) {
|
|
72
|
-
if (numberOfOperations <= 0) {
|
|
73
|
-
return;
|
|
74
|
-
}
|
|
75
|
-
return this.applyNextOperation()
|
|
76
|
-
.then(isFinished => {
|
|
77
|
-
if (!isFinished) {
|
|
78
|
-
return this.applyOperations(numberOfOperations - 1);
|
|
79
|
-
}
|
|
80
|
-
});
|
|
81
|
-
}
|
|
82
|
-
/**
|
|
83
|
-
* Applies all operations to replay at once.
|
|
84
|
-
*/
|
|
85
|
-
applyAllOperations() {
|
|
86
|
-
return this.applyNextOperation()
|
|
87
|
-
.then(isFinished => {
|
|
88
|
-
if (!isFinished) {
|
|
89
|
-
return this.applyAllOperations();
|
|
90
|
-
}
|
|
91
|
-
});
|
|
92
|
-
}
|
|
93
|
-
/**
|
|
94
|
-
* Applies the next operation to replay. Returns a promise with the `isFinished` parameter that is `true` if the last
|
|
95
|
-
* operation in the replayer has been applied, `false` otherwise.
|
|
96
|
-
*/
|
|
97
|
-
applyNextOperation() {
|
|
98
|
-
const model = this._model;
|
|
99
|
-
return new Promise(res => {
|
|
100
|
-
model.enqueueChange(writer => {
|
|
101
|
-
const operationJson = this._operationsToReplay.shift();
|
|
102
|
-
if (!operationJson) {
|
|
103
|
-
return res(true);
|
|
104
|
-
}
|
|
105
|
-
const operation = OperationFactory.fromJSON(operationJson, model.document);
|
|
106
|
-
writer.batch.addOperation(operation);
|
|
107
|
-
model.applyOperation(operation);
|
|
108
|
-
res(false);
|
|
109
|
-
});
|
|
110
|
-
});
|
|
111
|
-
}
|
|
112
|
-
}
|
|
1
|
+
/**
|
|
2
|
+
* @license Copyright (c) 2003-2023, 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 engine/dev-utils/operationreplayer
|
|
7
|
+
*/
|
|
8
|
+
/* global setTimeout */
|
|
9
|
+
import OperationFactory from '../model/operation/operationfactory.js';
|
|
10
|
+
/**
|
|
11
|
+
* Operation replayer is a development tool created for easy replaying of operations on the document from stringified operations.
|
|
12
|
+
*/
|
|
13
|
+
export default class OperationReplayer {
|
|
14
|
+
/**
|
|
15
|
+
* @param model Data model.
|
|
16
|
+
* @param logSeparator Separator between operations.
|
|
17
|
+
* @param stringifiedOperations Operations to replay.
|
|
18
|
+
*/
|
|
19
|
+
constructor(model, logSeparator, stringifiedOperations) {
|
|
20
|
+
this._model = model;
|
|
21
|
+
this._logSeparator = logSeparator;
|
|
22
|
+
this.setStringifiedOperations(stringifiedOperations);
|
|
23
|
+
}
|
|
24
|
+
/**
|
|
25
|
+
* Parses the given string containing stringified operations and sets parsed operations as operations to replay.
|
|
26
|
+
*
|
|
27
|
+
* @param stringifiedOperations Stringified operations to replay.
|
|
28
|
+
*/
|
|
29
|
+
setStringifiedOperations(stringifiedOperations) {
|
|
30
|
+
if (stringifiedOperations === '') {
|
|
31
|
+
this._operationsToReplay = [];
|
|
32
|
+
return;
|
|
33
|
+
}
|
|
34
|
+
this._operationsToReplay = stringifiedOperations
|
|
35
|
+
.split(this._logSeparator)
|
|
36
|
+
.map(stringifiedOperation => JSON.parse(stringifiedOperation));
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
* Returns operations to replay.
|
|
40
|
+
*/
|
|
41
|
+
getOperationsToReplay() {
|
|
42
|
+
return this._operationsToReplay;
|
|
43
|
+
}
|
|
44
|
+
/**
|
|
45
|
+
* Applies all operations with a delay between actions.
|
|
46
|
+
*
|
|
47
|
+
* @param timeInterval Time between applying operations.
|
|
48
|
+
*/
|
|
49
|
+
play(timeInterval = 1000) {
|
|
50
|
+
// eslint-disable-next-line @typescript-eslint/no-this-alias, consistent-this
|
|
51
|
+
const operationReplayer = this;
|
|
52
|
+
return new Promise((res, rej) => {
|
|
53
|
+
play();
|
|
54
|
+
function play() {
|
|
55
|
+
operationReplayer.applyNextOperation().then(isFinished => {
|
|
56
|
+
if (isFinished) {
|
|
57
|
+
return res();
|
|
58
|
+
}
|
|
59
|
+
setTimeout(play, timeInterval);
|
|
60
|
+
}).catch(err => {
|
|
61
|
+
rej(err);
|
|
62
|
+
});
|
|
63
|
+
}
|
|
64
|
+
});
|
|
65
|
+
}
|
|
66
|
+
/**
|
|
67
|
+
* Applies `numberOfOperations` operations, beginning after the last applied operation (or first, if no operations were applied).
|
|
68
|
+
*
|
|
69
|
+
* @param numberOfOperations The number of operations to apply.
|
|
70
|
+
*/
|
|
71
|
+
applyOperations(numberOfOperations) {
|
|
72
|
+
if (numberOfOperations <= 0) {
|
|
73
|
+
return;
|
|
74
|
+
}
|
|
75
|
+
return this.applyNextOperation()
|
|
76
|
+
.then(isFinished => {
|
|
77
|
+
if (!isFinished) {
|
|
78
|
+
return this.applyOperations(numberOfOperations - 1);
|
|
79
|
+
}
|
|
80
|
+
});
|
|
81
|
+
}
|
|
82
|
+
/**
|
|
83
|
+
* Applies all operations to replay at once.
|
|
84
|
+
*/
|
|
85
|
+
applyAllOperations() {
|
|
86
|
+
return this.applyNextOperation()
|
|
87
|
+
.then(isFinished => {
|
|
88
|
+
if (!isFinished) {
|
|
89
|
+
return this.applyAllOperations();
|
|
90
|
+
}
|
|
91
|
+
});
|
|
92
|
+
}
|
|
93
|
+
/**
|
|
94
|
+
* Applies the next operation to replay. Returns a promise with the `isFinished` parameter that is `true` if the last
|
|
95
|
+
* operation in the replayer has been applied, `false` otherwise.
|
|
96
|
+
*/
|
|
97
|
+
applyNextOperation() {
|
|
98
|
+
const model = this._model;
|
|
99
|
+
return new Promise(res => {
|
|
100
|
+
model.enqueueChange(writer => {
|
|
101
|
+
const operationJson = this._operationsToReplay.shift();
|
|
102
|
+
if (!operationJson) {
|
|
103
|
+
return res(true);
|
|
104
|
+
}
|
|
105
|
+
const operation = OperationFactory.fromJSON(operationJson, model.document);
|
|
106
|
+
writer.batch.addOperation(operation);
|
|
107
|
+
model.applyOperation(operation);
|
|
108
|
+
res(false);
|
|
109
|
+
});
|
|
110
|
+
});
|
|
111
|
+
}
|
|
112
|
+
}
|
package/src/dev-utils/utils.d.ts
CHANGED
|
@@ -1,37 +1,37 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @license Copyright (c) 2003-2023, 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
|
-
* Note: This package is used only internally for debugging purposes and should not be used
|
|
7
|
-
* in other environments. It uses a few special methods not existing in the default
|
|
8
|
-
* building process. That is also why there are no tests for this file.
|
|
9
|
-
*
|
|
10
|
-
* @module engine/dev-utils/utils
|
|
11
|
-
*/
|
|
12
|
-
/**
|
|
13
|
-
* Helper function, converts a map to the 'key1="value1" key2="value1"' format.
|
|
14
|
-
*
|
|
15
|
-
* @param map Map to convert.
|
|
16
|
-
* @returns Converted map.
|
|
17
|
-
*/
|
|
18
|
-
export declare function convertMapToTags(map: Iterable<[string, unknown]>): string;
|
|
19
|
-
/**
|
|
20
|
-
* Helper function, converts a map to the `{"key1":"value1","key2":"value2"}` format.
|
|
21
|
-
*
|
|
22
|
-
* @param map Map to convert.
|
|
23
|
-
* @returns Converted map.
|
|
24
|
-
*/
|
|
25
|
-
export declare function convertMapToStringifiedObject(map: Iterable<[string, unknown]>): string;
|
|
26
|
-
/**
|
|
27
|
-
* Helper function that stores the `document` state for a given `version`.
|
|
28
|
-
*/
|
|
29
|
-
export declare function dumpTrees(document: any, version: any): void;
|
|
30
|
-
/**
|
|
31
|
-
* Helper function that initializes document dumping.
|
|
32
|
-
*/
|
|
33
|
-
export declare function initDocumentDumping(document: any): void;
|
|
34
|
-
/**
|
|
35
|
-
* Helper function that logs document for the given version.
|
|
36
|
-
*/
|
|
37
|
-
export declare function logDocument(document: any, version: any): void;
|
|
1
|
+
/**
|
|
2
|
+
* @license Copyright (c) 2003-2023, 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
|
+
* Note: This package is used only internally for debugging purposes and should not be used
|
|
7
|
+
* in other environments. It uses a few special methods not existing in the default
|
|
8
|
+
* building process. That is also why there are no tests for this file.
|
|
9
|
+
*
|
|
10
|
+
* @module engine/dev-utils/utils
|
|
11
|
+
*/
|
|
12
|
+
/**
|
|
13
|
+
* Helper function, converts a map to the 'key1="value1" key2="value1"' format.
|
|
14
|
+
*
|
|
15
|
+
* @param map Map to convert.
|
|
16
|
+
* @returns Converted map.
|
|
17
|
+
*/
|
|
18
|
+
export declare function convertMapToTags(map: Iterable<[string, unknown]>): string;
|
|
19
|
+
/**
|
|
20
|
+
* Helper function, converts a map to the `{"key1":"value1","key2":"value2"}` format.
|
|
21
|
+
*
|
|
22
|
+
* @param map Map to convert.
|
|
23
|
+
* @returns Converted map.
|
|
24
|
+
*/
|
|
25
|
+
export declare function convertMapToStringifiedObject(map: Iterable<[string, unknown]>): string;
|
|
26
|
+
/**
|
|
27
|
+
* Helper function that stores the `document` state for a given `version`.
|
|
28
|
+
*/
|
|
29
|
+
export declare function dumpTrees(document: any, version: any): void;
|
|
30
|
+
/**
|
|
31
|
+
* Helper function that initializes document dumping.
|
|
32
|
+
*/
|
|
33
|
+
export declare function initDocumentDumping(document: any): void;
|
|
34
|
+
/**
|
|
35
|
+
* Helper function that logs document for the given version.
|
|
36
|
+
*/
|
|
37
|
+
export declare function logDocument(document: any, version: any): void;
|
package/src/dev-utils/utils.js
CHANGED
|
@@ -1,73 +1,73 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @license Copyright (c) 2003-2023, 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
|
-
* Note: This package is used only internally for debugging purposes and should not be used
|
|
7
|
-
* in other environments. It uses a few special methods not existing in the default
|
|
8
|
-
* building process. That is also why there are no tests for this file.
|
|
9
|
-
*
|
|
10
|
-
* @module engine/dev-utils/utils
|
|
11
|
-
*/
|
|
12
|
-
/* globals console */
|
|
13
|
-
/**
|
|
14
|
-
* Helper function, converts a map to the 'key1="value1" key2="value1"' format.
|
|
15
|
-
*
|
|
16
|
-
* @param map Map to convert.
|
|
17
|
-
* @returns Converted map.
|
|
18
|
-
*/
|
|
19
|
-
export function convertMapToTags(map) {
|
|
20
|
-
let string = '';
|
|
21
|
-
for (const entry of map) {
|
|
22
|
-
string += ` ${entry[0]}=${JSON.stringify(entry[1])}`;
|
|
23
|
-
}
|
|
24
|
-
return string;
|
|
25
|
-
}
|
|
26
|
-
/**
|
|
27
|
-
* Helper function, converts a map to the `{"key1":"value1","key2":"value2"}` format.
|
|
28
|
-
*
|
|
29
|
-
* @param map Map to convert.
|
|
30
|
-
* @returns Converted map.
|
|
31
|
-
*/
|
|
32
|
-
export function convertMapToStringifiedObject(map) {
|
|
33
|
-
const obj = {};
|
|
34
|
-
for (const entry of map) {
|
|
35
|
-
obj[entry[0]] = entry[1];
|
|
36
|
-
}
|
|
37
|
-
return JSON.stringify(obj);
|
|
38
|
-
}
|
|
39
|
-
const treeDump = Symbol('_treeDump');
|
|
40
|
-
const maxTreeDumpLength = 20;
|
|
41
|
-
/**
|
|
42
|
-
* Helper function that stores the `document` state for a given `version`.
|
|
43
|
-
*/
|
|
44
|
-
export function dumpTrees(document, version) {
|
|
45
|
-
console.log(document, version);
|
|
46
|
-
let string = '';
|
|
47
|
-
for (const root of document.roots) {
|
|
48
|
-
string += root.printTree() + '\n';
|
|
49
|
-
}
|
|
50
|
-
document[treeDump][version] = string.substr(0, string.length - 1); // Remove the last "\n".
|
|
51
|
-
const overflow = document[treeDump].length - maxTreeDumpLength;
|
|
52
|
-
if (overflow > 0) {
|
|
53
|
-
document[treeDump][overflow - 1] = null;
|
|
54
|
-
}
|
|
55
|
-
}
|
|
56
|
-
/**
|
|
57
|
-
* Helper function that initializes document dumping.
|
|
58
|
-
*/
|
|
59
|
-
export function initDocumentDumping(document) {
|
|
60
|
-
document[treeDump] = [];
|
|
61
|
-
}
|
|
62
|
-
/**
|
|
63
|
-
* Helper function that logs document for the given version.
|
|
64
|
-
*/
|
|
65
|
-
export function logDocument(document, version) {
|
|
66
|
-
console.log('--------------------');
|
|
67
|
-
if (document[treeDump][version]) {
|
|
68
|
-
console.log(document[treeDump][version]);
|
|
69
|
-
}
|
|
70
|
-
else {
|
|
71
|
-
console.log('Tree log unavailable for given version: ' + version);
|
|
72
|
-
}
|
|
73
|
-
}
|
|
1
|
+
/**
|
|
2
|
+
* @license Copyright (c) 2003-2023, 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
|
+
* Note: This package is used only internally for debugging purposes and should not be used
|
|
7
|
+
* in other environments. It uses a few special methods not existing in the default
|
|
8
|
+
* building process. That is also why there are no tests for this file.
|
|
9
|
+
*
|
|
10
|
+
* @module engine/dev-utils/utils
|
|
11
|
+
*/
|
|
12
|
+
/* globals console */
|
|
13
|
+
/**
|
|
14
|
+
* Helper function, converts a map to the 'key1="value1" key2="value1"' format.
|
|
15
|
+
*
|
|
16
|
+
* @param map Map to convert.
|
|
17
|
+
* @returns Converted map.
|
|
18
|
+
*/
|
|
19
|
+
export function convertMapToTags(map) {
|
|
20
|
+
let string = '';
|
|
21
|
+
for (const entry of map) {
|
|
22
|
+
string += ` ${entry[0]}=${JSON.stringify(entry[1])}`;
|
|
23
|
+
}
|
|
24
|
+
return string;
|
|
25
|
+
}
|
|
26
|
+
/**
|
|
27
|
+
* Helper function, converts a map to the `{"key1":"value1","key2":"value2"}` format.
|
|
28
|
+
*
|
|
29
|
+
* @param map Map to convert.
|
|
30
|
+
* @returns Converted map.
|
|
31
|
+
*/
|
|
32
|
+
export function convertMapToStringifiedObject(map) {
|
|
33
|
+
const obj = {};
|
|
34
|
+
for (const entry of map) {
|
|
35
|
+
obj[entry[0]] = entry[1];
|
|
36
|
+
}
|
|
37
|
+
return JSON.stringify(obj);
|
|
38
|
+
}
|
|
39
|
+
const treeDump = Symbol('_treeDump');
|
|
40
|
+
const maxTreeDumpLength = 20;
|
|
41
|
+
/**
|
|
42
|
+
* Helper function that stores the `document` state for a given `version`.
|
|
43
|
+
*/
|
|
44
|
+
export function dumpTrees(document, version) {
|
|
45
|
+
console.log(document, version);
|
|
46
|
+
let string = '';
|
|
47
|
+
for (const root of document.roots) {
|
|
48
|
+
string += root.printTree() + '\n';
|
|
49
|
+
}
|
|
50
|
+
document[treeDump][version] = string.substr(0, string.length - 1); // Remove the last "\n".
|
|
51
|
+
const overflow = document[treeDump].length - maxTreeDumpLength;
|
|
52
|
+
if (overflow > 0) {
|
|
53
|
+
document[treeDump][overflow - 1] = null;
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
/**
|
|
57
|
+
* Helper function that initializes document dumping.
|
|
58
|
+
*/
|
|
59
|
+
export function initDocumentDumping(document) {
|
|
60
|
+
document[treeDump] = [];
|
|
61
|
+
}
|
|
62
|
+
/**
|
|
63
|
+
* Helper function that logs document for the given version.
|
|
64
|
+
*/
|
|
65
|
+
export function logDocument(document, version) {
|
|
66
|
+
console.log('--------------------');
|
|
67
|
+
if (document[treeDump][version]) {
|
|
68
|
+
console.log(document[treeDump][version]);
|
|
69
|
+
}
|
|
70
|
+
else {
|
|
71
|
+
console.log('Tree log unavailable for given version: ' + version);
|
|
72
|
+
}
|
|
73
|
+
}
|