list tool improvements

apps/docs/document-api/available-operations.mdx

@@ -32,7 +32,7 @@ Use the tables below to see what operations are available and where each one is
 | Hyperlinks | 6 | 0 | 6 | [Reference](/document-api/reference/hyperlinks/index) |
 | Images | 27 | 0 | 27 | [Reference](/document-api/reference/images/index) |
 | Index | 11 | 0 | 11 | [Reference](/document-api/reference/index/index) |
-| Lists | 36 | 0 | 36 | [Reference](/document-api/reference/lists/index) |
+| Lists | 38 | 0 | 38 | [Reference](/document-api/reference/lists/index) |
 | Mutations | 2 | 0 | 2 | [Reference](/document-api/reference/mutations/index) |
 | Paragraph Formatting | 19 | 0 | 19 | [Reference](/document-api/reference/format/paragraph/index) |
 | Paragraph Styles | 2 | 0 | 2 | [Reference](/document-api/reference/styles/paragraph/index) |
@@ -291,6 +291,8 @@ Use the tables below to see what operations are available and where each one is
 | <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><code>editor.doc.lists.join(...)</code></span> | [`lists.join`](/document-api/reference/lists/join) |
 | <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><code>editor.doc.lists.canJoin(...)</code></span> | [`lists.canJoin`](/document-api/reference/lists/can-join) |
 | <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><code>editor.doc.lists.separate(...)</code></span> | [`lists.separate`](/document-api/reference/lists/separate) |
+| <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><code>editor.doc.lists.merge(...)</code></span> | [`lists.merge`](/document-api/reference/lists/merge) |
+| <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><code>editor.doc.lists.split(...)</code></span> | [`lists.split`](/document-api/reference/lists/split) |
 | <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><code>editor.doc.lists.setLevel(...)</code></span> | [`lists.setLevel`](/document-api/reference/lists/set-level) |
 | <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><code>editor.doc.lists.setValue(...)</code></span> | [`lists.setValue`](/document-api/reference/lists/set-value) |
 | <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><code>editor.doc.lists.continuePrevious(...)</code></span> | [`lists.continuePrevious`](/document-api/reference/lists/continue-previous) |

apps/docs/document-api/reference/_generated-manifest.json

@@ -299,6 +299,7 @@
     "apps/docs/document-api/reference/lists/insert.mdx",
     "apps/docs/document-api/reference/lists/join.mdx",
     "apps/docs/document-api/reference/lists/list.mdx",
+    "apps/docs/document-api/reference/lists/merge.mdx",
     "apps/docs/document-api/reference/lists/outdent.mdx",
     "apps/docs/document-api/reference/lists/restart-at.mdx",
     "apps/docs/document-api/reference/lists/separate.mdx",
@@ -317,6 +318,7 @@
     "apps/docs/document-api/reference/lists/set-level.mdx",
     "apps/docs/document-api/reference/lists/set-type.mdx",
     "apps/docs/document-api/reference/lists/set-value.mdx",
+    "apps/docs/document-api/reference/lists/split.mdx",
     "apps/docs/document-api/reference/markdown-to-fragment.mdx",
     "apps/docs/document-api/reference/mutations/apply.mdx",
     "apps/docs/document-api/reference/mutations/index.mdx",
@@ -576,6 +578,8 @@
         "lists.join",
         "lists.canJoin",
         "lists.separate",
+        "lists.merge",
+        "lists.split",
         "lists.setLevel",
         "lists.setValue",
         "lists.continuePrevious",
@@ -1027,5 +1031,5 @@
     }
   ],
   "marker": "{/* GENERATED FILE: DO NOT EDIT. Regenerate via `pnpm run docapi:sync`. */}",
-  "sourceHash": "f5c0786256e77432e9b9a58bc2009e39e2e832f6b0b2b625ee6dbeb3a762bdd6"
+  "sourceHash": "0bb50c2977e652d32a4c3dd591c774e7d164c013b53f2c951de8573911ecdef6"
 }

apps/docs/document-api/reference/capabilities/get.mdx

@@ -1645,6 +1645,11 @@ _No fields._
 | `operations.lists.list.dryRun` | boolean | yes |  |
 | `operations.lists.list.reasons` | enum[] | no |  |
 | `operations.lists.list.tracked` | boolean | yes |  |
+| `operations.lists.merge` | object | yes |  |
+| `operations.lists.merge.available` | boolean | yes |  |
+| `operations.lists.merge.dryRun` | boolean | yes |  |
+| `operations.lists.merge.reasons` | enum[] | no |  |
+| `operations.lists.merge.tracked` | boolean | yes |  |
 | `operations.lists.outdent` | object | yes |  |
 | `operations.lists.outdent.available` | boolean | yes |  |
 | `operations.lists.outdent.dryRun` | boolean | yes |  |
@@ -1735,6 +1740,11 @@ _No fields._
 | `operations.lists.setValue.dryRun` | boolean | yes |  |
 | `operations.lists.setValue.reasons` | enum[] | no |  |
 | `operations.lists.setValue.tracked` | boolean | yes |  |
+| `operations.lists.split` | object | yes |  |
+| `operations.lists.split.available` | boolean | yes |  |
+| `operations.lists.split.dryRun` | boolean | yes |  |
+| `operations.lists.split.reasons` | enum[] | no |  |
+| `operations.lists.split.tracked` | boolean | yes |  |
 | `operations.markdownToFragment` | object | yes |  |
 | `operations.markdownToFragment.available` | boolean | yes |  |
 | `operations.markdownToFragment.dryRun` | boolean | yes |  |
@@ -3871,6 +3881,11 @@ _No fields._
       "dryRun": false,
       "tracked": false
     },
+    "lists.merge": {
+      "available": true,
+      "dryRun": true,
+      "tracked": false
+    },
     "lists.outdent": {
       "available": true,
       "dryRun": true,
@@ -3961,6 +3976,11 @@ _No fields._
       "dryRun": true,
       "tracked": false
     },
+    "lists.split": {
+      "available": true,
+      "dryRun": true,
+      "tracked": false
+    },
     "markdownToFragment": {
       "available": true,
       "dryRun": false,
@@ -15729,6 +15749,41 @@ _No fields._
           ],
           "type": "object"
         },
+        "lists.merge": {
+          "additionalProperties": false,
+          "properties": {
+            "available": {
+              "type": "boolean"
+            },
+            "dryRun": {
+              "type": "boolean"
+            },
+            "reasons": {
+              "items": {
+                "enum": [
+                  "COMMAND_UNAVAILABLE",
+                  "HELPER_UNAVAILABLE",
+                  "OPERATION_UNAVAILABLE",
+                  "TRACKED_MODE_UNAVAILABLE",
+                  "DRY_RUN_UNAVAILABLE",
+                  "NAMESPACE_UNAVAILABLE",
+                  "STYLES_PART_MISSING",
+                  "COLLABORATION_ACTIVE"
+                ]
+              },
+              "type": "array"
+            },
+            "tracked": {
+              "type": "boolean"
+            }
+          },
+          "required": [
+            "available",
+            "tracked",
+            "dryRun"
+          ],
+          "type": "object"
+        },
         "lists.outdent": {
           "additionalProperties": false,
           "properties": {
@@ -16359,6 +16414,41 @@ _No fields._
           ],
           "type": "object"
         },
+        "lists.split": {
+          "additionalProperties": false,
+          "properties": {
+            "available": {
+              "type": "boolean"
+            },
+            "dryRun": {
+              "type": "boolean"
+            },
+            "reasons": {
+              "items": {
+                "enum": [
+                  "COMMAND_UNAVAILABLE",
+                  "HELPER_UNAVAILABLE",
+                  "OPERATION_UNAVAILABLE",
+                  "TRACKED_MODE_UNAVAILABLE",
+                  "DRY_RUN_UNAVAILABLE",
+                  "NAMESPACE_UNAVAILABLE",
+                  "STYLES_PART_MISSING",
+                  "COLLABORATION_ACTIVE"
+                ]
+              },
+              "type": "array"
+            },
+            "tracked": {
+              "type": "boolean"
+            }
+          },
+          "required": [
+            "available",
+            "tracked",
+            "dryRun"
+          ],
+          "type": "object"
+        },
         "markdownToFragment": {
           "additionalProperties": false,
           "properties": {
@@ -19766,6 +19856,8 @@ _No fields._
         "lists.join",
         "lists.canJoin",
         "lists.separate",
+        "lists.merge",
+        "lists.split",
         "lists.setLevel",
         "lists.setValue",
         "lists.continuePrevious",

apps/docs/document-api/reference/history/get.mdx

@@ -1,14 +1,14 @@
 ---
 title: history.get
 sidebarTitle: history.get
-description: Query the current undo/redo history state of the active editor.
+description: Query the current undo/redo history state of the document.
 ---
 
 {/* GENERATED FILE: DO NOT EDIT. Regenerate via `pnpm run docapi:sync`. */}
 
 ## Summary
 
-Query the current undo/redo history state of the active editor.
+Query the current undo/redo history state of the document.
 
 - Operation ID: `history.get`
 - API member path: `editor.doc.history.get(...)`

apps/docs/document-api/reference/history/redo.mdx

@@ -1,14 +1,14 @@
 ---
 title: history.redo
 sidebarTitle: history.redo
-description: Redo the most recently undone action in the active editor.
+description: Redo the most recently undone action in the document.
 ---
 
 {/* GENERATED FILE: DO NOT EDIT. Regenerate via `pnpm run docapi:sync`. */}
 
 ## Summary
 
-Redo the most recently undone action in the active editor.
+Redo the most recently undone action in the document.
 
 - Operation ID: `history.redo`
 - API member path: `editor.doc.history.redo(...)`

apps/docs/document-api/reference/history/undo.mdx

@@ -1,14 +1,14 @@
 ---
 title: history.undo
 sidebarTitle: history.undo
-description: Undo the most recent history-safe mutation in the active editor.
+description: Undo the most recent history-safe mutation in the document.
 ---
 
 {/* GENERATED FILE: DO NOT EDIT. Regenerate via `pnpm run docapi:sync`. */}
 
 ## Summary
 
-Undo the most recent history-safe mutation in the active editor.
+Undo the most recent history-safe mutation in the document.
 
 - Operation ID: `history.undo`
 - API member path: `editor.doc.history.undo(...)`

apps/docs/document-api/reference/index.mdx

@@ -26,7 +26,7 @@ This reference is sourced from `packages/document-api/src/contract/*`.
 | Sections | 18 | 0 | 18 | [Open](/document-api/reference/sections/index) |
 | Format | 44 | 1 | 45 | [Open](/document-api/reference/format/index) |
 | Styles | 1 | 0 | 1 | [Open](/document-api/reference/styles/index) |
-| Lists | 36 | 0 | 36 | [Open](/document-api/reference/lists/index) |
+| Lists | 38 | 0 | 38 | [Open](/document-api/reference/lists/index) |
 | Comments | 5 | 0 | 5 | [Open](/document-api/reference/comments/index) |
 | Track Changes | 3 | 0 | 3 | [Open](/document-api/reference/track-changes/index) |
 | Query | 1 | 0 | 1 | [Open](/document-api/reference/query/index) |
@@ -196,6 +196,8 @@ The tables below are grouped by namespace.
 | <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/join"><code>lists.join</code></a></span> | <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><code>editor.doc.lists.join(...)</code></span> | Merge two adjacent list sequences into one. |
 | <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/can-join"><code>lists.canJoin</code></a></span> | <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><code>editor.doc.lists.canJoin(...)</code></span> | Check whether two adjacent list sequences can be joined. |
 | <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/separate"><code>lists.separate</code></a></span> | <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><code>editor.doc.lists.separate(...)</code></span> | Split a list sequence at the target item, creating a new sequence from that point forward. |
+| <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/merge"><code>lists.merge</code></a></span> | <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><code>editor.doc.lists.merge(...)</code></span> | Compound: merge two adjacent list sequences into one. Reassigns numId on the absorbed sequence (no strict abstractNumId check — absorbed items adopt the absorbing definition) and deletes empty paragraphs between the two sequences. Use this instead of lists.join for the user-facing "merge these lists" intent. |
+| <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/split"><code>lists.split</code></a></span> | <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><code>editor.doc.lists.split(...)</code></span> | Compound: split a list sequence at the target item into two independent sequences. Runs lists.separate then (by default) lists.setValue(1) so the new half starts numbering fresh at 1. Pass restartNumbering:false for raw separate semantics (new half continues the previous count). |
 | <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/set-level"><code>lists.setLevel</code></a></span> | <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><code>editor.doc.lists.setLevel(...)</code></span> | Set the absolute nesting level (0..8) of a list item. |
 | <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/set-value"><code>lists.setValue</code></a></span> | <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><code>editor.doc.lists.setValue(...)</code></span> | Set an explicit numbering value at the target item. Mid-sequence targets are atomically separated first. |
 | <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/continue-previous"><code>lists.continuePrevious</code></a></span> | <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><code>editor.doc.lists.continuePrevious(...)</code></span> | Continue numbering from the nearest compatible previous list sequence. |
@@ -338,9 +340,9 @@ The tables below are grouped by namespace.
 
 | Operation | API member path | Description |
 | --- | --- | --- |
-| <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/history/get"><code>history.get</code></a></span> | <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><code>editor.doc.history.get(...)</code></span> | Query the current undo/redo history state of the active editor. |
-| <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/history/undo"><code>history.undo</code></a></span> | <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><code>editor.doc.history.undo(...)</code></span> | Undo the most recent history-safe mutation in the active editor. |
-| <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/history/redo"><code>history.redo</code></a></span> | <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><code>editor.doc.history.redo(...)</code></span> | Redo the most recently undone action in the active editor. |
+| <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/history/get"><code>history.get</code></a></span> | <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><code>editor.doc.history.get(...)</code></span> | Query the current undo/redo history state of the document. |
+| <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/history/undo"><code>history.undo</code></a></span> | <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><code>editor.doc.history.undo(...)</code></span> | Undo the most recent history-safe mutation in the document. |
+| <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/history/redo"><code>history.redo</code></a></span> | <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><code>editor.doc.history.redo(...)</code></span> | Redo the most recently undone action in the document. |
 
 #### Table of Contents
 

apps/docs/document-api/reference/lists/index.mdx

@@ -23,6 +23,8 @@ List inspection and list mutations.
 | <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/join"><code>lists.join</code></a></span> | `lists.join` | Yes | `conditional` | No | Yes |
 | <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/can-join"><code>lists.canJoin</code></a></span> | `lists.canJoin` | No | `idempotent` | No | No |
 | <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/separate"><code>lists.separate</code></a></span> | `lists.separate` | Yes | `conditional` | No | Yes |
+| <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/merge"><code>lists.merge</code></a></span> | `lists.merge` | Yes | `conditional` | No | Yes |
+| <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/split"><code>lists.split</code></a></span> | `lists.split` | Yes | `conditional` | No | Yes |
 | <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/set-level"><code>lists.setLevel</code></a></span> | `lists.setLevel` | Yes | `conditional` | No | Yes |
 | <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/set-value"><code>lists.setValue</code></a></span> | `lists.setValue` | Yes | `conditional` | No | Yes |
 | <span style={{ whiteSpace: 'nowrap', wordBreak: 'normal', overflowWrap: 'normal' }}><a href="/document-api/reference/lists/continue-previous"><code>lists.continuePrevious</code></a></span> | `lists.continuePrevious` | Yes | `conditional` | No | Yes |