feat: support signal opt

closes google#768
relates google#734

Author: antongolub

package-lock.json

@@ -80,7 +80,7 @@
     "typescript": "^5.4.4",
     "which": "^4.0.0",
     "yaml": "^2.4.1",
-    "zurk": "^0.0.32"
+    "zurk": "^0.1.0"
   },
   "publishConfig": {
     "registry": "https://wombat-dressing-room.appspot.com"

package.json

@@ -57,6 +57,7 @@ export interface Options {
   [syncExec]: boolean
   cwd?: string
   ac?: AbortController
+  signal?: AbortSignal
   input?: string | Buffer | Readable | ProcessOutput | ProcessPromise
   verbose: boolean
   sync: boolean
@@ -247,6 +248,7 @@ export class ProcessPromise extends Promise<ProcessOutput> {
       cmd: $.prefix + this._command + $.postfix,
       cwd: $.cwd ?? $[processCwd],
       ac: $.ac,
+      signal: $.signal,
       shell: typeof $.shell === 'string' ? $.shell : true,
       env: $.env,
       spawn: $.spawn,

src/core.ts

@@ -342,6 +342,20 @@ describe('core', () => {
     }
   })
 
+  test('accepts AbortController `signal` separately', async () => {
+    const ac = new AbortController()
+    const signal = ac.signal
+    const p = $({ signal })`sleep 9999`
+    setTimeout(() => ac.abort(), 100)
+
+    try {
+      await p
+      assert.unreachable('should have thrown')
+    } catch ({ message }) {
+      assert.match(message, /The operation was aborted/)
+    }
+  })
+
   test('kill() method works', async () => {
     let p = $`sleep 9999`.nothrow()
     setTimeout(() => {