@ckeditor/ckeditor5-engine 48.2.0 → 48.3.0-alpha.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 (129) hide show
  1. package/dist/controller/datacontroller.d.ts +329 -328
  2. package/dist/controller/editingcontroller.d.ts +95 -94
  3. package/dist/conversion/comparemarkers.d.ts +45 -45
  4. package/dist/conversion/conversion.d.ts +474 -474
  5. package/dist/conversion/conversionhelpers.d.ts +21 -21
  6. package/dist/conversion/downcastdispatcher.d.ts +539 -538
  7. package/dist/conversion/downcasthelpers.d.ts +1129 -1129
  8. package/dist/conversion/mapper.d.ts +692 -697
  9. package/dist/conversion/modelconsumable.d.ts +196 -196
  10. package/dist/conversion/upcastdispatcher.d.ts +483 -482
  11. package/dist/conversion/upcasthelpers.d.ts +491 -491
  12. package/dist/conversion/viewconsumable.d.ts +330 -330
  13. package/dist/dataprocessor/basichtmlwriter.d.ts +15 -15
  14. package/dist/dataprocessor/dataprocessor.d.ts +57 -57
  15. package/dist/dataprocessor/htmldataprocessor.d.ts +72 -72
  16. package/dist/dataprocessor/htmlwriter.d.ts +11 -11
  17. package/dist/dataprocessor/xmldataprocessor.d.ts +86 -86
  18. package/dist/dev-utils/model.d.ts +128 -123
  19. package/dist/dev-utils/operationreplayer.d.ts +49 -49
  20. package/dist/dev-utils/utils.d.ts +33 -33
  21. package/dist/dev-utils/view.d.ts +314 -309
  22. package/dist/engineconfig.d.ts +39 -39
  23. package/dist/index.css.map +1 -1
  24. package/dist/index.d.ts +150 -150
  25. package/dist/index.js +34026 -40107
  26. package/dist/index.js.map +1 -1
  27. package/dist/legacyerrors.d.ts +0 -4
  28. package/dist/model/batch.d.ts +86 -86
  29. package/dist/model/differ.d.ts +504 -504
  30. package/dist/model/document.d.ts +265 -268
  31. package/dist/model/documentfragment.d.ts +214 -214
  32. package/dist/model/documentselection.d.ts +406 -410
  33. package/dist/model/element.d.ts +182 -182
  34. package/dist/model/history.d.ts +109 -109
  35. package/dist/model/item.d.ts +9 -9
  36. package/dist/model/liveposition.d.ts +70 -69
  37. package/dist/model/liverange.d.ts +93 -92
  38. package/dist/model/markercollection.d.ts +317 -324
  39. package/dist/model/model.d.ts +889 -909
  40. package/dist/model/node.d.ts +254 -254
  41. package/dist/model/nodelist.d.ts +110 -110
  42. package/dist/model/operation/attributeoperation.d.ts +98 -98
  43. package/dist/model/operation/detachoperation.d.ts +57 -57
  44. package/dist/model/operation/insertoperation.d.ts +85 -85
  45. package/dist/model/operation/markeroperation.d.ts +87 -87
  46. package/dist/model/operation/mergeoperation.d.ts +95 -95
  47. package/dist/model/operation/moveoperation.d.ts +97 -97
  48. package/dist/model/operation/nooperation.d.ts +33 -33
  49. package/dist/model/operation/operation.d.ts +94 -94
  50. package/dist/model/operation/operationfactory.d.ts +14 -14
  51. package/dist/model/operation/renameoperation.d.ts +78 -78
  52. package/dist/model/operation/rootattributeoperation.d.ts +93 -93
  53. package/dist/model/operation/rootoperation.d.ts +71 -71
  54. package/dist/model/operation/splitoperation.d.ts +104 -104
  55. package/dist/model/operation/transform.d.ts +91 -91
  56. package/dist/model/operation/utils.d.ts +58 -58
  57. package/dist/model/position.d.ts +535 -535
  58. package/dist/model/range.d.ts +458 -453
  59. package/dist/model/rootelement.d.ts +55 -55
  60. package/dist/model/schema.d.ts +1325 -1327
  61. package/dist/model/selection.d.ts +452 -471
  62. package/dist/model/text.d.ts +62 -62
  63. package/dist/model/textproxy.d.ts +140 -140
  64. package/dist/model/treewalker.d.ts +190 -190
  65. package/dist/model/typecheckable.d.ts +281 -281
  66. package/dist/model/utils/autoparagraphing.d.ts +29 -29
  67. package/dist/model/utils/deletecontent.d.ts +68 -68
  68. package/dist/model/utils/getselectedcontent.d.ts +27 -27
  69. package/dist/model/utils/insertcontent.d.ts +42 -42
  70. package/dist/model/utils/insertobject.d.ts +41 -41
  71. package/dist/model/utils/modifyselection.d.ts +44 -44
  72. package/dist/model/utils/selection-post-fixer.d.ts +71 -71
  73. package/dist/model/writer.d.ts +854 -854
  74. package/dist/view/attributeelement.d.ts +123 -123
  75. package/dist/view/containerelement.d.ts +49 -49
  76. package/dist/view/datatransfer.d.ts +70 -70
  77. package/dist/view/document.d.ts +175 -177
  78. package/dist/view/documentfragment.d.ts +158 -157
  79. package/dist/view/documentselection.d.ts +308 -307
  80. package/dist/view/domconverter.d.ts +612 -657
  81. package/dist/view/downcastwriter.d.ts +1006 -1006
  82. package/dist/view/editableelement.d.ts +64 -63
  83. package/dist/view/element.d.ts +754 -754
  84. package/dist/view/elementdefinition.d.ts +79 -79
  85. package/dist/view/emptyelement.d.ts +42 -42
  86. package/dist/view/filler.d.ts +75 -75
  87. package/dist/view/item.d.ts +9 -9
  88. package/dist/view/matcher.d.ts +412 -487
  89. package/dist/view/node.d.ts +164 -163
  90. package/dist/view/observer/arrowkeysobserver.d.ts +37 -37
  91. package/dist/view/observer/bubblingemittermixin.d.ts +163 -153
  92. package/dist/view/observer/bubblingeventinfo.d.ts +45 -42
  93. package/dist/view/observer/clickobserver.d.ts +36 -36
  94. package/dist/view/observer/compositionobserver.d.ts +67 -67
  95. package/dist/view/observer/domeventdata.d.ts +46 -46
  96. package/dist/view/observer/domeventobserver.d.ts +77 -74
  97. package/dist/view/observer/fakeselectionobserver.d.ts +42 -42
  98. package/dist/view/observer/focusobserver.d.ts +84 -84
  99. package/dist/view/observer/inputobserver.d.ts +76 -76
  100. package/dist/view/observer/keyobserver.d.ts +53 -53
  101. package/dist/view/observer/mouseobserver.d.ts +73 -73
  102. package/dist/view/observer/mutationobserver.d.ts +101 -101
  103. package/dist/view/observer/observer.d.ts +84 -83
  104. package/dist/view/observer/pointerobserver.d.ts +63 -63
  105. package/dist/view/observer/selectionobserver.d.ts +136 -136
  106. package/dist/view/observer/tabobserver.d.ts +38 -38
  107. package/dist/view/observer/touchobserver.d.ts +60 -60
  108. package/dist/view/placeholder.d.ts +80 -80
  109. package/dist/view/position.d.ts +187 -187
  110. package/dist/view/range.d.ts +282 -282
  111. package/dist/view/rawelement.d.ts +72 -72
  112. package/dist/view/renderer.d.ts +270 -272
  113. package/dist/view/rooteditableelement.d.ts +43 -43
  114. package/dist/view/selection.d.ts +356 -369
  115. package/dist/view/styles/background.d.ts +15 -15
  116. package/dist/view/styles/border.d.ts +27 -27
  117. package/dist/view/styles/margin.d.ts +12 -12
  118. package/dist/view/styles/padding.d.ts +12 -12
  119. package/dist/view/styles/utils.d.ts +72 -72
  120. package/dist/view/stylesmap.d.ts +715 -715
  121. package/dist/view/text.d.ts +75 -75
  122. package/dist/view/textproxy.d.ts +92 -92
  123. package/dist/view/tokenlist.d.ts +104 -104
  124. package/dist/view/treewalker.d.ts +201 -201
  125. package/dist/view/typecheckable.d.ts +445 -445
  126. package/dist/view/uielement.d.ts +93 -93
  127. package/dist/view/upcastwriter.d.ts +412 -412
  128. package/dist/view/view.d.ts +466 -469
  129. package/package.json +2 -2
@@ -1,18 +1,18 @@
1
1
  /**
2
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
3
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
4
- */
5
- import type { StylesProcessor } from '../stylesmap.js';
2
+ * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
3
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
4
+ */
5
+ import type { StylesProcessor } from "../stylesmap.js";
6
6
  /**
7
- * Adds background CSS styles processing rules to the given `StylesProcessor`.
8
- *
9
- * Registers normalizers for the `background` shorthand and its longhand properties,
10
- * reducers that serialize them back to CSS strings, and the relation mapping between them.
11
- *
12
- * ```ts
13
- * editor.data.addStyleProcessorRules( addBackgroundStylesRules );
14
- * ```
15
- *
16
- * @param stylesProcessor The styles processor instance to register rules on.
17
- */
7
+ * Adds background CSS styles processing rules to the given `StylesProcessor`.
8
+ *
9
+ * Registers normalizers for the `background` shorthand and its longhand properties,
10
+ * reducers that serialize them back to CSS strings, and the relation mapping between them.
11
+ *
12
+ * ```ts
13
+ * editor.data.addStyleProcessorRules( addBackgroundStylesRules );
14
+ * ```
15
+ *
16
+ * @param stylesProcessor The styles processor instance to register rules on.
17
+ */
18
18
  export declare function addBackgroundStylesRules(stylesProcessor: StylesProcessor): void;
@@ -1,31 +1,31 @@
1
1
  /**
2
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
3
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
4
- */
2
+ * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
3
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
4
+ */
5
5
  /**
6
- * @module engine/view/styles/border
7
- */
8
- import type { StylesProcessor } from '../stylesmap.js';
6
+ * @module engine/view/styles/border
7
+ */
8
+ import type { StylesProcessor } from "../stylesmap.js";
9
9
  /**
10
- * Adds a border CSS styles processing rules.
11
- *
12
- * ```ts
13
- * editor.data.addStyleProcessorRules( addBorderStylesRules );
14
- * ```
15
- *
16
- * This rules merges all [border](https://developer.mozilla.org/en-US/docs/Web/CSS/border) styles notation shorthands:
17
- *
18
- * - border
19
- * - border-top
20
- * - border-right
21
- * - border-bottom
22
- * - border-left
23
- * - border-color
24
- * - border-style
25
- * - border-width
26
- *
27
- * and all corresponding longhand forms (like `border-top-color`, `border-top-style`, etc).
28
- *
29
- * It does not handle other shorthands (like `border-radius` or `border-image`).
30
- */
10
+ * Adds a border CSS styles processing rules.
11
+ *
12
+ * ```ts
13
+ * editor.data.addStyleProcessorRules( addBorderStylesRules );
14
+ * ```
15
+ *
16
+ * This rules merges all [border](https://developer.mozilla.org/en-US/docs/Web/CSS/border) styles notation shorthands:
17
+ *
18
+ * - border
19
+ * - border-top
20
+ * - border-right
21
+ * - border-bottom
22
+ * - border-left
23
+ * - border-color
24
+ * - border-style
25
+ * - border-width
26
+ *
27
+ * and all corresponding longhand forms (like `border-top-color`, `border-top-style`, etc).
28
+ *
29
+ * It does not handle other shorthands (like `border-radius` or `border-image`).
30
+ */
31
31
  export declare function addBorderStylesRules(stylesProcessor: StylesProcessor): void;
@@ -1,16 +1,16 @@
1
1
  /**
2
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
3
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
4
- */
2
+ * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
3
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
4
+ */
5
5
  /**
6
- * @module engine/view/styles/margin
7
- */
8
- import type { StylesProcessor } from '../stylesmap.js';
6
+ * @module engine/view/styles/margin
7
+ */
8
+ import type { StylesProcessor } from "../stylesmap.js";
9
9
  /**
10
- * Adds a margin CSS styles processing rules.
11
- *
12
- * ```ts
13
- * editor.data.addStyleProcessorRules( addMarginStylesRules );
14
- * ```
15
- */
10
+ * Adds a margin CSS styles processing rules.
11
+ *
12
+ * ```ts
13
+ * editor.data.addStyleProcessorRules( addMarginStylesRules );
14
+ * ```
15
+ */
16
16
  export declare function addMarginStylesRules(stylesProcessor: StylesProcessor): void;
@@ -1,16 +1,16 @@
1
1
  /**
2
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
3
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
4
- */
2
+ * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
3
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
4
+ */
5
5
  /**
6
- * @module engine/view/styles/padding
7
- */
8
- import type { StylesProcessor } from '../stylesmap.js';
6
+ * @module engine/view/styles/padding
7
+ */
8
+ import type { StylesProcessor } from "../stylesmap.js";
9
9
  /**
10
- * Adds a padding CSS styles processing rules.
11
- *
12
- * ```ts
13
- * editor.data.addStyleProcessorRules( addPaddingStylesRules );
14
- * ```
15
- */
10
+ * Adds a padding CSS styles processing rules.
11
+ *
12
+ * ```ts
13
+ * editor.data.addStyleProcessorRules( addPaddingStylesRules );
14
+ * ```
15
+ */
16
16
  export declare function addPaddingStylesRules(stylesProcessor: StylesProcessor): void;
@@ -1,105 +1,105 @@
1
1
  /**
2
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
3
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
4
- */
5
- /**
6
- * @module engine/view/styles/utils
7
- */
8
- import type { BoxStyleSides, StylePropertyDescriptor, StyleValue } from '../stylesmap.js';
9
- /**
10
- * Checks if string contains [color](https://developer.mozilla.org/en-US/docs/Web/CSS/color) CSS value.
11
- *
12
- * ```ts
13
- * isColorStyleValue( '#f00' ); // true
14
- * isColorStyleValue( '#AA00BB33' ); // true
15
- * isColorStyleValue( 'rgb(0, 0, 250)' ); // true
16
- * isColorStyleValue( 'hsla(240, 100%, 50%, .7)' ); // true
17
- * isColorStyleValue( 'deepskyblue' ); // true
18
- * ```
19
- *
20
- * **Note**: It does not support CSS Level 4 whitespace syntax, system colors and radius values for HSL colors.
21
- */
2
+ * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
3
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
4
+ */
5
+ /**
6
+ * @module engine/view/styles/utils
7
+ */
8
+ import type { BoxStyleSides, StylePropertyDescriptor, StyleValue } from "../stylesmap.js";
9
+ /**
10
+ * Checks if string contains [color](https://developer.mozilla.org/en-US/docs/Web/CSS/color) CSS value.
11
+ *
12
+ * ```ts
13
+ * isColorStyleValue( '#f00' ); // true
14
+ * isColorStyleValue( '#AA00BB33' ); // true
15
+ * isColorStyleValue( 'rgb(0, 0, 250)' ); // true
16
+ * isColorStyleValue( 'hsla(240, 100%, 50%, .7)' ); // true
17
+ * isColorStyleValue( 'deepskyblue' ); // true
18
+ * ```
19
+ *
20
+ * **Note**: It does not support CSS Level 4 whitespace syntax, system colors and radius values for HSL colors.
21
+ */
22
22
  export declare function isColorStyleValue(string: string): boolean;
23
23
  /**
24
- * Checks if string contains [line style](https://developer.mozilla.org/en-US/docs/Web/CSS/border-style) CSS value.
25
- */
24
+ * Checks if string contains [line style](https://developer.mozilla.org/en-US/docs/Web/CSS/border-style) CSS value.
25
+ */
26
26
  export declare function isLineStyleValue(string: string): boolean;
27
27
  /**
28
- * Checks if string contains [length](https://developer.mozilla.org/en-US/docs/Web/CSS/length) CSS value.
29
- */
28
+ * Checks if string contains [length](https://developer.mozilla.org/en-US/docs/Web/CSS/length) CSS value.
29
+ */
30
30
  export declare function isLengthStyleValue(string: string): boolean;
31
31
  /**
32
- * Checks if string contains [percentage](https://developer.mozilla.org/en-US/docs/Web/CSS/percentage) CSS value.
33
- */
32
+ * Checks if string contains [percentage](https://developer.mozilla.org/en-US/docs/Web/CSS/percentage) CSS value.
33
+ */
34
34
  export declare function isPercentageStyleValue(string: string): boolean;
35
35
  /**
36
- * Checks if a string is a valid CSS `background-size` value token.
37
- */
36
+ * Checks if a string is a valid CSS `background-size` value token.
37
+ */
38
38
  export declare function isSizeStyleValue(value: string): boolean;
39
39
  /**
40
- * Checks if string contains [background repeat](https://developer.mozilla.org/en-US/docs/Web/CSS/background-repeat) CSS value.
41
- */
40
+ * Checks if string contains [background repeat](https://developer.mozilla.org/en-US/docs/Web/CSS/background-repeat) CSS value.
41
+ */
42
42
  export declare function isRepeatStyleValue(string: string): boolean;
43
43
  /**
44
- * Checks if string contains [background position](https://developer.mozilla.org/en-US/docs/Web/CSS/background-position) CSS value.
45
- */
44
+ * Checks if string contains [background position](https://developer.mozilla.org/en-US/docs/Web/CSS/background-position) CSS value.
45
+ */
46
46
  export declare function isPositionStyleValue(string: string): boolean;
47
47
  /**
48
- * Checks if string contains [background attachment](https://developer.mozilla.org/en-US/docs/Web/CSS/background-attachment) CSS value.
49
- */
48
+ * Checks if string contains [background attachment](https://developer.mozilla.org/en-US/docs/Web/CSS/background-attachment) CSS value.
49
+ */
50
50
  export declare function isAttachmentStyleValue(string: string): boolean;
51
51
  /**
52
- * Checks if string contains [background origin](https://developer.mozilla.org/en-US/docs/Web/CSS/background-origin) CSS value.
53
- */
52
+ * Checks if string contains [background origin](https://developer.mozilla.org/en-US/docs/Web/CSS/background-origin) CSS value.
53
+ */
54
54
  export declare function isOriginStyleValue(string: string): boolean;
55
55
  /**
56
- * Checks if string contains [background clip](https://developer.mozilla.org/en-US/docs/Web/CSS/background-clip) CSS value.
57
- */
56
+ * Checks if string contains [background clip](https://developer.mozilla.org/en-US/docs/Web/CSS/background-clip) CSS value.
57
+ */
58
58
  export declare function isClipStyleValue(string: string): boolean;
59
59
  /**
60
- * Checks if string contains [URL](https://developer.mozilla.org/en-US/docs/Web/CSS/url) CSS value.
61
- */
60
+ * Checks if string contains [URL](https://developer.mozilla.org/en-US/docs/Web/CSS/url) CSS value.
61
+ */
62
62
  export declare function isURLStyleValue(string: string): boolean;
63
63
  /**
64
- * Parses box sides as individual values.
65
- */
64
+ * Parses box sides as individual values.
65
+ */
66
66
  export declare function getBoxSidesStyleValues(value?: string): BoxStyleSides;
67
67
  /**
68
- * Default reducer for CSS properties that concerns edges of a box
69
- * [shorthand](https://developer.mozilla.org/en-US/docs/Web/CSS/Shorthand_properties) notations:
70
- *
71
- * ```ts
72
- * stylesProcessor.setReducer( 'padding', getBoxSidesStyleValueReducer( 'padding' ) );
73
- * ```
74
- */
68
+ * Default reducer for CSS properties that concerns edges of a box
69
+ * [shorthand](https://developer.mozilla.org/en-US/docs/Web/CSS/Shorthand_properties) notations:
70
+ *
71
+ * ```ts
72
+ * stylesProcessor.setReducer( 'padding', getBoxSidesStyleValueReducer( 'padding' ) );
73
+ * ```
74
+ */
75
75
  export declare function getBoxSidesStyleValueReducer(styleShorthand: string): (value: StyleValue) => Array<StylePropertyDescriptor>;
76
76
  /**
77
- * Returns a [shorthand](https://developer.mozilla.org/en-US/docs/Web/CSS/Shorthand_properties) notation
78
- * of a CSS property value.
79
- *
80
- * ```ts
81
- * getBoxSidesStyleShorthandValue( { top: '1px', right: '1px', bottom: '2px', left: '1px' } );
82
- * // will return '1px 1px 2px'
83
- * ```
84
- */
77
+ * Returns a [shorthand](https://developer.mozilla.org/en-US/docs/Web/CSS/Shorthand_properties) notation
78
+ * of a CSS property value.
79
+ *
80
+ * ```ts
81
+ * getBoxSidesStyleShorthandValue( { top: '1px', right: '1px', bottom: '2px', left: '1px' } );
82
+ * // will return '1px 1px 2px'
83
+ * ```
84
+ */
85
85
  export declare function getBoxSidesStyleShorthandValue({ top, right, bottom, left }: BoxStyleSides): string;
86
86
  /**
87
- * Creates a normalizer for a [shorthand](https://developer.mozilla.org/en-US/docs/Web/CSS/Shorthand_properties) 1-to-4 value.
88
- *
89
- * ```ts
90
- * stylesProcessor.setNormalizer( 'margin', getPositionStyleShorthandNormalizer( 'margin' ) );
91
- * ```
92
- */
87
+ * Creates a normalizer for a [shorthand](https://developer.mozilla.org/en-US/docs/Web/CSS/Shorthand_properties) 1-to-4 value.
88
+ *
89
+ * ```ts
90
+ * stylesProcessor.setNormalizer( 'margin', getPositionStyleShorthandNormalizer( 'margin' ) );
91
+ * ```
92
+ */
93
93
  export declare function getPositionStyleShorthandNormalizer(shorthand: string): (value: string) => {
94
- path: string;
95
- value: BoxStyleSides;
94
+ path: string;
95
+ value: BoxStyleSides;
96
96
  };
97
97
  /**
98
- * Parses parts of a 1-to-4 value notation - handles some CSS values with spaces (like RGB()).
99
- *
100
- * ```ts
101
- * getShorthandStylesValues( 'red blue RGB(0, 0, 0)');
102
- * // will return [ 'red', 'blue', 'RGB(0, 0, 0)' ]
103
- * ```
104
- */
98
+ * Parses parts of a 1-to-4 value notation - handles some CSS values with spaces (like RGB()).
99
+ *
100
+ * ```ts
101
+ * getShorthandStylesValues( 'red blue RGB(0, 0, 0)');
102
+ * // will return [ 'red', 'blue', 'RGB(0, 0, 0)' ]
103
+ * ```
104
+ */
105
105
  export declare function getShorthandStylesValues(string: string): Array<string>;