@theia/preview 1.67.0-next.56 → 1.67.0-next.59

package/lib/browser/preview-contribution.d.ts

@@ -0,0 +1,51 @@
+import { Widget } from '@theia/core/shared/@lumino/widgets';
+import { FrontendApplicationContribution, WidgetOpenerOptions, NavigatableWidgetOpenHandler } from '@theia/core/lib/browser';
+import { EditorManager, TextEditor, EditorWidget } from '@theia/editor/lib/browser';
+import { CommandContribution, CommandRegistry, Command, MenuContribution, MenuModelRegistry, Disposable } from '@theia/core/lib/common';
+import { TabBarToolbarContribution, TabBarToolbarRegistry } from '@theia/core/lib/browser/shell/tab-bar-toolbar';
+import URI from '@theia/core/lib/common/uri';
+import { Position } from '@theia/core/shared/vscode-languageserver-protocol';
+import { PreviewWidget } from './preview-widget';
+import { PreviewHandlerProvider } from './preview-handler';
+import { PreviewPreferences } from '../common/preview-preferences';
+export declare namespace PreviewCommands {
+    /**
+     * No `label`. Otherwise, it would show up in the `Command Palette` and we already have the `Preview` open handler.
+     * See in (`WorkspaceCommandContribution`)[https://bit.ly/2DncrSD].
+     */
+    const OPEN: Command;
+    const OPEN_SOURCE: Command;
+}
+export interface PreviewOpenerOptions extends WidgetOpenerOptions {
+    originUri?: URI;
+}
+export declare class PreviewContribution extends NavigatableWidgetOpenHandler<PreviewWidget> implements CommandContribution, MenuContribution, FrontendApplicationContribution, TabBarToolbarContribution {
+    readonly id = "code-editor-preview";
+    readonly label: string;
+    protected readonly editorManager: EditorManager;
+    protected readonly previewHandlerProvider: PreviewHandlerProvider;
+    protected readonly preferences: PreviewPreferences;
+    protected readonly synchronizedUris: Set<string>;
+    protected scrollSyncLockOn: 'preview' | 'editor' | undefined;
+    protected scrollSyncLockTimeout: number | undefined;
+    onStart(): void;
+    protected lockScrollSync(on: 'preview' | 'editor', delay?: number): Promise<void>;
+    protected registerEditorAndPreviewSync(source: PreviewWidget | EditorWidget): Promise<void>;
+    protected revealSourceLineInPreview(previewWidget: PreviewWidget, position: Position): void;
+    protected synchronizeScrollToEditor(previewWidget: PreviewWidget, editor: TextEditor): Disposable;
+    protected registerOpenOnDoubleClick(ref: PreviewWidget): void;
+    canHandle(uri: URI): number;
+    protected get openByDefault(): boolean;
+    open(uri: URI, options?: PreviewOpenerOptions): Promise<PreviewWidget>;
+    protected serializeUri(uri: URI): string;
+    protected resolveOpenerOptions(options?: PreviewOpenerOptions): Promise<PreviewOpenerOptions>;
+    registerCommands(registry: CommandRegistry): void;
+    registerMenus(menus: MenuModelRegistry): void;
+    registerToolbarItems(registry: TabBarToolbarRegistry): void;
+    protected canHandleEditorUri(widget?: Widget): boolean;
+    protected getCurrentEditorUri(widget?: Widget): URI | undefined;
+    protected getCurrentEditor(widget?: Widget): EditorWidget | undefined;
+    protected openForEditor(widget?: Widget): Promise<void>;
+    protected openSource(ref: PreviewWidget): Promise<EditorWidget>;
+}
+//# sourceMappingURL=preview-contribution.d.ts.map

package/lib/browser/preview-contribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-contribution.d.ts","sourceRoot":"","sources":["../../src/browser/preview-contribution.ts"],"names":[],"mappings":"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"}

package/lib/browser/preview-contribution.js

@@ -0,0 +1,256 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2018 TypeFox and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PreviewContribution = exports.PreviewCommands = void 0;
+const tslib_1 = require("tslib");
+const inversify_1 = require("@theia/core/shared/inversify");
+const browser_1 = require("@theia/core/lib/browser");
+const browser_2 = require("@theia/editor/lib/browser");
+const common_1 = require("@theia/core/lib/common");
+const mini_browser_open_handler_1 = require("@theia/mini-browser/lib/browser/mini-browser-open-handler");
+const preview_widget_1 = require("./preview-widget");
+const preview_handler_1 = require("./preview-handler");
+const preview_uri_1 = require("./preview-uri");
+const preview_preferences_1 = require("../common/preview-preferences");
+const nls_1 = require("@theia/core/lib/common/nls");
+const debounce = require("@theia/core/shared/lodash.debounce");
+var PreviewCommands;
+(function (PreviewCommands) {
+    /**
+     * No `label`. Otherwise, it would show up in the `Command Palette` and we already have the `Preview` open handler.
+     * See in (`WorkspaceCommandContribution`)[https://bit.ly/2DncrSD].
+     */
+    PreviewCommands.OPEN = common_1.Command.toLocalizedCommand({
+        id: 'preview:open',
+        label: 'Open Preview',
+        iconClass: (0, browser_1.codicon)('open-preview')
+    }, 'vscode.markdown-language-features/package/markdown.preview.title');
+    PreviewCommands.OPEN_SOURCE = {
+        id: 'preview.open.source',
+        iconClass: (0, browser_1.codicon)('go-to-file')
+    };
+})(PreviewCommands || (exports.PreviewCommands = PreviewCommands = {}));
+let PreviewContribution = class PreviewContribution extends browser_1.NavigatableWidgetOpenHandler {
+    constructor() {
+        super(...arguments);
+        this.id = preview_uri_1.PreviewUri.id;
+        this.label = nls_1.nls.localize(mini_browser_open_handler_1.MiniBrowserCommands.PREVIEW_CATEGORY_KEY, mini_browser_open_handler_1.MiniBrowserCommands.PREVIEW_CATEGORY);
+        this.synchronizedUris = new Set();
+        this.scrollSyncLockOn = undefined;
+    }
+    onStart() {
+        this.onCreated(previewWidget => {
+            this.registerOpenOnDoubleClick(previewWidget);
+            this.registerEditorAndPreviewSync(previewWidget);
+        });
+        this.editorManager.onCreated(editorWidget => {
+            this.registerEditorAndPreviewSync(editorWidget);
+        });
+    }
+    async lockScrollSync(on, delay = 50) {
+        this.scrollSyncLockOn = on;
+        if (this.scrollSyncLockTimeout) {
+            window.clearTimeout(this.scrollSyncLockTimeout);
+        }
+        this.scrollSyncLockTimeout = window.setTimeout(() => {
+            this.scrollSyncLockOn = undefined;
+        }, delay);
+    }
+    async registerEditorAndPreviewSync(source) {
+        let uri;
+        let editorWidget;
+        let previewWidget;
+        if (source instanceof browser_2.EditorWidget) {
+            editorWidget = source;
+            uri = editorWidget.editor.uri.toString();
+            previewWidget = await this.getWidget(editorWidget.editor.uri);
+        }
+        else {
+            previewWidget = source;
+            uri = previewWidget.getUri().toString();
+            editorWidget = await this.editorManager.getByUri(previewWidget.getUri());
+        }
+        if (!previewWidget || !editorWidget || !uri) {
+            return;
+        }
+        if (this.synchronizedUris.has(uri)) {
+            return;
+        }
+        const syncDisposables = new common_1.DisposableCollection();
+        previewWidget.disposed.connect(() => syncDisposables.dispose());
+        editorWidget.disposed.connect(() => syncDisposables.dispose());
+        const editor = editorWidget.editor;
+        syncDisposables.push(editor.onScrollChanged(debounce(() => {
+            if (this.scrollSyncLockOn === 'editor') {
+                // avoid recursive scroll synchronization
+                return;
+            }
+            this.lockScrollSync('preview');
+            const range = editor.getVisibleRanges();
+            if (range.length > 0) {
+                this.revealSourceLineInPreview(previewWidget, range[0].start);
+            }
+        }), 100));
+        syncDisposables.push(this.synchronizeScrollToEditor(previewWidget, editor));
+        this.synchronizedUris.add(uri);
+        syncDisposables.push(common_1.Disposable.create(() => this.synchronizedUris.delete(uri)));
+    }
+    revealSourceLineInPreview(previewWidget, position) {
+        previewWidget.revealForSourceLine(position.line);
+    }
+    synchronizeScrollToEditor(previewWidget, editor) {
+        return previewWidget.onDidScroll(sourceLine => {
+            if (this.scrollSyncLockOn === 'preview') {
+                // avoid recursive scroll synchronization
+                return;
+            }
+            const line = Math.floor(sourceLine);
+            this.lockScrollSync('editor'); // avoid recursive scroll synchronization
+            editor.revealRange({
+                start: {
+                    line,
+                    character: 0
+                },
+                end: {
+                    line: line + 1,
+                    character: 0
+                }
+            }, { at: 'top' });
+        });
+    }
+    registerOpenOnDoubleClick(ref) {
+        const disposable = ref.onDidDoubleClick(async (location) => {
+            const { editor } = await this.openSource(ref);
+            editor.revealPosition(location.range.start);
+            editor.selection = {
+                ...location.range,
+                direction: 'ltr'
+            };
+            ref.revealForSourceLine(location.range.start.line);
+        });
+        ref.disposed.connect(() => disposable.dispose());
+    }
+    canHandle(uri) {
+        if (!this.previewHandlerProvider.canHandle(uri)) {
+            return 0;
+        }
+        const editorPriority = this.editorManager.canHandle(uri);
+        if (editorPriority === 0) {
+            return 200;
+        }
+        if (preview_uri_1.PreviewUri.match(uri)) {
+            return editorPriority * 2;
+        }
+        return editorPriority * (this.openByDefault ? 2 : 0.5);
+    }
+    get openByDefault() {
+        return this.preferences['preview.openByDefault'];
+    }
+    async open(uri, options) {
+        const resolvedOptions = await this.resolveOpenerOptions(options);
+        return super.open(uri, resolvedOptions);
+    }
+    serializeUri(uri) {
+        return super.serializeUri(preview_uri_1.PreviewUri.decode(uri));
+    }
+    async resolveOpenerOptions(options) {
+        const resolved = { mode: 'activate', ...options };
+        if (resolved.originUri) {
+            const ref = await this.getWidget(resolved.originUri);
+            if (ref) {
+                resolved.widgetOptions = { ...resolved.widgetOptions, ref };
+            }
+        }
+        return resolved;
+    }
+    registerCommands(registry) {
+        registry.registerCommand(PreviewCommands.OPEN, {
+            execute: widget => this.openForEditor(widget),
+            isEnabled: widget => this.canHandleEditorUri(widget),
+            isVisible: widget => this.canHandleEditorUri(widget)
+        });
+        registry.registerCommand(PreviewCommands.OPEN_SOURCE, {
+            execute: widget => this.openSource(widget),
+            isEnabled: widget => widget instanceof preview_widget_1.PreviewWidget,
+            isVisible: widget => widget instanceof preview_widget_1.PreviewWidget
+        });
+    }
+    registerMenus(menus) {
+        menus.registerMenuAction(browser_2.EditorContextMenu.NAVIGATION, {
+            commandId: PreviewCommands.OPEN.id
+        });
+    }
+    registerToolbarItems(registry) {
+        registry.registerItem({
+            id: PreviewCommands.OPEN.id,
+            command: PreviewCommands.OPEN.id,
+            tooltip: nls_1.nls.localize('vscode.markdown-language-features/package/markdown.previewSide.title', 'Open Preview to the Side')
+        });
+        registry.registerItem({
+            id: PreviewCommands.OPEN_SOURCE.id,
+            command: PreviewCommands.OPEN_SOURCE.id,
+            tooltip: nls_1.nls.localize('vscode.markdown-language-features/package/markdown.showSource.title', 'Open Source')
+        });
+    }
+    canHandleEditorUri(widget) {
+        const uri = this.getCurrentEditorUri(widget);
+        return !!uri && this.previewHandlerProvider.canHandle(uri);
+    }
+    getCurrentEditorUri(widget) {
+        const current = this.getCurrentEditor(widget);
+        return current && current.editor.uri;
+    }
+    getCurrentEditor(widget) {
+        const current = widget ? widget : this.editorManager.currentEditor;
+        return current instanceof browser_2.EditorWidget && current || undefined;
+    }
+    async openForEditor(widget) {
+        const ref = this.getCurrentEditor(widget);
+        if (!ref) {
+            return;
+        }
+        await this.open(ref.editor.uri, {
+            mode: 'reveal',
+            widgetOptions: { ref, mode: 'open-to-right' }
+        });
+    }
+    async openSource(ref) {
+        if (ref instanceof preview_widget_1.PreviewWidget) {
+            return this.editorManager.open(ref.uri, {
+                widgetOptions: { ref, mode: 'tab-after' }
+            });
+        }
+    }
+};
+exports.PreviewContribution = PreviewContribution;
+tslib_1.__decorate([
+    (0, inversify_1.inject)(browser_2.EditorManager),
+    tslib_1.__metadata("design:type", browser_2.EditorManager)
+], PreviewContribution.prototype, "editorManager", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(preview_handler_1.PreviewHandlerProvider),
+    tslib_1.__metadata("design:type", preview_handler_1.PreviewHandlerProvider)
+], PreviewContribution.prototype, "previewHandlerProvider", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(preview_preferences_1.PreviewPreferences),
+    tslib_1.__metadata("design:type", Object)
+], PreviewContribution.prototype, "preferences", void 0);
+exports.PreviewContribution = PreviewContribution = tslib_1.__decorate([
+    (0, inversify_1.injectable)()
+    // eslint-disable-next-line max-len
+], PreviewContribution);
+//# sourceMappingURL=preview-contribution.js.map

package/lib/browser/preview-contribution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-contribution.js","sourceRoot":"","sources":["../../src/browser/preview-contribution.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,yCAAyC;AACzC,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;;;AAEhF,4DAAkE;AAElE,qDAAsI;AACtI,uDAAuG;AACvG,mDAA8J;AAE9J,yGAAgG;AAGhG,qDAAiD;AACjD,uDAA2D;AAC3D,+CAA2C;AAC3C,uEAAmE;AACnE,oDAAiD;AAEjD,+DAAgE;AAEhE,IAAiB,eAAe,CAc/B;AAdD,WAAiB,eAAe;IAC5B;;;OAGG;IACU,oBAAI,GAAG,gBAAO,CAAC,kBAAkB,CAAC;QAC3C,EAAE,EAAE,cAAc;QAClB,KAAK,EAAE,cAAc;QACrB,SAAS,EAAE,IAAA,iBAAO,EAAC,cAAc,CAAC;KACrC,EAAE,kEAAkE,CAAC,CAAC;IAC1D,2BAAW,GAAY;QAChC,EAAE,EAAE,qBAAqB;QACzB,SAAS,EAAE,IAAA,iBAAO,EAAC,YAAY,CAAC;KACnC,CAAC;AACN,CAAC,EAdgB,eAAe,+BAAf,eAAe,QAc/B;AAQM,IAAM,mBAAmB,GAAzB,MAAM,mBAAoB,SAAQ,sCAA2C;IAA7E;;QAEM,OAAE,GAAG,wBAAU,CAAC,EAAE,CAAC;QACnB,UAAK,GAAG,SAAG,CAAC,QAAQ,CAAC,+CAAmB,CAAC,oBAAoB,EAAE,+CAAmB,CAAC,gBAAgB,CAAC,CAAC;QAW3F,qBAAgB,GAAG,IAAI,GAAG,EAAU,CAAC;QAE9C,qBAAgB,GAAqC,SAAS,CAAC;IA+M7E,CAAC;IA3MG,OAAO;QACH,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,EAAE;YAC3B,IAAI,CAAC,yBAAyB,CAAC,aAAa,CAAC,CAAC;YAC9C,IAAI,CAAC,4BAA4B,CAAC,aAAa,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,YAAY,CAAC,EAAE;YACxC,IAAI,CAAC,4BAA4B,CAAC,YAAY,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;IACP,CAAC;IAES,KAAK,CAAC,cAAc,CAAC,EAAwB,EAAE,QAAgB,EAAE;QACvE,IAAI,CAAC,gBAAgB,GAAG,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAC7B,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACpD,CAAC;QACD,IAAI,CAAC,qBAAqB,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE;YAChD,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAC;QACtC,CAAC,EAAE,KAAK,CAAC,CAAC;IACd,CAAC;IAES,KAAK,CAAC,4BAA4B,CAAC,MAAoC;QAC7E,IAAI,GAAW,CAAC;QAChB,IAAI,YAAsC,CAAC;QAC3C,IAAI,aAAwC,CAAC;QAC7C,IAAI,MAAM,YAAY,sBAAY,EAAE,CAAC;YACjC,YAAY,GAAG,MAAM,CAAC;YACtB,GAAG,GAAG,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YACzC,aAAa,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAClE,CAAC;aAAM,CAAC;YACJ,aAAa,GAAG,MAAM,CAAC;YACvB,GAAG,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC;YACxC,YAAY,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7E,CAAC;QACD,IAAI,CAAC,aAAa,IAAI,CAAC,YAAY,IAAI,CAAC,GAAG,EAAE,CAAC;YAC1C,OAAO;QACX,CAAC;QACD,IAAI,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACjC,OAAO;QACX,CAAC;QACD,MAAM,eAAe,GAAG,IAAI,6BAAoB,EAAE,CAAC;QACnD,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC,CAAC;QAChE,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC,CAAC;QAE/D,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC;QACnC,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,GAAG,EAAE;YACtD,IAAI,IAAI,CAAC,gBAAgB,KAAK,QAAQ,EAAE,CAAC;gBACrC,yCAAyC;gBACzC,OAAO;YACX,CAAC;YACD,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;YAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,gBAAgB,EAAE,CAAC;YACxC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACnB,IAAI,CAAC,yBAAyB,CAAC,aAAc,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACnE,CAAC;QACL,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QACV,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,yBAAyB,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC;QAE5E,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC/B,eAAe,CAAC,IAAI,CAAC,mBAAU,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACrF,CAAC;IAES,yBAAyB,CAAC,aAA4B,EAAE,QAAkB;QAChF,aAAa,CAAC,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACrD,CAAC;IAES,yBAAyB,CAAC,aAA4B,EAAE,MAAkB;QAChF,OAAO,aAAa,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE;YAC1C,IAAI,IAAI,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;gBACtC,yCAAyC;gBACzC,OAAO;YACX,CAAC;YACD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YACpC,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,yCAAyC;YACxE,MAAM,CAAC,WAAW,CAAC;gBACf,KAAK,EAAE;oBACH,IAAI;oBACJ,SAAS,EAAE,CAAC;iBACf;gBACD,GAAG,EAAE;oBACD,IAAI,EAAE,IAAI,GAAG,CAAC;oBACd,SAAS,EAAE,CAAC;iBACf;aACJ,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACtB,CAAC,CAAC,CAAC;IACP,CAAC;IAES,yBAAyB,CAAC,GAAkB;QAClD,MAAM,UAAU,GAAG,GAAG,CAAC,gBAAgB,CAAC,KAAK,EAAC,QAAQ,EAAC,EAAE;YACrD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YAC9C,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC5C,MAAM,CAAC,SAAS,GAAG;gBACf,GAAG,QAAQ,CAAC,KAAK;gBACjB,SAAS,EAAE,KAAK;aACnB,CAAC;YACF,GAAG,CAAC,mBAAmB,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvD,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,SAAS,CAAC,GAAQ;QACd,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;YAC9C,OAAO,CAAC,CAAC;QACb,CAAC;QACD,MAAM,cAAc,GAAG,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACzD,IAAI,cAAc,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,GAAG,CAAC;QACf,CAAC;QACD,IAAI,wBAAU,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,OAAO,cAAc,GAAG,CAAC,CAAC;QAC9B,CAAC;QACD,OAAO,cAAc,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC3D,CAAC;IAED,IAAc,aAAa;QACvB,OAAO,IAAI,CAAC,WAAW,CAAC,uBAAuB,CAAC,CAAC;IACrD,CAAC;IAEQ,KAAK,CAAC,IAAI,CAAC,GAAQ,EAAE,OAA8B;QACxD,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACjE,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IAC5C,CAAC;IACkB,YAAY,CAAC,GAAQ;QACpC,OAAO,KAAK,CAAC,YAAY,CAAC,wBAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACtD,CAAC;IAES,KAAK,CAAC,oBAAoB,CAAC,OAA8B;QAC/D,MAAM,QAAQ,GAAyB,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,OAAO,EAAE,CAAC;QACxE,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;YACrB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YACrD,IAAI,GAAG,EAAE,CAAC;gBACN,QAAQ,CAAC,aAAa,GAAG,EAAE,GAAG,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE,CAAC;YAChE,CAAC;QACL,CAAC;QACD,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED,gBAAgB,CAAC,QAAyB;QACtC,QAAQ,CAAC,eAAe,CAAC,eAAe,CAAC,IAAI,EAAE;YAC3C,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC;YAC7C,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC;YACpD,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC;SACvD,CAAC,CAAC;QACH,QAAQ,CAAC,eAAe,CAAC,eAAe,CAAC,WAAW,EAAE;YAClD,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;YAC1C,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,YAAY,8BAAa;YACpD,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,YAAY,8BAAa;SACvD,CAAC,CAAC;IACP,CAAC;IAED,aAAa,CAAC,KAAwB;QAClC,KAAK,CAAC,kBAAkB,CAAC,2BAAiB,CAAC,UAAU,EAAE;YACnD,SAAS,EAAE,eAAe,CAAC,IAAI,CAAC,EAAE;SACrC,CAAC,CAAC;IACP,CAAC;IAED,oBAAoB,CAAC,QAA+B;QAChD,QAAQ,CAAC,YAAY,CAAC;YAClB,EAAE,EAAE,eAAe,CAAC,IAAI,CAAC,EAAE;YAC3B,OAAO,EAAE,eAAe,CAAC,IAAI,CAAC,EAAE;YAChC,OAAO,EAAE,SAAG,CAAC,QAAQ,CAAC,sEAAsE,EAAE,0BAA0B,CAAC;SAC5H,CAAC,CAAC;QACH,QAAQ,CAAC,YAAY,CAAC;YAClB,EAAE,EAAE,eAAe,CAAC,WAAW,CAAC,EAAE;YAClC,OAAO,EAAE,eAAe,CAAC,WAAW,CAAC,EAAE;YACvC,OAAO,EAAE,SAAG,CAAC,QAAQ,CAAC,qEAAqE,EAAE,aAAa,CAAC;SAC9G,CAAC,CAAC;IACP,CAAC;IAES,kBAAkB,CAAC,MAAe;QACxC,MAAM,GAAG,GAAG,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAC7C,OAAO,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,sBAAsB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC/D,CAAC;IAES,mBAAmB,CAAC,MAAe;QACzC,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAC9C,OAAO,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC;IACzC,CAAC;IAES,gBAAgB,CAAC,MAAe;QACtC,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC;QACnE,OAAO,OAAO,YAAY,sBAAY,IAAI,OAAO,IAAI,SAAS,CAAC;IACnE,CAAC;IAES,KAAK,CAAC,aAAa,CAAC,MAAe;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,GAAG,EAAE,CAAC;YACP,OAAO;QACX,CAAC;QACD,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE;YAC5B,IAAI,EAAE,QAAQ;YACd,aAAa,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,eAAe,EAAE;SAChD,CAAC,CAAC;IACP,CAAC;IAGS,KAAK,CAAC,UAAU,CAAC,GAAY;QACnC,IAAI,GAAG,YAAY,8BAAa,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE;gBACpC,aAAa,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE;aAC5C,CAAC,CAAC;QACP,CAAC;IACL,CAAC;CAEJ,CAAA;AA/NY,kDAAmB;AAMT;IADlB,IAAA,kBAAM,EAAC,uBAAa,CAAC;sCACY,uBAAa;0DAAC;AAG7B;IADlB,IAAA,kBAAM,EAAC,wCAAsB,CAAC;sCACY,wCAAsB;mEAAC;AAG/C;IADlB,IAAA,kBAAM,EAAC,wCAAkB,CAAC;;wDACwB;8BAZ1C,mBAAmB;IAF/B,IAAA,sBAAU,GAAE;IACb,mCAAmC;GACtB,mBAAmB,CA+N/B"}

package/lib/browser/preview-frontend-module.d.ts

@@ -0,0 +1,6 @@
+import { ContainerModule } from '@theia/core/shared/inversify';
+import '../../src/browser/style/index.css';
+import '../../src/browser/markdown/style/index.css';
+declare const _default: ContainerModule;
+export default _default;
+//# sourceMappingURL=preview-frontend-module.d.ts.map

package/lib/browser/preview-frontend-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-frontend-module.d.ts","sourceRoot":"","sources":["../../src/browser/preview-frontend-module.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAa/D,OAAO,mCAAmC,CAAC;AAC3C,OAAO,4CAA4C,CAAC;;AAEpD,wBAwBG"}

package/lib/browser/preview-frontend-module.js

@@ -0,0 +1,53 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2018 TypeFox and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+const inversify_1 = require("@theia/core/shared/inversify");
+const uri_1 = require("@theia/core/lib/common/uri");
+const common_1 = require("@theia/core/lib/common");
+const browser_1 = require("@theia/core/lib/browser");
+const tab_bar_toolbar_1 = require("@theia/core/lib/browser/shell/tab-bar-toolbar");
+const preview_contribution_1 = require("./preview-contribution");
+const preview_widget_1 = require("./preview-widget");
+const preview_handler_1 = require("./preview-handler");
+const preview_uri_1 = require("./preview-uri");
+const markdown_1 = require("./markdown");
+const preview_preferences_1 = require("../common/preview-preferences");
+const preview_link_normalizer_1 = require("./preview-link-normalizer");
+require("../../src/browser/style/index.css");
+require("../../src/browser/markdown/style/index.css");
+exports.default = new inversify_1.ContainerModule(bind => {
+    (0, preview_preferences_1.bindPreviewPreferences)(bind);
+    bind(preview_handler_1.PreviewHandlerProvider).toSelf().inSingletonScope();
+    (0, common_1.bindContributionProvider)(bind, preview_handler_1.PreviewHandler);
+    bind(markdown_1.MarkdownPreviewHandler).toSelf().inSingletonScope();
+    bind(preview_handler_1.PreviewHandler).toService(markdown_1.MarkdownPreviewHandler);
+    bind(preview_link_normalizer_1.PreviewLinkNormalizer).toSelf().inSingletonScope();
+    bind(preview_widget_1.PreviewWidget).toSelf();
+    bind(browser_1.WidgetFactory).toDynamicValue(ctx => ({
+        id: preview_uri_1.PreviewUri.id,
+        async createWidget(options) {
+            const { container } = ctx;
+            const resource = await container.get(common_1.ResourceProvider)(new uri_1.default(options.uri));
+            const child = container.createChild();
+            child.bind(preview_widget_1.PreviewWidgetOptions).toConstantValue({ resource });
+            return child.get(preview_widget_1.PreviewWidget);
+        }
+    })).inSingletonScope();
+    bind(preview_contribution_1.PreviewContribution).toSelf().inSingletonScope();
+    [common_1.CommandContribution, common_1.MenuContribution, browser_1.OpenHandler, browser_1.FrontendApplicationContribution, tab_bar_toolbar_1.TabBarToolbarContribution].forEach(serviceIdentifier => bind(serviceIdentifier).toService(preview_contribution_1.PreviewContribution));
+});
+//# sourceMappingURL=preview-frontend-module.js.map

package/lib/browser/preview-frontend-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-frontend-module.js","sourceRoot":"","sources":["../../src/browser/preview-frontend-module.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,yCAAyC;AACzC,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;AAEhF,4DAA+D;AAC/D,oDAA6C;AAC7C,mDAA2H;AAC3H,qDAAgI;AAChI,mFAA0F;AAC1F,iEAA6D;AAC7D,qDAAuE;AACvE,uDAA2E;AAC3E,+CAA2C;AAC3C,yCAAoD;AACpD,uEAAuE;AACvE,uEAAkE;AAElE,6CAA2C;AAC3C,sDAAoD;AAEpD,kBAAe,IAAI,2BAAe,CAAC,IAAI,CAAC,EAAE;IACtC,IAAA,4CAAsB,EAAC,IAAI,CAAC,CAAC;IAC7B,IAAI,CAAC,wCAAsB,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;IACzD,IAAA,iCAAwB,EAAC,IAAI,EAAE,gCAAc,CAAC,CAAC;IAC/C,IAAI,CAAC,iCAAsB,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;IACzD,IAAI,CAAC,gCAAc,CAAC,CAAC,SAAS,CAAC,iCAAsB,CAAC,CAAC;IACvD,IAAI,CAAC,+CAAqB,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;IAExD,IAAI,CAAC,8BAAa,CAAC,CAAC,MAAM,EAAE,CAAC;IAC7B,IAAI,CAAgB,uBAAa,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtD,EAAE,EAAE,wBAAU,CAAC,EAAE;QACjB,KAAK,CAAC,YAAY,CAAC,OAAiC;YAChD,MAAM,EAAE,SAAS,EAAE,GAAG,GAAG,CAAC;YAC1B,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,GAAG,CAAmB,yBAAgB,CAAC,CAAC,IAAI,aAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;YAC/F,MAAM,KAAK,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;YACtC,KAAK,CAAC,IAAI,CAAuB,qCAAoB,CAAC,CAAC,eAAe,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;YACrF,OAAO,KAAK,CAAC,GAAG,CAAC,8BAAa,CAAC,CAAC;QACpC,CAAC;KACJ,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAC;IAEvB,IAAI,CAAC,0CAAmB,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;IACtD,CAAC,4BAAmB,EAAE,yBAAgB,EAAE,qBAAW,EAAE,yCAA+B,EAAE,2CAAyB,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,CACzI,IAAI,CAAC,iBAAiB,CAAC,CAAC,SAAS,CAAC,0CAAmB,CAAC,CACzD,CAAC;AACN,CAAC,CAAC,CAAC"}

package/lib/browser/preview-handler.d.ts

@@ -0,0 +1,105 @@
+import URI from '@theia/core/lib/common/uri';
+import { ContributionProvider, MaybePromise } from '@theia/core';
+export declare const PreviewHandler: unique symbol;
+/**
+ * The parameters given to the preview handler to render the preview content.
+ */
+export interface RenderContentParams {
+    /**
+     * Textual content of the resource.
+     */
+    content: string;
+    /**
+     * URI identifying the source resource.
+     */
+    originUri: URI;
+}
+export declare namespace RenderContentParams {
+    function is(params: unknown): params is RenderContentParams;
+}
+/**
+ * A PreviewHandler manages the integration of one or more previews.
+ *
+ * It indicates whether a preview shall be rendered for a given resource URI and, if yes, renders the content.
+ * Additionally it optionally provides methods with which the scroll state of the preview and corresponding
+ * editor can be managed.
+ *
+ * See {@link MarkdownPreviewHandler} for an example implementation.
+ */
+export interface PreviewHandler {
+    /**
+     * One or more classes which specify the preview widget icon.
+     */
+    readonly iconClass?: string;
+    /**
+     * Indicates whether and with which priority (larger is better) this preview handler is responsible for the resource identified by the given URI.
+     * If multiple handlers return the same priority it's undefined which one will be used.
+     *
+     * @param uri the URI identifying a resource.
+     *
+     * @returns a number larger than 0 if the handler is applicable, 0 or a negative number otherwise.
+     */
+    canHandle(uri: URI): number;
+    /**
+     * Render the preview content by returning appropriate HTML.
+     *
+     * @param params information for the handler to render its content.
+     *
+     * @returns the HTMLElement which will be attached to the preview widget.
+     */
+    renderContent(params: RenderContentParams): MaybePromise<HTMLElement | undefined>;
+    /**
+     * Search and return the HTMLElement which corresponds to the given fragment.
+     * This is used to initially reveal elements identified via the URI fragment.
+     *
+     * @param content the preview widget element containing the content previously rendered by {@link PreviewHandler.renderContent}.
+     * @param fragment the URI fragment for which the corresponding element shall be returned
+     *
+     * @returns the HTMLElement which is part of content and corresponds to the given fragment, undefined otherwise.
+     */
+    findElementForFragment?(content: HTMLElement, fragment: string): HTMLElement | undefined;
+    /**
+     * Search and return the HTMLElement which corresponds to the given line number.
+     * This is used to scroll the preview when the source editor scrolls.
+     *
+     * @param content the preview widget element containing the previously rendered by {@link PreviewHandler.renderContent}.
+     * @param sourceLine the line number for which the corresponding element shall be returned.
+     *
+     * @returns the HTMLElement which is part of content and corresponds to the given line number, undefined otherwise.
+     */
+    findElementForSourceLine?(content: HTMLElement, sourceLine: number): HTMLElement | undefined;
+    /**
+     * Returns the line number which corresponds to the preview element at the given offset.
+     * This is used to scroll the source editor when the preview scrolls.
+     *
+     * @param content the preview widget element containing the previously rendered by {@link PreviewHandler.renderContent}.
+     * @param offset the total amount by which the preview widget is scrolled.
+     *
+     * @returns the source line number which corresponds to the preview element at the given offset, undefined otherwise.
+     */
+    getSourceLineForOffset?(content: HTMLElement, offset: number): number | undefined;
+}
+/**
+ * Provider managing the available PreviewHandlers.
+ */
+export declare class PreviewHandlerProvider {
+    protected readonly previewHandlerContributions: ContributionProvider<PreviewHandler>;
+    constructor(previewHandlerContributions: ContributionProvider<PreviewHandler>);
+    /**
+     * Find PreviewHandlers for the given resource identifier.
+     *
+     * @param uri the URI identifying a resource.
+     *
+     * @returns the list of all supported `PreviewHandlers` sorted by their priority.
+     */
+    findContribution(uri: URI): PreviewHandler[];
+    /**
+     * Indicates whether any PreviewHandler can process the resource identified by the given URI.
+     *
+     * @param uri the URI identifying a resource.
+     *
+     * @returns `true` when a PreviewHandler can process the resource, `false` otherwise.
+     */
+    canHandle(uri: URI): boolean;
+}
+//# sourceMappingURL=preview-handler.d.ts.map

package/lib/browser/preview-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-handler.d.ts","sourceRoot":"","sources":["../../src/browser/preview-handler.ts"],"names":[],"mappings":"AAiBA,OAAO,GAAG,MAAM,4BAA4B,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAY,YAAY,EAAkB,MAAM,aAAa,CAAC;AAE3F,eAAO,MAAM,cAAc,eAA2B,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,SAAS,EAAE,GAAG,CAAC;CAClB;AAED,yBAAiB,mBAAmB,CAAC;IACjC,SAAgB,EAAE,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,mBAAmB,CAEjE;CACJ;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC3B;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;;;OAOG;IACH,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAAC;IAC5B;;;;;;OAMG;IACH,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,YAAY,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;IAClF;;;;;;;;OAQG;IACH,sBAAsB,CAAC,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;IACzF;;;;;;;;OAQG;IACH,wBAAwB,CAAC,CAAC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;IAC7F;;;;;;;;OAQG;IACH,sBAAsB,CAAC,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACrF;AAED;;GAEG;AACH,qBACa,sBAAsB;IAI3B,SAAS,CAAC,QAAQ,CAAC,2BAA2B,EAAE,oBAAoB,CAAC,cAAc,CAAC;gBAAjE,2BAA2B,EAAE,oBAAoB,CAAC,cAAc,CAAC;IAGxF;;;;;;OAMG;IACH,gBAAgB,CAAC,GAAG,EAAE,GAAG,GAAG,cAAc,EAAE;IAO5C;;;;;;OAMG;IACH,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO;CAG/B"}

package/lib/browser/preview-handler.js

@@ -0,0 +1,66 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2017 TypeFox and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PreviewHandlerProvider = exports.RenderContentParams = exports.PreviewHandler = void 0;
+const tslib_1 = require("tslib");
+const inversify_1 = require("@theia/core/shared/inversify");
+const core_1 = require("@theia/core");
+exports.PreviewHandler = Symbol('PreviewHandler');
+var RenderContentParams;
+(function (RenderContentParams) {
+    function is(params) {
+        return (0, core_1.isObject)(params) && 'content' in params && 'originUri' in params;
+    }
+    RenderContentParams.is = is;
+})(RenderContentParams || (exports.RenderContentParams = RenderContentParams = {}));
+/**
+ * Provider managing the available PreviewHandlers.
+ */
+let PreviewHandlerProvider = class PreviewHandlerProvider {
+    constructor(previewHandlerContributions) {
+        this.previewHandlerContributions = previewHandlerContributions;
+    }
+    /**
+     * Find PreviewHandlers for the given resource identifier.
+     *
+     * @param uri the URI identifying a resource.
+     *
+     * @returns the list of all supported `PreviewHandlers` sorted by their priority.
+     */
+    findContribution(uri) {
+        const prioritized = core_1.Prioritizeable.prioritizeAllSync(this.previewHandlerContributions.getContributions(), contrib => contrib.canHandle(uri));
+        return prioritized.map(c => c.value);
+    }
+    /**
+     * Indicates whether any PreviewHandler can process the resource identified by the given URI.
+     *
+     * @param uri the URI identifying a resource.
+     *
+     * @returns `true` when a PreviewHandler can process the resource, `false` otherwise.
+     */
+    canHandle(uri) {
+        return this.findContribution(uri).length > 0;
+    }
+};
+exports.PreviewHandlerProvider = PreviewHandlerProvider;
+exports.PreviewHandlerProvider = PreviewHandlerProvider = tslib_1.__decorate([
+    (0, inversify_1.injectable)(),
+    tslib_1.__param(0, (0, inversify_1.inject)(core_1.ContributionProvider)),
+    tslib_1.__param(0, (0, inversify_1.named)(exports.PreviewHandler)),
+    tslib_1.__metadata("design:paramtypes", [Object])
+], PreviewHandlerProvider);
+//# sourceMappingURL=preview-handler.js.map

package/lib/browser/preview-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-handler.js","sourceRoot":"","sources":["../../src/browser/preview-handler.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,yCAAyC;AACzC,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;;;AAEhF,4DAAyE;AAEzE,sCAA2F;AAE9E,QAAA,cAAc,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAgBvD,IAAiB,mBAAmB,CAInC;AAJD,WAAiB,mBAAmB;IAChC,SAAgB,EAAE,CAAC,MAAe;QAC9B,OAAO,IAAA,eAAQ,EAAC,MAAM,CAAC,IAAI,SAAS,IAAI,MAAM,IAAI,WAAW,IAAI,MAAM,CAAC;IAC5E,CAAC;IAFe,sBAAE,KAEjB,CAAA;AACL,CAAC,EAJgB,mBAAmB,mCAAnB,mBAAmB,QAInC;AAiED;;GAEG;AAEI,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;IAE/B,YAEuB,2BAAiE;QAAjE,gCAA2B,GAA3B,2BAA2B,CAAsC;IACpF,CAAC;IAEL;;;;;;OAMG;IACH,gBAAgB,CAAC,GAAQ;QACrB,MAAM,WAAW,GAAG,qBAAc,CAAC,iBAAiB,CAAC,IAAI,CAAC,2BAA2B,CAAC,gBAAgB,EAAE,EAAE,OAAO,CAAC,EAAE,CAChH,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CACzB,CAAC;QACF,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IAED;;;;;;OAMG;IACH,SAAS,CAAC,GAAQ;QACd,OAAO,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IACjD,CAAC;CACJ,CAAA;AA/BY,wDAAsB;iCAAtB,sBAAsB;IADlC,IAAA,sBAAU,GAAE;IAIJ,mBAAA,IAAA,kBAAM,EAAC,2BAAoB,CAAC,CAAA;IAAE,mBAAA,IAAA,iBAAK,EAAC,sBAAc,CAAC,CAAA;;GAH/C,sBAAsB,CA+BlC"}

package/lib/browser/preview-link-normalizer.d.ts

@@ -0,0 +1,8 @@
+import URI from '@theia/core/lib/common/uri';
+import { MiniBrowserEnvironment } from '@theia/mini-browser/lib/browser/environment/mini-browser-environment';
+export declare class PreviewLinkNormalizer {
+    protected urlScheme: RegExp;
+    protected readonly miniBrowserEnvironment: MiniBrowserEnvironment;
+    normalizeLink(documentUri: URI, link: string): string;
+}
+//# sourceMappingURL=preview-link-normalizer.d.ts.map

package/lib/browser/preview-link-normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-link-normalizer.d.ts","sourceRoot":"","sources":["../../src/browser/preview-link-normalizer.ts"],"names":[],"mappings":"AAiBA,OAAO,GAAG,MAAM,4BAA4B,CAAC;AAC7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,sEAAsE,CAAC;AAE9G,qBACa,qBAAqB;IAE9B,SAAS,CAAC,SAAS,SAAiD;IAGpE,SAAS,CAAC,QAAQ,CAAC,sBAAsB,EAAE,sBAAsB,CAAC;IAElE,aAAa,CAAC,WAAW,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;CAWxD"}

package/lib/browser/preview-link-normalizer.js

@@ -0,0 +1,47 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2018 TypeFox and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PreviewLinkNormalizer = void 0;
+const tslib_1 = require("tslib");
+const inversify_1 = require("@theia/core/shared/inversify");
+const mini_browser_environment_1 = require("@theia/mini-browser/lib/browser/environment/mini-browser-environment");
+let PreviewLinkNormalizer = class PreviewLinkNormalizer {
+    constructor() {
+        this.urlScheme = new RegExp('^[a-z][a-z|0-9|\+|\-|\.]*:', 'i');
+    }
+    normalizeLink(documentUri, link) {
+        try {
+            if (!this.urlScheme.test(link)) {
+                const location = documentUri.parent.resolve(link).path.toString();
+                return this.miniBrowserEnvironment.getEndpoint('normalized-link').getRestUrl().resolve(location).toString();
+            }
+        }
+        catch {
+            // ignore
+        }
+        return link;
+    }
+};
+exports.PreviewLinkNormalizer = PreviewLinkNormalizer;
+tslib_1.__decorate([
+    (0, inversify_1.inject)(mini_browser_environment_1.MiniBrowserEnvironment),
+    tslib_1.__metadata("design:type", mini_browser_environment_1.MiniBrowserEnvironment)
+], PreviewLinkNormalizer.prototype, "miniBrowserEnvironment", void 0);
+exports.PreviewLinkNormalizer = PreviewLinkNormalizer = tslib_1.__decorate([
+    (0, inversify_1.injectable)()
+], PreviewLinkNormalizer);
+//# sourceMappingURL=preview-link-normalizer.js.map