vscode-texinfo/src/preview.ts

110 lines
3.8 KiB
TypeScript

/**
* preview.ts
*
* @author CismonX <admin@cismon.net>
* @license MIT
*/
import * as path from 'path';
import * as vscode from 'vscode';
import Converter from './converter';
import Diagnosis from './diagnosis';
import Document from './document';
import Logger from './logger';
import Options from './options';
import { prompt, transformHtmlImageUri } from './utils';
/**
* Texinfo document preview.
*/
export default class Preview {
/**
* Create (if not yet created) and show preview for a Texinfo document.
*
* @param editor The editor where the document is being held.
*/
static async show(editor: vscode.TextEditor) {
const document = editor.document;
const documentContext = Document.get(document);
if (documentContext === undefined) return;
// Only show preview for saved files, as we're not gonna send document content to `makeinfo` via STDIN.
// Instead, the file will be loaded from disk.
if (document.isUntitled) {
if (!await prompt('Save this document to display preview.', 'Save')) return;
if (!await document.save()) return;
}
documentContext.initPreview().panel.reveal();
}
private readonly document = this.documentContext.document;
private readonly panel: vscode.WebviewPanel;
private readonly disposables = <vscode.Disposable[]>[];
/**
* Whether the preview is updating.
*/
private updating = false;
/**
* Whether a preview update request is pending.
*/
private pendingUpdate = false;
constructor(private readonly documentContext: Document) {
this.panel = vscode.window.createWebviewPanel('texinfo.preview', '', vscode.ViewColumn.Beside,
{ enableFindWidget: true, retainContextWhenHidden: true });
this.disposables.push(this.panel.onDidDispose(() => this.close()));
this.updateTitle();
this.updateWebview();
}
private updateTitle() {
const updating = this.updating ? '(Updating) ' : '';
const fileName = path.basename(this.document.fileName);
this.panel.title = `${updating}Preview ${fileName}`;
}
close() {
this.disposables.forEach(event => event.dispose());
this.panel.dispose();
this.documentContext.closePreview();
// Only show diagnostic information when the preview is active.
Diagnosis.instance.delete(this.document);
}
async updateWebview() {
if (this.updating) {
this.pendingUpdate = true;
return;
}
this.updating = true;
this.pendingUpdate = false;
// Inform the user that the preview is updating if `makeinfo` takes too long.
setTimeout(() => this.updating && this.updateTitle(), 500);
const { data, error } = await Converter.convertToHtml(this.document.fileName);
if (error) {
Logger.instance.log(error);
Diagnosis.instance.update(this.document, error);
}
if (data === undefined) {
prompt(`Failed to show preview for ${this.document.fileName}.`, 'Show log', true)
.then(result => result && Logger.instance.show());
} else if (Options.displayImage) {
const pathName = path.dirname(this.document.fileName);
// To display images in webviews, image URIs in HTML should be converted to VSCode-recognizable ones.
this.panel.webview.html = transformHtmlImageUri(data, src => {
const srcUri = vscode.Uri.file(pathName + '/' + src);
return this.panel.webview.asWebviewUri(srcUri).toString();
});
} else {
this.panel.webview.html = data;
}
this.updating = false;
this.updateTitle();
this.pendingUpdate && this.updateWebview();
}
}