Method provideHover

src/completions.ts:81–109

(document: vscode.TextDocument, position: vscode.Position)

export class HelpLinkHoverProvider implements vscode.HoverProvider {
    async provideHover(document: vscode.TextDocument, position: vscode.Position): Promise<vscode.Hover | null> {
        if(!config().get<boolean>('helpPanel.enableHoverLinks')){
            return null;
        }

        if (document.languageId === 'rmd') {
            const chunks = getChunks(document);
            const chunk = chunks.find((chunk) => chunk.language === 'r' && chunk.startLine < position.line && chunk.endLine > position.line);
            if (!chunk) {
                return null;
            }
        }

        const re = /([a-zA-Z0-9._:])+/;
        const wordRange = document.getWordRangeAtPosition(position, re);
        const token = document.getText(wordRange);
        const aliases = await globalRHelp?.getMatchingAliases(token) || [];
        const mds = aliases.map(a => {
            const cmdText = `${a.package}::${a.alias}`;
            const args = [`/library/${a.package}/html/${a.name}.html`];
            const encodedArgs = encodeURIComponent(JSON.stringify(args));
            const cmd = 'command:r.helpPanel.openForPath';
            const cmdUri = vscode.Uri.parse(`${cmd}?${encodedArgs}`);
            return `[\`${cmdText}\`](${cmdUri})`;
        });
        const md = new vscode.MarkdownString(mds.join('  \n'));
        md.isTrusted = true;
        return new vscode.Hover(md, wordRange);
    }
}