@ckeditor/ckeditor5-list 48.1.0 → 48.2.0-alpha.0

package/dist/list/converters.d.ts

@@ -9,6 +9,23 @@ import { type DowncastAttributeEvent, type ViewDowncastWriter, type EditingContr
 import type { GetCallback } from '@ckeditor/ckeditor5-utils';
 import { type ListElement } from './utils/model.js';
 import type { ListEditing, ListDowncastStrategy } from './listediting.js';
+/**
+ * Returns a consuming upcast converter for skip-level list item wrappers. It detects intermediate `<li>` elements
+ * with `list-style-type:none` (generated by the skip-level downcast or by external sources) and consumes them
+ * without producing a model element, so they don't end up as empty list items in the model.
+ *
+ * The wrapper `<li>` is consumed, but its children (nested lists) are converted normally. Because `getIndent()`
+ * counts all ancestor `<li>` elements (including the consumed wrapper), nested items receive the correct indent
+ * values that reflect the skip-level gap.
+ *
+ * Only `<li>` elements whose sole meaningful content is a nested `<ul>`/`<ol>` are treated as intermediate wrappers.
+ * Anything else (text, paragraphs, custom elements, even an empty `<li>` with `list-style-type:none` carrying only
+ * attributes) falls through to the regular list item upcast, so its data and attributes can be preserved by GHS
+ * or other plugins.
+ *
+ * @internal
+ */
+export declare function listItemSkipLevelConsumer(): GetCallback<UpcastElementEvent>;
 /**
  * Returns the upcast converter for list items. It's supposed to work after the block converters (content inside list items) are converted.
  *
@@ -33,8 +50,9 @@ export declare function reconvertItemsOnDataChange(model: Model, editing: Editin
  * @param strategies The strategies.
  * @param model The model.
  */
-export declare function listItemDowncastConverter(attributeNames: Array<string>, strategies: Array<ListDowncastStrategy>, model: Model, { dataPipeline }?: {
+export declare function listItemDowncastConverter(attributeNames: Array<string>, strategies: Array<ListDowncastStrategy>, model: Model, { dataPipeline, enableSkipLevelLists }: {
     dataPipeline?: boolean;
+    enableSkipLevelLists?: boolean;
 }): GetCallback<DowncastAttributeEvent<ListElement>>;
 /**
  * The 'remove' downcast converter for custom markers.

package/dist/list/utils/model.d.ts

@@ -219,9 +219,39 @@ export declare function canBecomeSimpleListItem(block: ModelElement, schema: Mod
  */
 export declare function isNumberedListType(listType: ListType): boolean;
 /**
- * Checks if the given list item is the first item in the list.
+ * Checks if the given list item block is the first block of the first item in its list at the given indent.
  *
- * This function checks if there's any other list item before the given list item
- * at the same indent level with the same list type.
+ * Walks back over previous siblings and returns:
+ * - `true` if it reaches a non-list block or a list block at a lower indent (a new list begins here),
+ * - `false` if it finds a same-indent block of the same `listItemId` (a continuation of the current item) or of the same
+ *   `listType` (the visible list already has earlier items),
+ * - `true` if it finds a same-indent block of a different `listType` and a different `listItemId` (a different list ends; ours
+ *   starts here),
+ * - `false` if the loop ends (it reaches the first non-list-item block, or no more previous siblings) while passing only
+ *   higher-indent blocks (those blocks live inside an intermediate skip-level `<li style="list-style-type:none">` wrapper
+ *   at our indent).
+ *
+ * For example, in the model:
+ *
+ * ```
+ * '  # aaa'
+ * '# bbb'
+ * ```
+ *
+ * `bbb` is preceded by a higher-indent block `aaa`, which in the view is rendered inside an intermediate
+ * skip-level wrapper at indent 0:
+ *
+ * ```html
+ * <ol>
+ *   <li style="list-style-type:none">
+ *     <ol>
+ *       <li>aaa</li>
+ *     </ol>
+ *   </li>
+ *   <li>bbb</li>
+ * </ol>
+ * ```
+ *
+ * So `bbb` is the second visible item in the outer list and the function returns `false`.
  */
 export declare function isFirstListItemInList(listItem: ModelElement): boolean;

package/dist/listconfig.d.ts

@@ -12,7 +12,7 @@ import { type ArrayOrItem } from '@ckeditor/ckeditor5-utils';
  *
  * ```ts
  * ClassicEditor
- * 	.create( editorElement, {
+ * 	.create( {
  * 		list:  ... // The list feature configuration.
  * 	} )
  * 	.then( ... )
@@ -54,6 +54,24 @@ export interface ListConfig {
      * @default true
      */
     enableListItemMarkerFormatting?: boolean;
+    /**
+     * When set to `true`, list items can be indented by more than one level relative to their parent.
+     * By default, the editor enforces that each nested list item is only one level deeper than its parent.
+     *
+     * ```ts
+     * ClassicEditor
+     * 	.create( editorElement, {
+     * 		list: {
+     * 			enableSkipLevelLists: true
+     * 		}
+     * 	} )
+     * 	.then( ... )
+     * 	.catch( ... );
+     * ```
+     *
+     * @default false
+     */
+    enableSkipLevelLists?: boolean;
 }
 /**
  * The configuration of the {@link module:list/listproperties~ListProperties list properties} feature and the
@@ -70,7 +88,7 @@ export interface ListConfig {
  *
  * ```ts
  * ClassicEditor
- * 	.create( editorElement, {
+ * 	.create( {
  * 		list: {
  * 			properties: {
  * 				styles: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-list",
-  "version": "48.1.0",
+  "version": "48.2.0-alpha.0",
   "description": "Ordered and unordered lists feature to CKEditor 5.",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "CKSource (http://cksource.com/)",
@@ -26,15 +26,15 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@ckeditor/ckeditor5-clipboard": "48.1.0",
-    "@ckeditor/ckeditor5-core": "48.1.0",
-    "@ckeditor/ckeditor5-engine": "48.1.0",
-    "@ckeditor/ckeditor5-enter": "48.1.0",
-    "@ckeditor/ckeditor5-font": "48.1.0",
-    "@ckeditor/ckeditor5-icons": "48.1.0",
-    "@ckeditor/ckeditor5-typing": "48.1.0",
-    "@ckeditor/ckeditor5-ui": "48.1.0",
-    "@ckeditor/ckeditor5-utils": "48.1.0",
+    "@ckeditor/ckeditor5-clipboard": "48.2.0-alpha.0",
+    "@ckeditor/ckeditor5-core": "48.2.0-alpha.0",
+    "@ckeditor/ckeditor5-engine": "48.2.0-alpha.0",
+    "@ckeditor/ckeditor5-enter": "48.2.0-alpha.0",
+    "@ckeditor/ckeditor5-font": "48.2.0-alpha.0",
+    "@ckeditor/ckeditor5-icons": "48.2.0-alpha.0",
+    "@ckeditor/ckeditor5-typing": "48.2.0-alpha.0",
+    "@ckeditor/ckeditor5-ui": "48.2.0-alpha.0",
+    "@ckeditor/ckeditor5-utils": "48.2.0-alpha.0",
     "es-toolkit": "1.45.1"
   },
   "files": [