@theia/core 1.48.1 → 1.48.3

package/lib/browser/preferences/preference-language-override-service.d.ts

@@ -1,40 +1,40 @@
-import { PreferenceSchemaProperties } from '../../common/preferences/preference-schema';
-export interface OverridePreferenceName {
-    preferenceName: string;
-    overrideIdentifier: string;
-}
-export declare namespace OverridePreferenceName {
-    function is(arg: unknown): arg is OverridePreferenceName;
-}
-export declare const OVERRIDE_PROPERTY_PATTERN: RegExp;
-export declare const getOverridePattern: (identifier: string) => string;
-export declare class PreferenceLanguageOverrideService {
-    protected readonly overrideIdentifiers: Set<string>;
-    testOverrideValue(name: string, value: unknown): value is PreferenceSchemaProperties;
-    /**
-     * @param overrideIdentifier the language id associated for a language override, e.g. `typescript`
-     * @returns the form used to mark language overrides in preference files, e.g. `[typescript]`
-     */
-    markLanguageOverride(overrideIdentifier: string): string;
-    /**
-     * @returns the flat JSON path to an overridden preference, e.g. [typescript].editor.tabSize.
-     */
-    overridePreferenceName({ preferenceName, overrideIdentifier }: OverridePreferenceName): string;
-    /**
-     * @returns an OverridePreferenceName if the `name` contains a language override, e.g. [typescript].editor.tabSize.
-     */
-    overriddenPreferenceName(name: string): OverridePreferenceName | undefined;
-    computeOverridePatternPropertiesKey(): string | undefined;
-    getOverridePreferenceNames(preferenceName: string): IterableIterator<string>;
-    /**
-     * @param overrideIdentifier
-     * @returns true if the addition caused a change, i.e. if the identifier was not already present in the set of identifiers, false otherwise.
-     */
-    addOverrideIdentifier(overrideIdentifier: string): boolean;
-    /**
-     * @param overrideIdentifier
-     * @returns true if the deletion caused a change, i.e. if the identifier was present in the set, false otherwise.
-     */
-    removeOverrideIdentifier(overrideIdentifier: string): boolean;
-}
+import { PreferenceSchemaProperties } from '../../common/preferences/preference-schema';
+export interface OverridePreferenceName {
+    preferenceName: string;
+    overrideIdentifier: string;
+}
+export declare namespace OverridePreferenceName {
+    function is(arg: unknown): arg is OverridePreferenceName;
+}
+export declare const OVERRIDE_PROPERTY_PATTERN: RegExp;
+export declare const getOverridePattern: (identifier: string) => string;
+export declare class PreferenceLanguageOverrideService {
+    protected readonly overrideIdentifiers: Set<string>;
+    testOverrideValue(name: string, value: unknown): value is PreferenceSchemaProperties;
+    /**
+     * @param overrideIdentifier the language id associated for a language override, e.g. `typescript`
+     * @returns the form used to mark language overrides in preference files, e.g. `[typescript]`
+     */
+    markLanguageOverride(overrideIdentifier: string): string;
+    /**
+     * @returns the flat JSON path to an overridden preference, e.g. [typescript].editor.tabSize.
+     */
+    overridePreferenceName({ preferenceName, overrideIdentifier }: OverridePreferenceName): string;
+    /**
+     * @returns an OverridePreferenceName if the `name` contains a language override, e.g. [typescript].editor.tabSize.
+     */
+    overriddenPreferenceName(name: string): OverridePreferenceName | undefined;
+    computeOverridePatternPropertiesKey(): string | undefined;
+    getOverridePreferenceNames(preferenceName: string): IterableIterator<string>;
+    /**
+     * @param overrideIdentifier
+     * @returns true if the addition caused a change, i.e. if the identifier was not already present in the set of identifiers, false otherwise.
+     */
+    addOverrideIdentifier(overrideIdentifier: string): boolean;
+    /**
+     * @param overrideIdentifier
+     * @returns true if the deletion caused a change, i.e. if the identifier was present in the set, false otherwise.
+     */
+    removeOverrideIdentifier(overrideIdentifier: string): boolean;
+}
 //# sourceMappingURL=preference-language-override-service.d.ts.map

package/lib/browser/preferences/preference-language-override-service.js

@@ -1,108 +1,108 @@
-"use strict";
-// *****************************************************************************
-// 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
-// *****************************************************************************
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PreferenceLanguageOverrideService = exports.getOverridePattern = exports.OVERRIDE_PROPERTY_PATTERN = exports.OverridePreferenceName = void 0;
-const tslib_1 = require("tslib");
-const inversify_1 = require("inversify");
-const common_1 = require("../../common");
-const preference_schema_1 = require("../../common/preferences/preference-schema");
-var OverridePreferenceName;
-(function (OverridePreferenceName) {
-    function is(arg) {
-        return (0, common_1.isObject)(arg) && 'preferenceName' in arg && 'overrideIdentifier' in arg;
-    }
-    OverridePreferenceName.is = is;
-})(OverridePreferenceName = exports.OverridePreferenceName || (exports.OverridePreferenceName = {}));
-const OVERRIDE_PROPERTY = '\\[(.*)\\]$';
-exports.OVERRIDE_PROPERTY_PATTERN = new RegExp(OVERRIDE_PROPERTY);
-const getOverridePattern = (identifier) => `\\[(${identifier})\\]$`;
-exports.getOverridePattern = getOverridePattern;
-let PreferenceLanguageOverrideService = class PreferenceLanguageOverrideService {
-    constructor() {
-        this.overrideIdentifiers = new Set();
-    }
-    testOverrideValue(name, value) {
-        return preference_schema_1.PreferenceSchemaProperties.is(value) && exports.OVERRIDE_PROPERTY_PATTERN.test(name);
-    }
-    /**
-     * @param overrideIdentifier the language id associated for a language override, e.g. `typescript`
-     * @returns the form used to mark language overrides in preference files, e.g. `[typescript]`
-     */
-    markLanguageOverride(overrideIdentifier) {
-        return `[${overrideIdentifier}]`;
-    }
-    /**
-     * @returns the flat JSON path to an overridden preference, e.g. [typescript].editor.tabSize.
-     */
-    overridePreferenceName({ preferenceName, overrideIdentifier }) {
-        return `${this.markLanguageOverride(overrideIdentifier)}.${preferenceName}`;
-    }
-    /**
-     * @returns an OverridePreferenceName if the `name` contains a language override, e.g. [typescript].editor.tabSize.
-     */
-    overriddenPreferenceName(name) {
-        const index = name.indexOf('.');
-        if (index === -1) {
-            return undefined;
-        }
-        const matches = name.substring(0, index).match(exports.OVERRIDE_PROPERTY_PATTERN);
-        const overrideIdentifier = matches && matches[1];
-        if (!overrideIdentifier || !this.overrideIdentifiers.has(overrideIdentifier)) {
-            return undefined;
-        }
-        const preferenceName = name.substring(index + 1);
-        return { preferenceName, overrideIdentifier };
-    }
-    computeOverridePatternPropertiesKey() {
-        let param = '';
-        for (const overrideIdentifier of this.overrideIdentifiers) {
-            if (param.length) {
-                param += '|';
-            }
-            param += new RegExp((0, common_1.escapeRegExpCharacters)(overrideIdentifier)).source;
-        }
-        return param.length ? (0, exports.getOverridePattern)(param) : undefined;
-    }
-    *getOverridePreferenceNames(preferenceName) {
-        for (const overrideIdentifier of this.overrideIdentifiers) {
-            yield this.overridePreferenceName({ preferenceName, overrideIdentifier });
-        }
-    }
-    /**
-     * @param overrideIdentifier
-     * @returns true if the addition caused a change, i.e. if the identifier was not already present in the set of identifiers, false otherwise.
-     */
-    addOverrideIdentifier(overrideIdentifier) {
-        const alreadyPresent = this.overrideIdentifiers.has(overrideIdentifier);
-        if (!alreadyPresent) {
-            this.overrideIdentifiers.add(overrideIdentifier);
-        }
-        return !alreadyPresent;
-    }
-    /**
-     * @param overrideIdentifier
-     * @returns true if the deletion caused a change, i.e. if the identifier was present in the set, false otherwise.
-     */
-    removeOverrideIdentifier(overrideIdentifier) {
-        return this.overrideIdentifiers.delete(overrideIdentifier);
-    }
-};
-PreferenceLanguageOverrideService = (0, tslib_1.__decorate)([
-    (0, inversify_1.injectable)()
-], PreferenceLanguageOverrideService);
-exports.PreferenceLanguageOverrideService = PreferenceLanguageOverrideService;
+"use strict";
+// *****************************************************************************
+// 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
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PreferenceLanguageOverrideService = exports.getOverridePattern = exports.OVERRIDE_PROPERTY_PATTERN = exports.OverridePreferenceName = void 0;
+const tslib_1 = require("tslib");
+const inversify_1 = require("inversify");
+const common_1 = require("../../common");
+const preference_schema_1 = require("../../common/preferences/preference-schema");
+var OverridePreferenceName;
+(function (OverridePreferenceName) {
+    function is(arg) {
+        return (0, common_1.isObject)(arg) && 'preferenceName' in arg && 'overrideIdentifier' in arg;
+    }
+    OverridePreferenceName.is = is;
+})(OverridePreferenceName = exports.OverridePreferenceName || (exports.OverridePreferenceName = {}));
+const OVERRIDE_PROPERTY = '\\[(.*)\\]$';
+exports.OVERRIDE_PROPERTY_PATTERN = new RegExp(OVERRIDE_PROPERTY);
+const getOverridePattern = (identifier) => `\\[(${identifier})\\]$`;
+exports.getOverridePattern = getOverridePattern;
+let PreferenceLanguageOverrideService = class PreferenceLanguageOverrideService {
+    constructor() {
+        this.overrideIdentifiers = new Set();
+    }
+    testOverrideValue(name, value) {
+        return preference_schema_1.PreferenceSchemaProperties.is(value) && exports.OVERRIDE_PROPERTY_PATTERN.test(name);
+    }
+    /**
+     * @param overrideIdentifier the language id associated for a language override, e.g. `typescript`
+     * @returns the form used to mark language overrides in preference files, e.g. `[typescript]`
+     */
+    markLanguageOverride(overrideIdentifier) {
+        return `[${overrideIdentifier}]`;
+    }
+    /**
+     * @returns the flat JSON path to an overridden preference, e.g. [typescript].editor.tabSize.
+     */
+    overridePreferenceName({ preferenceName, overrideIdentifier }) {
+        return `${this.markLanguageOverride(overrideIdentifier)}.${preferenceName}`;
+    }
+    /**
+     * @returns an OverridePreferenceName if the `name` contains a language override, e.g. [typescript].editor.tabSize.
+     */
+    overriddenPreferenceName(name) {
+        const index = name.indexOf('.');
+        if (index === -1) {
+            return undefined;
+        }
+        const matches = name.substring(0, index).match(exports.OVERRIDE_PROPERTY_PATTERN);
+        const overrideIdentifier = matches && matches[1];
+        if (!overrideIdentifier || !this.overrideIdentifiers.has(overrideIdentifier)) {
+            return undefined;
+        }
+        const preferenceName = name.substring(index + 1);
+        return { preferenceName, overrideIdentifier };
+    }
+    computeOverridePatternPropertiesKey() {
+        let param = '';
+        for (const overrideIdentifier of this.overrideIdentifiers) {
+            if (param.length) {
+                param += '|';
+            }
+            param += new RegExp((0, common_1.escapeRegExpCharacters)(overrideIdentifier)).source;
+        }
+        return param.length ? (0, exports.getOverridePattern)(param) : undefined;
+    }
+    *getOverridePreferenceNames(preferenceName) {
+        for (const overrideIdentifier of this.overrideIdentifiers) {
+            yield this.overridePreferenceName({ preferenceName, overrideIdentifier });
+        }
+    }
+    /**
+     * @param overrideIdentifier
+     * @returns true if the addition caused a change, i.e. if the identifier was not already present in the set of identifiers, false otherwise.
+     */
+    addOverrideIdentifier(overrideIdentifier) {
+        const alreadyPresent = this.overrideIdentifiers.has(overrideIdentifier);
+        if (!alreadyPresent) {
+            this.overrideIdentifiers.add(overrideIdentifier);
+        }
+        return !alreadyPresent;
+    }
+    /**
+     * @param overrideIdentifier
+     * @returns true if the deletion caused a change, i.e. if the identifier was present in the set, false otherwise.
+     */
+    removeOverrideIdentifier(overrideIdentifier) {
+        return this.overrideIdentifiers.delete(overrideIdentifier);
+    }
+};
+PreferenceLanguageOverrideService = (0, tslib_1.__decorate)([
+    (0, inversify_1.injectable)()
+], PreferenceLanguageOverrideService);
+exports.PreferenceLanguageOverrideService = PreferenceLanguageOverrideService;
 //# sourceMappingURL=preference-language-override-service.js.map

package/lib/browser/preferences/preference-provider.d.ts

@@ -1,133 +1,133 @@
-import { JSONValue } from '@phosphor/coreutils';
-import URI from '../../common/uri';
-import { Disposable, DisposableCollection, Emitter, Event } from '../../common';
-import { Deferred } from '../../common/promise-util';
-import { PreferenceScope } from './preference-scope';
-import { PreferenceLanguageOverrideService } from './preference-language-override-service';
-export interface PreferenceProviderDataChange {
-    /**
-     * The name of the changed preference.
-     */
-    readonly preferenceName: string;
-    /**
-     * The new value of the changed preference.
-     */
-    readonly newValue?: any;
-    /**
-     * The old value of the changed preference.
-     */
-    readonly oldValue?: any;
-    /**
-     * The {@link PreferenceScope} of the changed preference.
-     */
-    readonly scope: PreferenceScope;
-    /**
-     * URIs of the scopes in which this change applies.
-     */
-    readonly domain?: string[];
-}
-export declare namespace PreferenceProviderDataChange {
-    function affects(change: PreferenceProviderDataChange, resourceUri?: string): boolean;
-}
-export interface PreferenceProviderDataChanges {
-    [preferenceName: string]: PreferenceProviderDataChange;
-}
-export interface PreferenceResolveResult<T> {
-    configUri?: URI;
-    value?: T;
-}
-/**
- * The {@link PreferenceProvider} is used to store and retrieve preference values. A {@link PreferenceProvider} does not operate in a global scope but is
- * configured for one or more {@link PreferenceScope}s. The (default implementation for the) {@link PreferenceService} aggregates all {@link PreferenceProvider}s and
- * serves as a common facade for manipulating preference values.
- */
-export declare abstract class PreferenceProvider implements Disposable {
-    protected readonly preferenceOverrideService: PreferenceLanguageOverrideService;
-    protected readonly onDidPreferencesChangedEmitter: Emitter<PreferenceProviderDataChanges>;
-    readonly onDidPreferencesChanged: Event<PreferenceProviderDataChanges>;
-    protected readonly toDispose: DisposableCollection;
-    protected readonly _ready: Deferred<void>;
-    constructor();
-    dispose(): void;
-    protected deferredChanges: PreferenceProviderDataChanges | undefined;
-    /**
-     * Informs the listeners that one or more preferences of this provider are changed.
-     * The listeners are able to find what was changed from the emitted event.
-     */
-    protected emitPreferencesChangedEvent(changes: PreferenceProviderDataChanges | PreferenceProviderDataChange[]): Promise<boolean>;
-    protected mergePreferenceProviderDataChange(change: PreferenceProviderDataChange): void;
-    protected fireDidPreferencesChanged: () => Promise<boolean>;
-    /**
-     * Retrieve the stored value for the given preference and resource URI.
-     *
-     * @param preferenceName the preference identifier.
-     * @param resourceUri the uri of the resource for which the preference is stored. This is used to retrieve
-     * a potentially different value for the same preference for different resources, for example `files.encoding`.
-     *
-     * @returns the value stored for the given preference and resourceUri if it exists, otherwise `undefined`.
-     */
-    get<T>(preferenceName: string, resourceUri?: string): T | undefined;
-    /**
-     * Resolve the value for the given preference and resource URI.
-     *
-     * @param preferenceName the preference identifier.
-     * @param resourceUri the URI of the resource for which this provider should resolve the preference. This is used to retrieve
-     * a potentially different value for the same preference for different resources, for example `files.encoding`.
-     *
-     * @returns an object containing the value stored for the given preference and resourceUri if it exists,
-     * otherwise `undefined`.
-     */
-    resolve<T>(preferenceName: string, resourceUri?: string): PreferenceResolveResult<T>;
-    abstract getPreferences(resourceUri?: string): {
-        [p: string]: any;
-    };
-    /**
-     * Stores a new value for the given preference key in the provider.
-     * @param key the preference key (typically the name).
-     * @param value the new preference value.
-     * @param resourceUri the URI of the resource for which the preference is stored.
-     *
-     * @returns a promise that only resolves if all changes were delivered.
-     * If changes were made then implementation must either
-     * await on `this.emitPreferencesChangedEvent(...)` or
-     * `this.pendingChanges` if changes are fired indirectly.
-     */
-    abstract setPreference(key: string, value: any, resourceUri?: string): Promise<boolean>;
-    /**
-     * Resolved when the preference provider is ready to provide preferences
-     * It should be resolved by subclasses.
-     */
-    get ready(): Promise<void>;
-    /**
-     * Retrieve the domain for this provider.
-     *
-     * @returns the domain or `undefined` if this provider is suitable for all domains.
-     */
-    getDomain(): string[] | undefined;
-    /**
-     * Retrieve the configuration URI for the given resource URI.
-     * @param resourceUri the uri of the resource or `undefined`.
-     * @param sectionName the section to return the URI for, e.g. `tasks` or `launch`. Defaults to settings.
-     *
-     * @returns the corresponding resource URI or `undefined` if there is no valid URI.
-     */
-    getConfigUri(resourceUri?: string, sectionName?: string): URI | undefined;
-    /**
-     * Retrieves the first valid configuration URI contained by the given resource.
-     * @param resourceUri the uri of the container resource or `undefined`.
-     *
-     * @returns the first valid configuration URI contained by the given resource `undefined`
-     * if there is no valid configuration URI at all.
-     */
-    getContainingConfigUri?(resourceUri?: string, sectionName?: string): URI | undefined;
-    static merge(source: JSONValue | undefined, target: JSONValue): JSONValue;
-    /**
-     * Handles deep equality with the possibility of `undefined`
-     */
-    static deepEqual(a: JSONValue | undefined, b: JSONValue | undefined): boolean;
-    protected getParsedContent(jsonData: any): {
-        [key: string]: any;
-    };
-    canHandleScope(scope: PreferenceScope): boolean;
-}
+import { JSONValue } from '@phosphor/coreutils';
+import URI from '../../common/uri';
+import { Disposable, DisposableCollection, Emitter, Event } from '../../common';
+import { Deferred } from '../../common/promise-util';
+import { PreferenceScope } from './preference-scope';
+import { PreferenceLanguageOverrideService } from './preference-language-override-service';
+export interface PreferenceProviderDataChange {
+    /**
+     * The name of the changed preference.
+     */
+    readonly preferenceName: string;
+    /**
+     * The new value of the changed preference.
+     */
+    readonly newValue?: any;
+    /**
+     * The old value of the changed preference.
+     */
+    readonly oldValue?: any;
+    /**
+     * The {@link PreferenceScope} of the changed preference.
+     */
+    readonly scope: PreferenceScope;
+    /**
+     * URIs of the scopes in which this change applies.
+     */
+    readonly domain?: string[];
+}
+export declare namespace PreferenceProviderDataChange {
+    function affects(change: PreferenceProviderDataChange, resourceUri?: string): boolean;
+}
+export interface PreferenceProviderDataChanges {
+    [preferenceName: string]: PreferenceProviderDataChange;
+}
+export interface PreferenceResolveResult<T> {
+    configUri?: URI;
+    value?: T;
+}
+/**
+ * The {@link PreferenceProvider} is used to store and retrieve preference values. A {@link PreferenceProvider} does not operate in a global scope but is
+ * configured for one or more {@link PreferenceScope}s. The (default implementation for the) {@link PreferenceService} aggregates all {@link PreferenceProvider}s and
+ * serves as a common facade for manipulating preference values.
+ */
+export declare abstract class PreferenceProvider implements Disposable {
+    protected readonly preferenceOverrideService: PreferenceLanguageOverrideService;
+    protected readonly onDidPreferencesChangedEmitter: Emitter<PreferenceProviderDataChanges>;
+    readonly onDidPreferencesChanged: Event<PreferenceProviderDataChanges>;
+    protected readonly toDispose: DisposableCollection;
+    protected readonly _ready: Deferred<void>;
+    constructor();
+    dispose(): void;
+    protected deferredChanges: PreferenceProviderDataChanges | undefined;
+    /**
+     * Informs the listeners that one or more preferences of this provider are changed.
+     * The listeners are able to find what was changed from the emitted event.
+     */
+    protected emitPreferencesChangedEvent(changes: PreferenceProviderDataChanges | PreferenceProviderDataChange[]): Promise<boolean>;
+    protected mergePreferenceProviderDataChange(change: PreferenceProviderDataChange): void;
+    protected fireDidPreferencesChanged: () => Promise<boolean>;
+    /**
+     * Retrieve the stored value for the given preference and resource URI.
+     *
+     * @param preferenceName the preference identifier.
+     * @param resourceUri the uri of the resource for which the preference is stored. This is used to retrieve
+     * a potentially different value for the same preference for different resources, for example `files.encoding`.
+     *
+     * @returns the value stored for the given preference and resourceUri if it exists, otherwise `undefined`.
+     */
+    get<T>(preferenceName: string, resourceUri?: string): T | undefined;
+    /**
+     * Resolve the value for the given preference and resource URI.
+     *
+     * @param preferenceName the preference identifier.
+     * @param resourceUri the URI of the resource for which this provider should resolve the preference. This is used to retrieve
+     * a potentially different value for the same preference for different resources, for example `files.encoding`.
+     *
+     * @returns an object containing the value stored for the given preference and resourceUri if it exists,
+     * otherwise `undefined`.
+     */
+    resolve<T>(preferenceName: string, resourceUri?: string): PreferenceResolveResult<T>;
+    abstract getPreferences(resourceUri?: string): {
+        [p: string]: any;
+    };
+    /**
+     * Stores a new value for the given preference key in the provider.
+     * @param key the preference key (typically the name).
+     * @param value the new preference value.
+     * @param resourceUri the URI of the resource for which the preference is stored.
+     *
+     * @returns a promise that only resolves if all changes were delivered.
+     * If changes were made then implementation must either
+     * await on `this.emitPreferencesChangedEvent(...)` or
+     * `this.pendingChanges` if changes are fired indirectly.
+     */
+    abstract setPreference(key: string, value: any, resourceUri?: string): Promise<boolean>;
+    /**
+     * Resolved when the preference provider is ready to provide preferences
+     * It should be resolved by subclasses.
+     */
+    get ready(): Promise<void>;
+    /**
+     * Retrieve the domain for this provider.
+     *
+     * @returns the domain or `undefined` if this provider is suitable for all domains.
+     */
+    getDomain(): string[] | undefined;
+    /**
+     * Retrieve the configuration URI for the given resource URI.
+     * @param resourceUri the uri of the resource or `undefined`.
+     * @param sectionName the section to return the URI for, e.g. `tasks` or `launch`. Defaults to settings.
+     *
+     * @returns the corresponding resource URI or `undefined` if there is no valid URI.
+     */
+    getConfigUri(resourceUri?: string, sectionName?: string): URI | undefined;
+    /**
+     * Retrieves the first valid configuration URI contained by the given resource.
+     * @param resourceUri the uri of the container resource or `undefined`.
+     *
+     * @returns the first valid configuration URI contained by the given resource `undefined`
+     * if there is no valid configuration URI at all.
+     */
+    getContainingConfigUri?(resourceUri?: string, sectionName?: string): URI | undefined;
+    static merge(source: JSONValue | undefined, target: JSONValue): JSONValue;
+    /**
+     * Handles deep equality with the possibility of `undefined`
+     */
+    static deepEqual(a: JSONValue | undefined, b: JSONValue | undefined): boolean;
+    protected getParsedContent(jsonData: any): {
+        [key: string]: any;
+    };
+    canHandleScope(scope: PreferenceScope): boolean;
+}
 //# sourceMappingURL=preference-provider.d.ts.map