@theia/plugin-ext 1.76.0-next.7 → 1.76.0

package/src/main/browser/plugin-icon-theme-service.ts

@@ -26,6 +26,7 @@ import { injectable, inject, postConstruct } from '@theia/core/shared/inversify'
 import { IconThemeService, IconTheme, IconThemeDefinition } from '@theia/core/lib/browser/icon-theme-service';
 import { IconThemeContribution, DeployedPlugin, UiTheme, getPluginId } from '../../common/plugin-protocol';
 import { PLUGINS_BASE_PATH } from '@theia/plugin-utils/lib/common/constants';
+import { encodePluginAssetPath } from '@theia/plugin-utils/lib/common/plugin-model';
 import URI from '@theia/core/lib/common/uri';
 import { Disposable, DisposableCollection } from '@theia/core/lib/common/disposable';
 import { Emitter } from '@theia/core/lib/common/event';
@@ -364,7 +365,7 @@ export class PluginIconTheme extends PluginIconThemeDefinition implements IconTh
         const iconUri = this.locationUri.resolve(iconPath);
         const relativePath = this.packageRootUri.path.relative(iconUri.path.normalize());
         return relativePath && `url('${new Endpoint({
-            path: `${PLUGINS_BASE_PATH}/${this.pluginId}/${encodeURIComponent(relativePath.normalize().toString())}`
+            path: `${PLUGINS_BASE_PATH}/${this.pluginId}/${encodePluginAssetPath(relativePath.normalize().toString())}`
         }).getRestUrl().toString()}')`;
     }
 

package/src/main/browser/telemetry-main.spec.ts

@@ -0,0 +1,77 @@
+// *****************************************************************************
+// Copyright (C) 2026 JuliaHub, 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 { expect } from 'chai';
+import { Emitter } from '@theia/core/lib/common/event';
+import { Container } from '@theia/core/shared/inversify';
+import { TelemetryConsentProvider } from '@theia/telemetry/lib/common/telemetry-consent-provider';
+import { TelemetryLevel } from '@theia/telemetry/lib/common/telemetry-types';
+import { RPCProtocol } from '../../common/rpc-protocol';
+import { TelemetryMainImpl } from './telemetry-main';
+
+describe('TelemetryMainImpl', () => {
+
+    let level: TelemetryLevel;
+    let pushed: TelemetryLevel[];
+    let levelChanged: Emitter<TelemetryLevel>;
+    let container: Container;
+    let rpc: RPCProtocol;
+
+    beforeEach(() => {
+        level = 'off';
+        pushed = [];
+        levelChanged = new Emitter<TelemetryLevel>();
+        container = new Container();
+        container.bind(TelemetryConsentProvider).toConstantValue(<TelemetryConsentProvider>{
+            get level(): TelemetryLevel { return level; },
+            onDidChangeTelemetryLevel: levelChanged.event,
+            ready: Promise.resolve()
+        });
+        rpc = {
+            getProxy<T>(_proxyId: unknown): T {
+                return {
+                    $onDidChangeTelemetryLevel: (next: TelemetryLevel) => { pushed.push(next); }
+                } as unknown as T;
+            },
+            set: <T, R extends T>(_identifier: unknown, instance: R) => instance,
+            dispose: () => { }
+        } as RPCProtocol;
+    });
+
+    it('does not push a level on construction, the initial level is seeded through $init', () => {
+        new TelemetryMainImpl(rpc, container);
+
+        expect(pushed).to.be.empty;
+    });
+
+    it('pushes every level change to the plugin host', () => {
+        new TelemetryMainImpl(rpc, container);
+
+        levelChanged.fire('all');
+        levelChanged.fire('error');
+
+        expect(pushed).to.deep.equal(['all', 'error']);
+    });
+
+    it('stops pushing once disposed', () => {
+        const telemetryMain = new TelemetryMainImpl(rpc, container);
+
+        telemetryMain.dispose();
+        levelChanged.fire('all');
+
+        expect(pushed).to.be.empty;
+    });
+});

package/src/main/browser/telemetry-main.ts

@@ -0,0 +1,46 @@
+// *****************************************************************************
+// Copyright (C) 2026 JuliaHub, 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 { Disposable, DisposableCollection } from '@theia/core/lib/common/disposable';
+import { interfaces } from '@theia/core/shared/inversify';
+import { TelemetryConsentProvider } from '@theia/telemetry/lib/common/telemetry-consent-provider';
+import { MAIN_RPC_CONTEXT, TelemetryExt, TelemetryMain } from '../../common/plugin-api-rpc';
+import { RPCProtocol } from '../../common/rpc-protocol';
+
+/**
+ * Forwards the user's telemetry consent to the plugin host. The initial level is seeded through
+ * `PluginManagerInitializeParams` so that it is in place before any plugin activates.
+ *
+ * `TelemetryMain` declares no `$` methods; the instance is registered with the RPC protocol so that the consent
+ * subscription is disposed along with the channel.
+ *
+ * @experimental
+ */
+export class TelemetryMainImpl implements TelemetryMain, Disposable {
+
+    protected readonly proxy: TelemetryExt;
+    protected readonly toDispose = new DisposableCollection();
+
+    constructor(rpc: RPCProtocol, container: interfaces.Container) {
+        this.proxy = rpc.getProxy(MAIN_RPC_CONTEXT.TELEMETRY_EXT);
+        const consentProvider = container.get<TelemetryConsentProvider>(TelemetryConsentProvider);
+        this.toDispose.push(consentProvider.onDidChangeTelemetryLevel(level => this.proxy.$onDidChangeTelemetryLevel(level)));
+    }
+
+    dispose(): void {
+        this.toDispose.dispose();
+    }
+}

package/src/main/browser/webview/webview-context-keys.ts

@@ -14,14 +14,18 @@
 // SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
 // *****************************************************************************
 
-import { ApplicationShell, FocusTracker, Widget } from '@theia/core/lib/browser';
+import { ApplicationShell, FocusTracker, Widget, WidgetContextKeyContribution } from '@theia/core/lib/browser';
 import { ContextKey, ContextKeyService } from '@theia/core/lib/browser/context-key-service';
 import { inject, injectable, postConstruct } from '@theia/core/shared/inversify';
 import { CustomEditorWidget } from '../custom-editors/custom-editor-widget';
+import { CodeEditorWidgetUtil } from '../menus/vscode-theia-menu-mappings';
 import { WebviewWidget } from './webview';
 
+const ACTIVE_WEBVIEW_PANEL_ID = 'activeWebviewPanelId';
+const ACTIVE_CUSTOM_EDITOR_ID = 'activeCustomEditorId';
+
 @injectable()
-export class WebviewContextKeys {
+export class WebviewContextKeys implements WidgetContextKeyContribution {
 
     /**
      * Context key representing the `viewType` of the active `WebviewWidget`, if any.
@@ -41,11 +45,23 @@ export class WebviewContextKeys {
 
     @postConstruct()
     protected init(): void {
-        this.activeWebviewPanelId = this.contextKeyService.createKey('activeWebviewPanelId', '');
-        this.activeCustomEditorId = this.contextKeyService.createKey('activeCustomEditorId', '');
+        this.activeWebviewPanelId = this.contextKeyService.createKey(ACTIVE_WEBVIEW_PANEL_ID, '');
+        this.activeCustomEditorId = this.contextKeyService.createKey(ACTIVE_CUSTOM_EDITOR_ID, '');
         this.applicationShell.onDidChangeCurrentWidget(this.handleDidChangeCurrentWidget, this);
     }
 
+    getContextKeyValues(widget: Widget): Iterable<[string, unknown]> | undefined {
+        // A view toolbar item may key on the *active* editor, so only the editor-like widgets these keys can
+        // describe get an answer; everything else keeps the ambient value.
+        if (!CodeEditorWidgetUtil.is(widget)) {
+            return undefined;
+        }
+        return [
+            [ACTIVE_CUSTOM_EDITOR_ID, widget instanceof CustomEditorWidget ? widget.viewType : ''],
+            [ACTIVE_WEBVIEW_PANEL_ID, widget instanceof WebviewWidget ? widget.viewType : '']
+        ];
+    }
+
     protected handleDidChangeCurrentWidget(change: FocusTracker.IChangedArgs<Widget>): void {
         const { newValue } = change;
         if (newValue instanceof CustomEditorWidget) {

package/src/main/browser/webview/webview-environment.ts

@@ -20,6 +20,7 @@ import { Deferred } from '@theia/core/lib/common/promise-util';
 import { EnvVariablesServer } from '@theia/core/lib/common/env-variables';
 import URI from '@theia/core/lib/common/uri';
 import { WebviewExternalEndpoint } from '../../common/webview-protocol';
+import { PLUGIN_HOST_FRONTEND } from '../../../common/plugin-protocol';
 import { environment } from '@theia/core/shared/@theia/application-package/lib/environment';
 
 @injectable()
@@ -65,7 +66,7 @@ export class WebviewEnvironment {
     }
 
     async resourceRoot(host: string): Promise<string> {
-        if (host === 'frontend') {
+        if (host === PLUGIN_HOST_FRONTEND) {
             return (await this.externalEndpointUrl()).withPath('{{path}}').toString(true);
         }
 

package/src/main/common/paths/const.ts

@@ -0,0 +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
+// *****************************************************************************
+
+export namespace PluginPaths {
+    export const PLUGINS_LOGS_DIR = 'logs';
+    export const PLUGINS_GLOBAL_STORAGE_DIR = 'plugin-storage';
+    export const PLUGINS_WORKSPACE_STORAGE_DIR = 'workspace-storage';
+    /**
+     * Default number of per-session plugin log folders to retain. Shared between the backend's
+     * `--plugin-max-session-logs-folders` CLI option and the browser-only frontend, which has no
+     * CLI to read it from. This is the default value used in VSCode, see:
+     * https://github.com/Microsoft/vscode/blob/613447d6b3f458ef7fee227e3876303bf5184580/src/vs/code/electron-browser/sharedProcess/contrib/logsDataCleaner.ts#L32
+     */
+    export const DEFAULT_PLUGIN_MAX_SESSION_LOGS_FOLDERS = 10;
+}

package/src/main/node/paths/const.ts

@@ -14,8 +14,8 @@
 // SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
 // *****************************************************************************
 
-export namespace PluginPaths {
-    export const PLUGINS_LOGS_DIR = 'logs';
-    export const PLUGINS_GLOBAL_STORAGE_DIR = 'plugin-storage';
-    export const PLUGINS_WORKSPACE_STORAGE_DIR = 'workspace-storage';
-}
+/**
+ * @deprecated since 1.76.0 - `PluginPaths` moved to `@theia/plugin-ext/lib/main/common/paths/const`
+ * so the browser-only frontend can share it. Import it from there.
+ */
+export { PluginPaths } from '../../common/paths/const';

package/src/main/node/paths/plugin-paths-service.ts

@@ -23,7 +23,7 @@ import { remove } from '@theia/core/shared/fs-extra';
 import * as crypto from 'crypto';
 import { ILogger } from '@theia/core';
 import { FileUri } from '@theia/core/lib/node';
-import { PluginPaths } from './const';
+import { PluginPaths } from '../../common/paths/const';
 import { PluginPathsService } from '../../common/plugin-paths-protocol';
 import { UntitledWorkspaceService } from '@theia/workspace/lib/common';
 import { EnvVariablesServer } from '@theia/core/lib/common/env-variables';

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

@@ -18,6 +18,7 @@ import { injectable } from '@theia/core/shared/inversify';
 import { Argv, Arguments } from '@theia/core/shared/yargs';
 import { CliContribution } from '@theia/core/lib/node/cli';
 import { LocalDirectoryPluginDeployerResolver } from './resolvers/local-directory-plugin-deployer-resolver';
+import { PluginPaths } from '../common/paths/const';
 
 @injectable()
 export class PluginCliContribution implements CliContribution {
@@ -26,10 +27,10 @@ export class PluginCliContribution implements CliContribution {
     static PLUGIN_MAX_SESSION_LOGS_FOLDERS = 'plugin-max-session-logs-folders';
     static UNCOMPRESSED_PLUGINS_IN_PLACE = 'uncompressed-plugins-in-place';
     /**
-     * This is the default value used in VSCode, see:
-     * - https://github.com/Microsoft/vscode/blob/613447d6b3f458ef7fee227e3876303bf5184580/src/vs/code/electron-browser/sharedProcess/contrib/logsDataCleaner.ts#L32
+     * Shared with the browser-only frontend (which has no CLI to read this option from) via
+     * {@link PluginPaths.DEFAULT_PLUGIN_MAX_SESSION_LOGS_FOLDERS}, so the two defaults cannot drift apart.
      */
-    static DEFAULT_PLUGIN_MAX_SESSION_LOGS_FOLDERS = 10;
+    static DEFAULT_PLUGIN_MAX_SESSION_LOGS_FOLDERS = PluginPaths.DEFAULT_PLUGIN_MAX_SESSION_LOGS_FOLDERS;
 
     protected _localDir: string | undefined;
     protected _maxSessionLogsFolders: number;

package/src/main/node/plugins-key-value-storage.ts

@@ -21,7 +21,7 @@ import * as path from 'path';
 import { FileUri } from '@theia/core/lib/common/file-uri';
 import { Deferred } from '@theia/core/lib/common/promise-util';
 import { EnvVariablesServer } from '@theia/core/lib/common/env-variables';
-import { PluginPaths } from './paths/const';
+import { PluginPaths } from '../common/paths/const';
 import { PluginPathsService } from '../common/plugin-paths-protocol';
 import { KeysToAnyValues, KeysToKeysToAnyValue } from '../../common/types';
 import { PluginStorageKind } from '../../common';

package/src/main/node/resolvers/local-directory-plugin-deployer-resolver.spec.ts

@@ -0,0 +1,61 @@
+// *****************************************************************************
+// Copyright (C) 2026 Matthew Farrow 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 { expect } from 'chai';
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+import { LocalDirectoryPluginDeployerResolver } from './local-directory-plugin-deployer-resolver';
+import { PluginDeployerResolverContext } from '../../../common/plugin-protocol';
+
+describe('LocalDirectoryPluginDeployerResolver', () => {
+
+    let localPath: string;
+    let deployed: Map<string, string>;
+
+    beforeEach(() => {
+        localPath = fs.mkdtempSync(path.join(os.tmpdir(), 'theia-local-dir-'));
+        deployed = new Map();
+    });
+
+    afterEach(() => {
+        fs.rmSync(localPath, { recursive: true, force: true });
+    });
+
+    function createContext(): PluginDeployerResolverContext {
+        return {
+            getOriginId: () => `${LocalDirectoryPluginDeployerResolver.LOCAL_DIR}:${localPath}`,
+            addPlugin: (pluginId: string, pluginPath: string) => {
+                deployed.set(pluginId, pluginPath);
+            }
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        } as any as PluginDeployerResolverContext;
+    }
+
+    it('should skip files that are not plugins', async () => {
+        fs.mkdirSync(path.join(localPath, 'my.plugin'));
+        fs.writeFileSync(path.join(localPath, 'my-other.plugin.vsix'), '');
+        fs.writeFileSync(path.join(localPath, '.DS_Store'), '');
+        fs.writeFileSync(path.join(localPath, '._my.plugin'), '');
+        fs.writeFileSync(path.join(localPath, 'Thumbs.db'), '');
+        fs.writeFileSync(path.join(localPath, 'desktop.ini'), '');
+
+        await new LocalDirectoryPluginDeployerResolver().resolve(createContext());
+
+        expect([...deployed.keys()].sort()).to.deep.equal(['my-other.plugin.vsix', 'my.plugin']);
+        expect(deployed.get('my.plugin')).to.equal(path.resolve(localPath, 'my.plugin'));
+    });
+});

package/src/main/node/resolvers/local-directory-plugin-deployer-resolver.ts

@@ -20,6 +20,11 @@ import * as fs from '@theia/core/shared/fs-extra';
 import * as path from 'path';
 import { LocalPluginDeployerResolver } from './local-plugin-deployer-resolver';
 
+/**
+ * Lower-case names of files a file manager leaves behind, which are never plugins.
+ */
+const IGNORED_FILE_NAMES = new Set(['thumbs.db', 'desktop.ini']);
+
 @injectable()
 export class LocalDirectoryPluginDeployerResolver extends LocalPluginDeployerResolver {
     static LOCAL_DIR = 'local-dir';
@@ -30,8 +35,16 @@ export class LocalDirectoryPluginDeployerResolver extends LocalPluginDeployerRes
 
     protected async resolveFromLocalPath(pluginResolverContext: PluginDeployerResolverContext, localPath: string): Promise<void> {
         const files = await fs.readdir(localPath);
-        files.forEach(file =>
+        files.filter(file => !this.isIgnored(file)).forEach(file =>
             pluginResolverContext.addPlugin(file, path.resolve(localPath, file))
         );
     }
+
+    /**
+     * Whether a directory entry should be skipped instead of being deployed as a plugin.
+     * Covers dotfiles such as the macOS `.DS_Store` and the Windows `Thumbs.db` and `desktop.ini`.
+     */
+    protected isIgnored(file: string): boolean {
+        return file.startsWith('.') || IGNORED_FILE_NAMES.has(file.toLowerCase());
+    }
 }

package/src/plugin/plugin-context.ts

@@ -325,7 +325,8 @@ export function createAPIFactory(
     messageRegistryExt: MessageRegistryExt,
     clipboard: ClipboardExt,
     webviewExt: WebviewsExtImpl,
-    localizationExt: LocalizationExtImpl
+    localizationExt: LocalizationExtImpl,
+    telemetryExt: TelemetryExtImpl
 ): PluginAPIFactory {
 
     const authenticationExt = rpc.set(MAIN_RPC_CONTEXT.AUTHENTICATION_EXT, new AuthenticationExtImpl(rpc));
@@ -359,12 +360,12 @@ export function createAPIFactory(
     const tabsExt = rpc.set(MAIN_RPC_CONTEXT.TABS_EXT, new TabsExtImpl(rpc));
     const customEditorExt = rpc.set(MAIN_RPC_CONTEXT.CUSTOM_EDITORS_EXT, new CustomEditorsExtImpl(rpc, documents, webviewExt));
     const webviewViewsExt = rpc.set(MAIN_RPC_CONTEXT.WEBVIEW_VIEWS_EXT, new WebviewViewsExtImpl(rpc, webviewExt));
-    const telemetryExt = rpc.set(MAIN_RPC_CONTEXT.TELEMETRY_EXT, new TelemetryExtImpl());
     const testingExt = rpc.set(MAIN_RPC_CONTEXT.TESTING_EXT, new TestingExtImpl(rpc, commandRegistry));
     const uriExt = rpc.set(MAIN_RPC_CONTEXT.URI_EXT, new UriExtImpl(rpc));
     const lmExt = rpc.set(MAIN_RPC_CONTEXT.MCP_SERVER_DEFINITION_REGISTRY_EXT, new LmExtImpl(rpc));
     const lmToolExt = rpc.set(MAIN_RPC_CONTEXT.LM_TOOLS_EXT, new LanguageModelToolsExtImpl(rpc));
     rpc.set(MAIN_RPC_CONTEXT.DEBUG_EXT, debugExt);
+    rpc.set(MAIN_RPC_CONTEXT.TELEMETRY_EXT, telemetryExt);
 
     const commandLogger = new PluginLogger(rpc, 'commands-plugin');
 

package/src/plugin/plugin-manager.ts

@@ -37,6 +37,7 @@ import * as theia from '@theia/plugin';
 import * as types from './types-impl';
 import { join } from './path';
 import { EnvExtImpl } from './env';
+import { TelemetryExtImpl } from './telemetry-ext';
 import { PreferenceRegistryExtImpl } from './preference-registry';
 import { InternalStorageExt, Memento, GlobalState } from './plugin-storage';
 import { ExtPluginApi } from '../common/plugin-ext-api-contribution';
@@ -244,8 +245,12 @@ export abstract class AbstractPluginManagerExtImpl<P extends Record<string, any>
             contributes.jsonValidation = (contributes.jsonValidation || []).concat(this.jsonValidation);
         }
         this.registry.set(plugin.model.id, plugin);
+        if (!plugin.pluginPath) {
+            // No entry point at all, so nothing to activate here.
+            return;
+        }
         const activationEvents = this.getActivationEvents(plugin);
-        if (plugin.pluginPath && activationEvents) {
+        if (activationEvents) {
             const activation = () => this.$activatePlugin(plugin.model.id);
             // an internal activation event is a subject to change
             this.setActivation(`onPlugin:${plugin.model.id}`, activation);
@@ -474,6 +479,9 @@ export class PluginManagerExtImpl extends AbstractPluginManagerExtImpl<PluginMan
     @inject(WebviewsExtImpl)
     protected readonly webview: WebviewsExtImpl;
 
+    @inject(TelemetryExtImpl)
+    protected readonly telemetryExt: TelemetryExtImpl;
+
     private supportedActivationEvents: Set<string>;
 
     async $init(params: PluginManagerInitializeParams): Promise<void> {
@@ -489,6 +497,8 @@ export class PluginManagerExtImpl extends AbstractPluginManagerExtImpl<PluginMan
         this.envExt.setAppUriScheme(params.env.appUriScheme);
 
         this.preferencesManager.init(params.preferences);
+        // must be in place before activation: plugins create their telemetry loggers during `activate()`
+        this.telemetryExt.setLevel(params.telemetryLevel ?? 'off');
 
         if (params.extApi) {
             this.host.initExtApi(params.extApi);

package/src/plugin/relative-pattern.spec.ts

@@ -0,0 +1,55 @@
+// *****************************************************************************
+// Copyright (C) 2026 JuliaHub, 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 { expect } from 'chai';
+import * as os from 'os';
+import * as path from 'path';
+import { parse } from '@theia/core/lib/common/glob';
+import { isWindows } from '@theia/core/lib/common/os';
+import { URI } from '@theia/core/shared/vscode-uri';
+import { RelativePattern } from './types-impl';
+
+// This is the matching a `FileSystemWatcher` performs on every incoming event:
+// `ExtHostFileSystemEventService` builds `parse(globPattern)` once and applies it
+// to each event's `fsPath`. `wrapRelativePattern` rejects a base that is not a
+// parent of the path under `nativeSep`, so a backslash-separated base is only
+// reachable on Windows — elsewhere the pattern is rejected before the glob runs.
+(isWindows ? describe : describe.skip)('RelativePattern matching against native Windows paths', () => {
+
+    // Derive the child paths from the URI's own `fsPath`: `Uri.file` lower-cases the
+    // drive letter, and the parent check is case-sensitive.
+    const base = URI.file(path.join(os.tmpdir(), 'theia-relative-pattern'));
+
+    it('should match a file named by a bare-filename pattern', () => {
+        const matches = parse(new RelativePattern(base, 'Project.toml'));
+        expect(matches(path.join(base.fsPath, 'Project.toml'))).to.be.ok;
+    });
+
+    it('should not match a different file in the same folder', () => {
+        const matches = parse(new RelativePattern(base, 'Project.toml'));
+        expect(matches(path.join(base.fsPath, 'Manifest.toml'))).to.not.be.ok;
+    });
+
+    it('should match a nested file named by a subpath pattern', () => {
+        const matches = parse(new RelativePattern(base, 'generated/*.jl'));
+        expect(matches(path.join(base.fsPath, 'generated', 'definitions.jl'))).to.be.ok;
+    });
+
+    it('should not match a file outside the subpath of the pattern', () => {
+        const matches = parse(new RelativePattern(base, 'generated/*.jl'));
+        expect(matches(path.join(base.fsPath, 'definitions.jl'))).to.not.be.ok;
+    });
+});