Support package exports

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

@@ -954,7 +954,7 @@ Remaining test suites: {suites}`,
       websiteTitle: "Imported file doesn't exist",
       websiteDescription: `An imported file doesn't exist.`,
     },
-    IMPORTED_FILE_WITH_ICORRECT_CASING: {
+    IMPORTED_FILE_WITH_INCORRECT_CASING: {
       number: 1203,
       messageTemplate:
         'The import "{importPath} from "{from}" exists, but its casing is incorrect. The correct casing is "{correctCasing}".',
@@ -1195,6 +1195,12 @@ Please check Hardhat's output for more details.`,
       websiteTitle: "Invalid solcjs compiler",
       websiteDescription: `Hardhat successfully downloaded a WASM version of solc {version} but it is invalid. The compile function is missing.`,
     },
+    RESOLVE_NOT_EXPORTED_NPM_FILE: {
+      number: 1232,
+      messageTemplate: `You are tying to resolve the npm file "{module}", but it's not exported by its package`,
+      websiteTitle: "Resolution of not-exported npm file",
+      websiteDescription: `You are tying to resolve an npm file that is not exported by its package.`,
+    },
   },
   VIEM: {
     NETWORK_NOT_FOUND: {

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

@@ -1,3 +1,5 @@
+import fs from "node:fs";
+import { createRequire } from "node:module";
 import path from "node:path";
 
 import { ensureError } from "./error.js";
@@ -7,6 +9,7 @@ import {
 } from "./errors/package.js";
 import { findUp, readJsonFile } from "./fs.js";
 import { getFilePath } from "./internal/package.js";
+import { ensureTrailingSlash } from "./string.js";
 
 /**
  * The structure of a `package.json` file. This is a subset of the actual
@@ -102,6 +105,34 @@ export async function findClosestPackageRoot(
   return path.dirname(packageJsonPath);
 }
 
+/**
+ * Finds the package json for a given package
+ * @param from the absolute path from where to start the search
+ * @param packageName the name of the package to find
+ * @returns the absolute real path (resolved symlinks) of the package.json
+ */
+export async function findPackageJson(
+  from: string,
+  packageName: string,
+): Promise<string | undefined> {
+  const require = createRequire(ensureTrailingSlash(from));
+
+  const lookupPaths = require.resolve.paths(packageName) ?? [];
+
+  const pathToTest = [...packageName.split("/"), "package.json"];
+
+  for (const lookupPath of lookupPaths) {
+    const packageJsonPath = path.join(lookupPath, ...pathToTest);
+
+    try {
+      await fs.promises.access(packageJsonPath, fs.constants.R_OK);
+      return await fs.promises.realpath(packageJsonPath);
+    } catch (error) {
+      continue;
+    }
+  }
+}
+
 export {
   PackageJsonNotFoundError,
   PackageJsonReadError,

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

@@ -60,3 +60,10 @@ export function camelToSnakeCase(str: string): string {
 export function camelToKebabCase(str: string): string {
   return str.replace(/[A-Z0-9]/g, (match) => `-${match.toLowerCase()}`);
 }
+
+/**
+ * Ensures a string ends with a slash.
+ */
+export function ensureTrailingSlash(path: string): string {
+  return path.endsWith("/") ? path : path + "/";
+}

v-next/hardhat/package.json

@@ -32,7 +32,8 @@
     "./types/tasks": "./dist/src/types/tasks.js",
     "./types/user-interruptions": "./dist/src/types/user-interruptions.js",
     "./types/utils": "./dist/src/types/utils.js",
-    "./types/solidity": "./dist/src/types/solidity.js"
+    "./types/solidity": "./dist/src/types/solidity.js",
+    "./console.sol": "./console.sol"
   },
   "keywords": [
     "ethereum",
@@ -97,6 +98,7 @@
     "ethereum-cryptography": "^2.2.1",
     "micro-eth-signer": "^0.13.0",
     "p-map": "^7.0.2",
+    "resolve.exports": "^2.0.3",
     "semver": "^7.6.3",
     "tsx": "^4.11.0",
     "ws": "^8.18.0",

v-next/hardhat/src/internal/builtin-plugins/solidity/build-system/debug-utils.ts

@@ -16,7 +16,7 @@ export function printDependencyGraphAndRemappingsSummary(
   const rootRepresentations: string[] = [];
 
   for (const [rootFile, resolvedFile] of roots.entries()) {
-    if (resolvedFile.type === ResolvedFileType.NPM_PACKGE_FILE) {
+    if (resolvedFile.type === ResolvedFileType.NPM_PACKAGE_FILE) {
       rootRepresentations.push(`- ${rootFile} -> ${resolvedFile.sourceName}
       ${resolvedFile.fsPath}`);
     } else {