@theia/plugin-ext-vscode 1.53.0-next.55 → 1.53.0-next.64

package/src/node/package.spec.ts

@@ -1,28 +1,28 @@
-// *****************************************************************************
-// Copyright (C) 2018 Red Hat, Inc. 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
-// *****************************************************************************
-
-/* note: this bogus test file is required so that
-   we are able to run mocha unit tests on this
-   package, without having any actual unit tests in it.
-   This way a coverage report will be generated,
-   showing 0% coverage, instead of no report.
-   This file can be removed once we have real unit
-   tests in place. */
-
-describe('plugin-ext-vscode package', () => {
-
-    it('support code coverage statistics', () => true);
-});
+// *****************************************************************************
+// Copyright (C) 2018 Red Hat, Inc. 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
+// *****************************************************************************
+
+/* note: this bogus test file is required so that
+   we are able to run mocha unit tests on this
+   package, without having any actual unit tests in it.
+   This way a coverage report will be generated,
+   showing 0% coverage, instead of no report.
+   This file can be removed once we have real unit
+   tests in place. */
+
+describe('plugin-ext-vscode package', () => {
+
+    it('support code coverage statistics', () => true);
+});

package/src/node/plugin-vscode-backend-module.ts

@@ -1,46 +1,46 @@
-// *****************************************************************************
-// Copyright (C) 2018 Red Hat, Inc. 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
-// *****************************************************************************
-
-import { ContainerModule } from '@theia/core/shared/inversify';
-import {
-    PluginDeployerFileHandler, PluginDeployerDirectoryHandler, PluginScanner, PluginDeployerParticipant, PluginDeployerResolver
-} from '@theia/plugin-ext';
-import { PluginVsCodeFileHandler } from './plugin-vscode-file-handler';
-import { PluginVsCodeDirectoryHandler } from './plugin-vscode-directory-handler';
-import { VsCodePluginScanner } from './scanner-vscode';
-import { PluginVsCodeCliContribution } from './plugin-vscode-cli-contribution';
-import { CliContribution } from '@theia/core/lib/node';
-import { PluginHostEnvironmentVariable } from '@theia/plugin-ext/lib/common';
-import { PluginVSCodeEnvironment } from '../common/plugin-vscode-environment';
-import { PluginVSCodeDeployerParticipant } from './plugin-vscode-deployer-participant';
-import { LocalVSIXFilePluginDeployerResolver } from './local-vsix-file-plugin-deployer-resolver';
-
-export default new ContainerModule(bind => {
-    bind(PluginVSCodeEnvironment).toSelf().inSingletonScope();
-
-    bind(PluginVSCodeDeployerParticipant).toSelf().inSingletonScope();
-    bind(PluginDeployerParticipant).toService(PluginVSCodeDeployerParticipant);
-
-    bind(PluginDeployerFileHandler).to(PluginVsCodeFileHandler).inSingletonScope();
-    bind(PluginDeployerDirectoryHandler).to(PluginVsCodeDirectoryHandler).inSingletonScope();
-    bind(PluginScanner).to(VsCodePluginScanner).inSingletonScope();
-
-    bind(PluginVsCodeCliContribution).toSelf().inSingletonScope();
-    bind(CliContribution).toService(PluginVsCodeCliContribution);
-    bind(PluginHostEnvironmentVariable).toService(PluginVsCodeCliContribution);
-
-    bind(PluginDeployerResolver).to(LocalVSIXFilePluginDeployerResolver).inSingletonScope();
-});
+// *****************************************************************************
+// Copyright (C) 2018 Red Hat, Inc. 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
+// *****************************************************************************
+
+import { ContainerModule } from '@theia/core/shared/inversify';
+import {
+    PluginDeployerFileHandler, PluginDeployerDirectoryHandler, PluginScanner, PluginDeployerParticipant, PluginDeployerResolver
+} from '@theia/plugin-ext';
+import { PluginVsCodeFileHandler } from './plugin-vscode-file-handler';
+import { PluginVsCodeDirectoryHandler } from './plugin-vscode-directory-handler';
+import { VsCodePluginScanner } from './scanner-vscode';
+import { PluginVsCodeCliContribution } from './plugin-vscode-cli-contribution';
+import { CliContribution } from '@theia/core/lib/node';
+import { PluginHostEnvironmentVariable } from '@theia/plugin-ext/lib/common';
+import { PluginVSCodeEnvironment } from '../common/plugin-vscode-environment';
+import { PluginVSCodeDeployerParticipant } from './plugin-vscode-deployer-participant';
+import { LocalVSIXFilePluginDeployerResolver } from './local-vsix-file-plugin-deployer-resolver';
+
+export default new ContainerModule(bind => {
+    bind(PluginVSCodeEnvironment).toSelf().inSingletonScope();
+
+    bind(PluginVSCodeDeployerParticipant).toSelf().inSingletonScope();
+    bind(PluginDeployerParticipant).toService(PluginVSCodeDeployerParticipant);
+
+    bind(PluginDeployerFileHandler).to(PluginVsCodeFileHandler).inSingletonScope();
+    bind(PluginDeployerDirectoryHandler).to(PluginVsCodeDirectoryHandler).inSingletonScope();
+    bind(PluginScanner).to(VsCodePluginScanner).inSingletonScope();
+
+    bind(PluginVsCodeCliContribution).toSelf().inSingletonScope();
+    bind(CliContribution).toService(PluginVsCodeCliContribution);
+    bind(PluginHostEnvironmentVariable).toService(PluginVsCodeCliContribution);
+
+    bind(PluginDeployerResolver).to(LocalVSIXFilePluginDeployerResolver).inSingletonScope();
+});

package/src/node/plugin-vscode-cli-contribution.ts

@@ -1,64 +1,64 @@
-// *****************************************************************************
-// Copyright (C) 2019 Red Hat, Inc. 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
-// *****************************************************************************
-
-import { injectable } from '@theia/core/shared/inversify';
-import { Argv, Arguments } from '@theia/core/shared/yargs';
-import { CliContribution } from '@theia/core/lib/node/cli';
-import { PluginHostEnvironmentVariable } from '@theia/plugin-ext/lib/common';
-import { VSCODE_DEFAULT_API_VERSION } from '../common/plugin-vscode-types';
-import { Deferred } from '@theia/core/lib/common/promise-util';
-
-/**
- * CLI Contribution allowing to override the VS Code API version which is returned by `vscode.version` API call.
- */
-@injectable()
-export class PluginVsCodeCliContribution implements CliContribution, PluginHostEnvironmentVariable {
-
-    /**
-     * CLI argument name to define the supported VS Code API version.
-     */
-    static VSCODE_API_VERSION = 'vscode-api-version';
-
-    protected vsCodeApiVersion?: string;
-    protected vsCodeApiVersionDeferred = new Deferred<string>();
-
-    get vsCodeApiVersionPromise(): Promise<string> {
-        return this.vsCodeApiVersionDeferred.promise;
-    }
-
-    configure(conf: Argv): void {
-        conf.option(PluginVsCodeCliContribution.VSCODE_API_VERSION, {
-            // eslint-disable-next-line max-len
-            description: `Overrides the version returned by VSCode API 'vscode.version'. Example: --${PluginVsCodeCliContribution.VSCODE_API_VERSION}=<Wanted Version>. Default [${VSCODE_DEFAULT_API_VERSION}]`,
-            type: 'string',
-            nargs: 1
-        });
-    }
-
-    setArguments(args: Arguments): void {
-        const arg = args[PluginVsCodeCliContribution.VSCODE_API_VERSION] as string | undefined;
-        this.vsCodeApiVersion = arg?.trim() || process.env['VSCODE_API_VERSION']?.trim() || VSCODE_DEFAULT_API_VERSION;
-        process.env['VSCODE_API_VERSION'] = this.vsCodeApiVersion;
-        this.vsCodeApiVersionDeferred.resolve(this.vsCodeApiVersion);
-    }
-
-    process(env: NodeJS.ProcessEnv): void {
-        if (this.vsCodeApiVersion) {
-            env['VSCODE_API_VERSION'] = this.vsCodeApiVersion;
-        }
-    }
-
-}
+// *****************************************************************************
+// Copyright (C) 2019 Red Hat, Inc. 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
+// *****************************************************************************
+
+import { injectable } from '@theia/core/shared/inversify';
+import { Argv, Arguments } from '@theia/core/shared/yargs';
+import { CliContribution } from '@theia/core/lib/node/cli';
+import { PluginHostEnvironmentVariable } from '@theia/plugin-ext/lib/common';
+import { VSCODE_DEFAULT_API_VERSION } from '../common/plugin-vscode-types';
+import { Deferred } from '@theia/core/lib/common/promise-util';
+
+/**
+ * CLI Contribution allowing to override the VS Code API version which is returned by `vscode.version` API call.
+ */
+@injectable()
+export class PluginVsCodeCliContribution implements CliContribution, PluginHostEnvironmentVariable {
+
+    /**
+     * CLI argument name to define the supported VS Code API version.
+     */
+    static VSCODE_API_VERSION = 'vscode-api-version';
+
+    protected vsCodeApiVersion?: string;
+    protected vsCodeApiVersionDeferred = new Deferred<string>();
+
+    get vsCodeApiVersionPromise(): Promise<string> {
+        return this.vsCodeApiVersionDeferred.promise;
+    }
+
+    configure(conf: Argv): void {
+        conf.option(PluginVsCodeCliContribution.VSCODE_API_VERSION, {
+            // eslint-disable-next-line max-len
+            description: `Overrides the version returned by VSCode API 'vscode.version'. Example: --${PluginVsCodeCliContribution.VSCODE_API_VERSION}=<Wanted Version>. Default [${VSCODE_DEFAULT_API_VERSION}]`,
+            type: 'string',
+            nargs: 1
+        });
+    }
+
+    setArguments(args: Arguments): void {
+        const arg = args[PluginVsCodeCliContribution.VSCODE_API_VERSION] as string | undefined;
+        this.vsCodeApiVersion = arg?.trim() || process.env['VSCODE_API_VERSION']?.trim() || VSCODE_DEFAULT_API_VERSION;
+        process.env['VSCODE_API_VERSION'] = this.vsCodeApiVersion;
+        this.vsCodeApiVersionDeferred.resolve(this.vsCodeApiVersion);
+    }
+
+    process(env: NodeJS.ProcessEnv): void {
+        if (this.vsCodeApiVersion) {
+            env['VSCODE_API_VERSION'] = this.vsCodeApiVersion;
+        }
+    }
+
+}

package/src/node/plugin-vscode-deployer-participant.ts

@@ -1,48 +1,48 @@
-// *****************************************************************************
-// Copyright (C) 2020 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
-// *****************************************************************************
-
-import { injectable, inject } from '@theia/core/shared/inversify';
-import * as fs from '@theia/core/shared/fs-extra';
-import { FileUri } from '@theia/core/lib/node';
-import { PluginVSCodeEnvironment } from '../common/plugin-vscode-environment';
-import { PluginDeployerParticipant, PluginDeployerStartContext } from '@theia/plugin-ext/lib/common/plugin-protocol';
-import { LocalVSIXFilePluginDeployerResolver } from './local-vsix-file-plugin-deployer-resolver';
-
-@injectable()
-export class PluginVSCodeDeployerParticipant implements PluginDeployerParticipant {
-
-    @inject(PluginVSCodeEnvironment)
-    protected readonly environments: PluginVSCodeEnvironment;
-
-    async onWillStart(context: PluginDeployerStartContext): Promise<void> {
-        const extensionDeploymentDirUri = await this.environments.getDeploymentDirUri();
-        context.userEntries.push(extensionDeploymentDirUri.withScheme('local-dir').toString());
-
-        const userExtensionDirUri = await this.environments.getUserExtensionsDirUri();
-        const userExtensionDirPath = FileUri.fsPath(userExtensionDirUri);
-
-        if (await fs.pathExists(userExtensionDirPath)) {
-            const files = await fs.readdir(userExtensionDirPath);
-            for (const file of files) {
-                if (file.endsWith(LocalVSIXFilePluginDeployerResolver.FILE_EXTENSION)) {
-                    const extensionUri = userExtensionDirUri.resolve(file).withScheme('local-file').toString();
-                    console.log(`found drop-in extension "${extensionUri}"`);
-                    context.userEntries.push(extensionUri);
-                }
-            }
-        }
-    }
-}
+// *****************************************************************************
+// Copyright (C) 2020 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
+// *****************************************************************************
+
+import { injectable, inject } from '@theia/core/shared/inversify';
+import * as fs from '@theia/core/shared/fs-extra';
+import { FileUri } from '@theia/core/lib/node';
+import { PluginVSCodeEnvironment } from '../common/plugin-vscode-environment';
+import { PluginDeployerParticipant, PluginDeployerStartContext } from '@theia/plugin-ext/lib/common/plugin-protocol';
+import { LocalVSIXFilePluginDeployerResolver } from './local-vsix-file-plugin-deployer-resolver';
+
+@injectable()
+export class PluginVSCodeDeployerParticipant implements PluginDeployerParticipant {
+
+    @inject(PluginVSCodeEnvironment)
+    protected readonly environments: PluginVSCodeEnvironment;
+
+    async onWillStart(context: PluginDeployerStartContext): Promise<void> {
+        const extensionDeploymentDirUri = await this.environments.getDeploymentDirUri();
+        context.userEntries.push(extensionDeploymentDirUri.withScheme('local-dir').toString());
+
+        const userExtensionDirUri = await this.environments.getUserExtensionsDirUri();
+        const userExtensionDirPath = FileUri.fsPath(userExtensionDirUri);
+
+        if (await fs.pathExists(userExtensionDirPath)) {
+            const files = await fs.readdir(userExtensionDirPath);
+            for (const file of files) {
+                if (file.endsWith(LocalVSIXFilePluginDeployerResolver.FILE_EXTENSION)) {
+                    const extensionUri = userExtensionDirUri.resolve(file).withScheme('local-file').toString();
+                    console.log(`found drop-in extension "${extensionUri}"`);
+                    context.userEntries.push(extensionUri);
+                }
+            }
+        }
+    }
+}

package/src/node/plugin-vscode-directory-handler.ts

@@ -1,123 +1,123 @@
-// *****************************************************************************
-// Copyright (C) 2018 Red Hat, Inc. 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
-// *****************************************************************************
-
-import * as path from 'path';
-import * as fs from '@theia/core/shared/fs-extra';
-import { inject, injectable } from '@theia/core/shared/inversify';
-import type { RecursivePartial, URI } from '@theia/core';
-import { Deferred, firstTrue } from '@theia/core/lib/common/promise-util';
-import {
-    PluginDeployerDirectoryHandler, PluginDeployerEntry, PluginDeployerDirectoryHandlerContext,
-    PluginDeployerEntryType, PluginPackage, PluginIdentifiers
-} from '@theia/plugin-ext';
-import { PluginCliContribution } from '@theia/plugin-ext/lib/main/node/plugin-cli-contribution';
-import { TMP_DIR_PREFIX } from './plugin-vscode-utils';
-
-@injectable()
-export class PluginVsCodeDirectoryHandler implements PluginDeployerDirectoryHandler {
-
-    protected readonly deploymentDirectory: Deferred<URI>;
-
-    @inject(PluginCliContribution) protected readonly pluginCli: PluginCliContribution;
-
-    async accept(plugin: PluginDeployerEntry): Promise<boolean> {
-        console.debug(`Resolving "${plugin.id()}" as a VS Code extension...`);
-        if (plugin.path().startsWith(TMP_DIR_PREFIX)) {
-            // avoid adding corrupted plugins from temporary directories
-            return false;
-        }
-        return this.attemptResolution(plugin);
-    }
-
-    protected async attemptResolution(plugin: PluginDeployerEntry): Promise<boolean> {
-        if (this.resolvePackage(plugin)) {
-            return true;
-        }
-        return this.deriveMetadata(plugin);
-    }
-
-    protected async deriveMetadata(plugin: PluginDeployerEntry): Promise<boolean> {
-        return firstTrue(
-            this.resolveFromSources(plugin),
-            this.resolveFromVSIX(plugin),
-            this.resolveFromNpmTarball(plugin)
-        );
-    }
-
-    async handle(context: PluginDeployerDirectoryHandlerContext): Promise<void> {
-        const types: PluginDeployerEntryType[] = [];
-        const packageJson: PluginPackage = context.pluginEntry().getValue('package.json');
-        if (packageJson.browser) {
-            types.push(PluginDeployerEntryType.FRONTEND);
-        }
-        if (packageJson.main || !packageJson.browser) {
-            types.push(PluginDeployerEntryType.BACKEND);
-        }
-        context.pluginEntry().accept(...types);
-    }
-
-    protected async resolveFromSources(plugin: PluginDeployerEntry): Promise<boolean> {
-        const pluginPath = plugin.path();
-        const pck = await this.requirePackage(pluginPath);
-        return this.resolvePackage(plugin, { pluginPath, pck });
-    }
-
-    protected async resolveFromVSIX(plugin: PluginDeployerEntry): Promise<boolean> {
-        if (!(await fs.pathExists(path.join(plugin.path(), 'extension.vsixmanifest')))) {
-            return false;
-        }
-        const pluginPath = path.join(plugin.path(), 'extension');
-        const pck = await this.requirePackage(pluginPath);
-        return this.resolvePackage(plugin, { pluginPath, pck });
-    }
-
-    protected async resolveFromNpmTarball(plugin: PluginDeployerEntry): Promise<boolean> {
-        const pluginPath = path.join(plugin.path(), 'package');
-        const pck = await this.requirePackage(pluginPath);
-        return this.resolvePackage(plugin, { pluginPath, pck });
-    }
-
-    protected resolvePackage(plugin: PluginDeployerEntry, options?: {
-        pluginPath: string
-        pck?: RecursivePartial<PluginPackage>
-    }): boolean {
-        const { pluginPath, pck } = options || {
-            pluginPath: plugin.path(),
-            pck: plugin.getValue('package.json')
-        };
-        if (!pck || !pck.name || !pck.version || !pck.engines || !pck.engines.vscode) {
-            return false;
-        }
-        pck.publisher ??= PluginIdentifiers.UNPUBLISHED;
-        if (options) {
-            plugin.storeValue('package.json', pck);
-            plugin.rootPath = plugin.path();
-            plugin.updatePath(pluginPath);
-        }
-        console.debug(`Resolved "${plugin.id()}" to a VS Code extension "${pck.name}@${pck.version}" with engines:`, pck.engines);
-        return true;
-    }
-
-    protected async requirePackage(pluginPath: string): Promise<PluginPackage | undefined> {
-        try {
-            const plugin: PluginPackage = await fs.readJSON(path.join(pluginPath, 'package.json'));
-            plugin.publisher ??= PluginIdentifiers.UNPUBLISHED;
-            return plugin;
-        } catch {
-            return undefined;
-        }
-    }
-}
+// *****************************************************************************
+// Copyright (C) 2018 Red Hat, Inc. 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
+// *****************************************************************************
+
+import * as path from 'path';
+import * as fs from '@theia/core/shared/fs-extra';
+import { inject, injectable } from '@theia/core/shared/inversify';
+import type { RecursivePartial, URI } from '@theia/core';
+import { Deferred, firstTrue } from '@theia/core/lib/common/promise-util';
+import {
+    PluginDeployerDirectoryHandler, PluginDeployerEntry, PluginDeployerDirectoryHandlerContext,
+    PluginDeployerEntryType, PluginPackage, PluginIdentifiers
+} from '@theia/plugin-ext';
+import { PluginCliContribution } from '@theia/plugin-ext/lib/main/node/plugin-cli-contribution';
+import { TMP_DIR_PREFIX } from './plugin-vscode-utils';
+
+@injectable()
+export class PluginVsCodeDirectoryHandler implements PluginDeployerDirectoryHandler {
+
+    protected readonly deploymentDirectory: Deferred<URI>;
+
+    @inject(PluginCliContribution) protected readonly pluginCli: PluginCliContribution;
+
+    async accept(plugin: PluginDeployerEntry): Promise<boolean> {
+        console.debug(`Resolving "${plugin.id()}" as a VS Code extension...`);
+        if (plugin.path().startsWith(TMP_DIR_PREFIX)) {
+            // avoid adding corrupted plugins from temporary directories
+            return false;
+        }
+        return this.attemptResolution(plugin);
+    }
+
+    protected async attemptResolution(plugin: PluginDeployerEntry): Promise<boolean> {
+        if (this.resolvePackage(plugin)) {
+            return true;
+        }
+        return this.deriveMetadata(plugin);
+    }
+
+    protected async deriveMetadata(plugin: PluginDeployerEntry): Promise<boolean> {
+        return firstTrue(
+            this.resolveFromSources(plugin),
+            this.resolveFromVSIX(plugin),
+            this.resolveFromNpmTarball(plugin)
+        );
+    }
+
+    async handle(context: PluginDeployerDirectoryHandlerContext): Promise<void> {
+        const types: PluginDeployerEntryType[] = [];
+        const packageJson: PluginPackage = context.pluginEntry().getValue('package.json');
+        if (packageJson.browser) {
+            types.push(PluginDeployerEntryType.FRONTEND);
+        }
+        if (packageJson.main || !packageJson.browser) {
+            types.push(PluginDeployerEntryType.BACKEND);
+        }
+        context.pluginEntry().accept(...types);
+    }
+
+    protected async resolveFromSources(plugin: PluginDeployerEntry): Promise<boolean> {
+        const pluginPath = plugin.path();
+        const pck = await this.requirePackage(pluginPath);
+        return this.resolvePackage(plugin, { pluginPath, pck });
+    }
+
+    protected async resolveFromVSIX(plugin: PluginDeployerEntry): Promise<boolean> {
+        if (!(await fs.pathExists(path.join(plugin.path(), 'extension.vsixmanifest')))) {
+            return false;
+        }
+        const pluginPath = path.join(plugin.path(), 'extension');
+        const pck = await this.requirePackage(pluginPath);
+        return this.resolvePackage(plugin, { pluginPath, pck });
+    }
+
+    protected async resolveFromNpmTarball(plugin: PluginDeployerEntry): Promise<boolean> {
+        const pluginPath = path.join(plugin.path(), 'package');
+        const pck = await this.requirePackage(pluginPath);
+        return this.resolvePackage(plugin, { pluginPath, pck });
+    }
+
+    protected resolvePackage(plugin: PluginDeployerEntry, options?: {
+        pluginPath: string
+        pck?: RecursivePartial<PluginPackage>
+    }): boolean {
+        const { pluginPath, pck } = options || {
+            pluginPath: plugin.path(),
+            pck: plugin.getValue('package.json')
+        };
+        if (!pck || !pck.name || !pck.version || !pck.engines || !pck.engines.vscode) {
+            return false;
+        }
+        pck.publisher ??= PluginIdentifiers.UNPUBLISHED;
+        if (options) {
+            plugin.storeValue('package.json', pck);
+            plugin.rootPath = plugin.path();
+            plugin.updatePath(pluginPath);
+        }
+        console.debug(`Resolved "${plugin.id()}" to a VS Code extension "${pck.name}@${pck.version}" with engines:`, pck.engines);
+        return true;
+    }
+
+    protected async requirePackage(pluginPath: string): Promise<PluginPackage | undefined> {
+        try {
+            const plugin: PluginPackage = await fs.readJSON(path.join(pluginPath, 'package.json'));
+            plugin.publisher ??= PluginIdentifiers.UNPUBLISHED;
+            return plugin;
+        } catch {
+            return undefined;
+        }
+    }
+}