Feature: Added experimental terminal integration

src/Files.App.Controls/GridSplitter/GridSplitter.Events.cs

@@ -159,6 +159,29 @@ protected override void OnManipulationCompleted(ManipulationCompletedRoutedEvent
 			base.OnManipulationCompleted(e);
 		}
 
+		/// <inheritdoc />
+		protected override void OnPointerEntered(PointerRoutedEventArgs e)
+		{
+			if (_resizeDirection == GridResizeDirection.Auto)
+				_resizeDirection = GetResizeDirection();
+
+			if (PreviousCursor is null)
+				PreviousCursor = ProtectedCursor;
+
+			ProtectedCursor = _resizeDirection == GridResizeDirection.Rows
+				? RowSplitterCursor
+				: ColumnsSplitterCursor;
+
+			base.OnPointerEntered(e);
+		}
+
+		/// <inheritdoc />
+		protected override void OnPointerExited(PointerRoutedEventArgs e)
+		{
+			ProtectedCursor = PreviousCursor;
+			base.OnPointerExited(e);
+		}
+
 		/// <inheritdoc />
 		protected override void OnManipulationDelta(ManipulationDeltaRoutedEventArgs e)
 		{

src/Files.App.CsWin32/NativeMethods.txt

@@ -6,6 +6,7 @@ WNDCLASSEXW
 RegisterClassEx
 CreateWindowEx
 DestroyWindow
+ShowWindow
 GetModuleHandle
 RECT
 NOTIFYICONIDENTIFIER
@@ -115,7 +116,6 @@ WindowsCreateString
 WindowsDeleteString
 IPreviewHandler
 AssocQueryString
-GetModuleHandle
 SHEmptyRecycleBin
 SHFileOperation
 SHGetFolderPath
@@ -137,15 +137,12 @@ COMPRESSION_FORMAT
 FILE_ACCESS_RIGHTS
 FindFirstFileEx
 FindNextFile
-CreateFile
 GetFileSizeEx
 WIN32_FIND_DATAW
-FILE_ACCESS_RIGHTS
 SHAddToRecentDocs
 SHARD
 BHID_EnumItems
 FOLDERID_RecycleBinFolder
-CoTaskMemFree
 SHGetIDListFromObject
 SHCreateItemFromIDList
 BHID_SFUIObject
@@ -160,7 +157,6 @@ IApplicationDocumentLists
 ApplicationDocumentLists
 IApplicationActivationManager
 MENU_ITEM_TYPE
-COMPRESSION_FORMAT
 FSCTL_SET_COMPRESSION
 FSCTL_DISMOUNT_VOLUME
 FSCTL_LOCK_VOLUME
@@ -266,3 +262,25 @@ HCERTSTORE
 CERT_QUERY_ENCODING_TYPE
 CertGetNameString
 MessageBox
+// Console api
+AllocConsole
+GetConsoleWindow
+GetStdHandle
+SetConsoleMode
+GetConsoleMode
+COORD
+CreatePseudoConsole
+ResizePseudoConsole
+ClosePseudoConsole
+CreatePipe
+PROC_THREAD_ATTRIBUTE_PSEUDOCONSOLE
+STARTUPINFOEXW
+STARTUPINFOW
+PROCESS_CREATION_FLAGS
+PROCESS_INFORMATION
+SECURITY_ATTRIBUTES
+CloseHandle
+DeleteProcThreadAttributeList
+UpdateProcThreadAttribute
+InitializeProcThreadAttributeList
+CreateProcess

src/Files.App/Actions/Show/ToggleTerminalPaneAction.cs

@@ -0,0 +1,60 @@
+// Copyright (c) Files Community
+// Licensed under the MIT License.
+
+namespace Files.App.Actions
+{
+	[GeneratedRichCommand]
+	internal sealed partial class ToggleTerminalPaneAction : ObservableObject, IToggleAction
+	{
+		private readonly IGeneralSettingsService generalSettingsService = Ioc.Default.GetRequiredService<IGeneralSettingsService>();
+		private readonly MainPageViewModel mainPageViewModel = Ioc.Default.GetRequiredService<MainPageViewModel>();
+
+		public string Label
+			=> Strings.ToggleTerminalPane.GetLocalizedResource();
+
+		public string Description
+			=> Strings.ToggleTerminalPaneDescription.GetLocalizedResource();
+
+		public ActionCategory Category
+			=> ActionCategory.Show;
+
+		public RichGlyph Glyph
+			=> new("\uE756");
+
+		public bool IsAccessibleGlobally
+			=> AppLifecycleHelper.AppEnvironment is AppEnvironment.Dev && generalSettingsService.IsTerminalIntegrationEnabled;
+
+		public bool IsExecutable
+			=> AppLifecycleHelper.AppEnvironment is AppEnvironment.Dev && generalSettingsService.IsTerminalIntegrationEnabled;
+
+		public bool IsOn
+			=> mainPageViewModel.IsTerminalViewOpen;
+
+		public ToggleTerminalPaneAction()
+		{
+			generalSettingsService.PropertyChanged += GeneralSettingsService_PropertyChanged;
+			mainPageViewModel.PropertyChanged += MainPageViewModel_PropertyChanged;
+		}
+
+		public Task ExecuteAsync(object? parameter = null)
+		{
+			mainPageViewModel.TerminalToggleCommand.Execute(null);
+			return Task.CompletedTask;
+		}
+
+		private void GeneralSettingsService_PropertyChanged(object? sender, PropertyChangedEventArgs e)
+		{
+			if (e.PropertyName is nameof(GeneralSettingsService.IsTerminalIntegrationEnabled))
+			{
+				OnPropertyChanged(nameof(IsExecutable));
+				OnPropertyChanged(nameof(IsAccessibleGlobally));
+			}
+		}
+
+		private void MainPageViewModel_PropertyChanged(object? sender, PropertyChangedEventArgs e)
+		{
+			if (e.PropertyName is nameof(MainPageViewModel.IsTerminalViewOpen))
+				OnPropertyChanged(nameof(IsOn));
+		}
+	}
+}

src/Files.App/Data/Contracts/IGeneralSettingsService.cs

@@ -280,6 +280,11 @@ public interface IGeneralSettingsService : IBaseSettingsService, INotifyProperty
 		/// </summary>
 		bool ShowSystemTrayIcon { get; set; }
 
+		/// <summary>
+		/// Gets or sets a value indicating whether to enable terminal integration.
+		/// </summary>
+		bool IsTerminalIntegrationEnabled { get; set; }
+
 		/// <summary>
 		/// Gets or sets a value indicating the default option to resolve conflicts.
 		/// </summary>

src/Files.App/Data/Models/TerminalModel.cs

@@ -0,0 +1,21 @@
+using Microsoft.UI.Xaml.Controls;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace Files.App.Data.Models
+{
+	public class TerminalModel : IDisposable
+	{
+		public string Id { get; init; }
+		public string Name { get; init; }
+		public Control Control { get; init; }
+
+		public void Dispose()
+		{
+			(Control as IDisposable)?.Dispose();
+		}
+	}
+}

src/Files.App/Extensions/StringExtensions.cs

@@ -55,6 +55,14 @@ public static string WithEnding(this string str, string ending)
 			return result;
 		}
 
+		/// <summary>
+		/// Compares two strings for equality, but assumes that null string is equal to an empty string.
+		/// </summary>
+		public static bool NullableEqualTo(this string original, string other,
+			StringComparison stringComparison = StringComparison.Ordinal) => string.IsNullOrEmpty(original)
+			? string.IsNullOrEmpty(other)
+			: original.Equals(other, stringComparison);
+
 		private static readonly ResourceMap resourcesTree = new ResourceManager().MainResourceMap.TryGetSubtree("Resources");
 
 		private static readonly ConcurrentDictionary<string, string> cachedResources = new();

src/Files.App/Extensions/WebView2Extensions.cs

@@ -0,0 +1,149 @@
+// Copyright (c) Mahmoud Al-Qudsi, NeoSmart Technoogies. All rights reserved.  
+// Licensed under the MIT License.
+
+using CommunityToolkit.WinUI;
+using Microsoft.UI.Xaml.Controls;
+using Microsoft.Web.WebView2.Core;
+using System.Reflection;
+using System.Text;
+using System.Text.Encodings.Web;
+using Windows.Foundation;
+
+namespace Files.App.Extensions
+{
+	using WebViewMessageReceivedHandler = TypedEventHandler<WebView2, CoreWebView2WebMessageReceivedEventArgs>;
+
+	/// <summary>
+	/// Code modified from https://gist.github.com/mqudsi/ceb4ecee76eb4c32238a438664783480
+	/// </summary>
+	public static class WebView2Extensions
+	{
+		public static void Navigate(this WebView2 webview, Uri url)
+		{
+			webview.Source = url;
+		}
+
+		private struct WebMessage
+		{
+			public Guid Guid { get; set; }
+		}
+
+		private struct MethodWebMessage
+		{
+			public long Id { get; set; }
+			public string Method { get; set; }
+			public string Args { get; set; }
+		}
+
+		private static readonly JsonSerializerOptions _caseInsensitiveOptions = new() { PropertyNameCaseInsensitive = true };
+		private static readonly JsonSerializerOptions _unsafeRelaxedOptions = new() { Encoder = JavaScriptEncoder.UnsafeRelaxedJsonEscaping };
+
+		public static List<WebViewMessageReceivedHandler> _handlers = new();
+		public static async Task AddWebAllowedObject<T>(this WebView2 webview, string name, T @object)
+		{
+			var sb = new StringBuilder();
+			sb.AppendLine($"window.{name} = {{ ");
+
+			var methodsGuid = Guid.NewGuid();
+			var methodInfo = typeof(T).GetMethods(BindingFlags.Public | BindingFlags.Instance);
+			var methods = new Dictionary<string, MethodInfo>(methodInfo.Length);
+			foreach (var method in methodInfo)
+			{
+				var functionName = $"{char.ToLower(method.Name[0])}{method.Name.Substring(1)}";
+				sb.AppendLine($@"{functionName}: function() {{ window.chrome.webview.postMessage(JSON.stringify({{ guid: ""{methodsGuid}"", id: this._callbackIndex++, method: ""{functionName}"", args: JSON.stringify([...arguments]) }})); const promise = new Promise((accept, reject) => this._callbacks.set(this._callbackIndex, {{ accept: accept, reject: reject }})); return promise; }},");
+				methods.Add(functionName, method);
+			}
+
+			sb.AppendLine($@"_callbacks: new Map(),");
+			sb.Append($@"_callbackIndex: 0,");
+			sb.AppendLine("}");
+
+			try
+			{
+				await webview.ExecuteScriptAsync($"{sb}").AsTask();
+			}
+			catch (Exception)
+			{
+			}
+
+			var handler = (WebViewMessageReceivedHandler)(async (_, e) =>
+			{
+				var rawMessage = e.TryGetWebMessageAsString();
+				var message = JsonSerializer.Deserialize<WebMessage>(rawMessage, _caseInsensitiveOptions);
+				if (message.Guid != methodsGuid)
+					return;
+
+				var methodMessage = JsonSerializer.Deserialize<MethodWebMessage>(rawMessage, _caseInsensitiveOptions);
+				var method = methods[methodMessage.Method];
+				try
+				{
+					var args = JsonSerializer.Deserialize<JsonElement[]>(methodMessage.Args).Zip(method.GetParameters(), (val, args) => new { val, args.ParameterType }).Select(item => item.val.Deserialize(item.ParameterType));
+					var result = method.Invoke(@object, args.ToArray());
+					if (result is object)
+					{
+						var resultType = result.GetType();
+						dynamic task = null;
+						if (resultType.Name.StartsWith("TaskToAsyncOperationAdapter")
+							|| resultType.IsInstanceOfType(typeof(IAsyncInfo)))
+						{
+							if (resultType.GenericTypeArguments.Length > 0)
+							{
+								var asTask = typeof(WindowsRuntimeSystemExtensions)
+									.GetMethods(BindingFlags.Public | BindingFlags.Static)
+									.Where(method => method.GetParameters().Length == 1
+										&& method.Name == "AsTask"
+										&& method.ToString().Contains("Windows.Foundation.IAsyncOperation`1[TResult]"))
+									.FirstOrDefault();
+
+								asTask = asTask.MakeGenericMethod(resultType.GenericTypeArguments[0]);
+								task = (Task)asTask.Invoke(null, new[] { result });
+							}
+							else
+							{
+								task = WindowsRuntimeSystemExtensions.AsTask((dynamic)result);
+							}
+						}
+						else
+						{
+							var awaiter = resultType.GetMethod(nameof(Task.GetAwaiter));
+							if (awaiter is object)
+								task = result;
+						}
+						if (task is object)
+							result = await task;
+					}
+					var json = JsonSerializer.Serialize(result, _unsafeRelaxedOptions);
+					await webview.ExecuteScriptAsync($@"{name}._callbacks.get({methodMessage.Id}).accept(JSON.parse({json})); {name}._callbacks.delete({methodMessage.Id});");
+				}
+				catch (Exception ex)
+				{
+					var json = JsonSerializer.Serialize(ex, _unsafeRelaxedOptions);
+					await webview.ExecuteScriptAsync($@"{name}._callbacks.get({methodMessage.Id}).reject(JSON.parse({json})); {name}._callbacks.delete({methodMessage.Id});");
+				}
+			});
+
+			_handlers.Add(handler);
+			webview.WebMessageReceived += handler;
+		}
+
+		public static async Task<string> InvokeScriptAsync(this WebView2 webview, string function, params object[] args)
+		{
+			var array = JsonSerializer.Serialize(args, _unsafeRelaxedOptions);
+			string result = null;
+			await webview.DispatcherQueue.EnqueueAsync(async () =>
+			{
+				var script = $"{function}(...{array});";
+				try
+				{
+					result = await webview.ExecuteScriptAsync(script).AsTask();
+					result = JsonSerializer.Deserialize<string>(result);
+				}
+				catch (Exception)
+				{
+				}
+			}, Microsoft.UI.Dispatching.DispatcherQueuePriority.Normal);
+
+			return result;
+		}
+	}
+}

src/Files.App/Files.App.csproj

@@ -41,7 +41,7 @@
     <PropertyGroup>
         <DefineConstants>$(DefineConstants);DISABLE_XAML_GENERATED_MAIN</DefineConstants>
     </PropertyGroup>
-  
+
     <ItemGroup>
         <Manifest Include="app.manifest" />
         <Content Update="Assets\Resources\**">
@@ -65,6 +65,10 @@
         <Content Include="7zArm64.dll" Condition="'$(Platform)' == 'arm64'">
             <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
         </Content>
+		<Content Include="Utils\Terminal\UI\bundle.js" />
+		<Content Include="Utils\Terminal\UI\index.html" />
+		<Content Include="Utils\Terminal\UI\style.css" />
+		<Content Include="Utils\Terminal\UI\xterm.css" />
     </ItemGroup>
 
     <ItemGroup>

src/Files.App/Services/Settings/GeneralSettingsService.cs

@@ -345,6 +345,12 @@ public bool ShowSystemTrayIcon
 			set => Set(value);
 		}
 
+		public bool IsTerminalIntegrationEnabled
+		{
+			get => Get(false);
+			set => Set(value);
+		}
+
 		public FileNameConflictResolveOptionType ConflictsResolveOption
 		{
 			get => (FileNameConflictResolveOptionType)Get((long)FileNameConflictResolveOptionType.GenerateNewName);