Function maskTopLevelQuotes

src/shared/parse-command.ts:408–441

* Walk `command` and replace every top-level quoted region with a placeholder * token. Returns the masked string and the array of original quoted substrings * so callers can restore them later. * * Delegates all state-machine logic to `scanTopLevelQuotes`, ensuring * consistent quoting rules wi

(command: string)

 * a malformed command.
 */
function maskTopLevelQuotes(command: string): { masked: string; quotes: string[] } {
	const { spans, unterminatedQuote } = scanTopLevelQuotes(command)

	// If the command has an unterminated quote, treat the unclosed region as a
	// span running to the end of the string. This is safe because parseCommand
	// already guards against unterminated quotes and returns the raw command as
	// a single token before calling maskTopLevelQuotes -- but the fallback
	// ensures maskTopLevelQuotes is robust even when called directly.
	const effectiveSpans: QuoteSpan[] =
		unterminatedQuote !== null
			? [
					...spans,
					{ start: unterminatedQuote.openIndex, end: command.length, quoteType: unterminatedQuote.quoteType },
				]
			: spans

	const quotes: string[] = []
	let result = ""
	let pos = 0

	for (const span of effectiveSpans) {
		// Copy the unquoted text between the previous span end and this span start.
		result += command.slice(pos, span.start)
		// Replace the quoted span with a placeholder.
		quotes.push(command.slice(span.start, span.end))
		result += `__TOPLEVEL_QUOTE_${quotes.length - 1}__`
		pos = span.end
	}

	// Copy any remaining text after the last span (or the whole string if no spans).
	result += command.slice(pos)

	return { masked: result, quotes }
}

/**
 * Split a command string into individual sub-commands by