@bitblit/ratchet-common 4.0.419-alpha → 4.0.421-alpha

package/lib/lang/number-ratchet.d.ts

@@ -0,0 +1,28 @@
+export declare class NumberRatchet {
+    private static MAX_LEADING_ZEROS_FORMAT_LENGTH;
+    static readonly DEFAULT_SAFE_NUMBER_OPTIONS: SafeNumberOptions;
+    static toFixedDecimalNumber(input: number | string, placesAfterPoint: number): number;
+    static leadingZeros(val: any, size: number): string;
+    static between(inTest: number, inP1: number, inP2: number): boolean;
+    static safeNumber(input: any, ifNotNumber?: number, useDefaultForNullAndUndefined?: boolean): number;
+    static safeNumberOpt(input: any, optionPart?: Partial<SafeNumberOptions>): number;
+    static numberCSVToList(inputCSV: string): number[];
+    static fitToWindow(val: number, b1: number, b2: number): number;
+    static groupNumbersIntoContiguousRanges(inputData: number[], minRangeSize?: number): SinglesAndRanges;
+    static distributeItemsEvenly(items: number, buckets: number): number[];
+    static createRange(minInclusive: number, maxExclusive: number, step?: number): number[];
+}
+export interface SinglesAndRanges {
+    singles: number[];
+    ranges: NumberRange[];
+}
+export interface NumberRange {
+    min: number;
+    max: number;
+}
+export interface SafeNumberOptions {
+    ifNotNumber: number;
+    returnValueForNull: number;
+    returnValueForUndefined: number;
+    preParseCharacterMapping: Record<string, string>;
+}

package/lib/lang/number-ratchet.js

@@ -0,0 +1,186 @@
+import { Logger } from '../logger/logger.js';
+import { RequireRatchet } from './require-ratchet.js';
+export class NumberRatchet {
+    static MAX_LEADING_ZEROS_FORMAT_LENGTH = 1000;
+    static DEFAULT_SAFE_NUMBER_OPTIONS = {
+        ifNotNumber: null,
+        returnValueForNull: null,
+        returnValueForUndefined: null,
+        preParseCharacterMapping: { ',': '' },
+    };
+    static toFixedDecimalNumber(input, placesAfterPoint) {
+        const v = NumberRatchet.safeNumber(input);
+        return v === null || v === undefined ? v : NumberRatchet.safeNumber(v.toFixed(placesAfterPoint));
+    }
+    static leadingZeros(val, size) {
+        const sVal = String(val);
+        if (sVal.length < size) {
+            let pad = '0000';
+            if (size > NumberRatchet.MAX_LEADING_ZEROS_FORMAT_LENGTH) {
+                throw 'Cannot format number that large (max length is ' + NumberRatchet.MAX_LEADING_ZEROS_FORMAT_LENGTH + ')';
+            }
+            while (pad.length < size) {
+                pad = pad + pad;
+            }
+            return (pad + sVal).slice(-1 * size);
+        }
+        else {
+            return sVal;
+        }
+    }
+    static between(inTest, inP1, inP2) {
+        const test = NumberRatchet.safeNumber(inTest);
+        const p1 = NumberRatchet.safeNumber(inP1);
+        const p2 = NumberRatchet.safeNumber(inP2);
+        return (test >= p1 && test <= p2) || (test >= p2 && test <= p1);
+    }
+    static safeNumber(input, ifNotNumber = null, useDefaultForNullAndUndefined) {
+        const opts = {
+            ifNotNumber: ifNotNumber,
+            returnValueForNull: useDefaultForNullAndUndefined ? ifNotNumber : null,
+            returnValueForUndefined: useDefaultForNullAndUndefined ? ifNotNumber : undefined,
+        };
+        if (useDefaultForNullAndUndefined === undefined) {
+            opts.returnValueForUndefined = null;
+        }
+        return NumberRatchet.safeNumberOpt(input, opts);
+    }
+    static safeNumberOpt(input, optionPart) {
+        let rval = undefined;
+        const opts = Object.assign({}, NumberRatchet.DEFAULT_SAFE_NUMBER_OPTIONS, optionPart || {});
+        if (input === null) {
+            rval = opts.returnValueForNull;
+        }
+        else if (input === undefined) {
+            rval = opts.returnValueForUndefined;
+        }
+        else {
+            const type = typeof input;
+            if (type == 'number') {
+                rval = input;
+            }
+            else if (type == 'string') {
+                let test = input.trim();
+                if (test.length === 0) {
+                    rval = opts.ifNotNumber;
+                }
+                else {
+                    if (opts.preParseCharacterMapping && Object.keys(opts.preParseCharacterMapping).length > 0) {
+                        let t2 = '';
+                        for (let i = 0; i < test.length; i++) {
+                            const cr = test.charAt(i);
+                            t2 += opts.preParseCharacterMapping[cr] === undefined ? cr : opts.preParseCharacterMapping[cr];
+                        }
+                        test = t2;
+                    }
+                    rval = Number.parseFloat(test);
+                }
+            }
+            else {
+                Logger.warn('Value is of type %s, returning default', type);
+                rval = opts.ifNotNumber;
+            }
+            if (isNaN(rval)) {
+                Logger.debug('Parsed string to NaN - using NaN value from param');
+                rval = opts.ifNotNumber;
+            }
+        }
+        return rval;
+    }
+    static numberCSVToList(inputCSV) {
+        let rval = null;
+        if (inputCSV) {
+            rval = inputCSV.split(',').map((s) => {
+                return NumberRatchet.safeNumber(s.trim());
+            });
+            rval = rval.filter((r) => typeof r === 'number' && !isNaN(r));
+        }
+        return rval;
+    }
+    static fitToWindow(val, b1, b2) {
+        let rval = val;
+        if (val === null || b1 === null || b2 === null || b1 < 0 || b2 < 0 || val < 0) {
+            throw new Error('All values must be non-null and larger than 0');
+        }
+        const low = Math.min(b1, b2);
+        const high = Math.max(b1, b2);
+        const windowSize = high - low;
+        if (high === low) {
+            rval = high;
+        }
+        else {
+            while (rval < low) {
+                rval += windowSize;
+            }
+            while (rval > high) {
+                rval -= windowSize;
+            }
+        }
+        return rval;
+    }
+    static groupNumbersIntoContiguousRanges(inputData, minRangeSize = 3) {
+        RequireRatchet.notNullOrUndefined(inputData);
+        const input = Object.assign([], inputData);
+        input.sort((a, b) => a - b);
+        const singles = [];
+        const ranges = [];
+        let start = 0;
+        for (let i = 1; i < input.length; i++) {
+            if (input[i] === input[i - 1] + 1) {
+            }
+            else {
+                if (start === i - 1) {
+                    singles.push(input[i - 1]);
+                }
+                else {
+                    const rangeSize = i - start;
+                    if (rangeSize < minRangeSize) {
+                        for (let j = start; j < i; j++) {
+                            singles.push(input[j]);
+                        }
+                    }
+                    else {
+                        ranges.push({
+                            min: input[start],
+                            max: input[i - 1],
+                        });
+                    }
+                }
+                start = i;
+            }
+        }
+        return {
+            singles: singles,
+            ranges: ranges,
+        };
+    }
+    static distributeItemsEvenly(items, buckets) {
+        RequireRatchet.notNullOrUndefined(items, 'items');
+        RequireRatchet.notNullOrUndefined(buckets, 'buckets');
+        RequireRatchet.true(items > 0 && items === Math.floor(items), 'Items integer larger than 0');
+        RequireRatchet.true(buckets > 0 && buckets === Math.floor(buckets), 'Buckets integer larger than 0');
+        const offset = buckets / items;
+        const rval = [];
+        for (let i = 0; i < buckets; i++) {
+            rval.push(0);
+        }
+        let loc = 0;
+        let rem = items;
+        while (rem > 0) {
+            rval[Math.floor(loc) % buckets]++;
+            rem--;
+            loc += offset;
+        }
+        return rval;
+    }
+    static createRange(minInclusive, maxExclusive, step = 1) {
+        const rval = [];
+        let val = minInclusive;
+        while (val < maxExclusive) {
+            rval.push(val);
+            val += step;
+        }
+        return rval;
+    }
+}
+//# sourceMappingURL=number-ratchet.js.map

package/lib/lang/number-ratchet.js.map

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

package/lib/lang/parsed-url.d.ts

@@ -0,0 +1,10 @@
+export interface ParsedUrl {
+    href: string;
+    protocol: string;
+    host: string;
+    hostname: string;
+    port: string;
+    pathname: string;
+    search: string;
+    hash: string;
+}

package/lib/lang/parsed-url.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=parsed-url.js.map

package/lib/lang/parsed-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsed-url.js","sourceRoot":"","sources":["../../src/lang/parsed-url.ts"],"names":[],"mappings":""}

package/lib/lang/promise-ratchet.d.ts

@@ -0,0 +1,18 @@
+import { TimeoutToken } from './timeout-token.js';
+import { LoggerLevelName } from '../logger/logger-level-name.js';
+export declare class PromiseRatchet {
+    static resolveOnEvent<T>(evtSrc: any, okEvtNames: string[], errEvtNames?: string[], rval?: T): Promise<T>;
+    static timeout<T>(srcPromise: Promise<T>, title: string, timeoutMS: number): Promise<T | TimeoutToken>;
+    static createTimeoutPromise(title: string, timeoutMS: number): Promise<TimeoutToken>;
+    static wait(time: number): Promise<void>;
+    static dumpResult(result: any): void;
+    static dumpError(err: any): void;
+    static logErrorAndReturnNull(err: any): void;
+    static runPromiseAndDump<T>(promise: Promise<T>): void;
+    static waitFor(testFunction: (n: number) => any, expectedValue: any, intervalMS: number, maxCycles: number, label?: string, count?: number): Promise<boolean>;
+    static runBoundedParallel<T>(promiseFn: (...args: any[]) => Promise<T>, params: any[][], context: any, maxConcurrent?: number, logLevel?: LoggerLevelName): Promise<T[]>;
+    static runBoundedParallelSingleParam<T>(promiseFn: (...args: any[]) => Promise<T>, params: any[], context: any, maxConcurrent?: number, logLevel?: LoggerLevelName): Promise<T[]>;
+    static asyncForEachSerial<T, R>(array: any[], callback: (val: T, idx: number, arr: T[]) => Promise<R>): Promise<void>;
+    static asyncForEachParallel<T>(array: T[], callback: (val: T, idx: number, arr: T[]) => Promise<any>): Promise<void>;
+    private constructor();
+}

package/lib/lang/promise-ratchet.js

@@ -0,0 +1,130 @@
+import { Logger } from '../logger/logger.js';
+import { ArrayRatchet } from './array-ratchet.js';
+import { TimeoutToken } from './timeout-token.js';
+import { StopWatch } from './stop-watch.js';
+import { LoggerLevelName } from '../logger/logger-level-name.js';
+export class PromiseRatchet {
+    static resolveOnEvent(evtSrc, okEvtNames, errEvtNames = [], rval = null) {
+        if (!evtSrc || !okEvtNames || okEvtNames.length === 0 || !evtSrc['on']) {
+            return Promise.reject('Cannot continue - missing source object or name, or the object is not an event source');
+        }
+        return new Promise((res, rej) => {
+            okEvtNames.forEach((e) => {
+                evtSrc.on(e, () => {
+                    res(rval);
+                });
+            });
+            if (errEvtNames) {
+                errEvtNames.forEach((e) => {
+                    evtSrc.on(e, (err) => {
+                        rej(err);
+                    });
+                });
+            }
+        });
+    }
+    static timeout(srcPromise, title, timeoutMS) {
+        return Promise.race([srcPromise, PromiseRatchet.createTimeoutPromise(title, timeoutMS)]);
+    }
+    static createTimeoutPromise(title, timeoutMS) {
+        return new Promise((resolve, reject) => {
+            const id = setTimeout(() => {
+                clearTimeout(id);
+                const rval = new TimeoutToken(title, timeoutMS);
+                resolve(rval);
+            }, timeoutMS);
+        });
+    }
+    static async wait(time) {
+        await PromiseRatchet.createTimeoutPromise('Wait ' + time, time);
+        Logger.silly('Finished wait of %d ms', time);
+    }
+    static dumpResult(result) {
+        Logger.info('Success, result was : \n\n%s\n\n', JSON.stringify(result));
+        process.exit(0);
+    }
+    static dumpError(err) {
+        Logger.warn('Failure, err was : \n\n%s\n\n  --  \n\n%s\n\n', JSON.stringify(err), String(err));
+        console.trace();
+        process.exit(1);
+    }
+    static logErrorAndReturnNull(err) {
+        Logger.warn('Failure, err was : \n\n%s\n\n  --  \n\n%s\n\n', JSON.stringify(err), String(err));
+        return null;
+    }
+    static runPromiseAndDump(promise) {
+        promise.then(PromiseRatchet.dumpResult).catch(PromiseRatchet.dumpError);
+    }
+    static async waitFor(testFunction, expectedValue, intervalMS, maxCycles, label = 'waitFor', count = 0) {
+        if (expectedValue == null || intervalMS < 50 || maxCycles < 1 || count < 0 || typeof testFunction != 'function') {
+            Logger.warn('%s: Invalid configuration for waitFor - exiting immediately', label);
+            Logger.warn('ExpectedValue : %s ; interval: %d ; maxCycles: %d ; test : %s', expectedValue, intervalMS, maxCycles, typeof testFunction);
+            return false;
+        }
+        let curVal = null;
+        try {
+            curVal = testFunction(count);
+        }
+        catch (err) {
+            Logger.warn('%s: Caught error while waiting, giving up : %s', label, err);
+            return false;
+        }
+        if (curVal === null) {
+            Logger.debug('%s:CurVal was null - aborting', label);
+            return false;
+        }
+        else if (curVal == expectedValue) {
+            Logger.debug('%s:Found expected value', label);
+            return true;
+        }
+        else if (count > maxCycles) {
+            Logger.debug('%s:Exceeded max cycles, giving up', label);
+            return false;
+        }
+        else {
+            Logger.debug('%s : value not reached yet, waiting (count = %d of %d)', label, count, maxCycles);
+            await PromiseRatchet.wait(intervalMS);
+            return PromiseRatchet.waitFor(testFunction, expectedValue, intervalMS, maxCycles, label, count + 1);
+        }
+    }
+    static async runBoundedParallel(promiseFn, params, context, maxConcurrent = 1, logLevel = LoggerLevelName.debug) {
+        const sw = new StopWatch();
+        let rval = [];
+        let remain = params;
+        Logger.logByLevel(logLevel, 'Processing %d total elements %d at a time', params.length, maxConcurrent);
+        const ctx = context || this;
+        let processed = 0;
+        const totalCount = remain.length;
+        while (remain.length > 0) {
+            const curBatch = remain.slice(0, Math.min(remain.length, maxConcurrent));
+            remain = remain.slice(curBatch.length);
+            const proms = curBatch.map((c) => promiseFn.apply(ctx, c));
+            const output = await Promise.all(proms);
+            processed += proms.length;
+            rval = rval.concat(output);
+            const pct = processed / totalCount;
+            Logger.logByLevel(logLevel, '%d elements remain : %s', remain.length, sw.dumpExpected(pct));
+        }
+        sw.log();
+        return rval;
+    }
+    static async runBoundedParallelSingleParam(promiseFn, params, context, maxConcurrent = 1, logLevel = LoggerLevelName.debug) {
+        const wrappedParams = ArrayRatchet.wrapElementsInArray(params);
+        return PromiseRatchet.runBoundedParallel(promiseFn, wrappedParams, context, maxConcurrent, logLevel);
+    }
+    static async asyncForEachSerial(array, callback) {
+        for (let index = 0; index < array.length; index++) {
+            await callback(array[index], index, array);
+        }
+    }
+    static async asyncForEachParallel(array, callback) {
+        const proms = [];
+        for (let index = 0; index < array.length; index++) {
+            proms.push(callback(array[index], index, array));
+        }
+        await Promise.all(proms);
+    }
+    constructor() {
+    }
+}
+//# sourceMappingURL=promise-ratchet.js.map

package/lib/lang/promise-ratchet.js.map

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

package/lib/lang/require-ratchet.d.ts

@@ -0,0 +1,11 @@
+export declare class RequireRatchet {
+    static isNullOrUndefined(ob: any): boolean;
+    static notNullOrUndefined(ob: any, name?: string): void;
+    static notNullUndefinedOrOnlyWhitespaceString(ob: string, name?: string): void;
+    static notNullUndefinedOrEmptyArray(ob: any[], name?: string): void;
+    static equal(ob1: any, ob2: any, message?: string): void;
+    static true(ob: boolean, message?: string): void;
+    static noNullOrUndefinedValuesInArray(arr: any[], expectedLength?: number, customMsg?: string): void;
+    static noNullOrUndefinedValuesInRestArgs(expectedLength: number, ...restArgs: any[]): void;
+    static constructorArgumentsMatchLengthAndAreNonNull(): void;
+}

package/lib/lang/require-ratchet.js

@@ -0,0 +1,56 @@
+export class RequireRatchet {
+    static isNullOrUndefined(ob) {
+        return Object.is(ob, null) || Object.is(ob, undefined);
+    }
+    static notNullOrUndefined(ob, name = 'object') {
+        if (RequireRatchet.isNullOrUndefined(ob)) {
+            throw new Error(name + ' may not be null or undefined');
+        }
+    }
+    static notNullUndefinedOrOnlyWhitespaceString(ob, name = 'string') {
+        if (RequireRatchet.isNullOrUndefined(ob) || ob.trim() === '') {
+            throw new Error(name + ' may not be null or undefined or only whitespace string');
+        }
+    }
+    static notNullUndefinedOrEmptyArray(ob, name = 'string') {
+        if (RequireRatchet.isNullOrUndefined(ob) || ob.length === 0) {
+            throw new Error(name + ' may not be null or undefined or an empty array');
+        }
+    }
+    static equal(ob1, ob2, message = 'Values must be equal') {
+        if (ob1 !== ob2) {
+            throw new Error(message);
+        }
+    }
+    static true(ob, message = 'Value must be true') {
+        RequireRatchet.equal(ob, true, message);
+    }
+    static noNullOrUndefinedValuesInArray(arr, expectedLength = null, customMsg = null) {
+        RequireRatchet.notNullOrUndefined(arr, 'Source array may not be null');
+        if (expectedLength !== null && arr.length !== expectedLength) {
+            throw new Error(`Expected array of length ${expectedLength} but was ${arr.length} ${customMsg}`);
+        }
+        for (let i = 0; i < arr.length; i++) {
+            if (RequireRatchet.isNullOrUndefined(arr[i])) {
+                throw new Error(`Array index ${i} was null or undefined ${customMsg}`);
+            }
+        }
+    }
+    static noNullOrUndefinedValuesInRestArgs(expectedLength, ...restArgs) {
+        RequireRatchet.notNullOrUndefined(restArgs, 'Source array may not be null');
+        if (expectedLength !== null && restArgs.length !== expectedLength) {
+            throw new Error(`Expected array of length ${expectedLength} but was ${restArgs.length}`);
+        }
+        for (let i = 0; i < restArgs.length; i++) {
+            if (RequireRatchet.isNullOrUndefined(restArgs[i])) {
+                throw new Error(`Array index ${i} was null or undefined`);
+            }
+        }
+    }
+    static constructorArgumentsMatchLengthAndAreNonNull() {
+        const args = Array.from(arguments);
+        const len = this.constructor.length;
+        return RequireRatchet.noNullOrUndefinedValuesInArray(args, len);
+    }
+}
+//# sourceMappingURL=require-ratchet.js.map

package/lib/lang/require-ratchet.js.map

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

package/lib/lang/sort-ratchet.d.ts

@@ -0,0 +1,7 @@
+export declare class SortRatchet {
+    private constructor();
+    static sortNullToTop<T>(a: T, b: T, bothNonNullSort: (c: T, d: T) => number): number;
+    static sortNullToBottom<T>(a: T, b: T, bothNonNullSort: (c: T, d: T) => number): number;
+    static nullSafeSort<T>(a: T, b: T, nullsOnTop: boolean, bothNonNullSort: (c: T, d: T) => number): number;
+    static sortNumericStringsAsNumbers(a: string | number, b: string | number, sortNonNumbersToTop?: boolean): number;
+}

package/lib/lang/sort-ratchet.js

@@ -0,0 +1,33 @@
+import { RequireRatchet } from './require-ratchet.js';
+import { NumberRatchet } from './number-ratchet.js';
+export class SortRatchet {
+    constructor() { }
+    static sortNullToTop(a, b, bothNonNullSort) {
+        return SortRatchet.nullSafeSort(a, b, true, bothNonNullSort);
+    }
+    static sortNullToBottom(a, b, bothNonNullSort) {
+        return SortRatchet.nullSafeSort(a, b, false, bothNonNullSort);
+    }
+    static nullSafeSort(a, b, nullsOnTop, bothNonNullSort) {
+        let rval;
+        if (RequireRatchet.isNullOrUndefined(a) && RequireRatchet.isNullOrUndefined(b)) {
+            rval = 0;
+        }
+        else if (RequireRatchet.isNullOrUndefined(a)) {
+            rval = nullsOnTop ? -Infinity : Infinity;
+        }
+        else if (RequireRatchet.isNullOrUndefined(b)) {
+            rval = nullsOnTop ? Infinity : -Infinity;
+        }
+        else {
+            rval = bothNonNullSort(a, b);
+        }
+        return rval;
+    }
+    static sortNumericStringsAsNumbers(a, b, sortNonNumbersToTop) {
+        const an = NumberRatchet.safeNumber(a);
+        const bn = NumberRatchet.safeNumber(b);
+        return SortRatchet.nullSafeSort(an, bn, sortNonNumbersToTop, (ax, bx) => ax - bx);
+    }
+}
+//# sourceMappingURL=sort-ratchet.js.map

package/lib/lang/sort-ratchet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort-ratchet.js","sourceRoot":"","sources":["../../src/lang/sort-ratchet.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,OAAO,WAAW;IAGtB,gBAAuB,CAAC;IAEjB,MAAM,CAAC,aAAa,CAAI,CAAI,EAAE,CAAI,EAAE,eAAuC;QAChF,OAAO,WAAW,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC;IAC/D,CAAC;IAEM,MAAM,CAAC,gBAAgB,CAAI,CAAI,EAAE,CAAI,EAAE,eAAuC;QACnF,OAAO,WAAW,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC;IAChE,CAAC;IAEM,MAAM,CAAC,YAAY,CAAI,CAAI,EAAE,CAAI,EAAE,UAAmB,EAAE,eAAuC;QACpG,IAAI,IAAY,CAAC;QAEjB,IAAI,cAAc,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,cAAc,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/E,IAAI,GAAG,CAAC,CAAC;QACX,CAAC;aAAM,IAAI,cAAc,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/C,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC3C,CAAC;aAAM,IAAI,cAAc,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/C,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,IAAI,GAAG,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC/B,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,MAAM,CAAC,2BAA2B,CAAC,CAAkB,EAAE,CAAkB,EAAE,mBAA6B;QAC7G,MAAM,EAAE,GAAW,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC/C,MAAM,EAAE,GAAW,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC/C,OAAO,WAAW,CAAC,YAAY,CAAS,EAAE,EAAE,EAAE,EAAE,mBAAmB,EAAE,CAAC,EAAU,EAAE,EAAU,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IAC5G,CAAC;CACF"}

package/lib/lang/stop-watch.d.ts

@@ -0,0 +1,27 @@
+import { LoggerLevelName } from '../logger/logger-level-name.js';
+export declare class StopWatch {
+    get createTime(): number;
+    private starts;
+    private ends;
+    private _createTime;
+    private _label;
+    private _labelIncludedInOutput;
+    withLabel(val: string): StopWatch;
+    withLabelIncludedInOutput(val: boolean): StopWatch;
+    get label(): string;
+    set label(value: string);
+    get labelIncludedInOutput(): boolean;
+    set labelIncludedInOutput(value: boolean);
+    start(name: string): number;
+    stop(name: string): number;
+    reset(name: string): void;
+    hasTimer(name: string): boolean;
+    log(name?: string, shortForm?: boolean, logLevel?: LoggerLevelName): void;
+    logExpected(pctComplete: number, name?: string, shortForm?: boolean, logLevel?: LoggerLevelName): void;
+    timerNames(): string[];
+    dumpAll(separator?: string, shortForm?: boolean): string;
+    dump(name?: string, shortForm?: boolean): string;
+    dumpExpected(pctComplete: number, name?: string, shortForm?: boolean): string;
+    expectedRemainingMS(pctComplete: number, name?: string): number;
+    elapsedMS(name?: string): number;
+}