bireader 1.0.13 → 1.0.15

package/lib/cjs/src/writer.js

@@ -1,14 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.biwriter = void 0;
+const common_1 = require("./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)
 */
 class biwriter {
     isBuffer(obj) {
@@ -21,43 +22,25 @@ 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 (0, common_1.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";
@@ -65,6 +48,7 @@ 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");
@@ -96,7 +80,7 @@ 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");
             }
         }
@@ -104,8 +88,7 @@ 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
     *
@@ -121,169 +104,133 @@ 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 (0, common_1.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 (0, common_1.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
     *
@@ -297,7 +244,7 @@ class biwriter {
     *
     * @return {number} current byte position
     */
-    fgetpos() {
+    getOffset() {
         return this.offset;
     }
     /**
@@ -308,131 +255,201 @@ 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 (0, common_1.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 (0, common_1.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 (0, common_1.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 (0, common_1.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 (0, common_1.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 (0, common_1.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 (0, common_1.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 (0, common_1.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 (0, common_1.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 (0, common_1.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 (0, common_1.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 (0, common_1.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 (0, common_1.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 (0, common_1.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 (0, common_1.addData)(this, data, consume || false, this.size);
+    }
+    //
+    //finishing
+    //
+    /**
     * Returns current data
+    *
     * @returns {Buffer|Uint8Array} ``Buffer`` or ``Uint8Array``
     */
     get() {
@@ -440,35 +457,63 @@ 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 (0, common_1.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
     //
@@ -497,6 +542,7 @@ 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);
             }
         }
@@ -504,6 +550,7 @@ 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);
             }
         }
@@ -560,22 +607,22 @@ 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)
@@ -587,7 +634,7 @@ 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)
@@ -600,7 +647,7 @@ 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)
@@ -612,7 +659,7 @@ 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)
@@ -625,7 +672,7 @@ 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)
@@ -637,7 +684,7 @@ 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)
@@ -650,7 +697,7 @@ 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)
@@ -662,7 +709,7 @@ 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)
@@ -675,7 +722,7 @@ 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)
@@ -687,7 +734,7 @@ 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)
@@ -700,7 +747,7 @@ 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)
@@ -712,7 +759,7 @@ 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)
@@ -725,7 +772,7 @@ 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)
@@ -737,7 +784,7 @@ 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)
@@ -750,7 +797,7 @@ 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)
@@ -762,7 +809,7 @@ 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)
@@ -775,7 +822,7 @@ 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)
@@ -787,7 +834,7 @@ 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)
@@ -800,7 +847,7 @@ 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)
@@ -812,7 +859,7 @@ 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)
@@ -825,7 +872,7 @@ 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)
@@ -837,7 +884,7 @@ 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)
@@ -850,7 +897,7 @@ 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)
@@ -862,7 +909,7 @@ 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)
@@ -875,7 +922,7 @@ 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)
@@ -887,7 +934,7 @@ 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)
@@ -900,7 +947,7 @@ 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)
@@ -912,7 +959,7 @@ 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)
@@ -925,7 +972,7 @@ 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)
@@ -937,7 +984,7 @@ 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)
@@ -950,7 +997,7 @@ 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)
@@ -962,7 +1009,7 @@ 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)
@@ -975,7 +1022,7 @@ 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)
@@ -987,7 +1034,7 @@ 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)
@@ -1000,7 +1047,7 @@ 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)
@@ -1012,7 +1059,7 @@ 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)
@@ -1025,7 +1072,7 @@ 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)
@@ -1037,7 +1084,7 @@ 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)
@@ -1050,7 +1097,7 @@ 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)
@@ -1062,7 +1109,7 @@ 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)
@@ -1075,7 +1122,7 @@ 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)
@@ -1087,7 +1134,7 @@ 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)
@@ -1100,7 +1147,7 @@ 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)
@@ -1112,7 +1159,7 @@ 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)
@@ -1125,7 +1172,7 @@ 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)
@@ -1137,7 +1184,7 @@ 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)
@@ -1150,7 +1197,7 @@ 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)
@@ -1162,7 +1209,7 @@ 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)
@@ -1175,7 +1222,7 @@ 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)
@@ -1187,7 +1234,7 @@ 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)
@@ -1200,7 +1247,7 @@ 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)
@@ -1212,7 +1259,7 @@ 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)
@@ -1225,7 +1272,7 @@ 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)
@@ -1237,7 +1284,7 @@ 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)
@@ -1250,7 +1297,7 @@ 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)
@@ -1262,7 +1309,7 @@ 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)
@@ -1275,7 +1322,7 @@ 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)
@@ -1287,7 +1334,7 @@ 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)
@@ -1300,7 +1347,7 @@ 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)
@@ -1312,7 +1359,7 @@ 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)
@@ -1325,7 +1372,7 @@ 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)
@@ -1337,7 +1384,7 @@ 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)
@@ -1350,7 +1397,7 @@ 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)
@@ -1362,7 +1409,7 @@ 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)
@@ -1375,7 +1422,7 @@ 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)
@@ -1387,7 +1434,7 @@ 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)
@@ -1400,7 +1447,7 @@ 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)
@@ -1412,7 +1459,7 @@ 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)
@@ -1425,7 +1472,7 @@ 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)
@@ -1437,7 +1484,7 @@ 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)
@@ -1450,7 +1497,7 @@ 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)
@@ -1462,7 +1509,7 @@ 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)
@@ -1475,7 +1522,7 @@ 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)
@@ -1487,7 +1534,7 @@ 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)
@@ -1500,7 +1547,7 @@ 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)
@@ -1512,7 +1559,7 @@ 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)
@@ -1525,7 +1572,7 @@ 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)
@@ -1537,7 +1584,7 @@ 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)
@@ -1550,7 +1597,7 @@ 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)
@@ -1562,7 +1609,7 @@ 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)
@@ -1575,7 +1622,7 @@ 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)
@@ -1587,7 +1634,7 @@ 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)
@@ -1600,7 +1647,7 @@ 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)
@@ -1612,7 +1659,7 @@ 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)
@@ -1625,7 +1672,7 @@ 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)
@@ -1637,7 +1684,7 @@ 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)
@@ -1650,7 +1697,7 @@ 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)
@@ -1662,7 +1709,7 @@ 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)
@@ -1675,7 +1722,7 @@ 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)
@@ -1687,7 +1734,7 @@ 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)
@@ -1700,7 +1747,7 @@ 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)
@@ -1712,7 +1759,7 @@ 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)
@@ -1725,7 +1772,7 @@ 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)
@@ -1737,7 +1784,7 @@ 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)
@@ -1750,7 +1797,7 @@ 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)
@@ -1762,7 +1809,7 @@ 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)
@@ -1775,7 +1822,7 @@ 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)
@@ -1787,7 +1834,7 @@ 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)
@@ -1800,7 +1847,7 @@ 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)
@@ -1812,7 +1859,7 @@ 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)
@@ -1825,7 +1872,7 @@ 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)
@@ -1837,7 +1884,7 @@ 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)
@@ -1850,7 +1897,7 @@ 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)
@@ -1862,7 +1909,7 @@ 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)
@@ -1875,7 +1922,7 @@ 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)
@@ -1887,7 +1934,7 @@ 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)
@@ -1900,7 +1947,7 @@ 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)
@@ -1912,7 +1959,7 @@ 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)
@@ -1925,7 +1972,7 @@ 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)
@@ -1937,7 +1984,7 @@ 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)
@@ -1950,7 +1997,7 @@ 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)
@@ -1962,7 +2009,7 @@ 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)
@@ -1975,7 +2022,7 @@ 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)
@@ -1987,7 +2034,7 @@ 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)
@@ -2000,7 +2047,7 @@ 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)
@@ -2012,7 +2059,7 @@ 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)
@@ -2025,7 +2072,7 @@ 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)
@@ -2037,7 +2084,7 @@ 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)
@@ -2050,7 +2097,7 @@ 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)
@@ -2062,7 +2109,7 @@ 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)
@@ -2075,7 +2122,7 @@ 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)
@@ -2087,7 +2134,7 @@ 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)
@@ -2100,7 +2147,7 @@ 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)
@@ -2112,7 +2159,7 @@ 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)
@@ -2125,7 +2172,7 @@ 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)
@@ -2137,7 +2184,7 @@ 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)
@@ -2150,7 +2197,7 @@ 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)
@@ -2162,7 +2209,7 @@ 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)
@@ -2175,7 +2222,7 @@ 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)
@@ -2187,7 +2234,7 @@ 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)
@@ -2200,7 +2247,7 @@ 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)
@@ -2212,7 +2259,7 @@ 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)
@@ -2225,7 +2272,7 @@ 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)
@@ -2237,7 +2284,7 @@ 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)
@@ -2250,7 +2297,7 @@ 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)
@@ -2262,7 +2309,7 @@ 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)
@@ -2275,7 +2322,7 @@ 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)
@@ -2287,7 +2334,7 @@ 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)
@@ -2300,7 +2347,7 @@ 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)
@@ -2312,7 +2359,7 @@ 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)
@@ -2325,7 +2372,7 @@ 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)
@@ -2337,7 +2384,7 @@ 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)
@@ -2350,7 +2397,7 @@ 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)
@@ -2362,7 +2409,7 @@ 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)
@@ -2375,7 +2422,7 @@ 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)
@@ -2387,7 +2434,7 @@ 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)
@@ -2400,7 +2447,7 @@ 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)
@@ -2412,7 +2459,7 @@ 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)
@@ -2425,7 +2472,7 @@ 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)
@@ -2437,7 +2484,7 @@ 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)
@@ -2450,7 +2497,7 @@ 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)
@@ -2462,7 +2509,7 @@ 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)
@@ -2475,7 +2522,7 @@ 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)
@@ -2487,7 +2534,7 @@ 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)
@@ -2500,7 +2547,7 @@ 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)
@@ -2512,7 +2559,7 @@ 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)
@@ -2525,7 +2572,7 @@ 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)
@@ -2537,7 +2584,7 @@ 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)
@@ -2550,7 +2597,7 @@ 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)
@@ -2562,7 +2609,7 @@ 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)
@@ -2575,7 +2622,7 @@ 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)
@@ -2587,7 +2634,7 @@ 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)
@@ -2600,7 +2647,7 @@ 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)
@@ -2612,7 +2659,7 @@ 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)
@@ -2625,7 +2672,7 @@ 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)
@@ -2637,7 +2684,7 @@ 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)
@@ -2650,7 +2697,7 @@ 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)
@@ -2662,7 +2709,7 @@ 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)
@@ -2675,7 +2722,7 @@ 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)
@@ -2687,7 +2734,7 @@ 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)
@@ -2700,7 +2747,7 @@ 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)
@@ -2712,7 +2759,7 @@ 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)
@@ -2725,7 +2772,7 @@ 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)
@@ -2737,7 +2784,7 @@ 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)
@@ -2750,7 +2797,7 @@ 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)
@@ -2762,7 +2809,7 @@ 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)
@@ -2775,7 +2822,7 @@ 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)
@@ -2787,7 +2834,7 @@ 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)
@@ -2800,7 +2847,7 @@ 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)
@@ -2812,7 +2859,7 @@ 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)
@@ -2825,7 +2872,7 @@ 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)
@@ -2837,7 +2884,7 @@ 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)
@@ -2850,7 +2897,7 @@ 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)
@@ -2862,7 +2909,7 @@ 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)
@@ -2875,7 +2922,7 @@ 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)
@@ -2887,7 +2934,7 @@ 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)
@@ -2900,7 +2947,7 @@ 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)
@@ -2912,7 +2959,7 @@ 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)
@@ -2925,7 +2972,7 @@ 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)
@@ -2937,7 +2984,7 @@ 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)
@@ -2950,7 +2997,7 @@ 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)
@@ -2962,7 +3009,7 @@ 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
@@ -2976,7 +3023,7 @@ 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
@@ -2990,7 +3037,7 @@ 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
@@ -3004,7 +3051,7 @@ 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
@@ -3029,6 +3076,7 @@ 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);
             }
         }
@@ -3036,6 +3084,7 @@ 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);
             }
         }
@@ -3104,6 +3153,7 @@ 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);
             }
         }
@@ -3111,6 +3161,7 @@ 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);
             }
         }
@@ -3356,6 +3407,7 @@ 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;
@@ -3481,6 +3533,7 @@ 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);
             }
         }
@@ -3488,6 +3541,7 @@ 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);
             }
         }
@@ -3794,6 +3848,7 @@ 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
@@ -3870,6 +3925,7 @@ 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);
             }
         }
@@ -3877,6 +3933,7 @@ 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);
             }
         }
@@ -4135,7 +4192,7 @@ class biwriter {
         return this.writeInt64(value, offset, true, "big");
     }
     //
-    //doublefloat reader
+    //doublefloat
     //
     /**
     * Writes double float
@@ -4149,6 +4206,7 @@ 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);
@@ -4339,9 +4397,11 @@ 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);
@@ -4380,7 +4440,7 @@ class biwriter {
             this.offset += totalLength;
         }
         else {
-            throw new Error('Unsupported string type.');
+            throw new Error('Unsupported string type: ' + stringType);
         }
     }
     /**