@ckeditor/ckeditor5-list 41.4.2 → 42.0.0-alpha.1

package/dist/index.js

@@ -5,33 +5,82 @@
 import { Command, Plugin, icons } from '@ckeditor/ckeditor5-core/dist/index.js';
 import { Delete } from '@ckeditor/ckeditor5-typing/dist/index.js';
 import { Enter } from '@ckeditor/ckeditor5-enter/dist/index.js';
-import { first, toArray, uid, CKEditorError, global, FocusTracker, KeystrokeHandler, parseKeystroke, getCode, getLocalizedArrowKeyCodeDirection, createElement, logWarning } from '@ckeditor/ckeditor5-utils/dist/index.js';
+import { toArray, first, uid, CKEditorError, FocusTracker, KeystrokeHandler, global, getCode, parseKeystroke, getLocalizedArrowKeyCodeDirection, createElement, logWarning } from '@ckeditor/ckeditor5-utils/dist/index.js';
 import { UpcastWriter, DomEventObserver, Matcher, TreeWalker, getFillerOffset } from '@ckeditor/ckeditor5-engine/dist/index.js';
 import { ClipboardPipeline } from '@ckeditor/ckeditor5-clipboard/dist/index.js';
-import { ButtonView, MenuBarMenuListItemButtonView, View, addKeyboardHandlingForGrid, CollapsibleView, LabeledFieldView, createLabeledInputNumber, SwitchButtonView, ViewCollection, FocusCycler, createDropdown, SplitButtonView, focusChildOnDropdownOpen, MenuBarMenuView } from '@ckeditor/ckeditor5-ui/dist/index.js';
+import { ButtonView, MenuBarMenuListItemButtonView, View, ViewCollection, FocusCycler, addKeyboardHandlingForGrid, CollapsibleView, LabeledFieldView, createLabeledInputNumber, SwitchButtonView, createDropdown, SplitButtonView, focusChildOnDropdownOpen, MenuBarMenuView } from '@ckeditor/ckeditor5-ui/dist/index.js';
 
-class ListWalker {
-    /**
-     * Performs only first step of iteration and returns the result.
-     *
-     * @param startElement The start list item block element.
-     * @param options.direction The iterating direction.
-     * @param options.includeSelf Whether start block should be included in the result (if it's matching other criteria).
-     * @param options.sameAttributes Additional attributes that must be the same for each block.
-     * @param options.sameIndent Whether blocks with the same indent level as the start block should be included
-     * in the result.
-     * @param options.lowerIndent Whether blocks with a lower indent level than the start block should be included
-     * in the result.
-     * @param options.higherIndent Whether blocks with a higher indent level than the start block should be included
-     * in the result.
-     */ static first(startElement, options) {
+/**
+ * Document list blocks iterator.
+ */ class ListWalker {
+    /**
+	 * The start list item block element.
+	 */ _startElement;
+    /**
+	 * The reference indent. Initialized by the indent of the start block.
+	 */ _referenceIndent;
+    /**
+	 * The iterating direction.
+	 */ _isForward;
+    /**
+	 * Whether start block should be included in the result (if it's matching other criteria).
+	 */ _includeSelf;
+    /**
+	 * Additional attributes that must be the same for each block.
+	 */ _sameAttributes;
+    /**
+	 * Whether blocks with the same indent level as the start block should be included in the result.
+	 */ _sameIndent;
+    /**
+	 * Whether blocks with a lower indent level than the start block should be included in the result.
+	 */ _lowerIndent;
+    /**
+	 * Whether blocks with a higher indent level than the start block should be included in the result.
+	 */ _higherIndent;
+    /**
+	 * Creates a document list iterator.
+	 *
+	 * @param startElement The start list item block element.
+	 * @param options.direction The iterating direction.
+	 * @param options.includeSelf Whether start block should be included in the result (if it's matching other criteria).
+	 * @param options.sameAttributes Additional attributes that must be the same for each block.
+	 * @param options.sameIndent Whether blocks with the same indent level as the start block should be included
+	 * in the result.
+	 * @param options.lowerIndent Whether blocks with a lower indent level than the start block should be included
+	 * in the result.
+	 * @param options.higherIndent Whether blocks with a higher indent level than the start block should be included
+	 * in the result.
+	 */ constructor(startElement, options){
+        this._startElement = startElement;
+        this._referenceIndent = startElement.getAttribute('listIndent');
+        this._isForward = options.direction == 'forward';
+        this._includeSelf = !!options.includeSelf;
+        this._sameAttributes = toArray(options.sameAttributes || []);
+        this._sameIndent = !!options.sameIndent;
+        this._lowerIndent = !!options.lowerIndent;
+        this._higherIndent = !!options.higherIndent;
+    }
+    /**
+	 * Performs only first step of iteration and returns the result.
+	 *
+	 * @param startElement The start list item block element.
+	 * @param options.direction The iterating direction.
+	 * @param options.includeSelf Whether start block should be included in the result (if it's matching other criteria).
+	 * @param options.sameAttributes Additional attributes that must be the same for each block.
+	 * @param options.sameIndent Whether blocks with the same indent level as the start block should be included
+	 * in the result.
+	 * @param options.lowerIndent Whether blocks with a lower indent level than the start block should be included
+	 * in the result.
+	 * @param options.higherIndent Whether blocks with a higher indent level than the start block should be included
+	 * in the result.
+	 */ static first(startElement, options) {
         const walker = new this(startElement, options);
         const iterator = walker[Symbol.iterator]();
         return first(iterator);
     }
     /**
-     * Iterable interface.
-     */ *[Symbol.iterator]() {
+	 * Iterable interface.
+	 */ *[Symbol.iterator]() {
         const nestedItems = [];
         for (const { node } of iterateSiblingListBlocks(this._getStartNode(), this._isForward ? 'forward' : 'backward')){
             const indent = node.getAttribute('listIndent');
@@ -81,36 +130,13 @@ class ListWalker {
         }
     }
     /**
-     * Returns the model element to start iterating.
-     */ _getStartNode() {
+	 * Returns the model element to start iterating.
+	 */ _getStartNode() {
         if (this._includeSelf) {
             return this._startElement;
         }
         return this._isForward ? this._startElement.nextSibling : this._startElement.previousSibling;
     }
-    /**
-     * Creates a document list iterator.
-     *
-     * @param startElement The start list item block element.
-     * @param options.direction The iterating direction.
-     * @param options.includeSelf Whether start block should be included in the result (if it's matching other criteria).
-     * @param options.sameAttributes Additional attributes that must be the same for each block.
-     * @param options.sameIndent Whether blocks with the same indent level as the start block should be included
-     * in the result.
-     * @param options.lowerIndent Whether blocks with a lower indent level than the start block should be included
-     * in the result.
-     * @param options.higherIndent Whether blocks with a higher indent level than the start block should be included
-     * in the result.
-     */ constructor(startElement, options){
-        this._startElement = startElement;
-        this._referenceIndent = startElement.getAttribute('listIndent');
-        this._isForward = options.direction == 'forward';
-        this._includeSelf = !!options.includeSelf;
-        this._sameAttributes = toArray(options.sameAttributes || []);
-        this._sameIndent = !!options.sameIndent;
-        this._lowerIndent = !!options.lowerIndent;
-        this._higherIndent = !!options.higherIndent;
-    }
 }
 /**
  * Iterates sibling list blocks starting from the given node.
@@ -153,17 +179,18 @@ class ListWalker {
  *
  * @internal
  */ class ListBlocksIterable {
+    _listHead;
     /**
-     * List blocks iterator.
-     *
-     * Iterates over all blocks of a list.
-     */ [Symbol.iterator]() {
-        return iterateSiblingListBlocks(this._listHead, 'forward');
+	 * @param listHead The head element of a list.
+	 */ constructor(listHead){
+        this._listHead = listHead;
     }
     /**
-     * @param listHead The head element of a list.
-     */ constructor(listHead){
-        this._listHead = listHead;
+	 * List blocks iterator.
+	 *
+	 * Iterates over all blocks of a list.
+	 */ [Symbol.iterator]() {
+        return iterateSiblingListBlocks(this._listHead, 'forward');
     }
 }
 
@@ -173,10 +200,10 @@ class ListWalker {
  * @internal
  */ class ListItemUid {
     /**
-     * Returns the next ID.
-     *
-     * @internal
-     */ /* istanbul ignore next: static function definition -- @preserve */ static next() {
+	 * Returns the next ID.
+	 *
+	 * @internal
+	 */ /* istanbul ignore next: static function definition -- @preserve */ static next() {
         return uid();
     }
 }
@@ -615,18 +642,33 @@ class ListWalker {
     return [];
 }
 
-class ListIndentCommand extends Command {
+/**
+ * The document list indent command. It is used by the {@link module:list/list~List list feature}.
+ */ class ListIndentCommand extends Command {
+    /**
+	 * Determines by how much the command will change the list item's indent attribute.
+	 */ _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, indentDirection){
+        super(editor);
+        this._direction = indentDirection;
+    }
     /**
-     * @inheritDoc
-     */ refresh() {
+	 * @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() {
+	 * 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)=>{
@@ -667,17 +709,17 @@ class ListIndentCommand extends Command {
         });
     }
     /**
-     * Fires the `afterExecute` event.
-     *
-     * @param changedBlocks The changed list elements.
-     */ _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() {
+	 * 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];
@@ -707,16 +749,6 @@ class ListIndentCommand extends Command {
         }
         return false;
     }
-    /**
-     * 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;
-    }
 }
 /**
  * Returns an array of selected blocks truncated to the first non list block element.
@@ -729,24 +761,49 @@ class ListIndentCommand extends Command {
     return blocks;
 }
 
-class ListCommand extends Command {
+/**
+ * The list command. It is used by the {@link module:list/list~List list feature}.
+ */ class ListCommand extends Command {
+    /**
+	 * The type of the list created by the command.
+	 */ type;
+    /**
+	 * List Walker options that change the range of the list items to be changed when the selection is collapsed within a list item.
+	 *
+	 * In a multi-level list, when the selection is collapsed within a list item, instead of changing only the list items of the same list
+	 * type and current indent level, the entire list structure is changed (all list items at all indent levels of any list type).
+	 */ _listWalkerOptions;
+    /**
+	 * Creates an instance of the command.
+	 *
+	 * @param editor The editor instance.
+	 * @param type List type that will be handled by this command.
+	 */ constructor(editor, type, options = {}){
+        super(editor);
+        this.type = type;
+        this._listWalkerOptions = options.multiLevel ? {
+            higherIndent: true,
+            lowerIndent: true,
+            sameAttributes: []
+        } : undefined;
+    }
     /**
-     * @inheritDoc
-     */ refresh() {
+	 * @inheritDoc
+	 */ refresh() {
         this.value = this._getValue();
         this.isEnabled = this._checkEnabled();
     }
     /**
-     * Executes the list command.
-     *
-     * @fires execute
-     * @fires afterExecute
-     * @param options Command options.
-     * @param options.forceValue If set, it will force the command behavior. If `true`, the command will try to convert the
-     * selected items and potentially the neighbor elements to the proper list items. If set to `false` it will convert selected elements
-     * to paragraphs. If not set, the command will toggle selected elements to list items or paragraphs, depending on the selection.
-     * @param options.additionalAttributes Additional attributes that are set for list items when the command is executed.
-     */ execute(options = {}) {
+	 * Executes the list command.
+	 *
+	 * @fires execute
+	 * @fires afterExecute
+	 * @param options Command options.
+	 * @param options.forceValue If set, it will force the command behavior. If `true`, the command will try to convert the
+	 * selected items and potentially the neighbor elements to the proper list items. If set to `false` it will convert selected elements
+	 * to paragraphs. If not set, the command will toggle selected elements to list items or paragraphs, depending on the selection.
+	 * @param options.additionalAttributes Additional attributes that are set for list items when the command is executed.
+	 */ execute(options = {}) {
         const model = this.editor.model;
         const document = model.document;
         const selectedBlockObject = getSelectedBlockObject(model);
@@ -813,17 +870,17 @@ class ListCommand extends Command {
         });
     }
     /**
-     * Fires the `afterExecute` event.
-     *
-     * @param changedBlocks The changed list elements.
-     */ _fireAfterExecute(changedBlocks) {
+	 * Fires the `afterExecute` event.
+	 *
+	 * @param changedBlocks The changed list elements.
+	 */ _fireAfterExecute(changedBlocks) {
         this.fire('afterExecute', sortBlocks(new Set(changedBlocks)));
     }
     /**
-     * Checks the command's {@link #value}.
-     *
-     * @returns The current value.
-     */ _getValue() {
+	 * Checks the command's {@link #value}.
+	 *
+	 * @returns The current value.
+	 */ _getValue() {
         const selection = this.editor.model.document.selection;
         const blocks = Array.from(selection.getSelectedBlocks());
         if (!blocks.length) {
@@ -837,10 +894,10 @@ class ListCommand extends Command {
         return true;
     }
     /**
-     * Checks whether the command can be enabled in the current context.
-     *
-     * @returns Whether the command should be enabled.
-     */ _checkEnabled() {
+	 * Checks whether the command can be enabled in the current context.
+	 *
+	 * @returns Whether the command should be enabled.
+	 */ _checkEnabled() {
         const model = this.editor.model;
         const schema = model.schema;
         const selection = model.document.selection;
@@ -859,38 +916,38 @@ class ListCommand extends Command {
         }
         return false;
     }
+}
+
+/**
+ * The document list merge command. It is used by the {@link module:list/list~List list feature}.
+ */ class ListMergeCommand extends Command {
+    /**
+	 * Whether list item should be merged before or after the selected block.
+	 */ _direction;
     /**
-     * Creates an instance of the command.
-     *
-     * @param editor The editor instance.
-     * @param type List type that will be handled by this command.
-     */ constructor(editor, type, options = {}){
+	 * 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, direction){
         super(editor);
-        this.type = type;
-        this._listWalkerOptions = options.multiLevel ? {
-            higherIndent: true,
-            lowerIndent: true,
-            sameAttributes: []
-        } : undefined;
+        this._direction = direction;
     }
-}
-
-class ListMergeCommand extends Command {
     /**
-     * @inheritDoc
-     */ refresh() {
+	 * @inheritDoc
+	 */ refresh() {
         this.isEnabled = this._checkEnabled();
     }
     /**
-     * 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 = false } = {}) {
+	 * 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 = false } = {}) {
         const model = this.editor.model;
         const selection = model.document.selection;
         const changedBlocks = [];
@@ -935,17 +992,17 @@ class ListMergeCommand extends Command {
         });
     }
     /**
-     * Fires the `afterExecute` event.
-     *
-     * @param changedBlocks The changed list elements.
-     */ _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() {
+	 * Checks whether the command can be enabled in the current context.
+	 *
+	 * @returns Whether the command should be enabled.
+	 */ _checkEnabled() {
         const model = this.editor.model;
         const selection = model.document.selection;
         const selectedBlockObject = getSelectedBlockObject(model);
@@ -979,13 +1036,13 @@ class ListMergeCommand extends Command {
         return true;
     }
     /**
-     * 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.
-     */ _getMergeSubjectElements(selection, shouldMergeOnBlocksContentLevel) {
+	 * 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.
+	 */ _getMergeSubjectElements(selection, shouldMergeOnBlocksContentLevel) {
         const model = this.editor.model;
         const selectedBlockObject = getSelectedBlockObject(model);
         let firstElement, lastElement;
@@ -1024,29 +1081,36 @@ class ListMergeCommand extends Command {
             lastElement: lastElement
         };
     }
+}
+
+/**
+ * The document list split command that splits the list item at the selection.
+ *
+ * It is used by the {@link module:list/list~List list feature}.
+ */ class ListSplitCommand extends Command {
+    /**
+	 * Whether list item should be split before or after the selected block.
+	 */ _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, direction){
+	 * Creates an instance of the command.
+	 *
+	 * @param editor The editor instance.
+	 * @param direction Whether list item should be split before or after the selected block.
+	 */ constructor(editor, direction){
         super(editor);
         this._direction = direction;
     }
-}
-
-class ListSplitCommand extends Command {
     /**
-     * @inheritDoc
-     */ refresh() {
+	 * @inheritDoc
+	 */ refresh() {
         this.isEnabled = this._checkEnabled();
     }
     /**
-     * Splits the list item at the selection.
-     *
-     * @fires execute
-     * @fires afterExecute
-     */ execute() {
+	 * Splits the list item at the selection.
+	 *
+	 * @fires execute
+	 * @fires afterExecute
+	 */ execute() {
         const editor = this.editor;
         editor.model.change((writer)=>{
             const changedBlocks = splitListItemBefore(this._getStartBlock(), writer);
@@ -1054,77 +1118,70 @@ class ListSplitCommand extends Command {
         });
     }
     /**
-     * Fires the `afterExecute` event.
-     *
-     * @param changedBlocks The changed list elements.
-     */ _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() {
+	 * Checks whether the command can be enabled in the current context.
+	 *
+	 * @returns Whether the command should be enabled.
+	 */ _checkEnabled() {
         const selection = this.editor.model.document.selection;
         const block = this._getStartBlock();
         return selection.isCollapsed && isListItemBlock(block) && !isFirstBlockOfListItem(block);
     }
     /**
-     * Returns the model element that is the main focus of the command (according to the current selection and command direction).
-     */ _getStartBlock() {
+	 * Returns the model element that is the main focus of the command (according to the current selection and command direction).
+	 */ _getStartBlock() {
         const doc = this.editor.model.document;
         const positionParent = doc.selection.getFirstPosition().parent;
         return this._direction == 'before' ? positionParent : positionParent.nextSibling;
     }
-    /**
-     * Creates an instance of the command.
-     *
-     * @param editor The editor instance.
-     * @param direction Whether list item should be split before or after the selected block.
-     */ constructor(editor, direction){
-        super(editor);
-        this._direction = direction;
-    }
 }
 
-class ListUtils extends Plugin {
+/**
+ * A set of helpers related to document lists.
+ */ class ListUtils extends Plugin {
     /**
-     * @inheritDoc
-     */ static get pluginName() {
+	 * @inheritDoc
+	 */ static get pluginName() {
         return 'ListUtils';
     }
     /**
-     * Expands the given list of selected blocks to include all the items of the lists they're in.
-     *
-     * @param blocks The list of selected blocks.
-     */ expandListBlocksToCompleteList(blocks) {
+	 * Expands the given list of selected blocks to include all the items of the lists they're in.
+	 *
+	 * @param blocks The list of selected blocks.
+	 */ expandListBlocksToCompleteList(blocks) {
         return expandListBlocksToCompleteList(blocks);
     }
     /**
-     * Check if the given block is the first in the list item.
-     *
-     * @param listBlock The list block element.
-     */ isFirstBlockOfListItem(listBlock) {
+	 * Check if the given block is the first in the list item.
+	 *
+	 * @param listBlock The list block element.
+	 */ isFirstBlockOfListItem(listBlock) {
         return isFirstBlockOfListItem(listBlock);
     }
     /**
-     * Returns true if the given model node is a list item block.
-     *
-     * @param node A model node.
-     */ isListItemBlock(node) {
+	 * Returns true if the given model node is a list item block.
+	 *
+	 * @param node A model node.
+	 */ isListItemBlock(node) {
         return isListItemBlock(node);
     }
     /**
-     * Expands the given list of selected blocks to include the leading and tailing blocks of partially selected list items.
-     *
-     * @param blocks The list of selected blocks.
-     * @param options.withNested Whether should include nested list items.
-     */ expandListBlocksToCompleteItems(blocks, options = {}) {
+	 * Expands the given list of selected blocks to include the leading and tailing blocks of partially selected list items.
+	 *
+	 * @param blocks The list of selected blocks.
+	 * @param options.withNested Whether should include nested list items.
+	 */ expandListBlocksToCompleteItems(blocks, options = {}) {
         return expandListBlocksToCompleteItems(blocks, options);
     }
     /**
-     * Returns true if listType is of type `numbered` or `customNumbered`.
-     */ isNumberedListType(listType) {
+	 * Returns true if listType is of type `numbered` or `customNumbered`.
+	 */ isNumberedListType(listType) {
         return isNumberedListType(listType);
     }
 }
@@ -1133,6 +1190,8 @@ class ListUtils extends Plugin {
  * @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 list/list/utils/view
+ */ /**
  * Checks if view element is a list type (ul or ol).
  *
  * @internal
@@ -1860,15 +1919,20 @@ function shouldUseBogusParagraph(item, attributeNames, blocks = getAllListItemBl
     'listIndent',
     'listItemId'
 ];
-class ListEditing extends Plugin {
+/**
+ * The editing part of the document-list feature. It handles creating, editing and removing lists and list items.
+ */ class ListEditing extends Plugin {
+    /**
+	 * The list of registered downcast strategies.
+	 */ _downcastStrategies = [];
     /**
-     * @inheritDoc
-     */ static get pluginName() {
+	 * @inheritDoc
+	 */ static get pluginName() {
         return 'ListEditing';
     }
     /**
-     * @inheritDoc
-     */ static get requires() {
+	 * @inheritDoc
+	 */ static get requires() {
         return [
             Enter,
             Delete,
@@ -1877,18 +1941,24 @@ class ListEditing extends Plugin {
         ];
     }
     /**
-     * @inheritDoc
-     */ init() {
+	 * @inheritDoc
+	 */ constructor(editor){
+        super(editor);
+        editor.config.define('list.multiBlock', true);
+    }
+    /**
+	 * @inheritDoc
+	 */ init() {
         const editor = this.editor;
         const model = editor.model;
         const multiBlock = editor.config.get('list.multiBlock');
         if (editor.plugins.has('LegacyListEditing')) {
             /**
-             * The `List` feature can not be loaded together with the `LegacyList` plugin.
-             *
-             * @error list-feature-conflict
-             * @param conflictPlugin Name of the plugin.
-             */ throw new CKEditorError('list-feature-conflict', this, {
+			 * The `List` feature can not be loaded together with the `LegacyList` plugin.
+			 *
+			 * @error list-feature-conflict
+			 * @param conflictPlugin Name of the plugin.
+			 */ throw new CKEditorError('list-feature-conflict', this, {
                 conflictPlugin: 'LegacyListEditing'
             });
         }
@@ -1940,8 +2010,8 @@ class ListEditing extends Plugin {
         this._setupAccessibilityIntegration();
     }
     /**
-     * @inheritDoc
-     */ afterInit() {
+	 * @inheritDoc
+	 */ afterInit() {
         const editor = this.editor;
         const commands = editor.commands;
         const indent = commands.get('indent');
@@ -1965,27 +2035,27 @@ class ListEditing extends Plugin {
         this._setupConversion();
     }
     /**
-     * Registers a downcast strategy.
-     *
-     * **Note**: Strategies must be registered in the `Plugin#init()` phase so that it can be applied
-     * in the `ListEditing#afterInit()`.
-     *
-     * @param strategy The downcast strategy to register.
-     */ registerDowncastStrategy(strategy) {
+	 * Registers a downcast strategy.
+	 *
+	 * **Note**: Strategies must be registered in the `Plugin#init()` phase so that it can be applied
+	 * in the `ListEditing#afterInit()`.
+	 *
+	 * @param strategy The downcast strategy to register.
+	 */ registerDowncastStrategy(strategy) {
         this._downcastStrategies.push(strategy);
     }
     /**
-     * Returns list of model attribute names that should affect downcast conversion.
-     */ getListAttributeNames() {
+	 * Returns list of model attribute names that should affect downcast conversion.
+	 */ getListAttributeNames() {
         return [
             ...LIST_BASE_ATTRIBUTES,
             ...this._downcastStrategies.map((strategy)=>strategy.attributeName)
         ];
     }
     /**
-     * Attaches the listener to the {@link module:engine/view/document~Document#event:delete} event and handles backspace/delete
-     * keys in and around document lists.
-     */ _setupDeleteIntegration() {
+	 * Attaches the listener to the {@link module:engine/view/document~Document#event:delete} event and handles backspace/delete
+	 * keys in and around document lists.
+	 */ _setupDeleteIntegration() {
         const editor = this.editor;
         const mergeBackwardCommand = editor.commands.get('mergeListItemBackward');
         const mergeForwardCommand = editor.commands.get('mergeListItemForward');
@@ -2045,9 +2115,9 @@ class ListEditing extends Plugin {
         });
     }
     /**
-     * Attaches a listener to the {@link module:engine/view/document~Document#event:enter} event and handles enter key press
-     * in document lists.
-     */ _setupEnterIntegration() {
+	 * Attaches a listener to the {@link module:engine/view/document~Document#event:enter} event and handles enter key press
+	 * in document lists.
+	 */ _setupEnterIntegration() {
         const editor = this.editor;
         const model = editor.model;
         const commands = editor.commands;
@@ -2103,9 +2173,9 @@ class ListEditing extends Plugin {
         });
     }
     /**
-     * Attaches a listener to the {@link module:engine/view/document~Document#event:tab} event and handles tab key and tab+shift keys
-     * presses in document lists.
-     */ _setupTabIntegration() {
+	 * Attaches a listener to the {@link module:engine/view/document~Document#event:tab} event and handles tab key and tab+shift keys
+	 * presses in document lists.
+	 */ _setupTabIntegration() {
         const editor = this.editor;
         this.listenTo(editor.editing.view.document, 'tab', (evt, data)=>{
             const commandName = data.shiftKey ? 'outdentList' : 'indentList';
@@ -2121,8 +2191,8 @@ class ListEditing extends Plugin {
         });
     }
     /**
-     * Registers the conversion helpers for the document-list feature.
-     */ _setupConversion() {
+	 * Registers the conversion helpers for the document-list feature.
+	 */ _setupConversion() {
         const editor = this.editor;
         const model = editor.model;
         const attributeNames = this.getListAttributeNames();
@@ -2210,8 +2280,8 @@ class ListEditing extends Plugin {
         });
     }
     /**
-     * Registers model post-fixers.
-     */ _setupModelPostFixing() {
+	 * Registers model post-fixers.
+	 */ _setupModelPostFixing() {
         const model = this.editor.model;
         const attributeNames = this.getListAttributeNames();
         // Register list fixing.
@@ -2232,9 +2302,9 @@ class ListEditing extends Plugin {
         });
     }
     /**
-     * Integrates the feature with the clipboard via {@link module:engine/model/model~Model#insertContent} and
-     * {@link module:engine/model/model~Model#getSelectedContent}.
-     */ _setupClipboardIntegration() {
+	 * Integrates the feature with the clipboard via {@link module:engine/model/model~Model#insertContent} and
+	 * {@link module:engine/model/model~Model#getSelectedContent}.
+	 */ _setupClipboardIntegration() {
         const model = this.editor.model;
         const clipboardPipeline = this.editor.plugins.get('ClipboardPipeline');
         this.listenTo(model, 'insertContent', createModelIndentPasteFixer(model), {
@@ -2291,8 +2361,8 @@ class ListEditing extends Plugin {
         });
     }
     /**
-     * Informs editor accessibility features about keystrokes brought by the plugin.
-     */ _setupAccessibilityIntegration() {
+	 * Informs editor accessibility features about keystrokes brought by the plugin.
+	 */ _setupAccessibilityIntegration() {
         const editor = this.editor;
         const t = editor.t;
         editor.accessibility.addKeystrokeInfoGroup({
@@ -2310,15 +2380,6 @@ class ListEditing extends Plugin {
             ]
         });
     }
-    /**
-     * @inheritDoc
-     */ constructor(editor){
-        super(editor);
-        /**
-         * The list of registered downcast strategies.
-         */ this._downcastStrategies = [];
-        editor.config.define('list.multiBlock', true);
-    }
 }
 /**
  * Post-fixer that reacts to changes on document and fixes incorrect model states (invalid `listItemId` and `listIndent` values).
@@ -2462,11 +2523,11 @@ class ListEditing extends Plugin {
                 const isListItem = isListItemBlock(item);
                 if (refItem.is('element', 'listItem') && item.is('element', 'paragraph')) {
                     /**
-                     * When paragraphs or a plain text list is pasted into a simple list, convert
-                     * the `<paragraphs>' to `<listItem>' to avoid breaking the target list.
-                     *
-                     * See https://github.com/ckeditor/ckeditor5/issues/13826.
-                     */ writer.rename(item, 'listItem');
+					 * When paragraphs or a plain text list is pasted into a simple list, convert
+					 * the `<paragraphs>' to `<listItem>' to avoid breaking the target list.
+					 *
+					 * See https://github.com/ckeditor/ckeditor5/issues/13826.
+					 */ writer.rename(item, 'listItem');
                 }
                 writer.setAttributes({
                     listIndent: (isListItem ? item.getAttribute('listIndent') : 0) + indentDiff,
@@ -2542,15 +2603,18 @@ class ListEditing extends Plugin {
     return view;
 }
 
-class ListUI extends Plugin {
+/**
+ * The list UI feature. It introduces the `'numberedList'` and `'bulletedList'` buttons that
+ * allow to convert paragraphs to and from list items and indent or outdent them.
+ */ class ListUI extends Plugin {
     /**
-     * @inheritDoc
-     */ static get pluginName() {
+	 * @inheritDoc
+	 */ static get pluginName() {
         return 'ListUI';
     }
     /**
-     * @inheritDoc
-     */ init() {
+	 * @inheritDoc
+	 */ init() {
         const t = this.editor.t;
         // Create button numberedList.
         if (!this.editor.ui.componentFactory.has('numberedList')) {
@@ -2563,36 +2627,45 @@ class ListUI extends Plugin {
     }
 }
 
-class List extends Plugin {
+/**
+ * The list feature.
+ *
+ * This is a "glue" plugin that loads the {@link module:list/list/listediting~ListEditing  list
+ * editing feature} and {@link module:list/list/listui~ListUI list UI feature}.
+ */ class List extends Plugin {
     /**
-     * @inheritDoc
-     */ static get requires() {
+	 * @inheritDoc
+	 */ static get requires() {
         return [
             ListEditing,
             ListUI
         ];
     }
     /**
-     * @inheritDoc
-     */ static get pluginName() {
+	 * @inheritDoc
+	 */ static get pluginName() {
         return 'List';
     }
 }
 
-class ListStartCommand extends Command {
+/**
+ * The list start index command. It changes the `listStart` attribute of the selected list items,
+ * letting the user to choose the starting point of an ordered list.
+ * It is used by the {@link module:list/listproperties~ListProperties list properties feature}.
+ */ class ListStartCommand extends Command {
     /**
-     * @inheritDoc
-     */ refresh() {
+	 * @inheritDoc
+	 */ refresh() {
         const value = this._getValue();
         this.value = value;
         this.isEnabled = value != null;
     }
     /**
-     * Executes the command.
-     *
-     * @fires execute
-     * @param options.startIndex The list start index.
-     */ execute({ startIndex = 1 } = {}) {
+	 * Executes the command.
+	 *
+	 * @fires execute
+	 * @param options.startIndex The list start index.
+	 */ execute({ startIndex = 1 } = {}) {
         const model = this.editor.model;
         const document = model.document;
         let blocks = Array.from(document.selection.getSelectedBlocks()).filter((block)=>isListItemBlock(block) && isNumberedListType(block.getAttribute('listType')));
@@ -2604,10 +2677,10 @@ class ListStartCommand extends Command {
         });
     }
     /**
-     * Checks the command's {@link #value}.
-     *
-     * @returns The current value.
-     */ _getValue() {
+	 * Checks the command's {@link #value}.
+	 *
+	 * @returns The current value.
+	 */ _getValue() {
         const model = this.editor.model;
         const document = model.document;
         const block = first(document.selection.getSelectedBlocks());
@@ -2711,20 +2784,42 @@ for (const { listStyle, typeAttribute, listType } of LIST_STYLE_TYPES){
     return LIST_STYLE_TO_TYPE_ATTRIBUTE[value] || null;
 }
 
-class ListStyleCommand extends Command {
+/**
+ * The list style command. It changes `listStyle` attribute of the selected list items,
+ * letting the user choose styles for the list item markers.
+ * It is used by the {@link module:list/listproperties~ListProperties list properties feature}.
+ */ class ListStyleCommand extends Command {
+    /**
+	 * The default type of the list style.
+	 */ defaultType;
+    /**
+	 * The list of supported style types by this command.
+	 */ _supportedTypes;
+    /**
+	 * Creates an instance of the command.
+	 *
+	 * @param editor The editor instance.
+	 * @param defaultType The list type that will be used by default if the value was not specified during
+	 * the command execution.
+	 * @param supportedTypes The list of supported style types by this command.
+	 */ constructor(editor, defaultType, supportedTypes){
+        super(editor);
+        this.defaultType = defaultType;
+        this._supportedTypes = supportedTypes;
+    }
     /**
-     * @inheritDoc
-     */ refresh() {
+	 * @inheritDoc
+	 */ refresh() {
         this.value = this._getValue();
         this.isEnabled = this._checkEnabled();
     }
     /**
-     * Executes the command.
-     *
-     * @fires execute
-     * @param options.type The type of the list style, e.g. `'disc'` or `'square'`. If `null` is specified, the default
-     * style will be applied.
-     */ execute(options = {}) {
+	 * Executes the command.
+	 *
+	 * @fires execute
+	 * @param options.type The type of the list style, e.g. `'disc'` or `'square'`. If `null` is specified, the default
+	 * style will be applied.
+	 */ execute(options = {}) {
         const model = this.editor.model;
         const document = model.document;
         model.change((writer)=>{
@@ -2740,18 +2835,18 @@ class ListStyleCommand extends Command {
         });
     }
     /**
-     * Checks if the given style type is supported by this plugin.
-     */ isStyleTypeSupported(value) {
+	 * Checks if the given style type is supported by this plugin.
+	 */ isStyleTypeSupported(value) {
         if (!this._supportedTypes) {
             return true;
         }
         return this._supportedTypes.includes(value);
     }
     /**
-     * Checks the command's {@link #value}.
-     *
-     * @returns The current value.
-     */ _getValue() {
+	 * Checks the command's {@link #value}.
+	 *
+	 * @returns The current value.
+	 */ _getValue() {
         const listItem = first(this.editor.model.document.selection.getSelectedBlocks());
         if (isListItemBlock(listItem)) {
             return listItem.getAttribute('listStyle');
@@ -2759,20 +2854,20 @@ class ListStyleCommand extends Command {
         return null;
     }
     /**
-     * Checks whether the command can be enabled in the current context.
-     *
-     * @returns Whether the command should be enabled.
-     */ _checkEnabled() {
+	 * Checks whether the command can be enabled in the current context.
+	 *
+	 * @returns Whether the command should be enabled.
+	 */ _checkEnabled() {
         const editor = this.editor;
         const numberedList = editor.commands.get('numberedList');
         const bulletedList = editor.commands.get('bulletedList');
         return numberedList.isEnabled || bulletedList.isEnabled;
     }
     /**
-     * Check if the provided list style is valid. Also change the selection to a list if it's not set yet.
-     *
-     * @param options.type The type of the list style. If `null` is specified, the function does nothing.
-    */ _tryToConvertItemsToList(options) {
+	 * Check if the provided list style is valid. Also change the selection to a list if it's not set yet.
+	 *
+	 * @param options.type The type of the list style. If `null` is specified, the function does nothing.
+	*/ _tryToConvertItemsToList(options) {
         if (!options.type) {
             return;
         }
@@ -2787,34 +2882,26 @@ class ListStyleCommand extends Command {
             editor.execute(commandName);
         }
     }
-    /**
-     * Creates an instance of the command.
-     *
-     * @param editor The editor instance.
-     * @param defaultType The list type that will be used by default if the value was not specified during
-     * the command execution.
-     * @param supportedTypes The list of supported style types by this command.
-     */ constructor(editor, defaultType, supportedTypes){
-        super(editor);
-        this.defaultType = defaultType;
-        this._supportedTypes = supportedTypes;
-    }
 }
 
-class ListReversedCommand extends Command {
+/**
+ * The list reversed command. It changes the `listReversed` attribute of the selected list items,
+ * letting the user to choose the order of an ordered list.
+ * It is used by the {@link module:list/listproperties~ListProperties list properties feature}.
+ */ class ListReversedCommand extends Command {
     /**
-     * @inheritDoc
-     */ refresh() {
+	 * @inheritDoc
+	 */ refresh() {
         const value = this._getValue();
         this.value = value;
         this.isEnabled = value != null;
     }
     /**
-     * Executes the command.
-     *
-     * @fires execute
-     * @param options.reversed Whether the list should be reversed.
-     */ execute(options = {}) {
+	 * Executes the command.
+	 *
+	 * @fires execute
+	 * @param options.reversed Whether the list should be reversed.
+	 */ execute(options = {}) {
         const model = this.editor.model;
         const document = model.document;
         let blocks = Array.from(document.selection.getSelectedBlocks()).filter((block)=>isListItemBlock(block) && block.getAttribute('listType') == 'numbered');
@@ -2826,8 +2913,8 @@ class ListReversedCommand extends Command {
         });
     }
     /**
-     * Checks the command's {@link #value}.
-     */ _getValue() {
+	 * Checks the command's {@link #value}.
+	 */ _getValue() {
         const model = this.editor.model;
         const document = model.document;
         const block = first(document.selection.getSelectedBlocks());
@@ -2842,6 +2929,8 @@ class ListReversedCommand extends Command {
  * @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 list/listproperties/converters
+ */ /**
  * Returns a converter that consumes the `style`, `reversed`, and `start` attributes.
  * In `style`, it searches for the `list-style-type` definition.
  * If not found, the `"default"` value will be used.
@@ -2882,52 +2971,69 @@ class ListReversedCommand extends Command {
     };
 }
 
-class ListPropertiesUtils extends Plugin {
+/**
+ * A set of helpers related to document lists.
+ */ class ListPropertiesUtils extends Plugin {
     /**
-     * @inheritDoc
-     */ static get pluginName() {
+	 * @inheritDoc
+	 */ static get pluginName() {
         return 'ListPropertiesUtils';
     }
     /**
-     * Gets all the style types supported by given list type.
-     */ getAllSupportedStyleTypes() {
+	 * Gets all the style types supported by given list type.
+	 */ getAllSupportedStyleTypes() {
         return getAllSupportedStyleTypes();
     }
     /**
-     * Checks whether the given list-style-type is supported by numbered or bulleted list.
-     */ getListTypeFromListStyleType(listStyleType) {
+	 * Checks whether the given list-style-type is supported by numbered or bulleted list.
+	 */ getListTypeFromListStyleType(listStyleType) {
         return getListTypeFromListStyleType$1(listStyleType);
     }
     /**
-     * Converts `type` attribute of `<ul>` or `<ol>` elements to `list-style-type` equivalent.
-     */ getListStyleTypeFromTypeAttribute(value) {
+	 * Converts `type` attribute of `<ul>` or `<ol>` elements to `list-style-type` equivalent.
+	 */ getListStyleTypeFromTypeAttribute(value) {
         return getListStyleTypeFromTypeAttribute(value);
     }
     /**
-     * Converts `list-style-type` style to `type` attribute of `<ul>` or `<ol>` elements.
-     */ getTypeAttributeFromListStyleType(value) {
+	 * Converts `list-style-type` style to `type` attribute of `<ul>` or `<ol>` elements.
+	 */ getTypeAttributeFromListStyleType(value) {
         return getTypeAttributeFromListStyleType(value);
     }
 }
 
 const DEFAULT_LIST_TYPE$1 = 'default';
-class ListPropertiesEditing extends Plugin {
+/**
+ * The document list properties engine feature.
+ *
+ * It registers the `'listStyle'`, `'listReversed'` and `'listStart'` commands if they are enabled in the configuration.
+ * Read more in {@link module:list/listconfig~ListPropertiesConfig}.
+ */ class ListPropertiesEditing extends Plugin {
     /**
-     * @inheritDoc
-     */ static get requires() {
+	 * @inheritDoc
+	 */ static get requires() {
         return [
             ListEditing,
             ListPropertiesUtils
         ];
     }
     /**
-     * @inheritDoc
-     */ static get pluginName() {
+	 * @inheritDoc
+	 */ static get pluginName() {
         return 'ListPropertiesEditing';
     }
     /**
-     * @inheritDoc
-     */ init() {
+	 * @inheritDoc
+	 */ constructor(editor){
+        super(editor);
+        editor.config.define('list.properties', {
+            styles: true,
+            startIndex: false,
+            reversed: false
+        });
+    }
+    /**
+	 * @inheritDoc
+	 */ init() {
         const editor = this.editor;
         const model = editor.model;
         const listEditing = editor.plugins.get(ListEditing);
@@ -3022,16 +3128,6 @@ class ListPropertiesEditing extends Plugin {
             }
         });
     }
-    /**
-     * @inheritDoc
-     */ constructor(editor){
-        super(editor);
-        editor.config.define('list.properties', {
-            styles: true,
-            startIndex: false,
-            reversed: false
-        });
-    }
 }
 /**
  * Creates an array of strategies for dealing with enabled listItem attributes.
@@ -3157,10 +3253,109 @@ class ListPropertiesEditing extends Plugin {
     return strategies;
 }
 
-class ListPropertiesView extends View {
+/**
+ * The list properties view to be displayed in the list dropdown.
+ *
+ * Contains a grid of available list styles and, for numbered list, also the list start index and reversed fields.
+ *
+ * @internal
+ */ class ListPropertiesView extends View {
+    /**
+	 * A collection of the child views.
+	 */ children;
+    /**
+	 * A view that renders the grid of list styles.
+	 */ stylesView = null;
+    /**
+	 * A collapsible view that hosts additional list property fields ({@link #startIndexFieldView} and
+	 * {@link #reversedSwitchButtonView}) to visually separate them from the {@link #stylesView grid of styles}.
+	 *
+	 * **Note**: Only present when:
+	 * * the view represents **numbered** list properties,
+	 * * and the {@link #stylesView} is rendered,
+	 * * and either {@link #startIndexFieldView} or {@link #reversedSwitchButtonView} is rendered.
+	 *
+	 * @readonly
+	 */ additionalPropertiesCollapsibleView = null;
+    /**
+	 * A labeled number field allowing the user to set the start index of the list.
+	 *
+	 * **Note**: Only present when the view represents **numbered** list properties.
+	 *
+	 * @readonly
+	 */ startIndexFieldView = null;
+    /**
+	 * A switch button allowing the user to make the edited list reversed.
+	 *
+	 * **Note**: Only present when the view represents **numbered** list properties.
+	 *
+	 * @readonly
+	 */ reversedSwitchButtonView = null;
+    /**
+	 * Tracks information about the DOM focus in the view.
+	 */ focusTracker = new FocusTracker();
+    /**
+	 * An instance of the {@link module:utils/keystrokehandler~KeystrokeHandler}.
+	 */ keystrokes = new KeystrokeHandler();
+    /**
+	 * A collection of views that can be focused in the properties view.
+	 */ focusables = new ViewCollection();
+    /**
+	 * Helps cycling over {@link #focusables} in the view.
+	 */ focusCycler;
+    /**
+	 * Creates an instance of the list properties view.
+	 *
+	 * @param locale The {@link module:core/editor/editor~Editor#locale} instance.
+	 * @param options Options of the view.
+	 * @param options.enabledProperties An object containing the configuration of enabled list property names.
+	 * Allows conditional rendering the sub-components of the properties view.
+	 * @param options.styleButtonViews A list of style buttons to be rendered
+	 * inside the styles grid. The grid will not be rendered when `enabledProperties` does not include the `'styles'` key.
+	 * @param options.styleGridAriaLabel An assistive technologies label set on the grid of styles (if the grid is rendered).
+	 */ constructor(locale, { enabledProperties, styleButtonViews, styleGridAriaLabel }){
+        super(locale);
+        const elementCssClasses = [
+            'ck',
+            'ck-list-properties'
+        ];
+        this.children = this.createCollection();
+        this.focusCycler = new FocusCycler({
+            focusables: this.focusables,
+            focusTracker: this.focusTracker,
+            keystrokeHandler: this.keystrokes,
+            actions: {
+                // Navigate #children backwards using the <kbd>Shift</kbd> + <kbd>Tab</kbd> keystroke.
+                focusPrevious: 'shift + tab',
+                // Navigate #children forwards using the <kbd>Tab</kbd> key.
+                focusNext: 'tab'
+            }
+        });
+        // The rendering of the styles grid is conditional. When there is no styles grid, the view will render without collapsible
+        // for numbered list properties, hence simplifying the layout.
+        if (enabledProperties.styles) {
+            this.stylesView = this._createStylesView(styleButtonViews, styleGridAriaLabel);
+            this.children.add(this.stylesView);
+        } else {
+            elementCssClasses.push('ck-list-properties_without-styles');
+        }
+        // The rendering of the numbered list property views is also conditional. It only makes sense for the numbered list
+        // dropdown. The unordered list does not have such properties.
+        if (enabledProperties.startIndex || enabledProperties.reversed) {
+            this._addNumberedListPropertyViews(enabledProperties);
+            elementCssClasses.push('ck-list-properties_with-numbered-properties');
+        }
+        this.setTemplate({
+            tag: 'div',
+            attributes: {
+                class: elementCssClasses
+            },
+            children: this.children
+        });
+    }
     /**
-     * @inheritDoc
-     */ render() {
+	 * @inheritDoc
+	 */ render() {
         super.render();
         if (this.stylesView) {
             this.focusables.add(this.stylesView);
@@ -3203,28 +3398,28 @@ class ListPropertiesView extends View {
         this.keystrokes.listenTo(this.element);
     }
     /**
-     * @inheritDoc
-     */ focus() {
+	 * @inheritDoc
+	 */ focus() {
         this.focusCycler.focusFirst();
     }
     /**
-     * @inheritDoc
-     */ focusLast() {
+	 * @inheritDoc
+	 */ focusLast() {
         this.focusCycler.focusLast();
     }
     /**
-     * @inheritDoc
-     */ destroy() {
+	 * @inheritDoc
+	 */ destroy() {
         super.destroy();
         this.focusTracker.destroy();
         this.keystrokes.destroy();
     }
     /**
-     * Creates the list styles grid.
-     *
-     * @param styleButtons Buttons to be placed in the grid.
-     * @param styleGridAriaLabel The assistive technology label of the grid.
-     */ _createStylesView(styleButtons, styleGridAriaLabel) {
+	 * Creates the list styles grid.
+	 *
+	 * @param styleButtons Buttons to be placed in the grid.
+	 * @param styleGridAriaLabel The assistive technology label of the grid.
+	 */ _createStylesView(styleButtons, styleGridAriaLabel) {
         const stylesView = new View(this.locale);
         stylesView.children = stylesView.createCollection();
         stylesView.children.addMany(styleButtons);
@@ -3250,11 +3445,11 @@ class ListPropertiesView extends View {
         return stylesView;
     }
     /**
-     * Renders {@link #startIndexFieldView} and/or {@link #reversedSwitchButtonView} depending on the configuration of the properties view.
-     *
-     * @param enabledProperties An object containing the configuration of enabled list property names
-     * (see {@link #constructor}).
-     */ _addNumberedListPropertyViews(enabledProperties) {
+	 * Renders {@link #startIndexFieldView} and/or {@link #reversedSwitchButtonView} depending on the configuration of the properties view.
+	 *
+	 * @param enabledProperties An object containing the configuration of enabled list property names
+	 * (see {@link #constructor}).
+	 */ _addNumberedListPropertyViews(enabledProperties) {
         const t = this.locale.t;
         const numberedPropertyViews = [];
         if (enabledProperties.startIndex) {
@@ -3286,8 +3481,8 @@ class ListPropertiesView extends View {
         }
     }
     /**
-     * Creates the list start index labeled field.
-     */ _createStartIndexField() {
+	 * Creates the list start index labeled field.
+	 */ _createStartIndexField() {
         const t = this.locale.t;
         const startIndexFieldView = new LabeledFieldView(this.locale, createLabeledInputNumber);
         startIndexFieldView.set({
@@ -3320,8 +3515,8 @@ class ListPropertiesView extends View {
         return startIndexFieldView;
     }
     /**
-     * Creates the reversed list switch button.
-     */ _createReversedSwitchButton() {
+	 * Creates the reversed list switch button.
+	 */ _createReversedSwitchButton() {
         const t = this.locale.t;
         const reversedButtonView = new SwitchButtonView(this.locale);
         reversedButtonView.set({
@@ -3332,93 +3527,6 @@ class ListPropertiesView extends View {
         reversedButtonView.delegate('execute').to(this, 'listReversed');
         return reversedButtonView;
     }
-    /**
-     * Creates an instance of the list properties view.
-     *
-     * @param locale The {@link module:core/editor/editor~Editor#locale} instance.
-     * @param options Options of the view.
-     * @param options.enabledProperties An object containing the configuration of enabled list property names.
-     * Allows conditional rendering the sub-components of the properties view.
-     * @param options.styleButtonViews A list of style buttons to be rendered
-     * inside the styles grid. The grid will not be rendered when `enabledProperties` does not include the `'styles'` key.
-     * @param options.styleGridAriaLabel An assistive technologies label set on the grid of styles (if the grid is rendered).
-     */ constructor(locale, { enabledProperties, styleButtonViews, styleGridAriaLabel }){
-        super(locale);
-        /**
-         * A view that renders the grid of list styles.
-         */ this.stylesView = null;
-        /**
-         * A collapsible view that hosts additional list property fields ({@link #startIndexFieldView} and
-         * {@link #reversedSwitchButtonView}) to visually separate them from the {@link #stylesView grid of styles}.
-         *
-         * **Note**: Only present when:
-         * * the view represents **numbered** list properties,
-         * * and the {@link #stylesView} is rendered,
-         * * and either {@link #startIndexFieldView} or {@link #reversedSwitchButtonView} is rendered.
-         *
-         * @readonly
-         */ this.additionalPropertiesCollapsibleView = null;
-        /**
-         * A labeled number field allowing the user to set the start index of the list.
-         *
-         * **Note**: Only present when the view represents **numbered** list properties.
-         *
-         * @readonly
-         */ this.startIndexFieldView = null;
-        /**
-         * A switch button allowing the user to make the edited list reversed.
-         *
-         * **Note**: Only present when the view represents **numbered** list properties.
-         *
-         * @readonly
-         */ this.reversedSwitchButtonView = null;
-        /**
-         * Tracks information about the DOM focus in the view.
-         */ this.focusTracker = new FocusTracker();
-        /**
-         * An instance of the {@link module:utils/keystrokehandler~KeystrokeHandler}.
-         */ this.keystrokes = new KeystrokeHandler();
-        /**
-         * A collection of views that can be focused in the properties view.
-         */ this.focusables = new ViewCollection();
-        const elementCssClasses = [
-            'ck',
-            'ck-list-properties'
-        ];
-        this.children = this.createCollection();
-        this.focusCycler = new FocusCycler({
-            focusables: this.focusables,
-            focusTracker: this.focusTracker,
-            keystrokeHandler: this.keystrokes,
-            actions: {
-                // Navigate #children backwards using the <kbd>Shift</kbd> + <kbd>Tab</kbd> keystroke.
-                focusPrevious: 'shift + tab',
-                // Navigate #children forwards using the <kbd>Tab</kbd> key.
-                focusNext: 'tab'
-            }
-        });
-        // The rendering of the styles grid is conditional. When there is no styles grid, the view will render without collapsible
-        // for numbered list properties, hence simplifying the layout.
-        if (enabledProperties.styles) {
-            this.stylesView = this._createStylesView(styleButtonViews, styleGridAriaLabel);
-            this.children.add(this.stylesView);
-        } else {
-            elementCssClasses.push('ck-list-properties_without-styles');
-        }
-        // The rendering of the numbered list property views is also conditional. It only makes sense for the numbered list
-        // dropdown. The unordered list does not have such properties.
-        if (enabledProperties.startIndex || enabledProperties.reversed) {
-            this._addNumberedListPropertyViews(enabledProperties);
-            elementCssClasses.push('ck-list-properties_with-numbered-properties');
-        }
-        this.setTemplate({
-            tag: 'div',
-            attributes: {
-                class: elementCssClasses
-            },
-            children: this.children
-        });
-    }
 }
 
 var listStyleDiscIcon = "<svg viewBox=\"0 0 44 44\" xmlns=\"http://www.w3.org/2000/svg\"><path d=\"M35 29a1 1 0 0 1 1 1v1a1 1 0 0 1-1 1H18a1 1 0 0 1-1-1v-1a1 1 0 0 1 1-1h17zm0-9a1 1 0 0 1 1 1v1a1 1 0 0 1-1 1H18a1 1 0 0 1-1-1v-1a1 1 0 0 1 1-1h17zm0-9a1 1 0 0 1 1 1v1a1 1 0 0 1-1 1H18a1 1 0 0 1-1-1v-1a1 1 0 0 1 1-1h17z\" fill-opacity=\".163\"/><path d=\"M11 27a3 3 0 1 1 0 6 3 3 0 0 1 0-6zm0-9a3 3 0 1 1 0 6 3 3 0 0 1 0-6zm0-9a3 3 0 1 1 0 6 3 3 0 0 1 0-6z\"/></svg>";
@@ -3439,10 +3547,16 @@ var listStyleLowerLatinIcon = "<svg viewBox=\"0 0 44 44\" xmlns=\"http://www.w3.
 
 var listStyleUpperLatinIcon = "<svg viewBox=\"0 0 44 44\" xmlns=\"http://www.w3.org/2000/svg\"><path d=\"M35 29a1 1 0 0 1 1 1v1a1 1 0 0 1-1 1H18a1 1 0 0 1-1-1v-1a1 1 0 0 1 1-1h17zm0-9a1 1 0 0 1 1 1v1a1 1 0 0 1-1 1H18a1 1 0 0 1-1-1v-1a1 1 0 0 1 1-1h17zm0-9a1 1 0 0 1 1 1v1a1 1 0 0 1-1 1H18a1 1 0 0 1-1-1v-1a1 1 0 0 1 1-1h17z\" fill-opacity=\".163\"/><path d=\"m7.88 15 .532-1.463h2.575L11.549 15h1.415l-2.58-6.442H9.01L6.5 15h1.38zm2.69-2.549H8.811l.87-2.39.887 2.39zM14.88 15v-1.235h-1.234V15h1.234zM9.352 25c.83-.006 1.352-.02 1.569-.044.346-.038.636-.14.872-.305.236-.166.422-.387.558-.664.137-.277.205-.562.205-.855 0-.372-.106-.695-.317-.97-.21-.276-.512-.471-.905-.585a1.51 1.51 0 0 0 .661-.567 1.5 1.5 0 0 0 .244-.83c0-.28-.066-.53-.197-.754a1.654 1.654 0 0 0-.495-.539 1.676 1.676 0 0 0-.672-.266c-.25-.042-.63-.063-1.14-.063H7.158V25h2.193zm.142-3.88H8.46v-1.49h.747c.612 0 .983.007 1.112.022.217.026.38.102.49.226.11.125.165.287.165.486a.68.68 0 0 1-.192.503.86.86 0 0 1-.525.23 11.47 11.47 0 0 1-.944.023h.18zm.17 2.795H8.46v-1.723h1.05c.592 0 .977.03 1.154.092.177.062.313.16.406.295a.84.84 0 0 1 .14.492c0 .228-.06.41-.181.547a.806.806 0 0 1-.473.257c-.126.026-.423.04-.892.04zM14.88 25v-1.235h-1.234V25h1.234zm-5.018 9.11c.691 0 1.262-.17 1.711-.512.45-.341.772-.864.965-1.567l-1.261-.4c-.109.472-.287.818-.536 1.037-.25.22-.547.33-.892.33-.47 0-.85-.173-1.143-.519-.293-.345-.44-.925-.44-1.74 0-.767.15-1.322.447-1.665.297-.343.684-.514 1.162-.514.346 0 .64.096.881.29.242.193.4.457.477.79l1.288-.307c-.147-.516-.367-.911-.66-1.187-.492-.465-1.132-.698-1.92-.698-.902 0-1.63.296-2.184.89-.554.593-.83 1.426-.83 2.498 0 1.014.275 1.813.825 2.397.551.585 1.254.877 2.11.877zM14.88 34v-1.235h-1.234V34h1.234z\"/></svg>";
 
-class ListPropertiesUI extends Plugin {
+/**
+ * The list properties UI plugin. It introduces the extended `'bulletedList'` and `'numberedList'` toolbar
+ * buttons that allow users to control such aspects of list as the marker, start index or order.
+ *
+ * **Note**: Buttons introduced by this plugin override implementations from the {@link module:list/list/listui~ListUI}
+ * (because they share the same names).
+ */ class ListPropertiesUI extends Plugin {
     /**
-     * @inheritDoc
-     */ static get pluginName() {
+	 * @inheritDoc
+	 */ static get pluginName() {
         return 'ListPropertiesUI';
     }
     init() {
@@ -3774,37 +3888,60 @@ function getStyleTypeSupportChecker(listStyleCommand) {
     }
 }
 
-class ListProperties extends Plugin {
+/**
+ * The list properties feature.
+ *
+ * This is a "glue" plugin that loads the
+ * {@link module:list/listproperties/listpropertiesediting~ListPropertiesEditing list properties
+ * editing feature} and the {@link module:list/listproperties/listpropertiesui~ListPropertiesUI list properties UI feature}.
+ */ class ListProperties extends Plugin {
     /**
-     * @inheritDoc
-     */ static get requires() {
+	 * @inheritDoc
+	 */ static get requires() {
         return [
             ListPropertiesEditing,
             ListPropertiesUI
         ];
     }
     /**
-     * @inheritDoc
-     */ static get pluginName() {
+	 * @inheritDoc
+	 */ static get pluginName() {
         return 'ListProperties';
     }
 }
 
-class CheckTodoListCommand extends Command {
+/**
+ * The check to-do command.
+ *
+ * The command is registered by the {@link module:list/todolist/todolistediting~TodoListEditing} as
+ * the `checkTodoList` editor command.
+ */ class CheckTodoListCommand extends Command {
+    /**
+	 * @inheritDoc
+	 */ constructor(editor){
+        super(editor);
+        // Refresh command before executing to be sure all values are up to date.
+        // It is needed when selection has changed before command execution, in the same change block.
+        this.on('execute', ()=>{
+            this.refresh();
+        }, {
+            priority: 'highest'
+        });
+    }
     /**
-     * Updates the command's {@link #value} and {@link #isEnabled} properties based on the current selection.
-     */ refresh() {
+	 * Updates the command's {@link #value} and {@link #isEnabled} properties based on the current selection.
+	 */ refresh() {
         const selectedElements = this._getSelectedItems();
         this.value = this._getValue(selectedElements);
         this.isEnabled = !!selectedElements.length;
     }
     /**
-     * Executes the command.
-     *
-     * @param options.forceValue If set, it will force the command behavior. If `true`, the command will apply
-     * the attribute. Otherwise, the command will remove the attribute. If not set, the command will look for its current
-     * value to decide what it should do.
-     */ execute(options = {}) {
+	 * Executes the command.
+	 *
+	 * @param options.forceValue If set, it will force the command behavior. If `true`, the command will apply
+	 * the attribute. Otherwise, the command will remove the attribute. If not set, the command will look for its current
+	 * value to decide what it should do.
+	 */ execute(options = {}) {
         this.editor.model.change((writer)=>{
             const selectedElements = this._getSelectedItems();
             const value = options.forceValue === undefined ? !this._getValue(selectedElements) : options.forceValue;
@@ -3818,13 +3955,13 @@ class CheckTodoListCommand extends Command {
         });
     }
     /**
-     * Returns a value for the command.
-     */ _getValue(selectedElements) {
+	 * Returns a value for the command.
+	 */ _getValue(selectedElements) {
         return selectedElements.every((element)=>element.getAttribute('todoListChecked'));
     }
     /**
-     * Gets all to-do list items selected by the {@link module:engine/model/selection~Selection}.
-     */ _getSelectedItems() {
+	 * Gets all to-do list items selected by the {@link module:engine/model/selection~Selection}.
+	 */ _getSelectedItems() {
         const model = this.editor.model;
         const schema = model.schema;
         const selectionRange = model.document.selection.getFirstRange();
@@ -3842,24 +3979,22 @@ class CheckTodoListCommand extends Command {
         }
         return elements;
     }
-    /**
-     * @inheritDoc
-     */ constructor(editor){
-        super(editor);
-        // Refresh command before executing to be sure all values are up to date.
-        // It is needed when selection has changed before command execution, in the same change block.
-        this.on('execute', ()=>{
-            this.refresh();
-        }, {
-            priority: 'highest'
-        });
-    }
 }
 
-class TodoCheckboxChangeObserver extends DomEventObserver {
+/**
+ * Observes all to-do list checkboxes state changes.
+ *
+ * Note that this observer is not available by default. To make it available it needs to be added to
+ * {@link module:engine/view/view~View} by {@link module:engine/view/view~View#addObserver} method.
+ */ class TodoCheckboxChangeObserver extends DomEventObserver {
+    /**
+	 * @inheritDoc
+	 */ domEventType = [
+        'change'
+    ];
     /**
-     * @inheritDoc
-     */ onDomEvent(domEvent) {
+	 * @inheritDoc
+	 */ onDomEvent(domEvent) {
         if (domEvent.target) {
             const viewTarget = this.view.domConverter.mapDomToView(domEvent.target);
             if (viewTarget && viewTarget.is('element', 'input') && viewTarget.getAttribute('type') == 'checkbox' && viewTarget.findAncestor({
@@ -3869,33 +4004,33 @@ class TodoCheckboxChangeObserver extends DomEventObserver {
             }
         }
     }
-    constructor(){
-        super(...arguments);
-        /**
-         * @inheritDoc
-         */ this.domEventType = [
-            'change'
-        ];
-    }
 }
 
-const ITEM_TOGGLE_KEYSTROKE$1 = parseKeystroke('Ctrl+Enter');
-class TodoListEditing extends Plugin {
+const ITEM_TOGGLE_KEYSTROKE$1 = /* #__PURE__ */ parseKeystroke('Ctrl+Enter');
+/**
+ * The engine of the to-do list feature. It handles creating, editing and removing to-do lists and their items.
+ *
+ * It registers the entire functionality of the {@link module:list/list/listediting~ListEditing list editing plugin}
+ * and extends it with the commands:
+ *
+ * - `'todoList'`,
+ * - `'checkTodoList'`,
+ */ class TodoListEditing extends Plugin {
     /**
-     * @inheritDoc
-     */ static get pluginName() {
+	 * @inheritDoc
+	 */ static get pluginName() {
         return 'TodoListEditing';
     }
     /**
-     * @inheritDoc
-     */ static get requires() {
+	 * @inheritDoc
+	 */ static get requires() {
         return [
             ListEditing
         ];
     }
     /**
-     * @inheritDoc
-     */ init() {
+	 * @inheritDoc
+	 */ init() {
         const editor = this.editor;
         const model = editor.model;
         const editing = editor.editing;
@@ -4132,13 +4267,13 @@ class TodoListEditing extends Plugin {
         this._initAriaAnnouncements();
     }
     /**
-     * Handles the checkbox element change, moves the selection to the corresponding model item to make it possible
-     * to toggle the `todoListChecked` attribute using the command, and restores the selection position.
-     *
-     * Some say it's a hack :) Moving the selection only for executing the command on a certain node and restoring it after,
-     * is not a clear solution. We need to design an API for using commands beyond the selection range.
-     * See https://github.com/ckeditor/ckeditor5/issues/1954.
-     */ _handleCheckmarkChange(listItem) {
+	 * Handles the checkbox element change, moves the selection to the corresponding model item to make it possible
+	 * to toggle the `todoListChecked` attribute using the command, and restores the selection position.
+	 *
+	 * Some say it's a hack :) Moving the selection only for executing the command on a certain node and restoring it after,
+	 * is not a clear solution. We need to design an API for using commands beyond the selection range.
+	 * See https://github.com/ckeditor/ckeditor5/issues/1954.
+	 */ _handleCheckmarkChange(listItem) {
         const editor = this.editor;
         const model = editor.model;
         const previousSelectionRanges = Array.from(model.document.selection.getRanges());
@@ -4149,11 +4284,11 @@ class TodoListEditing extends Plugin {
         });
     }
     /**
-     * Observe when user enters or leaves todo list and set proper aria value in global live announcer.
-     * This allows screen readers to indicate when the user has entered and left the specified todo list.
-     *
-     * @internal
-     */ _initAriaAnnouncements() {
+	 * Observe when user enters or leaves todo list and set proper aria value in global live announcer.
+	 * This allows screen readers to indicate when the user has entered and left the specified todo list.
+	 *
+	 * @internal
+	 */ _initAriaAnnouncements() {
         const { model, ui, t } = this.editor;
         let lastFocusedCodeBlock = null;
         if (!ui) {
@@ -4300,52 +4435,74 @@ class TodoListEditing extends Plugin {
     return element.getAttribute('listType') == 'todo';
 }
 
-class TodoListUI extends Plugin {
+/**
+ * The to-do list UI feature. It introduces the `'todoList'` button that
+ * allows to convert elements to and from to-do list items and to indent or outdent them.
+ */ class TodoListUI extends Plugin {
     /**
-     * @inheritDoc
-     */ static get pluginName() {
+	 * @inheritDoc
+	 */ static get pluginName() {
         return 'TodoListUI';
     }
     /**
-     * @inheritDoc
-     */ init() {
+	 * @inheritDoc
+	 */ init() {
         const t = this.editor.t;
         createUIComponents(this.editor, 'todoList', t('To-do List'), icons.todoList);
     }
 }
 
-class TodoList extends Plugin {
+/**
+ * The to-do list feature.
+ *
+ * This is a "glue" plugin that loads the {@link module:list/todolist/todolistediting~TodoListEditing to-do list
+ * editing feature} and the {@link module:list/todolist/todolistui~TodoListUI to-do list UI feature}.
+ */ class TodoList extends Plugin {
     /**
-     * @inheritDoc
-     */ static get requires() {
+	 * @inheritDoc
+	 */ static get requires() {
         return [
             TodoListEditing,
             TodoListUI
         ];
     }
     /**
-     * @inheritDoc
-     */ static get pluginName() {
+	 * @inheritDoc
+	 */ static get pluginName() {
         return 'TodoList';
     }
 }
 
-class LegacyListCommand extends Command {
+/**
+ * The list command. It is used by the {@link module:list/legacylist~LegacyList legacy list feature}.
+ */ class LegacyListCommand extends Command {
+    /**
+	 * The type of the list created by the command.
+	 */ type;
     /**
-     * @inheritDoc
-     */ refresh() {
+	 * Creates an instance of the command.
+	 *
+	 * @param editor The editor instance.
+	 * @param type List type that will be handled by this command.
+	 */ constructor(editor, type){
+        super(editor);
+        this.type = type;
+    }
+    /**
+	 * @inheritDoc
+	 */ refresh() {
         this.value = this._getValue();
         this.isEnabled = this._checkEnabled();
     }
     /**
-     * Executes the list command.
-     *
-     * @fires execute
-     * @param options Command options.
-     * @param options.forceValue If set, it will force the command behavior. If `true`, the command will try to convert the
-     * selected items and potentially the neighbor elements to the proper list items. If set to `false`, it will convert selected elements
-     * to paragraphs. If not set, the command will toggle selected elements to list items or paragraphs, depending on the selection.
-     */ execute(options = {}) {
+	 * Executes the list command.
+	 *
+	 * @fires execute
+	 * @param options Command options.
+	 * @param options.forceValue If set, it will force the command behavior. If `true`, the command will try to convert the
+	 * selected items and potentially the neighbor elements to the proper list items. If set to `false`, it will convert selected elements
+	 * to paragraphs. If not set, the command will toggle selected elements to list items or paragraphs, depending on the selection.
+	 */ execute(options = {}) {
         const model = this.editor.model;
         const document = model.document;
         const blocks = Array.from(document.selection.getSelectedBlocks()).filter((block)=>checkCanBecomeListItem(block, model.schema));
@@ -4492,30 +4649,30 @@ class LegacyListCommand extends Command {
                 }
             }
             /**
-             * Event fired by the {@link #execute} method.
-             *
-             * It allows to execute an action after executing the {@link ~ListCommand#execute} method, for example adjusting
-             * attributes of changed blocks.
-             *
-             * @protected
-             * @event _executeCleanup
-             */ this.fire('_executeCleanup', blocks);
+			 * Event fired by the {@link #execute} method.
+			 *
+			 * It allows to execute an action after executing the {@link ~ListCommand#execute} method, for example adjusting
+			 * attributes of changed blocks.
+			 *
+			 * @protected
+			 * @event _executeCleanup
+			 */ this.fire('_executeCleanup', blocks);
         });
     }
     /**
-     * Checks the command's {@link #value}.
-     *
-     * @returns The current value.
-     */ _getValue() {
+	 * Checks the command's {@link #value}.
+	 *
+	 * @returns The current value.
+	 */ _getValue() {
         // Check whether closest `listItem` ancestor of the position has a correct type.
         const listItem = first(this.editor.model.document.selection.getSelectedBlocks());
         return !!listItem && listItem.is('element', 'listItem') && listItem.getAttribute('listType') == this.type;
     }
     /**
-     * Checks whether the command can be enabled in the current context.
-     *
-     * @returns Whether the command should be enabled.
-     */ _checkEnabled() {
+	 * Checks whether the command can be enabled in the current context.
+	 *
+	 * @returns Whether the command should be enabled.
+	 */ _checkEnabled() {
         // If command value is true it means that we are in list item, so the command should be enabled.
         if (this.value) {
             return true;
@@ -4529,15 +4686,6 @@ class LegacyListCommand extends Command {
         // Otherwise, check if list item can be inserted at the position start.
         return checkCanBecomeListItem(firstBlock, schema);
     }
-    /**
-     * Creates an instance of the command.
-     *
-     * @param editor The editor instance.
-     * @param type List type that will be handled by this command.
-     */ constructor(editor, type){
-        super(editor);
-        this.type = type;
-    }
 }
 /**
  * Helper function used when one or more list item have their type changed. Fixes type of other list items
@@ -4591,17 +4739,31 @@ class LegacyListCommand extends Command {
     return schema.checkChild(block.parent, 'listItem') && !schema.isObject(block);
 }
 
-class LegacyIndentCommand extends Command {
+/**
+ * The list indent command. It is used by the {@link module:list/legacylist~LegacyList legacy list feature}.
+ */ class LegacyIndentCommand extends Command {
+    /**
+	 * Determines by how much the command will change the list item's indent attribute.
+	 */ _indentBy;
     /**
-     * @inheritDoc
-     */ refresh() {
+	 * 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._indentBy = indentDirection == 'forward' ? 1 : -1;
+    }
+    /**
+	 * @inheritDoc
+	 */ refresh() {
         this.isEnabled = this._checkEnabled();
     }
     /**
-     * Indents or outdents (depending on the {@link #constructor}'s `indentDirection` parameter) selected list items.
-     *
-     * @fires execute
-     */ execute() {
+	 * Indents or outdents (depending on the {@link #constructor}'s `indentDirection` parameter) selected list items.
+	 *
+	 * @fires execute
+	 */ execute() {
         const model = this.editor.model;
         const doc = model.document;
         let itemsToChange = Array.from(doc.selection.getSelectedBlocks());
@@ -4640,10 +4802,10 @@ class LegacyIndentCommand extends Command {
         });
     }
     /**
-     * Checks whether the command can be enabled in the current context.
-     *
-     * @returns Whether the command should be enabled.
-     */ _checkEnabled() {
+	 * 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.
         const listItem = first(this.editor.model.document.selection.getSelectedBlocks());
         // If selection is not in a list item, the command is disabled.
@@ -4672,15 +4834,6 @@ class LegacyIndentCommand extends Command {
         // If we are outdenting it is enough to be in list item. Every list item can always be outdented.
         return true;
     }
-    /**
-     * 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._indentBy = indentDirection == 'forward' ? 1 : -1;
-    }
 }
 
 /**
@@ -5012,36 +5165,38 @@ const NUMBERED_LIST_STYLE_TYPES = [
     return getFillerOffset.call(this);
 }
 
-class LegacyListUtils extends Plugin {
+/**
+ * A set of helpers related to legacy lists.
+ */ class LegacyListUtils extends Plugin {
     /**
-     * @inheritDoc
-     */ static get pluginName() {
+	 * @inheritDoc
+	 */ static get pluginName() {
         return 'LegacyListUtils';
     }
     /**
-     * Checks whether the given list-style-type is supported by numbered or bulleted list.
-     */ getListTypeFromListStyleType(listStyleType) {
+	 * Checks whether the given list-style-type is supported by numbered or bulleted list.
+	 */ getListTypeFromListStyleType(listStyleType) {
         return getListTypeFromListStyleType(listStyleType);
     }
     /**
-     * Returns an array with all `listItem` elements in the model selection.
-     *
-     * It returns all the items even if only a part of the list is selected, including items that belong to nested lists.
-     * If no list is selected, it returns an empty array.
-     * The order of the elements is not specified.
-     */ getSelectedListItems(model) {
+	 * Returns an array with all `listItem` elements in the model selection.
+	 *
+	 * It returns all the items even if only a part of the list is selected, including items that belong to nested lists.
+	 * If no list is selected, it returns an empty array.
+	 * The order of the elements is not specified.
+	 */ getSelectedListItems(model) {
         return getSelectedListItems(model);
     }
     /**
-     * Returns an array with all `listItem` elements that represent the same list.
-     *
-     * It means that values of `listIndent`, `listType`, `listStyle`, `listReversed` and `listStart` for all items are equal.
-     *
-     * Additionally, if the `position` is inside a list item, that list item will be returned as well.
-     *
-     * @param position Starting position.
-     * @param direction Walking direction.
-     */ getSiblingNodes(position, direction) {
+	 * Returns an array with all `listItem` elements that represent the same list.
+	 *
+	 * It means that values of `listIndent`, `listType`, `listStyle`, `listReversed` and `listStart` for all items are equal.
+	 *
+	 * Additionally, if the `position` is inside a list item, that list item will be returned as well.
+	 *
+	 * @param position Starting position.
+	 * @param direction Walking direction.
+	 */ getSiblingNodes(position, direction) {
         return getSiblingNodes(position, direction);
     }
 }
@@ -5913,15 +6068,19 @@ class LegacyListUtils extends Plugin {
     return indent;
 }
 
-class LegacyListEditing extends Plugin {
+/**
+ * The engine of the list feature. It handles creating, editing and removing lists and list items.
+ *
+ * It registers the `'numberedList'`, `'bulletedList'`, `'indentList'` and `'outdentList'` commands.
+ */ class LegacyListEditing extends Plugin {
     /**
-     * @inheritDoc
-     */ static get pluginName() {
+	 * @inheritDoc
+	 */ static get pluginName() {
         return 'LegacyListEditing';
     }
     /**
-     * @inheritDoc
-     */ static get requires() {
+	 * @inheritDoc
+	 */ static get requires() {
         return [
             Enter,
             Delete,
@@ -5929,8 +6088,8 @@ class LegacyListEditing extends Plugin {
         ];
     }
     /**
-     * @inheritDoc
-     */ init() {
+	 * @inheritDoc
+	 */ init() {
         const editor = this.editor;
         // Schema.
         // Note: in case `$block` will ever be allowed in `listItem`, keep in mind that this feature
@@ -6054,8 +6213,8 @@ class LegacyListEditing extends Plugin {
         });
     }
     /**
-     * @inheritDoc
-     */ afterInit() {
+	 * @inheritDoc
+	 */ afterInit() {
         const commands = this.editor.commands;
         const indent = commands.get('indent');
         const outdent = commands.get('outdent');
@@ -6079,36 +6238,60 @@ function getViewListItemLength(element) {
     return length;
 }
 
-class LegacyList extends Plugin {
+/**
+ * The legacy list feature.
+ *
+ * This is a "glue" plugin that loads the {@link module:list/legacylist/legacylistediting~LegacyListEditing legacy list editing feature}
+ * and {@link module:list/list/listui~ListUI list UI feature}.
+ */ class LegacyList extends Plugin {
     /**
-     * @inheritDoc
-     */ static get requires() {
+	 * @inheritDoc
+	 */ static get requires() {
         return [
             LegacyListEditing,
             ListUI
         ];
     }
     /**
-     * @inheritDoc
-     */ static get pluginName() {
+	 * @inheritDoc
+	 */ static get pluginName() {
         return 'LegacyList';
     }
 }
 
-class LegacyListStyleCommand extends Command {
+/**
+ * The list style command. It changes the `listStyle` attribute of the selected list items.
+ *
+ * If the list type (numbered or bulleted) can be inferred from the passed style type,
+ * the command tries to convert selected items to a list of that type.
+ * It is used by the {@link module:list/legacylistproperties~LegacyListProperties legacy list properties feature}.
+ */ class LegacyListStyleCommand extends Command {
+    /**
+	 * The default type of the list style.
+	 */ defaultType;
+    /**
+	 * Creates an instance of the command.
+	 *
+	 * @param editor The editor instance.
+	 * @param defaultType The list type that will be used by default if the value was not specified during
+	 * the command execution.
+	 */ constructor(editor, defaultType){
+        super(editor);
+        this.defaultType = defaultType;
+    }
     /**
-     * @inheritDoc
-     */ refresh() {
+	 * @inheritDoc
+	 */ refresh() {
         this.value = this._getValue();
         this.isEnabled = this._checkEnabled();
     }
     /**
-     * Executes the command.
-     *
-     * @fires execute
-     * @param options.type The type of the list style, e.g. `'disc'` or `'square'`. If `null` is specified, the default
-     * style will be applied.
-     */ execute(options = {}) {
+	 * Executes the command.
+	 *
+	 * @fires execute
+	 * @param options.type The type of the list style, e.g. `'disc'` or `'square'`. If `null` is specified, the default
+	 * style will be applied.
+	 */ execute(options = {}) {
         this._tryToConvertItemsToList(options);
         const model = this.editor.model;
         const listItems = getSelectedListItems(model);
@@ -6122,10 +6305,10 @@ class LegacyListStyleCommand extends Command {
         });
     }
     /**
-     * Checks the command's {@link #value}.
-     *
-     * @returns The current value.
-     */ _getValue() {
+	 * Checks the command's {@link #value}.
+	 *
+	 * @returns The current value.
+	 */ _getValue() {
         const listItem = this.editor.model.document.selection.getFirstPosition().parent;
         if (listItem && listItem.is('element', 'listItem')) {
             return listItem.getAttribute('listStyle');
@@ -6133,20 +6316,20 @@ class LegacyListStyleCommand extends Command {
         return null;
     }
     /**
-     * Checks whether the command can be enabled in the current context.
-     *
-     * @returns Whether the command should be enabled.
-     */ _checkEnabled() {
+	 * Checks whether the command can be enabled in the current context.
+	 *
+	 * @returns Whether the command should be enabled.
+	 */ _checkEnabled() {
         const editor = this.editor;
         const numberedList = editor.commands.get('numberedList');
         const bulletedList = editor.commands.get('bulletedList');
         return numberedList.isEnabled || bulletedList.isEnabled;
     }
     /**
-     * Checks if the provided list style is valid. Also changes the selection to a list if it's not set yet.
-     *
-     * @param The type of the list style. If `null` is specified, the function does nothing.
-    */ _tryToConvertItemsToList(options) {
+	 * Checks if the provided list style is valid. Also changes the selection to a list if it's not set yet.
+	 *
+	 * @param The type of the list style. If `null` is specified, the function does nothing.
+	*/ _tryToConvertItemsToList(options) {
         if (!options.type) {
             return;
         }
@@ -6161,32 +6344,26 @@ class LegacyListStyleCommand extends Command {
             editor.execute(commandName);
         }
     }
-    /**
-     * Creates an instance of the command.
-     *
-     * @param editor The editor instance.
-     * @param defaultType The list type that will be used by default if the value was not specified during
-     * the command execution.
-     */ constructor(editor, defaultType){
-        super(editor);
-        this.defaultType = defaultType;
-    }
 }
 
-class LegacyListReversedCommand extends Command {
+/**
+ * The reversed list command. It changes the `listReversed` attribute of the selected list items. As a result, the list order will be
+ * reversed.
+ * It is used by the {@link module:list/legacylistproperties~LegacyListProperties legacy list properties feature}.
+ */ class LegacyListReversedCommand extends Command {
     /**
-     * @inheritDoc
-     */ refresh() {
+	 * @inheritDoc
+	 */ refresh() {
         const value = this._getValue();
         this.value = value;
         this.isEnabled = value != null;
     }
     /**
-     * Executes the command.
-     *
-     * @fires execute
-     * @param options.reversed Whether the list should be reversed.
-     */ execute(options = {}) {
+	 * Executes the command.
+	 *
+	 * @fires execute
+	 * @param options.reversed Whether the list should be reversed.
+	 */ execute(options = {}) {
         const model = this.editor.model;
         const listItems = getSelectedListItems(model).filter((item)=>item.getAttribute('listType') == 'numbered');
         model.change((writer)=>{
@@ -6196,10 +6373,10 @@ class LegacyListReversedCommand extends Command {
         });
     }
     /**
-     * Checks the command's {@link #value}.
-     *
-     * @returns The current value.
-     */ _getValue() {
+	 * Checks the command's {@link #value}.
+	 *
+	 * @returns The current value.
+	 */ _getValue() {
         const listItem = this.editor.model.document.selection.getFirstPosition().parent;
         if (listItem && listItem.is('element', 'listItem') && listItem.getAttribute('listType') == 'numbered') {
             return listItem.getAttribute('listReversed');
@@ -6208,20 +6385,23 @@ class LegacyListReversedCommand extends Command {
     }
 }
 
-class LegacyListStartCommand extends Command {
+/**
+ * The list start index command. It changes the `listStart` attribute of the selected list items.
+ * It is used by the {@link module:list/legacylistproperties~LegacyListProperties legacy list properties feature}.
+ */ class LegacyListStartCommand extends Command {
     /**
-     * @inheritDoc
-     */ refresh() {
+	 * @inheritDoc
+	 */ refresh() {
         const value = this._getValue();
         this.value = value;
         this.isEnabled = value != null;
     }
     /**
-     * Executes the command.
-     *
-     * @fires execute
-     * @param options.startIndex The list start index.
-     */ execute({ startIndex = 1 } = {}) {
+	 * Executes the command.
+	 *
+	 * @fires execute
+	 * @param options.startIndex The list start index.
+	 */ execute({ startIndex = 1 } = {}) {
         const model = this.editor.model;
         const listItems = getSelectedListItems(model).filter((item)=>item.getAttribute('listType') == 'numbered');
         model.change((writer)=>{
@@ -6231,10 +6411,10 @@ class LegacyListStartCommand extends Command {
         });
     }
     /**
-     * Checks the command's {@link #value}.
-     *
-     * @returns The current value.
-     */ _getValue() {
+	 * Checks the command's {@link #value}.
+	 *
+	 * @returns The current value.
+	 */ _getValue() {
         const listItem = this.editor.model.document.selection.getFirstPosition().parent;
         if (listItem && listItem.is('element', 'listItem') && listItem.getAttribute('listType') == 'numbered') {
             return listItem.getAttribute('listStart');
@@ -6244,22 +6424,42 @@ class LegacyListStartCommand extends Command {
 }
 
 const DEFAULT_LIST_TYPE = 'default';
-class LegacyListPropertiesEditing extends Plugin {
+/**
+ * The engine of the list properties feature.
+ *
+ * It sets the value for the `listItem` attribute of the {@link module:list/legacylist~LegacyList `<listItem>`} element that
+ * allows modifying the list style type.
+ *
+ * It registers the `'listStyle'`, `'listReversed'` and `'listStart'` commands if they are enabled in the configuration.
+ * Read more in {@link module:list/listconfig~ListPropertiesConfig}.
+ */ class LegacyListPropertiesEditing extends Plugin {
     /**
-     * @inheritDoc
-     */ static get requires() {
+	 * @inheritDoc
+	 */ static get requires() {
         return [
             LegacyListEditing
         ];
     }
     /**
-     * @inheritDoc
-     */ static get pluginName() {
+	 * @inheritDoc
+	 */ static get pluginName() {
         return 'LegacyListPropertiesEditing';
     }
     /**
-     * @inheritDoc
-     */ init() {
+	 * @inheritDoc
+	 */ constructor(editor){
+        super(editor);
+        editor.config.define('list', {
+            properties: {
+                styles: true,
+                startIndex: false,
+                reversed: false
+            }
+        });
+    }
+    /**
+	 * @inheritDoc
+	 */ init() {
         const editor = this.editor;
         const model = editor.model;
         const enabledProperties = editor.config.get('list.properties');
@@ -6285,8 +6485,8 @@ class LegacyListPropertiesEditing extends Plugin {
         this._mergeListAttributesWhileMergingLists(strategies);
     }
     /**
-     * @inheritDoc
-     */ afterInit() {
+	 * @inheritDoc
+	 */ afterInit() {
         const editor = this.editor;
         // Enable post-fixer that removes the attributes from to-do list items only if the "TodoList" plugin is on.
         // We need to registry the hook here since the `TodoList` plugin can be added after the `ListPropertiesEditing`.
@@ -6295,36 +6495,36 @@ class LegacyListPropertiesEditing extends Plugin {
         }
     }
     /**
-     * Starts listening to {@link module:engine/model/model~Model#deleteContent} and checks whether two lists will be merged into a single
-     * one after deleting the content.
-     *
-     * The purpose of this action is to adjust the `listStyle`, `listReversed` and `listStart` values
-     * for the list that was merged.
-     *
-     * Consider the following model's content:
-     *
-     * ```xml
-     * <listItem listIndent="0" listType="bulleted" listStyle="square">UL List item 1</listItem>
-     * <listItem listIndent="0" listType="bulleted" listStyle="square">UL List item 2</listItem>
-     * <paragraph>[A paragraph.]</paragraph>
-     * <listItem listIndent="0" listType="bulleted" listStyle="circle">UL List item 1</listItem>
-     * <listItem listIndent="0" listType="bulleted" listStyle="circle">UL List item 2</listItem>
-     * ```
-     *
-     * After removing the paragraph element, the second list will be merged into the first one.
-     * We want to inherit the `listStyle` attribute for the second list from the first one.
-     *
-     * ```xml
-     * <listItem listIndent="0" listType="bulleted" listStyle="square">UL List item 1</listItem>
-     * <listItem listIndent="0" listType="bulleted" listStyle="square">UL List item 2</listItem>
-     * <listItem listIndent="0" listType="bulleted" listStyle="square">UL List item 1</listItem>
-     * <listItem listIndent="0" listType="bulleted" listStyle="square">UL List item 2</listItem>
-     * ```
-     *
-     * See https://github.com/ckeditor/ckeditor5/issues/7879.
-     *
-     * @param attributeStrategies Strategies for the enabled attributes.
-     */ _mergeListAttributesWhileMergingLists(attributeStrategies) {
+	 * Starts listening to {@link module:engine/model/model~Model#deleteContent} and checks whether two lists will be merged into a single
+	 * one after deleting the content.
+	 *
+	 * The purpose of this action is to adjust the `listStyle`, `listReversed` and `listStart` values
+	 * for the list that was merged.
+	 *
+	 * Consider the following model's content:
+	 *
+	 * ```xml
+	 * <listItem listIndent="0" listType="bulleted" listStyle="square">UL List item 1</listItem>
+	 * <listItem listIndent="0" listType="bulleted" listStyle="square">UL List item 2</listItem>
+	 * <paragraph>[A paragraph.]</paragraph>
+	 * <listItem listIndent="0" listType="bulleted" listStyle="circle">UL List item 1</listItem>
+	 * <listItem listIndent="0" listType="bulleted" listStyle="circle">UL List item 2</listItem>
+	 * ```
+	 *
+	 * After removing the paragraph element, the second list will be merged into the first one.
+	 * We want to inherit the `listStyle` attribute for the second list from the first one.
+	 *
+	 * ```xml
+	 * <listItem listIndent="0" listType="bulleted" listStyle="square">UL List item 1</listItem>
+	 * <listItem listIndent="0" listType="bulleted" listStyle="square">UL List item 2</listItem>
+	 * <listItem listIndent="0" listType="bulleted" listStyle="square">UL List item 1</listItem>
+	 * <listItem listIndent="0" listType="bulleted" listStyle="square">UL List item 2</listItem>
+	 * ```
+	 *
+	 * See https://github.com/ckeditor/ckeditor5/issues/7879.
+	 *
+	 * @param attributeStrategies Strategies for the enabled attributes.
+	 */ _mergeListAttributesWhileMergingLists(attributeStrategies) {
         const editor = this.editor;
         const model = editor.model;
         // First the outer-most`listItem` in the first list reference.
@@ -6418,18 +6618,6 @@ class LegacyListPropertiesEditing extends Plugin {
             priority: 'low'
         });
     }
-    /**
-     * @inheritDoc
-     */ constructor(editor){
-        super(editor);
-        editor.config.define('list', {
-            properties: {
-                styles: true,
-                startIndex: false,
-                reversed: false
-            }
-        });
-    }
 }
 /**
  * Creates an array of strategies for dealing with enabled listItem attributes.
@@ -6554,8 +6742,8 @@ class LegacyListPropertiesEditing extends Plugin {
         }
     };
     /**
-     * Checks whether specified list items belong to the same list.
-     */ function areRepresentingSameList(listItem1, listItem2) {
+	 * Checks whether specified list items belong to the same list.
+	 */ function areRepresentingSameList(listItem1, listItem2) {
         return listItem2 && listItem1.getAttribute('listType') === listItem2.getAttribute('listType') && listItem1.getAttribute('listIndent') === listItem2.getAttribute('listIndent') && listItem1.getAttribute('listStyle') === listItem2.getAttribute('listStyle') && listItem1.getAttribute('listReversed') === listItem2.getAttribute('listReversed') && listItem1.getAttribute('listStart') === listItem2.getAttribute('listStart');
     }
 }
@@ -6895,34 +7083,63 @@ function getItemFromChange(change) {
     return null;
 }
 
-class LegacyListProperties extends Plugin {
+/**
+ * The legacy list properties feature.
+ *
+ * This is a "glue" plugin that loads the {@link module:list/legacylistproperties/legacylistpropertiesediting~LegacyListPropertiesEditing
+ * legacy list properties editing feature} and the
+ * {@link module:list/listproperties/listpropertiesui~ListPropertiesUI list properties UI feature}.
+ */ class LegacyListProperties extends Plugin {
     /**
-     * @inheritDoc
-     */ static get requires() {
+	 * @inheritDoc
+	 */ static get requires() {
         return [
             LegacyListPropertiesEditing,
             ListPropertiesUI
         ];
     }
     /**
-     * @inheritDoc
-     */ static get pluginName() {
+	 * @inheritDoc
+	 */ static get pluginName() {
         return 'LegacyListProperties';
     }
 }
 
 const attributeKey = 'todoListChecked';
-class LegacyCheckTodoListCommand extends Command {
+/**
+ * The check to-do command.
+ *
+ * The command is registered by the {@link module:list/legacytodolist/legacytodolistediting~LegacyTodoListEditing} as
+ * the `checkTodoList` editor command and it is also available via aliased `todoListCheck` name.
+ */ class LegacyCheckTodoListCommand extends Command {
+    /**
+	 * A list of to-do list items selected by the {@link module:engine/model/selection~Selection}.
+	 *
+	 * @internal
+	 */ _selectedElements;
     /**
-     * Updates the command's {@link #value} and {@link #isEnabled} properties based on the current selection.
-     */ refresh() {
+	 * @inheritDoc
+	 */ constructor(editor){
+        super(editor);
+        this._selectedElements = [];
+        // Refresh command before executing to be sure all values are up to date.
+        // It is needed when selection has changed before command execution, in the same change block.
+        this.on('execute', ()=>{
+            this.refresh();
+        }, {
+            priority: 'highest'
+        });
+    }
+    /**
+	 * Updates the command's {@link #value} and {@link #isEnabled} properties based on the current selection.
+	 */ refresh() {
         this._selectedElements = this._getSelectedItems();
         this.value = this._selectedElements.every((element)=>!!element.getAttribute(attributeKey));
         this.isEnabled = !!this._selectedElements.length;
     }
     /**
-     * Gets all to-do list items selected by the {@link module:engine/model/selection~Selection}.
-     */ _getSelectedItems() {
+	 * Gets all to-do list items selected by the {@link module:engine/model/selection~Selection}.
+	 */ _getSelectedItems() {
         const model = this.editor.model;
         const schema = model.schema;
         const selectionRange = model.document.selection.getFirstRange();
@@ -6939,12 +7156,12 @@ class LegacyCheckTodoListCommand extends Command {
         return elements;
     }
     /**
-     * Executes the command.
-     *
-     * @param options.forceValue If set, it will force the command behavior. If `true`, the command will apply
-     * the attribute. Otherwise, the command will remove the attribute. If not set, the command will look for its current
-     * value to decide what it should do.
-     */ execute(options = {}) {
+	 * Executes the command.
+	 *
+	 * @param options.forceValue If set, it will force the command behavior. If `true`, the command will apply
+	 * the attribute. Otherwise, the command will remove the attribute. If not set, the command will look for its current
+	 * value to decide what it should do.
+	 */ execute(options = {}) {
         this.editor.model.change((writer)=>{
             for (const element of this._selectedElements){
                 const value = options.forceValue === undefined ? !this.value : options.forceValue;
@@ -6956,19 +7173,6 @@ class LegacyCheckTodoListCommand extends Command {
             }
         });
     }
-    /**
-     * @inheritDoc
-     */ constructor(editor){
-        super(editor);
-        this._selectedElements = [];
-        // Refresh command before executing to be sure all values are up to date.
-        // It is needed when selection has changed before command execution, in the same change block.
-        this.on('execute', ()=>{
-            this.refresh();
-        }, {
-            priority: 'highest'
-        });
-    }
 }
 
 /**
@@ -7220,23 +7424,32 @@ function findDescription(viewItem, view) {
     }
 }
 
-const ITEM_TOGGLE_KEYSTROKE = parseKeystroke('Ctrl+Enter');
-class LegacyTodoListEditing extends Plugin {
+const ITEM_TOGGLE_KEYSTROKE = /* #__PURE__ */ parseKeystroke('Ctrl+Enter');
+/**
+ * The engine of the to-do list feature. It handles creating, editing and removing to-do lists and their items.
+ *
+ * It registers the entire functionality of the {@link module:list/legacylist/legacylistediting~LegacyListEditing legacy list editing
+ * plugin} and extends it with the commands:
+ *
+ * - `'todoList'`,
+ * - `'checkTodoList'`,
+ * - `'todoListCheck'` as an alias for `checkTodoList` command.
+ */ class LegacyTodoListEditing extends Plugin {
     /**
-     * @inheritDoc
-     */ static get pluginName() {
+	 * @inheritDoc
+	 */ static get pluginName() {
         return 'LegacyTodoListEditing';
     }
     /**
-     * @inheritDoc
-     */ static get requires() {
+	 * @inheritDoc
+	 */ static get requires() {
         return [
             LegacyListEditing
         ];
     }
     /**
-     * @inheritDoc
-     */ init() {
+	 * @inheritDoc
+	 */ init() {
         const editor = this.editor;
         const { editing, data, model } = editor;
         // Extend schema.
@@ -7323,13 +7536,13 @@ class LegacyTodoListEditing extends Plugin {
         this._initAriaAnnouncements();
     }
     /**
-     * Handles the checkbox element change, moves the selection to the corresponding model item to make it possible
-     * to toggle the `todoListChecked` attribute using the command, and restores the selection position.
-     *
-     * Some say it's a hack :) Moving the selection only for executing the command on a certain node and restoring it after,
-     * is not a clear solution. We need to design an API for using commands beyond the selection range.
-     * See https://github.com/ckeditor/ckeditor5/issues/1954.
-     */ _handleCheckmarkChange(listItem) {
+	 * Handles the checkbox element change, moves the selection to the corresponding model item to make it possible
+	 * to toggle the `todoListChecked` attribute using the command, and restores the selection position.
+	 *
+	 * Some say it's a hack :) Moving the selection only for executing the command on a certain node and restoring it after,
+	 * is not a clear solution. We need to design an API for using commands beyond the selection range.
+	 * See https://github.com/ckeditor/ckeditor5/issues/1954.
+	 */ _handleCheckmarkChange(listItem) {
         const editor = this.editor;
         const model = editor.model;
         const previousSelectionRanges = Array.from(model.document.selection.getRanges());
@@ -7340,11 +7553,11 @@ class LegacyTodoListEditing extends Plugin {
         });
     }
     /**
-     * Observe when user enters or leaves todo list and set proper aria value in global live announcer.
-     * This allows screen readers to indicate when the user has entered and left the specified todo list.
-     *
-     * @internal
-     */ _initAriaAnnouncements() {
+	 * Observe when user enters or leaves todo list and set proper aria value in global live announcer.
+	 * This allows screen readers to indicate when the user has entered and left the specified todo list.
+	 *
+	 * @internal
+	 */ _initAriaAnnouncements() {
         const { model, ui, t } = this.editor;
         let lastFocusedCodeBlock = null;
         if (!ui) {
@@ -7399,31 +7612,36 @@ class LegacyTodoListEditing extends Plugin {
     return !!element && element.is('element', 'listItem') && element.getAttribute('listType') === 'todo';
 }
 
-class LegacyTodoList extends Plugin {
+/**
+ * The legacy to-do list feature.
+ *
+ * This is a "glue" plugin that loads the {@link module:list/legacytodolist/legacytodolistediting~LegacyTodoListEditing legacy to-do list
+ * editing feature} and the {@link module:list/todolist/todolistui~TodoListUI to-do list UI feature}.
+ */ class LegacyTodoList extends Plugin {
     /**
-     * @inheritDoc
-     */ static get requires() {
+	 * @inheritDoc
+	 */ static get requires() {
         return [
             LegacyTodoListEditing,
             TodoListUI
         ];
     }
     /**
-     * @inheritDoc
-     */ static get pluginName() {
+	 * @inheritDoc
+	 */ static get pluginName() {
         return 'LegacyTodoList';
     }
 }
 
 class AdjacentListsSupport extends Plugin {
     /**
-     * @inheritDoc
-     */ static get pluginName() {
+	 * @inheritDoc
+	 */ static get pluginName() {
         return 'AdjacentListsSupport';
     }
     /**
-     * @inheritDoc
-     */ init() {
+	 * @inheritDoc
+	 */ init() {
         const editor = this.editor;
         const model = editor.model;
         model.schema.register('listSeparator', {
@@ -7490,76 +7708,97 @@ class AdjacentListsSupport extends Plugin {
     };
 }
 
-class DocumentList extends Plugin {
+/**
+ * The document list feature.
+ *
+ * This is an obsolete plugin that exists for backward compatibility only.
+ * Use the {@link module:list/list~List `List`} instead.
+ *
+ * @deprecated
+ */ class DocumentList extends Plugin {
     /**
-     * @inheritDoc
-     */ static get requires() {
+	 * @inheritDoc
+	 */ static get requires() {
         return [
             List
         ];
     }
     /**
-     * @inheritDoc
-     */ static get pluginName() {
+	 * @inheritDoc
+	 */ static get pluginName() {
         return 'DocumentList';
     }
     constructor(editor){
         super(editor);
         /**
-         * The `DocumentList` plugin is obsolete. Use `List` instead.
-         *
-         * @error plugin-obsolete-documentlist
-         */ logWarning('plugin-obsolete-documentlist', {
+		 * The `DocumentList` plugin is obsolete. Use `List` instead.
+		 *
+		 * @error plugin-obsolete-documentlist
+		 */ logWarning('plugin-obsolete-documentlist', {
             pluginName: 'DocumentList'
         });
     }
 }
 
-class DocumentListProperties extends Plugin {
+/**
+ * The document list properties feature.
+ *
+ * This is an obsolete plugin that exists for backward compatibility only.
+ * Use the {@link module:list/listproperties~ListProperties `ListProperties`} instead.
+ *
+ * @deprecated
+ */ class DocumentListProperties extends Plugin {
     /**
-     * @inheritDoc
-     */ static get requires() {
+	 * @inheritDoc
+	 */ static get requires() {
         return [
             ListProperties
         ];
     }
     /**
-     * @inheritDoc
-     */ static get pluginName() {
+	 * @inheritDoc
+	 */ static get pluginName() {
         return 'DocumentListProperties';
     }
     constructor(editor){
         super(editor);
         /**
-         * The `DocumentListProperties` plugin is obsolete. Use `ListProperties` instead.
-         *
-         * @error plugin-obsolete-documentlistproperties
-         */ logWarning('plugin-obsolete-documentlistproperties', {
+		 * The `DocumentListProperties` plugin is obsolete. Use `ListProperties` instead.
+		 *
+		 * @error plugin-obsolete-documentlistproperties
+		 */ logWarning('plugin-obsolete-documentlistproperties', {
             pluginName: 'DocumentListProperties'
         });
     }
 }
 
-class TodoDocumentList extends Plugin {
+/**
+ * The to-do list feature.
+ *
+ * This is an obsolete plugin that exists for backward compatibility only.
+ * Use the {@link module:list/todolist~TodoList `TodoList`} instead.
+ *
+ * @deprecated
+ */ class TodoDocumentList extends Plugin {
     /**
-     * @inheritDoc
-     */ static get requires() {
+	 * @inheritDoc
+	 */ static get requires() {
         return [
             TodoList
         ];
     }
     /**
-     * @inheritDoc
-     */ static get pluginName() {
+	 * @inheritDoc
+	 */ static get pluginName() {
         return 'TodoDocumentList';
     }
     constructor(editor){
         super(editor);
         /**
-         * The `TodoDocumentList` plugin is obsolete. Use `TodoList` instead.
-         *
-         * @error plugin-obsolete-tododocumentlist
-         */ logWarning('plugin-obsolete-tododocumentlist', {
+		 * The `TodoDocumentList` plugin is obsolete. Use `TodoList` instead.
+		 *
+		 * @error plugin-obsolete-tododocumentlist
+		 */ logWarning('plugin-obsolete-tododocumentlist', {
             pluginName: 'TodoDocumentList'
         });
     }