Escape single quotes while translating dropped Win32 paths (#18007)

When file/folder is dropped to the terminal, its path is translated and
quoted with a pair of single quotes if necessary.

However, the terminal control does not escape single quotes (allowed in
the Win32 subsystem) that need escapes when translated.

On the translation styles other than `"none"` (note: all other
translation styles are currently intended for the POSIX shell), it
causes incorrect path to be pasted when the path contains one or more
single quotes (see #18006 for an example).

With this commit, the terminal control escapes a single quote with a
valid escape sequence `'\''` (finish quote, print a single quote then
begin quote again) when the path translation is required.

* Changed escape sequence from `'"'"'` to much shorter `'\''`.
* Reflected comments by the reviewer.

* Overhaul after addition of multiple path translation styles (not just
WSL but Cygwin and MSYS).
* More clarification both in the code and in the commit message.

* Minor clarification both in the code and in the commit message.

* #18006
* #16214
* #18195

This is a follow-up of #16214 and #18195, fixing #18006.

Closes #18006

(cherry picked from commit ae90d52)
Service-Card-Id: PVTI_lADOAF3p4s4AmhmQzgVEvdU
Service-Version: 1.22

Author: a4lg

src/cascadia/TerminalControl/TermControl.cpp

@@ -3250,7 +3250,25 @@ namespace winrt::Microsoft::Terminal::Control::implementation
                     {
                         allPathsString.push_back(quotesChar);
                     }
-                    allPathsString.append(fullPath);
+                    if (isWSL)
+                    {
+                        // Fix quoted path for WSL
+                        // Single quote is allowed on the Win32 subsystem and must be processed on WSL profiles.
+                        // Note that we assume that all paths are quoted using a pair of single quotes for WSL.
+                        std::wstring_view fullPathView{ fullPath };
+                        size_t pos;
+                        while ((pos = fullPathView.find(L'\'')) != std::wstring_view::npos)
+                        {
+                            allPathsString.append(fullPathView.begin(), fullPathView.begin() + pos);
+                            allPathsString.append(L"'\\''");
+                            fullPathView.remove_prefix(pos + 1);
+                        }
+                        allPathsString.append(fullPathView);
+                    }
+                    else
+                    {
+                        allPathsString.append(fullPath);
+                    }
                     if (quotesNeeded)
                     {
                         allPathsString.push_back(quotesChar);