@ckeditor/ckeditor5-email 48.2.0 → 48.3.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 (34) hide show
  1. package/dist/augmentation.d.ts +28 -28
  2. package/dist/emailconfigurationconfig.d.ts +54 -54
  3. package/dist/emailconfigurationhelper.d.ts +53 -53
  4. package/dist/emailconfigurationlogger.d.ts +31 -31
  5. package/dist/emailinlinestylestransformations.d.ts +44 -44
  6. package/dist/index.d.ts +35 -35
  7. package/dist/index.js +1 -1
  8. package/dist/integrations/emptyblock.d.ts +30 -30
  9. package/dist/integrations/exportinlinestyles.d.ts +30 -30
  10. package/dist/integrations/font.d.ts +30 -30
  11. package/dist/integrations/generalhtmlintegration.d.ts +30 -30
  12. package/dist/integrations/highlight.d.ts +30 -30
  13. package/dist/integrations/image.d.ts +30 -30
  14. package/dist/integrations/link.d.ts +30 -30
  15. package/dist/integrations/list.d.ts +30 -30
  16. package/dist/integrations/listmultilevel.d.ts +30 -30
  17. package/dist/integrations/markdown.d.ts +30 -30
  18. package/dist/integrations/mathtype.d.ts +30 -30
  19. package/dist/integrations/mediaembed.d.ts +30 -30
  20. package/dist/integrations/mergefields.d.ts +30 -30
  21. package/dist/integrations/sourceediting.d.ts +30 -30
  22. package/dist/integrations/table.d.ts +30 -30
  23. package/dist/integrations/template.d.ts +30 -30
  24. package/dist/integrations/todolist.d.ts +30 -30
  25. package/dist/integrations/upload.d.ts +30 -30
  26. package/dist/transformations/transformemailaligntoattribute.d.ts +42 -42
  27. package/dist/transformations/transformemailcolumnwidthstocells.d.ts +17 -17
  28. package/dist/transformations/transformemailfigcaptiontodiv.d.ts +9 -9
  29. package/dist/transformations/transformemailfiguretotable.d.ts +55 -55
  30. package/dist/transformations/transformemailfloattoalign.d.ts +13 -13
  31. package/dist/transformations/transformemailimagewidthattributes.d.ts +13 -13
  32. package/dist/transformations/transformemailmargintoalign.d.ts +19 -19
  33. package/dist/transformations/utils.d.ts +87 -87
  34. package/package.json +10 -10
@@ -1,107 +1,107 @@
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 email/transformations/utils
7
- */
8
- import type { StylesMap } from '@ckeditor/ckeditor5-engine';
6
+ * @module email/transformations/utils
7
+ */
8
+ import type { StylesMap } from "@ckeditor/ckeditor5-engine";
9
9
  /**
10
- * Helper function that creates the wrapper table structure and performs DOM replacement.
11
- *
12
- * @param element The original element being transformed (and replaced in the DOM).
13
- * @param options An object with wrapper configuration.
14
- * @param options.align The alignment value ('left', 'right', 'center') or undefined.
15
- * @param options.width The width value or undefined.
16
- * @returns Inner cell.
17
- */
10
+ * Helper function that creates the wrapper table structure and performs DOM replacement.
11
+ *
12
+ * @param element The original element being transformed (and replaced in the DOM).
13
+ * @param options An object with wrapper configuration.
14
+ * @param options.align The alignment value ('left', 'right', 'center') or undefined.
15
+ * @param options.width The width value or undefined.
16
+ * @returns Inner cell.
17
+ */
18
18
  export declare function wrapWithFallbackTables(element: Element, options: {
19
- align?: string;
20
- width?: string;
19
+ align?: string;
20
+ width?: string;
21
21
  }): HTMLElement;
22
22
  /**
23
- * Creates a wrapper table with a single cell for email compatibility.
24
- *
25
- * @param doc The document object to create elements.
26
- * @param width The width attribute value for the table.
27
- * @returns An object containing the table element and the cell element.
28
- */
23
+ * Creates a wrapper table with a single cell for email compatibility.
24
+ *
25
+ * @param doc The document object to create elements.
26
+ * @param width The width attribute value for the table.
27
+ * @returns An object containing the table element and the cell element.
28
+ */
29
29
  export declare function createWrapperTable(doc: Document, width?: string): {
30
- table: HTMLTableElement;
31
- cell: HTMLTableCellElement;
30
+ table: HTMLTableElement;
31
+ cell: HTMLTableCellElement;
32
32
  };
33
33
  /**
34
- * Determines alignment based on margin-left and margin-right styles.
35
- *
36
- * @param stylesMap A map of CSS styles applied to an element.
37
- * @returns The alignment value ('left', 'right', 'center') or `undefined` if no alignment is determined.
38
- */
34
+ * Determines alignment based on margin-left and margin-right styles.
35
+ *
36
+ * @param stylesMap A map of CSS styles applied to an element.
37
+ * @returns The alignment value ('left', 'right', 'center') or `undefined` if no alignment is determined.
38
+ */
39
39
  export declare function getAlignFromMargins(stylesMap: StylesMap): string | undefined;
40
40
  /**
41
- * Creates a new element with the specified tag name, copying attributes and children from the source element.
42
- *
43
- * @param element The source element.
44
- * @param newTagName The tag name for the new element.
45
- * @returns The new element with copied attributes and children.
46
- */
41
+ * Creates a new element with the specified tag name, copying attributes and children from the source element.
42
+ *
43
+ * @param element The source element.
44
+ * @param newTagName The tag name for the new element.
45
+ * @returns The new element with copied attributes and children.
46
+ */
47
47
  export declare function shallowCloneHTMLElement(element: Element, newTagName: string): HTMLElement;
48
48
  /**
49
- * Checks whether an element is a presentation wrapper table produced by {@link wrapWithFallbackTables}.
50
- *
51
- * The function matches the exact shape that `createWrapperTable` builds:
52
- * - `<table role="presentation" width="…">` with a single `tbody > tr > td` path, where
53
- * - the `<td>` carries an `align` attribute.
54
- *
55
- * A wrapper table without `align` on its cell (e.g. a pure-width inner table) is **not** considered
56
- * an align-wrapper and returns `false`.
57
- *
58
- * ```ts
59
- * // true – outer align table (width="100%", td[align="center"])
60
- * isAlignWrapperTable( outerTable );
61
- *
62
- * // false – inner width table has no align on its td
63
- * isAlignWrapperTable( innerTable );
64
- *
65
- * // false – ordinary content table
66
- * isAlignWrapperTable( contentTable );
67
- * ```
68
- *
69
- * @param element The element to test.
70
- * @returns `true` when the element is an align wrapper table.
71
- */
49
+ * Checks whether an element is a presentation wrapper table produced by {@link wrapWithFallbackTables}.
50
+ *
51
+ * The function matches the exact shape that `createWrapperTable` builds:
52
+ * - `<table role="presentation" width="…">` with a single `tbody > tr > td` path, where
53
+ * - the `<td>` carries an `align` attribute.
54
+ *
55
+ * A wrapper table without `align` on its cell (e.g. a pure-width inner table) is **not** considered
56
+ * an align-wrapper and returns `false`.
57
+ *
58
+ * ```ts
59
+ * // true – outer align table (width="100%", td[align="center"])
60
+ * isAlignWrapperTable( outerTable );
61
+ *
62
+ * // false – inner width table has no align on its td
63
+ * isAlignWrapperTable( innerTable );
64
+ *
65
+ * // false – ordinary content table
66
+ * isAlignWrapperTable( contentTable );
67
+ * ```
68
+ *
69
+ * @param element The element to test.
70
+ * @returns `true` when the element is an align wrapper table.
71
+ */
72
72
  export declare function isAlignWrapperTable(element: Element): boolean;
73
73
  /**
74
- * Returns the single `<td>` from a presentation wrapper table, or `null` when the structure
75
- * does not match the `table > tbody > tr > td` shape produced by {@link wrapWithFallbackTables}.
76
- *
77
- * Use this together with {@link isAlignWrapperTable} to read or mutate the wrapper cell:
78
- *
79
- * ```ts
80
- * if ( isAlignWrapperTable( table ) ) {
81
- * const cell = getWrapperTableCell( table )!;
82
- * const align = cell.getAttribute( 'align' ); // 'left' | 'right' | 'center'
83
- * // …replace the wrapper table with its cell's children:
84
- * table.replaceWith( ...Array.from( cell.childNodes ) );
85
- * }
86
- * ```
87
- *
88
- * @param table The table element to inspect.
89
- * @returns The inner `<td>` element, or `null` if the structure does not match.
90
- */
74
+ * Returns the single `<td>` from a presentation wrapper table, or `null` when the structure
75
+ * does not match the `table > tbody > tr > td` shape produced by {@link wrapWithFallbackTables}.
76
+ *
77
+ * Use this together with {@link isAlignWrapperTable} to read or mutate the wrapper cell:
78
+ *
79
+ * ```ts
80
+ * if ( isAlignWrapperTable( table ) ) {
81
+ * const cell = getWrapperTableCell( table )!;
82
+ * const align = cell.getAttribute( 'align' ); // 'left' | 'right' | 'center'
83
+ * // …replace the wrapper table with its cell's children:
84
+ * table.replaceWith( ...Array.from( cell.childNodes ) );
85
+ * }
86
+ * ```
87
+ *
88
+ * @param table The table element to inspect.
89
+ * @returns The inner `<td>` element, or `null` if the structure does not match.
90
+ */
91
91
  export declare function getWrapperTableCell(table: Element): HTMLTableCellElement | null;
92
92
  /**
93
- * Normalizes legacy numeric attribute values.
94
- * Removes the `!important` suffix (if present) and the `px` unit.
95
- *
96
- * @param value - The attribute value to normalize.
97
- * @returns The normalized value as a clean string.
98
- */
93
+ * Normalizes legacy numeric attribute values.
94
+ * Removes the `!important` suffix (if present) and the `px` unit.
95
+ *
96
+ * @param value - The attribute value to normalize.
97
+ * @returns The normalized value as a clean string.
98
+ */
99
99
  export declare function normalizeLegacyNumericAttribute(value: string): string;
100
100
  /**
101
- * Converts a StylesMap to a string while preserving the original property order.
102
- *
103
- * Unlike `StylesMap#toString()`, which sorts properties alphabetically, this function maintains
104
- * the original order, which is critical for email clients where property sequence matters.
105
- * For example, `background` must precede `background-color` to avoid being overridden.
106
- */
101
+ * Converts a StylesMap to a string while preserving the original property order.
102
+ *
103
+ * Unlike `StylesMap#toString()`, which sorts properties alphabetically, this function maintains
104
+ * the original order, which is critical for email clients where property sequence matters.
105
+ * For example, `background` must precede `background-color` to avoid being overridden.
106
+ */
107
107
  export declare function dumpNonSortedStylesMap(stylesMap: StylesMap): string;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ckeditor/ckeditor5-email",
3
- "version": "48.2.0",
3
+ "version": "48.3.0-alpha.1",
4
4
  "description": "Email integration feature for CKEditor 5.",
5
5
  "license": "SEE LICENSE IN LICENSE.md",
6
6
  "author": "CKSource (http://cksource.com/)",
@@ -21,15 +21,15 @@
21
21
  "./package.json": "./package.json"
22
22
  },
23
23
  "dependencies": {
24
- "@ckeditor/ckeditor5-core": "48.2.0",
25
- "@ckeditor/ckeditor5-engine": "48.2.0",
26
- "@ckeditor/ckeditor5-export-inline-styles": "48.2.0",
27
- "@ckeditor/ckeditor5-font": "48.2.0",
28
- "@ckeditor/ckeditor5-html-support": "48.2.0",
29
- "@ckeditor/ckeditor5-list": "48.2.0",
30
- "@ckeditor/ckeditor5-table": "48.2.0",
31
- "@ckeditor/ckeditor5-ui": "48.2.0",
32
- "@ckeditor/ckeditor5-utils": "48.2.0"
24
+ "@ckeditor/ckeditor5-core": "48.3.0-alpha.1",
25
+ "@ckeditor/ckeditor5-engine": "48.3.0-alpha.1",
26
+ "@ckeditor/ckeditor5-export-inline-styles": "48.3.0-alpha.1",
27
+ "@ckeditor/ckeditor5-font": "48.3.0-alpha.1",
28
+ "@ckeditor/ckeditor5-html-support": "48.3.0-alpha.1",
29
+ "@ckeditor/ckeditor5-list": "48.3.0-alpha.1",
30
+ "@ckeditor/ckeditor5-table": "48.3.0-alpha.1",
31
+ "@ckeditor/ckeditor5-ui": "48.3.0-alpha.1",
32
+ "@ckeditor/ckeditor5-utils": "48.3.0-alpha.1"
33
33
  },
34
34
  "files": [
35
35
  "dist",