@itwin/core-i18n 3.6.0-dev.10 → 3.6.0-dev.14

package/lib/cjs/test/webpack/bundled-tests.js

@@ -16990,7 +16990,7 @@ __webpack_require__.r(__webpack_exports__);
 /** Allows the contents of an [ArrayBuffer](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer)
  * to be consumed sequentially using methods to extract
  * data of a particular type from the bytes beginning at the current read position.
- * Methods and properties beginning with 'next' consume data at the current read position and advance it
+ * Methods and properties beginning with 'read' and taking no arguments consume data at the current read position and advance it
  * by the size of the data read. The read position can also be directly adjusted by the caller.
  * @public
  */
@@ -17075,21 +17075,37 @@ class ByteStream {
     /** Resets the current read position to the beginning of the stream */
     reset() { this.curPos = 0; }
     /** Read a unsigned 8-bit integer from the current read position and advance by 1 byte. */
-    get nextUint8() { return this.read(1, (view) => view.getUint8(this.curPos)); }
+    readUint8() { return this.read(1, (view) => view.getUint8(this.curPos)); }
     /** Read an unsigned 16-bit integer from the current read position and advance by 2 bytes. */
-    get nextUint16() { return this.read(2, (view) => view.getUint16(this.curPos, true)); }
+    readUint16() { return this.read(2, (view) => view.getUint16(this.curPos, true)); }
     /** Read an unsigned 32-bit integer from the current read position and advance by 4 bytes. */
-    get nextUint32() { return this.read(4, (view) => view.getUint32(this.curPos, true)); }
+    readUint32() { return this.read(4, (view) => view.getUint32(this.curPos, true)); }
     /** Read a signed 32-bit integer from the current read position and advance by 4 bytes. */
-    get nextInt32() { return this.read(4, (view) => view.getInt32(this.curPos, true)); }
+    readInt32() { return this.read(4, (view) => view.getInt32(this.curPos, true)); }
     /** Read a 32-bit floating point number from the current read position and advance by 4 bytes. */
-    get nextFloat32() { return this.read(4, (view) => view.getFloat32(this.curPos, true)); }
+    readFloat32() { return this.read(4, (view) => view.getFloat32(this.curPos, true)); }
     /** Read a 64-bit floating point number from the current read position and advance by 8 bytes. */
-    get nextFloat64() { return this.read(8, (view) => view.getFloat64(this.curPos, true)); }
+    readFloat64() { return this.read(8, (view) => view.getFloat64(this.curPos, true)); }
     /** Read an unsigned 64-bit integer from the current read position, advance by 8 bytes, and return the 64-bit value as an Id64String. */
-    get nextId64() { return _Id__WEBPACK_IMPORTED_MODULE_1__.Id64.fromUint32Pair(this.nextUint32, this.nextUint32); }
+    readId64() { return _Id__WEBPACK_IMPORTED_MODULE_1__.Id64.fromUint32Pair(this.readUint32(), this.readUint32()); }
     /** Read an unsigned 24-bit integer from the current read position and advance by 3 bytes. */
-    get nextUint24() { return this.nextUint8 | (this.nextUint8 << 8) | (this.nextUint8 << 16); }
+    readUint24() { return this.readUint8() | (this.readUint8() << 8) | (this.readUint8() << 16); }
+    /** @deprecated use [[readUint8]]. */
+    get nextUint8() { return this.readUint8(); }
+    /** @deprecated use [[readUint16]]. */
+    get nextUint16() { return this.readUint16(); }
+    /** @deprecated use [[readUint32]]. */
+    get nextUint32() { return this.readUint32(); }
+    /** @deprecated use [[readInt32]]. */
+    get nextInt32() { return this.readInt32(); }
+    /** @deprecated use [[readFloat32]]. */
+    get nextFloat32() { return this.readFloat32(); }
+    /** @deprecated use [[readFloat64]]. */
+    get nextFloat64() { return this.readFloat64(); }
+    /** @deprecated use [[readId64]]. */
+    get nextId64() { return this.readId64(); }
+    /** @deprecated use [[readUint32]]. */
+    get nextUint24() { return this.readUint24(); }
     /** Read the specified number of bytes beginning at the current read position into a Uint8Array and advance by the specified number of byte.
      * @param numBytes The number of bytes to read.
      */
@@ -21684,7 +21700,8 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   "TypedArrayBuilder": () => (/* binding */ TypedArrayBuilder),
 /* harmony export */   "Uint16ArrayBuilder": () => (/* binding */ Uint16ArrayBuilder),
 /* harmony export */   "Uint32ArrayBuilder": () => (/* binding */ Uint32ArrayBuilder),
-/* harmony export */   "Uint8ArrayBuilder": () => (/* binding */ Uint8ArrayBuilder)
+/* harmony export */   "Uint8ArrayBuilder": () => (/* binding */ Uint8ArrayBuilder),
+/* harmony export */   "UintArrayBuilder": () => (/* binding */ UintArrayBuilder)
 /* harmony export */ });
 /* harmony import */ var _Assert__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./Assert */ "../bentley/lib/esm/Assert.js");
 /*---------------------------------------------------------------------------------------------
@@ -21695,7 +21712,7 @@ __webpack_require__.r(__webpack_exports__);
  * @module Collections
  */
 
-/** Incrementally builds a [TypedArray] of unsigned 8-, 16-, or 32-bit integers.
+/** 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.
  *
@@ -21706,6 +21723,7 @@ __webpack_require__.r(__webpack_exports__);
  *
  * 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
  */
 class TypedArrayBuilder {
@@ -21785,7 +21803,7 @@ class TypedArrayBuilder {
  * @public
  */
 class Uint8ArrayBuilder extends TypedArrayBuilder {
-    /** @see [[TypedArrayBuilder]] constructor. */
+    /** See [[TypedArrayBuilder]] constructor. */
     constructor(options) {
         super(Uint8Array, options);
     }
@@ -21794,7 +21812,7 @@ class Uint8ArrayBuilder extends TypedArrayBuilder {
  * @public
  */
 class Uint16ArrayBuilder extends TypedArrayBuilder {
-    /** @see [[TypedArrayBuilder]] constructor. */
+    /** See [[TypedArrayBuilder]] constructor. */
     constructor(options) {
         super(Uint16Array, options);
     }
@@ -21803,7 +21821,7 @@ class Uint16ArrayBuilder extends TypedArrayBuilder {
  * @public
  */
 class Uint32ArrayBuilder extends TypedArrayBuilder {
-    /** @see [[TypedArrayBuilder]] constructor. */
+    /** See [[TypedArrayBuilder]] constructor. */
     constructor(options) {
         super(Uint32Array, options);
     }
@@ -21814,6 +21832,78 @@ class Uint32ArrayBuilder extends TypedArrayBuilder {
         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
+ */
+class UintArrayBuilder extends TypedArrayBuilder {
+    constructor(options) {
+        var _a;
+        super((_a = options === null || options === void 0 ? void 0 : options.initialType) !== null && _a !== void 0 ? _a : 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;
+        (0,_Assert__WEBPACK_IMPORTED_MODULE_0__.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);
+    }
+}
 
 
 /***/ }),
@@ -22065,6 +22155,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   "Uint16ArrayBuilder": () => (/* reexport safe */ _TypedArrayBuilder__WEBPACK_IMPORTED_MODULE_32__.Uint16ArrayBuilder),
 /* harmony export */   "Uint32ArrayBuilder": () => (/* reexport safe */ _TypedArrayBuilder__WEBPACK_IMPORTED_MODULE_32__.Uint32ArrayBuilder),
 /* harmony export */   "Uint8ArrayBuilder": () => (/* reexport safe */ _TypedArrayBuilder__WEBPACK_IMPORTED_MODULE_32__.Uint8ArrayBuilder),
+/* harmony export */   "UintArrayBuilder": () => (/* reexport safe */ _TypedArrayBuilder__WEBPACK_IMPORTED_MODULE_32__.UintArrayBuilder),
 /* harmony export */   "UnexpectedErrors": () => (/* reexport safe */ _UnexpectedErrors__WEBPACK_IMPORTED_MODULE_33__.UnexpectedErrors),
 /* harmony export */   "YieldManager": () => (/* reexport safe */ _YieldManager__WEBPACK_IMPORTED_MODULE_35__.YieldManager),
 /* harmony export */   "areEqualPossiblyUndefined": () => (/* reexport safe */ _Compare__WEBPACK_IMPORTED_MODULE_10__.areEqualPossiblyUndefined),