chore: merge main into stable

README.md

@@ -165,6 +165,9 @@ Special thanks to these community members who have contributed code to SuperDoc:
 <a href="https://github.com/baristaGeek"><img src="https://github.com/baristaGeek.png" width="50" height="50" alt="baristaGeek" title="Esteban Vargas" /></a>
 <a href="https://github.com/Anuj52"><img src="https://github.com/Anuj52.png" width="50" height="50" alt="Anuj52" title="Anuj Chaudhary" /></a>
 <a href="https://github.com/Abdeltoto"><img src="https://github.com/Abdeltoto.png" width="50" height="50" alt="Abdeltoto" title="Abdel ATIA" /></a>
+<a href="https://github.com/JoaaoVerona"><img src="https://github.com/JoaaoVerona.png" width="50" height="50" alt="JoaaoVerona" title="João Vitor Verona Biazibetti" /></a>
+<a href="https://github.com/michaelreavant"><img src="https://github.com/michaelreavant.png" width="50" height="50" alt="michaelreavant" title="michaelreavant" /></a>
+<a href="https://github.com/ArturQuirino"><img src="https://github.com/ArturQuirino.png" width="50" height="50" alt="ArturQuirino" title="ARTUR QUIRINO" /></a>
 
 Want to see your avatar here? Check the [Contributing Guide](CONTRIBUTING.md) to get started.
 

apps/docs/core/superdoc/configuration.mdx

@@ -112,7 +112,7 @@ new SuperDoc({
     - `viewing` - Read-only display
     - `suggesting` - Track changes enabled
   </Expandable>
-  <Info>See the [Track Changes extension](/extensions/track-changes) for accept/reject commands, and the [runnable example](https://github.com/superdoc-dev/superdoc/tree/main/examples/features/track-changes) for a complete workflow.</Info>
+  <Info>See the [Track Changes module](/modules/track-changes) for accept/reject commands, the Document API, and configuration. The [runnable example](https://github.com/superdoc-dev/superdoc/tree/main/examples/features/track-changes) shows a complete workflow.</Info>
 </ParamField>
 
 <ParamField path="comments" type="Object">
@@ -124,11 +124,11 @@ new SuperDoc({
   </Expandable>
 </ParamField>
 
-<ParamField path="trackChanges" type="Object">
-  Viewing-mode visibility controls for tracked changes
+<ParamField path="trackChanges" type="Object" deprecated>
+  <Warning>**Deprecated** — Use [`modules.trackChanges`](#track-changes-module) instead. This top-level key remains supported as an alias and will emit a one-time console warning.</Warning>
   <Expandable title="properties" defaultOpen>
     <ParamField path="trackChanges.visible" type="boolean" default="false">
-      Show tracked-change markup and threads when `documentMode` is `viewing`
+      Show tracked-change markup and threads when `documentMode` is `viewing`.
     </ParamField>
   </Expandable>
 </ParamField>
@@ -196,6 +196,56 @@ new SuperDoc({
   </Expandable>
 </ParamField>
 
+### Track changes module
+
+<ParamField path="modules.trackChanges" type="Object">
+  Track changes configuration. Supersedes the top-level `trackChanges` and `layoutEngineOptions.trackedChanges` keys, which remain supported as deprecated aliases.
+
+  <Expandable title="properties" defaultOpen>
+    <ParamField path="modules.trackChanges.visible" type="boolean" default="false">
+      Show tracked-change markup and threads when `documentMode` is `viewing`.
+    </ParamField>
+    <ParamField path="modules.trackChanges.mode" type="'review' | 'original' | 'final' | 'off'">
+      Rendering mode for tracked changes.
+      - `'review'`: show insertions and deletions inline (default for editing/suggesting).
+      - `'original'`: show the document as it existed before tracked changes (default for viewing when `visible` is `false`).
+      - `'final'`: show the document with changes applied.
+      - `'off'`: disable tracked-change rendering.
+    </ParamField>
+    <ParamField path="modules.trackChanges.enabled" type="boolean" default="true">
+      Whether the layout engine treats tracked changes as active.
+    </ParamField>
+    <ParamField path="modules.trackChanges.replacements" type="'paired' | 'independent'" default="'paired'">
+      How a tracked replacement (adjacent insertion + deletion created by typing over selected text) surfaces in the UI and API.
+      - `'paired'` (default, Google Docs model): the two halves share one id and resolve together with a single accept/reject click.
+      - `'independent'` (Microsoft Word / ECMA-376 §17.13.5 model): each insertion and each deletion has its own id, is addressable on its own, and resolves independently.
+    </ParamField>
+  </Expandable>
+</ParamField>
+
+```javascript
+new SuperDoc({
+  selector: '#editor',
+  document: 'contract.docx',
+  documentMode: 'viewing',
+  modules: {
+    trackChanges: { visible: true, mode: 'review' },
+  },
+});
+```
+
+Opt into Microsoft Word / ECMA-376-style independent revisions, where each insertion and each deletion has its own id and resolves on its own:
+
+```javascript
+new SuperDoc({
+  selector: '#editor',
+  document: 'contract.docx',
+  modules: {
+    trackChanges: { replacements: 'independent' },
+  },
+});
+```
+
 ### Toolbar module
 
 <ParamField path="modules.toolbar" type="Object">

apps/docs/docs.json

@@ -154,6 +154,7 @@
                 ]
               },
               "modules/comments",
+              "modules/track-changes",
               {
                 "group": "Toolbar",
                 "tag": "NEW",
@@ -455,6 +456,10 @@
       "source": "/extensions/slash-menu",
       "destination": "/extensions/context-menu"
     },
+    {
+      "source": "/extensions/track-changes",
+      "destination": "/modules/track-changes"
+    },
     {
       "source": "/guides/breaking-changes-v1",
       "destination": "/guides/migration/breaking-changes-v1"

apps/docs/extensions/overview.mdx

@@ -53,7 +53,7 @@ Basic document capabilities:
 
 ### Advanced features
 Complex functionality:
-- **[Track Changes](/extensions/track-changes)** - Revision tracking
+- **[Track Changes](/modules/track-changes)** - Revision tracking
 - **[Comments](/extensions/comments)** - Discussions
 - **[Field Annotation](/extensions/field-annotation)** - Form fields
 - **[Document Section](/extensions/document-section)** - Locked sections