Merge pull request #5774 from NomicFoundation/galargh/hardhat-init

feat: implement alpha of hardhat --init for v3

Author: galargh

.github/workflows/v-next-ci.yml

@@ -56,7 +56,8 @@ jobs:
             [
               ".",
               "packages/",
-              "v-next/example-project"
+              "v-next/example-project",
+              "v-next/hardhat/templates/"
             ]
           COMMON_FILTERS: |
             [

pnpm-lock.yaml

@@ -1,3 +1,4 @@
 packages:
   - "packages/*"
   - "v-next/*"
+  - "v-next/hardhat/templates/*"

pnpm-workspace.yaml

@@ -155,22 +155,8 @@ Please double check whether you have multiple versions of the same plugin instal
       websiteTitle: "Hardhat project already created",
       websiteDescription: `Cannot create a new Hardhat project, the current folder is already associated with a project.`,
     },
-    NOT_INSIDE_PROJECT_ON_WINDOWS: {
-      number: 11,
-      messageTemplate: `You are not inside a project and Hardhat failed to initialize a new one.
-
-If you were trying to create a new project, please try again using Windows Subsystem for Linux (WSL) or PowerShell.
-`,
-      websiteTitle:
-        "You are not inside a Hardhat project and Hardhat failed to initialize a new one",
-      websiteDescription: `You are trying to run Hardhat outside of a Hardhat project, and we couldn't initialize one.
-
-If you were trying to create a new project, please try again using Windows Subsystem for Linux (WSL) or PowerShell.
-
-You can learn how to use Hardhat by reading the [Getting Started guide](/hardhat-runner/docs/getting-started).`,
-    },
     NOT_IN_INTERACTIVE_SHELL: {
-      number: 12,
+      number: 11,
       messageTemplate:
         "You are trying to initialize a project but you are not in an interactive shell.",
       websiteTitle: "Not inside an interactive shell",
@@ -179,7 +165,7 @@ You can learn how to use Hardhat by reading the [Getting Started guide](/hardhat
 Please re-run the command inside an interactive shell.`,
     },
     UNSUPPORTED_OPERATION: {
-      number: 13,
+      number: 12,
       messageTemplate: "{operation} is not supported in Hardhat.",
       websiteTitle: "Unsupported operation",
       websiteDescription: `You are trying to perform an unsupported operation.
@@ -189,7 +175,7 @@ Unless you are creating a task or plugin, this is probably a bug.
 Please [report it](https://github.com/nomiclabs/hardhat/issues/new) to help us improve Hardhat.`,
     },
     ONLY_ESM_SUPPORTED: {
-      number: 14,
+      number: 13,
       messageTemplate: `Hardhat only supports ESM projects. Please be sure to specify "'type': 'module'" in your package.json`,
       websiteTitle: "Only ESM projects are supported",
       websiteDescription: `You are trying to initialize a new Hardhat project, but your package.json does not have the property "type" set to "module".
@@ -199,20 +185,32 @@ Currently, Hardhat only supports ESM projects.
 Please add the property "type" with the value "module" in your package.json to ensure that your project is recognized as an ESM project.`,
     },
     GLOBAL_OPTION_ALREADY_DEFINED: {
-      number: 15,
+      number: 14,
       messageTemplate:
         "Plugin {plugin} is trying to define the global option {globalOption} but it is already defined by plugin {definedByPlugin}",
       websiteTitle: "Global option already defined",
       websiteDescription:
         "The global option is already defined by another plugin. Please ensure that global options are uniquely named to avoid conflicts.",
     },
     INVALID_CONFIG: {
-      number: 16,
+      number: 15,
       messageTemplate: `Invalid config:
 {errors}`,
       websiteTitle: "Invalid config",
       websiteDescription: `The configuration you provided is invalid. Please check the documentation to learn how to configure Hardhat correctly.`,
     },
+    TEMPLATE_NOT_FOUND: {
+      number: 16,
+      messageTemplate: `Template {template} not found`,
+      websiteTitle: "Template not found",
+      websiteDescription: `The template you provided is not found. Please check the documentation to learn which templates are available.`,
+    },
+    WORKSPACE_NOT_FOUND: {
+      number: 17,
+      messageTemplate: `Workspace {workspace} not found`,
+      websiteTitle: "Workspace not found",
+      websiteDescription: `The workspace you provided does not exist. Please ensure that the workspace exists and try again.`,
+    },
   },
   INTERNAL: {
     ASSERTION_ERROR: {

v-next/hardhat-errors/src/descriptors.ts

@@ -15,6 +15,7 @@ import { getFilePath } from "./internal/package.js";
 export interface PackageJson {
   name: string;
   version: string;
+  description?: string;
   type?: "commonjs" | "module";
   engines?: {
     node: string;

v-next/hardhat-utils/src/package.ts

@@ -53,6 +53,7 @@
   "files": [
     "dist/src/",
     "src/",
+    "templates/",
     "CHANGELOG.md",
     "LICENSE",
     "README.md"

v-next/hardhat/package.json

@@ -1,2 +1 @@
 export const HARDHAT_NAME = "Hardhat";
-export const HARDHAT_PACKAGE_NAME = "hardhat";