{"id":21956,"library":"rollup-plugin-combine","title":"rollup-plugin-combine","description":"A Rollup plugin that merges multiple JavaScript files into a single output, supporting both library and application builds. The current stable version is 2.1.1, released with a moderate cadence. It differentiates from similar plugins by offering fine-grained control over file ordering and custom transforms during concatenation. However, it lacks TypeScript support and is primarily used in legacy workflows where bundle splitting is not required.","status":"active","version":"2.1.1","language":"javascript","source_language":"en","source_url":"https://github.com/fengxinming/rollup-plugins/tree/master/packages/rollup-plugin-combine2.x","tags":["javascript","rollup","plugin"],"install":[{"cmd":"npm install rollup-plugin-combine","lang":"bash","label":"npm"},{"cmd":"yarn add rollup-plugin-combine","lang":"bash","label":"yarn"},{"cmd":"pnpm add rollup-plugin-combine","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"The default export is a function; named exports are not available.","wrong":"import { combine } from 'rollup-plugin-combine'","symbol":"default","correct":"import combine from 'rollup-plugin-combine'"},{"note":"CommonJS require returns the default export.","wrong":"const { combine } = require('rollup-plugin-combine')","symbol":"default","correct":"const combine = require('rollup-plugin-combine')"},{"note":"TypeScript users can import the options type for type safety, available since v2.","wrong":"","symbol":"type CombineOptions","correct":"import type { CombineOptions } from 'rollup-plugin-combine'"}],"quickstart":{"code":"// rollup.config.js\nimport combine from 'rollup-plugin-combine';\n\nexport default {\n  input: 'src/index.js',\n  output: {\n    dir: 'dist',\n    format: 'esm'\n  },\n  plugins: [\n    combine({\n      files: ['src/utils.js', 'src/main.js'],\n      output: 'dist/bundle.js'\n    })\n  ]\n};","lang":"javascript","description":"Combines two input files into a single output file using the plugin."},"warnings":[{"fix":"Use alternative plugin with source map support or disable source maps in Rollup.","message":"Plugin does not support source maps; combining files may break debugging experience.","severity":"gotcha","affected_versions":"<3.0.0"},{"fix":"Rename 'files' to 'include' in plugin options.","message":"Option 'files' is deprecated, use 'include' instead.","severity":"deprecated","affected_versions":">=1.0.0 <2.0.0"},{"fix":"Ensure 'output' is provided in plugin options.","message":"In v2, output option is required; previous versions allowed omission.","severity":"breaking","affected_versions":">=2.0.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Use 'import combine from 'rollup-plugin-combine'' instead of 'import { combine } from ...'","cause":"Using named import instead of default import.","error":"TypeError: combine is not a function"},{"fix":"Add 'output' property to the plugin options, e.g., output: 'bundle.js'","cause":"Missing required 'output' option in plugin configuration.","error":"Error: The 'output' option must be specified."},{"fix":"Run 'npm install rollup-plugin-combine' and ensure it's in your package.json.","cause":"Package not installed or missing from dependencies.","error":"Module not found: Can't resolve 'rollup-plugin-combine'"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}