@tsed/ts-doc/src/parsers/DocSymbolParser.js

Generate documentation in markdown for TypeScript API

const {DocSymbol} = require("../models/DocSymbol");
const {descriptionParser} = require("./description-parser");
const {context} = require("../context");

class DocSymbolParser {
  constructor(line, description, contents) {
    this.line = line;
    this.skip = false;
    // this.contents = contents;

    description = descriptionParser(description);

    this.description = description;
    this.symbol = new DocSymbol();
    this.symbol.description = description.content;
    this.symbol.labels = this.symbol.labels.concat(description.labels);
  }

  parse() {
    try {
      if (this.line.match(/class |interface |enum /)) {
        this.parseClass();
      } else {
        this.parseOtherSymbol();
      }
    } catch (er) {
      console.error(this.line, er);
    }

    return this.symbol;
  }

  /**
   *
   */
  parseClass() {
    let line = this.line
      .split(" ")
      .filter((word, index, map) => this.parseKeyword(word, index, map))
      .join(" ");

    this.symbol.implements = line
      .replace("implements ", "")
      .replace("{", "")
      .trim()
      .split(" ")
      .filter((o) => o !== "")
      .filter((o) => !o.match(">"))
      .filter((o) => !o.match(">"))
      .map((o) => o.split("<")[0])
      .filter((o) => o !== this.symbol.symbolName);
  }

  /**
   *
   */
  parseOtherSymbol() {
    this.line = this.line.replace(/^export /, "");

    const {symbol, line} = this;
    symbol.exported = true;

    const isFunction = line.match(/^function (\w+)\(|^const (\w+): \(/);
    const matched = line.match(/^(\w+) (\w+)/);

    if (matched) {
      if (isFunction) {
        symbol.symbolType = "function";

        if (symbol.labels.find((item) => item.key === "decorator")) {
          symbol.symbolType = "decorator";
        }
      } else {
        symbol.symbolType = matched[1];
      }

      symbol.symbolName = matched[2];

      try {
        symbol.symbolLabel = context.symbolTypes[symbol.symbolType].label;
        symbol.symbolCode = context.symbolTypes[symbol.symbolType].code;
      } catch (er) {
        this.skip = true;
        // console.error("====> Symbol", this.symbol.symbolType); //context.symbolTypes);
      }
    }
  }

  /**
   *
   * @param word
   * @param index
   * @param map
   * @returns {boolean}
   */
  parseKeyword(word, index, map) {
    if (word.match(/,<>/)) {
      return true;
    }

    if (word === "export") {
      this.symbol.exported = true;
      return false;
    }

    if (word === "abstract") {
      this.symbol.abstract = true;
      return false;
    }
    if (word.match(/class$|interface$|enum$/)) {
      this.symbol.symbolType = word;
      this.symbol.symbolCode = context.symbolTypes[word].code;
      this.symbol.symbolLabel = context.symbolTypes[word].label;
      this.symbol.symbolName = map[index + 1].split("<")[0];
      return false;
    }

    if (word === "extends") {
      this.symbol.extends = map[index + 1];
      return false;
    }

    return !(word === this.symbol.symbolName || word === this.symbol.extends);
  }
}

module.exports.DocSymbolParser = DocSymbolParser;