import * as vscode from 'vscode'; import * as ra from '../rust-analyzer-api'; import { Ctx, Cmd, Disposable } from '../ctx'; import { isRustDocument, RustEditor, isRustEditor, sleep } from '../util'; const AST_FILE_SCHEME = "rust-analyzer"; // Opens the virtual file that will show the syntax tree // // The contents of the file come from the `TextDocumentContentProvider` export function syntaxTree(ctx: Ctx): Cmd { const tdcp = new TextDocumentContentProvider(ctx); void new AstInspector(ctx); ctx.pushCleanup(vscode.workspace.registerTextDocumentContentProvider(AST_FILE_SCHEME, tdcp)); ctx.pushCleanup(vscode.languages.setLanguageConfiguration("ra_syntax_tree", { brackets: [["[", ")"]], })); return async () => { const editor = vscode.window.activeTextEditor; const rangeEnabled = !!editor && !editor.selection.isEmpty; const uri = rangeEnabled ? vscode.Uri.parse(`${tdcp.uri.toString()}?range=true`) : tdcp.uri; const document = await vscode.workspace.openTextDocument(uri); tdcp.eventEmitter.fire(uri); void await vscode.window.showTextDocument(document, { viewColumn: vscode.ViewColumn.Two, preserveFocus: true }); }; } class TextDocumentContentProvider implements vscode.TextDocumentContentProvider { readonly uri = vscode.Uri.parse('rust-analyzer://syntaxtree/tree.rast'); readonly eventEmitter = new vscode.EventEmitter(); constructor(private readonly ctx: Ctx) { vscode.workspace.onDidChangeTextDocument(this.onDidChangeTextDocument, this, ctx.subscriptions); vscode.window.onDidChangeActiveTextEditor(this.onDidChangeActiveTextEditor, this, ctx.subscriptions); } private onDidChangeTextDocument(event: vscode.TextDocumentChangeEvent) { if (isRustDocument(event.document)) { // We need to order this after language server updates, but there's no API for that. // Hence, good old sleep(). void sleep(10).then(() => this.eventEmitter.fire(this.uri)); } } private onDidChangeActiveTextEditor(editor: vscode.TextEditor | undefined) { if (editor && isRustEditor(editor)) { this.eventEmitter.fire(this.uri); } } provideTextDocumentContent(uri: vscode.Uri, ct: vscode.CancellationToken): vscode.ProviderResult { const rustEditor = this.ctx.activeRustEditor; if (!rustEditor) return ''; // When the range based query is enabled we take the range of the selection const range = uri.query === 'range=true' && !rustEditor.selection.isEmpty ? this.ctx.client.code2ProtocolConverter.asRange(rustEditor.selection) : null; const params = { textDocument: { uri: rustEditor.document.uri.toString() }, range, }; return this.ctx.client.sendRequest(ra.syntaxTree, params, ct); } get onDidChange(): vscode.Event { return this.eventEmitter.event; } } // FIXME: consider implementing this via the Tree View API? // https://code.visualstudio.com/api/extension-guides/tree-view class AstInspector implements vscode.HoverProvider, vscode.DefinitionProvider, Disposable { private readonly astDecorationType = vscode.window.createTextEditorDecorationType({ borderColor: new vscode.ThemeColor('rust_analyzer.syntaxTreeBorder'), borderStyle: "solid", borderWidth: "2px", }); private rustEditor: undefined | RustEditor; // Lazy rust token range -> syntax tree file range. private readonly rust2Ast = new Lazy(() => { const astEditor = this.findAstTextEditor(); if (!this.rustEditor || !astEditor) return undefined; const buf: [vscode.Range, vscode.Range][] = []; for (let i = 0; i < astEditor.document.lineCount; ++i) { const astLine = astEditor.document.lineAt(i); // Heuristically look for nodes with quoted text (which are token nodes) const isTokenNode = astLine.text.lastIndexOf('"') >= 0; if (!isTokenNode) continue; const rustRange = this.parseRustTextRange(this.rustEditor.document, astLine.text); if (!rustRange) continue; buf.push([rustRange, this.findAstNodeRange(astLine)]); } return buf; }); constructor(ctx: Ctx) { ctx.pushCleanup(vscode.languages.registerHoverProvider({ scheme: AST_FILE_SCHEME }, this)); ctx.pushCleanup(vscode.languages.registerDefinitionProvider({ language: "rust" }, this)); vscode.workspace.onDidCloseTextDocument(this.onDidCloseTextDocument, this, ctx.subscriptions); vscode.workspace.onDidChangeTextDocument(this.onDidChangeTextDocument, this, ctx.subscriptions); vscode.window.onDidChangeVisibleTextEditors(this.onDidChangeVisibleTextEditors, this, ctx.subscriptions); ctx.pushCleanup(this); } dispose() { this.setRustEditor(undefined); } private onDidChangeTextDocument(event: vscode.TextDocumentChangeEvent) { if (this.rustEditor && event.document.uri.toString() === this.rustEditor.document.uri.toString()) { this.rust2Ast.reset(); } } private onDidCloseTextDocument(doc: vscode.TextDocument) { if (this.rustEditor && doc.uri.toString() === this.rustEditor.document.uri.toString()) { this.setRustEditor(undefined); } } private onDidChangeVisibleTextEditors(editors: vscode.TextEditor[]) { if (!this.findAstTextEditor()) { this.setRustEditor(undefined); return; } this.setRustEditor(editors.find(isRustEditor)); } private findAstTextEditor(): undefined | vscode.TextEditor { return vscode.window.visibleTextEditors.find(it => it.document.uri.scheme === AST_FILE_SCHEME); } private setRustEditor(newRustEditor: undefined | RustEditor) { if (this.rustEditor && this.rustEditor !== newRustEditor) { this.rustEditor.setDecorations(this.astDecorationType, []); this.rust2Ast.reset(); } this.rustEditor = newRustEditor; } // additional positional params are omitted provideDefinition(doc: vscode.TextDocument, pos: vscode.Position): vscode.ProviderResult { if (!this.rustEditor || doc.uri.toString() !== this.rustEditor.document.uri.toString()) return; const astEditor = this.findAstTextEditor(); if (!astEditor) return; const rust2AstRanges = this.rust2Ast.get()?.find(([rustRange, _]) => rustRange.contains(pos)); if (!rust2AstRanges) return; const [rustFileRange, astFileRange] = rust2AstRanges; astEditor.revealRange(astFileRange); astEditor.selection = new vscode.Selection(astFileRange.start, astFileRange.end); return [{ targetRange: astFileRange, targetUri: astEditor.document.uri, originSelectionRange: rustFileRange, targetSelectionRange: astFileRange, }]; } // additional positional params are omitted provideHover(doc: vscode.TextDocument, hoverPosition: vscode.Position): vscode.ProviderResult { if (!this.rustEditor) return; const astFileLine = doc.lineAt(hoverPosition.line); const rustFileRange = this.parseRustTextRange(this.rustEditor.document, astFileLine.text); if (!rustFileRange) return; this.rustEditor.setDecorations(this.astDecorationType, [rustFileRange]); this.rustEditor.revealRange(rustFileRange); const rustSourceCode = this.rustEditor.document.getText(rustFileRange); const astFileRange = this.findAstNodeRange(astFileLine); return new vscode.Hover(["```rust\n" + rustSourceCode + "\n```"], astFileRange); } private findAstNodeRange(astLine: vscode.TextLine) { const lineOffset = astLine.range.start; const begin = lineOffset.translate(undefined, astLine.firstNonWhitespaceCharacterIndex); const end = lineOffset.translate(undefined, astLine.text.trimEnd().length); return new vscode.Range(begin, end); } private parseRustTextRange(doc: vscode.TextDocument, astLine: string): undefined | vscode.Range { const parsedRange = /\[(\d+); (\d+)\)/.exec(astLine); if (!parsedRange) return; const [begin, end] = parsedRange.slice(1).map(off => doc.positionAt(+off)); return new vscode.Range(begin, end); } } class Lazy { val: undefined | T; constructor(private readonly compute: () => undefined | T) { } get() { return this.val ?? (this.val = this.compute()); } reset() { this.val = undefined; } }