import type { ApiModel, Excerpt } from '@discordjs/api-extractor-model'; import { ExcerptTokenKind } from '@discordjs/api-extractor-model'; import { BuiltinDocumentationLinks } from '~/util/builtinDocumentationLinks'; import { DISCORD_API_TYPES_DOCS_URL } from '~/util/constants'; import { DocumentationLink } from './DocumentationLink'; import { ItemLink } from './ItemLink'; import { resolveItemURI } from './documentation/util'; export interface ExcerptTextProps { /** * The tokens to render. */ readonly excerpt: Excerpt; /** * The model to resolve item references from. */ readonly model: ApiModel; } /** * A component that renders excerpt tokens from an api item. */ export function ExcerptText({ model, excerpt }: ExcerptTextProps) { return ( {excerpt.spannedTokens.map((token, idx) => { if (token.kind === ExcerptTokenKind.Reference) { if (token.text in BuiltinDocumentationLinks) { const href = BuiltinDocumentationLinks[token.text as keyof typeof BuiltinDocumentationLinks]; return ( {token.text} ); } const source = token.canonicalReference?.source; const symbol = token.canonicalReference?.symbol; if (source && 'packageName' in source && source.packageName === 'discord-api-types' && symbol) { const { meaning, componentPath: path } = symbol; let href = DISCORD_API_TYPES_DOCS_URL; // dapi-types doesn't have routes for class members // so we can assume this member is for an enum if (meaning === 'member' && path && 'parent' in path) href += `/enum/${path.parent}#${path.component}`; else if (meaning === 'type' || meaning === 'var') href += `#${token.text}`; else href += `/${meaning}/${token.text}`; return ( {token.text} ); } const item = token.canonicalReference ? model.resolveDeclarationReference(token.canonicalReference!, model).resolvedApiItem : null; if (!item) { return token.text; } return ( {token.text} ); } return token.text.replace(/import\("discord-api-types(?:\/v\d+)?"\)\./, ''); })} ); }