refactor: Remove plugin-proposal because it is related of transform code (documentationjs#1371)

anthony-redFox · web-flow · commit 09a441ac4221 · 2021-04-20T13:41:30.000-07:00
* deps: Remove plugin-proposal because it is related of transform code

1. Documentation need to just parse code and do not transform anything.
That why need to remove plugin and preset usages
2. Remove parser options which already included in parser and enabled by default

* chore: Update docs related remark 13
diff --git a/docs/NODE_API.md b/docs/NODE_API.md
@@ -2,22 +2,22 @@
 
 ### Table of Contents
 
--   [lint][1]
-    -   [Parameters][2]
-    -   [Examples][3]
--   [build][4]
-    -   [Parameters][5]
-    -   [Examples][6]
--   [formats][7]
--   [formats.html][8]
-    -   [Parameters][9]
-    -   [Examples][10]
--   [formats.markdown][11]
-    -   [Parameters][12]
-    -   [Examples][13]
--   [formats.json][14]
-    -   [Parameters][15]
-    -   [Examples][16]
+*   [lint][1]
+    *   [Parameters][2]
+    *   [Examples][3]
+*   [build][4]
+    *   [Parameters][5]
+    *   [Examples][6]
+*   [formats][7]
+*   [formats.html][8]
+    *   [Parameters][9]
+    *   [Examples][10]
+*   [formats.markdown][11]
+    *   [Parameters][12]
+    *   [Examples][13]
+*   [formats.json][14]
+    *   [Parameters][15]
+    *   [Examples][16]
 
 ## lint
 
@@ -27,19 +27,19 @@ of lint information intended for human-readable output.
 
 ### Parameters
 
--   `indexes` **([Array][17]&lt;[string][18]> | [string][18])** files to process
--   `args` **[Object][19]** args
+*   `indexes` **([Array][17]<[string][18]> | [string][18])** files to process
+*   `args` **[Object][19]** args
 
-    -   `args.external` **[Array][17]&lt;[string][18]>** a string regex / glob match pattern
+    *   `args.external` **[Array][17]<[string][18]>** a string regex / glob match pattern
         that defines what external modules will be whitelisted and included in the
         generated documentation.
-    -   `args.shallow` **[boolean][20]** whether to avoid dependency parsing
+    *   `args.shallow` **[boolean][20]** whether to avoid dependency parsing
         even in JavaScript code. (optional, default `false`)
-    -   `args.inferPrivate` **[string][18]?** a valid regular expression string
+    *   `args.inferPrivate` **[string][18]?** a valid regular expression string
         to infer whether a code element should be private, given its naming structure.
         For instance, you can specify `inferPrivate: '^_'` to automatically treat
         methods named like `_myMethod` as private.
-    -   `args.extension` **([string][18] \| [Array][17]&lt;[string][18]>)?** treat additional file extensions
+    *   `args.extension` **([string][18] | [Array][17]<[string][18]>)?** treat additional file extensions
         as JavaScript, extending the default set of `js`, `es6`, and `jsx`.
 
 ### Examples
@@ -64,27 +64,27 @@ comments, given a root file as a path.
 
 ### Parameters
 
--   `indexes` **([Array][17]&lt;[string][18]> | [string][18])** files to process
--   `args` **[Object][19]** args
+*   `indexes` **([Array][17]<[string][18]> | [string][18])** files to process
+*   `args` **[Object][19]** args
 
-    -   `args.external` **[Array][17]&lt;[string][18]>** a string regex / glob match pattern
+    *   `args.external` **[Array][17]<[string][18]>** a string regex / glob match pattern
         that defines what external modules will be whitelisted and included in the
         generated documentation.
-    -   `args.shallow` **[boolean][20]** whether to avoid dependency parsing
+    *   `args.shallow` **[boolean][20]** whether to avoid dependency parsing
         even in JavaScript code. (optional, default `false`)
-    -   `args.order` **[Array][17]&lt;([string][18] \| [Object][19])>** optional array that
+    *   `args.order` **[Array][17]<([string][18] | [Object][19])>** optional array that
         defines sorting order of documentation (optional, default `[]`)
-    -   `args.access` **[Array][17]&lt;[string][18]>** an array of access levels
+    *   `args.access` **[Array][17]<[string][18]>** an array of access levels
         to output in documentation (optional, default `[]`)
-    -   `args.hljs` **[Object][19]?** hljs optional args
+    *   `args.hljs` **[Object][19]?** hljs optional args
 
-        -   `args.hljs.highlightAuto` **[boolean][20]** hljs automatically detect language (optional, default `false`)
-        -   `args.hljs.languages` **[Array][17]?** languages for hljs to choose from
-    -   `args.inferPrivate` **[string][18]?** a valid regular expression string
+        *   `args.hljs.highlightAuto` **[boolean][20]** hljs automatically detect language (optional, default `false`)
+        *   `args.hljs.languages` **[Array][17]?** languages for hljs to choose from
+    *   `args.inferPrivate` **[string][18]?** a valid regular expression string
         to infer whether a code element should be private, given its naming structure.
         For instance, you can specify `inferPrivate: '^_'` to automatically treat
         methods named like `_myMethod` as private.
-    -   `args.extension` **([string][18] \| [Array][17]&lt;[string][18]>)?** treat additional file extensions
+    *   `args.extension` **([string][18] | [Array][17]<[string][18]>)?** treat additional file extensions
         as JavaScript, extending the default set of `js`, `es6`, and `jsx`.
 
 ### Examples
@@ -117,10 +117,10 @@ Formats documentation as HTML.
 
 ### Parameters
 
--   `comments` **[Array][17]&lt;[Comment][22]>** parsed comments
--   `config` **[Object][19]** Options that can customize the output
+*   `comments` **[Array][17]<[Comment][22]>** parsed comments
+*   `config` **[Object][19]** Options that can customize the output
 
-    -   `config.theme` **[string][18]** Name of a module used for an HTML theme. (optional, default `'default_theme'`)
+    *   `config.theme` **[string][18]** Name of a module used for an HTML theme. (optional, default `'default_theme'`)
 
 ### Examples
 
@@ -136,7 +136,7 @@ documentation.build(['index.js'])
   });
 ```
 
-Returns **[Promise][21]&lt;[Array][17]&lt;[Object][19]>>** Promise with results
+Returns **[Promise][21]<[Array][17]<[Object][19]>>** Promise with results
 
 ## formats.markdown
 
@@ -145,8 +145,8 @@ Formats documentation as
 
 ### Parameters
 
--   `comments` **[Array][17]&lt;[Object][19]>** parsed comments
--   `args` **[Object][19]** Options that can customize the output
+*   `comments` **[Array][17]<[Object][19]>** parsed comments
+*   `args` **[Object][19]** Options that can customize the output
 
 ### Examples
 
@@ -162,15 +162,15 @@ documentation.build(['index.js'])
   });
 ```
 
-Returns **[Promise][21]&lt;[string][18]>** a promise of the eventual value
+Returns **[Promise][21]<[string][18]>** a promise of the eventual value
 
 ## formats.json
 
 Formats documentation as a JSON string.
 
 ### Parameters
 
--   `comments` **[Array][17]&lt;[Comment][22]>** parsed comments
+*   `comments` **[Array][17]<[Comment][22]>** parsed comments
 
 ### Examples
 
@@ -186,7 +186,7 @@ documentation.build(['index.js'])
   });
 ```
 
-Returns **[Promise][21]&lt;[string][18]>** 
+Returns **[Promise][21]<[string][18]>** 
 
 [1]: #lint
 
diff --git a/package.json b/package.json
@@ -11,22 +11,6 @@
     "@babel/core": "7.12.3",
     "@babel/generator": "7.12.1",
     "@babel/parser": "7.12.3",
-    "@babel/plugin-proposal-class-properties": "^7.12.1",
-    "@babel/plugin-proposal-decorators": "^7.12.1",
-    "@babel/plugin-proposal-do-expressions": "^7.12.1",
-    "@babel/plugin-proposal-export-default-from": "^7.12.1",
-    "@babel/plugin-proposal-export-namespace-from": "^7.12.1",
-    "@babel/plugin-proposal-function-bind": "^7.12.1",
-    "@babel/plugin-proposal-function-sent": "^7.12.1",
-    "@babel/plugin-proposal-json-strings": "^7.12.1",
-    "@babel/plugin-proposal-pipeline-operator": "^7.12.1",
-    "@babel/plugin-proposal-private-methods": "^7.12.1",
-    "@babel/plugin-proposal-throw-expressions": "^7.12.1",
-    "@babel/plugin-syntax-import-meta": "^7.10.4",
-    "@babel/preset-env": "^7.12.1",
-    "@babel/preset-flow": "^7.9.0",
-    "@babel/preset-react": "^7.9.4",
-    "@babel/preset-stage-0": "^7.8.3",
     "@babel/traverse": "^7.12.1",
     "@babel/types": "^7.12.1",
     "ansi-html": "^0.0.7",
diff --git a/src/input/dependency.js b/src/input/dependency.js
@@ -7,29 +7,8 @@ const { standardBabelParserPlugins } = require('../parsers/parse_to_ast');
 const smartGlob = require('../smart_glob.js');
 
 const STANDARD_BABEL_CONFIG = {
-  sourceMaps: false,
   compact: false,
-  cwd: path.resolve(__dirname, '../../'),
-  presets: ['@babel/preset-react', '@babel/preset-env', '@babel/preset-flow'],
-  parserOpts: { plugins: standardBabelParserPlugins },
-  plugins: [
-    // Stage 0
-    '@babel/plugin-proposal-function-bind',
-    // Stage 1
-    '@babel/plugin-proposal-export-default-from',
-    ['@babel/plugin-proposal-pipeline-operator', { proposal: 'minimal' }],
-    '@babel/plugin-proposal-do-expressions',
-    // Stage 2
-    ['@babel/plugin-proposal-decorators', { decoratorsBeforeExport: true }],
-    '@babel/plugin-proposal-function-sent',
-    '@babel/plugin-proposal-export-namespace-from',
-    '@babel/plugin-proposal-throw-expressions',
-    // Stage 3
-    '@babel/plugin-syntax-import-meta',
-    ['@babel/plugin-proposal-class-properties', { loose: false }],
-    '@babel/plugin-proposal-private-methods',
-    '@babel/plugin-proposal-json-strings'
-  ]
+  parserOpts: { plugins: [...standardBabelParserPlugins, 'flow'] }
 };
 
 /**
diff --git a/src/parsers/parse_to_ast.js b/src/parsers/parse_to_ast.js
@@ -7,26 +7,14 @@ const TYPESCRIPT_EXTS = {
 };
 
 const standardBabelParserPlugins = [
-  'asyncGenerators',
-  'bigInt',
   'classProperties',
-  'classConstructorCall',
   'classPrivateProperties',
   'classPrivateMethods',
   'doExpressions',
-  'dynamicImport',
   'exportDefaultFrom',
-  'exportNamespaceFrom',
   'exportExtensions',
   'functionBind',
-  'functionSent',
   'jsx',
-  'logicalAssignment',
-  'nullishCoalescingOperator',
-  'numericSeparator',
-  'objectRestSpread',
-  'optionalCatchBinding',
-  'optionalChaining',
   'partialApplication',
   ['pipelineOperator', { proposal: 'minimal' }],
   'throwExpressions'
diff --git a/yarn.lock b/yarn.lock
