@vbarbarosh/node-helpers 3.74.1 → 3.76.0

package/src/str_camel_to_snake.md

@@ -0,0 +1,11 @@
+Converts camelCase/PascalCase to snake_case and lowercases the result.
+Acronyms are kept together as one word (`SomeUPCCode` → `some_upc_code`),
+though an acronym at the end of the string has nothing to split it from the
+previous word (`thisISNT` → `this_isnt`).
+
+```js
+str_camel_to_snake('CamelCase')         // 'camel_case'
+str_camel_to_snake('SomeUPCCode')       // 'some_upc_code'
+str_camel_to_snake('thisISDifficult')   // 'this_is_difficult'
+str_camel_to_snake('UPC')               // 'upc'
+```

package/src/str_parse_kv.md

@@ -0,0 +1,11 @@
+Splits a `key: value` string on the first colon and returns a trimmed
+`[key, value]` pair. Only the first colon splits — the rest stays in the
+value — so URLs survive. Without a colon, the whole string is the key and
+the value is `''`.
+
+```js
+str_parse_kv('key: value')                  // ['key', 'value']
+str_parse_kv('url: http://example.com')     // ['url', 'http://example.com']
+str_parse_kv('key')                         // ['key', '']
+str_parse_kv(':value')                      // ['', 'value']
+```

package/src/stream_curl_progress.md

@@ -0,0 +1,14 @@
+Transform that parses curl's stderr progress meter (the `--progress-meter`
+table) into objects. The two header lines are skipped; every following line
+becomes `{perc, done, total, speed, eta, duration, time_total, ...}` with the
+raw columns (`recv`, `transferred`, `speed_down`, `speed_up`, ...) included.
+`done` is the received column, falling back to the transferred column while
+received is `'0'` (uploads). `--:--:--` times are reported as `'~'`.
+
+Lines starting with `curl:` (error messages) are written to
+`process.stderr` and dropped from the output.
+
+```js
+stream.compose(proc.stderr, stream_curl_progress())
+// {perc: '18', done: '587M', total: '3217M', speed: '19.0M', eta: '0:02:22', ...}
+```

package/src/stream_data_ln.js

@@ -1,3 +1,5 @@
+const {StringDecoder} = require('string_decoder');
+
 /**
  * Split stream on each \n and call `fn` for each line.
  *
@@ -7,6 +9,9 @@
  */
 function stream_data_ln(stream, fn)
 {
+    // StringDecoder buffers a multi-byte character split across chunk
+    // boundaries; plain buffer.toString('utf8') would corrupt it into �.
+    const decoder = new StringDecoder('utf8');
     let utf8 = '';
     stream.on('data', data);
     stream.on('end', end);
@@ -18,12 +23,13 @@ function stream_data_ln(stream, fn)
     }
     function end() {
         off();
+        utf8 += decoder.end();
         if (utf8) {
             fn(utf8, true);
         }
     }
     function data(buffer) {
-        utf8 += buffer.toString('utf8');
+        utf8 += (typeof buffer === 'string') ? buffer : decoder.write(buffer);
         for (let iteration = 1; true; ++iteration) {
             if (iteration == 1000000) {
                 throw new Error('Too many iterations');

package/src/stream_discard.md

@@ -0,0 +1,8 @@
+A writable sink that accepts and discards every chunk — useful to drain a
+pipeline whose output is irrelevant. Byte mode by default; pass
+`{objectMode: true}` for object streams. Consumes empty streams fine.
+
+```js
+await stream.promises.pipeline(source, stream_discard());
+await stream.promises.pipeline(objects, stream_discard({objectMode: true}));
+```

package/src/stream_group.md

@@ -0,0 +1,3 @@
+Deprecated alias of `stream_chunk` — splits an object stream into arrays of
+up to `chunk_size` items. Calls `stream_chunk(chunk_size)` directly; use
+`stream_chunk` in new code.

package/src/stream_gunzip.md

@@ -0,0 +1,7 @@
+Thin wrapper around `zlib.createGunzip(options)`: a transform that
+decompresses a gzipped byte stream. Corrupt input errors the stream
+(`incorrect header check`).
+
+```js
+await stream.promises.pipeline(gzipped_source, stream_gunzip(), destination);
+```

package/src/stream_hash.md

@@ -0,0 +1,10 @@
+Transform that consumes all input chunks and emits a single output chunk at
+flush: the hex digest of the whole stream. `algorithm` defaults to `'md5'`;
+any `crypto.createHash` algorithm name works, and `options` is passed
+through to it. An empty stream still emits the digest of empty input.
+
+```js
+const chunks = await stream.Readable.from(['aaa', 'bbb']).pipe(stream_hash('sha256')).toArray();
+Buffer.concat(chunks).toString('utf8');
+// '2ce109e9d0faf820b2434e166297934e6177b65ab9951dbc3e204cad4689b39c'
+```

package/src/stream_map.js

@@ -2,6 +2,10 @@ const stream = require('stream');
 
 /**
  * Transform each item using a simple function.
+ *
+ * Returning null or undefined from `fn` drops the item: streams cannot
+ * carry null (it is an eof mark), so pushing it would end the stream and
+ * silently discard everything after it.
  */
 function stream_map(fn)
 {
@@ -9,7 +13,10 @@ function stream_map(fn)
         objectMode: true,
         transform: async function (item, encoding, callback) {
             try {
-                this.push(await fn(item));
+                const out = await fn(item);
+                if (out !== null && out !== undefined) {
+                    this.push(out);
+                }
                 callback();
             }
             catch (error) {

package/src/stream_map_parallel.js

@@ -3,6 +3,10 @@ const stream = require('stream');
 
 /**
  * Transform each item using a simple function in parallel.
+ *
+ * Returning null or undefined from `handler` drops the item: streams cannot
+ * carry null (it is an eof mark), so pushing it would end the stream and
+ * silently discard everything after it.
  */
 function stream_map_parallel({handler, concurrency})
 {
@@ -46,7 +50,11 @@ function stream_map_parallel({handler, concurrency})
     function ready() {
         running--;
         while (buf.length && buf[0].isFulfilled()) {
-            out.push(buf.shift().value());
+            const value = buf.shift().value();
+            // null is an eof mark, pushing it would end the stream
+            if (value !== null && value !== undefined) {
+                out.push(value);
+            }
         }
         if (callback_next && buf.length < buf_limit) {
             const tmp = callback_next;

package/src/stream_md5.md

@@ -0,0 +1,9 @@
+Transform that consumes all input chunks and emits a single output chunk at
+flush: the md5 hex digest of the whole stream. An empty stream still emits
+`'d41d8cd98f00b204e9800998ecf8427e'`. Equivalent to `stream_hash('md5')`;
+the source carries a TODO to rename this to `stream_hash_md5`.
+
+```js
+const chunks = await stream.Readable.from(['aaa', 'bbb']).pipe(stream_md5()).toArray();
+Buffer.concat(chunks).toString('utf8');    // '6547436690a26a399603a7096e876a2d'
+```

package/src/stream_multiplex.js

@@ -3,6 +3,17 @@ const stream = require('stream');
 
 function stream_multiplex(...streams)
 {
+    if (streams.length === 0) {
+        // Multiplex of nothing is a sink which accepts and discards all writes
+        // (the generic write/final below would never invoke their callbacks).
+        return stream.Writable({
+            objectMode: true,
+            write: function (chunk, encoding, callback) {
+                callback();
+            },
+        });
+    }
+
     if (streams.length === 1) {
         return streams[0];
     }

package/src/stream_multiplex.md

@@ -0,0 +1,16 @@
+Combines several writable streams into one object-mode writable that
+duplicates every chunk to all of them. Backpressure is respected: a write
+completes only after every target accepted the chunk.
+
+- Zero streams → a sink that accepts and discards all writes.
+- One stream → returned as is (no wrapper).
+- Ending the multiplex ends all targets; destroying it destroys all targets.
+- An error in any target destroys the multiplex (and, through it, the other
+  targets) with that error — the first error wins.
+
+```js
+await stream.promises.pipeline(
+    source,
+    stream_multiplex(ws1, ws2),
+);
+```

package/src/stream_through.md

@@ -0,0 +1,3 @@
+Deprecated alias of `stream_tap` — calls `fn` on each item and passes the
+item through unchanged. Calls `stream_tap(fn)` directly; use `stream_tap`
+in new code.

package/src/stream_transform.md

@@ -0,0 +1,2 @@
+Deprecated alias of `stream_map` — maps each item through `fn`. Calls
+`stream_map(fn)` directly; use `stream_map` in new code.

package/src/stream_xml_analyze.js

@@ -1,5 +1,6 @@
 const htmlparser2 = require('htmlparser2');
 const stream = require('stream');
+const {StringDecoder} = require('string_decoder');
 
 /**
  * Consume XML, produce an object with analytics about provided xml stream.
@@ -30,13 +31,20 @@ function stream_xml_analyze()
     };
 
     const parser = new htmlparser2.Parser(events, options);
+    // StringDecoder buffers a multi-byte character split across chunk
+    // boundaries; plain buf.toString() would corrupt it into �.
+    const decoder = new StringDecoder('utf8');
     return out = new stream.Transform({
         objectMode: true,
         transform: function (buf, encoding, callback) {
-            parser.write(buf.toString());
+            parser.write(typeof buf === 'string' ? buf : decoder.write(buf));
             callback();
         },
         flush: function (callback) {
+            const tail = decoder.end();
+            if (tail) {
+                parser.write(tail);
+            }
             parser.end();
             callback();
         },

package/src/stream_xml_parse.js

@@ -2,6 +2,7 @@ const assert = require('assert');
 const const_stream = require('./const_stream');
 const htmlparser2 = require('htmlparser2');
 const stream = require('stream');
+const {StringDecoder} = require('string_decoder');
 
 /**
  * Consume XML, produce objects.
@@ -48,13 +49,20 @@ function stream_xml_parse(selector, mapper = stream_xml_parse.guess)
     };
 
     const parser = new htmlparser2.Parser(events, options);
+    // StringDecoder buffers a multi-byte character split across chunk
+    // boundaries; plain buf.toString() would corrupt it into �.
+    const decoder = new StringDecoder('utf8');
     return out = new stream.Transform({
         objectMode: true,
         transform: function (buf, encoding, callback) {
-            parser.write(buf.toString());
+            parser.write(typeof buf === 'string' ? buf : decoder.write(buf));
             callback();
         },
         flush: function (callback) {
+            const tail = decoder.end();
+            if (tail) {
+                parser.write(tail);
+            }
             parser.end();
             callback();
         },

package/src/stream_ytdlp_progress.js

@@ -55,7 +55,7 @@ function stream_ytdlp_progress()
                 current_part = downloading_formats.indexOf(m[1]) + 1;
                 return false;
             }
-            if (m = line.match(/^\[Merger]/i)) {
+            if (line.match(/^\[Merger]/i)) {
                 last.merging = true;
                 return last;
             }

package/src/stream_ytdlp_progress.md

@@ -0,0 +1,18 @@
+Transform that parses yt-dlp `--progress` output (stdout) into objects:
+`{current_part, total_parts, perc, done, total, speed, eta, merging}`. Sizes
+are re-formatted via `parse_bytes`/`format_bytes` (`15.71MiB` → `'15.71MB'`,
+`done` computed from the percentage), `Unknown` speed/ETA become `'~'`, and
+non-progress lines are dropped.
+
+- `[info] ...: Downloading N format(s): 251+248` plus the per-part
+  `[download] Destination: ....fNNN.ext` lines drive
+  `current_part`/`total_parts` for multi-format downloads (otherwise
+  `1`/`0`).
+- A `[Merger]` line re-emits the last row with `merging: true`. The last row
+  is mutated in place, so copy rows if you collect them.
+
+```js
+stream.Readable.from(lines).pipe(stream_ytdlp_progress())
+// {current_part: 1, total_parts: 0, perc: '50.90%', done: '8.0MB',
+//  total: '15.71MB', speed: '33.83MB/s', eta: '00:01', merging: false}
+```

package/src/strtr.js

@@ -2,13 +2,23 @@
 // echo strtr("hello", ["he" => "X", "hell" => "Y"]);
 function strtr(subject, map)
 {
-    let out = subject;
-    Object.entries(map).sort(fcmp).forEach(function ([search, replace]) {
-        out = out.replaceAll(search, replace);
-    });
+    // Single pass, like PHP: replaced text is never scanned again
+    const keys = Object.keys(map).filter(v => v.length).sort(fcmp);
+    let out = '';
+    for (let i = 0; i < subject.length; ) {
+        const key = keys.find(v => subject.startsWith(v, i));
+        if (key) {
+            out += map[key];
+            i += key.length;
+        }
+        else {
+            out += subject[i];
+            i++;
+        }
+    }
     return out;
     function fcmp(b, a) {
-        return a[0].length - b[0].length;
+        return a.length - b.length;
     }
 }
 

package/src/strtr.md

@@ -0,0 +1,11 @@
+Replaces substrings in `subject` using a `{from: to}` map, like PHP's
+`strtr`. Single pass: replaced text is never scanned again, so maps like
+`{a: 'b', b: 'c'}` cannot cascade. When keys overlap, the longest matching
+key wins regardless of map order. Empty keys are ignored.
+
+```js
+strtr('hello world', {world: 'there'})  // 'hello there'
+strtr('hello', {he: 'X', hell: 'Y'})    // 'Yo' (longest key wins)
+strtr('ab', {a: 'b', b: 'c'})           // 'bc' (single pass, no cascade)
+strtr('hello', {l: ''})                 // 'heo'
+```

package/src/urlclean.js

@@ -6,6 +6,13 @@ const querystring = require('querystring');
  */
 function urlclean(url)
 {
+    // The #fragment is not part of the query string: without splitting it
+    // off first it would be percent-encoded into the last query value.
+    const h = url.indexOf('#');
+    const hash = (h === -1) ? '' : url.slice(h);
+    if (hash) {
+        url = url.slice(0, h);
+    }
     const i = url.indexOf('?') + 1;
     if (i) {
         const s = querystring.stringify(querystring.parse(url.slice(i)), '&', '=', {
@@ -13,9 +20,9 @@ function urlclean(url)
                 return encodeURIComponent(v).replaceAll('%3A', ':').replaceAll('%2F', '/');
             },
         });
-        return url.slice(0, i) + s;
+        return url.slice(0, i) + s + hash;
     }
-    return url;
+    return url + hash;
 }
 
 module.exports = urlclean;

package/src/urlmod.js

@@ -26,6 +26,11 @@ function urlmod(url, params)
             break;
         }
     });
+    if (url && url[0] === '/' && url[1] === '/') {
+        // Protocol-relative url: the fake base host was replaced by the
+        // real one, only the fake scheme is left to strip.
+        return tmp_url.toString().replace(/^xxx:/, '');
+    }
     if (url && url[0] === '/') {
         return tmp_url.toString().replace(/^xxx:\/\/___base___/, '');
     }

package/src/urlparts.md

@@ -0,0 +1,17 @@
+Splits a URL into a fixed-shape plain object. Accepts a `URL` instance or a
+string; strings are parsed against the base `fake://fake/`, so relative paths
+work (and non-string input degrades to the bare base instead of throwing).
+The keys mirror the `URL` properties, except `pathname` is exposed as `path`.
+
+```js
+urlparts('https://john:secret@example.com:8080/users/15?page=2#top')
+// {
+//     href: 'https://john:secret@example.com:8080/users/15?page=2#top',
+//     protocol: 'https:', hostname: 'example.com',
+//     username: 'john', password: 'secret',
+//     host: 'example.com:8080', port: '8080',
+//     path: '/users/15', search: '?page=2', hash: '#top',
+// }
+urlparts('/users?page=5').path      // '/users'
+urlparts('/users?page=5').protocol  // 'fake:'
+```

package/src/wait_while.js

@@ -1,7 +1,7 @@
 const Promise = require('bluebird');
 
 /**
- * Wait until `fn` returns `true`.
+ * Wait while `fn` returns a truthy value; resolve as soon as it turns falsy.
  *
  * W A R N I N G
  * This method was designed mainly for prototyping (where code cleanliness is important).

package/src/wait_while.md

@@ -1,4 +1,4 @@
-Wait until `fn` returns `true`.
+Wait while `fn` returns a truthy value; resolve as soon as it turns falsy.
 
 W A R N I N G
 This method was designed mainly for prototyping (where code cleanliness is important).

package/src/HeartbeatServer.test.js

@@ -1,31 +0,0 @@
-const HeartbeatServer = require('./HeartbeatServer');
-const assert = require('assert');
-const fs_assert_file_socket = require('./fs_assert_file_socket');
-const ping_socket = require('./ping_socket');
-
-// 💎 Only the lack of a valid PING within WATCHDOG_INTERVAL is fatal
-
-// 📕 Notes by ChatGPT
-// If listen() fails (EADDRINUSE, perms, etc.), constructor will throw,
-// and heartbeat_server will be undefined in finally { await heartbeat_server.dispose() }.
-
-describe('HeartbeatServer', function () {
-    it('Happy Path', async function () {
-        const server = new HeartbeatServer();
-        try {
-            let counter = 0;
-            server.on('heartbeat', () => counter++);
-            await fs_assert_file_socket(server.socket_path);
-            await ping_socket(server.socket_path);
-            await ping_socket(server.socket_path);
-            assert.strictEqual(counter, 2);
-        }
-        finally {
-            await server.dispose();
-        }
-    });
-
-    // should emit a "warning" event on any client errors
-    // should not send any heartbeat signals after rejection (decision to kill a child process)
-    // should reject when no heartbeat received in an expected interval
-});

package/src/array_chunk.test.js

@@ -1,24 +0,0 @@
-const array_chunk = require('./array_chunk');
-const assert = require('assert');
-
-describe('array_chunk', function () {
-    it('should accept no arguments', function () {
-        assert.deepStrictEqual(array_chunk(), []);
-    });
-    it('should handle basic input', function () {
-        assert.deepStrictEqual(array_chunk([]), []);
-        assert.deepStrictEqual(array_chunk([1,2,3,4,5]), [[1],[2],[3],[4],[5]]);
-        assert.deepStrictEqual(array_chunk([1,2,3,4,5], 1), [[1],[2],[3],[4],[5]]);
-        assert.deepStrictEqual(array_chunk([1,2,3,4,5], 2), [[1,2],[3,4],[5]]);
-        assert.deepStrictEqual(array_chunk([1,2,3,4,5], 3), [[1,2,3],[4,5]]);
-        assert.deepStrictEqual(array_chunk([1,2,3,4,5], 4), [[1,2,3,4],[5]]);
-        assert.deepStrictEqual(array_chunk([1,2,3,4,5], 5), [[1,2,3,4,5]]);
-        assert.deepStrictEqual(array_chunk([1,2,3,4,5], 6), [[1,2,3,4,5]]);
-    });
-    it('should throw when limit is less than 1', function () {
-        assert.throws(() => array_chunk([], 0));
-        assert.throws(() => array_chunk([], -1));
-        assert.throws(() => array_chunk([1], 0));
-        assert.throws(() => array_chunk([1], -1));
-    });
-});

package/src/array_chunk_balanced.test.js

@@ -1,37 +0,0 @@
-const array_chunk_balanced = require('./array_chunk_balanced');
-const assert = require('assert');
-
-describe('array_chunk_balanced', function () {
-    it('should handle basic input', function () {
-        assert.deepStrictEqual(array_chunk_balanced([1]), [[1]]);
-        assert.deepStrictEqual(array_chunk_balanced([1,2]), [[1,2]]);
-        assert.deepStrictEqual(array_chunk_balanced([1,2,3]), [[1,2,3]]);
-        assert.deepStrictEqual(array_chunk_balanced([1,2,3,4,5], 3, 2), [[1,2,3],[4,5]]);
-        assert.deepStrictEqual(array_chunk_balanced([1,2,3,4,5,6], 3, 2), [[1,2],[3,4],[5,6]]);
-        assert.deepStrictEqual(array_chunk_balanced([1,2,3,4,5,6,7], 3, 2), [[1,2,3],[4,5],[6,7]]);
-        assert.deepStrictEqual(array_chunk_balanced([1,2,3,4,5], 3, 3), [[1,2,3,4,5]]);
-        assert.deepStrictEqual(array_chunk_balanced([1,2,3,4,5,6], 3, 3), [[1,2,3],[4,5,6]]);
-        assert.deepStrictEqual(array_chunk_balanced([1,2,3,4,5,6,7], 3, 3), [[1,2,3,4],[5,6,7]]);
-        assert.deepStrictEqual(array_chunk_balanced([1,2,3,4,5,6,7,8], 3, 3), [[1,2,3,4],[5,6,7,8]]);
-    });
-    it('edge: If an array is empty → returns []', function () {
-        assert.deepStrictEqual(array_chunk_balanced([]), []);
-    });
-    it('edge: If there are too few items to satisfy `min_items_per_chunk`, even for 1 chunk, everything goes into a single chunk', function () {
-        assert.deepStrictEqual(array_chunk_balanced([1,2,3], 5, 5), [[1,2,3]]);
-    });
-    it('should never produce more chunks than max_threads', function () {
-        // 12 jobs, max 5 threads, min 2 jobs per thread
-        // Correct result MUST have exactly 5 chunks
-        assert.deepStrictEqual(
-            array_chunk_balanced([1,2,3,4,5,6,7,8,9,10,11,12], 5, 2),
-            [
-                [1,2,3],
-                [4,5,6],
-                [7,8],
-                [9,10],
-                [11,12]
-            ]
-        );
-    });
-});

package/src/array_fps.test.js

@@ -1,72 +0,0 @@
-const array_fps = require('./array_fps');
-const assert = require('assert');
-
-describe('array_fps', function () {
-    it('should handle basic input', function () {
-        assert.deepStrictEqual(array_fps(1, 1), [0]);
-        assert.deepStrictEqual(array_fps(1, 2), [0, 0.99999]);
-        assert.deepStrictEqual(array_fps(1, 3), [0, 0.49999, 0.99999]);
-        assert.deepStrictEqual(array_fps(1, 4), [0, 0.33333, 0.66666, 0.99999]);
-        assert.deepStrictEqual(array_fps(5, 20), [
-            0,       0.0505,  0.10101, 0.15151, 0.20202, 0.25252, 0.30303, 0.35353, 0.40404, 0.45454,
-            0.50505, 0.55555, 0.60606, 0.65656, 0.70707, 0.75757, 0.80808, 0.85858, 0.90909, 0.95959,
-            1.0101,  1.0606,  1.11111, 1.16161, 1.21212, 1.26262, 1.31313, 1.36363, 1.41414, 1.46464,
-            1.51515, 1.56565, 1.61616, 1.66666, 1.71717, 1.76767, 1.81818, 1.86868, 1.91919, 1.96969,
-            2.0202,  2.0707,  2.12121, 2.17171, 2.22222, 2.27272, 2.32323, 2.37373, 2.42424, 2.47474,
-            2.52525, 2.57575, 2.62626, 2.67676, 2.72727, 2.77777, 2.82828, 2.87878, 2.92929, 2.97979,
-            3.0303,  3.0808,  3.13131, 3.18181, 3.23232, 3.28282, 3.33333, 3.38383, 3.43434, 3.48484,
-            3.53535, 3.58585, 3.63636, 3.68686, 3.73737, 3.78787, 3.83838, 3.88888, 3.93939, 3.98989,
-            4.0404,  4.0909,  4.14141, 4.19191, 4.24242, 4.29292, 4.34343, 4.39393, 4.44444, 4.49494,
-            4.54545, 4.59595, 4.64646, 4.69696, 4.74747, 4.79797, 4.84848, 4.89898, 4.94949, 4.99999,
-        ]);
-        assert.deepStrictEqual(array_fps(5, 30), [
-            0,       0.03356, 0.06711, 0.10067, 0.13423, 0.16778, 0.20134, 0.2349,  0.26846, 0.30201,
-            0.33557, 0.36913, 0.40268, 0.43624, 0.4698,  0.50335, 0.53691, 0.57047, 0.60403, 0.63758,
-            0.67114, 0.7047,  0.73825, 0.77181, 0.80537, 0.83892, 0.87248, 0.90604, 0.9396,  0.97315,
-            1.00671, 1.04027, 1.07382, 1.10738, 1.14094, 1.17449, 1.20805, 1.24161, 1.27517, 1.30872,
-            1.34228, 1.37584, 1.40939, 1.44295, 1.47651, 1.51006, 1.54362, 1.57718, 1.61074, 1.64429,
-            1.67785, 1.71141, 1.74496, 1.77852, 1.81208, 1.84563, 1.87919, 1.91275, 1.9463,  1.97986,
-            2.01342, 2.04698, 2.08053, 2.11409, 2.14765, 2.1812,  2.21476, 2.24832, 2.28187, 2.31543,
-            2.34899, 2.38255, 2.4161,  2.44966, 2.48322, 2.51677, 2.55033, 2.58389, 2.61744, 2.651,
-            2.68456, 2.71812, 2.75167, 2.78523, 2.81879, 2.85234, 2.8859,  2.91946, 2.95301, 2.98657,
-            3.02013, 3.05369, 3.08724, 3.1208,  3.15436, 3.18791, 3.22147, 3.25503, 3.28858, 3.32214,
-            3.3557,  3.38925, 3.42281, 3.45637, 3.48993, 3.52348, 3.55704, 3.5906,  3.62415, 3.65771,
-            3.69127, 3.72482, 3.75838, 3.79194, 3.8255,  3.85905, 3.89261, 3.92617, 3.95972, 3.99328,
-            4.02684, 4.06039, 4.09395, 4.12751, 4.16107, 4.19462, 4.22818, 4.26174, 4.29529, 4.32885,
-            4.36241, 4.39596, 4.42952, 4.46308, 4.49664, 4.53019, 4.56375, 4.59731, 4.63086, 4.66442,
-            4.69798, 4.73153, 4.76509, 4.79865, 4.83221, 4.86576, 4.89932, 4.93288, 4.96643, 4.99999,
-        ]);
-        assert.deepStrictEqual(array_fps(5, 60), [
-            0,       0.01672, 0.03344, 0.05017, 0.06689, 0.08361, 0.10033, 0.11706, 0.13378, 0.1505,
-            0.16722, 0.18395, 0.20067, 0.21739, 0.23411, 0.25084, 0.26756, 0.28428, 0.301,   0.31773,
-            0.33445, 0.35117, 0.36789, 0.38461, 0.40134, 0.41806, 0.43478, 0.4515,  0.46823, 0.48495,
-            0.50167, 0.51839, 0.53512, 0.55184, 0.56856, 0.58528, 0.60201, 0.61873, 0.63545, 0.65217,
-            0.66889, 0.68562, 0.70234, 0.71906, 0.73578, 0.75251, 0.76923, 0.78595, 0.80267, 0.8194,
-            0.83612, 0.85284, 0.86956, 0.88629, 0.90301, 0.91973, 0.93645, 0.95318, 0.9699,  0.98662,
-            1.00334, 1.02006, 1.03679, 1.05351, 1.07023, 1.08695, 1.10368, 1.1204,  1.13712, 1.15384,
-            1.17057, 1.18729, 1.20401, 1.22073, 1.23746, 1.25418, 1.2709,  1.28762, 1.30435, 1.32107,
-            1.33779, 1.35451, 1.37123, 1.38796, 1.40468, 1.4214,  1.43812, 1.45485, 1.47157, 1.48829,
-            1.50501, 1.52174, 1.53846, 1.55518, 1.5719,  1.58863, 1.60535, 1.62207, 1.63879, 1.65552,
-            1.67224, 1.68896, 1.70568, 1.7224,  1.73913, 1.75585, 1.77257, 1.78929, 1.80602, 1.82274,
-            1.83946, 1.85618, 1.87291, 1.88963, 1.90635, 1.92307, 1.9398,  1.95652, 1.97324, 1.98996,
-            2.00668, 2.02341, 2.04013, 2.05685, 2.07357, 2.0903,  2.10702, 2.12374, 2.14046, 2.15719,
-            2.17391, 2.19063, 2.20735, 2.22408, 2.2408,  2.25752, 2.27424, 2.29097, 2.30769, 2.32441,
-            2.34113, 2.35785, 2.37458, 2.3913,  2.40802, 2.42474, 2.44147, 2.45819, 2.47491, 2.49163,
-            2.50836, 2.52508, 2.5418,  2.55852, 2.57525, 2.59197, 2.60869, 2.62541, 2.64214, 2.65886,
-            2.67558, 2.6923,  2.70902, 2.72575, 2.74247, 2.75919, 2.77591, 2.79264, 2.80936, 2.82608,
-            2.8428,  2.85953, 2.87625, 2.89297, 2.90969, 2.92642, 2.94314, 2.95986, 2.97658, 2.99331,
-            3.01003, 3.02675, 3.04347, 3.06019, 3.07692, 3.09364, 3.11036, 3.12708, 3.14381, 3.16053,
-            3.17725, 3.19397, 3.2107,  3.22742, 3.24414, 3.26086, 3.27759, 3.29431, 3.31103, 3.32775,
-            3.34447, 3.3612,  3.37792, 3.39464, 3.41136, 3.42809, 3.44481, 3.46153, 3.47825, 3.49498,
-            3.5117,  3.52842, 3.54514, 3.56187, 3.57859, 3.59531, 3.61203, 3.62876, 3.64548, 3.6622,
-            3.67892, 3.69564, 3.71237, 3.72909, 3.74581, 3.76253, 3.77926, 3.79598, 3.8127,  3.82942,
-            3.84615, 3.86287, 3.87959, 3.89631, 3.91304, 3.92976, 3.94648, 3.9632,  3.97993, 3.99665,
-            4.01337, 4.03009, 4.04681, 4.06354, 4.08026, 4.09698, 4.1137,  4.13043, 4.14715, 4.16387,
-            4.18059, 4.19732, 4.21404, 4.23076, 4.24748, 4.26421, 4.28093, 4.29765, 4.31437, 4.3311,
-            4.34782, 4.36454, 4.38126, 4.39798, 4.41471, 4.43143, 4.44815, 4.46487, 4.4816,  4.49832,
-            4.51504, 4.53176, 4.54849, 4.56521, 4.58193, 4.59865, 4.61538, 4.6321,  4.64882, 4.66554,
-            4.68226, 4.69899, 4.71571, 4.73243, 4.74915, 4.76588, 4.7826,  4.79932, 4.81604, 4.83277,
-            4.84949, 4.86621, 4.88293, 4.89966, 4.91638, 4.9331,  4.94982, 4.96655, 4.98327, 4.99999,
-        ]);
-    });
-});

package/src/array_gcd.test.js

@@ -1,10 +0,0 @@
-const array_gcd = require('./array_gcd');
-const assert = require('assert');
-
-describe('array_gcd', function () {
-    it('should handle basic input', function () {
-        assert.deepStrictEqual(array_gcd([1,2,3,4,5]), 1);
-        assert.deepStrictEqual(array_gcd([4,8,16]), 4);
-        assert.deepStrictEqual(array_gcd([300,100,200,300]), 100);
-    });
-});

package/src/array_index.test.js

@@ -1,14 +0,0 @@
-const array_index = require('./array_index');
-const assert = require('assert');
-
-describe('array_index', function () {
-    it('should accept empty array', function () {
-        assert.deepStrictEqual(array_index([]), {});
-    });
-    it('should handle basic input', function () {
-        const a = {uid: 'a'};
-        const b = {uid: 'b'};
-        const c = {uid: 'c'};
-        assert.deepStrictEqual(array_index([a, b, c], v => v.uid), {a, b, c});
-    });
-});

package/src/array_lcm.test.js

@@ -1,12 +0,0 @@
-const array_lcm = require('./array_lcm');
-const assert = require('assert');
-
-describe('array_lcm', function () {
-    it('should handle basic input', function () {
-        assert.deepStrictEqual(array_lcm([1,2,3,4,5]), 60);
-        assert.deepStrictEqual(array_lcm([15,25]), 75);
-        assert.deepStrictEqual(array_lcm([4,6,8]), 24);
-        assert.deepStrictEqual(array_lcm([4,8,16]), 16);
-        assert.deepStrictEqual(array_lcm([300,100,200,300]), 600);
-    });
-});