effect 4.0.7 → 4.1.1

package/dist/process/ChildProcess.js

@@ -14,7 +14,9 @@ import * as Context from "../Context.js";
 import * as Effectable from "../Effectable.js";
 import { dual } from "../Function.js";
 import * as Predicate from "../Predicate.js";
+import * as Result from "../Result.js";
 import { ChildProcessSpawner } from "./ChildProcessSpawner.js";
+import * as CommandLine from "./CommandLine.js";
 const TypeId = "~effect/process/ChildProcess";
 // =============================================================================
 // Constructors
@@ -74,16 +76,33 @@ const makePipedCommand = (left, right, options = {}) => Object.assign(Object.cre
  * 2. Options + template literal: `make({ cwd: "/app" })\`npm run build\``
  * 3. Array form: `make("npm", ["run", "build"], options?)`
  *
- * Template literals are not parsed until execution time, allowing parsing
- * errors to flow through Effect's error channel.
+ * Templates are split with `CommandLine.template`: quotes group words, each
+ * `${}` value is one literal argument, and an argument that contains a
+ * `Redacted` value stays `Redacted`. Arguments in the array form can be
+ * `Redacted` too.
+ *
+ * With the `shell` option, the template text is the shell script and is kept
+ * as written.
+ *
+ * **Gotchas**
+ *
+ * - A template is parsed when `make` is called. Shell syntax such as `|`,
+ *   `$HOME`, `*` or `~` throws a `CommandLine.CommandLineError`: quote it, or
+ *   pass the value with `${}`.
+ * - A template with the `shell` option cannot contain `${}` values, because
+ *   their quoting depends on the shell. Build the script with
+ *   `CommandLine.quote` and pass it as a string.
+ * - The program name, the first word, cannot be `Redacted`.
+ * - A NUL character in the command, an argument or an `env` value fails with
+ *   a `BadArgument` error when the command is spawned.
  *
  * **Example** (Creating commands)
  *
  * ```ts import.meta.vitest
  * import { ChildProcess } from "effect/process"
  *
- * // Template literal form
- * const cmd1 = ChildProcess.make`echo "hello"`
+ * // Template literal form; quotes group words
+ * const cmd1 = ChildProcess.make`echo "hello world"`
  *
  * // With options
  * const cmd2 = ChildProcess.make({ cwd: "/tmp" })`ls -la`
@@ -91,7 +110,7 @@ const makePipedCommand = (left, right, options = {}) => Object.assign(Object.cre
  * // Array form
  * const cmd3 = ChildProcess.make("git", ["status"])
  *
- * const result = [cmd1.command, cmd2.options.cwd, cmd3.args[0]] // => ["echo", "/tmp", "status"]
+ * const result = [cmd1.args[0], cmd2.options.cwd, cmd3.args[0]] // => ["hello world", "/tmp", "status"]
  * ```
  *
  * @stability unstable
@@ -102,15 +121,18 @@ export const make = function make(...args) {
   // Template literal form: make`command`
   if (isTemplateString(args[0])) {
     const [templates, ...expressions] = args;
-    const tokens = parseTemplates(templates, expressions);
-    return makeStandardCommand(tokens[0] ?? "", tokens.slice(1), {});
+    const [command, cmdArgs] = parseTemplate(templates, expressions);
+    return makeStandardCommand(command, cmdArgs, {});
   }
   // Options form: make({ cwd: "/tmp" })`command`
   if (typeof args[0] === "object" && !Array.isArray(args[0]) && !isTemplateString(args[0])) {
     const options = args[0];
     return function (templates, ...expressions) {
-      const tokens = parseTemplates(templates, expressions);
-      return makeStandardCommand(tokens[0] ?? "", tokens.slice(1), options);
+      if (options.shell !== undefined && options.shell !== false) {
+        return makeStandardCommand(shellScript(templates, expressions), [], options);
+      }
+      const [command, cmdArgs] = parseTemplate(templates, expressions);
+      return makeStandardCommand(command, cmdArgs, options);
     };
   }
   // Standard form without arguments: make("command", options?)
@@ -171,7 +193,7 @@ export const pipeTo = /*#__PURE__*/dual(args => isCommand(args[0]) && isCommand(
  * ```ts import.meta.vitest
  * import { ChildProcess } from "effect/process"
  *
- * const command = ChildProcess.make`echo "foo"`
+ * const command = ChildProcess.make`echo foo`
  *
  * const prefixed = command.pipe(
  *   ChildProcess.prefix`time`
@@ -198,10 +220,10 @@ export const prefix = function prefix(...args) {
 const parsePrefixArgs = args => {
   if (isTemplateString(args[0])) {
     const [templates, ...expressions] = args;
-    const tokens = parseTemplates(templates, expressions);
+    const [command, cmdArgs] = parseTemplate(templates, expressions);
     return {
-      command: tokens[0] ?? "",
-      args: tokens.slice(1)
+      command,
+      args: cmdArgs
     };
   }
   const [command, cmdArgs = []] = args;
@@ -330,154 +352,30 @@ export const fdName = fd => `fd${fd}`;
 // =============================================================================
 // Template Parsing
 // =============================================================================
-const parseTemplates = (templates, expressions) => {
-  let tokens = [];
-  for (const [index, template] of templates.entries()) {
-    tokens = parseTemplate(templates, expressions, tokens, template, index);
+const parseTemplate = (templates, expressions) => {
+  const [program = "", ...args] = Result.getOrThrow(CommandLine.template(templates, ...expressions));
+  if (typeof program !== "string") {
+    throw new CommandLine.CommandLineError({
+      reason: "InvalidArgument",
+      message: "The program name of a command cannot be Redacted"
+    });
   }
-  return tokens;
+  return [program, args];
 };
-const parseTemplate = (templates, expressions, prevTokens, template, index) => {
-  const rawTemplate = templates.raw[index];
-  if (rawTemplate === undefined) {
-    throw new Error(`Invalid backslash sequence: ${templates.raw[index]}`);
-  }
-  const {
-    hasLeadingWhitespace,
-    hasTrailingWhitespace,
-    tokens
-  } = splitByWhitespaces(template, rawTemplate);
-  const nextTokens = concatTokens(prevTokens, tokens, hasLeadingWhitespace);
-  if (index === expressions.length) {
-    return nextTokens;
-  }
-  const expression = expressions[index];
-  const expressionTokens = Array.isArray(expression) ? expression.map(expression => parseExpression(expression)) : [parseExpression(expression)];
-  return concatTokens(nextTokens, expressionTokens, hasTrailingWhitespace);
-};
-/**
- * Convert valid expressions defined in a template string command (i.e. using
- * `${expression}` into strings.
- */
-const parseExpression = expression => {
-  const type = typeof expression;
-  if (type === "string") {
-    return expression; // Return strings directly
-  }
-  return String(expression); // Convert numbers to strings
-};
-const DELIMITERS = /*#__PURE__*/new Set([" ", "\t", "\r", "\n"]);
-/**
- * Number of characters in backslash escape sequences: \0 \xXX or \uXXXX
- * \cX is allowed in RegExps but not in strings
- * Octal sequences are not allowed in strict mode
- */
-const ESCAPE_LENGTH = {
-  x: 3,
-  u: 5
-};
-/**
- * Splits a template string by whitespace while also properly handling escape
- * sequences.
- *
- * As an example, let's review the following valid commands:
- *
- * ```ts
- * ChildProcess.exec`echo foo\n bar`
- * // We should run `["echo", "foo\n", "bar"]`
- *
- * ChildProcess.exec`echo foo
- *  bar`
- * // We should run `["echo", "foo", "bar]`
- * ```
- *
- * The problem is that when we evaluate the template string for both of the above
- * commands, we will end up with the same string "echo foo\n bar".
- *
- * What we really want is to include the escaped character in the arguments for
- * the first command, since it was written explicitly by the user.
- *
- * This is why also having access to the raw template string is useful - in a
- * template string, there are two representations of the same string:
- * 1. `template`     - The processed string (escape sequences are evaluated).
- * 2. `template.raw` - The raw string (escape sequences are literal).
- */
-const splitByWhitespaces = (template, rawTemplate) => {
-  if (rawTemplate.length === 0) {
-    return {
-      tokens: [],
-      hasLeadingWhitespace: false,
-      hasTrailingWhitespace: false
-    };
+const shellScript = (templates, expressions) => {
+  if (expressions.length > 0) {
+    throw new CommandLine.CommandLineError({
+      reason: "UnsupportedSyntax",
+      message: "A shell template cannot interpolate values; build the script with CommandLine.quote"
+    });
   }
-  const hasLeadingWhitespace = DELIMITERS.has(rawTemplate[0]);
-  const tokens = [];
-  // Given that escape sequences will have different lengths in the template
-  // versus the raw template, we must maintain two indices:
-  // - One for the index into the template string
-  // - One for the index into the raw template string
-  // We also maintain the current cursor position for where we are in the template
-  let templateCursor = 0;
-  for (let templateIndex = 0, rawIndex = 0; templateIndex < template.length; templateIndex += 1, rawIndex += 1) {
-    // Use the raw template character to check for actual whitespace
-    const rawCharacter = rawTemplate[rawIndex];
-    if (DELIMITERS.has(rawCharacter)) {
-      // Whitespace found, extract token from template if necessary
-      if (templateCursor !== templateIndex) {
-        tokens.push(template.slice(templateCursor, templateIndex));
-      }
-      // Advance the template start index to the current position
-      templateCursor = templateIndex + 1;
-    } else if (rawCharacter === "\\") {
-      // Escape sequence detected, check the next raw character
-      const nextRawCharacter = rawTemplate[rawIndex + 1];
-      if (nextRawCharacter === "\n") {
-        // Handle `\` character followed by a newline (i.e. a line continuation) by:
-        // - Reversing the template index (backslash-newline is erased in template)
-        // - Advancing the raw template index past the line continuation
-        templateIndex -= 1;
-        rawIndex += 1;
-      } else if (nextRawCharacter === "u" && rawTemplate[rawIndex + 2] === "{") {
-        // Handle variable-length unicode escape sequences (i.e. `\u{1F600}`) by:
-        // - Advancing the template index an extra code unit for astral code points
-        // - Advancing the raw template index past the unicode escape sequence
-        const end = rawTemplate.indexOf("}", rawIndex + 3);
-        if (parseInt(rawTemplate.slice(rawIndex + 3, end), 16) > 0xffff) {
-          templateIndex += 1;
-        }
-        rawIndex = end;
-      } else {
-        // Advance raw template index past fixed-length escape sequences:
-        // - \n    → 2 chars (backslash + n)
-        // - \t    → 2 chars (backslash + t)
-        // - \xHH  → 4 chars (backslash + x + H + H)
-        // - \uHHHH → 6 chars (backslash + u + H + H + H + H)
-        rawIndex += ESCAPE_LENGTH[nextRawCharacter] ?? 1;
-      }
-    }
+  const script = templates[0];
+  if (script === undefined) {
+    throw new CommandLine.CommandLineError({
+      reason: "InvalidEscape",
+      message: "Template part 0 contains an invalid escape sequence"
+    });
   }
-  // Trailing whitespace only exists if the template cursor is equivalent to the
-  // length of the template
-  const hasTrailingWhitespace = templateCursor === template.length;
-  // If we did not end with trailing whitespace, ensure the final token is added
-  if (!hasTrailingWhitespace) {
-    tokens.push(template.slice(templateCursor));
-  }
-  return {
-    tokens,
-    hasLeadingWhitespace,
-    hasTrailingWhitespace
-  };
+  return script;
 };
-/**
- * Concatenates two separate sets of string tokens together.
- *
- * If either set is empty or `isSeparated=false`, the last element of `prevTokens`
- * and the first element of `nextTokens` will be joined into a single token.
- */
-const concatTokens = (prevTokens, nextTokens, isSeparated) => isSeparated || prevTokens.length === 0 || nextTokens.length === 0
-// Keep the previous and next tokens separate from one another
-? [...prevTokens, ...nextTokens]
-// Join the last token from the previous set and the first token from the next set
-: [...prevTokens.slice(0, -1), `${prevTokens.at(-1)}${nextTokens.at(0)}`, ...nextTokens.slice(1)];
 //# sourceMappingURL=ChildProcess.js.map

package/dist/process/ChildProcess.js.map

@@ -1 +1 @@
-{"version":3,"file":"ChildProcess.js","names":[],"sources":["../../src/process/ChildProcess.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"ChildProcess.js","names":[],"sources":["../../src/process/ChildProcess.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/process/ChildProcessSpawner.d.ts

@@ -132,6 +132,9 @@ export interface ChildProcessHandle {
      *
      * **Details**
      *
+     * Available for `"input"` and `"duplex"` file descriptors. The write side is
+     * ended when the sink completes.
+     *
      * If a file descriptor is accessed that was not configured, returns a drain
      * `Sink`.
      */
@@ -142,6 +145,8 @@ export interface ChildProcessHandle {
      *
      * **Details**
      *
+     * Available for `"output"` and `"duplex"` file descriptors.
+     *
      * If a file descriptor is accessed that was not configured, returns an empty
      * `Stream`.
      */

package/dist/process/ChildProcessSpawner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChildProcessSpawner.d.ts","sourceRoot":"","sources":["../../src/process/ChildProcessSpawner.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ChildProcessSpawner.d.ts","sourceRoot":"","sources":["../../src/process/ChildProcessSpawner.ts"],"names":[],"mappings":"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"}

package/dist/process/ChildProcessSpawner.js.map

@@ -1 +1 @@
-{"version":3,"file":"ChildProcessSpawner.js","names":[],"sources":["../../src/process/ChildProcessSpawner.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;AAaA,OAAO,KAAK,KAAK,MAAM,aAAa;AACpC,OAAO,KAAK,OAAO,MAAM,eAAe;AACxC,OAAO,KAAK,MAAM,MAAM,cAAc;AACtC,OAAO,KAAK,WAAW,MAAM,mBAAmB;AAIhD,OAAO,KAAK,MAAM,MAAM,cAAc;AAYtC;;;;;;;AAOA,OAAO,MAAM,QAAQ,gBAAgC,KAAK,CAAC,OAAO,EAAY;AAY9E;;;;;;;AAOA,OAAO,MAAM,SAAS,gBAAiC,KAAK,CAAC,OAAO,EAAa;AAkBjF,MAAM,YAAY,GAAG,wDAAwD;AAiI7E,MAAM,WAAW,GAAG;EAClB,CAAC,YAAY,GAAG,YAAY;EAC5B,GAAG,WAAW,CAAC,SAAS;EACxB,MAAM;IACJ,OAAO;MAAE,GAAG,EAAE,oBAAoB;MAAE,GAAG,EAAE,IAAI,CAAC;IAAG,CAAE;EACrD;CACD;AAED;;;;;;;AAOA,OAAO,MAAM,UAAU,GAAI,MAAqD,IAC9E,MAAM,CAAC,cAAc,CAAC;EAAE,GAAG;AAAM,CAAE,EAAE,WAAW,CAAC;AAEnD;;;;;;;;AAQA,OAAO,MAAM,IAAI,GAAI,KAA8C,IAAoC;EACrG;EACA;EACA,MAAM,YAAY,GAAkD,CAAC,OAAO,EAAE,OAAO,KACnF,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CACjB,MAAM,CAAC,GAAG,CAAE,MAAM,IAChB,MAAM,CAAC,UAAU,CACf,OAAO,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,CAAC,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAC9F,CACF,EACD,MAAM,CAAC,MAAM,CACd;EACH,MAAM,WAAW,GAAkD,CAAC,OAAO,EAAE,OAAO,KAClF,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;EAEnD,OAAO,mBAAmB,CAAC,EAAE,CAAC;IAC5B,KAAK;IACL;IACA,QAAQ,EAAG,OAAO,IAChB,MAAM,CAAC,MAAM,CACX,MAAM,CAAC,OAAO,CACZ,KAAK,CAAC,OAAO,CAAC,EACb,MAAM,IAAK,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CACzG,CACF;IACH,YAAY;IACZ,WAAW;IACX,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7E,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC;GAC7E,CAAC;AACJ,CAAC;AAED;;;;;;;AAOA,OAAM,MAAO,mBAAoB,sBAAQ,OAAO,CAAC,OAAO,EA0EpD,CAAC,oCAAoC,CAAC","ignoreList":[]}
+{"version":3,"file":"ChildProcessSpawner.js","names":[],"sources":["../../src/process/ChildProcessSpawner.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;AAaA,OAAO,KAAK,KAAK,MAAM,aAAa;AACpC,OAAO,KAAK,OAAO,MAAM,eAAe;AACxC,OAAO,KAAK,MAAM,MAAM,cAAc;AACtC,OAAO,KAAK,WAAW,MAAM,mBAAmB;AAIhD,OAAO,KAAK,MAAM,MAAM,cAAc;AAYtC;;;;;;;AAOA,OAAO,MAAM,QAAQ,gBAAgC,KAAK,CAAC,OAAO,EAAY;AAY9E;;;;;;;AAOA,OAAO,MAAM,SAAS,gBAAiC,KAAK,CAAC,OAAO,EAAa;AAkBjF,MAAM,YAAY,GAAG,wDAAwD;AAsI7E,MAAM,WAAW,GAAG;EAClB,CAAC,YAAY,GAAG,YAAY;EAC5B,GAAG,WAAW,CAAC,SAAS;EACxB,MAAM;IACJ,OAAO;MAAE,GAAG,EAAE,oBAAoB;MAAE,GAAG,EAAE,IAAI,CAAC;IAAG,CAAE;EACrD;CACD;AAED;;;;;;;AAOA,OAAO,MAAM,UAAU,GAAI,MAAqD,IAC9E,MAAM,CAAC,cAAc,CAAC;EAAE,GAAG;AAAM,CAAE,EAAE,WAAW,CAAC;AAEnD;;;;;;;;AAQA,OAAO,MAAM,IAAI,GAAI,KAA8C,IAAoC;EACrG;EACA;EACA,MAAM,YAAY,GAAkD,CAAC,OAAO,EAAE,OAAO,KACnF,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CACjB,MAAM,CAAC,GAAG,CAAE,MAAM,IAChB,MAAM,CAAC,UAAU,CACf,OAAO,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,CAAC,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAC9F,CACF,EACD,MAAM,CAAC,MAAM,CACd;EACH,MAAM,WAAW,GAAkD,CAAC,OAAO,EAAE,OAAO,KAClF,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;EAEnD,OAAO,mBAAmB,CAAC,EAAE,CAAC;IAC5B,KAAK;IACL;IACA,QAAQ,EAAG,OAAO,IAChB,MAAM,CAAC,MAAM,CACX,MAAM,CAAC,OAAO,CACZ,KAAK,CAAC,OAAO,CAAC,EACb,MAAM,IAAK,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CACzG,CACF;IACH,YAAY;IACZ,WAAW;IACX,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7E,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC;GAC7E,CAAC;AACJ,CAAC;AAED;;;;;;;AAOA,OAAM,MAAO,mBAAoB,sBAAQ,OAAO,CAAC,OAAO,EA0EpD,CAAC,oCAAoC,CAAC","ignoreList":[]}

package/dist/process/CommandLine.d.ts

@@ -0,0 +1,294 @@
+import * as Redacted from "../Redacted.ts";
+import * as Result from "../Result.ts";
+/**
+ * Command line syntax understood by the functions in this module.
+ *
+ * **Details**
+ *
+ * - `"posix"`: POSIX shells (`sh`, `dash`, `bash`, `zsh`). Quoted words are
+ *   also safe in `fish`.
+ * - `"powershell"`: PowerShell 7.3 or later, which passes arguments to native
+ *   programs unchanged (`$PSNativeCommandArgumentPassing` set to `Standard` or
+ *   `Windows`).
+ * - `"windows"`: the Microsoft C runtime convention, also implemented by
+ *   `CommandLineToArgvW`, that most Windows programs use. It is not the syntax
+ *   of `cmd.exe` or of batch files.
+ *
+ * @stability unstable
+ * @category models
+ * @since 4.0.7
+ */
+export type Format = "posix" | "powershell" | "windows";
+/**
+ * One argument: a plain string or a `Redacted` string that must not appear in
+ * logs.
+ *
+ * @stability unstable
+ * @category models
+ * @since 4.0.7
+ */
+export type Word = string | Redacted.Redacted<string>;
+/**
+ * Single value accepted inside a `${}` interpolation of {@link template}.
+ *
+ * @stability unstable
+ * @category models
+ * @since 4.0.7
+ */
+export type TemplateExpressionItem = string | number | boolean | Redacted.Redacted<string>;
+/**
+ * Value accepted inside a `${}` interpolation of {@link template}.
+ *
+ * **Details**
+ *
+ * An array adds one argument per element and must stand alone as a whole
+ * argument. An empty array adds no arguments.
+ *
+ * @stability unstable
+ * @category models
+ * @since 4.0.7
+ */
+export type TemplateExpression = TemplateExpressionItem | ReadonlyArray<TemplateExpressionItem>;
+declare const CommandLineError_base: new <A extends Record<string, any> = {}>(args: import("../Types.ts").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("../Cause.ts").YieldableError & {
+    readonly _tag: "CommandLineError";
+} & Readonly<A>;
+/**
+ * Error returned when a command line or a template cannot be built.
+ *
+ * **Details**
+ *
+ * - `NulCharacter`: an argument passed to {@link quote} or {@link join}
+ *   contains a NUL character, which no command line can carry.
+ * - `InvalidArgument`: the format cannot carry an argument: a Windows program
+ *   name with a double quote, or the argument `--%`, which PowerShell drops
+ *   when it calls a native program.
+ * - `InvalidEscape`: template text ends with a backslash that escapes nothing,
+ *   or contains an invalid JavaScript escape sequence.
+ * - `UnterminatedQuote`: a quoted section of a template is not closed.
+ * - `UnsupportedSyntax`: template text contains shell syntax that cannot work
+ *   without a shell, such as operators, expansions, globs, comments or
+ *   variable assignments, or an interpolated array is not a separate argument.
+ *
+ * Messages never include the input, which may contain secrets.
+ *
+ * @stability unstable
+ * @category errors
+ * @since 4.0.7
+ */
+export declare class CommandLineError extends CommandLineError_base<{
+    readonly reason: "NulCharacter" | "InvalidArgument" | "InvalidEscape" | "UnterminatedQuote" | "UnsupportedSyntax";
+    readonly message: string;
+}> {
+}
+/**
+ * Quotes one argument so that a program reading the given format sees it as
+ * exactly one argument, with one PowerShell exception listed under Gotchas.
+ *
+ * **When to use**
+ *
+ * Use when you insert an argument into a command line that is otherwise
+ * written by hand, for example a script passed to `sh -c`.
+ *
+ * **Details**
+ *
+ * - `"posix"` leaves words made of letters, digits and `_ @ + : , . / -`
+ *   unchanged and wraps everything else in single quotes. Single quotes and
+ *   backslashes are written outside the quotes, so `fish` reads the result
+ *   the same way.
+ * - `"powershell"` always uses single quotes, doubling `'` and the
+ *   typographic single quotes that PowerShell also accepts as quotes.
+ * - `"windows"` quotes words that contain a space, a tab, a line break or a
+ *   double quote, using the C runtime backslash rules. Use {@link join} for a
+ *   complete command line, because the program name follows different rules.
+ *
+ * **Gotchas**
+ *
+ * - The result contains the value of a `Redacted` argument. Use
+ *   {@link display} for logs.
+ * - Control characters are kept as they are. That is safe for `sh -c` and SSH
+ *   commands, but not for text typed into an interactive shell.
+ * - PowerShell never passes an argument equal to `--%` to a native program,
+ *   however it is quoted. Use {@link join} for a whole native call, which
+ *   fails with `InvalidArgument` instead.
+ *
+ * **Example** (Quoting arguments for different shells)
+ *
+ * ```ts import.meta.vitest
+ * import { Result } from "effect"
+ * import { CommandLine } from "effect/process"
+ *
+ * CommandLine.quote("it's") // => Result.succeed("'it'\\''s'")
+ * CommandLine.quote("it's", { format: "powershell" }) // => Result.succeed("'it''s'")
+ * CommandLine.quote("C:\\My Files\\", { format: "windows" }) // => Result.succeed("\"C:\\My Files\\\\\"")
+ * ```
+ *
+ * @see {@link join} for quoting a whole argument list
+ *
+ * @stability unstable
+ * @category encoding
+ * @since 4.0.7
+ */
+export declare const quote: (word: Word, options?: {
+    readonly format?: Format | undefined;
+}) => Result.Result<string, CommandLineError>;
+/**
+ * Builds a command line that runs the given program and arguments.
+ *
+ * **When to use**
+ *
+ * Use when a transport accepts only one string, such as an SSH exec request or
+ * a `shell` option, and the arguments must reach the program unchanged.
+ *
+ * **Details**
+ *
+ * The first word is the program. Each word is quoted as in {@link quote} and
+ * the words are separated by spaces.
+ *
+ * - `"posix"` also quotes a program name that `sh`, `bash`, `zsh` or `fish`
+ *   reads as syntax, such as `if` or `time`.
+ * - `"powershell"` starts the line with the call operator `&`, because a
+ *   quoted program name is otherwise read as a string value.
+ * - `"windows"` quotes the program name with the C runtime rules for program
+ *   names, which do not support backslash escapes.
+ * - An empty list returns an empty string.
+ *
+ * **Gotchas**
+ *
+ * - The result contains the values of `Redacted` arguments. Use
+ *   {@link display} for logs.
+ * - A Windows program name that contains `"` fails with `InvalidArgument`.
+ * - For `"powershell"`, an argument equal to `--%` fails with
+ *   `InvalidArgument`: PowerShell drops it when it calls a native program,
+ *   however it is quoted.
+ * - `"windows"` output is the command line of a program, not a `cmd.exe`
+ *   script. `cmd.exe`, which `shell: true` uses on Windows, expands `%NAME%`
+ *   and reads `^ & | < >` before the program sees its arguments, so a script
+ *   that contains untrusted values has to be written by hand.
+ *
+ * **Example** (Joining arguments into command lines)
+ *
+ * ```ts import.meta.vitest
+ * import { Result } from "effect"
+ * import { CommandLine } from "effect/process"
+ *
+ * const args = ["git", "commit", "-m", "fix: don't fail"]
+ *
+ * CommandLine.join(args) // => Result.succeed("git commit -m 'fix: don'\\''t fail'")
+ * CommandLine.join(args, { format: "powershell" }) // => Result.succeed("& 'git' 'commit' '-m' 'fix: don''t fail'")
+ * CommandLine.join(args, { format: "windows" }) // => Result.succeed("git commit -m \"fix: don't fail\"")
+ * ```
+ *
+ * @see {@link display} for rendering a command for logs and error messages
+ *
+ * @stability unstable
+ * @category encoding
+ * @since 4.0.7
+ */
+export declare const join: (words: ReadonlyArray<Word>, options?: {
+    readonly format?: Format | undefined;
+}) => Result.Result<string, CommandLineError>;
+/**
+ * Renders a command for logs and error messages.
+ *
+ * **When to use**
+ *
+ * Use when you show a command to a person, for example in an error message,
+ * and secrets and control characters must not reach the output.
+ *
+ * **Details**
+ *
+ * - Quotes like {@link join}, so commands without control characters or
+ *   secrets can be copied into a terminal of the given format.
+ * - Replaces `Redacted` arguments with `<redacted>`.
+ * - Writes control characters and Unicode line separators as escapes such as
+ *   `\n` or `\u001b`, so output cannot move the cursor or inject terminal
+ *   sequences.
+ * - Never fails: input that {@link join} rejects is rendered anyway.
+ *
+ * **Gotchas**
+ *
+ * The output is for reading only. It is not a reliable command line: escapes
+ * and `<redacted>` change what a shell would run.
+ *
+ * **Example** (Showing a command with a secret)
+ *
+ * ```ts import.meta.vitest
+ * import { Redacted } from "effect"
+ * import { CommandLine } from "effect/process"
+ *
+ * const token = Redacted.make("hunter2")
+ *
+ * CommandLine.display(["curl", "-H", token, "https://x.dev/a b"]) // => "curl -H <redacted> 'https://x.dev/a b'"
+ * ```
+ *
+ * @see {@link join} for building a command line to run
+ *
+ * @stability unstable
+ * @category encoding
+ * @since 4.0.7
+ */
+export declare const display: (words: ReadonlyArray<Word>, options?: {
+    readonly format?: Format | undefined;
+}) => string;
+/**
+ * Builds an argument list from a template literal.
+ *
+ * **When to use**
+ *
+ * Use to write a command as it would look in a shell while keeping every
+ * interpolated value a literal argument.
+ *
+ * **Details**
+ *
+ * - The template text is split into words as a POSIX shell does: spaces,
+ *   tabs and line breaks separate words, and quotes and backslash escapes are
+ *   removed. A long command can span several lines.
+ * - Text that would need a shell fails with `UnsupportedSyntax`: operators
+ *   (`| & ; < > ( )`), expansions (`$NAME`, `${...}`, `$(...)`, backticks, a
+ *   leading `~`, braces such as `{a,b}`, and a leading `=` that `zsh`
+ *   expands), globs (`* ? [`), comments (`#` at the start of a word), and a
+ *   variable assignment in the program position. Quote such characters to
+ *   pass them literally.
+ * - No shell runs, so a program such as `if` or `time` names an executable.
+ * - Each `${}` value is inserted literally, without splitting or quote
+ *   processing. Next to other text or inside quotes, it becomes part of the
+ *   surrounding argument.
+ * - An array adds one argument per element and must stand alone as a whole
+ *   argument.
+ * - Numbers and booleans are converted with `String`.
+ * - An argument that contains a `Redacted` value becomes `Redacted` as a
+ *   whole.
+ *
+ * **Gotchas**
+ *
+ * - An invalid JavaScript escape sequence in the text, such as `\u` without
+ *   hex digits, fails with `InvalidEscape`. Use `String.raw` or a `${}` value
+ *   for backslashes.
+ * - Neither the text nor the values are checked for NUL characters.
+ *   {@link join} and the child process spawners reject them where they would
+ *   truncate an argument.
+ *
+ * **Example** (Building arguments with interpolated values)
+ *
+ * ```ts import.meta.vitest
+ * import { Redacted, Result } from "effect"
+ * import { CommandLine } from "effect/process"
+ *
+ * const msg = "fix: handle $HOME"
+ * const files = ["a.ts", "b.ts"]
+ *
+ * CommandLine.template`git commit -m ${msg} ${files}` // => Result.succeed(["git", "commit", "-m", msg, ...files])
+ *
+ * const password = Redacted.make("hunter2")
+ * const words = Result.getOrThrow(CommandLine.template`psql "--password=${password}"`)
+ *
+ * CommandLine.display(words) // => "psql <redacted>"
+ * ```
+ *
+ * @stability unstable
+ * @category constructors
+ * @since 4.0.7
+ */
+export declare const template: (strings: TemplateStringsArray, ...expressions: ReadonlyArray<TemplateExpression>) => Result.Result<Array<Word>, CommandLineError>;
+export {};
+//# sourceMappingURL=CommandLine.d.ts.map