parser.ts

import fs from 'fs-extra';
import { FsCache } from '@teambit/workspace.modules.fs-cache';
import { SourceFile } from '@teambit/component.sources';
import { PathOsBased } from '@teambit/toolbox.path.path';
import jsDocParse from './jsdoc';
import reactParse from './react';
import { Doclet } from './types';

export default async function parse(file: SourceFile, componentFsCache: FsCache): Promise<Doclet[]> {
  const docsFromCache = await componentFsCache.getDocsFromCache(file.path);
  if (docsFromCache && docsFromCache.timestamp) {
    const stat = await fs.stat(file.path);
    const wasFileChanged = stat.mtimeMs > docsFromCache.timestamp;
    if (!wasFileChanged) {
      return JSON.parse(docsFromCache.data);
    }
  }

  const results = await parseFile(file.contents.toString(), file.relative);
  await componentFsCache.saveDocsInCache(file.path, results);
  return results;
}

async function parseFile(data: string, filePath: PathOsBased): Promise<Doclet[]> {
  const reactDocs = await reactParse(data, filePath);
  if (reactDocs && Object.keys(reactDocs).length > 0) {
    return reactDocs;
  }
  return jsDocParse(data, filePath);
}