{"id":25118,"library":"constellate-plugin-compiler-webpack","title":"Constellate Webpack Compiler Plugin","description":"A Webpack-based compiler plugin for Constellate bundling toolchain. Version 0.14.0 integrates with Constellate's pipeline to handle Webpack compilation and code splitting. Maintained as part of the Constellate monorepo with sporadic releases. Differentiates from other Webpack wrappers by being tightly coupled to Constellate's declarative configuration and plugin system.","status":"active","version":"0.14.0","language":"javascript","source_language":"en","source_url":null,"tags":["javascript"],"install":[{"cmd":"npm install constellate-plugin-compiler-webpack","lang":"bash","label":"npm"},{"cmd":"yarn add constellate-plugin-compiler-webpack","lang":"bash","label":"yarn"},{"cmd":"pnpm add constellate-plugin-compiler-webpack","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Peer dependency for compilation","package":"webpack","optional":false},{"reason":"Core pipeline integration","package":"constellate","optional":false}],"imports":[{"note":"ESM-only package, no CommonJS export","wrong":"const WebpackCompilerPlugin = require('constellate-plugin-compiler-webpack')","symbol":"WebpackCompilerPlugin","correct":"import { WebpackCompilerPlugin } from 'constellate-plugin-compiler-webpack'"},{"note":"CJS require works via auto-wrapped ESM in Node 12+, but not recommended","wrong":null,"symbol":"WebpackCompilerPlugin","correct":"const { WebpackCompilerPlugin } = require('constellate-plugin-compiler-webpack')"},{"note":"Default export is a class, use named import for clarity","wrong":"import { default } from 'constellate-plugin-compiler-webpack'","symbol":"default","correct":"import WebpackCompilerPlugin from 'constellate-plugin-compiler-webpack'"}],"quickstart":{"code":"import { WebpackCompilerPlugin } from 'constellate-plugin-compiler-webpack';\nimport { Project } from 'constellate';\n\nconst project = new Project({\n  root: process.cwd(),\n  plugins: [\n    new WebpackCompilerPlugin({\n      webpackConfig: {\n        output: { filename: 'bundle.js' },\n        mode: 'production'\n      }\n    })\n  ]\n});\n\nawait project.compile();","lang":"typescript","description":"Shows how to instantiate the Webpack compiler plugin with custom Webpack config and compile a Constellate project."},"warnings":[{"fix":"Provide a `webpackConfig` object to the constructor.","message":"Version 0.14.0 changes the plugin constructor signature; `webpackConfig` is now required instead of optional.","severity":"breaking","affected_versions":">=0.14.0"},{"fix":"Use `webpackConfig.devServer.hot: true` instead.","message":"The `enableHMR` option is deprecated in favor of setting `webpackConfig.devServer.hot`.","severity":"deprecated","affected_versions":">=0.12.0"},{"fix":"Ensure Webpack 5 is installed as a peer dependency.","message":"Plugin requires Webpack 5; using Webpack 4 will cause silent failures.","severity":"gotcha","affected_versions":">=0.10.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run `npm install constellate-plugin-compiler-webpack` and ensure correct import.","cause":"Package not installed or incorrect import path.","error":"Error: Cannot find module 'constellate-plugin-compiler-webpack'"},{"fix":"Use `import { WebpackCompilerPlugin } from 'constellate-plugin-compiler-webpack'`.","cause":"Using default import without named import or incorrect bundler configuration.","error":"TypeError: WebpackCompilerPlugin is not a constructor"},{"fix":"Add a `webpackConfig` object to the plugin constructor.","cause":"Missing webpackConfig in constructor options (breaking change in 0.14.0).","error":"Configuration error: 'webpackConfig' is required"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}