Registry / devops / rollup-plugin-keep-css-imports

rollup-plugin-keep-css-imports

library1.0.0jsnpmunverified

Rollup plugin that preserves CSS, SCSS, and SASS import statements unchanged during bundling. Version 1.0.0, actively maintained. Useful for component libraries where consumers need to handle CSS bundling themselves. Supports custom output paths, extensions, source maps, and PostCSS compatibility. Differentiates by keeping imports untouched rather than bundling or extracting CSS.

devops

npm install rollup-plugin-keep-css-imports

github ↗package ↗

INSTALL

IMPORT

SIG · ROLLUP-PLUGIN-KEEP

rollup-plugin-keep-css-imports

devopsjavascriptv1.0.0

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.

keepCssImports

✓ import keepCssImports from 'rollup-plugin-keep-css-imports'

✗ const keepCssImports = require('rollup-plugin-keep-css-imports')

Default export, ESM only. CommonJS require will fail as package is type: module.

keepCssImports

✓ import keepCssImports from 'rollup-plugin-keep-css-imports'; keepCssImports({...})

✗ import { keepCssImports } from 'rollup-plugin-keep-css-imports'

Named export does not exist. Only default export.

keepCssImports (TypeScript)

✓ import keepCssImports from 'rollup-plugin-keep-css-imports'; keepCssImports({...})

TypeScript types are bundled. Use default import.

Shows a basic Rollup configuration using keepCssImports plugin with default options to preserve CSS imports.

// rollup.config.js import keepCssImports from 'rollup-plugin-keep-css-imports'; export default { input: 'src/index.js', output: { file: 'dist/bundle.js', format: 'esm', }, plugins: [ keepCssImports({ includeRegexp: /\.(?:s[ca]|c)ss$/, outputExt: '.css', outputDir: 'dist/styles', outputPath: 'keep', sourceMap: false, skipCurrentFolderPart: false, }), ], };

Debug

Known issues

gotchaPlugin requires Rollup to be installed as peer dependency.

fix

Ensure rollup is installed: npm install rollup --save-dev.

affects: >=1.0.0

gotchaoutputPath option 'keep' only preserves the original relative path if the input file is under the current working directory. If using absolute paths or paths outside cwd, behavior may be unexpected.

fix

Use a custom function to generate output paths explicitly.

affects: >=1.0.0

gotchaSource maps are only generated when sourceMap option is true or 'inline'. Default is false, no source maps.

fix

Set sourceMap: true or sourceMap: 'inline' if source maps are needed.

affects: >=1.0.0

Errors

Common errors & fixes

Error [ERR_MODULE_NOT_FOUND]: Cannot find package 'rollup-plugin-keep-css-imports' imported from ...

Package not installed or not in node_modules.

fix

Run npm install rollup-plugin-keep-css-imports --save-dev.

TypeError: keepCssImports is not a function

Using named import instead of default import.

fix

Use import keepCssImports from 'rollup-plugin-keep-css-imports' (without braces).

Plugin could not be loaded: Error [ERR_REQUIRE_ESM]

Attempted to require() an ES module package.

fix

Use import instead of require, or set "type": "module" in package.json.

Upgrade

Version history

1.0.0latest on npm

Audit

Dependencies

@rollup/pluginutilsrequiredUsed for creating filter and reading/writing files

sassoptionalOptional peer dependency for SCSS/SASS compilation

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/SLTKA/rollup-plugin-keep-css-imports ↗

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