@itwin/core-bentley 4.0.0-dev.52 → 4.0.0-dev.55

package/lib/esm/TypedArrayBuilder.js

@@ -1,199 +1,199 @@
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module Collections
- */
-import { assert } from "./Assert";
-/** Incrementally builds a [TypedArray](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray) of unsigned 8-, 16-, or 32-bit integers.
- * Sometimes you wish to populate a `TypedArray`, but you don't know how many elements you will need.
- * `TypedArray` requires you to specify the size upon construction, and does not permit you to change the size later.
- *
- * `TypedArrayBuilder` manages a `TypedArray`, permitting you to [[push]] and [[append]] elements to it. It exposes two "size" properties":
- *  - [[capacity]], the number of elements it has currently allocated space for - i.e., the length of the underlying TypedArray; and
- *  - [[length]], the number of elements that have so far been added to it, which is never bigger than [[capacity]].
- * When [[capacity]] is exceeded, a new, bigger TypedArray is allocated and the contents of the previous array are copied over to it.
- *
- * Once you've finished adding elements, you can obtain the finished `TypedArray` via [[toTypedArray]].
- * @see [[Uint8ArrayBuilder]], [[Uint16ArrayBuilder]], and [[Uint32ArrayBuilder]] to build specific types of arrays.
- * @see [[UintArrayBuilder]] when you don't know the maximum number of bytes required for each element in the array.
- * @public
- */
-export class TypedArrayBuilder {
-    /** Constructs a new builder from the specified options, with a [[length]] of zero. */
-    constructor(constructor, options) {
-        this._constructor = constructor;
-        this._data = new constructor(options?.initialCapacity ?? 0);
-        this.growthFactor = Math.max(1.0, options?.growthFactor ?? 1.5);
-        this._length = 0;
-    }
-    /** The number of elements currently in the array. */
-    get length() {
-        return this._length;
-    }
-    /** The number of elements that can fit into the memory currently allocated for the array. */
-    get capacity() {
-        return this._data.length;
-    }
-    /** Like [TypedArray.at](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray/at),
-     * returns the element at the specified index, with negative integers counting back from the end of the array.
-     * @note It is your responsibility to ensure the index falls within the bounds of the array.
-     */
-    at(index) {
-        if (index < 0)
-            index = this.length - index;
-        const value = this._data[index];
-        assert(value !== undefined, "index out of bounds");
-        return value;
-    }
-    /** Ensure that [[capacity]] is at least equal to `newCapacity`.
-     * This is used internally by methods like [[push]] and [[append]] to ensure the array has room for the element(s) to be added.
-     * It can also be useful when you know you intend to add some number of additional elements, to minimize reallocations.
-     *
-     * If `newCapacity` is not greater than the current [[capacity]], this function does nothing.
-     * Otherwise, it allocates a new `TypedArray` with room for `newCapacity * growthFactor` elements, and copies the contents of the previous `TypedArray` into it.
-     * [[length]] remains unchanged; [[capacity]] reflects the size of the new TypeArray.
-     */
-    ensureCapacity(newCapacity) {
-        if (this.capacity >= newCapacity)
-            return this.capacity;
-        assert(this.growthFactor >= 1.0);
-        newCapacity = Math.ceil(newCapacity * this.growthFactor);
-        const prevData = this._data;
-        this._data = new this._constructor(newCapacity);
-        this._data.set(prevData, 0);
-        assert(this.capacity === newCapacity);
-        return this.capacity;
-    }
-    /** Append the specified value, resizing if necessary. */
-    push(value) {
-        this.ensureCapacity(this.length + 1);
-        this._data[this.length] = value;
-        ++this._length;
-    }
-    /** Append an array of values, resizing (at most once) if necessary. */
-    append(values) {
-        const newLength = this.length + values.length;
-        this.ensureCapacity(newLength);
-        this._data.set(values, this.length);
-        this._length = newLength;
-    }
-    /** Obtain the finished array.
-     * @param includeUnusedCapacity If true, the length of the returned array will be equal to [[capacity]], with extra bytes initialized to zero; otherwise, the
-     * returned array's length will be equal to [[length]].
-     */
-    toTypedArray(includeUnusedCapacity = false) {
-        if (includeUnusedCapacity)
-            return this._data;
-        const subarray = this._data.subarray(0, this.length);
-        assert(subarray instanceof this._constructor);
-        assert(subarray.buffer === this._data.buffer);
-        return subarray;
-    }
-}
-/** A [[TypedArrayBuilder]] for producing a [Uint8Array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array).
- * @public
- */
-export class Uint8ArrayBuilder extends TypedArrayBuilder {
-    /** See [[TypedArrayBuilder]] constructor. */
-    constructor(options) {
-        super(Uint8Array, options);
-    }
-}
-/** A [[TypedArrayBuilder]] for producing a [Uint16Array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint16Array).
- * @public
- */
-export class Uint16ArrayBuilder extends TypedArrayBuilder {
-    /** See [[TypedArrayBuilder]] constructor. */
-    constructor(options) {
-        super(Uint16Array, options);
-    }
-}
-/** A [[TypedArrayBuilder]] for producing a [Uint32Array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint32Array).
- * @public
- */
-export class Uint32ArrayBuilder extends TypedArrayBuilder {
-    /** See [[TypedArrayBuilder]] constructor. */
-    constructor(options) {
-        super(Uint32Array, options);
-    }
-    /** Obtain a view of the finished array as an array of bytes. */
-    toUint8Array(includeUnusedCapacity = false) {
-        if (includeUnusedCapacity)
-            return new Uint8Array(this._data.buffer);
-        return new Uint8Array(this._data.buffer, 0, this.length * 4);
-    }
-}
-/** A [[TypedArrayBuilder]] that can populate a [[UintArray]] with the minimum
- * [bytes per element](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray/BYTES_PER_ELEMENT) required.
- *
- * By default, the underlying array is a `Uint8Array`, though this can be configured via [[UintArrayBuilderOptions.initialType]].
- * As values are added to the array, if the bytes per element supported by the underlying array is too small to hold one of the new values, the array is
- * reallocated to a type large enough to hold all of the new values. For example, the following produces a `Uint8Array` because all values are less than 256:
- *
- * ```ts
- *  const builder = new UintArrayBuilder();
- *  builder.append([1, 2, 254, 255]);
- *  const array = builder.toTypedArray();
- *  assert(array instanceof Uint8Array);
- * ```
- *
- * However, the following produces a `Uint16Array` because one of the values is larger than 255 but none are larger than 65,535:
- *
- * ```ts
- *  const builder = new UintArrayBuilder();
- *  builder.append([1, 255, 257, 65535]);
- *  const array = builder.toTypedArray();
- *  assert(array instanceof Uint16Array);
- * ```
- *
- * @see [[Uint8ArrayBuilder]], [[Uint16ArrayBuilder]], or [[Uint32ArrayBuilder]] if you know the number of bytes you want to allocate for each element in the array.
- * @public
- */
-export class UintArrayBuilder extends TypedArrayBuilder {
-    constructor(options) {
-        super(options?.initialType ?? Uint8Array, options);
-    }
-    /** The number of bytes (1, 2, or 4) currently allocated per element by the underlying array.
-     * This may change as larger values are added to the array.
-     */
-    get bytesPerElement() {
-        return this._data.BYTES_PER_ELEMENT;
-    }
-    /** Ensures that the underlying array is of a type that can contain the largest value in `newValues`.
-     * For example, if `_data` is a `Uint16Array` and `newValues` contains any value(s) larger than 65,535, it will be replaced with a `Uint32Array`.
-     * This method is invoked by [[push]] and [[append]].
-     */
-    ensureBytesPerElement(newValues) {
-        const curBytesPerElem = this.bytesPerElement;
-        assert(curBytesPerElem === 1 || curBytesPerElem === 2 || curBytesPerElem === 4);
-        if (curBytesPerElem >= 4)
-            return;
-        let neededBytesPerElem = curBytesPerElem;
-        for (const value of newValues) {
-            if (value > 0xffff) {
-                neededBytesPerElem = 4;
-                break;
-            }
-            else if (value > 0xff) {
-                neededBytesPerElem = 2;
-            }
-        }
-        if (neededBytesPerElem <= curBytesPerElem)
-            return;
-        this._constructor = neededBytesPerElem === 1 ? Uint8Array : (neededBytesPerElem === 2 ? Uint16Array : Uint32Array);
-        this._data = new this._constructor(this._data);
-    }
-    /** See [[TypedArrayBuilder.push]]. */
-    push(value) {
-        this.ensureBytesPerElement([value]);
-        super.push(value);
-    }
-    /** See [[TypedArrayBuilder.append]]. */
-    append(values) {
-        this.ensureBytesPerElement(values);
-        super.append(values);
-    }
-}
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Collections
+ */
+import { assert } from "./Assert";
+/** Incrementally builds a [TypedArray](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray) of unsigned 8-, 16-, or 32-bit integers.
+ * Sometimes you wish to populate a `TypedArray`, but you don't know how many elements you will need.
+ * `TypedArray` requires you to specify the size upon construction, and does not permit you to change the size later.
+ *
+ * `TypedArrayBuilder` manages a `TypedArray`, permitting you to [[push]] and [[append]] elements to it. It exposes two "size" properties":
+ *  - [[capacity]], the number of elements it has currently allocated space for - i.e., the length of the underlying TypedArray; and
+ *  - [[length]], the number of elements that have so far been added to it, which is never bigger than [[capacity]].
+ * When [[capacity]] is exceeded, a new, bigger TypedArray is allocated and the contents of the previous array are copied over to it.
+ *
+ * Once you've finished adding elements, you can obtain the finished `TypedArray` via [[toTypedArray]].
+ * @see [[Uint8ArrayBuilder]], [[Uint16ArrayBuilder]], and [[Uint32ArrayBuilder]] to build specific types of arrays.
+ * @see [[UintArrayBuilder]] when you don't know the maximum number of bytes required for each element in the array.
+ * @public
+ */
+export class TypedArrayBuilder {
+    /** Constructs a new builder from the specified options, with a [[length]] of zero. */
+    constructor(constructor, options) {
+        this._constructor = constructor;
+        this._data = new constructor(options?.initialCapacity ?? 0);
+        this.growthFactor = Math.max(1.0, options?.growthFactor ?? 1.5);
+        this._length = 0;
+    }
+    /** The number of elements currently in the array. */
+    get length() {
+        return this._length;
+    }
+    /** The number of elements that can fit into the memory currently allocated for the array. */
+    get capacity() {
+        return this._data.length;
+    }
+    /** Like [TypedArray.at](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray/at),
+     * returns the element at the specified index, with negative integers counting back from the end of the array.
+     * @note It is your responsibility to ensure the index falls within the bounds of the array.
+     */
+    at(index) {
+        if (index < 0)
+            index = this.length - index;
+        const value = this._data[index];
+        assert(value !== undefined, "index out of bounds");
+        return value;
+    }
+    /** Ensure that [[capacity]] is at least equal to `newCapacity`.
+     * This is used internally by methods like [[push]] and [[append]] to ensure the array has room for the element(s) to be added.
+     * It can also be useful when you know you intend to add some number of additional elements, to minimize reallocations.
+     *
+     * If `newCapacity` is not greater than the current [[capacity]], this function does nothing.
+     * Otherwise, it allocates a new `TypedArray` with room for `newCapacity * growthFactor` elements, and copies the contents of the previous `TypedArray` into it.
+     * [[length]] remains unchanged; [[capacity]] reflects the size of the new TypeArray.
+     */
+    ensureCapacity(newCapacity) {
+        if (this.capacity >= newCapacity)
+            return this.capacity;
+        assert(this.growthFactor >= 1.0);
+        newCapacity = Math.ceil(newCapacity * this.growthFactor);
+        const prevData = this._data;
+        this._data = new this._constructor(newCapacity);
+        this._data.set(prevData, 0);
+        assert(this.capacity === newCapacity);
+        return this.capacity;
+    }
+    /** Append the specified value, resizing if necessary. */
+    push(value) {
+        this.ensureCapacity(this.length + 1);
+        this._data[this.length] = value;
+        ++this._length;
+    }
+    /** Append an array of values, resizing (at most once) if necessary. */
+    append(values) {
+        const newLength = this.length + values.length;
+        this.ensureCapacity(newLength);
+        this._data.set(values, this.length);
+        this._length = newLength;
+    }
+    /** Obtain the finished array.
+     * @param includeUnusedCapacity If true, the length of the returned array will be equal to [[capacity]], with extra bytes initialized to zero; otherwise, the
+     * returned array's length will be equal to [[length]].
+     */
+    toTypedArray(includeUnusedCapacity = false) {
+        if (includeUnusedCapacity)
+            return this._data;
+        const subarray = this._data.subarray(0, this.length);
+        assert(subarray instanceof this._constructor);
+        assert(subarray.buffer === this._data.buffer);
+        return subarray;
+    }
+}
+/** A [[TypedArrayBuilder]] for producing a [Uint8Array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array).
+ * @public
+ */
+export class Uint8ArrayBuilder extends TypedArrayBuilder {
+    /** See [[TypedArrayBuilder]] constructor. */
+    constructor(options) {
+        super(Uint8Array, options);
+    }
+}
+/** A [[TypedArrayBuilder]] for producing a [Uint16Array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint16Array).
+ * @public
+ */
+export class Uint16ArrayBuilder extends TypedArrayBuilder {
+    /** See [[TypedArrayBuilder]] constructor. */
+    constructor(options) {
+        super(Uint16Array, options);
+    }
+}
+/** A [[TypedArrayBuilder]] for producing a [Uint32Array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint32Array).
+ * @public
+ */
+export class Uint32ArrayBuilder extends TypedArrayBuilder {
+    /** See [[TypedArrayBuilder]] constructor. */
+    constructor(options) {
+        super(Uint32Array, options);
+    }
+    /** Obtain a view of the finished array as an array of bytes. */
+    toUint8Array(includeUnusedCapacity = false) {
+        if (includeUnusedCapacity)
+            return new Uint8Array(this._data.buffer);
+        return new Uint8Array(this._data.buffer, 0, this.length * 4);
+    }
+}
+/** A [[TypedArrayBuilder]] that can populate a [[UintArray]] with the minimum
+ * [bytes per element](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray/BYTES_PER_ELEMENT) required.
+ *
+ * By default, the underlying array is a `Uint8Array`, though this can be configured via [[UintArrayBuilderOptions.initialType]].
+ * As values are added to the array, if the bytes per element supported by the underlying array is too small to hold one of the new values, the array is
+ * reallocated to a type large enough to hold all of the new values. For example, the following produces a `Uint8Array` because all values are less than 256:
+ *
+ * ```ts
+ *  const builder = new UintArrayBuilder();
+ *  builder.append([1, 2, 254, 255]);
+ *  const array = builder.toTypedArray();
+ *  assert(array instanceof Uint8Array);
+ * ```
+ *
+ * However, the following produces a `Uint16Array` because one of the values is larger than 255 but none are larger than 65,535:
+ *
+ * ```ts
+ *  const builder = new UintArrayBuilder();
+ *  builder.append([1, 255, 257, 65535]);
+ *  const array = builder.toTypedArray();
+ *  assert(array instanceof Uint16Array);
+ * ```
+ *
+ * @see [[Uint8ArrayBuilder]], [[Uint16ArrayBuilder]], or [[Uint32ArrayBuilder]] if you know the number of bytes you want to allocate for each element in the array.
+ * @public
+ */
+export class UintArrayBuilder extends TypedArrayBuilder {
+    constructor(options) {
+        super(options?.initialType ?? Uint8Array, options);
+    }
+    /** The number of bytes (1, 2, or 4) currently allocated per element by the underlying array.
+     * This may change as larger values are added to the array.
+     */
+    get bytesPerElement() {
+        return this._data.BYTES_PER_ELEMENT;
+    }
+    /** Ensures that the underlying array is of a type that can contain the largest value in `newValues`.
+     * For example, if `_data` is a `Uint16Array` and `newValues` contains any value(s) larger than 65,535, it will be replaced with a `Uint32Array`.
+     * This method is invoked by [[push]] and [[append]].
+     */
+    ensureBytesPerElement(newValues) {
+        const curBytesPerElem = this.bytesPerElement;
+        assert(curBytesPerElem === 1 || curBytesPerElem === 2 || curBytesPerElem === 4);
+        if (curBytesPerElem >= 4)
+            return;
+        let neededBytesPerElem = curBytesPerElem;
+        for (const value of newValues) {
+            if (value > 0xffff) {
+                neededBytesPerElem = 4;
+                break;
+            }
+            else if (value > 0xff) {
+                neededBytesPerElem = 2;
+            }
+        }
+        if (neededBytesPerElem <= curBytesPerElem)
+            return;
+        this._constructor = neededBytesPerElem === 1 ? Uint8Array : (neededBytesPerElem === 2 ? Uint16Array : Uint32Array);
+        this._data = new this._constructor(this._data);
+    }
+    /** See [[TypedArrayBuilder.push]]. */
+    push(value) {
+        this.ensureBytesPerElement([value]);
+        super.push(value);
+    }
+    /** See [[TypedArrayBuilder.append]]. */
+    append(values) {
+        this.ensureBytesPerElement(values);
+        super.append(values);
+    }
+}
 //# sourceMappingURL=TypedArrayBuilder.js.map

package/lib/esm/UnexpectedErrors.d.ts

@@ -1,44 +1,44 @@
-/** @packageDocumentation
- * @module Errors
- */
-/// <reference types="node" />
-/** A function to be notified when an unexpected error happens
- * @public
- */
-export declare type OnUnexpectedError = (error: any) => void;
-/**
- * Utility for handling/reporting unexpected runtime errors. This class establishes a global handler for
- * unexpected errors, and programmers should use its `handle` method when they occur. Generally, unexpected
- * errors should not cause program termination, and should instead be logged and swallowed. However, for
- * development/debugging, it can be helpful to re-throw exceptions so they are not missed.
- * @public
- */
-export declare class UnexpectedErrors {
-    /** handler for re-throwing exceptions directly */
-    static readonly reThrowImmediate: (e: any) => never;
-    /** handler for re-throwing exceptions from an asynchronous interval (so the current call stack is not aborted) */
-    static readonly reThrowDeferred: (e: any) => NodeJS.Timeout;
-    /** handler for logging exception to console */
-    static readonly consoleLog: (e: any) => void;
-    /** handler for logging exception with [[Logger]] */
-    static readonly errorLog: (e: any) => void;
-    private static _telemetry;
-    private static _handler;
-    private constructor();
-    /** Add a "telemetry tracker" for unexpected errors. Useful for tracking/reporting errors without changing handler.
-     * @returns a method to remove the tracker
-     */
-    static addTelemetry(tracker: OnUnexpectedError): () => void;
-    /** call this method when an unexpected error happens so the global handler can process it.
-     * @param error the unexpected error
-     * @param notifyTelemetry if false, don't notify telemetry trackers. Use this for exceptions from third-party code, for example.
-     */
-    static handle(error: any, notifyTelemetry?: boolean): void;
-    /** establish a new global *unexpected error* handler.
-     * @param handler the new global handler. You may provide your own function or use one of the static members of this class.
-     * The default is [[errorLog]].
-     * @returns the previous handler. Useful to temporarily change the handler.
-     */
-    static setHandler(handler: OnUnexpectedError): OnUnexpectedError;
-}
+/** @packageDocumentation
+ * @module Errors
+ */
+/// <reference types="node" />
+/** A function to be notified when an unexpected error happens
+ * @public
+ */
+export type OnUnexpectedError = (error: any) => void;
+/**
+ * Utility for handling/reporting unexpected runtime errors. This class establishes a global handler for
+ * unexpected errors, and programmers should use its `handle` method when they occur. Generally, unexpected
+ * errors should not cause program termination, and should instead be logged and swallowed. However, for
+ * development/debugging, it can be helpful to re-throw exceptions so they are not missed.
+ * @public
+ */
+export declare class UnexpectedErrors {
+    /** handler for re-throwing exceptions directly */
+    static readonly reThrowImmediate: (e: any) => never;
+    /** handler for re-throwing exceptions from an asynchronous interval (so the current call stack is not aborted) */
+    static readonly reThrowDeferred: (e: any) => NodeJS.Timeout;
+    /** handler for logging exception to console */
+    static readonly consoleLog: (e: any) => void;
+    /** handler for logging exception with [[Logger]] */
+    static readonly errorLog: (e: any) => void;
+    private static _telemetry;
+    private static _handler;
+    private constructor();
+    /** Add a "telemetry tracker" for unexpected errors. Useful for tracking/reporting errors without changing handler.
+     * @returns a method to remove the tracker
+     */
+    static addTelemetry(tracker: OnUnexpectedError): () => void;
+    /** call this method when an unexpected error happens so the global handler can process it.
+     * @param error the unexpected error
+     * @param notifyTelemetry if false, don't notify telemetry trackers. Use this for exceptions from third-party code, for example.
+     */
+    static handle(error: any, notifyTelemetry?: boolean): void;
+    /** establish a new global *unexpected error* handler.
+     * @param handler the new global handler. You may provide your own function or use one of the static members of this class.
+     * The default is [[errorLog]].
+     * @returns the previous handler. Useful to temporarily change the handler.
+     */
+    static setHandler(handler: OnUnexpectedError): OnUnexpectedError;
+}
 //# sourceMappingURL=UnexpectedErrors.d.ts.map

package/lib/esm/UnexpectedErrors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UnexpectedErrors.d.ts","sourceRoot":"","sources":["../../src/UnexpectedErrors.ts"],"names":[],"mappings":"AAIA;;GAEG;;AAIH;;GAEG;AACH,oBAAY,iBAAiB,GAAG,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;AAErD;;;;;;GAMG;AACH,qBAAa,gBAAgB;IAC3B,kDAAkD;IAClD,gBAAuB,gBAAgB,MAAO,GAAG,WAAkB;IACnE,kHAAkH;IAClH,gBAAuB,eAAe,MAAO,GAAG,oBAAuC;IACvF,+CAA+C;IAC/C,gBAAuB,UAAU,MAAO,GAAG,UAAsB;IACjE,oDAAoD;IACpD,gBAAuB,QAAQ,MAAO,GAAG,UAAyC;IAElF,OAAO,CAAC,MAAM,CAAC,UAAU,CAA2B;IACpD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiB;IACxC,OAAO;IAEP;;OAEG;WACW,YAAY,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,IAAI;IAKlE;;;OAGG;WACW,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,eAAe,UAAO,GAAG,IAAI;IAa9D;;;;OAIG;WACW,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,iBAAiB;CAKxE"}
+{"version":3,"file":"UnexpectedErrors.d.ts","sourceRoot":"","sources":["../../src/UnexpectedErrors.ts"],"names":[],"mappings":"AAIA;;GAEG;;AAIH;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;AAErD;;;;;;GAMG;AACH,qBAAa,gBAAgB;IAC3B,kDAAkD;IAClD,gBAAuB,gBAAgB,MAAO,GAAG,WAAkB;IACnE,kHAAkH;IAClH,gBAAuB,eAAe,MAAO,GAAG,oBAAuC;IACvF,+CAA+C;IAC/C,gBAAuB,UAAU,MAAO,GAAG,UAAsB;IACjE,oDAAoD;IACpD,gBAAuB,QAAQ,MAAO,GAAG,UAAyC;IAElF,OAAO,CAAC,MAAM,CAAC,UAAU,CAA2B;IACpD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiB;IACxC,OAAO;IAEP;;OAEG;WACW,YAAY,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,IAAI;IAKlE;;;OAGG;WACW,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,eAAe,UAAO,GAAG,IAAI;IAa9D;;;;OAIG;WACW,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,iBAAiB;CAKxE"}

package/lib/esm/UnexpectedErrors.js

@@ -1,65 +1,66 @@
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module Errors
- */
-var _a;
-import { Logger } from "./Logger";
-/**
- * Utility for handling/reporting unexpected runtime errors. This class establishes a global handler for
- * unexpected errors, and programmers should use its `handle` method when they occur. Generally, unexpected
- * errors should not cause program termination, and should instead be logged and swallowed. However, for
- * development/debugging, it can be helpful to re-throw exceptions so they are not missed.
- * @public
- */
-export class UnexpectedErrors {
-    constructor() { } // this is a singleton
-    /** Add a "telemetry tracker" for unexpected errors. Useful for tracking/reporting errors without changing handler.
-     * @returns a method to remove the tracker
-     */
-    static addTelemetry(tracker) {
-        this._telemetry.push(tracker);
-        return () => this._telemetry.splice(this._telemetry.indexOf(tracker), 1);
-    }
-    /** call this method when an unexpected error happens so the global handler can process it.
-     * @param error the unexpected error
-     * @param notifyTelemetry if false, don't notify telemetry trackers. Use this for exceptions from third-party code, for example.
-     */
-    static handle(error, notifyTelemetry = true) {
-        this._handler(error);
-        if (notifyTelemetry) {
-            this._telemetry.forEach((telemetry) => {
-                try {
-                    telemetry(error);
-                }
-                catch (_) {
-                    // ignore errors from telemetry trackers
-                }
-            });
-        }
-    }
-    /** establish a new global *unexpected error* handler.
-     * @param handler the new global handler. You may provide your own function or use one of the static members of this class.
-     * The default is [[errorLog]].
-     * @returns the previous handler. Useful to temporarily change the handler.
-     */
-    static setHandler(handler) {
-        const oldHandler = this._handler;
-        this._handler = handler;
-        return oldHandler;
-    }
-}
-_a = UnexpectedErrors;
-/** handler for re-throwing exceptions directly */
-UnexpectedErrors.reThrowImmediate = (e) => { throw e; };
-/** handler for re-throwing exceptions from an asynchronous interval (so the current call stack is not aborted) */
-UnexpectedErrors.reThrowDeferred = (e) => setTimeout(() => { throw e; }, 0);
-/** handler for logging exception to console */
-UnexpectedErrors.consoleLog = (e) => console.error(e); // eslint-disable-line no-console
-/** handler for logging exception with [[Logger]] */
-UnexpectedErrors.errorLog = (e) => Logger.logException("unhandled", e);
-UnexpectedErrors._telemetry = [];
-UnexpectedErrors._handler = _a.errorLog; // default to error logging
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Errors
+ */
+var _a;
+import { Logger } from "./Logger";
+/**
+ * Utility for handling/reporting unexpected runtime errors. This class establishes a global handler for
+ * unexpected errors, and programmers should use its `handle` method when they occur. Generally, unexpected
+ * errors should not cause program termination, and should instead be logged and swallowed. However, for
+ * development/debugging, it can be helpful to re-throw exceptions so they are not missed.
+ * @public
+ */
+class UnexpectedErrors {
+    constructor() { } // this is a singleton
+    /** Add a "telemetry tracker" for unexpected errors. Useful for tracking/reporting errors without changing handler.
+     * @returns a method to remove the tracker
+     */
+    static addTelemetry(tracker) {
+        this._telemetry.push(tracker);
+        return () => this._telemetry.splice(this._telemetry.indexOf(tracker), 1);
+    }
+    /** call this method when an unexpected error happens so the global handler can process it.
+     * @param error the unexpected error
+     * @param notifyTelemetry if false, don't notify telemetry trackers. Use this for exceptions from third-party code, for example.
+     */
+    static handle(error, notifyTelemetry = true) {
+        this._handler(error);
+        if (notifyTelemetry) {
+            this._telemetry.forEach((telemetry) => {
+                try {
+                    telemetry(error);
+                }
+                catch (_) {
+                    // ignore errors from telemetry trackers
+                }
+            });
+        }
+    }
+    /** establish a new global *unexpected error* handler.
+     * @param handler the new global handler. You may provide your own function or use one of the static members of this class.
+     * The default is [[errorLog]].
+     * @returns the previous handler. Useful to temporarily change the handler.
+     */
+    static setHandler(handler) {
+        const oldHandler = this._handler;
+        this._handler = handler;
+        return oldHandler;
+    }
+}
+_a = UnexpectedErrors;
+/** handler for re-throwing exceptions directly */
+UnexpectedErrors.reThrowImmediate = (e) => { throw e; };
+/** handler for re-throwing exceptions from an asynchronous interval (so the current call stack is not aborted) */
+UnexpectedErrors.reThrowDeferred = (e) => setTimeout(() => { throw e; }, 0);
+/** handler for logging exception to console */
+UnexpectedErrors.consoleLog = (e) => console.error(e); // eslint-disable-line no-console
+/** handler for logging exception with [[Logger]] */
+UnexpectedErrors.errorLog = (e) => Logger.logException("unhandled", e);
+UnexpectedErrors._telemetry = [];
+UnexpectedErrors._handler = _a.errorLog; // default to error logging
+export { UnexpectedErrors };
 //# sourceMappingURL=UnexpectedErrors.js.map