@itwin/core-bentley 3.5.0-dev.5 → 3.5.0-dev.52

package/lib/esm/TypedArrayBuilder.d.ts

@@ -1,98 +1,98 @@
-/** @packageDocumentation
- * @module Collections
- */
-import { Constructor } from "./UtilityTypes";
-/** Options used to construct a [[TypedArrayBuilder]].
- * @public
- */
-export interface TypedArrayBuilderOptions {
-    /** Controls how much additional memory is allocated when the TypedArray needs to be resized to accomodate more elements.
-     * [[TypedArrayBuilder.ensureCapacity]] multiplies the required capacity by this factor to determine the new capacity.
-     * Default: 1.5
-     * Minimum: 1.0, which causes the TypedArray to allocate exactly the space it needs each time it is resized.
-     */
-    growthFactor?: number;
-    /** The number of elements to allocate memory for in the TypedArray when creating the builder.
-     * If you know the minimum number of elements you intend to add to the builder, you should specify that as the
-     * initial capacity to avoid reallocations when populating the array.
-     * Default: 0.
-     * Minimum: 0.
-     */
-    initialCapacity?: number;
-}
-/** Incrementally builds a [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.
- * @public
- */
-export declare class TypedArrayBuilder<T extends Uint8Array | Uint16Array | Uint32Array> {
-    /** The constructor for the specific type of array being populated. */
-    protected readonly _constructor: Constructor<T>;
-    /** The underlying typed array, to be reallocated and copied when its capacity is exceeded. */
-    protected _data: T;
-    /** The number of elements added to the array so far. */
-    protected _length: number;
-    /** Multiplier applied to required capacity by [[ensureCapacity]]. */
-    readonly growthFactor: number;
-    /** Constructs a new builder from the specified options, with a [[length]] of zero. */
-    protected constructor(constructor: Constructor<T>, options?: TypedArrayBuilderOptions);
-    /** The number of elements currently in the array. */
-    get length(): number;
-    /** The number of elements that can fit into the memory currently allocated for the array. */
-    get capacity(): number;
-    /** 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: number): number;
-    /** 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: number): number;
-    /** Append the specified value, resizing if necessary. */
-    push(value: number): void;
-    /** Append an array of values, resizing (at most once) if necessary. */
-    append(values: T): void;
-    /** 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?: boolean): T;
-}
-/** A [[TypedArrayBuilder]] for producing a [Uint8Array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array).
- * @public
- */
-export declare class Uint8ArrayBuilder extends TypedArrayBuilder<Uint8Array> {
-    /** @see [[TypedArrayBuilder]] constructor. */
-    constructor(options?: TypedArrayBuilderOptions);
-}
-/** A [[TypedArrayBuilder]] for producing a [Uint16Array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint16Array).
- * @public
- */
-export declare class Uint16ArrayBuilder extends TypedArrayBuilder<Uint16Array> {
-    /** @see [[TypedArrayBuilder]] constructor. */
-    constructor(options?: TypedArrayBuilderOptions);
-}
-/** A [[TypedArrayBuilder]] for producing a [Uint32Array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint32Array).
- * @public
- */
-export declare class Uint32ArrayBuilder extends TypedArrayBuilder<Uint32Array> {
-    /** @see [[TypedArrayBuilder]] constructor. */
-    constructor(options?: TypedArrayBuilderOptions);
-    /** Obtain a view of the finished array as an array of bytes. */
-    toUint8Array(includeUnusedCapacity?: boolean): Uint8Array;
-}
+/** @packageDocumentation
+ * @module Collections
+ */
+import { Constructor } from "./UtilityTypes";
+/** Options used to construct a [[TypedArrayBuilder]].
+ * @public
+ */
+export interface TypedArrayBuilderOptions {
+    /** Controls how much additional memory is allocated when the TypedArray needs to be resized to accomodate more elements.
+     * [[TypedArrayBuilder.ensureCapacity]] multiplies the required capacity by this factor to determine the new capacity.
+     * Default: 1.5
+     * Minimum: 1.0, which causes the TypedArray to allocate exactly the space it needs each time it is resized.
+     */
+    growthFactor?: number;
+    /** The number of elements to allocate memory for in the TypedArray when creating the builder.
+     * If you know the minimum number of elements you intend to add to the builder, you should specify that as the
+     * initial capacity to avoid reallocations when populating the array.
+     * Default: 0.
+     * Minimum: 0.
+     */
+    initialCapacity?: number;
+}
+/** Incrementally builds a [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.
+ * @public
+ */
+export declare class TypedArrayBuilder<T extends Uint8Array | Uint16Array | Uint32Array> {
+    /** The constructor for the specific type of array being populated. */
+    protected readonly _constructor: Constructor<T>;
+    /** The underlying typed array, to be reallocated and copied when its capacity is exceeded. */
+    protected _data: T;
+    /** The number of elements added to the array so far. */
+    protected _length: number;
+    /** Multiplier applied to required capacity by [[ensureCapacity]]. */
+    readonly growthFactor: number;
+    /** Constructs a new builder from the specified options, with a [[length]] of zero. */
+    protected constructor(constructor: Constructor<T>, options?: TypedArrayBuilderOptions);
+    /** The number of elements currently in the array. */
+    get length(): number;
+    /** The number of elements that can fit into the memory currently allocated for the array. */
+    get capacity(): number;
+    /** 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: number): number;
+    /** 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: number): number;
+    /** Append the specified value, resizing if necessary. */
+    push(value: number): void;
+    /** Append an array of values, resizing (at most once) if necessary. */
+    append(values: T): void;
+    /** 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?: boolean): T;
+}
+/** A [[TypedArrayBuilder]] for producing a [Uint8Array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array).
+ * @public
+ */
+export declare class Uint8ArrayBuilder extends TypedArrayBuilder<Uint8Array> {
+    /** @see [[TypedArrayBuilder]] constructor. */
+    constructor(options?: TypedArrayBuilderOptions);
+}
+/** A [[TypedArrayBuilder]] for producing a [Uint16Array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint16Array).
+ * @public
+ */
+export declare class Uint16ArrayBuilder extends TypedArrayBuilder<Uint16Array> {
+    /** @see [[TypedArrayBuilder]] constructor. */
+    constructor(options?: TypedArrayBuilderOptions);
+}
+/** A [[TypedArrayBuilder]] for producing a [Uint32Array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint32Array).
+ * @public
+ */
+export declare class Uint32ArrayBuilder extends TypedArrayBuilder<Uint32Array> {
+    /** @see [[TypedArrayBuilder]] constructor. */
+    constructor(options?: TypedArrayBuilderOptions);
+    /** Obtain a view of the finished array as an array of bytes. */
+    toUint8Array(includeUnusedCapacity?: boolean): Uint8Array;
+}
 //# sourceMappingURL=TypedArrayBuilder.d.ts.map

package/lib/esm/TypedArrayBuilder.js

@@ -1,128 +1,128 @@
-/*---------------------------------------------------------------------------------------------
-* 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] 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.
- * @public
- */
-export class TypedArrayBuilder {
-    /** Constructs a new builder from the specified options, with a [[length]] of zero. */
-    constructor(constructor, options) {
-        var _a, _b;
-        this._constructor = constructor;
-        this._data = new constructor((_a = options === null || options === void 0 ? void 0 : options.initialCapacity) !== null && _a !== void 0 ? _a : 0);
-        this.growthFactor = Math.max(1.0, (_b = options === null || options === void 0 ? void 0 : options.growthFactor) !== null && _b !== void 0 ? _b : 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);
-    }
-}
+/*---------------------------------------------------------------------------------------------
+* 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] 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.
+ * @public
+ */
+export class TypedArrayBuilder {
+    /** Constructs a new builder from the specified options, with a [[length]] of zero. */
+    constructor(constructor, options) {
+        var _a, _b;
+        this._constructor = constructor;
+        this._data = new constructor((_a = options === null || options === void 0 ? void 0 : options.initialCapacity) !== null && _a !== void 0 ? _a : 0);
+        this.growthFactor = Math.max(1.0, (_b = options === null || options === void 0 ? void 0 : options.growthFactor) !== null && _b !== void 0 ? _b : 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);
+    }
+}
 //# sourceMappingURL=TypedArrayBuilder.js.map

package/lib/esm/TypedArrayBuilder.js.map

@@ -1 +1 @@
-{"version":3,"file":"TypedArrayBuilder.js","sourceRoot":"","sources":["../../src/TypedArrayBuilder.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Collections\n */\n\nimport { Constructor } from \"./UtilityTypes\";\nimport { assert } from \"./Assert\";\n\n/** Options used to construct a [[TypedArrayBuilder]].\n * @public\n */\nexport interface TypedArrayBuilderOptions {\n  /** Controls how much additional memory is allocated when the TypedArray needs to be resized to accomodate more elements.\n   * [[TypedArrayBuilder.ensureCapacity]] multiplies the required capacity by this factor to determine the new capacity.\n   * Default: 1.5\n   * Minimum: 1.0, which causes the TypedArray to allocate exactly the space it needs each time it is resized.\n   */\n  growthFactor?: number;\n  /** The number of elements to allocate memory for in the TypedArray when creating the builder.\n   * If you know the minimum number of elements you intend to add to the builder, you should specify that as the\n   * initial capacity to avoid reallocations when populating the array.\n   * Default: 0.\n   * Minimum: 0.\n   */\n  initialCapacity?: number;\n}\n\n/** Incrementally builds a [TypedArray] of unsigned 8-, 16-, or 32-bit integers.\n * Sometimes you wish to populate a `TypedArray`, but you don't know how many elements you will need.\n * `TypedArray` requires you to specify the size upon construction, and does not permit you to change the size later.\n *\n * `TypedArrayBuilder` manages a `TypedArray`, permitting you to [[push]] and [[append]] elements to it. It exposes two \"size\" properties\":\n *  - [[capacity]], the number of elements it has currently allocated space for - i.e., the length of the underlying TypedArray; and\n *  - [[length]], the number of elements that have so far been added to it, which is never bigger than [[capacity]].\n * When [[capacity]] is exceeded, a new, bigger TypedArray is allocated and the contents of the previous array are copied over to it.\n *\n * Once you've finished adding elements, you can obtain the finished `TypedArray` via [[toTypedArray]].\n * @see [[Uint8ArrayBuilder]], [[Uint16ArrayBuilder]], and [[Uint32ArrayBuilder]] to build specific types of arrays.\n * @public\n */\nexport class TypedArrayBuilder<T extends Uint8Array | Uint16Array | Uint32Array> {\n  /** The constructor for the specific type of array being populated. */\n  protected readonly _constructor: Constructor<T>;\n  /** The underlying typed array, to be reallocated and copied when its capacity is exceeded. */\n  protected _data: T;\n  /** The number of elements added to the array so far. */\n  protected _length: number;\n  /** Multiplier applied to required capacity by [[ensureCapacity]]. */\n  public readonly growthFactor: number;\n\n  /** Constructs a new builder from the specified options, with a [[length]] of zero. */\n  protected constructor(constructor: Constructor<T>, options?: TypedArrayBuilderOptions) {\n    this._constructor = constructor;\n    this._data = new constructor(options?.initialCapacity ?? 0);\n    this.growthFactor = Math.max(1.0, options?.growthFactor ?? 1.5);\n    this._length = 0;\n  }\n\n  /** The number of elements currently in the array. */\n  public get length(): number {\n    return this._length;\n  }\n\n  /** The number of elements that can fit into the memory currently allocated for the array. */\n  public get capacity(): number {\n    return this._data.length;\n  }\n\n  /** Like [TypedArray.at](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray/at),\n   * returns the element at the specified index, with negative integers counting back from the end of the array.\n   * @note It is your responsibility to ensure the index falls within the bounds of the array.\n   */\n  public at(index: number): number {\n    if (index < 0)\n      index = this.length - index;\n\n    const value = this._data[index];\n    assert(value !== undefined, \"index out of bounds\");\n    return value;\n  }\n\n  /** Ensure that [[capacity]] is at least equal to `newCapacity`.\n   * This is used internally by methods like [[push]] and [[append]] to ensure the array has room for the element(s) to be added.\n   * It can also be useful when you know you intend to add some number of additional elements, to minimize reallocations.\n   *\n   * If `newCapacity` is not greater than the current [[capacity]], this function does nothing.\n   * Otherwise, it allocates a new `TypedArray` with room for `newCapacity * growthFactor` elements, and copies the contents of the previous `TypedArray` into it.\n   * [[length]] remains unchanged; [[capacity]] reflects the size of the new TypeArray.\n   */\n  public ensureCapacity(newCapacity: number): number {\n    if (this.capacity >= newCapacity)\n      return this.capacity;\n\n    assert(this.growthFactor >= 1.0);\n    newCapacity = Math.ceil(newCapacity * this.growthFactor);\n    const prevData = this._data;\n    this._data = new this._constructor(newCapacity);\n    this._data.set(prevData, 0);\n\n    assert(this.capacity === newCapacity);\n    return this.capacity;\n  }\n\n  /** Append the specified value, resizing if necessary. */\n  public push(value: number): void {\n    this.ensureCapacity(this.length + 1);\n    this._data[this.length] = value;\n    ++this._length;\n  }\n\n  /** Append an array of values, resizing (at most once) if necessary. */\n  public append(values: T): void {\n    const newLength = this.length + values.length;\n    this.ensureCapacity(newLength);\n    this._data.set(values, this.length);\n    this._length = newLength;\n  }\n\n  /** Obtain the finished array.\n   * @param includeUnusedCapacity If true, the length of the returned array will be equal to [[capacity]], with extra bytes initialized to zero; otherwise, the\n   * returned array's length will be equal to [[length]].\n   */\n  public toTypedArray(includeUnusedCapacity = false): T {\n    if (includeUnusedCapacity)\n      return this._data;\n\n    const subarray = this._data.subarray(0, this.length);\n    assert(subarray instanceof this._constructor);\n    assert(subarray.buffer === this._data.buffer);\n    return subarray;\n  }\n}\n\n/** A [[TypedArrayBuilder]] for producing a [Uint8Array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array).\n * @public\n */\nexport class Uint8ArrayBuilder extends TypedArrayBuilder<Uint8Array> {\n  /** @see [[TypedArrayBuilder]] constructor. */\n  public constructor(options?: TypedArrayBuilderOptions) {\n    super(Uint8Array, options);\n  }\n}\n\n/** A [[TypedArrayBuilder]] for producing a [Uint16Array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint16Array).\n * @public\n */\nexport class Uint16ArrayBuilder extends TypedArrayBuilder<Uint16Array> {\n  /** @see [[TypedArrayBuilder]] constructor. */\n  public constructor(options?: TypedArrayBuilderOptions) {\n    super(Uint16Array, options);\n  }\n}\n\n/** A [[TypedArrayBuilder]] for producing a [Uint32Array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint32Array).\n * @public\n */\nexport class Uint32ArrayBuilder extends TypedArrayBuilder<Uint32Array> {\n  /** @see [[TypedArrayBuilder]] constructor. */\n  public constructor(options?: TypedArrayBuilderOptions) {\n    super(Uint32Array, options);\n  }\n\n  /** Obtain a view of the finished array as an array of bytes. */\n  public toUint8Array(includeUnusedCapacity = false): Uint8Array {\n    if (includeUnusedCapacity)\n      return new Uint8Array(this._data.buffer);\n\n    return new Uint8Array(this._data.buffer, 0, this.length * 4);\n  }\n}\n"]}
+{"version":3,"file":"TypedArrayBuilder.js","sourceRoot":"","sources":["../../src/TypedArrayBuilder.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Collections\r\n */\r\n\r\nimport { Constructor } from \"./UtilityTypes\";\r\nimport { assert } from \"./Assert\";\r\n\r\n/** Options used to construct a [[TypedArrayBuilder]].\r\n * @public\r\n */\r\nexport interface TypedArrayBuilderOptions {\r\n  /** Controls how much additional memory is allocated when the TypedArray needs to be resized to accomodate more elements.\r\n   * [[TypedArrayBuilder.ensureCapacity]] multiplies the required capacity by this factor to determine the new capacity.\r\n   * Default: 1.5\r\n   * Minimum: 1.0, which causes the TypedArray to allocate exactly the space it needs each time it is resized.\r\n   */\r\n  growthFactor?: number;\r\n  /** The number of elements to allocate memory for in the TypedArray when creating the builder.\r\n   * If you know the minimum number of elements you intend to add to the builder, you should specify that as the\r\n   * initial capacity to avoid reallocations when populating the array.\r\n   * Default: 0.\r\n   * Minimum: 0.\r\n   */\r\n  initialCapacity?: number;\r\n}\r\n\r\n/** Incrementally builds a [TypedArray] of unsigned 8-, 16-, or 32-bit integers.\r\n * Sometimes you wish to populate a `TypedArray`, but you don't know how many elements you will need.\r\n * `TypedArray` requires you to specify the size upon construction, and does not permit you to change the size later.\r\n *\r\n * `TypedArrayBuilder` manages a `TypedArray`, permitting you to [[push]] and [[append]] elements to it. It exposes two \"size\" properties\":\r\n *  - [[capacity]], the number of elements it has currently allocated space for - i.e., the length of the underlying TypedArray; and\r\n *  - [[length]], the number of elements that have so far been added to it, which is never bigger than [[capacity]].\r\n * When [[capacity]] is exceeded, a new, bigger TypedArray is allocated and the contents of the previous array are copied over to it.\r\n *\r\n * Once you've finished adding elements, you can obtain the finished `TypedArray` via [[toTypedArray]].\r\n * @see [[Uint8ArrayBuilder]], [[Uint16ArrayBuilder]], and [[Uint32ArrayBuilder]] to build specific types of arrays.\r\n * @public\r\n */\r\nexport class TypedArrayBuilder<T extends Uint8Array | Uint16Array | Uint32Array> {\r\n  /** The constructor for the specific type of array being populated. */\r\n  protected readonly _constructor: Constructor<T>;\r\n  /** The underlying typed array, to be reallocated and copied when its capacity is exceeded. */\r\n  protected _data: T;\r\n  /** The number of elements added to the array so far. */\r\n  protected _length: number;\r\n  /** Multiplier applied to required capacity by [[ensureCapacity]]. */\r\n  public readonly growthFactor: number;\r\n\r\n  /** Constructs a new builder from the specified options, with a [[length]] of zero. */\r\n  protected constructor(constructor: Constructor<T>, options?: TypedArrayBuilderOptions) {\r\n    this._constructor = constructor;\r\n    this._data = new constructor(options?.initialCapacity ?? 0);\r\n    this.growthFactor = Math.max(1.0, options?.growthFactor ?? 1.5);\r\n    this._length = 0;\r\n  }\r\n\r\n  /** The number of elements currently in the array. */\r\n  public get length(): number {\r\n    return this._length;\r\n  }\r\n\r\n  /** The number of elements that can fit into the memory currently allocated for the array. */\r\n  public get capacity(): number {\r\n    return this._data.length;\r\n  }\r\n\r\n  /** Like [TypedArray.at](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray/at),\r\n   * returns the element at the specified index, with negative integers counting back from the end of the array.\r\n   * @note It is your responsibility to ensure the index falls within the bounds of the array.\r\n   */\r\n  public at(index: number): number {\r\n    if (index < 0)\r\n      index = this.length - index;\r\n\r\n    const value = this._data[index];\r\n    assert(value !== undefined, \"index out of bounds\");\r\n    return value;\r\n  }\r\n\r\n  /** Ensure that [[capacity]] is at least equal to `newCapacity`.\r\n   * This is used internally by methods like [[push]] and [[append]] to ensure the array has room for the element(s) to be added.\r\n   * It can also be useful when you know you intend to add some number of additional elements, to minimize reallocations.\r\n   *\r\n   * If `newCapacity` is not greater than the current [[capacity]], this function does nothing.\r\n   * Otherwise, it allocates a new `TypedArray` with room for `newCapacity * growthFactor` elements, and copies the contents of the previous `TypedArray` into it.\r\n   * [[length]] remains unchanged; [[capacity]] reflects the size of the new TypeArray.\r\n   */\r\n  public ensureCapacity(newCapacity: number): number {\r\n    if (this.capacity >= newCapacity)\r\n      return this.capacity;\r\n\r\n    assert(this.growthFactor >= 1.0);\r\n    newCapacity = Math.ceil(newCapacity * this.growthFactor);\r\n    const prevData = this._data;\r\n    this._data = new this._constructor(newCapacity);\r\n    this._data.set(prevData, 0);\r\n\r\n    assert(this.capacity === newCapacity);\r\n    return this.capacity;\r\n  }\r\n\r\n  /** Append the specified value, resizing if necessary. */\r\n  public push(value: number): void {\r\n    this.ensureCapacity(this.length + 1);\r\n    this._data[this.length] = value;\r\n    ++this._length;\r\n  }\r\n\r\n  /** Append an array of values, resizing (at most once) if necessary. */\r\n  public append(values: T): void {\r\n    const newLength = this.length + values.length;\r\n    this.ensureCapacity(newLength);\r\n    this._data.set(values, this.length);\r\n    this._length = newLength;\r\n  }\r\n\r\n  /** Obtain the finished array.\r\n   * @param includeUnusedCapacity If true, the length of the returned array will be equal to [[capacity]], with extra bytes initialized to zero; otherwise, the\r\n   * returned array's length will be equal to [[length]].\r\n   */\r\n  public toTypedArray(includeUnusedCapacity = false): T {\r\n    if (includeUnusedCapacity)\r\n      return this._data;\r\n\r\n    const subarray = this._data.subarray(0, this.length);\r\n    assert(subarray instanceof this._constructor);\r\n    assert(subarray.buffer === this._data.buffer);\r\n    return subarray;\r\n  }\r\n}\r\n\r\n/** A [[TypedArrayBuilder]] for producing a [Uint8Array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array).\r\n * @public\r\n */\r\nexport class Uint8ArrayBuilder extends TypedArrayBuilder<Uint8Array> {\r\n  /** @see [[TypedArrayBuilder]] constructor. */\r\n  public constructor(options?: TypedArrayBuilderOptions) {\r\n    super(Uint8Array, options);\r\n  }\r\n}\r\n\r\n/** A [[TypedArrayBuilder]] for producing a [Uint16Array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint16Array).\r\n * @public\r\n */\r\nexport class Uint16ArrayBuilder extends TypedArrayBuilder<Uint16Array> {\r\n  /** @see [[TypedArrayBuilder]] constructor. */\r\n  public constructor(options?: TypedArrayBuilderOptions) {\r\n    super(Uint16Array, options);\r\n  }\r\n}\r\n\r\n/** A [[TypedArrayBuilder]] for producing a [Uint32Array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint32Array).\r\n * @public\r\n */\r\nexport class Uint32ArrayBuilder extends TypedArrayBuilder<Uint32Array> {\r\n  /** @see [[TypedArrayBuilder]] constructor. */\r\n  public constructor(options?: TypedArrayBuilderOptions) {\r\n    super(Uint32Array, options);\r\n  }\r\n\r\n  /** Obtain a view of the finished array as an array of bytes. */\r\n  public toUint8Array(includeUnusedCapacity = false): Uint8Array {\r\n    if (includeUnusedCapacity)\r\n      return new Uint8Array(this._data.buffer);\r\n\r\n    return new Uint8Array(this._data.buffer, 0, this.length * 4);\r\n  }\r\n}\r\n"]}

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 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;
+}
 //# sourceMappingURL=UnexpectedErrors.d.ts.map