@ckeditor/ckeditor5-engine 39.0.1 → 40.0.0

package/src/conversion/upcasthelpers.js

@@ -1,950 +1,950 @@
-/**
- * @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 Matcher from '../view/matcher';
-import ConversionHelpers from './conversionhelpers';
-import { isParagraphable, wrapInParagraph } from '../model/utils/autoparagraphing';
-import { priorities } from '@ckeditor/ckeditor5-utils';
-import { cloneDeep } from 'lodash-es';
-/**
- * Contains the {@link module:engine/view/view view} to {@link module:engine/model/model model} converters for
- * {@link module:engine/conversion/upcastdispatcher~UpcastDispatcher}.
- *
- * @module engine/conversion/upcasthelpers
- */
-/**
- * Upcast conversion helper functions.
- *
- * Learn more about {@glink framework/deep-dive/conversion/upcast upcast helpers}.
- *
- * @extends module:engine/conversion/conversionhelpers~ConversionHelpers
- */
-export default class UpcastHelpers extends ConversionHelpers {
-    /**
-     * View element to model element conversion helper.
-     *
-     * This conversion results in creating a model element. For example,
-     * view `<p>Foo</p>` becomes `<paragraph>Foo</paragraph>` in the model.
-     *
-     * Keep in mind that the element will be inserted only if it is allowed
-     * by {@link module:engine/model/schema~Schema schema} configuration.
-     *
-     * ```ts
-     * editor.conversion.for( 'upcast' ).elementToElement( {
-     * 	view: 'p',
-     * 	model: 'paragraph'
-     * } );
-     *
-     * editor.conversion.for( 'upcast' ).elementToElement( {
-     * 	view: 'p',
-     * 	model: 'paragraph',
-     * 	converterPriority: 'high'
-     * } );
-     *
-     * editor.conversion.for( 'upcast' ).elementToElement( {
-     * 	view: {
-     * 		name: 'p',
-     * 		classes: 'fancy'
-     * 	},
-     * 	model: 'fancyParagraph'
-     * } );
-     *
-     * editor.conversion.for( 'upcast' ).elementToElement( {
-     * 	view: {
-     * 		name: 'p',
-     * 		classes: 'heading'
-     * 	},
-     * 	model: ( viewElement, conversionApi ) => {
-     * 		const modelWriter = conversionApi.writer;
-     *
-     * 		return modelWriter.createElement( 'heading', { level: viewElement.getAttribute( 'data-level' ) } );
-     * 	}
-     * } );
-     * ```
-     *
-     * See {@link module:engine/conversion/conversion~Conversion#for `conversion.for()`} to learn how to add a converter
-     * to the conversion process.
-     *
-     * @param config Conversion configuration.
-     * @param config.view Pattern matching all view elements which should be converted. If not set, the converter
-     * will fire for every view element.
-     * @param config.model Name of the model element, a model element instance or a function that takes a view element
-     * and {@link module:engine/conversion/upcastdispatcher~UpcastConversionApi upcast conversion API}
-     * and returns a model element. The model element will be inserted in the model.
-     * @param config.converterPriority Converter priority.
-     */
-    elementToElement(config) {
-        return this.add(upcastElementToElement(config));
-    }
-    /**
-     * View element to model attribute conversion helper.
-     *
-     * This conversion results in setting an attribute on a model node. For example, view `<strong>Foo</strong>` becomes
-     * `Foo` {@link module:engine/model/text~Text model text node} with `bold` attribute set to `true`.
-     *
-     * This helper is meant to set a model attribute on all the elements that are inside the converted element:
-     *
-     * ```
-     * <strong>Foo</strong>   -->   <strong><p>Foo</p></strong>   -->   <paragraph><$text bold="true">Foo</$text></paragraph>
-     * ```
-     *
-     * Above is a sample of HTML code, that goes through autoparagraphing (first step) and then is converted (second step).
-     * Even though `<strong>` is over `<p>` element, `bold="true"` was added to the text. See
-     * {@link module:engine/conversion/upcasthelpers~UpcastHelpers#attributeToAttribute} for comparison.
-     *
-     * Keep in mind that the attribute will be set only if it is allowed by {@link module:engine/model/schema~Schema schema} configuration.
-     *
-     * ```ts
-     * editor.conversion.for( 'upcast' ).elementToAttribute( {
-     * 	view: 'strong',
-     * 	model: 'bold'
-     * } );
-     *
-     * editor.conversion.for( 'upcast' ).elementToAttribute( {
-     * 	view: 'strong',
-     * 	model: 'bold',
-     * 	converterPriority: 'high'
-     * } );
-     *
-     * editor.conversion.for( 'upcast' ).elementToAttribute( {
-     * 	view: {
-     * 		name: 'span',
-     * 		classes: 'bold'
-     * 	},
-     * 	model: 'bold'
-     * } );
-     *
-     * editor.conversion.for( 'upcast' ).elementToAttribute( {
-     * 	view: {
-     * 		name: 'span',
-     * 		classes: [ 'styled', 'styled-dark' ]
-     * 	},
-     * 	model: {
-     * 		key: 'styled',
-     * 		value: 'dark'
-     * 	}
-     * } );
-     *
-     * editor.conversion.for( 'upcast' ).elementToAttribute( {
-     * 	view: {
-     * 		name: 'span',
-     * 		styles: {
-     * 			'font-size': /[\s\S]+/
-     * 		}
-     * 	},
-     * 	model: {
-     * 		key: 'fontSize',
-     * 		value: ( viewElement, conversionApi ) => {
-     * 			const fontSize = viewElement.getStyle( 'font-size' );
-     * 			const value = fontSize.substr( 0, fontSize.length - 2 );
-     *
-     * 			if ( value <= 10 ) {
-     * 				return 'small';
-     * 			} else if ( value > 12 ) {
-     * 				return 'big';
-     * 			}
-     *
-     * 			return null;
-     * 		}
-     * 	}
-     * } );
-     * ```
-     *
-     * See {@link module:engine/conversion/conversion~Conversion#for `conversion.for()`} to learn how to add a converter
-     * to the conversion process.
-     *
-     * @param config Conversion configuration.
-     * @param config.view Pattern matching all view elements which should be converted.
-     * @param config.model Model attribute key or an object with `key` and `value` properties, describing
-     * the model attribute. `value` property may be set as a function that takes a view element and
-     * {@link module:engine/conversion/upcastdispatcher~UpcastConversionApi upcast conversion API} and returns the value.
-     * If `String` is given, the model attribute value will be set to `true`.
-     * @param config.converterPriority Converter priority. Defaults to `low`.
-     */
-    elementToAttribute(config) {
-        return this.add(upcastElementToAttribute(config));
-    }
-    /**
-     * View attribute to model attribute conversion helper.
-     *
-     * This conversion results in setting an attribute on a model node. For example, view `<img src="foo.jpg"></img>` becomes
-     * `<imageBlock source="foo.jpg"></imageBlock>` in the model.
-     *
-     * This helper is meant to convert view attributes from view elements which got converted to the model, so the view attribute
-     * is set only on the corresponding model node:
-     *
-     * ```
-     * <div class="dark"><div>foo</div></div>    -->    <div dark="true"><div>foo</div></div>
-     * ```
-     *
-     * Above, `class="dark"` attribute is added only to the `<div>` elements that has it. This is in contrary to
-     * {@link module:engine/conversion/upcasthelpers~UpcastHelpers#elementToAttribute} which sets attributes for
-     * all the children in the model:
-     *
-     * ```
-     * <strong>Foo</strong>   -->   <strong><p>Foo</p></strong>   -->   <paragraph><$text bold="true">Foo</$text></paragraph>
-     * ```
-     *
-     * Above is a sample of HTML code, that goes through autoparagraphing (first step) and then is converted (second step).
-     * Even though `<strong>` is over `<p>` element, `bold="true"` was added to the text.
-     *
-     * Keep in mind that the attribute will be set only if it is allowed by {@link module:engine/model/schema~Schema schema} configuration.
-     *
-     * ```ts
-     * editor.conversion.for( 'upcast' ).attributeToAttribute( {
-     * 	view: 'src',
-     * 	model: 'source'
-     * } );
-     *
-     * editor.conversion.for( 'upcast' ).attributeToAttribute( {
-     * 	view: { key: 'src' },
-     * 	model: 'source'
-     * } );
-     *
-     * editor.conversion.for( 'upcast' ).attributeToAttribute( {
-     * 	view: { key: 'src' },
-     * 	model: 'source',
-     * 	converterPriority: 'normal'
-     * } );
-     *
-     * editor.conversion.for( 'upcast' ).attributeToAttribute( {
-     * 	view: {
-     * 		key: 'data-style',
-     * 		value: /[\s\S]+/
-     * 	},
-     * 	model: 'styled'
-     * } );
-     *
-     * editor.conversion.for( 'upcast' ).attributeToAttribute( {
-     * 	view: {
-     * 		name: 'img',
-     * 		key: 'class',
-     * 		value: 'styled-dark'
-     * 	},
-     * 	model: {
-     * 		key: 'styled',
-     * 		value: 'dark'
-     * 	}
-     * } );
-     *
-     * editor.conversion.for( 'upcast' ).attributeToAttribute( {
-     * 	view: {
-     * 		key: 'class',
-     * 		value: /styled-[\S]+/
-     * 	},
-     * 	model: {
-     * 		key: 'styled'
-     * 		value: ( viewElement, conversionApi ) => {
-     * 			const regexp = /styled-([\S]+)/;
-     * 			const match = viewElement.getAttribute( 'class' ).match( regexp );
-     *
-     * 			return match[ 1 ];
-     * 		}
-     * 	}
-     * } );
-     * ```
-     *
-     * Converting styles works a bit differently as it requires `view.styles` to be an object and by default
-     * a model attribute will be set to `true` by such a converter. You can set the model attribute to any value by providing the `value`
-     * callback that returns the desired value.
-     *
-     * ```ts
-     * // Default conversion of font-weight style will result in setting bold attribute to true.
-     * editor.conversion.for( 'upcast' ).attributeToAttribute( {
-     * 	view: {
-     * 		styles: {
-     * 			'font-weight': 'bold'
-     * 		}
-     * 	},
-     * 	model: 'bold'
-     * } );
-     *
-     * // This converter will pass any style value to the `lineHeight` model attribute.
-     * editor.conversion.for( 'upcast' ).attributeToAttribute( {
-     * 	view: {
-     * 		styles: {
-     * 			'line-height': /[\s\S]+/
-     * 		}
-     * 	},
-     * 	model: {
-     * 		key: 'lineHeight',
-     * 		value: ( viewElement, conversionApi ) => viewElement.getStyle( 'line-height' )
-     * 	}
-     * } );
-     * ```
-     *
-     * See {@link module:engine/conversion/conversion~Conversion#for `conversion.for()`} to learn how to add a converter
-     * to the conversion process.
-     *
-     * @param config Conversion configuration.
-     * @param config.view Specifies which view attribute will be converted. If a `String` is passed,
-     * attributes with given key will be converted. If an `Object` is passed, it must have a required `key` property,
-     * specifying view attribute key, and may have an optional `value` property, specifying view attribute value and optional `name`
-     * property specifying a view element name from/on which the attribute should be converted. `value` can be given as a `String`,
-     * a `RegExp` or a function callback, that takes view attribute value as the only parameter and returns `Boolean`.
-     * @param config.model Model attribute key or an object with `key` and `value` properties, describing
-     * the model attribute. `value` property may be set as a function that takes a view element and
-     * {@link module:engine/conversion/upcastdispatcher~UpcastConversionApi upcast conversion API} and returns the value.
-     * If `String` is given, the model attribute value will be same as view attribute value.
-     * @param config.converterPriority Converter priority. Defaults to `low`.
-     */
-    attributeToAttribute(config) {
-        return this.add(upcastAttributeToAttribute(config));
-    }
-    /**
-     * View element to model marker conversion helper.
-     *
-     * This conversion results in creating a model marker. For example, if the marker was stored in a view as an element:
-     * `<p>Fo<span data-marker="comment" data-comment-id="7"></span>o</p><p>B<span data-marker="comment" data-comment-id="7"></span>ar</p>`,
-     * after the conversion is done, the marker will be available in
-     * {@link module:engine/model/model~Model#markers model document markers}.
-     *
-     * **Note**: When this helper is used in the data upcast in combination with
-     * {@link module:engine/conversion/downcasthelpers~DowncastHelpers#markerToData `#markerToData()`} in the data downcast,
-     * then invalid HTML code (e.g. a span between table cells) may be produced by the latter converter.
-     *
-     * In most of the cases, the {@link #dataToMarker} should be used instead.
-     *
-     * ```ts
-     * editor.conversion.for( 'upcast' ).elementToMarker( {
-     * 	view: 'marker-search',
-     * 	model: 'search'
-     * } );
-     *
-     * editor.conversion.for( 'upcast' ).elementToMarker( {
-     * 	view: 'marker-search',
-     * 	model: 'search',
-     * 	converterPriority: 'high'
-     * } );
-     *
-     * editor.conversion.for( 'upcast' ).elementToMarker( {
-     * 	view: 'marker-search',
-     * 	model: ( viewElement, conversionApi ) => 'comment:' + viewElement.getAttribute( 'data-comment-id' )
-     * } );
-     *
-     * editor.conversion.for( 'upcast' ).elementToMarker( {
-     * 	view: {
-     * 		name: 'span',
-     * 		attributes: {
-     * 			'data-marker': 'search'
-     * 		}
-     * 	},
-     * 	model: 'search'
-     * } );
-     * ```
-     *
-     * See {@link module:engine/conversion/conversion~Conversion#for `conversion.for()`} to learn how to add a converter
-     * to the conversion process.
-     *
-     * @param config Conversion configuration.
-     * @param config.view Pattern matching all view elements which should be converted.
-     * @param config.model Name of the model marker, or a function that takes a view element and returns
-     * a model marker name.
-     * @param config.converterPriority Converter priority.
-     */
-    elementToMarker(config) {
-        return this.add(upcastElementToMarker(config));
-    }
-    /**
-     * View-to-model marker conversion helper.
-     *
-     * Converts view data created by {@link module:engine/conversion/downcasthelpers~DowncastHelpers#markerToData `#markerToData()`}
-     * back to a model marker.
-     *
-     * This converter looks for specific view elements and view attributes that mark marker boundaries. See
-     * {@link module:engine/conversion/downcasthelpers~DowncastHelpers#markerToData `#markerToData()`} to learn what view data
-     * is expected by this converter.
-     *
-     * The `config.view` property is equal to the marker group name to convert.
-     *
-     * By default, this converter creates markers with the `group:name` name convention (to match the default `markerToData` conversion).
-     *
-     * The conversion configuration can take a function that will generate a marker name.
-     * If such function is set as the `config.model` parameter, it is passed the `name` part from the view element or attribute and it is
-     * expected to return a string with the marker name.
-     *
-     * Basic usage:
-     *
-     * ```ts
-     * // Using the default conversion.
-     * // In this case, all markers from the `comment` group will be converted.
-     * // The conversion will look for `<comment-start>` and `<comment-end>` tags and
-     * // `data-comment-start-before`, `data-comment-start-after`,
-     * // `data-comment-end-before` and `data-comment-end-after` attributes.
-     * editor.conversion.for( 'upcast' ).dataToMarker( {
-     * 	view: 'comment'
-     * } );
-     * ```
-     *
-     * An example of a model that may be generated by this conversion:
-     *
-     * ```
-     * // View:
-     * <p>Foo<comment-start name="commentId:uid"></comment-start>bar</p>
-     * <figure data-comment-end-after="commentId:uid" class="image"><img src="abc.jpg" /></figure>
-     *
-     * // Model:
-     * <paragraph>Foo[bar</paragraph>
-     * <imageBlock src="abc.jpg"></imageBlock>]
-     * ```
-     *
-     * Where `[]` are boundaries of a marker that will receive the `comment:commentId:uid` name.
-     *
-     * Other examples of usage:
-     *
-     * ```ts
-     * // Using a custom function which is the same as the default conversion:
-     * editor.conversion.for( 'upcast' ).dataToMarker( {
-     * 	view: 'comment',
-     * 	model: ( name, conversionApi ) => 'comment:' + name,
-     * } );
-     *
-     * // Using the converter priority:
-     * editor.conversion.for( 'upcast' ).dataToMarker( {
-     * 	view: 'comment',
-     * 	model: ( name, conversionApi ) => 'comment:' + name,
-     * 	converterPriority: 'high'
-     * } );
-     * ```
-     *
-     * See {@link module:engine/conversion/conversion~Conversion#for `conversion.for()`} to learn how to add a converter
-     * to the conversion process.
-     *
-     * @param config Conversion configuration.
-     * @param config.view The marker group name to convert.
-     * @param config.model A function that takes the `name` part from the view element or attribute and
-     * {@link module:engine/conversion/upcastdispatcher~UpcastConversionApi upcast conversion API} and returns the marker name.
-     * @param config.converterPriority Converter priority.
-     */
-    dataToMarker(config) {
-        return this.add(upcastDataToMarker(config));
-    }
-}
-/**
- * Function factory, creates a converter that converts {@link module:engine/view/documentfragment~DocumentFragment view document fragment}
- * or all children of {@link module:engine/view/element~Element} into
- * {@link module:engine/model/documentfragment~DocumentFragment model document fragment}.
- * This is the "entry-point" converter for upcast (view to model conversion). This converter starts the conversion of all children
- * of passed view document fragment. Those children {@link module:engine/view/node~Node view nodes} are then handled by other converters.
- *
- * This also a "default", last resort converter for all view elements that has not been converted by other converters.
- * When a view element is being converted to the model but it does not have converter specified, that view element
- * will be converted to {@link module:engine/model/documentfragment~DocumentFragment model document fragment} and returned.
- *
- * @returns Universal converter for view {@link module:engine/view/documentfragment~DocumentFragment fragments} and
- * {@link module:engine/view/element~Element elements} that returns
- * {@link module:engine/model/documentfragment~DocumentFragment model fragment} with children of converted view item.
- */
-export function convertToModelFragment() {
-    return (evt, data, conversionApi) => {
-        // Second argument in `consumable.consume` is discarded for ViewDocumentFragment but is needed for ViewElement.
-        if (!data.modelRange && conversionApi.consumable.consume(data.viewItem, { name: true })) {
-            const { modelRange, modelCursor } = conversionApi.convertChildren(data.viewItem, data.modelCursor);
-            data.modelRange = modelRange;
-            data.modelCursor = modelCursor;
-        }
-    };
-}
-/**
- * Function factory, creates a converter that converts {@link module:engine/view/text~Text} to {@link module:engine/model/text~Text}.
- *
- * @returns {@link module:engine/view/text~Text View text} converter.
- */
-export function convertText() {
-    return (evt, data, { schema, consumable, writer }) => {
-        let position = data.modelCursor;
-        // When node is already converted then do nothing.
-        if (!consumable.test(data.viewItem)) {
-            return;
-        }
-        if (!schema.checkChild(position, '$text')) {
-            if (!isParagraphable(position, '$text', schema)) {
-                return;
-            }
-            // Do not auto-paragraph whitespaces.
-            if (data.viewItem.data.trim().length == 0) {
-                return;
-            }
-            // Wrap `$text` in paragraph and include any marker that is directly before `$text`. See #13053.
-            const nodeBefore = position.nodeBefore;
-            position = wrapInParagraph(position, writer);
-            if (nodeBefore && nodeBefore.is('element', '$marker')) {
-                // Move `$marker` to the paragraph.
-                writer.move(writer.createRangeOn(nodeBefore), position);
-                position = writer.createPositionAfter(nodeBefore);
-            }
-        }
-        consumable.consume(data.viewItem);
-        const text = writer.createText(data.viewItem.data);
-        writer.insert(text, position);
-        data.modelRange = writer.createRange(position, position.getShiftedBy(text.offsetSize));
-        data.modelCursor = data.modelRange.end;
-    };
-}
-/**
- * Function factory, creates a callback function which converts a {@link module:engine/view/selection~Selection
- * view selection} taken from the {@link module:engine/view/document~Document#event:selectionChange} event
- * and sets in on the {@link module:engine/model/document~Document#selection model}.
- *
- * **Note**: because there is no view selection change dispatcher nor any other advanced view selection to model
- * conversion mechanism, the callback should be set directly on view document.
- *
- * ```ts
- * view.document.on( 'selectionChange', convertSelectionChange( modelDocument, mapper ) );
- * ```
- *
- * @param model Data model.
- * @param mapper Conversion mapper.
- * @returns {@link module:engine/view/document~Document#event:selectionChange} callback function.
- */
-export function convertSelectionChange(model, mapper) {
-    return (evt, data) => {
-        const viewSelection = data.newSelection;
-        const ranges = [];
-        for (const viewRange of viewSelection.getRanges()) {
-            ranges.push(mapper.toModelRange(viewRange));
-        }
-        const modelSelection = model.createSelection(ranges, { backward: viewSelection.isBackward });
-        if (!modelSelection.isEqual(model.document.selection)) {
-            model.change(writer => {
-                writer.setSelection(modelSelection);
-            });
-        }
-    };
-}
-/**
- * View element to model element conversion helper.
- *
- * See {@link ~UpcastHelpers#elementToElement `.elementToElement()` upcast helper} for examples.
- *
- * @param config Conversion configuration.
- * @param config.view Pattern matching all view elements which should be converted. If not
- * set, the converter will fire for every view element.
- * @param config.model Name of the model element, a model element
- * instance or a function that takes a view element and returns a model element. The model element will be inserted in the model.
- * @param config.converterPriority Converter priority.
- * @returns Conversion helper.
- */
-function upcastElementToElement(config) {
-    config = cloneDeep(config);
-    const converter = prepareToElementConverter(config);
-    const elementName = getViewElementNameFromConfig(config.view);
-    const eventName = elementName ? `element:${elementName}` : 'element';
-    return (dispatcher) => {
-        dispatcher.on(eventName, converter, { priority: config.converterPriority || 'normal' });
-    };
-}
-/**
- * View element to model attribute conversion helper.
- *
- * See {@link ~UpcastHelpers#elementToAttribute `.elementToAttribute()` upcast helper} for examples.
- *
- * @param config Conversion configuration.
- * @param config.view Pattern matching all view elements which should be converted.
- * @param config.model Model attribute key or an object with `key` and `value` properties, describing
- * the model attribute. `value` property may be set as a function that takes a view element and returns the value.
- * If `String` is given, the model attribute value will be set to `true`.
- * @param config.converterPriority Converter priority. Defaults to `low`.
- * @returns Conversion helper.
- */
-function upcastElementToAttribute(config) {
-    config = cloneDeep(config);
-    normalizeModelAttributeConfig(config);
-    const converter = prepareToAttributeConverter(config, false);
-    const elementName = getViewElementNameFromConfig(config.view);
-    const eventName = elementName ? `element:${elementName}` : 'element';
-    return (dispatcher) => {
-        dispatcher.on(eventName, converter, { priority: config.converterPriority || 'low' });
-    };
-}
-/**
- * View attribute to model attribute conversion helper.
- *
- * See {@link ~UpcastHelpers#attributeToAttribute `.attributeToAttribute()` upcast helper} for examples.
- *
- * @param config Conversion configuration.
- * @param config.view Specifies which view attribute will be converted. If a `String` is passed,
- * attributes with given key will be converted. If an `Object` is passed, it must have a required `key` property,
- * specifying view attribute key, and may have an optional `value` property, specifying view attribute value and optional `name`
- * property specifying a view element name from/on which the attribute should be converted. `value` can be given as a `String`,
- * a `RegExp` or a function callback, that takes view attribute value as the only parameter and returns `Boolean`.
- * @param config.model Model attribute key or an object with `key` and `value` properties, describing
- * the model attribute. `value` property may be set as a function that takes a view element and returns the value.
- * If `String` is given, the model attribute value will be same as view attribute value.
- * @param config.converterPriority Converter priority. Defaults to `low`.
- * @returns Conversion helper.
- */
-function upcastAttributeToAttribute(config) {
-    config = cloneDeep(config);
-    let viewKey = null;
-    if (typeof config.view == 'string' || config.view.key) {
-        viewKey = normalizeViewAttributeKeyValueConfig(config);
-    }
-    normalizeModelAttributeConfig(config, viewKey);
-    const converter = prepareToAttributeConverter(config, true);
-    return (dispatcher) => {
-        dispatcher.on('element', converter, { priority: config.converterPriority || 'low' });
-    };
-}
-/**
- * View element to model marker conversion helper.
- *
- * See {@link ~UpcastHelpers#elementToMarker `.elementToMarker()` upcast helper} for examples.
- *
- * @param config Conversion configuration.
- * @param config.view Pattern matching all view elements which should be converted.
- * @param config.model Name of the model marker, or a function that takes a view element and returns
- * a model marker name.
- * @param config.converterPriority Converter priority.
- * @returns Conversion helper.
- */
-function upcastElementToMarker(config) {
-    const model = normalizeElementToMarkerModelConfig(config.model);
-    return upcastElementToElement({ ...config, model });
-}
-/**
- * View data to model marker conversion helper.
- *
- * See {@link ~UpcastHelpers#dataToMarker} to learn more.
- *
- * @returns Conversion helper.
- */
-function upcastDataToMarker(config) {
-    config = cloneDeep(config);
-    // Default conversion.
-    if (!config.model) {
-        config.model = name => {
-            return name ? config.view + ':' + name : config.view;
-        };
-    }
-    const normalizedConfig = {
-        view: config.view,
-        model: config.model
-    };
-    const converterStart = prepareToElementConverter(normalizeDataToMarkerConfig(normalizedConfig, 'start'));
-    const converterEnd = prepareToElementConverter(normalizeDataToMarkerConfig(normalizedConfig, 'end'));
-    return (dispatcher) => {
-        dispatcher.on(`element:${config.view}-start`, converterStart, { priority: config.converterPriority || 'normal' });
-        dispatcher.on(`element:${config.view}-end`, converterEnd, { priority: config.converterPriority || 'normal' });
-        // Below is a hack that is needed to properly handle `converterPriority` for both elements and attributes.
-        // Attribute conversion needs to be performed *after* element conversion.
-        // This converter handles both element conversion and attribute conversion, which means that if a single
-        // `config.converterPriority` is used, it will lead to problems. For example, if the `'high'` priority is used,
-        // the attribute conversion will be performed before a lot of element upcast converters.
-        // On the other hand, we want to support `config.converterPriority` and converter overwriting.
-        //
-        // To make it work, we need to do some extra processing for priority for attribute converter.
-        // Priority `'low'` value should be the base value and then we will change it depending on `config.converterPriority` value.
-        //
-        // This hack probably would not be needed if attributes are upcasted separately.
-        //
-        const basePriority = priorities.low;
-        const maxPriority = priorities.highest;
-        const priorityFactor = priorities.get(config.converterPriority) / maxPriority; // Number in range [ -1, 1 ].
-        dispatcher.on('element', upcastAttributeToMarker(normalizedConfig), { priority: basePriority + priorityFactor });
-    };
-}
-/**
- * Function factory, returns a callback function which converts view attributes to a model marker.
- *
- * The converter looks for elements with `data-group-start-before`, `data-group-start-after`, `data-group-end-before`
- * and `data-group-end-after` attributes and inserts `$marker` model elements before/after those elements.
- * `group` part is specified in `config.view`.
- *
- * @returns Marker converter.
- */
-function upcastAttributeToMarker(config) {
-    return (evt, data, conversionApi) => {
-        const attrName = `data-${config.view}`;
-        // Check if any attribute for the given view item can be consumed before changing the conversion data
-        // and consuming view items with these attributes.
-        if (!conversionApi.consumable.test(data.viewItem, { attributes: attrName + '-end-after' }) &&
-            !conversionApi.consumable.test(data.viewItem, { attributes: attrName + '-start-after' }) &&
-            !conversionApi.consumable.test(data.viewItem, { attributes: attrName + '-end-before' }) &&
-            !conversionApi.consumable.test(data.viewItem, { attributes: attrName + '-start-before' })) {
-            return;
-        }
-        // This converter wants to add a model element, marking a marker, before/after an element (or maybe even group of elements).
-        // To do that, we can use `data.modelRange` which is set on an element (or a group of elements) that has been upcasted.
-        // But, if the processed view element has not been upcasted yet (it does not have been converted), we need to
-        // fire conversion for its children first, then we will have `data.modelRange` available.
-        if (!data.modelRange) {
-            Object.assign(data, conversionApi.convertChildren(data.viewItem, data.modelCursor));
-        }
-        if (conversionApi.consumable.consume(data.viewItem, { attributes: attrName + '-end-after' })) {
-            addMarkerElements(data.modelRange.end, data.viewItem.getAttribute(attrName + '-end-after').split(','));
-        }
-        if (conversionApi.consumable.consume(data.viewItem, { attributes: attrName + '-start-after' })) {
-            addMarkerElements(data.modelRange.end, data.viewItem.getAttribute(attrName + '-start-after').split(','));
-        }
-        if (conversionApi.consumable.consume(data.viewItem, { attributes: attrName + '-end-before' })) {
-            addMarkerElements(data.modelRange.start, data.viewItem.getAttribute(attrName + '-end-before').split(','));
-        }
-        if (conversionApi.consumable.consume(data.viewItem, { attributes: attrName + '-start-before' })) {
-            addMarkerElements(data.modelRange.start, data.viewItem.getAttribute(attrName + '-start-before').split(','));
-        }
-        function addMarkerElements(position, markerViewNames) {
-            for (const markerViewName of markerViewNames) {
-                const markerName = config.model(markerViewName, conversionApi);
-                const element = conversionApi.writer.createElement('$marker', { 'data-name': markerName });
-                conversionApi.writer.insert(element, position);
-                if (data.modelCursor.isEqual(position)) {
-                    data.modelCursor = data.modelCursor.getShiftedBy(1);
-                }
-                else {
-                    data.modelCursor = data.modelCursor._getTransformedByInsertion(position, 1);
-                }
-                data.modelRange = data.modelRange._getTransformedByInsertion(position, 1)[0];
-            }
-        }
-    };
-}
-/**
- * Helper function for from-view-element conversion. Checks if `config.view` directly specifies converted view element's name
- * and if so, returns it.
- *
- * @param config Conversion view config.
- * @returns View element name or `null` if name is not directly set.
- */
-function getViewElementNameFromConfig(viewConfig) {
-    if (typeof viewConfig == 'string') {
-        return viewConfig;
-    }
-    if (typeof viewConfig == 'object' && typeof viewConfig.name == 'string') {
-        return viewConfig.name;
-    }
-    return null;
-}
-/**
- * Helper for to-model-element conversion. Takes a config object and returns a proper converter function.
- *
- * @param config Conversion configuration.
- * @returns View to model converter.
- */
-function prepareToElementConverter(config) {
-    const matcher = new Matcher(config.view);
-    return (evt, data, conversionApi) => {
-        const matcherResult = matcher.match(data.viewItem);
-        if (!matcherResult) {
-            return;
-        }
-        const match = matcherResult.match;
-        // Force consuming element's name.
-        match.name = true;
-        if (!conversionApi.consumable.test(data.viewItem, match)) {
-            return;
-        }
-        const modelElement = getModelElement(config.model, data.viewItem, conversionApi);
-        if (!modelElement) {
-            return;
-        }
-        if (!conversionApi.safeInsert(modelElement, data.modelCursor)) {
-            return;
-        }
-        conversionApi.consumable.consume(data.viewItem, match);
-        conversionApi.convertChildren(data.viewItem, modelElement);
-        conversionApi.updateConversionResult(modelElement, data);
-    };
-}
-/**
- * Helper function for upcasting-to-element converter. Takes the model configuration, the converted view element
- * and a writer instance and returns a model element instance to be inserted in the model.
- *
- * @param model Model conversion configuration.
- * @param input The converted view node.
- * @param conversionApi The upcast conversion API.
- */
-function getModelElement(model, input, conversionApi) {
-    if (model instanceof Function) {
-        return model(input, conversionApi);
-    }
-    else {
-        return conversionApi.writer.createElement(model);
-    }
-}
-/**
- * Helper function view-attribute-to-model-attribute helper. Normalizes `config.view` which was set as `String` or
- * as an `Object` with `key`, `value` and `name` properties. Normalized `config.view` has is compatible with
- * {@link module:engine/view/matcher~MatcherPattern}.
- *
- * @param config Conversion config.
- * @returns Key of the converted view attribute.
- */
-function normalizeViewAttributeKeyValueConfig(config) {
-    if (typeof config.view == 'string') {
-        config.view = { key: config.view };
-    }
-    const key = config.view.key;
-    let normalized;
-    if (key == 'class' || key == 'style') {
-        const keyName = key == 'class' ? 'classes' : 'styles';
-        normalized = {
-            [keyName]: config.view.value
-        };
-    }
-    else {
-        const value = typeof config.view.value == 'undefined' ? /[\s\S]*/ : config.view.value;
-        normalized = {
-            attributes: {
-                [key]: value
-            }
-        };
-    }
-    if (config.view.name) {
-        normalized.name = config.view.name;
-    }
-    config.view = normalized;
-    return key;
-}
-/**
- * Helper function that normalizes `config.model` in from-model-attribute conversion. `config.model` can be set
- * as a `String`, an `Object` with only `key` property or an `Object` with `key` and `value` properties. Normalized
- * `config.model` is an `Object` with `key` and `value` properties.
- *
- * @param config Conversion config.
- * @param viewAttributeKeyToCopy Key of the converted view attribute. If it is set, model attribute value
- * will be equal to view attribute value.
- */
-function normalizeModelAttributeConfig(config, viewAttributeKeyToCopy = null) {
-    const defaultModelValue = viewAttributeKeyToCopy === null ? true :
-        (viewElement) => viewElement.getAttribute(viewAttributeKeyToCopy);
-    const key = typeof config.model != 'object' ? config.model : config.model.key;
-    const value = typeof config.model != 'object' || typeof config.model.value == 'undefined' ? defaultModelValue : config.model.value;
-    config.model = { key, value };
-}
-/**
- * Helper for to-model-attribute conversion. Takes the model attribute name and conversion configuration and returns
- * a proper converter function.
- *
- * @param config Conversion configuration. It is possible to provide multiple configurations in an array.
- * @param shallow If set to `true` the attribute will be set only on top-level nodes. Otherwise, it will be set
- * on all elements in the range.
- */
-function prepareToAttributeConverter(config, shallow) {
-    const matcher = new Matcher(config.view);
-    return (evt, data, conversionApi) => {
-        // Converting an attribute of an element that has not been converted to anything does not make sense
-        // because there will be nowhere to set that attribute on. At this stage, the element should've already
-        // been converted (https://github.com/ckeditor/ckeditor5/issues/11000).
-        if (!data.modelRange && shallow) {
-            return;
-        }
-        const match = matcher.match(data.viewItem);
-        // If there is no match, this callback should not do anything.
-        if (!match) {
-            return;
-        }
-        if (onlyViewNameIsDefined(config.view, data.viewItem)) {
-            match.match.name = true;
-        }
-        else {
-            // Do not test `name` consumable because it could get consumed already while upcasting some other attribute
-            // on the same element (for example <span class="big" style="color: red">foo</span>).
-            delete match.match.name;
-        }
-        // Try to consume appropriate values from consumable values list.
-        if (!conversionApi.consumable.test(data.viewItem, match.match)) {
-            return;
-        }
-        const modelKey = config.model.key;
-        const modelValue = typeof config.model.value == 'function' ?
-            config.model.value(data.viewItem, conversionApi) : config.model.value;
-        // Do not convert if attribute building function returned falsy value.
-        if (modelValue === null) {
-            return;
-        }
-        // Since we are converting to attribute we need a range on which we will set the attribute.
-        // If the range is not created yet, let's create it by converting children of the current node first.
-        if (!data.modelRange) {
-            // Convert children and set conversion result as a current data.
-            Object.assign(data, conversionApi.convertChildren(data.viewItem, data.modelCursor));
-        }
-        // Set attribute on current `output`. `Schema` is checked inside this helper function.
-        const attributeWasSet = setAttributeOn(data.modelRange, { key: modelKey, value: modelValue }, shallow, conversionApi);
-        // It may happen that a converter will try to set an attribute that is not allowed in the given context.
-        // In such a situation we cannot consume the attribute. See: https://github.com/ckeditor/ckeditor5/pull/9249#issuecomment-815658459.
-        if (attributeWasSet) {
-            // Verify if the element itself wasn't consumed yet. It could be consumed already while upcasting some other attribute
-            // on the same element (for example <span class="big" style="color: red">foo</span>).
-            // We need to consume it so other features (especially GHS) won't try to convert it.
-            // Note that it's not tested by the other element-to-attribute converters whether an element was consumed before
-            // (in case of converters that the element itself is just a context and not the primary information to convert).
-            if (conversionApi.consumable.test(data.viewItem, { name: true })) {
-                match.match.name = true;
-            }
-            conversionApi.consumable.consume(data.viewItem, match.match);
-        }
-    };
-}
-/**
- * Helper function that checks if element name should be consumed in attribute converters.
- *
- * @param viewConfig Conversion view config.
- */
-function onlyViewNameIsDefined(viewConfig, viewItem) {
-    // https://github.com/ckeditor/ckeditor5-engine/issues/1786
-    const configToTest = typeof viewConfig == 'function' ? viewConfig(viewItem) : viewConfig;
-    if (typeof configToTest == 'object' && !getViewElementNameFromConfig(configToTest)) {
-        return false;
-    }
-    return !configToTest.classes && !configToTest.attributes && !configToTest.styles;
-}
-/**
- * Helper function for to-model-attribute converter. Sets model attribute on given range. Checks {@link module:engine/model/schema~Schema}
- * to ensure proper model structure.
- *
- * If any node on the given range has already defined an attribute with the same name, its value will not be updated.
- *
- * @param modelRange Model range on which attribute should be set.
- * @param modelAttribute Model attribute to set.
- * @param conversionApi Conversion API.
- * @param shallow If set to `true` the attribute will be set only on top-level nodes. Otherwise, it will be set
- * on all elements in the range.
- * @returns `true` if attribute was set on at least one node from given `modelRange`.
- */
-function setAttributeOn(modelRange, modelAttribute, shallow, conversionApi) {
-    let result = false;
-    // Set attribute on each item in range according to Schema.
-    for (const node of Array.from(modelRange.getItems({ shallow }))) {
-        // Skip if not allowed.
-        if (!conversionApi.schema.checkAttribute(node, modelAttribute.key)) {
-            continue;
-        }
-        // Mark the node as consumed even if the attribute will not be updated because it's in a valid context (schema)
-        // and would be converted if the attribute wouldn't be present. See #8921.
-        result = true;
-        // Do not override the attribute if it's already present.
-        if (node.hasAttribute(modelAttribute.key)) {
-            continue;
-        }
-        conversionApi.writer.setAttribute(modelAttribute.key, modelAttribute.value, node);
-    }
-    return result;
-}
-/**
- * Helper function for upcasting-to-marker conversion. Takes the config in a format requested by `upcastElementToMarker()`
- * function and converts it to a format that is supported by `upcastElementToElement()` function.
- */
-function normalizeElementToMarkerModelConfig(model) {
-    return (viewElement, conversionApi) => {
-        const markerName = typeof model == 'string' ? model : model(viewElement, conversionApi);
-        return conversionApi.writer.createElement('$marker', { 'data-name': markerName });
-    };
-}
-/**
- * Helper function for upcasting-to-marker conversion. Takes the config in a format requested by `upcastDataToMarker()`
- * function and converts it to a format that is supported by `upcastElementToElement()` function.
- */
-function normalizeDataToMarkerConfig(config, type) {
-    const elementCreatorFunction = (viewElement, conversionApi) => {
-        const viewName = viewElement.getAttribute('name');
-        const markerName = config.model(viewName, conversionApi);
-        return conversionApi.writer.createElement('$marker', { 'data-name': markerName });
-    };
-    return {
-        // Upcast <markerGroup-start> and <markerGroup-end> elements.
-        view: `${config.view}-${type}`,
-        model: elementCreatorFunction
-    };
-}
+/**
+ * @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 Matcher from '../view/matcher';
+import ConversionHelpers from './conversionhelpers';
+import { isParagraphable, wrapInParagraph } from '../model/utils/autoparagraphing';
+import { priorities } from '@ckeditor/ckeditor5-utils';
+import { cloneDeep } from 'lodash-es';
+/**
+ * Contains the {@link module:engine/view/view view} to {@link module:engine/model/model model} converters for
+ * {@link module:engine/conversion/upcastdispatcher~UpcastDispatcher}.
+ *
+ * @module engine/conversion/upcasthelpers
+ */
+/**
+ * Upcast conversion helper functions.
+ *
+ * Learn more about {@glink framework/deep-dive/conversion/upcast upcast helpers}.
+ *
+ * @extends module:engine/conversion/conversionhelpers~ConversionHelpers
+ */
+export default class UpcastHelpers extends ConversionHelpers {
+    /**
+     * View element to model element conversion helper.
+     *
+     * This conversion results in creating a model element. For example,
+     * view `<p>Foo</p>` becomes `<paragraph>Foo</paragraph>` in the model.
+     *
+     * Keep in mind that the element will be inserted only if it is allowed
+     * by {@link module:engine/model/schema~Schema schema} configuration.
+     *
+     * ```ts
+     * editor.conversion.for( 'upcast' ).elementToElement( {
+     * 	view: 'p',
+     * 	model: 'paragraph'
+     * } );
+     *
+     * editor.conversion.for( 'upcast' ).elementToElement( {
+     * 	view: 'p',
+     * 	model: 'paragraph',
+     * 	converterPriority: 'high'
+     * } );
+     *
+     * editor.conversion.for( 'upcast' ).elementToElement( {
+     * 	view: {
+     * 		name: 'p',
+     * 		classes: 'fancy'
+     * 	},
+     * 	model: 'fancyParagraph'
+     * } );
+     *
+     * editor.conversion.for( 'upcast' ).elementToElement( {
+     * 	view: {
+     * 		name: 'p',
+     * 		classes: 'heading'
+     * 	},
+     * 	model: ( viewElement, conversionApi ) => {
+     * 		const modelWriter = conversionApi.writer;
+     *
+     * 		return modelWriter.createElement( 'heading', { level: viewElement.getAttribute( 'data-level' ) } );
+     * 	}
+     * } );
+     * ```
+     *
+     * See {@link module:engine/conversion/conversion~Conversion#for `conversion.for()`} to learn how to add a converter
+     * to the conversion process.
+     *
+     * @param config Conversion configuration.
+     * @param config.view Pattern matching all view elements which should be converted. If not set, the converter
+     * will fire for every view element.
+     * @param config.model Name of the model element, a model element instance or a function that takes a view element
+     * and {@link module:engine/conversion/upcastdispatcher~UpcastConversionApi upcast conversion API}
+     * and returns a model element. The model element will be inserted in the model.
+     * @param config.converterPriority Converter priority.
+     */
+    elementToElement(config) {
+        return this.add(upcastElementToElement(config));
+    }
+    /**
+     * View element to model attribute conversion helper.
+     *
+     * This conversion results in setting an attribute on a model node. For example, view `<strong>Foo</strong>` becomes
+     * `Foo` {@link module:engine/model/text~Text model text node} with `bold` attribute set to `true`.
+     *
+     * This helper is meant to set a model attribute on all the elements that are inside the converted element:
+     *
+     * ```
+     * <strong>Foo</strong>   -->   <strong><p>Foo</p></strong>   -->   <paragraph><$text bold="true">Foo</$text></paragraph>
+     * ```
+     *
+     * Above is a sample of HTML code, that goes through autoparagraphing (first step) and then is converted (second step).
+     * Even though `<strong>` is over `<p>` element, `bold="true"` was added to the text. See
+     * {@link module:engine/conversion/upcasthelpers~UpcastHelpers#attributeToAttribute} for comparison.
+     *
+     * Keep in mind that the attribute will be set only if it is allowed by {@link module:engine/model/schema~Schema schema} configuration.
+     *
+     * ```ts
+     * editor.conversion.for( 'upcast' ).elementToAttribute( {
+     * 	view: 'strong',
+     * 	model: 'bold'
+     * } );
+     *
+     * editor.conversion.for( 'upcast' ).elementToAttribute( {
+     * 	view: 'strong',
+     * 	model: 'bold',
+     * 	converterPriority: 'high'
+     * } );
+     *
+     * editor.conversion.for( 'upcast' ).elementToAttribute( {
+     * 	view: {
+     * 		name: 'span',
+     * 		classes: 'bold'
+     * 	},
+     * 	model: 'bold'
+     * } );
+     *
+     * editor.conversion.for( 'upcast' ).elementToAttribute( {
+     * 	view: {
+     * 		name: 'span',
+     * 		classes: [ 'styled', 'styled-dark' ]
+     * 	},
+     * 	model: {
+     * 		key: 'styled',
+     * 		value: 'dark'
+     * 	}
+     * } );
+     *
+     * editor.conversion.for( 'upcast' ).elementToAttribute( {
+     * 	view: {
+     * 		name: 'span',
+     * 		styles: {
+     * 			'font-size': /[\s\S]+/
+     * 		}
+     * 	},
+     * 	model: {
+     * 		key: 'fontSize',
+     * 		value: ( viewElement, conversionApi ) => {
+     * 			const fontSize = viewElement.getStyle( 'font-size' );
+     * 			const value = fontSize.substr( 0, fontSize.length - 2 );
+     *
+     * 			if ( value <= 10 ) {
+     * 				return 'small';
+     * 			} else if ( value > 12 ) {
+     * 				return 'big';
+     * 			}
+     *
+     * 			return null;
+     * 		}
+     * 	}
+     * } );
+     * ```
+     *
+     * See {@link module:engine/conversion/conversion~Conversion#for `conversion.for()`} to learn how to add a converter
+     * to the conversion process.
+     *
+     * @param config Conversion configuration.
+     * @param config.view Pattern matching all view elements which should be converted.
+     * @param config.model Model attribute key or an object with `key` and `value` properties, describing
+     * the model attribute. `value` property may be set as a function that takes a view element and
+     * {@link module:engine/conversion/upcastdispatcher~UpcastConversionApi upcast conversion API} and returns the value.
+     * If `String` is given, the model attribute value will be set to `true`.
+     * @param config.converterPriority Converter priority. Defaults to `low`.
+     */
+    elementToAttribute(config) {
+        return this.add(upcastElementToAttribute(config));
+    }
+    /**
+     * View attribute to model attribute conversion helper.
+     *
+     * This conversion results in setting an attribute on a model node. For example, view `<img src="foo.jpg"></img>` becomes
+     * `<imageBlock source="foo.jpg"></imageBlock>` in the model.
+     *
+     * This helper is meant to convert view attributes from view elements which got converted to the model, so the view attribute
+     * is set only on the corresponding model node:
+     *
+     * ```
+     * <div class="dark"><div>foo</div></div>    -->    <div dark="true"><div>foo</div></div>
+     * ```
+     *
+     * Above, `class="dark"` attribute is added only to the `<div>` elements that has it. This is in contrast to
+     * {@link module:engine/conversion/upcasthelpers~UpcastHelpers#elementToAttribute} which sets attributes for
+     * all the children in the model:
+     *
+     * ```
+     * <strong>Foo</strong>   -->   <strong><p>Foo</p></strong>   -->   <paragraph><$text bold="true">Foo</$text></paragraph>
+     * ```
+     *
+     * Above is a sample of HTML code, that goes through autoparagraphing (first step) and then is converted (second step).
+     * Even though `<strong>` is over `<p>` element, `bold="true"` was added to the text.
+     *
+     * Keep in mind that the attribute will be set only if it is allowed by {@link module:engine/model/schema~Schema schema} configuration.
+     *
+     * ```ts
+     * editor.conversion.for( 'upcast' ).attributeToAttribute( {
+     * 	view: 'src',
+     * 	model: 'source'
+     * } );
+     *
+     * editor.conversion.for( 'upcast' ).attributeToAttribute( {
+     * 	view: { key: 'src' },
+     * 	model: 'source'
+     * } );
+     *
+     * editor.conversion.for( 'upcast' ).attributeToAttribute( {
+     * 	view: { key: 'src' },
+     * 	model: 'source',
+     * 	converterPriority: 'normal'
+     * } );
+     *
+     * editor.conversion.for( 'upcast' ).attributeToAttribute( {
+     * 	view: {
+     * 		key: 'data-style',
+     * 		value: /[\s\S]+/
+     * 	},
+     * 	model: 'styled'
+     * } );
+     *
+     * editor.conversion.for( 'upcast' ).attributeToAttribute( {
+     * 	view: {
+     * 		name: 'img',
+     * 		key: 'class',
+     * 		value: 'styled-dark'
+     * 	},
+     * 	model: {
+     * 		key: 'styled',
+     * 		value: 'dark'
+     * 	}
+     * } );
+     *
+     * editor.conversion.for( 'upcast' ).attributeToAttribute( {
+     * 	view: {
+     * 		key: 'class',
+     * 		value: /styled-[\S]+/
+     * 	},
+     * 	model: {
+     * 		key: 'styled'
+     * 		value: ( viewElement, conversionApi ) => {
+     * 			const regexp = /styled-([\S]+)/;
+     * 			const match = viewElement.getAttribute( 'class' ).match( regexp );
+     *
+     * 			return match[ 1 ];
+     * 		}
+     * 	}
+     * } );
+     * ```
+     *
+     * Converting styles works a bit differently as it requires `view.styles` to be an object and by default
+     * a model attribute will be set to `true` by such a converter. You can set the model attribute to any value by providing the `value`
+     * callback that returns the desired value.
+     *
+     * ```ts
+     * // Default conversion of font-weight style will result in setting bold attribute to true.
+     * editor.conversion.for( 'upcast' ).attributeToAttribute( {
+     * 	view: {
+     * 		styles: {
+     * 			'font-weight': 'bold'
+     * 		}
+     * 	},
+     * 	model: 'bold'
+     * } );
+     *
+     * // This converter will pass any style value to the `lineHeight` model attribute.
+     * editor.conversion.for( 'upcast' ).attributeToAttribute( {
+     * 	view: {
+     * 		styles: {
+     * 			'line-height': /[\s\S]+/
+     * 		}
+     * 	},
+     * 	model: {
+     * 		key: 'lineHeight',
+     * 		value: ( viewElement, conversionApi ) => viewElement.getStyle( 'line-height' )
+     * 	}
+     * } );
+     * ```
+     *
+     * See {@link module:engine/conversion/conversion~Conversion#for `conversion.for()`} to learn how to add a converter
+     * to the conversion process.
+     *
+     * @param config Conversion configuration.
+     * @param config.view Specifies which view attribute will be converted. If a `String` is passed,
+     * attributes with given key will be converted. If an `Object` is passed, it must have a required `key` property,
+     * specifying view attribute key, and may have an optional `value` property, specifying view attribute value and optional `name`
+     * property specifying a view element name from/on which the attribute should be converted. `value` can be given as a `String`,
+     * a `RegExp` or a function callback, that takes view attribute value as the only parameter and returns `Boolean`.
+     * @param config.model Model attribute key or an object with `key` and `value` properties, describing
+     * the model attribute. `value` property may be set as a function that takes a view element and
+     * {@link module:engine/conversion/upcastdispatcher~UpcastConversionApi upcast conversion API} and returns the value.
+     * If `String` is given, the model attribute value will be same as view attribute value.
+     * @param config.converterPriority Converter priority. Defaults to `low`.
+     */
+    attributeToAttribute(config) {
+        return this.add(upcastAttributeToAttribute(config));
+    }
+    /**
+     * View element to model marker conversion helper.
+     *
+     * This conversion results in creating a model marker. For example, if the marker was stored in a view as an element:
+     * `<p>Fo<span data-marker="comment" data-comment-id="7"></span>o</p><p>B<span data-marker="comment" data-comment-id="7"></span>ar</p>`,
+     * after the conversion is done, the marker will be available in
+     * {@link module:engine/model/model~Model#markers model document markers}.
+     *
+     * **Note**: When this helper is used in the data upcast in combination with
+     * {@link module:engine/conversion/downcasthelpers~DowncastHelpers#markerToData `#markerToData()`} in the data downcast,
+     * then invalid HTML code (e.g. a span between table cells) may be produced by the latter converter.
+     *
+     * In most of the cases, the {@link #dataToMarker} should be used instead.
+     *
+     * ```ts
+     * editor.conversion.for( 'upcast' ).elementToMarker( {
+     * 	view: 'marker-search',
+     * 	model: 'search'
+     * } );
+     *
+     * editor.conversion.for( 'upcast' ).elementToMarker( {
+     * 	view: 'marker-search',
+     * 	model: 'search',
+     * 	converterPriority: 'high'
+     * } );
+     *
+     * editor.conversion.for( 'upcast' ).elementToMarker( {
+     * 	view: 'marker-search',
+     * 	model: ( viewElement, conversionApi ) => 'comment:' + viewElement.getAttribute( 'data-comment-id' )
+     * } );
+     *
+     * editor.conversion.for( 'upcast' ).elementToMarker( {
+     * 	view: {
+     * 		name: 'span',
+     * 		attributes: {
+     * 			'data-marker': 'search'
+     * 		}
+     * 	},
+     * 	model: 'search'
+     * } );
+     * ```
+     *
+     * See {@link module:engine/conversion/conversion~Conversion#for `conversion.for()`} to learn how to add a converter
+     * to the conversion process.
+     *
+     * @param config Conversion configuration.
+     * @param config.view Pattern matching all view elements which should be converted.
+     * @param config.model Name of the model marker, or a function that takes a view element and returns
+     * a model marker name.
+     * @param config.converterPriority Converter priority.
+     */
+    elementToMarker(config) {
+        return this.add(upcastElementToMarker(config));
+    }
+    /**
+     * View-to-model marker conversion helper.
+     *
+     * Converts view data created by {@link module:engine/conversion/downcasthelpers~DowncastHelpers#markerToData `#markerToData()`}
+     * back to a model marker.
+     *
+     * This converter looks for specific view elements and view attributes that mark marker boundaries. See
+     * {@link module:engine/conversion/downcasthelpers~DowncastHelpers#markerToData `#markerToData()`} to learn what view data
+     * is expected by this converter.
+     *
+     * The `config.view` property is equal to the marker group name to convert.
+     *
+     * By default, this converter creates markers with the `group:name` name convention (to match the default `markerToData` conversion).
+     *
+     * The conversion configuration can take a function that will generate a marker name.
+     * If such function is set as the `config.model` parameter, it is passed the `name` part from the view element or attribute and it is
+     * expected to return a string with the marker name.
+     *
+     * Basic usage:
+     *
+     * ```ts
+     * // Using the default conversion.
+     * // In this case, all markers from the `comment` group will be converted.
+     * // The conversion will look for `<comment-start>` and `<comment-end>` tags and
+     * // `data-comment-start-before`, `data-comment-start-after`,
+     * // `data-comment-end-before` and `data-comment-end-after` attributes.
+     * editor.conversion.for( 'upcast' ).dataToMarker( {
+     * 	view: 'comment'
+     * } );
+     * ```
+     *
+     * An example of a model that may be generated by this conversion:
+     *
+     * ```
+     * // View:
+     * <p>Foo<comment-start name="commentId:uid"></comment-start>bar</p>
+     * <figure data-comment-end-after="commentId:uid" class="image"><img src="abc.jpg" /></figure>
+     *
+     * // Model:
+     * <paragraph>Foo[bar</paragraph>
+     * <imageBlock src="abc.jpg"></imageBlock>]
+     * ```
+     *
+     * Where `[]` are boundaries of a marker that will receive the `comment:commentId:uid` name.
+     *
+     * Other examples of usage:
+     *
+     * ```ts
+     * // Using a custom function which is the same as the default conversion:
+     * editor.conversion.for( 'upcast' ).dataToMarker( {
+     * 	view: 'comment',
+     * 	model: ( name, conversionApi ) => 'comment:' + name,
+     * } );
+     *
+     * // Using the converter priority:
+     * editor.conversion.for( 'upcast' ).dataToMarker( {
+     * 	view: 'comment',
+     * 	model: ( name, conversionApi ) => 'comment:' + name,
+     * 	converterPriority: 'high'
+     * } );
+     * ```
+     *
+     * See {@link module:engine/conversion/conversion~Conversion#for `conversion.for()`} to learn how to add a converter
+     * to the conversion process.
+     *
+     * @param config Conversion configuration.
+     * @param config.view The marker group name to convert.
+     * @param config.model A function that takes the `name` part from the view element or attribute and
+     * {@link module:engine/conversion/upcastdispatcher~UpcastConversionApi upcast conversion API} and returns the marker name.
+     * @param config.converterPriority Converter priority.
+     */
+    dataToMarker(config) {
+        return this.add(upcastDataToMarker(config));
+    }
+}
+/**
+ * Function factory, creates a converter that converts {@link module:engine/view/documentfragment~DocumentFragment view document fragment}
+ * or all children of {@link module:engine/view/element~Element} into
+ * {@link module:engine/model/documentfragment~DocumentFragment model document fragment}.
+ * This is the "entry-point" converter for upcast (view to model conversion). This converter starts the conversion of all children
+ * of passed view document fragment. Those children {@link module:engine/view/node~Node view nodes} are then handled by other converters.
+ *
+ * This also a "default", last resort converter for all view elements that has not been converted by other converters.
+ * When a view element is being converted to the model but it does not have converter specified, that view element
+ * will be converted to {@link module:engine/model/documentfragment~DocumentFragment model document fragment} and returned.
+ *
+ * @returns Universal converter for view {@link module:engine/view/documentfragment~DocumentFragment fragments} and
+ * {@link module:engine/view/element~Element elements} that returns
+ * {@link module:engine/model/documentfragment~DocumentFragment model fragment} with children of converted view item.
+ */
+export function convertToModelFragment() {
+    return (evt, data, conversionApi) => {
+        // Second argument in `consumable.consume` is discarded for ViewDocumentFragment but is needed for ViewElement.
+        if (!data.modelRange && conversionApi.consumable.consume(data.viewItem, { name: true })) {
+            const { modelRange, modelCursor } = conversionApi.convertChildren(data.viewItem, data.modelCursor);
+            data.modelRange = modelRange;
+            data.modelCursor = modelCursor;
+        }
+    };
+}
+/**
+ * Function factory, creates a converter that converts {@link module:engine/view/text~Text} to {@link module:engine/model/text~Text}.
+ *
+ * @returns {@link module:engine/view/text~Text View text} converter.
+ */
+export function convertText() {
+    return (evt, data, { schema, consumable, writer }) => {
+        let position = data.modelCursor;
+        // When node is already converted then do nothing.
+        if (!consumable.test(data.viewItem)) {
+            return;
+        }
+        if (!schema.checkChild(position, '$text')) {
+            if (!isParagraphable(position, '$text', schema)) {
+                return;
+            }
+            // Do not auto-paragraph whitespaces.
+            if (data.viewItem.data.trim().length == 0) {
+                return;
+            }
+            // Wrap `$text` in paragraph and include any marker that is directly before `$text`. See #13053.
+            const nodeBefore = position.nodeBefore;
+            position = wrapInParagraph(position, writer);
+            if (nodeBefore && nodeBefore.is('element', '$marker')) {
+                // Move `$marker` to the paragraph.
+                writer.move(writer.createRangeOn(nodeBefore), position);
+                position = writer.createPositionAfter(nodeBefore);
+            }
+        }
+        consumable.consume(data.viewItem);
+        const text = writer.createText(data.viewItem.data);
+        writer.insert(text, position);
+        data.modelRange = writer.createRange(position, position.getShiftedBy(text.offsetSize));
+        data.modelCursor = data.modelRange.end;
+    };
+}
+/**
+ * Function factory, creates a callback function which converts a {@link module:engine/view/selection~Selection
+ * view selection} taken from the {@link module:engine/view/document~Document#event:selectionChange} event
+ * and sets in on the {@link module:engine/model/document~Document#selection model}.
+ *
+ * **Note**: because there is no view selection change dispatcher nor any other advanced view selection to model
+ * conversion mechanism, the callback should be set directly on view document.
+ *
+ * ```ts
+ * view.document.on( 'selectionChange', convertSelectionChange( modelDocument, mapper ) );
+ * ```
+ *
+ * @param model Data model.
+ * @param mapper Conversion mapper.
+ * @returns {@link module:engine/view/document~Document#event:selectionChange} callback function.
+ */
+export function convertSelectionChange(model, mapper) {
+    return (evt, data) => {
+        const viewSelection = data.newSelection;
+        const ranges = [];
+        for (const viewRange of viewSelection.getRanges()) {
+            ranges.push(mapper.toModelRange(viewRange));
+        }
+        const modelSelection = model.createSelection(ranges, { backward: viewSelection.isBackward });
+        if (!modelSelection.isEqual(model.document.selection)) {
+            model.change(writer => {
+                writer.setSelection(modelSelection);
+            });
+        }
+    };
+}
+/**
+ * View element to model element conversion helper.
+ *
+ * See {@link ~UpcastHelpers#elementToElement `.elementToElement()` upcast helper} for examples.
+ *
+ * @param config Conversion configuration.
+ * @param config.view Pattern matching all view elements which should be converted. If not
+ * set, the converter will fire for every view element.
+ * @param config.model Name of the model element, a model element
+ * instance or a function that takes a view element and returns a model element. The model element will be inserted in the model.
+ * @param config.converterPriority Converter priority.
+ * @returns Conversion helper.
+ */
+function upcastElementToElement(config) {
+    config = cloneDeep(config);
+    const converter = prepareToElementConverter(config);
+    const elementName = getViewElementNameFromConfig(config.view);
+    const eventName = elementName ? `element:${elementName}` : 'element';
+    return (dispatcher) => {
+        dispatcher.on(eventName, converter, { priority: config.converterPriority || 'normal' });
+    };
+}
+/**
+ * View element to model attribute conversion helper.
+ *
+ * See {@link ~UpcastHelpers#elementToAttribute `.elementToAttribute()` upcast helper} for examples.
+ *
+ * @param config Conversion configuration.
+ * @param config.view Pattern matching all view elements which should be converted.
+ * @param config.model Model attribute key or an object with `key` and `value` properties, describing
+ * the model attribute. `value` property may be set as a function that takes a view element and returns the value.
+ * If `String` is given, the model attribute value will be set to `true`.
+ * @param config.converterPriority Converter priority. Defaults to `low`.
+ * @returns Conversion helper.
+ */
+function upcastElementToAttribute(config) {
+    config = cloneDeep(config);
+    normalizeModelAttributeConfig(config);
+    const converter = prepareToAttributeConverter(config, false);
+    const elementName = getViewElementNameFromConfig(config.view);
+    const eventName = elementName ? `element:${elementName}` : 'element';
+    return (dispatcher) => {
+        dispatcher.on(eventName, converter, { priority: config.converterPriority || 'low' });
+    };
+}
+/**
+ * View attribute to model attribute conversion helper.
+ *
+ * See {@link ~UpcastHelpers#attributeToAttribute `.attributeToAttribute()` upcast helper} for examples.
+ *
+ * @param config Conversion configuration.
+ * @param config.view Specifies which view attribute will be converted. If a `String` is passed,
+ * attributes with given key will be converted. If an `Object` is passed, it must have a required `key` property,
+ * specifying view attribute key, and may have an optional `value` property, specifying view attribute value and optional `name`
+ * property specifying a view element name from/on which the attribute should be converted. `value` can be given as a `String`,
+ * a `RegExp` or a function callback, that takes view attribute value as the only parameter and returns `Boolean`.
+ * @param config.model Model attribute key or an object with `key` and `value` properties, describing
+ * the model attribute. `value` property may be set as a function that takes a view element and returns the value.
+ * If `String` is given, the model attribute value will be same as view attribute value.
+ * @param config.converterPriority Converter priority. Defaults to `low`.
+ * @returns Conversion helper.
+ */
+function upcastAttributeToAttribute(config) {
+    config = cloneDeep(config);
+    let viewKey = null;
+    if (typeof config.view == 'string' || config.view.key) {
+        viewKey = normalizeViewAttributeKeyValueConfig(config);
+    }
+    normalizeModelAttributeConfig(config, viewKey);
+    const converter = prepareToAttributeConverter(config, true);
+    return (dispatcher) => {
+        dispatcher.on('element', converter, { priority: config.converterPriority || 'low' });
+    };
+}
+/**
+ * View element to model marker conversion helper.
+ *
+ * See {@link ~UpcastHelpers#elementToMarker `.elementToMarker()` upcast helper} for examples.
+ *
+ * @param config Conversion configuration.
+ * @param config.view Pattern matching all view elements which should be converted.
+ * @param config.model Name of the model marker, or a function that takes a view element and returns
+ * a model marker name.
+ * @param config.converterPriority Converter priority.
+ * @returns Conversion helper.
+ */
+function upcastElementToMarker(config) {
+    const model = normalizeElementToMarkerModelConfig(config.model);
+    return upcastElementToElement({ ...config, model });
+}
+/**
+ * View data to model marker conversion helper.
+ *
+ * See {@link ~UpcastHelpers#dataToMarker} to learn more.
+ *
+ * @returns Conversion helper.
+ */
+function upcastDataToMarker(config) {
+    config = cloneDeep(config);
+    // Default conversion.
+    if (!config.model) {
+        config.model = name => {
+            return name ? config.view + ':' + name : config.view;
+        };
+    }
+    const normalizedConfig = {
+        view: config.view,
+        model: config.model
+    };
+    const converterStart = prepareToElementConverter(normalizeDataToMarkerConfig(normalizedConfig, 'start'));
+    const converterEnd = prepareToElementConverter(normalizeDataToMarkerConfig(normalizedConfig, 'end'));
+    return (dispatcher) => {
+        dispatcher.on(`element:${config.view}-start`, converterStart, { priority: config.converterPriority || 'normal' });
+        dispatcher.on(`element:${config.view}-end`, converterEnd, { priority: config.converterPriority || 'normal' });
+        // Below is a hack that is needed to properly handle `converterPriority` for both elements and attributes.
+        // Attribute conversion needs to be performed *after* element conversion.
+        // This converter handles both element conversion and attribute conversion, which means that if a single
+        // `config.converterPriority` is used, it will lead to problems. For example, if the `'high'` priority is used,
+        // the attribute conversion will be performed before a lot of element upcast converters.
+        // On the other hand, we want to support `config.converterPriority` and converter overwriting.
+        //
+        // To make it work, we need to do some extra processing for priority for attribute converter.
+        // Priority `'low'` value should be the base value and then we will change it depending on `config.converterPriority` value.
+        //
+        // This hack probably would not be needed if attributes are upcasted separately.
+        //
+        const basePriority = priorities.low;
+        const maxPriority = priorities.highest;
+        const priorityFactor = priorities.get(config.converterPriority) / maxPriority; // Number in range [ -1, 1 ].
+        dispatcher.on('element', upcastAttributeToMarker(normalizedConfig), { priority: basePriority + priorityFactor });
+    };
+}
+/**
+ * Function factory, returns a callback function which converts view attributes to a model marker.
+ *
+ * The converter looks for elements with `data-group-start-before`, `data-group-start-after`, `data-group-end-before`
+ * and `data-group-end-after` attributes and inserts `$marker` model elements before/after those elements.
+ * `group` part is specified in `config.view`.
+ *
+ * @returns Marker converter.
+ */
+function upcastAttributeToMarker(config) {
+    return (evt, data, conversionApi) => {
+        const attrName = `data-${config.view}`;
+        // Check if any attribute for the given view item can be consumed before changing the conversion data
+        // and consuming view items with these attributes.
+        if (!conversionApi.consumable.test(data.viewItem, { attributes: attrName + '-end-after' }) &&
+            !conversionApi.consumable.test(data.viewItem, { attributes: attrName + '-start-after' }) &&
+            !conversionApi.consumable.test(data.viewItem, { attributes: attrName + '-end-before' }) &&
+            !conversionApi.consumable.test(data.viewItem, { attributes: attrName + '-start-before' })) {
+            return;
+        }
+        // This converter wants to add a model element, marking a marker, before/after an element (or maybe even group of elements).
+        // To do that, we can use `data.modelRange` which is set on an element (or a group of elements) that has been upcasted.
+        // But, if the processed view element has not been upcasted yet (it does not have been converted), we need to
+        // fire conversion for its children first, then we will have `data.modelRange` available.
+        if (!data.modelRange) {
+            Object.assign(data, conversionApi.convertChildren(data.viewItem, data.modelCursor));
+        }
+        if (conversionApi.consumable.consume(data.viewItem, { attributes: attrName + '-end-after' })) {
+            addMarkerElements(data.modelRange.end, data.viewItem.getAttribute(attrName + '-end-after').split(','));
+        }
+        if (conversionApi.consumable.consume(data.viewItem, { attributes: attrName + '-start-after' })) {
+            addMarkerElements(data.modelRange.end, data.viewItem.getAttribute(attrName + '-start-after').split(','));
+        }
+        if (conversionApi.consumable.consume(data.viewItem, { attributes: attrName + '-end-before' })) {
+            addMarkerElements(data.modelRange.start, data.viewItem.getAttribute(attrName + '-end-before').split(','));
+        }
+        if (conversionApi.consumable.consume(data.viewItem, { attributes: attrName + '-start-before' })) {
+            addMarkerElements(data.modelRange.start, data.viewItem.getAttribute(attrName + '-start-before').split(','));
+        }
+        function addMarkerElements(position, markerViewNames) {
+            for (const markerViewName of markerViewNames) {
+                const markerName = config.model(markerViewName, conversionApi);
+                const element = conversionApi.writer.createElement('$marker', { 'data-name': markerName });
+                conversionApi.writer.insert(element, position);
+                if (data.modelCursor.isEqual(position)) {
+                    data.modelCursor = data.modelCursor.getShiftedBy(1);
+                }
+                else {
+                    data.modelCursor = data.modelCursor._getTransformedByInsertion(position, 1);
+                }
+                data.modelRange = data.modelRange._getTransformedByInsertion(position, 1)[0];
+            }
+        }
+    };
+}
+/**
+ * Helper function for from-view-element conversion. Checks if `config.view` directly specifies converted view element's name
+ * and if so, returns it.
+ *
+ * @param config Conversion view config.
+ * @returns View element name or `null` if name is not directly set.
+ */
+function getViewElementNameFromConfig(viewConfig) {
+    if (typeof viewConfig == 'string') {
+        return viewConfig;
+    }
+    if (typeof viewConfig == 'object' && typeof viewConfig.name == 'string') {
+        return viewConfig.name;
+    }
+    return null;
+}
+/**
+ * Helper for to-model-element conversion. Takes a config object and returns a proper converter function.
+ *
+ * @param config Conversion configuration.
+ * @returns View to model converter.
+ */
+function prepareToElementConverter(config) {
+    const matcher = new Matcher(config.view);
+    return (evt, data, conversionApi) => {
+        const matcherResult = matcher.match(data.viewItem);
+        if (!matcherResult) {
+            return;
+        }
+        const match = matcherResult.match;
+        // Force consuming element's name.
+        match.name = true;
+        if (!conversionApi.consumable.test(data.viewItem, match)) {
+            return;
+        }
+        const modelElement = getModelElement(config.model, data.viewItem, conversionApi);
+        if (!modelElement) {
+            return;
+        }
+        if (!conversionApi.safeInsert(modelElement, data.modelCursor)) {
+            return;
+        }
+        conversionApi.consumable.consume(data.viewItem, match);
+        conversionApi.convertChildren(data.viewItem, modelElement);
+        conversionApi.updateConversionResult(modelElement, data);
+    };
+}
+/**
+ * Helper function for upcasting-to-element converter. Takes the model configuration, the converted view element
+ * and a writer instance and returns a model element instance to be inserted in the model.
+ *
+ * @param model Model conversion configuration.
+ * @param input The converted view node.
+ * @param conversionApi The upcast conversion API.
+ */
+function getModelElement(model, input, conversionApi) {
+    if (model instanceof Function) {
+        return model(input, conversionApi);
+    }
+    else {
+        return conversionApi.writer.createElement(model);
+    }
+}
+/**
+ * Helper function view-attribute-to-model-attribute helper. Normalizes `config.view` which was set as `String` or
+ * as an `Object` with `key`, `value` and `name` properties. Normalized `config.view` has is compatible with
+ * {@link module:engine/view/matcher~MatcherPattern}.
+ *
+ * @param config Conversion config.
+ * @returns Key of the converted view attribute.
+ */
+function normalizeViewAttributeKeyValueConfig(config) {
+    if (typeof config.view == 'string') {
+        config.view = { key: config.view };
+    }
+    const key = config.view.key;
+    let normalized;
+    if (key == 'class' || key == 'style') {
+        const keyName = key == 'class' ? 'classes' : 'styles';
+        normalized = {
+            [keyName]: config.view.value
+        };
+    }
+    else {
+        const value = typeof config.view.value == 'undefined' ? /[\s\S]*/ : config.view.value;
+        normalized = {
+            attributes: {
+                [key]: value
+            }
+        };
+    }
+    if (config.view.name) {
+        normalized.name = config.view.name;
+    }
+    config.view = normalized;
+    return key;
+}
+/**
+ * Helper function that normalizes `config.model` in from-model-attribute conversion. `config.model` can be set
+ * as a `String`, an `Object` with only `key` property or an `Object` with `key` and `value` properties. Normalized
+ * `config.model` is an `Object` with `key` and `value` properties.
+ *
+ * @param config Conversion config.
+ * @param viewAttributeKeyToCopy Key of the converted view attribute. If it is set, model attribute value
+ * will be equal to view attribute value.
+ */
+function normalizeModelAttributeConfig(config, viewAttributeKeyToCopy = null) {
+    const defaultModelValue = viewAttributeKeyToCopy === null ? true :
+        (viewElement) => viewElement.getAttribute(viewAttributeKeyToCopy);
+    const key = typeof config.model != 'object' ? config.model : config.model.key;
+    const value = typeof config.model != 'object' || typeof config.model.value == 'undefined' ? defaultModelValue : config.model.value;
+    config.model = { key, value };
+}
+/**
+ * Helper for to-model-attribute conversion. Takes the model attribute name and conversion configuration and returns
+ * a proper converter function.
+ *
+ * @param config Conversion configuration. It is possible to provide multiple configurations in an array.
+ * @param shallow If set to `true` the attribute will be set only on top-level nodes. Otherwise, it will be set
+ * on all elements in the range.
+ */
+function prepareToAttributeConverter(config, shallow) {
+    const matcher = new Matcher(config.view);
+    return (evt, data, conversionApi) => {
+        // Converting an attribute of an element that has not been converted to anything does not make sense
+        // because there will be nowhere to set that attribute on. At this stage, the element should've already
+        // been converted (https://github.com/ckeditor/ckeditor5/issues/11000).
+        if (!data.modelRange && shallow) {
+            return;
+        }
+        const match = matcher.match(data.viewItem);
+        // If there is no match, this callback should not do anything.
+        if (!match) {
+            return;
+        }
+        if (onlyViewNameIsDefined(config.view, data.viewItem)) {
+            match.match.name = true;
+        }
+        else {
+            // Do not test `name` consumable because it could get consumed already while upcasting some other attribute
+            // on the same element (for example <span class="big" style="color: red">foo</span>).
+            delete match.match.name;
+        }
+        // Try to consume appropriate values from consumable values list.
+        if (!conversionApi.consumable.test(data.viewItem, match.match)) {
+            return;
+        }
+        const modelKey = config.model.key;
+        const modelValue = typeof config.model.value == 'function' ?
+            config.model.value(data.viewItem, conversionApi) : config.model.value;
+        // Do not convert if attribute building function returned falsy value.
+        if (modelValue === null) {
+            return;
+        }
+        // Since we are converting to attribute we need a range on which we will set the attribute.
+        // If the range is not created yet, let's create it by converting children of the current node first.
+        if (!data.modelRange) {
+            // Convert children and set conversion result as a current data.
+            Object.assign(data, conversionApi.convertChildren(data.viewItem, data.modelCursor));
+        }
+        // Set attribute on current `output`. `Schema` is checked inside this helper function.
+        const attributeWasSet = setAttributeOn(data.modelRange, { key: modelKey, value: modelValue }, shallow, conversionApi);
+        // It may happen that a converter will try to set an attribute that is not allowed in the given context.
+        // In such a situation we cannot consume the attribute. See: https://github.com/ckeditor/ckeditor5/pull/9249#issuecomment-815658459.
+        if (attributeWasSet) {
+            // Verify if the element itself wasn't consumed yet. It could be consumed already while upcasting some other attribute
+            // on the same element (for example <span class="big" style="color: red">foo</span>).
+            // We need to consume it so other features (especially GHS) won't try to convert it.
+            // Note that it's not tested by the other element-to-attribute converters whether an element was consumed before
+            // (in case of converters that the element itself is just a context and not the primary information to convert).
+            if (conversionApi.consumable.test(data.viewItem, { name: true })) {
+                match.match.name = true;
+            }
+            conversionApi.consumable.consume(data.viewItem, match.match);
+        }
+    };
+}
+/**
+ * Helper function that checks if element name should be consumed in attribute converters.
+ *
+ * @param viewConfig Conversion view config.
+ */
+function onlyViewNameIsDefined(viewConfig, viewItem) {
+    // https://github.com/ckeditor/ckeditor5-engine/issues/1786
+    const configToTest = typeof viewConfig == 'function' ? viewConfig(viewItem) : viewConfig;
+    if (typeof configToTest == 'object' && !getViewElementNameFromConfig(configToTest)) {
+        return false;
+    }
+    return !configToTest.classes && !configToTest.attributes && !configToTest.styles;
+}
+/**
+ * Helper function for to-model-attribute converter. Sets model attribute on given range. Checks {@link module:engine/model/schema~Schema}
+ * to ensure proper model structure.
+ *
+ * If any node on the given range has already defined an attribute with the same name, its value will not be updated.
+ *
+ * @param modelRange Model range on which attribute should be set.
+ * @param modelAttribute Model attribute to set.
+ * @param conversionApi Conversion API.
+ * @param shallow If set to `true` the attribute will be set only on top-level nodes. Otherwise, it will be set
+ * on all elements in the range.
+ * @returns `true` if attribute was set on at least one node from given `modelRange`.
+ */
+function setAttributeOn(modelRange, modelAttribute, shallow, conversionApi) {
+    let result = false;
+    // Set attribute on each item in range according to Schema.
+    for (const node of Array.from(modelRange.getItems({ shallow }))) {
+        // Skip if not allowed.
+        if (!conversionApi.schema.checkAttribute(node, modelAttribute.key)) {
+            continue;
+        }
+        // Mark the node as consumed even if the attribute will not be updated because it's in a valid context (schema)
+        // and would be converted if the attribute wouldn't be present. See #8921.
+        result = true;
+        // Do not override the attribute if it's already present.
+        if (node.hasAttribute(modelAttribute.key)) {
+            continue;
+        }
+        conversionApi.writer.setAttribute(modelAttribute.key, modelAttribute.value, node);
+    }
+    return result;
+}
+/**
+ * Helper function for upcasting-to-marker conversion. Takes the config in a format requested by `upcastElementToMarker()`
+ * function and converts it to a format that is supported by `upcastElementToElement()` function.
+ */
+function normalizeElementToMarkerModelConfig(model) {
+    return (viewElement, conversionApi) => {
+        const markerName = typeof model == 'string' ? model : model(viewElement, conversionApi);
+        return conversionApi.writer.createElement('$marker', { 'data-name': markerName });
+    };
+}
+/**
+ * Helper function for upcasting-to-marker conversion. Takes the config in a format requested by `upcastDataToMarker()`
+ * function and converts it to a format that is supported by `upcastElementToElement()` function.
+ */
+function normalizeDataToMarkerConfig(config, type) {
+    const elementCreatorFunction = (viewElement, conversionApi) => {
+        const viewName = viewElement.getAttribute('name');
+        const markerName = config.model(viewName, conversionApi);
+        return conversionApi.writer.createElement('$marker', { 'data-name': markerName });
+    };
+    return {
+        // Upcast <markerGroup-start> and <markerGroup-end> elements.
+        view: `${config.view}-${type}`,
+        model: elementCreatorFunction
+    };
+}