@theia/preferences 1.45.1 → 1.46.0-next.72

package/src/browser/monaco-jsonc-editor.ts

@@ -1,67 +1,67 @@
-// *****************************************************************************
-// Copyright (C) 2021 Ericsson 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 jsoncparser from 'jsonc-parser';
-import { MonacoEditorModel } from '@theia/monaco/lib/browser/monaco-editor-model';
-import { MonacoWorkspace } from '@theia/monaco/lib/browser/monaco-workspace';
-import { inject, injectable } from '@theia/core/shared/inversify';
-import * as monaco from '@theia/monaco-editor-core';
-
-@injectable()
-export class MonacoJSONCEditor {
-    @inject(MonacoWorkspace) protected readonly workspace: MonacoWorkspace;
-
-    async setValue(model: MonacoEditorModel, path: jsoncparser.JSONPath, value: unknown, shouldSave = true): Promise<void> {
-        const edits = this.getEditOperations(model, path, value);
-        if (edits.length > 0) {
-            await this.workspace.applyBackgroundEdit(model, edits, shouldSave);
-        }
-    }
-
-    getEditOperations(model: MonacoEditorModel, path: jsoncparser.JSONPath, value: unknown): monaco.editor.IIdentifiedSingleEditOperation[] {
-        const textModel = model.textEditorModel;
-        const content = model.getText().trim();
-        // Everything is already undefined - no need for changes.
-        if (!content && value === undefined) {
-            return [];
-        }
-        // Delete the entire document.
-        if (!path.length && value === undefined) {
-            return [{
-                range: textModel.getFullModelRange(),
-                text: null, // eslint-disable-line no-null/no-null
-                forceMoveMarkers: false
-            }];
-        }
-        const { insertSpaces, tabSize, defaultEOL } = textModel.getOptions();
-        const jsonCOptions = {
-            formattingOptions: {
-                insertSpaces,
-                tabSize,
-                eol: defaultEOL === monaco.editor.DefaultEndOfLine.LF ? '\n' : '\r\n'
-            }
-        };
-        return jsoncparser.modify(content, path, value, jsonCOptions).map(edit => {
-            const start = textModel.getPositionAt(edit.offset);
-            const end = textModel.getPositionAt(edit.offset + edit.length);
-            return {
-                range: monaco.Range.fromPositions(start, end),
-                text: edit.content || null, // eslint-disable-line no-null/no-null
-                forceMoveMarkers: false
-            };
-        });
-    }
-}
+// *****************************************************************************
+// Copyright (C) 2021 Ericsson 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 jsoncparser from 'jsonc-parser';
+import { MonacoEditorModel } from '@theia/monaco/lib/browser/monaco-editor-model';
+import { MonacoWorkspace } from '@theia/monaco/lib/browser/monaco-workspace';
+import { inject, injectable } from '@theia/core/shared/inversify';
+import * as monaco from '@theia/monaco-editor-core';
+
+@injectable()
+export class MonacoJSONCEditor {
+    @inject(MonacoWorkspace) protected readonly workspace: MonacoWorkspace;
+
+    async setValue(model: MonacoEditorModel, path: jsoncparser.JSONPath, value: unknown, shouldSave = true): Promise<void> {
+        const edits = this.getEditOperations(model, path, value);
+        if (edits.length > 0) {
+            await this.workspace.applyBackgroundEdit(model, edits, shouldSave);
+        }
+    }
+
+    getEditOperations(model: MonacoEditorModel, path: jsoncparser.JSONPath, value: unknown): monaco.editor.IIdentifiedSingleEditOperation[] {
+        const textModel = model.textEditorModel;
+        const content = model.getText().trim();
+        // Everything is already undefined - no need for changes.
+        if (!content && value === undefined) {
+            return [];
+        }
+        // Delete the entire document.
+        if (!path.length && value === undefined) {
+            return [{
+                range: textModel.getFullModelRange(),
+                text: null, // eslint-disable-line no-null/no-null
+                forceMoveMarkers: false
+            }];
+        }
+        const { insertSpaces, tabSize, defaultEOL } = textModel.getOptions();
+        const jsonCOptions = {
+            formattingOptions: {
+                insertSpaces,
+                tabSize,
+                eol: defaultEOL === monaco.editor.DefaultEndOfLine.LF ? '\n' : '\r\n'
+            }
+        };
+        return jsoncparser.modify(content, path, value, jsonCOptions).map(edit => {
+            const start = textModel.getPositionAt(edit.offset);
+            const end = textModel.getPositionAt(edit.offset + edit.length);
+            return {
+                range: monaco.Range.fromPositions(start, end),
+                text: edit.content || null, // eslint-disable-line no-null/no-null
+                forceMoveMarkers: false
+            };
+        });
+    }
+}

package/src/browser/package.spec.ts

@@ -1,28 +1,28 @@
-// *****************************************************************************
-// Copyright (C) 2018 Ericsson 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('preferences package', () => {
-
-    it('should support code coverage statistics', () => true);
-});
+// *****************************************************************************
+// Copyright (C) 2018 Ericsson 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('preferences package', () => {
+
+    it('should support code coverage statistics', () => true);
+});

package/src/browser/preference-bindings.ts

@@ -1,65 +1,65 @@
-// *****************************************************************************
-// Copyright (C) 2018 Ericsson 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 { Container, interfaces } from '@theia/core/shared/inversify';
-import { PreferenceProvider, PreferenceScope } from '@theia/core/lib/browser/preferences';
-import { UserPreferenceProvider, UserPreferenceProviderFactory } from './user-preference-provider';
-import { WorkspacePreferenceProvider } from './workspace-preference-provider';
-import { WorkspaceFilePreferenceProvider, WorkspaceFilePreferenceProviderFactory, WorkspaceFilePreferenceProviderOptions } from './workspace-file-preference-provider';
-import { FoldersPreferencesProvider } from './folders-preferences-provider';
-import { FolderPreferenceProvider, FolderPreferenceProviderFactory, FolderPreferenceProviderFolder } from './folder-preference-provider';
-import { UserConfigsPreferenceProvider } from './user-configs-preference-provider';
-import { SectionPreferenceProviderUri, SectionPreferenceProviderSection } from './section-preference-provider';
-
-export function bindWorkspaceFilePreferenceProvider(bind: interfaces.Bind): void {
-    bind(WorkspaceFilePreferenceProviderFactory).toFactory(ctx => (options: WorkspaceFilePreferenceProviderOptions) => {
-        const child = new Container({ defaultScope: 'Singleton' });
-        child.parent = ctx.container;
-        child.bind(WorkspaceFilePreferenceProvider).toSelf();
-        child.bind(WorkspaceFilePreferenceProviderOptions).toConstantValue(options);
-        return child.get(WorkspaceFilePreferenceProvider);
-    });
-}
-
-export function bindFactory<F, C>(bind: interfaces.Bind,
-    factoryId: interfaces.ServiceIdentifier<F>,
-    constructor: interfaces.Newable<C>,
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    ...parameterBindings: interfaces.ServiceIdentifier<any>[]): void {
-    bind(factoryId).toFactory(ctx =>
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        (...args: any[]) => {
-            const child = new Container({ defaultScope: 'Singleton' });
-            child.parent = ctx.container;
-            for (let i = 0; i < parameterBindings.length; i++) {
-                child.bind(parameterBindings[i]).toConstantValue(args[i]);
-            }
-            child.bind(constructor).to(constructor);
-            return child.get(constructor);
-        }
-    );
-}
-
-export function bindPreferenceProviders(bind: interfaces.Bind, unbind: interfaces.Unbind): void {
-    unbind(PreferenceProvider);
-
-    bind(PreferenceProvider).to(UserConfigsPreferenceProvider).inSingletonScope().whenTargetNamed(PreferenceScope.User);
-    bind(PreferenceProvider).to(WorkspacePreferenceProvider).inSingletonScope().whenTargetNamed(PreferenceScope.Workspace);
-    bind(PreferenceProvider).to(FoldersPreferencesProvider).inSingletonScope().whenTargetNamed(PreferenceScope.Folder);
-    bindWorkspaceFilePreferenceProvider(bind);
-    bindFactory(bind, UserPreferenceProviderFactory, UserPreferenceProvider, SectionPreferenceProviderUri, SectionPreferenceProviderSection);
-    bindFactory(bind, FolderPreferenceProviderFactory, FolderPreferenceProvider, SectionPreferenceProviderUri, SectionPreferenceProviderSection, FolderPreferenceProviderFolder);
-}
+// *****************************************************************************
+// Copyright (C) 2018 Ericsson 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 { Container, interfaces } from '@theia/core/shared/inversify';
+import { PreferenceProvider, PreferenceScope } from '@theia/core/lib/browser/preferences';
+import { UserPreferenceProvider, UserPreferenceProviderFactory } from './user-preference-provider';
+import { WorkspacePreferenceProvider } from './workspace-preference-provider';
+import { WorkspaceFilePreferenceProvider, WorkspaceFilePreferenceProviderFactory, WorkspaceFilePreferenceProviderOptions } from './workspace-file-preference-provider';
+import { FoldersPreferencesProvider } from './folders-preferences-provider';
+import { FolderPreferenceProvider, FolderPreferenceProviderFactory, FolderPreferenceProviderFolder } from './folder-preference-provider';
+import { UserConfigsPreferenceProvider } from './user-configs-preference-provider';
+import { SectionPreferenceProviderUri, SectionPreferenceProviderSection } from './section-preference-provider';
+
+export function bindWorkspaceFilePreferenceProvider(bind: interfaces.Bind): void {
+    bind(WorkspaceFilePreferenceProviderFactory).toFactory(ctx => (options: WorkspaceFilePreferenceProviderOptions) => {
+        const child = new Container({ defaultScope: 'Singleton' });
+        child.parent = ctx.container;
+        child.bind(WorkspaceFilePreferenceProvider).toSelf();
+        child.bind(WorkspaceFilePreferenceProviderOptions).toConstantValue(options);
+        return child.get(WorkspaceFilePreferenceProvider);
+    });
+}
+
+export function bindFactory<F, C>(bind: interfaces.Bind,
+    factoryId: interfaces.ServiceIdentifier<F>,
+    constructor: interfaces.Newable<C>,
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    ...parameterBindings: interfaces.ServiceIdentifier<any>[]): void {
+    bind(factoryId).toFactory(ctx =>
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        (...args: any[]) => {
+            const child = new Container({ defaultScope: 'Singleton' });
+            child.parent = ctx.container;
+            for (let i = 0; i < parameterBindings.length; i++) {
+                child.bind(parameterBindings[i]).toConstantValue(args[i]);
+            }
+            child.bind(constructor).to(constructor);
+            return child.get(constructor);
+        }
+    );
+}
+
+export function bindPreferenceProviders(bind: interfaces.Bind, unbind: interfaces.Unbind): void {
+    unbind(PreferenceProvider);
+
+    bind(PreferenceProvider).to(UserConfigsPreferenceProvider).inSingletonScope().whenTargetNamed(PreferenceScope.User);
+    bind(PreferenceProvider).to(WorkspacePreferenceProvider).inSingletonScope().whenTargetNamed(PreferenceScope.Workspace);
+    bind(PreferenceProvider).to(FoldersPreferencesProvider).inSingletonScope().whenTargetNamed(PreferenceScope.Folder);
+    bindWorkspaceFilePreferenceProvider(bind);
+    bindFactory(bind, UserPreferenceProviderFactory, UserPreferenceProvider, SectionPreferenceProviderUri, SectionPreferenceProviderSection);
+    bindFactory(bind, FolderPreferenceProviderFactory, FolderPreferenceProvider, SectionPreferenceProviderUri, SectionPreferenceProviderSection, FolderPreferenceProviderFolder);
+}

package/src/browser/preference-frontend-module.ts

@@ -1,57 +1,57 @@
-// *****************************************************************************
-// Copyright (C) 2018 Ericsson 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 '../../src/browser/style/index.css';
-import './preferences-monaco-contribution';
-import { ContainerModule, interfaces } from '@theia/core/shared/inversify';
-import { bindViewContribution, OpenHandler } from '@theia/core/lib/browser';
-import { TabBarToolbarContribution } from '@theia/core/lib/browser/shell/tab-bar-toolbar';
-import { PreferenceTreeGenerator } from './util/preference-tree-generator';
-import { bindPreferenceProviders } from './preference-bindings';
-import { bindPreferencesWidgets } from './views/preference-widget-bindings';
-import { PreferencesContribution } from './preferences-contribution';
-import { PreferenceScopeCommandManager } from './util/preference-scope-command-manager';
-import { JsonSchemaContribution } from '@theia/core/lib/browser/json-schema-store';
-import { PreferencesJsonSchemaContribution } from './preferences-json-schema-contribution';
-import { MonacoJSONCEditor } from './monaco-jsonc-editor';
-import { PreferenceTransaction, PreferenceTransactionFactory, preferenceTransactionFactoryCreator } from './preference-transaction-manager';
-import { PreferenceOpenHandler } from './preference-open-handler';
-
-export function bindPreferences(bind: interfaces.Bind, unbind: interfaces.Unbind): void {
-    bindPreferenceProviders(bind, unbind);
-    bindPreferencesWidgets(bind);
-
-    bind(PreferenceTreeGenerator).toSelf().inSingletonScope();
-
-    bindViewContribution(bind, PreferencesContribution);
-
-    bind(PreferenceOpenHandler).toSelf().inSingletonScope();
-    bind(OpenHandler).toService(PreferenceOpenHandler);
-
-    bind(PreferenceScopeCommandManager).toSelf().inSingletonScope();
-    bind(TabBarToolbarContribution).toService(PreferencesContribution);
-
-    bind(PreferencesJsonSchemaContribution).toSelf().inSingletonScope();
-    bind(JsonSchemaContribution).toService(PreferencesJsonSchemaContribution);
-
-    bind(MonacoJSONCEditor).toSelf().inSingletonScope();
-    bind(PreferenceTransaction).toSelf();
-    bind(PreferenceTransactionFactory).toFactory(preferenceTransactionFactoryCreator);
-}
-
-export default new ContainerModule((bind, unbind, isBound, rebind) => {
-    bindPreferences(bind, unbind);
-});
+// *****************************************************************************
+// Copyright (C) 2018 Ericsson 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 '../../src/browser/style/index.css';
+import './preferences-monaco-contribution';
+import { ContainerModule, interfaces } from '@theia/core/shared/inversify';
+import { bindViewContribution, OpenHandler } from '@theia/core/lib/browser';
+import { TabBarToolbarContribution } from '@theia/core/lib/browser/shell/tab-bar-toolbar';
+import { PreferenceTreeGenerator } from './util/preference-tree-generator';
+import { bindPreferenceProviders } from './preference-bindings';
+import { bindPreferencesWidgets } from './views/preference-widget-bindings';
+import { PreferencesContribution } from './preferences-contribution';
+import { PreferenceScopeCommandManager } from './util/preference-scope-command-manager';
+import { JsonSchemaContribution } from '@theia/core/lib/browser/json-schema-store';
+import { PreferencesJsonSchemaContribution } from './preferences-json-schema-contribution';
+import { MonacoJSONCEditor } from './monaco-jsonc-editor';
+import { PreferenceTransaction, PreferenceTransactionFactory, preferenceTransactionFactoryCreator } from './preference-transaction-manager';
+import { PreferenceOpenHandler } from './preference-open-handler';
+
+export function bindPreferences(bind: interfaces.Bind, unbind: interfaces.Unbind): void {
+    bindPreferenceProviders(bind, unbind);
+    bindPreferencesWidgets(bind);
+
+    bind(PreferenceTreeGenerator).toSelf().inSingletonScope();
+
+    bindViewContribution(bind, PreferencesContribution);
+
+    bind(PreferenceOpenHandler).toSelf().inSingletonScope();
+    bind(OpenHandler).toService(PreferenceOpenHandler);
+
+    bind(PreferenceScopeCommandManager).toSelf().inSingletonScope();
+    bind(TabBarToolbarContribution).toService(PreferencesContribution);
+
+    bind(PreferencesJsonSchemaContribution).toSelf().inSingletonScope();
+    bind(JsonSchemaContribution).toService(PreferencesJsonSchemaContribution);
+
+    bind(MonacoJSONCEditor).toSelf().inSingletonScope();
+    bind(PreferenceTransaction).toSelf();
+    bind(PreferenceTransactionFactory).toFactory(preferenceTransactionFactoryCreator);
+}
+
+export default new ContainerModule((bind, unbind, isBound, rebind) => {
+    bindPreferences(bind, unbind);
+});

package/src/browser/preference-open-handler.ts

@@ -1,53 +1,53 @@
-// *****************************************************************************
-// Copyright (C) 2022 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 { animationFrame, OpenHandler } from '@theia/core/lib/browser';
-import URI from '@theia/core/lib/common/uri';
-import { injectable, inject } from '@theia/core/shared/inversify';
-import { PreferencesContribution } from './preferences-contribution';
-
-@injectable()
-export class PreferenceOpenHandler implements OpenHandler {
-
-    readonly id = 'preference';
-
-    @inject(PreferencesContribution)
-    protected readonly preferencesContribution: PreferencesContribution;
-
-    canHandle(uri: URI): number {
-        return uri.scheme === this.id ? 500 : -1;
-    }
-
-    async open(uri: URI): Promise<boolean> {
-        const preferencesWidget = await this.preferencesContribution.openView();
-        const selector = `li[data-pref-id="${uri.path.toString()}"]:not([data-node-id^="commonly-used@"])`;
-        const element = document.querySelector(selector);
-        if (element instanceof HTMLElement) {
-            if (element.classList.contains('hidden')) {
-                // We clear the search term as we have clicked on a hidden preference
-                await preferencesWidget.setSearchTerm('');
-                await animationFrame();
-            }
-            element.scrollIntoView({
-                block: 'center'
-            });
-            element.focus();
-            return true;
-        }
-        return false;
-    }
-
-}
+// *****************************************************************************
+// Copyright (C) 2022 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 { animationFrame, OpenHandler } from '@theia/core/lib/browser';
+import URI from '@theia/core/lib/common/uri';
+import { injectable, inject } from '@theia/core/shared/inversify';
+import { PreferencesContribution } from './preferences-contribution';
+
+@injectable()
+export class PreferenceOpenHandler implements OpenHandler {
+
+    readonly id = 'preference';
+
+    @inject(PreferencesContribution)
+    protected readonly preferencesContribution: PreferencesContribution;
+
+    canHandle(uri: URI): number {
+        return uri.scheme === this.id ? 500 : -1;
+    }
+
+    async open(uri: URI): Promise<boolean> {
+        const preferencesWidget = await this.preferencesContribution.openView();
+        const selector = `li[data-pref-id="${uri.path.toString()}"]:not([data-node-id^="commonly-used@"])`;
+        const element = document.querySelector(selector);
+        if (element instanceof HTMLElement) {
+            if (element.classList.contains('hidden')) {
+                // We clear the search term as we have clicked on a hidden preference
+                await preferencesWidget.setSearchTerm('');
+                await animationFrame();
+            }
+            element.scrollIntoView({
+                block: 'center'
+            });
+            element.focus();
+            return true;
+        }
+        return false;
+    }
+
+}