Add options parameter, add ignoreAutomaticGrants option (#11)

* feat: add option to ignore automatic grants

* feat: merge `transform` into `userOptions`, add overloads to allow for any parameter combination

This allows for either providing just a transform function, just an options object with an (optional) transform function, or both as separate parameters. All parameters being optional!

* feat: remove 2-parameter overload

You can now either only pass a transform function, an object with a transform function and other options, or nothing at all.

As requested in a code review.

Author: netux

src/index.ts

@@ -5,7 +5,23 @@ import { collectGrants, getMetadata } from './util';
 
 const suffix = '?userscript-metadata';
 
-export default (transform?: (metadata: string) => string): Plugin => {
+type TransformFn = (metadata: string) => string;
+
+export interface UserscriptMetaOptions {
+  transform?: TransformFn;
+  ignoreAutomaticGrants?: string[];
+}
+
+function userscriptPlugin(transform?: TransformFn): Plugin;
+function userscriptPlugin(options?: UserscriptMetaOptions): Plugin;
+
+function userscriptPlugin(
+  transformOrUserOptions?: TransformFn | UserscriptMetaOptions
+): Plugin {
+  const userOptions = typeof transformOrUserOptions === 'function'
+    ? { transform: transformOrUserOptions }
+    : transformOrUserOptions;
+
   const metadataMap = new Map();
   const grantMap = new Map();
   return {
@@ -45,12 +61,16 @@ export default (transform?: (metadata: string) => string): Plugin => {
         const grantSetPerFile = grantMap.get(id);
         if (grantSetPerFile) {
           for (const item of grantSetPerFile) {
+            if (userOptions.ignoreAutomaticGrants?.includes(item)) {
+              continue;
+            }
+
             grantSet.add(item);
           }
         }
       }
       metadata = getMetadata(metadata, grantSet);
-      if (transform) metadata = transform(metadata);
+      if (userOptions.transform) metadata = userOptions.transform(metadata);
       const s = new MagicString(code);
       s.prepend(`${metadata}\n\n`);
       return {
@@ -60,3 +80,5 @@ export default (transform?: (metadata: string) => string): Plugin => {
     },
   };
 };
+
+export default userscriptPlugin;