@teambit/typescript 0.0.955 → 0.0.957

package/dist/{preview-1673347296243.js → preview-1673494106850.js}

@@ -1,5 +1,5 @@
-import * as compositions_0 from '/home/circleci/Library/Caches/Bit/capsules/8891be5ad3d35bfc38b9cd90c0e05b598a5a55af/teambit.typescript_typescript@0.0.955/dist/typescript.composition.js';
-import * as overview_0 from '/home/circleci/Library/Caches/Bit/capsules/8891be5ad3d35bfc38b9cd90c0e05b598a5a55af/teambit.typescript_typescript@0.0.955/dist/typescript.docs.mdx';
+import * as compositions_0 from '/home/circleci/Library/Caches/Bit/capsules/8891be5ad3d35bfc38b9cd90c0e05b598a5a55af/teambit.typescript_typescript@0.0.957/dist/typescript.composition.js';
+import * as overview_0 from '/home/circleci/Library/Caches/Bit/capsules/8891be5ad3d35bfc38b9cd90c0e05b598a5a55af/teambit.typescript_typescript@0.0.957/dist/typescript.docs.mdx';
 
 export const compositions = [compositions_0];
 export const overview = [overview_0];

package/dist/schema-extractor-context.d.ts

@@ -13,8 +13,8 @@ export declare class SchemaExtractorContext {
     readonly component: Component;
     readonly extractor: TypeScriptExtractor;
     readonly componentDeps: ComponentDependency[];
-    readonly formatter: Formatter;
-    constructor(tsserver: TsserverClient, component: Component, extractor: TypeScriptExtractor, componentDeps: ComponentDependency[], formatter: Formatter);
+    readonly formatter?: Formatter | undefined;
+    constructor(tsserver: TsserverClient, component: Component, extractor: TypeScriptExtractor, componentDeps: ComponentDependency[], formatter?: Formatter | undefined);
     computeSchema(node: Node): Promise<SchemaNode>;
     /**
      * returns the location of a node in a source file.

package/dist/schema-extractor-context.js.map

@@ -1 +1 @@
-{"version":3,"names":["SchemaExtractorContext","constructor","tsserver","component","extractor","componentDeps","formatter","undefined","computeSchema","node","getLocation","targetSourceFile","absolutePath","sourceFile","getSourceFile","position","getLineAndCharacterOfPosition","getStart","line","character","filePath","fileName","getPathRelativeToComponent","pathNormalizeToLinux","getLocationAsString","location","basePath","filesystem","files","base","relative","getSignature","getSignatureHelp","getPath","getPosition","offset","getPositionOfLineAndCharacter","getQuickInfo","err","message","Error","getQuickInfoDisplayString","quickInfo","body","displayString","typeDefinition","getTypeDefinition","visitTypeDefinition","findFileInComponent","find","file","path","includes","strings","map","format","endsWith","string","parsePackageNameFromPath","parts","split","length","lastPart","replace","sep","pkgParts","startsWith","pkgName","getSourceFileInsideComponent","parseSourceFile","getSourceFileFromNode","getFilePathByNode","def","getDefinition","firstDef","head","definitionInfo","definition","startPosition","start","pos","nodeAtPos","getTokenAtPosition","visitDefinition","getTypeRefForExternalNode","visit","parent","references","isExported","isFromComponent","getFileExports","exportDec","specifierPathStr","kind","SyntaxKind","ExportDeclaration","moduleSpecifier","getText","specifierPath","substring","absPath","resolve","computeExportedIdentifiers","setExports","exports","_exports","getExportedIdentifiers","jump","TransformerNotFound","resolveType","typeStr","isTypeStrFromQuickInfo","TypeRefSchema","type","ts","isTypeNode","typeNodeToSchema","getDef","headTypeDefinition","unknownExactType","InferenceTypeSchema","info","parseTypeFromQuickInfo","isDefInSameLocation","loc","schemaNode","getTypeRefForExternalPath","getCompIdByPkgName","dep","packageName","componentId","compIdByPath","getComponentIDByPath","compIdByPkg","jsDocToDocSchema","canHaveJsDoc","jsDocs","getJsDoc","jsDoc","comment","getTextOfJSDocComment","tags","pMapSeries","tag","tagParser","DocSchema"],"sources":["schema-extractor-context.ts"],"sourcesContent":["import { TsserverClient } from '@teambit/ts-server';\nimport { getTokenAtPosition, canHaveJsDoc, getJsDoc } from 'tsutils';\nimport ts, { ExportAssignment, getTextOfJSDocComment, ExportDeclaration, Node, SyntaxKind, TypeNode } from 'typescript';\nimport { head } from 'lodash';\n// eslint-disable-next-line import/no-unresolved\nimport protocol from 'typescript/lib/protocol';\n// @ts-ignore david we should figure fix this.\nimport type { AbstractVinyl } from '@teambit/legacy/dist/consumer/component/sources';\nimport { pathNormalizeToLinux } from '@teambit/legacy/dist/utils';\nimport { resolve, sep, relative } from 'path';\nimport { Component, ComponentID } from '@teambit/component';\nimport {\n  TypeRefSchema,\n  SchemaNode,\n  InferenceTypeSchema,\n  Location,\n  DocSchema,\n} from '@teambit/semantics.entities.semantic-schema';\nimport { ComponentDependency } from '@teambit/dependency-resolver';\nimport { Formatter } from '@teambit/formatter';\nimport pMapSeries from 'p-map-series';\nimport { TypeScriptExtractor } from './typescript.extractor';\nimport { ExportList } from './export-list';\nimport { typeNodeToSchema } from './transformers/utils/type-node-to-schema';\nimport { TransformerNotFound } from './exceptions';\nimport { parseTypeFromQuickInfo } from './transformers/utils/parse-type-from-quick-info';\nimport { tagParser } from './transformers/utils/jsdoc-to-doc-schema';\n\nexport class SchemaExtractorContext {\n  constructor(\n    readonly tsserver: TsserverClient,\n    readonly component: Component,\n    readonly extractor: TypeScriptExtractor,\n    readonly componentDeps: ComponentDependency[],\n    readonly formatter: Formatter\n  ) {}\n\n  computeSchema(node: Node) {\n    return this.extractor.computeSchema(node, this);\n  }\n\n  /**\n   * returns the location of a node in a source file.\n   */\n  getLocation(node: Node, targetSourceFile?: ts.SourceFile, absolutePath = false): Location {\n    const sourceFile = targetSourceFile || node.getSourceFile();\n    const position = sourceFile.getLineAndCharacterOfPosition(node.getStart());\n    const line = position.line + 1;\n    const character = position.character + 1;\n    const filePath = absolutePath ? sourceFile.fileName : this.getPathRelativeToComponent(sourceFile.fileName);\n\n    return {\n      filePath: pathNormalizeToLinux(filePath),\n      line,\n      character,\n    };\n  }\n\n  getLocationAsString(node: Node): string {\n    const location = this.getLocation(node);\n    return `${node.getSourceFile().fileName}, line: ${location.line}, character: ${location.character}`;\n  }\n\n  getPathRelativeToComponent(filePath: string): string {\n    const basePath = this.component.filesystem.files[0].base;\n    return relative(basePath, filePath);\n  }\n\n  /**\n   * returns a signature for a node.\n   */\n  async getSignature(node: Node) {\n    return this.tsserver.getSignatureHelp(this.getPath(node), this.getLocation(node));\n  }\n\n  /**\n   * get the position for the tsserver.\n   */\n  getPosition(sourceFile: ts.SourceFile, line: number, offset: number): number {\n    return sourceFile.getPositionOfLineAndCharacter(line - 1, offset - 1);\n  }\n\n  /**\n   * get the path for a source file.\n   */\n  getPath(node: Node) {\n    const sourceFile = node.getSourceFile();\n    return sourceFile.fileName;\n  }\n\n  async getQuickInfo(node: Node) {\n    const location = this.getLocation(node);\n    try {\n      return await this.tsserver.getQuickInfo(this.getPath(node), location);\n    } catch (err: any) {\n      if (err.message === 'No content available.') {\n        throw new Error(\n          `unable to get quickinfo data from tsserver at ${this.getPath(node)}, Ln ${location.line}, Col ${\n            location.character\n          }`\n        );\n      }\n      throw err;\n    }\n  }\n\n  async getQuickInfoDisplayString(node: Node): Promise<string> {\n    const quickInfo = await this.getQuickInfo(node);\n    return quickInfo?.body?.displayString || '';\n  }\n\n  /**\n   * returns the type definition for a type.\n   */\n  typeDefinition(node: Node) {\n    return this.tsserver.getTypeDefinition(this.getPath(node), this.getLocation(node));\n  }\n\n  visitTypeDefinition() {}\n\n  private findFileInComponent(filePath: string) {\n    return this.component.filesystem.files.find((file) => {\n      // TODO: fix this line to support further extensions.\n      if (file.path.includes(filePath)) {\n        const strings = ['ts', 'tsx', 'js', 'jsx'].map((format) => {\n          if (filePath.endsWith(format)) return filePath;\n          return `${filePath}.${format}`;\n        });\n\n        return strings.find((string) => string === file.path);\n      }\n\n      return false;\n    });\n  }\n\n  private parsePackageNameFromPath(path: string) {\n    const parts = path.split('node_modules');\n    if (parts.length === 1) return '';\n    const lastPart = parts[parts.length - 1].replace(sep, '');\n    const pkgParts = lastPart.split('/');\n    if (lastPart.startsWith('@')) {\n      // scoped package\n      return `${pkgParts[0]}/${pkgParts[1]}`;\n    }\n    const pkgName = pkgParts[0];\n    if (pkgName === 'typescript') {\n      // it's a built-in type, such as \"string\".\n      return '';\n    }\n    return pkgName;\n  }\n\n  /**\n   * return the file if part of the component.\n   * otherwise, a reference to the target package and the type name.\n   */\n  getSourceFileInsideComponent(filePath: string) {\n    const file = this.findFileInComponent(filePath);\n    if (!file) return undefined;\n    return this.extractor.parseSourceFile(file);\n  }\n\n  async getSourceFileFromNode(node: Node) {\n    const filePath = await this.getFilePathByNode(node);\n    if (!filePath) {\n      return undefined;\n    }\n    return this.getSourceFileInsideComponent(filePath);\n  }\n\n  async getFilePathByNode(node: Node) {\n    const def = await this.tsserver.getDefinition(this.getPath(node), this.getLocation(node));\n\n    const firstDef = head(def.body);\n    return firstDef?.file;\n  }\n\n  async definitionInfo(node: Node): Promise<protocol.DefinitionInfo | undefined> {\n    const location = this.getLocation(node);\n    const filePath = this.getPath(node);\n\n    const def = await this.tsserver.getDefinition(filePath, location);\n\n    const firstDef = head(def.body);\n\n    return firstDef;\n  }\n\n  /**\n   * get a definition for a given node.\n   */\n  async definition(definition: protocol.DefinitionInfo): Promise<Node | undefined> {\n    const startPosition = definition.start;\n    const sourceFile = this.getSourceFileInsideComponent(definition.file);\n    if (!sourceFile) {\n      // it might be an external reference, cant get the node\n      return undefined;\n    }\n    const pos = this.getPosition(sourceFile, startPosition.line, startPosition.offset);\n    const nodeAtPos = getTokenAtPosition(sourceFile, pos);\n    return nodeAtPos;\n  }\n\n  /**\n   * visit a definition for node - e.g. return it's schema.\n   */\n  async visitDefinition(node: Node): Promise<SchemaNode | undefined> {\n    const definitionInfo = await this.definitionInfo(node);\n    if (!definitionInfo) {\n      return undefined;\n    }\n\n    const definition = await this.definition(definitionInfo);\n    if (!definition) {\n      return this.getTypeRefForExternalNode(node);\n    }\n\n    return this.visit(definition.parent);\n  }\n\n  async visit(node: Node): Promise<SchemaNode> {\n    return this.extractor.computeSchema(node, this);\n  }\n\n  references() {}\n\n  isExported() {}\n\n  isFromComponent() {}\n\n  async getFileExports(exportDec: ExportDeclaration | ExportAssignment) {\n    const file = exportDec.getSourceFile().fileName;\n    const specifierPathStr =\n      (exportDec.kind === SyntaxKind.ExportDeclaration && exportDec.moduleSpecifier?.getText()) || '';\n    const specifierPath = specifierPathStr.substring(1, specifierPathStr.length - 1);\n    const absPath = resolve(file, '..', specifierPath);\n    const sourceFile = this.getSourceFileInsideComponent(absPath);\n    if (!sourceFile) return [];\n    return this.extractor.computeExportedIdentifiers(sourceFile, this);\n  }\n\n  _exports: ExportList | undefined = undefined;\n\n  setExports(exports: ExportList) {\n    this._exports = exports;\n    return this;\n  }\n\n  getExportedIdentifiers(node: Node) {\n    return this.extractor.computeExportedIdentifiers(node, this);\n  }\n\n  async jump(file: AbstractVinyl, start: any): Promise<SchemaNode | undefined> {\n    const sourceFile = this.extractor.parseSourceFile(file);\n    const pos = this.getPosition(sourceFile, start.line, start.offset);\n    const nodeAtPos = getTokenAtPosition(sourceFile, pos);\n    if (!nodeAtPos) return undefined;\n\n    // this causes some infinite loops. it's helpful for getting more data from types that are not exported.\n    // e.g.\n    // ```ts\n    // class Bar {}\n    // export const getBar = () => new Bar();\n    // ```\n    // if (nodeAtPos.kind === ts.SyntaxKind.Identifier) {\n    //   // @todo: make sure with Ran that it's fine. Maybe it's better to do: `this.visit(nodeAtPos.parent);`\n    //   return this.visitDefinition(nodeAtPos);\n    // }\n    try {\n      return await this.visit(nodeAtPos);\n    } catch (err) {\n      if (err instanceof TransformerNotFound) {\n        return undefined;\n      }\n      throw err;\n    }\n  }\n\n  /**\n   * resolve a type by a node and its identifier.\n   */\n  async resolveType(\n    node: Node & { type?: TypeNode },\n    typeStr: string,\n    isTypeStrFromQuickInfo = true\n  ): Promise<SchemaNode> {\n    const location = this.getLocation(node);\n    if (this._exports?.includes(typeStr)) {\n      return new TypeRefSchema(location, typeStr);\n    }\n    if (node.type && ts.isTypeNode(node.type)) {\n      // if a node has \"type\" prop, it has the type data of the node. this normally happens when the code has the type\n      // explicitly, e.g. `const str: string` vs implicitly `const str = 'some-string'`, which the node won't have \"type\"\n      return typeNodeToSchema(node.type, this);\n    }\n    /**\n     * tsserver has two different calls: \"definition\" and \"typeDefinition\".\n     * normally, we need the \"typeDefinition\" to get the type data of a node.\n     * sometimes, it has no data, for example when the node is of type TypeReference, and then using \"definition\" is\n     * helpful. (couldn't find a rule when to use each one. e.g. \"VariableDeclaration\" sometimes has data only in\n     * \"definition\" but it's not clear when/why).\n     */\n    const getDef = async () => {\n      const typeDefinition = await this.typeDefinition(node);\n      const headTypeDefinition = head(typeDefinition?.body);\n      if (headTypeDefinition) {\n        return headTypeDefinition;\n      }\n      const definition = await this.tsserver.getDefinition(node.getSourceFile().fileName, this.getLocation(node));\n      return head(definition?.body);\n    };\n    const definition = await getDef();\n\n    // when we can't figure out the component/package/type of this node, we'll use the typeStr as the type.\n    const unknownExactType = async () => {\n      if (isTypeStrFromQuickInfo) {\n        return new InferenceTypeSchema(location, typeStr || 'any');\n      }\n      const info = await this.getQuickInfo(node);\n      const type = parseTypeFromQuickInfo(info);\n      return new InferenceTypeSchema(location, type, typeStr);\n    };\n    if (!definition) {\n      return unknownExactType();\n    }\n\n    // the reason for this check is to avoid infinite loop when calling `this.jump` with the same file+location\n    const isDefInSameLocation = () => {\n      if (definition.file !== node.getSourceFile().fileName) {\n        return false;\n      }\n      const loc = this.getLocation(node);\n      return loc.line === definition.start.line && loc.character === definition.start.offset;\n    };\n\n    const file = this.findFileInComponent(definition.file);\n    if (file) {\n      if (isDefInSameLocation()) {\n        return unknownExactType();\n      }\n      const schemaNode = await this.jump(file, definition.start);\n      return schemaNode || unknownExactType();\n    }\n    return this.getTypeRefForExternalPath(typeStr, definition.file, location);\n  }\n\n  private getCompIdByPkgName(pkgName: string): ComponentID | undefined {\n    return this.componentDeps.find((dep) => dep.packageName === pkgName)?.componentId;\n  }\n\n  async getTypeRefForExternalNode(node: Node): Promise<TypeRefSchema> {\n    const info = await this.getQuickInfo(node);\n    const typeStr = parseTypeFromQuickInfo(info);\n    const location = this.getLocation(node);\n    const filePath = this.getPath(node);\n    return this.getTypeRefForExternalPath(typeStr, filePath, location);\n  }\n\n  async getTypeRefForExternalPath(typeStr: string, filePath: string, location: Location): Promise<TypeRefSchema> {\n    const compIdByPath = await this.extractor.getComponentIDByPath(filePath);\n    if (compIdByPath) {\n      return new TypeRefSchema(location, typeStr, compIdByPath);\n    }\n    const pkgName = this.parsePackageNameFromPath(filePath);\n    const compIdByPkg = this.getCompIdByPkgName(pkgName);\n    if (compIdByPkg) {\n      return new TypeRefSchema(location, typeStr, compIdByPkg);\n    }\n    return new TypeRefSchema(location, typeStr, undefined, pkgName);\n  }\n\n  async jsDocToDocSchema(node: Node): Promise<DocSchema | undefined> {\n    if (!canHaveJsDoc(node)) {\n      return undefined;\n    }\n    const jsDocs = getJsDoc(node);\n    if (!jsDocs.length) {\n      return undefined;\n    }\n    // not sure how common it is to have multiple JSDocs. never seen it before.\n    // regardless, in typescript implementation of methods like `getJSDocDeprecatedTag()`, they use the first one. (`getFirstJSDocTag()`)\n    const jsDoc = jsDocs[0];\n    const location = this.getLocation(jsDoc);\n    const comment = getTextOfJSDocComment(jsDoc.comment);\n    const tags = jsDoc.tags ? await pMapSeries(jsDoc.tags, (tag) => tagParser(tag, this, this.formatter)) : undefined;\n    return new DocSchema(location, jsDoc.getText(), comment, tags);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"names":["SchemaExtractorContext","constructor","tsserver","component","extractor","componentDeps","formatter","undefined","computeSchema","node","getLocation","targetSourceFile","absolutePath","sourceFile","getSourceFile","position","getLineAndCharacterOfPosition","getStart","line","character","filePath","fileName","getPathRelativeToComponent","pathNormalizeToLinux","getLocationAsString","location","basePath","filesystem","files","base","relative","getSignature","getSignatureHelp","getPath","getPosition","offset","getPositionOfLineAndCharacter","getQuickInfo","err","message","Error","getQuickInfoDisplayString","quickInfo","body","displayString","typeDefinition","getTypeDefinition","visitTypeDefinition","findFileInComponent","find","file","path","includes","strings","map","format","endsWith","string","parsePackageNameFromPath","parts","split","length","lastPart","replace","sep","pkgParts","startsWith","pkgName","getSourceFileInsideComponent","parseSourceFile","getSourceFileFromNode","getFilePathByNode","def","getDefinition","firstDef","head","definitionInfo","definition","startPosition","start","pos","nodeAtPos","getTokenAtPosition","visitDefinition","getTypeRefForExternalNode","visit","parent","references","isExported","isFromComponent","getFileExports","exportDec","specifierPathStr","kind","SyntaxKind","ExportDeclaration","moduleSpecifier","getText","specifierPath","substring","absPath","resolve","computeExportedIdentifiers","setExports","exports","_exports","getExportedIdentifiers","jump","TransformerNotFound","resolveType","typeStr","isTypeStrFromQuickInfo","TypeRefSchema","type","ts","isTypeNode","typeNodeToSchema","getDef","headTypeDefinition","unknownExactType","InferenceTypeSchema","info","parseTypeFromQuickInfo","isDefInSameLocation","loc","schemaNode","getTypeRefForExternalPath","getCompIdByPkgName","dep","packageName","componentId","compIdByPath","getComponentIDByPath","compIdByPkg","jsDocToDocSchema","canHaveJsDoc","jsDocs","getJsDoc","jsDoc","comment","getTextOfJSDocComment","tags","pMapSeries","tag","tagParser","DocSchema"],"sources":["schema-extractor-context.ts"],"sourcesContent":["import { TsserverClient } from '@teambit/ts-server';\nimport { getTokenAtPosition, canHaveJsDoc, getJsDoc } from 'tsutils';\nimport ts, { ExportAssignment, getTextOfJSDocComment, ExportDeclaration, Node, SyntaxKind, TypeNode } from 'typescript';\nimport { head } from 'lodash';\n// eslint-disable-next-line import/no-unresolved\nimport protocol from 'typescript/lib/protocol';\n// @ts-ignore david we should figure fix this.\nimport type { AbstractVinyl } from '@teambit/legacy/dist/consumer/component/sources';\nimport { pathNormalizeToLinux } from '@teambit/legacy/dist/utils';\nimport { resolve, sep, relative } from 'path';\nimport { Component, ComponentID } from '@teambit/component';\nimport {\n  TypeRefSchema,\n  SchemaNode,\n  InferenceTypeSchema,\n  Location,\n  DocSchema,\n} from '@teambit/semantics.entities.semantic-schema';\nimport { ComponentDependency } from '@teambit/dependency-resolver';\nimport { Formatter } from '@teambit/formatter';\nimport pMapSeries from 'p-map-series';\nimport { TypeScriptExtractor } from './typescript.extractor';\nimport { ExportList } from './export-list';\nimport { typeNodeToSchema } from './transformers/utils/type-node-to-schema';\nimport { TransformerNotFound } from './exceptions';\nimport { parseTypeFromQuickInfo } from './transformers/utils/parse-type-from-quick-info';\nimport { tagParser } from './transformers/utils/jsdoc-to-doc-schema';\n\nexport class SchemaExtractorContext {\n  constructor(\n    readonly tsserver: TsserverClient,\n    readonly component: Component,\n    readonly extractor: TypeScriptExtractor,\n    readonly componentDeps: ComponentDependency[],\n    readonly formatter?: Formatter\n  ) {}\n\n  computeSchema(node: Node) {\n    return this.extractor.computeSchema(node, this);\n  }\n\n  /**\n   * returns the location of a node in a source file.\n   */\n  getLocation(node: Node, targetSourceFile?: ts.SourceFile, absolutePath = false): Location {\n    const sourceFile = targetSourceFile || node.getSourceFile();\n    const position = sourceFile.getLineAndCharacterOfPosition(node.getStart());\n    const line = position.line + 1;\n    const character = position.character + 1;\n    const filePath = absolutePath ? sourceFile.fileName : this.getPathRelativeToComponent(sourceFile.fileName);\n\n    return {\n      filePath: pathNormalizeToLinux(filePath),\n      line,\n      character,\n    };\n  }\n\n  getLocationAsString(node: Node): string {\n    const location = this.getLocation(node);\n    return `${node.getSourceFile().fileName}, line: ${location.line}, character: ${location.character}`;\n  }\n\n  getPathRelativeToComponent(filePath: string): string {\n    const basePath = this.component.filesystem.files[0].base;\n    return relative(basePath, filePath);\n  }\n\n  /**\n   * returns a signature for a node.\n   */\n  async getSignature(node: Node) {\n    return this.tsserver.getSignatureHelp(this.getPath(node), this.getLocation(node));\n  }\n\n  /**\n   * get the position for the tsserver.\n   */\n  getPosition(sourceFile: ts.SourceFile, line: number, offset: number): number {\n    return sourceFile.getPositionOfLineAndCharacter(line - 1, offset - 1);\n  }\n\n  /**\n   * get the path for a source file.\n   */\n  getPath(node: Node) {\n    const sourceFile = node.getSourceFile();\n    return sourceFile.fileName;\n  }\n\n  async getQuickInfo(node: Node) {\n    const location = this.getLocation(node);\n    try {\n      return await this.tsserver.getQuickInfo(this.getPath(node), location);\n    } catch (err: any) {\n      if (err.message === 'No content available.') {\n        throw new Error(\n          `unable to get quickinfo data from tsserver at ${this.getPath(node)}, Ln ${location.line}, Col ${\n            location.character\n          }`\n        );\n      }\n      throw err;\n    }\n  }\n\n  async getQuickInfoDisplayString(node: Node): Promise<string> {\n    const quickInfo = await this.getQuickInfo(node);\n    return quickInfo?.body?.displayString || '';\n  }\n\n  /**\n   * returns the type definition for a type.\n   */\n  typeDefinition(node: Node) {\n    return this.tsserver.getTypeDefinition(this.getPath(node), this.getLocation(node));\n  }\n\n  visitTypeDefinition() {}\n\n  private findFileInComponent(filePath: string) {\n    return this.component.filesystem.files.find((file) => {\n      // TODO: fix this line to support further extensions.\n      if (file.path.includes(filePath)) {\n        const strings = ['ts', 'tsx', 'js', 'jsx'].map((format) => {\n          if (filePath.endsWith(format)) return filePath;\n          return `${filePath}.${format}`;\n        });\n\n        return strings.find((string) => string === file.path);\n      }\n\n      return false;\n    });\n  }\n\n  private parsePackageNameFromPath(path: string) {\n    const parts = path.split('node_modules');\n    if (parts.length === 1) return '';\n    const lastPart = parts[parts.length - 1].replace(sep, '');\n    const pkgParts = lastPart.split('/');\n    if (lastPart.startsWith('@')) {\n      // scoped package\n      return `${pkgParts[0]}/${pkgParts[1]}`;\n    }\n    const pkgName = pkgParts[0];\n    if (pkgName === 'typescript') {\n      // it's a built-in type, such as \"string\".\n      return '';\n    }\n    return pkgName;\n  }\n\n  /**\n   * return the file if part of the component.\n   * otherwise, a reference to the target package and the type name.\n   */\n  getSourceFileInsideComponent(filePath: string) {\n    const file = this.findFileInComponent(filePath);\n    if (!file) return undefined;\n    return this.extractor.parseSourceFile(file);\n  }\n\n  async getSourceFileFromNode(node: Node) {\n    const filePath = await this.getFilePathByNode(node);\n    if (!filePath) {\n      return undefined;\n    }\n    return this.getSourceFileInsideComponent(filePath);\n  }\n\n  async getFilePathByNode(node: Node) {\n    const def = await this.tsserver.getDefinition(this.getPath(node), this.getLocation(node));\n\n    const firstDef = head(def.body);\n    return firstDef?.file;\n  }\n\n  async definitionInfo(node: Node): Promise<protocol.DefinitionInfo | undefined> {\n    const location = this.getLocation(node);\n    const filePath = this.getPath(node);\n\n    const def = await this.tsserver.getDefinition(filePath, location);\n\n    const firstDef = head(def.body);\n\n    return firstDef;\n  }\n\n  /**\n   * get a definition for a given node.\n   */\n  async definition(definition: protocol.DefinitionInfo): Promise<Node | undefined> {\n    const startPosition = definition.start;\n    const sourceFile = this.getSourceFileInsideComponent(definition.file);\n    if (!sourceFile) {\n      // it might be an external reference, cant get the node\n      return undefined;\n    }\n    const pos = this.getPosition(sourceFile, startPosition.line, startPosition.offset);\n    const nodeAtPos = getTokenAtPosition(sourceFile, pos);\n    return nodeAtPos;\n  }\n\n  /**\n   * visit a definition for node - e.g. return it's schema.\n   */\n  async visitDefinition(node: Node): Promise<SchemaNode | undefined> {\n    const definitionInfo = await this.definitionInfo(node);\n    if (!definitionInfo) {\n      return undefined;\n    }\n\n    const definition = await this.definition(definitionInfo);\n    if (!definition) {\n      return this.getTypeRefForExternalNode(node);\n    }\n\n    return this.visit(definition.parent);\n  }\n\n  async visit(node: Node): Promise<SchemaNode> {\n    return this.extractor.computeSchema(node, this);\n  }\n\n  references() {}\n\n  isExported() {}\n\n  isFromComponent() {}\n\n  async getFileExports(exportDec: ExportDeclaration | ExportAssignment) {\n    const file = exportDec.getSourceFile().fileName;\n    const specifierPathStr =\n      (exportDec.kind === SyntaxKind.ExportDeclaration && exportDec.moduleSpecifier?.getText()) || '';\n    const specifierPath = specifierPathStr.substring(1, specifierPathStr.length - 1);\n    const absPath = resolve(file, '..', specifierPath);\n    const sourceFile = this.getSourceFileInsideComponent(absPath);\n    if (!sourceFile) return [];\n    return this.extractor.computeExportedIdentifiers(sourceFile, this);\n  }\n\n  _exports: ExportList | undefined = undefined;\n\n  setExports(exports: ExportList) {\n    this._exports = exports;\n    return this;\n  }\n\n  getExportedIdentifiers(node: Node) {\n    return this.extractor.computeExportedIdentifiers(node, this);\n  }\n\n  async jump(file: AbstractVinyl, start: any): Promise<SchemaNode | undefined> {\n    const sourceFile = this.extractor.parseSourceFile(file);\n    const pos = this.getPosition(sourceFile, start.line, start.offset);\n    const nodeAtPos = getTokenAtPosition(sourceFile, pos);\n    if (!nodeAtPos) return undefined;\n\n    // this causes some infinite loops. it's helpful for getting more data from types that are not exported.\n    // e.g.\n    // ```ts\n    // class Bar {}\n    // export const getBar = () => new Bar();\n    // ```\n    // if (nodeAtPos.kind === ts.SyntaxKind.Identifier) {\n    //   // @todo: make sure with Ran that it's fine. Maybe it's better to do: `this.visit(nodeAtPos.parent);`\n    //   return this.visitDefinition(nodeAtPos);\n    // }\n    try {\n      return await this.visit(nodeAtPos);\n    } catch (err) {\n      if (err instanceof TransformerNotFound) {\n        return undefined;\n      }\n      throw err;\n    }\n  }\n\n  /**\n   * resolve a type by a node and its identifier.\n   */\n  async resolveType(\n    node: Node & { type?: TypeNode },\n    typeStr: string,\n    isTypeStrFromQuickInfo = true\n  ): Promise<SchemaNode> {\n    const location = this.getLocation(node);\n    if (this._exports?.includes(typeStr)) {\n      return new TypeRefSchema(location, typeStr);\n    }\n    if (node.type && ts.isTypeNode(node.type)) {\n      // if a node has \"type\" prop, it has the type data of the node. this normally happens when the code has the type\n      // explicitly, e.g. `const str: string` vs implicitly `const str = 'some-string'`, which the node won't have \"type\"\n      return typeNodeToSchema(node.type, this);\n    }\n    /**\n     * tsserver has two different calls: \"definition\" and \"typeDefinition\".\n     * normally, we need the \"typeDefinition\" to get the type data of a node.\n     * sometimes, it has no data, for example when the node is of type TypeReference, and then using \"definition\" is\n     * helpful. (couldn't find a rule when to use each one. e.g. \"VariableDeclaration\" sometimes has data only in\n     * \"definition\" but it's not clear when/why).\n     */\n    const getDef = async () => {\n      const typeDefinition = await this.typeDefinition(node);\n      const headTypeDefinition = head(typeDefinition?.body);\n      if (headTypeDefinition) {\n        return headTypeDefinition;\n      }\n      const definition = await this.tsserver.getDefinition(node.getSourceFile().fileName, this.getLocation(node));\n      return head(definition?.body);\n    };\n    const definition = await getDef();\n\n    // when we can't figure out the component/package/type of this node, we'll use the typeStr as the type.\n    const unknownExactType = async () => {\n      if (isTypeStrFromQuickInfo) {\n        return new InferenceTypeSchema(location, typeStr || 'any');\n      }\n      const info = await this.getQuickInfo(node);\n      const type = parseTypeFromQuickInfo(info);\n      return new InferenceTypeSchema(location, type, typeStr);\n    };\n    if (!definition) {\n      return unknownExactType();\n    }\n\n    // the reason for this check is to avoid infinite loop when calling `this.jump` with the same file+location\n    const isDefInSameLocation = () => {\n      if (definition.file !== node.getSourceFile().fileName) {\n        return false;\n      }\n      const loc = this.getLocation(node);\n      return loc.line === definition.start.line && loc.character === definition.start.offset;\n    };\n\n    const file = this.findFileInComponent(definition.file);\n    if (file) {\n      if (isDefInSameLocation()) {\n        return unknownExactType();\n      }\n      const schemaNode = await this.jump(file, definition.start);\n      return schemaNode || unknownExactType();\n    }\n    return this.getTypeRefForExternalPath(typeStr, definition.file, location);\n  }\n\n  private getCompIdByPkgName(pkgName: string): ComponentID | undefined {\n    return this.componentDeps.find((dep) => dep.packageName === pkgName)?.componentId;\n  }\n\n  async getTypeRefForExternalNode(node: Node): Promise<TypeRefSchema> {\n    const info = await this.getQuickInfo(node);\n    const typeStr = parseTypeFromQuickInfo(info);\n    const location = this.getLocation(node);\n    const filePath = this.getPath(node);\n    return this.getTypeRefForExternalPath(typeStr, filePath, location);\n  }\n\n  async getTypeRefForExternalPath(typeStr: string, filePath: string, location: Location): Promise<TypeRefSchema> {\n    const compIdByPath = await this.extractor.getComponentIDByPath(filePath);\n    if (compIdByPath) {\n      return new TypeRefSchema(location, typeStr, compIdByPath);\n    }\n    const pkgName = this.parsePackageNameFromPath(filePath);\n    const compIdByPkg = this.getCompIdByPkgName(pkgName);\n    if (compIdByPkg) {\n      return new TypeRefSchema(location, typeStr, compIdByPkg);\n    }\n    return new TypeRefSchema(location, typeStr, undefined, pkgName);\n  }\n\n  async jsDocToDocSchema(node: Node): Promise<DocSchema | undefined> {\n    if (!canHaveJsDoc(node)) {\n      return undefined;\n    }\n    const jsDocs = getJsDoc(node);\n    if (!jsDocs.length) {\n      return undefined;\n    }\n    // not sure how common it is to have multiple JSDocs. never seen it before.\n    // regardless, in typescript implementation of methods like `getJSDocDeprecatedTag()`, they use the first one. (`getFirstJSDocTag()`)\n    const jsDoc = jsDocs[0];\n    const location = this.getLocation(jsDoc);\n    const comment = getTextOfJSDocComment(jsDoc.comment);\n    const tags = jsDoc.tags ? await pMapSeries(jsDoc.tags, (tag) => tagParser(tag, this, this.formatter)) : undefined;\n    return new DocSchema(location, jsDoc.getText(), comment, tags);\n  }\n}\n"],"mappings":"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"}

package/dist/transformers/utils/jsdoc-to-doc-schema.d.ts

@@ -2,4 +2,4 @@ import { JSDocTag } from 'typescript';
 import { TagSchema } from '@teambit/semantics.entities.semantic-schema';
 import { Formatter } from '@teambit/formatter';
 import { SchemaExtractorContext } from '../../schema-extractor-context';
-export declare function tagParser(tag: JSDocTag, context: SchemaExtractorContext, formatter: Formatter): Promise<TagSchema>;
+export declare function tagParser(tag: JSDocTag, context: SchemaExtractorContext, formatter?: Formatter): Promise<TagSchema>;

package/dist/transformers/utils/jsdoc-to-doc-schema.js

@@ -77,6 +77,7 @@ async function tagParser(tag, context, formatter) {
         const tagName = tag.tagName.getText(tag.getSourceFile());
         if (tagName === 'example') {
           const comment = (0, _typescript().getTextOfJSDocComment)(tag.comment);
+          if (!formatter) return simpleTag(tag, tagName, context);
           try {
             const formattedComment = comment && (await formatter.formatSnippet(comment));
             return new (_semanticsEntities().TagSchema)(context.getLocation(tag), tagName, formattedComment);

package/dist/transformers/utils/jsdoc-to-doc-schema.js.map

@@ -1 +1 @@
-{"version":3,"names":["tagParser","tag","context","formatter","kind","SyntaxKind","JSDocReturnTag","returnTag","JSDocPropertyTag","propertyLikeTag","JSDocParameterTag","JSDocAugmentsTag","simpleTag","TagName","augments","JSDocAuthorTag","author","JSDocClassTag","class","JSDocCallbackTag","callback","JSDocPublicTag","public","JSDocPrivateTag","private","JSDocProtectedTag","protected","JSDocReadonlyTag","readonly","JSDocOverrideTag","override","JSDocDeprecatedTag","deprecated","JSDocSeeTag","see","JSDocEnumTag","enum","JSDocThisTag","this","JSDocTypeTag","type","JSDocTemplateTag","template","JSDocTypedefTag","typedef","JSDocImplementsTag","implements","tagName","getText","getSourceFile","comment","getTextOfJSDocComment","formattedComment","formatSnippet","TagSchema","getLocation","e","typeExpression","typeNodeToSchema","undefined","ReturnTagSchema","PropertyLikeTagSchema","name"],"sources":["jsdoc-to-doc-schema.ts"],"sourcesContent":["/* eslint-disable no-fallthrough */\nimport {\n  getTextOfJSDocComment,\n  JSDocParameterTag,\n  JSDocPropertyLikeTag,\n  JSDocPropertyTag,\n  JSDocReturnTag,\n  JSDocTag,\n  SyntaxKind,\n} from 'typescript';\nimport {\n  PropertyLikeTagSchema,\n  ReturnTagSchema,\n  TagName,\n  TagSchema,\n} from '@teambit/semantics.entities.semantic-schema';\nimport { Formatter } from '@teambit/formatter';\nimport { SchemaExtractorContext } from '../../schema-extractor-context';\nimport { typeNodeToSchema } from './type-node-to-schema';\n\nexport async function tagParser(\n  tag: JSDocTag,\n  context: SchemaExtractorContext,\n  formatter: Formatter\n): Promise<TagSchema> {\n  // for some reason, in some cases, if `tag.getSourceFile()` is not provided to the `getText()`, it throws \"Cannot read property 'text' of undefined\"\n\n  switch (tag.kind) {\n    case SyntaxKind.JSDocReturnTag:\n      return returnTag(tag as JSDocReturnTag, context);\n    case SyntaxKind.JSDocPropertyTag:\n      return propertyLikeTag(tag as JSDocPropertyTag, context);\n    case SyntaxKind.JSDocParameterTag:\n      return propertyLikeTag(tag as JSDocParameterTag, context);\n    case SyntaxKind.JSDocAugmentsTag:\n      return simpleTag(tag, TagName.augments, context);\n    case SyntaxKind.JSDocAuthorTag:\n      return simpleTag(tag, TagName.author, context);\n    case SyntaxKind.JSDocClassTag:\n      return simpleTag(tag, TagName.class, context);\n    case SyntaxKind.JSDocCallbackTag:\n      return simpleTag(tag, TagName.callback, context);\n    case SyntaxKind.JSDocPublicTag:\n      return simpleTag(tag, TagName.public, context);\n    case SyntaxKind.JSDocPrivateTag:\n      return simpleTag(tag, TagName.private, context);\n    case SyntaxKind.JSDocProtectedTag:\n      return simpleTag(tag, TagName.protected, context);\n    case SyntaxKind.JSDocReadonlyTag:\n      return simpleTag(tag, TagName.readonly, context);\n    case SyntaxKind.JSDocOverrideTag:\n      return simpleTag(tag, TagName.override, context);\n    case SyntaxKind.JSDocDeprecatedTag:\n      return simpleTag(tag, TagName.deprecated, context);\n    case SyntaxKind.JSDocSeeTag:\n      return simpleTag(tag, TagName.see, context);\n    case SyntaxKind.JSDocEnumTag:\n      return simpleTag(tag, TagName.enum, context);\n    case SyntaxKind.JSDocThisTag:\n      return simpleTag(tag, TagName.this, context);\n    case SyntaxKind.JSDocTypeTag:\n      return simpleTag(tag, TagName.type, context);\n    case SyntaxKind.JSDocTemplateTag:\n      return simpleTag(tag, TagName.template, context);\n    case SyntaxKind.JSDocTypedefTag:\n      return simpleTag(tag, TagName.typedef, context);\n    case SyntaxKind.JSDocImplementsTag:\n      return simpleTag(tag, TagName.implements, context);\n    default: {\n      const tagName: TagName | string = tag.tagName.getText(tag.getSourceFile());\n      if (tagName === 'example') {\n        const comment = getTextOfJSDocComment(tag.comment);\n        try {\n          const formattedComment = comment && (await formatter.formatSnippet(comment));\n          return new TagSchema(context.getLocation(tag), tagName, formattedComment);\n        } catch (e) {\n          return simpleTag(tag, tagName, context);\n        }\n      }\n      return simpleTag(tag, tagName, context);\n    }\n  }\n}\n\nfunction simpleTag(tag: JSDocTag, tagName: TagName | string, context: SchemaExtractorContext): TagSchema {\n  return new TagSchema(context.getLocation(tag), tagName, getTextOfJSDocComment(tag.comment));\n}\n\nasync function returnTag(tag: JSDocReturnTag, context: SchemaExtractorContext) {\n  const type = tag.typeExpression?.type ? await typeNodeToSchema(tag.typeExpression?.type, context) : undefined;\n  return new ReturnTagSchema(context.getLocation(tag), getTextOfJSDocComment(tag.comment), type);\n}\n\nasync function propertyLikeTag(tag: JSDocPropertyLikeTag, context: SchemaExtractorContext) {\n  const type = tag.typeExpression?.type ? await typeNodeToSchema(tag.typeExpression?.type, context) : undefined;\n  return new PropertyLikeTagSchema(\n    context.getLocation(tag),\n    tag.name.getText(),\n    getTextOfJSDocComment(tag.comment),\n    type\n  );\n}\n"],"mappings":"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"}
+{"version":3,"names":["tagParser","tag","context","formatter","kind","SyntaxKind","JSDocReturnTag","returnTag","JSDocPropertyTag","propertyLikeTag","JSDocParameterTag","JSDocAugmentsTag","simpleTag","TagName","augments","JSDocAuthorTag","author","JSDocClassTag","class","JSDocCallbackTag","callback","JSDocPublicTag","public","JSDocPrivateTag","private","JSDocProtectedTag","protected","JSDocReadonlyTag","readonly","JSDocOverrideTag","override","JSDocDeprecatedTag","deprecated","JSDocSeeTag","see","JSDocEnumTag","enum","JSDocThisTag","this","JSDocTypeTag","type","JSDocTemplateTag","template","JSDocTypedefTag","typedef","JSDocImplementsTag","implements","tagName","getText","getSourceFile","comment","getTextOfJSDocComment","formattedComment","formatSnippet","TagSchema","getLocation","e","typeExpression","typeNodeToSchema","undefined","ReturnTagSchema","PropertyLikeTagSchema","name"],"sources":["jsdoc-to-doc-schema.ts"],"sourcesContent":["/* eslint-disable no-fallthrough */\nimport {\n  getTextOfJSDocComment,\n  JSDocParameterTag,\n  JSDocPropertyLikeTag,\n  JSDocPropertyTag,\n  JSDocReturnTag,\n  JSDocTag,\n  SyntaxKind,\n} from 'typescript';\nimport {\n  PropertyLikeTagSchema,\n  ReturnTagSchema,\n  TagName,\n  TagSchema,\n} from '@teambit/semantics.entities.semantic-schema';\nimport { Formatter } from '@teambit/formatter';\nimport { SchemaExtractorContext } from '../../schema-extractor-context';\nimport { typeNodeToSchema } from './type-node-to-schema';\n\nexport async function tagParser(\n  tag: JSDocTag,\n  context: SchemaExtractorContext,\n  formatter?: Formatter\n): Promise<TagSchema> {\n  // for some reason, in some cases, if `tag.getSourceFile()` is not provided to the `getText()`, it throws \"Cannot read property 'text' of undefined\"\n\n  switch (tag.kind) {\n    case SyntaxKind.JSDocReturnTag:\n      return returnTag(tag as JSDocReturnTag, context);\n    case SyntaxKind.JSDocPropertyTag:\n      return propertyLikeTag(tag as JSDocPropertyTag, context);\n    case SyntaxKind.JSDocParameterTag:\n      return propertyLikeTag(tag as JSDocParameterTag, context);\n    case SyntaxKind.JSDocAugmentsTag:\n      return simpleTag(tag, TagName.augments, context);\n    case SyntaxKind.JSDocAuthorTag:\n      return simpleTag(tag, TagName.author, context);\n    case SyntaxKind.JSDocClassTag:\n      return simpleTag(tag, TagName.class, context);\n    case SyntaxKind.JSDocCallbackTag:\n      return simpleTag(tag, TagName.callback, context);\n    case SyntaxKind.JSDocPublicTag:\n      return simpleTag(tag, TagName.public, context);\n    case SyntaxKind.JSDocPrivateTag:\n      return simpleTag(tag, TagName.private, context);\n    case SyntaxKind.JSDocProtectedTag:\n      return simpleTag(tag, TagName.protected, context);\n    case SyntaxKind.JSDocReadonlyTag:\n      return simpleTag(tag, TagName.readonly, context);\n    case SyntaxKind.JSDocOverrideTag:\n      return simpleTag(tag, TagName.override, context);\n    case SyntaxKind.JSDocDeprecatedTag:\n      return simpleTag(tag, TagName.deprecated, context);\n    case SyntaxKind.JSDocSeeTag:\n      return simpleTag(tag, TagName.see, context);\n    case SyntaxKind.JSDocEnumTag:\n      return simpleTag(tag, TagName.enum, context);\n    case SyntaxKind.JSDocThisTag:\n      return simpleTag(tag, TagName.this, context);\n    case SyntaxKind.JSDocTypeTag:\n      return simpleTag(tag, TagName.type, context);\n    case SyntaxKind.JSDocTemplateTag:\n      return simpleTag(tag, TagName.template, context);\n    case SyntaxKind.JSDocTypedefTag:\n      return simpleTag(tag, TagName.typedef, context);\n    case SyntaxKind.JSDocImplementsTag:\n      return simpleTag(tag, TagName.implements, context);\n    default: {\n      const tagName: TagName | string = tag.tagName.getText(tag.getSourceFile());\n      if (tagName === 'example') {\n        const comment = getTextOfJSDocComment(tag.comment);\n        if (!formatter) return simpleTag(tag, tagName, context);\n        try {\n          const formattedComment = comment && (await formatter.formatSnippet(comment));\n          return new TagSchema(context.getLocation(tag), tagName, formattedComment);\n        } catch (e) {\n          return simpleTag(tag, tagName, context);\n        }\n      }\n      return simpleTag(tag, tagName, context);\n    }\n  }\n}\n\nfunction simpleTag(tag: JSDocTag, tagName: TagName | string, context: SchemaExtractorContext): TagSchema {\n  return new TagSchema(context.getLocation(tag), tagName, getTextOfJSDocComment(tag.comment));\n}\n\nasync function returnTag(tag: JSDocReturnTag, context: SchemaExtractorContext) {\n  const type = tag.typeExpression?.type ? await typeNodeToSchema(tag.typeExpression?.type, context) : undefined;\n  return new ReturnTagSchema(context.getLocation(tag), getTextOfJSDocComment(tag.comment), type);\n}\n\nasync function propertyLikeTag(tag: JSDocPropertyLikeTag, context: SchemaExtractorContext) {\n  const type = tag.typeExpression?.type ? await typeNodeToSchema(tag.typeExpression?.type, context) : undefined;\n  return new PropertyLikeTagSchema(\n    context.getLocation(tag),\n    tag.name.getText(),\n    getTextOfJSDocComment(tag.comment),\n    type\n  );\n}\n"],"mappings":"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"}

package/dist/typescript.extractor.d.ts

@@ -22,7 +22,7 @@ export declare class TypeScriptExtractor implements SchemaExtractor {
     /**
      * extract a component schema.
      */
-    extract(component: Component, formatter: Formatter): Promise<APISchema>;
+    extract(component: Component, formatter?: Formatter): Promise<APISchema>;
     dispose(): void;
     computeExportedIdentifiers(node: Node, context: SchemaExtractorContext): Promise<import("./export-identifier").ExportIdentifier[]>;
     private createContext;

package/dist/typescript.extractor.js.map

@@ -1 +1 @@
-{"version":3,"names":["TypeScriptExtractor","constructor","tsconfig","schemaTransformerSlot","tsMain","rootPath","depResolver","workspace","undefined","parseSourceFile","file","sourceFile","ts","createSourceFile","path","contents","toString","ScriptTarget","Latest","extract","component","formatter","tsserver","getTsServer","mainFile","mainAst","context","createContext","exportNames","computeExportedIdentifiers","setExports","ExportList","moduleSchema","computeSchema","flatExportsRecursively","apiScheme","location","getLocation","APISchema","id","dispose","killTsServer","node","transformer","getTransformer","getIdentifiers","TransformerNotFound","componentDeps","getComponentDeps","SchemaExtractorContext","deps","getDependencies","getComponentDependencies","getTsserverClient","initTsserverClient","transform","getComponentIDByPath","getComponentIdByPath","transformers","flatten","values","find","singleTransformer","predicate","from","options","getTsconfig","config","compilerOptions","getAspect","TypescriptAspect","wsPath"],"sources":["typescript.extractor.ts"],"sourcesContent":["import ts, { Node, SourceFile } from 'typescript';\nimport { getTsconfig } from 'get-tsconfig';\nimport { SchemaExtractor } from '@teambit/schema';\nimport { TsserverClient } from '@teambit/ts-server';\nimport type { Workspace } from '@teambit/workspace';\nimport { ComponentDependency, DependencyResolverMain } from '@teambit/dependency-resolver';\nimport { SchemaNode, APISchema, ModuleSchema } from '@teambit/semantics.entities.semantic-schema';\nimport { Component } from '@teambit/component';\nimport { AbstractVinyl } from '@teambit/legacy/dist/consumer/component/sources';\nimport { EnvContext } from '@teambit/envs';\nimport { Formatter } from '@teambit/formatter';\nimport { flatten } from 'lodash';\nimport { TypescriptMain, SchemaTransformerSlot } from './typescript.main.runtime';\nimport { TransformerNotFound } from './exceptions';\nimport { SchemaExtractorContext } from './schema-extractor-context';\nimport { ExportList } from './export-list';\nimport { ExtractorOptions } from './extractor-options';\nimport { TypescriptAspect } from './typescript.aspect';\n\nexport class TypeScriptExtractor implements SchemaExtractor {\n  constructor(\n    private tsconfig: any,\n    private schemaTransformerSlot: SchemaTransformerSlot,\n    private tsMain: TypescriptMain,\n    private rootPath: string,\n    private depResolver: DependencyResolverMain,\n    private workspace: Workspace | undefined\n  ) {}\n\n  parseSourceFile(file: AbstractVinyl): SourceFile {\n    const sourceFile = ts.createSourceFile(\n      file.path,\n      file.contents.toString('utf8'),\n      ts.ScriptTarget.Latest,\n      true\n      /** don't pass the scriptKind, it'll be determined automatically by typescript by the filepath */\n    );\n    // leave this commented out, it's helpful when there are issues with ASTs. consider throwing in this case.\n    // console.log(\"sourceFile Errors\", file.path, sourceFile.parseDiagnostics);\n    return sourceFile;\n  }\n\n  /**\n   * extract a component schema.\n   */\n  async extract(component: Component, formatter: Formatter): Promise<APISchema> {\n    const tsserver = await this.getTsServer();\n    const mainFile = component.mainFile;\n    const mainAst = this.parseSourceFile(mainFile);\n    const context = await this.createContext(tsserver, component, formatter);\n    const exportNames = await this.computeExportedIdentifiers(mainAst, context);\n    context.setExports(new ExportList(exportNames));\n    const moduleSchema = (await this.computeSchema(mainAst, context)) as ModuleSchema;\n    moduleSchema.flatExportsRecursively();\n    const apiScheme = moduleSchema;\n    const location = context.getLocation(mainAst);\n\n    return new APISchema(location, apiScheme, component.id);\n  }\n\n  dispose() {\n    if (!this.tsserver) return;\n    this.tsserver.killTsServer();\n  }\n\n  async computeExportedIdentifiers(node: Node, context: SchemaExtractorContext) {\n    const transformer = this.getTransformer(node, context);\n    if (!transformer || !transformer.getIdentifiers) {\n      throw new TransformerNotFound(node, context.component, context.getLocation(node));\n    }\n    return transformer.getIdentifiers(node, context);\n  }\n\n  private async createContext(\n    tsserver: TsserverClient,\n    component: Component,\n    formatter: Formatter\n  ): Promise<SchemaExtractorContext> {\n    const componentDeps = await this.getComponentDeps(component);\n    return new SchemaExtractorContext(tsserver, component, this, componentDeps, formatter);\n  }\n\n  private async getComponentDeps(component: Component): Promise<ComponentDependency[]> {\n    const deps = await this.depResolver.getDependencies(component);\n    const componentDeps = deps.getComponentDependencies();\n    return componentDeps;\n  }\n\n  private tsserver: TsserverClient | undefined = undefined;\n\n  private async getTsServer() {\n    if (!this.tsserver) {\n      const tsserver = this.tsMain.getTsserverClient();\n      if (tsserver) {\n        this.tsserver = tsserver;\n        return tsserver;\n      }\n\n      this.tsserver = await this.tsMain.initTsserverClient(this.rootPath);\n      return this.tsserver;\n    }\n\n    return this.tsserver;\n  }\n\n  async computeSchema(node: Node, context: SchemaExtractorContext): Promise<SchemaNode> {\n    const transformer = this.getTransformer(node, context);\n    // leave the next line commented out, it is used for debugging\n    // console.log('transformer', transformer.constructor.name, node.getText());\n    return transformer.transform(node, context);\n  }\n\n  async getComponentIDByPath(file: string) {\n    if (!this.workspace) {\n      return null;\n    }\n    return this.workspace.getComponentIdByPath(file);\n  }\n\n  /**\n   * select the correct transformer for a node.\n   */\n  private getTransformer(node: Node, context: SchemaExtractorContext) {\n    const transformers = flatten(this.schemaTransformerSlot.values());\n    const transformer = transformers.find((singleTransformer) => singleTransformer.predicate(node));\n\n    if (!transformer) throw new TransformerNotFound(node, context.component, context.getLocation(node));\n\n    return transformer;\n  }\n\n  static from(options: ExtractorOptions) {\n    return (context: EnvContext) => {\n      const tsconfig = getTsconfig(options.tsconfig)?.config || { compilerOptions: options.compilerOptions };\n      const tsMain = context.getAspect<TypescriptMain>(TypescriptAspect.id);\n      // When loading the env from a scope you don't have a workspace\n      const wsPath = tsMain.workspace?.path || '';\n      return new TypeScriptExtractor(\n        tsconfig,\n        tsMain.schemaTransformerSlot,\n        tsMain,\n        wsPath,\n        tsMain.depResolver,\n        tsMain.workspace,\n      );\n    };\n  }\n}\n"],"mappings":"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"}
+{"version":3,"names":["TypeScriptExtractor","constructor","tsconfig","schemaTransformerSlot","tsMain","rootPath","depResolver","workspace","undefined","parseSourceFile","file","sourceFile","ts","createSourceFile","path","contents","toString","ScriptTarget","Latest","extract","component","formatter","tsserver","getTsServer","mainFile","mainAst","context","createContext","exportNames","computeExportedIdentifiers","setExports","ExportList","moduleSchema","computeSchema","flatExportsRecursively","apiScheme","location","getLocation","APISchema","id","dispose","killTsServer","node","transformer","getTransformer","getIdentifiers","TransformerNotFound","componentDeps","getComponentDeps","SchemaExtractorContext","deps","getDependencies","getComponentDependencies","getTsserverClient","initTsserverClient","transform","getComponentIDByPath","getComponentIdByPath","transformers","flatten","values","find","singleTransformer","predicate","from","options","getTsconfig","config","compilerOptions","getAspect","TypescriptAspect","wsPath"],"sources":["typescript.extractor.ts"],"sourcesContent":["import ts, { Node, SourceFile } from 'typescript';\nimport { getTsconfig } from 'get-tsconfig';\nimport { SchemaExtractor } from '@teambit/schema';\nimport { TsserverClient } from '@teambit/ts-server';\nimport type { Workspace } from '@teambit/workspace';\nimport { ComponentDependency, DependencyResolverMain } from '@teambit/dependency-resolver';\nimport { SchemaNode, APISchema, ModuleSchema } from '@teambit/semantics.entities.semantic-schema';\nimport { Component } from '@teambit/component';\nimport { AbstractVinyl } from '@teambit/legacy/dist/consumer/component/sources';\nimport { EnvContext } from '@teambit/envs';\nimport { Formatter } from '@teambit/formatter';\nimport { flatten } from 'lodash';\nimport { TypescriptMain, SchemaTransformerSlot } from './typescript.main.runtime';\nimport { TransformerNotFound } from './exceptions';\nimport { SchemaExtractorContext } from './schema-extractor-context';\nimport { ExportList } from './export-list';\nimport { ExtractorOptions } from './extractor-options';\nimport { TypescriptAspect } from './typescript.aspect';\n\nexport class TypeScriptExtractor implements SchemaExtractor {\n  constructor(\n    private tsconfig: any,\n    private schemaTransformerSlot: SchemaTransformerSlot,\n    private tsMain: TypescriptMain,\n    private rootPath: string,\n    private depResolver: DependencyResolverMain,\n    private workspace: Workspace | undefined\n  ) {}\n\n  parseSourceFile(file: AbstractVinyl): SourceFile {\n    const sourceFile = ts.createSourceFile(\n      file.path,\n      file.contents.toString('utf8'),\n      ts.ScriptTarget.Latest,\n      true\n      /** don't pass the scriptKind, it'll be determined automatically by typescript by the filepath */\n    );\n    // leave this commented out, it's helpful when there are issues with ASTs. consider throwing in this case.\n    // console.log(\"sourceFile Errors\", file.path, sourceFile.parseDiagnostics);\n    return sourceFile;\n  }\n\n  /**\n   * extract a component schema.\n   */\n  async extract(component: Component, formatter?: Formatter): Promise<APISchema> {\n    const tsserver = await this.getTsServer();\n    const mainFile = component.mainFile;\n    const mainAst = this.parseSourceFile(mainFile);\n    const context = await this.createContext(tsserver, component, formatter);\n    const exportNames = await this.computeExportedIdentifiers(mainAst, context);\n    context.setExports(new ExportList(exportNames));\n    const moduleSchema = (await this.computeSchema(mainAst, context)) as ModuleSchema;\n    moduleSchema.flatExportsRecursively();\n    const apiScheme = moduleSchema;\n    const location = context.getLocation(mainAst);\n\n    return new APISchema(location, apiScheme, component.id);\n  }\n\n  dispose() {\n    if (!this.tsserver) return;\n    this.tsserver.killTsServer();\n  }\n\n  async computeExportedIdentifiers(node: Node, context: SchemaExtractorContext) {\n    const transformer = this.getTransformer(node, context);\n    if (!transformer || !transformer.getIdentifiers) {\n      throw new TransformerNotFound(node, context.component, context.getLocation(node));\n    }\n    return transformer.getIdentifiers(node, context);\n  }\n\n  private async createContext(\n    tsserver: TsserverClient,\n    component: Component,\n    formatter?: Formatter\n  ): Promise<SchemaExtractorContext> {\n    const componentDeps = await this.getComponentDeps(component);\n    return new SchemaExtractorContext(tsserver, component, this, componentDeps, formatter);\n  }\n\n  private async getComponentDeps(component: Component): Promise<ComponentDependency[]> {\n    const deps = await this.depResolver.getDependencies(component);\n    const componentDeps = deps.getComponentDependencies();\n    return componentDeps;\n  }\n\n  private tsserver: TsserverClient | undefined = undefined;\n\n  private async getTsServer() {\n    if (!this.tsserver) {\n      const tsserver = this.tsMain.getTsserverClient();\n      if (tsserver) {\n        this.tsserver = tsserver;\n        return tsserver;\n      }\n\n      this.tsserver = await this.tsMain.initTsserverClient(this.rootPath);\n      return this.tsserver;\n    }\n\n    return this.tsserver;\n  }\n\n  async computeSchema(node: Node, context: SchemaExtractorContext): Promise<SchemaNode> {\n    const transformer = this.getTransformer(node, context);\n    // leave the next line commented out, it is used for debugging\n    // console.log('transformer', transformer.constructor.name, node.getText());\n    return transformer.transform(node, context);\n  }\n\n  async getComponentIDByPath(file: string) {\n    if (!this.workspace) {\n      return null;\n    }\n    return this.workspace.getComponentIdByPath(file);\n  }\n\n  /**\n   * select the correct transformer for a node.\n   */\n  private getTransformer(node: Node, context: SchemaExtractorContext) {\n    const transformers = flatten(this.schemaTransformerSlot.values());\n    const transformer = transformers.find((singleTransformer) => singleTransformer.predicate(node));\n\n    if (!transformer) throw new TransformerNotFound(node, context.component, context.getLocation(node));\n\n    return transformer;\n  }\n\n  static from(options: ExtractorOptions) {\n    return (context: EnvContext) => {\n      const tsconfig = getTsconfig(options.tsconfig)?.config || { compilerOptions: options.compilerOptions };\n      const tsMain = context.getAspect<TypescriptMain>(TypescriptAspect.id);\n      // When loading the env from a scope you don't have a workspace\n      const wsPath = tsMain.workspace?.path || '';\n      return new TypeScriptExtractor(\n        tsconfig,\n        tsMain.schemaTransformerSlot,\n        tsMain,\n        wsPath,\n        tsMain.depResolver,\n        tsMain.workspace\n      );\n    };\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@teambit/typescript",
-  "version": "0.0.955",
+  "version": "0.0.957",
   "homepage": "https://bit.dev/teambit/typescript/typescript",
   "main": "dist/index.js",
   "componentId": {
     "scope": "teambit.typescript",
     "name": "typescript",
-    "version": "0.0.955"
+    "version": "0.0.957"
   },
   "dependencies": {
     "lodash": "4.17.21",
@@ -20,23 +20,23 @@
     "core-js": "^3.0.0",
     "@babel/runtime": "7.20.0",
     "@teambit/harmony": "0.4.6",
-    "@teambit/compiler": "0.0.955",
+    "@teambit/compiler": "0.0.957",
     "@teambit/typescript.modules.ts-config-mutator": "0.0.76",
-    "@teambit/component": "0.0.955",
-    "@teambit/dependency-resolver": "0.0.955",
-    "@teambit/formatter": "0.0.506",
+    "@teambit/component": "0.0.957",
+    "@teambit/dependency-resolver": "0.0.957",
+    "@teambit/formatter": "0.0.508",
     "@teambit/semantics.entities.semantic-schema": "0.0.48",
     "@teambit/ts-server": "0.0.39",
-    "@teambit/aspect-loader": "0.0.955",
-    "@teambit/envs": "0.0.955",
-    "@teambit/logger": "0.0.733",
-    "@teambit/workspace": "0.0.955",
+    "@teambit/aspect-loader": "0.0.957",
+    "@teambit/envs": "0.0.957",
+    "@teambit/logger": "0.0.734",
+    "@teambit/workspace": "0.0.957",
     "@teambit/bit-error": "0.0.402",
-    "@teambit/builder": "0.0.955",
-    "@teambit/isolator": "0.0.955",
-    "@teambit/schema": "0.0.955",
-    "@teambit/cli": "0.0.640",
-    "@teambit/pkg": "0.0.955"
+    "@teambit/builder": "0.0.957",
+    "@teambit/isolator": "0.0.957",
+    "@teambit/schema": "0.0.957",
+    "@teambit/cli": "0.0.641",
+    "@teambit/pkg": "0.0.957"
   },
   "devDependencies": {
     "@types/lodash": "4.14.165",
@@ -52,7 +52,7 @@
     "@teambit/typescript.aspect-docs.typescript": "0.0.150"
   },
   "peerDependencies": {
-    "@teambit/legacy": "1.0.422",
+    "@teambit/legacy": "1.0.423",
     "react": "^16.8.0 || ^17.0.0",
     "react-dom": "^16.8.0 || ^17.0.0"
   },

package/transformers/utils/jsdoc-to-doc-schema.ts

@@ -21,7 +21,7 @@ import { typeNodeToSchema } from './type-node-to-schema';
 export async function tagParser(
   tag: JSDocTag,
   context: SchemaExtractorContext,
-  formatter: Formatter
+  formatter?: Formatter
 ): Promise<TagSchema> {
   // for some reason, in some cases, if `tag.getSourceFile()` is not provided to the `getText()`, it throws "Cannot read property 'text' of undefined"
 
@@ -70,6 +70,7 @@ export async function tagParser(
       const tagName: TagName | string = tag.tagName.getText(tag.getSourceFile());
       if (tagName === 'example') {
         const comment = getTextOfJSDocComment(tag.comment);
+        if (!formatter) return simpleTag(tag, tagName, context);
         try {
           const formattedComment = comment && (await formatter.formatSnippet(comment));
           return new TagSchema(context.getLocation(tag), tagName, formattedComment);