@poe-platform/safe-bash 0.1.157 → 0.1.159

package/dist/safe-bash/browser.js

@@ -117,23 +117,23 @@ var require_base64_js = __commonJS({
       var tmp;
       var len2 = uint8.length;
       var extraBytes = len2 % 3;
-      var parts = [];
+      var parts2 = [];
       var maxChunkLength = 16383;
       for (var i2 = 0, len22 = len2 - extraBytes; i2 < len22; i2 += maxChunkLength) {
-        parts.push(encodeChunk(uint8, i2, i2 + maxChunkLength > len22 ? len22 : i2 + maxChunkLength));
+        parts2.push(encodeChunk(uint8, i2, i2 + maxChunkLength > len22 ? len22 : i2 + maxChunkLength));
       }
       if (extraBytes === 1) {
         tmp = uint8[len2 - 1];
-        parts.push(
+        parts2.push(
           lookup[tmp >> 2] + lookup[tmp << 4 & 63] + "=="
         );
       } else if (extraBytes === 2) {
         tmp = (uint8[len2 - 2] << 8) + uint8[len2 - 1];
-        parts.push(
+        parts2.push(
           lookup[tmp >> 10] + lookup[tmp >> 4 & 63] + lookup[tmp << 2 & 63] + "="
         );
       }
-      return parts.join("");
+      return parts2.join("");
     }
   }
 });
@@ -1831,6 +1831,9 @@ init_platform();
 // packages/safe-bash/src/commands/basic.ts
 init_platform();
 
+// packages/safe-bash/src/escaping.ts
+init_platform();
+
 // packages/safe-bash/src/contracts/command.ts
 init_platform();
 
@@ -2139,14 +2142,14 @@ function ownedCommandArguments(size, valueAt, allocation, extent) {
         const transaction2 = argumentAllocation(allocation);
         const scratch = transaction2.allocation?.reserve(bytes3, count2 + 1);
         try {
-          const parts = [];
+          const parts2 = [];
           for (let index = 0; index < length; index++) {
-            if (index) parts.push(separator);
-            parts.push(values[index]);
+            if (index) parts2.push(separator);
+            parts2.push(values[index]);
           }
-          Object.freeze(parts);
-          scratch?.commit(parts);
-          const result = concatShellValues(parts, transaction2.allocation);
+          Object.freeze(parts2);
+          scratch?.commit(parts2);
+          const result = concatShellValues(parts2, transaction2.allocation);
           scratch?.release();
           return result;
         } catch (error) {
@@ -2600,6 +2603,85 @@ function composeMiddleware(middleware, terminal) {
   };
 }
 
+// packages/safe-bash/src/contracts/yield.ts
+init_platform();
+var checkpoints = /* @__PURE__ */ new WeakMap();
+function monotonicNow() {
+  return globalThis.performance?.now() ?? Date.now();
+}
+function registerYieldCheckpoint(signal, checkpoint) {
+  checkpoints.set(signal, checkpoint);
+}
+function scheduleTurn(callback) {
+  const host = globalThis;
+  return host.setImmediate ? { kind: "immediate", value: host.setImmediate(callback) } : { kind: "timeout", value: setTimeout(callback, 0) };
+}
+function cancelTurn(handle) {
+  if (handle?.kind === "immediate") globalThis.clearImmediate?.(handle.value);
+  else if (handle) clearTimeout(handle.value);
+}
+function yieldTurn(signal) {
+  signal?.throwIfAborted();
+  if (signal) checkpoints.get(signal)?.();
+  return new Promise((resolve, reject) => {
+    let handle;
+    const finish = () => {
+      signal?.removeEventListener("abort", abort);
+      resolve();
+    };
+    const abort = () => {
+      cancelTurn(handle);
+      reject(signal.reason);
+    };
+    signal?.addEventListener("abort", abort, { once: true });
+    if (signal?.aborted) abort();
+    else handle = scheduleTurn(finish);
+  });
+}
+
+// packages/safe-bash/src/escaping.ts
+var controls = { 8: "\\b", 9: "\\t", 10: "\\n", 11: "\\v", 12: "\\f", 13: "\\r", 92: "\\\\" };
+var encoder2 = new TextEncoder();
+function* parts(value2, mode) {
+  for (const character of value2) {
+    const point = character.codePointAt(0);
+    if (mode === "diagnostic" && (point === 9 || point === 10 || point >= 32 && (point < 127 || point > 159))) {
+      yield character;
+    } else {
+      for (const byte of encoder2.encode(character)) {
+        yield controls[byte] ?? (byte >= 32 && byte < 127 ? String.fromCharCode(byte) : `\\${byte.toString(8).padStart(3, "0")}`);
+      }
+    }
+  }
+}
+function escapeText(value2, mode, checkOutput) {
+  let result = "", bytes2 = 0;
+  for (const part of parts(value2, mode)) {
+    bytes2 += import_buffer.Buffer.byteLength(part);
+    checkOutput?.(bytes2);
+    result += part;
+  }
+  return result;
+}
+async function writeDiagnostic(sink, value2, signal) {
+  signal?.throwIfAborted();
+  let chunk = "", bytes2 = 0, work = 0;
+  for (const part of parts(value2, "diagnostic")) {
+    signal?.throwIfAborted();
+    const size = import_buffer.Buffer.byteLength(part);
+    if (bytes2 + size > 16384) {
+      await writeBytes(sink, encoder2.encode(chunk), signal);
+      chunk = "";
+      bytes2 = 0;
+    }
+    chunk += part;
+    bytes2 += size;
+    if (++work % 1024 === 0) await yieldTurn(signal);
+  }
+  if (bytes2) await writeBytes(sink, encoder2.encode(chunk), signal);
+  signal?.throwIfAborted();
+}
+
 // packages/safe-bash/src/commands/internal.ts
 init_platform();
 
@@ -2687,7 +2769,7 @@ var RecordBuffer = class {
 };
 
 // packages/safe-bash/src/commands/internal.ts
-var encoder2 = new TextEncoder();
+var encoder3 = new TextEncoder();
 var decoder2 = new TextDecoder();
 var bufferLimit = 32 * 1024 * 1024;
 var UsageError = class extends Error {
@@ -2767,12 +2849,12 @@ function codeOf(error) {
 }
 async function output(context, text) {
   context.signal.throwIfAborted();
-  await writeBytes(context.stdout, typeof text === "string" ? encoder2.encode(text) : text, context.signal);
+  await writeBytes(context.stdout, typeof text === "string" ? encoder3.encode(text) : text, context.signal);
 }
 async function diagnostic(context, error) {
   context.signal.throwIfAborted();
-  await writeBytes(context.stderr, encoder2.encode(`${context.command}: ${error instanceof Error ? error.message : String(error)}
-`), context.signal);
+  await writeDiagnostic(context.stderr, `${context.command}: ${error instanceof Error ? error.message : String(error)}
+`, context.signal);
 }
 function define(name2, handler, failureCode = 1) {
   return {
@@ -2881,9 +2963,9 @@ function emptyInput() {
 }
 function replaceArgument(source, pattern, replacement) {
   if (typeof source === "string") return source.split(pattern).join(replacement);
-  const needle = encoder2.encode(pattern);
+  const needle = encoder3.encode(pattern);
   if (!needle.length) throw new UsageError("replacement string cannot be empty");
-  const substituted = encoder2.encode(replacement);
+  const substituted = encoder3.encode(replacement);
   const chunks = [];
   let start = 0;
   for (let offset = 0; offset <= source.length - needle.length; ) {
@@ -2903,7 +2985,7 @@ function escapeBytes(text, zeroOctal = false, bareOctal = false) {
     for (let index = 0; index < text.length; ) {
       if (text[index] !== "\\" || index + 1 === text.length) {
         const character = String.fromCodePoint(text.codePointAt(index));
-        chunks.push(encoder2.encode(character));
+        chunks.push(encoder3.encode(character));
         index += character.length;
         continue;
       }
@@ -2927,7 +3009,7 @@ function escapeBytes(text, zeroOctal = false, bareOctal = false) {
         index += 1 + hexadecimal[0].length;
         continue;
       }
-      chunks.push(encoder2.encode(`\\${next}`));
+      chunks.push(encoder3.encode(`\\${next}`));
       index += 2;
     }
     return { bytes: concatenate(chunks), stop: false };
@@ -3113,8 +3195,8 @@ async function formatPrintf(context) {
           else number = parseInt(supplied.replace(/^[+-]?0/u, ""), 8) * (supplied.startsWith("-") ? -1 : 1);
         }
         if (!Number.isFinite(number)) {
-          await writeBytes(context.stderr, encoder2.encode(`printf: '${supplied}': invalid number
-`), context.signal);
+          await writeDiagnostic(context.stderr, `printf: '${supplied}': invalid number
+`, context.signal);
           exitCode = 1;
           number = 0;
         }
@@ -3135,8 +3217,8 @@ async function formatPrintf(context) {
             }
           } catch {
             integral = 0n;
-            if (exitCode === 0) await writeBytes(context.stderr, encoder2.encode(`printf: '${supplied}': invalid integer
-`), context.signal);
+            if (exitCode === 0) await writeDiagnostic(context.stderr, `printf: '${supplied}': invalid integer
+`, context.signal);
             exitCode = 1;
           }
           text = (unsigned ? BigInt.asUintN(64, integral) : integral).toString(radix);
@@ -3207,42 +3289,6 @@ async function compareObservedEntries(fs, path, stat, peer, peerPath, peerStat,
 // packages/safe-bash/src/commands/move.ts
 init_platform();
 
-// packages/safe-bash/src/contracts/yield.ts
-init_platform();
-var checkpoints = /* @__PURE__ */ new WeakMap();
-function monotonicNow() {
-  return globalThis.performance?.now() ?? Date.now();
-}
-function registerYieldCheckpoint(signal, checkpoint) {
-  checkpoints.set(signal, checkpoint);
-}
-function scheduleTurn(callback) {
-  const host = globalThis;
-  return host.setImmediate ? { kind: "immediate", value: host.setImmediate(callback) } : { kind: "timeout", value: setTimeout(callback, 0) };
-}
-function cancelTurn(handle) {
-  if (handle?.kind === "immediate") globalThis.clearImmediate?.(handle.value);
-  else if (handle) clearTimeout(handle.value);
-}
-function yieldTurn(signal) {
-  signal?.throwIfAborted();
-  if (signal) checkpoints.get(signal)?.();
-  return new Promise((resolve, reject) => {
-    let handle;
-    const finish = () => {
-      signal?.removeEventListener("abort", abort);
-      resolve();
-    };
-    const abort = () => {
-      cancelTurn(handle);
-      reject(signal.reason);
-    };
-    signal?.addEventListener("abort", abort, { once: true });
-    if (signal?.aborted) abort();
-    else handle = scheduleTurn(finish);
-  });
-}
-
 // packages/safe-bash/src/commands/filesystem-requirements.ts
 init_platform();
 var filesystemCommandRequirements = {
@@ -3651,7 +3697,7 @@ async function copy(context, source, target, flags, readDirectory, top = true, a
       await context.fs.copyFile(source, target, { exclusive: true, signal: context.signal });
     }
   }
-  if (!preflight && flags.has("v")) await output(context, `'${source}' -> '${target}'
+  if (!preflight && flags.has("v")) await output(context, `'${escapeText(source, "display")}' -> '${escapeText(target, "display")}'
 `);
 }
 function modeText(stat) {
@@ -3681,7 +3727,7 @@ function filesystemCommands(maxDirectoryEntries) {
       ));
       return eachOperand(context, parsed.operands, async (operand) => {
         await context.fs.mkdir(pathOf(context, operand), { recursive: parsed.flags.has("p"), ...mode === void 0 ? {} : { mode: parseInt(mode, 8) }, signal: context.signal });
-        if (parsed.flags.has("v")) await output(context, `mkdir: created directory '${operand}'
+        if (parsed.flags.has("v")) await output(context, `mkdir: created directory '${escapeText(operand, "display")}'
 `);
       });
     }),
@@ -3766,7 +3812,7 @@ function filesystemCommands(maxDirectoryEntries) {
             return;
           }
         }
-        if (parsed.flags.has("v")) await output(context, `'${operand}' -> '${target}'
+        if (parsed.flags.has("v")) await output(context, `'${escapeText(operand, "display")}' -> '${escapeText(target, "display")}'
 `);
       });
     }),
@@ -3801,7 +3847,7 @@ function filesystemCommands(maxDirectoryEntries) {
         } else {
           await context.fs.rm(path, { recursive, force: parsed.flags.has("f"), signal: context.signal });
         }
-        if (parsed.flags.has("v")) await output(context, `removed '${operand}'
+        if (parsed.flags.has("v")) await output(context, `removed '${escapeText(operand, "display")}'
 `);
       });
     }),
@@ -3822,7 +3868,7 @@ function filesystemCommands(maxDirectoryEntries) {
         do {
           if (path === "/") throw new FsError("EBUSY", { path });
           await removeEmptyDirectory(context, path, readDirectory);
-          if (parsed.flags.has("v")) await output(context, `rmdir: removing directory '${path}'
+          if (parsed.flags.has("v")) await output(context, `rmdir: removing directory '${escapeText(path, "display")}'
 `);
           path = dirname(path);
         } while (parsed.flags.has("p") && path !== "/" && path !== stop);
@@ -3991,11 +4037,11 @@ function filesystemCommands(maxDirectoryEntries) {
           if (stat.type === "symlink") {
             await admitFilesystemModes(context, "ls", ["link"], [path]);
             needCapability(context, "readlink");
-            target = ` -> ${await context.fs.readlink(path, { signal: context.signal })}`;
+            target = ` -> ${escapeText(await context.fs.readlink(path, { signal: context.signal }), "display")}`;
           }
-          await output(context, `${modeText(stat)} ${stat.nlink ?? 1} ${stat.uid ?? 0} ${stat.gid ?? 0} ${size} ${date} ${display}${suffix2}${target}
+          await output(context, `${modeText(stat)} ${stat.nlink ?? 1} ${stat.uid ?? 0} ${stat.gid ?? 0} ${size} ${date} ${escapeText(display, "display")}${suffix2}${target}
 `);
-        } else await output(context, `${display}${suffix2}
+        } else await output(context, `${escapeText(display, "display")}${suffix2}
 `);
         outputWritten = true;
       };
@@ -4011,7 +4057,7 @@ function filesystemCommands(maxDirectoryEntries) {
         ancestors.add(physical);
         try {
           if (header) {
-            await output(context, `${outputWritten ? "\n" : ""}${display}:
+            await output(context, `${outputWritten ? "\n" : ""}${escapeText(display, "display")}:
 `);
             outputWritten = true;
           }
@@ -5012,7 +5058,7 @@ function characterSet(specification) {
       continue;
     }
     const character = String.fromCodePoint(specification.codePointAt(offset));
-    tokens2.push({ bytes: [...encoder2.encode(character)], literal: character === "-" });
+    tokens2.push({ bytes: [...encoder3.encode(character)], literal: character === "-" });
     offset += character.length;
   }
   const result = [];
@@ -5067,7 +5113,7 @@ function streamCommands(maxTeeTargets = 64, maxTailFollowHandles = 64) {
         for await (const chunk of source) {
           const transformed = [];
           const append = (text) => {
-            for (const byte of encoder2.encode(text)) transformed.push(byte);
+            for (const byte of encoder3.encode(text)) transformed.push(byte);
           };
           for (const byte of chunk) {
             if (lineStart && byte === 10 && parsed.flags.has("s") && blankCount > 0) continue;
@@ -5399,7 +5445,7 @@ var CutOutput = class {
       let end = Math.min(offset + 4096, text.length);
       const last = text.charCodeAt(end - 1);
       if (end < text.length && last >= 55296 && last <= 56319) end--;
-      await this.write(encoder2.encode(text.slice(offset, end)));
+      await this.write(encoder3.encode(text.slice(offset, end)));
       offset = end;
     }
   }
@@ -5585,8 +5631,8 @@ function textCommands() {
       await assertInputRequirements(context, parsed.operands);
       if (!parsed.flags.has("c")) await admitTextOutput(context, value(parsed, "o"));
       const separatorText = value(parsed, "t");
-      if (separatorText !== void 0 && encoder2.encode(separatorText).length !== 1) throw new UsageError("field separator must be one byte");
-      const separator = separatorText === void 0 ? void 0 : encoder2.encode(separatorText)[0];
+      if (separatorText !== void 0 && encoder3.encode(separatorText).length !== 1) throw new UsageError("field separator must be one byte");
+      const separator = separatorText === void 0 ? void 0 : encoder3.encode(separatorText)[0];
       const keys = (parsed.values.get("k") ?? []).map(sortKey);
       for (const key of keys.length ? keys : [void 0]) {
         const flags = key?.flags.size ? key.flags : parsed.flags;
@@ -5755,7 +5801,7 @@ function textCommands() {
         let previousKey;
         let count2 = 0;
         const selected = () => (!parsed.flags.has("d") || count2 > 1) && (!parsed.flags.has("u") || count2 === 1);
-        const record4 = () => concatenate([...parsed.flags.has("c") ? [encoder2.encode(`${String(count2).padStart(7)} `)] : [], previous, Uint8Array.of(delimiter)]);
+        const record4 = () => concatenate([...parsed.flags.has("c") ? [encoder3.encode(`${String(count2).padStart(7)} `)] : [], previous, Uint8Array.of(delimiter)]);
         for await (const line of lines(input(context, parsed.operands[0]), delimiter)) {
           context.signal.throwIfAborted();
           const currentKey = key(line.bytes);
@@ -5937,7 +5983,7 @@ async function splitString(source, environment, work) {
   work.expansion();
   work.account(source);
   const result = [];
-  let parts = [];
+  let parts2 = [];
   let active = false;
   let quote = "";
   const start = () => {
@@ -5949,11 +5995,11 @@ async function splitString(source, environment, work) {
   const append = (text) => {
     work.account(text);
     start();
-    parts.push(text);
+    parts2.push(text);
   };
   const finish = () => {
-    if (active) result.push(parts.join(""));
-    parts = [];
+    if (active) result.push(parts2.join(""));
+    parts2 = [];
     active = false;
   };
   for (let index = 0; index < source.length; ) {
@@ -5984,8 +6030,8 @@ async function splitString(source, environment, work) {
         else finish();
         continue;
       }
-      const controls = { f: "\f", n: "\n", r: "\r", t: "	", v: "\v" };
-      if (Object.hasOwn(controls, escaped)) append(controls[escaped]);
+      const controls2 = { f: "\f", n: "\n", r: "\r", t: "	", v: "\v" };
+      if (Object.hasOwn(controls2, escaped)) append(controls2[escaped]);
       else if (`"#$'\\`.includes(escaped)) append(escaped);
       else throw new EnvSplitError(`invalid sequence '\\${escaped}' in -S`);
       continue;
@@ -6068,8 +6114,8 @@ async function splitBytes(source, environment, work) {
         else finish();
         continue;
       }
-      const controls = { 102: 12, 110: 10, 114: 13, 116: 9, 118: 11 };
-      if (Object.hasOwn(controls, escaped)) append(Uint8Array.of(controls[escaped]));
+      const controls2 = { 102: 12, 110: 10, 114: 13, 116: 9, 118: 11 };
+      if (Object.hasOwn(controls2, escaped)) append(Uint8Array.of(controls2[escaped]));
       else if ([34, 35, 36, 39, 92].includes(escaped)) append(Uint8Array.of(escaped));
       else throw new EnvSplitError(`invalid sequence '\\${String.fromCharCode(escaped)}' in -S`);
       continue;
@@ -6085,7 +6131,7 @@ async function splitBytes(source, environment, work) {
       const name2 = decoder2.decode(source.subarray(index + 2, end));
       if (Object.hasOwn(environment, name2)) {
         const text = environment[name2];
-        append(encoder2.encode(text));
+        append(encoder3.encode(text));
         if (work.tick(text.length)) await work.pause();
       }
       index = end + 1;
@@ -6274,8 +6320,8 @@ function executionCommands(execute3, configuration = {}) {
       } catch (error) {
         context.signal.throwIfAborted();
         if (!(error instanceof EnvSplitError)) throw error;
-        await writeBytes(context.stderr, encoder2.encode(`${context.command}: ${error.message}
-`), context.signal);
+        await writeDiagnostic(context.stderr, `${context.command}: ${error.message}
+`, context.signal);
         return { exitCode: 125 };
       }
       const env = Object.assign(/* @__PURE__ */ Object.create(null), parsed.flags.has("i") ? {} : context.env);
@@ -6343,7 +6389,7 @@ function executionCommands(execute3, configuration = {}) {
       }
       const command2 = parsed.operands[0] ?? "echo";
       const initial = argumentValues.select(operandIndices).slice(1);
-      const baseBytes = encoder2.encode(command2).length + 1 + initial.values.reduce((sum, argument) => sum + shellValueByteLength(argument) + 1, 0);
+      const baseBytes = encoder3.encode(command2).length + 1 + initial.values.reduce((sum, argument) => sum + shellValueByteLength(argument) + 1, 0);
       if (baseBytes >= maxBytes) throw new UsageError("initial arguments exceed command size limit");
       let batch = [];
       let bytes2 = baseBytes;
@@ -6426,9 +6472,9 @@ function executionCommands(execute3, configuration = {}) {
         if (stop) return;
         const childArguments = initial.withValues(replacement === void 0 ? [...initial.values, ...batch] : initial.values.map((argument, index) => replaceArgument(typeof argument === "string" ? argument : initial.bytes(index), replacement, batch[0] ?? "")));
         const args = childArguments.args;
-        const size = encoder2.encode(command2).length + 1 + childArguments.values.reduce((sum, argument) => sum + shellValueByteLength(argument) + 1, 0);
+        const size = encoder3.encode(command2).length + 1 + childArguments.values.reduce((sum, argument) => sum + shellValueByteLength(argument) + 1, 0);
         if (size > maxBytes) throw new UsageError("expanded arguments exceed command size limit");
-        if (parsed.flags.has("t")) await writeBytes(context.stderr, encoder2.encode([command2, ...args].map((argument) => /^[A-Za-z0-9_./-]+$/u.test(argument) ? argument : `'${argument.replaceAll("'", "'\\''")}'`).join(" ") + "\n"), context.signal);
+        if (parsed.flags.has("t")) await writeDiagnostic(context.stderr, [command2, ...args].map((argument) => /^[A-Za-z0-9_./-]+$/u.test(argument) ? argument : `'${argument.replaceAll("'", "'\\''")}'`).join(" ") + "\n", context.signal);
         if (stop) return;
         context.signal.throwIfAborted();
         executed = true;
@@ -6464,7 +6510,7 @@ function executionCommands(execute3, configuration = {}) {
       try {
         for await (const argument of argumentsFrom(source, inputSignal, delimiter, replacement !== void 0)) {
           if (stop || delimiter === void 0 && eof !== void 0 && eof !== "" && argument === eof) break;
-          const size = encoder2.encode(argument).length + 1;
+          const size = encoder3.encode(argument).length + 1;
           if (replacement === void 0 && baseBytes + size > maxBytes) throw new UsageError("single argument exceeds command size limit");
           if (batch.length && (batch.length === maxArgs || bytes2 + size > maxBytes)) {
             if (parsed.flags.has("x") && batch.length < maxArgs) throw new UsageError("command size limit exceeded");
@@ -6950,21 +6996,21 @@ function getArrayAssignment(word) {
 }
 function removePrefix(word, length, budget) {
   budget.admit();
-  const parts = [];
+  const parts2 = [];
   for (const part of word.parts) {
-    if (length === 0) parts.push(part);
+    if (length === 0) parts2.push(part);
     else {
       if (part.kind !== "text") throw new ShellSyntaxError("Unsupported indexed-array subscript", word.offset);
       if (part.value.length <= length) length -= part.value.length;
       else {
         budget.admit();
-        parts.push({ ...part, value: part.value.slice(length) });
+        parts2.push({ ...part, value: part.value.slice(length) });
         length = 0;
       }
     }
   }
   if (length !== 0) throw new ShellSyntaxError("Invalid indexed-array assignment", word.offset);
-  return { offset: word.offset, parts };
+  return { offset: word.offset, parts: parts2 };
 }
 function elementAssignment(word, budget = new ParseBudget()) {
   const source = word.spelling;
@@ -7520,9 +7566,9 @@ var Lexer = class {
         }
         const offset = this.position;
         this.budget.admit();
-        const parts = [];
+        const parts2 = [];
         try {
-          this.expansion(parts, true);
+          this.expansion(parts2, true);
         } catch (error) {
           if (!(error instanceof ShellSyntaxError) || /nesting|exceeds/u.test(error.reason)) throw error;
           if (this.source.startsWith("${", offset)) throw new HereDocumentSyntaxError(`shell: line ${this.documentLine}: ${this.source}: bad substitution
@@ -7534,7 +7580,7 @@ var Lexer = class {
           throw new HereDocumentSyntaxError(`shell: line ${this.documentLine}: ${error.message}
 `);
         }
-        yield { offset, parts };
+        yield { offset, parts: parts2 };
       } else if (current === "\\" && /[$`\\]/u.test(this.source[this.position + 1] ?? "")) {
         text += this.source[this.position + 1];
         this.position += 2;
@@ -7602,7 +7648,7 @@ shell: command substitution: line ${line}: \`${sourceLine}'
     const offset = this.position;
     const reduction = this.printedNewlineReduction;
     const unprinted = this.unprintedWords;
-    const parts = [];
+    const parts2 = [];
     let parentheses = 0;
     let conditionals = 0;
     let patternParentheses = 0;
@@ -7618,7 +7664,7 @@ shell: command substitution: line ${line}: \`${sourceLine}'
         regexBracketFirst = false;
         regexBracketNegation = false;
       }
-      const previous = parts.at(-1);
+      const previous = parts2.at(-1);
       if (previous?.kind === "text" && previous.quoted === quoted && !previous.byteValue && typeof value2 === "string" && !ansi && !expansionSpellings.get(previous)?.ansi) {
         previous.value += value2;
         const spelling2 = expansionSpellings.get(previous);
@@ -7632,7 +7678,7 @@ shell: command substitution: line ${line}: \`${sourceLine}'
           this.budget.admit();
           expansionSpellings.set(part, { source: this.source, start, end, ...ansi ? { ansi } : {} });
         }
-        parts.push(part);
+        parts2.push(part);
       }
     };
     while (this.position < this.source.length) {
@@ -7697,14 +7743,14 @@ shell: command substitution: line ${line}: \`${sourceLine}'
         const quoteLine = this.lineAt(this.position);
         this.position++;
         text("", true, true, this.position - 1, this.position);
-        const quoteParts = parts.length;
+        const quoteParts = parts2.length;
         while (this.position < this.source.length && this.source[this.position] !== '"') {
           const inner = this.source[this.position];
           const opaque2 = this.braceReplay?.get(this.position);
           if (opaque2 !== void 0) {
             text(opaque2, true);
             this.position++;
-          } else if (!literal && (inner === "$" || inner === "`")) this.expansion(parts, true);
+          } else if (!literal && (inner === "$" || inner === "`")) this.expansion(parts2, true);
           else if (inner === "\\" && /[$`"\\\n]/u.test(this.source[this.position + 1] ?? "")) {
             const escaped = this.source[this.position + 1];
             if (escaped !== "\n") text(escaped, true, false, this.position, this.position + 2);
@@ -7716,8 +7762,8 @@ shell: command substitution: line ${line}: \`${sourceLine}'
           }
         }
         if (this.source[this.position] !== '"' && !this.braceReplay) this.error("Unterminated double quote", { quote: '"', line: quoteLine });
-        if (parts.length === quoteParts) setQuoteMarker(parts.at(-1), false);
-        const spelling2 = expansionSpellings.get(parts.at(-1));
+        if (parts2.length === quoteParts) setQuoteMarker(parts2.at(-1), false);
+        const spelling2 = expansionSpellings.get(parts2.at(-1));
         if (spelling2) spelling2.end = Math.min(this.position + 1, this.source.length);
         if (this.position < this.source.length) this.position++;
       } else if (current === "\\") {
@@ -7736,7 +7782,7 @@ shell: command substitution: line ${line}: \`${sourceLine}'
         if (literal) {
           if (current === "$" && ["'", '"'].includes(this.source[this.position + 1] ?? "")) this.error("Unsupported shell quoting in here-document delimiter");
           text(this.literalExpansion(), current === "`");
-        } else this.expansion(parts, enclosingQuoted);
+        } else this.expansion(parts2, enclosingQuoted);
       } else {
         if (arithmetic) {
           if (current === "(") parentheses++;
@@ -7750,13 +7796,13 @@ shell: command substitution: line ${line}: \`${sourceLine}'
     }
     if (conditionalPattern === "regex" && patternParentheses > 0) this.error("Unterminated conditional regular expression group");
     const printedNewlines = this.source.slice(offset, this.position).split("\n").length - 1 - (this.printedNewlineReduction - reduction);
-    return { parts, offset, ...unprinted === this.unprintedWords ? { printedNewlines } : {}, ...plain ? { plain: parts.map((part) => part.kind === "text" ? part.value : "").join("") } : {} };
+    return { parts: parts2, offset, ...unprinted === this.unprintedWords ? { printedNewlines } : {}, ...plain ? { plain: parts2.map((part) => part.kind === "text" ? part.value : "").join("") } : {} };
   }
   ansiWord() {
     const quoteLine = this.lineAt(this.position);
     this.position += 2;
     const bytes2 = [];
-    const encoder3 = new TextEncoder();
+    const encoder4 = new TextEncoder();
     const escapes = { a: 7, b: 8, e: 27, E: 27, f: 12, n: 10, r: 13, t: 9, v: 11, "\\": 92, "'": 39, '"': 34, "?": 63 };
     while (this.position < this.source.length) {
       const character = String.fromCodePoint(this.source.codePointAt(this.position));
@@ -7773,7 +7819,7 @@ shell: command substitution: line ${line}: \`${sourceLine}'
         }
       }
       if (character !== "\\") {
-        bytes2.push(...encoder3.encode(character));
+        bytes2.push(...encoder4.encode(character));
         continue;
       }
       const escape = this.source[this.position++];
@@ -7797,26 +7843,26 @@ shell: command substitution: line ${line}: \`${sourceLine}'
         const code = parseInt(digits, 16);
         if (escape === "x") bytes2.push(code);
         else if (this.byteLocale && code > 127) {
-          bytes2.push(...encoder3.encode(`\\${code <= 65535 ? "u" : "U"}${code.toString(16).toUpperCase().padStart(code <= 65535 ? 4 : 8, "0")}`));
+          bytes2.push(...encoder4.encode(`\\${code <= 65535 ? "u" : "U"}${code.toString(16).toUpperCase().padStart(code <= 65535 ? 4 : 8, "0")}`));
         } else {
           if (code > 1114111 || code >= 55296 && code <= 57343) this.error("Unsupported non-scalar ANSI-C Unicode escape");
-          bytes2.push(...encoder3.encode(String.fromCodePoint(code)));
+          bytes2.push(...encoder4.encode(String.fromCodePoint(code)));
         }
       } else if (escape === "c" && this.source[this.position] !== "'" && this.position < this.source.length) {
         const control = this.source[this.position++];
         if (control === "\\" && this.source[this.position] === "\\") this.position++;
         bytes2.push(control === "?" ? 127 : control.toUpperCase().charCodeAt(0) & 31);
-      } else bytes2.push(92, ...encoder3.encode(escape));
+      } else bytes2.push(92, ...encoder4.encode(escape));
     }
     this.error("Unterminated ANSI-C quote", { quote: "'", line: quoteLine });
   }
-  expansion(parts, quoted) {
+  expansion(parts2, quoted) {
     this.budget.admit();
     const spellingStart = this.position;
     const line = this.documentLine ?? this.lineAt(this.position);
     if (this.source[this.position] === "`") {
       if (this.braceReplay && this.position === this.source.length - 1) {
-        parts.push({ kind: "text", value: "`", quoted });
+        parts2.push({ kind: "text", value: "`", quoted });
         this.position++;
         return;
       }
@@ -7829,15 +7875,15 @@ shell: command substitution: line ${line}: \`${sourceLine}'
       if (this.source[this.position] !== "`") this.error("Unterminated command substitution");
       this.position++;
       try {
-        parts.push({ kind: "substitution", script: parseSource(source, this.depth + this.operandDepth + 1, this.warnings, line - 1, this.byteLocale, this.budget), line, quoted });
+        parts2.push({ kind: "substitution", script: parseSource(source, this.depth + this.operandDepth + 1, this.warnings, line - 1, this.byteLocale, this.budget), line, quoted });
       } catch (error) {
         if (this.documentLine === void 0 || !(error instanceof ShellSyntaxError) || /nesting|exceeds/u.test(error.reason)) throw error;
         this.budget.admit();
-        parts.push({ kind: "failed-substitution", diagnostic: this.documentSubstitutionError(source, error, true).diagnostic, quoted });
+        parts2.push({ kind: "failed-substitution", diagnostic: this.documentSubstitutionError(source, error, true).diagnostic, quoted });
       }
       if (this.documentLine === void 0) {
         this.budget.admit();
-        expansionSpellings.set(parts.at(-1), { source: this.source, start: spellingStart, end: this.position });
+        expansionSpellings.set(parts2.at(-1), { source: this.source, start: spellingStart, end: this.position });
       }
       return;
     }
@@ -7847,7 +7893,7 @@ shell: command substitution: line ${line}: \`${sourceLine}'
       const start = this.position + 2;
       const end = arithmeticEnd(this.source, start);
       const source = this.source.slice(start, end);
-      parts.push({ kind: "arithmetic", expression: prepareArithmetic(source, this.budget), source, line, quoted });
+      parts2.push({ kind: "arithmetic", expression: prepareArithmetic(source, this.budget), source, line, quoted });
       this.position = end + 2;
     } else if (this.source[this.position] === "(") {
       const start = this.position + 1;
@@ -7870,7 +7916,7 @@ shell: command substitution: line ${line}: \`${sourceLine}'
       this.position += nested.current.end + 1;
       if (script.printedNewlines === void 0) this.unprintedWords++;
       else this.printedNewlineReduction += this.source.slice(start, this.position - 1).split("\n").length - 1 - script.printedNewlines;
-      parts.push({ kind: "substitution", script, line, sourceLine: script.line ?? line, quoted });
+      parts2.push({ kind: "substitution", script, line, sourceLine: script.line ?? line, quoted });
     } else if (this.source[this.position] === "{") {
       this.position++;
       const parameterStart = this.position - 2;
@@ -7925,17 +7971,17 @@ shell: command substitution: line ${line}: \`${sourceLine}'
       this.position++;
       const part = { kind: "variable", name: name2, quoted, line, ...length ? { length } : {}, ...operator ? { operator, alternate } : {}, ...replacement ? { replacement } : {}, ...substring ? { substring } : {} };
       if (selector) setArraySelector(part, selector);
-      parts.push(part);
+      parts2.push(part);
     } else {
       const name2 = /^(?:[a-zA-Z_][a-zA-Z_0-9]*|[?@*#0-9-])/u.exec(this.source.slice(this.position))?.[0];
       if (name2) {
         this.position += name2.length;
-        parts.push({ kind: "variable", name: name2, quoted, line });
-      } else parts.push({ kind: "text", value: "$", quoted });
+        parts2.push({ kind: "variable", name: name2, quoted, line });
+      } else parts2.push({ kind: "text", value: "$", quoted });
     }
     if (this.documentLine === void 0) {
       this.budget.admit();
-      expansionSpellings.set(parts.at(-1), { source: this.source, start: spellingStart, end: this.position });
+      expansionSpellings.set(parts2.at(-1), { source: this.source, start: spellingStart, end: this.position });
     }
   }
 };
@@ -8805,7 +8851,7 @@ async function* expandBraces(word, budget, signal) {
       const materialized = budget.values.scope();
       try {
         materialized.reserve(64, 0);
-        const parts = [];
+        const parts2 = [];
         const generatedSyntax = /* @__PURE__ */ new WeakSet();
         const pending = [{ node: root, rank }];
         while (pending.length) {
@@ -8847,24 +8893,24 @@ async function* expandBraces(word, budget, signal) {
                 generatedSyntax.add(part);
               }
             }
-            const previous = parts.at(-1);
+            const previous = parts2.at(-1);
             if (part.kind === "text" && !part.quoted && !part.byteValue && !generatedSyntax.has(part) && previous?.kind === "text" && !previous.quoted && !previous.byteValue && !generatedSyntax.has(previous)) {
               materialized.reserve((previous.value.length + part.value.length) * 2, 0);
-              parts[parts.length - 1] = { kind: "text", value: previous.value + part.value, quoted: false };
-            } else parts.push(part);
+              parts2[parts2.length - 1] = { kind: "text", value: previous.value + part.value, quoted: false };
+            } else parts2.push(part);
           }
         }
-        for (let index = 0; index < parts.length; index++) {
+        for (let index = 0; index < parts2.length; index++) {
           await checkpoint();
-          const part = parts[index];
+          const part = parts2[index];
           if (!generatedSyntax.has(part) || part.kind !== "text") continue;
           materialized.reserve(128, 0);
           const fragments = [];
           const opaque = /* @__PURE__ */ new Map();
           let length = 0;
-          for (let position = index; position < parts.length; position++) {
+          for (let position = index; position < parts2.length; position++) {
             await checkpoint();
-            const current = parts[position];
+            const current = parts2[position];
             const spelling2 = expansionSpellings.get(current);
             materialized.reserve(32, 0);
             let fragment;
@@ -8892,11 +8938,11 @@ async function* expandBraces(word, budget, signal) {
             throw new BraceExpansionFailure(error.reason);
           }
           materialized.reserve(replayed.parts.length * 32, 0);
-          parts.length = index;
-          for (const replayedPart of replayed.parts) parts.push(replayedPart);
+          parts2.length = index;
+          for (const replayedPart of replayed.parts) parts2.push(replayedPart);
           break;
         }
-        yield { parts, offset: word.offset };
+        yield { parts: parts2, offset: word.offset };
       } finally {
         materialized.close();
       }
@@ -9703,11 +9749,11 @@ function stagedFailure(state, reason) {
   throwAdmissionFailure(state);
   throw reason;
 }
-function prepareControls(parent, controls) {
-  if (controls === void 0) return Object.freeze([]);
-  if (!Array.isArray(controls)) return stagedFailure(parent, new TypeError("Cancellation controls must be an array"));
+function prepareControls(parent, controls2) {
+  if (controls2 === void 0) return Object.freeze([]);
+  if (!Array.isArray(controls2)) return stagedFailure(parent, new TypeError("Cancellation controls must be an array"));
   const prepared = [];
-  for (const input3 of controls) {
+  for (const input3 of controls2) {
     let role;
     let signal;
     try {
@@ -9725,13 +9771,13 @@ function prepareControls(parent, controls) {
   throwAdmissionFailure(parent);
   return Object.freeze(prepared);
 }
-function makePrepared(parent, localSignal, controls, admission) {
+function makePrepared(parent, localSignal, controls2, admission) {
   const state = {
     parent,
     localSignal,
-    controls,
+    controls: controls2,
     admission,
-    owned: localSignal !== void 0 || controls.length > 0,
+    owned: localSignal !== void 0 || controls2.length > 0,
     replayError: new Error("Prepared cancellation admission was already activated"),
     activated: false
   };
@@ -9751,7 +9797,7 @@ function throwLocalActivationFailure(state) {
   const failure = localActivationFailure(state);
   if (failure.failed) throw failure.reason;
 }
-function prepareChildCancellation(parent, options3, snapshot, controls) {
+function prepareChildCancellation(parent, options3, snapshot, controls2) {
   const parentState = requireLink(parent);
   throwAdmissionFailure(parentState);
   let localSignal;
@@ -9773,7 +9819,7 @@ function prepareChildCancellation(parent, options3, snapshot, controls) {
     throwAdmissionFailure(parentState);
     if (localSignal !== void 0 && signalAborted(localSignal)) throw localSignal.reason;
   }
-  const preparedControls = prepareControls(parentState, controls);
+  const preparedControls = prepareControls(parentState, controls2);
   if (localSignal === void 0 && preparedControls.length === 0) {
     return makePrepared(parentState, void 0, preparedControls, void 0);
   }
@@ -9846,16 +9892,16 @@ function createRootCancellationLink(input3) {
   const admission = validateSnapshot(input3.admission);
   if (admission.depth !== 0) throw new RangeError("Root cancellation depth must be zero");
   if (input3.callerSignal !== void 0 && !nativeSignal(input3.callerSignal)) throw new TypeError("Root caller signal must be an AbortSignal");
-  const controls = input3.controls ?? [];
-  if (!Array.isArray(controls)) throw new TypeError("Cancellation controls must be an array");
-  for (const control of controls) {
+  const controls2 = input3.controls ?? [];
+  if (!Array.isArray(controls2)) throw new TypeError("Cancellation controls must be an array");
+  for (const control of controls2) {
     if (!control || typeof control !== "object" || control.role !== "budget-control" && control.role !== "pipeline-control" || !nativeSignal(control.signal)) throw new TypeError("Invalid cancellation control origin");
   }
-  const required = 1 + Number(input3.callerSignal !== void 0 && !signalAborted(input3.callerSignal)) + controls.filter((control) => !signalAborted(control.signal)).length;
+  const required = 1 + Number(input3.callerSignal !== void 0 && !signalAborted(input3.callerSignal)) + controls2.filter((control) => !signalAborted(control.signal)).length;
   if (admission.resourceLimit < required) throw new CancellationCapacityError();
   const state = initializeState(void 0, admission);
   state.rootCaller = input3.callerSignal === void 0 ? void 0 : Object.freeze({ role: "root-caller", signal: input3.callerSignal, frame: state.boundary });
-  state.controls = Object.freeze(controls.map((control) => Object.freeze({
+  state.controls = Object.freeze(controls2.map((control) => Object.freeze({
     role: control.role,
     signal: control.signal,
     frame: state.boundary
@@ -12686,16 +12732,16 @@ var Runtime = class _Runtime {
       resourceLimit: _Runtime.cancellationResourceLimit(budget, 0, maxDepth, 2)
     };
   }
-  static cancellationResourceLimit(budget, depth, maxDepth, controls) {
+  static cancellationResourceLimit(budget, depth, maxDepth, controls2) {
     const remainingCommands = Math.max(0, budget.limits.maxCommands - budget.commands);
     const remainingDepth = Math.max(0, maxDepth - depth);
-    return saturatedSum(saturatedSum(4, controls), saturatedSum(remainingCommands, remainingDepth));
+    return saturatedSum(saturatedSum(4, controls2), saturatedSum(remainingCommands, remainingDepth));
   }
-  cancellationAdmission(depth, controls = 0) {
+  cancellationAdmission(depth, controls2 = 0) {
     return {
       depth,
       maxDepth: this.cancellationMaxDepth,
-      resourceLimit: _Runtime.cancellationResourceLimit(this.budget, depth, this.cancellationMaxDepth, controls)
+      resourceLimit: _Runtime.cancellationResourceLimit(this.budget, depth, this.cancellationMaxDepth, controls2)
     };
   }
   observeRuntimeReturn(rawReturn, frame, downstream = () => void 0) {
@@ -12794,7 +12840,7 @@ var Runtime = class _Runtime {
     if (this.outcomeFrame) this.outcomeFrame.report = void 0;
   }
   diagnostic(io, text) {
-    return writeText(io.stderr, `${io.scriptName ?? "shell"}: line ${io.diagnosticLine ?? 1}: ${text}
+    return writeDiagnostic(io.stderr, `${io.scriptName ?? "shell"}: line ${io.diagnosticLine ?? 1}: ${text}
 `);
   }
   writeVariable(state, name2, value2, origin = "assignment") {
@@ -12945,10 +12991,10 @@ var Runtime = class _Runtime {
         await textToken(store.owner, env[key], this.signal);
         publications.set(key, operation.reserve({ generation: true, version: true, epoch: true, work: 8 }));
       }
-      const controls = operation.reserve({ epoch: true, work: state.exported.size + keys.length + 5 });
+      const controls2 = operation.reserve({ epoch: true, work: state.exported.size + keys.length + 5 });
       this.signal.throwIfAborted();
       if (stateMonitor(state).epoch !== epoch) throw new ArrayFailure("stale state snapshot");
-      stateMonitor(state).publish(controls, void 0, () => {
+      stateMonitor(state).publish(controls2, void 0, () => {
         for (const key of state.exported) delete state.variables[key];
         state.exported = new Set(keys);
       });
@@ -13268,14 +13314,14 @@ var Runtime = class _Runtime {
           const incoming = pipes[index - 1];
           const outgoing = pipes[index];
           const childDepth = this.cancellationDepth + 1;
-          const controls = [
+          const controls2 = [
             { role: "pipeline-control", signal: controllers[index].signal }
           ];
           const prepared = prepareChildCancellation(
             this.cancellation,
             void 0,
-            this.cancellationAdmission(childDepth, controls.length),
-            controls
+            this.cancellationAdmission(childDepth, controls2.length),
+            controls2
           );
           const owner = new InvocationCancellationOwner(io[invocationScope], prepared, this.cancellationState);
           let boundary;
@@ -13629,7 +13675,7 @@ var Runtime = class _Runtime {
       if (error instanceof Flow || error instanceof ShellLimitError || error instanceof ShellSyntaxError) throw error;
       this.clearOutcomeReport();
       if (error instanceof HereDocumentSyntaxError) {
-        await writeText(io.stderr, error.diagnostic);
+        await writeDiagnostic(io.stderr, error.diagnostic);
         if (command2.kind !== "simple" && command2.kind !== "subshell" && command2.kind !== "arithmetic" && command2.kind !== "conditional") this.errexit(1, state, io);
         return 1;
       }
@@ -13641,7 +13687,7 @@ var Runtime = class _Runtime {
       if (error instanceof NounsetFailure || error instanceof ParameterExpansionFailure) {
         const detail = error instanceof ParameterExpansionFailure ? diagnostic3 ?? message(error) : message(error);
         try {
-          await writeText(io.stderr, `${io.scriptName ?? "shell"}: line ${line}: ${detail}
+          await writeDiagnostic(io.stderr, `${io.scriptName ?? "shell"}: line ${line}: ${detail}
 `);
         } catch (reason) {
           this.signal.throwIfAborted();
@@ -13651,11 +13697,11 @@ var Runtime = class _Runtime {
         }
         throw completedExit(error instanceof ParameterExpansionFailure && !state.isolated ? 127 : 1);
       }
-      if (error instanceof ArrayFailure) await writeText(io.stderr, `${io.scriptName ?? "shell"}: line ${line}: ${diagnostic3 ?? message(error)}
+      if (error instanceof ArrayFailure) await writeDiagnostic(io.stderr, `${io.scriptName ?? "shell"}: line ${line}: ${diagnostic3 ?? message(error)}
 `);
       else {
         try {
-          await writeText(io.stderr, `${io.scriptName ?? "shell"}: line ${line}: ${diagnostic3 ?? message(error)}
+          await writeDiagnostic(io.stderr, `${io.scriptName ?? "shell"}: line ${line}: ${diagnostic3 ?? message(error)}
 `);
         } catch {
           this.signal.throwIfAborted();
@@ -13700,7 +13746,7 @@ var Runtime = class _Runtime {
     try {
       for (const word of hereDocumentWords(document, line, byteLocale(state.variables), warnings, this.budget.parsing)) {
         this.signal.throwIfAborted();
-        for (const warning of warnings.splice(0)) await writeText(io.stderr, `shell: warning: ${warning}
+        for (const warning of warnings.splice(0)) await writeDiagnostic(io.stderr, `shell: warning: ${warning}
 `);
         if (++words % 128 === 0) await yieldTurn(this.signal);
         const part = (await this.word(word, state, io, false)).join("");
@@ -13709,7 +13755,7 @@ var Runtime = class _Runtime {
         value2 += part;
       }
     } finally {
-      for (const warning of warnings.splice(0)) await writeText(io.stderr, `shell: warning: ${warning}
+      for (const warning of warnings.splice(0)) await writeDiagnostic(io.stderr, `shell: warning: ${warning}
 `);
     }
     return value2;
@@ -14402,8 +14448,8 @@ var Runtime = class _Runtime {
         } else {
           if (command2 && flag !== "p") {
             await this.diagnostic({ ...io, ...context }, `command: -${flag}: invalid option`);
-            await writeText(context.stderr, "command: usage: command [-pVv] command [arg ...]\n");
-          } else await writeText(context.stderr, `${context.command}: ${option}: unsupported option
+            await writeDiagnostic(context.stderr, "command: usage: command [-pVv] command [arg ...]\n");
+          } else await writeDiagnostic(context.stderr, `${context.command}: ${option}: unsupported option
 `);
           return 2;
         }
@@ -14452,7 +14498,7 @@ var Runtime = class _Runtime {
         }));
       }
       if (!matches.length) {
-        if (mode === "describe") await writeText(context.stderr, `${io.scriptName ?? "shell"}: line ${io.diagnosticLine ?? 1}: ${context.command}: ${name2}: not found
+        if (mode === "describe") await writeDiagnostic(context.stderr, `${io.scriptName ?? "shell"}: line ${io.diagnosticLine ?? 1}: ${context.command}: ${name2}: not found
 `);
         continue;
       }
@@ -14554,7 +14600,7 @@ ${functionDisplay(name2, state.functions.get(name2))}`;
       }
       const flags = option.slice(1);
       if (!flags.length || [...flags].some((flag) => !(option[0] === "-" ? "cseB" : "eB").includes(flag))) {
-        await writeText(context.stderr, `${context.command}: ${option}: unsupported option; supported flags are -c, -s, -e, +e, -B, +B and +/-o braceexpand
+        await writeDiagnostic(context.stderr, `${context.command}: ${option}: unsupported option; supported flags are -c, -s, -e, +e, -B, +B and +/-o braceexpand
 `);
         return 2;
       }
@@ -14566,7 +14612,7 @@ ${functionDisplay(name2, state.functions.get(name2))}`;
     if (!commandString && !standardInput && args.length) return this.scriptFile(context, state, io, args[0], args.slice(1), false, errexit, loadedSource, braceexpand);
     const source = commandString ? args.shift() : void 0;
     if (commandString && source === void 0) {
-      await writeText(context.stderr, `${context.command}: -c: option requires an argument
+      await writeDiagnostic(context.stderr, `${context.command}: -c: option requires an argument
 `);
       return 2;
     }
@@ -14586,15 +14632,15 @@ ${functionDisplay(name2, state.functions.get(name2))}`;
     const offset = io.diagnosticOffset ?? 0;
     const line = source.slice(0, error.offset).split("\n").length;
     const prefix2 = `${io.scriptName ?? "shell"}:${commandString ? " -c:" : ""}`;
-    if (error.unclosedQuote) await writeText(io.stderr, `${prefix2} line ${offset + error.unclosedQuote.line}: unexpected EOF while looking for matching \`${error.unclosedQuote.quote}'
+    if (error.unclosedQuote) await writeDiagnostic(io.stderr, `${prefix2} line ${offset + error.unclosedQuote.line}: unexpected EOF while looking for matching \`${error.unclosedQuote.quote}'
 `);
     else if (error.offset >= source.length && !/Unterminated|nesting|Unsupported/u.test(error.reason)) {
       const context = error.incompleteCommand ? ` from \`${error.incompleteCommand.name}' command on line ${offset + error.incompleteCommand.line}` : "";
-      await writeText(io.stderr, `${prefix2} line ${offset + source.split("\n").length + Number(!source.endsWith("\n"))}: syntax error: unexpected end of file${context}
+      await writeDiagnostic(io.stderr, `${prefix2} line ${offset + source.split("\n").length + Number(!source.endsWith("\n"))}: syntax error: unexpected end of file${context}
 `);
     } else {
       const token = /^[;&|()<>]|^[^\s;&|()<>]+/u.exec(source.slice(error.offset))?.[0] ?? "newline";
-      await writeText(io.stderr, `${prefix2} line ${offset + line}: syntax error near unexpected token \`${token}'
+      await writeDiagnostic(io.stderr, `${prefix2} line ${offset + line}: syntax error near unexpected token \`${token}'
 ${prefix2} line ${offset + line}: \`${source.split("\n")[line - 1] ?? ""}'
 `);
     }
@@ -14608,7 +14654,7 @@ ${prefix2} line ${offset + line}: \`${source.split("\n")[line - 1] ?? ""}'
       do {
         this.signal.throwIfAborted();
         const unit = parseShellUnit(source, position, byteLocale(state.variables), this.budget.parsing, lineIndex);
-        for (const warning of unit.script.warnings ?? []) await writeText(io.stderr, `${io.scriptName}: warning: ${warning}
+        for (const warning of unit.script.warnings ?? []) await writeDiagnostic(io.stderr, `${io.scriptName}: warning: ${warning}
 `);
         if (unit.script.lists.length) {
           const result = await this.runUnit(unit.script, state, io);
@@ -14650,7 +14696,7 @@ ${prefix2} line ${offset + line}: \`${source.split("\n")[line - 1] ?? ""}'
       try {
         const unit = eof ? parseShellUnit(source, 0, byteLocale(state.variables), this.budget.parsing, lineIndex) : parseShellInputUnit(source, byteLocale(state.variables), this.budget.parsing, lineIndex);
         if (unit) {
-          for (const warning of unit.script.warnings ?? []) await writeText(io.stderr, `${io.scriptName}: warning: ${warning}
+          for (const warning of unit.script.warnings ?? []) await writeDiagnostic(io.stderr, `${io.scriptName}: warning: ${warning}
 `);
           if (unit.script.lists.length) {
             const result = await this.runUnit(unit.script, state, unitIO);
@@ -14828,7 +14874,7 @@ ${prefix2} line ${offset + line}: \`${source.split("\n")[line - 1] ?? ""}'
       }
       if (direct) return { exitCode: await runtime.scriptFile(forwarded, state2, childIO, command2, forwarded.args, true) };
       if (definition) return definition.execute(forwarded);
-      await writeText(forwarded.stderr, `env: ${command2}: command not found
+      await writeDiagnostic(forwarded.stderr, `env: ${command2}: command not found
 `);
       return { exitCode: 127 };
     }, void 0, options3.stdin !== context.stdin ? options3.stdin : void 0, scope);
@@ -14921,7 +14967,7 @@ ${prefix2} line ${offset + line}: \`${source.split("\n")[line - 1] ?? ""}'
     } catch (error) {
       if (!(error instanceof ShellSyntaxError)) throw error;
       const line = source.slice(0, error.offset).split("\n").length;
-      await writeText(context.stderr, `${target}: line ${line}: syntax error: ${error.reason}
+      await writeDiagnostic(context.stderr, `${target}: line ${line}: syntax error: ${error.reason}
 `);
       return error.exitCode;
     }
@@ -14932,7 +14978,7 @@ ${prefix2} line ${offset + line}: \`${source.split("\n")[line - 1] ?? ""}'
     const childIO = isolateIO({ ...io, ...context, execution: { ignoreErrexit: false }, diagnosticLine: 1, diagnosticOffset: 0, scriptName: target });
     let status = 0;
     for (const unit of units) {
-      for (const warning of unit.warnings ?? []) await writeText(context.stderr, `${target}: warning: ${warning}
+      for (const warning of unit.warnings ?? []) await writeDiagnostic(context.stderr, `${target}: warning: ${warning}
 `);
       if (!unit.lists.length) continue;
       const result = await this.runUnit(unit, child, childIO);
@@ -14950,7 +14996,7 @@ ${prefix2} line ${offset + line}: \`${source.split("\n")[line - 1] ?? ""}'
       do {
         this.signal.throwIfAborted();
         const unit = parseShellUnit(source, position, byteLocale(state.variables), this.budget.parsing, lineIndex);
-        for (const warning of unit.script.warnings ?? []) await writeText(io.stderr, `${io.scriptName ?? "shell"}: warning: ${warning}
+        for (const warning of unit.script.warnings ?? []) await writeDiagnostic(io.stderr, `${io.scriptName ?? "shell"}: warning: ${warning}
 `);
         if (unit.script.lists.length) {
           status = await this.script(unit.script, state, io);
@@ -14971,7 +15017,7 @@ ${prefix2} line ${offset + line}: \`${source.split("\n")[line - 1] ?? ""}'
     if (args[0] === "--") args.shift();
     else if (args[0]?.startsWith("-") && args[0] !== "-") {
       await this.diagnostic(io, `eval: -${args[0][1]}: invalid option`);
-      await writeText(io.stderr, "eval: usage: eval [arg ...]\n");
+      await writeDiagnostic(io.stderr, "eval: usage: eval [arg ...]\n");
       if (special2) throw new Flow("exit", 2);
       return 2;
     }
@@ -15008,7 +15054,7 @@ ${prefix2} line ${offset + line}: \`${source.split("\n")[line - 1] ?? ""}'
     const filename = args.shift();
     if (filename === void 0) {
       await this.diagnostic(io, `${context.command}: filename argument required`);
-      await writeText(io.stderr, `${context.command}: usage: ${context.command} [-p path] filename [arguments]
+      await writeDiagnostic(io.stderr, `${context.command}: usage: ${context.command} [-p path] filename [arguments]
 `);
       if (special2) throw new Flow("exit", 2);
       return 2;
@@ -15220,7 +15266,7 @@ ${prefix2} line ${offset + line}: \`${source.split("\n")[line - 1] ?? ""}'
         } else valid = false;
       }
       if (!valid) {
-        await writeText(stderr, "set: unsupported shell option; supported forms are +/- e/u/B clusters, -- arguments and terminal o with braceexpand, pipefail, errexit or nounset\n");
+        await writeDiagnostic(stderr, "set: unsupported shell option; supported forms are +/- e/u/B clusters, -- arguments and terminal o with braceexpand, pipefail, errexit or nounset\n");
         return 1;
       }
       index++;
@@ -15299,11 +15345,11 @@ ${prefix2} line ${offset + line}: \`${source.split("\n")[line - 1] ?? ""}'
     const offset = context.args[0] === "--" ? 1 : 0;
     if (!offset && context.args[0]?.startsWith("-") && context.args[0] !== "-") {
       await this.diagnostic(context, `getopts: -${context.args[0][1]}: invalid option`);
-      await writeText(context.stderr, "getopts: usage: getopts optstring name [arg ...]\n");
+      await writeDiagnostic(context.stderr, "getopts: usage: getopts optstring name [arg ...]\n");
       return 2;
     }
     if (context.args.length - offset < 2) {
-      await writeText(context.stderr, "getopts: usage: getopts optstring name [arg ...]\n");
+      await writeDiagnostic(context.stderr, "getopts: usage: getopts optstring name [arg ...]\n");
       return 2;
     }
     const optstring = context.args[offset];
@@ -15333,7 +15379,7 @@ ${prefix2} line ${offset + line}: \`${source.split("\n")[line - 1] ?? ""}'
     state.getopts.cursor = result.state;
     if (result.diagnostic) {
       const explanation = result.diagnostic.kind === "unknown-option" ? "illegal option" : "option requires an argument";
-      await writeText(context.stderr, `${state.arg0 ?? context.scriptName ?? "shell"}: ${explanation} -- ${result.diagnostic.option}
+      await writeDiagnostic(context.stderr, `${state.arg0 ?? context.scriptName ?? "shell"}: ${explanation} -- ${result.diagnostic.option}
 `);
     }
     this.signal.throwIfAborted();
@@ -15348,13 +15394,13 @@ ${prefix2} line ${offset + line}: \`${source.split("\n")[line - 1] ?? ""}'
     const name2 = stackHooks?.name ?? "cd";
     this.signal.throwIfAborted();
     if (args.length > 1) {
-      await writeText(context.stderr, `${name2}: too many arguments
+      await writeDiagnostic(context.stderr, `${name2}: too many arguments
 `);
       return 1;
     }
     const target = args[0] === "-" ? state.variables.OLDPWD : args[0] ?? state.variables.HOME;
     if (target === void 0) {
-      await writeText(context.stderr, `${name2}: ${args[0] === "-" ? "OLDPWD" : "HOME"} not set
+      await writeDiagnostic(context.stderr, `${name2}: ${args[0] === "-" ? "OLDPWD" : "HOME"} not set
 `);
       return 1;
     }
@@ -15566,7 +15612,7 @@ ${prefix2} line ${offset + line}: \`${source.split("\n")[line - 1] ?? ""}'
         else if (flag === "u") unset = true;
         else {
           await this.diagnostic(context, `shopt: ${option.startsWith("--") ? option : `-${flag}`}: unsupported option`);
-          await writeText(context.stderr, "shopt: usage: shopt [-pqsu] [--] [dotglob ...]\n");
+          await writeDiagnostic(context.stderr, "shopt: usage: shopt [-pqsu] [--] [dotglob ...]\n");
           return 2;
         }
       }
@@ -15608,20 +15654,20 @@ ${prefix2} line ${offset + line}: \`${source.split("\n")[line - 1] ?? ""}'
       const option = incoming.args[offset++];
       const target = option.slice(2) || incoming.args[offset++];
       if (target === void 0) {
-        await writeText(context.stderr, "printf: -v: option requires an argument\n");
+        await writeDiagnostic(context.stderr, "printf: -v: option requires an argument\n");
         return 2;
       }
       const bracket = target.indexOf("[");
       name2 = bracket < 0 ? target : target.slice(0, bracket);
       if (!/^[a-zA-Z_][a-zA-Z_0-9]*$/u.test(name2) || bracket >= 0 && !target.endsWith("]")) {
-        await writeText(context.stderr, `printf: '${target}': not a valid identifier
+        await writeDiagnostic(context.stderr, `printf: '${target}': not a valid identifier
 `);
         return 2;
       }
       index = void 0;
       if (bracket >= 0) {
         if (target[bracket + 1] === "'" || target[bracket + 1] === '"') {
-          await writeText(context.stderr, `printf: '${target}': unsupported indexed-array subscript
+          await writeDiagnostic(context.stderr, `printf: '${target}': unsupported indexed-array subscript
 `);
           return 2;
         }
@@ -15630,12 +15676,12 @@ ${prefix2} line ${offset + line}: \`${source.split("\n")[line - 1] ?? ""}'
         } catch (error) {
           this.signal.throwIfAborted();
           if (!(error instanceof ShellSyntaxError)) throw error;
-          await writeText(context.stderr, `printf: '${target}': unsupported indexed-array subscript
+          await writeDiagnostic(context.stderr, `printf: '${target}': unsupported indexed-array subscript
 `);
           return 2;
         }
         if (numericIndex(index) === void 0) {
-          await writeText(context.stderr, "printf: index outside 0..2147483647\n");
+          await writeDiagnostic(context.stderr, "printf: index outside 0..2147483647\n");
           return 2;
         }
       }
@@ -15643,7 +15689,7 @@ ${prefix2} line ${offset + line}: \`${source.split("\n")[line - 1] ?? ""}'
     const arguments_ = incoming.slice(offset);
     const format = arguments_.args[0] === "--" ? arguments_.args[1] : arguments_.args[0];
     if (format === void 0 || arguments_.args[0] !== "--" && format.startsWith("-")) {
-      await writeText(context.stderr, "printf: usage: printf [-v var] format [arguments]\n");
+      await writeDiagnostic(context.stderr, "printf: usage: printf [-v var] format [arguments]\n");
       return 2;
     }
     const allocation = this.budget.values.scope();
@@ -15668,14 +15714,14 @@ ${prefix2} line ${offset + line}: \`${source.split("\n")[line - 1] ?? ""}'
       } catch (error) {
         this.signal.throwIfAborted();
         if (!(error instanceof UsageError)) throw error;
-        await writeText(context.stderr, `printf: ${error.message}
+        await writeDiagnostic(context.stderr, `printf: ${error.message}
 `);
         status = 1;
       }
       const value2 = concatShellValues(chunks, allocation);
       this.signal.throwIfAborted();
       if (state.readonlyVariables?.has(name2)) {
-        await writeText(context.stderr, `printf: ${name2}: readonly variable
+        await writeDiagnostic(context.stderr, `printf: ${name2}: readonly variable
 `);
         return 1;
       }
@@ -15696,7 +15742,7 @@ ${prefix2} line ${offset + line}: \`${source.split("\n")[line - 1] ?? ""}'
           if (decode(shellValueBytes(previous2, allocation)) === void 0) text = void 0;
         }
         if (text === void 0) {
-          await writeText(context.stderr, "printf: indexed variables do not support non-UTF-8 bytes\n");
+          await writeDiagnostic(context.stderr, "printf: indexed variables do not support non-UTF-8 bytes\n");
           return 1;
         }
         if (index) await this.arrayAssignment({ kind: "element", name: name2, index, append: false, value: { offset: 0, parts: [{ kind: "text", value: text, quoted: true }] } }, state, context);
@@ -15723,7 +15769,7 @@ ${prefix2} line ${offset + line}: \`${source.split("\n")[line - 1] ?? ""}'
     if (command2 === "pushd" || command2 === "dirs" || command2 === "popd") return this.directoryStackBuiltin(context, state, diagnose);
     if (command2 === "pwd") {
       if (args.some((arg) => arg !== "-L" && arg !== "-P")) {
-        await writeText(stderr, "pwd: invalid option\n");
+        await writeDiagnostic(stderr, "pwd: invalid option\n");
         return 2;
       }
       const path = args.at(-1) === "-P" ? await this.fs.realpath(state.cwd, { signal: this.signal }) : state.cwd;
@@ -15762,7 +15808,7 @@ ${prefix2} line ${offset + line}: \`${source.split("\n")[line - 1] ?? ""}'
           continue;
         }
         if (/^[+-]/u.test(option)) {
-          await writeText(stderr, "set: unsupported shell option; supported forms are +/- e/u clusters, -- arguments and terminal o with pipefail, errexit or nounset\n");
+          await writeDiagnostic(stderr, "set: unsupported shell option; supported forms are +/- e/u clusters, -- arguments and terminal o with pipefail, errexit or nounset\n");
           if (state.profile === "sh" && suppressSpecial) return 2;
           throw new Flow("exit", 2);
         }
@@ -15774,7 +15820,7 @@ ${prefix2} line ${offset + line}: \`${source.split("\n")[line - 1] ?? ""}'
         state.positionalSetVersion = (state.positionalSetVersion ?? 0) + 1;
       }
       if (args.length) return 0;
-      await writeText(stderr, "set: supported forms are +/- e/u clusters, -- arguments and terminal o with pipefail, errexit or nounset\n");
+      await writeDiagnostic(stderr, "set: supported forms are +/- e/u clusters, -- arguments and terminal o with pipefail, errexit or nounset\n");
       return 2;
     }
     if (command2 === "shift") {
@@ -15789,14 +15835,14 @@ ${prefix2} line ${offset + line}: \`${source.split("\n")[line - 1] ?? ""}'
       if (command2 === "local") {
         const options3 = localDeclarationOptions(declarationArgs, this.signal);
         if (options3.error !== void 0) {
-          await writeText(stderr, `local: ${options3.error}: unsupported option
+          await writeDiagnostic(stderr, `local: ${options3.error}: unsupported option
 `);
           return 2;
         }
         indexedLocal = options3.indexed;
         declarationArgs.splice(0, options3.offset);
         if (indexedLocal && declarationArgs.length === 0) {
-          await writeText(stderr, "local: -a requires a variable name\n");
+          await writeDiagnostic(stderr, "local: -a requires a variable name\n");
           return 2;
         }
       }
@@ -15805,7 +15851,7 @@ ${prefix2} line ${offset + line}: \`${source.split("\n")[line - 1] ?? ""}'
           const option = declarationArgs.shift();
           if (option === "--") break;
           if (option !== "-p") {
-            await writeText(stderr, `readonly: ${option}: unsupported option
+            await writeDiagnostic(stderr, `readonly: ${option}: unsupported option
 `);
             return 2;
           }
@@ -15813,7 +15859,7 @@ ${prefix2} line ${offset + line}: \`${source.split("\n")[line - 1] ?? ""}'
       }
       const locals = state.locals.at(-1);
       if (command2 === "local" && !locals) {
-        await writeText(stderr, "local: not in a function\n");
+        await writeDiagnostic(stderr, "local: not in a function\n");
         return 1;
       }
       let status = 0;
@@ -16062,7 +16108,7 @@ ${prefix2} line ${offset + line}: \`${source.split("\n")[line - 1] ?? ""}'
           continue;
         }
         if (!/^[a-zA-Z_][a-zA-Z_0-9]*$/u.test(name2)) {
-          await writeText(stderr, `unset: ${name2}: not a valid identifier
+          await writeDiagnostic(stderr, `unset: ${name2}: not a valid identifier
 `);
           status = 1;
           continue;
@@ -16104,7 +16150,7 @@ ${prefix2} line ${offset + line}: \`${source.split("\n")[line - 1] ?? ""}'
           else if (flag === "d") delimiter = new TextEncoder().encode(value2)[0] ?? 0;
           else if (exact && (!/^[ \t]*[+-]?\d+[ \t]*$/u.test(value2) || !Number.isSafeInteger(Number(value2)) || Number(value2) < 0)) {
             const diagnosticIO = context;
-            await writeText(stderr, `${diagnosticIO.scriptName ?? "shell"}: line ${diagnosticIO.diagnosticLine ?? 1}: read: ${value2}: invalid ${/^[+-]?0[xX]/u.test(value2) ? "hex " : ""}number
+            await writeDiagnostic(stderr, `${diagnosticIO.scriptName ?? "shell"}: line ${diagnosticIO.diagnosticLine ?? 1}: read: ${value2}: invalid ${/^[+-]?0[xX]/u.test(value2) ? "hex " : ""}number
 `);
             return 1;
           } else if (!exact && (!/^\d+$/u.test(value2) || !Number.isSafeInteger(Number(value2)))) invalid = true;
@@ -16117,12 +16163,12 @@ ${prefix2} line ${offset + line}: \`${source.split("\n")[line - 1] ?? ""}'
       const invalidName = names.find((name2) => !/^[a-zA-Z_][a-zA-Z_0-9]*$/u.test(name2));
       if (exact && !invalid && invalidName !== void 0) {
         const diagnosticIO = context;
-        await writeText(stderr, `${diagnosticIO.scriptName ?? "shell"}: line ${diagnosticIO.diagnosticLine ?? 1}: read: \`${invalidName}': not a valid identifier
+        await writeDiagnostic(stderr, `${diagnosticIO.scriptName ?? "shell"}: line ${diagnosticIO.diagnosticLine ?? 1}: read: \`${invalidName}': not a valid identifier
 `);
         return 1;
       }
       if (invalid || names.some((name2) => !/^[a-zA-Z_][a-zA-Z_0-9]*$/u.test(name2))) {
-        await writeText(stderr, "read: invalid variable name or unsupported option\n");
+        await writeDiagnostic(stderr, "read: invalid variable name or unsupported option\n");
         return 2;
       }
       const input3 = context.stdin instanceof ShellInput ? context.stdin : new ShellInput(context.stdin, this.budget, this.signal);
@@ -16179,16 +16225,16 @@ ${prefix2} line ${offset + line}: \`${source.split("\n")[line - 1] ?? ""}'
     }
     if (command2 === "exit" || command2 === "return") {
       if (command2 === "return" && state.functionDepth === 0 && !state.sourceDepth) {
-        await writeText(stderr, "return: not in a function\n");
+        await writeDiagnostic(stderr, "return: not in a function\n");
         return 1;
       }
       if (args.length > 1) {
-        await writeText(stderr, `${command2}: too many arguments
+        await writeDiagnostic(stderr, `${command2}: too many arguments
 `);
         return 1;
       }
       if (args[0] !== void 0 && !/^[+-]?\d+$/u.test(args[0])) {
-        await writeText(stderr, `${command2}: ${args[0]}: numeric argument required
+        await writeDiagnostic(stderr, `${command2}: ${args[0]}: numeric argument required
 `);
         throw completedExit(2, command2);
       }
@@ -16198,12 +16244,12 @@ ${prefix2} line ${offset + line}: \`${source.split("\n")[line - 1] ?? ""}'
     if (command2 === "break" || command2 === "continue") {
       const levels = args[0] === void 0 ? 1 : Number(args[0]);
       if (args.length > 1 || !Number.isSafeInteger(levels) || levels < 1) {
-        await writeText(stderr, `${command2}: invalid loop count
+        await writeDiagnostic(stderr, `${command2}: invalid loop count
 `);
         return 1;
       }
       if (!state.loopDepth) {
-        await writeText(stderr, `${command2}: only meaningful in a loop
+        await writeDiagnostic(stderr, `${command2}: only meaningful in a loop
 `);
         return 0;
       }
@@ -16252,7 +16298,7 @@ ${prefix2} line ${offset + line}: \`${source.split("\n")[line - 1] ?? ""}'
     this.signal.throwIfAborted();
     if (part.kind === "failed-substitution") {
       if (state.depth >= this.budget.limits.maxSubstitutionDepth) this.budget.fail("maxSubstitutionDepth");
-      await writeText(io.stderr, part.diagnostic);
+      await writeDiagnostic(io.stderr, part.diagnostic);
       state.status = state.substitutionStatus = 2;
       return "";
     }
@@ -16305,7 +16351,7 @@ ${prefix2} line ${offset + line}: \`${source.split("\n")[line - 1] ?? ""}'
       }
       state.status = state.substitutionStatus;
       const bytes2 = capture.bytes();
-      if (bytes2.includes(0)) await writeText(io.stderr, `${io.scriptName ?? "shell"}: line ${warningLine}: warning: command substitution: ignored null byte in input
+      if (bytes2.includes(0)) await writeDiagnostic(io.stderr, `${io.scriptName ?? "shell"}: line ${warningLine}: warning: command substitution: ignored null byte in input
 `);
       let length = 0;
       for (const byte of bytes2) if (byte !== 0) bytes2[length++] = byte;
@@ -16701,9 +16747,9 @@ ${prefix2} line ${offset + line}: \`${source.split("\n")[line - 1] ?? ""}'
           separatorScope.close();
         }
       };
-      const parts = word.parts.map((part) => ({ part, splitText: false, io }));
-      for (let index = 0; index < parts.length; index++) {
-        const { part, splitText, io: partIO } = parts[index];
+      const parts2 = word.parts.map((part) => ({ part, splitText: false, io }));
+      for (let index = 0; index < parts2.length; index++) {
+        const { part, splitText, io: partIO } = parts2[index];
         const quotedPresence = part.quoted && !(arrayOwned && isQuoteMarker(part));
         if (part.kind === "variable" && ["-", "+", ":-", ":+"].includes(part.operator ?? "") && /^[a-zA-Z_][a-zA-Z_0-9]*$/u.test(part.name)) {
           const value2 = this.variable(state, part.name);
@@ -16713,7 +16759,7 @@ ${prefix2} line ${offset + line}: \`${source.split("\n")[line - 1] ?? ""}'
             scratch?.reserve(part.alternate.parts.length * 32, 0);
             const alternate = part.alternate.parts.map((entry) => ({ part: copyArraySelector(entry, { ...entry, quoted: entry.quoted || part.quoted }), splitText: true, io: operandIO }));
             if (!alternate.length && part.quoted) append("", false, true);
-            parts.splice(index + 1, 0, ...alternate);
+            parts2.splice(index + 1, 0, ...alternate);
             continue;
           }
         }
@@ -17546,7 +17592,7 @@ var Shell = class {
         );
         exitCode = 0;
         while (true) {
-          for (const warning of unit.script.warnings ?? []) await writeText(io.stderr, `shell: warning: ${warning}
+          for (const warning of unit.script.warnings ?? []) await writeDiagnostic(io.stderr, `shell: warning: ${warning}
 `);
           if (unit.script.lists.length) {
             const result = await interruptible(runtime.runUnit(unit.script, state, io), budget.signal);
@@ -17561,18 +17607,18 @@ var Shell = class {
         if (!(error instanceof ShellSyntaxError)) throw error;
         const line = source.slice(0, error.offset).split("\n").length;
         if (error.unclosedQuote) {
-          await writeText(io.stderr, `shell: -c: line ${error.unclosedQuote.line}: unexpected EOF while looking for matching \`${error.unclosedQuote.quote}'
+          await writeDiagnostic(io.stderr, `shell: -c: line ${error.unclosedQuote.line}: unexpected EOF while looking for matching \`${error.unclosedQuote.quote}'
 `);
         } else if (error.exitCode === 127) {
           const token = /^[;&|()<>]|^[^\s;&|()<>]+/u.exec(source.slice(error.offset))?.[0] ?? "newline";
-          await writeText(io.stderr, `shell: -c: line ${line}: syntax error near unexpected token \`${token}'
+          await writeDiagnostic(io.stderr, `shell: -c: line ${line}: syntax error near unexpected token \`${token}'
 shell: -c: line ${line}: \`${source.split("\n")[line - 1] ?? ""}'
 `);
         } else if (error.offset >= source.length && !/Unterminated|nesting|Unsupported/u.test(error.reason)) {
           const context = error.incompleteCommand ? ` from \`${error.incompleteCommand.name}' command on line ${error.incompleteCommand.line}` : "";
-          await writeText(io.stderr, `shell: -c: line ${source.split("\n").length + Number(!source.endsWith("\n"))}: syntax error: unexpected end of file${context}
+          await writeDiagnostic(io.stderr, `shell: -c: line ${source.split("\n").length + Number(!source.endsWith("\n"))}: syntax error: unexpected end of file${context}
 `);
-        } else await writeText(io.stderr, `shell: ${error.message}
+        } else await writeDiagnostic(io.stderr, `shell: ${error.message}
 `);
         exitCode = error.exitCode;
       }
@@ -17794,9 +17840,9 @@ function privateHostname(input3) {
     }
     return (hextets[0] & 65024) === 64512 || (hextets[0] & 65472) === 65152;
   }
-  const parts = hostname.split(".");
-  if (parts.length !== 4 || parts.some((part) => !part || Array.from(part).some((character) => character < "0" || character > "9"))) return false;
-  const octets = parts.map(Number);
+  const parts2 = hostname.split(".");
+  if (parts2.length !== 4 || parts2.some((part) => !part || Array.from(part).some((character) => character < "0" || character > "9"))) return false;
+  const octets = parts2.map(Number);
   if (octets.some((value2) => value2 < 0 || value2 > 255)) return false;
   const [first, second] = octets;
   return privateIPv4(first, second);
@@ -18507,8 +18553,8 @@ function command(name2, run) {
         return { exitCode: await run(context) };
       } catch (error) {
         context.signal.throwIfAborted();
-        await writeBytes(context.stderr, new TextEncoder().encode(`${name2}: ${error instanceof Error ? error.message : String(error)}
-`), context.signal);
+        await writeDiagnostic(context.stderr, `${name2}: ${error instanceof Error ? error.message : String(error)}
+`, context.signal);
         return { exitCode: error instanceof ProgramError ? 2 : 1 };
       }
     }
@@ -20344,8 +20390,8 @@ var Limits = class {
   }
 };
 async function diagnostic2(context, error) {
-  await writeBytes(context.stderr, import_buffer.Buffer.from(`rg: ${error instanceof Error ? error.message : String(error)}
-`), context.signal);
+  await writeDiagnostic(context.stderr, `rg: ${error instanceof Error ? error.message : String(error)}
+`, context.signal);
 }
 async function* lines2(source, limits, state, binary, nullData) {
   let pending = import_buffer.Buffer.alloc(0);