bireader 1.0.13 → 1.0.15

package/lib/esm/src/writer.js

@@ -1,11 +1,12 @@
+import { skip, goto, remove, checkSize, addData, hexDump } from './common';
 /**
 * Binary writer, includes bitfields and strings
 *
 * @param {Buffer|Uint8Array} data - ``Buffer`` or ``Uint8Array``. Always found in ``biwriter.data``
-* @param {number} byteOffset - byte offset to start writer, default is 0
-* @param {number} bitOffset - bit offset to start writer, 0-7
-* @param {string} endianness - endianness ``big`` or ``little`` (default little)
-* @param {boolean} strict - strict mode: if true does not extend supplied array on outside write (default false)
+* @param {number} byteOffset - Byte offset to start writer, default is 0
+* @param {number} bitOffset - Bit offset to start writer, 0-7
+* @param {string} endianness - Endianness ``big`` or ``little`` (default little)
+* @param {boolean} strict - Strict mode: if true does not extend supplied array on outside write (default false)
 */
 export class biwriter {
     isBuffer(obj) {
@@ -18,43 +19,25 @@ export class biwriter {
         if ((typeof Buffer !== 'undefined' && this.data instanceof Buffer)) {
             var paddbuffer = Buffer.alloc(to_padd);
             this.data = Buffer.concat([this.data, paddbuffer]);
+            this.size = this.data.length;
         }
         else {
             const addArray = new Array(to_padd);
             this.data = new Uint8Array([...this.data, ...addArray]);
+            this.size = this.data.length;
         }
     }
     check_size(write_bytes, write_bit, offset) {
-        const bits = (write_bit || 0) + this.bitoffset;
-        var new_off = (offset || this.offset);
-        var writesize = write_bytes || 0;
-        if (bits != 0) {
-            //add bits
-            writesize += Math.ceil(bits / 8);
-        }
-        //if biger extend
-        const needed_size = new_off + writesize;
-        if (needed_size > this.size) {
-            const dif = needed_size - this.size;
-            if (this.strict == false) {
-                this.extendArray(dif);
-            }
-            else {
-                throw new Error("Location outside of size of data: " + this.size);
-            }
-            this.size = this.data.length;
-        }
-        //start read location
-        this.offset = new_off;
+        return checkSize(this, write_bytes || 0, write_bit || 0, offset || this.offset);
     }
     /**
     * Binary writer, includes bitfields and strings
     *
     * @param {Buffer|Uint8Array} data - ``Buffer`` or ``Uint8Array``. Always found in ``biwriter.data``
-    * @param {number} byteOffset - byte offset to start writer, default is 0
-    * @param {number} bitOffset - bit offset to start writer, 0-7
-    * @param {string} endianness - endianness ``big`` or ``little`` (default little)
-    * @param {boolean} strict - strict mode: if true does not extend supplied array on outside write (default false)
+    * @param {number} byteOffset - Byte offset to start writer, default is 0
+    * @param {number} bitOffset - Bit offset to start writer, 0-7
+    * @param {string} endianness - Endianness ``big`` or ``little`` (default little)
+    * @param {boolean} strict - Strict mode: if true does not extend supplied array on outside write (default false)
     */
     constructor(data, byteOffset, bitOffset, endianness, strict) {
         this.endian = "little";
@@ -62,6 +45,7 @@ export class biwriter {
         this.bitoffset = 0;
         this.size = 0;
         this.strict = false;
+        this.errorDump = true;
         this.data = [];
         if (endianness != undefined && typeof endianness != "string") {
             throw new Error("endianness must be big or little");
@@ -93,7 +77,7 @@ export class biwriter {
             throw new Error("Data required");
         }
         else {
-            if (!this.isBufferOrUint8Array(this.data)) {
+            if (!this.isBufferOrUint8Array(data)) {
                 throw new Error("Write data must be Uint8Array or Buffer");
             }
         }
@@ -101,8 +85,7 @@ export class biwriter {
         this.size = this.data.length + ((bitOffset || 0) % 8);
     }
     /**
-    *
-    * Change endian, defaults to little
+    * Change endian (default little)
     *
     * Can be changed at any time, doesn't loose position
     *
@@ -118,169 +101,133 @@ export class biwriter {
         this.endian = endian;
     }
     /**
-    *
     * Sets endian to big
+    *
     */
     bigEndian() {
         this.endianness("big");
     }
     /**
-    *
     * Sets endian to big
+    *
     */
     big() {
         this.endianness("big");
     }
     /**
-    *
     * Sets endian to big
+    *
     */
     be() {
         this.endianness("big");
     }
     /**
-    *
     * Sets endian to little
+    *
     */
     littleEndian() {
         this.endianness("little");
     }
     /**
-    *
     * Sets endian to little
+    *
     */
     little() {
         this.endianness("little");
     }
     /**
-    *
     * Sets endian to little
+    *
     */
     le() {
         this.endianness("little");
     }
+    //
+    // move from current position
+    //
     /**
-    * Move current write byte or bit position, will extend data if outside of current size
+    * Offset current byte or bit position
+    * Note: Will extend array if strict mode is off and outside of max size
     *
-    * @param {number} bytes - bytes to skip
-    * @param {number} bits - bits to skip (0-7)
+    * @param {number} bytes - Bytes to skip
+    * @param {number} bits - Bits to skip (0-7)
     */
     skip(bytes, bits) {
-        this.check_size(bytes, bits);
-        this.offset += (bytes || 0);
-        this.bitoffset += (bits || 0) % 8;
+        return skip(this, bytes, bits);
     }
     /**
-    * Move current write byte or bit position, will extend data if outside of current size
+    * Offset current byte or bit position
+    * Note: Will extend array if strict mode is off and outside of max size
     *
-    * @param {number} bytes - bytes to skip
-    * @param {number} bits - bits to skip (0-7)
+    * @param {number} bytes - Bytes to skip
+    * @param {number} bits - Bits to skip (0-7)
     */
-    fskip(bytes, bits) {
-        this.check_size(bytes, bits);
-        this.offset += (bytes || 0);
-        this.bitoffset += (bits || 0) % 8;
+    jump(bytes, bits) {
+        this.skip(bytes, bits);
     }
+    //
+    // directly set current position
+    //
     /**
-    * Change current byte or bit write position, will extend data if outside of current size
+    * Change position directly to address
+    * Note: Will extend array if strict mode is off and outside of max size
     *
-    * @param {number} byte - byte to jump to
-    * @param {number} bit - bit to jump to (0-7)
+    * @param {number} byte - byte to set to
+    * @param {number} bit - bit to set to (0-7)
     */
     goto(byte, bit) {
-        const new_size = (byte + Math.ceil((bit || 0) / 8));
-        if (new_size > this.size && this.strict == false) {
-            this.extendArray(new_size - this.size);
-        }
-        else {
-            throw new Error("Outside of range of data: " + this.size);
-        }
-        this.offset = byte;
-        this.bitoffset = (bit || 0) % 8;
+        return goto(this, byte, bit);
     }
     /**
-    * Change current byte or bit write position, will extend data if outside of current size
+    * Change position directly to address
+    * Note: Will extend array if strict mode is off and outside of max size
     *
-    * @param {number} byte - byte to jump to
-    * @param {number} bit - bit to jump to (0-7)
+    * @param {number} byte - byte to set to
+    * @param {number} bit - bit to set to (0-7)
     */
     seek(byte, bit) {
         return this.goto(byte, bit);
     }
     /**
-    * Change current byte or bit write position, will extend data if outside of current size
-    *
-    * @param {number} byte - byte to jump to
-    * @param {number} bit - bit to jump to (0-7)
-    */
-    fseek(byte, bit) {
-        return this.goto(byte, bit);
-    }
-    /**
-    * Change current byte or bit write position, will extend data if outside of current size
+    * Change position directly to address
+    * Note: Will extend array if strict mode is off and outside of max size
     *
-    * @param {number} byte - byte to jump to
-    * @param {number} bit - bit to jump to (0-7)
-    */
-    jump(byte, bit) {
-        return this.goto(byte, bit);
-    }
-    /**
-    * Change current byte or bit write position, will extend data if outside of current size
-    *
-    * @param {number} byte - byte to jump to
-    * @param {number} bit - bit to jump to (0-7)
+    * @param {number} byte - byte to set to
+    * @param {number} bit - bit to set to (0-7)
     */
     pointer(byte, bit) {
         return this.goto(byte, bit);
     }
     /**
-    * Change current byte or bit write position, will extend data if outside of current size
+    * Change position directly to address
+    * Note: Will extend array if strict mode is off and outside of max size
     *
-    * @param {number} byte - byte to jump to
-    * @param {number} bit - bit to jump to (0-7)
+    * @param {number} byte - byte to set to
+    * @param {number} bit - bit to set to (0-7)
     */
     warp(byte, bit) {
         return this.goto(byte, bit);
     }
+    //
+    //go to start
+    //
     /**
-    * Change current byte or bit write position, will extend data if outside of current size
-    *
-    * @param {number} byte - byte to jump to
-    * @param {number} bit - bit to jump to (0-7)
-    */
-    fsetpos(byte, bit) {
-        return this.goto(byte, bit);
-    }
-    /**
-    * Set offset to start of file
+    * Set byte and bit position to start of data
     */
     rewind() {
         this.offset = 0;
         this.bitoffset = 0;
     }
     /**
-    * Set offset to start of file
+    * Set byte and bit position to start of data
     */
     gotostart() {
         this.offset = 0;
         this.bitoffset = 0;
     }
-    /**
-    * Set offset to start of file
-    */
-    tostart() {
-        this.offset = 0;
-        this.bitoffset = 0;
-    }
-    /**
-    * Get the current byte position
-    *
-    * @return {number} current byte position
-    */
-    ftell() {
-        return this.offset;
-    }
+    //
+    //get position
+    //
     /**
     * Get the current byte position
     *
@@ -294,7 +241,7 @@ export class biwriter {
     *
     * @return {number} current byte position
     */
-    fgetpos() {
+    getOffset() {
         return this.offset;
     }
     /**
@@ -305,131 +252,201 @@ export class biwriter {
     saveOffset() {
         return this.offset;
     }
+    //
+    //strict mode change
+    //
     /**
-    * Disallows extending array if writing outside of max size
+    * Disallows extending data if position is outside of max size
     */
     restrict() {
         this.strict = true;
     }
     /**
-    * Allows extending array if writing outside of max size
+    * Allows extending data if position is outside of max size
     */
     unrestrict() {
         this.strict = false;
     }
+    //
+    //remove part of data
+    //
     /**
-    * Truncates array from start to current position unless supplied
-    * Note: Does not affect supplied data
-    * Note: Will extend array if strict mode is off
-    * @param {number} startOffset - Start location, default 0
-    * @param {number} endOffset - end location, default current write position
-    */
-    clip(startOffset, endOffset) {
-        if ((endOffset || this.offset) > this.size) {
-            if (this.strict == false) {
-                this.extendArray((endOffset || this.offset) - this.size);
-            }
-            else {
-                throw new Error("End offset outside of data: " + this.size);
-            }
-        }
-        return this.data.slice(Math.abs(startOffset || 0), endOffset || this.offset);
+    * Deletes part of data from start to current byte position unless supplied, returns removed
+    * Note: Errors in strict mode
+    *
+    * @param {number} startOffset - Start location (default 0)
+    * @param {number} endOffset - End location (default current position)
+    * @param {boolean} consume - Move position to end of removed data (default false)
+    * @returns {Buffer|Uint8Array} Removed data as ``Buffer`` or ``Uint8Array``
+    */
+    delete(startOffset, endOffset, consume) {
+        return remove(this, startOffset || 0, endOffset || this.offset, consume || false, true);
     }
     /**
-    * Truncates array from start to current position unless supplied
-    * Note: Does not affect supplied data
-    * Note: Will extend array if strict mode is off
-    * @param {number} startOffset - Start location, default 0
-    * @param {number} endOffset - end location, default current write position
-    */
-    crop(startOffset, endOffset) {
-        if ((endOffset || this.offset) > this.size) {
-            if (this.strict == false) {
-                this.extendArray((endOffset || this.offset) - this.size);
-            }
-            else {
-                throw new Error("End offset outside of data: " + this.size);
-            }
-        }
-        return this.data.slice(Math.abs(startOffset || 0), endOffset || this.offset);
+    * Deletes part of data from start to current byte position unless supplied, returns removed
+    * Note: Errors in strict mode
+    *
+    * @param {number} startOffset - Start location (default 0)
+    * @param {number} endOffset - End location (default current position)
+    * @param {boolean} consume - Move position to end of removed data (default false)
+    * @returns {Buffer|Uint8Array} Removed data as ``Buffer`` or ``Uint8Array``
+    */
+    clip(startOffset, endOffset, consume) {
+        return remove(this, startOffset || 0, endOffset || this.offset, consume || false, true);
     }
     /**
-    * Truncates array from start to current position unless supplied
-    * Note: Does not affect supplied data
-    * Note: Will extend array if strict mode is off
-    * @param {number} startOffset - Start location, default 0
-    * @param {number} endOffset - end location, default current write position
-    */
-    truncate(startOffset, endOffset) {
-        if ((endOffset || this.offset) > this.size) {
-            if (this.strict == false) {
-                this.extendArray((endOffset || this.offset) - this.size);
-            }
-            else {
-                throw new Error("End offset outside of data: " + this.size);
-            }
-        }
-        return this.data.slice(Math.abs(startOffset || 0), endOffset || this.offset);
+    * Deletes part of data from current byte position to supplied length, returns removed
+    * Note: Errors in strict mode
+    *
+    * @param {number} length - Length of data in bytes to remove
+    * @param {boolean} consume - Move position to end of removed data (default false)
+    * @returns {Buffer|Uint8Array} Removed data as ``Buffer`` or ``Uint8Array``
+    */
+    crop(length, consume) {
+        return remove(this, this.offset, this.offset + (length || 0), consume || false, true);
     }
     /**
-    * Truncates array from start to current position unless supplied
-    * Note: Does not affect supplied data
-    * Note: Will extend array if strict mode is off
-    * @param {number} startOffset - Start location, default 0
-    * @param {number} endOffset - end location, default current write position
-    * @returns {Buffer|Uint8Array} ``Buffer`` or ``Uint8Array``
+    * Deletes part of data from current position to supplied length, returns removed
+    * Note: Only works in strict mode
+    *
+    * @param {number} length - Length of data in bytes to remove
+    * @param {boolean} consume - Move position to end of removed data (default false)
+    * @returns {Buffer|Uint8Array} Removed data as ``Buffer`` or ``Uint8Array``
     */
-    slice(startOffset, endOffset) {
-        if ((endOffset || this.offset) > this.size) {
-            if (this.strict == false) {
-                this.extendArray((endOffset || this.offset) - this.size);
-            }
-            else {
-                throw new Error("End offset outside of data: " + this.size);
-            }
-        }
-        return this.data.slice(Math.abs(startOffset || 0), endOffset || this.offset);
+    drop(length, consume) {
+        return remove(this, this.offset, this.offset + (length || 0), consume || false, true);
     }
+    //
+    //copy out
+    //
     /**
-    * Extract array from current position to length supplied
+    * Returns part of data from current byte position to end of data unless supplied
+    *
+    * @param {number} startOffset - Start location (default current position)
+    * @param {number} endOffset - End location (default end of data)
+    * @param {boolean} consume - Move position to end of lifted data (default false)
+    * @param {number} fillValue - Byte value to to fill returned data (does NOT fill unless supplied)
+    * @returns {Buffer|Uint8Array} Selected data as ```Uint8Array``` or ```Buffer```
+    */
+    lift(startOffset, endOffset, consume, fillValue) {
+        return remove(this, startOffset || this.offset, endOffset || this.size, consume || false, false, fillValue);
+    }
+    /**
+    * Returns part of data from current byte position to end of data unless supplied
+    *
+    * @param {number} startOffset - Start location (default current position)
+    * @param {number} endOffset - End location (default end of data)
+    * @param {boolean} consume - Move position to end of lifted data (default false)
+    * @param {number} fillValue - Byte value to to fill returned data (does NOT fill unless supplied)
+    * @returns {Buffer|Uint8Array} Selected data as ```Uint8Array``` or ```Buffer```
+    */
+    fill(startOffset, endOffset, consume, fillValue) {
+        return remove(this, startOffset || this.offset, endOffset || this.size, consume || false, false, fillValue);
+    }
+    /**
+    * Extract data from current position to length supplied
     * Note: Does not affect supplied data
-    * Note: Will extend array if strict mode is off
-    * @param {number} length - length of data to copy from current offset
-    * @returns {Buffer|Uint8Array} ``Buffer`` or ``Uint8Array``
+    *
+    * @param {number} length - Length of data in bytes to copy from current offset
+    * @param {number} consume - Moves offset to end of length
+    * @returns {Buffer|Uint8Array} Selected data as ```Uint8Array``` or ```Buffer```
     */
-    extract(length) {
-        if (this.offset + (length || 0) > this.size) {
-            if (this.strict == false) {
-                this.extendArray(this.offset + (length || 0) - this.size);
-            }
-            else {
-                throw new Error("End offset outside of data: " + this.size);
-            }
-        }
-        return this.data.slice(this.offset, this.offset + (length || 0));
+    extract(length, consume) {
+        return remove(this, this.offset, length || 0, consume || false, false);
     }
     /**
-    * Extract array from current position to length supplied
+    * Extract data from current position to length supplied
     * Note: Does not affect supplied data
-    * Note: Will extend array if strict mode is off
-    * @param {number} length - length of data to copy from current offset
-    * @returns {Buffer|Uint8Array} ``Buffer`` or ``Uint8Array``
+    *
+    * @param {number} length - Length of data in bytes to copy from current offset
+    * @param {number} consume - Moves offset to end of length
+    * @returns {Buffer|Uint8Array} Selected data as ```Uint8Array``` or ```Buffer```
     */
-    wrap(length) {
-        return this.extract(length);
+    slice(length, consume) {
+        return remove(this, this.offset, length || 0, consume || false, false);
     }
     /**
-    * Extract array from current position to length supplied
+    * Extract data from current position to length supplied
     * Note: Does not affect supplied data
-    * Note: Will extend array if strict mode is off
-    * @param {number} length - length of data to copy from current offset
-    * @returns {Buffer|Uint8Array} ``Buffer`` or ``Uint8Array``
+    *
+    * @param {number} length - Length of data in bytes to copy from current offset
+    * @param {number} consume - Moves offset to end of length
+    * @returns {Buffer|Uint8Array} Selected data as ```Uint8Array``` or ```Buffer```
+    */
+    wrap(length, consume) {
+        return remove(this, this.offset, length || 0, consume || false, false);
+    }
+    //
+    //insert
+    //
+    /**
+    * Inserts data into data
+    * Note: Must be same data type as supplied data. Errors on strict mode.
+    *
+    * @param {Buffer|Uint8Array} data - ```Uint8Array``` or ```Buffer``` to add to data
+    * @param {boolean} consume - Move current write position to end of data (default false)
+    * @param {number} offset - Offset to add it at (defaults to current position)
+    */
+    insert(data, consume, offset) {
+        return addData(this, data, consume || false, offset || this.offset);
+    }
+    /**
+    * Inserts data into data
+    * Note: Must be same data type as supplied data. Errors on strict mode.
+    *
+    * @param {Buffer|Uint8Array} data - ```Uint8Array``` or ```Buffer``` to add to data
+    * @param {boolean} consume - Move current write position to end of data (default false)
+    * @param {number} offset - Offset to add it at (defaults to current position)
+    */
+    place(data, consume, offset) {
+        return addData(this, data, consume || false, offset || this.offset);
+    }
+    /**
+    * Adds data to start of supplied data
+    * Note: Must be same data type as supplied data. Errors on strict mode.
+    *
+    * @param {Buffer|Uint8Array} data - ```Uint8Array``` or ```Buffer``` to add to data
+    * @param {boolean} consume - Move current write position to end of data (default false)
+    */
+    unshift(data, consume) {
+        return addData(this, data, consume || false, 0);
+    }
+    /**
+    * Adds data to start of supplied data
+    * Note: Must be same data type as supplied data. Errors on strict mode.
+    *
+    * @param {Buffer|Uint8Array} data - ```Uint8Array``` or ```Buffer``` to add to data
+    * @param {boolean} consume - Move current write position to end of data (default false)
+    */
+    prepend(data, consume) {
+        return addData(this, data, consume || false, 0);
+    }
+    /**
+    * Adds data to end of supplied data
+    * Note: Must be same data type as supplied data. Errors on strict mode.
+    *
+    * @param {Buffer|Uint8Array} data - ```Uint8Array``` or ```Buffer``` to add to data
+    * @param {boolean} consume - Move current write position to end of data (default false)
     */
-    lift(length) {
-        return this.extract(length);
+    push(data, consume) {
+        return addData(this, data, consume || false, this.size);
     }
     /**
+    * Adds data to end of supplied data
+    * Note: Must be same data type as supplied data. Errors on strict mode.
+    *
+    * @param {Buffer|Uint8Array} data - ```Uint8Array``` or ```Buffer``` to add to data
+    * @param {boolean} consume - Move current write position to end of data (default false)
+    */
+    append(data, consume) {
+        return addData(this, data, consume || false, this.size);
+    }
+    //
+    //finishing
+    //
+    /**
     * Returns current data
+    *
     * @returns {Buffer|Uint8Array} ``Buffer`` or ``Uint8Array``
     */
     get() {
@@ -437,35 +454,63 @@ export class biwriter {
     }
     /**
     * Returns current data
+    *
     * @returns {Buffer|Uint8Array} ``Buffer`` or ``Uint8Array``
     */
     return() {
         return this.data;
     }
     /**
-    * removes writing data
+    * removes data
     */
     end() {
         this.data = undefined;
     }
     /**
-    * removes writing data
+    * removes data
     */
     close() {
         this.data = undefined;
     }
     /**
-    * removes writing data
+    * removes data
     */
     done() {
         this.data = undefined;
     }
     /**
-    * removes writing data
+    * removes data
     */
     finished() {
         this.data = undefined;
     }
+    /**
+    * Console logs data as hex dump
+    *
+    * @param {object} options - options object
+    * ```javascript
+    *   {
+    *       length: 192, // number of bytes to log, default 192 or end of data
+    *       startByte: 0, // byte to start dump, default current position
+    *       supressUnicode: false // Supress unicode character preview for cleaner columns
+    *   }
+    * ```
+    */
+    hexdump(options) {
+        return hexDump(this, options);
+    }
+    /**
+    * Turn hexdump on error off (default on)
+    */
+    errorDumpOff() {
+        this.errorDump = false;
+    }
+    /**
+    * Turn hexdump on error on (default on)
+    */
+    errorDumpOn() {
+        this.errorDump = true;
+    }
     //
     //bit writer
     //
@@ -494,6 +539,7 @@ export class biwriter {
         }
         if (unsigned == true) {
             if (value < 0 || value > Math.pow(2, bits)) {
+                this.errorDump ? "[Error], hexdump:\n" + this.hexdump() : "";
                 throw new Error(`Value is out of range for the specified ${bits}bit length.` + " min: " + 0 + " max: " + Math.pow(2, bits) + " value: " + value);
             }
         }
@@ -501,6 +547,7 @@ export class biwriter {
             const maxValue = Math.pow(2, bits - 1) - 1;
             const minValue = -maxValue - 1;
             if (value < minValue || value > maxValue) {
+                this.errorDump ? "[Error], hexdump:\n" + this.hexdump() : "";
                 throw new Error(`Value is out of range for the specified ${bits}bit length.` + " min: " + minValue + " max: " + maxValue + " value: " + value);
             }
         }
@@ -557,22 +604,22 @@ export class biwriter {
         return this.writeBit(value, bits, offsetBits, offsetBytes, unsigned, endian);
     }
     /**
-* Bit field writer
-*
-* Note: When returning to a byte read, remaining bits are dropped
-*
-* @param {number} value - value as int
-* @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
-* @param {number} offsetBytes - byte offset to start the write (default last write position)
-* @param {boolean} unsigned - if value is unsigned or not
-*/
+    * Bit field writer
+    *
+    * Note: When returning to a byte write, remaining bits are dropped
+    *
+    * @param {number} value - value as int
+    * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
+    * @param {number} offsetBytes - byte offset to start the write (default last write position)
+    * @param {boolean} unsigned - if value is unsigned or not
+    */
     bit1(value, offsetBits, offsetBytes, unsigned) {
         return this.bit(value, 1, offsetBits, offsetBytes, unsigned);
     }
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -584,7 +631,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -597,7 +644,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -609,7 +656,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -622,7 +669,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -634,7 +681,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -647,7 +694,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -659,7 +706,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -672,7 +719,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -684,7 +731,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -697,7 +744,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -709,7 +756,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -722,7 +769,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -734,7 +781,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -747,7 +794,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -759,7 +806,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -772,7 +819,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -784,7 +831,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -797,7 +844,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -809,7 +856,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -822,7 +869,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -834,7 +881,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -847,7 +894,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -859,7 +906,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -872,7 +919,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -884,7 +931,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -897,7 +944,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -909,7 +956,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -922,7 +969,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -934,7 +981,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -947,7 +994,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -959,7 +1006,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -972,7 +1019,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -984,7 +1031,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -997,7 +1044,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1009,7 +1056,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1022,7 +1069,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1034,7 +1081,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1047,7 +1094,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1059,7 +1106,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1072,7 +1119,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1084,7 +1131,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1097,7 +1144,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1109,7 +1156,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1122,7 +1169,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1134,7 +1181,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1147,7 +1194,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1159,7 +1206,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1172,7 +1219,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1184,7 +1231,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1197,7 +1244,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1209,7 +1256,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1222,7 +1269,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1234,7 +1281,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1247,7 +1294,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1259,7 +1306,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1272,7 +1319,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1284,7 +1331,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1297,7 +1344,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1309,7 +1356,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1322,7 +1369,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1334,7 +1381,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1347,7 +1394,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1359,7 +1406,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1372,7 +1419,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1384,7 +1431,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1397,7 +1444,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1409,7 +1456,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1422,7 +1469,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1434,7 +1481,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1447,7 +1494,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1459,7 +1506,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1472,7 +1519,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1484,7 +1531,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1497,7 +1544,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1509,7 +1556,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1522,7 +1569,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1534,7 +1581,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1547,7 +1594,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1559,7 +1606,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1572,7 +1619,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1584,7 +1631,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1597,7 +1644,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1609,7 +1656,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1622,7 +1669,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1634,7 +1681,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1647,7 +1694,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1659,7 +1706,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1672,7 +1719,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1684,7 +1731,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1697,7 +1744,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1709,7 +1756,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1722,7 +1769,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1734,7 +1781,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1747,7 +1794,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1759,7 +1806,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1772,7 +1819,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1784,7 +1831,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1797,7 +1844,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1809,7 +1856,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1822,7 +1869,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1834,7 +1881,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1847,7 +1894,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1859,7 +1906,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1872,7 +1919,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1884,7 +1931,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1897,7 +1944,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1909,7 +1956,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1922,7 +1969,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1934,7 +1981,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1947,7 +1994,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1959,7 +2006,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1972,7 +2019,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1984,7 +2031,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1997,7 +2044,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2009,7 +2056,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2022,7 +2069,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2034,7 +2081,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2047,7 +2094,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2059,7 +2106,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2072,7 +2119,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2084,7 +2131,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2097,7 +2144,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2109,7 +2156,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2122,7 +2169,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2134,7 +2181,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2147,7 +2194,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2159,7 +2206,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2172,7 +2219,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2184,7 +2231,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2197,7 +2244,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2209,7 +2256,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2222,7 +2269,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2234,7 +2281,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2247,7 +2294,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2259,7 +2306,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2272,7 +2319,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2284,7 +2331,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2297,7 +2344,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2309,7 +2356,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2322,7 +2369,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2334,7 +2381,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2347,7 +2394,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2359,7 +2406,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2372,7 +2419,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2384,7 +2431,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2397,7 +2444,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2409,7 +2456,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2422,7 +2469,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2434,7 +2481,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2447,7 +2494,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2459,7 +2506,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2472,7 +2519,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2484,7 +2531,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2497,7 +2544,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2509,7 +2556,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2522,7 +2569,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2534,7 +2581,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2547,7 +2594,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2559,7 +2606,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2572,7 +2619,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2584,7 +2631,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2597,7 +2644,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2609,7 +2656,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2622,7 +2669,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2634,7 +2681,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2647,7 +2694,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2659,7 +2706,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2672,7 +2719,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2684,7 +2731,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2697,7 +2744,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2709,7 +2756,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2722,7 +2769,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2734,7 +2781,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2747,7 +2794,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2759,7 +2806,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2772,7 +2819,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2784,7 +2831,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2797,7 +2844,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2809,7 +2856,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2822,7 +2869,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2834,7 +2881,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2847,7 +2894,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2859,7 +2906,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2872,7 +2919,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2884,7 +2931,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2897,7 +2944,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2909,7 +2956,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2922,7 +2969,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2934,7 +2981,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2947,7 +2994,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2959,7 +3006,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} bits - number of bits to write
@@ -2973,7 +3020,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} bits - number of bits to write
@@ -2987,7 +3034,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} bits - number of bits to write
@@ -3001,7 +3048,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} bits - number of bits to write
@@ -3026,6 +3073,7 @@ export class biwriter {
         this.check_size(1, 0, offset);
         if (unsigned == true) {
             if (value < 0 || value > 255) {
+                this.errorDump ? "[Error], hexdump:\n" + this.hexdump() : "";
                 throw new Error('Value is out of range for the specified 8bit length.' + " min: " + 0 + " max: " + 255 + " value: " + value);
             }
         }
@@ -3033,6 +3081,7 @@ export class biwriter {
             const maxValue = Math.pow(2, 8 - 1) - 1;
             const minValue = -maxValue - 1;
             if (value < minValue || value > maxValue) {
+                this.errorDump ? "[Error], hexdump:\n" + this.hexdump() : "";
                 throw new Error('Value is out of range for the specified 8bit length.' + " min: " + minValue + " max: " + maxValue + " value: " + value);
             }
         }
@@ -3101,6 +3150,7 @@ export class biwriter {
         this.check_size(2, 0, offset);
         if (unsigned == true) {
             if (value < 0 || value > 65535) {
+                this.errorDump ? "[Error], hexdump:\n" + this.hexdump() : "";
                 throw new Error('Value is out of range for the specified 16bit length.' + " min: " + 0 + " max: " + 65535 + " value: " + value);
             }
         }
@@ -3108,6 +3158,7 @@ export class biwriter {
             const maxValue = Math.pow(2, 16 - 1) - 1;
             const minValue = -maxValue - 1;
             if (value < minValue || value > maxValue) {
+                this.errorDump ? "[Error], hexdump:\n" + this.hexdump() : "";
                 throw new Error('Value is out of range for the specified 16bit length.' + " min: " + minValue + " max: " + maxValue + " value: " + value);
             }
         }
@@ -3353,6 +3404,7 @@ export class biwriter {
         const maxValue = 65504;
         const minValue = 5.96e-08;
         if (value < minValue || value > maxValue) {
+            this.errorDump ? "[Error], hexdump:\n" + this.hexdump() : "";
             throw new Error('Value is out of range for the specified half float length.' + " min: " + minValue + " max: " + maxValue + " value: " + value);
         }
         const signMask = 0x8000;
@@ -3478,6 +3530,7 @@ export class biwriter {
         this.check_size(4, 0, offset);
         if (unsigned == true) {
             if (value < 0 || value > 4294967295) {
+                this.errorDump ? "[Error], hexdump:\n" + this.hexdump() : "";
                 throw new Error('Value is out of range for the specified 32bit length.' + " min: " + 0 + " max: " + 4294967295 + " value: " + value);
             }
         }
@@ -3485,6 +3538,7 @@ export class biwriter {
             const maxValue = Math.pow(2, 32 - 1) - 1;
             const minValue = -maxValue - 1;
             if (value < minValue || value > maxValue) {
+                this.errorDump ? "[Error], hexdump:\n" + this.hexdump() : "";
                 throw new Error('Value is out of range for the specified 32bit length.' + " min: " + minValue + " max: " + maxValue + " value: " + value);
             }
         }
@@ -3791,6 +3845,7 @@ export class biwriter {
         const maxValue = 3.402823466e+38;
         const minValue = 1.175494351e-38;
         if (value < minValue || value > maxValue) {
+            this.errorDump ? "[Error], hexdump:\n" + this.hexdump() : "";
             throw new Error('Value is out of range for the specified float length.' + " min: " + minValue + " max: " + maxValue + " value: " + value);
         }
         let intValue = Float32Array.from([value])[0]; // Convert float to 32-bit integer representation
@@ -3867,6 +3922,7 @@ export class biwriter {
         this.check_size(8, 0, offset);
         if (unsigned == true) {
             if (value < 0 || value > Math.pow(2, 64) - 1) {
+                this.errorDump ? "[Error], hexdump:\n" + this.hexdump() : "";
                 throw new Error('Value is out of range for the specified 64bit length.' + " min: " + 0 + " max: " + (Math.pow(2, 64) - 1) + " value: " + value);
             }
         }
@@ -3874,6 +3930,7 @@ export class biwriter {
             const maxValue = Math.pow(2, 63) - 1;
             const minValue = -Math.pow(2, 63);
             if (value < minValue || value > maxValue) {
+                this.errorDump ? "[Error], hexdump:\n" + this.hexdump() : "";
                 throw new Error('Value is out of range for the specified 64bit length.' + " min: " + minValue + " max: " + maxValue + " value: " + value);
             }
         }
@@ -4132,7 +4189,7 @@ export class biwriter {
         return this.writeInt64(value, offset, true, "big");
     }
     //
-    //doublefloat reader
+    //doublefloat
     //
     /**
     * Writes double float
@@ -4146,6 +4203,7 @@ export class biwriter {
         const maxValue = 1.7976931348623158e308;
         const minValue = 2.2250738585072014e-308;
         if (value < minValue || value > maxValue) {
+            this.errorDump ? "[Error], hexdump:\n" + this.hexdump() : "";
             throw new Error('Value is out of range for the specified 64bit length.' + " min: " + minValue + " max: " + maxValue + " value: " + value);
         }
         const intArray = new Int32Array(2);
@@ -4336,9 +4394,11 @@ export class biwriter {
                 maxLength = 4294967295;
             }
             else {
-                throw new Error("Invalid length read size: " + lengthWriteSize);
+                this.errorDump ? "[Error], hexdump:\n" + this.hexdump() : "";
+                throw new Error("Invalid length write size: " + lengthWriteSize);
             }
             if (string.length > maxLength || (length || 0) > maxLength) {
+                this.errorDump ? "[Error], hexdump:\n" + this.hexdump() : "";
                 throw new Error("String outsize of max write length: " + maxLength);
             }
             var maxBytes = Math.min(string.length, maxLength);
@@ -4377,7 +4437,7 @@ export class biwriter {
             this.offset += totalLength;
         }
         else {
-            throw new Error('Unsupported string type.');
+            throw new Error('Unsupported string type: ' + stringType);
         }
     }
     /**