Add documentation comments

miroiu · miroiu · commit 42c1234ad3d6 · 2024-12-10T22:01:43.000+02:00
diff --git a/Nodify/EditorGestures.cs b/Nodify/EditorGestures.cs
@@ -13,6 +13,14 @@ public class SelectionGestures
             /// <summary>Disable selection gestures.</summary>
             public static readonly SelectionGestures None = new SelectionGestures(MouseAction.None);
 
+            /// <summary>
+            /// Initializes a new instance of the <see cref="SelectionGestures"/> class with specified mouse action 
+            /// and a flag indicating whether modifier keys should be ignored when releasing the mouse button.
+            /// </summary>
+            /// <param name="mouseAction">The mouse action to trigger the gestures.</param>
+            /// <param name="ignoreModifierKeysOnRelease">
+            /// A value indicating whether modifier keys (Alt, Shift, Control) should be ignored when the mouse button is released.
+            /// </param>
             public SelectionGestures(MouseAction mouseAction, bool ignoreModifierKeysOnRelease)
             {
                 Replace = new MouseGesture(mouseAction);
@@ -23,16 +31,33 @@ public SelectionGestures(MouseAction mouseAction, bool ignoreModifierKeysOnRelea
                 Cancel = new KeyGesture(Key.Escape);
             }
 
+            /// <summary>
+            /// Initializes a new instance of the <see cref="SelectionGestures"/> class with a specified mouse action.
+            /// Modifier keys will be ignored when releasing the mouse button.
+            /// </summary>
+            /// <param name="mouseAction">The mouse action to trigger the gestures.</param>
             public SelectionGestures(MouseAction mouseAction)
                 : this(mouseAction, true)
             {
             }
 
+            /// <summary>
+            /// Initializes a new instance of the <see cref="SelectionGestures"/> class with a flag indicating 
+            /// whether modifier keys should be ignored when releasing the mouse button. 
+            /// The default mouse action is <see cref="MouseAction.LeftClick"/>.
+            /// </summary>
+            /// <param name="ignoreModifierKeysOnRelease">
+            /// A value indicating whether modifier keys (Alt, Shift, Control) should be ignored when the mouse button is released.
+            /// </param>
             public SelectionGestures(bool ignoreModifierKeysOnRelease)
                 : this(MouseAction.LeftClick, ignoreModifierKeysOnRelease)
             {
             }
 
+            /// <summary>
+            /// Initializes a new instance of the <see cref="SelectionGestures"/> class with default values:
+            /// the mouse action is <see cref="MouseAction.LeftClick"/>, and modifier keys are ignored when releasing the mouse button.
+            /// </summary>
             public SelectionGestures() : this(true)
             {
             }
diff --git a/Nodify/EditorStates/ConnectorConnectingState.cs b/Nodify/EditorStates/ConnectorConnectingState.cs
@@ -3,10 +3,18 @@
 
 namespace Nodify
 {
+    /// <summary>
+    /// Represents the state for handling a connector's connecting operation in the editor, 
+    /// enabling drag-based creation of connections between connectors.
+    /// </summary>
     public class ConnectorConnectingState : DragState<Connector>
     {
         protected override bool CanCancel => Connector.AllowPendingConnectionCancellation;
 
+        /// <summary>
+        /// Initializes a new instance of the <see cref="ConnectorConnectingState"/> class.
+        /// </summary>
+        /// <param name="connector">The connector associated with this state.</param>
         public ConnectorConnectingState(Connector connector)
             : base(connector, EditorGestures.Mappings.Connector.Connect, EditorGestures.Mappings.Connector.CancelAction)
         {
diff --git a/Nodify/EditorStates/ConnectorDisconnectState.cs b/Nodify/EditorStates/ConnectorDisconnectState.cs
@@ -2,8 +2,15 @@
 
 namespace Nodify
 {
+    /// <summary>
+    /// Represents a state in which a connector can be disconnected from its connections based on specific gestures.
+    /// </summary>
     public class ConnectorDisconnectState : InputElementState<Connector>
     {
+        /// <summary>
+        /// Initializes a new instance of the <see cref="ConnectorDisconnectState"/> class.
+        /// </summary>
+        /// <param name="connector">The <see cref="Connector"/> element associated with this state.</param>
         public ConnectorDisconnectState(Connector connector) : base(connector)
         {
         }
diff --git a/Nodify/EditorStates/ContainerDefaultState.cs b/Nodify/EditorStates/ContainerDefaultState.cs
@@ -4,7 +4,7 @@
 namespace Nodify
 {
     /// <summary>The default state of the <see cref="ItemContainer"/>.</summary>
-    public class ContainerDefaultState : InputElementStateStack<ItemContainer>
+    public sealed class ContainerDefaultState : InputElementStateStack<ItemContainer>
     {
         public ContainerDefaultState(ItemContainer container) : base(container)
         {
diff --git a/Nodify/EditorStates/DragState.cs b/Nodify/EditorStates/DragState.cs
@@ -3,29 +3,70 @@
 
 namespace Nodify
 {
+    /// <summary>
+    /// Represents an abstract base class for managing drag operations within a UI element.
+    /// Provides a framework for handling input gestures such as starting, canceling, and completing drag operations.
+    /// </summary>
+    /// <typeparam name="TElement">The type of <see cref="FrameworkElement"/> that owns the state.</typeparam>
     public abstract class DragState<TElement> : InputElementState<TElement>, IInputHandler
         where TElement : FrameworkElement
     {
+        /// <summary>
+        /// Gets the gesture used to cancel the drag operation, if defined.
+        /// </summary>
         protected InputGesture? CancelGesture { get; }
+
+        /// <summary>
+        /// Gets the gesture used to begin the drag operation.
+        /// </summary>
         protected InputGesture BeginGesture { get; }
 
+        /// <summary>
+        /// Indicates whether the element has a context menu associated with it.
+        /// </summary>
+        /// <remarks>This property is used to suppress the context menu when a drag operation is performed using the right mouse button.</remarks>
         protected virtual bool HasContextMenu => Element.ContextMenu != null;
+
+        /// <summary>
+        /// Determines if the drag operation can begin (see <see cref="OnBegin(InputEventArgs)"/>).
+        /// </summary>
         protected virtual bool CanBegin { get; } = true;
+
+        /// <summary>
+        /// Determines if the drag operation can be canceled (see <see cref="OnCancel(InputEventArgs)"/>).
+        /// </summary>
         protected virtual bool CanCancel { get; } = true;
+
+        /// <summary>
+        /// Indicates if the drag gesture is a toggle, meaning the same gesture can be used to both start and stop the operation.
+        /// </summary>
         protected virtual bool IsToggle { get; }
+
+        /// <summary>
+        /// Gets or sets the UI element used to calculate the mouse position during the drag operation.
+        /// </summary>
         protected IInputElement PositionElement { get; set; }
 
         private bool _canReceiveInput;
         private Point _initialPosition;
 
-        /// <summary>Constructs a new <see cref="EditorState"/>.</summary>
-        /// <param name="element">The owner of the state.</param>
+        /// <summary>
+        /// Initializes a new instance of the <see cref="DragState{TElement}"/> class with a begin gesture.
+        /// </summary>
+        /// <param name="element">The element associated with this state.</param>
+        /// <param name="beginGesture">The gesture used to start the drag operation.</param>
         public DragState(TElement element, InputGesture beginGesture) : base(element)
         {
             BeginGesture = beginGesture;
             PositionElement = element;
         }
 
+        /// <summary>
+        /// Initializes a new instance of the <see cref="DragState{TElement}"/> class with begin and cancel gestures.
+        /// </summary>
+        /// <param name="element">The element associated with this state.</param>
+        /// <param name="beginGesture">The gesture used to start the drag operation.</param>
+        /// <param name="cancelGesture">The gesture used to cancel the drag operation.</param>
         public DragState(TElement element, InputGesture beginGesture, InputGesture cancelGesture)
             : this(element, beginGesture)
         {
@@ -116,6 +157,11 @@ private void EndDrag(InputEventArgs e)
             }
         }
 
+        /// <summary>
+        /// Determines if the given input event represents the release of an input gesture.
+        /// </summary>
+        /// <param name="e">The input event to evaluate.</param>
+        /// <returns>True if the event represents the release of a gesture; otherwise, false.</returns>
         protected virtual bool IsInputEventReleased(InputEventArgs e)
         {
             if (e is MouseButtonEventArgs mbe && mbe.ButtonState == MouseButtonState.Released)
@@ -130,6 +176,11 @@ protected virtual bool IsInputEventReleased(InputEventArgs e)
             return false;
         }
 
+        /// <summary>
+        /// Determines if the given input event represents the press of an input gesture.
+        /// </summary>
+        /// <param name="e">The input event to evaluate.</param>
+        /// <returns>True if the event represents the press of a gesture; otherwise, false.</returns>
         protected virtual bool IsInputEventPressed(InputEventArgs e)
         {
             if (e is MouseButtonEventArgs mbe && mbe.ButtonState == MouseButtonState.Pressed)
@@ -144,14 +195,26 @@ protected virtual bool IsInputEventPressed(InputEventArgs e)
             return false;
         }
 
+        /// <summary>
+        /// Called when the drag operation begins. Override to provide custom behavior.
+        /// </summary>
+        /// <param name="e">The input event that started the operation.</param>
         protected virtual void OnBegin(InputEventArgs e)
         {
         }
 
+        /// <summary>
+        /// Called when the drag operation ends. Override to provide custom behavior.
+        /// </summary>
+        /// <param name="e">The input event that ended the operation.</param>
         protected virtual void OnEnd(InputEventArgs e)
         {
         }
 
+        /// <summary>
+        /// Called when the drag operation is canceled. Override to provide custom behavior.
+        /// </summary>
+        /// <param name="e">The input event that canceled the operation.</param>
         protected virtual void OnCancel(InputEventArgs e)
         {
         }
diff --git a/Nodify/EditorStates/EditorCuttingState.cs b/Nodify/EditorStates/EditorCuttingState.cs
@@ -2,11 +2,18 @@
 
 namespace Nodify
 {
+    /// <summary>
+    /// Represents the cutting state in the <see cref="NodifyEditor"/>, allowing users to cut connections between elements using a drag gesture.
+    /// </summary>
     public class EditorCuttingState : DragState<NodifyEditor>
     {
         protected override bool HasContextMenu => Element.HasContextMenu;
         protected override bool CanCancel => NodifyEditor.AllowCuttingCancellation;
 
+        /// <summary>
+        /// Initializes a new instance of the <see cref="EditorCuttingState"/> class.
+        /// </summary>
+        /// <param name="editor">The <see cref="NodifyEditor"/> associated with this state.</param>
         public EditorCuttingState(NodifyEditor editor)
             : base(editor, EditorGestures.Mappings.Editor.Cutting, EditorGestures.Mappings.Editor.CancelAction)
         {
@@ -15,7 +22,6 @@ public EditorCuttingState(NodifyEditor editor)
         protected override void OnBegin(InputEventArgs e) 
             => Element.BeginCutting();
 
-        /// <inheritdoc />
         protected override void OnMouseMove(MouseEventArgs e)
             => Element.UpdateCuttingLine(Element.MouseLocation);
 
diff --git a/Nodify/EditorStates/EditorPanningState.cs b/Nodify/EditorStates/EditorPanningState.cs
@@ -4,7 +4,9 @@
 
 namespace Nodify
 {
-    /// <summary>The panning state of the editor.</summary>
+    /// <summary>
+    /// Represents the panning state of the <see cref="NodifyEditor"/>, allowing the user to pan the viewport by clicking and dragging.
+    /// </summary>
     public class EditorPanningState : DragState<NodifyEditor>
     {
         protected override bool HasContextMenu => Element.HasContextMenu;
@@ -13,8 +15,10 @@ public class EditorPanningState : DragState<NodifyEditor>
 
         private Point _prevPosition;
 
-        /// <summary>Constructs an instance of the <see cref="EditorPanningState"/> state.</summary>
-        /// <param name="editor">The owner of the state.</param>
+        /// <summary>
+        /// Initializes a new instance of the <see cref="EditorPanningState"/> class.
+        /// </summary>
+        /// <param name="editor">The <see cref="NodifyEditor"/> associated with this state.</param>
         public EditorPanningState(NodifyEditor editor)
             : base(editor, EditorGestures.Mappings.Editor.Pan, EditorGestures.Mappings.Editor.CancelAction)
         {
@@ -26,7 +30,6 @@ protected override void OnBegin(InputEventArgs e)
             Element.BeginPanning();
         }
 
-        /// <inheritdoc />
         protected override void OnMouseMove(MouseEventArgs e)
         {
             var currentMousePosition = e.GetPosition(Element);
@@ -41,10 +44,16 @@ protected override void OnCancel(InputEventArgs e)
             => Element.CancelPanning();
     }
 
+    /// <summary>
+    /// Represents the panning state of the <see cref="NodifyEditor"/> using the mouse wheel.
+    /// Allows the user to pan horizontally or vertically by holding modifier keys while scrolling the mouse wheel.
+    /// </summary>
     public class EditorPanningWithMouseWheelState : InputElementState<NodifyEditor>
     {
-        /// <summary>Constructs an instance of the <see cref="EditorPanningWithMouseWheelState"/> state.</summary>
-        /// <param name="editor">The owner of the state.</param>
+        /// <summary>
+        /// Initializes a new instance of the <see cref="EditorPanningWithMouseWheelState"/> class.
+        /// </summary>
+        /// <param name="editor">The <see cref="NodifyEditor"/> associated with this state.</param>
         public EditorPanningWithMouseWheelState(NodifyEditor editor) : base(editor)
         {
         }
diff --git a/Nodify/EditorStates/EditorPushingItemsState.cs b/Nodify/EditorStates/EditorPushingItemsState.cs
@@ -5,13 +5,20 @@
 
 namespace Nodify
 {
+    /// <summary>
+    /// Represents the state of the <see cref="NodifyEditor"/> during a "push items" operation, allowing users to move items within the editor by dragging.
+    /// </summary>
     public class EditorPushingItemsState : DragState<NodifyEditor>
     {
         protected override bool HasContextMenu => Element.HasContextMenu;
         protected override bool CanCancel => NodifyEditor.AllowPushItemsCancellation;
 
         private Point _prevPosition;
 
+        /// <summary>
+        /// Initializes a new instance of the <see cref="EditorPushingItemsState"/> class.
+        /// </summary>
+        /// <param name="editor">The <see cref="NodifyEditor"/> associated with this state.</param>
         public EditorPushingItemsState(NodifyEditor editor)
             : base(editor, EditorGestures.Mappings.Editor.PushItems, EditorGestures.Mappings.Editor.CancelAction)
         {
@@ -20,7 +27,6 @@ public EditorPushingItemsState(NodifyEditor editor)
         protected override void OnBegin(InputEventArgs e) 
             => _prevPosition = Element.MouseLocation;
 
-        /// <inheritdoc />
         protected override void OnMouseMove(MouseEventArgs e)
         {
             if (Element.IsPushingItems)
diff --git a/Nodify/EditorStates/EditorSelectingState.cs b/Nodify/EditorStates/EditorSelectingState.cs
@@ -2,16 +2,20 @@
 
 namespace Nodify
 {
-    /// <summary>The selecting state of the editor.</summary>
+    /// <summary>
+    /// Represents the selecting state of the <see cref="NodifyEditor"/>.
+    /// This state is responsible for handling item selection within the editor.
+    /// </summary>
     public class EditorSelectingState : DragState<NodifyEditor>
     {
         protected override bool HasContextMenu => Element.HasContextMenu;
         protected override bool CanBegin => Element.CanSelectMultipleItems && !Element.IsPanning;
         protected override bool CanCancel => NodifyEditor.AllowSelectionCancellation;
 
-        /// <summary>Constructs an instance of the <see cref="EditorSelectingState"/> state.</summary>
-        /// <param name="editor">The owner of the state.</param>
-        /// <param name="type">The selection strategy.</param>
+        /// <summary>
+        /// Initializes a new instance of the <see cref="EditorSelectingState"/> class.
+        /// </summary>
+        /// <param name="editor">The <see cref="NodifyEditor"/> associated with this state.</param>
         public EditorSelectingState(NodifyEditor editor)
             : base(editor, EditorGestures.Mappings.Editor.Selection.Select, EditorGestures.Mappings.Editor.Selection.Cancel)
         {
@@ -23,7 +27,6 @@ protected override void OnBegin(InputEventArgs e)
             Element.BeginSelecting(selectionType);
         }
 
-        /// <inheritdoc />
         protected override void OnMouseMove(MouseEventArgs e)
             => Element.UpdateSelection(Element.MouseLocation);
 
diff --git a/Nodify/EditorStates/EditorZoomingState.cs b/Nodify/EditorStates/EditorZoomingState.cs
@@ -3,10 +3,16 @@
 
 namespace Nodify
 {
+    /// <summary>
+    /// Represents the zooming state of the <see cref="NodifyEditor"/>.
+    /// This state handles zooming operations using the mouse wheel with an optional modifier key.
+    /// </summary>
     public class EditorZoomingState : InputElementState<NodifyEditor>
     {
-        /// <summary>Constructs an instance of the <see cref="EditorZoomingState"/> state.</summary>
-        /// <param name="editor">The owner of the state.</param>
+        /// <summary>
+        /// Initializes a new instance of the <see cref="EditorZoomingState"/> class.
+        /// </summary>
+        /// <param name="editor">The <see cref="NodifyEditor"/> associated with this state.</param>
         public EditorZoomingState(NodifyEditor editor) : base(editor)
         {
         }
diff --git a/Nodify/EditorStates/InputElementState.cs b/Nodify/EditorStates/InputElementState.cs
diff --git a/Nodify/Helpers/DependencyObjectExtensions.cs b/Nodify/Helpers/DependencyObjectExtensions.cs
diff --git a/Nodify/InputProcessor.cs b/Nodify/InputProcessor.cs
diff --git a/Nodify/ItemContainer.cs b/Nodify/ItemContainer.cs

Original file line number	Diff line number	Diff line change
`@@ -13,6 +13,14 @@ public class SelectionGestures`
`13`	`13`	`/// <summary>Disable selection gestures.</summary>`
`14`	`14`	`public static readonly SelectionGestures None = new SelectionGestures(MouseAction.None);`
`15`	`15`
	`16`	`+ /// <summary>`
	`17`	`+ /// Initializes a new instance of the <see cref="SelectionGestures"/> class with specified mouse action`
	`18`	`+ /// and a flag indicating whether modifier keys should be ignored when releasing the mouse button.`
	`19`	`+ /// </summary>`
	`20`	`+ /// <param name="mouseAction">The mouse action to trigger the gestures.</param>`
	`21`	`+ /// <param name="ignoreModifierKeysOnRelease">`
	`22`	`+ /// A value indicating whether modifier keys (Alt, Shift, Control) should be ignored when the mouse button is released.`
	`23`	`+ /// </param>`
`16`	`24`	`public SelectionGestures(MouseAction mouseAction, bool ignoreModifierKeysOnRelease)`
`17`	`25`	`{`
`18`	`26`	`Replace = new MouseGesture(mouseAction);`
`@@ -23,16 +31,33 @@ public SelectionGestures(MouseAction mouseAction, bool ignoreModifierKeysOnRelea`
`23`	`31`	`Cancel = new KeyGesture(Key.Escape);`
`24`	`32`	`}`
`25`	`33`
	`34`	`+ /// <summary>`
	`35`	`+ /// Initializes a new instance of the <see cref="SelectionGestures"/> class with a specified mouse action.`
	`36`	`+ /// Modifier keys will be ignored when releasing the mouse button.`
	`37`	`+ /// </summary>`
	`38`	`+ /// <param name="mouseAction">The mouse action to trigger the gestures.</param>`
`26`	`39`	`public SelectionGestures(MouseAction mouseAction)`
`27`	`40`	`: this(mouseAction, true)`
`28`	`41`	`{`
`29`	`42`	`}`
`30`	`43`
	`44`	`+ /// <summary>`
	`45`	`+ /// Initializes a new instance of the <see cref="SelectionGestures"/> class with a flag indicating`
	`46`	`+ /// whether modifier keys should be ignored when releasing the mouse button.`
	`47`	`+ /// The default mouse action is <see cref="MouseAction.LeftClick"/>.`
	`48`	`+ /// </summary>`
	`49`	`+ /// <param name="ignoreModifierKeysOnRelease">`
	`50`	`+ /// A value indicating whether modifier keys (Alt, Shift, Control) should be ignored when the mouse button is released.`
	`51`	`+ /// </param>`
`31`	`52`	`public SelectionGestures(bool ignoreModifierKeysOnRelease)`
`32`	`53`	`: this(MouseAction.LeftClick, ignoreModifierKeysOnRelease)`
`33`	`54`	`{`
`34`	`55`	`}`
`35`	`56`
	`57`	`+ /// <summary>`
	`58`	`+ /// Initializes a new instance of the <see cref="SelectionGestures"/> class with default values:`
	`59`	`+ /// the mouse action is <see cref="MouseAction.LeftClick"/>, and modifier keys are ignored when releasing the mouse button.`
	`60`	`+ /// </summary>`
`36`	`61`	`public SelectionGestures() : this(true)`
`37`	`62`	`{`
`38`	`63`	`}`
Original file line number	Diff line number	Diff line change
`@@ -3,10 +3,18 @@`
`3`	`3`
`4`	`4`	`namespace Nodify`
`5`	`5`	`{`
	`6`	`+ /// <summary>`
	`7`	`+ /// Represents the state for handling a connector's connecting operation in the editor,`
	`8`	`+ /// enabling drag-based creation of connections between connectors.`
	`9`	`+ /// </summary>`
`6`	`10`	`public class ConnectorConnectingState : DragState<Connector>`
`7`	`11`	`{`
`8`	`12`	`protected override bool CanCancel => Connector.AllowPendingConnectionCancellation;`
`9`	`13`
	`14`	`+ /// <summary>`
	`15`	`+ /// Initializes a new instance of the <see cref="ConnectorConnectingState"/> class.`
	`16`	`+ /// </summary>`
	`17`	`+ /// <param name="connector">The connector associated with this state.</param>`
`10`	`18`	`public ConnectorConnectingState(Connector connector)`
`11`	`19`	`: base(connector, EditorGestures.Mappings.Connector.Connect, EditorGestures.Mappings.Connector.CancelAction)`
`12`	`20`	`{`
Original file line number	Diff line number	Diff line change
`@@ -2,8 +2,15 @@`
`2`	`2`
`3`	`3`	`namespace Nodify`
`4`	`4`	`{`
	`5`	`+ /// <summary>`
	`6`	`+ /// Represents a state in which a connector can be disconnected from its connections based on specific gestures.`
	`7`	`+ /// </summary>`
`5`	`8`	`public class ConnectorDisconnectState : InputElementState<Connector>`
`6`	`9`	`{`
	`10`	`+ /// <summary>`
	`11`	`+ /// Initializes a new instance of the <see cref="ConnectorDisconnectState"/> class.`
	`12`	`+ /// </summary>`
	`13`	`+ /// <param name="connector">The <see cref="Connector"/> element associated with this state.</param>`
`7`	`14`	`public ConnectorDisconnectState(Connector connector) : base(connector)`
`8`	`15`	`{`
`9`	`16`	`}`
Original file line number	Diff line number	Diff line change
`@@ -4,7 +4,7 @@`
`4`	`4`	`namespace Nodify`
`5`	`5`	`{`
`6`	`6`	`/// <summary>The default state of the <see cref="ItemContainer"/>.</summary>`
`7`		`- public class ContainerDefaultState : InputElementStateStack<ItemContainer>`
	`7`	`+ public sealed class ContainerDefaultState : InputElementStateStack<ItemContainer>`
`8`	`8`	`{`
`9`	`9`	`public ContainerDefaultState(ItemContainer container) : base(container)`
`10`	`10`	`{`
Original file line number	Diff line number	Diff line change
`@@ -4,7 +4,9 @@`
`4`	`4`
`5`	`5`	`namespace Nodify`
`6`	`6`	`{`
`7`		`- /// <summary>The panning state of the editor.</summary>`
	`7`	`+ /// <summary>`
	`8`	`+ /// Represents the panning state of the <see cref="NodifyEditor"/>, allowing the user to pan the viewport by clicking and dragging.`
	`9`	`+ /// </summary>`
`8`	`10`	`public class EditorPanningState : DragState<NodifyEditor>`
`9`	`11`	`{`
`10`	`12`	`protected override bool HasContextMenu => Element.HasContextMenu;`
`@@ -13,8 +15,10 @@ public class EditorPanningState : DragState<NodifyEditor>`
`13`	`15`
`14`	`16`	`private Point _prevPosition;`
`15`	`17`
`16`		`- /// <summary>Constructs an instance of the <see cref="EditorPanningState"/> state.</summary>`
`17`		`- /// <param name="editor">The owner of the state.</param>`
	`18`	`+ /// <summary>`
	`19`	`+ /// Initializes a new instance of the <see cref="EditorPanningState"/> class.`
	`20`	`+ /// </summary>`
	`21`	`+ /// <param name="editor">The <see cref="NodifyEditor"/> associated with this state.</param>`
`18`	`22`	`public EditorPanningState(NodifyEditor editor)`
`19`	`23`	`: base(editor, EditorGestures.Mappings.Editor.Pan, EditorGestures.Mappings.Editor.CancelAction)`
`20`	`24`	`{`
`@@ -26,7 +30,6 @@ protected override void OnBegin(InputEventArgs e)`
`26`	`30`	`Element.BeginPanning();`
`27`	`31`	`}`
`28`	`32`
`29`		`- /// <inheritdoc />`
`30`	`33`	`protected override void OnMouseMove(MouseEventArgs e)`
`31`	`34`	`{`
`32`	`35`	`var currentMousePosition = e.GetPosition(Element);`
`@@ -41,10 +44,16 @@ protected override void OnCancel(InputEventArgs e)`
`41`	`44`	`=> Element.CancelPanning();`
`42`	`45`	`}`
`43`	`46`
	`47`	`+ /// <summary>`
	`48`	`+ /// Represents the panning state of the <see cref="NodifyEditor"/> using the mouse wheel.`
	`49`	`+ /// Allows the user to pan horizontally or vertically by holding modifier keys while scrolling the mouse wheel.`
	`50`	`+ /// </summary>`
`44`	`51`	`public class EditorPanningWithMouseWheelState : InputElementState<NodifyEditor>`
`45`	`52`	`{`
`46`		`- /// <summary>Constructs an instance of the <see cref="EditorPanningWithMouseWheelState"/> state.</summary>`
`47`		`- /// <param name="editor">The owner of the state.</param>`
	`53`	`+ /// <summary>`
	`54`	`+ /// Initializes a new instance of the <see cref="EditorPanningWithMouseWheelState"/> class.`
	`55`	`+ /// </summary>`
	`56`	`+ /// <param name="editor">The <see cref="NodifyEditor"/> associated with this state.</param>`
`48`	`57`	`public EditorPanningWithMouseWheelState(NodifyEditor editor) : base(editor)`
`49`	`58`	`{`
`50`	`59`	`}`
Original file line number	Diff line number	Diff line change
`@@ -5,13 +5,20 @@`
`5`	`5`
`6`	`6`	`namespace Nodify`
`7`	`7`	`{`
	`8`	`+ /// <summary>`
	`9`	`+ /// Represents the state of the <see cref="NodifyEditor"/> during a "push items" operation, allowing users to move items within the editor by dragging.`
	`10`	`+ /// </summary>`
`8`	`11`	`public class EditorPushingItemsState : DragState<NodifyEditor>`
`9`	`12`	`{`
`10`	`13`	`protected override bool HasContextMenu => Element.HasContextMenu;`
`11`	`14`	`protected override bool CanCancel => NodifyEditor.AllowPushItemsCancellation;`
`12`	`15`
`13`	`16`	`private Point _prevPosition;`
`14`	`17`
	`18`	`+ /// <summary>`
	`19`	`+ /// Initializes a new instance of the <see cref="EditorPushingItemsState"/> class.`
	`20`	`+ /// </summary>`
	`21`	`+ /// <param name="editor">The <see cref="NodifyEditor"/> associated with this state.</param>`
`15`	`22`	`public EditorPushingItemsState(NodifyEditor editor)`
`16`	`23`	`: base(editor, EditorGestures.Mappings.Editor.PushItems, EditorGestures.Mappings.Editor.CancelAction)`
`17`	`24`	`{`
`@@ -20,7 +27,6 @@ public EditorPushingItemsState(NodifyEditor editor)`
`20`	`27`	`protected override void OnBegin(InputEventArgs e)`
`21`	`28`	`=> _prevPosition = Element.MouseLocation;`
`22`	`29`
`23`		`- /// <inheritdoc />`
`24`	`30`	`protected override void OnMouseMove(MouseEventArgs e)`
`25`	`31`	`{`
`26`	`32`	`if (Element.IsPushingItems)`
Original file line number	Diff line number	Diff line change
`@@ -3,10 +3,16 @@`
`3`	`3`
`4`	`4`	`namespace Nodify`
`5`	`5`	`{`
	`6`	`+ /// <summary>`
	`7`	`+ /// Represents the zooming state of the <see cref="NodifyEditor"/>.`
	`8`	`+ /// This state handles zooming operations using the mouse wheel with an optional modifier key.`
	`9`	`+ /// </summary>`
`6`	`10`	`public class EditorZoomingState : InputElementState<NodifyEditor>`
`7`	`11`	`{`
`8`		`- /// <summary>Constructs an instance of the <see cref="EditorZoomingState"/> state.</summary>`
`9`		`- /// <param name="editor">The owner of the state.</param>`
	`12`	`+ /// <summary>`
	`13`	`+ /// Initializes a new instance of the <see cref="EditorZoomingState"/> class.`
	`14`	`+ /// </summary>`
	`15`	`+ /// <param name="editor">The <see cref="NodifyEditor"/> associated with this state.</param>`
`10`	`16`	`public EditorZoomingState(NodifyEditor editor) : base(editor)`
`11`	`17`	`{`
`12`	`18`	`}`