Include the builtin options as part of the global options & augment types

Author: schaable

v-next/example-project/hardhat.config.ts

@@ -1,3 +1,5 @@
+import type { GlobalOptions } from "@ignored/hardhat-vnext/types/global-options";
+
 import { HardhatPluginError } from "@ignored/hardhat-vnext/plugins";
 
 import {
@@ -126,6 +128,15 @@ const pluginExample = {
   ],
 };
 
+// Type includes the builtin global options
+const _globalOptions: GlobalOptions = {
+  configPath: "",
+  help: false,
+  init: false,
+  showStackTraces: false,
+  version: false,
+};
+
 const config: HardhatUserConfig = {
   tasks: [
     exampleTaskOverride,

v-next/hardhat/src/internal/builtin-global-options.ts

@@ -0,0 +1,56 @@
+import type { GlobalOptionDefinitions } from "../types/global-options.js";
+
+import { globalOption, ArgumentType } from "../config.js";
+
+export const BUILTIN_GLOBAL_OPTIONS_DEFINITIONS: GlobalOptionDefinitions =
+  new Map([
+    [
+      "config",
+      {
+        pluginId: "hardhat",
+        option: globalOption({
+          name: "config",
+          description: "A Hardhat config file.",
+          type: ArgumentType.STRING,
+          defaultValue: "",
+        }),
+      },
+    ],
+    [
+      "help",
+      {
+        pluginId: "hardhat",
+        option: globalOption({
+          name: "help",
+          description:
+            "Shows this message, or a task's help if its name is provided.",
+          type: ArgumentType.BOOLEAN,
+          defaultValue: false,
+        }),
+      },
+    ],
+    [
+      "showStackTraces",
+      {
+        pluginId: "hardhat",
+        option: globalOption({
+          name: "showStackTraces",
+          description: "Show stack traces (always enabled on CI servers).",
+          type: ArgumentType.BOOLEAN,
+          defaultValue: false,
+        }),
+      },
+    ],
+    [
+      "version",
+      {
+        pluginId: "hardhat",
+        option: globalOption({
+          name: "version",
+          description: "Shows hardhat's version.",
+          type: ArgumentType.BOOLEAN,
+          defaultValue: false,
+        }),
+      },
+    ],
+  ]);

v-next/hardhat/src/internal/builtin-options.ts

@@ -2,8 +2,6 @@ import type { ArgumentType } from "@ignored/hardhat-vnext-core/config";
 import type { GlobalOptionDefinitions } from "@ignored/hardhat-vnext-core/types/global-options";
 import type { Task } from "@ignored/hardhat-vnext-core/types/tasks";
 
-import { BUILTIN_OPTIONS } from "../../builtin-options.js";
-
 export const GLOBAL_NAME_PADDING = 6;
 
 interface ArgumentDescriptor {
@@ -16,23 +14,10 @@ interface ArgumentDescriptor {
 export function parseGlobalOptions(
   globalOptionDefinitions: GlobalOptionDefinitions,
 ): ArgumentDescriptor[] {
-  const formattedBuiltinOptions = BUILTIN_OPTIONS.map(
-    ({ name, description }) => ({
-      name: formatOptionName(name),
-      description,
-    }),
-  );
-
-  const formattedUserOptions = Array.from(globalOptionDefinitions).map(
-    ([, entry]) => {
-      return {
-        name: formatOptionName(entry.option.name),
-        description: entry.option.description,
-      };
-    },
-  );
-
-  return [...formattedBuiltinOptions, ...formattedUserOptions];
+  return [...globalOptionDefinitions].map(([, { option }]) => ({
+    name: formatOptionName(option.name),
+    description: option.description,
+  }));
 }
 
 export function parseTasks(taskMap: Map<string, Task>): {

v-next/hardhat/src/internal/cli/helpers/utils.ts

@@ -28,6 +28,7 @@ import { kebabToCamelCase } from "@ignored/hardhat-vnext-utils/string";
 
 import { resolveHardhatConfigPath } from "../../config.js";
 import { createHardhatRuntimeEnvironment } from "../../hre.js";
+import { BUILTIN_GLOBAL_OPTIONS_DEFINITIONS } from "../builtin-global-options.js";
 import { builtinPlugins } from "../builtin-plugins/index.js";
 import { setGlobalHardhatRuntimeEnvironment } from "../global-hre-instance.js";
 import { importUserConfig } from "../helpers/config-loading.js";
@@ -77,8 +78,12 @@ export async function main(
       builtinGlobalOptions.configPath,
     );
 
-    const globalOptionDefinitions =
+    const pluginGlobalOptionDefinitions =
       buildGlobalOptionDefinitions(resolvedPlugins);
+    const globalOptionDefinitions = new Map([
+      ...BUILTIN_GLOBAL_OPTIONS_DEFINITIONS,
+      ...pluginGlobalOptionDefinitions,
+    ]);
     const userProvidedGlobalOptions = await parseGlobalOptions(
       globalOptionDefinitions,
       cliArguments,
@@ -87,7 +92,7 @@ export async function main(
 
     const hre = await createHardhatRuntimeEnvironment(
       userConfig,
-      userProvidedGlobalOptions,
+      { ...builtinGlobalOptions, ...userProvidedGlobalOptions },
       { resolvedPlugins, globalOptionDefinitions },
     );
 

v-next/hardhat/src/internal/cli/main.ts

@@ -1,2 +1,14 @@
+import "@ignored/hardhat-vnext-core/types/global-options";
+
+declare module "@ignored/hardhat-vnext-core/types/global-options" {
+  export interface GlobalOptions {
+    configPath: string;
+    help: boolean;
+    init: boolean;
+    showStackTraces: boolean;
+    version: boolean;
+  }
+}
+
 export type * from "@ignored/hardhat-vnext-core/types/global-options";
 export * from "@ignored/hardhat-vnext-core/types/global-options";