@ckeditor/ckeditor5-list 42.0.2 → 43.0.0-alpha.0

package/dist/list/converters.d.ts

@@ -19,14 +19,6 @@ import type { default as ListEditing, DowncastStrategy } from './listediting.js'
  * @internal
  */
 export declare function listItemUpcastConverter(): GetCallback<UpcastElementEvent>;
-/**
- * Returns the upcast converter for the `<ul>` and `<ol>` view elements that cleans the input view of garbage.
- * This is mostly to clean whitespaces from between the `<li>` view elements inside the view list element. However,
- * incorrect data can also be cleared if the view was incorrect.
- *
- * @internal
- */
-export declare function listUpcastCleanList(): GetCallback<UpcastElementEvent>;
 /**
  * Returns a model document change:data event listener that triggers conversion of related items if needed.
  *

package/dist/listconfig.d.ts

@@ -9,6 +9,7 @@
 /**
  * @module list/listconfig
  */
+import { type ArrayOrItem } from 'ckeditor5/src/utils.js';
 /**
  * The configuration of the {@link module:list/list~List list} feature
  * and the {@link module:list/legacylist~LegacyList legacy list} feature.
@@ -84,7 +85,7 @@ export interface ListPropertiesConfig {
      *
      * @default true
      */
-    styles?: boolean | ListPropertiesStyleConfig;
+    styles?: boolean | ListPropertiesStyleConfig | ArrayOrItem<ListPropertiesStyleListType>;
     /**
      * When set, the list start index feature will be enabled. It allows changing the `start` HTML attribute of the numbered lists. As a
      * result, it will be possible to specify the start value of the first item in an ordered list.
@@ -105,6 +106,32 @@ export interface ListPropertiesConfig {
     reversed?: boolean;
 }
 export interface ListPropertiesStyleConfig {
+    /**
+     * Enable style feature for the given list type only.
+     *
+     * ```ts
+     * {
+     * 	list: {
+     * 		properties: {
+     * 			styles: {
+     * 				listTypes: 'numbered'
+     * 			}
+     *
+     * 			// ...
+     * 		}
+     * 	},
+     *
+     * 	// ...
+     * }
+     * ```
+     *
+     *
+     * **Note**: This configuration works only with
+     * {@link module:list/listproperties~ListProperties list properties}.
+     *
+     * @default ['bulleted','numbered']
+     */
+    listTypes?: ArrayOrItem<ListPropertiesStyleListType>;
     /**
      * When set `true`, the list style feature will use the `type` attribute of `<ul>` and `<ol>` elements instead of the `list-style-type`
      * style.
@@ -134,3 +161,4 @@ export interface ListPropertiesStyleConfig {
      */
     useAttribute?: boolean;
 }
+export type ListPropertiesStyleListType = 'numbered' | 'bulleted';

package/dist/listproperties/ui/listpropertiesview.d.ts

@@ -11,7 +11,7 @@
  */
 import { View, ViewCollection, FocusCycler, SwitchButtonView, LabeledFieldView, CollapsibleView, type ButtonView, type InputNumberView, type FocusableView } from 'ckeditor5/src/ui.js';
 import { FocusTracker, KeystrokeHandler, type Locale } from 'ckeditor5/src/utils.js';
-import type { ListPropertiesConfig } from '../../listconfig.js';
+import type { NormalizedListPropertiesConfig } from '../utils/config.js';
 import '../../../theme/listproperties.css';
 /**
  * The list properties view to be displayed in the list dropdown.
@@ -89,7 +89,7 @@ export default class ListPropertiesView extends View {
      * @param options.styleGridAriaLabel An assistive technologies label set on the grid of styles (if the grid is rendered).
      */
     constructor(locale: Locale, { enabledProperties, styleButtonViews, styleGridAriaLabel }: {
-        enabledProperties: ListPropertiesConfig;
+        enabledProperties: NormalizedListPropertiesConfig;
         styleButtonViews: Array<ButtonView> | null;
         styleGridAriaLabel: string;
     });

package/dist/listproperties/utils/config.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @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
+ */
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+import type { ListPropertiesConfig, ListPropertiesStyleListType } from '../../listconfig.js';
+/**
+ * Normalizes {@link module:list/listconfig~ListPropertiesConfig} in the configuration of the list properties feature.
+ * The structure of normalized list properties options looks as follows:
+ *
+ * ```ts
+ * {
+ * 	styles: {
+ * 		listTypes: [ 'bulleted', 'numbered' ],
+ * 		useAttribute: false
+ * 	},
+ * 	startIndex: true,
+ * 	reversed: true
+ * }
+ * ```
+ *
+ * @param config The list properties {@link module:list/listconfig~ListPropertiesConfig config}.
+ * @returns An object with normalized list properties options.
+ */
+export declare function getNormalizedConfig(config: ListPropertiesConfig): NormalizedListPropertiesConfig;
+/**
+* Normalized list properties config.
+*/
+export type NormalizedListPropertiesConfig = {
+    styles: {
+        listTypes: Array<ListPropertiesStyleListType>;
+        useAttribute: boolean;
+    };
+    startIndex: boolean;
+    reversed: boolean;
+};

package/dist/translations/sr-latn.js

@@ -2,4 +2,4 @@
  * @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
  */
-export default {"sr-latn":{"dictionary":{"Numbered List":"Lista sa brojevima","Bulleted List":"Nabrajane liste","To-do List":"Lista obaveza","Bulleted list styles toolbar":"Traka sa alatkama za nabrajane liste","Numbered list styles toolbar":"Traka sa altakama za liste sa brojevima","Toggle the disc list style":"Uključite / isključite stil liste diskova","Toggle the circle list style":"Uključite / isključite stil liste krugova","Toggle the square list style":"Uključite / isključite stil liste kvadrata","Toggle the decimal list style":"Uključi / isključi stil dekadne liste","Toggle the decimal with leading zero list style":"Prebaci decimalni znak sa vodećim stilom liste nula","Toggle the lower–roman list style":"Uključite / isključite stil donje rimske liste","Toggle the upper–roman list style":"Uključite / isključite stil gornje rimske liste","Toggle the lower–latin list style":"Uključite / isključite stil donje liste latinice","Toggle the upper–latin list style":"Uključite / isključite stil gornje liste latinice","Disc":"Disk","Circle":"Krug","Square":"Kvadrat","Decimal":"Decimala","Decimal with leading zero":"Decimalni broj sa nulom na početku","Lower–roman":"Donji - rimski","Upper-roman":"Gornji - rimski","Lower-latin":"Donji - latinski","Upper-latin":"Gornji - latinski","List properties":"Navedite svojstva","Start at":"Početi u","Invalid start index value.":"","Start index must be greater than 0.":"Početni indeks mora biti veći od 0.","Reversed order":"Obrnuti redosled","Keystrokes that can be used in a list":"","Increase list item indent":"","Decrease list item indent":"","Entering a to-do list":"","Leaving a to-do list":""},getPluralForm(n){return (n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);}}}
+export default {"sr-latn":{"dictionary":{"Numbered List":"Lista sa brojevima","Bulleted List":"Nabrajane liste","To-do List":"Lista obaveza","Bulleted list styles toolbar":"Traka sa alatkama za nabrajane liste","Numbered list styles toolbar":"Traka sa altakama za liste sa brojevima","Toggle the disc list style":"Uključite / isključite stil liste diskova","Toggle the circle list style":"Uključite / isključite stil liste krugova","Toggle the square list style":"Uključite / isključite stil liste kvadrata","Toggle the decimal list style":"Uključi / isključi stil dekadne liste","Toggle the decimal with leading zero list style":"Prebaci decimalni znak sa vodećim stilom liste nula","Toggle the lower–roman list style":"Uključite / isključite stil donje rimske liste","Toggle the upper–roman list style":"Uključite / isključite stil gornje rimske liste","Toggle the lower–latin list style":"Uključite / isključite stil donje liste latinice","Toggle the upper–latin list style":"Uključite / isključite stil gornje liste latinice","Disc":"Disk","Circle":"Krug","Square":"Kvadrat","Decimal":"Decimala","Decimal with leading zero":"Decimalni broj sa nulom na početku","Lower–roman":"Donji - rimski","Upper-roman":"Gornji - rimski","Lower-latin":"Donji - latinski","Upper-latin":"Gornji - latinski","List properties":"Navedite svojstva","Start at":"Početi u","Invalid start index value.":"Nevažeća vrednost početnog indeksa.","Start index must be greater than 0.":"Početni indeks mora biti veći od 0.","Reversed order":"Obrnuti redosled","Keystrokes that can be used in a list":"Pritisci na tastere koji se mogu koristiti na listi","Increase list item indent":"Povećaj uvlačenje stavke liste","Decrease list item indent":"Smanji uvlačenje stavke liste","Entering a to-do list":"Unošenje liste obaveza","Leaving a to-do list":"Ostavljanje liste obaveza"},getPluralForm(n){return (n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);}}}

package/dist/translations/sr-latn.umd.js

@@ -4,7 +4,7 @@
  */
 
 ( e => {
-const { [ 'sr-latn' ]: { dictionary, getPluralForm } } = {"sr-latn":{"dictionary":{"Numbered List":"Lista sa brojevima","Bulleted List":"Nabrajane liste","To-do List":"Lista obaveza","Bulleted list styles toolbar":"Traka sa alatkama za nabrajane liste","Numbered list styles toolbar":"Traka sa altakama za liste sa brojevima","Toggle the disc list style":"Uključite / isključite stil liste diskova","Toggle the circle list style":"Uključite / isključite stil liste krugova","Toggle the square list style":"Uključite / isključite stil liste kvadrata","Toggle the decimal list style":"Uključi / isključi stil dekadne liste","Toggle the decimal with leading zero list style":"Prebaci decimalni znak sa vodećim stilom liste nula","Toggle the lower–roman list style":"Uključite / isključite stil donje rimske liste","Toggle the upper–roman list style":"Uključite / isključite stil gornje rimske liste","Toggle the lower–latin list style":"Uključite / isključite stil donje liste latinice","Toggle the upper–latin list style":"Uključite / isključite stil gornje liste latinice","Disc":"Disk","Circle":"Krug","Square":"Kvadrat","Decimal":"Decimala","Decimal with leading zero":"Decimalni broj sa nulom na početku","Lower–roman":"Donji - rimski","Upper-roman":"Gornji - rimski","Lower-latin":"Donji - latinski","Upper-latin":"Gornji - latinski","List properties":"Navedite svojstva","Start at":"Početi u","Invalid start index value.":"","Start index must be greater than 0.":"Početni indeks mora biti veći od 0.","Reversed order":"Obrnuti redosled","Keystrokes that can be used in a list":"","Increase list item indent":"","Decrease list item indent":"","Entering a to-do list":"","Leaving a to-do list":""},getPluralForm(n){return (n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);}}};
+const { [ 'sr-latn' ]: { dictionary, getPluralForm } } = {"sr-latn":{"dictionary":{"Numbered List":"Lista sa brojevima","Bulleted List":"Nabrajane liste","To-do List":"Lista obaveza","Bulleted list styles toolbar":"Traka sa alatkama za nabrajane liste","Numbered list styles toolbar":"Traka sa altakama za liste sa brojevima","Toggle the disc list style":"Uključite / isključite stil liste diskova","Toggle the circle list style":"Uključite / isključite stil liste krugova","Toggle the square list style":"Uključite / isključite stil liste kvadrata","Toggle the decimal list style":"Uključi / isključi stil dekadne liste","Toggle the decimal with leading zero list style":"Prebaci decimalni znak sa vodećim stilom liste nula","Toggle the lower–roman list style":"Uključite / isključite stil donje rimske liste","Toggle the upper–roman list style":"Uključite / isključite stil gornje rimske liste","Toggle the lower–latin list style":"Uključite / isključite stil donje liste latinice","Toggle the upper–latin list style":"Uključite / isključite stil gornje liste latinice","Disc":"Disk","Circle":"Krug","Square":"Kvadrat","Decimal":"Decimala","Decimal with leading zero":"Decimalni broj sa nulom na početku","Lower–roman":"Donji - rimski","Upper-roman":"Gornji - rimski","Lower-latin":"Donji - latinski","Upper-latin":"Gornji - latinski","List properties":"Navedite svojstva","Start at":"Početi u","Invalid start index value.":"Nevažeća vrednost početnog indeksa.","Start index must be greater than 0.":"Početni indeks mora biti veći od 0.","Reversed order":"Obrnuti redosled","Keystrokes that can be used in a list":"Pritisci na tastere koji se mogu koristiti na listi","Increase list item indent":"Povećaj uvlačenje stavke liste","Decrease list item indent":"Smanji uvlačenje stavke liste","Entering a to-do list":"Unošenje liste obaveza","Leaving a to-do list":"Ostavljanje liste obaveza"},getPluralForm(n){return (n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);}}};
 e[ 'sr-latn' ] ||= { dictionary: {}, getPluralForm: null };
 e[ 'sr-latn' ].dictionary = Object.assign( e[ 'sr-latn' ].dictionary, dictionary );
 e[ 'sr-latn' ].getPluralForm = getPluralForm;

package/lang/translations/sr-latn.po

@@ -119,7 +119,7 @@ msgstr "Početi u"
 
 msgctxt "The error message displayed when the numbered list start index input value is not a valid number."
 msgid "Invalid start index value."
-msgstr ""
+msgstr "Nevažeća vrednost početnog indeksa."
 
 msgctxt "The error message displayed when the numbered list start index input value is invalid."
 msgid "Start index must be greater than 0."
@@ -131,20 +131,20 @@ msgstr "Obrnuti redosled"
 
 msgctxt "Accessibility help dialog header text displayed before the list of keystrokes that can be used in a list."
 msgid "Keystrokes that can be used in a list"
-msgstr ""
+msgstr "Pritisci na tastere koji se mogu koristiti na listi"
 
 msgctxt "Keystroke description for assistive technologies: keystroke for increasing list item indentation."
 msgid "Increase list item indent"
-msgstr ""
+msgstr "Povećaj uvlačenje stavke liste"
 
 msgctxt "Keystroke description for assistive technologies: keystroke for decreasing list item indentation."
 msgid "Decrease list item indent"
-msgstr ""
+msgstr "Smanji uvlačenje stavke liste"
 
 msgctxt "Assistive technologies label for entering the to-do list."
 msgid "Entering a to-do list"
-msgstr ""
+msgstr "Unošenje liste obaveza"
 
 msgctxt "Assistive technologies label for leaving the to-do list."
 msgid "Leaving a to-do list"
-msgstr ""
+msgstr "Ostavljanje liste obaveza"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-list",
-  "version": "42.0.2",
+  "version": "43.0.0-alpha.0",
   "description": "Ordered and unordered lists feature to CKEditor 5.",
   "keywords": [
     "ckeditor",
@@ -13,14 +13,14 @@
   "type": "module",
   "main": "src/index.js",
   "dependencies": {
-    "@ckeditor/ckeditor5-clipboard": "42.0.2",
-    "@ckeditor/ckeditor5-core": "42.0.2",
-    "@ckeditor/ckeditor5-engine": "42.0.2",
-    "@ckeditor/ckeditor5-enter": "42.0.2",
-    "@ckeditor/ckeditor5-typing": "42.0.2",
-    "@ckeditor/ckeditor5-ui": "42.0.2",
-    "@ckeditor/ckeditor5-utils": "42.0.2",
-    "ckeditor5": "42.0.2"
+    "@ckeditor/ckeditor5-clipboard": "43.0.0-alpha.0",
+    "@ckeditor/ckeditor5-core": "43.0.0-alpha.0",
+    "@ckeditor/ckeditor5-engine": "43.0.0-alpha.0",
+    "@ckeditor/ckeditor5-enter": "43.0.0-alpha.0",
+    "@ckeditor/ckeditor5-typing": "43.0.0-alpha.0",
+    "@ckeditor/ckeditor5-ui": "43.0.0-alpha.0",
+    "@ckeditor/ckeditor5-utils": "43.0.0-alpha.0",
+    "ckeditor5": "43.0.0-alpha.0"
   },
   "author": "CKSource (http://cksource.com/)",
   "license": "GPL-2.0-or-later",

package/src/list/converters.d.ts

@@ -15,14 +15,6 @@ import type { default as ListEditing, DowncastStrategy } from './listediting.js'
  * @internal
  */
 export declare function listItemUpcastConverter(): GetCallback<UpcastElementEvent>;
-/**
- * Returns the upcast converter for the `<ul>` and `<ol>` view elements that cleans the input view of garbage.
- * This is mostly to clean whitespaces from between the `<li>` view elements inside the view list element. However,
- * incorrect data can also be cleared if the view was incorrect.
- *
- * @internal
- */
-export declare function listUpcastCleanList(): GetCallback<UpcastElementEvent>;
 /**
  * Returns a model document change:data event listener that triggers conversion of related items if needed.
  *

package/src/list/converters.js

@@ -2,10 +2,6 @@
  * @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/converters
- */
-import { UpcastWriter } from 'ckeditor5/src/engine.js';
 import { getAllListItemBlocks, getListItemBlocks, isListItemBlock, isFirstBlockOfListItem, ListItemUid } from './utils/model.js';
 import { createListElement, createListItemElement, getIndent, isListView, isListItemView } from './utils/view.js';
 import ListWalker, { iterateSiblingListBlocks } from './utils/listwalker.js';
@@ -61,26 +57,6 @@ export function listItemUpcastConverter() {
         }
     };
 }
-/**
- * Returns the upcast converter for the `<ul>` and `<ol>` view elements that cleans the input view of garbage.
- * This is mostly to clean whitespaces from between the `<li>` view elements inside the view list element. However,
- * incorrect data can also be cleared if the view was incorrect.
- *
- * @internal
- */
-export function listUpcastCleanList() {
-    return (evt, data, conversionApi) => {
-        if (!conversionApi.consumable.test(data.viewItem, { name: true })) {
-            return;
-        }
-        const viewWriter = new UpcastWriter(data.viewItem.document);
-        for (const child of Array.from(data.viewItem.getChildren())) {
-            if (!isListItemView(child) && !isListView(child)) {
-                viewWriter.remove(child);
-            }
-        }
-    };
-}
 /**
  * Returns a model document change:data event listener that triggers conversion of related items if needed.
  *

package/src/list/listediting.js

@@ -14,7 +14,7 @@ import ListCommand from './listcommand.js';
 import ListMergeCommand from './listmergecommand.js';
 import ListSplitCommand from './listsplitcommand.js';
 import ListUtils from './listutils.js';
-import { bogusParagraphCreator, createModelToViewPositionMapper, listItemDowncastConverter, listItemDowncastRemoveConverter, listItemUpcastConverter, listUpcastCleanList, reconvertItemsOnDataChange } from './converters.js';
+import { bogusParagraphCreator, createModelToViewPositionMapper, listItemDowncastConverter, listItemDowncastRemoveConverter, listItemUpcastConverter, reconvertItemsOnDataChange } from './converters.js';
 import { findAndAddListHeadToMap, fixListIndents, fixListItemIds } from './utils/postfixers.js';
 import { getAllListItemBlocks, isFirstBlockOfListItem, isLastBlockOfListItem, isSingleListItem, getSelectedBlockObject, isListItemBlock, removeListAttributes, ListItemUid } from './utils/model.js';
 import { getViewElementIdForListType, getViewElementNameForListType } from './utils/view.js';
@@ -331,8 +331,6 @@ export default class ListEditing extends Plugin {
         })
             .add(dispatcher => {
             dispatcher.on('element:li', listItemUpcastConverter());
-            dispatcher.on('element:ul', listUpcastCleanList(), { priority: 'high' });
-            dispatcher.on('element:ol', listUpcastCleanList(), { priority: 'high' });
         });
         if (!multiBlock) {
             editor.conversion.for('downcast')

package/src/list/utils.js

@@ -21,7 +21,14 @@ export function createUIComponents(editor, commandName, label, icon) {
         });
         return buttonView;
     });
-    editor.ui.componentFactory.add(`menuBar:${commandName}`, () => _createButton(MenuBarMenuListItemButtonView, editor, commandName, label, icon));
+    editor.ui.componentFactory.add(`menuBar:${commandName}`, () => {
+        const buttonView = _createButton(MenuBarMenuListItemButtonView, editor, commandName, label, icon);
+        buttonView.set({
+            role: 'menuitemcheckbox',
+            isToggleable: true
+        });
+        return buttonView;
+    });
 }
 /**
  * Creates a button to use either in toolbar or in menu bar.

package/src/listconfig.d.ts

@@ -5,6 +5,7 @@
 /**
  * @module list/listconfig
  */
+import { type ArrayOrItem } from 'ckeditor5/src/utils.js';
 /**
  * The configuration of the {@link module:list/list~List list} feature
  * and the {@link module:list/legacylist~LegacyList legacy list} feature.
@@ -80,7 +81,7 @@ export interface ListPropertiesConfig {
      *
      * @default true
      */
-    styles?: boolean | ListPropertiesStyleConfig;
+    styles?: boolean | ListPropertiesStyleConfig | ArrayOrItem<ListPropertiesStyleListType>;
     /**
      * When set, the list start index feature will be enabled. It allows changing the `start` HTML attribute of the numbered lists. As a
      * result, it will be possible to specify the start value of the first item in an ordered list.
@@ -101,6 +102,32 @@ export interface ListPropertiesConfig {
     reversed?: boolean;
 }
 export interface ListPropertiesStyleConfig {
+    /**
+     * Enable style feature for the given list type only.
+     *
+     * ```ts
+     * {
+     * 	list: {
+     * 		properties: {
+     * 			styles: {
+     * 				listTypes: 'numbered'
+     * 			}
+     *
+     * 			// ...
+     * 		}
+     * 	},
+     *
+     * 	// ...
+     * }
+     * ```
+     *
+     *
+     * **Note**: This configuration works only with
+     * {@link module:list/listproperties~ListProperties list properties}.
+     *
+     * @default ['bulleted','numbered']
+     */
+    listTypes?: ArrayOrItem<ListPropertiesStyleListType>;
     /**
      * When set `true`, the list style feature will use the `type` attribute of `<ul>` and `<ol>` elements instead of the `list-style-type`
      * style.
@@ -130,3 +157,4 @@ export interface ListPropertiesStyleConfig {
      */
     useAttribute?: boolean;
 }
+export type ListPropertiesStyleListType = 'numbered' | 'bulleted';

package/src/listproperties/listpropertiesediting.js

@@ -14,6 +14,7 @@ import { listPropertiesUpcastConverter } from './converters.js';
 import { getAllSupportedStyleTypes, getListTypeFromListStyleType, getListStyleTypeFromTypeAttribute, getTypeAttributeFromListStyleType } from './utils/style.js';
 import ListPropertiesUtils from './listpropertiesutils.js';
 import { isNumberedListType } from '../list/utils/model.js';
+import { getNormalizedConfig } from './utils/config.js';
 const DEFAULT_LIST_TYPE = 'default';
 /**
  * The document list properties engine feature.
@@ -149,8 +150,9 @@ export default class ListPropertiesEditing extends Plugin {
  */
 function createAttributeStrategies(enabledProperties) {
     const strategies = [];
+    const normalizedConfig = getNormalizedConfig(enabledProperties);
     if (enabledProperties.styles) {
-        const useAttribute = typeof enabledProperties.styles == 'object' && enabledProperties.styles.useAttribute;
+        const useAttribute = normalizedConfig.styles.useAttribute;
         strategies.push({
             attributeName: 'listStyle',
             defaultValue: DEFAULT_LIST_TYPE,

package/src/listproperties/listpropertiesui.js

@@ -8,6 +8,7 @@
 import { icons, Plugin } from 'ckeditor5/src/core.js';
 import { ButtonView, SplitButtonView, createDropdown, focusChildOnDropdownOpen, MenuBarMenuView } from 'ckeditor5/src/ui.js';
 import ListPropertiesView from './ui/listpropertiesview.js';
+import { getNormalizedConfig } from './utils/config.js';
 import listStyleDiscIcon from '../../theme/icons/liststyledisc.svg';
 import listStyleCircleIcon from '../../theme/icons/liststylecircle.svg';
 import listStyleSquareIcon from '../../theme/icons/liststylesquare.svg';
@@ -36,10 +37,12 @@ export default class ListPropertiesUI extends Plugin {
         const editor = this.editor;
         const t = editor.locale.t;
         const propertiesConfig = editor.config.get('list.properties');
+        const normalizedConfig = getNormalizedConfig(propertiesConfig);
+        const stylesListTypes = normalizedConfig.styles.listTypes;
         // Note: When this plugin does not register the "bulletedList" dropdown due to properties configuration,
         // a simple button will be still registered under the same name by ListUI as a fallback. This should happen
         // in most editor configuration because the List plugin automatically requires ListUI.
-        if (propertiesConfig.styles) {
+        if (stylesListTypes.includes('bulleted')) {
             const styleDefinitions = [
                 {
                     label: t('Toggle the disc list style'),
@@ -65,7 +68,7 @@ export default class ListPropertiesUI extends Plugin {
             const commandName = 'bulletedList';
             editor.ui.componentFactory.add(commandName, getDropdownViewCreator({
                 editor,
-                propertiesConfig,
+                normalizedConfig,
                 parentCommandName: commandName,
                 buttonLabel,
                 buttonIcon: icons.bulletedList,
@@ -75,7 +78,7 @@ export default class ListPropertiesUI extends Plugin {
             // Add the menu bar item for bulleted list.
             editor.ui.componentFactory.add(`menuBar:${commandName}`, getMenuBarStylesMenuCreator({
                 editor,
-                propertiesConfig,
+                normalizedConfig,
                 parentCommandName: commandName,
                 buttonLabel,
                 styleGridAriaLabel,
@@ -85,7 +88,7 @@ export default class ListPropertiesUI extends Plugin {
         // Note: When this plugin does not register the "numberedList" dropdown due to properties configuration,
         // a simple button will be still registered under the same name by ListUI as a fallback. This should happen
         // in most editor configuration because the List plugin automatically requires ListUI.
-        if (propertiesConfig.styles || propertiesConfig.startIndex || propertiesConfig.reversed) {
+        if (stylesListTypes.includes('numbered') || propertiesConfig.startIndex || propertiesConfig.reversed) {
             const styleDefinitions = [
                 {
                     label: t('Toggle the decimal list style'),
@@ -129,7 +132,7 @@ export default class ListPropertiesUI extends Plugin {
             const commandName = 'numberedList';
             editor.ui.componentFactory.add(commandName, getDropdownViewCreator({
                 editor,
-                propertiesConfig,
+                normalizedConfig,
                 parentCommandName: commandName,
                 buttonLabel,
                 buttonIcon: icons.numberedList,
@@ -138,10 +141,10 @@ export default class ListPropertiesUI extends Plugin {
             }));
             // Menu bar menu does not display list start index or reverse UI. If there are no styles enabled,
             // the menu makes no sense and should be omitted.
-            if (propertiesConfig.styles) {
+            if (stylesListTypes.includes('numbered')) {
                 editor.ui.componentFactory.add(`menuBar:${commandName}`, getMenuBarStylesMenuCreator({
                     editor,
-                    propertiesConfig,
+                    normalizedConfig,
                     parentCommandName: commandName,
                     buttonLabel,
                     styleGridAriaLabel,
@@ -156,7 +159,7 @@ export default class ListPropertiesUI extends Plugin {
  * which in turn contains buttons allowing users to change list styles in the context of the current selection.
  *
  * @param options.editor
- * @param options.propertiesConfig List properties configuration.
+ * @param options.normalizedConfig List properties configuration.
  * @param options.parentCommandName The name of the higher-order editor command associated with
  * the set of particular list styles (e.g. "bulletedList" for "disc", "circle", and "square" styles).
  * @param options.buttonLabel Label of the main part of the split button.
@@ -165,7 +168,7 @@ export default class ListPropertiesUI extends Plugin {
  * @param options.styleDefinitions Definitions of the style buttons.
  * @returns A function that can be passed straight into {@link module:ui/componentfactory~ComponentFactory#add}.
  */
-function getDropdownViewCreator({ editor, propertiesConfig, parentCommandName, buttonLabel, buttonIcon, styleGridAriaLabel, styleDefinitions }) {
+function getDropdownViewCreator({ editor, normalizedConfig, parentCommandName, buttonLabel, buttonIcon, styleGridAriaLabel, styleDefinitions }) {
     const parentCommand = editor.commands.get(parentCommandName);
     return (locale) => {
         const dropdownView = createDropdown(locale, SplitButtonView);
@@ -187,7 +190,7 @@ function getDropdownViewCreator({ editor, propertiesConfig, parentCommandName, b
         dropdownView.once('change:isOpen', () => {
             const listPropertiesView = createListPropertiesView({
                 editor,
-                propertiesConfig,
+                normalizedConfig,
                 dropdownView,
                 parentCommandName,
                 styleGridAriaLabel,
@@ -249,24 +252,25 @@ function getStyleButtonCreator({ editor, listStyleCommand, parentCommandName })
  * A helper that creates the properties view for the individual style dropdown.
  *
  * @param options.editor Editor instance.
- * @param options.propertiesConfig List properties configuration.
+ * @param options.normalizedConfig List properties configuration.
  * @param options.dropdownView Styles dropdown view that hosts the properties view.
  * @param options.parentCommandName The name of the higher-order editor command associated with
  * the set of particular list styles (e.g. "bulletedList" for "disc", "circle", and "square" styles).
  * @param options.styleDefinitions Definitions of the style buttons.
  * @param options.styleGridAriaLabel An assistive technologies label set on the grid of styles (if the grid is rendered).
  */
-function createListPropertiesView({ editor, propertiesConfig, dropdownView, parentCommandName, styleDefinitions, styleGridAriaLabel }) {
+function createListPropertiesView({ editor, normalizedConfig, dropdownView, parentCommandName, styleDefinitions, styleGridAriaLabel }) {
     const locale = editor.locale;
     const enabledProperties = {
-        ...propertiesConfig
+        ...normalizedConfig,
+        ...(parentCommandName != 'numberedList' ? {
+            startIndex: false,
+            reversed: false
+        } : null)
     };
-    if (parentCommandName != 'numberedList') {
-        enabledProperties.startIndex = false;
-        enabledProperties.reversed = false;
-    }
+    const listType = parentCommandName.replace('List', '');
     let styleButtonViews = null;
-    if (enabledProperties.styles) {
+    if (normalizedConfig.styles.listTypes.includes(listType)) {
         const listStyleCommand = editor.commands.get('listStyle');
         const styleButtonCreator = getStyleButtonCreator({
             editor,
@@ -282,7 +286,7 @@ function createListPropertiesView({ editor, propertiesConfig, dropdownView, pare
         enabledProperties,
         styleButtonViews
     });
-    if (enabledProperties.styles) {
+    if (normalizedConfig.styles.listTypes.includes(listType)) {
         // Accessibility: focus the first active style when opening the dropdown.
         focusChildOnDropdownOpen(dropdownView, () => {
             return listPropertiesView.stylesView.children.find((child) => child.isOn);
@@ -311,13 +315,12 @@ function createListPropertiesView({ editor, propertiesConfig, dropdownView, pare
  * A helper that creates the list style submenu for menu bar.
  *
  * @param editor Editor instance.
- * @param propertiesConfig List properties configuration.
+ * @param normalizedConfig List properties configuration.
  * @param parentCommandName Name of the list command.
  * @param buttonLabel Label of the menu button.
  * @param styleGridAriaLabel ARIA label of the styles grid.
- * @param styleDefinitions Array of available styles for processed list type.
  */
-function getMenuBarStylesMenuCreator({ editor, propertiesConfig, parentCommandName, buttonLabel, styleGridAriaLabel, styleDefinitions }) {
+function getMenuBarStylesMenuCreator({ editor, normalizedConfig, parentCommandName, buttonLabel, styleGridAriaLabel, styleDefinitions }) {
     return (locale) => {
         const menuView = new MenuBarMenuView(locale);
         const listCommand = editor.commands.get(parentCommandName);
@@ -332,7 +335,7 @@ function getMenuBarStylesMenuCreator({ editor, propertiesConfig, parentCommandNa
         const listPropertiesView = new ListPropertiesView(locale, {
             styleGridAriaLabel,
             enabledProperties: {
-                ...propertiesConfig,
+                ...normalizedConfig,
                 // Disable list start index and reversed in the menu bar.
                 startIndex: false,
                 reversed: false

package/src/listproperties/ui/listpropertiesview.d.ts

@@ -7,7 +7,7 @@
  */
 import { View, ViewCollection, FocusCycler, SwitchButtonView, LabeledFieldView, CollapsibleView, type ButtonView, type InputNumberView, type FocusableView } from 'ckeditor5/src/ui.js';
 import { FocusTracker, KeystrokeHandler, type Locale } from 'ckeditor5/src/utils.js';
-import type { ListPropertiesConfig } from '../../listconfig.js';
+import type { NormalizedListPropertiesConfig } from '../utils/config.js';
 import '../../../theme/listproperties.css';
 /**
  * The list properties view to be displayed in the list dropdown.
@@ -85,7 +85,7 @@ export default class ListPropertiesView extends View {
      * @param options.styleGridAriaLabel An assistive technologies label set on the grid of styles (if the grid is rendered).
      */
     constructor(locale: Locale, { enabledProperties, styleButtonViews, styleGridAriaLabel }: {
-        enabledProperties: ListPropertiesConfig;
+        enabledProperties: NormalizedListPropertiesConfig;
         styleButtonViews: Array<ButtonView> | null;
         styleGridAriaLabel: string;
     });

package/src/listproperties/ui/listpropertiesview.js

@@ -91,7 +91,7 @@ export default class ListPropertiesView extends View {
         });
         // 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) {
+        if (styleButtonViews && styleButtonViews.length) {
             this.stylesView = this._createStylesView(styleButtonViews, styleGridAriaLabel);
             this.children.add(this.stylesView);
         }
@@ -230,7 +230,7 @@ export default class ListPropertiesView extends View {
             numberedPropertyViews.push(this.reversedSwitchButtonView);
         }
         // When there are some style buttons, pack the numbered list properties into a collapsible to separate them.
-        if (enabledProperties.styles) {
+        if (this.stylesView) {
             this.additionalPropertiesCollapsibleView = new CollapsibleView(this.locale, numberedPropertyViews);
             this.additionalPropertiesCollapsibleView.set({
                 label: t('List properties'),

package/src/listproperties/utils/config.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+import type { ListPropertiesConfig, ListPropertiesStyleListType } from '../../listconfig.js';
+/**
+ * Normalizes {@link module:list/listconfig~ListPropertiesConfig} in the configuration of the list properties feature.
+ * The structure of normalized list properties options looks as follows:
+ *
+ * ```ts
+ * {
+ * 	styles: {
+ * 		listTypes: [ 'bulleted', 'numbered' ],
+ * 		useAttribute: false
+ * 	},
+ * 	startIndex: true,
+ * 	reversed: true
+ * }
+ * ```
+ *
+ * @param config The list properties {@link module:list/listconfig~ListPropertiesConfig config}.
+ * @returns An object with normalized list properties options.
+ */
+export declare function getNormalizedConfig(config: ListPropertiesConfig): NormalizedListPropertiesConfig;
+/**
+* Normalized list properties config.
+*/
+export type NormalizedListPropertiesConfig = {
+    styles: {
+        listTypes: Array<ListPropertiesStyleListType>;
+        useAttribute: boolean;
+    };
+    startIndex: boolean;
+    reversed: boolean;
+};