@woosh/meep-engine 2.113.4 → 2.113.7

package/src/core/binary/Base64.js

@@ -1,6 +1,7 @@
 /**
  * Adapted from https://github.com/beatgammit/base64-js
  * @author Jameson Little
+ * @author Alex Goldring
  */
 
 /**
@@ -8,12 +9,12 @@
  * @type {string[]}
  */
 const lookup = [];
+
 /**
  *
  * @type {number[]}
  */
 const revLookup = [];
-const Arr = typeof Uint8Array !== 'undefined' ? Uint8Array : Array;
 
 const code = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
 
@@ -33,7 +34,7 @@ revLookup['_'.charCodeAt(0)] = 63;
  * @return {number[]}
  */
 function getLens(b64) {
-    var len = b64.length;
+    const len = b64.length;
 
     if (len % 4 > 0) {
         throw new Error('Invalid string. Length must be a multiple of 4');
@@ -41,63 +42,88 @@ function getLens(b64) {
 
     // Trim off extra bytes after placeholder bytes are found
     // See: https://github.com/beatgammit/base64-js/issues/42
-    var validLen = b64.indexOf('=');
+    let validLen = b64.indexOf('=');
+
     if (validLen === -1) {
         validLen = len;
     }
 
-    var placeHoldersLen = validLen === len
+    const placeHoldersLen = validLen === len
         ? 0
         : 4 - (validLen % 4);
 
     return [validLen, placeHoldersLen];
 }
 
-// base64 is 4/3 + up to two characters of the original data
-
-function _byteLength(b64, validLen, placeHoldersLen) {
+/**
+ * base64 is 4/3 + up to two characters of the original data
+ * @param {number} validLen
+ * @param {number} placeHoldersLen
+ */
+function _byteLength(validLen, placeHoldersLen) {
     return ((validLen + placeHoldersLen) * 3 / 4) - placeHoldersLen;
 }
 
+/**
+ *
+ * @param {string} b64
+ * @return {Uint8Array}
+ */
 function toByteArray(b64) {
-    var tmp;
-    var lens = getLens(b64);
-    var validLen = lens[0];
-    var placeHoldersLen = lens[1];
+    let tmp;
+    const lens = getLens(b64);
+    const validLen = lens[0];
+    const placeHoldersLen = lens[1];
 
-    var arr = new Arr(_byteLength(b64, validLen, placeHoldersLen));
+    const arr = new Uint8Array(_byteLength(validLen, placeHoldersLen));
 
-    var curByte = 0;
+    let curByte = 0;
 
     // if there are placeholders, only get up to the last complete 4 chars
-    var len = placeHoldersLen > 0
+    const len = placeHoldersLen > 0
         ? validLen - 4
         : validLen;
 
-    var i;
-    for (i = 0; i < len; i += 4) {
+    let i = 0;
+
+    for (; i < len; i += 4) {
+        const char_0 = b64.charCodeAt(i);
+        const char_1 = b64.charCodeAt(i + 1);
+        const char_2 = b64.charCodeAt(i + 2);
+        const char_3 = b64.charCodeAt(i + 3);
+
         tmp =
-            (revLookup[b64.charCodeAt(i)] << 18) |
-            (revLookup[b64.charCodeAt(i + 1)] << 12) |
-            (revLookup[b64.charCodeAt(i + 2)] << 6) |
-            revLookup[b64.charCodeAt(i + 3)];
+            (revLookup[char_0] << 18) |
+            (revLookup[char_1] << 12) |
+            (revLookup[char_2] << 6) |
+            revLookup[char_3];
+
         arr[curByte++] = (tmp >> 16) & 0xFF;
         arr[curByte++] = (tmp >> 8) & 0xFF;
         arr[curByte++] = tmp & 0xFF;
     }
 
     if (placeHoldersLen === 2) {
+        const char_0 = b64.charCodeAt(i);
+        const char_1 = b64.charCodeAt(i + 1);
+
         tmp =
-            (revLookup[b64.charCodeAt(i)] << 2) |
-            (revLookup[b64.charCodeAt(i + 1)] >> 4);
+            (revLookup[char_0] << 2) |
+            (revLookup[char_1] >> 4);
+
         arr[curByte++] = tmp & 0xFF;
     }
 
     if (placeHoldersLen === 1) {
+        const char_0 = b64.charCodeAt(i);
+        const char_1 = b64.charCodeAt(i + 1);
+        const char_2 = b64.charCodeAt(i + 2);
+
         tmp =
-            (revLookup[b64.charCodeAt(i)] << 10) |
-            (revLookup[b64.charCodeAt(i + 1)] << 4) |
-            (revLookup[b64.charCodeAt(i + 2)] >> 2);
+            (revLookup[char_0] << 10) |
+            (revLookup[char_1] << 4) |
+            (revLookup[char_2] >> 2);
+
         arr[curByte++] = (tmp >> 8) & 0xFF;
         arr[curByte++] = tmp & 0xFF;
     }
@@ -105,6 +131,11 @@ function toByteArray(b64) {
     return arr;
 }
 
+/**
+ *
+ * @param {number} num
+ * @return {string}
+ */
 function tripletToBase64(num) {
     return lookup[num >> 18 & 0x3F]
         + lookup[num >> 12 & 0x3F]
@@ -135,24 +166,29 @@ function encodeChunk(uint8, start, end) {
     return output.join('');
 }
 
+/**
+ * must be multiple of 3
+ */
+const MAX_CHUNK_LENGTH = 16383;
+
 /**
  *
  * @param {Uint8Array} uint8
  * @return {string}
  */
 function fromByteArray(uint8) {
-    let tmp;
 
     const len = uint8.length;
+
     const extraBytes = len % 3; // if we have 1 byte left, pad 2 bytes
+
     const parts = [];
-    const maxChunkLength = 16383; // must be multiple of 3
 
     // go through the array every three bytes, we'll deal with trailing stuff later
     const len2 = len - extraBytes;
 
-    for (let i = 0; i < len2; i += maxChunkLength) {
-        const end = (i + maxChunkLength) > len2 ? len2 : (i + maxChunkLength);
+    for (let i = 0; i < len2; i += MAX_CHUNK_LENGTH) {
+        const end = (i + MAX_CHUNK_LENGTH) > len2 ? len2 : (i + MAX_CHUNK_LENGTH);
 
         const chunk = encodeChunk(uint8, i, end);
 
@@ -161,20 +197,26 @@ function fromByteArray(uint8) {
 
     // pad the end with zeros, but make sure to not forget the extra bytes
     if (extraBytes === 1) {
-        tmp = uint8[len - 1];
+
+        const tmp = uint8[len - 1];
+
         parts.push(
             lookup[tmp >> 2] +
             lookup[(tmp << 4) & 0x3F] +
             '=='
         );
+
     } else if (extraBytes === 2) {
-        tmp = (uint8[len - 2] << 8) + uint8[len - 1];
+
+        const tmp = (uint8[len - 2] << 8) + uint8[len - 1];
+
         parts.push(
             lookup[tmp >> 10] +
             lookup[(tmp >> 4) & 0x3F] +
             lookup[(tmp << 2) & 0x3F] +
             '='
         );
+
     }
 
     return parts.join('');

package/src/core/binary/BitSet.d.ts

@@ -87,10 +87,10 @@ export class BitSet {
     nextClearBit(fromIndex: int): number;
     /**
      *
-     * @param {int} bitIndex
+     * @param {int} bit_index
      * @param {boolean} value
      */
-    set(bitIndex: int, value: boolean): void;
+    set(bit_index: int, value: boolean): void;
     /**
      * Sets the bit specified by the index to false.
      * @param {int} bitIndex

package/src/core/binary/BitSet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BitSet.d.ts","sourceRoot":"","sources":["../../../../src/core/binary/BitSet.js"],"names":[],"mappings":"AAgCA;IAyiBI;;;;OAIG;IACH,oBAHW,MAAM,GACJ,MAAM,CASlB;IApjBD;;;;OAIG;IACH,+BAFW,MAAM,EA8BhB;IAzBG;;;;OAIG;IACH,iBAAiB;IAEjB;;;;OAIG;IACH,mBAA4C;IAE5C;;;;OAIG;IACH,sBAA0D;IAE1D;;OAEG;IACH,gBAFU,MAAM,CAEmB;IAGvC,sBAEC;IAED;;;OAGG;IACH,mBAFW,MAAM,QAOhB;IAED;;;OAGG;IACH,uBAFW,MAAM,QAUhB;IAED;;;OAGG;IACH,QAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,YAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,iBAsBC;IAED,uBAMC;IAED;;;;OAIG;IACH,oBAyBC;IAED;;;;OAIG;IACH,oCAqCC;IAED;;;;OAIG;IACH,4BAFa,MAAM,CAuDlB;IAED;;;;OAIG;IACH,8BAFa,MAAM,CAkDlB;IAED;;;;OAIG;IACH,0BAFW,OAAO,QAmCjB;IAED;;;OAGG;IACH,2BAEC;IAED;;;;OAIG;IACH,qBAHW,MAAM,YACN,MAAM,QAWhB;IAED;;;;OAIG;IACH,uBAHW,MAAM,YACN,MAAM,QAShB;IAED;;;OAGG;IACH,SAFW,MAAM,QAIhB;IAED;;;;OAIG;IACH,oBAFa,OAAO,CAkBnB;IAED;;;;OAIG;IACH,iBAHW,MAAM,GACJ,OAAO,CAUnB;IAED;;;;OAIG;IACH,mBAHW,MAAM,GACJ,OAAO,CAUnB;IAED;;;;;OAKG;IACH,sBAJW,MAAM,eACN,MAAM,aACN,MAAM,QAShB;IAED;;;;;OAKG;IACH,qBAJW,MAAM,eACN,MAAM,aACN,MAAM,QAShB;IAED;;;;;OAKG;IACH,gBAJW,MAAM,eACN,MAAM,aACN,MAAM,QAQhB;IAED;;OAEG;IACH,cAgBC;IAED;;;OAGG;IACH,YAFW,MAAM,QAoChB;CAeJ"}
+{"version":3,"file":"BitSet.d.ts","sourceRoot":"","sources":["../../../../src/core/binary/BitSet.js"],"names":[],"mappings":"AAgCA;IAyiBI;;;;OAIG;IACH,oBAHW,MAAM,GACJ,MAAM,CASlB;IApjBD;;;;OAIG;IACH,+BAFW,MAAM,EA8BhB;IAzBG;;;;OAIG;IACH,iBAAiB;IAEjB;;;;OAIG;IACH,mBAA4C;IAE5C;;;;OAIG;IACH,sBAA0D;IAE1D;;OAEG;IACH,gBAFU,MAAM,CAEmB;IAGvC,sBAEC;IAED;;;OAGG;IACH,mBAFW,MAAM,QAOhB;IAED;;;OAGG;IACH,uBAFW,MAAM,QAUhB;IAED;;;OAGG;IACH,QAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,YAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,iBAsBC;IAED,uBAMC;IAED;;;;OAIG;IACH,oBAyBC;IAED;;;;OAIG;IACH,oCAqCC;IAED;;;;OAIG;IACH,4BAFa,MAAM,CAuDlB;IAED;;;;OAIG;IACH,8BAFa,MAAM,CAkDlB;IAED;;;;OAIG;IACH,2BAFW,OAAO,QAmCjB;IAED;;;OAGG;IACH,2BAEC;IAED;;;;OAIG;IACH,qBAHW,MAAM,YACN,MAAM,QAWhB;IAED;;;;OAIG;IACH,uBAHW,MAAM,YACN,MAAM,QAShB;IAED;;;OAGG;IACH,SAFW,MAAM,QAIhB;IAED;;;;OAIG;IACH,oBAFa,OAAO,CAkBnB;IAED;;;;OAIG;IACH,iBAHW,MAAM,GACJ,OAAO,CAUnB;IAED;;;;OAIG;IACH,mBAHW,MAAM,GACJ,OAAO,CAUnB;IAED;;;;;OAKG;IACH,sBAJW,MAAM,eACN,MAAM,aACN,MAAM,QAShB;IAED;;;;;OAKG;IACH,qBAJW,MAAM,eACN,MAAM,aACN,MAAM,QAShB;IAED;;;;;OAKG;IACH,gBAJW,MAAM,eACN,MAAM,aACN,MAAM,QAQhB;IAED;;OAEG;IACH,cAgBC;IAED;;;OAGG;IACH,YAFW,MAAM,QAoChB;CAeJ"}

package/src/core/binary/BitSet.js

@@ -341,22 +341,22 @@ export class BitSet {
 
     /**
      *
-     * @param {int} bitIndex
+     * @param {int} bit_index
      * @param {boolean} value
      */
-    set(bitIndex, value) {
-        //assert.ok(typeof bitIndex, 'number', `bitIndex must be a number, instead was '${typeof bitIndex}'`);
-        //assert.ok(typeof value, 'boolean', `value must be a boolean, instead was '${typeof bitIndex}'`);
+    set(bit_index, value) {
+        assert.isNonNegativeInteger(bit_index, 'bit_index');
+        assert.isBoolean(value, 'value');
 
-        const word_offset = bitIndex >> 5;
-        const bit_offset = bitIndex & 31;
+        const word_offset = bit_index >> 5;
+        const bit_offset = bit_index & 31;
 
         //const oldLength = this.__length;
 
         const word_mask = 1 << bit_offset;
 
         if (value) {
-            const bitIndexInc = bitIndex + 1;
+            const bitIndexInc = bit_index + 1;
 
             if (bitIndexInc > this.__length) {
                 // ensure capacity
@@ -367,7 +367,7 @@ export class BitSet {
             this.__data_uint32[word_offset] |= word_mask;
 
 
-        } else if (bitIndex < this.__length) {
+        } else if (bit_index < this.__length) {
             //clear
             this.__data_uint32[word_offset] &= ~word_mask;
 

package/src/core/binary/align_32.d.ts

@@ -1,7 +1,7 @@
 /**
  * Align to the nearest number divisible by 32, rounding up
- * @param {number} n
+ * @param {number} x must be a non-negative integer
  * @returns {number}
  */
-export function align_32(n: number): number;
+export function align_32(x: number): number;
 //# sourceMappingURL=align_32.d.ts.map

package/src/core/binary/align_32.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"align_32.d.ts","sourceRoot":"","sources":["../../../../src/core/binary/align_32.js"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,4BAHW,MAAM,GACJ,MAAM,CAIlB"}
+{"version":3,"file":"align_32.d.ts","sourceRoot":"","sources":["../../../../src/core/binary/align_32.js"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,4BAHW,MAAM,GACJ,MAAM,CAMlB"}

package/src/core/binary/align_32.js

@@ -1,8 +1,12 @@
+import { assert } from "../assert.js";
+
 /**
  * Align to the nearest number divisible by 32, rounding up
- * @param {number} n
+ * @param {number} x must be a non-negative integer
  * @returns {number}
  */
-export function align_32(n) {
-    return ((n + 31) >>> 5) << 5
+export function align_32(x) {
+    assert.isNonNegativeInteger(x, 'n');
+
+    return ((x + 31) >>> 5) << 5
 }

package/src/core/binary/bitset_find_clear_gap.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Find a range of unset bits in the {@link BitSet}
+ * useful for allocation algorithms
+ * @param {BitSet} bitset
+ * @param {number} bit_count
+ * @param {number} start_index
+ * @returns {number}
+ */
+export function bitset_find_clear_gap(bitset: BitSet, bit_count: number, start_index?: number): number;
+//# sourceMappingURL=bitset_find_clear_gap.d.ts.map

package/src/core/binary/bitset_find_clear_gap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitset_find_clear_gap.d.ts","sourceRoot":"","sources":["../../../../src/core/binary/bitset_find_clear_gap.js"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,iEAJW,MAAM,gBACN,MAAM,GACJ,MAAM,CAuBlB"}

package/src/core/binary/bitset_find_clear_gap.js

@@ -0,0 +1,30 @@
+/**
+ * Find a range of unset bits in the {@link BitSet}
+ * useful for allocation algorithms
+ * @param {BitSet} bitset
+ * @param {number} bit_count
+ * @param {number} start_index
+ * @returns {number}
+ */
+export function bitset_find_clear_gap(bitset, bit_count, start_index = 0) {
+    let slot_index = start_index;
+
+    main_loop:while (true) {
+
+        slot_index = bitset.nextClearBit(slot_index)
+
+        const search_range_end = slot_index + bit_count;
+
+        for (let i = slot_index; i < search_range_end; i++) {
+            if (bitset.get(i)) {
+                // slot is occupied
+                slot_index = i + 1;
+
+                continue main_loop;
+            }
+        }
+
+        // found a hole big enough
+        return slot_index;
+    }
+}

package/src/core/binary/dec2hex.d.ts

@@ -1,7 +1,7 @@
 /**
  * Convert a decimal value to hex
- * @param {number} c generally expects b byte value, 0-255
+ * @param {number} x generally expects b byte value, 0-255
  * @returns {string} zero-padded value, for example instead of "0", will return "00" and instead of "F" will return "0F"
  */
-export function dec2hex(c: number): string;
+export function dec2hex(x: number): string;
 //# sourceMappingURL=dec2hex.d.ts.map

package/src/core/binary/dec2hex.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dec2hex.d.ts","sourceRoot":"","sources":["../../../../src/core/binary/dec2hex.js"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,2BAHW,MAAM,GACJ,MAAM,CAKlB"}
+{"version":3,"file":"dec2hex.d.ts","sourceRoot":"","sources":["../../../../src/core/binary/dec2hex.js"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,2BAHW,MAAM,GACJ,MAAM,CAOlB"}

package/src/core/binary/dec2hex.js

@@ -1,9 +1,13 @@
+import { assert } from "../assert.js";
+
 /**
  * Convert a decimal value to hex
- * @param {number} c generally expects b byte value, 0-255
+ * @param {number} x generally expects b byte value, 0-255
  * @returns {string} zero-padded value, for example instead of "0", will return "00" and instead of "F" will return "0F"
  */
-export function dec2hex(c) {
-    const hex = Math.round(c).toString(16);
+export function dec2hex(x) {
+    assert.greaterThanOrEqual(x, 0);
+
+    const hex = Math.round(x).toString(16);
     return hex.length === 1 ? "0" + hex : hex;
 }

package/src/core/binary/downloadAsFile.d.ts

@@ -1,2 +1,8 @@
-export function downloadAsFile(data: any, filename: any, type?: string): void;
+/**
+ *
+ * @param {ArrayBuffer|Uint8Array|Array|Blob|string} data
+ * @param {string} [filename]
+ * @param {string} [type]
+ */
+export function downloadAsFile(data: ArrayBuffer | Uint8Array | any[] | Blob | string, filename?: string, type?: string): void;
 //# sourceMappingURL=downloadAsFile.d.ts.map

package/src/core/binary/downloadAsFile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"downloadAsFile.d.ts","sourceRoot":"","sources":["../../../../src/core/binary/downloadAsFile.js"],"names":[],"mappings":"AAEA,8EAyBC"}
+{"version":3,"file":"downloadAsFile.d.ts","sourceRoot":"","sources":["../../../../src/core/binary/downloadAsFile.js"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,qCAJW,WAAW,GAAC,UAAU,WAAO,IAAI,GAAC,MAAM,aACxC,MAAM,SACN,MAAM,QAwBhB"}

package/src/core/binary/downloadAsFile.js

@@ -1,5 +1,11 @@
-import {downloadUrlAsFile} from "./downloadUrlAsFile.js";
+import { downloadUrlAsFile } from "./downloadUrlAsFile.js";
 
+/**
+ *
+ * @param {ArrayBuffer|Uint8Array|Array|Blob|string} data
+ * @param {string} [filename]
+ * @param {string} [type]
+ */
 export function downloadAsFile(data, filename, type = 'text/json') {
 
     let blobContent;
@@ -19,10 +25,7 @@ export function downloadAsFile(data, filename, type = 'text/json') {
         blobContent = [data]
     }
 
-    const blob = new Blob(blobContent, {type});
-    if (window.navigator.msSaveOrOpenBlob) {
-        window.navigator.msSaveBlob(blob, filename);
-    } else {
-        downloadUrlAsFile(window.URL.createObjectURL(blob), filename);
-    }
+    const blob = new Blob(blobContent, { type });
+
+    downloadUrlAsFile(window.URL.createObjectURL(blob), filename);
 }

package/src/core/binary/downloadUrlAsFile.d.ts

@@ -3,5 +3,5 @@
  * @param {string} url
  * @param {string} filename
  */
-export function downloadUrlAsFile(url: string, filename: string): void;
+export function downloadUrlAsFile(url: string, filename?: string): void;
 //# sourceMappingURL=downloadUrlAsFile.d.ts.map

package/src/core/binary/downloadUrlAsFile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"downloadUrlAsFile.d.ts","sourceRoot":"","sources":["../../../../src/core/binary/downloadUrlAsFile.js"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,uCAHW,MAAM,YACN,MAAM,QAWhB"}
+{"version":3,"file":"downloadUrlAsFile.d.ts","sourceRoot":"","sources":["../../../../src/core/binary/downloadUrlAsFile.js"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,uCAHW,MAAM,aACN,MAAM,QAchB"}

package/src/core/binary/downloadUrlAsFile.js

@@ -1,9 +1,14 @@
+import { assert } from "../assert.js";
+
 /**
  *
  * @param {string} url
  * @param {string} filename
  */
-export function downloadUrlAsFile(url, filename) {
+export function downloadUrlAsFile(url, filename = "file") {
+    assert.isString(url,'url');
+    assert.isString(filename,'filename');
+
     const elem = document.createElement('a');
     elem.href = url;
     elem.download = filename;

package/src/core/binary/int32_to_binary_string.d.ts

@@ -1,10 +1,9 @@
 /**
  * Converts an integer to easily readable binary string representation
- * @see https://stackoverflow.com/questions/9939760/how-do-i-convert-an-integer-to-binary-in-javascript
  * @example 1024    -> "00000000 00000000 00000100 00000000"
  * @example -1      -> "11111111 11111111 11111111 11111111"
  * @param {number} input_value
- * @param {string} [byte_separator] insert this string between each group of 8 bits
+ * @param {string} [byte_separator] insert this string between each group of 8 bits, defaults to a space
  * @returns {string}
  */
 export function int32_to_binary_string(input_value: number, byte_separator?: string): string;

package/src/core/binary/int32_to_binary_string.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"int32_to_binary_string.d.ts","sourceRoot":"","sources":["../../../../src/core/binary/int32_to_binary_string.js"],"names":[],"mappings":"AAcA;;;;;;;;GAQG;AACH,oDAJW,MAAM,mBACN,MAAM,GACJ,MAAM,CA4BlB"}
+{"version":3,"file":"int32_to_binary_string.d.ts","sourceRoot":"","sources":["../../../../src/core/binary/int32_to_binary_string.js"],"names":[],"mappings":"AAcA;;;;;;;GAOG;AACH,oDAJW,MAAM,mBACN,MAAM,GACJ,MAAM,CA+BlB"}

package/src/core/binary/int32_to_binary_string.js

@@ -14,14 +14,16 @@ const MIN_VALUE = -1 * (2 ** 31);
 
 /**
  * Converts an integer to easily readable binary string representation
- * @see https://stackoverflow.com/questions/9939760/how-do-i-convert-an-integer-to-binary-in-javascript
  * @example 1024    -> "00000000 00000000 00000100 00000000"
  * @example -1      -> "11111111 11111111 11111111 11111111"
  * @param {number} input_value
- * @param {string} [byte_separator] insert this string between each group of 8 bits
+ * @param {string} [byte_separator] insert this string between each group of 8 bits, defaults to a space
  * @returns {string}
  */
 export function int32_to_binary_string(input_value, byte_separator = " ") {
+
+    // @see https://stackoverflow.com/questions/9939760/how-do-i-convert-an-integer-to-binary-in-javascript
+
     // nMask must be between -2147483648 and 2147483647
     if (input_value > MAX_VALUE) {
         throw "number too large. number shouldn't be > 2**31-1";//added

package/src/core/binary/url_to_data_url.d.ts

@@ -1,5 +1,6 @@
 /**
- *
+ * Resolve URL to content and create a data URL from the content
+ * @example 'cat.png' -> 'data:image/png;base64,....'
  * @param {string} url
  * @returns {string}
  */

package/src/core/binary/url_to_data_url.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"url_to_data_url.d.ts","sourceRoot":"","sources":["../../../../src/core/binary/url_to_data_url.js"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qCAHW,MAAM,GACJ,MAAM,CAwBlB"}
+{"version":3,"file":"url_to_data_url.d.ts","sourceRoot":"","sources":["../../../../src/core/binary/url_to_data_url.js"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qCAHW,MAAM,GACJ,MAAM,CAwBlB"}

package/src/core/binary/url_to_data_url.js

@@ -1,5 +1,6 @@
 /**
- *
+ * Resolve URL to content and create a data URL from the content
+ * @example 'cat.png' -> 'data:image/png;base64,....'
  * @param {string} url
  * @returns {string}
  */

package/src/core/codegen/LineBuilder.d.ts

@@ -4,13 +4,13 @@ export default LineBuilder;
  */
 declare class LineBuilder {
     /**
-     *
      * @param {string} text
+     * @param {string} [line_separator] defaults to new-line character
      * @returns {LineBuilder}
      */
-    static fromText(text: string): LineBuilder;
+    static fromText(text: string, line_separator?: string): LineBuilder;
     /**
-     *
+     * TODO replace with indent string, that is tab, space or any combination or something else entirely
      * @type {number}
      */
     indentSpaces: number;
@@ -52,6 +52,7 @@ declare class LineBuilder {
      * @returns {string}
      */
     build(): string;
+    toString(): string;
     #private;
 }
 //# sourceMappingURL=LineBuilder.d.ts.map

package/src/core/codegen/LineBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LineBuilder.d.ts","sourceRoot":"","sources":["../../../../src/core/codegen/LineBuilder.js"],"names":[],"mappings":";AAeA;;GAEG;AACH;IAoII;;;;OAIG;IACH,sBAHW,MAAM,GACJ,WAAW,CAoBvB;IA7ID;;;OAGG;IACH,cAFU,MAAM,CAEqB;IAErC;;;OAGG;IACH,oBAEC;IAED;;;;OAIG;IACH,wBAFW,MAAM,GADL,OAAO,CAiBlB;IAED;;;OAGG;IACH,UAFa,WAAW,CAKvB;IAED;;;OAGG;IACH,UAFa,WAAW,CAKvB;IAED;;;;OAIG;IACH,eAHW,MAAM,GACJ,WAAW,CASvB;IAED;;;OAGG;IACH,gBAFW,WAAW,QAgBrB;IAED,cAGC;IAED;;;OAGG;IACH,SAFa,MAAM,CAsBlB;;CA0BJ"}
+{"version":3,"file":"LineBuilder.d.ts","sourceRoot":"","sources":["../../../../src/core/codegen/LineBuilder.js"],"names":[],"mappings":";AA+BA;;GAEG;AACH;IA0II;;;;OAIG;IACH,sBAJW,MAAM,mBACN,MAAM,GACJ,WAAW,CAuBvB;IAtJD;;;OAGG;IACH,cAFU,MAAM,CAEqB;IAErC;;;OAGG;IACH,oBAEC;IAED;;;;OAIG;IACH,wBAFW,MAAM,GADL,OAAO,CAoBlB;IAED;;;OAGG;IACH,UAFa,WAAW,CAKvB;IAED;;;OAGG;IACH,UAFa,WAAW,CAOvB;IAED;;;;OAIG;IACH,eAHW,MAAM,GACJ,WAAW,CASvB;IAED;;;OAGG;IACH,gBAFW,WAAW,QAiBrB;IAED,cAGC;IAED;;;OAGG;IACH,SAFa,MAAM,CAsBlB;IA8BD,mBAEC;;CACJ"}

package/src/core/codegen/LineBuilder.js

@@ -1,14 +1,30 @@
+import { assert } from "../assert.js";
+
 class Line {
     /**
      *
      * @param {string} text
      * @param {number} indent
-     * @constructor
      */
     constructor(text, indent) {
+        assert.isString(text, 'text');
+        assert.isNonNegativeInteger(indent, 'index');
+
+        /**
+         *
+         * @type {string}
+         */
         this.text = text;
+        /**
+         *
+         * @type {number}
+         */
         this.indentation = indent;
     }
+
+    toString() {
+        return `Line{ indentation=${this.indentation}, text="${this.text}" }`
+    }
 }
 
 const DEFAULT_INDENT_SPACES = 4;
@@ -25,13 +41,13 @@ class LineBuilder {
     #lines = [];
 
     /**
-     *
+     * Current indent level
      * @type {number}
      */
     #indentation = 0;
 
     /**
-     *
+     * TODO replace with indent string, that is tab, space or any combination or something else entirely
      * @type {number}
      */
     indentSpaces = DEFAULT_INDENT_SPACES;
@@ -50,8 +66,11 @@ class LineBuilder {
      * @param {string} term
      */
     containsSubstring(term) {
+        assert.isString(term, 'term');
+
         const lines = this.#lines;
         const n = lines.length;
+
         for (let i = 0; i < n; i++) {
             const line = lines[i];
 
@@ -79,6 +98,8 @@ class LineBuilder {
      * @returns {LineBuilder}
      */
     dedent() {
+        assert.greaterThan(this.#indentation, 0, 'indentation is already at 0');
+
         this.#indentation--;
         return this;
     }
@@ -102,6 +123,7 @@ class LineBuilder {
      * @param {LineBuilder} lines
      */
     addLines(lines) {
+        assert.defined(lines, 'lines');
 
         const other_lines = lines.#lines;
 
@@ -149,14 +171,17 @@ class LineBuilder {
     }
 
     /**
-     *
      * @param {string} text
+     * @param {string} [line_separator] defaults to new-line character
      * @returns {LineBuilder}
      */
-    static fromText(text) {
+    static fromText(text, line_separator = '\n') {
+        assert.isString(text, 'text');
+        assert.isString(line_separator, 'line_separator');
+
         const r = new LineBuilder();
 
-        const lines = text.split('\n');
+        const lines = text.split(line_separator);
 
         const n = lines.length;
 
@@ -172,6 +197,10 @@ class LineBuilder {
 
         return r;
     }
+
+    toString() {
+        return this.build();
+    }
 }
 
 export default LineBuilder;