PackageJson: Add devEngines type (#1286)

Author: danielbayley

source/package-json.d.ts

@@ -208,6 +208,15 @@ export namespace PackageJson {
 	*/
 	type Dependency = Partial<Record<string, string>>;
 
+	/**
+	Specifies requirements for development environment components such as operating systems, runtimes, or package managers. Used to ensure consistent development environments across the team.
+	*/
+	type DevEngineDependency = {
+		name: string;
+		version?: string;
+		onFail?: 'ignore' | 'warn' | 'error' | 'download';
+	};
+
 	/**
 	A mapping of conditions and the paths to which they resolve.
 	*/
@@ -563,6 +572,17 @@ export namespace PackageJson {
 			string
 		>>;
 
+		/**
+		Define the runtime and package manager for developing the current project.
+		*/
+		devEngines?: {
+			os?: DevEngineDependency | DevEngineDependency[];
+			cpu?: DevEngineDependency | DevEngineDependency[];
+			libc?: DevEngineDependency | DevEngineDependency[];
+			runtime?: DevEngineDependency | DevEngineDependency[];
+			packageManager?: DevEngineDependency | DevEngineDependency[];
+		};
+
 		/**
 		If set to `true`, a warning will be shown if package is installed locally. Useful if the package is primarily a command-line application that should be installed globally.
 

test-d/package-json.ts

@@ -37,6 +37,11 @@ expectType<string[] | undefined>(packageJson.bundleDependencies);
 expectType<string[] | undefined>(packageJson.bundledDependencies);
 expectType<PackageJson.Dependency | undefined>(packageJson.resolutions);
 expectType<PackageJson.WorkspaceConfig | string[] | undefined>(packageJson.workspaces);
+expectAssignable<PackageJson.DevEngineDependency>({
+	name: 'unicorn',
+	version: '>= 1.0.0',
+	onFail: 'ignore',
+});
 expectType<Partial<Record<string, string>> | undefined>(packageJson.engines);
 expectType<boolean | undefined>(packageJson.engineStrict);
 expectAssignable<