Nagging Penguin Matriarchs

    sourcemap-updater

    0.1.1 • Public • Published

    sourcemap-updater

    Build Status

    A tool help to modify css and update sourcemap automatically.

    Assume that you have a css (maybe generated via sass/postcss) and a corresponding sourcemap. If you want to modify the css (such as delete one declaration, change a prop value), you could modify directly, but the sourcemap would be inaccurate.

    This lib will help you modify css (more convenient/powerful), and update sourcemap automatically. This means you no longer need to care about sourcemap when you modify css.

    Installation and Usage

    npm i --save sourcemap-updater

    And then

    const update = require('sourcemap-updater')
     
    const res = update([
        readFileSync(`${__dirname}/res/concated.css`),
        readFileSync(`${__dirname}/res/concated.css.map`)
    ], {
        updater (str, node, type) {
            // for `prop-value`s, remove all newline of value.
            if (!type && node && node.prop) {
                node.value = node.value.replace(/\s*\n\s*/g, '')
                return node.toString() + ';'
            }
            return false
        }
    })
     
    writeFileSync(`${__dirname}/res/concated.css`, res.css)
    writeFileSync(`${__dirname}/res/concated.css.map`, res.map)

    API

    update(data[, options])

    • data is Array, data[0] is css content (String/Buffer), and data[1] is original sourcemap (String/Buffer/Object).

    • options is Object. And options.updater is Function, options.file is String

      options.updater is like function(str, node, type){}, is the same as postcss/builder. You can use it to change css. For the return value of the func:

        1. If you return `false`, this part string would keep the same.
        2. If you return `String`, this `string` will be used (as the replacement).
        3. Otherwise, this part string will be deleted.
      

      options.file is String, the relative file path of the css content. It will be used when original sourcemap is invalid.

    License

    MIT

    Keywords

    Install

    npm i sourcemap-updater

    DownloadsWeekly Downloads

    3

    Version

    0.1.1

    License

    MIT

    Last publish

    Collaborators

    • creeper