Registry / web-framework / rollup-plugin-css-text

rollup-plugin-css-text

library1.0.3jsnpmunverified

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.

web-framework serialization

npm install rollup-plugin-css-text

github ↗package ↗

INSTALL

IMPORT

SIG · ROLLUP-PLUGIN-CSS-

rollup-plugin-css-text

web-frameworkjavascriptv1.0.3

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–223 runs

build_error

glibc

node 18–223 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

cssText

✓ import cssText from 'rollup-plugin-css-text'

✗ const cssText = require('rollup-plugin-css-text')

Default export only; package is ESM-first, no CommonJS named export.

CssTextOptions

✓ import type { CssTextOptions } from 'rollup-plugin-css-text'

Type-only import for TypeScript users; available since 1.0.2.

includeComments

✓ cssText({ includeComments: true })

Option to include CSS comments in output; false by default.

Shows typical usage with rollup-plugin-postcss, outputting CJS with named exports, disabling TS declarations.

import postcss from 'rollup-plugin-postcss'; import cssText from 'rollup-plugin-css-text'; export default { input: 'src/index.js', output: { dir: 'dist', format: 'cjs', exports: 'named' }, plugins: [ postcss({ extract: true }), cssText({ tsDeclaration: false }) ] };

Debug

Known issues

gotchaPlugin does not handle CSS loading/minification; it only processes already-extracted CSS files in the output directory.

fix

Place a CSS plugin (e.g., rollup-plugin-postcss with extract: true) before css-text in the plugins array.

affects: >=1.0.2

gotchaRequires output.dir to be set; does not work with output.file.

fix

Use output.dir instead of output.file in Rollup config.

affects: >=1.0.2

breakingThe option 'includeComments' was added in 1.0.3; earlier versions ignore it.

fix

Upgrade to >=1.0.3 to use includeComments.

affects: <1.0.3

deprecatedNo deprecated features known; but the plugin is minimally maintained (last release 2023).

fix

Evaluate if active maintenance is needed; consider alternatives if new features required.

affects: all

Errors

Common errors & fixes

Error: output.dir must be set when using rollup-plugin-css-text

output.dir not specified in Rollup config.

fix

Add output.dir to rollup config (e.g., output: { dir: 'dist', ... }).

TypeError: cssText is not a function

Using CommonJS require instead of ESM import.

fix

Use import cssText from 'rollup-plugin-css-text' (ESM) or use dynamic import if in CommonJS.

Upgrade

Version history

1.0.3latest on npm

Audit

Dependencies

rolluprequiredpeer dependency, version >=2.61.1

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/amjedomar/rollup-plugin-css-text ↗

packagehttps://www.npmjs.com/package/rollup-plugin-css-text ↗