feat: change the syntax for providing options from scratch

BREAKING CHANGE to provide configs for a plugin from scratch, pass false
as the third input.

Also deprecates passing extra plugins to `createPlugins`

Author: aminya

README.md

@@ -88,35 +88,32 @@ terser (in production)
 replace (in production)
 ```
 
-### Override Default Options for the plugins `[name, overriddenOptions, true]`
+### Override Default Options for the plugins `[name, overriddenOptions]`
 
-You can pass an input plugin with the overridden options using the `[name, overriddenOptions, true]` syntax.
+You can pass an input plugin with the overridden options using the `[name, overriddenOptions]` syntax.
 
 ```ts
-const plugins = createPlugins([
-  ["ts", { tsconfig: "./lib/tsconfig.json" }, true], // third element makes the config merge to and override the default options
-  "js",
-])
+const plugins = createPlugins([["ts", { tsconfig: "./lib/tsconfig.json" }], "js"])
 ```
 
-The difference with the next syntax is that these are merged into the default options and if there is a config with the same name, they override it, but the next syntax completely replaces the default options.
+### Completely New Options for the plugins `[name, newOptions, false]`
 
-### Completely New Options for the plugins `[name, newOptions]`
-
-You can pass an input plugin with their supported option using the `[name, newOptions]` syntax:
+You can pass an input plugin with their supported option using the `[name, newOptions, false]` syntax:
 
 ```ts
 const plugins = createPlugins([
-  ["ts", { tsconfig: "./lib/tsconfig.json", noEmitOnError: false, module: "ESNext" }],
+  ["ts", { tsconfig: "./lib/tsconfig.json", noEmitOnError: false, module: "ESNext" }, false],
   "js",
 ])
 ```
 
+Passing false as the third argument results in discarding the `rollup-config-atomic` built-in options.
+
 ### Adding New Extra Plugins
 
-For adding extra plugins, you can pass them in array to the second argument
+For adding extra plugins, you can simply concatenate your plugins with the output of `createPlugins`
 
 ```ts
 import multyentry from "@rollup/plugin-multi-entry"
-createPlugins(["ts"], [multyentry()])
+const plugins = [...createPlugins(["ts"]), multyentry()]
 ```

src/main.ts

@@ -132,6 +132,9 @@ export function createPlugins(
 
   // extra plugins
   if (extraPlugins !== undefined && typeof extraPlugins === "object" /*array*/) {
+    console.warn(
+      "Passing extra plugins to `createPlugins` is deprecated. Instead concatenate the output of `createPlugins` with your extra plugins."
+    )
     try {
       plugins.push(...extraPlugins)
     } catch (e) {
@@ -225,7 +228,10 @@ export function createPlugins(
       if (typeof inputPluginsNames[index] === "string") {
         // plugin name only
         plugins.push(pluginFunction(pluginDefaultOptions))
-      } else if (typeof inputPluginsNames[index][2] === "boolean" && inputPluginsNames[index][2] === true) {
+      } else if (inputPluginsNames[index].length == 3 && inputPluginsNames[index][2] === false) {
+        // plugin with options from scratch
+        plugins.push(pluginFunction(inputPluginsNames[index][1]))
+      } else {
         // plugin with options that override pluginDefaultOptions
         const pluginOptions = inputPluginsNames[index][1]
         plugins.push(
@@ -235,9 +241,6 @@ export function createPlugins(
               : { ...pluginDefaultOptions, pluginOptions }
           )
         )
-      } else {
-        // plugin with options
-        plugins.push(pluginFunction(inputPluginsNames[index][1]))
       }
     } else if (includeByDefault) {
       const pluginFunction = getPluginFunction(require(moduleName), prop)