@prebuilder/rollup-plugin NPM

Prebuilder rollup plugin

C# like preprocessor directives for javascript

Install

npm i --save-dev @prebuilder/rollup-plugin

Usage

rollup.config.js :

import prebuilder from '@prebuilder/rollup-plugin';

let myDefines = [ 'MY_DIRECTIVE' ]

export default {
    input: "** your input **",
    output: {
        file: "** your output **",
    },
    plugins: [
        prebuilder({ defines: myDefines }),
    ],
}

source code :

class MyClass {

// if else directives:
#if MY_DIRECTIVE
    myFunction = (data) => {
        return data;
    }
#else
    myFunction = (differentData) => {
        return differentData;
    }
#endif

// commented mode & #if negative check:
//#if !MY_DIRECTIVE
    myVar = {
        number: 0
    };
//#else
    //#post-code myVar = {
    //#post-code     number: 5
    //#post-code };
//#endif

}

output code :

class MyClass {

    myFunction = (data) => {
        return data;
    }

    myVar = {
        number: 5
    };
}

Options

defines

Required. Type: Array<string>

List of defines based on which to validate #if statements.

include

Type: string || Array<string>

One or a list of script names to process, all other files will be ignored.

exclude

Type: string || Array<string>

One or a list of script names to ignore, ignores a file even if present in the include option.

log

Type: boolean

Wether to show this plugin's logs or not, like skipped files and number of #if groups found.

mode

Type: string

Values: "plain"|"commented"|"both"

Wether to preprocess directives written plainly #if or in a comment //#if. Default value is "both".

commented -> "//#if", "//#else", ... and "//#post-code let exampleVar = 5;"
plain     -> "#if", "#else", ... ("#post-code" not available)

Differences

The differences between this rollup plugin, and @prebuilder/rollup are: | | pb-rollup | rollup-plugin | | --- | :---: | :---: | | faster processing | ❌manages files +processes them | ✔ processes files | | Not affected by configurationedge cases | ✔ | ❌can become unusable for complex rollup configs, depending on what other plugin is used ¹ |

¹ ) If, for example, using the typsescript rollup plugin which seems to manage .ts files on non-transform hooks, @prebuilder/rollup is then more suitable.