@vscode/observables 0.1.1-0

package/dist/observableInternal/transaction.js

@@ -0,0 +1,114 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+import { handleBugIndicatingErrorRecovery } from './base.js';
+import { getFunctionName } from './debugName.js';
+import { getLogger } from './logging/logging.js';
+
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+/**
+ * Starts a transaction in which many observables can be changed at once.
+ * {@link fn} should start with a JS Doc using `@description` to give the transaction a debug name.
+ * Reaction run on demand or when the transaction ends.
+ */
+function transaction(fn, getDebugName) {
+    const tx = new TransactionImpl(fn, getDebugName);
+    try {
+        fn(tx);
+    }
+    finally {
+        tx.finish();
+    }
+}
+let _globalTransaction = undefined;
+function globalTransaction(fn) {
+    if (_globalTransaction) {
+        fn(_globalTransaction);
+    }
+    else {
+        const tx = new TransactionImpl(fn, undefined);
+        _globalTransaction = tx;
+        try {
+            fn(tx);
+        }
+        finally {
+            tx.finish(); // During finish, more actions might be added to the transaction.
+            // Which is why we only clear the global transaction after finish.
+            _globalTransaction = undefined;
+        }
+    }
+}
+/** @deprecated */
+async function asyncTransaction(fn, getDebugName) {
+    const tx = new TransactionImpl(fn, getDebugName);
+    try {
+        await fn(tx);
+    }
+    finally {
+        tx.finish();
+    }
+}
+/**
+ * Allows to chain transactions.
+ */
+function subtransaction(tx, fn, getDebugName) {
+    if (!tx) {
+        transaction(fn, getDebugName);
+    }
+    else {
+        fn(tx);
+    }
+}
+class TransactionImpl {
+    constructor(_fn, _getDebugName) {
+        this._fn = _fn;
+        this._getDebugName = _getDebugName;
+        this._updatingObservers = [];
+        getLogger()?.handleBeginTransaction(this);
+    }
+    getDebugName() {
+        if (this._getDebugName) {
+            return this._getDebugName();
+        }
+        return getFunctionName(this._fn);
+    }
+    updateObserver(observer, observable) {
+        if (!this._updatingObservers) {
+            // This happens when a transaction is used in a callback or async function.
+            // If an async transaction is used, make sure the promise awaits all users of the transaction (e.g. no race).
+            handleBugIndicatingErrorRecovery('Transaction already finished!');
+            // Error recovery
+            transaction(tx => {
+                tx.updateObserver(observer, observable);
+            });
+            return;
+        }
+        // When this gets called while finish is active, they will still get considered
+        this._updatingObservers.push({ observer, observable });
+        observer.beginUpdate(observable);
+    }
+    finish() {
+        const updatingObservers = this._updatingObservers;
+        if (!updatingObservers) {
+            handleBugIndicatingErrorRecovery('transaction.finish() has already been called!');
+            return;
+        }
+        for (let i = 0; i < updatingObservers.length; i++) {
+            const { observer, observable } = updatingObservers[i];
+            observer.endUpdate(observable);
+        }
+        // Prevent anyone from updating observers from now on.
+        this._updatingObservers = null;
+        getLogger()?.handleEndTransaction(this);
+    }
+    debugGetUpdatingObservers() {
+        return this._updatingObservers;
+    }
+}
+
+export { TransactionImpl, asyncTransaction, globalTransaction, subtransaction, transaction };
+//# sourceMappingURL=transaction.js.map

package/dist/observableInternal/transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.js","sources":["../../src/observableInternal/transaction.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/observableInternal/utils/promise.d.ts

@@ -0,0 +1,76 @@
+import { IObservable } from '../base';
+export declare class ObservableLazy<T> {
+    private readonly _computeValue;
+    private readonly _value;
+    /**
+     * The cached value.
+     * Does not force a computation of the value.
+     */
+    get cachedValue(): IObservable<T | undefined>;
+    constructor(_computeValue: () => T);
+    /**
+     * Returns the cached value.
+     * Computes the value if the value has not been cached yet.
+     */
+    getValue(): T;
+}
+/**
+ * A promise whose state is observable.
+ */
+export declare class ObservablePromise<T> {
+    static fromFn<T>(fn: () => Promise<T>): ObservablePromise<T>;
+    private readonly _value;
+    /**
+     * The promise that this object wraps.
+     */
+    readonly promise: Promise<T>;
+    /**
+     * The current state of the promise.
+     * Is `undefined` if the promise didn't resolve yet.
+     */
+    readonly promiseResult: IObservable<PromiseResult<T> | undefined>;
+    constructor(promise: Promise<T>);
+    readonly resolvedValue: import("..").IObservableWithChange<T | undefined, void>;
+}
+export declare class PromiseResult<T> {
+    /**
+     * The value of the resolved promise.
+     * Undefined if the promise rejected.
+     */
+    readonly data: T | undefined;
+    /**
+     * The error in case of a rejected promise.
+     * Undefined if the promise resolved.
+     */
+    readonly error: unknown | undefined;
+    constructor(
+    /**
+     * The value of the resolved promise.
+     * Undefined if the promise rejected.
+     */
+    data: T | undefined, 
+    /**
+     * The error in case of a rejected promise.
+     * Undefined if the promise resolved.
+     */
+    error: unknown | undefined);
+    /**
+     * Returns the value if the promise resolved, otherwise throws the error.
+     */
+    getDataOrThrow(): T;
+}
+/**
+ * A lazy promise whose state is observable.
+ */
+export declare class ObservableLazyPromise<T> {
+    private readonly _computePromise;
+    private readonly _lazyValue;
+    /**
+     * Does not enforce evaluation of the promise compute function.
+     * Is undefined if the promise has not been computed yet.
+     */
+    readonly cachedPromiseResult: import("..").IObservableWithChange<PromiseResult<T> | undefined, void>;
+    constructor(_computePromise: () => Promise<T>);
+    getPromise(): Promise<T>;
+}
+//# sourceMappingURL=promise.d.ts.map

package/dist/observableInternal/utils/promise.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promise.d.ts","sourceRoot":"","sources":["../../../src/observableInternal/utils/promise.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAKtC,qBAAa,cAAc,CAAC,CAAC;IAShB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAR1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmD;IAE1E;;;OAGG;IACH,IAAW,WAAW,IAAI,WAAW,CAAC,CAAC,GAAG,SAAS,CAAC,CAAwB;gBAE/C,aAAa,EAAE,MAAM,CAAC;IAGnD;;;OAGG;IACI,QAAQ,IAAI,CAAC;CAQpB;AAED;;GAEG;AACH,qBAAa,iBAAiB,CAAC,CAAC;WACjB,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC;IAInE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkE;IAEzF;;OAEG;IACH,SAAgB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAEpC;;;OAGG;IACH,SAAgB,aAAa,EAAE,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAe;gBAE3E,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAgB/B,SAAgB,aAAa,0DAM1B;CACH;AAED,qBAAa,aAAa,CAAC,CAAC;IAE1B;;;OAGG;aACa,IAAI,EAAE,CAAC,GAAG,SAAS;IAEnC;;;OAGG;aACa,KAAK,EAAE,OAAO,GAAG,SAAS;;IAV1C;;;OAGG;IACa,IAAI,EAAE,CAAC,GAAG,SAAS;IAEnC;;;OAGG;IACa,KAAK,EAAE,OAAO,GAAG,SAAS;IAI3C;;OAEG;IACI,cAAc,IAAI,CAAC;CAM1B;AAED;;GAEG;AACH,qBAAa,qBAAqB,CAAC,CAAC;IASvB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAR5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA2E;IAEtG;;;OAGG;IACH,SAAgB,mBAAmB,yEAAiG;gBAEvG,eAAe,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC;IAGvD,UAAU,IAAI,OAAO,CAAC,CAAC,CAAC;CAG/B"}

package/dist/observableInternal/utils/promise.js

@@ -0,0 +1,112 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+import { transaction } from '../transaction.js';
+import { derived } from '../observables/derived.js';
+import { observableValue } from '../observables/observableValue.js';
+
+class ObservableLazy {
+    /**
+     * The cached value.
+     * Does not force a computation of the value.
+     */
+    get cachedValue() { return this._value; }
+    constructor(_computeValue) {
+        this._computeValue = _computeValue;
+        this._value = observableValue(this, undefined);
+    }
+    /**
+     * Returns the cached value.
+     * Computes the value if the value has not been cached yet.
+     */
+    getValue() {
+        let v = this._value.get();
+        if (!v) {
+            v = this._computeValue();
+            this._value.set(v, undefined);
+        }
+        return v;
+    }
+}
+/**
+ * A promise whose state is observable.
+ */
+class ObservablePromise {
+    static fromFn(fn) {
+        return new ObservablePromise(fn());
+    }
+    constructor(promise) {
+        this._value = observableValue(this, undefined);
+        /**
+         * The current state of the promise.
+         * Is `undefined` if the promise didn't resolve yet.
+         */
+        this.promiseResult = this._value;
+        this.resolvedValue = derived(this, reader => {
+            const result = this.promiseResult.read(reader);
+            if (!result) {
+                return undefined;
+            }
+            return result.getDataOrThrow();
+        });
+        this.promise = promise.then(value => {
+            transaction(tx => {
+                /** @description onPromiseResolved */
+                this._value.set(new PromiseResult(value, undefined), tx);
+            });
+            return value;
+        }, error => {
+            transaction(tx => {
+                /** @description onPromiseRejected */
+                this._value.set(new PromiseResult(undefined, error), tx);
+            });
+            throw error;
+        });
+    }
+}
+class PromiseResult {
+    constructor(
+    /**
+     * The value of the resolved promise.
+     * Undefined if the promise rejected.
+     */
+    data, 
+    /**
+     * The error in case of a rejected promise.
+     * Undefined if the promise resolved.
+     */
+    error) {
+        this.data = data;
+        this.error = error;
+    }
+    /**
+     * Returns the value if the promise resolved, otherwise throws the error.
+     */
+    getDataOrThrow() {
+        if (this.error) {
+            throw this.error;
+        }
+        return this.data;
+    }
+}
+/**
+ * A lazy promise whose state is observable.
+ */
+class ObservableLazyPromise {
+    constructor(_computePromise) {
+        this._computePromise = _computePromise;
+        this._lazyValue = new ObservableLazy(() => new ObservablePromise(this._computePromise()));
+        /**
+         * Does not enforce evaluation of the promise compute function.
+         * Is undefined if the promise has not been computed yet.
+         */
+        this.cachedPromiseResult = derived(this, reader => this._lazyValue.cachedValue.read(reader)?.promiseResult.read(reader));
+    }
+    getPromise() {
+        return this._lazyValue.getValue().promise;
+    }
+}
+
+export { ObservableLazy, ObservableLazyPromise, ObservablePromise, PromiseResult };
+//# sourceMappingURL=promise.js.map

package/dist/observableInternal/utils/promise.js.map

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

package/dist/observableInternal/utils/runOnChange.d.ts

@@ -0,0 +1,8 @@
+import { IObservableWithChange } from '../base';
+import { CancellationToken } from '../commonFacade/cancellation';
+import { DisposableStore, IDisposable } from '../commonFacade/deps';
+export type RemoveUndefined<T> = T extends undefined ? never : T;
+export declare function runOnChange<T, TChange>(observable: IObservableWithChange<T, TChange>, cb: (value: T, previousValue: T, deltas: RemoveUndefined<TChange>[]) => void): IDisposable;
+export declare function runOnChangeWithStore<T, TChange>(observable: IObservableWithChange<T, TChange>, cb: (value: T, previousValue: T, deltas: RemoveUndefined<TChange>[], store: DisposableStore) => void): IDisposable;
+export declare function runOnChangeWithCancellationToken<T, TChange>(observable: IObservableWithChange<T, TChange>, cb: (value: T, previousValue: T, deltas: RemoveUndefined<TChange>[], token: CancellationToken) => Promise<void>): IDisposable;
+//# sourceMappingURL=runOnChange.d.ts.map

package/dist/observableInternal/utils/runOnChange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runOnChange.d.ts","sourceRoot":"","sources":["../../../src/observableInternal/utils/runOnChange.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAmB,MAAM,8BAA8B,CAAC;AAClF,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGpE,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,CAAC,SAAS,SAAS,GAAG,KAAK,GAAG,CAAC,CAAC;AAEjE,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,qBAAqB,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,EAAE,KAAK,IAAI,GAAG,WAAW,CA8BhL;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,qBAAqB,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,eAAe,KAAK,IAAI,GAAG,WAAW,CAYjN;AAED,wBAAgB,gCAAgC,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,qBAAqB,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,WAAW,CAIxO"}

package/dist/observableInternal/utils/runOnChange.js

@@ -0,0 +1,64 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+import { cancelOnDispose } from '../commonFacade/cancellation.js';
+import { DisposableStore } from '../../disposables.js';
+import { autorunWithStoreHandleChanges } from '../reactions/createEffect.js';
+
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+function runOnChange(observable, cb) {
+    let _previousValue;
+    let _firstRun = true;
+    return autorunWithStoreHandleChanges({
+        changeTracker: {
+            createChangeSummary: () => ({ deltas: [], didChange: false }),
+            handleChange: (context, changeSummary) => {
+                if (context.didChange(observable)) {
+                    const e = context.change;
+                    if (e !== undefined) {
+                        changeSummary.deltas.push(e);
+                    }
+                    changeSummary.didChange = true;
+                }
+                return true;
+            },
+        }
+    }, (reader, changeSummary) => {
+        const value = observable.read(reader);
+        const previousValue = _previousValue;
+        if (changeSummary.didChange) {
+            _previousValue = value;
+            // didChange can never be true on the first autorun, so we know previousValue is defined
+            cb(value, previousValue, changeSummary.deltas);
+        }
+        if (_firstRun) {
+            _firstRun = false;
+            _previousValue = value;
+        }
+    });
+}
+function runOnChangeWithStore(observable, cb) {
+    const store = new DisposableStore();
+    const disposable = runOnChange(observable, (value, previousValue, deltas) => {
+        store.clear();
+        cb(value, previousValue, deltas, store);
+    });
+    return {
+        dispose() {
+            disposable.dispose();
+            store.dispose();
+        }
+    };
+}
+function runOnChangeWithCancellationToken(observable, cb) {
+    return runOnChangeWithStore(observable, (value, previousValue, deltas, store) => {
+        cb(value, previousValue, deltas, cancelOnDispose(store));
+    });
+}
+
+export { runOnChange, runOnChangeWithCancellationToken, runOnChangeWithStore };
+//# sourceMappingURL=runOnChange.js.map

package/dist/observableInternal/utils/runOnChange.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runOnChange.js","sources":["../../../src/observableInternal/utils/runOnChange.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;AAAA;;;AAGgG;AAShF,SAAA,WAAW,CAAa,UAA6C,EAAE,EAA4E,EAAA;AAClK,IAAA,IAAI,cAA6B,CAAC;IAClC,IAAI,SAAS,GAAG,IAAI,CAAC;AACrB,IAAA,OAAO,6BAA6B,CAAC;AACpC,QAAA,aAAa,EAAE;AACd,YAAA,mBAAmB,EAAE,OAAO,EAAE,MAAM,EAAE,EAAgC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AAC3F,YAAA,YAAY,EAAE,CAAC,OAAO,EAAE,aAAa,KAAI;AACxC,gBAAA,IAAI,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE;AAClC,oBAAA,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;AACzB,oBAAA,IAAI,CAAC,KAAK,SAAS,EAAE;AACpB,wBAAA,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAA6B,CAAC,CAAC;qBACzD;AACD,oBAAA,aAAa,CAAC,SAAS,GAAG,IAAI,CAAC;iBAC/B;AACD,gBAAA,OAAO,IAAI,CAAC;aACZ;AACD,SAAA;AACD,KAAA,EAAE,CAAC,MAAM,EAAE,aAAa,KAAI;QAC5B,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,aAAa,GAAG,cAAc,CAAC;AACrC,QAAA,IAAI,aAAa,CAAC,SAAS,EAAE;YAC5B,cAAc,GAAG,KAAK,CAAC;;YAEvB,EAAE,CAAC,KAAK,EAAE,aAAc,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;SAChD;QACD,IAAI,SAAS,EAAE;YACd,SAAS,GAAG,KAAK,CAAC;YAClB,cAAc,GAAG,KAAK,CAAC;SACvB;AACF,KAAC,CAAC,CAAC;AACJ,CAAC;AAEe,SAAA,oBAAoB,CAAa,UAA6C,EAAE,EAAoG,EAAA;AACnM,IAAA,MAAM,KAAK,GAAG,IAAI,eAAe,EAAE,CAAC;AACpC,IAAA,MAAM,UAAU,GAAG,WAAW,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,aAAgB,EAAE,MAAM,KAAI;QAC9E,KAAK,CAAC,KAAK,EAAE,CAAC;QACd,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AACzC,KAAC,CAAC,CAAC;IACH,OAAO;QACN,OAAO,GAAA;YACN,UAAU,CAAC,OAAO,EAAE,CAAC;YACrB,KAAK,CAAC,OAAO,EAAE,CAAC;SAChB;KACD,CAAC;AACH,CAAC;AAEe,SAAA,gCAAgC,CAAa,UAA6C,EAAE,EAA+G,EAAA;AAC1N,IAAA,OAAO,oBAAoB,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,KAAI;AAC/E,QAAA,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;AAC1D,KAAC,CAAC,CAAC;AACJ;;;;"}

package/dist/observableInternal/utils/utils.d.ts

@@ -0,0 +1,44 @@
+import { IObservable, IObservableWithChange, IObserver, IReader, ITransaction } from '../base';
+import { DebugOwner } from '../debugName';
+import { DisposableStore, Event, IDisposable } from '../commonFacade/deps';
+export declare function observableFromPromise<T>(promise: Promise<T>): IObservable<{
+    value?: T;
+}>;
+export declare function signalFromObservable<T>(owner: DebugOwner | undefined, observable: IObservable<T>): IObservable<void>;
+/**
+ * @deprecated Use `debouncedObservable` instead.
+ */
+export declare function debouncedObservableDeprecated<T>(observable: IObservable<T>, debounceMs: number, disposableStore: DisposableStore): IObservable<T | undefined>;
+/**
+ * Creates an observable that debounces the input observable.
+ */
+export declare function debouncedObservable<T>(observable: IObservable<T>, debounceMs: number): IObservable<T>;
+export declare function wasEventTriggeredRecently(event: Event<any>, timeoutMs: number, disposableStore: DisposableStore): IObservable<boolean>;
+/**
+ * This makes sure the observable is being observed and keeps its cache alive.
+ */
+export declare function keepObserved<T>(observable: IObservable<T>): IDisposable;
+/**
+ * This converts the given observable into an autorun.
+ */
+export declare function recomputeInitiallyAndOnChange<T>(observable: IObservable<T>, handleValue?: (value: T) => void): IDisposable;
+export declare class KeepAliveObserver implements IObserver {
+    private readonly _forceRecompute;
+    private readonly _handleValue;
+    private _counter;
+    constructor(_forceRecompute: boolean, _handleValue: ((value: any) => void) | undefined);
+    beginUpdate<T>(observable: IObservable<T>): void;
+    endUpdate<T>(observable: IObservable<T>): void;
+    handlePossibleChange<T>(observable: IObservable<T>): void;
+    handleChange<T, TChange>(observable: IObservableWithChange<T, TChange>, change: TChange): void;
+}
+export declare function derivedObservableWithCache<T>(owner: DebugOwner, computeFn: (reader: IReader, lastValue: T | undefined) => T): IObservable<T>;
+export declare function derivedObservableWithWritableCache<T>(owner: object, computeFn: (reader: IReader, lastValue: T | undefined) => T): IObservable<T> & {
+    clearCache(transaction: ITransaction): void;
+    setCache(newValue: T | undefined, tx: ITransaction | undefined): void;
+};
+/**
+ * When the items array changes, referential equal items are not mapped again.
+ */
+export declare function mapObservableArrayCached<TIn, TOut, TKey = TIn>(owner: DebugOwner, items: IObservable<readonly TIn[]>, map: (input: TIn, store: DisposableStore) => TOut, keySelector?: (input: TIn) => TKey): IObservable<readonly TOut[]>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/observableInternal/utils/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/observableInternal/utils/utils.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAG/F,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,WAAW,EAAgB,MAAM,sBAAsB,CAAC;AAMzF,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC;IAAE,KAAK,CAAC,EAAE,CAAC,CAAA;CAAE,CAAC,CAMxF;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,GAAG,SAAS,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,CAOpH;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,CAAC,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,eAAe,GAAG,WAAW,CAAC,CAAC,GAAG,SAAS,CAAC,CAqB7J;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAqCrG;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,eAAe,GAAG,WAAW,CAAC,OAAO,CAAC,CAiBtI;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,CAMvE;AAID;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,CAAC,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,WAAW,CAY1H;AAID,qBAAa,iBAAkB,YAAW,SAAS;IAIjD,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAJ9B,OAAO,CAAC,QAAQ,CAAK;gBAGH,eAAe,EAAE,OAAO,EACxB,YAAY,EAAE,CAAC,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC,GAAG,SAAS;IAGlE,WAAW,CAAC,CAAC,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI;IAIhD,SAAS,CAAC,CAAC,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI;IAW9C,oBAAoB,CAAC,CAAC,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI;IAIzD,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,qBAAqB,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;CAG9F;AAED,wBAAgB,0BAA0B,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,GAAG,SAAS,KAAK,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAO5I;AAED,wBAAgB,kCAAkC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,GAAG,SAAS,KAAK,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,GAC9I;IAAE,UAAU,CAAC,WAAW,EAAE,YAAY,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,SAAS,EAAE,EAAE,EAAE,YAAY,GAAG,SAAS,GAAG,IAAI,CAAA;CAAE,CAkBxH;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,GAAG,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,CAAC,SAAS,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,eAAe,KAAK,IAAI,EAAE,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,GAAG,WAAW,CAAC,SAAS,IAAI,EAAE,CAAC,CAc1O"}