@opensumi/ide-utils 2.16.6

package/lib/async.js

@@ -0,0 +1,467 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.disposableTimeout = exports.RunOnceScheduler = exports.raceCancellation = exports.timeout = exports.first = exports.IdleValue = exports.runWhenIdle = exports.asPromise = exports.raceTimeout = exports.isThenable = exports.AutoOpenBarrier = exports.Barrier = exports.ThrottledDelayer = exports.Delayer = exports.Sequencer = exports.Throttler = exports.hookCancellationToken = exports.createCancelablePromise = void 0;
+const cancellation_1 = require("./cancellation");
+const disposable_1 = require("./disposable");
+const errors_1 = require("./errors");
+function createCancelablePromise(callback) {
+    const source = new cancellation_1.CancellationTokenSource();
+    const thenable = callback(source.token);
+    const promise = new Promise((resolve, reject) => {
+        source.token.onCancellationRequested(() => {
+            reject((0, errors_1.canceled)());
+        });
+        Promise.resolve(thenable).then((value) => {
+            source.dispose();
+            resolve(value);
+        }, (err) => {
+            source.dispose();
+            reject(err);
+        });
+    });
+    return new (class {
+        cancel() {
+            source.cancel();
+        }
+        then(resolve, reject) {
+            return promise.then(resolve, reject);
+        }
+        catch(reject) {
+            return this.then(undefined, reject);
+        }
+        finally(onfinally) {
+            return promise.finally(onfinally);
+        }
+    })();
+}
+exports.createCancelablePromise = createCancelablePromise;
+function hookCancellationToken(token, promise) {
+    return new Promise((resolve, reject) => {
+        const sub = token.onCancellationRequested(() => reject(new Error('This promise is cancelled')));
+        promise
+            .then((value) => {
+            sub.dispose();
+            resolve(value);
+        })
+            .catch((err) => {
+            sub.dispose();
+            reject(err);
+        });
+    });
+}
+exports.hookCancellationToken = hookCancellationToken;
+/**
+ * A helper to prevent accumulation of sequential async tasks.
+ *
+ * Imagine a mail man with the sole task of delivering letters. As soon as
+ * a letter submitted for delivery, he drives to the destination, delivers it
+ * and returns to his base. Imagine that during the trip, N more letters were submitted.
+ * When the mail man returns, he picks those N letters and delivers them all in a
+ * single trip. Even though N+1 submissions occurred, only 2 deliveries were made.
+ *
+ * The throttler implements this via the queue() method, by providing it a task
+ * factory. Following the example:
+ *
+ * 		const throttler = new Throttler();
+ * 		const letters = [];
+ *
+ * 		function deliver() {
+ * 			const lettersToDeliver = letters;
+ * 			letters = [];
+ * 			return makeTheTrip(lettersToDeliver);
+ * 		}
+ *
+ * 		function onLetterReceived(l) {
+ * 			letters.push(l);
+ * 			throttler.queue(deliver);
+ * 		}
+ */
+class Throttler {
+    constructor() {
+        this.activePromise = null;
+        this.queuedPromise = null;
+        this.queuedPromiseFactory = null;
+    }
+    queue(promiseFactory) {
+        if (this.activePromise) {
+            this.queuedPromiseFactory = promiseFactory;
+            if (!this.queuedPromise) {
+                const onComplete = () => {
+                    this.queuedPromise = null;
+                    const result = this.queue(this.queuedPromiseFactory);
+                    this.queuedPromiseFactory = null;
+                    return result;
+                };
+                this.queuedPromise = new Promise((c) => {
+                    this.activePromise && this.activePromise.then(onComplete, onComplete).then(c);
+                });
+            }
+            return new Promise((c, e) => {
+                this.queuedPromise && this.queuedPromise.then(c, e);
+            });
+        }
+        this.activePromise = promiseFactory();
+        return new Promise((c, e) => {
+            var _a;
+            (_a = this.activePromise) === null || _a === void 0 ? void 0 : _a.then((result) => {
+                this.activePromise = null;
+                c(result);
+            }, (err) => {
+                this.activePromise = null;
+                e(err);
+            });
+        });
+    }
+}
+exports.Throttler = Throttler;
+class Sequencer {
+    constructor() {
+        this.current = Promise.resolve(null);
+    }
+    queue(promiseTask) {
+        return (this.current = this.current.then(() => promiseTask()));
+    }
+}
+exports.Sequencer = Sequencer;
+/**
+ * A helper to delay execution of a task that is being requested often.
+ *
+ * Following the throttler, now imagine the mail man wants to optimize the number of
+ * trips proactively. The trip itself can be long, so he decides not to make the trip
+ * as soon as a letter is submitted. Instead he waits a while, in case more
+ * letters are submitted. After said waiting period, if no letters were submitted, he
+ * decides to make the trip. Imagine that N more letters were submitted after the first
+ * one, all within a short period of time between each other. Even though N+1
+ * submissions occurred, only 1 delivery was made.
+ *
+ * The delayer offers this behavior via the trigger() method, into which both the task
+ * to be executed and the waiting period (delay) must be passed in as arguments. Following
+ * the example:
+ *
+ * 		const delayer = new Delayer(WAITING_PERIOD);
+ * 		const letters = [];
+ *
+ * 		function letterReceived(l) {
+ * 			letters.push(l);
+ * 			delayer.trigger(() => { return makeTheTrip(); });
+ * 		}
+ */
+class Delayer {
+    constructor(defaultDelay) {
+        this.defaultDelay = defaultDelay;
+        this.timeout = null;
+        this.completionPromise = null;
+        this.doResolve = null;
+        this.task = null;
+    }
+    trigger(task, delay = this.defaultDelay) {
+        this.task = task;
+        this.cancelTimeout();
+        if (!this.completionPromise) {
+            this.completionPromise = new Promise((c, e) => {
+                this.doResolve = c;
+                this.doReject = e;
+            })
+                .then(() => {
+                this.completionPromise = null;
+                this.doResolve = null;
+                const task = this.task;
+                this.task = null;
+                return task && task();
+            })
+                .catch();
+        }
+        this.timeout = setTimeout(() => {
+            var _a;
+            this.timeout = null;
+            (_a = this.doResolve) === null || _a === void 0 ? void 0 : _a.call(this, null);
+        }, delay);
+        return this.completionPromise;
+    }
+    isTriggered() {
+        return this.timeout !== null;
+    }
+    cancel() {
+        this.cancelTimeout();
+        if (this.completionPromise) {
+            this.doReject && this.doReject((0, errors_1.canceled)());
+            this.completionPromise = null;
+        }
+    }
+    cancelTimeout() {
+        if (this.timeout !== null) {
+            clearTimeout(this.timeout);
+            this.timeout = null;
+        }
+    }
+    dispose() {
+        this.cancelTimeout();
+    }
+}
+exports.Delayer = Delayer;
+/**
+ * A helper to delay execution of a task that is being requested often, while
+ * preventing accumulation of consecutive executions, while the task runs.
+ *
+ * The mail man is clever and waits for a certain amount of time, before going
+ * out to deliver letters. While the mail man is going out, more letters arrive
+ * and can only be delivered once he is back. Once he is back the mail man will
+ * do one more trip to deliver the letters that have accumulated while he was out.
+ */
+class ThrottledDelayer {
+    constructor(defaultDelay) {
+        this.delayer = new Delayer(defaultDelay);
+        this.throttler = new Throttler();
+    }
+    trigger(promiseFactory, delay) {
+        return this.delayer.trigger(() => this.throttler.queue(promiseFactory), delay);
+    }
+    isTriggered() {
+        return this.delayer.isTriggered();
+    }
+    cancel() {
+        this.delayer.cancel();
+    }
+    dispose() {
+        this.delayer.dispose();
+    }
+}
+exports.ThrottledDelayer = ThrottledDelayer;
+/**
+ * A barrier that is initially closed and then becomes opened permanently.
+ */
+class Barrier {
+    constructor() {
+        this._isOpen = false;
+        this._promise = new Promise((c) => {
+            this._completePromise = c;
+        });
+    }
+    isOpen() {
+        return this._isOpen;
+    }
+    open() {
+        this._isOpen = true;
+        this._completePromise(true);
+    }
+    wait() {
+        return this._promise;
+    }
+}
+exports.Barrier = Barrier;
+/**
+ * A barrier that is initially closed and then becomes opened permanently after a certain period of
+ * time or when open is called explicitly
+ */
+class AutoOpenBarrier extends Barrier {
+    constructor(autoOpenTimeMs) {
+        super();
+        this._timeout = setTimeout(() => this.open(), autoOpenTimeMs);
+    }
+    open() {
+        clearTimeout(this._timeout);
+        super.open();
+    }
+}
+exports.AutoOpenBarrier = AutoOpenBarrier;
+function isThenable(obj) {
+    return obj && typeof obj.then === 'function';
+}
+exports.isThenable = isThenable;
+function raceTimeout(promise, timeout, onTimeout) {
+    let promiseResolve;
+    const timer = setTimeout(() => {
+        promiseResolve === null || promiseResolve === void 0 ? void 0 : promiseResolve(undefined);
+        onTimeout === null || onTimeout === void 0 ? void 0 : onTimeout();
+    }, timeout);
+    return Promise.race([
+        promise.finally(() => clearTimeout(timer)),
+        new Promise((resolve) => (promiseResolve = resolve)),
+    ]);
+}
+exports.raceTimeout = raceTimeout;
+function asPromise(callback) {
+    return new Promise((resolve, reject) => {
+        const item = callback();
+        if (isThenable(item)) {
+            item.then(resolve, reject);
+        }
+        else {
+            resolve(item);
+        }
+    });
+}
+exports.asPromise = asPromise;
+(function () {
+    if (typeof requestIdleCallback !== 'function' || typeof cancelIdleCallback !== 'function') {
+        const dummyIdle = Object.freeze({
+            didTimeout: true,
+            timeRemaining() {
+                return 15;
+            },
+        });
+        exports.runWhenIdle = (runner) => {
+            const handle = setTimeout(() => runner(dummyIdle));
+            let disposed = false;
+            return {
+                dispose() {
+                    if (disposed) {
+                        return;
+                    }
+                    disposed = true;
+                    clearTimeout(handle);
+                },
+            };
+        };
+    }
+    else {
+        exports.runWhenIdle = (runner, timeout) => {
+            const handle = requestIdleCallback(runner, typeof timeout === 'number' ? { timeout } : undefined);
+            let disposed = false;
+            return {
+                dispose() {
+                    if (disposed) {
+                        return;
+                    }
+                    disposed = true;
+                    cancelIdleCallback(handle);
+                },
+            };
+        };
+    }
+})();
+/**
+ * An implementation of the "idle-until-urgent"-strategy as introduced
+ * here: https://philipwalton.com/articles/idle-until-urgent/
+ */
+class IdleValue {
+    constructor(executor) {
+        this._didRun = false;
+        this._executor = () => {
+            try {
+                this._value = executor();
+            }
+            catch (err) {
+                this._error = err;
+            }
+            finally {
+                this._didRun = true;
+            }
+        };
+        this._handle = (0, exports.runWhenIdle)(() => this._executor());
+    }
+    dispose() {
+        this._handle.dispose();
+    }
+    getValue() {
+        if (!this._didRun) {
+            this._handle.dispose();
+            this._executor();
+        }
+        if (this._error) {
+            throw this._error;
+        }
+        return this._value;
+    }
+}
+exports.IdleValue = IdleValue;
+function first(promiseFactories, shouldStop = (t) => !!t, defaultValue = null) {
+    let index = 0;
+    const len = promiseFactories.length;
+    const loop = () => {
+        if (index >= len) {
+            return Promise.resolve(defaultValue);
+        }
+        const factory = promiseFactories[index++];
+        const promise = Promise.resolve(factory());
+        return promise.then((result) => {
+            if (shouldStop(result)) {
+                return Promise.resolve(result);
+            }
+            return loop();
+        });
+    };
+    return loop();
+}
+exports.first = first;
+function timeout(millis, token) {
+    if (!token) {
+        return createCancelablePromise((token) => timeout(millis, token));
+    }
+    return new Promise((resolve, reject) => {
+        const handle = setTimeout(resolve, millis);
+        token.onCancellationRequested(() => {
+            clearTimeout(handle);
+            reject((0, errors_1.canceled)());
+        });
+    });
+}
+exports.timeout = timeout;
+function raceCancellation(promise, token, defaultValue) {
+    return Promise.race([
+        promise,
+        new Promise((resolve) => token.onCancellationRequested(() => resolve(defaultValue))),
+    ]);
+}
+exports.raceCancellation = raceCancellation;
+class RunOnceScheduler {
+    constructor(runner, delay) {
+        this.timeoutToken = -1;
+        this.runner = runner;
+        this.timeout = delay;
+        this.timeoutHandler = this.onTimeout.bind(this);
+    }
+    /**
+     * Dispose RunOnceScheduler
+     */
+    dispose() {
+        this.cancel();
+        this.runner = null;
+    }
+    /**
+     * Cancel current scheduled runner (if any).
+     */
+    cancel() {
+        if (this.isScheduled()) {
+            clearTimeout(this.timeoutToken);
+            this.timeoutToken = -1;
+        }
+    }
+    /**
+     * Cancel previous runner (if any) & schedule a new runner.
+     */
+    schedule(delay = this.timeout) {
+        this.cancel();
+        this.timeoutToken = setTimeout(this.timeoutHandler, delay);
+    }
+    get delay() {
+        return this.timeout;
+    }
+    set delay(value) {
+        this.timeout = value;
+    }
+    /**
+     * Returns true if scheduled.
+     */
+    isScheduled() {
+        return this.timeoutToken !== -1;
+    }
+    onTimeout() {
+        this.timeoutToken = -1;
+        if (this.runner) {
+            this.doRun();
+        }
+    }
+    doRun() {
+        if (this.runner) {
+            this.runner();
+        }
+    }
+}
+exports.RunOnceScheduler = RunOnceScheduler;
+function disposableTimeout(handler, timeout = 0) {
+    const timer = setTimeout(handler, timeout);
+    return (0, disposable_1.toDisposable)(() => clearTimeout(timer));
+}
+exports.disposableTimeout = disposableTimeout;
+//# sourceMappingURL=async.js.map

package/lib/async.js.map

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

package/lib/buffer.d.ts

@@ -0,0 +1,35 @@
+export declare class BinaryBuffer {
+    static alloc(byteLength: number): BinaryBuffer;
+    static wrap(actual: Uint8Array): BinaryBuffer;
+    /**
+     * fromString 产生的 BinaryBuffer 的 encoding 都是 utf8
+     * @param source source string
+     */
+    static fromString(source: string): BinaryBuffer;
+    static concat(buffers: BinaryBuffer[], totalLength?: number): BinaryBuffer;
+    readonly buffer: Uint8Array;
+    readonly byteLength: number;
+    private constructor();
+    /**
+     * 将 BinaryBuffer 转为字符串
+     * @param encoding 字节编码，不传默认为 utf8。需要传入 `SUPPORTED_ENCODINGS` 已有的键值。
+     */
+    toString(encoding?: string): string;
+    slice(start?: number, end?: number): BinaryBuffer;
+    set(array: BinaryBuffer | Uint8Array, offset?: number): void;
+    readUInt32BE(offset: number): number;
+    writeUInt32BE(value: number, offset: number): void;
+    readUInt32LE(offset: number): number;
+    writeUInt32LE(value: number, offset: number): void;
+    readUInt8(offset: number): number;
+    writeUInt8(value: number, offset: number): void;
+}
+export declare function readUInt16LE(source: Uint8Array, offset: number): number;
+export declare function writeUInt16LE(destination: Uint8Array, value: number, offset: number): void;
+export declare function readUInt32BE(source: Uint8Array, offset: number): number;
+export declare function writeUInt32BE(destination: Uint8Array, value: number, offset: number): void;
+export declare function readUInt32LE(source: Uint8Array, offset: number): number;
+export declare function writeUInt32LE(destination: Uint8Array, value: number, offset: number): void;
+export declare function readUInt8(source: Uint8Array, offset: number): number;
+export declare function writeUInt8(destination: Uint8Array, value: number, offset: number): void;
+//# sourceMappingURL=buffer.d.ts.map

package/lib/buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer.d.ts","sourceRoot":"","sources":["../src/buffer.ts"],"names":[],"mappings":"AAcA,qBAAa,YAAY;IACvB,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY;IAQ9C,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,YAAY;IAS7C;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IAa/C,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,YAAY;IAmB1E,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,OAAO;IAKP;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM;IAenC,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,YAAY;IAOjD,GAAG,CAAC,KAAK,EAAE,YAAY,GAAG,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAQ5D,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAIpC,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAIlD,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAIpC,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAIlD,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAIjC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAGhD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED,wBAAgB,aAAa,CAAC,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAI1F;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED,wBAAgB,aAAa,CAAC,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAQ1F;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAOvE;AAED,wBAAgB,aAAa,CAAC,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAQ1F;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,wBAAgB,UAAU,CAAC,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAEvF"}