ckeditor5-elements-schema 0.0.0-stage → 49.0.0-alpha.4

package/dist/commands/elementInlineCommand.js

@@ -0,0 +1,253 @@
+import { ModelLivePosition, ModelLiveRange } from 'ckeditor5';
+import ElementSchemaCommand from './elementSchemaCommand.js';
+/**
+ * Toggles an inline element with text, as CKEditor's `bold` toggles an attribute of text, but with an element, e.g. a
+ * `bold` that is an inline `block` of the element schema.
+ *
+ * ```ts
+ * editor.execute('bold'); // The selection.
+ * editor.commands.get('bold').executeFor(element); // An element, e.g. of a context menu.
+ * ```
+ *
+ * * On selected text, it wraps the text with the element, in each block, and merges it with the elements next to it.
+ *   When all the text is in the element already, it unwraps the elements: the whole ones, not only the selected part.
+ * * On the cursor, it inserts an empty element with the cursor in it. In the element, it moves the cursor out of it, at
+ *   its start or end, or it unwraps it.
+ * * On an element (selected, or given), it unwraps the element it is in, or wraps it.
+ *
+ * It is "on" ({@link isOn}) when the target is in the element: for selected text, when all of it is.
+ */
+export default class ElementInlineCommand extends ElementSchemaCommand {
+    isToggleable = true;
+    /**
+     * Puts the target in the element, or out of it: by default, the selection, also selected text.
+     */
+    execute(elementOrPosition) {
+        const ranges = this._getSelectedRanges(elementOrPosition);
+        const target = this._getElementOrPosition(elementOrPosition);
+        this.editor.model.change(writer => {
+            if (ranges) {
+                if (this._isOnRanges(ranges)) {
+                    this._unwrapRanges(writer, ranges);
+                }
+                else {
+                    this._wrapRanges(writer, ranges);
+                }
+            }
+            else if (target) {
+                const element = this._findElement(target);
+                if (element) {
+                    this._leave(writer, element, target);
+                }
+                else {
+                    this._insert(writer, target);
+                }
+            }
+        });
+    }
+    /**
+     * Enabled when the target can be edited, and is in the element, or the element can be there.
+     */
+    _isEnabledFor(elementOrPosition) {
+        const ranges = this._getSelectedRanges(elementOrPosition);
+        const target = this._getElementOrPosition(elementOrPosition);
+        if (!target || !super._isEnabledFor(target)) {
+            return false;
+        }
+        if (ranges) {
+            return this._isOnRanges(ranges) || this._getWrapRanges(ranges).length > 0;
+        }
+        if (this._findElement(target)) {
+            return true;
+        }
+        return target.is('position')
+            ? this.editor.model.schema.checkChild(target, this.elementName)
+            : this._canHold(this.editor.model.createPositionBefore(target), [target]);
+    }
+    /**
+     * "On" when the target is in the element: for selected text, when all of it is.
+     */
+    _isOnFor(elementOrPosition) {
+        const ranges = this._getSelectedRanges(elementOrPosition);
+        const target = this._getElementOrPosition(elementOrPosition);
+        return ranges ? this._isOnRanges(ranges) : !!target && !!this._findElement(target);
+    }
+    /**
+     * Whether all the text of the ranges is in the element: there are elements, and nothing to wrap.
+     */
+    _isOnRanges(ranges) {
+        return this._getElementsIn(ranges).length > 0 && !this._getWrapRanges(ranges).length;
+    }
+    /**
+     * Returns the elements of the command that a node is, or is in, in its line of text: the node and its ancestors, up to
+     * the first that is not inline, e.g. the paragraph. The inner first.
+     */
+    _getElementsAround(node) {
+        const schema = this.editor.model.schema;
+        const elements = [];
+        for (let element = node; element?.is('element') && schema.isInline(element); element = element.parent) {
+            if (this.isElement(element)) {
+                elements.push(element);
+            }
+        }
+        return elements;
+    }
+    /**
+     * Returns the closest element of the command that the target is, or is in, in its line of text.
+     */
+    _findElement(elementOrPosition) {
+        const target = this._getElementOrPosition(elementOrPosition);
+        return target ? (this._getElementsAround(target.is('position') ? target.parent : target)[0] ?? null) : null;
+    }
+    /**
+     * Returns the elements of the command in ranges, and around their ends.
+     */
+    _getElementsIn(ranges) {
+        const elements = new Set();
+        for (const range of ranges) {
+            for (const element of [
+                ...this._getElementsAround(range.start.parent),
+                ...this._getElementsAround(range.end.parent)
+            ]) {
+                elements.add(element);
+            }
+            for (const item of range.getItems()) {
+                if (this.isElement(item)) {
+                    elements.add(item);
+                }
+            }
+        }
+        return Array.from(elements);
+    }
+    /**
+     * Returns the ranges to wrap with the element to put the text of ranges in it: in each parent the element is allowed
+     * in, the runs of nodes it can hold, which are not in the element already. The other elements are looked into, e.g.
+     * the paragraphs of a selection across blocks.
+     */
+    _getWrapRanges(ranges) {
+        const model = this.editor.model;
+        const wrapRanges = [];
+        const collect = (flatRange) => {
+            const parent = flatRange.start.parent;
+            if (this._getElementsAround(parent).length) {
+                return;
+            }
+            let run = null;
+            const close = () => {
+                if (run) {
+                    wrapRanges.push(run);
+                    run = null;
+                }
+            };
+            for (const item of flatRange.getItems({ shallow: true })) {
+                if (this.isElement(item)) {
+                    close();
+                }
+                else if (this._canHold(flatRange.start, [item])) {
+                    run = model.createRange(run?.start ?? model.createPositionBefore(item), model.createPositionAfter(item));
+                }
+                else {
+                    close();
+                    if (item.is('element')) {
+                        collect(model.createRangeIn(item));
+                    }
+                }
+            }
+            close();
+        };
+        for (const range of ranges) {
+            range.getMinimalFlatRanges().forEach(collect);
+        }
+        return wrapRanges;
+    }
+    /**
+     * Wraps the text of ranges with new elements, merged with the ones next to them, and keeps the selection on the text.
+     */
+    _wrapRanges(writer, ranges) {
+        // The last first: wrapping one does not move the ones before it.
+        const wrapRanges = this._getWrapRanges(ranges).reverse();
+        this._keepSelection(writer, ranges, () => {
+            for (const range of wrapRanges) {
+                const element = writer.createElement(this.elementName);
+                writer.wrap(range, element);
+                this._mergeWithSiblings(writer, element);
+            }
+        });
+    }
+    /**
+     * Unwraps the elements in ranges and around their ends, and keeps the selection on the text.
+     */
+    _unwrapRanges(writer, ranges) {
+        const elements = this._getElementsIn(ranges);
+        this._keepSelection(writer, ranges, () => {
+            for (const element of elements) {
+                writer.unwrap(element);
+            }
+        });
+    }
+    /**
+     * Changes the content of the selected ranges, and selects the same text then: the ends of the ranges stick to the
+     * text, so they follow it into the elements and out of them.
+     */
+    _keepSelection(writer, ranges, change) {
+        const backward = this.editor.model.document.selection.isBackward;
+        const ends = ranges.map(range => ({
+            start: ModelLivePosition.fromPosition(range.start, 'toNext'),
+            end: ModelLivePosition.fromPosition(range.end, 'toPrevious')
+        }));
+        change();
+        writer.setSelection(ends.map(({ start, end }) => writer.createRange(start, end)), { backward });
+        for (const { start, end } of ends) {
+            start.detach();
+            end.detach();
+        }
+    }
+    /**
+     * Merges a new element with the elements of the command next to it that have no attributes, as it has none.
+     */
+    _mergeWithSiblings(writer, element) {
+        const isPlain = (node) => this.isElement(node) && node.getAttributeKeys().next().done === true;
+        if (isPlain(element.nextSibling)) {
+            writer.merge(writer.createPositionAfter(element));
+        }
+        if (isPlain(element.previousSibling)) {
+            writer.merge(writer.createPositionBefore(element));
+        }
+    }
+    /**
+     * Puts the target out of the element it is in: a cursor at the start or the end of the element goes before or after
+     * it, so that what is typed next is out of it; otherwise the element is unwrapped. A selected element that is
+     * unwrapped leaves its content selected.
+     */
+    _leave(writer, element, target) {
+        if (target.is('position') && target.parent === element && !element.isEmpty) {
+            if (target.isAtEnd || target.isAtStart) {
+                writer.setSelection(element, target.isAtEnd ? 'after' : 'before');
+                return;
+            }
+        }
+        const isSelected = this.editor.model.document.selection.getSelectedElement() === element;
+        const content = ModelLiveRange.fromRange(writer.createRangeIn(element));
+        writer.unwrap(element);
+        if (isSelected) {
+            writer.setSelection(content.toRange());
+        }
+        content.detach();
+    }
+    /**
+     * Puts the target in a new element: at a position, an empty element with the cursor in it; an element, e.g. a
+     * selected inline object, is wrapped, and selected.
+     */
+    _insert(writer, target) {
+        if (target.is('position')) {
+            const element = writer.createElement(this.elementName);
+            writer.insert(element, target);
+            writer.setSelection(element, 0);
+        }
+        else {
+            writer.wrap(writer.createRangeOn(target), this.elementName);
+            writer.setSelection(target, 'on');
+        }
+    }
+}
+//# sourceMappingURL=elementInlineCommand.js.map

package/dist/commands/elementInlineCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elementInlineCommand.js","sourceRoot":"","sources":["../../src/commands/elementInlineCommand.ts"],"names":[],"mappings":"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"}

package/dist/commands/elementInsertCommand.d.ts

@@ -0,0 +1,33 @@
+import { type ElementOrPosition } from 'ckeditor5-elements-core';
+import ElementSchemaCommand from './elementSchemaCommand.js';
+/**
+ * Inserts the element, as CKEditor's horizontal line and image commands do: an element that is not typed around text,
+ * e.g. an `empty` element of the element schema (a `divider`, or an inline `badge`), or an inline `container` (a `card`).
+ *
+ * ```ts
+ * editor.execute('divider'); // In place of the selection.
+ * editor.commands.get('divider').executeFor(element); // After the element.
+ * ```
+ *
+ * For the selection, it replaces the selected content, as typing does; at a position, it is inserted there; for an
+ * element, after it. Where the element cannot be, the blocks are split up to where it can, e.g. a block-level one in the
+ * middle of a paragraph. Then it is selected, as `selectNewElement()` does: an `empty` element as a whole, and an inline
+ * container gets a paragraph, with the cursor in it.
+ *
+ * It does not toggle: it is never "on".
+ */
+export default class ElementInsertCommand extends ElementSchemaCommand {
+    /**
+     * Inserts a new element at the target, and selects it.
+     */
+    execute(elementOrPosition?: ElementOrPosition): void;
+    /**
+     * Enabled when the target can be edited, and the element can be there, or in one of its ancestors.
+     */
+    protected _isEnabledFor(elementOrPosition?: ElementOrPosition): boolean;
+    /**
+     * Returns where the element goes: the selection, or the given position, or the position after the given element.
+     */
+    private _getSelectable;
+}
+//# sourceMappingURL=elementInsertCommand.d.ts.map

package/dist/commands/elementInsertCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elementInsertCommand.d.ts","sourceRoot":"","sources":["../../src/commands/elementInsertCommand.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACnF,OAAO,oBAAoB,MAAM,2BAA2B,CAAC;AAE7D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,OAAO,OAAO,oBAAqB,SAAQ,oBAAoB;IACrE;;OAEG;IACa,OAAO,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,IAAI;IAmBpE;;OAEG;cACgB,aAAa,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,OAAO;IAUhF;;OAEG;IACH,OAAO,CAAC,cAAc;CActB"}

package/dist/commands/elementInsertCommand.js

@@ -0,0 +1,61 @@
+import { selectNewElement } from 'ckeditor5-elements-core';
+import ElementSchemaCommand from './elementSchemaCommand.js';
+/**
+ * Inserts the element, as CKEditor's horizontal line and image commands do: an element that is not typed around text,
+ * e.g. an `empty` element of the element schema (a `divider`, or an inline `badge`), or an inline `container` (a `card`).
+ *
+ * ```ts
+ * editor.execute('divider'); // In place of the selection.
+ * editor.commands.get('divider').executeFor(element); // After the element.
+ * ```
+ *
+ * For the selection, it replaces the selected content, as typing does; at a position, it is inserted there; for an
+ * element, after it. Where the element cannot be, the blocks are split up to where it can, e.g. a block-level one in the
+ * middle of a paragraph. Then it is selected, as `selectNewElement()` does: an `empty` element as a whole, and an inline
+ * container gets a paragraph, with the cursor in it.
+ *
+ * It does not toggle: it is never "on".
+ */
+export default class ElementInsertCommand extends ElementSchemaCommand {
+    /**
+     * Inserts a new element at the target, and selects it.
+     */
+    execute(elementOrPosition) {
+        const model = this.editor.model;
+        const selectable = this._getSelectable(elementOrPosition);
+        if (!selectable) {
+            return;
+        }
+        model.change(writer => {
+            const element = writer.createElement(this.elementName);
+            model.insertContent(element, selectable);
+            if (element.parent) {
+                selectNewElement(writer, element);
+            }
+        });
+    }
+    /**
+     * Enabled when the target can be edited, and the element can be there, or in one of its ancestors.
+     */
+    _isEnabledFor(elementOrPosition) {
+        const position = this._getSelectable(elementOrPosition)?.getFirstPosition();
+        return (!!position &&
+            super._isEnabledFor(elementOrPosition) &&
+            !!this.editor.model.schema.findAllowedParent(position, this.elementName));
+    }
+    /**
+     * Returns where the element goes: the selection, or the given position, or the position after the given element.
+     */
+    _getSelectable(elementOrPosition) {
+        const model = this.editor.model;
+        const target = this._getElementOrPosition(elementOrPosition);
+        if (!target) {
+            return null;
+        }
+        if (!elementOrPosition) {
+            return model.document.selection;
+        }
+        return model.createSelection(target.is('position') ? target : model.createPositionAfter(target));
+    }
+}
+//# sourceMappingURL=elementInsertCommand.js.map

package/dist/commands/elementInsertCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elementInsertCommand.js","sourceRoot":"","sources":["../../src/commands/elementInsertCommand.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAA0B,MAAM,yBAAyB,CAAC;AACnF,OAAO,oBAAoB,MAAM,2BAA2B,CAAC;AAE7D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,OAAO,OAAO,oBAAqB,SAAQ,oBAAoB;IACrE;;OAEG;IACa,OAAO,CAAC,iBAAqC;QAC5D,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;QAChC,MAAM,UAAU,GAAG,IAAI,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;QAE1D,IAAI,CAAC,UAAU,EAAE,CAAC;YACjB,OAAO;QACR,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE;YACrB,MAAM,OAAO,GAAG,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAEvD,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;YAEzC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACpB,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACnC,CAAC;QACF,CAAC,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACgB,aAAa,CAAC,iBAAqC;QACrE,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,iBAAiB,CAAC,EAAE,gBAAgB,EAAE,CAAC;QAE5E,OAAO,CACN,CAAC,CAAC,QAAQ;YACV,KAAK,CAAC,aAAa,CAAC,iBAAiB,CAAC;YACtC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,iBAAiB,CAAC,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,CACxE,CAAC;IACH,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,iBAAqC;QAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;QAChC,MAAM,MAAM,GAAG,IAAI,CAAC,qBAAqB,CAAC,iBAAiB,CAAC,CAAC;QAE7D,IAAI,CAAC,MAAM,EAAE,CAAC;YACb,OAAO,IAAI,CAAC;QACb,CAAC;QAED,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACxB,OAAO,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC;QACjC,CAAC;QAED,OAAO,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC;IAClG,CAAC;CACD"}

package/dist/commands/elementSchemaCommand.d.ts

@@ -0,0 +1,62 @@
+import type { Editor, ModelElement, ModelDocumentFragment, ModelItem, ModelPosition, ModelRange } from 'ckeditor5';
+import { ElementOrPositionCommand, type ElementOrPosition } from 'ckeditor5-elements-core';
+/**
+ * The base of the commands of the elements of a schema, one for each kind of element: what they share is the element,
+ * the state, and how they find their targets and check the schema.
+ *
+ * * {@link ElementInlineCommand}: an inline element with text, as bold (an inline `block`);
+ * * {@link ElementBlockCommand}: a block, as a heading (a `block`);
+ * * {@link ElementContainerCommand}: a container of blocks, as a block quote (a `container`);
+ * * {@link ElementInsertCommand}: an element that is inserted, as a horizontal line, an inline image, or a card (an
+ *   `empty` element, and an inline `container`).
+ *
+ * As every {@link ElementOrPositionCommand}, it is for the selection, or for a given position or element, e.g. of a
+ * context menu.
+ */
+export default class ElementSchemaCommand extends ElementOrPositionCommand {
+    /**
+     * Whether the target is in the element, or is one, for the commands that toggle it.
+     *
+     * @observable
+     */
+    isOn: boolean;
+    /**
+     * The name of the model element of the command.
+     */
+    readonly elementName: string;
+    constructor(editor: Editor, elementName: string);
+    refresh(elementOrPosition?: ElementOrPosition): void;
+    /**
+     * Whether a node is an element of the command.
+     */
+    isElement(node: ModelItem | ModelDocumentFragment | null): node is ModelElement;
+    /**
+     * Returns the closest element of the command that the target is, or is in: by default, the selection. Never a root.
+     */
+    protected _findElement(elementOrPosition?: ElementOrPosition): ModelElement | null;
+    /**
+     * Returns the elements the target is, or is in (by default, the selection), the inner first: an element and its
+     * ancestors, or the parent of a position and its ancestors. Not the root.
+     */
+    protected _getAncestors(elementOrPosition?: ElementOrPosition): ModelElement[];
+    /**
+     * Returns the ranges of the selected content, when the command is for the selection, and the selection is content,
+     * not a cursor nor an element.
+     */
+    protected _getSelectedRanges(elementOrPosition?: ElementOrPosition): ModelRange[] | null;
+    /**
+     * Returns the blocks of the target, by default of the selection: the selected blocks, or the block-level element the
+     * target is, or is in (e.g. the paragraph with the cursor, a selected horizontal line, or a block quote).
+     */
+    protected _getBlocks(elementOrPosition?: ElementOrPosition): ModelElement[];
+    /**
+     * Whether an element (by default, the one of the command) can be at a position, and hold the items there: the check
+     * for wrapping them, or for renaming their parent.
+     */
+    protected _canHold(position: ModelPosition, items: Iterable<ModelItem>, name?: string): boolean;
+    /**
+     * Whether the children of an element can be in its place: the check for unwrapping it.
+     */
+    protected _canUnwrap(element: ModelElement): boolean;
+}
+//# sourceMappingURL=elementSchemaCommand.d.ts.map

package/dist/commands/elementSchemaCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elementSchemaCommand.d.ts","sourceRoot":"","sources":["../../src/commands/elementSchemaCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,qBAAqB,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACnH,OAAO,EAAE,wBAAwB,EAAE,KAAK,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE3F;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,OAAO,OAAO,oBAAqB,SAAQ,wBAAwB;IACzE;;;;OAIG;IACY,IAAI,EAAE,OAAO,CAAC;IAE7B;;OAEG;IACH,SAAgB,WAAW,EAAE,MAAM,CAAC;gBAExB,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAO/B,OAAO,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,IAAI;IAKpE;;OAEG;IACI,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,qBAAqB,GAAG,IAAI,GAAG,IAAI,IAAI,YAAY;IAItF;;OAEG;IACH,SAAS,CAAC,YAAY,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,YAAY,GAAG,IAAI;IAIlF;;;OAGG;IACH,SAAS,CAAC,aAAa,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,YAAY,EAAE;IAW9E;;;OAGG;IACH,SAAS,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,UAAU,EAAE,GAAG,IAAI;IAQxF;;;OAGG;IACH,SAAS,CAAC,UAAU,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,YAAY,EAAE;IAgB3E;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,SAAmB,GAAG,OAAO;IAmBzG;;OAEG;IACH,SAAS,CAAC,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;CAWpD"}

package/dist/commands/elementSchemaCommand.js

@@ -0,0 +1,107 @@
+import { ElementOrPositionCommand } from 'ckeditor5-elements-core';
+/**
+ * The base of the commands of the elements of a schema, one for each kind of element: what they share is the element,
+ * the state, and how they find their targets and check the schema.
+ *
+ * * {@link ElementInlineCommand}: an inline element with text, as bold (an inline `block`);
+ * * {@link ElementBlockCommand}: a block, as a heading (a `block`);
+ * * {@link ElementContainerCommand}: a container of blocks, as a block quote (a `container`);
+ * * {@link ElementInsertCommand}: an element that is inserted, as a horizontal line, an inline image, or a card (an
+ *   `empty` element, and an inline `container`).
+ *
+ * As every {@link ElementOrPositionCommand}, it is for the selection, or for a given position or element, e.g. of a
+ * context menu.
+ */
+export default class ElementSchemaCommand extends ElementOrPositionCommand {
+    /**
+     * The name of the model element of the command.
+     */
+    elementName;
+    constructor(editor, elementName) {
+        super(editor);
+        this.elementName = elementName;
+        this.set('isOn', false);
+    }
+    refresh(elementOrPosition) {
+        this.isOn = this._isOnFor(elementOrPosition);
+        super.refresh(elementOrPosition);
+    }
+    /**
+     * Whether a node is an element of the command.
+     */
+    isElement(node) {
+        return !!node?.is('element', this.elementName);
+    }
+    /**
+     * Returns the closest element of the command that the target is, or is in: by default, the selection. Never a root.
+     */
+    _findElement(elementOrPosition) {
+        return this._getAncestors(elementOrPosition).find(element => this.isElement(element)) ?? null;
+    }
+    /**
+     * Returns the elements the target is, or is in (by default, the selection), the inner first: an element and its
+     * ancestors, or the parent of a position and its ancestors. Not the root.
+     */
+    _getAncestors(elementOrPosition) {
+        const target = this._getElementOrPosition(elementOrPosition);
+        const element = target && (target.is('position') ? target.parent : target);
+        return element?.is('element')
+            ? element
+                .getAncestors({ includeSelf: true, parentFirst: true })
+                .filter((node) => node.is('element') && !node.is('rootElement'))
+            : [];
+    }
+    /**
+     * Returns the ranges of the selected content, when the command is for the selection, and the selection is content,
+     * not a cursor nor an element.
+     */
+    _getSelectedRanges(elementOrPosition) {
+        const selection = this.editor.model.document.selection;
+        return !elementOrPosition && !selection.isCollapsed && !selection.getSelectedElement()
+            ? Array.from(selection.getRanges())
+            : null;
+    }
+    /**
+     * Returns the blocks of the target, by default of the selection: the selected blocks, or the block-level element the
+     * target is, or is in (e.g. the paragraph with the cursor, a selected horizontal line, or a block quote).
+     */
+    _getBlocks(elementOrPosition) {
+        const selection = this.editor.model.document.selection;
+        const blocks = elementOrPosition || selection.getSelectedElement() ? [] : Array.from(selection.getSelectedBlocks());
+        if (blocks.length) {
+            return blocks;
+        }
+        const block = this._getAncestors(elementOrPosition).find(element => !this.editor.model.schema.isInline(element));
+        return block ? [block] : [];
+    }
+    /**
+     * Whether an element (by default, the one of the command) can be at a position, and hold the items there: the check
+     * for wrapping them, or for renaming their parent.
+     */
+    _canHold(position, items, name = this.elementName) {
+        const schema = this.editor.model.schema;
+        if (!schema.checkChild(position, name)) {
+            return false;
+        }
+        const parent = position.parent;
+        const context = [...parent.getAncestors({ includeSelf: true }).filter(node => node.is('element')), name];
+        for (const item of items) {
+            if (!schema.checkChild(context, item.is('$textProxy') ? '$text' : item)) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Whether the children of an element can be in its place: the check for unwrapping it.
+     */
+    _canUnwrap(element) {
+        const model = this.editor.model;
+        if (!element.parent) {
+            return false;
+        }
+        const position = model.createPositionBefore(element);
+        return Array.from(element.getChildren()).every(child => model.schema.checkChild(position, child));
+    }
+}
+//# sourceMappingURL=elementSchemaCommand.js.map

package/dist/commands/elementSchemaCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elementSchemaCommand.js","sourceRoot":"","sources":["../../src/commands/elementSchemaCommand.ts"],"names":[],"mappings":"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"}

package/dist/conversion/convertElementSchema.d.ts

@@ -0,0 +1,17 @@
+import type { Editor } from 'ckeditor5';
+import type { ElementSchemaElement, ElementSchemaInput } from '../definition/types.js';
+/**
+ * Returns the tag of an element in the data: a `span` for what is in a line of text (an inline element that is empty or
+ * has text), a `div` for the rest. An inline container is a `div`: it holds blocks, which a `span` cannot hold.
+ */
+export declare function getViewTag({ type, isInline }: Pick<ElementSchemaElement, 'type' | 'isInline'>): 'div' | 'span';
+/**
+ * Declares the converters of the elements of a schema, one to one: an element is a `div` or a `span` in the data (see
+ * {@link getViewTag}), with its name as the class. Its attributes are `data-*` attributes. The data is loaded as it is
+ * saved. The editing view is the same, except for the tag, when the element has an `editingTag`.
+ *
+ * The `empty` elements are empty in the data too: `<div class="divider"></div>`, with no filler. The inline elements with
+ * text have no block filler, so the cursor can go in an empty one (see `withoutBlockFiller()`).
+ */
+export declare function convertElementSchema(editor: Editor, input: ElementSchemaInput): void;
+//# sourceMappingURL=convertElementSchema.d.ts.map

package/dist/conversion/convertElementSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convertElementSchema.d.ts","sourceRoot":"","sources":["../../src/conversion/convertElementSchema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAGvF;;;GAGG;AACH,wBAAgB,UAAU,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,IAAI,CAAC,oBAAoB,EAAE,MAAM,GAAG,UAAU,CAAC,GAAG,KAAK,GAAG,MAAM,CAE9G;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,IAAI,CA4CpF"}

package/dist/conversion/convertElementSchema.js

@@ -0,0 +1,55 @@
+import { createInlineTextElement } from './inlineTextElement.js';
+/**
+ * Returns the tag of an element in the data: a `span` for what is in a line of text (an inline element that is empty or
+ * has text), a `div` for the rest. An inline container is a `div`: it holds blocks, which a `span` cannot hold.
+ */
+export function getViewTag({ type, isInline }) {
+    return isInline && type !== 'container' ? 'span' : 'div';
+}
+/**
+ * Declares the converters of the elements of a schema, one to one: an element is a `div` or a `span` in the data (see
+ * {@link getViewTag}), with its name as the class. Its attributes are `data-*` attributes. The data is loaded as it is
+ * saved. The editing view is the same, except for the tag, when the element has an `editingTag`.
+ *
+ * The `empty` elements are empty in the data too: `<div class="divider"></div>`, with no filler. The inline elements with
+ * text have no block filler, so the cursor can go in an empty one (see `withoutBlockFiller()`).
+ */
+export function convertElementSchema(editor, input) {
+    const { conversion } = editor;
+    for (const [name, element] of Object.entries(input)) {
+        const { type, isInline, editingTag, allowAttributes } = element;
+        const tag = getViewTag(element);
+        const view = { name: tag, classes: name };
+        const isInlineText = type === 'block' && !!isInline;
+        for (const key of allowAttributes ?? []) {
+            // The names of HTML attributes are lowercase, so the data has them in lowercase; the model keeps the key as it is.
+            conversion.attributeToAttribute({ model: { name, key }, view: `data-${key.toLowerCase()}` });
+        }
+        // Upcast, data downcast and editing downcast at once; what differs is declared with a higher priority.
+        conversion.elementToElement({ model: name, view });
+        if (type === 'empty') {
+            conversion.for('dataDowncast').elementToElement({
+                model: name,
+                view: (_element, { writer }) => writer.createEmptyElement(tag, { class: name }),
+                converterPriority: 'high'
+            });
+        }
+        if (isInlineText) {
+            conversion.for('dataDowncast').elementToElement({
+                model: name,
+                view: (_element, { writer }) => createInlineTextElement(writer, tag, name),
+                converterPriority: 'high'
+            });
+        }
+        if (editingTag || isInlineText) {
+            conversion.for('editingDowncast').elementToElement({
+                model: name,
+                view: (_element, { writer }) => isInlineText
+                    ? createInlineTextElement(writer, editingTag ?? tag, name)
+                    : writer.createContainerElement(editingTag ?? tag, { class: name }),
+                converterPriority: 'high'
+            });
+        }
+    }
+}
+//# sourceMappingURL=convertElementSchema.js.map

package/dist/conversion/convertElementSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convertElementSchema.js","sourceRoot":"","sources":["../../src/conversion/convertElementSchema.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAmD;IAC7F,OAAO,QAAQ,IAAI,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;AAC1D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc,EAAE,KAAyB;IAC7E,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;IAE9B,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACrD,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe,EAAE,GAAG,OAA+B,CAAC;QACxF,MAAM,GAAG,GAAG,UAAU,CAAC,OAA+B,CAAC,CAAC;QACxD,MAAM,IAAI,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC1C,MAAM,YAAY,GAAG,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,QAAQ,CAAC;QAEpD,KAAK,MAAM,GAAG,IAAI,eAAe,IAAI,EAAE,EAAE,CAAC;YACzC,mHAAmH;YACnH,UAAU,CAAC,oBAAoB,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,GAAG,CAAC,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC;QAC9F,CAAC;QAED,uGAAuG;QACvG,UAAU,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAEnD,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YACtB,UAAU,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,gBAAgB,CAAC;gBAC/C,KAAK,EAAE,IAAI;gBACX,IAAI,EAAE,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,kBAAkB,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;gBAC/E,iBAAiB,EAAE,MAAM;aACzB,CAAC,CAAC;QACJ,CAAC;QAED,IAAI,YAAY,EAAE,CAAC;YAClB,UAAU,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,gBAAgB,CAAC;gBAC/C,KAAK,EAAE,IAAI;gBACX,IAAI,EAAE,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,uBAAuB,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC;gBAC1E,iBAAiB,EAAE,MAAM;aACzB,CAAC,CAAC;QACJ,CAAC;QAED,IAAI,UAAU,IAAI,YAAY,EAAE,CAAC;YAChC,UAAU,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,gBAAgB,CAAC;gBAClD,KAAK,EAAE,IAAI;gBACX,IAAI,EAAE,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAC9B,YAAY;oBACX,CAAC,CAAC,uBAAuB,CAAC,MAAM,EAAE,UAAU,IAAI,GAAG,EAAE,IAAI,CAAC;oBAC1D,CAAC,CAAC,MAAM,CAAC,sBAAsB,CAAC,UAAU,IAAI,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;gBACrE,iBAAiB,EAAE,MAAM;aACzB,CAAC,CAAC;QACJ,CAAC;IACF,CAAC;AACF,CAAC"}