Support replacing the root node during processing.

Author: MrKWatkins

.github/workflows/release.yml

@@ -23,13 +23,14 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
 
       - name: Publish to NuGet
         uses: MrKWatkins/nuget-publish@main
         with:
           nuget-api-key: ${{ secrets.NUGET_API_KEY }}
           version: ${{ inputs.version }}
+          directory: src
 
       - name: Deploy Documentation
         uses: MrKWatkins/writerside-build@main

doc/MrKWatkins.Ast.tree

@@ -467,7 +467,7 @@
         <toc-element toc-title="Methods">
           <toc-element toc-title="Build" topic="MrKWatkins.Ast.Processing.Pipeline-1.Build.md" />
           <toc-element toc-title="Run" topic="MrKWatkins.Ast.Processing.Pipeline-1.Run.md" />
-        </toc-element>
+      </toc-element>
       </toc-element>
       <toc-element toc-title="Pipeline&lt;TContext, TBaseNode&gt;">
         <toc-element toc-title="Pipeline&lt;TContext, TBaseNode&gt;" topic="MrKWatkins.Ast.Processing.Pipeline-2.md" />
@@ -477,7 +477,7 @@
         <toc-element toc-title="Methods">
           <toc-element toc-title="Build" topic="MrKWatkins.Ast.Processing.Pipeline-2.Build.md" />
           <toc-element toc-title="Run" topic="MrKWatkins.Ast.Processing.Pipeline-2.Run.md" />
-        </toc-element>
+      </toc-element>
       </toc-element>
       <toc-element toc-title="PipelineBuilder&lt;TBaseNode&gt;">
         <toc-element toc-title="PipelineBuilder&lt;TBaseNode&gt;" topic="MrKWatkins.Ast.Processing.PipelineBuilder-1.md" />
@@ -511,7 +511,7 @@
         </toc-element>
         <toc-element toc-title="Methods">
           <toc-element toc-title="Run" topic="MrKWatkins.Ast.Processing.PipelineStage-1.Run.md" />
-        </toc-element>
+      </toc-element>
       </toc-element>
       <toc-element toc-title="PipelineStage&lt;TContext, TBaseNode&gt;">
         <toc-element toc-title="PipelineStage&lt;TContext, TBaseNode&gt;" topic="MrKWatkins.Ast.Processing.PipelineStage-2.md" />
@@ -522,7 +522,7 @@
         </toc-element>
         <toc-element toc-title="Methods">
           <toc-element toc-title="Run" topic="MrKWatkins.Ast.Processing.PipelineStage-2.Run.md" />
-        </toc-element>
+      </toc-element>
       </toc-element>
       <toc-element toc-title="PipelineStageBuilder&lt;TSelf, TStage, TBaseNode, TProcessor, TShouldContinue&gt;">
         <toc-element toc-title="PipelineStageBuilder&lt;TSelf, TStage, TBaseNode, TProcessor, TShouldContinue&gt;" topic="MrKWatkins.Ast.Processing.PipelineStageBuilder-5.md" />

doc/topics/API/MrKWatkins.Ast.Processing.NodeProcessor-2.Process.md

@@ -11,7 +11,7 @@
 Performs processing on the specified `node` if it is of type `TNode`. Does not process any descendents.
 
 ```c#
-public sealed override void Process(TBaseNode node);
+public sealed override TBaseNode Process(TBaseNode node);
 ```
 
 ## Parameters {id="parameters-mrkwatkins-ast-processing-nodeprocessor-2-process(-0)"}
@@ -20,12 +20,18 @@ public sealed override void Process(TBaseNode node);
 | ---- | ---- | ----------- |
 | node | TBaseNode | The node to process. |
 
+## Returns {id="returns-mrkwatkins-ast-processing-nodeprocessor-2-process(-0)"}
+
+TBaseNode
+
+The root node of the tree, which may have been replaced.
+
 ## Process(TNode) {id="mrkwatkins-ast-processing-nodeprocessor-2-process(-1)"}
 
 Performs processing on the specified `node`. Does not process any descendents.
 
 ```c#
-protected new abstract void Process(TNode node);
+protected new abstract TBaseNode Process(TNode node);
 ```
 
 ## Parameters {id="parameters-mrkwatkins-ast-processing-nodeprocessor-2-process(-1)"}
@@ -34,3 +40,8 @@ protected new abstract void Process(TNode node);
 | ---- | ---- | ----------- |
 | node | TNode | The node to process. |
 
+## Returns {id="returns-mrkwatkins-ast-processing-nodeprocessor-2-process(-1)"}
+
+TBaseNode
+
+The root node of the tree, which may have been replaced.

doc/topics/API/MrKWatkins.Ast.Processing.NodeProcessor-3.Process.md

@@ -11,7 +11,7 @@
 Performs processing on the specified `node` if it is of type `TNode`. Does not process any descendents.
 
 ```c#
-public sealed override void Process(TContext? context, TBaseNode node);
+public sealed override TBaseNode Process(TContext context, TBaseNode node);
 ```
 
 ## Parameters {id="parameters-mrkwatkins-ast-processing-nodeprocessor-3-process(-0-1)"}
@@ -21,12 +21,18 @@ public sealed override void Process(TContext? context, TBaseNode node);
 | context | TContext | The processing context. |
 | node | TBaseNode | The node to process. |
 
+## Returns {id="returns-mrkwatkins-ast-processing-nodeprocessor-3-process(-0-1)"}
+
+TBaseNode
+
+The root node of the tree, which may have been replaced.
+
 ## Process(TContext, TNode) {id="mrkwatkins-ast-processing-nodeprocessor-3-process(-0-2)"}
 
 Performs processing on the specified `node`. Does not process any descendents.
 
 ```c#
-protected new abstract void Process(TContext? context, TNode node);
+protected new abstract TBaseNode Process(TContext context, TNode node);
 ```
 
 ## Parameters {id="parameters-mrkwatkins-ast-processing-nodeprocessor-3-process(-0-2)"}
@@ -36,3 +42,8 @@ protected new abstract void Process(TContext? context, TNode node);
 | context | TContext | The processing context. |
 | node | TNode | The node to process. |
 
+## Returns {id="returns-mrkwatkins-ast-processing-nodeprocessor-3-process(-0-2)"}
+
+TBaseNode
+
+The root node of the tree, which may have been replaced.

doc/topics/API/MrKWatkins.Ast.Processing.NodeReplacer-2.Process.md

@@ -2,7 +2,7 @@
 ## Definition
 
 ```c#
-protected sealed override void Process(TNode node);
+protected sealed override TBaseNode Process(TNode node);
 ```
 
 ## Parameters
@@ -11,3 +11,6 @@ protected sealed override void Process(TNode node);
 | ---- | ---- | ----------- |
 | node | TNode |  |
 
+## Returns
+
+TBaseNode

doc/topics/API/MrKWatkins.Ast.Processing.NodeReplacer-3.Process.md

@@ -2,7 +2,7 @@
 ## Definition
 
 ```c#
-protected sealed override void Process(TContext? context, TNode node);
+protected sealed override TBaseNode Process(TContext context, TNode node);
 ```
 
 ## Parameters
@@ -12,3 +12,6 @@ protected sealed override void Process(TContext? context, TNode node);
 | context | TContext |  |
 | node | TNode |  |
 
+## Returns
+
+TBaseNode

doc/topics/API/MrKWatkins.Ast.Processing.NodeValidator-2.Process.md

@@ -2,7 +2,7 @@
 ## Definition
 
 ```c#
-protected sealed override void Process(TNode node);
+protected sealed override TBaseNode Process(TNode node);
 ```
 
 ## Parameters
@@ -11,3 +11,6 @@ protected sealed override void Process(TNode node);
 | ---- | ---- | ----------- |
 | node | TNode |  |
 
+## Returns
+
+TBaseNode

doc/topics/API/MrKWatkins.Ast.Processing.NodeValidator-3.Process.md

@@ -2,7 +2,7 @@
 ## Definition
 
 ```c#
-protected sealed override void Process(TContext? context, TNode node);
+protected sealed override TBaseNode Process(TContext context, TNode node);
 ```
 
 ## Parameters
@@ -12,3 +12,6 @@ protected sealed override void Process(TContext? context, TNode node);
 | context | TContext |  |
 | node | TNode |  |
 
+## Returns
+
+TBaseNode

doc/topics/API/MrKWatkins.Ast.Processing.OrderedNodeProcessor-2.Process.md

@@ -9,7 +9,7 @@
 ## Process(TBaseNode) {id="mrkwatkins-ast-processing-orderednodeprocessor-2-process(-0)"}
 
 ```c#
-public sealed override void Process(TBaseNode node);
+public sealed override TBaseNode Process(TBaseNode node);
 ```
 
 ## Parameters {id="parameters-mrkwatkins-ast-processing-orderednodeprocessor-2-process(-0)"}
@@ -18,12 +18,16 @@ public sealed override void Process(TBaseNode node);
 | ---- | ---- | ----------- |
 | node | TBaseNode |  |
 
+## Returns {id="returns-mrkwatkins-ast-processing-orderednodeprocessor-2-process(-0)"}
+
+TBaseNode
+
 ## Process(TNode) {id="mrkwatkins-ast-processing-orderednodeprocessor-2-process(-1)"}
 
 Performs processing on the specified `node`. Does not process any descendents.
 
 ```c#
-protected new abstract void Process(TNode node);
+protected new abstract TBaseNode Process(TNode node);
 ```
 
 ## Parameters {id="parameters-mrkwatkins-ast-processing-orderednodeprocessor-2-process(-1)"}
@@ -32,3 +36,6 @@ protected new abstract void Process(TNode node);
 | ---- | ---- | ----------- |
 | node | TNode | The node to process. |
 
+## Returns {id="returns-mrkwatkins-ast-processing-orderednodeprocessor-2-process(-1)"}
+
+TBaseNode

doc/topics/API/MrKWatkins.Ast.Processing.OrderedNodeProcessor-3.Process.md

@@ -9,7 +9,7 @@
 ## Process(TContext, TBaseNode) {id="mrkwatkins-ast-processing-orderednodeprocessor-3-process(-0-1)"}
 
 ```c#
-public sealed override void Process(TContext? context, TBaseNode node);
+public sealed override TBaseNode Process(TContext context, TBaseNode node);
 ```
 
 ## Parameters {id="parameters-mrkwatkins-ast-processing-orderednodeprocessor-3-process(-0-1)"}
@@ -19,12 +19,16 @@ public sealed override void Process(TContext? context, TBaseNode node);
 | context | TContext |  |
 | node | TBaseNode |  |
 
+## Returns {id="returns-mrkwatkins-ast-processing-orderednodeprocessor-3-process(-0-1)"}
+
+TBaseNode
+
 ## Process(TContext, TNode) {id="mrkwatkins-ast-processing-orderednodeprocessor-3-process(-0-2)"}
 
 Performs processing on the specified `node`. Does not process any descendents.
 
 ```c#
-protected new abstract void Process(TContext? context, TNode node);
+protected new abstract TBaseNode Process(TContext context, TNode node);
 ```
 
 ## Parameters {id="parameters-mrkwatkins-ast-processing-orderednodeprocessor-3-process(-0-2)"}
@@ -34,3 +38,6 @@ protected new abstract void Process(TContext? context, TNode node);
 | context | TContext | The processing context. |
 | node | TNode | The node to process. |
 
+## Returns {id="returns-mrkwatkins-ast-processing-orderednodeprocessor-3-process(-0-2)"}
+
+TBaseNode