remap-css

Remap CSS rules based on declaration value

Usage

npm i remap-css

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 - Extract CSS from websites and browser extensions

© silverwind, distributed under BSD licence