prosemirror-transform 1.10.5 → 1.11.0

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## 1.11.0 (2026-01-21)
+
+### New features
+
+The new `Tranform.changedRange` method gives you a document range that includes all changes made by the transform/transaction.
+
 ## 1.10.5 (2025-11-11)
 
 ### Bug fixes

package/dist/index.cjs

@@ -1691,6 +1691,27 @@ var Transform = function () {
     get: function get() {
       return this.steps.length > 0;
     }
+  }, {
+    key: "changedRange",
+    value: function changedRange() {
+      var from = 1e9,
+        to = -1e9;
+      for (var i = 0; i < this.mapping.maps.length; i++) {
+        var map = this.mapping.maps[i];
+        if (i) {
+          from = map.map(from, 1);
+          to = map.map(to, -1);
+        }
+        map.forEach(function (_f, _t, fromB, toB) {
+          from = Math.min(from, fromB);
+          to = Math.max(to, toB);
+        });
+      }
+      return from == 1e9 ? null : {
+        from: from,
+        to: to
+      };
+    }
   }, {
     key: "addStep",
     value: function addStep(step, doc) {

package/dist/index.d.cts

@@ -326,6 +326,16 @@ declare class Transform {
     */
     get docChanged(): boolean;
     /**
+    Return a single range, in post-transform document positions,
+    that covers all content changed by this transform. Returns null
+    if no replacements are made. Note that this will ignore changes
+    that add/remove marks without replacing the underlying content.
+    */
+    changedRange(): {
+        from: number;
+        to: number;
+    } | null;
+    /**
     Replace the part of the document between `from` and `to` with the
     given `slice`.
     */

package/dist/index.d.ts

@@ -326,6 +326,16 @@ declare class Transform {
     */
     get docChanged(): boolean;
     /**
+    Return a single range, in post-transform document positions,
+    that covers all content changed by this transform. Returns null
+    if no replacements are made. Note that this will ignore changes
+    that add/remove marks without replacing the underlying content.
+    */
+    changedRange(): {
+        from: number;
+        to: number;
+    } | null;
+    /**
     Replace the part of the document between `from` and `to` with the
     given `slice`.
     */

package/dist/index.js

@@ -1946,6 +1946,27 @@ class Transform {
         return this.steps.length > 0;
     }
     /**
+    Return a single range, in post-transform document positions,
+    that covers all content changed by this transform. Returns null
+    if no replacements are made. Note that this will ignore changes
+    that add/remove marks without replacing the underlying content.
+    */
+    changedRange() {
+        let from = 1e9, to = -1e9;
+        for (let i = 0; i < this.mapping.maps.length; i++) {
+            let map = this.mapping.maps[i];
+            if (i) {
+                from = map.map(from, 1);
+                to = map.map(to, -1);
+            }
+            map.forEach((_f, _t, fromB, toB) => {
+                from = Math.min(from, fromB);
+                to = Math.max(to, toB);
+            });
+        }
+        return from == 1e9 ? null : { from, to };
+    }
+    /**
     @internal
     */
     addStep(step, doc) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prosemirror-transform",
-  "version": "1.10.5",
+  "version": "1.11.0",
   "description": "ProseMirror document transformations",
   "type": "module",
   "main": "dist/index.cjs",

package/src/transform.ts

@@ -1,5 +1,4 @@
 import {Node, NodeType, Mark, MarkType, ContentMatch, Slice, Fragment, NodeRange, Attrs} from "prosemirror-model"
-
 import {Mapping} from "./map"
 import {Step} from "./step"
 import {addMark, removeMark, clearIncompatible} from "./mark"
@@ -66,6 +65,26 @@ export class Transform {
     return this.steps.length > 0
   }
 
+  /// Return a single range, in post-transform document positions,
+  /// that covers all content changed by this transform. Returns null
+  /// if no replacements are made. Note that this will ignore changes
+  /// that add/remove marks without replacing the underlying content.
+  changedRange() {
+    let from = 1e9, to = -1e9
+    for (let i = 0; i < this.mapping.maps.length; i++) {
+      let map = this.mapping.maps[i]
+      if (i) {
+        from = map.map(from, 1)
+        to = map.map(to, -1)
+      }
+      map.forEach((_f, _t, fromB, toB) => {
+        from = Math.min(from, fromB)
+        to = Math.max(to, toB)
+      })
+    }
+    return from == 1e9 ? null : {from, to}
+  }
+
   /// @internal
   addStep(step: Step, doc: Node) {
     this.docs.push(this.doc)
@@ -206,7 +225,7 @@ export class Transform {
     if (mark instanceof Mark) {
       if (mark.isInSet(node.marks)) this.step(new RemoveNodeMarkStep(pos, mark))
     } else {
-      let set = node.marks, found, steps: Step[] = []
+      let set = node.marks, found: Mark | undefined, steps: Step[] = []
       while (found = mark.isInSet(set)) {
         steps.push(new RemoveNodeMarkStep(pos, found))
         set = found.removeFromSet(set)