bireader 1.0.14 → 1.0.15

package/lib/esm/src/writer.js

@@ -1,11 +1,12 @@
+import { skip, goto, remove, checkSize, addData, hexDump } from './common';
 /**
 * Binary writer, includes bitfields and strings
 *
 * @param {Buffer|Uint8Array} data - ``Buffer`` or ``Uint8Array``. Always found in ``biwriter.data``
-* @param {number} byteOffset - byte offset to start writer, default is 0
-* @param {number} bitOffset - bit offset to start writer, 0-7
-* @param {string} endianness - endianness ``big`` or ``little`` (default little)
-* @param {boolean} strict - strict mode: if true does not extend supplied array on outside write (default false)
+* @param {number} byteOffset - Byte offset to start writer, default is 0
+* @param {number} bitOffset - Bit offset to start writer, 0-7
+* @param {string} endianness - Endianness ``big`` or ``little`` (default little)
+* @param {boolean} strict - Strict mode: if true does not extend supplied array on outside write (default false)
 */
 export class biwriter {
     isBuffer(obj) {
@@ -18,44 +19,25 @@ export class biwriter {
         if ((typeof Buffer !== 'undefined' && this.data instanceof Buffer)) {
             var paddbuffer = Buffer.alloc(to_padd);
             this.data = Buffer.concat([this.data, paddbuffer]);
+            this.size = this.data.length;
         }
         else {
             const addArray = new Array(to_padd);
             this.data = new Uint8Array([...this.data, ...addArray]);
+            this.size = this.data.length;
         }
     }
     check_size(write_bytes, write_bit, offset) {
-        const bits = (write_bit || 0) + this.bitoffset;
-        var new_off = (offset || this.offset);
-        var writesize = write_bytes || 0;
-        if (bits != 0) {
-            //add bits
-            writesize += Math.ceil(bits / 8);
-        }
-        //if biger extend
-        const needed_size = new_off + writesize;
-        if (needed_size > this.size) {
-            const dif = needed_size - this.size;
-            if (this.strict == false) {
-                this.extendArray(dif);
-            }
-            else {
-                this.errorDump ? "[Error], hexdump:\n" + this.hexdump() : "";
-                throw new Error(`Reader reached end of data: reading to ` + needed_size + " at " + this.offset + " of " + this.size);
-            }
-            this.size = this.data.length;
-        }
-        //start read location
-        this.offset = new_off;
+        return checkSize(this, write_bytes || 0, write_bit || 0, offset || this.offset);
     }
     /**
     * Binary writer, includes bitfields and strings
     *
     * @param {Buffer|Uint8Array} data - ``Buffer`` or ``Uint8Array``. Always found in ``biwriter.data``
-    * @param {number} byteOffset - byte offset to start writer, default is 0
-    * @param {number} bitOffset - bit offset to start writer, 0-7
-    * @param {string} endianness - endianness ``big`` or ``little`` (default little)
-    * @param {boolean} strict - strict mode: if true does not extend supplied array on outside write (default false)
+    * @param {number} byteOffset - Byte offset to start writer, default is 0
+    * @param {number} bitOffset - Bit offset to start writer, 0-7
+    * @param {string} endianness - Endianness ``big`` or ``little`` (default little)
+    * @param {boolean} strict - Strict mode: if true does not extend supplied array on outside write (default false)
     */
     constructor(data, byteOffset, bitOffset, endianness, strict) {
         this.endian = "little";
@@ -95,7 +77,7 @@ export class biwriter {
             throw new Error("Data required");
         }
         else {
-            if (!this.isBufferOrUint8Array(this.data)) {
+            if (!this.isBufferOrUint8Array(data)) {
                 throw new Error("Write data must be Uint8Array or Buffer");
             }
         }
@@ -103,8 +85,7 @@ export class biwriter {
         this.size = this.data.length + ((bitOffset || 0) % 8);
     }
     /**
-    *
-    * Change endian, defaults to little
+    * Change endian (default little)
     *
     * Can be changed at any time, doesn't loose position
     *
@@ -120,170 +101,133 @@ export class biwriter {
         this.endian = endian;
     }
     /**
-    *
     * Sets endian to big
+    *
     */
     bigEndian() {
         this.endianness("big");
     }
     /**
-    *
     * Sets endian to big
+    *
     */
     big() {
         this.endianness("big");
     }
     /**
-    *
     * Sets endian to big
+    *
     */
     be() {
         this.endianness("big");
     }
     /**
-    *
     * Sets endian to little
+    *
     */
     littleEndian() {
         this.endianness("little");
     }
     /**
-    *
     * Sets endian to little
+    *
     */
     little() {
         this.endianness("little");
     }
     /**
-    *
     * Sets endian to little
+    *
     */
     le() {
         this.endianness("little");
     }
+    //
+    // move from current position
+    //
     /**
-    * Move current write byte or bit position, will extend data if outside of current size
+    * Offset current byte or bit position
+    * Note: Will extend array if strict mode is off and outside of max size
     *
-    * @param {number} bytes - bytes to skip
-    * @param {number} bits - bits to skip (0-7)
+    * @param {number} bytes - Bytes to skip
+    * @param {number} bits - Bits to skip (0-7)
     */
     skip(bytes, bits) {
-        this.check_size(bytes, bits);
-        this.offset += (bytes || 0);
-        this.bitoffset += (bits || 0) % 8;
+        return skip(this, bytes, bits);
     }
     /**
-    * Move current write byte or bit position, will extend data if outside of current size
+    * Offset current byte or bit position
+    * Note: Will extend array if strict mode is off and outside of max size
     *
-    * @param {number} bytes - bytes to skip
-    * @param {number} bits - bits to skip (0-7)
+    * @param {number} bytes - Bytes to skip
+    * @param {number} bits - Bits to skip (0-7)
     */
-    fskip(bytes, bits) {
-        this.check_size(bytes, bits);
-        this.offset += (bytes || 0);
-        this.bitoffset += (bits || 0) % 8;
+    jump(bytes, bits) {
+        this.skip(bytes, bits);
     }
+    //
+    // directly set current position
+    //
     /**
-    * Change current byte or bit write position, will extend data if outside of current size
+    * Change position directly to address
+    * Note: Will extend array if strict mode is off and outside of max size
     *
-    * @param {number} byte - byte to jump to
-    * @param {number} bit - bit to jump to (0-7)
+    * @param {number} byte - byte to set to
+    * @param {number} bit - bit to set to (0-7)
     */
     goto(byte, bit) {
-        const new_size = (byte + Math.ceil((bit || 0) / 8));
-        if (new_size > this.size && this.strict == false) {
-            this.extendArray(new_size - this.size);
-        }
-        else {
-            this.errorDump ? "[Error], hexdump:\n" + this.hexdump() : "";
-            throw new Error("Outside of range of data: goto " + new_size + " of " + this.size);
-        }
-        this.offset = byte;
-        this.bitoffset = (bit || 0) % 8;
+        return goto(this, byte, bit);
     }
     /**
-    * Change current byte or bit write position, will extend data if outside of current size
+    * Change position directly to address
+    * Note: Will extend array if strict mode is off and outside of max size
     *
-    * @param {number} byte - byte to jump to
-    * @param {number} bit - bit to jump to (0-7)
+    * @param {number} byte - byte to set to
+    * @param {number} bit - bit to set to (0-7)
     */
     seek(byte, bit) {
         return this.goto(byte, bit);
     }
     /**
-    * Change current byte or bit write position, will extend data if outside of current size
-    *
-    * @param {number} byte - byte to jump to
-    * @param {number} bit - bit to jump to (0-7)
-    */
-    fseek(byte, bit) {
-        return this.goto(byte, bit);
-    }
-    /**
-    * Change current byte or bit write position, will extend data if outside of current size
+    * Change position directly to address
+    * Note: Will extend array if strict mode is off and outside of max size
     *
-    * @param {number} byte - byte to jump to
-    * @param {number} bit - bit to jump to (0-7)
-    */
-    jump(byte, bit) {
-        return this.goto(byte, bit);
-    }
-    /**
-    * Change current byte or bit write position, will extend data if outside of current size
-    *
-    * @param {number} byte - byte to jump to
-    * @param {number} bit - bit to jump to (0-7)
+    * @param {number} byte - byte to set to
+    * @param {number} bit - bit to set to (0-7)
     */
     pointer(byte, bit) {
         return this.goto(byte, bit);
     }
     /**
-    * Change current byte or bit write position, will extend data if outside of current size
+    * Change position directly to address
+    * Note: Will extend array if strict mode is off and outside of max size
     *
-    * @param {number} byte - byte to jump to
-    * @param {number} bit - bit to jump to (0-7)
+    * @param {number} byte - byte to set to
+    * @param {number} bit - bit to set to (0-7)
     */
     warp(byte, bit) {
         return this.goto(byte, bit);
     }
+    //
+    //go to start
+    //
     /**
-    * Change current byte or bit write position, will extend data if outside of current size
-    *
-    * @param {number} byte - byte to jump to
-    * @param {number} bit - bit to jump to (0-7)
-    */
-    fsetpos(byte, bit) {
-        return this.goto(byte, bit);
-    }
-    /**
-    * Set offset to start of file
+    * Set byte and bit position to start of data
     */
     rewind() {
         this.offset = 0;
         this.bitoffset = 0;
     }
     /**
-    * Set offset to start of file
+    * Set byte and bit position to start of data
     */
     gotostart() {
         this.offset = 0;
         this.bitoffset = 0;
     }
-    /**
-    * Set offset to start of file
-    */
-    tostart() {
-        this.offset = 0;
-        this.bitoffset = 0;
-    }
-    /**
-    * Get the current byte position
-    *
-    * @return {number} current byte position
-    */
-    ftell() {
-        return this.offset;
-    }
+    //
+    //get position
+    //
     /**
     * Get the current byte position
     *
@@ -297,7 +241,7 @@ export class biwriter {
     *
     * @return {number} current byte position
     */
-    fgetpos() {
+    getOffset() {
         return this.offset;
     }
     /**
@@ -308,143 +252,201 @@ export class biwriter {
     saveOffset() {
         return this.offset;
     }
+    //
+    //strict mode change
+    //
     /**
-    * Disallows extending array if writing outside of max size
+    * Disallows extending data if position is outside of max size
     */
     restrict() {
         this.strict = true;
     }
     /**
-    * Allows extending array if writing outside of max size
+    * Allows extending data if position is outside of max size
     */
     unrestrict() {
         this.strict = false;
     }
+    //
+    //remove part of data
+    //
     /**
-    * Truncates array from start to current position unless supplied
-    * Note: Does not affect supplied data
-    * Note: Will extend array if strict mode is off
-    * @param {number} startOffset - Start location, default 0
-    * @param {number} endOffset - end location, default current write position
-    */
-    clip(startOffset, endOffset) {
-        if ((endOffset || this.offset) > this.size) {
-            if (this.strict == false) {
-                this.extendArray((endOffset || this.offset) - this.size);
-            }
-            else {
-                this.errorDump ? "[Error], hexdump:\n" + this.hexdump() : "";
-                throw new Error("End offset outside of data: endOffset" + endOffset + " of " + this.size);
-            }
-        }
-        return this.data.slice(Math.abs(startOffset || 0), endOffset || this.offset);
+    * Deletes part of data from start to current byte position unless supplied, returns removed
+    * Note: Errors in strict mode
+    *
+    * @param {number} startOffset - Start location (default 0)
+    * @param {number} endOffset - End location (default current position)
+    * @param {boolean} consume - Move position to end of removed data (default false)
+    * @returns {Buffer|Uint8Array} Removed data as ``Buffer`` or ``Uint8Array``
+    */
+    delete(startOffset, endOffset, consume) {
+        return remove(this, startOffset || 0, endOffset || this.offset, consume || false, true);
     }
     /**
-    * Truncates array from start to current position unless supplied
-    * Note: Does not affect supplied data
-    * Note: Will extend array if strict mode is off
-    * @param {number} startOffset - Start location, default 0
-    * @param {number} endOffset - end location, default current write position
-    */
-    crop(startOffset, endOffset) {
-        if ((endOffset || this.offset) > this.size) {
-            if (this.strict == false) {
-                this.extendArray((endOffset || this.offset) - this.size);
-            }
-            else {
-                this.errorDump ? "[Error], hexdump:\n" + this.hexdump() : "";
-                throw new Error("End offset outside of data: endOffset" + endOffset + " of " + this.size);
-            }
-        }
-        return this.data.slice(Math.abs(startOffset || 0), endOffset || this.offset);
+    * Deletes part of data from start to current byte position unless supplied, returns removed
+    * Note: Errors in strict mode
+    *
+    * @param {number} startOffset - Start location (default 0)
+    * @param {number} endOffset - End location (default current position)
+    * @param {boolean} consume - Move position to end of removed data (default false)
+    * @returns {Buffer|Uint8Array} Removed data as ``Buffer`` or ``Uint8Array``
+    */
+    clip(startOffset, endOffset, consume) {
+        return remove(this, startOffset || 0, endOffset || this.offset, consume || false, true);
     }
     /**
-    * Truncates array from start to current position unless supplied
-    * Note: Does not affect supplied data
-    * Note: Will extend array if strict mode is off
-    * @param {number} startOffset - Start location, default 0
-    * @param {number} endOffset - end location, default current write position
-    */
-    truncate(startOffset, endOffset) {
-        if ((endOffset || this.offset) > this.size) {
-            if (this.strict == false) {
-                this.extendArray((endOffset || this.offset) - this.size);
-            }
-            else {
-                this.errorDump ? "[Error], hexdump:\n" + this.hexdump() : "";
-                throw new Error("End offset outside of data: endOffset" + endOffset + " of " + this.size);
-            }
-        }
-        return this.data.slice(Math.abs(startOffset || 0), endOffset || this.offset);
+    * Deletes part of data from current byte position to supplied length, returns removed
+    * Note: Errors in strict mode
+    *
+    * @param {number} length - Length of data in bytes to remove
+    * @param {boolean} consume - Move position to end of removed data (default false)
+    * @returns {Buffer|Uint8Array} Removed data as ``Buffer`` or ``Uint8Array``
+    */
+    crop(length, consume) {
+        return remove(this, this.offset, this.offset + (length || 0), consume || false, true);
     }
     /**
-    * Truncates array from start to current position unless supplied
-    * Note: Does not affect supplied data
-    * Note: Will extend array if strict mode is off
-    * @param {number} startOffset - Start location, default 0
-    * @param {number} endOffset - end location, default current write position
-    * @returns {Buffer|Uint8Array} ``Buffer`` or ``Uint8Array``
+    * Deletes part of data from current position to supplied length, returns removed
+    * Note: Only works in strict mode
+    *
+    * @param {number} length - Length of data in bytes to remove
+    * @param {boolean} consume - Move position to end of removed data (default false)
+    * @returns {Buffer|Uint8Array} Removed data as ``Buffer`` or ``Uint8Array``
     */
-    slice(startOffset, endOffset) {
-        if ((endOffset || this.offset) > this.size) {
-            if (this.strict == false) {
-                this.extendArray((endOffset || this.offset) - this.size);
-            }
-            else {
-                this.errorDump ? "[Error], hexdump:\n" + this.hexdump() : "";
-                throw new Error("End offset outside of data: endOffset" + endOffset + " of " + this.size);
-            }
-        }
-        return this.data.slice(Math.abs(startOffset || 0), endOffset || this.offset);
+    drop(length, consume) {
+        return remove(this, this.offset, this.offset + (length || 0), consume || false, true);
+    }
+    //
+    //copy out
+    //
+    /**
+    * Returns part of data from current byte position to end of data unless supplied
+    *
+    * @param {number} startOffset - Start location (default current position)
+    * @param {number} endOffset - End location (default end of data)
+    * @param {boolean} consume - Move position to end of lifted data (default false)
+    * @param {number} fillValue - Byte value to to fill returned data (does NOT fill unless supplied)
+    * @returns {Buffer|Uint8Array} Selected data as ```Uint8Array``` or ```Buffer```
+    */
+    lift(startOffset, endOffset, consume, fillValue) {
+        return remove(this, startOffset || this.offset, endOffset || this.size, consume || false, false, fillValue);
+    }
+    /**
+    * Returns part of data from current byte position to end of data unless supplied
+    *
+    * @param {number} startOffset - Start location (default current position)
+    * @param {number} endOffset - End location (default end of data)
+    * @param {boolean} consume - Move position to end of lifted data (default false)
+    * @param {number} fillValue - Byte value to to fill returned data (does NOT fill unless supplied)
+    * @returns {Buffer|Uint8Array} Selected data as ```Uint8Array``` or ```Buffer```
+    */
+    fill(startOffset, endOffset, consume, fillValue) {
+        return remove(this, startOffset || this.offset, endOffset || this.size, consume || false, false, fillValue);
     }
     /**
-    * Extract 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
-    * @param {number} consume - moves offset to end of length
-    * @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, consume) {
-        if (this.offset + (length || 0) > this.size) {
-            if (this.strict == false) {
-                this.extendArray(this.offset + (length || 0) - this.size);
-            }
-            else {
-                this.errorDump ? "[Error], hexdump:\n" + this.hexdump() : "";
-                throw new Error("End offset outside of data: at " + this.offset + " reading " + length + " of" + this.size);
-            }
-        }
-        const extract = this.data.slice(this.offset, this.offset + (length || 0));
-        if (consume) {
-            this.offset += length;
-        }
-        return extract;
+        return remove(this, this.offset, length || 0, consume || false, false);
     }
     /**
-    * Extract array from current position to length supplied
+    * Extract data from current position to length supplied
     * Note: Does not affect supplied data
-    * Note: Will extend array if strict mode is off
-    * @param {number} length - length of data to copy from current offset
-    * @param {number} consume - moves offset to end of length
-    * @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 this.extract(length, consume);
+    slice(length, consume) {
+        return remove(this, this.offset, length || 0, consume || false, false);
     }
     /**
-    * Extract array from current position to length supplied
+    * Extract data from current position to length supplied
     * Note: Does not affect supplied data
-    * Note: Will extend array if strict mode is off
-    * @param {number} length - length of data to copy from current offset
-    * @param {number} consume - moves offset to end of length
-    * @returns {Buffer|Uint8Array} ``Buffer`` or ``Uint8Array``
+    *
+    * @param {number} length - Length of data in bytes to copy from current offset
+    * @param {number} consume - Moves offset to end of length
+    * @returns {Buffer|Uint8Array} Selected data as ```Uint8Array``` or ```Buffer```
+    */
+    wrap(length, consume) {
+        return remove(this, this.offset, length || 0, consume || false, false);
+    }
+    //
+    //insert
+    //
+    /**
+    * Inserts data into data
+    * Note: Must be same data type as supplied data. Errors on strict mode.
+    *
+    * @param {Buffer|Uint8Array} data - ```Uint8Array``` or ```Buffer``` to add to data
+    * @param {boolean} consume - Move current write position to end of data (default false)
+    * @param {number} offset - Offset to add it at (defaults to current position)
+    */
+    insert(data, consume, offset) {
+        return addData(this, data, consume || false, offset || this.offset);
+    }
+    /**
+    * Inserts data into data
+    * Note: Must be same data type as supplied data. Errors on strict mode.
+    *
+    * @param {Buffer|Uint8Array} data - ```Uint8Array``` or ```Buffer``` to add to data
+    * @param {boolean} consume - Move current write position to end of data (default false)
+    * @param {number} offset - Offset to add it at (defaults to current position)
+    */
+    place(data, consume, offset) {
+        return addData(this, data, consume || false, offset || this.offset);
+    }
+    /**
+    * Adds data to start of supplied data
+    * Note: Must be same data type as supplied data. Errors on strict mode.
+    *
+    * @param {Buffer|Uint8Array} data - ```Uint8Array``` or ```Buffer``` to add to data
+    * @param {boolean} consume - Move current write position to end of data (default false)
+    */
+    unshift(data, consume) {
+        return addData(this, data, consume || false, 0);
+    }
+    /**
+    * Adds data to start of supplied data
+    * Note: Must be same data type as supplied data. Errors on strict mode.
+    *
+    * @param {Buffer|Uint8Array} data - ```Uint8Array``` or ```Buffer``` to add to data
+    * @param {boolean} consume - Move current write position to end of data (default false)
+    */
+    prepend(data, consume) {
+        return addData(this, data, consume || false, 0);
+    }
+    /**
+    * Adds data to end of supplied data
+    * Note: Must be same data type as supplied data. Errors on strict mode.
+    *
+    * @param {Buffer|Uint8Array} data - ```Uint8Array``` or ```Buffer``` to add to data
+    * @param {boolean} consume - Move current write position to end of data (default false)
+    */
+    push(data, consume) {
+        return addData(this, data, consume || false, this.size);
+    }
+    /**
+    * Adds data to end of supplied data
+    * Note: Must be same data type as supplied data. Errors on strict mode.
+    *
+    * @param {Buffer|Uint8Array} data - ```Uint8Array``` or ```Buffer``` to add to data
+    * @param {boolean} consume - Move current write position to end of data (default false)
     */
-    lift(length, consume) {
-        return this.extract(length, consume);
+    append(data, consume) {
+        return addData(this, data, consume || false, this.size);
     }
+    //
+    //finishing
+    //
     /**
     * Returns current data
+    *
     * @returns {Buffer|Uint8Array} ``Buffer`` or ``Uint8Array``
     */
     get() {
@@ -452,48 +454,37 @@ export class biwriter {
     }
     /**
     * Returns current data
+    *
     * @returns {Buffer|Uint8Array} ``Buffer`` or ``Uint8Array``
     */
     return() {
         return this.data;
     }
     /**
-    * removes writing data
+    * removes data
     */
     end() {
         this.data = undefined;
     }
     /**
-    * removes writing data
+    * removes data
     */
     close() {
         this.data = undefined;
     }
     /**
-    * removes writing data
+    * removes data
     */
     done() {
         this.data = undefined;
     }
     /**
-    * removes writing data
+    * removes data
     */
     finished() {
         this.data = undefined;
     }
     /**
-    * Turn hexdump on error off, default on
-    */
-    errorDumpOff() {
-        this.errorDump = false;
-    }
-    /**
-    * Turn hexdump on error on, default on
-    */
-    errorDumpOn() {
-        this.errorDump = true;
-    }
-    /**
     * Console logs data as hex dump
     *
     * @param {object} options - options object
@@ -506,186 +497,19 @@ export class biwriter {
     * ```
     */
     hexdump(options) {
-        var length = options && options.length;
-        var startByte = options && options.startByte;
-        var supressUnicode = options && options.supressUnicode || false;
-        if ((startByte || 0) > this.size) {
-            this.errorDump ? "[Error], hexdump:\n" + this.hexdump() : "";
-            throw new Error("Hexdump start is outside of data size: " + startByte + " of " + this.size);
-        }
-        const start = startByte || this.offset;
-        const end = Math.min(start + (length || 192), this.size);
-        if (start + (length || 0) > this.size) {
-            this.errorDump ? "[Error], hexdump:\n" + this.hexdump() : "";
-            throw new Error("Hexdump amount is outside of data size: " + (start + (length || 0)) + " of " + end);
-        }
-        function hex_check(byte, bits) {
-            var value = 0;
-            for (var i = 0; i < bits;) {
-                var remaining = bits - i;
-                var bitOffset = 0;
-                var currentByte = byte;
-                var read = Math.min(remaining, 8 - bitOffset);
-                var mask, readBits;
-                mask = ~(0xFF << read);
-                readBits = (currentByte >> (8 - read - bitOffset)) & mask;
-                value <<= read;
-                value |= readBits;
-                i += read;
-            }
-            value = value >>> 0;
-            return value;
-        }
-        const rows = [];
-        var header = "   0  1  2  3  4  5  6  7  8  9  A  B  C  D  E  F  ";
-        var ending = "0123456789ABCDEF";
-        var addr = "";
-        for (let i = start; i < end; i += 16) {
-            addr = i.toString(16).padStart(5, '0');
-            var row = this.data?.slice(i, i + 16) || [];
-            var hex = Array.from(row, (byte) => byte.toString(16).padStart(2, '0')).join(' ');
-            rows.push(`${addr}  ${hex.padEnd(47)}  `);
-        }
-        let result = '';
-        let make_wide = false;
-        let i = start;
-        while (i < end) {
-            const byte = this.data[i];
-            if (byte < 32 || byte == 127) {
-                result += '.';
-            }
-            else if (byte < 127) {
-                // Valid UTF-8 start byte or single-byte character
-                // Convert the byte to a character and add it to the result
-                result += String.fromCharCode(byte);
-            }
-            else if (supressUnicode) {
-                result += '.';
-            }
-            else if (hex_check(byte, 1) == 0) {
-                //Byte 1
-                result += String.fromCharCode(byte);
-            }
-            else if (hex_check(byte, 3) == 6) {
-                //Byte 2
-                if (i + 1 <= end) {
-                    //check second byte
-                    const byte2 = this.data[i + 1];
-                    if (hex_check(byte2, 2) == 2) {
-                        const charCode = ((byte & 0x1f) << 6) | (byte2 & 0x3f);
-                        i++;
-                        make_wide = true;
-                        const read = " " + String.fromCharCode(charCode);
-                        result += read;
-                    }
-                    else {
-                        result += ".";
-                    }
-                }
-                else {
-                    result += ".";
-                }
-            }
-            else if (hex_check(byte, 4) == 14) {
-                //Byte 3
-                if (i + 1 <= end) {
-                    //check second byte
-                    const byte2 = this.data[i + 1];
-                    if (hex_check(byte2, 2) == 2) {
-                        if (i + 2 <= end) {
-                            //check third byte
-                            const byte3 = this.data[i + 2];
-                            if (hex_check(byte3, 2) == 2) {
-                                const charCode = ((byte & 0x0f) << 12) |
-                                    ((byte2 & 0x3f) << 6) |
-                                    (byte3 & 0x3f);
-                                i += 2;
-                                make_wide = true;
-                                const read = "  " + String.fromCharCode(charCode);
-                                result += read;
-                            }
-                            else {
-                                i++;
-                                result += " .";
-                            }
-                        }
-                        else {
-                            i++;
-                            result += " .";
-                        }
-                    }
-                    else {
-                        result += ".";
-                    }
-                }
-                else {
-                    result += ".";
-                }
-            }
-            else if (hex_check(byte, 5) == 28) {
-                //Byte 4
-                if (i + 1 <= end) {
-                    //check second byte
-                    const byte2 = this.data[i + 1];
-                    if (hex_check(byte2, 2) == 2) {
-                        if (i + 2 <= end) {
-                            //check third byte
-                            const byte3 = this.data[i + 2];
-                            if (hex_check(byte3, 2) == 2) {
-                                if (i + 3 <= end) {
-                                    //check fourth byte
-                                    const byte4 = this.data[i + 2];
-                                    if (hex_check(byte4, 2) == 2) {
-                                        const charCode = (((byte4 & 0xFF) << 24) | ((byte3 & 0xFF) << 16) | ((byte2 & 0xFF) << 8) | (byte & 0xFF));
-                                        i += 3;
-                                        make_wide = true;
-                                        const read = "   " + String.fromCharCode(charCode);
-                                        result += read;
-                                    }
-                                    else {
-                                        i += 2;
-                                        result += "  .";
-                                    }
-                                }
-                                else {
-                                    i += 2;
-                                    result += "  .";
-                                }
-                            }
-                            else {
-                                i++;
-                                result += " .";
-                            }
-                        }
-                        else {
-                            i++;
-                            result += " .";
-                        }
-                    }
-                    else {
-                        result += ".";
-                    }
-                }
-                else {
-                    result += ".";
-                }
-            }
-            else {
-                // Invalid UTF-8 byte, add a period to the result
-                result += '.';
-            }
-            i++;
-        }
-        const chunks = result.match(new RegExp(`.{1,${16}}`, 'g'));
-        chunks?.forEach((self, i) => {
-            rows[i] = rows[i] + (make_wide ? "|" + self + "|" : self);
-        });
-        header = "".padStart(addr.length) + header + (make_wide ? "" : ending);
-        rows.unshift(header);
-        if (make_wide) {
-            rows.push("*Removed character byte header on unicode detection");
-        }
-        console.log(rows.join("\n"));
+        return hexDump(this, options);
+    }
+    /**
+    * Turn hexdump on error off (default on)
+    */
+    errorDumpOff() {
+        this.errorDump = false;
+    }
+    /**
+    * Turn hexdump on error on (default on)
+    */
+    errorDumpOn() {
+        this.errorDump = true;
     }
     //
     //bit writer
@@ -780,22 +604,22 @@ export class biwriter {
         return this.writeBit(value, bits, offsetBits, offsetBytes, unsigned, endian);
     }
     /**
-* Bit field writer
-*
-* Note: When returning to a byte read, remaining bits are dropped
-*
-* @param {number} value - value as int
-* @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
-* @param {number} offsetBytes - byte offset to start the write (default last write position)
-* @param {boolean} unsigned - if value is unsigned or not
-*/
+    * Bit field writer
+    *
+    * Note: When returning to a byte write, remaining bits are dropped
+    *
+    * @param {number} value - value as int
+    * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
+    * @param {number} offsetBytes - byte offset to start the write (default last write position)
+    * @param {boolean} unsigned - if value is unsigned or not
+    */
     bit1(value, offsetBits, offsetBytes, unsigned) {
         return this.bit(value, 1, offsetBits, offsetBytes, unsigned);
     }
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -807,7 +631,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -820,7 +644,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -832,7 +656,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -845,7 +669,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -857,7 +681,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -870,7 +694,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -882,7 +706,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -895,7 +719,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -907,7 +731,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -920,7 +744,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -932,7 +756,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -945,7 +769,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -957,7 +781,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -970,7 +794,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -982,7 +806,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -995,7 +819,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1007,7 +831,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1020,7 +844,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1032,7 +856,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1045,7 +869,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1057,7 +881,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1070,7 +894,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1082,7 +906,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1095,7 +919,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1107,7 +931,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1120,7 +944,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1132,7 +956,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1145,7 +969,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1157,7 +981,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1170,7 +994,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1182,7 +1006,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1195,7 +1019,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1207,7 +1031,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1220,7 +1044,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1232,7 +1056,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1245,7 +1069,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1257,7 +1081,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1270,7 +1094,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1282,7 +1106,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1295,7 +1119,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1307,7 +1131,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1320,7 +1144,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1332,7 +1156,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1345,7 +1169,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1357,7 +1181,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1370,7 +1194,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1382,7 +1206,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1395,7 +1219,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1407,7 +1231,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1420,7 +1244,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1432,7 +1256,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1445,7 +1269,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1457,7 +1281,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1470,7 +1294,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1482,7 +1306,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1495,7 +1319,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1507,7 +1331,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1520,7 +1344,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1532,7 +1356,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1545,7 +1369,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1557,7 +1381,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1570,7 +1394,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1582,7 +1406,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1595,7 +1419,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1607,7 +1431,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1620,7 +1444,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1632,7 +1456,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1645,7 +1469,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1657,7 +1481,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1670,7 +1494,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1682,7 +1506,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1695,7 +1519,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1707,7 +1531,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1720,7 +1544,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1732,7 +1556,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1745,7 +1569,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1757,7 +1581,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1770,7 +1594,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1782,7 +1606,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1795,7 +1619,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1807,7 +1631,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1820,7 +1644,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1832,7 +1656,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1845,7 +1669,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1857,7 +1681,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1870,7 +1694,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1882,7 +1706,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1895,7 +1719,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1907,7 +1731,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1920,7 +1744,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1932,7 +1756,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1945,7 +1769,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1957,7 +1781,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1970,7 +1794,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1982,7 +1806,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -1995,7 +1819,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2007,7 +1831,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2020,7 +1844,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2032,7 +1856,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2045,7 +1869,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2057,7 +1881,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2070,7 +1894,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2082,7 +1906,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2095,7 +1919,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2107,7 +1931,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2120,7 +1944,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2132,7 +1956,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2145,7 +1969,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2157,7 +1981,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2170,7 +1994,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2182,7 +2006,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2195,7 +2019,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2207,7 +2031,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2220,7 +2044,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2232,7 +2056,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2245,7 +2069,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2257,7 +2081,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2270,7 +2094,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2282,7 +2106,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2295,7 +2119,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2307,7 +2131,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2320,7 +2144,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2332,7 +2156,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2345,7 +2169,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2357,7 +2181,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2370,7 +2194,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2382,7 +2206,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2395,7 +2219,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2407,7 +2231,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2420,7 +2244,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2432,7 +2256,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2445,7 +2269,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2457,7 +2281,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2470,7 +2294,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2482,7 +2306,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2495,7 +2319,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2507,7 +2331,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2520,7 +2344,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2532,7 +2356,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2545,7 +2369,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2557,7 +2381,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2570,7 +2394,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2582,7 +2406,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2595,7 +2419,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2607,7 +2431,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2620,7 +2444,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2632,7 +2456,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2645,7 +2469,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2657,7 +2481,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2670,7 +2494,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2682,7 +2506,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2695,7 +2519,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2707,7 +2531,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2720,7 +2544,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2732,7 +2556,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2745,7 +2569,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2757,7 +2581,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2770,7 +2594,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2782,7 +2606,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2795,7 +2619,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2807,7 +2631,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2820,7 +2644,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2832,7 +2656,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2845,7 +2669,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2857,7 +2681,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2870,7 +2694,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2882,7 +2706,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2895,7 +2719,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2907,7 +2731,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2920,7 +2744,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2932,7 +2756,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2945,7 +2769,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2957,7 +2781,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2970,7 +2794,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2982,7 +2806,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -2995,7 +2819,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -3007,7 +2831,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -3020,7 +2844,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -3032,7 +2856,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -3045,7 +2869,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -3057,7 +2881,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -3070,7 +2894,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -3082,7 +2906,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -3095,7 +2919,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -3107,7 +2931,7 @@ export class biwriter {
     /**
 * Bit field writer
 *
-* Note: When returning to a byte read, remaining bits are dropped
+* Note: When returning to a byte write, remaining bits are dropped
 *
 * @param {number} value - value as int
 * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -3120,7 +2944,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -3132,7 +2956,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -3145,7 +2969,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -3157,7 +2981,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -3170,7 +2994,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} offsetBits - bit offset from current byte position to start the write (defaults last bit position)
@@ -3182,7 +3006,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} bits - number of bits to write
@@ -3196,7 +3020,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} bits - number of bits to write
@@ -3210,7 +3034,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} bits - number of bits to write
@@ -3224,7 +3048,7 @@ export class biwriter {
     /**
     * Bit field writer
     *
-    * Note: When returning to a byte read, remaining bits are dropped
+    * Note: When returning to a byte write, remaining bits are dropped
     *
     * @param {number} value - value as int
     * @param {number} bits - number of bits to write
@@ -4365,7 +4189,7 @@ export class biwriter {
         return this.writeInt64(value, offset, true, "big");
     }
     //
-    //doublefloat reader
+    //doublefloat
     //
     /**
     * Writes double float
@@ -4571,7 +4395,7 @@ export class biwriter {
             }
             else {
                 this.errorDump ? "[Error], hexdump:\n" + this.hexdump() : "";
-                throw new Error("Invalid length read size: " + lengthWriteSize);
+                throw new Error("Invalid length write size: " + lengthWriteSize);
             }
             if (string.length > maxLength || (length || 0) > maxLength) {
                 this.errorDump ? "[Error], hexdump:\n" + this.hexdump() : "";
@@ -4613,7 +4437,7 @@ export class biwriter {
             this.offset += totalLength;
         }
         else {
-            throw new Error('Unsupported string type.');
+            throw new Error('Unsupported string type: ' + stringType);
         }
     }
     /**