@domternal/core 0.7.5 → 0.8.0

package/dist/index.d.cts

@@ -2666,17 +2666,18 @@ interface InsertAsListItemChildArgs {
      * matching the Tab keyboard behaviour ("indent into last item").
      */
     targetItemPos?: number;
-    /** Block node to append as the LAST child of the target item. */
+    /** Block node to insert. */
     blockNode: Node$1;
-    /**
-     * Optional source range to delete in the SAME transaction (when
-     * MOVING an existing block instead of creating a new one). Position
-     * math handles source-before-vs-after-target ordering automatically.
-     */
+    /** Optional source range to delete in the same tr (turns insert into a MOVE). */
     sourceRange?: {
         from: number;
         to: number;
     };
+    /**
+     * Child index to insert at. Clamped to `>= 1` (index 0 is the label
+     * paragraph). Omitted or `>= childCount` appends as the last child.
+     */
+    childIndex?: number;
 }
 interface InsertAsListItemChildResult {
     /** True when schema accepted the insertion and `tr` was mutated. */
@@ -2689,11 +2690,10 @@ interface InsertAsListItemChildResult {
     insertedAt?: number;
 }
 /**
- * Insert `blockNode` as the LAST child of a list item (target item or, when
- * omitted, the wrapper's last item). When `sourceRange` is set, the source
- * range is removed in the same transaction so the op is a clean MOVE.
- * Returns `{ ok: false }` WITHOUT mutating `tr` on schema reject so callers
- * can fall through to a sibling-mode fallback.
+ * Insert `blockNode` into a list item's children at `childIndex` (default:
+ * append last; target item defaults to the wrapper's last item). `sourceRange`
+ * makes it a MOVE. Returns `{ ok: false }` without mutating `tr` on schema
+ * reject or self-drop so callers can fall back to a sibling move.
  */
 declare function insertAsListItemChild(args: InsertAsListItemChildArgs): InsertAsListItemChildResult;
 

package/dist/index.d.ts

@@ -2666,17 +2666,18 @@ interface InsertAsListItemChildArgs {
      * matching the Tab keyboard behaviour ("indent into last item").
      */
     targetItemPos?: number;
-    /** Block node to append as the LAST child of the target item. */
+    /** Block node to insert. */
     blockNode: Node$1;
-    /**
-     * Optional source range to delete in the SAME transaction (when
-     * MOVING an existing block instead of creating a new one). Position
-     * math handles source-before-vs-after-target ordering automatically.
-     */
+    /** Optional source range to delete in the same tr (turns insert into a MOVE). */
     sourceRange?: {
         from: number;
         to: number;
     };
+    /**
+     * Child index to insert at. Clamped to `>= 1` (index 0 is the label
+     * paragraph). Omitted or `>= childCount` appends as the last child.
+     */
+    childIndex?: number;
 }
 interface InsertAsListItemChildResult {
     /** True when schema accepted the insertion and `tr` was mutated. */
@@ -2689,11 +2690,10 @@ interface InsertAsListItemChildResult {
     insertedAt?: number;
 }
 /**
- * Insert `blockNode` as the LAST child of a list item (target item or, when
- * omitted, the wrapper's last item). When `sourceRange` is set, the source
- * range is removed in the same transaction so the op is a clean MOVE.
- * Returns `{ ok: false }` WITHOUT mutating `tr` on schema reject so callers
- * can fall through to a sibling-mode fallback.
+ * Insert `blockNode` into a list item's children at `childIndex` (default:
+ * append last; target item defaults to the wrapper's last item). `sourceRange`
+ * makes it a MOVE. Returns `{ ok: false }` without mutating `tr` on schema
+ * reject or self-drop so callers can fall back to a sibling move.
  */
 declare function insertAsListItemChild(args: InsertAsListItemChildArgs): InsertAsListItemChildResult;
 

package/dist/index.js

@@ -4131,7 +4131,7 @@ function defaultBubbleContexts(editor) {
 var LIST_ITEM_TYPES3 = /* @__PURE__ */ new Set(["listItem", "taskItem"]);
 var LIST_WRAPPER_TYPES = /* @__PURE__ */ new Set(["bulletList", "orderedList", "taskList"]);
 function insertAsListItemChild(args) {
-  const { tr, wrapperPos, targetItemPos, blockNode, sourceRange } = args;
+  const { tr, wrapperPos, targetItemPos, blockNode, sourceRange, childIndex } = args;
   if (wrapperPos < 0 || wrapperPos >= tr.doc.content.size) return { ok: false };
   const wrapper = tr.doc.nodeAt(wrapperPos);
   if (!wrapper || !LIST_WRAPPER_TYPES.has(wrapper.type.name)) return { ok: false };
@@ -4157,22 +4157,25 @@ function insertAsListItemChild(args) {
     targetItem = last;
     targetItemStart = pos;
   }
-  if (!targetItem.canReplaceWith(targetItem.childCount, targetItem.childCount, blockNode.type)) {
+  const childCount = targetItem.childCount;
+  const insertIndex = childIndex === void 0 || childIndex >= childCount ? childCount : Math.max(1, childIndex);
+  if (!targetItem.canReplaceWith(insertIndex, insertIndex, blockNode.type)) {
     return { ok: false };
   }
-  const targetItemContentEnd = targetItemStart + targetItem.nodeSize - 1;
+  const $item = tr.doc.resolve(targetItemStart + 1);
+  const insertPos = $item.posAtIndex(insertIndex, $item.depth);
   if (sourceRange) {
     const { from, to } = sourceRange;
-    if (targetItemContentEnd >= from && targetItemContentEnd <= to) {
+    if (insertPos >= from && insertPos <= to) {
       return { ok: false };
     }
     tr.delete(from, to);
-    const adjustedInsertPos = targetItemContentEnd > from ? targetItemContentEnd - (to - from) : targetItemContentEnd;
+    const adjustedInsertPos = insertPos > from ? insertPos - (to - from) : insertPos;
     tr.insert(adjustedInsertPos, blockNode);
     return { ok: true, insertedAt: adjustedInsertPos };
   }
-  tr.insert(targetItemContentEnd, blockNode);
-  return { ok: true, insertedAt: targetItemContentEnd };
+  tr.insert(insertPos, blockNode);
+  return { ok: true, insertedAt: insertPos };
 }
 function liftEmptyChildrenZoneParagraph(state, dispatch, ctx) {
   if (!ctx.isInChildrenZone || !ctx.paragraphIsEmpty) return false;