@ckeditor/ckeditor5-html-support 36.0.1 → 37.0.0-alpha.1

package/src/integrations/heading.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module html-support/integrations/heading
+ */
+import { Plugin, type PluginDependencies } from 'ckeditor5/src/core';
+/**
+ * Provides the General HTML Support integration with {@link module:heading/heading~Heading Heading} feature.
+ */
+export default class HeadingElementSupport extends Plugin {
+    /**
+     * @inheritDoc
+     */
+    static get requires(): PluginDependencies;
+    /**
+     * @inheritDoc
+     */
+    static get pluginName(): 'HeadingElementSupport';
+    /**
+     * @inheritDoc
+     */
+    init(): void;
+}

package/src/integrations/heading.js

@@ -2,67 +2,54 @@
  * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
-
 /**
  * @module html-support/integrations/heading
  */
-
 import { Plugin } from 'ckeditor5/src/core';
-
 import DataSchema from '../dataschema';
-
 /**
  * Provides the General HTML Support integration with {@link module:heading/heading~Heading Heading} feature.
- *
- * @extends module:core/plugin~Plugin
  */
 export default class HeadingElementSupport extends Plugin {
-	/**
-	 * @inheritDoc
-	 */
-	static get requires() {
-		return [ DataSchema ];
-	}
-
-	/**
-	 * @inheritDoc
-	 */
-	static get pluginName() {
-		return 'HeadingElementSupport';
-	}
-
-	/**
-	 * @inheritDoc
-	 */
-	init() {
-		const editor = this.editor;
-
-		if ( !editor.plugins.has( 'HeadingEditing' ) ) {
-			return;
-		}
-
-		const dataSchema = editor.plugins.get( DataSchema );
-		const options = editor.config.get( 'heading.options' );
-		const headerModels = [];
-
-		// We are registering all elements supported by HeadingEditing
-		// to enable custom attributes for those elements.
-		for ( const option of options ) {
-			if ( 'model' in option && 'view' in option ) {
-				dataSchema.registerBlockElement( {
-					view: option.view,
-					model: option.model
-				} );
-
-				headerModels.push( option.model );
-			}
-		}
-
-		dataSchema.extendBlockElement( {
-			model: 'htmlHgroup',
-			modelSchema: {
-				allowChildren: headerModels
-			}
-		} );
-	}
+    /**
+     * @inheritDoc
+     */
+    static get requires() {
+        return [DataSchema];
+    }
+    /**
+     * @inheritDoc
+     */
+    static get pluginName() {
+        return 'HeadingElementSupport';
+    }
+    /**
+     * @inheritDoc
+     */
+    init() {
+        const editor = this.editor;
+        if (!editor.plugins.has('HeadingEditing')) {
+            return;
+        }
+        const dataSchema = editor.plugins.get(DataSchema);
+        const options = editor.config.get('heading.options');
+        const headerModels = [];
+        // We are registering all elements supported by HeadingEditing
+        // to enable custom attributes for those elements.
+        for (const option of options) {
+            if ('model' in option && 'view' in option) {
+                dataSchema.registerBlockElement({
+                    view: option.view,
+                    model: option.model
+                });
+                headerModels.push(option.model);
+            }
+        }
+        dataSchema.extendBlockElement({
+            model: 'htmlHgroup',
+            modelSchema: {
+                allowChildren: headerModels
+            }
+        });
+    }
 }

package/src/integrations/image.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module html-support/integrations/image
+ */
+import { Plugin, type PluginDependencies } from 'ckeditor5/src/core';
+/**
+ * Provides the General HTML Support integration with the {@link module:image/image~Image Image} feature.
+ */
+export default class ImageElementSupport extends Plugin {
+    /**
+     * @inheritDoc
+     */
+    static get requires(): PluginDependencies;
+    /**
+     * @inheritDoc
+     */
+    static get pluginName(): 'ImageElementSupport';
+    /**
+     * @inheritDoc
+     */
+    init(): void;
+}

package/src/integrations/image.js

@@ -2,229 +2,171 @@
  * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
-
 /**
  * @module html-support/integrations/image
  */
-
 import { Plugin } from 'ckeditor5/src/core';
-
 import DataFilter from '../datafilter';
-import {
-	setViewAttributes,
-	updateViewAttributes
-} from '../conversionutils.js';
-
+import { setViewAttributes, updateViewAttributes } from '../conversionutils';
+import { getDescendantElement } from './integrationutils';
 /**
  * Provides the General HTML Support integration with the {@link module:image/image~Image Image} feature.
- *
- * @extends module:core/plugin~Plugin
  */
 export default class ImageElementSupport extends Plugin {
-	/**
-	 * @inheritDoc
-	 */
-	static get requires() {
-		return [ DataFilter ];
-	}
-
-	/**
-	 * @inheritDoc
-	 */
-	static get pluginName() {
-		return 'ImageElementSupport';
-	}
-
-	/**
-	 * @inheritDoc
-	 */
-	init() {
-		const editor = this.editor;
-
-		// At least one image plugin should be loaded for the integration to work properly.
-		if ( !editor.plugins.has( 'ImageInlineEditing' ) && !editor.plugins.has( 'ImageBlockEditing' ) ) {
-			return;
-		}
-
-		const schema = editor.model.schema;
-		const conversion = editor.conversion;
-		const dataFilter = editor.plugins.get( DataFilter );
-
-		dataFilter.on( 'register:figure', () => {
-			conversion.for( 'upcast' ).add( viewToModelFigureAttributeConverter( dataFilter ) );
-		} );
-
-		dataFilter.on( 'register:img', ( evt, definition ) => {
-			if ( definition.model !== 'imageBlock' && definition.model !== 'imageInline' ) {
-				return;
-			}
-
-			if ( schema.isRegistered( 'imageBlock' ) ) {
-				schema.extend( 'imageBlock', {
-					allowAttributes: [
-						'htmlAttributes',
-						// Figure and Link don't have model counterpart.
-						// We will preserve attributes on image model element using these attribute keys.
-						'htmlFigureAttributes',
-						'htmlLinkAttributes'
-					]
-				} );
-			}
-
-			if ( schema.isRegistered( 'imageInline' ) ) {
-				schema.extend( 'imageInline', {
-					allowAttributes: [
-						// `htmlA` is needed for standard GHS link integration.
-						'htmlA',
-						'htmlAttributes'
-					]
-				} );
-			}
-
-			conversion.for( 'upcast' ).add( viewToModelImageAttributeConverter( dataFilter ) );
-			conversion.for( 'downcast' ).add( modelToViewImageAttributeConverter() );
-
-			evt.stop();
-		} );
-	}
+    /**
+     * @inheritDoc
+     */
+    static get requires() {
+        return [DataFilter];
+    }
+    /**
+     * @inheritDoc
+     */
+    static get pluginName() {
+        return 'ImageElementSupport';
+    }
+    /**
+     * @inheritDoc
+     */
+    init() {
+        const editor = this.editor;
+        // At least one image plugin should be loaded for the integration to work properly.
+        if (!editor.plugins.has('ImageInlineEditing') && !editor.plugins.has('ImageBlockEditing')) {
+            return;
+        }
+        const schema = editor.model.schema;
+        const conversion = editor.conversion;
+        const dataFilter = editor.plugins.get(DataFilter);
+        dataFilter.on('register:figure', () => {
+            conversion.for('upcast').add(viewToModelFigureAttributeConverter(dataFilter));
+        });
+        dataFilter.on('register:img', (evt, definition) => {
+            if (definition.model !== 'imageBlock' && definition.model !== 'imageInline') {
+                return;
+            }
+            if (schema.isRegistered('imageBlock')) {
+                schema.extend('imageBlock', {
+                    allowAttributes: [
+                        'htmlAttributes',
+                        // Figure and Link don't have model counterpart.
+                        // We will preserve attributes on image model element using these attribute keys.
+                        'htmlFigureAttributes',
+                        'htmlLinkAttributes'
+                    ]
+                });
+            }
+            if (schema.isRegistered('imageInline')) {
+                schema.extend('imageInline', {
+                    allowAttributes: [
+                        // `htmlA` is needed for standard GHS link integration.
+                        'htmlA',
+                        'htmlAttributes'
+                    ]
+                });
+            }
+            conversion.for('upcast').add(viewToModelImageAttributeConverter(dataFilter));
+            conversion.for('downcast').add(modelToViewImageAttributeConverter());
+            evt.stop();
+        });
+    }
 }
-
-// View-to-model conversion helper preserving allowed attributes on the {@link module:image/image~Image Image}
-// feature model element.
-//
-// @private
-// @param {module:html-support/datafilter~DataFilter} dataFilter
-// @returns {Function} Returns a conversion callback.
-function viewToModelImageAttributeConverter( dataFilter ) {
-	return dispatcher => {
-		dispatcher.on( 'element:img', ( evt, data, conversionApi ) => {
-			if ( !data.modelRange ) {
-				return;
-			}
-
-			const viewImageElement = data.viewItem;
-			const viewContainerElement = viewImageElement.parent;
-
-			preserveElementAttributes( viewImageElement, 'htmlAttributes' );
-
-			if ( viewContainerElement.is( 'element', 'a' ) ) {
-				preserveLinkAttributes( viewContainerElement );
-			}
-
-			function preserveElementAttributes( viewElement, attributeName ) {
-				const viewAttributes = dataFilter.processViewAttributes( viewElement, conversionApi );
-
-				if ( viewAttributes ) {
-					conversionApi.writer.setAttribute( attributeName, viewAttributes, data.modelRange );
-				}
-			}
-
-			function preserveLinkAttributes( viewContainerElement ) {
-				if ( data.modelRange && data.modelRange.getContainedElement().is( 'element', 'imageBlock' ) ) {
-					preserveElementAttributes( viewContainerElement, 'htmlLinkAttributes' );
-				}
-			}
-		}, { priority: 'low' } );
-	};
+/**
+ * View-to-model conversion helper preserving allowed attributes on the {@link module:image/image~Image Image}
+ * feature model element.
+ *
+ * @returns Returns a conversion callback.
+ */
+function viewToModelImageAttributeConverter(dataFilter) {
+    return (dispatcher) => {
+        dispatcher.on('element:img', (evt, data, conversionApi) => {
+            if (!data.modelRange) {
+                return;
+            }
+            const viewImageElement = data.viewItem;
+            const viewContainerElement = viewImageElement.parent;
+            preserveElementAttributes(viewImageElement, 'htmlAttributes');
+            if (viewContainerElement.is('element', 'a')) {
+                preserveLinkAttributes(viewContainerElement);
+            }
+            function preserveElementAttributes(viewElement, attributeName) {
+                const viewAttributes = dataFilter.processViewAttributes(viewElement, conversionApi);
+                if (viewAttributes) {
+                    conversionApi.writer.setAttribute(attributeName, viewAttributes, data.modelRange);
+                }
+            }
+            function preserveLinkAttributes(viewContainerElement) {
+                if (data.modelRange && data.modelRange.getContainedElement().is('element', 'imageBlock')) {
+                    preserveElementAttributes(viewContainerElement, 'htmlLinkAttributes');
+                }
+            }
+        }, { priority: 'low' });
+    };
 }
-
-// View-to-model conversion helper preserving allowed attributes on {@link module:image/image~Image Image}
-// feature model element from figure view element.
-//
-// @private
-// @param {module:html-support/datafilter~DataFilter} dataFilter
-// @returns {Function} Returns a conversion callback.
-function viewToModelFigureAttributeConverter( dataFilter ) {
-	return dispatcher => {
-		dispatcher.on( 'element:figure', ( evt, data, conversionApi ) => {
-			const viewFigureElement = data.viewItem;
-
-			if ( !data.modelRange || !viewFigureElement.hasClass( 'image' ) ) {
-				return;
-			}
-
-			const viewAttributes = dataFilter.processViewAttributes( viewFigureElement, conversionApi );
-
-			if ( viewAttributes ) {
-				conversionApi.writer.setAttribute( 'htmlFigureAttributes', viewAttributes, data.modelRange );
-			}
-		}, { priority: 'low' } );
-	};
+/**
+ * View-to-model conversion helper preserving allowed attributes on {@link module:image/image~Image Image}
+ * feature model element from figure view element.
+ *
+ * @returns Returns a conversion callback.
+ */
+function viewToModelFigureAttributeConverter(dataFilter) {
+    return (dispatcher) => {
+        dispatcher.on('element:figure', (evt, data, conversionApi) => {
+            const viewFigureElement = data.viewItem;
+            if (!data.modelRange || !viewFigureElement.hasClass('image')) {
+                return;
+            }
+            const viewAttributes = dataFilter.processViewAttributes(viewFigureElement, conversionApi);
+            if (viewAttributes) {
+                conversionApi.writer.setAttribute('htmlFigureAttributes', viewAttributes, data.modelRange);
+            }
+        }, { priority: 'low' });
+    };
 }
-
-// A model-to-view conversion helper applying attributes from the {@link module:image/image~Image Image}
-// feature.
-//
-// @private
-// @returns {Function} Returns a conversion callback.
+/**
+ * A model-to-view conversion helper applying attributes from the {@link module:image/image~Image Image}
+ * feature.
+ * @returns Returns a conversion callback.
+ */
 function modelToViewImageAttributeConverter() {
-	return dispatcher => {
-		addInlineAttributeConversion( 'htmlAttributes' );
-
-		addBlockAttributeConversion( 'img', 'htmlAttributes' );
-		addBlockAttributeConversion( 'figure', 'htmlFigureAttributes' );
-		addBlockAttributeConversion( 'a', 'htmlLinkAttributes' );
-
-		function addInlineAttributeConversion( attributeName ) {
-			dispatcher.on( `attribute:${ attributeName }:imageInline`, ( evt, data, conversionApi ) => {
-				if ( !conversionApi.consumable.consume( data.item, evt.name ) ) {
-					return;
-				}
-
-				const { attributeOldValue, attributeNewValue } = data;
-				const viewElement = conversionApi.mapper.toViewElement( data.item );
-
-				updateViewAttributes( conversionApi.writer, attributeOldValue, attributeNewValue, viewElement );
-			}, { priority: 'low' } );
-		}
-
-		function addBlockAttributeConversion( elementName, attributeName ) {
-			dispatcher.on( `attribute:${ attributeName }:imageBlock`, ( evt, data, conversionApi ) => {
-				if ( !conversionApi.consumable.test( data.item, evt.name ) ) {
-					return;
-				}
-
-				const { attributeOldValue, attributeNewValue } = data;
-				const containerElement = conversionApi.mapper.toViewElement( data.item );
-				const viewElement = getDescendantElement( conversionApi.writer, containerElement, elementName );
-
-				if ( viewElement ) {
-					updateViewAttributes( conversionApi.writer, attributeOldValue, attributeNewValue, viewElement );
-					conversionApi.consumable.consume( data.item, evt.name );
-				}
-			}, { priority: 'low' } );
-
-			if ( elementName === 'a' ) {
-				// To have a link element in the view, we need to attach a converter to the `linkHref` attribute as well.
-				dispatcher.on( 'attribute:linkHref:imageBlock', ( evt, data, conversionApi ) => {
-					if ( !conversionApi.consumable.consume( data.item, 'attribute:htmlLinkAttributes:imageBlock' ) ) {
-						return;
-					}
-
-					const containerElement = conversionApi.mapper.toViewElement( data.item );
-					const viewElement = getDescendantElement( conversionApi.writer, containerElement, 'a' );
-
-					setViewAttributes( conversionApi.writer, data.item.getAttribute( 'htmlLinkAttributes' ), viewElement );
-				}, { priority: 'low' } );
-			}
-		}
-	};
-}
-
-// Returns the first view element descendant matching the given view name.
-// Includes view element itself.
-//
-// @private
-// @param {module:engine/view/downcastwriter~DowncastWriter} writer
-// @param {module:engine/view/element~Element} containerElement
-// @param {String} elementName
-// @returns {module:engine/view/element~Element|null}
-function getDescendantElement( writer, containerElement, elementName ) {
-	const range = writer.createRangeOn( containerElement );
-
-	for ( const { item } of range.getWalker() ) {
-		if ( item.is( 'element', elementName ) ) {
-			return item;
-		}
-	}
+    return (dispatcher) => {
+        addInlineAttributeConversion('htmlAttributes');
+        addBlockAttributeConversion('img', 'htmlAttributes');
+        addBlockAttributeConversion('figure', 'htmlFigureAttributes');
+        addBlockAttributeConversion('a', 'htmlLinkAttributes');
+        function addInlineAttributeConversion(attributeName) {
+            dispatcher.on(`attribute:${attributeName}:imageInline`, (evt, data, conversionApi) => {
+                if (!conversionApi.consumable.consume(data.item, evt.name)) {
+                    return;
+                }
+                const { attributeOldValue, attributeNewValue } = data;
+                const viewElement = conversionApi.mapper.toViewElement(data.item);
+                updateViewAttributes(conversionApi.writer, attributeOldValue, attributeNewValue, viewElement);
+            }, { priority: 'low' });
+        }
+        function addBlockAttributeConversion(elementName, attributeName) {
+            dispatcher.on(`attribute:${attributeName}:imageBlock`, (evt, data, conversionApi) => {
+                if (!conversionApi.consumable.test(data.item, evt.name)) {
+                    return;
+                }
+                const { attributeOldValue, attributeNewValue } = data;
+                const containerElement = conversionApi.mapper.toViewElement(data.item);
+                const viewElement = getDescendantElement(conversionApi.writer, containerElement, elementName);
+                if (viewElement) {
+                    updateViewAttributes(conversionApi.writer, attributeOldValue, attributeNewValue, viewElement);
+                    conversionApi.consumable.consume(data.item, evt.name);
+                }
+            }, { priority: 'low' });
+            if (elementName === 'a') {
+                // To have a link element in the view, we need to attach a converter to the `linkHref` attribute as well.
+                dispatcher.on('attribute:linkHref:imageBlock', (evt, data, conversionApi) => {
+                    if (!conversionApi.consumable.consume(data.item, 'attribute:htmlLinkAttributes:imageBlock')) {
+                        return;
+                    }
+                    const containerElement = conversionApi.mapper.toViewElement(data.item);
+                    const viewElement = getDescendantElement(conversionApi.writer, containerElement, 'a');
+                    setViewAttributes(conversionApi.writer, data.item.getAttribute('htmlLinkAttributes'), viewElement);
+                }, { priority: 'low' });
+            }
+        }
+    };
 }

package/src/integrations/integrationutils.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+import type { DowncastWriter, ViewElement } from 'ckeditor5/src/engine';
+/**
+ * @module html-support/integrations/integrationutils
+ */
+/**
+ * Returns the first view element descendant matching the given view name.
+ * Includes view element itself.
+ *
+ * @internal
+ */
+export declare function getDescendantElement(writer: DowncastWriter, containerElement: ViewElement, elementName: string): ViewElement | undefined;

package/src/integrations/integrationutils.js

@@ -0,0 +1,21 @@
+/**
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module html-support/integrations/integrationutils
+ */
+/**
+ * Returns the first view element descendant matching the given view name.
+ * Includes view element itself.
+ *
+ * @internal
+ */
+export function getDescendantElement(writer, containerElement, elementName) {
+    const range = writer.createRangeOn(containerElement);
+    for (const { item } of range.getWalker()) {
+        if (item.is('element', elementName)) {
+            return item;
+        }
+    }
+}

package/src/integrations/mediaembed.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module html-support/integrations/mediaembed
+ */
+import { Plugin, type PluginDependencies } from 'ckeditor5/src/core';
+/**
+ * Provides the General HTML Support integration with {@link module:media-embed/mediaembed~MediaEmbed Media Embed} feature.
+ */
+export default class MediaEmbedElementSupport extends Plugin {
+    /**
+     * @inheritDoc
+     */
+    static get requires(): PluginDependencies;
+    /**
+     * @inheritDoc
+     */
+    static get pluginName(): 'MediaEmbedElementSupport';
+    /**
+     * @inheritDoc
+     */
+    init(): void;
+}