hardhat-external-artifacts 0.0.1 → 0.0.3

package/README.md

@@ -16,14 +16,15 @@ yarn add hardhat-external-artifacts
 
 ## Usage
 
-Import the plugin in your Hardhat configuration file:
+Import the plugin and add it to the `plugins` array in your Hardhat configuration file:
 
 ```typescript
 // hardhat.config.ts
 import type {HardhatUserConfig} from 'hardhat/config';
-import 'hardhat-external-artifacts';
+import HardhatExternalArtifactsPlugin from 'hardhat-external-artifacts';
 
 const config: HardhatUserConfig = {
+	plugins: [HardhatExternalArtifactsPlugin],
 	solidity: '0.8.20',
 	externalArtifacts: {
 		// Load specific artifact files
@@ -41,6 +42,44 @@ const config: HardhatUserConfig = {
 export default config;
 ```
 
+### Loading from npm Packages
+
+You can load artifacts directly from npm packages using the `modules` option. This uses Node.js module resolution, supporting both package exports and direct paths:
+
+```typescript
+// hardhat.config.ts
+import type {HardhatUserConfig} from 'hardhat/config';
+import HardhatExternalArtifactsPlugin from 'hardhat-external-artifacts';
+
+const config: HardhatUserConfig = {
+	plugins: [HardhatExternalArtifactsPlugin],
+	solidity: '0.8.20',
+	externalArtifacts: {
+		// Load from npm packages via module resolution
+		modules: [
+			'@my-org/contracts/artifacts',     // Uses package.json "exports"
+			'some-package/dist/artifacts',     // Direct path in package
+		],
+	},
+};
+
+export default config;
+```
+
+**Note:** The `modules` option differs from `paths` in that it resolves module specifiers from `node_modules` using Node.js resolution, respecting the package's `exports` field. This is useful when a package explicitly exports its artifacts folder.
+
+For example, if a package has:
+```json
+{
+  "name": "@my-org/contracts",
+  "exports": {
+    "./artifacts": "./dist/artifacts"
+  }
+}
+```
+
+Then using `modules: ['@my-org/contracts/artifacts']` will correctly resolve to the exported path.
+
 ### Using a Resolver Function
 
 For more dynamic artifact loading, you can use a resolver function:
@@ -48,9 +87,10 @@ For more dynamic artifact loading, you can use a resolver function:
 ```typescript
 // hardhat.config.ts
 import type {HardhatUserConfig} from 'hardhat/config';
-import 'hardhat-external-artifacts';
+import HardhatExternalArtifactsPlugin from 'hardhat-external-artifacts';
 
 const config: HardhatUserConfig = {
+	plugins: [HardhatExternalArtifactsPlugin],
 	solidity: '0.8.20',
 	externalArtifacts: {
 		resolver: async () => {
@@ -81,10 +121,11 @@ You can use both paths and resolver together:
 ```typescript
 // hardhat.config.ts
 import type {HardhatUserConfig} from 'hardhat/config';
-import 'hardhat-external-artifacts';
+import HardhatExternalArtifactsPlugin from 'hardhat-external-artifacts';
 import {loadDefiProtocolArtifacts} from './scripts/load-defi';
 
 const config: HardhatUserConfig = {
+	plugins: [HardhatExternalArtifactsPlugin],
 	solidity: '0.8.20',
 	externalArtifacts: {
 		// Load from local directory
@@ -106,13 +147,14 @@ export default config;
 
 ## Configuration Options
 
-| Option                   | Type                                | Default     | Description                                     |
-| ------------------------ | ----------------------------------- | ----------- | ----------------------------------------------- |
-| `paths`                  | `string[]`                          | `[]`        | Paths to artifact files or directories          |
-| `resolver`               | `() => Promise<ExternalArtifact[]>` | `undefined` | Function that returns artifacts dynamically     |
-| `solcVersion`            | `string`                            | `"0.8.20"`  | Solc version for synthetic compilations         |
-| `warnOnInvalidArtifacts` | `boolean`                           | `true`      | Whether to log warnings for malformed artifacts |
-| `debug`                  | `boolean`                           | `false`     | Enable debug logging for troubleshooting        |
+| Option                   | Type                                | Default     | Description                                              |
+| ------------------------ | ----------------------------------- | ----------- | -------------------------------------------------------- |
+| `paths`                  | `string[]`                          | `[]`        | Paths to artifact files or directories (relative/absolute) |
+| `modules`                | `string[]`                          | `[]`        | Module specifiers to resolve from node_modules           |
+| `resolver`               | `() => Promise<ExternalArtifact[]>` | `undefined` | Function that returns artifacts dynamically              |
+| `solcVersion`            | `string`                            | `"0.8.20"`  | Solc version for synthetic compilations                  |
+| `warnOnInvalidArtifacts` | `boolean`                           | `true`      | Whether to log warnings for malformed artifacts          |
+| `debug`                  | `boolean`                           | `false`     | Enable debug logging for troubleshooting                 |
 
 ## Artifact Format
 

package/dist/artifacts/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/artifacts/loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,gBAAgB,EAEhB,uBAAuB,EACvB,MAAM,YAAY,CAAC;AAQpB,qBAAa,cAAc;;gBAId,MAAM,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM;IAK1D,OAAO,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;CA8H5C"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/artifacts/loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,gBAAgB,EAEhB,uBAAuB,EACvB,MAAM,YAAY,CAAC;AAuBpB,qBAAa,cAAc;;gBAId,MAAM,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM;IAK1D,OAAO,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;CA0Z5C"}

package/dist/artifacts/loader.js

@@ -1,6 +1,8 @@
 import { readJsonFile, getAllFilesMatching, } from '@nomicfoundation/hardhat-utils/fs';
 import path from 'node:path';
 import fs from 'node:fs/promises';
+import { createRequire } from 'node:module';
+import { fileURLToPath } from 'node:url';
 export class ArtifactLoader {
     #config;
     #projectRoot;
@@ -10,13 +12,22 @@ export class ArtifactLoader {
     }
     async loadAll() {
         const artifacts = [];
-        // Load from paths
+        // Load from paths (relative/absolute filesystem paths)
         if (this.#config.paths) {
             for (const pathOrGlob of this.#config.paths) {
                 const absolutePath = path.resolve(this.#projectRoot, pathOrGlob);
                 artifacts.push(...(await this.#loadFromPath(absolutePath)));
             }
         }
+        // Load from modules (node_modules resolution)
+        if (this.#config.modules) {
+            for (const moduleSpecifier of this.#config.modules) {
+                const resolvedPath = await this.#resolveModulePath(moduleSpecifier);
+                if (resolvedPath) {
+                    artifacts.push(...(await this.#loadFromPath(resolvedPath)));
+                }
+            }
+        }
         // Load from resolver function
         if (this.#config.resolver) {
             const resolvedArtifacts = await this.#config.resolver();
@@ -24,6 +35,239 @@ export class ArtifactLoader {
         }
         return artifacts;
     }
+    /**
+     * Resolves a module specifier to an absolute filesystem path.
+     * Supports package.json "exports" field patterns like "./artifacts/*".
+     *
+     * @param moduleSpecifier - e.g., "@my-org/contracts/artifacts"
+     * @returns The resolved absolute path, or undefined if resolution fails
+     */
+    async #resolveModulePath(moduleSpecifier) {
+        // Parse the module specifier into package name and subpath
+        const { pkgName, subpath } = this.#parseModuleSpecifier(moduleSpecifier);
+        try {
+            // Find the package directory by locating its package.json
+            const { pkgDir, pkgJson } = await this.#findPackage(pkgName);
+            if (subpath && pkgJson.exports) {
+                // Try to resolve the subpath using the exports field
+                const resolvedSubpath = this.#resolveExportsSubpath(pkgJson.exports, `./${subpath}`);
+                if (resolvedSubpath) {
+                    const targetPath = path.join(pkgDir, resolvedSubpath);
+                    const stat = await fs.stat(targetPath).catch(() => null);
+                    if (stat) {
+                        return targetPath;
+                    }
+                }
+            }
+            // Fallback: try direct path (for packages without exports or simple cases)
+            if (subpath) {
+                const targetPath = path.join(pkgDir, subpath);
+                const stat = await fs.stat(targetPath).catch(() => null);
+                if (stat) {
+                    return targetPath;
+                }
+            }
+            // Try using import.meta.resolve for standard module resolution
+            try {
+                const resolvedUrl = import.meta.resolve(moduleSpecifier, `file://${this.#projectRoot}/`);
+                const resolvedPath = fileURLToPath(resolvedUrl);
+                const stat = await fs.stat(resolvedPath).catch(() => null);
+                if (stat?.isDirectory()) {
+                    return resolvedPath;
+                }
+                if (stat?.isFile()) {
+                    // If it resolved to an index file, return the directory
+                    const basename = path.basename(resolvedPath);
+                    if (basename.startsWith('index.')) {
+                        return path.dirname(resolvedPath);
+                    }
+                    return resolvedPath;
+                }
+            }
+            catch {
+                // import.meta.resolve failed, continue to error handling
+            }
+            if (this.#config.warnOnInvalidArtifacts !== false) {
+                console.warn(`[hardhat-external-artifacts] Could not resolve module path: ${moduleSpecifier}`);
+            }
+            return undefined;
+        }
+        catch (error) {
+            if (this.#config.warnOnInvalidArtifacts !== false) {
+                console.warn(`[hardhat-external-artifacts] Failed to resolve module: ${moduleSpecifier}`, error instanceof Error ? error.message : error);
+            }
+            return undefined;
+        }
+    }
+    /**
+     * Find a package's directory and read its package.json.
+     * Handles packages with strict exports that don't include ./package.json.
+     */
+    async #findPackage(pkgName) {
+        const require = createRequire(path.join(this.#projectRoot, 'package.json'));
+        // Try method 1: Direct package.json resolution (works for most packages)
+        try {
+            const pkgJsonPath = require.resolve(`${pkgName}/package.json`);
+            const pkgDir = path.dirname(pkgJsonPath);
+            const pkgJson = await readJsonFile(pkgJsonPath);
+            return { pkgDir, pkgJson };
+        }
+        catch {
+            // Package has strict exports, try alternative methods
+        }
+        // Try method 2: Resolve main entry and walk up to find package.json
+        try {
+            const mainEntry = require.resolve(pkgName);
+            let dir = path.dirname(mainEntry);
+            // Walk up the directory tree to find package.json
+            while (dir !== path.dirname(dir)) { // Stop at filesystem root
+                const pkgJsonPath = path.join(dir, 'package.json');
+                try {
+                    const pkgJson = await readJsonFile(pkgJsonPath);
+                    // Verify this is the correct package
+                    if (pkgJson.name === pkgName) {
+                        return { pkgDir: dir, pkgJson };
+                    }
+                }
+                catch {
+                    // No package.json here, continue walking up
+                }
+                dir = path.dirname(dir);
+            }
+        }
+        catch {
+            // Main entry resolution failed
+        }
+        // Try method 3: Search node_modules directly
+        const nodeModulesPath = path.join(this.#projectRoot, 'node_modules', ...pkgName.split('/'));
+        const pkgJsonPath = path.join(nodeModulesPath, 'package.json');
+        try {
+            const stat = await fs.stat(pkgJsonPath);
+            if (stat.isFile()) {
+                const pkgJson = await readJsonFile(pkgJsonPath);
+                return { pkgDir: nodeModulesPath, pkgJson };
+            }
+        }
+        catch {
+            // Not found in direct node_modules
+        }
+        throw new Error(`Could not find package: ${pkgName}`);
+    }
+    /**
+     * Parse a module specifier into package name and subpath.
+     * Handles scoped packages (e.g., "@scope/pkg/subpath") and regular packages.
+     */
+    #parseModuleSpecifier(specifier) {
+        const parts = specifier.split('/');
+        const isScoped = specifier.startsWith('@');
+        if (isScoped) {
+            return {
+                pkgName: parts.slice(0, 2).join('/'),
+                subpath: parts.slice(2).join('/'),
+            };
+        }
+        return {
+            pkgName: parts[0],
+            subpath: parts.slice(1).join('/'),
+        };
+    }
+    /**
+     * Resolve a subpath against a package.json exports field.
+     * Handles subpath patterns like "./artifacts/*": "./dist/artifacts/*"
+     *
+     * @param exports - The exports field from package.json
+     * @param subpath - The subpath to resolve (e.g., "./artifacts")
+     * @returns The resolved path relative to the package root, or undefined
+     */
+    #resolveExportsSubpath(exports, subpath) {
+        if (exports === null) {
+            return undefined;
+        }
+        if (typeof exports === 'string') {
+            // Simple string export - only matches if subpath is "."
+            return subpath === '.' ? exports : undefined;
+        }
+        if (typeof exports !== 'object') {
+            return undefined;
+        }
+        // Check for exact match first
+        if (subpath in exports) {
+            return this.#resolveExportTarget(exports[subpath]);
+        }
+        // Check for pattern matches (e.g., "./artifacts/*")
+        for (const [pattern, target] of Object.entries(exports)) {
+            if (pattern.includes('*')) {
+                const resolved = this.#matchExportPattern(pattern, target, subpath);
+                if (resolved) {
+                    return resolved;
+                }
+            }
+        }
+        // Check for directory patterns (e.g., "./artifacts/" matches "./artifacts/anything")
+        for (const [pattern, target] of Object.entries(exports)) {
+            if (pattern.endsWith('/') && subpath.startsWith(pattern)) {
+                const suffix = subpath.slice(pattern.length);
+                const resolvedTarget = this.#resolveExportTarget(target);
+                if (resolvedTarget) {
+                    return resolvedTarget.endsWith('/')
+                        ? resolvedTarget + suffix
+                        : resolvedTarget + '/' + suffix;
+                }
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Match a subpath against an export pattern with wildcards.
+     * E.g., pattern "./artifacts/*" with target "./dist/*" and subpath "./artifacts"
+     * would return "./dist"
+     */
+    #matchExportPattern(pattern, target, subpath) {
+        // Handle pattern like "./artifacts/*" matching "./artifacts" (the directory itself)
+        const patternBase = pattern.replace('/*', '');
+        if (subpath === patternBase) {
+            // User wants the base directory, not a specific file
+            // Resolve to the target base directory
+            const resolvedTarget = this.#resolveExportTarget(target);
+            if (resolvedTarget) {
+                return resolvedTarget.replace('/*', '').replace(/\*$/, '');
+            }
+        }
+        // Handle pattern matching for files within the directory
+        if (subpath.startsWith(patternBase + '/')) {
+            const wildcardValue = subpath.slice(patternBase.length + 1);
+            const resolvedTarget = this.#resolveExportTarget(target);
+            if (resolvedTarget && resolvedTarget.includes('*')) {
+                return resolvedTarget.replace('*', wildcardValue);
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Resolve an export target, handling conditional exports.
+     */
+    #resolveExportTarget(target) {
+        if (target === null) {
+            return undefined;
+        }
+        if (typeof target === 'string') {
+            return target;
+        }
+        if (typeof target !== 'object') {
+            return undefined;
+        }
+        // Handle conditional exports - prefer 'import' for ESM, then 'default'
+        const conditions = ['import', 'default', 'node', 'require'];
+        for (const condition of conditions) {
+            if (condition in target) {
+                const result = this.#resolveExportTarget(target[condition]);
+                if (result) {
+                    return result;
+                }
+            }
+        }
+        return undefined;
+    }
     async #loadFromPath(absolutePath) {
         let stat;
         try {

package/dist/artifacts/loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/artifacts/loader.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/artifacts/loader.ts"],"names":[],"mappings":"AAKA,OAAO,EACN,YAAY,EACZ,mBAAmB,GACnB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAC,aAAa,EAAC,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAC,aAAa,EAAC,MAAM,UAAU,CAAC;AAevC,MAAM,OAAO,cAAc;IACjB,OAAO,CAA0B;IACjC,YAAY,CAAS;IAE9B,YAAY,MAA+B,EAAE,WAAmB;QAC/D,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,OAAO;QACZ,MAAM,SAAS,GAAuB,EAAE,CAAC;QAEzC,uDAAuD;QACvD,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACxB,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;gBAC7C,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;gBACjE,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAC7D,CAAC;QACF,CAAC;QAED,8CAA8C;QAC9C,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YAC1B,KAAK,MAAM,eAAe,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;gBACpD,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,eAAe,CAAC,CAAC;gBACpE,IAAI,YAAY,EAAE,CAAC;oBAClB,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;gBAC7D,CAAC;YACF,CAAC;QACF,CAAC;QAED,8BAA8B;QAC9B,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YAC3B,MAAM,iBAAiB,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YACxD,SAAS,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC,CAAC;QACtC,CAAC;QAED,OAAO,SAAS,CAAC;IAClB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,kBAAkB,CAAC,eAAuB;QAC/C,2DAA2D;QAC3D,MAAM,EAAC,OAAO,EAAE,OAAO,EAAC,GAAG,IAAI,CAAC,qBAAqB,CAAC,eAAe,CAAC,CAAC;QAEvE,IAAI,CAAC;YACJ,0DAA0D;YAC1D,MAAM,EAAC,MAAM,EAAE,OAAO,EAAC,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;YAE3D,IAAI,OAAO,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBAChC,qDAAqD;gBACrD,MAAM,eAAe,GAAG,IAAI,CAAC,sBAAsB,CAClD,OAAO,CAAC,OAAO,EACf,KAAK,OAAO,EAAE,CACd,CAAC;gBAEF,IAAI,eAAe,EAAE,CAAC;oBACrB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;oBACtD,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;oBACzD,IAAI,IAAI,EAAE,CAAC;wBACV,OAAO,UAAU,CAAC;oBACnB,CAAC;gBACF,CAAC;YACF,CAAC;YAED,2EAA2E;YAC3E,IAAI,OAAO,EAAE,CAAC;gBACb,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAC9C,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;gBACzD,IAAI,IAAI,EAAE,CAAC;oBACV,OAAO,UAAU,CAAC;gBACnB,CAAC;YACF,CAAC;YAED,+DAA+D;YAC/D,IAAI,CAAC;gBACJ,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,UAAU,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;gBACzF,MAAM,YAAY,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;gBAChD,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;gBAE3D,IAAI,IAAI,EAAE,WAAW,EAAE,EAAE,CAAC;oBACzB,OAAO,YAAY,CAAC;gBACrB,CAAC;gBAED,IAAI,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;oBACpB,wDAAwD;oBACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;oBAC7C,IAAI,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;wBACnC,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;oBACnC,CAAC;oBACD,OAAO,YAAY,CAAC;gBACrB,CAAC;YACF,CAAC;YAAC,MAAM,CAAC;gBACR,yDAAyD;YAC1D,CAAC;YAED,IAAI,IAAI,CAAC,OAAO,CAAC,sBAAsB,KAAK,KAAK,EAAE,CAAC;gBACnD,OAAO,CAAC,IAAI,CACX,+DAA+D,eAAe,EAAE,CAChF,CAAC;YACH,CAAC;YACD,OAAO,SAAS,CAAC;QAElB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,IAAI,CAAC,OAAO,CAAC,sBAAsB,KAAK,KAAK,EAAE,CAAC;gBACnD,OAAO,CAAC,IAAI,CACX,0DAA0D,eAAe,EAAE,EAC3E,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAC9C,CAAC;YACH,CAAC;YACD,OAAO,SAAS,CAAC;QAClB,CAAC;IACF,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY,CAAC,OAAe;QACjC,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC,CAAC;QAE5E,yEAAyE;QACzE,IAAI,CAAC;YACJ,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,eAAe,CAAC,CAAC;YAC/D,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YACzC,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,WAAW,CAA6B,CAAC;YAC5E,OAAO,EAAC,MAAM,EAAE,OAAO,EAAC,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACR,sDAAsD;QACvD,CAAC;QAED,oEAAoE;QACpE,IAAI,CAAC;YACJ,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC3C,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAElC,kDAAkD;YAClD,OAAO,GAAG,KAAK,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,0BAA0B;gBAC7D,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;gBACnD,IAAI,CAAC;oBACJ,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,WAAW,CAA4C,CAAC;oBAC3F,qCAAqC;oBACrC,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;wBAC9B,OAAO,EAAC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAC,CAAC;oBAC/B,CAAC;gBACF,CAAC;gBAAC,MAAM,CAAC;oBACR,4CAA4C;gBAC7C,CAAC;gBACD,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACzB,CAAC;QACF,CAAC;QAAC,MAAM,CAAC;YACR,+BAA+B;QAChC,CAAC;QAED,6CAA6C;QAC7C,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5F,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC;QAC/D,IAAI,CAAC;YACJ,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACxC,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;gBACnB,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,WAAW,CAA6B,CAAC;gBAC5E,OAAO,EAAC,MAAM,EAAE,eAAe,EAAE,OAAO,EAAC,CAAC;YAC3C,CAAC;QACF,CAAC;QAAC,MAAM,CAAC;YACR,mCAAmC;QACpC,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,2BAA2B,OAAO,EAAE,CAAC,CAAC;IACvD,CAAC;IAED;;;OAGG;IACH,qBAAqB,CAAC,SAAiB;QACtC,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,QAAQ,GAAG,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAE3C,IAAI,QAAQ,EAAE,CAAC;YACd,OAAO;gBACN,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;gBACpC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;aACjC,CAAC;QACH,CAAC;QAED,OAAO;YACN,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;YACjB,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;SACjC,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACH,sBAAsB,CAAC,OAAqB,EAAE,OAAe;QAC5D,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACtB,OAAO,SAAS,CAAC;QAClB,CAAC;QAED,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YACjC,wDAAwD;YACxD,OAAO,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9C,CAAC;QAED,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YACjC,OAAO,SAAS,CAAC;QAClB,CAAC;QAED,8BAA8B;QAC9B,IAAI,OAAO,IAAI,OAAO,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QACpD,CAAC;QAED,oDAAoD;QACpD,KAAK,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACzD,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;gBACpE,IAAI,QAAQ,EAAE,CAAC;oBACd,OAAO,QAAQ,CAAC;gBACjB,CAAC;YACF,CAAC;QACF,CAAC;QAED,qFAAqF;QACrF,KAAK,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACzD,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC1D,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBAC7C,MAAM,cAAc,GAAG,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;gBACzD,IAAI,cAAc,EAAE,CAAC;oBACpB,OAAO,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC;wBAClC,CAAC,CAAC,cAAc,GAAG,MAAM;wBACzB,CAAC,CAAC,cAAc,GAAG,GAAG,GAAG,MAAM,CAAC;gBAClC,CAAC;YACF,CAAC;QACF,CAAC;QAED,OAAO,SAAS,CAAC;IAClB,CAAC;IAED;;;;OAIG;IACH,mBAAmB,CAClB,OAAe,EACf,MAAoB,EACpB,OAAe;QAEf,oFAAoF;QACpF,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAE9C,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;YAC7B,qDAAqD;YACrD,uCAAuC;YACvC,MAAM,cAAc,GAAG,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;YACzD,IAAI,cAAc,EAAE,CAAC;gBACpB,OAAO,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC5D,CAAC;QACF,CAAC;QAED,yDAAyD;QACzD,IAAI,OAAO,CAAC,UAAU,CAAC,WAAW,GAAG,GAAG,CAAC,EAAE,CAAC;YAC3C,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAC5D,MAAM,cAAc,GAAG,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;YACzD,IAAI,cAAc,IAAI,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpD,OAAO,cAAc,CAAC,OAAO,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;YACnD,CAAC;QACF,CAAC;QAED,OAAO,SAAS,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,oBAAoB,CAAC,MAAoB;QACxC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACrB,OAAO,SAAS,CAAC;QAClB,CAAC;QAED,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAChC,OAAO,MAAM,CAAC;QACf,CAAC;QAED,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAChC,OAAO,SAAS,CAAC;QAClB,CAAC;QAED,uEAAuE;QACvE,MAAM,UAAU,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;QAC5D,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACpC,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;gBACzB,MAAM,MAAM,GAAG,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;gBAC5D,IAAI,MAAM,EAAE,CAAC;oBACZ,OAAO,MAAM,CAAC;gBACf,CAAC;YACF,CAAC;QACF,CAAC;QAED,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,YAAoB;QACvC,IAAI,IAAyC,CAAC;QAE9C,IAAI,CAAC;YACJ,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACR,yCAAyC;YACzC,IAAI,IAAI,CAAC,OAAO,CAAC,sBAAsB,KAAK,KAAK,EAAE,CAAC;gBACnD,OAAO,CAAC,IAAI,CACX,gDAAgD,YAAY,EAAE,CAC9D,CAAC;YACH,CAAC;YACD,OAAO,EAAE,CAAC;QACX,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YACnB,IAAI,CAAC;gBACJ,OAAO,CAAC,MAAM,IAAI,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC,CAAC;YACrD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,IAAI,IAAI,CAAC,OAAO,CAAC,sBAAsB,KAAK,KAAK,EAAE,CAAC;oBACnD,OAAO,CAAC,IAAI,CACX,yDAAyD,YAAY,EAAE,EACvE,KAAK,CACL,CAAC;gBACH,CAAC;gBACD,OAAO,EAAE,CAAC;YACX,CAAC;QACF,CAAC;QAED,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,4CAA4C;YAC5C,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE,CAC3D,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CACnB,CAAC;YAEF,MAAM,eAAe,GAAuB,EAAE,CAAC;YAC/C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBAC1B,IAAI,CAAC;oBACJ,eAAe,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC1D,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBAChB,IAAI,IAAI,CAAC,OAAO,CAAC,sBAAsB,KAAK,KAAK,EAAE,CAAC;wBACnD,OAAO,CAAC,IAAI,CACX,yDAAyD,IAAI,EAAE,EAC/D,KAAK,CACL,CAAC;oBACH,CAAC;gBACF,CAAC;YACF,CAAC;YACD,OAAO,eAAe,CAAC;QACxB,CAAC;QAED,OAAO,EAAE,CAAC;IACX,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,QAAgB;QACvC,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACnD,CAAC;IAED,kBAAkB,CAAC,GAAQ,EAAE,MAAc;QAC1C,wDAAwD;QACxD,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CACd,iBAAiB,MAAM,uDAAuD,CAC9E,CAAC;QACH,CAAC;QAED,mDAAmD;QACnD,qDAAqD;QACrD,IAAI,YAAY,GAAG,GAAG,CAAC,YAAY,CAAC;QACpC,IAAI,CAAC,YAAY,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;YACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAChD,YAAY,GAAG,QAAQ,CAAC;QACzB,CAAC;QAED,iDAAiD;QACjD,oDAAoD;QACpD,IAAI,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC;QAChC,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;YACnD,UAAU,GAAG,YAAY,YAAY,MAAM,CAAC;QAC7C,CAAC;QAED,kCAAkC;QAClC,MAAM,QAAQ,GAAqB;YAClC,YAAY;YACZ,UAAU;YACV,GAAG,EAAE,GAAG,CAAC,GAAG;YACZ,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,IAAI;YAC9B,gBAAgB,EAAE,GAAG,CAAC,gBAAgB,IAAI,IAAI;YAC9C,cAAc,EAAE,GAAG,CAAC,cAAc,IAAI,EAAE;YACxC,sBAAsB,EAAE,GAAG,CAAC,sBAAsB,IAAI,EAAE;SACxD,CAAC;QAEF,6DAA6D;QAC7D,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;YACnB,4CAA4C;YAC3C,QAAyB,CAAC,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC;YACpD,QAAyB,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;YAClD,QAAyB,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC;YACxC,QAAyB,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;YAC9C,QAAyB,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;YAChD,QAAyB,CAAC,aAAa,GAAG,GAAG,CAAC,aAAa,CAAC;QAC9D,CAAC;QAED,OAAO,QAAQ,CAAC;IACjB,CAAC;CACD"}

package/dist/artifacts/types.d.ts

@@ -81,11 +81,23 @@ export type ArtifactResolver = () => Promise<ExternalArtifact[]> | ExternalArtif
  */
 export interface ExternalArtifactsConfig {
     /**
-     * Paths to artifact files or directories
+     * Paths to artifact files or directories (relative to project root)
      * - File path: loads single artifact JSON
      * - Directory path: loads all .json files recursively
      */
     paths?: string[];
+    /**
+     * Module specifiers to resolve from node_modules
+     * Uses Node.js module resolution to find exported artifact directories.
+     *
+     * @example
+     * ```ts
+     * // If @my-org/contracts exports "./artifacts" in package.json:
+     * // "exports": { "./artifacts": "./dist/artifacts" }
+     * modules: ['@my-org/contracts/artifacts']
+     * ```
+     */
+    modules?: string[];
     /**
      * Function that resolves and returns artifacts dynamically
      * Useful for loading from APIs, databases, or complex logic

package/dist/artifacts/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/artifacts/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAChC,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAC;IAErB,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IAEnB,mBAAmB;IACnB,GAAG,EAAE,SAAS,GAAG,EAAE,CAAC;IAEpB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IAEjB,8CAA8C;IAC9C,gBAAgB,EAAE,MAAM,CAAC;IAEzB,sDAAsD;IACtD,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC,oDAAoD;IACpD,sBAAsB,CAAC,EAAE,cAAc,CAAC;CACxC;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACrD,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,qEAAqE;IACrE,GAAG,CAAC,EAAE;QACL,QAAQ,EAAE;YACT,MAAM,EAAE,MAAM,CAAC;YACf,OAAO,EAAE,MAAM,CAAC;YAChB,SAAS,EAAE,MAAM,CAAC;YAClB,cAAc,EAAE,cAAc,CAAC;YAC/B,gBAAgB,CAAC,EAAE,GAAG,EAAE,CAAC;YACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;SACxC,CAAC;QACF,gBAAgB,EAAE;YACjB,MAAM,EAAE,MAAM,CAAC;YACf,OAAO,EAAE,MAAM,CAAC;YAChB,SAAS,EAAE,MAAM,CAAC;YAClB,cAAc,EAAE,cAAc,CAAC;YAC/B,mBAAmB,CAAC,EAAE,MAAM,CAC3B,MAAM,EACN,KAAK,CAAC;gBAAC,KAAK,EAAE,MAAM,CAAC;gBAAC,MAAM,EAAE,MAAM,CAAA;aAAC,CAAC,CACtC,CAAC;YACF,gBAAgB,CAAC,EAAE,GAAG,EAAE,CAAC;YACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;SACxC,CAAC;QACF,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC3C,YAAY,CAAC,EAAE,GAAG,CAAC;KACnB,CAAC;IAEF,8BAA8B;IAC9B,MAAM,CAAC,EAAE,GAAG,CAAC;IAEb,yBAAyB;IACzB,OAAO,CAAC,EAAE,GAAG,CAAC;IAEd,qBAAqB;IACrB,aAAa,CAAC,EAAE,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC9B,CAAC,UAAU,EAAE,MAAM,GAAG;QACrB,CAAC,WAAW,EAAE,MAAM,GAAG,KAAK,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAC,CAAC,CAAC;KAC9D,CAAC;CACF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC7B,QAAQ,EAAE,gBAAgB,GACxB,QAAQ,IAAI,YAAY,CAE1B;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAC5B,OAAO,CAAC,gBAAgB,EAAE,CAAC,GAC3B,gBAAgB,EAAE,CAAC;AAEtB;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACvC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAEjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAE5B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/artifacts/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAChC,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAC;IAErB,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IAEnB,mBAAmB;IACnB,GAAG,EAAE,SAAS,GAAG,EAAE,CAAC;IAEpB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IAEjB,8CAA8C;IAC9C,gBAAgB,EAAE,MAAM,CAAC;IAEzB,sDAAsD;IACtD,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC,oDAAoD;IACpD,sBAAsB,CAAC,EAAE,cAAc,CAAC;CACxC;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACrD,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,qEAAqE;IACrE,GAAG,CAAC,EAAE;QACL,QAAQ,EAAE;YACT,MAAM,EAAE,MAAM,CAAC;YACf,OAAO,EAAE,MAAM,CAAC;YAChB,SAAS,EAAE,MAAM,CAAC;YAClB,cAAc,EAAE,cAAc,CAAC;YAC/B,gBAAgB,CAAC,EAAE,GAAG,EAAE,CAAC;YACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;SACxC,CAAC;QACF,gBAAgB,EAAE;YACjB,MAAM,EAAE,MAAM,CAAC;YACf,OAAO,EAAE,MAAM,CAAC;YAChB,SAAS,EAAE,MAAM,CAAC;YAClB,cAAc,EAAE,cAAc,CAAC;YAC/B,mBAAmB,CAAC,EAAE,MAAM,CAC3B,MAAM,EACN,KAAK,CAAC;gBAAC,KAAK,EAAE,MAAM,CAAC;gBAAC,MAAM,EAAE,MAAM,CAAA;aAAC,CAAC,CACtC,CAAC;YACF,gBAAgB,CAAC,EAAE,GAAG,EAAE,CAAC;YACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;SACxC,CAAC;QACF,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC3C,YAAY,CAAC,EAAE,GAAG,CAAC;KACnB,CAAC;IAEF,8BAA8B;IAC9B,MAAM,CAAC,EAAE,GAAG,CAAC;IAEb,yBAAyB;IACzB,OAAO,CAAC,EAAE,GAAG,CAAC;IAEd,qBAAqB;IACrB,aAAa,CAAC,EAAE,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC9B,CAAC,UAAU,EAAE,MAAM,GAAG;QACrB,CAAC,WAAW,EAAE,MAAM,GAAG,KAAK,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAC,CAAC,CAAC;KAC9D,CAAC;CACF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC7B,QAAQ,EAAE,gBAAgB,GACxB,QAAQ,IAAI,YAAY,CAE1B;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAC5B,OAAO,CAAC,gBAAgB,EAAE,CAAC,GAC3B,gBAAgB,EAAE,CAAC;AAEtB;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACvC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAEjB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAE5B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB"}

package/dist/hooks/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/hooks/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,qBAAqB,CAAC;8BAG5B,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;AAAtD,wBAuCE"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/hooks/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,qBAAqB,CAAC;8BAG5B,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;AAAtD,wBAwCE"}

package/dist/hooks/config.js

@@ -7,6 +7,7 @@ export default async () => {
             // Apply defaults
             const externalArtifacts = {
                 paths: externalArtifactsUserConfig?.paths ?? [],
+                modules: externalArtifactsUserConfig?.modules ?? [],
                 resolver: externalArtifactsUserConfig?.resolver,
                 solcVersion: externalArtifactsUserConfig?.solcVersion ?? '0.8.20',
                 warnOnInvalidArtifacts: externalArtifactsUserConfig?.warnOnInvalidArtifacts ?? true,

package/dist/hooks/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/hooks/config.ts"],"names":[],"mappings":"AAGA,eAAe,KAAK,IAAmC,EAAE;IACxD,MAAM,QAAQ,GAAyB;QACtC,iBAAiB,EAAE,KAAK,EACvB,UAAU,EACV,4BAA4B,EAC5B,IAAI,EACH,EAAE;YACH,MAAM,cAAc,GAAG,MAAM,IAAI,CAChC,UAAU,EACV,4BAA4B,CAC5B,CAAC;YAEF,uCAAuC;YACvC,MAAM,2BAA2B,GAAG,UAAU,CAAC,iBAEnC,CAAC;YAEb,iBAAiB;YACjB,MAAM,iBAAiB,GAInB;gBACH,KAAK,EAAE,2BAA2B,EAAE,KAAK,IAAI,EAAE;gBAC/C,QAAQ,EAAE,2BAA2B,EAAE,QAAQ;gBAC/C,WAAW,EAAE,2BAA2B,EAAE,WAAW,IAAI,QAAQ;gBACjE,sBAAsB,EACrB,2BAA2B,EAAE,sBAAsB,IAAI,IAAI;gBAC5D,KAAK,EAAE,2BAA2B,EAAE,KAAK,IAAI,KAAK;aAClD,CAAC;YAEF,OAAO;gBACN,GAAG,cAAc;gBACjB,iBAAiB;aACjB,CAAC;QACH,CAAC;KACD,CAAC;IAEF,OAAO,QAAQ,CAAC;AACjB,CAAC,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/hooks/config.ts"],"names":[],"mappings":"AAGA,eAAe,KAAK,IAAmC,EAAE;IACxD,MAAM,QAAQ,GAAyB;QACtC,iBAAiB,EAAE,KAAK,EACvB,UAAU,EACV,4BAA4B,EAC5B,IAAI,EACH,EAAE;YACH,MAAM,cAAc,GAAG,MAAM,IAAI,CAChC,UAAU,EACV,4BAA4B,CAC5B,CAAC;YAEF,uCAAuC;YACvC,MAAM,2BAA2B,GAAG,UAAU,CAAC,iBAEnC,CAAC;YAEb,iBAAiB;YACjB,MAAM,iBAAiB,GAInB;gBACH,KAAK,EAAE,2BAA2B,EAAE,KAAK,IAAI,EAAE;gBAC/C,OAAO,EAAE,2BAA2B,EAAE,OAAO,IAAI,EAAE;gBACnD,QAAQ,EAAE,2BAA2B,EAAE,QAAQ;gBAC/C,WAAW,EAAE,2BAA2B,EAAE,WAAW,IAAI,QAAQ;gBACjE,sBAAsB,EACrB,2BAA2B,EAAE,sBAAsB,IAAI,IAAI;gBAC5D,KAAK,EAAE,2BAA2B,EAAE,KAAK,IAAI,KAAK;aAClD,CAAC;YAEF,OAAO;gBACN,GAAG,cAAc;gBACjB,iBAAiB;aACjB,CAAC;QACH,CAAC;KACD,CAAC;IAEF,OAAO,QAAQ,CAAC;AACjB,CAAC,CAAC"}

package/dist/hooks/network.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/hooks/network.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,YAAY,EAAc,MAAM,qBAAqB,CAAC;8BAS1C,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;AAAvD,wBAsHE"}
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/hooks/network.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,YAAY,EAAc,MAAM,qBAAqB,CAAC;8BAS1C,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;AAAvD,wBAyHE"}

package/dist/hooks/network.js

@@ -12,7 +12,8 @@ export default async () => {
             }
             const config = context.config.externalArtifacts;
             // Check if config exists and there's anything to load
-            if (!config || (!config.paths?.length && !config.resolver)) {
+            if (!config ||
+                (!config.modules?.length && !config.paths?.length && !config.resolver)) {
                 return connection;
             }
             const debug = config.debug ?? false;

package/dist/hooks/network.js.map

@@ -1 +1 @@
-{"version":3,"file":"network.js","sourceRoot":"","sources":["../../src/hooks/network.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"network.js","sourceRoot":"","sources":["../../src/hooks/network.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hardhat-external-artifacts",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "Hardhat plugin that allow hardhat to know about them",
   "keywords": [
     "hardhat",

package/src/artifacts/loader.ts

@@ -9,6 +9,21 @@ import {
 } from '@nomicfoundation/hardhat-utils/fs';
 import path from 'node:path';
 import fs from 'node:fs/promises';
+import {createRequire} from 'node:module';
+import {fileURLToPath} from 'node:url';
+
+/**
+ * Package.json exports field types
+ */
+type ExportsField = string | null | ExportsConditions | ExportsMap;
+
+interface ExportsConditions {
+	[condition: string]: ExportsField;
+}
+
+interface ExportsMap {
+	[subpath: string]: ExportsField;
+}
 
 export class ArtifactLoader {
 	readonly #config: ExternalArtifactsConfig;
@@ -22,7 +37,7 @@ export class ArtifactLoader {
 	async loadAll(): Promise<ExternalArtifact[]> {
 		const artifacts: ExternalArtifact[] = [];
 
-		// Load from paths
+		// Load from paths (relative/absolute filesystem paths)
 		if (this.#config.paths) {
 			for (const pathOrGlob of this.#config.paths) {
 				const absolutePath = path.resolve(this.#projectRoot, pathOrGlob);
@@ -30,6 +45,16 @@ export class ArtifactLoader {
 			}
 		}
 
+		// Load from modules (node_modules resolution)
+		if (this.#config.modules) {
+			for (const moduleSpecifier of this.#config.modules) {
+				const resolvedPath = await this.#resolveModulePath(moduleSpecifier);
+				if (resolvedPath) {
+					artifacts.push(...(await this.#loadFromPath(resolvedPath)));
+				}
+			}
+		}
+
 		// Load from resolver function
 		if (this.#config.resolver) {
 			const resolvedArtifacts = await this.#config.resolver();
@@ -39,6 +64,280 @@ export class ArtifactLoader {
 		return artifacts;
 	}
 
+	/**
+	 * Resolves a module specifier to an absolute filesystem path.
+	 * Supports package.json "exports" field patterns like "./artifacts/*".
+	 *
+	 * @param moduleSpecifier - e.g., "@my-org/contracts/artifacts"
+	 * @returns The resolved absolute path, or undefined if resolution fails
+	 */
+	async #resolveModulePath(moduleSpecifier: string): Promise<string | undefined> {
+		// Parse the module specifier into package name and subpath
+		const {pkgName, subpath} = this.#parseModuleSpecifier(moduleSpecifier);
+
+		try {
+			// Find the package directory by locating its package.json
+			const {pkgDir, pkgJson} = await this.#findPackage(pkgName);
+
+			if (subpath && pkgJson.exports) {
+				// Try to resolve the subpath using the exports field
+				const resolvedSubpath = this.#resolveExportsSubpath(
+					pkgJson.exports,
+					`./${subpath}`,
+				);
+
+				if (resolvedSubpath) {
+					const targetPath = path.join(pkgDir, resolvedSubpath);
+					const stat = await fs.stat(targetPath).catch(() => null);
+					if (stat) {
+						return targetPath;
+					}
+				}
+			}
+
+			// Fallback: try direct path (for packages without exports or simple cases)
+			if (subpath) {
+				const targetPath = path.join(pkgDir, subpath);
+				const stat = await fs.stat(targetPath).catch(() => null);
+				if (stat) {
+					return targetPath;
+				}
+			}
+
+			// Try using import.meta.resolve for standard module resolution
+			try {
+				const resolvedUrl = import.meta.resolve(moduleSpecifier, `file://${this.#projectRoot}/`);
+				const resolvedPath = fileURLToPath(resolvedUrl);
+				const stat = await fs.stat(resolvedPath).catch(() => null);
+
+				if (stat?.isDirectory()) {
+					return resolvedPath;
+				}
+
+				if (stat?.isFile()) {
+					// If it resolved to an index file, return the directory
+					const basename = path.basename(resolvedPath);
+					if (basename.startsWith('index.')) {
+						return path.dirname(resolvedPath);
+					}
+					return resolvedPath;
+				}
+			} catch {
+				// import.meta.resolve failed, continue to error handling
+			}
+
+			if (this.#config.warnOnInvalidArtifacts !== false) {
+				console.warn(
+					`[hardhat-external-artifacts] Could not resolve module path: ${moduleSpecifier}`,
+				);
+			}
+			return undefined;
+
+		} catch (error) {
+			if (this.#config.warnOnInvalidArtifacts !== false) {
+				console.warn(
+					`[hardhat-external-artifacts] Failed to resolve module: ${moduleSpecifier}`,
+					error instanceof Error ? error.message : error,
+				);
+			}
+			return undefined;
+		}
+	}
+
+	/**
+	 * Find a package's directory and read its package.json.
+	 * Handles packages with strict exports that don't include ./package.json.
+	 */
+	async #findPackage(pkgName: string): Promise<{pkgDir: string; pkgJson: {exports?: ExportsField}}> {
+		const require = createRequire(path.join(this.#projectRoot, 'package.json'));
+
+		// Try method 1: Direct package.json resolution (works for most packages)
+		try {
+			const pkgJsonPath = require.resolve(`${pkgName}/package.json`);
+			const pkgDir = path.dirname(pkgJsonPath);
+			const pkgJson = await readJsonFile(pkgJsonPath) as {exports?: ExportsField};
+			return {pkgDir, pkgJson};
+		} catch {
+			// Package has strict exports, try alternative methods
+		}
+
+		// Try method 2: Resolve main entry and walk up to find package.json
+		try {
+			const mainEntry = require.resolve(pkgName);
+			let dir = path.dirname(mainEntry);
+			
+			// Walk up the directory tree to find package.json
+			while (dir !== path.dirname(dir)) { // Stop at filesystem root
+				const pkgJsonPath = path.join(dir, 'package.json');
+				try {
+					const pkgJson = await readJsonFile(pkgJsonPath) as {name?: string; exports?: ExportsField};
+					// Verify this is the correct package
+					if (pkgJson.name === pkgName) {
+						return {pkgDir: dir, pkgJson};
+					}
+				} catch {
+					// No package.json here, continue walking up
+				}
+				dir = path.dirname(dir);
+			}
+		} catch {
+			// Main entry resolution failed
+		}
+
+		// Try method 3: Search node_modules directly
+		const nodeModulesPath = path.join(this.#projectRoot, 'node_modules', ...pkgName.split('/'));
+		const pkgJsonPath = path.join(nodeModulesPath, 'package.json');
+		try {
+			const stat = await fs.stat(pkgJsonPath);
+			if (stat.isFile()) {
+				const pkgJson = await readJsonFile(pkgJsonPath) as {exports?: ExportsField};
+				return {pkgDir: nodeModulesPath, pkgJson};
+			}
+		} catch {
+			// Not found in direct node_modules
+		}
+
+		throw new Error(`Could not find package: ${pkgName}`);
+	}
+
+	/**
+	 * Parse a module specifier into package name and subpath.
+	 * Handles scoped packages (e.g., "@scope/pkg/subpath") and regular packages.
+	 */
+	#parseModuleSpecifier(specifier: string): {pkgName: string; subpath: string} {
+		const parts = specifier.split('/');
+		const isScoped = specifier.startsWith('@');
+
+		if (isScoped) {
+			return {
+				pkgName: parts.slice(0, 2).join('/'),
+				subpath: parts.slice(2).join('/'),
+			};
+		}
+
+		return {
+			pkgName: parts[0],
+			subpath: parts.slice(1).join('/'),
+		};
+	}
+
+	/**
+	 * Resolve a subpath against a package.json exports field.
+	 * Handles subpath patterns like "./artifacts/*": "./dist/artifacts/*"
+	 *
+	 * @param exports - The exports field from package.json
+	 * @param subpath - The subpath to resolve (e.g., "./artifacts")
+	 * @returns The resolved path relative to the package root, or undefined
+	 */
+	#resolveExportsSubpath(exports: ExportsField, subpath: string): string | undefined {
+		if (exports === null) {
+			return undefined;
+		}
+
+		if (typeof exports === 'string') {
+			// Simple string export - only matches if subpath is "."
+			return subpath === '.' ? exports : undefined;
+		}
+
+		if (typeof exports !== 'object') {
+			return undefined;
+		}
+
+		// Check for exact match first
+		if (subpath in exports) {
+			return this.#resolveExportTarget(exports[subpath]);
+		}
+
+		// Check for pattern matches (e.g., "./artifacts/*")
+		for (const [pattern, target] of Object.entries(exports)) {
+			if (pattern.includes('*')) {
+				const resolved = this.#matchExportPattern(pattern, target, subpath);
+				if (resolved) {
+					return resolved;
+				}
+			}
+		}
+
+		// Check for directory patterns (e.g., "./artifacts/" matches "./artifacts/anything")
+		for (const [pattern, target] of Object.entries(exports)) {
+			if (pattern.endsWith('/') && subpath.startsWith(pattern)) {
+				const suffix = subpath.slice(pattern.length);
+				const resolvedTarget = this.#resolveExportTarget(target);
+				if (resolvedTarget) {
+					return resolvedTarget.endsWith('/')
+						? resolvedTarget + suffix
+						: resolvedTarget + '/' + suffix;
+				}
+			}
+		}
+
+		return undefined;
+	}
+
+	/**
+	 * Match a subpath against an export pattern with wildcards.
+	 * E.g., pattern "./artifacts/*" with target "./dist/*" and subpath "./artifacts"
+	 * would return "./dist"
+	 */
+	#matchExportPattern(
+		pattern: string,
+		target: ExportsField,
+		subpath: string,
+	): string | undefined {
+		// Handle pattern like "./artifacts/*" matching "./artifacts" (the directory itself)
+		const patternBase = pattern.replace('/*', '');
+		
+		if (subpath === patternBase) {
+			// User wants the base directory, not a specific file
+			// Resolve to the target base directory
+			const resolvedTarget = this.#resolveExportTarget(target);
+			if (resolvedTarget) {
+				return resolvedTarget.replace('/*', '').replace(/\*$/, '');
+			}
+		}
+
+		// Handle pattern matching for files within the directory
+		if (subpath.startsWith(patternBase + '/')) {
+			const wildcardValue = subpath.slice(patternBase.length + 1);
+			const resolvedTarget = this.#resolveExportTarget(target);
+			if (resolvedTarget && resolvedTarget.includes('*')) {
+				return resolvedTarget.replace('*', wildcardValue);
+			}
+		}
+
+		return undefined;
+	}
+
+	/**
+	 * Resolve an export target, handling conditional exports.
+	 */
+	#resolveExportTarget(target: ExportsField): string | undefined {
+		if (target === null) {
+			return undefined;
+		}
+
+		if (typeof target === 'string') {
+			return target;
+		}
+
+		if (typeof target !== 'object') {
+			return undefined;
+		}
+
+		// Handle conditional exports - prefer 'import' for ESM, then 'default'
+		const conditions = ['import', 'default', 'node', 'require'];
+		for (const condition of conditions) {
+			if (condition in target) {
+				const result = this.#resolveExportTarget(target[condition]);
+				if (result) {
+					return result;
+				}
+			}
+		}
+
+		return undefined;
+	}
+
 	async #loadFromPath(absolutePath: string): Promise<ExternalArtifact[]> {
 		let stat: Awaited<ReturnType<typeof fs.stat>>;
 

package/src/artifacts/types.ts

@@ -100,12 +100,25 @@ export type ArtifactResolver = () =>
  */
 export interface ExternalArtifactsConfig {
 	/**
-	 * Paths to artifact files or directories
+	 * Paths to artifact files or directories (relative to project root)
 	 * - File path: loads single artifact JSON
 	 * - Directory path: loads all .json files recursively
 	 */
 	paths?: string[];
 
+	/**
+	 * Module specifiers to resolve from node_modules
+	 * Uses Node.js module resolution to find exported artifact directories.
+	 *
+	 * @example
+	 * ```ts
+	 * // If @my-org/contracts exports "./artifacts" in package.json:
+	 * // "exports": { "./artifacts": "./dist/artifacts" }
+	 * modules: ['@my-org/contracts/artifacts']
+	 * ```
+	 */
+	modules?: string[];
+
 	/**
 	 * Function that resolves and returns artifacts dynamically
 	 * Useful for loading from APIs, databases, or complex logic

package/src/hooks/config.ts

@@ -25,6 +25,7 @@ export default async (): Promise<Partial<ConfigHooks>> => {
 				resolver?: ExternalArtifactsConfig['resolver'];
 			} = {
 				paths: externalArtifactsUserConfig?.paths ?? [],
+				modules: externalArtifactsUserConfig?.modules ?? [],
 				resolver: externalArtifactsUserConfig?.resolver,
 				solcVersion: externalArtifactsUserConfig?.solcVersion ?? '0.8.20',
 				warnOnInvalidArtifacts:

package/src/hooks/network.ts

@@ -26,7 +26,10 @@ export default async (): Promise<Partial<NetworkHooks>> => {
 			const config = context.config.externalArtifacts;
 
 			// Check if config exists and there's anything to load
-			if (!config || (!config.paths?.length && !config.resolver)) {
+			if (
+				!config ||
+				(!config.modules?.length && !config.paths?.length && !config.resolver)
+			) {
 				return connection;
 			}
 
@@ -54,13 +57,13 @@ export default async (): Promise<Partial<NetworkHooks>> => {
 					);
 				}
 
-					// Convert to compilation format(s)
-					// Rich artifacts with solcInput get their own compilations
-					// Simple artifacts get grouped into a synthetic compilation
-					const compilations = artifactsToCompilations(
-						artifacts,
-						config.solcVersion, // Default already set in config.ts
-					);
+				// Convert to compilation format(s)
+				// Rich artifacts with solcInput get their own compilations
+				// Simple artifacts get grouped into a synthetic compilation
+				const compilations = artifactsToCompilations(
+					artifacts,
+					config.solcVersion, // Default already set in config.ts
+				);
 
 				log(
 					`[hardhat-external-artifacts] Created ${compilations.length} compilation(s)`,