Skip to content

Commit

Permalink
chore: import specific types only
Browse files Browse the repository at this point in the history
  • Loading branch information
ST-DDT committed Mar 1, 2022
1 parent 62cec8c commit ebc59ad
Showing 1 changed file with 15 additions and 8 deletions.
23 changes: 15 additions & 8 deletions scripts/apidoc/signature.ts
@@ -1,5 +1,12 @@
import sanitizeHtml from 'sanitize-html';
import * as TypeDoc from 'typedoc';
import type {
Comment,
ParameterReflection,
Reflection,
SignatureReflection,
SomeType,
} from 'typedoc';
import { ReflectionFlag, ReflectionKind } from 'typedoc';
import { createMarkdownRenderer } from 'vitepress';
import type {
Method,
Expand All @@ -18,7 +25,7 @@ export function prettifyMethodName(method: string): string {
);
}

export function toBlock(comment?: TypeDoc.Comment): string {
export function toBlock(comment?: Comment): string {
return (
(comment?.shortText.trim() || 'Missing') +
(comment?.text ? '\n\n' + comment.text : '')
Expand Down Expand Up @@ -59,7 +66,7 @@ function mdToHtml(md: string): string {
}

export function analyzeSignature(
signature: TypeDoc.SignatureReflection,
signature: SignatureReflection,
moduleName: string,
methodName: string
): Method {
Expand Down Expand Up @@ -145,7 +152,7 @@ export function analyzeSignature(
};
}

function analyzeParameter(parameter: TypeDoc.ParameterReflection): {
function analyzeParameter(parameter: ParameterReflection): {
parameters: MethodParameter[];
signature: string;
} {
Expand Down Expand Up @@ -180,7 +187,7 @@ function analyzeParameter(parameter: TypeDoc.ParameterReflection): {

function analyzeParameterOptions(
name: string,
parameterType: TypeDoc.SomeType
parameterType: SomeType
): MethodParameter[] {
if (parameterType.type === 'union') {
return [];
Expand All @@ -191,7 +198,7 @@ function analyzeParameterOptions(
// );
} else if (parameterType.type === 'reflection') {
const properties = parameterType.declaration.getChildrenByKind(
TypeDoc.ReflectionKind.Property
ReflectionKind.Property
);
return properties.map((property) => ({
name: `${name}.${property.name}${isOptional(property) ? '?' : ''}`,
Expand All @@ -203,6 +210,6 @@ function analyzeParameterOptions(
return [];
}

function isOptional(parameter: TypeDoc.Reflection): boolean {
return parameter.flags.hasFlag(TypeDoc.ReflectionFlag.Optional);
function isOptional(parameter: Reflection): boolean {
return parameter.flags.hasFlag(ReflectionFlag.Optional);
}

0 comments on commit ebc59ad

Please sign in to comment.