rollup-plugin-conditional-compilation 0.0.2 → 1.0.0

package/README.md

@@ -3,17 +3,17 @@
 [![npm version](https://img.shields.io/npm/v/rollup-plugin-conditional-compilation.svg)](https://www.npmjs.com/package/rollup-plugin-conditional-compilation) [![npm downloads](http://img.shields.io/npm/dm/rollup-plugin-conditional-compilation.svg)](https://npmcharts.com/compare/rollup-plugin-conditional-compilation,token-types?start=1200&interval=30)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Codacy Badge](https://api.codacy.com/project/badge/Grade/59dd6795e61949fb97066ca52e6097ef)](https://www.codacy.com/app/Borewit/rollup-plugin-conditional-compilation?utm_source=github.com&utm_medium=referral&utm_content=Borewit/rollup-plugin-conditional-compilation&utm_campaign=Badge_Grade)
 
-A simple plugin that allows you to include or exclude code blocks based on compile-time conditions. Works like `#if`, `#endif` in C/C++.
+A simple plugin that allows you to include or exclude code blocks based on compile-time conditions. Works like `#if`, `#else`, `#elif` , `#endif` in C/C++.
 
-> **Note**: This plugin is a simplified version that only supports `#if` and `#endif` for now. Supports for `#else`, `#elif` will be added in future releases.
+> **Note**: You should modify the plugin options to ensure **NOT to strip comments so quickly**, since we work with them. For example, with `@rollup/plugin-typescript`, set `removeComments: false`.
 
-For more awesome packages, check out [my homepage💛](https://baendlorel.github.io/?repoType=npm)
-
-**More rollup plugins** you might be interested in:
+**More Rollup plugins** you might be interested in:
 
-- [rollup-plugin-conditional-compilation](https://www.npmjs.com/package/rollup-plugin-conditional-compilation): inline your `const enum XXX { ... }` definitions at compile time.
+- [rollup-plugin-const-enum](https://www.npmjs.com/package/rollup-plugin-const-enum): inline your `const enum XXX { ... }` definitions at compile time.
 - [rollup-plugin-func-macro](https://www.npmjs.com/package/rollup-plugin-func-macro): replace `__func__` by function name of current block, and `__file__` by file name at compile time.
 
+For more awesome packages, check out [my homepage💛](https://baendlorel.github.io/?repoType=npm)
+
 ## Installation
 
 ```bash
@@ -25,21 +25,25 @@ pnpm add -D rollup-plugin-conditional-compilation
 
 ```js
 import conditional from 'rollup-plugin-conditional-compilation';
-
 export default {
-  input: 'src/index.js',
-  output: { file: 'dist/bundle.js', format: 'esm' },
   ...other configs,
-  plugins: [conditional({ variables: { DEBUG: false, FEATURE_X: true } })],
+  plugins: [
+    typescript({
+      ...,
+      removeComments: false, // !!IMPORTANT!! Don't strip comments so quickly!
+    }),
+    conditional({ variables: { DEBUG: false, FEATURE_X: true } })
+  ],
 };
 ```
 
 ### Syntax
 
-- Single-line directives only: `// #if <expression>` and `// #endif`.
+- Single-line directives only: `// #if <expression>`, `// #else`, `// #elif <expression>` and `// #endif`.
 - The `<expression>` is evaluated at build time with the keys from `variables` available as identifiers.
-  - You can write literally **ANY** js expression in it, because it is evaluated as an IIFE(Immediately Invoked Function Expression).
-- Only `#if` and `#endif` are supported(for now). `#else` / `#elif` will be supported in future releases.
+  - You can write **literally ANY JavaScript expressions** in it, because it is evaluated as an IIFE (Immediately Invoked Function Expression).
+  - Supported directives: `#if`, `#else`, `#elif`, `#endif` (similar to C/C++ style conditional compilation).
+- Since it is `if/else` , it follows the syntax of `if/else` statements
 
 ### Example