Separated out nodes with properties from basic nodes.

Author: MrKWatkins

doc/.idea/inspectionProfiles/Project_Default.xml

@@ -109,7 +109,6 @@
           <toc-element toc-title="Parent" topic="MrKWatkins.Ast.Node-1.Parent.md" />
           <toc-element toc-title="PreviousSibling" topic="MrKWatkins.Ast.Node-1.PreviousSibling.md" />
           <toc-element toc-title="PreviousSiblings" topic="MrKWatkins.Ast.Node-1.PreviousSiblings.md" />
-          <toc-element toc-title="Properties" topic="MrKWatkins.Ast.Node-1.Properties.md" />
           <toc-element toc-title="Root" topic="MrKWatkins.Ast.Node-1.Root.md" />
           <toc-element toc-title="SourcePosition" topic="MrKWatkins.Ast.Node-1.SourcePosition.md" />
           <toc-element toc-title="ThisAndAncestors" topic="MrKWatkins.Ast.Node-1.ThisAndAncestors.md" />
@@ -134,7 +133,6 @@
           <toc-element toc-title="AddPreviousSibling" topic="MrKWatkins.Ast.Node-1.AddPreviousSibling.md" />
           <toc-element toc-title="AddWarning" topic="MrKWatkins.Ast.Node-1.AddWarning.md" />
           <toc-element toc-title="AncestorsOfType" topic="MrKWatkins.Ast.Node-1.AncestorsOfType.md" />
-          <toc-element toc-title="Copy" topic="MrKWatkins.Ast.Node-1.Copy.md" />
           <toc-element toc-title="MoveTo" topic="MrKWatkins.Ast.Node-1.MoveTo.md" />
           <toc-element toc-title="RemoveFromParent" topic="MrKWatkins.Ast.Node-1.RemoveFromParent.md" />
           <toc-element toc-title="RemoveNextSibling" topic="MrKWatkins.Ast.Node-1.RemoveNextSibling.md" />
@@ -165,6 +163,16 @@
           <toc-element toc-title="TryGet" topic="MrKWatkins.Ast.Properties.TryGet.md" />
         </toc-element>
       </toc-element>
+      <toc-element toc-title="PropertyNode&lt;TNode&gt;">
+        <toc-element toc-title="PropertyNode&lt;TNode&gt;" topic="MrKWatkins.Ast.PropertyNode-1.md" />
+        <toc-element toc-title="Constructors" topic="MrKWatkins.Ast.PropertyNode-1.-ctor.md" />
+        <toc-element toc-title="Properties">
+          <toc-element toc-title="Properties" topic="MrKWatkins.Ast.PropertyNode-1.Properties.md" />
+        </toc-element>
+        <toc-element toc-title="Methods">
+          <toc-element toc-title="Copy" topic="MrKWatkins.Ast.PropertyNode-1.Copy.md" />
+        </toc-element>
+      </toc-element>
     </toc-element>
     <toc-element toc-title="MrKWatkins.Ast.Listening">
       <toc-element toc-title="CompositeListener&lt;TBaseNode&gt;">

doc/MrKWatkins.Ast.tree

@@ -2,7 +2,6 @@
 <buildprofiles xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                xsi:noNamespaceSchemaLocation="https://resources.jetbrains.com/writerside/1.0/build-profiles.xsd">
 
-    <variables></variables>
     <build-profile instance="hi">
         <variables>
             <noindex-content>true</noindex-content>

doc/cfg/buildprofiles.xml

@@ -1,10 +1,14 @@
 # Node<TNode>.ToString Method
 ## Definition
 
+Returns a string that represents the current node. Defaults to the name of the type of the node.
+
 ```c#
 public override string ToString();
 ```
 
 ## Returns
 
 [String](https://learn.microsoft.com/en-gb/dotnet/api/System.String)
+
+A string that represents the current node.

doc/topics/API/MrKWatkins.Ast.Node-1.Copy.md

@@ -51,7 +51,6 @@ public abstract class Node<TNode>
 | [Parent](MrKWatkins.Ast.Node-1.Parent.md) | The parent of this node. |
 | [PreviousSibling](MrKWatkins.Ast.Node-1.PreviousSibling.md) | The previous sibling, i.e. the child from the same [Parent](MrKWatkins.Ast.Node-1.Parent.md) at the previous positional index. Returns `null` if this node is the first child. |
 | [PreviousSiblings](MrKWatkins.Ast.Node-1.PreviousSiblings.md) | Lazily enumerates over the previous siblings, i.e. the children from the same [Parent](MrKWatkins.Ast.Node-1.Parent.md) at precedent positional indices in descending index order. |
-| [Properties](MrKWatkins.Ast.Node-1.Properties.md) | The [Properties](MrKWatkins.Ast.Properties.md) associated with this node. |
 | [Root](MrKWatkins.Ast.Node-1.Root.md) | The root node, i.e. the highest parent above this node. Returns this node if it is the root, i.e. it has no parents. |
 | [SourcePosition](MrKWatkins.Ast.Node-1.SourcePosition.md) | The position of the node in the source code. |
 | [ThisAndAncestors](MrKWatkins.Ast.Node-1.ThisAndAncestors.md) | Lazily enumerates over this node and its [Ancestors](MrKWatkins.Ast.Node-1.Ancestors.md), i.e. this node, the [Parent](MrKWatkins.Ast.Node-1.Parent.md), grandparent, great-grandparent and so on up to the root node. |
@@ -84,14 +83,12 @@ public abstract class Node<TNode>
 | [AddWarning(String)](MrKWatkins.Ast.Node-1.AddWarning.md#mrkwatkins-ast-node-1-addwarning(system-string)) | Adds a [Message](MrKWatkins.Ast.Message.md) with [Level](MrKWatkins.Ast.Message.Level.md) [Warning](MrKWatkins.Ast.MessageLevel.Warning.md) and the specified text to this node. |
 | [AddWarning(String, String)](MrKWatkins.Ast.Node-1.AddWarning.md#mrkwatkins-ast-node-1-addwarning(system-string-system-string)) | Adds a [Message](MrKWatkins.Ast.Message.md) with [Level](MrKWatkins.Ast.Message.Level.md) [Warning](MrKWatkins.Ast.MessageLevel.Warning.md) and the specified text to this node. |
 | [AncestorsOfType()](MrKWatkins.Ast.Node-1.AncestorsOfType.md) | Lazily enumerates over this node and its [Ancestors](MrKWatkins.Ast.Node-1.Ancestors.md), returning only ancestors of the specified type. |
-| [Copy()](MrKWatkins.Ast.Node-1.Copy.md#mrkwatkins-ast-node-1-copy) | Copies this node using the [DefaultNodeFactory&lt;TNode&gt;](MrKWatkins.Ast.DefaultNodeFactory-1.md). |
-| [Copy(INodeFactory&lt;TNode&gt;)](MrKWatkins.Ast.Node-1.Copy.md#mrkwatkins-ast-node-1-copy(mrkwatkins-ast-inodefactory((-0)))) | Copies this node using the specified [INodeFactory&lt;TNode&gt;](MrKWatkins.Ast.INodeFactory-1.md). |
 | [MoveTo(TNode)](MrKWatkins.Ast.Node-1.MoveTo.md) | Moves this node to a new parent. |
 | [RemoveFromParent()](MrKWatkins.Ast.Node-1.RemoveFromParent.md) | Removes this node from its [Parent](MrKWatkins.Ast.Node-1.Parent.md). |
 | [RemoveNextSibling()](MrKWatkins.Ast.Node-1.RemoveNextSibling.md) | Removes the [NextSibling](MrKWatkins.Ast.Node-1.NextSibling.md) from [Parent](MrKWatkins.Ast.Node-1.Parent.md) if it exists. |
 | [RemovePreviousSibling()](MrKWatkins.Ast.Node-1.RemovePreviousSibling.md) | Removes the [PreviousSibling](MrKWatkins.Ast.Node-1.PreviousSibling.md) from [Parent](MrKWatkins.Ast.Node-1.Parent.md) if it exists. |
 | [ReplaceWith(Node&lt;TNode&gt;)](MrKWatkins.Ast.Node-1.ReplaceWith.md) | Removes this node from it&#39;s parent and puts another node in its place. |
 | [ThisAnd(IEnumerable&lt;TNode&gt;)](MrKWatkins.Ast.Node-1.ThisAnd.md) | Lazily enumerates over this node and then the specified enumeration of nodes. |
 | [ThisAndAncestorsOfType()](MrKWatkins.Ast.Node-1.ThisAndAncestorsOfType.md) | Lazily enumerates over the [Ancestors](MrKWatkins.Ast.Node-1.Ancestors.md) of this node, returning only ancestors of the specified type. |
-| [ToString()](MrKWatkins.Ast.Node-1.ToString.md) |  |
+| [ToString()](MrKWatkins.Ast.Node-1.ToString.md) | Returns a string that represents the current node. Defaults to the name of the type of the node. |
 

doc/topics/API/MrKWatkins.Ast.Node-1.ToString.md

@@ -5,10 +5,13 @@
 | ---- | ----------- |
 | [GetOrThrow(String)](MrKWatkins.Ast.Properties.GetOrThrow.md#mrkwatkins-ast-properties-getorthrow-1(system-string)) | Gets the value of a single valued property with the specified key or throws an exception if the property does not exist. |
 | [GetOrThrow(String, T)](MrKWatkins.Ast.Properties.GetOrThrow.md#mrkwatkins-ast-properties-getorthrow-1(system-string-0@)) | Gets the value of a single valued property with the specified key or throws an exception if the property does not exist. Uses a field to cache the value for better performance. |
+| [GetOrThrow(String, T?)](MrKWatkins.Ast.Properties.GetOrThrow.md#mrkwatkins-ast-properties-getorthrow-1(system-string-system-nullable((-0))@)) | Gets the value of a single valued property with the specified key or throws an exception if the property does not exist. Uses a field to cache the value for better performance. |
 | [GetOrThrow(String, Func<Exception>)](MrKWatkins.Ast.Properties.GetOrThrow.md#mrkwatkins-ast-properties-getorthrow-1(system-string-system-func((system-exception)))) | Gets the value of a single valued property with the specified key or throws an exception if the property does not exist. |
 | [GetOrThrow(String, T, Func<Exception>)](MrKWatkins.Ast.Properties.GetOrThrow.md#mrkwatkins-ast-properties-getorthrow-1(system-string-0@-system-func((system-exception)))) | Gets the value of a single valued property with the specified key or throws an exception if the property does not exist. Uses a field to cache the value for better performance. |
+| [GetOrThrow(String, T?, Func<Exception>)](MrKWatkins.Ast.Properties.GetOrThrow.md#mrkwatkins-ast-properties-getorthrow-1(system-string-system-nullable((-0))@-system-func((system-exception)))) | Gets the value of a single valued property with the specified key or throws an exception if the property does not exist. Uses a field to cache the value for better performance. |
 | [GetOrThrow(String, Func<String, Exception>)](MrKWatkins.Ast.Properties.GetOrThrow.md#mrkwatkins-ast-properties-getorthrow-1(system-string-system-func((system-string-system-exception)))) | Gets the value of a single valued property with the specified key or throws an exception if the property does not exist. |
 | [GetOrThrow(String, T, Func<String, Exception>)](MrKWatkins.Ast.Properties.GetOrThrow.md#mrkwatkins-ast-properties-getorthrow-1(system-string-0@-system-func((system-string-system-exception)))) | Gets the value of a single valued property with the specified key or throws an exception if the property does not exist. Uses a field to cache the value for better performance. |
+| [GetOrThrow(String, T?, Func<String, Exception>)](MrKWatkins.Ast.Properties.GetOrThrow.md#mrkwatkins-ast-properties-getorthrow-1(system-string-system-nullable((-0))@-system-func((system-string-system-exception)))) | Gets the value of a single valued property with the specified key or throws an exception if the property does not exist. Uses a field to cache the value for better performance. |
 
 ## GetOrThrow<T>(string) {id="mrkwatkins-ast-properties-getorthrow-1(system-string)"}
 
@@ -65,6 +68,36 @@ T
 The value of the property.
 ## Remarks {id="remarks-mrkwatkins-ast-properties-getorthrow-1(system-string-0@)"}
 
+Properties are stored in a dictionary which might not have enough performance in some situations. Use this overload to get higher performance as the value will be taken from the field if it exists. Make sure to use [Set(String, T, T)](MrKWatkins.Ast.Properties.Set.md#mrkwatkins-ast-properties-set-1(system-string-0-0@)) to update the cached field.
+## GetOrThrow<T>(string, T?) {id="mrkwatkins-ast-properties-getorthrow-1(system-string-system-nullable((-0))@)"}
+
+Gets the value of a single valued property with the specified key or throws an exception if the property does not exist. Uses a field to cache the value for better performance.
+
+```c#
+public T GetOrThrow<T>(string key, ref T? cached)
+   where T : ValueType, new();
+```
+
+### Type Parameters {id="type-parameters-mrkwatkins-ast-properties-getorthrow-1(system-string-system-nullable((-0))@)"}
+
+| Name | Description |
+| ---- | ----------- |
+| T | The type of the property. |
+
+## Parameters {id="parameters-mrkwatkins-ast-properties-getorthrow-1(system-string-system-nullable((-0))@)"}
+
+| Name | Type | Description |
+| ---- | ---- | ----------- |
+| key | [String](https://learn.microsoft.com/en-gb/dotnet/api/System.String) | The key of the property. |
+| cached | [T?](https://learn.microsoft.com/en-gb/dotnet/api/System.Nullable-1) | The key of the property. |
+
+## Returns {id="returns-mrkwatkins-ast-properties-getorthrow-1(system-string-system-nullable((-0))@)"}
+
+T
+
+The value of the property.
+## Remarks {id="remarks-mrkwatkins-ast-properties-getorthrow-1(system-string-system-nullable((-0))@)"}
+
 Properties are stored in a dictionary which might not have enough performance in some situations. Use this overload to get higher performance as the value will be taken from the field if it exists. Make sure to use [Set(String, T, T)](MrKWatkins.Ast.Properties.Set.md#mrkwatkins-ast-properties-set-1(system-string-0-0@)) to update the cached field.
 ## GetOrThrow&lt;T&gt;(string, Func&lt;Exception&gt;) {id="mrkwatkins-ast-properties-getorthrow-1(system-string-system-func((system-exception)))"}
 
@@ -123,6 +156,37 @@ T
 The value of the property.
 ## Remarks {id="remarks-mrkwatkins-ast-properties-getorthrow-1(system-string-0@-system-func((system-exception)))"}
 
+Properties are stored in a dictionary which might not have enough performance in some situations. Use this overload to get higher performance as the value will be taken from the field if it exists. Make sure to use [Set(String, T, T)](MrKWatkins.Ast.Properties.Set.md#mrkwatkins-ast-properties-set-1(system-string-0-0@)) to update the cached field.
+## GetOrThrow&lt;T&gt;(string, T?, Func&lt;Exception&gt;) {id="mrkwatkins-ast-properties-getorthrow-1(system-string-system-nullable((-0))@-system-func((system-exception)))"}
+
+Gets the value of a single valued property with the specified key or throws an exception if the property does not exist. Uses a field to cache the value for better performance.
+
+```c#
+public T GetOrThrow<T>(string key, ref T? cached, Func<Exception> exceptionCreator)
+   where T : ValueType, new();
+```
+
+### Type Parameters {id="type-parameters-mrkwatkins-ast-properties-getorthrow-1(system-string-system-nullable((-0))@-system-func((system-exception)))"}
+
+| Name | Description |
+| ---- | ----------- |
+| T | The type of the property. |
+
+## Parameters {id="parameters-mrkwatkins-ast-properties-getorthrow-1(system-string-system-nullable((-0))@-system-func((system-exception)))"}
+
+| Name | Type | Description |
+| ---- | ---- | ----------- |
+| key | [String](https://learn.microsoft.com/en-gb/dotnet/api/System.String) | The key of the property. |
+| cached | [T?](https://learn.microsoft.com/en-gb/dotnet/api/System.Nullable-1) | The key of the property. |
+| exceptionCreator | [Func&lt;Exception&gt;](https://learn.microsoft.com/en-gb/dotnet/api/System.Func-1) | Function to create an exception to throw if the no property with the specified `key` exists. |
+
+## Returns {id="returns-mrkwatkins-ast-properties-getorthrow-1(system-string-system-nullable((-0))@-system-func((system-exception)))"}
+
+T
+
+The value of the property.
+## Remarks {id="remarks-mrkwatkins-ast-properties-getorthrow-1(system-string-system-nullable((-0))@-system-func((system-exception)))"}
+
 Properties are stored in a dictionary which might not have enough performance in some situations. Use this overload to get higher performance as the value will be taken from the field if it exists. Make sure to use [Set(String, T, T)](MrKWatkins.Ast.Properties.Set.md#mrkwatkins-ast-properties-set-1(system-string-0-0@)) to update the cached field.
 ## GetOrThrow&lt;T&gt;(string, Func&lt;String, Exception&gt;) {id="mrkwatkins-ast-properties-getorthrow-1(system-string-system-func((system-string-system-exception)))"}
 
@@ -182,3 +246,34 @@ The value of the property.
 ## Remarks {id="remarks-mrkwatkins-ast-properties-getorthrow-1(system-string-0@-system-func((system-string-system-exception)))"}
 
 Properties are stored in a dictionary which might not have enough performance in some situations. Use this overload to get higher performance as the value will be taken from the field if it exists. Make sure to use [Set(String, T, T)](MrKWatkins.Ast.Properties.Set.md#mrkwatkins-ast-properties-set-1(system-string-0-0@)) to update the cached field.
+## GetOrThrow&lt;T&gt;(string, T?, Func&lt;String, Exception&gt;) {id="mrkwatkins-ast-properties-getorthrow-1(system-string-system-nullable((-0))@-system-func((system-string-system-exception)))"}
+
+Gets the value of a single valued property with the specified key or throws an exception if the property does not exist. Uses a field to cache the value for better performance.
+
+```c#
+public T GetOrThrow<T>(string key, ref T? cached, Func<String, Exception> exceptionCreator)
+   where T : ValueType, new();
+```
+
+### Type Parameters {id="type-parameters-mrkwatkins-ast-properties-getorthrow-1(system-string-system-nullable((-0))@-system-func((system-string-system-exception)))"}
+
+| Name | Description |
+| ---- | ----------- |
+| T | The type of the property. |
+
+## Parameters {id="parameters-mrkwatkins-ast-properties-getorthrow-1(system-string-system-nullable((-0))@-system-func((system-string-system-exception)))"}
+
+| Name | Type | Description |
+| ---- | ---- | ----------- |
+| key | [String](https://learn.microsoft.com/en-gb/dotnet/api/System.String) | The key of the property. |
+| cached | [T?](https://learn.microsoft.com/en-gb/dotnet/api/System.Nullable-1) | The key of the property. |
+| exceptionCreator | [Func&lt;String, Exception&gt;](https://learn.microsoft.com/en-gb/dotnet/api/System.Func-2) | Function to create an exception to throw if the no property with the specified `key` exists. |
+
+## Returns {id="returns-mrkwatkins-ast-properties-getorthrow-1(system-string-system-nullable((-0))@-system-func((system-string-system-exception)))"}
+
+T
+
+The value of the property.
+## Remarks {id="remarks-mrkwatkins-ast-properties-getorthrow-1(system-string-system-nullable((-0))@-system-func((system-string-system-exception)))"}
+
+Properties are stored in a dictionary which might not have enough performance in some situations. Use this overload to get higher performance as the value will be taken from the field if it exists. Make sure to use [Set(String, T, T)](MrKWatkins.Ast.Properties.Set.md#mrkwatkins-ast-properties-set-1(system-string-0-0@)) to update the cached field.