@vscode/chat-lib 0.0.1

package/dist/src/_internal/util/vs/base/common/lifecycle.d.ts

@@ -0,0 +1,262 @@
+export interface IDisposableTracker {
+    /**
+     * Is called on construction of a disposable.
+    */
+    trackDisposable(disposable: IDisposable): void;
+    /**
+     * Is called when a disposable is registered as child of another disposable (e.g. {@link DisposableStore}).
+     * If parent is `null`, the disposable is removed from its former parent.
+    */
+    setParent(child: IDisposable, parent: IDisposable | null): void;
+    /**
+     * Is called after a disposable is disposed.
+    */
+    markAsDisposed(disposable: IDisposable): void;
+    /**
+     * Indicates that the given object is a singleton which does not need to be disposed.
+    */
+    markAsSingleton(disposable: IDisposable): void;
+}
+export declare class GCBasedDisposableTracker implements IDisposableTracker {
+    private readonly _registry;
+    trackDisposable(disposable: IDisposable): void;
+    setParent(child: IDisposable, parent: IDisposable | null): void;
+    markAsDisposed(disposable: IDisposable): void;
+    markAsSingleton(disposable: IDisposable): void;
+}
+export interface DisposableInfo {
+    value: IDisposable;
+    source: string | null;
+    parent: IDisposable | null;
+    isSingleton: boolean;
+    idx: number;
+}
+export declare class DisposableTracker implements IDisposableTracker {
+    private static idx;
+    private readonly livingDisposables;
+    private getDisposableData;
+    trackDisposable(d: IDisposable): void;
+    setParent(child: IDisposable, parent: IDisposable | null): void;
+    markAsDisposed(x: IDisposable): void;
+    markAsSingleton(disposable: IDisposable): void;
+    private getRootParent;
+    getTrackedDisposables(): IDisposable[];
+    computeLeakingDisposables(maxReported?: number, preComputedLeaks?: DisposableInfo[]): {
+        leaks: DisposableInfo[];
+        details: string;
+    } | undefined;
+}
+export declare function setDisposableTracker(tracker: IDisposableTracker | null): void;
+export declare function trackDisposable<T extends IDisposable>(x: T): T;
+export declare function markAsDisposed(disposable: IDisposable): void;
+/**
+ * Indicates that the given object is a singleton which does not need to be disposed.
+*/
+export declare function markAsSingleton<T extends IDisposable>(singleton: T): T;
+/**
+ * An object that performs a cleanup operation when `.dispose()` is called.
+ *
+ * Some examples of how disposables are used:
+ *
+ * - An event listener that removes itself when `.dispose()` is called.
+ * - A resource such as a file system watcher that cleans up the resource when `.dispose()` is called.
+ * - The return value from registering a provider. When `.dispose()` is called, the provider is unregistered.
+ */
+export interface IDisposable {
+    dispose(): void;
+}
+/**
+ * Check if `thing` is {@link IDisposable disposable}.
+ */
+export declare function isDisposable<E extends any>(thing: E): thing is E & IDisposable;
+/**
+ * Disposes of the value(s) passed in.
+ */
+export declare function dispose<T extends IDisposable>(disposable: T): T;
+export declare function dispose<T extends IDisposable>(disposable: T | undefined): T | undefined;
+export declare function dispose<T extends IDisposable, A extends Iterable<T> = Iterable<T>>(disposables: A): A;
+export declare function dispose<T extends IDisposable>(disposables: Array<T>): Array<T>;
+export declare function dispose<T extends IDisposable>(disposables: ReadonlyArray<T>): ReadonlyArray<T>;
+export declare function disposeIfDisposable<T extends IDisposable | object>(disposables: Array<T>): Array<T>;
+/**
+ * Combine multiple disposable values into a single {@link IDisposable}.
+ */
+export declare function combinedDisposable(...disposables: IDisposable[]): IDisposable;
+/**
+ * Turn a function that implements dispose into an {@link IDisposable}.
+ *
+ * @param fn Clean up function, guaranteed to be called only **once**.
+ */
+export declare function toDisposable(fn: () => void): IDisposable;
+/**
+ * Manages a collection of disposable values.
+ *
+ * This is the preferred way to manage multiple disposables. A `DisposableStore` is safer to work with than an
+ * `IDisposable[]` as it considers edge cases, such as registering the same value multiple times or adding an item to a
+ * store that has already been disposed of.
+ */
+export declare class DisposableStore implements IDisposable {
+    static DISABLE_DISPOSED_WARNING: boolean;
+    private readonly _toDispose;
+    private _isDisposed;
+    constructor();
+    /**
+     * Dispose of all registered disposables and mark this object as disposed.
+     *
+     * Any future disposables added to this object will be disposed of on `add`.
+     */
+    dispose(): void;
+    /**
+     * @return `true` if this object has been disposed of.
+     */
+    get isDisposed(): boolean;
+    /**
+     * Dispose of all registered disposables but do not mark this object as disposed.
+     */
+    clear(): void;
+    /**
+     * Add a new {@link IDisposable disposable} to the collection.
+     */
+    add<T extends IDisposable>(o: T): T;
+    /**
+     * Deletes a disposable from store and disposes of it. This will not throw or warn and proceed to dispose the
+     * disposable even when the disposable is not part in the store.
+     */
+    delete<T extends IDisposable>(o: T): void;
+    /**
+     * Deletes the value from the store, but does not dispose it.
+     */
+    deleteAndLeak<T extends IDisposable>(o: T): void;
+    assertNotDisposed(): void;
+}
+/**
+ * Abstract base class for a {@link IDisposable disposable} object.
+ *
+ * Subclasses can {@linkcode _register} disposables that will be automatically cleaned up when this object is disposed of.
+ */
+export declare abstract class Disposable implements IDisposable {
+    /**
+     * A disposable that does nothing when it is disposed of.
+     *
+     * TODO: This should not be a static property.
+     */
+    static readonly None: Readonly<IDisposable>;
+    protected readonly _store: DisposableStore;
+    constructor();
+    dispose(): void;
+    /**
+     * Adds `o` to the collection of disposables managed by this object.
+     */
+    protected _register<T extends IDisposable>(o: T): T;
+}
+/**
+ * Manages the lifecycle of a disposable value that may be changed.
+ *
+ * This ensures that when the disposable value is changed, the previously held disposable is disposed of. You can
+ * also register a `MutableDisposable` on a `Disposable` to ensure it is automatically cleaned up.
+ */
+export declare class MutableDisposable<T extends IDisposable> implements IDisposable {
+    private _value?;
+    private _isDisposed;
+    constructor();
+    get value(): T | undefined;
+    set value(value: T | undefined);
+    /**
+     * Resets the stored value and disposed of the previously stored value.
+     */
+    clear(): void;
+    dispose(): void;
+    /**
+     * Clears the value, but does not dispose it.
+     * The old value is returned.
+    */
+    clearAndLeak(): T | undefined;
+}
+/**
+ * Manages the lifecycle of a disposable value that may be changed like {@link MutableDisposable}, but the value must
+ * exist and cannot be undefined.
+ */
+export declare class MandatoryMutableDisposable<T extends IDisposable> implements IDisposable {
+    private readonly _disposable;
+    private _isDisposed;
+    constructor(initialValue: T);
+    get value(): T;
+    set value(value: T);
+    dispose(): void;
+}
+export declare class RefCountedDisposable {
+    private readonly _disposable;
+    private _counter;
+    constructor(_disposable: IDisposable);
+    acquire(): this;
+    release(): this;
+}
+export interface IReference<T> extends IDisposable {
+    readonly object: T;
+}
+export declare abstract class ReferenceCollection<T> {
+    private readonly references;
+    acquire(key: string, ...args: any[]): IReference<T>;
+    protected abstract createReferencedObject(key: string, ...args: any[]): T;
+    protected abstract destroyReferencedObject(key: string, object: T): void;
+}
+/**
+ * Unwraps a reference collection of promised values. Makes sure
+ * references are disposed whenever promises get rejected.
+ */
+export declare class AsyncReferenceCollection<T> {
+    private referenceCollection;
+    constructor(referenceCollection: ReferenceCollection<Promise<T>>);
+    acquire(key: string, ...args: any[]): Promise<IReference<T>>;
+}
+export declare class ImmortalReference<T> implements IReference<T> {
+    object: T;
+    constructor(object: T);
+    dispose(): void;
+}
+export declare function disposeOnReturn(fn: (store: DisposableStore) => void): void;
+/**
+ * A map the manages the lifecycle of the values that it stores.
+ */
+export declare class DisposableMap<K, V extends IDisposable = IDisposable> implements IDisposable {
+    private readonly _store;
+    private _isDisposed;
+    constructor();
+    /**
+     * Disposes of all stored values and mark this object as disposed.
+     *
+     * Trying to use this object after it has been disposed of is an error.
+     */
+    dispose(): void;
+    /**
+     * Disposes of all stored values and clear the map, but DO NOT mark this object as disposed.
+     */
+    clearAndDisposeAll(): void;
+    has(key: K): boolean;
+    get size(): number;
+    get(key: K): V | undefined;
+    set(key: K, value: V, skipDisposeOnOverwrite?: boolean): void;
+    /**
+     * Delete the value stored for `key` from this map and also dispose of it.
+     */
+    deleteAndDispose(key: K): void;
+    /**
+     * Delete the value stored for `key` from this map but return it. The caller is
+     * responsible for disposing of the value.
+     */
+    deleteAndLeak(key: K): V | undefined;
+    keys(): IterableIterator<K>;
+    values(): IterableIterator<V>;
+    [Symbol.iterator](): IterableIterator<[K, V]>;
+}
+/**
+ * Call `then` on a Promise, unless the returned disposable is disposed.
+ */
+export declare function thenIfNotDisposed<T>(promise: Promise<T>, then: (result: T) => void): IDisposable;
+/**
+ * Call `then` on a promise that resolves to a {@link IDisposable}, then either register the
+ * disposable or register it to the {@link DisposableStore}, depending on whether the store is
+ * disposed or not.
+ */
+export declare function thenRegisterOrDispose<T extends IDisposable>(promise: Promise<T>, store: DisposableStore): Promise<T>;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/src/_internal/util/vs/base/common/lifecycle.d.ts.map

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