lib0 0.2.63 → 0.2.65

package/storage.js

@@ -8,7 +8,7 @@
  * @module storage
  */
 
-/* istanbul ignore next */
+/* c8 ignore start */
 class VarStoragePolyfill {
   constructor () {
     this.map = new Map()
@@ -29,34 +29,35 @@ class VarStoragePolyfill {
     return this.map.get(key)
   }
 }
+/* c8 ignore stop */
 
-/* istanbul ignore next */
 /**
  * @type {any}
  */
 let _localStorage = new VarStoragePolyfill()
 let usePolyfill = true
 
+/* c8 ignore start */
 try {
   // if the same-origin rule is violated, accessing localStorage might thrown an error
-  /* istanbul ignore next */
   if (typeof localStorage !== 'undefined') {
     _localStorage = localStorage
     usePolyfill = false
   }
 } catch (e) { }
+/* c8 ignore stop */
 
-/* istanbul ignore next */
 /**
  * This is basically localStorage in browser, or a polyfill in nodejs
  */
+/* c8 ignore next */
 export const varStorage = _localStorage
 
-/* istanbul ignore next */
 /**
  * A polyfill for `addEventListener('storage', event => {..})` that does nothing if the polyfill is being used.
  *
  * @param {function({ key: string, newValue: string, oldValue: string }): void} eventHandler
  * @function
  */
+/* c8 ignore next */
 export const onChange = eventHandler => usePolyfill || addEventListener('storage', /** @type {any} */ (eventHandler))

package/string.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["string.js"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,0DAA+C;AAC/C,gEAAiD;AAc1C,4BAHI,MAAM,GACL,MAAM,CAEuC;AASlD,iCAJI,MAAM,aACN,MAAM,GACL,MAAM,CAEkH;AAO7H,oCAHI,MAAM,GACL,MAAM,CAE2D;AAMtE,yCAHI,MAAM,GACL,UAAU,CAUrB;AAGD,0CAAyH;AAMlH,uCAHI,MAAM,GACL,UAAU,CAE6C;AAjB5D,gCAHI,MAAM,GACL,UAAU,CAUrB;AAsBM,yCAHI,UAAU,GACT,MAAM,CAejB;AAGD,+CAAmI;AAiB5H,uCAHI,UAAU,GACT,MAAM,CAE8E;AAjCzF,gCAHI,UAAU,GACT,MAAM,CAejB;AAmCM,4BALI,MAAM,SACN,MAAM,UACN,MAAM,WACN,MAAM,UAEkG"}
+{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["string.js"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,0DAA+C;AAC/C,gEAAiD;AAc1C,4BAHI,MAAM,GACL,MAAM,CAEuC;AASlD,iCAJI,MAAM,aACN,MAAM,GACL,MAAM,CAEkH;AAO7H,oCAHI,MAAM,GACL,MAAM,CAE2D;AAMtE,yCAHI,MAAM,GACL,UAAU,CAUrB;AAGD,0CAAyH;AAMlH,uCAHI,MAAM,GACL,UAAU,CAE6C;AAjB5D,gCAHI,MAAM,GACL,UAAU,CAUrB;AAsBM,yCAHI,UAAU,GACT,MAAM,CAejB;AAGD,+CAAmI;AAkB5H,uCAHI,UAAU,GACT,MAAM,CAE8E;AAlCzF,gCAHI,UAAU,GACT,MAAM,CAejB;AAoCM,4BALI,MAAM,SACN,MAAM,UACN,MAAM,WACN,MAAM,UAEkG"}

package/string.js

@@ -51,7 +51,7 @@ export const _encodeUtf8Polyfill = str => {
   return buf
 }
 
-/* istanbul ignore next */
+/* c8 ignore next */
 export const utf8TextEncoder = /** @type {TextEncoder} */ (typeof TextEncoder !== 'undefined' ? new TextEncoder() : null)
 
 /**
@@ -64,7 +64,7 @@ export const _encodeUtf8Native = str => utf8TextEncoder.encode(str)
  * @param {string} str
  * @return {Uint8Array}
  */
-/* istanbul ignore next */
+/* c8 ignore next */
 export const encodeUtf8 = utf8TextEncoder ? _encodeUtf8Native : _encodeUtf8Polyfill
 
 /**
@@ -86,19 +86,20 @@ export const _decodeUtf8Polyfill = buf => {
   return decodeURIComponent(escape(encodedString))
 }
 
-/* istanbul ignore next */
+/* c8 ignore next */
 export let utf8TextDecoder = typeof TextDecoder === 'undefined' ? null : new TextDecoder('utf-8', { fatal: true, ignoreBOM: true })
 
-/* istanbul ignore next */
+/* c8 ignore start */
 if (utf8TextDecoder && utf8TextDecoder.decode(new Uint8Array()).length === 1) {
   // Safari doesn't handle BOM correctly.
   // This fixes a bug in Safari 13.0.5 where it produces a BOM the first time it is called.
   // utf8TextDecoder.decode(new Uint8Array()).length === 1 on the first call and
   // utf8TextDecoder.decode(new Uint8Array()).length === 1 on the second call
   // Another issue is that from then on no BOM chars are recognized anymore
-  /* istanbul ignore next */
+  /* c8 ignore next */
   utf8TextDecoder = null
 }
+/* c8 ignore stop */
 
 /**
  * @param {Uint8Array} buf
@@ -110,7 +111,7 @@ export const _decodeUtf8Native = buf => /** @type {TextDecoder} */ (utf8TextDeco
  * @param {Uint8Array} buf
  * @return {string}
  */
-/* istanbul ignore next */
+/* c8 ignore next */
 export const decodeUtf8 = utf8TextDecoder ? _decodeUtf8Native : _decodeUtf8Polyfill
 
 /**

package/symbol.test.d.ts

@@ -0,0 +1,3 @@
+export function testBasicSymbolFeatures(_tc: t.TestCase): void;
+import * as t from "./testing.js";
+//# sourceMappingURL=symbol.test.d.ts.map

package/symbol.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbol.test.d.ts","sourceRoot":"","sources":["symbol.test.js"],"names":[],"mappings":"AAMO,6CAFI,EAAE,QAAQ,QAQpB"}

package/test.html

@@ -1,9 +1,157 @@
+
 <!DOCTYPE html>
 <html>
 <head>
   <title>Testing lib0</title>
+  <script type="importmap">
+    {
+      "imports": {
+  "lib0/package.json": "./package.json",
+  "lib0": "./index.js",
+  "lib0/array.js": "./array.js",
+  "lib0/dist/array.cjs": "./dist/array.cjs",
+  "lib0/array": "./array.js",
+  "lib0/binary.js": "./binary.js",
+  "lib0/dist/binary.cjs": "./dist/binary.cjs",
+  "lib0/binary": "./binary.js",
+  "lib0/broadcastchannel.js": "./broadcastchannel.js",
+  "lib0/dist/broadcastchannel.cjs": "./dist/broadcastchannel.cjs",
+  "lib0/broadcastchannel": "./broadcastchannel.js",
+  "lib0/buffer.js": "./buffer.js",
+  "lib0/dist/buffer.cjs": "./dist/buffer.cjs",
+  "lib0/buffer": "./buffer.js",
+  "lib0/cache.js": "./cache.js",
+  "lib0/dist/cache.cjs": "./dist/cache.cjs",
+  "lib0/cache": "./cache.js",
+  "lib0/component.js": "./component.js",
+  "lib0/dist/component.cjs": "./dist/component.cjs",
+  "lib0/component": "./component.js",
+  "lib0/conditions.js": "./conditions.js",
+  "lib0/dist/conditions.cjs": "./dist/conditions.cjs",
+  "lib0/conditions": "./condititons.js",
+  "lib0/crypto/aes-gcm": "./crypto/aes-gcm.js",
+  "lib0/crypto/ecdsa": "./crypto/ecdsa.js",
+  "lib0/crypto/rsa-oaep": "./crypto/rsa-oaep.js",
+  "lib0/decoding.js": "./decoding.js",
+  "lib0/dist/decoding.cjs": "./dist/decoding.cjs",
+  "lib0/decoding": "./decoding.js",
+  "lib0/diff.js": "./diff.js",
+  "lib0/dist/diff.cjs": "./dist/diff.cjs",
+  "lib0/diff": "./diff.js",
+  "lib0/dom.js": "./dom.js",
+  "lib0/dist/dom.cjs": "./dist/dom.cjs",
+  "lib0/dom": "./dom.js",
+  "lib0/encoding.js": "./encoding.js",
+  "lib0/dist/encoding.cjs": "./dist/encoding.cjs",
+  "lib0/encoding": "./encoding.js",
+  "lib0/environment.js": "./environment.js",
+  "lib0/dist/environment.cjs": "./dist/environment.cjs",
+  "lib0/environment": "./environment.js",
+  "lib0/error.js": "./error.js",
+  "lib0/dist/error.cjs": "./dist/error.cjs",
+  "lib0/error": "./error.js",
+  "lib0/eventloop.js": "./eventloop.js",
+  "lib0/dist/eventloop.cjs": "./dist/eventloop.cjs",
+  "lib0/eventloop": "./eventloop.js",
+  "lib0/function.js": "./function.js",
+  "lib0/dist/function.cjs": "./dist/function.cjs",
+  "lib0/function": "./function.js",
+  "lib0/indexeddb.js": "./indexeddb.js",
+  "lib0/dist/indexeddb.cjs": "./dist/indexeddb.cjs",
+  "lib0/indexeddb": "./indexeddb.js",
+  "lib0/isomorphic.js": "./isomorphic.js",
+  "lib0/dist/isomorphic.cjs": "./dist/isomorphic.cjs",
+  "lib0/isomorphic": "./isomorphic.js",
+  "lib0/iterator.js": "./iterator.js",
+  "lib0/dist/iterator.cjs": "./dist/iterator.cjs",
+  "lib0/iterator": "./iterator.js",
+  "lib0/json.js": "./json.js",
+  "lib0/dist/json.cjs": "./dist/json.cjs",
+  "lib0/json": "./json.js",
+  "lib0/list.js": "./list.js",
+  "lib0/dist/list.cjs": "./dist/list.cjs",
+  "lib0/list": "./list.js",
+  "lib0/logging.js": "./logging.js",
+  "lib0/dist/logging.cjs": "./dist/logging.cjs",
+  "lib0/logging": "./logging.js",
+  "lib0/map.js": "./map.js",
+  "lib0/dist/map.cjs": "./dist/map.cjs",
+  "lib0/map": "./map.js",
+  "lib0/math.js": "./math.js",
+  "lib0/dist/math.cjs": "./dist/math.cjs",
+  "lib0/math": "./math.js",
+  "lib0/metric.js": "./metric.js",
+  "lib0/dist/metric.cjs": "./dist/metric.cjs",
+  "lib0/metric": "./metric.js",
+  "lib0/mutex.js": "./mutex.js",
+  "lib0/dist/mutex.cjs": "./dist/mutex.cjs",
+  "lib0/mutex": "./mutex.js",
+  "lib0/number.js": "./number.js",
+  "lib0/dist/number.cjs": "./dist/number.cjs",
+  "lib0/number": "./number.js",
+  "lib0/object.js": "./object.js",
+  "lib0/dist/object.cjs": "./dist/object.cjs",
+  "lib0/object": "./object.js",
+  "lib0/observable.js": "./observable.js",
+  "lib0/dist/observable.cjs": "./dist/observable.cjs",
+  "lib0/observable": "./observable.js",
+  "lib0/pair.js": "./pair.js",
+  "lib0/dist/pair.cjs": "./dist/pair.cjs",
+  "lib0/pair": "./pair.js",
+  "lib0/prng.js": "./prng.js",
+  "lib0/dist/prng.cjs": "./dist/prng.cjs",
+  "lib0/prng": "./prng.js",
+  "lib0/promise.js": "./promise.js",
+  "lib0/dist/promise.cjs": "./dist/promise.cjs",
+  "lib0/promise": "./promise.js",
+  "lib0/queue.js": "./queue.js",
+  "lib0/dist/queue.cjs": "./dist/queue.cjs",
+  "lib0/queue": "./queue.js",
+  "lib0/random.js": "./random.js",
+  "lib0/dist/random.cjs": "./dist/random.cjs",
+  "lib0/random": "./random.js",
+  "lib0/set.js": "./set.js",
+  "lib0/dist/set.cjs": "./dist/set.cjs",
+  "lib0/set": "./set.js",
+  "lib0/sort.js": "./sort.js",
+  "lib0/dist/sort.cjs": "./dist/sort.cjs",
+  "lib0/sort": "./sort.js",
+  "lib0/statistics.js": "./statistics.js",
+  "lib0/dist/statistics.cjs": "./dist/statistics.cjs",
+  "lib0/statistics": "./statistics.js",
+  "lib0/storage.js": "./storage.js",
+  "lib0/dist/storage.cjs": "./dist/storage.cjs",
+  "lib0/storage": "./storage.js",
+  "lib0/string.js": "./string.js",
+  "lib0/dist/string.cjs": "./dist/string.cjs",
+  "lib0/string": "./string.js",
+  "lib0/symbol.js": "./symbol.js",
+  "lib0/dist/symbol.cjs": "./dist/symbol.cjs",
+  "lib0/symbol": "./symbol.js",
+  "lib0/testing.js": "./testing.js",
+  "lib0/dist/testing.cjs": "./dist/testing.cjs",
+  "lib0/testing": "./testing.js",
+  "lib0/time.js": "./time.js",
+  "lib0/dist/time.cjs": "./dist/time.cjs",
+  "lib0/time": "./time.js",
+  "lib0/tree.js": "./tree.js",
+  "lib0/dist/tree.cjs": "./dist/tree.cjs",
+  "lib0/tree": "./tree.js",
+  "lib0/url.js": "./url.js",
+  "lib0/dist/url.cjs": "./dist/url.cjs",
+  "lib0/url": "./url.js",
+  "lib0/websocket.js": "./websocket.js",
+  "lib0/dist/websocket.cjs": "./dist/websocket.cjs",
+  "lib0/websocket": "./websocket.js",
+  "lib0/webcrypto": "./webcrypto.browser.js",
+  "isomorphic.js": "./node_modules/isomorphic.js/browser.mjs",
+  "isomorphic.js/package.json": "./node_modules/isomorphic.js/package.json"
+}
+    }
+  </script>
 </head>
 <body>
-  <script type="module" src="./dist/test.js"></script>
+  <script type="module" src="./test.js"></script>
 </body>
-</html>
+</html>
+

package/test.js

@@ -31,10 +31,11 @@ import * as func from './function.test.js'
 import * as storage from './storage.test.js'
 import * as list from './list.test.js'
 import * as cache from './cache.test.js'
+import * as symbol from './symbol.test.js'
 
 import { isBrowser, isNode } from './environment.js'
 
-/* istanbul ignore if */
+/* c8 ignore next */
 if (isBrowser) {
   log.createVConsole(document.body)
 }
@@ -70,9 +71,10 @@ runTests({
   func,
   storage,
   list,
-  cache
+  cache,
+  symbol
 }).then(success => {
-  /* istanbul ignore next */
+  /* c8 ignore next */
   if (isNode) {
     process.exit(success ? 0 : 1)
   }

package/testing.d.ts

@@ -43,9 +43,10 @@ export function compareArrays<T>(as: T[], bs: T[], m?: string | undefined): bool
 export function compareStrings(a: string, b: string, m?: string | undefined): void;
 export function compareObjects<K, V>(a: any, b: any, m?: string | undefined): void;
 export function compare<T>(a: T, b: T, message?: string | null | undefined, customCompare?: ((arg0: any, arg1: T, arg2: T, arg3: string, arg4: any) => boolean) | undefined): boolean;
-export function assert(condition: boolean, message?: string | null | undefined): true;
+export function assert<T>(property: T, message?: string | null | undefined): asserts property is NonNullable<T>;
 export function promiseRejected(f: () => Promise<any>): Promise<void>;
 export function fails(f: () => void): void;
+export function failsAsync(f: () => Promise<any>): Promise<void>;
 export function runTests(tests: {
     [x: string]: {
         [x: string]: (arg0: TestCase) => void | Promise<any>;

package/testing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["testing.js"],"names":[],"mappings":";AA+DA,gCAAiD;AAGjD,oCAAmG;AAEnG;IACE;;;OAGG;IACH,wBAHW,MAAM,YACN,MAAM,EAahB;IAVC;;OAEG;IACH,YAFU,MAAM,CAEY;IAC5B;;OAEG;IACH,UAFU,MAAM,CAEQ;IACxB,qBAAiB;IACjB,wBAAiB;IAGnB,kBAGC;IAED;;OAEG;IAEH,mBAOC;IAED;;;;OAIG;IACH,sBAMC;CACF;AAED,oCAA6E;AAgBtE,gCANI,MAAM,QACN,MAAM,YACG,QAAQ,KAAE,IAAI,GAAC,QAAQ,GAAG,CAAC,KACpC,MAAM,iBACN,MAAM,oBAyEhB;AAcM,sCAHI,MAAM,SACN,MAAM,QAEwF;AAYlG,2BAFI,MAAM,QAE6B;AAE9C,wDAAoC;AAEpC,8EAA0C;AAoBnC,mCAHI,MAAM,YACG,IAAI,KAAE,IAAI,QAS7B;AAoBM,wCAHI,MAAM,YACG,IAAI,KAAE,QAAQ,GAAG,CAAC,iBASrC;AAoBM,qCAJI,MAAM,WACK,IAAI,GACd,MAAM,CAYjB;AAoBM,0CAJI,MAAM,WACK,QAAQ,GAAG,CAAC,GACtB,QAAQ,MAAM,CAAC,CAY1B;AASM,4EAFK,OAAO,CAYlB;AAQM,kCALI,MAAM,KACN,MAAM,gCAUhB;AASM,mFAA2F;AAsH3F,oGAFa,GAAG,0BAAK,MAAM,QAAC,GAAG,KAAE,OAAO,wBAE8E;AAQtH,kCAJI,OAAO,6CAIiH;AAK5H,yCAFe,QAAQ,GAAG,CAAC,iBASjC;AAMM,+BAHe,IAAI,QAWzB;AAKM;QAFW,MAAM;YAAS,MAAM,UAAW,QAAQ,KAAE,IAAI,GAAC,QAAQ,GAAG,CAAC;;qBA4C5E;AAQM,6BAHI,MAAM,SAMhB;AAQM,4BAHI,OAAO,QAOjB"}
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["testing.js"],"names":[],"mappings":";AA+DA,gCAAiD;AAGjD,oCAAmG;AAEnG;IACE;;;OAGG;IACH,wBAHW,MAAM,YACN,MAAM,EAahB;IAVC;;OAEG;IACH,YAFU,MAAM,CAEY;IAC5B;;OAEG;IACH,UAFU,MAAM,CAEQ;IACxB,qBAAiB;IACjB,wBAAiB;IAGnB,kBAGC;IAED;;OAEG;IAEH,mBAOC;IAED;;;;OAIG;IACH,sBAMC;CACF;AAED,oCAA6E;AAgBtE,gCANI,MAAM,QACN,MAAM,YACG,QAAQ,KAAE,IAAI,GAAC,QAAQ,GAAG,CAAC,KACpC,MAAM,iBACN,MAAM,oBA0EhB;AAcM,sCAHI,MAAM,SACN,MAAM,QAEwF;AAYlG,2BAFI,MAAM,QAE6B;AAE9C,wDAAoC;AAEpC,8EAA0C;AAoBnC,mCAHI,MAAM,YACG,IAAI,KAAE,IAAI,QAS7B;AAoBM,wCAHI,MAAM,YACG,IAAI,KAAE,QAAQ,GAAG,CAAC,iBASrC;AAoBM,qCAJI,MAAM,WACK,IAAI,GACd,MAAM,CAYjB;AAoBM,0CAJI,MAAM,WACK,QAAQ,GAAG,CAAC,GACtB,QAAQ,MAAM,CAAC,CAY1B;AASM,4EAFK,OAAO,CAYlB;AAQM,kCALI,MAAM,KACN,MAAM,gCAUhB;AASM,mFAA2F;AAsH3F,oGAFa,GAAG,0BAAK,MAAM,QAAC,GAAG,KAAE,OAAO,wBAE8E;AAUtH,gHAA8H;AAK9H,yCAFe,QAAQ,GAAG,CAAC,iBASjC;AAMM,+BAHe,IAAI,QAWzB;AAMM,oCAHe,QAAQ,GAAG,CAAC,iBAWjC;AAKM;QAFW,MAAM;YAAS,MAAM,UAAW,QAAQ,KAAE,IAAI,GAAC,QAAQ,GAAG,CAAC;;qBA2C5E;AAQM,6BAHI,MAAM,SAMhB;AAQM,4BAHI,OAAO,QAOjB"}

package/testing.js

@@ -63,7 +63,7 @@ export { production } from './environment.js'
 
 export const extensive = env.hasConf('extensive')
 
-/* istanbul ignore next */
+/* c8 ignore next */
 export const envSeed = env.hasParam('--seed') ? Number.parseInt(env.getParam('--seed', '0')) : null
 
 export class TestCase {
@@ -92,11 +92,11 @@ export class TestCase {
   /**
    * @type {number}
    */
-  /* istanbul ignore next */
+  /* c8 ignore next */
   get seed () {
-    /* istanbul ignore else */
+    /* c8 ignore else */
     if (this._seed === null) {
-      /* istanbul ignore next */
+      /* c8 ignore next */
       this._seed = envSeed === null ? random.uint32() : envSeed
     }
     return this._seed
@@ -108,7 +108,7 @@ export class TestCase {
    * @type {prng.PRNG}
    */
   get prng () {
-    /* istanbul ignore else */
+    /* c8 ignore else */
     if (this._prng === null) {
       this._prng = prng.create(this.seed)
     }
@@ -117,10 +117,10 @@ export class TestCase {
 }
 
 export const repetitionTime = Number(env.getParam('--repetition-time', '50'))
-/* istanbul ignore next */
+/* c8 ignore next */
 const testFilter = env.hasParam('--filter') ? env.getParam('--filter', '') : null
 
-/* istanbul ignore next */
+/* c8 ignore next */
 const testFilterRegExp = testFilter !== null ? new RegExp(testFilter) : new RegExp('.*')
 
 const repeatTestRegex = /^(repeat|repeating)\s/
@@ -135,14 +135,14 @@ const repeatTestRegex = /^(repeat|repeating)\s/
 export const run = async (moduleName, name, f, i, numberOfTests) => {
   const uncamelized = string.fromCamelCase(name.slice(4), ' ')
   const filtered = !testFilterRegExp.test(`[${i + 1}/${numberOfTests}] ${moduleName}: ${uncamelized}`)
-  /* istanbul ignore if */
+  /* c8 ignore next 3 */
   if (filtered) {
     return true
   }
   const tc = new TestCase(moduleName, name)
   const repeat = repeatTestRegex.test(uncamelized)
   const groupArgs = [log.GREY, `[${i + 1}/${numberOfTests}] `, log.PURPLE, `${moduleName}: `, log.BLUE, uncamelized]
-  /* istanbul ignore next */
+  /* c8 ignore next 5 */
   if (testFilter === null) {
     log.groupCollapsed(...groupArgs)
   } else {
@@ -175,7 +175,7 @@ export const run = async (moduleName, name, f, i, numberOfTests) => {
     }
   } while (err === null && (lastTime - start) < repetitionTime)
   performance.mark(`${name}-end`)
-  /* istanbul ignore if */
+  /* c8 ignore next 3 */
   if (err !== null && err.constructor !== SkipError) {
     log.printError(err)
   }
@@ -184,7 +184,7 @@ export const run = async (moduleName, name, f, i, numberOfTests) => {
   const duration = lastTime - start
   let success = true
   times.sort((a, b) => a - b)
-  /* istanbul ignore next */
+  /* c8 ignore next 3 */
   const againMessage = env.isBrowser
     ? `     - ${window.location.host + window.location.pathname}?filter=\\[${i + 1}/${tc._seed === null ? '' : `&seed=${tc._seed}`}`
     : `\nrepeat: npm run test -- --filter "\\[${i + 1}/" ${tc._seed === null ? '' : `--seed ${tc._seed}`}`
@@ -192,13 +192,14 @@ export const run = async (moduleName, name, f, i, numberOfTests) => {
     ? ` - ${times.length} repetitions in ${time.humanizeDuration(duration)} (best: ${time.humanizeDuration(times[0])}, worst: ${time.humanizeDuration(array.last(times))}, median: ${time.humanizeDuration(statistics.median(times))}, average: ${time.humanizeDuration(statistics.average(times))})`
     : ` in ${time.humanizeDuration(duration)}`
   if (err !== null) {
-    /* istanbul ignore else */
+    /* c8 ignore start */
     if (err.constructor === SkipError) {
       log.print(log.GREY, log.BOLD, 'Skipped: ', log.UNBOLD, uncamelized)
     } else {
       success = false
       log.print(log.RED, log.BOLD, 'Failure: ', log.UNBOLD, log.UNCOLOR, uncamelized, log.GREY, timeInfo, againMessage)
     }
+    /* c8 ignore stop */
   } else {
     log.print(log.GREEN, log.BOLD, 'Success: ', log.UNBOLD, log.UNCOLOR, uncamelized, log.GREY, timeInfo, againMessage)
   }
@@ -490,7 +491,7 @@ const _compare = (a, b, path, message, customCompare) => {
       // @ts-ignore
       a.forEach((value, i) => _compare(value, b[i], `${path}[${i}]`, message, customCompare))
       break
-    /* istanbul ignore next */
+    /* c8 ignore next 4 */
     default:
       if (!customCompare(a.constructor, a, b, path, compareValues)) {
         _failMessage(message, `Values ${json.stringify(a)} and ${json.stringify(b)} don't match`, path)
@@ -509,13 +510,15 @@ const _compare = (a, b, path, message, customCompare) => {
  */
 export const compare = (a, b, message = null, customCompare = compareValues) => _compare(a, b, 'obj', message, customCompare)
 
-/* istanbul ignore next */
 /**
- * @param {boolean} condition
+ * @template T
+ * @param {T} property
  * @param {string?} [message]
+ * @return {asserts property is NonNullable<T>}
  * @throws {TestError}
  */
-export const assert = (condition, message = null) => condition || fail(`Assertion failed${message !== null ? `: ${message}` : ''}`)
+/* c8 ignore next */
+export const assert = (property, message = null) => { property || fail(`Assertion failed${message !== null ? `: ${message}` : ''}`) }
 
 /**
  * @param {function():Promise<any>} f
@@ -543,6 +546,20 @@ export const fails = f => {
   fail('Expected this to fail')
 }
 
+/**
+ * @param {function():Promise<any>} f
+ * @throws {TestError}
+ */
+export const failsAsync = async f => {
+  try {
+    await f()
+  } catch (_err) {
+    log.print(log.GREEN, '⇖ This Error was expected')
+    return
+  }
+  fail('Expected this to fail')
+}
+
 /**
  * @param {Object<string, Object<string, function(TestCase):void|Promise<any>>>} tests
  */
@@ -551,7 +568,7 @@ export const runTests = async tests => {
    * @param {string} testname
    */
   const filterTest = testname => testname.startsWith('test') || testname.startsWith('benchmark')
-  const numberOfTests = object.map(tests, mod => object.map(mod, (f, fname) => /* istanbul ignore next */ f && filterTest(fname) ? 1 : 0).reduce(math.add, 0)).reduce(math.add, 0)
+  const numberOfTests = object.map(tests, mod => object.map(mod, (f, fname) => /* c8 ignore next */ f && filterTest(fname) ? 1 : 0).reduce(math.add, 0)).reduce(math.add, 0)
   let successfulTests = 0
   let testnumber = 0
   const start = performance.now()
@@ -559,7 +576,7 @@ export const runTests = async tests => {
     const mod = tests[modName]
     for (const fname in mod) {
       const f = mod[fname]
-      /* istanbul ignore else */
+      /* c8 ignore else */
       if (f && filterTest(fname)) {
         const repeatEachTest = 1
         let success = true
@@ -567,7 +584,7 @@ export const runTests = async tests => {
           success = await run(modName, fname, f, testnumber, numberOfTests)
         }
         testnumber++
-        /* istanbul ignore else */
+        /* c8 ignore else */
         if (success) {
           successfulTests++
         }
@@ -577,16 +594,15 @@ export const runTests = async tests => {
   const end = performance.now()
   log.print('')
   const success = successfulTests === numberOfTests
-  /* istanbul ignore next */
+  /* c8 ignore start */
   if (success) {
-    /* istanbul ignore next */
     log.print(log.GREEN, log.BOLD, 'All tests successful!', log.GREY, log.UNBOLD, ` in ${time.humanizeDuration(end - start)}`)
-    /* istanbul ignore next */
     log.printImgBase64(nyanCatImage, 50)
   } else {
     const failedTests = numberOfTests - successfulTests
     log.print(log.RED, log.BOLD, `> ${failedTests} test${failedTests > 1 ? 's' : ''} failed`)
   }
+  /* c8 ignore stop */
   return success
 }
 

package/testing.test.d.ts

@@ -1,4 +1,5 @@
 export function nottestingNotTested(): void;
+export function testAssertTyping(): void;
 export function testComparing(_tc: t.TestCase): void;
 export function testFailing(): Promise<void>;
 export function testSkipping(): void;

package/testing.test.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"testing.test.d.ts","sourceRoot":"","sources":["testing.test.js"],"names":[],"mappings":"AAQO,4CAEN;AAKM,mCAFI,EAAE,QAAQ,QA+FpB;AAEM,6CAWN;AAEM,qCAMN;AAEM,2CAIN;AAEM,6CAON"}
+{"version":3,"file":"testing.test.d.ts","sourceRoot":"","sources":["testing.test.js"],"names":[],"mappings":"AAQO,4CAEN;AAEM,yCAMN;AAKM,mCAFI,EAAE,QAAQ,QA+FpB;AAEM,6CAcN;AAEM,qCAMN;AAEM,2CAIN;AAEM,6CAON"}

package/time.js

@@ -41,7 +41,7 @@ export const humanizeDuration = d => {
     return days + 'd' + ((hours > 0 || minutes > 30) ? ' ' + (minutes > 30 ? hours + 1 : hours) + 'h' : '')
   }
   if (hours > 0) {
-    /* istanbul ignore next */
+    /* c8 ignore next */
     return hours + 'h' + ((minutes > 0 || seconds > 30) ? ' ' + (seconds > 30 ? minutes + 1 : minutes) + 'min' : '')
   }
   return minutes + 'min' + (seconds > 0 ? ' ' + seconds + 's' : '')

package/tree.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["tree.js"],"names":[],"mappings":"AAgJA;;;;GAIG;AACH;IAEI,UAAgB;IAChB,eAAe;IAGjB;;OAEG;IACH,aAFW,CAAC,KAMX;IAED;;OAEG;IACH,aAFW,CAAC,KAMX;IAED;;OAEG;IACH,6BAFW,CAAC,OA0BX;IAED;;OAEG;IACH,2BAFW,CAAC,OA6BX;IAED;;OAEG;IACH,oBAFY,CAAC,CAQZ;IAED;;;OAGG;IACH,yBAHW,CAAC,GACA,CAAC,CAKZ;IAED;;;OAGG;IACH,uBAHW,CAAC,GACA,CAAC,CAKZ;IAED;;;;OAIG;IACH,cAJW,CAAC,qBAEQ,CAAC,KAAE,IAAI,QAoB1B;IAED;;;OAGG;IACH,SAHW,CAAC,GACA,CAAC,GAAC,IAAI,CASjB;IAED;;;OAGG;IACH,aAHW,CAAC,GACA,EAAE,CAAC,CAAC,GAAC,IAAI,CAoBpB;IAED;;OAEG;IACH,WAFW,CAAC,QAmEX;IAED,yBAmEC;IAED,iBA+BC;IAED,yBA8CC;CACF;AA5gBD;;GAEG;AACH;IACE;;;;OAIG;IACH,iBAFW,CAAC,EAQX;IALC,OAAc;IACd,eAAiB;IACjB,WAAiB;IACjB,YAAkB;IAClB,aAAmB;IAGrB,iBAA8B;IAC9B,mBAAiC;IACjC,eAA4C;IAC5C,gBAA8C;IAC9C,uBAEC;IAED,kBAEC;IAED,mBAGC;IAUD,mBAKC;IAbD,gBAEC;IAaD,oBAKC;IAhBD,iBAEC;IAgBD,4BAOC;IAED,YAeC;IAED,YAeC;IAED,6BAOC;IAED,gBAOC;CACF"}
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["tree.js"],"names":[],"mappings":"AAiJA;;;;GAIG;AACH;IAEI,UAAgB;IAChB,eAAe;IAGjB;;OAEG;IACH,aAFW,CAAC,KAMX;IAED;;OAEG;IACH,aAFW,CAAC,KAMX;IAED;;OAEG;IACH,6BAFW,CAAC,OA0BX;IAED;;OAEG;IACH,2BAFW,CAAC,OA6BX;IAED;;OAEG;IACH,oBAFY,CAAC,CAQZ;IAED;;;OAGG;IACH,yBAHW,CAAC,GACA,CAAC,CAKZ;IAED;;;OAGG;IACH,uBAHW,CAAC,GACA,CAAC,CAKZ;IAED;;;;OAIG;IACH,cAJW,CAAC,qBAEQ,CAAC,KAAE,IAAI,QAoB1B;IAED;;;OAGG;IACH,SAHW,CAAC,GACA,CAAC,GAAC,IAAI,CASjB;IAED;;;OAGG;IACH,aAHW,CAAC,GACA,EAAE,CAAC,CAAC,GAAC,IAAI,CAoBpB;IAED;;OAEG;IACH,WAFW,CAAC,QAmEX;IAED,yBAmEC;IAED,iBA+BC;IAED,yBA8CC;CACF;AA7gBD;;GAEG;AACH;IACE;;;;OAIG;IACH,iBAFW,CAAC,EAQX;IALC,OAAc;IACd,eAAiB;IACjB,WAAiB;IACjB,YAAkB;IAClB,aAAmB;IAGrB,iBAA8B;IAC9B,mBAAiC;IACjC,eAA4C;IAC5C,gBAA8C;IAC9C,uBAEC;IAED,kBAEC;IAED,mBAIC;IAUD,mBAKC;IAbD,gBAEC;IAaD,oBAKC;IAhBD,iBAEC;IAgBD,4BAOC;IAED,YAeC;IAED,YAeC;IAED,6BAOC;IAED,gBAOC;CACF"}