{"id":21898,"library":"rollup-copy-transform-css","title":"rollup-copy-transform-css","description":"Rollup plugin utility for transforming CSS files during copy operations with rollup-plugin-copy. Current stable version is 2.2.0, released November 2025, with support for Rollup 2, 3, and 4. Provides CSS minification via cssnano or esbuild, stylesheet and asset inlining via postcss-import and postcss-url, and custom PostCSS plugin pipelines. Key differentiators: supports both PostCSS and esbuild engines for fast processing, integrates seamlessly with rollup-plugin-copy targets, and offers source map generation. Requires Node.js 18+ as of v2.0.0.","status":"active","version":"2.2.0","language":"javascript","source_language":"en","source_url":"https://github.com/prantlf/rollup-copy-transform-css","tags":["javascript","rollup","plugin","rollup-plugin","copy","transform","css","stylesheets","minify"],"install":[{"cmd":"npm install rollup-copy-transform-css","lang":"bash","label":"npm"},{"cmd":"yarn add rollup-copy-transform-css","lang":"bash","label":"yarn"},{"cmd":"pnpm add rollup-copy-transform-css","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"peer dependency; required as the primary copy plugin that uses the transforms generated by this package","package":"rollup-plugin-copy","optional":false}],"imports":[{"note":"ESM-only since v2; CJS require may fail or produce undefined","wrong":"const { createTransform } = require('rollup-copy-transform-css')","symbol":"createTransform","correct":"import { createTransform } from 'rollup-copy-transform-css'"},{"note":"No default export; only named export createTransform is available","wrong":"import createTransform from 'rollup-copy-transform-css'","symbol":"default","correct":"import { createTransform } from 'rollup-copy-transform-css'"},{"note":"rollup-plugin-copy uses default export","wrong":"import { copy } from 'rollup-plugin-copy'","symbol":"copy plugin","correct":"import copy from 'rollup-plugin-copy'"}],"quickstart":{"code":"import copy from 'rollup-plugin-copy';\nimport { createTransform } from 'rollup-copy-transform-css';\n\nconst transformCss = createTransform({\n  inline: false,\n  minify: true,\n  map: { inline: false }\n});\n\nexport default {\n  input: 'src/index.js',\n  output: {\n    file: 'dist/bundle.js',\n    format: 'iife'\n  },\n  plugins: [\n    copy({\n      targets: [\n        {\n          src: 'src/styles/main.css',\n          dest: 'dist/styles',\n          transform: transformCss\n        }\n      ]\n    })\n  ]\n};","lang":"javascript","description":"Basic Rollup config using rollup-plugin-copy with transform that minifies CSS and generates an external source map."},"warnings":[{"fix":"Upgrade Node.js to version 18 or later","message":"Node.js 18 is required","severity":"breaking","affected_versions":">=2.0.0"},{"fix":"Use import syntax instead of require; set type: 'module' in package.json","message":"ESM-only: no CommonJS support","severity":"breaking","affected_versions":">=2.0.0"},{"fix":"Set minify: { fast: true } or inline: { fast: true } to use esbuild; test output carefully","message":"Experimental esbuild engine may produce different output than PostCSS","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Ensure map option is set to boolean or object in createTransform or transform call","message":"Source map generation may be silently ignored if not explicitly configured","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Use dynamic import: const { createTransform } = await import('rollup-copy-transform-css');","cause":"Using require() on this package which is ESM-only since v2","error":"Error [ERR_REQUIRE_ESM]: require() of ES Module not supported"},{"fix":"Use import { createTransform } from 'rollup-copy-transform-css'","cause":"Importing default export incorrectly instead of named export createTransform","error":"TypeError: createTransform is not a function"},{"fix":"Install rollup-plugin-copy alongside this package: npm i -D rollup-plugin-copy","cause":"Missing required peer dependency rollup-plugin-copy","error":"Error: rollup-plugin-copy is not installed"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}