2017-09-06 19:13:34 +02:00
|
|
|
// @module: commonjs
|
2017-10-04 22:14:05 +02:00
|
|
|
// @skipLibCheck: true
|
2018-06-12 21:52:06 +02:00
|
|
|
// @includebuiltfile: typescriptServices.d.ts
|
|
|
|
// @noImplicitAny:true
|
|
|
|
// @strictNullChecks:true
|
2017-09-06 19:13:34 +02:00
|
|
|
|
2018-06-12 21:52:06 +02:00
|
|
|
// @filename: node_modules/typescript/index.d.ts
|
|
|
|
declare module "typescript" {
|
|
|
|
export = ts;
|
|
|
|
}
|
|
|
|
|
|
|
|
// @filename: APISample_jsdoc.ts
|
2017-09-06 19:13:34 +02:00
|
|
|
/*
|
|
|
|
* Note: This test is a public API sample. The original sources can be found
|
|
|
|
* at: https://github.com/YousefED/typescript-json-schema
|
|
|
|
* https://github.com/vega/ts-json-schema-generator
|
|
|
|
* Please log a "breaking change" issue for any API breaking change affecting this issue
|
|
|
|
*/
|
|
|
|
|
|
|
|
declare var console: any;
|
|
|
|
|
|
|
|
import * as ts from "typescript";
|
|
|
|
|
|
|
|
// excerpted from https://github.com/YousefED/typescript-json-schema
|
|
|
|
// (converted from a method and modified; for example, `this: any` to compensate, among other changes)
|
|
|
|
function parseCommentsIntoDefinition(this: any,
|
|
|
|
symbol: ts.Symbol,
|
|
|
|
definition: {description?: string, [s: string]: string | undefined},
|
|
|
|
otherAnnotations: { [s: string]: true}): void {
|
|
|
|
if (!symbol) {
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
// the comments for a symbol
|
2017-11-06 22:18:21 +01:00
|
|
|
let comments = symbol.getDocumentationComment(undefined);
|
2017-09-06 19:13:34 +02:00
|
|
|
|
|
|
|
if (comments.length) {
|
|
|
|
definition.description = comments.map(comment => comment.kind === "lineBreak" ? comment.text : comment.text.trim().replace(/\r\n/g, "\n")).join("");
|
|
|
|
}
|
|
|
|
|
|
|
|
// jsdocs are separate from comments
|
|
|
|
const jsdocs = symbol.getJsDocTags();
|
|
|
|
jsdocs.forEach(doc => {
|
|
|
|
// if we have @TJS-... annotations, we have to parse them
|
|
|
|
const { name, text } = doc;
|
|
|
|
if (this.userValidationKeywords[name]) {
|
|
|
|
definition[name] = this.parseValue(text);
|
|
|
|
} else {
|
|
|
|
// special annotations
|
|
|
|
otherAnnotations[doc.name] = true;
|
|
|
|
}
|
|
|
|
});
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// excerpted from https://github.com/vega/ts-json-schema-generator
|
|
|
|
export interface Annotations {
|
|
|
|
[name: string]: any;
|
|
|
|
}
|
|
|
|
function getAnnotations(this: any, node: ts.Node): Annotations | undefined {
|
|
|
|
const symbol: ts.Symbol = (node as any).symbol;
|
|
|
|
if (!symbol) {
|
|
|
|
return undefined;
|
|
|
|
}
|
|
|
|
|
|
|
|
const jsDocTags: ts.JSDocTagInfo[] = symbol.getJsDocTags();
|
|
|
|
if (!jsDocTags || !jsDocTags.length) {
|
|
|
|
return undefined;
|
|
|
|
}
|
|
|
|
|
|
|
|
const annotations: Annotations = jsDocTags.reduce((result: Annotations, jsDocTag: ts.JSDocTagInfo) => {
|
|
|
|
const value = this.parseJsDocTag(jsDocTag);
|
|
|
|
if (value !== undefined) {
|
|
|
|
result[jsDocTag.name] = value;
|
|
|
|
}
|
|
|
|
|
|
|
|
return result;
|
|
|
|
}, {});
|
|
|
|
return Object.keys(annotations).length ? annotations : undefined;
|
|
|
|
}
|
|
|
|
|
|
|
|
// these examples are artificial and mostly nonsensical
|
|
|
|
function parseSpecificTags(node: ts.Node) {
|
|
|
|
if (node.kind === ts.SyntaxKind.Parameter) {
|
|
|
|
return ts.getJSDocParameterTags(node as ts.ParameterDeclaration);
|
|
|
|
}
|
|
|
|
if (node.kind === ts.SyntaxKind.FunctionDeclaration) {
|
|
|
|
const func = node as ts.FunctionDeclaration;
|
|
|
|
if (ts.hasJSDocParameterTags(func)) {
|
|
|
|
const flat: ts.JSDocTag[] = [];
|
|
|
|
for (const tags of func.parameters.map(ts.getJSDocParameterTags)) {
|
|
|
|
if (tags) flat.push(...tags);
|
|
|
|
}
|
|
|
|
return flat;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
function getReturnTypeFromJSDoc(node: ts.Node) {
|
|
|
|
if (node.kind === ts.SyntaxKind.FunctionDeclaration) {
|
|
|
|
return ts.getJSDocReturnType(node);
|
|
|
|
}
|
|
|
|
let type = ts.getJSDocType(node);
|
|
|
|
if (type && type.kind === ts.SyntaxKind.FunctionType) {
|
|
|
|
return (type as ts.FunctionTypeNode).type;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
function getAllTags(node: ts.Node) {
|
|
|
|
ts.getJSDocTags(node);
|
|
|
|
}
|
|
|
|
|
|
|
|
function getSomeOtherTags(node: ts.Node) {
|
|
|
|
const tags: (ts.JSDocTag | undefined)[] = [];
|
|
|
|
tags.push(ts.getJSDocAugmentsTag(node));
|
|
|
|
tags.push(ts.getJSDocClassTag(node));
|
|
|
|
tags.push(ts.getJSDocReturnTag(node));
|
|
|
|
const type = ts.getJSDocTypeTag(node);
|
|
|
|
if (type) {
|
|
|
|
tags.push(type);
|
|
|
|
}
|
|
|
|
tags.push(ts.getJSDocTemplateTag(node));
|
|
|
|
return tags;
|
|
|
|
}
|