@ckeditor/ckeditor5-list 39.0.2 → 40.0.0

package/src/documentlist/documentlistindentcommand.d.ts

@@ -1,62 +1,62 @@
-/**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
- */
-/**
- * @module list/documentlist/documentlistindentcommand
- */
-import { Command, type Editor } from 'ckeditor5/src/core';
-import type { Element } from 'ckeditor5/src/engine';
-/**
- * The document list indent command. It is used by the {@link module:list/documentlist~DocumentList list feature}.
- */
-export default class DocumentListIndentCommand extends Command {
-    /**
-     * Determines by how much the command will change the list item's indent attribute.
-     */
-    private readonly _direction;
-    /**
-     * Creates an instance of the command.
-     *
-     * @param editor The editor instance.
-     * @param indentDirection The direction of indent. If it is equal to `backward`, the command
-     * will outdent a list item.
-     */
-    constructor(editor: Editor, indentDirection: 'forward' | 'backward');
-    /**
-     * @inheritDoc
-     */
-    refresh(): void;
-    /**
-     * Indents or outdents (depending on the {@link #constructor}'s `indentDirection` parameter) selected list items.
-     *
-     * @fires execute
-     * @fires afterExecute
-     */
-    execute(): void;
-    /**
-     * Fires the `afterExecute` event.
-     *
-     * @param changedBlocks The changed list elements.
-     */
-    private _fireAfterExecute;
-    /**
-     * Checks whether the command can be enabled in the current context.
-     *
-     * @returns Whether the command should be enabled.
-     */
-    private _checkEnabled;
-}
-/**
- * Event fired by the {@link ~DocumentListIndentCommand#execute} method.
- *
- * It allows to execute an action after executing the {@link module:list/documentlist/documentlistcommand~DocumentListCommand#execute}
- * method, for example adjusting attributes of changed list items.
- *
- * @internal
- * @eventName ~DocumentListIndentCommand#afterExecute
- */
-export type DocumentListIndentCommandAfterExecuteEvent = {
-    name: 'afterExecute';
-    args: [changedBlocks: Array<Element>];
-};
+/**
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module list/documentlist/documentlistindentcommand
+ */
+import { Command, type Editor } from 'ckeditor5/src/core';
+import type { Element } from 'ckeditor5/src/engine';
+/**
+ * The document list indent command. It is used by the {@link module:list/documentlist~DocumentList list feature}.
+ */
+export default class DocumentListIndentCommand extends Command {
+    /**
+     * Determines by how much the command will change the list item's indent attribute.
+     */
+    private readonly _direction;
+    /**
+     * Creates an instance of the command.
+     *
+     * @param editor The editor instance.
+     * @param indentDirection The direction of indent. If it is equal to `backward`, the command
+     * will outdent a list item.
+     */
+    constructor(editor: Editor, indentDirection: 'forward' | 'backward');
+    /**
+     * @inheritDoc
+     */
+    refresh(): void;
+    /**
+     * Indents or outdents (depending on the {@link #constructor}'s `indentDirection` parameter) selected list items.
+     *
+     * @fires execute
+     * @fires afterExecute
+     */
+    execute(): void;
+    /**
+     * Fires the `afterExecute` event.
+     *
+     * @param changedBlocks The changed list elements.
+     */
+    private _fireAfterExecute;
+    /**
+     * Checks whether the command can be enabled in the current context.
+     *
+     * @returns Whether the command should be enabled.
+     */
+    private _checkEnabled;
+}
+/**
+ * Event fired by the {@link ~DocumentListIndentCommand#execute} method.
+ *
+ * It allows to execute an action after executing the {@link module:list/documentlist/documentlistcommand~DocumentListCommand#execute}
+ * method, for example adjusting attributes of changed list items.
+ *
+ * @internal
+ * @eventName ~DocumentListIndentCommand#afterExecute
+ */
+export type DocumentListIndentCommandAfterExecuteEvent = {
+    name: 'afterExecute';
+    args: [changedBlocks: Array<Element>];
+};

package/src/documentlist/documentlistindentcommand.js

@@ -1,129 +1,129 @@
-/**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
- */
-/**
- * @module list/documentlist/documentlistindentcommand
- */
-import { Command } from 'ckeditor5/src/core';
-import { expandListBlocksToCompleteItems, indentBlocks, isFirstBlockOfListItem, isListItemBlock, isSingleListItem, outdentBlocksWithMerge, sortBlocks, splitListItemBefore } from './utils/model';
-import ListWalker from './utils/listwalker';
-/**
- * The document list indent command. It is used by the {@link module:list/documentlist~DocumentList list feature}.
- */
-export default class DocumentListIndentCommand extends Command {
-    /**
-     * Creates an instance of the command.
-     *
-     * @param editor The editor instance.
-     * @param indentDirection The direction of indent. If it is equal to `backward`, the command
-     * will outdent a list item.
-     */
-    constructor(editor, indentDirection) {
-        super(editor);
-        this._direction = indentDirection;
-    }
-    /**
-     * @inheritDoc
-     */
-    refresh() {
-        this.isEnabled = this._checkEnabled();
-    }
-    /**
-     * Indents or outdents (depending on the {@link #constructor}'s `indentDirection` parameter) selected list items.
-     *
-     * @fires execute
-     * @fires afterExecute
-     */
-    execute() {
-        const model = this.editor.model;
-        const blocks = getSelectedListBlocks(model.document.selection);
-        model.change(writer => {
-            const changedBlocks = [];
-            // Handle selection contained in the single list item and starting in the following blocks.
-            if (isSingleListItem(blocks) && !isFirstBlockOfListItem(blocks[0])) {
-                // Allow increasing indent of following list item blocks.
-                if (this._direction == 'forward') {
-                    changedBlocks.push(...indentBlocks(blocks, writer));
-                }
-                // For indent make sure that indented blocks have a new ID.
-                // For outdent just split blocks from the list item (give them a new IDs).
-                changedBlocks.push(...splitListItemBefore(blocks[0], writer));
-            }
-            // More than a single list item is selected, or the first block of list item is selected.
-            else {
-                // Now just update the attributes of blocks.
-                if (this._direction == 'forward') {
-                    changedBlocks.push(...indentBlocks(blocks, writer, { expand: true }));
-                }
-                else {
-                    changedBlocks.push(...outdentBlocksWithMerge(blocks, writer));
-                }
-            }
-            // Align the list item type to match the previous list item (from the same list).
-            for (const block of changedBlocks) {
-                // This block become a plain block (for example a paragraph).
-                if (!block.hasAttribute('listType')) {
-                    continue;
-                }
-                const previousItemBlock = ListWalker.first(block, { sameIndent: true });
-                if (previousItemBlock) {
-                    writer.setAttribute('listType', previousItemBlock.getAttribute('listType'), block);
-                }
-            }
-            this._fireAfterExecute(changedBlocks);
-        });
-    }
-    /**
-     * Fires the `afterExecute` event.
-     *
-     * @param changedBlocks The changed list elements.
-     */
-    _fireAfterExecute(changedBlocks) {
-        this.fire('afterExecute', sortBlocks(new Set(changedBlocks)));
-    }
-    /**
-     * Checks whether the command can be enabled in the current context.
-     *
-     * @returns Whether the command should be enabled.
-     */
-    _checkEnabled() {
-        // Check whether any of position's ancestor is a list item.
-        let blocks = getSelectedListBlocks(this.editor.model.document.selection);
-        let firstBlock = blocks[0];
-        // If selection is not in a list item, the command is disabled.
-        if (!firstBlock) {
-            return false;
-        }
-        // If we are outdenting it is enough to be in list item. Every list item can always be outdented.
-        if (this._direction == 'backward') {
-            return true;
-        }
-        // A single block of a list item is selected, so it could be indented as a sublist.
-        if (isSingleListItem(blocks) && !isFirstBlockOfListItem(blocks[0])) {
-            return true;
-        }
-        blocks = expandListBlocksToCompleteItems(blocks);
-        firstBlock = blocks[0];
-        // Check if there is any list item before selected items that could become a parent of selected items.
-        const siblingItem = ListWalker.first(firstBlock, { sameIndent: true });
-        if (!siblingItem) {
-            return false;
-        }
-        if (siblingItem.getAttribute('listType') == firstBlock.getAttribute('listType')) {
-            return true;
-        }
-        return false;
-    }
-}
-/**
- * Returns an array of selected blocks truncated to the first non list block element.
- */
-function getSelectedListBlocks(selection) {
-    const blocks = Array.from(selection.getSelectedBlocks());
-    const firstNonListBlockIndex = blocks.findIndex(block => !isListItemBlock(block));
-    if (firstNonListBlockIndex != -1) {
-        blocks.length = firstNonListBlockIndex;
-    }
-    return blocks;
-}
+/**
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module list/documentlist/documentlistindentcommand
+ */
+import { Command } from 'ckeditor5/src/core';
+import { expandListBlocksToCompleteItems, indentBlocks, isFirstBlockOfListItem, isListItemBlock, isSingleListItem, outdentBlocksWithMerge, sortBlocks, splitListItemBefore } from './utils/model';
+import ListWalker from './utils/listwalker';
+/**
+ * The document list indent command. It is used by the {@link module:list/documentlist~DocumentList list feature}.
+ */
+export default class DocumentListIndentCommand extends Command {
+    /**
+     * Creates an instance of the command.
+     *
+     * @param editor The editor instance.
+     * @param indentDirection The direction of indent. If it is equal to `backward`, the command
+     * will outdent a list item.
+     */
+    constructor(editor, indentDirection) {
+        super(editor);
+        this._direction = indentDirection;
+    }
+    /**
+     * @inheritDoc
+     */
+    refresh() {
+        this.isEnabled = this._checkEnabled();
+    }
+    /**
+     * Indents or outdents (depending on the {@link #constructor}'s `indentDirection` parameter) selected list items.
+     *
+     * @fires execute
+     * @fires afterExecute
+     */
+    execute() {
+        const model = this.editor.model;
+        const blocks = getSelectedListBlocks(model.document.selection);
+        model.change(writer => {
+            const changedBlocks = [];
+            // Handle selection contained in the single list item and starting in the following blocks.
+            if (isSingleListItem(blocks) && !isFirstBlockOfListItem(blocks[0])) {
+                // Allow increasing indent of following list item blocks.
+                if (this._direction == 'forward') {
+                    changedBlocks.push(...indentBlocks(blocks, writer));
+                }
+                // For indent make sure that indented blocks have a new ID.
+                // For outdent just split blocks from the list item (give them a new IDs).
+                changedBlocks.push(...splitListItemBefore(blocks[0], writer));
+            }
+            // More than a single list item is selected, or the first block of list item is selected.
+            else {
+                // Now just update the attributes of blocks.
+                if (this._direction == 'forward') {
+                    changedBlocks.push(...indentBlocks(blocks, writer, { expand: true }));
+                }
+                else {
+                    changedBlocks.push(...outdentBlocksWithMerge(blocks, writer));
+                }
+            }
+            // Align the list item type to match the previous list item (from the same list).
+            for (const block of changedBlocks) {
+                // This block become a plain block (for example a paragraph).
+                if (!block.hasAttribute('listType')) {
+                    continue;
+                }
+                const previousItemBlock = ListWalker.first(block, { sameIndent: true });
+                if (previousItemBlock) {
+                    writer.setAttribute('listType', previousItemBlock.getAttribute('listType'), block);
+                }
+            }
+            this._fireAfterExecute(changedBlocks);
+        });
+    }
+    /**
+     * Fires the `afterExecute` event.
+     *
+     * @param changedBlocks The changed list elements.
+     */
+    _fireAfterExecute(changedBlocks) {
+        this.fire('afterExecute', sortBlocks(new Set(changedBlocks)));
+    }
+    /**
+     * Checks whether the command can be enabled in the current context.
+     *
+     * @returns Whether the command should be enabled.
+     */
+    _checkEnabled() {
+        // Check whether any of position's ancestor is a list item.
+        let blocks = getSelectedListBlocks(this.editor.model.document.selection);
+        let firstBlock = blocks[0];
+        // If selection is not in a list item, the command is disabled.
+        if (!firstBlock) {
+            return false;
+        }
+        // If we are outdenting it is enough to be in list item. Every list item can always be outdented.
+        if (this._direction == 'backward') {
+            return true;
+        }
+        // A single block of a list item is selected, so it could be indented as a sublist.
+        if (isSingleListItem(blocks) && !isFirstBlockOfListItem(blocks[0])) {
+            return true;
+        }
+        blocks = expandListBlocksToCompleteItems(blocks);
+        firstBlock = blocks[0];
+        // Check if there is any list item before selected items that could become a parent of selected items.
+        const siblingItem = ListWalker.first(firstBlock, { sameIndent: true });
+        if (!siblingItem) {
+            return false;
+        }
+        if (siblingItem.getAttribute('listType') == firstBlock.getAttribute('listType')) {
+            return true;
+        }
+        return false;
+    }
+}
+/**
+ * Returns an array of selected blocks truncated to the first non list block element.
+ */
+function getSelectedListBlocks(selection) {
+    const blocks = Array.from(selection.getSelectedBlocks());
+    const firstNonListBlockIndex = blocks.findIndex(block => !isListItemBlock(block));
+    if (firstNonListBlockIndex != -1) {
+        blocks.length = firstNonListBlockIndex;
+    }
+    return blocks;
+}

package/src/documentlist/documentlistmergecommand.d.ts

@@ -1,76 +1,76 @@
-/**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
- */
-/**
- * @module list/documentlist/documentlistmergecommand
- */
-import { Command, type Editor } from 'ckeditor5/src/core';
-import type { Element } from 'ckeditor5/src/engine';
-/**
- * The document list merge command. It is used by the {@link module:list/documentlist~DocumentList list feature}.
- */
-export default class DocumentListMergeCommand extends Command {
-    /**
-     * Whether list item should be merged before or after the selected block.
-     */
-    private readonly _direction;
-    /**
-     * Creates an instance of the command.
-     *
-     * @param editor The editor instance.
-     * @param direction Whether list item should be merged before or after the selected block.
-     */
-    constructor(editor: Editor, direction: 'forward' | 'backward');
-    /**
-     * @inheritDoc
-     */
-    refresh(): void;
-    /**
-     * Merges list blocks together (depending on the {@link #constructor}'s `direction` parameter).
-     *
-     * @fires execute
-     * @fires afterExecute
-     * @param options Command options.
-     * @param options.shouldMergeOnBlocksContentLevel When set `true`, merging will be performed together
-     * with {@link module:engine/model/model~Model#deleteContent} to get rid of the inline content in the selection or take advantage
-     * of the heuristics in `deleteContent()` that helps convert lists into paragraphs in certain cases.
-     */
-    execute({ shouldMergeOnBlocksContentLevel }?: {
-        shouldMergeOnBlocksContentLevel?: boolean;
-    }): void;
-    /**
-     * Fires the `afterExecute` event.
-     *
-     * @param changedBlocks The changed list elements.
-     */
-    private _fireAfterExecute;
-    /**
-     * Checks whether the command can be enabled in the current context.
-     *
-     * @returns Whether the command should be enabled.
-     */
-    private _checkEnabled;
-    /**
-     * Returns the boundary elements the merge should be executed for. These are not necessarily selection's first
-     * and last position parents but sometimes sibling or even further blocks depending on the context.
-     *
-     * @param selection The selection the merge is executed for.
-     * @param shouldMergeOnBlocksContentLevel When `true`, merge is performed together with
-     * {@link module:engine/model/model~Model#deleteContent} to remove the inline content within the selection.
-     */
-    private _getMergeSubjectElements;
-}
-/**
- * Event fired by the {@link ~DocumentListMergeCommand#execute} method.
- *
- * It allows to execute an action after executing the {@link module:list/documentlist/documentlistcommand~DocumentListCommand#execute}
- * method, for example adjusting attributes of changed list items.
- *
- * @internal
- * @eventName ~DocumentListMergeCommand#afterExecute
- */
-export type DocumentListMergeCommandAfterExecuteEvent = {
-    name: 'afterExecute';
-    args: [changedBlocks: Array<Element>];
-};
+/**
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module list/documentlist/documentlistmergecommand
+ */
+import { Command, type Editor } from 'ckeditor5/src/core';
+import type { Element } from 'ckeditor5/src/engine';
+/**
+ * The document list merge command. It is used by the {@link module:list/documentlist~DocumentList list feature}.
+ */
+export default class DocumentListMergeCommand extends Command {
+    /**
+     * Whether list item should be merged before or after the selected block.
+     */
+    private readonly _direction;
+    /**
+     * Creates an instance of the command.
+     *
+     * @param editor The editor instance.
+     * @param direction Whether list item should be merged before or after the selected block.
+     */
+    constructor(editor: Editor, direction: 'forward' | 'backward');
+    /**
+     * @inheritDoc
+     */
+    refresh(): void;
+    /**
+     * Merges list blocks together (depending on the {@link #constructor}'s `direction` parameter).
+     *
+     * @fires execute
+     * @fires afterExecute
+     * @param options Command options.
+     * @param options.shouldMergeOnBlocksContentLevel When set `true`, merging will be performed together
+     * with {@link module:engine/model/model~Model#deleteContent} to get rid of the inline content in the selection or take advantage
+     * of the heuristics in `deleteContent()` that helps convert lists into paragraphs in certain cases.
+     */
+    execute({ shouldMergeOnBlocksContentLevel }?: {
+        shouldMergeOnBlocksContentLevel?: boolean;
+    }): void;
+    /**
+     * Fires the `afterExecute` event.
+     *
+     * @param changedBlocks The changed list elements.
+     */
+    private _fireAfterExecute;
+    /**
+     * Checks whether the command can be enabled in the current context.
+     *
+     * @returns Whether the command should be enabled.
+     */
+    private _checkEnabled;
+    /**
+     * Returns the boundary elements the merge should be executed for. These are not necessarily selection's first
+     * and last position parents but sometimes sibling or even further blocks depending on the context.
+     *
+     * @param selection The selection the merge is executed for.
+     * @param shouldMergeOnBlocksContentLevel When `true`, merge is performed together with
+     * {@link module:engine/model/model~Model#deleteContent} to remove the inline content within the selection.
+     */
+    private _getMergeSubjectElements;
+}
+/**
+ * Event fired by the {@link ~DocumentListMergeCommand#execute} method.
+ *
+ * It allows to execute an action after executing the {@link module:list/documentlist/documentlistcommand~DocumentListCommand#execute}
+ * method, for example adjusting attributes of changed list items.
+ *
+ * @internal
+ * @eventName ~DocumentListMergeCommand#afterExecute
+ */
+export type DocumentListMergeCommandAfterExecuteEvent = {
+    name: 'afterExecute';
+    args: [changedBlocks: Array<Element>];
+};