@theia/core 1.64.0-next.28 → 1.64.0

package/lib/common/observable/observable-utils.d.ts

@@ -0,0 +1,26 @@
+import { CancellationToken } from '../cancellation';
+import { Disposable } from '../disposable';
+import { Observable } from './observable-base';
+import { DerivedObservable } from './derived-observable';
+import { Autorun } from './autorun';
+export declare namespace ObservableUtils {
+    /**
+     * Creates an {@link Autorun.create autorun} that passes a collector for disposable objects to the {@link run} function.
+     * The collected disposables are disposed before the next run or when the autorun is disposed.
+     */
+    function autorunWithDisposables<TChangeSummary = void>(run: (args: Autorun.Args<TChangeSummary> & {
+        readonly toDispose: {
+            push(disposable: Disposable): void;
+        };
+    }) => void, options?: Autorun.Options<TChangeSummary>): Disposable;
+    function derivedObservableWithCache<T, TChangeSummary = void>(compute: (args: DerivedObservable.Args<TChangeSummary> & {
+        readonly lastValue: T | undefined;
+    }) => T, options?: DerivedObservable.Options<T, TChangeSummary>): Observable<T, void>;
+    /**
+     * Resolves the promise when the observable's state matches the predicate.
+     */
+    function waitForState<T>(observable: Observable<T | undefined>): Promise<T>;
+    function waitForState<T, TState extends T>(observable: Observable<T>, predicate: (state: T) => state is TState, isError?: (state: T) => boolean | unknown | undefined, cancellationToken?: CancellationToken): Promise<TState>;
+    function waitForState<T>(observable: Observable<T>, predicate: (state: T) => boolean, isError?: (state: T) => boolean | unknown | undefined, cancellationToken?: CancellationToken): Promise<T>;
+}
+//# sourceMappingURL=observable-utils.d.ts.map

package/lib/common/observable/observable-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observable-utils.d.ts","sourceRoot":"","sources":["../../../src/common/observable/observable-utils.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAqB,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,UAAU,EAAwB,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,yBAAiB,eAAe,CAAC;IAE7B;;;OAGG;IACH,SAAgB,sBAAsB,CAAC,cAAc,GAAG,IAAI,EACxD,GAAG,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG;QAAE,QAAQ,CAAC,SAAS,EAAE;YAAE,IAAI,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAA;SAAE,CAAA;KAAE,KAAK,IAAI,EAClH,OAAO,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,GAC1C,UAAU,CAeZ;IAED,SAAgB,0BAA0B,CAAC,CAAC,EAAE,cAAc,GAAG,IAAI,EAC/D,OAAO,EAAE,CAAC,IAAI,EAAE,iBAAiB,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG;QAAE,QAAQ,CAAC,SAAS,EAAE,CAAC,GAAG,SAAS,CAAA;KAAE,KAAK,CAAC,EACpG,OAAO,CAAC,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC,EAAE,cAAc,CAAC,GACvD,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,CASrB;IAED;;OAEG;IACH,SAAgB,YAAY,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACnF,SAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,SAAS,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,KAAK,IAAI,MAAM,EACjH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,GAAG,OAAO,GAAG,SAAS,EAAE,iBAAiB,CAAC,EAAE,iBAAiB,GAC7F,OAAO,CAAC,MAAM,CAAC,CAAC;IACnB,SAAgB,YAAY,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,EACvF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,GAAG,OAAO,GAAG,SAAS,EAAE,iBAAiB,CAAC,EAAE,iBAAiB,GAC7F,OAAO,CAAC,CAAC,CAAC,CAAC;CAyCjB"}

package/lib/common/observable/observable-utils.js

@@ -0,0 +1,98 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2025 1C-Soft LLC 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
+// *****************************************************************************
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+// copied and modified from https://github.com/microsoft/vscode/blob/1.96.3/src/vs/base/common/observableInternal/utils.ts,
+// https://github.com/microsoft/vscode/blob/1.96.3/src/vs/base/common/observableInternal/utilsCancellation.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObservableUtils = void 0;
+const cancellation_1 = require("../cancellation");
+const disposable_1 = require("../disposable");
+const derived_observable_1 = require("./derived-observable");
+const autorun_1 = require("./autorun");
+var ObservableUtils;
+(function (ObservableUtils) {
+    /**
+     * Creates an {@link Autorun.create autorun} that passes a collector for disposable objects to the {@link run} function.
+     * The collected disposables are disposed before the next run or when the autorun is disposed.
+     */
+    function autorunWithDisposables(run, options) {
+        let toDispose = undefined;
+        return new class extends autorun_1.Autorun {
+            dispose() {
+                super.dispose();
+                toDispose === null || toDispose === void 0 ? void 0 : toDispose.dispose();
+            }
+        }(({ autorun, isFirstRun, changeSummary }) => {
+            toDispose === null || toDispose === void 0 ? void 0 : toDispose.dispose();
+            toDispose = new disposable_1.DisposableCollection();
+            run({ toDispose, autorun, isFirstRun, changeSummary });
+        }, options);
+    }
+    ObservableUtils.autorunWithDisposables = autorunWithDisposables;
+    function derivedObservableWithCache(compute, options) {
+        let value = undefined;
+        return new derived_observable_1.DerivedObservable(({ changeSummary }) => {
+            value = compute({ lastValue: value, changeSummary });
+            return value;
+        }, options);
+    }
+    ObservableUtils.derivedObservableWithCache = derivedObservableWithCache;
+    function waitForState(observable, predicate, isError, cancellationToken) {
+        if (!predicate) {
+            predicate = state => !!state;
+        }
+        return new Promise((resolve, reject) => {
+            const stateObservable = derived_observable_1.DerivedObservable.create(() => {
+                const state = observable.get();
+                return {
+                    isFinished: predicate(state),
+                    error: isError ? isError(state) : false,
+                    state
+                };
+            });
+            const autorun_ = autorun_1.Autorun.create(({ autorun }) => {
+                const { isFinished, error, state } = stateObservable.get();
+                if (isFinished || error) {
+                    autorun.dispose();
+                    if (error) {
+                        reject(error === true ? state : error);
+                    }
+                    else {
+                        resolve(state);
+                    }
+                }
+            });
+            if (cancellationToken) {
+                const subscription = cancellationToken.onCancellationRequested(() => {
+                    autorun_.dispose();
+                    subscription.dispose();
+                    reject(new cancellation_1.CancellationError());
+                });
+                if (cancellationToken.isCancellationRequested) {
+                    autorun_.dispose();
+                    subscription.dispose();
+                    reject(new cancellation_1.CancellationError());
+                }
+            }
+        });
+    }
+    ObservableUtils.waitForState = waitForState;
+})(ObservableUtils || (exports.ObservableUtils = ObservableUtils = {}));
+//# sourceMappingURL=observable-utils.js.map

package/lib/common/observable/observable-utils.js.map

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

package/lib/common/observable/observable.spec.d.ts

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

package/lib/common/observable/observable.spec.d.ts.map

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

package/lib/common/observable/observable.spec.js

@@ -0,0 +1,301 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2025 1C-Soft LLC 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
+// *****************************************************************************
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+// copied and modified from https://github.com/microsoft/vscode/blob/1.96.3/src/vs/base/test/common/observable.test.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = require("chai");
+const disposable_1 = require("../disposable");
+const observable_base_1 = require("./observable-base");
+const settable_observable_1 = require("./settable-observable");
+const derived_observable_1 = require("./derived-observable");
+const observable_signal_1 = require("./observable-signal");
+const autorun_1 = require("./autorun");
+describe('Observables', () => {
+    let disposables;
+    beforeEach(() => disposables = new disposable_1.DisposableCollection());
+    afterEach(() => disposables.dispose());
+    // Read these tests to understand how to use observables.
+    describe('Tutorial', () => {
+        it('settable observable & autorun', () => {
+            const log = new Log();
+            // This creates an observable with an initial value that can later be changed with the `set` method.
+            const myObservable = settable_observable_1.SettableObservable.create(0);
+            // This creates an autorun. The autorun has to be disposed!
+            disposables.push(autorun_1.Autorun.create(() => {
+                // Observables are automatically added to the tracked dependencies of the autorun as they are accessed with `get`.
+                log.log(`myAutorun.run(myObservable: ${myObservable.get()})`);
+                // Now that all dependencies are tracked, the autorun is re-run whenever any of the dependencies change.
+            }));
+            // The autorun runs immediately.
+            (0, chai_1.expect)(log.getAndClearEntries()).to.be.deep.equal(['myAutorun.run(myObservable: 0)']);
+            myObservable.set(1);
+            // The autorun runs again, because its dependency changed.
+            (0, chai_1.expect)(log.getAndClearEntries()).to.be.deep.equal(['myAutorun.run(myObservable: 1)']);
+            myObservable.set(1);
+            // The autorun didn't run, because the observable was set to the same value (no change).
+            (0, chai_1.expect)(log.getAndClearEntries()).to.be.deep.equal([]);
+            // An update scope can be used to batch autorun runs.
+            observable_base_1.Observable.update(() => {
+                myObservable.set(2);
+                (0, chai_1.expect)(log.getAndClearEntries()).to.be.deep.equal([]); // The autorun didn't run, even though its dependency changed!
+                myObservable.set(3);
+                (0, chai_1.expect)(log.getAndClearEntries()).to.be.deep.equal([]);
+            });
+            // The autorun re-runs only at the end of the update scope.
+            // Note that the autorun didn't see the intermediate value `2`!
+            (0, chai_1.expect)(log.getAndClearEntries()).to.be.deep.equal(['myAutorun.run(myObservable: 3)']);
+        });
+        it('derived observable & autorun', () => {
+            const log = new Log();
+            const observable1 = settable_observable_1.SettableObservable.create(0);
+            const observable2 = settable_observable_1.SettableObservable.create(0);
+            // This creates an observable that is derived from other observables.
+            const myDerived = derived_observable_1.DerivedObservable.create(() => {
+                // Dependencies are automatically tracked as they are accessed with `get`.
+                const value1 = observable1.get();
+                const value2 = observable2.get();
+                const sum = value1 + value2;
+                log.log(`myDerived.recompute: ${value1} + ${value2} = ${sum}`);
+                return sum;
+            });
+            // This creates an autorun that reacts to changes of the derived observable.
+            disposables.push(autorun_1.Autorun.create(() => {
+                log.log(`myAutorun(myDerived: ${myDerived.get()})`);
+            }));
+            // The autorun runs immediately...
+            (0, chai_1.expect)(log.getAndClearEntries()).to.be.deep.equal([
+                'myDerived.recompute: 0 + 0 = 0',
+                'myAutorun(myDerived: 0)',
+            ]);
+            observable1.set(1);
+            // ...and on changes...
+            (0, chai_1.expect)(log.getAndClearEntries()).to.be.deep.equal([
+                'myDerived.recompute: 1 + 0 = 1',
+                'myAutorun(myDerived: 1)',
+            ]);
+            observable2.set(1);
+            // ...of the derived observable.
+            (0, chai_1.expect)(log.getAndClearEntries()).to.be.deep.equal([
+                'myDerived.recompute: 1 + 1 = 2',
+                'myAutorun(myDerived: 2)',
+            ]);
+            // Multiple observables can be updated in a batch.
+            observable_base_1.Observable.update(() => {
+                observable1.set(5);
+                (0, chai_1.expect)(log.getAndClearEntries()).to.be.deep.equal([]);
+                observable2.set(5);
+                (0, chai_1.expect)(log.getAndClearEntries()).to.be.deep.equal([]);
+            });
+            // The autorun re-runs only at the end of the update scope.
+            // Derived observables are only recomputed on demand.
+            (0, chai_1.expect)(log.getAndClearEntries()).to.be.deep.equal([
+                'myDerived.recompute: 5 + 5 = 10',
+                'myAutorun(myDerived: 10)',
+            ]);
+            observable_base_1.Observable.update(() => {
+                observable1.set(6);
+                (0, chai_1.expect)(log.getAndClearEntries()).to.be.deep.equal([]);
+                observable2.set(4);
+                (0, chai_1.expect)(log.getAndClearEntries()).to.be.deep.equal([]);
+            });
+            // The autorun didn't run, because its dependency changed from 10 to 10 (no change).
+            (0, chai_1.expect)(log.getAndClearEntries()).to.be.deep.equal(['myDerived.recompute: 6 + 4 = 10']);
+        });
+        it('derived observable: get within update scope', () => {
+            const log = new Log();
+            const observable1 = settable_observable_1.SettableObservable.create(0);
+            const observable2 = settable_observable_1.SettableObservable.create(0);
+            const myDerived = derived_observable_1.DerivedObservable.create(() => {
+                const value1 = observable1.get();
+                const value2 = observable2.get();
+                const sum = value1 + value2;
+                log.log(`myDerived.recompute: ${value1} + ${value2} = ${sum}`);
+                return sum;
+            });
+            disposables.push(autorun_1.Autorun.create(() => {
+                log.log(`myAutorun(myDerived: ${myDerived.get()})`);
+            }));
+            // The autorun runs immediately.
+            (0, chai_1.expect)(log.getAndClearEntries()).to.be.deep.equal([
+                'myDerived.recompute: 0 + 0 = 0',
+                'myAutorun(myDerived: 0)',
+            ]);
+            observable_base_1.Observable.update(() => {
+                observable1.set(-10);
+                (0, chai_1.expect)(log.getAndClearEntries()).to.be.deep.equal([]);
+                myDerived.get(); // This forces a (sync) recomputation of the current value!
+                (0, chai_1.expect)(log.getAndClearEntries()).to.be.deep.equal(['myDerived.recompute: -10 + 0 = -10']);
+                // This means that, even within an update scope, all observable values you get are up-to-date.
+                // It might just cause additional (potentially unneeded) recomputations.
+                observable2.set(10);
+                (0, chai_1.expect)(log.getAndClearEntries()).to.be.deep.equal([]);
+            });
+            // The autorun runs again, because its dependency changed from 0 to -10 and then back to 0.
+            (0, chai_1.expect)(log.getAndClearEntries()).to.be.deep.equal([
+                'myDerived.recompute: -10 + 10 = 0',
+                'myAutorun(myDerived: 0)',
+            ]);
+        });
+        it('derived observable: get without observers', () => {
+            const log = new Log();
+            const observable1 = settable_observable_1.SettableObservable.create(0);
+            const computed1 = derived_observable_1.DerivedObservable.create(() => {
+                const value1 = observable1.get();
+                const result = value1 % 3;
+                log.log(`recompute1: ${value1} % 3 = ${result}`);
+                return result;
+            });
+            const computed2 = derived_observable_1.DerivedObservable.create(() => {
+                const value1 = computed1.get();
+                const result = value1 * 2;
+                log.log(`recompute2: ${value1} * 2 = ${result}`);
+                return result;
+            });
+            const computed3 = derived_observable_1.DerivedObservable.create(() => {
+                const value1 = computed1.get();
+                const result = value1 * 3;
+                log.log(`recompute3: ${value1} * 3 = ${result}`);
+                return result;
+            });
+            const computedSum = derived_observable_1.DerivedObservable.create(() => {
+                const value1 = computed2.get();
+                const value2 = computed3.get();
+                const result = value1 + value2;
+                log.log(`recompute4: ${value1} + ${value2} = ${result}`);
+                return result;
+            });
+            (0, chai_1.expect)(log.getAndClearEntries()).to.be.deep.equal([]);
+            observable1.set(1);
+            // Derived observables are only recomputed on demand.
+            (0, chai_1.expect)(log.getAndClearEntries()).to.be.deep.equal([]);
+            log.log(`value: ${computedSum.get()}`);
+            (0, chai_1.expect)(log.getAndClearEntries()).to.be.deep.equal([
+                'recompute1: 1 % 3 = 1',
+                'recompute2: 1 * 2 = 2',
+                'recompute3: 1 * 3 = 3',
+                'recompute4: 2 + 3 = 5',
+                'value: 5',
+            ]);
+            log.log(`value: ${computedSum.get()}`);
+            // Because there are no observers, the derived observable values are not cached (!) but recomputed from scratch.
+            (0, chai_1.expect)(log.getAndClearEntries()).to.be.deep.equal([
+                'recompute1: 1 % 3 = 1',
+                'recompute2: 1 * 2 = 2',
+                'recompute3: 1 * 3 = 3',
+                'recompute4: 2 + 3 = 5',
+                'value: 5',
+            ]);
+            // keepObserved can be used to keep the cache alive.
+            const disposable = observable_base_1.Observable.keepObserved(computedSum);
+            log.log(`value: ${computedSum.get()}`);
+            (0, chai_1.expect)(log.getAndClearEntries()).to.be.deep.equal([
+                'recompute1: 1 % 3 = 1',
+                'recompute2: 1 * 2 = 2',
+                'recompute3: 1 * 3 = 3',
+                'recompute4: 2 + 3 = 5',
+                'value: 5',
+            ]);
+            log.log(`value: ${computedSum.get()}`);
+            // Tada, no recomputations!
+            (0, chai_1.expect)(log.getAndClearEntries()).to.be.deep.equal([
+                'value: 5',
+            ]);
+            observable1.set(2);
+            // keepObserved does not force derived observables to be recomputed.
+            (0, chai_1.expect)(log.getAndClearEntries()).to.be.deep.equal([]);
+            log.log(`value: ${computedSum.get()}`);
+            // Derived observables are only recomputed on demand...
+            (0, chai_1.expect)(log.getAndClearEntries()).to.be.deep.equal([
+                'recompute1: 2 % 3 = 2',
+                'recompute2: 2 * 2 = 4',
+                'recompute3: 2 * 3 = 6',
+                'recompute4: 4 + 6 = 10',
+                'value: 10',
+            ]);
+            log.log(`value: ${computedSum.get()}`);
+            // ...and then cached again.
+            (0, chai_1.expect)(log.getAndClearEntries()).to.be.deep.equal(['value: 10']);
+            // Don't forget to dispose the disposable returned by keepObserved!
+            disposable.dispose();
+            log.log(`value: ${computedSum.get()}`);
+            // The cache is disabled again.
+            (0, chai_1.expect)(log.getAndClearEntries()).to.be.deep.equal([
+                'recompute1: 2 % 3 = 2',
+                'recompute2: 2 * 2 = 4',
+                'recompute3: 2 * 3 = 6',
+                'recompute4: 4 + 6 = 10',
+                'value: 10',
+            ]);
+            log.log(`value: ${computedSum.get()}`);
+            (0, chai_1.expect)(log.getAndClearEntries()).to.be.deep.equal([
+                'recompute1: 2 % 3 = 2',
+                'recompute2: 2 * 2 = 4',
+                'recompute3: 2 * 3 = 6',
+                'recompute4: 4 + 6 = 10',
+                'value: 10',
+            ]);
+        });
+        it('autorun that receives change information of signals', () => {
+            const log = new Log();
+            // A signal is an observable without a value.
+            // However, it can ship change information when it is triggered.
+            const signal = observable_signal_1.ObservableSignal.create();
+            disposables.push(autorun_1.Autorun.create(({ changeSummary }) => {
+                signal.get(); // This makes sure the signal is tracked as a dependency of the autorun.
+                log.log('msgs: ' + changeSummary.msgs.join(', '));
+            }, {
+                // A change summary can be used to collect the reported changes.
+                createChangeSummary: () => ({ msgs: [] }),
+                willHandleChange: (context, changeSummary) => {
+                    if (context.isChangeOf(signal)) {
+                        changeSummary.msgs.push(context.change.msg);
+                    }
+                    return true;
+                },
+            }));
+            signal.trigger({ msg: 'foobar' });
+            // An update scope can be used to batch triggering signals.
+            // No change information is lost!
+            observable_base_1.Observable.update(() => {
+                signal.trigger({ msg: 'hello' });
+                signal.trigger({ msg: 'world' });
+            });
+            (0, chai_1.expect)(log.getAndClearEntries()).to.be.deep.equal([
+                'msgs: ',
+                'msgs: foobar',
+                'msgs: hello, world'
+            ]);
+        });
+    });
+});
+class Log {
+    constructor() {
+        this.entries = [];
+    }
+    log(message) {
+        this.entries.push(message);
+    }
+    getAndClearEntries() {
+        const entries = [...this.entries];
+        this.entries.length = 0;
+        return entries;
+    }
+}
+//# sourceMappingURL=observable.spec.js.map

package/lib/common/observable/observable.spec.js.map

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

package/lib/common/observable/settable-observable.d.ts

@@ -0,0 +1,16 @@
+import { BaseObservable, Observable } from './observable-base';
+export declare class SettableObservable<T, TChange = void> extends BaseObservable<T, TChange> implements Observable.Settable<T, TChange> {
+    protected value: T;
+    protected readonly isEqual: (a: T, b: T) => boolean;
+    constructor(initialValue: T, options?: SettableObservable.Options<T>);
+    protected getValue(): T;
+    set(value: T, change?: TChange, updateScope?: Observable.UpdateScope | undefined): void;
+    protected setValue(newValue: T): void;
+}
+export declare namespace SettableObservable {
+    function create<T, TChange = void>(initialValue: T, options?: Options<T>): Observable.Settable<T, TChange>;
+    interface Options<T> {
+        isEqual?: (a: T, b: T) => boolean;
+    }
+}
+//# sourceMappingURL=settable-observable.d.ts.map

package/lib/common/observable/settable-observable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settable-observable.d.ts","sourceRoot":"","sources":["../../../src/common/observable/settable-observable.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/D,qBAAa,kBAAkB,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI,CAAE,SAAQ,cAAc,CAAC,CAAC,EAAE,OAAO,CAAE,YAAW,UAAU,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC;IAE5H,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC;IACnB,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC;gBAGhD,YAAY,EAAE,CAAC,EACf,OAAO,CAAC,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;cAOxB,QAAQ,IAAI,CAAC;IAIhC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,WAAW,qCAAsC,GAAG,IAAI;IAiBxF,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,IAAI;CAGxC;AAED,yBAAiB,kBAAkB,CAAC;IAEhC,SAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI,EAAE,YAAY,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,CAEhH;IAED,UAAiB,OAAO,CAAC,CAAC;QACtB,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC;KACrC;CACJ"}

package/lib/common/observable/settable-observable.js

@@ -0,0 +1,58 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2025 1C-Soft LLC 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
+// *****************************************************************************
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+// copied and modified from https://github.com/microsoft/vscode/blob/1.96.3/src/vs/base/common/observableInternal/base.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SettableObservable = void 0;
+const observable_base_1 = require("./observable-base");
+class SettableObservable extends observable_base_1.BaseObservable {
+    constructor(initialValue, options) {
+        var _a;
+        super();
+        this.value = initialValue;
+        this.isEqual = (_a = options === null || options === void 0 ? void 0 : options.isEqual) !== null && _a !== void 0 ? _a : ((a, b) => a === b);
+    }
+    getValue() {
+        return this.value;
+    }
+    set(value, change, updateScope = observable_base_1.Observable.UpdateScope.getCurrent()) {
+        if (change === undefined && this.isEqual(this.value, value)) {
+            return;
+        }
+        observable_base_1.Observable.update(scope => {
+            this.setValue(value);
+            for (const observer of this.observers) {
+                scope.push(observer, this);
+                observer.handleChange(this, change);
+            }
+        }, updateScope);
+    }
+    setValue(newValue) {
+        this.value = newValue;
+    }
+}
+exports.SettableObservable = SettableObservable;
+(function (SettableObservable) {
+    function create(initialValue, options) {
+        return new SettableObservable(initialValue, options);
+    }
+    SettableObservable.create = create;
+})(SettableObservable || (exports.SettableObservable = SettableObservable = {}));
+//# sourceMappingURL=settable-observable.js.map

package/lib/common/observable/settable-observable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settable-observable.js","sourceRoot":"","sources":["../../../src/common/observable/settable-observable.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,6CAA6C;AAC7C,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;AAChF;;;gGAGgG;AAChG,yHAAyH;;;AAEzH,uDAA+D;AAE/D,MAAa,kBAAsC,SAAQ,gCAA0B;IAKjF,YACI,YAAe,EACf,OAAuC;;QAEvC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO,mCAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3D,CAAC;IAEkB,QAAQ;QACvB,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,GAAG,CAAC,KAAQ,EAAE,MAAgB,EAAE,WAAW,GAAG,4BAAU,CAAC,WAAW,CAAC,UAAU,EAAE;QAC7E,IAAI,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC;YAC1D,OAAO;QACX,CAAC;QAED,4BAAU,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;YAEtB,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAErB,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBACpC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;gBAC3B,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACxC,CAAC;QAEL,CAAC,EAAE,WAAW,CAAC,CAAC;IACpB,CAAC;IAES,QAAQ,CAAC,QAAW;QAC1B,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC;IAC1B,CAAC;CACJ;AAtCD,gDAsCC;AAED,WAAiB,kBAAkB;IAE/B,SAAgB,MAAM,CAAoB,YAAe,EAAE,OAAoB;QAC3E,OAAO,IAAI,kBAAkB,CAAa,YAAY,EAAE,OAAO,CAAC,CAAC;IACrE,CAAC;IAFe,yBAAM,SAErB,CAAA;AAKL,CAAC,EATgB,kBAAkB,kCAAlB,kBAAkB,QASlC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theia/core",
-  "version": "1.64.0-next.28+c0fda4c47",
+  "version": "1.64.0",
   "description": "Theia is a cloud & desktop IDE framework implemented in TypeScript.",
   "main": "lib/common/index.js",
   "typings": "lib/common/index.d.ts",
@@ -17,10 +17,9 @@
     "@lumino/virtualdom": "^2.0.2",
     "@lumino/widgets": "2.5.0",
     "@parcel/watcher": "^2.5.0",
-    "@theia/application-package": "1.64.0-next.28+c0fda4c47",
-    "@theia/request": "1.64.0-next.28+c0fda4c47",
+    "@theia/application-package": "1.64.0",
+    "@theia/request": "1.64.0",
     "@types/body-parser": "^1.16.4",
-    "@types/cookie": "^0.3.3",
     "@types/express": "^4.17.21",
     "@types/fs-extra": "^4.0.2",
     "@types/lodash.debounce": "4.0.3",
@@ -37,7 +36,7 @@
     "ajv": "^6.5.3",
     "async-mutex": "^0.4.0",
     "body-parser": "^1.17.2",
-    "cookie": "^0.4.0",
+    "cookie": "^1.0.2",
     "dompurify": "^3.2.4",
     "drivelist": "^12.0.2",
     "express": "^4.21.0",
@@ -208,13 +207,13 @@
     "watch": "theiaext watch"
   },
   "devDependencies": {
-    "@theia/ext-scripts": "1.63.0",
-    "@theia/re-exports": "1.63.0",
+    "@theia/ext-scripts": "1.64.0",
+    "@theia/re-exports": "1.64.0",
     "minimist": "^1.2.0",
     "nodejs-file-downloader": "4.13.0"
   },
   "nyc": {
     "extends": "../../configs/nyc.json"
   },
-  "gitHead": "c0fda4c4706fcd4ec1616c8e2f24673352a707d1"
+  "gitHead": "4c074e0d16c48e96a044b2f8bc4717de2e031c4b"
 }

package/src/browser/context-key-service.ts

@@ -41,6 +41,11 @@ export interface ContextKeyChangeEvent {
     affects(keys: { has(key: string): boolean }): boolean;
 }
 
+export interface Context {
+    getValue<T extends ContextKeyValue = ContextKeyValue>(key: string): T | undefined;
+    readonly onDidChange?: Event<ContextKeyChangeEvent>;
+}
+
 export const ContextKeyService = Symbol('ContextKeyService');
 
 export interface ContextMatcher {

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

@@ -207,7 +207,7 @@ export const frontendApplicationModule = new ContainerModule((bind, _unbind, _is
     });
     bind(TheiaDockPanel.Factory).toFactory(({ container }) => (options?: DockPanel.IOptions, maximizeCallback?: (area: TheiaDockPanel) => void) => {
         const corePreferences = container.get<CorePreferences>(CorePreferences);
-        return new TheiaDockPanel(options, corePreferences);
+        return new TheiaDockPanel(options, corePreferences, maximizeCallback);
     });
 
     bindContributionProvider(bind, TabBarDecorator);