/**
 * Shell utility functions for safe command execution
 */
/**
 * Quote a string for safe shell execution (cross-platform)
 *
 * On Unix/Linux/macOS:
 * - Uses single-quote wrapping with proper escaping
 * - Handles spaces, special characters, and single quotes
 * - Pattern: 'original' becomes 'original'
 * - Pattern: it's becomes 'it'\''s'
 *
 * On Windows (cmd.exe):
 * - Uses double-quote wrapping
 * - Only escapes double quotes by doubling them ("")
 * - Most special characters (&, |, <, >, ^) are safe inside double quotes
 * - LIMITATION: %VAR% environment variables are expanded even inside double quotes
 * - Note: Quote doubling ("") works with Git/MinGW tools. Standard Windows apps
 *   sometimes use backslash escaping (\") via CommandLineToArgvW, but Git
 *   on Windows typically uses MSYS/Cygwin which handles doubled quotes correctly.
 *
 * This function is primarily used for git commands, which work well with
 * this quoting strategy on both platforms.
 *
 * @param str - The string to quote
 * @returns The safely quoted string for the current platform
 *
 * @example
 * ```ts
 * quoteForShell('filename.txt')           // 'filename.txt' (Unix) or "filename.txt" (Windows)
 * quoteForShell('my file.txt')            // 'my file.txt' (Unix) or "my file.txt" (Windows)
 * quoteForShell("it's great")             // 'it'\''s great' (Unix) or "it's great" (Windows)
 * quoteForShell('$(rm -rf)')              // '$(rm -rf)' (Unix) or "$(rm -rf)" (Windows)
 * quoteForShell('file with "quotes"')    // 'file with "quotes"' (Unix) or "file with ""quotes""" (Windows)
 * ```
 */
export declare function quoteForShell(str: string): string;
//# sourceMappingURL=shell.d.ts.map