mjs nodejs support

lib/decoding.mjs

@@ -4,7 +4,7 @@
 
 /* global Buffer */
 
-import * as globals from './globals.js'
+import * as globals from './globals.mjs'
 
 /**
  * A Decoder handles the decoding of an ArrayBuffer.

lib/encoding.mjs

@@ -1,7 +1,7 @@
 /**
  * @module encoding
  */
-import * as globals from './globals.js'
+import * as globals from './globals.mjs'
 
 const bits7 = 0b1111111
 const bits8 = 0b11111111

lib/encoding.test.mjs

@@ -1,4 +1,4 @@
-import * as encoding from './encoding.js'
+import * as encoding from './encoding.mjs'
 
 /**
  * Check if binary encoding is compatible with golang binary encoding - binary.PutVarUint.

lib/idb.mjs

@@ -4,7 +4,7 @@
 
 /* eslint-env browser */
 
-import * as globals from './globals.js'
+import * as globals from './globals.mjs'
 
 /*
  * IDB Request to Promise transformer
@@ -16,6 +16,8 @@ export const rtop = request => globals.createPromise((resolve, reject) => {
 })
 
 /**
+ * @param {string} name
+ * @param {Function} initDB Called when the database is first created
  * @return {Promise<IDBDatabase>}
  */
 export const openDB = (name, initDB) => globals.createPromise((resolve, reject) => {

lib/idb.test.mjs

@@ -1,6 +1,6 @@
-import * as test from './testing.js'
-import * as idb from './idb.js'
-import * as logging from './logging.js'
+import * as test from './testing.mjs'
+import * as idb from './idb.mjs'
+import * as logging from './logging.mjs'
 
 const initTestDB = db => idb.createStores(db, [['test']])
 const testDBName = 'idb-test'

lib/logging.mjs

@@ -2,7 +2,7 @@
  * @module logging
  */
 
-import * as globals from './globals.js'
+import * as globals from './globals.mjs'
 
 let date = new Date().getTime()
 

lib/prng/PRNG/PRNG.tests.mjs

@@ -2,10 +2,10 @@
  * @module prng
  */
 
-import { Mt19937 } from './Mt19937.js'
-import { Xoroshiro128plus } from './Xoroshiro128plus.js'
-import { Xorshift32 } from './Xorshift32.js'
-import * as time from '../../time.js'
+import { Mt19937 } from './Mt19937.mjs'
+import { Xoroshiro128plus } from './Xoroshiro128plus.mjs'
+import { Xorshift32 } from './Xorshift32.mjs'
+import * as time from '../../time.mjs'
 
 const DIAMETER = 300
 const NUMBERS = 10000

lib/prng/PRNG/Xoroshiro128plus.mjs

@@ -2,7 +2,7 @@
  * @module prng
  */
 
-import { Xorshift32 } from './Xorshift32.js'
+import { Xorshift32 } from './Xorshift32.mjs'
 
 /**
  * This is a variant of xoroshiro128plus - the fastest full-period generator passing BigCrush without systematic failures.

lib/prng/prng.js

@@ -2,12 +2,12 @@
  * @module prng
  */
 
-import * as binary from '../binary.js'
-import { fromCharCode, fromCodePoint } from '../string.js'
-import { MAX_SAFE_INTEGER, MIN_SAFE_INTEGER } from '../number.js'
-import * as math from '../math.js'
+import * as binary from '../binary.mjs'
+import { fromCharCode, fromCodePoint } from '../string.mjs'
+import { MAX_SAFE_INTEGER, MIN_SAFE_INTEGER } from '../number.mjs'
+import * as math from '../math.mjs'
 
-import { Xoroshiro128plus as DefaultPRNG } from './PRNG/Xoroshiro128plus.js'
+import { Xoroshiro128plus as DefaultPRNG } from './PRNG/Xoroshiro128plus.mjs'
 
 /**
  * Description of the function

lib/prng/prng.mjs

@@ -0,0 +1,134 @@
+/**
+ * @module prng
+ */
+
+import * as binary from '../binary.mjs'
+import { fromCharCode, fromCodePoint } from '../string.mjs'
+import { MAX_SAFE_INTEGER, MIN_SAFE_INTEGER } from '../number.mjs'
+import * as math from '../math.mjs'
+
+import { Xoroshiro128plus as DefaultPRNG } from './PRNG/Xoroshiro128plus.mjs'
+
+/**
+ * Description of the function
+ *  @callback generatorNext
+ *  @return {number} A 32bit integer
+ */
+
+/**
+ * A random type generator.
+ *
+ * @typedef {Object} PRNG
+ * @property {generatorNext} next Generate new number
+ */
+
+/**
+ * Create a Xoroshiro128plus Pseudo-Random-Number-Generator.
+ * This is the fastest full-period generator passing BigCrush without systematic failures.
+ * But there are more PRNGs available in ./PRNG/.
+ *
+ * @param {number} seed A positive 32bit integer. Do not use negative numbers.
+ * @return {PRNG}
+ */
+export const createPRNG = seed => new DefaultPRNG(Math.floor(seed < 1 ? seed * binary.BITS32 : seed))
+
+/**
+ * Generates a single random bool.
+ *
+ * @param {PRNG} gen A random number generator.
+ * @return {Boolean} A random boolean
+ */
+export const bool = gen => (gen.next() & 2) === 2 // brackets are non-optional!
+
+/**
+ * Generates a random integer with 53 bit resolution.
+ *
+ * @param {PRNG} gen A random number generator.
+ * @param {Number} [min = MIN_SAFE_INTEGER] The lower bound of the allowed return values (inclusive).
+ * @param {Number} [max = MAX_SAFE_INTEGER] The upper bound of the allowed return values (inclusive).
+ * @return {Number} A random integer on [min, max]
+ */
+export const int53 = (gen, min = MIN_SAFE_INTEGER, max = MAX_SAFE_INTEGER) => math.floor(real53(gen) * (max + 1 - min) + min)
+
+/**
+ * Generates a random integer with 32 bit resolution.
+ *
+ * @param {PRNG} gen A random number generator.
+ * @param {Number} [min = MIN_SAFE_INTEGER] The lower bound of the allowed return values (inclusive).
+ * @param {Number} [max = MAX_SAFE_INTEGER] The upper bound of the allowed return values (inclusive).
+ * @return {Number} A random integer on [min, max]
+ */
+export const int32 = (gen, min = MIN_SAFE_INTEGER, max = MAX_SAFE_INTEGER) => min + ((gen.next() >>> 0) % (max + 1 - min))
+
+/**
+ * Generates a random real on [0, 1) with 32 bit resolution.
+ *
+ * @param {PRNG} gen A random number generator.
+ * @return {Number} A random real number on [0, 1).
+ */
+export const real32 = gen => (gen.next() >>> 0) / binary.BITS32
+
+/**
+ * Generates a random real on [0, 1) with 53 bit resolution.
+ *
+ * @param {PRNG} gen A random number generator.
+ * @return {Number} A random real number on [0, 1).
+ */
+export const real53 = gen => (((gen.next() >>> 5) * binary.BIT26) + (gen.next() >>> 6)) / MAX_SAFE_INTEGER
+
+/**
+ * Generates a random character from char code 32 - 126. I.e. Characters, Numbers, special characters, and Space:
+ *
+ * (Space)!"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[/]^_`abcdefghijklmnopqrstuvwxyz{|}~
+ */
+export const char = gen => fromCharCode(int32(gen, 32, 126))
+
+/**
+ * @param {PRNG} gen
+ * @return {string} A single letter (a-z)
+ */
+export const letter = gen => fromCharCode(int32(gen, 97, 122))
+
+/**
+ * @param {PRNG} gen
+ * @return {string} A random word without spaces consisting of letters (a-z)
+ */
+export const word = gen => {
+  const len = int32(gen, 0, 20)
+  let str = ''
+  for (let i = 0; i < len; i++) {
+    str += letter(gen)
+  }
+  return str
+}
+
+/**
+ * TODO: this function produces invalid runes. Does not cover all of utf16!!
+ */
+export const utf16Rune = gen => {
+  const codepoint = int32(gen, 0, 256)
+  return fromCodePoint(codepoint)
+}
+
+/**
+ * @param {PRNG} gen
+ * @param {number} [maxlen = 20]
+ */
+export const utf16String = (gen, maxlen = 20) => {
+  const len = int32(gen, 0, maxlen)
+  let str = ''
+  for (let i = 0; i < len; i++) {
+    str += utf16Rune(gen)
+  }
+  return str
+}
+
+/**
+ * Returns one element of a given array.
+ *
+ * @param {PRNG} gen A random number generator.
+ * @param {Array<T>} array Non empty Array of possible values.
+ * @return {T} One of the values of the supplied Array.
+ * @template T
+ */
+export const oneOf = (gen, array) => array[int32(gen, 0, array.length - 1)]

lib/prng/prng.test.mjs

@@ -4,14 +4,14 @@
 
 /**
  *TODO: enable tests
-import * as rt from '../rich-text/formatters.mjs'
-import { test } from '../test/test.mjs'
-import Xoroshiro128plus from './PRNG/Xoroshiro128plus.mjs'
-import Xorshift32 from './PRNG/Xorshift32.mjs'
-import MT19937 from './PRNG/Mt19937.mjs'
-import { generateBool, generateInt, generateInt32, generateReal, generateChar } from './random.mjs'
-import { MAX_SAFE_INTEGER } from '../number/constants.mjs'
-import { BIT32 } from '../binary/constants.mjs'
+import * as rt from '../rich-text/formatters.mjs''
+import { test } from '../test/test.mjs''
+import Xoroshiro128plus from './PRNG/Xoroshiro128plus.mjs''
+import Xorshift32 from './PRNG/Xorshift32.mjs''
+import MT19937 from './PRNG/Mt19937.mjs''
+import { generateBool, generateInt, generateInt32, generateReal, generateChar } from './random.mjs''
+import { MAX_SAFE_INTEGER } from '../number/constants.mjs''
+import { BIT32 } from '../binary/constants.mjs''
 
 function init (Gen) {
   return {

lib/testing.mjs

@@ -2,8 +2,8 @@
  * @module testing
  */
 
-import * as logging from './logging.js'
-import { simpleDiff } from './diff.js'
+import * as logging from './logging.mjs'
+import { simpleDiff } from './diff.mjs'
 
 export const run = async (name, f) => {
   console.log(`%cStart:%c   ${name}`, 'color:blue;', '')