feat: allow options.preferBuiltins to be function

packages/node-resolve/src/index.js

@@ -58,7 +58,7 @@ export function nodeResolve(opts = {}) {
   const idToPackageInfo = new Map();
   const mainFields = getMainFields(options);
   const useBrowserOverrides = mainFields.indexOf('browser') !== -1;
-  const isPreferBuiltinsSet = options.preferBuiltins === true || options.preferBuiltins === false;
+  const isPreferBuiltinsSet = Object.prototype.hasOwnProperty.call(options, 'preferBuiltins');
   const preferBuiltins = isPreferBuiltinsSet ? options.preferBuiltins : true;
   const rootDir = resolve(options.rootDir || process.cwd());
   let { dedupe } = options;
@@ -194,8 +194,10 @@ export function nodeResolve(opts = {}) {
     });
 
     const importeeIsBuiltin = builtinModules.includes(importee.replace(nodeImportPrefix, ''));
+    const preferImporteeIsBuiltin =
+      typeof preferBuiltins === 'function' ? preferBuiltins(importee) : preferBuiltins;
     const resolved =
-      importeeIsBuiltin && preferBuiltins
+      importeeIsBuiltin && preferImporteeIsBuiltin
         ? {
             packageInfo: undefined,
             hasModuleSideEffects: () => null,
@@ -230,11 +232,14 @@ export function nodeResolve(opts = {}) {
     idToPackageInfo.set(location, packageInfo);
 
     if (hasPackageEntry) {
-      if (importeeIsBuiltin && preferBuiltins) {
+      if (importeeIsBuiltin && preferImporteeIsBuiltin) {
         if (!isPreferBuiltinsSet && resolvedWithoutBuiltins && resolved !== importee) {
-          context.warn(
-            `preferring built-in module '${importee}' over local alternative at '${resolvedWithoutBuiltins.location}', pass 'preferBuiltins: false' to disable this behavior or 'preferBuiltins: true' to disable this warning`
-          );
+          context.warn({
+            message:
+              `preferring built-in module '${importee}' over local alternative at '${resolvedWithoutBuiltins.location}', pass 'preferBuiltins: false' to disable this behavior or 'preferBuiltins: true' to disable this warning.` +
+              `or passing a function to 'preferBuiltins' to provide more fine-grained control over which built-in modules to prefer.`,
+            pluginCode: 'PREFER_BUILTINS'
+          });
         }
         return false;
       } else if (jail && location.indexOf(normalize(jail.trim(sep))) !== 0) {