Feature: Firewall app (#3383)

* Feature: Firewall app

* Update Source/NETworkManager.Models/Firewall/FirewallRule.cs

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Fix XML doc comments for Id/Name properties in FirewallRule.cs

Agent-Logs-Url: https://github.com/BornToBeRoot/NETworkManager/sessions/5215e397-497d-4847-a3f7-a7454cafebb3

Co-authored-by: BornToBeRoot <16019165+BornToBeRoot@users.noreply.github.com>

* Feature: Add translation

* Feature: Add translation and export

* Feature: Add network profile to networkinterfaceview

* Docs: #3383

* Chore: Hide firewall settings/profile

* Chore: Refactor the UI

* Feature: UI & Copy data

* Chore: UI redesign

* Docs: Discovery Protocol

* Update package.json

* Update yarn.lock

* Feature: Enable/Disable/Delete Firewall rule

* Feature: Open Hosts File Editor

* Feature: Firewall add / edit firewall rule

* Chore: Adjust strings

* Feature:  Firewall edit/del + docs

* Fix: Copilot feedback

* Fix: More firewall validations

* dotnet format

* Update firewall.md

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>

Author: 3 people

Source/NETworkManager.Converters/FirewallInterfaceTypeToStringConverter.cs

@@ -0,0 +1,41 @@
+using System;
+using System.Globalization;
+using System.Windows.Data;
+using NETworkManager.Localization;
+using NETworkManager.Models.Firewall;
+
+namespace NETworkManager.Converters;
+
+/// <summary>
+///     Convert <see cref="FirewallInterfaceType" /> to translated <see cref="string" /> or vice versa.
+/// </summary>
+public sealed class FirewallInterfaceTypeToStringConverter : IValueConverter
+{
+    /// <summary>
+    ///     Convert <see cref="FirewallInterfaceType" /> to translated <see cref="string" />.
+    /// </summary>
+    /// <param name="value">Object from type <see cref="FirewallInterfaceType" />.</param>
+    /// <param name="targetType"></param>
+    /// <param name="parameter"></param>
+    /// <param name="culture"></param>
+    /// <returns>Translated <see cref="FirewallInterfaceType" />.</returns>
+    public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
+    {
+        return value is not FirewallInterfaceType interfaceType
+            ? "-/-"
+            : ResourceTranslator.Translate(ResourceIdentifier.FirewallInterfaceType, interfaceType);
+    }
+
+    /// <summary>
+    ///     !!! Method not implemented !!!
+    /// </summary>
+    /// <param name="value"></param>
+    /// <param name="targetType"></param>
+    /// <param name="parameter"></param>
+    /// <param name="culture"></param>
+    /// <returns></returns>
+    public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
+    {
+        throw new NotImplementedException();
+    }
+}

Source/NETworkManager.Converters/FirewallNetworkProfilesToStringConverter.cs

@@ -0,0 +1,48 @@
+using System;
+using System.Collections.Generic;
+using System.Globalization;
+using System.Windows.Data;
+using NETworkManager.Localization.Resources;
+
+namespace NETworkManager.Converters;
+
+/// <summary>
+///     Convert a <see cref="bool" /> array (Domain, Private, Public) representing firewall network
+///     profiles to a localized <see cref="string" />, or vice versa.
+/// </summary>
+public sealed class FirewallNetworkProfilesToStringConverter : IValueConverter
+{
+    /// <summary>
+    ///     Convert a <see cref="bool" /> array (Domain, Private, Public) to a localized <see cref="string" />.
+    ///     Returns the localized "Any" label when all three profiles are active or none are active,
+    ///     since both cases are treated as "Any" by the Windows Firewall PowerShell layer.
+    /// </summary>
+    /// <param name="value">A <see cref="bool" /> array with exactly three elements.</param>
+    /// <param name="targetType"></param>
+    /// <param name="parameter"></param>
+    /// <param name="culture"></param>
+    /// <returns>Localized, comma-separated profile list (e.g. "Domain, Private, Public"), or "Any".</returns>
+    public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
+    {
+        if (value is not bool[] { Length: 3 } profiles)
+            return "-/-";
+
+        if ((profiles[0] && profiles[1] && profiles[2]) || (!profiles[0] && !profiles[1] && !profiles[2]))
+            return Strings.Any;
+
+        var names = new List<string>(3);
+        if (profiles[0]) names.Add(Strings.Domain);
+        if (profiles[1]) names.Add(Strings.Private);
+        if (profiles[2]) names.Add(Strings.Public);
+
+        return string.Join(", ", names);
+    }
+
+    /// <summary>
+    ///     !!! Method not implemented !!!
+    /// </summary>
+    public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
+    {
+        throw new NotImplementedException();
+    }
+}

Source/NETworkManager.Converters/FirewallProtocolToStringConverter.cs

@@ -0,0 +1,41 @@
+using System;
+using System.Globalization;
+using System.Windows.Data;
+using NETworkManager.Localization;
+using NETworkManager.Models.Firewall;
+
+namespace NETworkManager.Converters;
+
+/// <summary>
+///     Convert <see cref="FirewallProtocol" /> to translated <see cref="string" /> or vice versa.
+/// </summary>
+public sealed class FirewallProtocolToStringConverter : IValueConverter
+{
+    /// <summary>
+    ///     Convert <see cref="FirewallProtocol" /> to translated <see cref="string" />.
+    /// </summary>
+    /// <param name="value">Object from type <see cref="FirewallProtocol" />.</param>
+    /// <param name="targetType"></param>
+    /// <param name="parameter"></param>
+    /// <param name="culture"></param>
+    /// <returns>Translated <see cref="FirewallProtocol" />.</returns>
+    public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
+    {
+        return value is not FirewallProtocol protocol
+            ? "-/-"
+            : ResourceTranslator.Translate(ResourceIdentifier.FirewallProtocol, protocol);
+    }
+
+    /// <summary>
+    ///     !!! Method not implemented !!!
+    /// </summary>
+    /// <param name="value"></param>
+    /// <param name="targetType"></param>
+    /// <param name="parameter"></param>
+    /// <param name="culture"></param>
+    /// <returns></returns>
+    public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
+    {
+        throw new NotImplementedException();
+    }
+}

Source/NETworkManager.Converters/FirewallRuleActionToStringConverter.cs

@@ -0,0 +1,41 @@
+using System;
+using System.Globalization;
+using System.Windows.Data;
+using NETworkManager.Localization;
+using NETworkManager.Models.Firewall;
+
+namespace NETworkManager.Converters;
+
+/// <summary>
+///     Convert <see cref="FirewallRuleAction" /> to translated <see cref="string" /> or vice versa.
+/// </summary>
+public sealed class FirewallRuleActionToStringConverter : IValueConverter
+{
+    /// <summary>
+    ///     Convert <see cref="FirewallRuleAction" /> to translated <see cref="string" />.
+    /// </summary>
+    /// <param name="value">Object from type <see cref="FirewallRuleAction" />.</param>
+    /// <param name="targetType"></param>
+    /// <param name="parameter"></param>
+    /// <param name="culture"></param>
+    /// <returns>Translated <see cref="FirewallRuleAction" />.</returns>
+    public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
+    {
+        return value is not FirewallRuleAction action
+            ? "-/-"
+            : ResourceTranslator.Translate(ResourceIdentifier.FirewallRuleAction, action);
+    }
+
+    /// <summary>
+    ///     !!! Method not implemented !!!
+    /// </summary>
+    /// <param name="value"></param>
+    /// <param name="targetType"></param>
+    /// <param name="parameter"></param>
+    /// <param name="culture"></param>
+    /// <returns></returns>
+    public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
+    {
+        throw new NotImplementedException();
+    }
+}

Source/NETworkManager.Converters/FirewallRuleDirectionToStringConverter.cs

@@ -0,0 +1,41 @@
+using System;
+using System.Globalization;
+using System.Windows.Data;
+using NETworkManager.Localization;
+using NETworkManager.Models.Firewall;
+
+namespace NETworkManager.Converters;
+
+/// <summary>
+///     Convert <see cref="FirewallRuleDirection" /> to translated <see cref="string" /> or vice versa.
+/// </summary>
+public sealed class FirewallRuleDirectionToStringConverter : IValueConverter
+{
+    /// <summary>
+    ///     Convert <see cref="FirewallRuleDirection" /> to translated <see cref="string" />.
+    /// </summary>
+    /// <param name="value">Object from type <see cref="FirewallRuleDirection" />.</param>
+    /// <param name="targetType"></param>
+    /// <param name="parameter"></param>
+    /// <param name="culture"></param>
+    /// <returns>Translated <see cref="FirewallRuleDirection" />.</returns>
+    public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
+    {
+        return value is not FirewallRuleDirection direction
+            ? "-/-"
+            : ResourceTranslator.Translate(ResourceIdentifier.FirewallRuleDirection, direction);
+    }
+
+    /// <summary>
+    ///     !!! Method not implemented !!!
+    /// </summary>
+    /// <param name="value"></param>
+    /// <param name="targetType"></param>
+    /// <param name="parameter"></param>
+    /// <param name="culture"></param>
+    /// <returns></returns>
+    public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
+    {
+        throw new NotImplementedException();
+    }
+}

Source/NETworkManager.Converters/NetworkProfileToStringConverter.cs

@@ -0,0 +1,42 @@
+using System;
+using System.Globalization;
+using System.Windows.Data;
+using NETworkManager.Localization.Resources;
+using NETworkManager.Models.Network;
+
+namespace NETworkManager.Converters;
+
+/// <summary>
+///     Convert <see cref="NetworkProfile" /> to a localized <see cref="string" /> or vice versa.
+/// </summary>
+public sealed class NetworkProfileToStringConverter : IValueConverter
+{
+    /// <summary>
+    ///     Convert <see cref="NetworkProfile" /> to a localized <see cref="string" />.
+    /// </summary>
+    /// <param name="value">Object from type <see cref="NetworkProfile" />.</param>
+    /// <param name="targetType"></param>
+    /// <param name="parameter"></param>
+    /// <param name="culture"></param>
+    /// <returns>Localized <see cref="string" /> representing the network profile.</returns>
+    public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
+    {
+        return value is not NetworkProfile profile
+            ? "-/-"
+            : profile switch
+            {
+                NetworkProfile.Domain => Strings.Domain,
+                NetworkProfile.Private => Strings.Private,
+                NetworkProfile.Public => Strings.Public,
+                _ => "-/-"
+            };
+    }
+
+    /// <summary>
+    ///     !!! Method not implemented !!!
+    /// </summary>
+    public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
+    {
+        throw new NotImplementedException();
+    }
+}

Source/NETworkManager.Documentation/DocumentationManager.cs

@@ -267,7 +267,6 @@ public static DocumentationIdentifier GetIdentifierBySettingsName(SettingsName n
             SettingsName.WebConsole => GetIdentifierByApplicationName(ApplicationName.WebConsole),
             SettingsName.SNMP => GetIdentifierByApplicationName(ApplicationName.SNMP),
             SettingsName.SNTPLookup => GetIdentifierByApplicationName(ApplicationName.SNTPLookup),
-            SettingsName.Firewall => GetIdentifierByApplicationName(ApplicationName.Firewall),
             SettingsName.WakeOnLAN => GetIdentifierByApplicationName(ApplicationName.WakeOnLAN),
             SettingsName.BitCalculator => GetIdentifierByApplicationName(ApplicationName.BitCalculator),
             _ => DocumentationIdentifier.Default

Source/NETworkManager.Localization/ResourceIdentifier.cs

@@ -22,5 +22,9 @@ public enum ResourceIdentifier
     TcpState,
     Theme,
     TimeUnit,
-    WiFiConnectionStatus
+    WiFiConnectionStatus,
+    FirewallProtocol,
+    FirewallInterfaceType,
+    FirewallRuleDirection,
+    FirewallRuleAction
 }

Source/NETworkManager.Localization/Resources/StaticStrings.Designer.cs

@@ -342,4 +342,10 @@
   <data name="ExampleFqdnOrIPAddressPublic" xml:space="preserve">
     <value>borntoberoot.net or 1.1.1.1</value>
   </data>
+  <data name="ExampleFirewallRuleName" xml:space="preserve">
+    <value>MyApp - HTTP</value>
+  </data>
+  <data name="ExampleFirewallAddresses" xml:space="preserve">
+    <value>10.0.0.0/8; LocalSubnet</value>
+  </data>
 </root>