lib0 0.2.62 → 0.2.64

package/README.md

@@ -78,7 +78,7 @@ import module from 'lib0/[module].js'
 <details><summary><b>[lib0/array]</b> Utility module to work with Arrays.</summary>
 <pre>import * as array from 'lib0/array'</pre>
 <dl>
-<b><code>array.last(arr: Array&lt;L&gt;): L</code></b><br>
+<b><code>array.last(arr: ArrayLike&lt;L&gt;): L</code></b><br>
 <dd><p>Return the last element of an array. The element must exist</p></dd>
 <b><code>array.create(): Array&lt;C&gt;</code></b><br>
 <b><code>array.copy(a: Array&lt;D&gt;): Array&lt;D&gt;</code></b><br>
@@ -86,15 +86,15 @@ import module from 'lib0/[module].js'
 <dd><p>Append elements from src to dest</p></dd>
 <b><code>array.from(arraylike: ArrayLike&lt;T&gt;|Iterable&lt;T&gt;): T</code></b><br>
 <dd><p>Transforms something array-like to an actual Array.</p></dd>
-<b><code>array.every(arr: Array&lt;ITEM&gt;, f: function(ITEM, number, Array&lt;ITEM&gt;):boolean): boolean</code></b><br>
+<b><code>array.every(arr: ARR, f: function(ITEM, number, ARR):boolean): boolean</code></b><br>
 <dd><p>True iff condition holds on every element in the Array.</p></dd>
-<b><code>array.some(arr: Array&lt;S&gt;, f: function(S, number, Array&lt;S&gt;):boolean): boolean</code></b><br>
+<b><code>array.some(arr: ARR, f: function(S, number, ARR):boolean): boolean</code></b><br>
 <dd><p>True iff condition holds on some element in the Array.</p></dd>
-<b><code>array.equalFlat(a: Array&lt;ELEM&gt;, b: Array&lt;ELEM&gt;): boolean</code></b><br>
+<b><code>array.equalFlat(a: ArrayLike&lt;ELEM&gt;, b: ArrayLike&lt;ELEM&gt;): boolean</code></b><br>
 <b><code>array.flatten(arr: Array&lt;Array&lt;ELEM&gt;&gt;): Array&lt;ELEM&gt;</code></b><br>
 <b><code>array.isArray</code></b><br>
 <b><code>array.unique(arr: Array&lt;T&gt;): Array&lt;T&gt;</code></b><br>
-<b><code>array.uniqueBy(arr: Array&lt;T&gt;, mapper: function(T):M): Array&lt;T&gt;</code></b><br>
+<b><code>array.uniqueBy(arr: ArrayLike&lt;T&gt;, mapper: function(T):M): Array&lt;T&gt;</code></b><br>
 </dl>
 </details>
 <details><summary><b>[lib0/binary]</b> Binary data constants.</summary>

package/array.d.ts

@@ -1,4 +1,4 @@
-export function last<L>(arr: L[]): L;
+export function last<L>(arr: ArrayLike<L>): L;
 export function create<C>(): C[];
 export function copy<D>(a: D[]): D[];
 export function appendTo<M>(dest: M[], src: M[]): void;
@@ -16,11 +16,11 @@ export const from: {
     <T_3>(iterable: Iterable<T_3> | ArrayLike<T_3>): T_3[];
     <T_4, U_1>(iterable: Iterable<T_4> | ArrayLike<T_4>, mapfn: (v: T_4, k: number) => U_1, thisArg?: any): U_1[];
 };
-export function every<ITEM>(arr: ITEM[], f: (arg0: ITEM, arg1: number, arg2: ITEM[]) => boolean): boolean;
-export function some<S>(arr: S[], f: (arg0: S, arg1: number, arg2: S[]) => boolean): boolean;
-export function equalFlat<ELEM>(a: ELEM[], b: ELEM[]): boolean;
+export function every<ITEM, ARR extends ArrayLike<ITEM>>(arr: ARR, f: (arg0: ITEM, arg1: number, arg2: ARR) => boolean): boolean;
+export function some<S, ARR extends ArrayLike<S>>(arr: ARR, f: (arg0: S, arg1: number, arg2: ARR) => boolean): boolean;
+export function equalFlat<ELEM>(a: ArrayLike<ELEM>, b: ArrayLike<ELEM>): boolean;
 export function flatten<ELEM>(arr: ELEM[][]): ELEM[];
 export const isArray: (arg: any) => arg is any[];
 export function unique<T_1>(arr: T_1[]): T_1[];
-export function uniqueBy<T_1, M>(arr: T_1[], mapper: (arg0: T_1) => M): T_1[];
+export function uniqueBy<T_1, M>(arr: ArrayLike<T_1>, mapper: (arg0: T_1) => M): T_1[];
 //# sourceMappingURL=array.d.ts.map

package/array.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["array.js"],"names":[],"mappings":"AAeO,qCAAuC;AAMvC,iCAAiD;AAOjD,qCAAqD;AASrD,uDAIN;AAED;;;;;;;GAOG;AACH;;;;;EAA8B;AAYvB,+DAHmB,MAAM,mBAAe,OAAO,GAC1C,OAAO,CAE0B;AAWtC,qDAHgB,MAAM,gBAAY,OAAO,GACpC,OAAO,CAEwB;AASpC,uDAFK,OAAO,CAEqF;AAOjG,qDAAoE;AAE3E,iDAAoC;AAO7B,+CAAyC;AASzC,8EAkBN"}
+{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["array.js"],"names":[],"mappings":"AAeO,8CAAuC;AAMvC,iCAAiD;AAOjD,qCAAqD;AASrD,uDAIN;AAED;;;;;;;GAOG;AACH;;;;;EAA8B;AAavB,yFAHmB,MAAM,gBAAO,OAAO,GAClC,OAAO,CASlB;AAYM,+EAHgB,MAAM,gBAAO,OAAO,GAC/B,OAAO,CASlB;AASM,yEAFK,OAAO,CAEqF;AAOjG,qDAAoE;AAE3E,iDAAoC;AAO7B,+CAAyC;AASzC,uFAkBN"}

package/array.js

@@ -10,7 +10,7 @@ import * as set from './set.js'
  * Return the last element of an array. The element must exist
  *
  * @template L
- * @param {Array<L>} arr
+ * @param {ArrayLike<L>} arr
  * @return {L}
  */
 export const last = arr => arr[arr.length - 1]
@@ -56,29 +56,45 @@ export const from = Array.from
  *
  * @function
  * @template ITEM
+ * @template {ArrayLike<ITEM>} ARR
  *
- * @param {Array<ITEM>} arr
- * @param {function(ITEM, number, Array<ITEM>):boolean} f
+ * @param {ARR} arr
+ * @param {function(ITEM, number, ARR):boolean} f
  * @return {boolean}
  */
-export const every = (arr, f) => arr.every(f)
+export const every = (arr, f) => {
+  for (let i = 0; i < arr.length; i++) {
+    if (!f(arr[i], i, arr)) {
+      return false
+    }
+  }
+  return true
+}
 
 /**
  * True iff condition holds on some element in the Array.
  *
  * @function
  * @template S
- * @param {Array<S>} arr
- * @param {function(S, number, Array<S>):boolean} f
+ * @template {ArrayLike<S>} ARR
+ * @param {ARR} arr
+ * @param {function(S, number, ARR):boolean} f
  * @return {boolean}
  */
-export const some = (arr, f) => arr.some(f)
+export const some = (arr, f) => {
+  for (let i = 0; i < arr.length; i++) {
+    if (f(arr[i], i, arr)) {
+      return true
+    }
+  }
+  return false
+}
 
 /**
  * @template ELEM
  *
- * @param {Array<ELEM>} a
- * @param {Array<ELEM>} b
+ * @param {ArrayLike<ELEM>} a
+ * @param {ArrayLike<ELEM>} b
  * @return {boolean}
  */
 export const equalFlat = (a, b) => a.length === b.length && every(a, (item, index) => item === b[index])
@@ -102,7 +118,7 @@ export const unique = arr => from(set.from(arr))
 /**
  * @template T
  * @template M
- * @param {Array<T>} arr
+ * @param {ArrayLike<T>} arr
  * @param {function(T):M} mapper
  * @return {Array<T>}
  */

package/array.test.d.ts

@@ -1,6 +1,8 @@
-export function testAppend(tc: t.TestCase): void;
-export function testflatten(tc: t.TestCase): void;
-export function testIsArray(tc: t.TestCase): void;
-export function testUnique(tc: t.TestCase): void;
+export function testAppend(_tc: t.TestCase): void;
+export function testBasic(_tc: t.TestCase): void;
+export function testflatten(_tc: t.TestCase): void;
+export function testEvery(_tc: t.TestCase): void;
+export function testIsArray(_tc: t.TestCase): void;
+export function testUnique(_tc: t.TestCase): void;
 import * as t from "./testing.js";
 //# sourceMappingURL=array.test.d.ts.map

package/array.test.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"array.test.d.ts","sourceRoot":"","sources":["array.test.js"],"names":[],"mappings":"AAOO,+BAFI,EAAE,QAAQ,QAMpB;AAKM,gCAFI,EAAE,QAAQ,QAKpB;AAKM,gCAFI,EAAE,QAAQ,QASpB;AAKM,+BAFI,EAAE,QAAQ,QAOpB"}
+{"version":3,"file":"array.test.d.ts","sourceRoot":"","sources":["array.test.js"],"names":[],"mappings":"AAMO,gCAFI,EAAE,QAAQ,QAMpB;AAKM,+BAFI,EAAE,QAAQ,QAMpB;AAKM,iCAFI,EAAE,QAAQ,QAKpB;AAKM,+BAFI,EAAE,QAAQ,QAQpB;AAKM,iCAFI,EAAE,QAAQ,QASpB;AAKM,gCAFI,EAAE,QAAQ,QAOpB"}

package/bin/gendocs.js

@@ -1,4 +1,3 @@
-
 import jsdoc from 'jsdoc-api'
 import fs from 'fs'
 

package/bin/gentesthtml.js

@@ -0,0 +1,54 @@
+
+import fs from 'fs'
+import * as object from '../object.js'
+
+/**
+ * @type {Object<string,string>}
+ */
+const exports = {}
+
+/**
+ * @param {any} v
+ * @param {string} k
+ * @param {string} pkgName
+ * @param {string} pathPrefix
+ */
+const extractModMap = (v, k, pkgName, pathPrefix) => {
+  if (k[0] !== '.') return
+  if (typeof v === 'object') {
+    extractModMap(v.browser || v.module || v.import, k, pkgName, pathPrefix)
+  } else if (v && v[0] === '.') {
+    exports[pkgName + k.slice(1)] = pathPrefix + v.slice(1)
+  }
+}
+const rootPkgJson = JSON.parse(fs.readFileSync('./package.json'))
+/**
+ * @param {object} pkgJson
+ * @param {string} pathPrefix
+ */
+const extractPkgJsonInfo = (pkgJson, pathPrefix) => object.forEach(pkgJson.exports, (v, k) => extractModMap(v, k, pkgJson.name, pathPrefix))
+extractPkgJsonInfo(rootPkgJson, '.')
+object.forEach(rootPkgJson.dependencies, (_v, depName) => {
+  const prefix = `./node_modules/${depName}`
+  const depPkgJson = JSON.parse(fs.readFileSync(prefix + '/package.json'))
+  extractPkgJsonInfo(depPkgJson, prefix)
+})
+
+const testHtml = `
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Testing lib0</title>
+  <script type="importmap">
+    {
+      "imports": ${JSON.stringify(exports, null, 2)}
+    }
+  </script>
+</head>
+<body>
+  <script type="module" src="./test.js"></script>
+</body>
+</html>
+`
+
+console.log(testHtml)

package/broadcastchannel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"broadcastchannel.d.ts","sourceRoot":"","sources":["broadcastchannel.js"],"names":[],"mappings":"AAsFO,gCAHI,MAAM,YACG,GAAG,QAAE,GAAG,KAAE,GAAG,UAAb,GAAG,QAAE,GAAG,KAAE,GAAG,CAKhC;AASM,kCAHI,MAAM,YACG,GAAG,QAAE,GAAG,KAAE,GAAG,WAWhC;AAUM,8BAJI,MAAM,QACN,GAAG,WACH,GAAG,QAMb;;UA/Fa,WAAa,GAAG,QAAE,GAAG,KAAE,GAAG,CAAC;QAC3B,GAAG"}
+{"version":3,"file":"broadcastchannel.d.ts","sourceRoot":"","sources":["broadcastchannel.js"],"names":[],"mappings":"AAuFO,gCAHI,MAAM,YACG,GAAG,QAAE,GAAG,KAAE,GAAG,UAAb,GAAG,QAAE,GAAG,KAAE,GAAG,CAKhC;AASM,kCAHI,MAAM,YACG,GAAG,QAAE,GAAG,KAAE,GAAG,WAUhC;AAUM,8BAJI,MAAM,QACN,GAAG,WACH,GAAG,QAMb;;UA/Fa,WAAa,GAAG,QAAE,GAAG,KAAE,GAAG,CAAC;QAC3B,GAAG"}

package/broadcastchannel.js

@@ -33,7 +33,7 @@ import * as storage from './storage.js'
  */
 const channels = new Map()
 
-/* istanbul ignore next */
+/* c8 ignore start */
 class LocalStoragePolyfill {
   /**
    * @param {string} room
@@ -54,9 +54,10 @@ class LocalStoragePolyfill {
     storage.varStorage.setItem(this.room, buffer.toBase64(buffer.createUint8ArrayFromArrayBuffer(buf)))
   }
 }
+/* c8 ignore stop */
 
-/* istanbul ignore next */
 // Use BroadcastChannel or Polyfill
+/* c8 ignore next */
 const BC = typeof BroadcastChannel === 'undefined' ? LocalStoragePolyfill : BroadcastChannel
 
 /**
@@ -67,10 +68,10 @@ const getChannel = room =>
   map.setIfUndefined(channels, room, () => {
     const subs = set.create()
     const bc = new BC(room)
-    /* istanbul ignore next */
     /**
      * @param {{data:ArrayBuffer}} e
      */
+    /* c8 ignore next */
     bc.onmessage = e => subs.forEach(sub => sub(e.data, 'broadcastchannel'))
     return {
       bc, subs
@@ -99,7 +100,6 @@ export const subscribe = (room, f) => {
 export const unsubscribe = (room, f) => {
   const channel = getChannel(room)
   const unsubscribed = channel.subs.delete(f)
-  /* istanbul ignore else */
   if (unsubscribed && channel.subs.size === 0) {
     channel.bc.close()
     channels.delete(room)

package/buffer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buffer.d.ts","sourceRoot":"","sources":["buffer.js"],"names":[],"mappings":"AAcO,6CAFI,MAAM,cAEgD;AAS1D,4DAJI,WAAW,cACX,MAAM,UACN,MAAM,cAE4G;AAOtH,wDAFI,WAAW,cAEyD;AAG/E;;;GAGG;AACH,gCAHW,UAAU,GACT,MAAM,CASjB;AASD;;;GAGG;AACH,8BAHW,MAAM,GACL,UAAU,CAUrB;AAsBM,2CAHI,UAAU,GACT,UAAU,CAMrB;AASM,gCAHI,GAAG,GACF,UAAU,CAMrB;AAQM,+BAHI,UAAU,GACT,GAAG,CAE8D"}
+{"version":3,"file":"buffer.d.ts","sourceRoot":"","sources":["buffer.js"],"names":[],"mappings":"AAcO,6CAFI,MAAM,cAEgD;AAS1D,4DAJI,WAAW,cACX,MAAM,UACN,MAAM,cAE4G;AAOtH,wDAFI,WAAW,cAEyD;AAG/E;;;GAGG;AACH,gCAHW,UAAU,GACT,MAAM,CASjB;AAUD;;;GAGG;AACH,8BAHW,MAAM,GACL,UAAU,CAUrB;AAuBM,2CAHI,UAAU,GACT,UAAU,CAMrB;AASM,gCAHI,GAAG,GACF,UAAU,CAMrB;AAQM,+BAHI,UAAU,GACT,GAAG,CAE8D"}

package/buffer.js

@@ -30,7 +30,7 @@ export const createUint8ArrayViewFromArrayBuffer = (buffer, byteOffset, length)
  */
 export const createUint8ArrayFromArrayBuffer = buffer => new Uint8Array(buffer)
 
-/* istanbul ignore next */
+/* c8 ignore start */
 /**
  * @param {Uint8Array} bytes
  * @return {string}
@@ -43,6 +43,7 @@ const toBase64Browser = bytes => {
   // eslint-disable-next-line no-undef
   return btoa(s)
 }
+/* c8 ignore stop */
 
 /**
  * @param {Uint8Array} bytes
@@ -50,7 +51,7 @@ const toBase64Browser = bytes => {
  */
 const toBase64Node = bytes => Buffer.from(bytes.buffer, bytes.byteOffset, bytes.byteLength).toString('base64')
 
-/* istanbul ignore next */
+/* c8 ignore start */
 /**
  * @param {string} s
  * @return {Uint8Array}
@@ -64,6 +65,7 @@ const fromBase64Browser = s => {
   }
   return bytes
 }
+/* c8 ignore stop */
 
 /**
  * @param {string} s
@@ -73,10 +75,10 @@ const fromBase64Node = s => {
   return new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength)
 }
 
-/* istanbul ignore next */
+/* c8 ignore next */
 export const toBase64 = env.isBrowser ? toBase64Browser : toBase64Node
 
-/* istanbul ignore next */
+/* c8 ignore next */
 export const fromBase64 = env.isBrowser ? fromBase64Browser : fromBase64Node
 
 /**

package/conditions.js

@@ -9,5 +9,5 @@
  * @param {T|null|undefined} v
  * @return {T|null}
  */
-/* istanbul ignore next */
+/* c8 ignore next */
 export const undefinedToNull = v => v === undefined ? null : v