# remap-css

**Repository Path**: mirrors_silverwind/remap-css

## Basic Information

- **Project Name**: remap-css
- **Description**: Remap CSS rules based on declaration value
- **Primary Language**: Unknown
- **License**: BSD-2-Clause
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-25
- **Last Updated**: 2026-08-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# remap-css
[![](https://img.shields.io/npm/v/remap-css.svg?style=flat)](https://www.npmjs.org/package/remap-css) [![](https://img.shields.io/npm/dm/remap-css.svg)](https://www.npmjs.org/package/remap-css) [![](https://packagephobia.com/badge?p=remap-css)](https://packagephobia.com/result?p=remap-css)
> Remap CSS rules based on declaration value

## Usage

```bash
npm i remap-css
```

```js
import remapCss from "remap-css";

const css = await remapCss([{
  css: `
    a {
      color: red;
    }
  `}
], {
  "color: red": "color: blue"
});
// a {
//   color: blue;
// }
```

## API
### `remapCss(sources, mappings, [opts])`

Returns a `Promise` that resolves to a CSS string.

- `sources`: *Array* Array of sources
  - `source`: *Object*
    - `css`: *string* A CSS string
    - `prefix`: *string* A CSS selector to be prefixed to all output rules
    - `match`: *string* A array of plain CSS selectors that prevent a prefix addition on exact match
    - `name`: *string* Optional name used in comments
- `mappings`: *Object* CSS declaration value-to-value mapping. The key is either a exact match CSS declaration or a special rule starting with `$`. The value is the a replacement declaration or a replacement value in the case of a special rule.
- `options`: *Object*
  - `indentSize`: *number* Numbers of spaces to indent rules and declarations. Default: `2`.
  - `indentCss`: *number* Numbers of spaces to indent the output. Default: `0`.
  - `lineLength`: *number* Number of characters after which to wrap lines. Default: `80`.
  - `ignoreSelectors`: *Array* of *RegExp* Regular expressions of selectors to ignore. Default: `[]`.
  - `comments`: *boolean* Whether to output comments. Default: `false`.
  - `stylistic`: *boolean* Whether to perform stylistic tweaks on selectors. Default: `false`.
  - `validate`: *boolean* Validate properties and discard ones that fail. Default: `false`.
  - `keep`: *boolean* Retain non-matching declarations in the output. Default: `false`.

These special mapping keys supported:

- `$border: value`: Any occurance of `value` in a `border` rule.
- `$background: value` Any occurance of `value` in a `background` rule.
- `$box-shadow: value` Any occurance of `value` in a `box-shadow` rule.
- `$value: value`: Any occurance of `value`.

On special rules, only specify the replacement value alone (not the whole declaration).

## Related

- [fetch-css](https://github.com/silverwind/fetch-css) - Extract CSS from websites and browser extensions

© [silverwind](https://github.com/silverwind), distributed under BSD licence