Quote array items in Invoke-FzfPsReadlineHandlerProvider to fix multi-select ambiguity (#354)

* Initial plan

* Implement AlwaysQuote for array items in Invoke-FzfPsReadlineHandlerProvider

Co-authored-by: kelleyma49 <2152684+kelleyma49@users.noreply.github.com>

---------

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

Author: Copilot

PSFzf.Base.ps1

@@ -103,24 +103,27 @@ class FzfDefaultCmd {
 	}
 }
 
-function FixCompletionResult($str) {
+function FixCompletionResult($str, [switch]$AlwaysQuote) {
 	if ([string]::IsNullOrEmpty($str)) {
 		return ""
 	}
-	elseif ($str.Contains(" ") -or $str.Contains("`t")) {
-		$str = $str.Replace("`r`n", "")
-		# check if already quoted
-		if (($str.StartsWith("'") -and $str.EndsWith("'")) -or `
-			($str.StartsWith("""") -and $str.EndsWith(""""))) {
-			return $str
-		}
-		else {
-			return """{0}""" -f $str
-		}
-
+	
+	$str = $str.Replace("`r`n", "")
+	
+	# check if already quoted
+	$isAlreadyQuoted = ($str.StartsWith("'") -and $str.EndsWith("'")) -or `
+		($str.StartsWith("""") -and $str.EndsWith(""""))
+	
+	if ($isAlreadyQuoted) {
+		return $str
+	}
+	
+	# Quote if it contains spaces/tabs, or if AlwaysQuote is specified
+	if ($AlwaysQuote -or $str.Contains(" ") -or $str.Contains("`t")) {
+		return """{0}""" -f $str
 	}
- else {
-		return $str.Replace("`r`n", "")
+	else {
+		return $str
 	}
 }
 
@@ -807,7 +810,7 @@ function Invoke-FzfPsReadlineHandlerProvider {
 				else {
 					$resultFull = $result[$i]
 				}
-				$result[$i] = FixCompletionResult $resultFull
+				$result[$i] = FixCompletionResult $resultFull -AlwaysQuote
 			}
 		}
 		else {

PSFzf.tests.ps1

@@ -545,6 +545,28 @@ Describe "Check FixCompletionResult" {
 				FixCompletionResult("'with space and already quoted'") | Should -Be "'with space and already quoted'"
 			}
 		}
+
+		Context "AlwaysQuote Parameter Tests" {
+			It "Should quote simple string when AlwaysQuote is used" {
+				FixCompletionResult -str "file.txt" -AlwaysQuote | Should -Be """file.txt"""
+			}
+
+			It "Should not double-quote already double-quoted string with AlwaysQuote" {
+				FixCompletionResult -str """already_quoted.txt""" -AlwaysQuote | Should -Be """already_quoted.txt"""
+			}
+
+			It "Should not double-quote already single-quoted string with AlwaysQuote" {
+				FixCompletionResult -str "'already_quoted.txt'" -AlwaysQuote | Should -Be "'already_quoted.txt'"
+			}
+
+			It "Should quote string with spaces when AlwaysQuote is used" {
+				FixCompletionResult -str "file with spaces.txt" -AlwaysQuote | Should -Be """file with spaces.txt"""
+			}
+
+			It "Should not double-quote already quoted string with spaces when AlwaysQuote is used" {
+				FixCompletionResult -str """file with spaces.txt""" -AlwaysQuote | Should -Be """file with spaces.txt"""
+			}
+		}
 	}
 }