gjs-gts-parser.js

const babelParser = require('@babel/eslint-parser');
const { registerParsedFile } = require('../preprocessor/noop');
const {
  patchTs,
  replaceExtensions,
  syncMtsGtsSourceFiles,
  typescriptParser,
} = require('./ts-patch');
const { transformForLint, preprocessGlimmerTemplates, convertAst } = require('./transforms');

/**
 * implements https://eslint.org/docs/latest/extend/custom-parsers
 * 1. transforms gts/gjs files into parseable ts/js without changing the offsets and locations around it
 * 2. parses the transformed code and generates the AST for TS ot JS
 * 3. preprocesses the templates info and prepares the Glimmer AST
 * 4. converts the js/ts AST so that it includes the Glimmer AST at the right locations, replacing the original
 */
/**
 *
 * @type {import('eslint').ParserModule}
 */
module.exports = {
  meta: {
    name: 'ember-eslint-parser',
    version: '*',
  },

  parseForESLint(code, options) {
    patchTs();
    registerParsedFile(options.filePath);
    let jsCode = code;
    const info = transformForLint(code, options.filePath);
    jsCode = info.output;

    const isTypescript = options.filePath.endsWith('.gts') || options.filePath.endsWith('.ts');
    let useTypescript = true;

    if (options.useBabel || !typescriptParser) {
      useTypescript = false;
    }

    let result = null;
    const filePath = options.filePath;
    if (options.project || options.projectService) {
      jsCode = replaceExtensions(jsCode);
    }

    if (isTypescript && !typescriptParser) {
      throw new Error('Please install typescript to process gts');
    }

    try {
      result =
        isTypescript || useTypescript
          ? typescriptParser.parseForESLint(jsCode, {
              ...options,
              ranges: true,
              extraFileExtensions: ['.gts', '.gjs'],
              filePath,
            })
          : babelParser.parseForESLint(jsCode, {
              ...options,
              requireConfigFile: false,
              ranges: true,
            });
      if (!info.templateInfos?.length) {
        return result;
      }
      const preprocessedResult = preprocessGlimmerTemplates(info, code);
      preprocessedResult.code = code;
      const { templateVisitorKeys } = preprocessedResult;
      const visitorKeys = { ...result.visitorKeys, ...templateVisitorKeys };
      result.isTypescript = isTypescript || useTypescript;
      convertAst(result, preprocessedResult, visitorKeys);
      if (result.services?.program) {
        syncMtsGtsSourceFiles(result.services?.program);
      }
      return { ...result, visitorKeys };
    } catch (e) {
      console.error(e);
      throw e;
    }
  },
};