zarro 1.185.0 → 1.186.0

package/gulp-tasks/modules/system.js

@@ -91,6 +91,21 @@ ${tempFileContents}
         const result = new SystemResult(`${exe}`, programArgs, undefined, [], []);
         return new Promise((resolve, reject) => {
             const child = child_process.spawn(exe, programArgs, spawnOptions);
+            if (!!options) {
+                const optsWithKill = options;
+                optsWithKill.kill = (signal) => {
+                    destroyPipesOn(child);
+                    child.kill(signal);
+                };
+                if (optsWithKill === null || optsWithKill === void 0 ? void 0 : optsWithKill.onChildSpawned) {
+                    try {
+                        optsWithKill.onChildSpawned(child, optsWithKill);
+                    }
+                    catch (e) {
+                        // suppress
+                    }
+                }
+            }
             const stdoutFn = typeof opts.stdout === "function" ? opts.stdout : noop;
             const stderrFn = typeof opts.stderr === "function" ? opts.stderr : noop;
             const stdoutLineBuffer = new LineBuffer(s => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zarro",
-  "version": "1.185.0",
+  "version": "1.186.0",
   "description": "Some glue to make gulp easier, perhaps even zero- or close-to-zero-conf",
   "bin": {
     "zarro": "index.js"

package/types.d.ts

@@ -5,7 +5,7 @@ import { StatsBase } from "fs";
 import { Stream, Transform } from "stream";
 import ansiColors, { StyleFunction } from "ansi-colors";
 import { RimrafOptions } from "./gulp-tasks/modules/rimraf";
-import { ExecFileOptionsWithBufferEncoding } from "child_process";
+import { ChildProcess, ExecFileOptionsWithBufferEncoding } from "child_process";
 import * as vinyl from "vinyl";
 import { BufferFile } from "vinyl";
 // noinspection ES6PreferShortImport
@@ -1095,6 +1095,7 @@ declare global {
      * io writer or the result from after spawn completes
      */
     suppressOutput?: boolean;
+
   }
 
   interface SystemOptions {
@@ -1134,6 +1135,17 @@ declare global {
      * / error as the first argument, with the exe set to either cmd or sh
      */
     keepTempFiles?: boolean;
+
+    // gain direct access to the child process as
+    // soon as it spawns
+    onChildSpawned?: (child: ChildProcess, originalOptions: SystemOptionsWithKill) => void;
+
+  }
+
+  interface SystemOptionsWithKill extends SystemOptions {
+    // this function will be filled in for you once the
+    // child process has started
+    kill: (signal?: NodeJS.Signals | number) => void;
   }
 
   /**