From 3d4f5f051e14cabf44be01f5048d05b1b0133788 Mon Sep 17 00:00:00 2001
From: agape1225 <49804691+agape1225@users.noreply.github.com>
Date: Sat, 12 Sep 2026 14:49:38 +0900
Subject: [PATCH] typings: wire up spawn_sync internal binding types

Signed-off-by: agape1225 <49804691+agape1225@users.noreply.github.com>
---
 typings/globals.d.ts                    |  2 ++
 typings/internalBinding/spawn_sync.d.ts | 33 +++++++++++++++++++++++++
 2 files changed, 35 insertions(+)
 create mode 100644 typings/internalBinding/spawn_sync.d.ts

diff --git a/typings/globals.d.ts b/typings/globals.d.ts
index 7363e7088ee9..03d0a5ba08f6 100644
--- a/typings/globals.d.ts
+++ b/typings/globals.d.ts
@@ -33,6 +33,7 @@ import { ProfilerBinding } from './internalBinding/profiler';
 import { SeaBinding } from './internalBinding/sea';
 import { SerdesBinding } from './internalBinding/serdes';
 import { SignalWrapBinding } from './internalBinding/signal_wrap';
+import { SpawnSyncBinding } from './internalBinding/spawn_sync';
 import { StreamPipeBinding } from './internalBinding/stream_pipe';
 import { StringDecoderBinding } from './internalBinding/string_decoder';
 import { SymbolsBinding } from './internalBinding/symbols';
@@ -84,6 +85,7 @@ interface InternalBindingMap {
   sea: SeaBinding;
   serdes: SerdesBinding;
   signal_wrap: SignalWrapBinding;
+  spawn_sync: SpawnSyncBinding;
   stream_pipe: StreamPipeBinding;
   string_decoder: StringDecoderBinding;
   symbols: SymbolsBinding;
diff --git a/typings/internalBinding/spawn_sync.d.ts b/typings/internalBinding/spawn_sync.d.ts
new file mode 100644
index 000000000000..84438510aa75
--- /dev/null
+++ b/typings/internalBinding/spawn_sync.d.ts
@@ -0,0 +1,33 @@
+type SpawnSyncStdio =
+  | { type: 'ignore' }
+  | { type: 'pipe'; readable: boolean; writable: boolean; input?: Uint8Array }
+  | { type: 'inherit'; fd: number }
+  | { type: 'fd'; fd: number };
+
+export interface SpawnSyncOptions {
+  file: string;
+  args: readonly string[];
+  cwd?: string | null;
+  envPairs?: readonly string[] | null;
+  uid?: number;
+  gid?: number;
+  detached?: boolean;
+  windowsHide?: boolean;
+  windowsVerbatimArguments?: boolean;
+  timeout?: number;
+  maxBuffer?: number;
+  killSignal?: number;
+  stdio: readonly SpawnSyncStdio[];
+}
+
+export interface SpawnSyncResult {
+  error?: number;
+  status: number | null;
+  signal: string | null;
+  output: (Uint8Array | null)[] | null;
+  pid: number;
+}
+
+export interface SpawnSyncBinding {
+  spawn(options: SpawnSyncOptions): SpawnSyncResult;
+}