@theia/core 1.67.0-next.56 → 1.67.0-next.86

package/lib/common/preferences/preference-scope.js

@@ -0,0 +1,63 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2019 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.PreferenceScope = exports.ValidPreferenceScopes = void 0;
+/**
+ * An array of preference scopes that are valid in a given context, sorted from more general to more specific
+ */
+exports.ValidPreferenceScopes = Symbol('ValidPreferenceScopes');
+var PreferenceScope;
+(function (PreferenceScope) {
+    PreferenceScope[PreferenceScope["Default"] = 0] = "Default";
+    PreferenceScope[PreferenceScope["User"] = 1] = "User";
+    PreferenceScope[PreferenceScope["Workspace"] = 2] = "Workspace";
+    PreferenceScope[PreferenceScope["Folder"] = 3] = "Folder";
+})(PreferenceScope || (exports.PreferenceScope = PreferenceScope = {}));
+(function (PreferenceScope) {
+    function is(scope) {
+        return typeof scope === 'number' && getScopes().includes(scope);
+    }
+    PreferenceScope.is = is;
+    /**
+     * @returns preference scopes from broadest to narrowest: Default -> Folder.
+     */
+    function getScopes() {
+        return Object.values(PreferenceScope).filter(nameOrIndex => !isNaN(Number(nameOrIndex)));
+    }
+    PreferenceScope.getScopes = getScopes;
+    /**
+     * @returns preference scopes from narrowest to broadest. Folder -> Default.
+     */
+    function getReversedScopes() {
+        return getScopes().reverse();
+    }
+    PreferenceScope.getReversedScopes = getReversedScopes;
+    function getScopeNames(scope) {
+        const names = [];
+        const scopes = getScopes();
+        if (scope) {
+            for (const scopeIndex of scopes) {
+                if (scopeIndex <= scope) {
+                    names.push(PreferenceScope[scopeIndex]);
+                }
+            }
+        }
+        return names;
+    }
+    PreferenceScope.getScopeNames = getScopeNames;
+})(PreferenceScope || (exports.PreferenceScope = PreferenceScope = {}));
+//# sourceMappingURL=preference-scope.js.map

package/lib/common/preferences/preference-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preference-scope.js","sourceRoot":"","sources":["../../../src/common/preferences/preference-scope.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,0CAA0C;AAC1C,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;;AAEhF;;GAEG;AACU,QAAA,qBAAqB,GAAG,MAAM,CAAC,uBAAuB,CAAC,CAAC;AAErE,IAAY,eAKX;AALD,WAAY,eAAe;IACvB,2DAAO,CAAA;IACP,qDAAI,CAAA;IACJ,+DAAS,CAAA;IACT,yDAAM,CAAA;AACV,CAAC,EALW,eAAe,+BAAf,eAAe,QAK1B;AAED,WAAiB,eAAe;IAC5B,SAAgB,EAAE,CAAC,KAAc;QAC7B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpE,CAAC;IAFe,kBAAE,KAEjB,CAAA;IAED;;OAEG;IACH,SAAgB,SAAS;QACrB,OAAO,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAsB,CAAC;IAClH,CAAC;IAFe,yBAAS,YAExB,CAAA;IAED;;OAEG;IACH,SAAgB,iBAAiB;QAC7B,OAAO,SAAS,EAAE,CAAC,OAAO,EAAE,CAAC;IACjC,CAAC;IAFe,iCAAiB,oBAEhC,CAAA;IAED,SAAgB,aAAa,CAAC,KAAuB;QACjD,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,IAAI,KAAK,EAAE,CAAC;YACR,KAAK,MAAM,UAAU,IAAI,MAAM,EAAE,CAAC;gBAC9B,IAAI,UAAU,IAAI,KAAK,EAAE,CAAC;oBACtB,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC;gBAC5C,CAAC;YACL,CAAC;QACL,CAAC;QACD,OAAO,KAAK,CAAC;IACjB,CAAC;IAXe,6BAAa,gBAW5B,CAAA;AACL,CAAC,EA/BgB,eAAe,+BAAf,eAAe,QA+B/B"}

package/lib/common/preferences/preference-scope.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=preference-scope.spec.d.ts.map

package/lib/common/preferences/preference-scope.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preference-scope.spec.d.ts","sourceRoot":"","sources":["../../../src/common/preferences/preference-scope.spec.ts"],"names":[],"mappings":""}

package/lib/common/preferences/preference-scope.spec.js

@@ -0,0 +1,45 @@
+"use strict";
+// *****************************************************************************
+// 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
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = require("chai");
+const preference_scope_1 = require("./preference-scope");
+describe('PreferenceScope', () => {
+    it('getScopes() should return numbers from broadest to narrowest', () => {
+        (0, chai_1.expect)(preference_scope_1.PreferenceScope.getScopes()).deep.equal([0, 1, 2, 3]);
+    });
+    it('getReversedScopes() should return numbers from narrowest to broadest', () => {
+        (0, chai_1.expect)(preference_scope_1.PreferenceScope.getReversedScopes()).deep.equal([3, 2, 1, 0]);
+    });
+    it('getScopeNames() should return the names of scopes broader than the current one', () => {
+        (0, chai_1.expect)(preference_scope_1.PreferenceScope.getScopeNames(preference_scope_1.PreferenceScope.Workspace)).deep.equal(['Default', 'User', 'Workspace']);
+    });
+    it('is() returns whether a value is a preference scope', () => {
+        (0, chai_1.expect)(preference_scope_1.PreferenceScope.is(preference_scope_1.PreferenceScope.Default)).to.be.true;
+        (0, chai_1.expect)(preference_scope_1.PreferenceScope.is(preference_scope_1.PreferenceScope.User)).to.be.true;
+        (0, chai_1.expect)(preference_scope_1.PreferenceScope.is(preference_scope_1.PreferenceScope.Workspace)).to.be.true;
+        (0, chai_1.expect)(preference_scope_1.PreferenceScope.is(preference_scope_1.PreferenceScope.Folder)).to.be.true;
+        (0, chai_1.expect)(preference_scope_1.PreferenceScope.is(0)).to.be.true;
+        (0, chai_1.expect)(preference_scope_1.PreferenceScope.is(1)).to.be.true;
+        (0, chai_1.expect)(preference_scope_1.PreferenceScope.is(2)).to.be.true;
+        (0, chai_1.expect)(preference_scope_1.PreferenceScope.is(3)).to.be.true;
+        (0, chai_1.expect)(preference_scope_1.PreferenceScope.is(4)).to.be.false;
+        (0, chai_1.expect)(preference_scope_1.PreferenceScope.is(-1)).to.be.false;
+        (0, chai_1.expect)(preference_scope_1.PreferenceScope.is({})).to.be.false;
+        (0, chai_1.expect)(preference_scope_1.PreferenceScope.is('Default')).to.be.false;
+    });
+});
+//# sourceMappingURL=preference-scope.spec.js.map

package/lib/common/preferences/preference-scope.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preference-scope.spec.js","sourceRoot":"","sources":["../../../src/common/preferences/preference-scope.spec.ts"],"names":[],"mappings":"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"}

package/lib/common/preferences/preference-service.d.ts

@@ -0,0 +1,278 @@
+import { JSONValue } from '@lumino/coreutils';
+import { Disposable, DisposableCollection, Emitter, Event } from '../../common';
+import { Deferred } from '../../common/promise-util';
+import URI from '../../common/uri';
+import { OverridePreferenceName, PreferenceLanguageOverrideService } from './preference-language-override-service';
+import { PreferenceProvider, PreferenceProviderDataChange, PreferenceProviderDataChanges, PreferenceResolveResult } from './preference-provider';
+import { PreferenceSchemaService } from './preference-schema';
+import { PreferenceScope } from './preference-scope';
+import { PreferenceConfigurations } from './preference-configurations';
+/**
+ * Representation of a preference change. A preference value can be set to `undefined` for a specific scope.
+ * This means that the value from a more general scope will be used.
+ */
+export interface PreferenceChange extends PreferenceProviderDataChange {
+    /**
+     * Tests wether the given resource is affected by the preference change.
+     * @param resourceUri the uri of the resource to test.
+     */
+    affects(resourceUri?: string): boolean;
+}
+export declare class PreferenceChangeImpl implements PreferenceChange {
+    protected readonly change: PreferenceProviderDataChange;
+    constructor(change: PreferenceProviderDataChange);
+    get preferenceName(): string;
+    get newValue(): JSONValue | undefined;
+    get oldValue(): JSONValue | undefined;
+    get scope(): PreferenceScope;
+    get domain(): string[] | undefined;
+    affects(resourceUri?: string): boolean;
+}
+/**
+ * A key-value storage for {@link PreferenceChange}s. Used to aggregate multiple simultaneous preference changes.
+ */
+export interface PreferenceChanges {
+    [preferenceName: string]: PreferenceChange;
+}
+export declare const PreferenceService: unique symbol;
+/**
+ * Service to manage preferences including, among others, getting and setting preference values as well
+ * as listening to preference changes.
+ *
+ * Depending on your use case you might also want to look at {@link createPreferenceProxy} with which
+ * you can easily create a typesafe schema-based interface for your preferences. Internally the proxy
+ * uses the PreferenceService so both approaches are compatible.
+ */
+export interface PreferenceService extends Disposable {
+    /**
+     * Promise indicating whether the service successfully initialized.
+     */
+    readonly ready: Promise<void>;
+    /**
+     * Indicates whether the service has successfully initialized. Will be `true` when {@link PreferenceService.ready the `ready` Promise} resolves.
+     */
+    readonly isReady: boolean;
+    /**
+     * Retrieve the stored value for the given preference.
+     *
+     * @param preferenceName the preference identifier.
+     *
+     * @returns the value stored for the given preference when it exists, `undefined` otherwise.
+     */
+    get<T>(preferenceName: string): T | undefined;
+    /**
+     * Retrieve the stored value for the given preference.
+     *
+     * @param preferenceName the preference identifier.
+     * @param defaultValue the value to return when no value for the given preference is stored.
+     *
+     * @returns the value stored for the given preference when it exists, otherwise the given default value.
+     */
+    get<T>(preferenceName: string, defaultValue: T): T;
+    /**
+     * Retrieve the stored value for the given preference and resourceUri.
+     *
+     * @param preferenceName the preference identifier.
+     * @param defaultValue the value to return when no value for the given preference is stored.
+     * @param resourceUri the uri of the resource for which the preference is stored. This 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 when it exists, otherwise the given
+     * default value.
+     */
+    get<T>(preferenceName: string, defaultValue: T, resourceUri?: string): T;
+    /**
+     * Retrieve the stored value for the given preference and resourceUri.
+     *
+     * @param preferenceName the preference identifier.
+     * @param defaultValue the value to return when no value for the given preference is stored.
+     * @param resourceUri the uri of the resource for which the preference is stored. This 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 when it exists, otherwise the given
+     * default value.
+     */
+    get<T>(preferenceName: string, defaultValue?: T, resourceUri?: string): T | undefined;
+    /**
+     * Sets the given preference to the given value.
+     *
+     * @param preferenceName the preference identifier.
+     * @param value the new value of the preference.
+     * @param scope the scope for which the value shall be set, i.e. user, workspace etc.
+     * When the folder scope is specified a resourceUri must be provided.
+     * @param resourceUri the uri of the resource for which the preference is stored. This used to store
+     * a potentially different value for the same preference for different resources, for example `files.encoding`.
+     *
+     * @returns a promise which resolves to `undefined` when setting the preference was successful. Otherwise it rejects
+     * with an error.
+     */
+    set(preferenceName: string, value: any, scope?: PreferenceScope, resourceUri?: string): Promise<void>;
+    /**
+     * Determines and applies the changes necessary to apply `value` to either the `resourceUri` supplied or the active session.
+     * If there is no setting for the `preferenceName`, the change will be applied in user scope.
+     * If there is a setting conflicting with the specified `value`, the change will be applied in the most specific scope with a conflicting value.
+     *
+     * @param preferenceName the identifier of the preference to modify.
+     * @param value the value to which to set the preference. `undefined` will reset the preference to its default value.
+     * @param resourceUri the uri of the resource to which the change is to apply. If none is provided, folder scope will be ignored.
+     */
+    updateValue(preferenceName: string, value: any, resourceUri?: string): Promise<void>;
+    /**
+     * Registers a callback which will be called whenever a preference is changed.
+     */
+    onPreferenceChanged: Event<PreferenceChange>;
+    /**
+     * Registers a callback which will be called whenever one or more preferences are changed.
+     */
+    onPreferencesChanged: Event<PreferenceChanges>;
+    /**
+     * Retrieve the stored value for the given preference and resourceUri in all available scopes.
+     *
+     * @param preferenceName the preference identifier.
+     * @param resourceUri the uri of the resource for which the preference is stored.
+     * @param forceLanguageOverride if `true` and `preferenceName` is a language override, only values for the specified override will be returned.
+     * Otherwise, values for the override will be returned where defined, and values from the base preference will be returned otherwise.
+     *
+     * @return an object containing the value of the given preference for all scopes.
+     */
+    inspect<T extends JSONValue>(preferenceName: string, resourceUri?: string, forceLanguageOverride?: boolean): PreferenceInspection<T> | undefined;
+    /**
+     * For behavior, see {@link PreferenceService.inspect}.
+     *
+     * @returns the value in the scope specified.
+     */
+    inspectInScope<T extends JSONValue>(preferenceName: string, scope: PreferenceScope, resourceUri?: string, forceLanguageOverride?: boolean): T | undefined;
+    /**
+     * Returns a new preference identifier based on the given OverridePreferenceName.
+     *
+     * @param options the override specification.
+     *
+     * @returns the calculated string based on the given OverridePreferenceName.
+     */
+    overridePreferenceName(options: OverridePreferenceName): string;
+    /**
+     * Tries to split the given preference identifier into the original OverridePreferenceName attributes
+     * with which this identifier was created. Returns `undefined` if this is not possible, for example
+     * when the given preference identifier was not generated by `overridePreferenceName`.
+     *
+     * This method is checked when resolving preferences. Therefore together with "overridePreferenceName"
+     * this can be used to handle specialized preferences, e.g. "[markdown].editor.autoIndent" and "editor.autoIndent".
+     *
+     * @param preferenceName the preferenceName which might have been created via {@link PreferenceService.overridePreferenceName}.
+     *
+     * @returns the OverridePreferenceName which was used to create the given `preferenceName` if this was the case,
+     * `undefined` otherwise.
+     */
+    overriddenPreferenceName(preferenceName: string): OverridePreferenceName | undefined;
+    /**
+     * Retrieve the stored value for the given preference and resourceUri.
+     *
+     * @param preferenceName the preference identifier.
+     * @param defaultValue the value to return when no value for the given preference is stored.
+     * @param resourceUri the uri of the resource for which the preference is stored. This 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 when it exists,
+     * otherwise the given default value. If determinable the object will also contain the uri of the configuration
+     * resource in which the preference was stored.
+     */
+    resolve<T>(preferenceName: string, defaultValue?: T, resourceUri?: string): PreferenceResolveResult<T>;
+    /**
+     * Returns the uri of the configuration resource for the given scope and optional resource uri.
+     *
+     * @param scope the PreferenceScope to query for.
+     * @param resourceUri the optional uri of the resource-specific preference handling
+     * @param sectionName the optional preference section to query for.
+     *
+     * @returns the uri of the configuration resource for the given scope and optional resource uri it it exists,
+     * `undefined` otherwise.
+     */
+    getConfigUri(scope: PreferenceScope, resourceUri?: string, sectionName?: string): URI | undefined;
+}
+/**
+ * Return type of the {@link PreferenceService.inspect} call.
+ */
+export interface PreferenceInspection<T = JSONValue> {
+    /**
+     * The preference identifier.
+     */
+    preferenceName: string;
+    /**
+     * Value in default scope.
+     */
+    defaultValue: T | undefined;
+    /**
+     * Value in user scope.
+     */
+    globalValue: T | undefined;
+    /**
+     * Value in workspace scope.
+     */
+    workspaceValue: T | undefined;
+    /**
+     * Value in folder scope.
+     */
+    workspaceFolderValue: T | undefined;
+    /**
+     * The value that is active, i.e. the value set in the lowest scope available.
+     */
+    value: T | undefined;
+}
+export type PreferenceInspectionScope = keyof Omit<PreferenceInspection<unknown>, 'preferenceName'>;
+/**
+ * We cannot load providers directly in the case if they depend on `PreferenceService` somehow.
+ * It allows to load them lazily after DI is configured.
+ */
+export declare const PreferenceProviderProvider: unique symbol;
+export type PreferenceProviderProvider = (scope: PreferenceScope, uri?: URI) => PreferenceProvider | undefined;
+export declare class PreferenceServiceImpl implements PreferenceService {
+    protected readonly onPreferenceChangedEmitter: Emitter<PreferenceChange>;
+    readonly onPreferenceChanged: Event<PreferenceChange>;
+    protected readonly onPreferencesChangedEmitter: Emitter<PreferenceChanges>;
+    readonly onPreferencesChanged: Event<PreferenceChanges>;
+    protected readonly toDispose: DisposableCollection;
+    protected readonly schemaService: PreferenceSchemaService;
+    protected readonly providerProvider: PreferenceProviderProvider;
+    protected readonly configurations: PreferenceConfigurations;
+    protected readonly preferenceOverrideService: PreferenceLanguageOverrideService;
+    protected readonly preferenceProviders: Map<PreferenceScope, PreferenceProvider>;
+    protected initializeProviders(): Promise<void>;
+    protected init(): void;
+    dispose(): void;
+    protected readonly _ready: Deferred<void>;
+    get ready(): Promise<void>;
+    protected _isReady: boolean;
+    get isReady(): boolean;
+    protected reconcilePreferences(changes: PreferenceProviderDataChanges): void;
+    protected getAffectedPreferenceNames(change: PreferenceProviderDataChange, accept: (affectedPreferenceName: string) => void): void;
+    protected getProvider(scope: PreferenceScope): PreferenceProvider | undefined;
+    has(preferenceName: string, resourceUri?: string): boolean;
+    get<T>(preferenceName: string): T | undefined;
+    get<T>(preferenceName: string, defaultValue: T): T;
+    get<T>(preferenceName: string, defaultValue: T, resourceUri: string): T;
+    get<T>(preferenceName: string, defaultValue?: T, resourceUri?: string): T | undefined;
+    resolve<T>(preferenceName: string, defaultValue?: T, resourceUri?: string): PreferenceResolveResult<T>;
+    set(preferenceName: string, value: any, scope: PreferenceScope | undefined, resourceUri?: string): Promise<void>;
+    getBoolean(preferenceName: string): boolean | undefined;
+    getBoolean(preferenceName: string, defaultValue: boolean): boolean;
+    getBoolean(preferenceName: string, defaultValue: boolean, resourceUri: string): boolean;
+    getString(preferenceName: string): string | undefined;
+    getString(preferenceName: string, defaultValue: string): string;
+    getString(preferenceName: string, defaultValue: string, resourceUri: string): string;
+    getNumber(preferenceName: string): number | undefined;
+    getNumber(preferenceName: string, defaultValue: number): number;
+    getNumber(preferenceName: string, defaultValue: number, resourceUri: string): number;
+    inspect<T extends JSONValue>(preferenceName: string, resourceUri?: string, forceLanguageOverride?: boolean): PreferenceInspection<T> | undefined;
+    inspectInScope<T extends JSONValue>(preferenceName: string, scope: PreferenceScope, resourceUri?: string, forceLanguageOverride?: boolean): T | undefined;
+    protected getScopedValueFromInspection<T>(inspection: PreferenceInspection<T>, scope: PreferenceScope): T | undefined;
+    updateValue(preferenceName: string, value: any, resourceUri?: string): Promise<void>;
+    protected getScopesToChange(inspection: PreferenceInspection<any>, intendedValue: any): PreferenceScope[];
+    overridePreferenceName(options: OverridePreferenceName): string;
+    overriddenPreferenceName(preferenceName: string): OverridePreferenceName | undefined;
+    protected doHas(preferenceName: string, resourceUri?: string): boolean;
+    protected doInspectInScope<T>(preferenceName: string, scope: PreferenceScope, resourceUri?: string): T | undefined;
+    protected doGet<T>(preferenceName: string, defaultValue?: T, resourceUri?: string): T | undefined;
+    protected doResolve<T>(preferenceName: string, defaultValue?: T, resourceUri?: string): PreferenceResolveResult<T>;
+    getConfigUri(scope: PreferenceScope, resourceUri?: string, sectionName?: string): URI | undefined;
+}
+//# sourceMappingURL=preference-service.d.ts.map

package/lib/common/preferences/preference-service.d.ts.map

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