Merge branch 'v-next' into remove-defaultNetwork

Author: kanej

.changeset/loud-buses-wave.md

@@ -0,0 +1,5 @@
+---
+"hardhat": patch
+---
+
+Allowed requesting help via the -h flag

scripts/check-release.mjs

@@ -5,7 +5,7 @@ import { appendFile } from "node:fs/promises";
 import { readPackage, isPackageReleasedToNpm } from "./lib/packages.mjs";
 
 /**
- * The function checks whether the version of hardhat from its' package.json is available in the NPM registry
+ * The function checks whether the version of hardhat from its package.json is available in the NPM registry
  * It appends this information to the GITHUB_OUTPUT file (this is an env variable available in the GitHub Actions environment)
  */
 async function checkRelease() {

v-next/hardhat-node-test-reporter/src/error-formatting.ts

@@ -368,7 +368,7 @@ export function formatLocation(
 /**
  * Returns true if the stack line is a node line.
  *
- * A node line is a line that has a node stack reference, i.e. its' location
+ * A node line is a line that has a node stack reference, i.e. its location
  * starts with "node:" or "async node:", or its context is for a node type.
  */
 function isNodeLine({ reference }: StackLine): boolean {

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

@@ -23,6 +23,7 @@ export const BUILTIN_GLOBAL_OPTIONS_DEFINITIONS: GlobalOptionDefinitions =
         pluginId: "builtin",
         option: globalFlag({
           name: "help",
+          shortName: "h",
           description:
             "Shows this message, or a task's help if its name is provided.",
         }),

v-next/hardhat/src/internal/builtin-plugins/solidity/type-extensions.ts

@@ -119,6 +119,7 @@ declare module "../../../types/hooks.js" {
      *
      * @param context The hook context.
      * @param inputSourceName The input source name of the project file.
+     * @param fsPath The absolute path to the project file.
      * @param fileContent The content of the project file.
      * @param solcVersion The solc version that will be used to compile the project file.
      * @param next A function to call the next handler for this hook, or the

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

@@ -248,6 +248,7 @@ export async function parseBuiltinGlobalOptions(
   let version: boolean = false;
   let init: boolean = false;
 
+  // TODO: Use parseGlobalOptions(BUILTIN_GLOBAL_OPTIONS_DEFINITIONS, ...) instead
   for (let i = 0; i < cliArguments.length; i++) {
     const arg = cliArguments[i];
 
@@ -291,7 +292,7 @@ export async function parseBuiltinGlobalOptions(
       continue;
     }
 
-    if (arg === "--help") {
+    if (arg === "--help" || arg === "-h") {
       usedCliArguments[i] = true;
       help = true;
       continue;

v-next/hardhat/src/types/config.ts

@@ -80,14 +80,14 @@ export interface ProjectPathsUserConfig {
 }
 
 /**
- * The different paths were the Hardhat project's tests are located.
+ * The different paths where the Hardhat project's tests are located.
  */
 /* eslint-disable-next-line @typescript-eslint/no-empty-interface -- This is
 intended to be used through module augmentation. */
 export interface TestPathsUserConfig {}
 
 /**
- * The different paths were the Hardhat project's sources are located.
+ * The different paths where the Hardhat project's sources are located.
  */
 /* eslint-disable-next-line @typescript-eslint/no-empty-interface -- This is
 intended to be used through module augmentation. */
@@ -122,14 +122,14 @@ export interface ProjectPathsConfig {
 }
 
 /**
- * The resolved paths were the Hardhat project's tests are located.
+ * The resolved paths where the Hardhat project's tests are located.
  */
 /* eslint-disable-next-line @typescript-eslint/no-empty-interface -- This is
 intended to be used through module augmentation. */
 export interface TestPathsConfig {}
 
 /**
- * The resolved paths were the Hardhat project's sources are located.
+ * The resolved paths where the Hardhat project's sources are located.
  */
 /* eslint-disable-next-line @typescript-eslint/no-empty-interface -- This is
 intended to be used through module augmentation. */

v-next/hardhat/src/types/user-interruptions.ts

@@ -9,7 +9,7 @@
 export interface UserInterruptionManager {
   /**
    * Displays a message to the user, returning a `Promise` that resolve when the
-   * message was displayed and we have a good digree of certainty that the user
+   * message was displayed and we have a good degree of certainty that the user
    * has read it.
    *
    * For example, if the plugin/task handling the user output doesn't refresh the screen,
@@ -36,8 +36,8 @@ export interface UserInterruptionManager {
    * Request a secret input from the user, returning a `Promise` that resolves with
    * the user's input.
    *
-   * The main difference between this method and `requestInput` is that this method
-   * is that the plugin/task handling the user input/output should take extra care
+   * The main difference between this method and `requestInput` is that with this
+   * method the plugin/task handling the user input/output should take extra care
    * to avoid leaking the user's input or displaying it in the user's terminal.
    *
    * @param interruptor - A name or description of the module calling this method.

v-next/hardhat/test/internal/builtin-plugins/solidity/build-system/dependency-graph.ts

@@ -359,7 +359,7 @@ describe("DependencyGraphImplementation", () => {
   });
 
   describe("getFileBySourceName", () => {
-    it("should return the file by its' input source name if the file was previously added", () => {
+    it("should return the file by its input source name if the file was previously added", () => {
       const root = createProjectResolvedFile("root.sol");
       const dependency = createProjectResolvedFile("dependency.sol");
 

v-next/hardhat/test/internal/cli/help/get-global-help-string.ts

@@ -195,7 +195,7 @@ Usage: hardhat [GLOBAL OPTIONS] <TASK> [SUBTASK] [TASK OPTIONS] [--] [TASK ARGUM
 GLOBAL OPTIONS:
 
   --config                 A Hardhat config file.
-  --help                   Shows this message, or a task's help if its name is provided.
+  --help, -h               Shows this message, or a task's help if its name is provided.
   --init                   Initializes a Hardhat project.
   --show-stack-traces      Show stack traces (always enabled on CI servers).
   --user-option-1          userOption1 description.
@@ -294,7 +294,7 @@ AVAILABLE SUBTASKS:
 GLOBAL OPTIONS:
 
   --config                 A Hardhat config file.
-  --help                   Shows this message, or a task's help if its name is provided.
+  --help, -h               Shows this message, or a task's help if its name is provided.
   --init                   Initializes a Hardhat project.
   --show-stack-traces      Show stack traces (always enabled on CI servers).
   --user-option-1          userOption1 description.