@lexical/list 0.44.1-nightly.20260519.0 → 0.45.0

package/{LexicalList.dev.js → dist/LexicalList.dev.js}

@@ -8,9 +8,10 @@
 
 'use strict';
 
-var extension = require('@lexical/extension');
 var utils = require('@lexical/utils');
 var lexical = require('lexical');
+var extension = require('@lexical/extension');
+var html = require('@lexical/html');
 
 /**
  * Copyright (c) Meta Platforms, Inc. and affiliates.
@@ -1295,7 +1296,7 @@ function $normalizeChildren(nodes, listNode) {
   }
   return normalizedListItems;
 }
-function isDomChecklist(domNode) {
+function isDomChecklist$1(domNode) {
   if (domNode.getAttribute('__lexicallisttype') === 'check' ||
   // is github checklist
   domNode.classList.contains('contains-task-list') ||
@@ -1319,7 +1320,7 @@ function $convertListNode(domNode) {
   if (isHTMLOListElement(domNode)) {
     const start = domNode.start;
     node = $createListNode('number', start);
-  } else if (isDomChecklist(domNode)) {
+  } else if (isDomChecklist$1(domNode)) {
     node = $createListNode('check');
   } else {
     node = $createListNode('bullet');
@@ -1787,33 +1788,13 @@ function $findChildrenEndListItemNode(listItemNode) {
 }
 
 /**
- * @deprecated use {@link $insertList} from an update or command listener.
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
  *
- * Inserts a new ListNode. If the selection's anchor node is an empty ListItemNode and is a child of
- * the root/shadow root, it will replace the ListItemNode with a ListNode and the old ListItemNode.
- * Otherwise it will replace its parent with a new ListNode and re-insert the ListItemNode and any previous children.
- * If the selection's anchor node is not an empty ListItemNode, it will add a new ListNode or merge an existing ListNode,
- * unless the the node is a leaf node, in which case it will attempt to find a ListNode up the branch and replace it with
- * a new ListNode, or create a new ListNode at the nearest root/shadow root.
- * @param editor - The lexical editor.
- * @param listType - The type of list, "number" | "bullet" | "check".
- */
-function insertList(editor, listType) {
-  editor.update(() => $insertList(listType));
-}
-
-/**
- * @deprecated use {@link $removeList} from an update or command listener.
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
  *
- * Searches for the nearest ancestral ListNode and removes it. If selection is an empty ListItemNode
- * it will remove the whole list, including the ListItemNode. For each ListItemNode in the ListNode,
- * removeList will also generate new ParagraphNodes in the removed ListNode's place. Any child node
- * inside a ListItemNode will be appended to the new ParagraphNodes.
- * @param editor - The lexical editor.
  */
-function removeList(editor) {
-  editor.update(() => $removeList());
-}
+
 /**
  * Configures {@link ListNode}, {@link ListItemNode} and registers
  * the strict indent transform if `hasStrictIndent` is true (default false).
@@ -1839,10 +1820,8 @@ const ListExtension = lexical.defineExtension({
 });
 /**
  * Registers checklist functionality for {@link ListNode} and
- * {@link ListItemNode} with a
- * {@link INSERT_CHECK_LIST_COMMAND} listener and
- * the expected keyboard and mouse interactions for
- * checkboxes.
+ * {@link ListItemNode} with a `INSERT_CHECK_LIST_COMMAND` listener and
+ * the expected keyboard and mouse interactions for checkboxes.
  */
 const CheckListExtension = lexical.defineExtension({
   build: (editor, config) => extension.namedSignals(config),
@@ -1854,6 +1833,213 @@ const CheckListExtension = lexical.defineExtension({
   register: (editor, config, state) => registerCheckList(editor, state.getOutput())
 });
 
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+
+/**
+ * Mirrors the legacy `isDomChecklist` heuristic from
+ * `@lexical/list`.
+ */
+function isDomChecklist(domNode) {
+  return domNode.matches('[__lexicallisttype="check"], .contains-task-list, [data-is-checklist="1"]') || domNode.querySelector(':scope > [aria-checked]') !== null;
+}
+
+/**
+ * Lift nested `ListNode`s out of `ListItemNode`s into sibling
+ * `ListItemNode`s (the legacy `$normalizeChildren` shape). Also wraps any
+ * non-`ListItemNode` children in a new `ListItemNode`.
+ */
+function $normalizeListChildren(children) {
+  const out = [];
+  for (const child of children) {
+    if ($isListItemNode(child)) {
+      out.push(child);
+      const innerChildren = child.getChildren();
+      if (innerChildren.length > 1) {
+        for (const inner of innerChildren) {
+          if ($isListNode(inner)) {
+            out.push($createListItemNode().append(inner));
+          }
+        }
+      }
+    } else {
+      out.push($createListItemNode().append(child));
+    }
+  }
+  return out;
+}
+const ListRule = html.defineImportRule({
+  $import: (ctx, el) => {
+    let node;
+    if (html.isElementOfTag(el, 'ol')) {
+      node = $createListNode('number', el.start);
+    } else if (isDomChecklist(el)) {
+      node = $createListNode('check');
+    } else {
+      node = $createListNode('bullet');
+    }
+    lexical.$setDirectionFromDOM(node, el);
+    return [node.splice(0, 0, $normalizeListChildren(ctx.$importChildren(el)))];
+  },
+  match: html.sel.tag('ol', 'ul'),
+  name: '@lexical/list/list'
+});
+
+/**
+ * Apply formatting from the first child paragraph of `<li>` to the list
+ * item itself, then unwrap that paragraph (Google Docs sets the alignment
+ * of the `<p>` inside the `<li>`). Mirrors the legacy
+ * `setFormatFromChildren`.
+ */
+function $liftFormatFromSingleParagraph(listItemNode, children) {
+  if (children.length !== 1) {
+    return children;
+  }
+  const firstChild = children[0];
+  if (lexical.$isParagraphNode(firstChild) && !listItemNode.getFormatType() && firstChild.getFormatType()) {
+    listItemNode.setFormat(firstChild.getFormatType());
+    return firstChild.getChildren();
+  }
+  return children;
+}
+const ListItemRule = html.defineImportRule({
+  $import: (ctx, el) => {
+    const ariaChecked = el.getAttribute('aria-checked');
+    const checked = ariaChecked === 'true' ? true : ariaChecked === 'false' ? false : undefined;
+    const node = $createListItemNode(checked);
+    lexical.$setFormatFromDOM(node, el);
+    lexical.$setDirectionFromDOM(node, el);
+    return [node.splice(0, 0, $liftFormatFromSingleParagraph(node, ctx.$importChildren(el)))];
+  },
+  match: html.sel.tag('li'),
+  name: '@lexical/list/li'
+});
+function $buildChecklistItem(ctx, el, checkboxOwner) {
+  const checkboxInput = html.isElementOfTag(checkboxOwner, 'input') ? checkboxOwner : checkboxOwner.querySelector('input[type="checkbox"]');
+  if (!checkboxInput || checkboxInput.getAttribute('type') !== 'checkbox') {
+    return [];
+  }
+  const checked = checkboxInput.hasAttribute('checked');
+  const node = $createListItemNode(checked);
+  lexical.$setFormatFromDOM(node, el);
+  lexical.$setDirectionFromDOM(node, el);
+  return [node.splice(0, 0, $liftFormatFromSingleParagraph(node, ctx.$importChildren(el)))];
+}
+const TaskListItemRule = html.defineImportRule({
+  $import: (ctx, el, $next) => {
+    const input = el.querySelector(':scope > input[type="checkbox"]');
+    if (!input) {
+      return $next();
+    }
+    return $buildChecklistItem(ctx, el, input);
+  },
+  match: html.sel.tag('li').classAll('task-list-item'),
+  name: '@lexical/list/li-task-list-item'
+});
+const JoplinChecklistItemRule = html.defineImportRule({
+  $import: (ctx, el, $next) => {
+    const wrapper = el.querySelector(':scope > .checkbox-wrapper');
+    if (!wrapper) {
+      return $next();
+    }
+    const input = wrapper.querySelector(':scope > input[type="checkbox"]');
+    if (!input) {
+      return $next();
+    }
+    return $buildChecklistItem(ctx, el, input);
+  },
+  match: html.sel.tag('li').classAll('joplin-checkbox'),
+  name: '@lexical/list/li-joplin-checkbox'
+});
+
+/**
+ * A {@link ChildSchema} that enforces ListNode invariants: only
+ * `ListItemNode` and (immediately-nested) `ListNode` children are
+ * accepted; runs of other children get wrapped in a fresh
+ * `ListItemNode`.
+ *
+ * @experimental
+ */
+const ListSchema = {
+  $accepts: child => $isListItemNode(child) || $isListNode(child),
+  // Inline runs inside a `<ul>`/`<ol>` (e.g. text between two `<li>`s)
+  // become the children of a synthetic `ListItemNode`. `ListItemNode`
+  // is itself a block-level container of inlines, so no intermediate
+  // `ParagraphNode` is needed (and the demoted-paragraph normalization
+  // would strip one anyway).
+  $packageRun: run => [$createListItemNode().splice(0, 0, run)],
+  name: 'ListSchema'
+};
+
+/**
+ * Import rules for {@link ListNode} and {@link ListItemNode}, including
+ * GitHub task-list and Joplin checkbox heuristics.
+ *
+ * @experimental
+ */
+const ListImportRules = [
+// More specific rules (class-restricted) must precede the generic `li`
+// rule so they win the dispatch race (lower array index = higher
+// priority).
+TaskListItemRule, JoplinChecklistItemRule, ListRule, ListItemRule];
+
+/**
+ * Bundles {@link ListImportRules} (plus {@link CoreImportExtension}) into
+ * a single dependency.
+ *
+ * @experimental
+ */
+const ListImportExtension = lexical.defineExtension({
+  dependencies: [html.CoreImportExtension, ListExtension, lexical.configExtension(html.DOMImportExtension, {
+    rules: ListImportRules
+  })],
+  name: '@lexical/list/Import'
+});
+
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+
+/**
+ * @deprecated use {@link $insertList} from an update or command listener.
+ *
+ * Inserts a new ListNode. If the selection's anchor node is an empty ListItemNode and is a child of
+ * the root/shadow root, it will replace the ListItemNode with a ListNode and the old ListItemNode.
+ * Otherwise it will replace its parent with a new ListNode and re-insert the ListItemNode and any previous children.
+ * If the selection's anchor node is not an empty ListItemNode, it will add a new ListNode or merge an existing ListNode,
+ * unless the the node is a leaf node, in which case it will attempt to find a ListNode up the branch and replace it with
+ * a new ListNode, or create a new ListNode at the nearest root/shadow root.
+ * @param editor - The lexical editor.
+ * @param listType - The type of list, "number" | "bullet" | "check".
+ */
+function insertList(editor, listType) {
+  editor.update(() => $insertList(listType));
+}
+
+/**
+ * @deprecated use {@link $removeList} from an update or command listener.
+ *
+ * Searches for the nearest ancestral ListNode and removes it. If selection is an empty ListItemNode
+ * it will remove the whole list, including the ListItemNode. For each ListItemNode in the ListNode,
+ * removeList will also generate new ParagraphNodes in the removed ListNode's place. Any child node
+ * inside a ListItemNode will be appended to the new ParagraphNodes.
+ * @param editor - The lexical editor.
+ */
+function removeList(editor) {
+  editor.update(() => $removeList());
+}
+
 exports.$createListItemNode = $createListItemNode;
 exports.$createListNode = $createListNode;
 exports.$getListDepth = $getListDepth;
@@ -1867,8 +2053,11 @@ exports.INSERT_CHECK_LIST_COMMAND = INSERT_CHECK_LIST_COMMAND;
 exports.INSERT_ORDERED_LIST_COMMAND = INSERT_ORDERED_LIST_COMMAND;
 exports.INSERT_UNORDERED_LIST_COMMAND = INSERT_UNORDERED_LIST_COMMAND;
 exports.ListExtension = ListExtension;
+exports.ListImportExtension = ListImportExtension;
+exports.ListImportRules = ListImportRules;
 exports.ListItemNode = ListItemNode;
 exports.ListNode = ListNode;
+exports.ListSchema = ListSchema;
 exports.REMOVE_LIST_COMMAND = REMOVE_LIST_COMMAND;
 exports.UPDATE_LIST_START_COMMAND = UPDATE_LIST_START_COMMAND;
 exports.insertList = insertList;

package/{LexicalList.dev.mjs → dist/LexicalList.dev.mjs}

@@ -6,9 +6,10 @@
  *
  */
 
-import { effect, namedSignals } from '@lexical/extension';
 import { $getNearestNodeOfType, $insertNodeToNearestRootAtCaret, removeClassNamesFromElement, addClassNamesToElement, isHTMLElement as isHTMLElement$1, mergeRegister, $findMatchingParent, calculateZoomLevel } from '@lexical/utils';
-import { $copyNode, $getSelection, $isRangeSelection, $isRootOrShadowRoot, $createParagraphNode, $isElementNode, $isLeafNode, $setPointFromCaret, $normalizeCaret, $getChildCaret, $isTextNode, ElementNode, buildImportMap, $getSiblingCaret, $rewindSiblingCaret, setDOMStyleFromCSS, isHTMLElement, $isParagraphNode, $applyNodeReplacement, $setFormatFromDOM, $setDirectionFromDOM, normalizeClassNames, getStyleObjectFromCSS, $createTextNode, COMMAND_PRIORITY_LOW, KEY_ARROW_DOWN_COMMAND, KEY_ARROW_UP_COMMAND, KEY_ESCAPE_COMMAND, KEY_SPACE_COMMAND, $getNearestNodeFromDOMNode, KEY_ARROW_LEFT_COMMAND, createCommand, getNearestEditorFromDOMNode, $addUpdateTag, SKIP_SELECTION_FOCUS_TAG, SKIP_DOM_SELECTION_TAG, defineExtension, safeCast, $getNodeByKey, INSERT_PARAGRAPH_COMMAND, TextNode } from 'lexical';
+import { $getSelection, $isRangeSelection, $isTextNode, $isRootOrShadowRoot, $createParagraphNode, $copyNode, $isElementNode, $isLeafNode, $setPointFromCaret, $normalizeCaret, $getChildCaret, $applyNodeReplacement, ElementNode, buildImportMap, $getSiblingCaret, $rewindSiblingCaret, setDOMStyleFromCSS, isHTMLElement, $isParagraphNode, $setFormatFromDOM, $setDirectionFromDOM, normalizeClassNames, getStyleObjectFromCSS, $createTextNode, createCommand, COMMAND_PRIORITY_LOW, KEY_ARROW_DOWN_COMMAND, KEY_ARROW_UP_COMMAND, KEY_ESCAPE_COMMAND, KEY_SPACE_COMMAND, $getNearestNodeFromDOMNode, KEY_ARROW_LEFT_COMMAND, getNearestEditorFromDOMNode, $addUpdateTag, SKIP_SELECTION_FOCUS_TAG, SKIP_DOM_SELECTION_TAG, $getNodeByKey, INSERT_PARAGRAPH_COMMAND, TextNode, defineExtension, safeCast, configExtension } from 'lexical';
+import { namedSignals, effect } from '@lexical/extension';
+import { CoreImportExtension, DOMImportExtension, defineImportRule, sel, isElementOfTag } from '@lexical/html';
 
 /**
  * Copyright (c) Meta Platforms, Inc. and affiliates.
@@ -1293,7 +1294,7 @@ function $normalizeChildren(nodes, listNode) {
   }
   return normalizedListItems;
 }
-function isDomChecklist(domNode) {
+function isDomChecklist$1(domNode) {
   if (domNode.getAttribute('__lexicallisttype') === 'check' ||
   // is github checklist
   domNode.classList.contains('contains-task-list') ||
@@ -1317,7 +1318,7 @@ function $convertListNode(domNode) {
   if (isHTMLOListElement(domNode)) {
     const start = domNode.start;
     node = $createListNode('number', start);
-  } else if (isDomChecklist(domNode)) {
+  } else if (isDomChecklist$1(domNode)) {
     node = $createListNode('check');
   } else {
     node = $createListNode('bullet');
@@ -1785,33 +1786,13 @@ function $findChildrenEndListItemNode(listItemNode) {
 }
 
 /**
- * @deprecated use {@link $insertList} from an update or command listener.
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
  *
- * Inserts a new ListNode. If the selection's anchor node is an empty ListItemNode and is a child of
- * the root/shadow root, it will replace the ListItemNode with a ListNode and the old ListItemNode.
- * Otherwise it will replace its parent with a new ListNode and re-insert the ListItemNode and any previous children.
- * If the selection's anchor node is not an empty ListItemNode, it will add a new ListNode or merge an existing ListNode,
- * unless the the node is a leaf node, in which case it will attempt to find a ListNode up the branch and replace it with
- * a new ListNode, or create a new ListNode at the nearest root/shadow root.
- * @param editor - The lexical editor.
- * @param listType - The type of list, "number" | "bullet" | "check".
- */
-function insertList(editor, listType) {
-  editor.update(() => $insertList(listType));
-}
-
-/**
- * @deprecated use {@link $removeList} from an update or command listener.
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
  *
- * Searches for the nearest ancestral ListNode and removes it. If selection is an empty ListItemNode
- * it will remove the whole list, including the ListItemNode. For each ListItemNode in the ListNode,
- * removeList will also generate new ParagraphNodes in the removed ListNode's place. Any child node
- * inside a ListItemNode will be appended to the new ParagraphNodes.
- * @param editor - The lexical editor.
  */
-function removeList(editor) {
-  editor.update(() => $removeList());
-}
+
 /**
  * Configures {@link ListNode}, {@link ListItemNode} and registers
  * the strict indent transform if `hasStrictIndent` is true (default false).
@@ -1837,10 +1818,8 @@ const ListExtension = defineExtension({
 });
 /**
  * Registers checklist functionality for {@link ListNode} and
- * {@link ListItemNode} with a
- * {@link INSERT_CHECK_LIST_COMMAND} listener and
- * the expected keyboard and mouse interactions for
- * checkboxes.
+ * {@link ListItemNode} with a `INSERT_CHECK_LIST_COMMAND` listener and
+ * the expected keyboard and mouse interactions for checkboxes.
  */
 const CheckListExtension = defineExtension({
   build: (editor, config) => namedSignals(config),
@@ -1852,4 +1831,211 @@ const CheckListExtension = defineExtension({
   register: (editor, config, state) => registerCheckList(editor, state.getOutput())
 });
 
-export { $createListItemNode, $createListNode, $getListDepth, $handleListInsertParagraph, $insertList, $isListItemNode, $isListNode, $removeList, CheckListExtension, INSERT_CHECK_LIST_COMMAND, INSERT_ORDERED_LIST_COMMAND, INSERT_UNORDERED_LIST_COMMAND, ListExtension, ListItemNode, ListNode, REMOVE_LIST_COMMAND, UPDATE_LIST_START_COMMAND, insertList, registerCheckList, registerList, registerListStrictIndentTransform, removeList };
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+
+/**
+ * Mirrors the legacy `isDomChecklist` heuristic from
+ * `@lexical/list`.
+ */
+function isDomChecklist(domNode) {
+  return domNode.matches('[__lexicallisttype="check"], .contains-task-list, [data-is-checklist="1"]') || domNode.querySelector(':scope > [aria-checked]') !== null;
+}
+
+/**
+ * Lift nested `ListNode`s out of `ListItemNode`s into sibling
+ * `ListItemNode`s (the legacy `$normalizeChildren` shape). Also wraps any
+ * non-`ListItemNode` children in a new `ListItemNode`.
+ */
+function $normalizeListChildren(children) {
+  const out = [];
+  for (const child of children) {
+    if ($isListItemNode(child)) {
+      out.push(child);
+      const innerChildren = child.getChildren();
+      if (innerChildren.length > 1) {
+        for (const inner of innerChildren) {
+          if ($isListNode(inner)) {
+            out.push($createListItemNode().append(inner));
+          }
+        }
+      }
+    } else {
+      out.push($createListItemNode().append(child));
+    }
+  }
+  return out;
+}
+const ListRule = defineImportRule({
+  $import: (ctx, el) => {
+    let node;
+    if (isElementOfTag(el, 'ol')) {
+      node = $createListNode('number', el.start);
+    } else if (isDomChecklist(el)) {
+      node = $createListNode('check');
+    } else {
+      node = $createListNode('bullet');
+    }
+    $setDirectionFromDOM(node, el);
+    return [node.splice(0, 0, $normalizeListChildren(ctx.$importChildren(el)))];
+  },
+  match: sel.tag('ol', 'ul'),
+  name: '@lexical/list/list'
+});
+
+/**
+ * Apply formatting from the first child paragraph of `<li>` to the list
+ * item itself, then unwrap that paragraph (Google Docs sets the alignment
+ * of the `<p>` inside the `<li>`). Mirrors the legacy
+ * `setFormatFromChildren`.
+ */
+function $liftFormatFromSingleParagraph(listItemNode, children) {
+  if (children.length !== 1) {
+    return children;
+  }
+  const firstChild = children[0];
+  if ($isParagraphNode(firstChild) && !listItemNode.getFormatType() && firstChild.getFormatType()) {
+    listItemNode.setFormat(firstChild.getFormatType());
+    return firstChild.getChildren();
+  }
+  return children;
+}
+const ListItemRule = defineImportRule({
+  $import: (ctx, el) => {
+    const ariaChecked = el.getAttribute('aria-checked');
+    const checked = ariaChecked === 'true' ? true : ariaChecked === 'false' ? false : undefined;
+    const node = $createListItemNode(checked);
+    $setFormatFromDOM(node, el);
+    $setDirectionFromDOM(node, el);
+    return [node.splice(0, 0, $liftFormatFromSingleParagraph(node, ctx.$importChildren(el)))];
+  },
+  match: sel.tag('li'),
+  name: '@lexical/list/li'
+});
+function $buildChecklistItem(ctx, el, checkboxOwner) {
+  const checkboxInput = isElementOfTag(checkboxOwner, 'input') ? checkboxOwner : checkboxOwner.querySelector('input[type="checkbox"]');
+  if (!checkboxInput || checkboxInput.getAttribute('type') !== 'checkbox') {
+    return [];
+  }
+  const checked = checkboxInput.hasAttribute('checked');
+  const node = $createListItemNode(checked);
+  $setFormatFromDOM(node, el);
+  $setDirectionFromDOM(node, el);
+  return [node.splice(0, 0, $liftFormatFromSingleParagraph(node, ctx.$importChildren(el)))];
+}
+const TaskListItemRule = defineImportRule({
+  $import: (ctx, el, $next) => {
+    const input = el.querySelector(':scope > input[type="checkbox"]');
+    if (!input) {
+      return $next();
+    }
+    return $buildChecklistItem(ctx, el, input);
+  },
+  match: sel.tag('li').classAll('task-list-item'),
+  name: '@lexical/list/li-task-list-item'
+});
+const JoplinChecklistItemRule = defineImportRule({
+  $import: (ctx, el, $next) => {
+    const wrapper = el.querySelector(':scope > .checkbox-wrapper');
+    if (!wrapper) {
+      return $next();
+    }
+    const input = wrapper.querySelector(':scope > input[type="checkbox"]');
+    if (!input) {
+      return $next();
+    }
+    return $buildChecklistItem(ctx, el, input);
+  },
+  match: sel.tag('li').classAll('joplin-checkbox'),
+  name: '@lexical/list/li-joplin-checkbox'
+});
+
+/**
+ * A {@link ChildSchema} that enforces ListNode invariants: only
+ * `ListItemNode` and (immediately-nested) `ListNode` children are
+ * accepted; runs of other children get wrapped in a fresh
+ * `ListItemNode`.
+ *
+ * @experimental
+ */
+const ListSchema = {
+  $accepts: child => $isListItemNode(child) || $isListNode(child),
+  // Inline runs inside a `<ul>`/`<ol>` (e.g. text between two `<li>`s)
+  // become the children of a synthetic `ListItemNode`. `ListItemNode`
+  // is itself a block-level container of inlines, so no intermediate
+  // `ParagraphNode` is needed (and the demoted-paragraph normalization
+  // would strip one anyway).
+  $packageRun: run => [$createListItemNode().splice(0, 0, run)],
+  name: 'ListSchema'
+};
+
+/**
+ * Import rules for {@link ListNode} and {@link ListItemNode}, including
+ * GitHub task-list and Joplin checkbox heuristics.
+ *
+ * @experimental
+ */
+const ListImportRules = [
+// More specific rules (class-restricted) must precede the generic `li`
+// rule so they win the dispatch race (lower array index = higher
+// priority).
+TaskListItemRule, JoplinChecklistItemRule, ListRule, ListItemRule];
+
+/**
+ * Bundles {@link ListImportRules} (plus {@link CoreImportExtension}) into
+ * a single dependency.
+ *
+ * @experimental
+ */
+const ListImportExtension = defineExtension({
+  dependencies: [CoreImportExtension, ListExtension, configExtension(DOMImportExtension, {
+    rules: ListImportRules
+  })],
+  name: '@lexical/list/Import'
+});
+
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+
+/**
+ * @deprecated use {@link $insertList} from an update or command listener.
+ *
+ * Inserts a new ListNode. If the selection's anchor node is an empty ListItemNode and is a child of
+ * the root/shadow root, it will replace the ListItemNode with a ListNode and the old ListItemNode.
+ * Otherwise it will replace its parent with a new ListNode and re-insert the ListItemNode and any previous children.
+ * If the selection's anchor node is not an empty ListItemNode, it will add a new ListNode or merge an existing ListNode,
+ * unless the the node is a leaf node, in which case it will attempt to find a ListNode up the branch and replace it with
+ * a new ListNode, or create a new ListNode at the nearest root/shadow root.
+ * @param editor - The lexical editor.
+ * @param listType - The type of list, "number" | "bullet" | "check".
+ */
+function insertList(editor, listType) {
+  editor.update(() => $insertList(listType));
+}
+
+/**
+ * @deprecated use {@link $removeList} from an update or command listener.
+ *
+ * Searches for the nearest ancestral ListNode and removes it. If selection is an empty ListItemNode
+ * it will remove the whole list, including the ListItemNode. For each ListItemNode in the ListNode,
+ * removeList will also generate new ParagraphNodes in the removed ListNode's place. Any child node
+ * inside a ListItemNode will be appended to the new ParagraphNodes.
+ * @param editor - The lexical editor.
+ */
+function removeList(editor) {
+  editor.update(() => $removeList());
+}
+
+export { $createListItemNode, $createListNode, $getListDepth, $handleListInsertParagraph, $insertList, $isListItemNode, $isListNode, $removeList, CheckListExtension, INSERT_CHECK_LIST_COMMAND, INSERT_ORDERED_LIST_COMMAND, INSERT_UNORDERED_LIST_COMMAND, ListExtension, ListImportExtension, ListImportRules, ListItemNode, ListNode, ListSchema, REMOVE_LIST_COMMAND, UPDATE_LIST_START_COMMAND, insertList, registerCheckList, registerList, registerListStrictIndentTransform, removeList };

package/{LexicalList.mjs → dist/LexicalList.mjs}

@@ -22,8 +22,11 @@ export const INSERT_CHECK_LIST_COMMAND = mod.INSERT_CHECK_LIST_COMMAND;
 export const INSERT_ORDERED_LIST_COMMAND = mod.INSERT_ORDERED_LIST_COMMAND;
 export const INSERT_UNORDERED_LIST_COMMAND = mod.INSERT_UNORDERED_LIST_COMMAND;
 export const ListExtension = mod.ListExtension;
+export const ListImportExtension = mod.ListImportExtension;
+export const ListImportRules = mod.ListImportRules;
 export const ListItemNode = mod.ListItemNode;
 export const ListNode = mod.ListNode;
+export const ListSchema = mod.ListSchema;
 export const REMOVE_LIST_COMMAND = mod.REMOVE_LIST_COMMAND;
 export const UPDATE_LIST_START_COMMAND = mod.UPDATE_LIST_START_COMMAND;
 export const insertList = mod.insertList;

package/{LexicalList.node.mjs → dist/LexicalList.node.mjs}

@@ -20,8 +20,11 @@ export const INSERT_CHECK_LIST_COMMAND = mod.INSERT_CHECK_LIST_COMMAND;
 export const INSERT_ORDERED_LIST_COMMAND = mod.INSERT_ORDERED_LIST_COMMAND;
 export const INSERT_UNORDERED_LIST_COMMAND = mod.INSERT_UNORDERED_LIST_COMMAND;
 export const ListExtension = mod.ListExtension;
+export const ListImportExtension = mod.ListImportExtension;
+export const ListImportRules = mod.ListImportRules;
 export const ListItemNode = mod.ListItemNode;
 export const ListNode = mod.ListNode;
+export const ListSchema = mod.ListSchema;
 export const REMOVE_LIST_COMMAND = mod.REMOVE_LIST_COMMAND;
 export const UPDATE_LIST_START_COMMAND = mod.UPDATE_LIST_START_COMMAND;
 export const insertList = mod.insertList;