@ckeditor/ckeditor5-email 48.2.0 → 48.3.0-alpha.0

package/dist/integrations/template.d.ts

@@ -1,35 +1,35 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
 /**
- * @module email/integrations/template
- * @publicApi
- */
-import { Plugin } from '@ckeditor/ckeditor5-core';
-import { EmailConfigurationLogger } from '../emailconfigurationlogger.js';
+* @module email/integrations/template
+* @publicApi
+*/
+import { Plugin, type PluginDependenciesOf } from "@ckeditor/ckeditor5-core";
+import { EmailConfigurationLogger } from "../emailconfigurationlogger.js";
 /**
- * A plugin that checks if the Template plugin is properly configured for the email integration.
- */
+* A plugin that checks if the Template plugin is properly configured for the email integration.
+*/
 export declare class TemplateEmailIntegration extends Plugin {
-    /**
-     * @inheritDoc
-     */
-    static get requires(): readonly [typeof EmailConfigurationLogger];
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): "TemplateEmailIntegration";
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    static get isPremiumPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    afterInit(): void;
+	/**
+	* @inheritDoc
+	*/
+	static get requires(): PluginDependenciesOf<[EmailConfigurationLogger]>;
+	/**
+	* @inheritDoc
+	*/
+	static get pluginName(): "TemplateEmailIntegration";
+	/**
+	* @inheritDoc
+	*/
+	static override get isOfficialPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	static override get isPremiumPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	afterInit(): void;
 }

package/dist/integrations/todolist.d.ts

@@ -1,35 +1,35 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
 /**
- * @module email/integrations/todolist
- * @publicApi
- */
-import { Plugin } from '@ckeditor/ckeditor5-core';
-import { EmailConfigurationLogger } from '../emailconfigurationlogger.js';
+* @module email/integrations/todolist
+* @publicApi
+*/
+import { Plugin, type PluginDependenciesOf } from "@ckeditor/ckeditor5-core";
+import { EmailConfigurationLogger } from "../emailconfigurationlogger.js";
 /**
- * A plugin that warns about using the TodoList plugin in the email integration.
- */
+* A plugin that warns about using the TodoList plugin in the email integration.
+*/
 export declare class TodoListEmailIntegration extends Plugin {
-    /**
-     * @inheritDoc
-     */
-    static get requires(): readonly [typeof EmailConfigurationLogger];
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): "TodoListEmailIntegration";
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    static get isPremiumPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    afterInit(): void;
+	/**
+	* @inheritDoc
+	*/
+	static get requires(): PluginDependenciesOf<[EmailConfigurationLogger]>;
+	/**
+	* @inheritDoc
+	*/
+	static get pluginName(): "TodoListEmailIntegration";
+	/**
+	* @inheritDoc
+	*/
+	static override get isOfficialPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	static override get isPremiumPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	afterInit(): void;
 }

package/dist/integrations/upload.d.ts

@@ -1,35 +1,35 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
 /**
- * @module email/integrations/upload
- * @publicApi
- */
-import { Plugin } from '@ckeditor/ckeditor5-core';
-import { EmailConfigurationLogger } from '../emailconfigurationlogger.js';
+* @module email/integrations/upload
+* @publicApi
+*/
+import { Plugin, type PluginDependenciesOf } from "@ckeditor/ckeditor5-core";
+import { EmailConfigurationLogger } from "../emailconfigurationlogger.js";
 /**
- * A plugin that checks if the upload is properly configured for the email integration.
- */
+* A plugin that checks if the upload is properly configured for the email integration.
+*/
 export declare class UploadEmailIntegration extends Plugin {
-    /**
-     * @inheritDoc
-     */
-    static get requires(): readonly [typeof EmailConfigurationLogger];
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): "UploadEmailIntegration";
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    static get isPremiumPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    afterInit(): void;
+	/**
+	* @inheritDoc
+	*/
+	static get requires(): PluginDependenciesOf<[EmailConfigurationLogger]>;
+	/**
+	* @inheritDoc
+	*/
+	static get pluginName(): "UploadEmailIntegration";
+	/**
+	* @inheritDoc
+	*/
+	static override get isOfficialPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	static override get isPremiumPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	afterInit(): void;
 }

package/dist/transformations/transformemailaligntoattribute.d.ts

@@ -1,46 +1,46 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
 /**
- * @module email/transformations/transformemailaligntoattribute
- * @publicApi
- */
-import type { ExportInlineStylesTransformation } from '@ckeditor/ckeditor5-export-inline-styles';
+* @module email/transformations/transformemailaligntoattribute
+* @publicApi
+*/
+import type { ExportInlineStylesTransformation } from "@ckeditor/ckeditor5-export-inline-styles";
 /**
- * Promotes a shared alignment value from all direct children of a `<td>` element up to a
- * `align` attribute on the cell itself, removing the per-child alignment in the process.
- *
- * Examples:
- * ```
- * // All children share align="center" via inline style:
- * <td>
- *   <p style="text-align: center;">…</p>
- *   <p style="text-align: center;">…</p>
- * </td>
- * →
- * <td align="center">
- *   <p>…</p>
- *   <p>…</p>
- * </td>
- *
- * // All children share align="center" via wrapper tables:
- * <td>
- *   <table role="presentation" width="100%"><tbody><tr><td align="center"><img …></td></tr></tbody></table>
- *   <table role="presentation" width="100%"><tbody><tr><td align="center"><p …></p></td></tr></tbody></table>
- * </td>
- * →
- * <td align="center">
- *   <img …>
- *   <p …></p>
- * </td>
- *
- * // Mixed alignments → no change:
- * <td>
- *   <p style="text-align: center;">…</p>
- *   <p style="text-align: left;">…</p>
- * </td>
- * → (unchanged)
- * ```
- */
+* Promotes a shared alignment value from all direct children of a `<td>` element up to a
+* `align` attribute on the cell itself, removing the per-child alignment in the process.
+*
+* Examples:
+* ```
+* // All children share align="center" via inline style:
+* <td>
+*   <p style="text-align: center;">…</p>
+*   <p style="text-align: center;">…</p>
+* </td>
+* →
+* <td align="center">
+*   <p>…</p>
+*   <p>…</p>
+* </td>
+*
+* // All children share align="center" via wrapper tables:
+* <td>
+*   <table role="presentation" width="100%"><tbody><tr><td align="center"><img …></td></tr></tbody></table>
+*   <table role="presentation" width="100%"><tbody><tr><td align="center"><p …></p></td></tr></tbody></table>
+* </td>
+* →
+* <td align="center">
+*   <img …>
+*   <p …></p>
+* </td>
+*
+* // Mixed alignments → no change:
+* <td>
+*   <p style="text-align: center;">…</p>
+*   <p style="text-align: left;">…</p>
+* </td>
+* → (unchanged)
+* ```
+*/
 export declare const transformEmailAlignToAttribute: ExportInlineStylesTransformation;

package/dist/transformations/transformemailcolumnwidthstocells.d.ts

@@ -1,21 +1,21 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
 /**
- * @module email/transformations/transformemailcolumnwidthstocells
- * @publicApi
- */
-import { type ExportInlineStylesTransformation } from '@ckeditor/ckeditor5-export-inline-styles';
+* @module email/transformations/transformemailcolumnwidthstocells
+* @publicApi
+*/
+import { type ExportInlineStylesTransformation } from "@ckeditor/ckeditor5-export-inline-styles";
 /**
- * Copies per-column widths from a `<colgroup>`'s `<col>` children onto every matching
- * `<td>`/`<th>` cell as a `width` HTML attribute. Outlook (Microsoft Word rendering
- * engine) and other email clients ignore `<colgroup>`/`<col>` widths, so widths must
- * be duplicated on the cells themselves.
- *
- * Skipped (transformer is a no-op on the entire table) when:
- * - The table has no `<colgroup>` direct child, or no `<col>` carries a width.
- * - Any `<col>` has `span` > 1, or any cell has `colspan`/`rowspan` > 1 (simple tables only).
- * - Any cell already has a `width` attribute or `width:` style — preserves user-configured layout.
- */
+* Copies per-column widths from a `<colgroup>`'s `<col>` children onto every matching
+* `<td>`/`<th>` cell as a `width` HTML attribute. Outlook (Microsoft Word rendering
+* engine) and other email clients ignore `<colgroup>`/`<col>` widths, so widths must
+* be duplicated on the cells themselves.
+*
+* Skipped (transformer is a no-op on the entire table) when:
+* - The table has no `<colgroup>` direct child, or no `<col>` carries a width.
+* - Any `<col>` has `span` > 1, or any cell has `colspan`/`rowspan` > 1 (simple tables only).
+* - Any cell already has a `width` attribute or `width:` style — preserves user-configured layout.
+*/
 export declare const transformEmailColumnWidthsToCells: ExportInlineStylesTransformation;

package/dist/transformations/transformemailfigcaptiontodiv.d.ts

@@ -1,13 +1,13 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
 /**
- * @module email/transformations/transformemailfigcaptiontodiv
- * @publicApi
- */
-import { type ExportInlineStylesTransformation } from '@ckeditor/ckeditor5-export-inline-styles';
+* @module email/transformations/transformemailfigcaptiontodiv
+* @publicApi
+*/
+import { type ExportInlineStylesTransformation } from "@ckeditor/ckeditor5-export-inline-styles";
 /**
- * Transforms a FIGCAPTION element into a DIV element to make it more compatible with email clients.
- */
+* Transforms a FIGCAPTION element into a DIV element to make it more compatible with email clients.
+*/
 export declare const transformEmailFigcaptionToDiv: ExportInlineStylesTransformation;

package/dist/transformations/transformemailfiguretotable.d.ts

@@ -1,59 +1,59 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
 /**
- * @module email/transformations/transformemailfiguretotable
- * @publicApi
- */
-import { type ExportInlineStylesTransformation } from '@ckeditor/ckeditor5-export-inline-styles';
+* @module email/transformations/transformemailfiguretotable
+* @publicApi
+*/
+import { type ExportInlineStylesTransformation } from "@ckeditor/ckeditor5-export-inline-styles";
 /**
- * Transforms a `<figure>` element into an email-compatible structure by replacing it with
- * a table-based layout. The exact output depends on the figure's styles and children:
- *
- * **Float — single inner `<table>`** (figure is just a float wrapper):
- * The inner table is promoted in place; figure styles are merged into it and `float`
- * is converted to an `align` attribute.
- * ```
- * <figure style="float: left;"><table>…</table></figure>
- * →
- * <table align="left" style="…">…</table>
- * ```
- *
- * **Float — mixed content** (figure wraps multiple children alongside float):
- * All children are moved into a single-cell presentation table that carries the float
- * as an `align` attribute.
- * ```
- * <figure style="float: right;"><img><figcaption>…</figcaption></figure>
- * →
- * <table align="right" style="…"><tbody><tr><td><img><figcaption>…</figcaption></td></tr></tbody></table>
- * ```
- *
- * **Margin-based alignment — single inner `<table>`** (figure is a `display:table` alignment wrapper):
- * The inner table is promoted in place; figure styles (minus `display`, layout props) are
- * merged into it. Alignment and width are already encoded in the surrounding fallback tables
- * added by `wrapWithFallbackTables`.
- * ```
- * <figure style="display: table; margin: auto; width: 600px;"><table>…</table></figure>
- * →
- * <table width="100%"><tbody><tr><td align="center">
- *   <table width="600"><tbody><tr><td>
- *     <table style="…">…</table>
- *   </td></tr></tbody></table>
- * </td></tr></tbody></table>
- * ```
- *
- * **Margin-based alignment — mixed content** (figure wraps an image, caption, etc.):
- * The figure is replaced with a `<div>` that inherits its attributes, and the whole
- * thing is wrapped in one or two fallback tables for alignment and width.
- * ```
- * <figure style="margin: auto; width: 600px;"><img><figcaption>…</figcaption></figure>
- * →
- * <table width="100%"><tbody><tr><td align="center">
- *   <table width="600"><tbody><tr><td>
- *     <div style="…"><img><figcaption>…</figcaption></div>
- *   </td></tr></tbody></table>
- * </td></tr></tbody></table>
- * ```
- */
+* Transforms a `<figure>` element into an email-compatible structure by replacing it with
+* a table-based layout. The exact output depends on the figure's styles and children:
+*
+* **Float — single inner `<table>`** (figure is just a float wrapper):
+* The inner table is promoted in place; figure styles are merged into it and `float`
+* is converted to an `align` attribute.
+* ```
+* <figure style="float: left;"><table>…</table></figure>
+* →
+* <table align="left" style="…">…</table>
+* ```
+*
+* **Float — mixed content** (figure wraps multiple children alongside float):
+* All children are moved into a single-cell presentation table that carries the float
+* as an `align` attribute.
+* ```
+* <figure style="float: right;"><img><figcaption>…</figcaption></figure>
+* →
+* <table align="right" style="…"><tbody><tr><td><img><figcaption>…</figcaption></td></tr></tbody></table>
+* ```
+*
+* **Margin-based alignment — single inner `<table>`** (figure is a `display:table` alignment wrapper):
+* The inner table is promoted in place; figure styles (minus `display`, layout props) are
+* merged into it. Alignment and width are already encoded in the surrounding fallback tables
+* added by `wrapWithFallbackTables`.
+* ```
+* <figure style="display: table; margin: auto; width: 600px;"><table>…</table></figure>
+* →
+* <table width="100%"><tbody><tr><td align="center">
+*   <table width="600"><tbody><tr><td>
+*     <table style="…">…</table>
+*   </td></tr></tbody></table>
+* </td></tr></tbody></table>
+* ```
+*
+* **Margin-based alignment — mixed content** (figure wraps an image, caption, etc.):
+* The figure is replaced with a `<div>` that inherits its attributes, and the whole
+* thing is wrapped in one or two fallback tables for alignment and width.
+* ```
+* <figure style="margin: auto; width: 600px;"><img><figcaption>…</figcaption></figure>
+* →
+* <table width="100%"><tbody><tr><td align="center">
+*   <table width="600"><tbody><tr><td>
+*     <div style="…"><img><figcaption>…</figcaption></div>
+*   </td></tr></tbody></table>
+* </td></tr></tbody></table>
+* ```
+*/
 export declare const transformEmailFigureToTable: ExportInlineStylesTransformation;

package/dist/transformations/transformemailfloattoalign.d.ts

@@ -1,17 +1,17 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
 /**
- * @module email/transformations/transformemailfloattoalign
- * @publicApi
- */
-import { type ExportInlineStylesTransformation } from '@ckeditor/ckeditor5-export-inline-styles';
+* @module email/transformations/transformemailfloattoalign
+* @publicApi
+*/
+import { type ExportInlineStylesTransformation } from "@ckeditor/ckeditor5-export-inline-styles";
 /**
- * Transform float: left/right to align="left"/"right" for table and img elements.
- *
- * Examples:
- * * `<table style="float: left">` → `<table style="float: left" align="left">`
- * * `<img style="float: right">` → `<img style="float: right" align="right">`
- */
+* Transform float: left/right to align="left"/"right" for table and img elements.
+*
+* Examples:
+* * `<table style="float: left">` → `<table style="float: left" align="left">`
+* * `<img style="float: right">` → `<img style="float: right" align="right">`
+*/
 export declare const transformEmailFloatToAlign: ExportInlineStylesTransformation;

package/dist/transformations/transformemailimagewidthattributes.d.ts

@@ -1,17 +1,17 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
 /**
- * @module email/transformations/transformemailimagewidthattributes
- * @publicApi
- */
-import type { ExportInlineStylesTransformation } from '@ckeditor/ckeditor5-export-inline-styles';
+* @module email/transformations/transformemailimagewidthattributes
+* @publicApi
+*/
+import type { ExportInlineStylesTransformation } from "@ckeditor/ckeditor5-export-inline-styles";
 /**
- * Removes width and height attributes from images that have width defined in styles.
- * This helps to prevent issues with image scaling in some email clients.
- *
- * Example:
- * * `<img style="width: 100px;" width="200" height="150">` → `<img style="width: 100px; height: auto;">`
- */
+* Removes width and height attributes from images that have width defined in styles.
+* This helps to prevent issues with image scaling in some email clients.
+*
+* Example:
+* * `<img style="width: 100px;" width="200" height="150">` → `<img style="width: 100px; height: auto;">`
+*/
 export declare const transformEmailImageWidthAttributes: ExportInlineStylesTransformation;

package/dist/transformations/transformemailmargintoalign.d.ts

@@ -1,23 +1,23 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
 /**
- * @module email/transformations/transformemailmargintoalign
- * @publicApi
- */
-import type { ExportInlineStylesTransformation } from '@ckeditor/ckeditor5-export-inline-styles';
+* @module email/transformations/transformemailmargintoalign
+* @publicApi
+*/
+import type { ExportInlineStylesTransformation } from "@ckeditor/ckeditor5-export-inline-styles";
 /**
- * Handle margin-left and margin-right combinations for alignment of the table element.
- * It skips elements with float style because float has higher priority for alignment.
- *
- * It wraps the `<table>` in a container `<table>` to ensure proper alignment in all email clients.
- *
- * Examples:
- * * `<table style="margin: auto">` →
- * `<table width="100%"><tr><td align="center"><table style="...">...</table></td></tr></table>`
- *
- * * `<table style="margin-left: auto; width: 500px">` →
- * `<table width="100%"><tr><td align="right"><table width="500"><tr><td><table style="...">...</table>...`
- */
+* Handle margin-left and margin-right combinations for alignment of the table element.
+* It skips elements with float style because float has higher priority for alignment.
+*
+* It wraps the `<table>` in a container `<table>` to ensure proper alignment in all email clients.
+*
+* Examples:
+* * `<table style="margin: auto">` →
+* `<table width="100%"><tr><td align="center"><table style="...">...</table></td></tr></table>`
+*
+* * `<table style="margin-left: auto; width: 500px">` →
+* `<table width="100%"><tr><td align="right"><table width="500"><tr><td><table style="...">...</table>...`
+*/
 export declare const transformEmailMarginToAlign: ExportInlineStylesTransformation;