Add MVVM data binding: INotifyPropertyChanged on all controls, Bind/BindTwoWay API

BaseControl implements INotifyPropertyChanged with SetProperty() pattern.
Migrate 134 property setters across 26 controls. Add DataBinding namespace
with one-way, two-way, and converter bindings. Builders support deferred
bindings via IControlBuilder<T>.

Author: nickprotop

SharpConsoleUI/Builders/BarGraphBuilder.cs

@@ -7,6 +7,7 @@
 // -----------------------------------------------------------------------
 
 using SharpConsoleUI.Controls;
+using SharpConsoleUI.DataBinding;
 using SharpConsoleUI.Helpers;
 using SharpConsoleUI.Layout;
 
@@ -15,7 +16,7 @@ namespace SharpConsoleUI.Builders
 	/// <summary>
 	/// Fluent builder for creating BarGraphControl instances.
 	/// </summary>
-	public class BarGraphBuilder
+	public class BarGraphBuilder : IControlBuilder<BarGraphControl>
 	{
 		private readonly BarGraphControl _control;
 
@@ -272,6 +273,7 @@ public BarGraphBuilder WithSmoothGradient(params Color[] colors)
 		/// </summary>
 		public BarGraphControl Build()
 		{
+			BindingHelper.ApplyDeferredBindings(this, _control);
 			return _control;
 		}
 	}

SharpConsoleUI/Builders/ButtonBuilder.cs

@@ -7,6 +7,7 @@
 // -----------------------------------------------------------------------
 
 using SharpConsoleUI.Controls;
+using SharpConsoleUI.DataBinding;
 using SharpConsoleUI.Events;
 using SharpConsoleUI.Extensions;
 using SharpConsoleUI.Layout;
@@ -18,7 +19,7 @@ namespace SharpConsoleUI.Builders;
 /// <summary>
 /// Fluent builder for button controls
 /// </summary>
-public sealed class ButtonBuilder
+public sealed class ButtonBuilder : IControlBuilder<ButtonControl>
 {
 	private string _text = "Button";
 	private HorizontalAlignment _alignment = HorizontalAlignment.Left;
@@ -456,6 +457,7 @@ public ButtonControl Build()
 			};
 		}
 
+		BindingHelper.ApplyDeferredBindings(this, button);
 		return button;
 	}
 

SharpConsoleUI/Builders/CheckboxBuilder.cs

@@ -7,6 +7,7 @@
 // -----------------------------------------------------------------------
 
 using SharpConsoleUI.Controls;
+using SharpConsoleUI.DataBinding;
 using SharpConsoleUI.Events;
 using SharpConsoleUI.Extensions;
 using SharpConsoleUI.Layout;
@@ -16,7 +17,7 @@ namespace SharpConsoleUI.Builders;
 /// <summary>
 /// Fluent builder for checkbox controls
 /// </summary>
-public sealed class CheckboxBuilder
+public sealed class CheckboxBuilder : IControlBuilder<CheckboxControl>
 {
 	private string _label = "Checkbox";
 	private bool _isChecked = false;
@@ -278,6 +279,7 @@ public CheckboxControl Build()
 			};
 		}
 
+		BindingHelper.ApplyDeferredBindings(this, checkbox);
 		return checkbox;
 	}
 

SharpConsoleUI/Builders/DropdownBuilder.cs

@@ -7,6 +7,7 @@
 // -----------------------------------------------------------------------
 
 using SharpConsoleUI.Controls;
+using SharpConsoleUI.DataBinding;
 using SharpConsoleUI.Events;
 using SharpConsoleUI.Extensions;
 using SharpConsoleUI.Layout;
@@ -16,7 +17,7 @@ namespace SharpConsoleUI.Builders;
 /// <summary>
 /// Fluent builder for dropdown controls
 /// </summary>
-public sealed class DropdownBuilder
+public sealed class DropdownBuilder : IControlBuilder<DropdownControl>
 {
 	private readonly List<DropdownItem> _items = new();
 	private string _prompt = "Select...";
@@ -393,6 +394,7 @@ public DropdownControl Build()
 			};
 		}
 
+		BindingHelper.ApplyDeferredBindings(this, dropdown);
 		return dropdown;
 	}
 

SharpConsoleUI/Builders/FigleControlBuilder.cs

@@ -7,6 +7,7 @@
 // -----------------------------------------------------------------------
 
 using SharpConsoleUI.Controls;
+using SharpConsoleUI.DataBinding;
 using SharpConsoleUI.Layout;
 using SharpConsoleUI.Parsing;
 
@@ -15,7 +16,7 @@ namespace SharpConsoleUI.Builders;
 /// <summary>
 /// Fluent builder for Figlet ASCII art controls
 /// </summary>
-public sealed class FigleControlBuilder
+public sealed class FigleControlBuilder : IControlBuilder<FigleControl>
 {
 	private string? _text;
 	private Color? _color;
@@ -289,6 +290,7 @@ public FigleControl Build()
 		if (_color.HasValue)
 			control.Color = _color.Value;
 
+		BindingHelper.ApplyDeferredBindings(this, control);
 		return control;
 	}
 

SharpConsoleUI/Builders/HorizontalGridBuilder.cs

@@ -7,6 +7,7 @@
 // -----------------------------------------------------------------------
 
 using SharpConsoleUI.Controls;
+using SharpConsoleUI.DataBinding;
 using SharpConsoleUI.Layout;
 
 namespace SharpConsoleUI.Builders
@@ -24,7 +25,7 @@ namespace SharpConsoleUI.Builders
 	///     .Build();
 	/// </code>
 	/// </example>
-	public class HorizontalGridBuilder
+	public class HorizontalGridBuilder : IControlBuilder<HorizontalGridControl>
 	{
 		private readonly HorizontalGridControl _grid = new();
 		private readonly List<ColumnConfiguration> _columns = new();
@@ -245,6 +246,7 @@ public HorizontalGridControl Build()
 				_grid.AddSplitter(index, new SplitterControl());
 			}
 
+			BindingHelper.ApplyDeferredBindings(this, _grid);
 			return _grid;
 		}
 

SharpConsoleUI/Builders/ListBuilder.cs

@@ -7,6 +7,7 @@
 // -----------------------------------------------------------------------
 
 using SharpConsoleUI.Controls;
+using SharpConsoleUI.DataBinding;
 using SharpConsoleUI.Events;
 using SharpConsoleUI.Extensions;
 using SharpConsoleUI.Layout;
@@ -17,7 +18,7 @@ namespace SharpConsoleUI.Builders;
 /// <summary>
 /// Fluent builder for list controls
 /// </summary>
-public sealed class ListBuilder
+public sealed class ListBuilder : IControlBuilder<ListControl>
 {
 	private readonly List<ListItem> _items = new();
 	private string _title = "List";
@@ -724,6 +725,7 @@ public ListControl Build()
 			};
 		}
 
+		BindingHelper.ApplyDeferredBindings(this, list);
 		return list;
 	}
 

SharpConsoleUI/Builders/MarkupBuilder.cs

@@ -7,6 +7,7 @@
 // -----------------------------------------------------------------------
 
 using SharpConsoleUI.Controls;
+using SharpConsoleUI.DataBinding;
 using SharpConsoleUI.Events;
 using SharpConsoleUI.Extensions;
 using SharpConsoleUI.Layout;
@@ -16,7 +17,7 @@ namespace SharpConsoleUI.Builders;
 /// <summary>
 /// Fluent builder for markup controls
 /// </summary>
-public sealed class MarkupBuilder
+public sealed class MarkupBuilder : IControlBuilder<MarkupControl>
 {
 	private readonly List<string> _lines = new();
 	private HorizontalAlignment _alignment = HorizontalAlignment.Left;
@@ -302,6 +303,7 @@ public MarkupControl Build()
 			ForegroundColor = _foregroundColor
 		};
 
+		BindingHelper.ApplyDeferredBindings(this, markup);
 		return markup;
 	}
 

SharpConsoleUI/Builders/MenuBuilder.cs

@@ -1,12 +1,13 @@
 using SharpConsoleUI.Controls;
+using SharpConsoleUI.DataBinding;
 using SharpConsoleUI.Events;
 
 namespace SharpConsoleUI.Builders;
 
 /// <summary>
 /// Fluent builder for creating MenuControl instances with a clean, chainable API.
 /// </summary>
-public class MenuBuilder
+public class MenuBuilder : IControlBuilder<MenuControl>
 {
     private MenuOrientation _orientation = MenuOrientation.Horizontal;
     private readonly List<MenuItem> _items = new();
@@ -319,6 +320,7 @@ public MenuControl Build()
         if (_itemHoveredHandler != null)
             menu.ItemHovered += _itemHoveredHandler;
 
+        BindingHelper.ApplyDeferredBindings(this, menu);
         return menu;
     }
 

SharpConsoleUI/Builders/MultilineEditControlBuilder.cs

@@ -7,6 +7,7 @@
 // -----------------------------------------------------------------------
 
 using SharpConsoleUI.Controls;
+using SharpConsoleUI.DataBinding;
 using SharpConsoleUI.Events;
 using SharpConsoleUI.Extensions;
 using SharpConsoleUI.Layout;
@@ -16,7 +17,7 @@ namespace SharpConsoleUI.Builders;
 /// <summary>
 /// Fluent builder for multiline edit controls
 /// </summary>
-public sealed class MultilineEditControlBuilder
+public sealed class MultilineEditControlBuilder : IControlBuilder<MultilineEditControl>
 {
 	private int _viewportHeight = Configuration.ControlDefaults.DefaultEditorViewportHeight;
 	private string? _content;
@@ -812,6 +813,7 @@ public MultilineEditControl Build()
 			};
 		}
 
+		BindingHelper.ApplyDeferredBindings(this, control);
 		return control;
 	}