jsdoc/packages/jsdoc-parse/lib/ast-builder.js

const _ = require('lodash');
const babelParser = require('@babel/parser');
const { log } = require('@jsdoc/util');

// Exported so we can use them in tests.
const parserOptions = (exports.parserOptions = {
  allowAwaitOutsideFunction: true,
  allowImportExportEverywhere: true,
  allowReturnOutsideFunction: true,
  allowSuperOutsideMethod: true,
  allowUndeclaredExports: true,
  plugins: [
    'asyncGenerators',
    'bigInt',
    'classPrivateMethods',
    'classPrivateProperties',
    'classProperties',
    [
      'decorators',
      {
        decoratorsBeforeExport: true,
      },
    ],
    'doExpressions',
    'dynamicImport',
    'estree',
    'exportDefaultFrom',
    'exportNamespaceFrom',
    'functionBind',
    'functionSent',
    'importMeta',
    'jsx',
    'logicalAssignment',
    'nullishCoalescingOperator',
    'numericSeparator',
    'objectRestSpread',
    'optionalCatchBinding',
    'optionalChaining',
    [
      'pipelineOperator',
      {
        proposal: 'minimal',
      },
    ],
    'throwExpressions',
  ],
  ranges: true,
});

function parse(source, filename, sourceType) {
  let ast;
  const options = _.defaults({}, parserOptions, { sourceType });

  try {
    ast = babelParser.parse(source, options);
  } catch (e) {
    log.error(`Unable to parse ${filename}: ${e.message}`);
  }

  return ast;
}

// TODO: docs
class AstBuilder {
  // TODO: docs
  static build(source, filename, sourceType) {
    return parse(source, filename, sourceType);
  }
}
exports.AstBuilder = AstBuilder;