@ckeditor/ckeditor5-html-support 0.0.0-internal-20241017.0

package/src/htmlpagedataprocessor.js

@@ -0,0 +1,67 @@
+/**
+ * @license Copyright (c) 2003-2024, 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/htmlpagedataprocessor
+ */
+import { HtmlDataProcessor, UpcastWriter } from 'ckeditor5/src/engine.js';
+/**
+ * The full page HTML data processor class.
+ * This data processor implementation uses HTML as input and output data.
+ */
+export default class HtmlPageDataProcessor extends HtmlDataProcessor {
+    /**
+     * @inheritDoc
+     */
+    toView(data) {
+        // Ignore content that is not a full page source.
+        if (!/<(?:html|body|head|meta)(?:\s[^>]*)?>/i.test(data.trim().slice(0, 10000))) {
+            return super.toView(data);
+        }
+        // Store doctype and xml declaration in a separate properties as they can't be stringified later.
+        let docType = '';
+        let xmlDeclaration = '';
+        data = data.trim().replace(/<\?xml\s[^?]*\?>/i, match => {
+            xmlDeclaration = match;
+            return '';
+        });
+        data = data.trim().replace(/^<!DOCTYPE\s[^>]*?>/i, match => {
+            docType = match;
+            return '';
+        });
+        // Convert input HTML data to DOM DocumentFragment.
+        const domFragment = this._toDom(data);
+        // Convert DOM DocumentFragment to view DocumentFragment.
+        const viewFragment = this.domConverter.domToView(domFragment, { skipComments: this.skipComments });
+        const writer = new UpcastWriter(viewFragment.document);
+        // Using the DOM document with body content extracted as a skeleton of the page.
+        writer.setCustomProperty('$fullPageDocument', domFragment.ownerDocument.documentElement.outerHTML, viewFragment);
+        if (docType) {
+            writer.setCustomProperty('$fullPageDocType', docType, viewFragment);
+        }
+        if (xmlDeclaration) {
+            writer.setCustomProperty('$fullPageXmlDeclaration', xmlDeclaration, viewFragment);
+        }
+        return viewFragment;
+    }
+    /**
+     * @inheritDoc
+     */
+    toData(viewFragment) {
+        let data = super.toData(viewFragment);
+        const page = viewFragment.getCustomProperty('$fullPageDocument');
+        const docType = viewFragment.getCustomProperty('$fullPageDocType');
+        const xmlDeclaration = viewFragment.getCustomProperty('$fullPageXmlDeclaration');
+        if (page) {
+            data = page.replace(/<\/body\s*>/, data + '$&');
+            if (docType) {
+                data = docType + '\n' + data;
+            }
+            if (xmlDeclaration) {
+                data = xmlDeclaration + '\n' + data;
+            }
+        }
+        return data;
+    }
+}

package/src/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @license Copyright (c) 2003-2024, 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
+ */
+export { default as GeneralHtmlSupport } from './generalhtmlsupport.js';
+export { default as DataFilter } from './datafilter.js';
+export { default as DataSchema, type DataSchemaBlockElementDefinition } from './dataschema.js';
+export { default as HtmlComment } from './htmlcomment.js';
+export { default as FullPage } from './fullpage.js';
+export { default as HtmlPageDataProcessor } from './htmlpagedataprocessor.js';
+export type { GeneralHtmlSupportConfig } from './generalhtmlsupportconfig.js';
+export type { default as CodeBlockElementSupport } from './integrations/codeblock.js';
+export type { default as CustomElementSupport } from './integrations/customelement.js';
+export type { default as ListElementSupport } from './integrations/list.js';
+export type { default as DualContentModelElementSupport } from './integrations/dualcontent.js';
+export type { default as HeadingElementSupport } from './integrations/heading.js';
+export type { default as ImageElementSupport } from './integrations/image.js';
+export type { default as MediaEmbedElementSupport } from './integrations/mediaembed.js';
+export type { default as ScriptElementSupport } from './integrations/script.js';
+export type { default as StyleElementSupport } from './integrations/style.js';
+export type { default as TableElementSupport } from './integrations/table.js';
+import './augmentation.js';

package/src/index.js

@@ -0,0 +1,14 @@
+/**
+ * @license Copyright (c) 2003-2024, 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
+ */
+export { default as GeneralHtmlSupport } from './generalhtmlsupport.js';
+export { default as DataFilter } from './datafilter.js';
+export { default as DataSchema } from './dataschema.js';
+export { default as HtmlComment } from './htmlcomment.js';
+export { default as FullPage } from './fullpage.js';
+export { default as HtmlPageDataProcessor } from './htmlpagedataprocessor.js';
+import './augmentation.js';

package/src/integrations/codeblock.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+import { Plugin } from 'ckeditor5/src/core.js';
+import DataFilter from '../datafilter.js';
+/**
+ * Provides the General HTML Support integration with {@link module:code-block/codeblock~CodeBlock Code Block} feature.
+ */
+export default class CodeBlockElementSupport extends Plugin {
+    /**
+     * @inheritDoc
+     */
+    static get requires(): readonly [typeof DataFilter];
+    /**
+     * @inheritDoc
+     */
+    static get pluginName(): "CodeBlockElementSupport";
+    /**
+     * @inheritDoc
+     */
+    static get isOfficialPlugin(): true;
+    /**
+     * @inheritDoc
+     */
+    init(): void;
+}

package/src/integrations/codeblock.js

@@ -0,0 +1,107 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+import { Plugin } from 'ckeditor5/src/core.js';
+import { updateViewAttributes } from '../utils.js';
+import DataFilter from '../datafilter.js';
+/**
+ * Provides the General HTML Support integration with {@link module:code-block/codeblock~CodeBlock Code Block} feature.
+ */
+export default class CodeBlockElementSupport extends Plugin {
+    /**
+     * @inheritDoc
+     */
+    static get requires() {
+        return [DataFilter];
+    }
+    /**
+     * @inheritDoc
+     */
+    static get pluginName() {
+        return 'CodeBlockElementSupport';
+    }
+    /**
+     * @inheritDoc
+     */
+    static get isOfficialPlugin() {
+        return true;
+    }
+    /**
+     * @inheritDoc
+     */
+    init() {
+        if (!this.editor.plugins.has('CodeBlockEditing')) {
+            return;
+        }
+        const dataFilter = this.editor.plugins.get(DataFilter);
+        dataFilter.on('register:pre', (evt, definition) => {
+            if (definition.model !== 'codeBlock') {
+                return;
+            }
+            const editor = this.editor;
+            const schema = editor.model.schema;
+            const conversion = editor.conversion;
+            // Extend codeBlock to allow attributes required by attribute filtration.
+            schema.extend('codeBlock', {
+                allowAttributes: ['htmlPreAttributes', 'htmlContentAttributes']
+            });
+            conversion.for('upcast').add(viewToModelCodeBlockAttributeConverter(dataFilter));
+            conversion.for('downcast').add(modelToViewCodeBlockAttributeConverter());
+            evt.stop();
+        });
+    }
+}
+/**
+ * View-to-model conversion helper preserving allowed attributes on {@link module:code-block/codeblock~CodeBlock Code Block}
+ * feature model element.
+ *
+ * Attributes are preserved as a value of `html*Attributes` model attribute.
+ * @param dataFilter
+ * @returns Returns a conversion callback.
+ */
+function viewToModelCodeBlockAttributeConverter(dataFilter) {
+    return (dispatcher) => {
+        dispatcher.on('element:code', (evt, data, conversionApi) => {
+            const viewCodeElement = data.viewItem;
+            const viewPreElement = viewCodeElement.parent;
+            if (!viewPreElement || !viewPreElement.is('element', 'pre')) {
+                return;
+            }
+            preserveElementAttributes(viewPreElement, 'htmlPreAttributes');
+            preserveElementAttributes(viewCodeElement, 'htmlContentAttributes');
+            function preserveElementAttributes(viewElement, attributeName) {
+                const viewAttributes = dataFilter.processViewAttributes(viewElement, conversionApi);
+                if (viewAttributes) {
+                    conversionApi.writer.setAttribute(attributeName, viewAttributes, data.modelRange);
+                }
+            }
+        }, { priority: 'low' });
+    };
+}
+/**
+ * Model-to-view conversion helper applying attributes from {@link module:code-block/codeblock~CodeBlock Code Block}
+ * feature model element.
+ * @returns Returns a conversion callback.
+ */
+function modelToViewCodeBlockAttributeConverter() {
+    return (dispatcher) => {
+        dispatcher.on('attribute:htmlPreAttributes:codeBlock', (evt, data, conversionApi) => {
+            if (!conversionApi.consumable.consume(data.item, evt.name)) {
+                return;
+            }
+            const { attributeOldValue, attributeNewValue } = data;
+            const viewCodeElement = conversionApi.mapper.toViewElement(data.item);
+            const viewPreElement = viewCodeElement.parent;
+            updateViewAttributes(conversionApi.writer, attributeOldValue, attributeNewValue, viewPreElement);
+        });
+        dispatcher.on('attribute:htmlContentAttributes:codeBlock', (evt, data, conversionApi) => {
+            if (!conversionApi.consumable.consume(data.item, evt.name)) {
+                return;
+            }
+            const { attributeOldValue, attributeNewValue } = data;
+            const viewCodeElement = conversionApi.mapper.toViewElement(data.item);
+            updateViewAttributes(conversionApi.writer, attributeOldValue, attributeNewValue, viewCodeElement);
+        });
+    };
+}

package/src/integrations/customelement.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @license Copyright (c) 2003-2024, 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/customelement
+ */
+import { Plugin } from 'ckeditor5/src/core.js';
+import DataSchema from '../dataschema.js';
+import DataFilter from '../datafilter.js';
+/**
+ * Provides the General HTML Support for custom elements (not registered in the {@link module:html-support/dataschema~DataSchema}).
+ */
+export default class CustomElementSupport extends Plugin {
+    /**
+     * @inheritDoc
+     */
+    static get requires(): readonly [typeof DataFilter, typeof DataSchema];
+    /**
+     * @inheritDoc
+     */
+    static get pluginName(): "CustomElementSupport";
+    /**
+     * @inheritDoc
+     */
+    static get isOfficialPlugin(): true;
+    /**
+     * @inheritDoc
+     */
+    init(): void;
+}

package/src/integrations/customelement.js

@@ -0,0 +1,162 @@
+/**
+ * @license Copyright (c) 2003-2024, 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/customelement
+ */
+/* globals document */
+import { Plugin } from 'ckeditor5/src/core.js';
+import { UpcastWriter } from 'ckeditor5/src/engine.js';
+import DataSchema from '../dataschema.js';
+import DataFilter from '../datafilter.js';
+import { setViewAttributes } from '../utils.js';
+/**
+ * Provides the General HTML Support for custom elements (not registered in the {@link module:html-support/dataschema~DataSchema}).
+ */
+export default class CustomElementSupport extends Plugin {
+    /**
+     * @inheritDoc
+     */
+    static get requires() {
+        return [DataFilter, DataSchema];
+    }
+    /**
+     * @inheritDoc
+     */
+    static get pluginName() {
+        return 'CustomElementSupport';
+    }
+    /**
+     * @inheritDoc
+     */
+    static get isOfficialPlugin() {
+        return true;
+    }
+    /**
+     * @inheritDoc
+     */
+    init() {
+        const dataFilter = this.editor.plugins.get(DataFilter);
+        const dataSchema = this.editor.plugins.get(DataSchema);
+        dataFilter.on('register:$customElement', (evt, definition) => {
+            evt.stop();
+            const editor = this.editor;
+            const schema = editor.model.schema;
+            const conversion = editor.conversion;
+            const unsafeElements = editor.editing.view.domConverter.unsafeElements;
+            const preLikeElements = editor.data.htmlProcessor.domConverter.preElements;
+            schema.register(definition.model, definition.modelSchema);
+            schema.extend(definition.model, {
+                allowAttributes: ['htmlElementName', 'htmlCustomElementAttributes', 'htmlContent'],
+                isContent: true
+            });
+            // For the `<template>` element we use only raw-content because DOM API exposes its content
+            // only as a document fragment in the `content` property (or innerHTML).
+            editor.data.htmlProcessor.domConverter.registerRawContentMatcher({ name: 'template' });
+            // Being executed on the low priority, it will catch all elements that were not caught by other converters.
+            conversion.for('upcast').elementToElement({
+                view: /.*/,
+                model: (viewElement, conversionApi) => {
+                    // Do not try to convert $comment fake element.
+                    if (viewElement.name == '$comment') {
+                        return null;
+                    }
+                    if (!isValidElementName(viewElement.name)) {
+                        return null;
+                    }
+                    // Allow for fallback only if this element is not defined in data schema to make sure
+                    // that this will handle only custom elements not registered in the data schema.
+                    if (dataSchema.getDefinitionsForView(viewElement.name).size) {
+                        return null;
+                    }
+                    // Make sure that this element will not render in the editing view.
+                    if (!unsafeElements.includes(viewElement.name)) {
+                        unsafeElements.push(viewElement.name);
+                    }
+                    // Make sure that whitespaces will not be trimmed or replaced by nbsps while stringify content.
+                    if (!preLikeElements.includes(viewElement.name)) {
+                        preLikeElements.push(viewElement.name);
+                    }
+                    const modelElement = conversionApi.writer.createElement(definition.model, {
+                        htmlElementName: viewElement.name
+                    });
+                    const htmlAttributes = dataFilter.processViewAttributes(viewElement, conversionApi);
+                    if (htmlAttributes) {
+                        conversionApi.writer.setAttribute('htmlCustomElementAttributes', htmlAttributes, modelElement);
+                    }
+                    let htmlContent;
+                    // For the `<template>` element we use only raw-content because DOM API exposes its content
+                    // only as a document fragment in the `content` property.
+                    if (viewElement.is('element', 'template') && viewElement.getCustomProperty('$rawContent')) {
+                        htmlContent = viewElement.getCustomProperty('$rawContent');
+                    }
+                    else {
+                        // Store the whole element in the attribute so that DomConverter will be able to use the pre like element context.
+                        const viewWriter = new UpcastWriter(viewElement.document);
+                        const documentFragment = viewWriter.createDocumentFragment(viewElement);
+                        const domFragment = editor.data.htmlProcessor.domConverter.viewToDom(documentFragment);
+                        const domElement = domFragment.firstChild;
+                        while (domElement.firstChild) {
+                            domFragment.appendChild(domElement.firstChild);
+                        }
+                        domElement.remove();
+                        htmlContent = editor.data.htmlProcessor.htmlWriter.getHtml(domFragment);
+                    }
+                    conversionApi.writer.setAttribute('htmlContent', htmlContent, modelElement);
+                    // Consume the content of the element.
+                    for (const { item } of editor.editing.view.createRangeIn(viewElement)) {
+                        conversionApi.consumable.consume(item, { name: true });
+                    }
+                    return modelElement;
+                },
+                converterPriority: 'low'
+            });
+            // Because this element is unsafe (DomConverter#unsafeElements), it will render as a transparent <span> but it must
+            // be rendered anyway for the mapping between the model and the view to exist.
+            conversion.for('editingDowncast').elementToElement({
+                model: {
+                    name: definition.model,
+                    attributes: ['htmlElementName', 'htmlCustomElementAttributes', 'htmlContent']
+                },
+                view: (modelElement, { writer }) => {
+                    const viewName = modelElement.getAttribute('htmlElementName');
+                    const viewElement = writer.createRawElement(viewName);
+                    if (modelElement.hasAttribute('htmlCustomElementAttributes')) {
+                        setViewAttributes(writer, modelElement.getAttribute('htmlCustomElementAttributes'), viewElement);
+                    }
+                    return viewElement;
+                }
+            });
+            conversion.for('dataDowncast').elementToElement({
+                model: {
+                    name: definition.model,
+                    attributes: ['htmlElementName', 'htmlCustomElementAttributes', 'htmlContent']
+                },
+                view: (modelElement, { writer }) => {
+                    const viewName = modelElement.getAttribute('htmlElementName');
+                    const htmlContent = modelElement.getAttribute('htmlContent');
+                    const viewElement = writer.createRawElement(viewName, null, (domElement, domConverter) => {
+                        domConverter.setContentOf(domElement, htmlContent);
+                    });
+                    if (modelElement.hasAttribute('htmlCustomElementAttributes')) {
+                        setViewAttributes(writer, modelElement.getAttribute('htmlCustomElementAttributes'), viewElement);
+                    }
+                    return viewElement;
+                }
+            });
+        });
+    }
+}
+/**
+ * Returns true if name is valid for a DOM element name.
+ */
+function isValidElementName(name) {
+    try {
+        document.createElement(name);
+    }
+    catch (error) {
+        return false;
+    }
+    return true;
+}

package/src/integrations/dualcontent.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+import { Plugin } from 'ckeditor5/src/core.js';
+import DataFilter from '../datafilter.js';
+/**
+ * Provides the General HTML Support integration for elements which can behave like sectioning element (e.g. article) or
+ * element accepting only inline content (e.g. paragraph).
+ *
+ * The distinction between this two content models is important for choosing correct schema model and proper content conversion.
+ * As an example, it ensures that:
+ *
+ * * children elements paragraphing is enabled for sectioning elements only,
+ * * element and its content can be correctly handled by editing view (splitting and merging elements),
+ * * model element HTML is semantically correct and easier to work with.
+ *
+ * If element contains any block element, it will be treated as a sectioning element and registered using
+ * {@link module:html-support/dataschema~DataSchemaDefinition#model} and
+ * {@link module:html-support/dataschema~DataSchemaDefinition#modelSchema} in editor schema.
+ * Otherwise, it will be registered under {@link module:html-support/dataschema~DataSchemaBlockElementDefinition#paragraphLikeModel} model
+ * name with model schema accepting only inline content (inheriting from `$block`).
+ */
+export default class DualContentModelElementSupport extends Plugin {
+    /**
+     * @inheritDoc
+     */
+    static get requires(): readonly [typeof DataFilter];
+    /**
+     * @inheritDoc
+     */
+    static get pluginName(): "DualContentModelElementSupport";
+    /**
+     * @inheritDoc
+     */
+    static get isOfficialPlugin(): true;
+    /**
+     * @inheritDoc
+     */
+    init(): void;
+    /**
+     * Checks whether the given view element includes any other block element.
+     */
+    private _hasBlockContent;
+    /**
+     * Adds attribute filtering conversion for the given data schema.
+     */
+    private _addAttributeConversion;
+}

package/src/integrations/dualcontent.js

@@ -0,0 +1,125 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+import { Plugin } from 'ckeditor5/src/core.js';
+import { priorities } from 'ckeditor5/src/utils.js';
+import { modelToViewBlockAttributeConverter, viewToModelBlockAttributeConverter } from '../converters.js';
+import DataFilter from '../datafilter.js';
+import { getHtmlAttributeName } from '../utils.js';
+/**
+ * Provides the General HTML Support integration for elements which can behave like sectioning element (e.g. article) or
+ * element accepting only inline content (e.g. paragraph).
+ *
+ * The distinction between this two content models is important for choosing correct schema model and proper content conversion.
+ * As an example, it ensures that:
+ *
+ * * children elements paragraphing is enabled for sectioning elements only,
+ * * element and its content can be correctly handled by editing view (splitting and merging elements),
+ * * model element HTML is semantically correct and easier to work with.
+ *
+ * If element contains any block element, it will be treated as a sectioning element and registered using
+ * {@link module:html-support/dataschema~DataSchemaDefinition#model} and
+ * {@link module:html-support/dataschema~DataSchemaDefinition#modelSchema} in editor schema.
+ * Otherwise, it will be registered under {@link module:html-support/dataschema~DataSchemaBlockElementDefinition#paragraphLikeModel} model
+ * name with model schema accepting only inline content (inheriting from `$block`).
+ */
+export default class DualContentModelElementSupport extends Plugin {
+    /**
+     * @inheritDoc
+     */
+    static get requires() {
+        return [DataFilter];
+    }
+    /**
+     * @inheritDoc
+     */
+    static get pluginName() {
+        return 'DualContentModelElementSupport';
+    }
+    /**
+     * @inheritDoc
+     */
+    static get isOfficialPlugin() {
+        return true;
+    }
+    /**
+     * @inheritDoc
+     */
+    init() {
+        const dataFilter = this.editor.plugins.get(DataFilter);
+        dataFilter.on('register', (evt, definition) => {
+            const blockDefinition = definition;
+            const editor = this.editor;
+            const schema = editor.model.schema;
+            const conversion = editor.conversion;
+            if (!blockDefinition.paragraphLikeModel) {
+                return;
+            }
+            // Can only apply to newly registered features.
+            if (schema.isRegistered(blockDefinition.model) || schema.isRegistered(blockDefinition.paragraphLikeModel)) {
+                return;
+            }
+            const paragraphLikeModelDefinition = {
+                model: blockDefinition.paragraphLikeModel,
+                view: blockDefinition.view
+            };
+            schema.register(blockDefinition.model, blockDefinition.modelSchema);
+            schema.register(paragraphLikeModelDefinition.model, {
+                inheritAllFrom: '$block'
+            });
+            conversion.for('upcast').elementToElement({
+                view: blockDefinition.view,
+                model: (viewElement, { writer }) => {
+                    if (this._hasBlockContent(viewElement)) {
+                        return writer.createElement(blockDefinition.model);
+                    }
+                    return writer.createElement(paragraphLikeModelDefinition.model);
+                },
+                // With a `low` priority, `paragraph` plugin auto-paragraphing mechanism is executed. Make sure
+                // this listener is called before it. If not, some elements will be transformed into a paragraph.
+                converterPriority: priorities.low + 0.5
+            });
+            conversion.for('downcast').elementToElement({
+                view: blockDefinition.view,
+                model: blockDefinition.model
+            });
+            this._addAttributeConversion(blockDefinition);
+            conversion.for('downcast').elementToElement({
+                view: paragraphLikeModelDefinition.view,
+                model: paragraphLikeModelDefinition.model
+            });
+            this._addAttributeConversion(paragraphLikeModelDefinition);
+            evt.stop();
+        });
+    }
+    /**
+     * Checks whether the given view element includes any other block element.
+     */
+    _hasBlockContent(viewElement) {
+        const view = this.editor.editing.view;
+        const blockElements = view.domConverter.blockElements;
+        // Traversing the viewElement subtree looking for block elements.
+        // Especially for the cases like <div><a href="#"><p>foo</p></a></div>.
+        // https://github.com/ckeditor/ckeditor5/issues/11513
+        for (const viewItem of view.createRangeIn(viewElement).getItems()) {
+            if (viewItem.is('element') && blockElements.includes(viewItem.name)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Adds attribute filtering conversion for the given data schema.
+     */
+    _addAttributeConversion(definition) {
+        const editor = this.editor;
+        const conversion = editor.conversion;
+        const dataFilter = editor.plugins.get(DataFilter);
+        editor.model.schema.extend(definition.model, {
+            allowAttributes: getHtmlAttributeName(definition.view)
+        });
+        conversion.for('upcast').add(viewToModelBlockAttributeConverter(definition, dataFilter));
+        conversion.for('downcast').add(modelToViewBlockAttributeConverter(definition));
+    }
+}

package/src/integrations/heading.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @license Copyright (c) 2003-2024, 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.js';
+import { Enter } from 'ckeditor5/src/enter.js';
+import DataSchema from '../dataschema.js';
+/**
+ * Provides the General HTML Support integration with {@link module:heading/heading~Heading Heading} feature.
+ */
+export default class HeadingElementSupport extends Plugin {
+    /**
+     * @inheritDoc
+     */
+    static get requires(): readonly [typeof DataSchema, typeof Enter];
+    /**
+     * @inheritDoc
+     */
+    static get pluginName(): "HeadingElementSupport";
+    /**
+     * @inheritDoc
+     */
+    static get isOfficialPlugin(): true;
+    /**
+     * @inheritDoc
+     */
+    init(): void;
+    /**
+     * Registers all elements supported by HeadingEditing to enable custom attributes for those elements.
+     */
+    private registerHeadingElements;
+}