{"id":21979,"library":"rollup-plugin-css-text","title":"rollup-plugin-css-text","description":"A Rollup plugin that generates JavaScript files exporting CSS file contents as strings, paired with TypeScript declaration files. Version 1.0.3, stable, no recent updates. Designed for library authors needing to export CSS text for SSR-compatible CSS-in-JS (e.g., styled-components, Emotion). Unlike typical CSS extraction plugins, it creates companion .css-text.js files alongside original CSS files, preserving both. Requires Rollup >=2.61.1, and a separate CSS plugin (e.g., rollup-plugin-postcss) for actual CSS handling.","status":"active","version":"1.0.3","language":"javascript","source_language":"en","source_url":"https://github.com/amjedomar/rollup-plugin-css-text","tags":["javascript","rollup","rollup-plugin","css","js","text","typescript"],"install":[{"cmd":"npm install rollup-plugin-css-text","lang":"bash","label":"npm"},{"cmd":"yarn add rollup-plugin-css-text","lang":"bash","label":"yarn"},{"cmd":"pnpm add rollup-plugin-css-text","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"peer dependency, version >=2.61.1","package":"rollup","optional":false}],"imports":[{"note":"Default export only; package is ESM-first, no CommonJS named export.","wrong":"const cssText = require('rollup-plugin-css-text')","symbol":"cssText","correct":"import cssText from 'rollup-plugin-css-text'"},{"note":"Type-only import for TypeScript users; available since 1.0.2.","wrong":null,"symbol":"CssTextOptions","correct":"import type { CssTextOptions } from 'rollup-plugin-css-text'"},{"note":"Option to include CSS comments in output; false by default.","wrong":null,"symbol":"includeComments","correct":"cssText({ includeComments: true })"}],"quickstart":{"code":"import postcss from 'rollup-plugin-postcss';\nimport cssText from 'rollup-plugin-css-text';\n\nexport default {\n  input: 'src/index.js',\n  output: {\n    dir: 'dist',\n    format: 'cjs',\n    exports: 'named'\n  },\n  plugins: [\n    postcss({ extract: true }),\n    cssText({ tsDeclaration: false })\n  ]\n};","lang":"javascript","description":"Shows typical usage with rollup-plugin-postcss, outputting CJS with named exports, disabling TS declarations."},"warnings":[{"fix":"Place a CSS plugin (e.g., rollup-plugin-postcss with extract: true) before css-text in the plugins array.","message":"Plugin does not handle CSS loading/minification; it only processes already-extracted CSS files in the output directory.","severity":"gotcha","affected_versions":">=1.0.2"},{"fix":"Use output.dir instead of output.file in Rollup config.","message":"Requires output.dir to be set; does not work with output.file.","severity":"gotcha","affected_versions":">=1.0.2"},{"fix":"Upgrade to >=1.0.3 to use includeComments.","message":"The option 'includeComments' was added in 1.0.3; earlier versions ignore it.","severity":"breaking","affected_versions":"<1.0.3"},{"fix":"Evaluate if active maintenance is needed; consider alternatives if new features required.","message":"No deprecated features known; but the plugin is minimally maintained (last release 2023).","severity":"deprecated","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Add output.dir to rollup config (e.g., output: { dir: 'dist', ... }).","cause":"output.dir not specified in Rollup config.","error":"Error: output.dir must be set when using rollup-plugin-css-text"},{"fix":"Use import cssText from 'rollup-plugin-css-text' (ESM) or use dynamic import if in CommonJS.","cause":"Using CommonJS require instead of ESM import.","error":"TypeError: cssText is not a function"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}