Add the ability to use the Call operator instead of the DotSource operator

Add support to switch the ExecuteMode from DotSource to Call

Author: LucasArona

src/PowerShellEditorServices/Services/DebugAdapter/DebugStateService.cs

@@ -34,6 +34,8 @@ internal class DebugStateService
 
         internal bool IsUsingTempIntegratedConsole { get; set; }
 
+        internal string ExecuteMode { get; set; }
+
         // This gets set at the end of the Launch/Attach handler which set debug state.
         internal TaskCompletionSource<bool> ServerStarted { get; set; }
 

src/PowerShellEditorServices/Services/DebugAdapter/Handlers/ConfigurationDoneHandler.cs

@@ -110,9 +110,11 @@ internal async Task LaunchScriptAsync(string scriptToLaunch)
             PSCommand command;
             if (System.IO.File.Exists(scriptToLaunch))
             {
-                // For a saved file we just execute its path (after escaping it).
+                // For a saved file we just execute its path (after escaping it), with the configured operator
+                // (which can't be called that because it's a reserved keyword in C#).
+                string executeMode = _debugStateService?.ExecuteMode == "Call" ? "&" : ".";
                 command = PSCommandHelpers.BuildDotSourceCommandWithArguments(
-                    PSCommandHelpers.EscapeScriptFilePath(scriptToLaunch), _debugStateService?.Arguments);
+                    PSCommandHelpers.EscapeScriptFilePath(scriptToLaunch), _debugStateService?.Arguments, executeMode);
             }
             else // It's a URI to an untitled script, or a raw script.
             {

src/PowerShellEditorServices/Services/DebugAdapter/Handlers/LaunchAndAttachHandler.cs

@@ -65,6 +65,11 @@ internal record PsesLaunchRequestArguments : LaunchRequestArguments
         /// </summary>
         public string[] RuntimeArgs { get; set; }
 
+        /// <summary>
+        /// Gets or sets the script execution mode, either "DotSource" or "Call".
+        /// </summary>
+        public string ExecuteMode { get; set; }
+
         /// <summary>
         /// Gets or sets optional environment variables to pass to the debuggee. The string valued
         /// properties of the 'environmentVariables' are used as key/value pairs.
@@ -186,6 +191,7 @@ public async Task<LaunchResponse> Handle(PsesLaunchRequestArguments request, Can
             _debugStateService.ScriptToLaunch = request.Script;
             _debugStateService.Arguments = request.Args;
             _debugStateService.IsUsingTempIntegratedConsole = request.CreateTemporaryIntegratedConsole;
+            _debugStateService.ExecuteMode = request.ExecuteMode;
 
             if (request.CreateTemporaryIntegratedConsole
                 && !string.IsNullOrEmpty(request.Script)

src/PowerShellEditorServices/Utility/PSCommandExtensions.cs

@@ -94,10 +94,12 @@ private static StringBuilder AddCommandText(this StringBuilder sb, Command comma
 
         public static string EscapeScriptFilePath(string f) => string.Concat("'", f.Replace("'", "''"), "'");
 
-        public static PSCommand BuildDotSourceCommandWithArguments(string command, IEnumerable<string> arguments)
+        // Operator defaults to dot-source but could also be call (ampersand).
+        // It can't be called that because it's a reserved keyword in C#.
+        public static PSCommand BuildDotSourceCommandWithArguments(string command, IEnumerable<string> arguments, string executeMode = ".")
         {
             string args = string.Join(" ", arguments ?? Array.Empty<string>());
-            string script = string.Concat(". ", command, string.IsNullOrEmpty(args) ? "" : " ", args);
+            string script = string.Concat(executeMode, " ", command, string.IsNullOrEmpty(args) ? "" : " ", args);
             // HACK: We use AddScript instead of AddArgument/AddParameter to reuse Powershell parameter binding logic.
             return new PSCommand().AddScript(script);
         }