@parcel/transformer-postcss 2.0.0-nightly.101 → 2.0.0-nightly.1014

package/lib/PostCSSTransformer.js

@@ -5,205 +5,277 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.default = void 0;
 
-var _utils = require("@parcel/utils");
+function _hash() {
+  const data = require("@parcel/hash");
 
-var _plugin = require("@parcel/plugin");
+  _hash = function () {
+    return data;
+  };
 
-var _fileSystemLoader = _interopRequireDefault(require("css-modules-loader-core/lib/file-system-loader"));
+  return data;
+}
 
-var _nullthrows = _interopRequireDefault(require("nullthrows"));
+function _utils() {
+  const data = require("@parcel/utils");
 
-var _path = _interopRequireDefault(require("path"));
+  _utils = function () {
+    return data;
+  };
 
-var _postcss = _interopRequireDefault(require("postcss"));
+  return data;
+}
 
-var _semver = _interopRequireDefault(require("semver"));
+function _plugin() {
+  const data = require("@parcel/plugin");
 
-var _postcssValueParser = _interopRequireDefault(require("postcss-value-parser"));
+  _plugin = function () {
+    return data;
+  };
 
-var _loadPlugins = _interopRequireDefault(require("./loadPlugins"));
+  return data;
+}
 
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _nullthrows() {
+  const data = _interopRequireDefault(require("nullthrows"));
 
-function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); if (enumerableOnly) symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; }); keys.push.apply(keys, symbols); } return keys; }
+  _nullthrows = function () {
+    return data;
+  };
 
-function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i] != null ? arguments[i] : {}; if (i % 2) { ownKeys(Object(source), true).forEach(function (key) { _defineProperty(target, key, source[key]); }); } else if (Object.getOwnPropertyDescriptors) { Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)); } else { ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } } return target; }
+  return data;
+}
 
-function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _path() {
+  const data = _interopRequireDefault(require("path"));
 
-const COMPOSES_RE = /composes:.+from\s*("|').*("|')\s*;?/;
-const FROM_IMPORT_RE = /.+from\s*(?:"|')(.*)(?:"|')\s*;?/;
-const MODULE_BY_NAME_RE = /\.module\./;
+  _path = function () {
+    return data;
+  };
 
-var _default = new _plugin.Transformer({
-  async getConfig({
-    asset,
-    resolve,
-    options
-  }) {
-    let configFile = await asset.getConfig(['.postcssrc', '.postcssrc.json', '.postcssrc.js', 'postcss.config.js'], {
-      packageKey: 'postcss'
-    }); // Use a basic, modules-only PostCSS config if the file opts in by a name
-    // like foo.module.css
-
-    if (configFile == null && asset.filePath.match(MODULE_BY_NAME_RE)) {
-      configFile = {
-        plugins: {
-          'postcss-modules': {}
-        }
-      };
-    }
+  return data;
+}
 
-    if (configFile == null) {
-      return;
-    }
+function _semver() {
+  const data = _interopRequireDefault(require("semver"));
 
-    if (typeof configFile !== 'object') {
-      throw new Error('PostCSS config should be an object.');
-    }
+  _semver = function () {
+    return data;
+  };
 
-    if (configFile.plugins == null || typeof configFile.plugins !== 'object' || Object.keys(configFile.plugins) === 0) {
-      throw new Error('PostCSS config must have plugins');
-    }
+  return data;
+}
 
-    let originalModulesConfig;
-    let configFilePlugins = configFile.plugins;
+function _postcssValueParser() {
+  const data = _interopRequireDefault(require("postcss-value-parser"));
 
-    if (configFilePlugins != null && typeof configFilePlugins === 'object' && configFilePlugins['postcss-modules'] != null) {
-      originalModulesConfig = configFilePlugins['postcss-modules']; // $FlowFixMe
+  _postcssValueParser = function () {
+    return data;
+  };
 
-      delete configFilePlugins['postcss-modules'];
-    }
+  return data;
+}
 
-    let plugins = await (0, _loadPlugins.default)(configFilePlugins, asset.filePath, options);
+var _loadConfig = require("./loadConfig");
 
-    if (originalModulesConfig || configFile.modules) {
-      let postcssModules = await options.packageManager.require('postcss-modules', asset.filePath);
-      plugins.push(postcssModules(_objectSpread({
-        getJSON: (filename, json) => asset.meta.cssModules = json,
-        Loader: createLoader(asset, resolve),
-        generateScopedName: (name, filename, css) => `_${name}_${(0, _utils.md5FromString)(filename + css).substr(0, 5)}`
-      }, originalModulesConfig)));
-    }
+var _constants = require("./constants");
 
-    return {
-      plugins,
-      from: asset.filePath,
-      to: asset.filePath
-    };
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+const COMPOSES_RE = /composes:.+from\s*("|').*("|')\s*;?/;
+const FROM_IMPORT_RE = /.+from\s*(?:"|')(.*)(?:"|')\s*;?/;
+const LEGACY_MODULE_RE = /@value|(:global|:local)(?!\s*\()/i;
+const MODULE_BY_NAME_RE = /\.module\./;
+
+var _default = new (_plugin().Transformer)({
+  loadConfig({
+    config,
+    options,
+    logger
+  }) {
+    return (0, _loadConfig.load)({
+      config,
+      options,
+      logger
+    });
   },
 
   canReuseAST({
     ast
   }) {
-    return ast.type === 'postcss' && _semver.default.satisfies(ast.version, '^7.0.0');
+    return ast.type === 'postcss' && _semver().default.satisfies(ast.version, _constants.POSTCSS_RANGE);
   },
 
   async parse({
     asset,
-    config
+    config,
+    options
   }) {
-    if (!config) {
+    let isLegacy = await isLegacyCssModule(asset);
+
+    if (!config && !isLegacy) {
       return;
     }
 
+    const postcss = await loadPostcss(options, asset.filePath);
     return {
       type: 'postcss',
-      version: '7.0.0',
-      program: _postcss.default.parse((await asset.getCode()), {
+      version: '8.2.1',
+      program: postcss.parse(await asset.getCode(), {
         from: asset.filePath
-      })
+      }).toJSON()
     };
   },
 
   async transform({
     asset,
-    config
+    config,
+    options,
+    resolve
   }) {
+    asset.type = 'css';
+    let isLegacy = await isLegacyCssModule(asset);
+
+    if (isLegacy && !config) {
+      config = {
+        hydrated: {
+          plugins: [],
+          from: asset.filePath,
+          to: asset.filePath,
+          modules: {}
+        }
+      }; // TODO: warning?
+    }
+
     if (!config) {
       return [asset];
     }
 
-    let ast = (0, _nullthrows.default)(asset.ast);
-
-    if (COMPOSES_RE.test((await asset.getCode()))) {
-      ast.program.walkDecls(decl => {
-        let [, importPath] = FROM_IMPORT_RE.exec(decl.value) || [];
-
-        if (decl.prop === 'composes' && importPath != null) {
-          let parsed = (0, _postcssValueParser.default)(decl.value);
-          parsed.walk(node => {
-            if (node.type === 'string') {
-              asset.addDependency({
-                moduleSpecifier: importPath,
-                loc: {
-                  filePath: importPath,
-                  start: decl.source.start,
-                  end: {
-                    line: decl.source.start.line,
-                    column: decl.source.start.column + importPath.length
-                  }
-                }
-              });
-            }
-          });
-        }
+    const postcss = await loadPostcss(options, asset.filePath);
+    let ast = (0, _nullthrows().default)(await asset.getAST());
+    let program = postcss.fromJSON(ast.program);
+    let plugins = [...config.hydrated.plugins];
+    let cssModules = null;
+
+    if (config.hydrated.modules) {
+      asset.meta.cssModulesCompiled = true; // TODO: should this be resolved from the project root?
+
+      let postcssModules = await options.packageManager.require('postcss-modules', asset.filePath, {
+        range: '^4.3.0',
+        saveDev: true,
+        shouldAutoInstall: options.shouldAutoInstall
       });
-    }
+      plugins.push(postcssModules({
+        getJSON: (filename, json) => cssModules = json,
+        Loader: await createLoader(asset, resolve, options),
+        generateScopedName: (name, filename) => `${name}_${(0, _hash().hashString)(_path().default.relative(options.projectRoot, filename)).substr(0, 6)}`,
+        ...config.hydrated.modules
+      }));
+      let code = asset.isASTDirty() ? null : await asset.getCode();
+
+      if (code == null || COMPOSES_RE.test(code)) {
+        program.walkDecls(decl => {
+          let [, importPath] = FROM_IMPORT_RE.exec(decl.value) || [];
+
+          if (decl.prop === 'composes' && importPath != null) {
+            let parsed = (0, _postcssValueParser().default)(decl.value);
+            parsed.walk(node => {
+              if (node.type === 'string') {
+                asset.addDependency({
+                  specifier: importPath,
+                  specifierType: 'url',
+                  loc: {
+                    filePath: asset.filePath,
+                    start: decl.source.start,
+                    end: {
+                      line: decl.source.start.line,
+                      column: decl.source.start.column + importPath.length
+                    }
+                  }
+                });
+              }
+            });
+          }
+        });
+      }
+    } // $FlowFixMe Added in Flow 0.121.0 upgrade in #4381
+
 
     let {
       messages,
       root
-    } = await (0, _postcss.default)(config.plugins).process(ast.program, config);
-    ast.program = root;
-    ast.isDirty = true;
+    } = await postcss(plugins).process(program, config.hydrated);
+    asset.setAST({
+      type: 'postcss',
+      version: '8.2.1',
+      program: root.toJSON()
+    });
 
     for (let msg of messages) {
       if (msg.type === 'dependency') {
-        // $FlowFixMe merely a convention
-        msg = msg;
-        asset.addIncludedFile({
-          filePath: msg.file
+        asset.invalidateOnFileChange(msg.file);
+      } else if (msg.type === 'dir-dependency') {
+        var _msg$glob;
+
+        let pattern = `${msg.dir}/${(_msg$glob = msg.glob) !== null && _msg$glob !== void 0 ? _msg$glob : '**/*'}`;
+        let files = await (0, _utils().glob)(pattern, asset.fs, {
+          onlyFiles: true
+        });
+
+        for (let file of files) {
+          asset.invalidateOnFileChange(_path().default.normalize(file));
+        }
+
+        asset.invalidateOnFileCreate({
+          glob: pattern
         });
       }
     }
 
     let assets = [asset];
 
-    if (asset.meta.cssModules) {
-      let code = JSON.stringify(asset.meta.cssModules, null, 2);
-      let deps = asset.getDependencies().filter(dep => !dep.isURL);
+    if (cssModules) {
+      // $FlowFixMe
+      let cssModulesList = Object.entries(cssModules);
+      let deps = asset.getDependencies().filter(dep => dep.priority === 'sync');
+      let code;
 
       if (deps.length > 0) {
         code = `
-          module.exports = Object.assign({}, ${deps.map(dep => `require(${JSON.stringify(dep.moduleSpecifier)})`).join(', ')}, ${code});
+          module.exports = Object.assign({}, ${deps.map(dep => `require(${JSON.stringify(dep.specifier)})`).join(', ')}, ${JSON.stringify(cssModules, null, 2)});
         `;
       } else {
-        code = `module.exports = ${code};`;
+        code = cssModulesList.map( // This syntax enables shaking the invidual statements, so that unused classes don't even exist in JS.
+        ([className, classNameHashed]) => `module.exports[${JSON.stringify(className)}] = ${JSON.stringify(classNameHashed)};`).join('\n');
       }
 
+      asset.symbols.ensure();
+
+      for (let [k, v] of cssModulesList) {
+        asset.symbols.set(k, v);
+      }
+
+      asset.symbols.set('default', 'default');
       assets.push({
         type: 'js',
-        filePath: asset.filePath + '.js',
-        code
+        content: code
       });
     }
 
     return assets;
   },
 
-  generate({
-    asset
+  async generate({
+    asset,
+    ast,
+    options
   }) {
-    let ast = (0, _nullthrows.default)(asset.ast);
+    const postcss = await loadPostcss(options, asset.filePath);
     let code = '';
-
-    _postcss.default.stringify(ast.program, c => {
+    postcss.stringify(postcss.fromJSON(ast.program), c => {
       code += c;
     });
-
     return {
-      code
+      content: code
     };
   }
 
@@ -211,15 +283,18 @@ var _default = new _plugin.Transformer({
 
 exports.default = _default;
 
-function createLoader(asset, resolve) {
-  return class extends _fileSystemLoader.default {
+async function createLoader(asset, resolve, options) {
+  let {
+    default: FileSystemLoader
+  } = await options.packageManager.require('postcss-modules/build/css-loader-core/loader', asset.filePath);
+  return class extends FileSystemLoader {
     async fetch(composesPath, relativeTo) {
       let importPath = composesPath.replace(/^["']|["']$/g, '');
       let resolved = await resolve(relativeTo, importPath);
 
-      let rootRelativePath = _path.default.resolve(_path.default.dirname(relativeTo), resolved);
+      let rootRelativePath = _path().default.resolve(_path().default.dirname(relativeTo), resolved);
 
-      let root = _path.default.resolve('/'); // fixes an issue on windows which is part of the css-modules-loader-core
+      let root = _path().default.resolve('/'); // fixes an issue on windows which is part of the css-modules-loader-core
       // see https://github.com/css-modules/css-modules-loader-core/issues/230
 
 
@@ -230,7 +305,8 @@ function createLoader(asset, resolve) {
       let source = await asset.fs.readFile(resolved, 'utf-8');
       let {
         exportTokens
-      } = await this.core.load(source, rootRelativePath, undefined, this.fetch.bind(this));
+      } = await this.core.load(source, rootRelativePath, undefined, // $FlowFixMe[method-unbinding]
+      this.fetch.bind(this));
       return exportTokens;
     }
 
@@ -239,4 +315,21 @@ function createLoader(asset, resolve) {
     }
 
   };
+}
+
+function loadPostcss(options, from) {
+  return options.packageManager.require('postcss', from, {
+    range: _constants.POSTCSS_RANGE,
+    saveDev: true,
+    shouldAutoInstall: options.shouldAutoInstall
+  });
+}
+
+async function isLegacyCssModule(asset) {
+  if (!MODULE_BY_NAME_RE.test(asset.filePath)) {
+    return false;
+  }
+
+  let code = await asset.getCode();
+  return LEGACY_MODULE_RE.test(code);
 }

package/lib/constants.js

@@ -0,0 +1,8 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.POSTCSS_RANGE = void 0;
+const POSTCSS_RANGE = '^8.2.1';
+exports.POSTCSS_RANGE = POSTCSS_RANGE;

package/lib/loadConfig.js

@@ -0,0 +1,146 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.load = load;
+
+function _path() {
+  const data = _interopRequireDefault(require("path"));
+
+  _path = function () {
+    return data;
+  };
+
+  return data;
+}
+
+function _utils() {
+  const data = require("@parcel/utils");
+
+  _utils = function () {
+    return data;
+  };
+
+  return data;
+}
+
+function _nullthrows() {
+  const data = _interopRequireDefault(require("nullthrows"));
+
+  _nullthrows = function () {
+    return data;
+  };
+
+  return data;
+}
+
+function _clone() {
+  const data = _interopRequireDefault(require("clone"));
+
+  _clone = function () {
+    return data;
+  };
+
+  return data;
+}
+
+var _constants = require("./constants");
+
+var _loadPlugins = _interopRequireDefault(require("./loadPlugins"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+async function configHydrator(configFile, config, resolveFrom, options) {
+  if (configFile == null) {
+    return;
+  } // Load the custom config...
+
+
+  let modulesConfig;
+  let configFilePlugins = (0, _clone().default)(configFile.plugins);
+
+  if (configFilePlugins != null && typeof configFilePlugins === 'object' && configFilePlugins['postcss-modules'] != null) {
+    modulesConfig = configFilePlugins['postcss-modules'];
+    delete configFilePlugins['postcss-modules'];
+  }
+
+  if (!modulesConfig && configFile.modules) {
+    modulesConfig = {};
+  }
+
+  let plugins = await (0, _loadPlugins.default)(configFilePlugins, (0, _nullthrows().default)(resolveFrom), options); // contents is either:
+  // from JSON:    { plugins: { 'postcss-foo': { ...opts } } }
+  // from JS (v8): { plugins: [ { postcssPlugin: 'postcss-foo', ...visitor callback functions } ]
+  // from JS (v7): { plugins: [ [Function: ...] ]
+
+  let pluginArray = Array.isArray(configFilePlugins) ? configFilePlugins : Object.keys(configFilePlugins);
+
+  for (let p of pluginArray) {
+    if (typeof p === 'string') {
+      config.addDevDependency({
+        specifier: p,
+        resolveFrom: (0, _nullthrows().default)(resolveFrom)
+      });
+    }
+  }
+
+  return {
+    raw: configFile,
+    hydrated: {
+      plugins,
+      from: config.searchPath,
+      to: config.searchPath,
+      modules: modulesConfig
+    }
+  };
+}
+
+async function load({
+  config,
+  options,
+  logger
+}) {
+  if (!config.isSource) {
+    return;
+  }
+
+  let configFile = await config.getConfig(['.postcssrc', '.postcssrc.json', '.postcssrc.js', 'postcss.config.js'], {
+    packageKey: 'postcss'
+  });
+  let contents = null;
+
+  if (configFile) {
+    config.addDevDependency({
+      specifier: 'postcss',
+      resolveFrom: config.searchPath,
+      range: _constants.POSTCSS_RANGE
+    });
+    contents = configFile.contents;
+    let isDynamic = configFile && _path().default.extname(configFile.filePath) === '.js';
+
+    if (isDynamic) {
+      // We have to invalidate on startup in case the config is non-deterministic,
+      // e.g. using unknown environment variables, reading from the filesystem, etc.
+      logger.warn({
+        message: 'WARNING: Using a JavaScript PostCSS config file means losing out on caching features of Parcel. Use a .postcssrc(.json) file whenever possible.'
+      });
+      config.invalidateOnStartup(); // Also add the config as a dev dependency so we attempt to reload in watch mode.
+
+      config.addDevDependency({
+        specifier: (0, _utils().relativePath)(_path().default.dirname(config.searchPath), configFile.filePath),
+        resolveFrom: config.searchPath
+      });
+    }
+
+    if (typeof contents !== 'object') {
+      throw new Error('PostCSS config should be an object.');
+    }
+
+    if (contents.plugins == null || typeof contents.plugins !== 'object' || Object.keys(contents.plugins).length === 0) {
+      throw new Error('PostCSS config must have plugins');
+    }
+  }
+
+  return configHydrator(contents, config, configFile === null || configFile === void 0 ? void 0 : configFile.filePath, options);
+}

package/lib/loadPlugins.js

@@ -7,21 +7,23 @@ exports.default = loadExternalPlugins;
 
 async function loadExternalPlugins(plugins, relative, options) {
   if (Array.isArray(plugins)) {
-    return Promise.all(plugins.map(p => loadPlugin(p, relative, null, options.packageManager)).filter(Boolean));
+    return Promise.all(plugins.map(p => loadPlugin(p, relative, null, options.packageManager, options.shouldAutoInstall)).filter(Boolean));
   } else if (typeof plugins === 'object') {
-    let mapPlugins = await Promise.all(Object.keys(plugins).map(p => loadPlugin(p, relative, plugins[p], options.packageManager)));
+    let mapPlugins = await Promise.all(Object.keys(plugins).map(p => loadPlugin(p, relative, plugins[p], options.packageManager, options.shouldAutoInstall)));
     return mapPlugins.filter(Boolean);
   } else {
     return [];
   }
 }
 
-async function loadPlugin(pluginArg, relative, options = {}, packageManager) {
+async function loadPlugin(pluginArg, relative, options = {}, packageManager, shouldAutoInstall) {
   if (typeof pluginArg !== 'string') {
     return pluginArg;
   }
 
-  let plugin = await packageManager.require(pluginArg, relative);
+  let plugin = await packageManager.require(pluginArg, relative, {
+    shouldAutoInstall
+  });
   plugin = plugin.default || plugin;
 
   if (options != null && typeof options === 'object' && Object.keys(options).length > 0) {

package/package.json

@@ -1,10 +1,14 @@
 {
   "name": "@parcel/transformer-postcss",
-  "version": "2.0.0-nightly.101+fa36fe82",
+  "version": "2.0.0-nightly.1014+ef16fad82",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
   },
+  "funding": {
+    "type": "opencollective",
+    "url": "https://opencollective.com/parcel"
+  },
   "repository": {
     "type": "git",
     "url": "https://github.com/parcel-bundler/parcel.git"
@@ -12,17 +16,20 @@
   "main": "lib/PostCSSTransformer.js",
   "source": "src/PostCSSTransformer.js",
   "engines": {
-    "node": ">= 10.0.0",
-    "parcel": "^2.0.0-alpha.1.1"
+    "node": ">= 12.0.0",
+    "parcel": "2.0.0-nightly.1012+ef16fad82"
   },
   "dependencies": {
-    "@parcel/plugin": "2.0.0-nightly.101+fa36fe82",
-    "@parcel/utils": "2.0.0-nightly.101+fa36fe82",
-    "css-modules-loader-core": "^1.1.0",
+    "@parcel/hash": "2.3.3-nightly.2637+ef16fad82",
+    "@parcel/plugin": "2.0.0-nightly.1014+ef16fad82",
+    "@parcel/utils": "2.0.0-nightly.1014+ef16fad82",
+    "clone": "^2.1.1",
     "nullthrows": "^1.1.1",
-    "postcss": "^7.0.5",
-    "postcss-value-parser": "^3.3.1",
-    "semver": "^5.4.1"
+    "postcss-value-parser": "^4.2.0",
+    "semver": "^5.7.1"
+  },
+  "devDependencies": {
+    "postcss": "^8.4.5"
   },
-  "gitHead": "fa36fe822604e5bc19789cd5c1e89b090c3a7471"
+  "gitHead": "ef16fad82001dd112c4dd46d79dce47968bb10b8"
 }

package/src/PostCSSTransformer.js

@@ -1,212 +1,220 @@
 // @flow
 
-import type {FilePath, MutableAsset} from '@parcel/types';
+import type {FilePath, Asset, MutableAsset, PluginOptions} from '@parcel/types';
 
-import {md5FromString} from '@parcel/utils';
+import {hashString} from '@parcel/hash';
+import {glob} from '@parcel/utils';
 import {Transformer} from '@parcel/plugin';
-import FileSystemLoader from 'css-modules-loader-core/lib/file-system-loader';
 import nullthrows from 'nullthrows';
 import path from 'path';
-import postcss from 'postcss';
 import semver from 'semver';
 import valueParser from 'postcss-value-parser';
+import typeof * as Postcss from 'postcss';
 
-import loadPlugins from './loadPlugins';
+import {load} from './loadConfig';
+import {POSTCSS_RANGE} from './constants';
 
 const COMPOSES_RE = /composes:.+from\s*("|').*("|')\s*;?/;
 const FROM_IMPORT_RE = /.+from\s*(?:"|')(.*)(?:"|')\s*;?/;
+const LEGACY_MODULE_RE = /@value|(:global|:local)(?!\s*\()/i;
 const MODULE_BY_NAME_RE = /\.module\./;
 
-type ParcelPostCSSConfig = {
-  plugins: Array<mixed>,
-  from: FilePath,
-  to: FilePath,
-  ...
-};
-
-export default new Transformer({
-  async getConfig({asset, resolve, options}): Promise<?ParcelPostCSSConfig> {
-    let configFile: mixed = await asset.getConfig(
-      ['.postcssrc', '.postcssrc.json', '.postcssrc.js', 'postcss.config.js'],
-      {packageKey: 'postcss'},
-    );
+export default (new Transformer({
+  loadConfig({config, options, logger}) {
+    return load({config, options, logger});
+  },
 
-    // Use a basic, modules-only PostCSS config if the file opts in by a name
-    // like foo.module.css
-    if (configFile == null && asset.filePath.match(MODULE_BY_NAME_RE)) {
-      configFile = {
-        plugins: {
-          'postcss-modules': {},
-        },
-      };
-    }
+  canReuseAST({ast}) {
+    return (
+      ast.type === 'postcss' && semver.satisfies(ast.version, POSTCSS_RANGE)
+    );
+  },
 
-    if (configFile == null) {
+  async parse({asset, config, options}) {
+    let isLegacy = await isLegacyCssModule(asset);
+    if (!config && !isLegacy) {
       return;
     }
 
-    if (typeof configFile !== 'object') {
-      throw new Error('PostCSS config should be an object.');
-    }
+    const postcss = await loadPostcss(options, asset.filePath);
 
-    if (
-      configFile.plugins == null ||
-      typeof configFile.plugins !== 'object' ||
-      Object.keys(configFile.plugins) === 0
-    ) {
-      throw new Error('PostCSS config must have plugins');
+    return {
+      type: 'postcss',
+      version: '8.2.1',
+      program: postcss
+        .parse(await asset.getCode(), {
+          from: asset.filePath,
+        })
+        .toJSON(),
+    };
+  },
+
+  async transform({asset, config, options, resolve}) {
+    asset.type = 'css';
+    let isLegacy = await isLegacyCssModule(asset);
+    if (isLegacy && !config) {
+      config = {
+        hydrated: {
+          plugins: [],
+          from: asset.filePath,
+          to: asset.filePath,
+          modules: {},
+        },
+      };
+
+      // TODO: warning?
     }
 
-    let originalModulesConfig;
-    let configFilePlugins = configFile.plugins;
-    if (
-      configFilePlugins != null &&
-      typeof configFilePlugins === 'object' &&
-      configFilePlugins['postcss-modules'] != null
-    ) {
-      originalModulesConfig = configFilePlugins['postcss-modules'];
-      // $FlowFixMe
-      delete configFilePlugins['postcss-modules'];
+    if (!config) {
+      return [asset];
     }
 
-    let plugins = await loadPlugins(configFilePlugins, asset.filePath, options);
+    const postcss: Postcss = await loadPostcss(options, asset.filePath);
+    let ast = nullthrows(await asset.getAST());
+    let program = postcss.fromJSON(ast.program);
+
+    let plugins = [...config.hydrated.plugins];
+    let cssModules: ?{|[string]: string|} = null;
+    if (config.hydrated.modules) {
+      asset.meta.cssModulesCompiled = true;
 
-    if (originalModulesConfig || configFile.modules) {
+      // TODO: should this be resolved from the project root?
       let postcssModules = await options.packageManager.require(
         'postcss-modules',
         asset.filePath,
+        {
+          range: '^4.3.0',
+          saveDev: true,
+          shouldAutoInstall: options.shouldAutoInstall,
+        },
       );
 
       plugins.push(
         postcssModules({
-          getJSON: (filename, json) => (asset.meta.cssModules = json),
-          Loader: createLoader(asset, resolve),
-          generateScopedName: (name, filename, css) =>
-            `_${name}_${md5FromString(filename + css).substr(0, 5)}`,
-          ...originalModulesConfig,
+          getJSON: (filename, json) => (cssModules = json),
+          Loader: await createLoader(asset, resolve, options),
+          generateScopedName: (name, filename) =>
+            `${name}_${hashString(
+              path.relative(options.projectRoot, filename),
+            ).substr(0, 6)}`,
+          ...config.hydrated.modules,
         }),
       );
-    }
-
-    return {
-      plugins,
-      from: asset.filePath,
-      to: asset.filePath,
-    };
-  },
-
-  canReuseAST({ast}) {
-    return ast.type === 'postcss' && semver.satisfies(ast.version, '^7.0.0');
-  },
 
-  async parse({asset, config}) {
-    if (!config) {
-      return;
-    }
+      let code = asset.isASTDirty() ? null : await asset.getCode();
+      if (code == null || COMPOSES_RE.test(code)) {
+        program.walkDecls(decl => {
+          let [, importPath] = FROM_IMPORT_RE.exec(decl.value) || [];
+          if (decl.prop === 'composes' && importPath != null) {
+            let parsed = valueParser(decl.value);
 
-    return {
-      type: 'postcss',
-      version: '7.0.0',
-      program: postcss.parse(await asset.getCode(), {
-        from: asset.filePath,
-      }),
-    };
-  },
-
-  async transform({asset, config}) {
-    if (!config) {
-      return [asset];
-    }
-
-    let ast = nullthrows(asset.ast);
-    if (COMPOSES_RE.test(await asset.getCode())) {
-      ast.program.walkDecls(decl => {
-        let [, importPath] = FROM_IMPORT_RE.exec(decl.value) || [];
-        if (decl.prop === 'composes' && importPath != null) {
-          let parsed = valueParser(decl.value);
-
-          parsed.walk(node => {
-            if (node.type === 'string') {
-              asset.addDependency({
-                moduleSpecifier: importPath,
-                loc: {
-                  filePath: importPath,
-                  start: decl.source.start,
-                  end: {
-                    line: decl.source.start.line,
-                    column: decl.source.start.column + importPath.length,
+            parsed.walk(node => {
+              if (node.type === 'string') {
+                asset.addDependency({
+                  specifier: importPath,
+                  specifierType: 'url',
+                  loc: {
+                    filePath: asset.filePath,
+                    start: decl.source.start,
+                    end: {
+                      line: decl.source.start.line,
+                      column: decl.source.start.column + importPath.length,
+                    },
                   },
-                },
-              });
-            }
-          });
-        }
-      });
+                });
+              }
+            });
+          }
+        });
+      }
     }
 
-    let {messages, root} = await postcss(config.plugins).process(
-      ast.program,
-      config,
+    // $FlowFixMe Added in Flow 0.121.0 upgrade in #4381
+    let {messages, root} = await postcss(plugins).process(
+      program,
+      config.hydrated,
     );
-    ast.program = root;
-    ast.isDirty = true;
+    asset.setAST({
+      type: 'postcss',
+      version: '8.2.1',
+      program: root.toJSON(),
+    });
     for (let msg of messages) {
       if (msg.type === 'dependency') {
-        // $FlowFixMe merely a convention
-        msg = (msg: {|
-          type: 'dependency',
-          plugin: string,
-          file: string,
-          parent: string,
-        |});
-
-        asset.addIncludedFile({
-          filePath: msg.file,
-        });
+        asset.invalidateOnFileChange(msg.file);
+      } else if (msg.type === 'dir-dependency') {
+        let pattern = `${msg.dir}/${msg.glob ?? '**/*'}`;
+        let files = await glob(pattern, asset.fs, {onlyFiles: true});
+        for (let file of files) {
+          asset.invalidateOnFileChange(path.normalize(file));
+        }
+        asset.invalidateOnFileCreate({glob: pattern});
       }
     }
 
     let assets = [asset];
-    if (asset.meta.cssModules) {
-      let code = JSON.stringify(asset.meta.cssModules, null, 2);
-      let deps = asset.getDependencies().filter(dep => !dep.isURL);
+    if (cssModules) {
+      // $FlowFixMe
+      let cssModulesList = (Object.entries(cssModules): Array<
+        [string, string],
+      >);
+      let deps = asset.getDependencies().filter(dep => dep.priority === 'sync');
+      let code: string;
       if (deps.length > 0) {
         code = `
           module.exports = Object.assign({}, ${deps
-            .map(dep => `require(${JSON.stringify(dep.moduleSpecifier)})`)
-            .join(', ')}, ${code});
+            .map(dep => `require(${JSON.stringify(dep.specifier)})`)
+            .join(', ')}, ${JSON.stringify(cssModules, null, 2)});
         `;
       } else {
-        code = `module.exports = ${code};`;
+        code = cssModulesList
+          .map(
+            // This syntax enables shaking the invidual statements, so that unused classes don't even exist in JS.
+            ([className, classNameHashed]) =>
+              `module.exports[${JSON.stringify(className)}] = ${JSON.stringify(
+                classNameHashed,
+              )};`,
+          )
+          .join('\n');
       }
 
+      asset.symbols.ensure();
+      for (let [k, v] of cssModulesList) {
+        asset.symbols.set(k, v);
+      }
+      asset.symbols.set('default', 'default');
+
       assets.push({
         type: 'js',
-        filePath: asset.filePath + '.js',
-        code,
+        content: code,
       });
     }
     return assets;
   },
 
-  generate({asset}) {
-    let ast = nullthrows(asset.ast);
+  async generate({asset, ast, options}) {
+    const postcss: Postcss = await loadPostcss(options, asset.filePath);
 
     let code = '';
-    postcss.stringify(ast.program, c => {
+    postcss.stringify(postcss.fromJSON(ast.program), c => {
       code += c;
     });
 
     return {
-      code,
+      content: code,
     };
   },
-});
+}): Transformer);
 
-function createLoader(
+async function createLoader(
   asset: MutableAsset,
   resolve: (from: FilePath, to: string) => Promise<FilePath>,
+  options: PluginOptions,
 ) {
+  let {default: FileSystemLoader} = await options.packageManager.require(
+    'postcss-modules/build/css-loader-core/loader',
+    asset.filePath,
+  );
   return class ParcelFileSystemLoader extends FileSystemLoader {
     async fetch(composesPath, relativeTo) {
       let importPath = composesPath.replace(/^["']|["']$/g, '');
@@ -224,6 +232,7 @@ function createLoader(
         source,
         rootRelativePath,
         undefined,
+        // $FlowFixMe[method-unbinding]
         this.fetch.bind(this),
       );
       return exportTokens;
@@ -234,3 +243,20 @@ function createLoader(
     }
   };
 }
+
+function loadPostcss(options: PluginOptions, from: FilePath): Promise<Postcss> {
+  return options.packageManager.require('postcss', from, {
+    range: POSTCSS_RANGE,
+    saveDev: true,
+    shouldAutoInstall: options.shouldAutoInstall,
+  });
+}
+
+async function isLegacyCssModule(asset: Asset | MutableAsset) {
+  if (!MODULE_BY_NAME_RE.test(asset.filePath)) {
+    return false;
+  }
+
+  let code = await asset.getCode();
+  return LEGACY_MODULE_RE.test(code);
+}

package/src/constants.js

@@ -0,0 +1,3 @@
+// @flow
+
+export const POSTCSS_RANGE = '^8.2.1';

package/src/loadConfig.js

@@ -0,0 +1,147 @@
+// @flow
+import type {
+  Config,
+  FilePath,
+  PluginOptions,
+  PluginLogger,
+} from '@parcel/types';
+import path from 'path';
+import {relativePath} from '@parcel/utils';
+import nullthrows from 'nullthrows';
+import clone from 'clone';
+import {POSTCSS_RANGE} from './constants';
+
+import loadExternalPlugins from './loadPlugins';
+
+type ConfigResult = {|
+  raw: any,
+  hydrated: {|
+    plugins: Array<any>,
+    from: FilePath,
+    to: FilePath,
+    modules: any,
+  |},
+|};
+
+async function configHydrator(
+  configFile: any,
+  config: Config,
+  resolveFrom: ?FilePath,
+  options: PluginOptions,
+): Promise<?ConfigResult> {
+  if (configFile == null) {
+    return;
+  }
+
+  // Load the custom config...
+  let modulesConfig;
+  let configFilePlugins = clone(configFile.plugins);
+  if (
+    configFilePlugins != null &&
+    typeof configFilePlugins === 'object' &&
+    configFilePlugins['postcss-modules'] != null
+  ) {
+    modulesConfig = configFilePlugins['postcss-modules'];
+    delete configFilePlugins['postcss-modules'];
+  }
+
+  if (!modulesConfig && configFile.modules) {
+    modulesConfig = {};
+  }
+
+  let plugins = await loadExternalPlugins(
+    configFilePlugins,
+    nullthrows(resolveFrom),
+    options,
+  );
+
+  // contents is either:
+  // from JSON:    { plugins: { 'postcss-foo': { ...opts } } }
+  // from JS (v8): { plugins: [ { postcssPlugin: 'postcss-foo', ...visitor callback functions } ]
+  // from JS (v7): { plugins: [ [Function: ...] ]
+  let pluginArray = Array.isArray(configFilePlugins)
+    ? configFilePlugins
+    : Object.keys(configFilePlugins);
+  for (let p of pluginArray) {
+    if (typeof p === 'string') {
+      config.addDevDependency({
+        specifier: p,
+        resolveFrom: nullthrows(resolveFrom),
+      });
+    }
+  }
+
+  return {
+    raw: configFile,
+    hydrated: {
+      plugins,
+      from: config.searchPath,
+      to: config.searchPath,
+      modules: modulesConfig,
+    },
+  };
+}
+
+export async function load({
+  config,
+  options,
+  logger,
+}: {|
+  config: Config,
+  options: PluginOptions,
+  logger: PluginLogger,
+|}): Promise<?ConfigResult> {
+  if (!config.isSource) {
+    return;
+  }
+
+  let configFile: any = await config.getConfig(
+    ['.postcssrc', '.postcssrc.json', '.postcssrc.js', 'postcss.config.js'],
+    {packageKey: 'postcss'},
+  );
+
+  let contents = null;
+  if (configFile) {
+    config.addDevDependency({
+      specifier: 'postcss',
+      resolveFrom: config.searchPath,
+      range: POSTCSS_RANGE,
+    });
+
+    contents = configFile.contents;
+    let isDynamic = configFile && path.extname(configFile.filePath) === '.js';
+    if (isDynamic) {
+      // We have to invalidate on startup in case the config is non-deterministic,
+      // e.g. using unknown environment variables, reading from the filesystem, etc.
+      logger.warn({
+        message:
+          'WARNING: Using a JavaScript PostCSS config file means losing out on caching features of Parcel. Use a .postcssrc(.json) file whenever possible.',
+      });
+
+      config.invalidateOnStartup();
+
+      // Also add the config as a dev dependency so we attempt to reload in watch mode.
+      config.addDevDependency({
+        specifier: relativePath(
+          path.dirname(config.searchPath),
+          configFile.filePath,
+        ),
+        resolveFrom: config.searchPath,
+      });
+    }
+
+    if (typeof contents !== 'object') {
+      throw new Error('PostCSS config should be an object.');
+    }
+
+    if (
+      contents.plugins == null ||
+      typeof contents.plugins !== 'object' ||
+      Object.keys(contents.plugins).length === 0
+    ) {
+      throw new Error('PostCSS config must have plugins');
+    }
+  }
+
+  return configHydrator(contents, config, configFile?.filePath, options);
+}

package/src/loadPlugins.js

@@ -11,14 +11,28 @@ export default async function loadExternalPlugins(
   if (Array.isArray(plugins)) {
     return Promise.all(
       plugins
-        .map(p => loadPlugin(p, relative, null, options.packageManager))
+        .map(p =>
+          loadPlugin(
+            p,
+            relative,
+            null,
+            options.packageManager,
+            options.shouldAutoInstall,
+          ),
+        )
         .filter(Boolean),
     );
   } else if (typeof plugins === 'object') {
     let _plugins = plugins;
     let mapPlugins = await Promise.all(
       Object.keys(plugins).map(p =>
-        loadPlugin(p, relative, _plugins[p], options.packageManager),
+        loadPlugin(
+          p,
+          relative,
+          _plugins[p],
+          options.packageManager,
+          options.shouldAutoInstall,
+        ),
       ),
     );
     return mapPlugins.filter(Boolean);
@@ -32,12 +46,15 @@ async function loadPlugin(
   relative: FilePath,
   options: mixed = {},
   packageManager: PackageManager,
+  shouldAutoInstall: boolean,
 ): mixed {
   if (typeof pluginArg !== 'string') {
     return pluginArg;
   }
 
-  let plugin = await packageManager.require(pluginArg, relative);
+  let plugin = await packageManager.require(pluginArg, relative, {
+    shouldAutoInstall,
+  });
   plugin = plugin.default || plugin;
 
   if (