release v3.74.0

Author: vbarbarosh

README.md

@@ -20,7 +20,7 @@ npm install @vbarbarosh/node-helpers
 A subset of `@vbarbarosh/node-helpers` is available for browser:
 
 ```html
-<script src="https://unpkg.com/@vbarbarosh/node-helpers@3.73.0/dist/browser.js"></script>
+<script src="https://unpkg.com/@vbarbarosh/node-helpers@3.74.0/dist/browser.js"></script>
 ```
 
 ⚠️ All browser functions are exposed globally.

dist/browser.js

@@ -80,7 +80,7 @@ function serializer(replacer, cycleReplacer) {
 
 var map = {
 	"./array_chunk.js": "./src/array_chunk.js",
-	"./array_chunk_jobs.js": "./src/array_chunk_jobs.js",
+	"./array_chunk_balanced.js": "./src/array_chunk_balanced.js",
 	"./array_fps.js": "./src/array_fps.js",
 	"./array_gcd.js": "./src/array_gcd.js",
 	"./array_group.js": "./src/array_group.js",
@@ -205,39 +205,44 @@ module.exports = array_chunk;
 
 /***/ }),
 
-/***/ "./src/array_chunk_jobs.js":
-/*!*********************************!*\
-  !*** ./src/array_chunk_jobs.js ***!
-  \*********************************/
+/***/ "./src/array_chunk_balanced.js":
+/*!*************************************!*\
+  !*** ./src/array_chunk_balanced.js ***!
+  \*************************************/
 /***/ ((module, __unused_webpack_exports, __webpack_require__) => {
 
 const clamp = __webpack_require__(/*! ./clamp */ "./src/clamp.js");
 
 /**
- * Split an array of jobs between up to `max_threads`, while trying to put at least
- * `min_jobs_per_thread` items into each chunk.
+ * Split an array into up to `max_chunks` balanced chunks, while ensuring that
+ * each chunk contains at least `min_items_per_chunk` items (when possible).
  *
- * - If an array is empty → returns [].
- * - If there are too few items to satisfy `min_items_per_chunk`, even for 1 chunk,
- *   everything goes into a single chunk.
+ * The function distributes items as evenly as possible:
+ * - Chunk sizes differ by at most 1 item.
+ * - The number of chunks never exceeds `max_chunks`.
  *
- * Alternative names:
- *   - array_chunk_balanced
+ * Originally designed for distributing workload across threads
+ * (e.g. `array_chunk_balanced(jobs, max_threads, min_jobs_per_thread)`).
  *
- * @param array
- * @param max_threads
- * @param min_jobs_per_thread
- * @returns {*[]}
+ * Edge cases:
+ * - If the input array is empty → returns [].
+ * - If there are too few items to satisfy `min_items_per_chunk`, even for a single
+ *   chunk, all items are placed into one chunk.
+ *
+ * @param {Array} array
+ * @param {number} max_chunks
+ * @param {number} min_items_per_chunk
+ * @returns {Array<Array>}
  */
-function array_chunk_jobs(array = [], max_threads = 1, min_jobs_per_thread = 1)
+function array_chunk_balanced(array = [], max_chunks = 1, min_items_per_chunk = 1)
 {
-    const total_threads = clamp(1, max_threads, Math.floor(array.length / min_jobs_per_thread));
-    const jobs_per_thread = Math.floor(array.length / total_threads);
-    let extra = array.length % total_threads;
+    const total_chunks = clamp(1, max_chunks, Math.floor(array.length / min_items_per_chunk));
+    const items_per_chunk = Math.floor(array.length / total_chunks);
+    let extra = array.length % total_chunks;
 
     const out = [];
     for (let i = 0; i < array.length; ) {
-        const size = jobs_per_thread + (extra ? 1 : 0);
+        const size = items_per_chunk + (extra ? 1 : 0);
         out.push(array.slice(i, i + size));
         i += size;
         if (extra) {
@@ -247,7 +252,7 @@ function array_chunk_jobs(array = [], max_threads = 1, min_jobs_per_thread = 1)
     return out;
 }
 
-module.exports = array_chunk_jobs;
+module.exports = array_chunk_balanced;
 
 
 /***/ }),
@@ -2479,10 +2484,10 @@ var __webpack_exports__ = {};
   \******************************/
 const ns = new URL(document.currentScript.src).searchParams.get('var') ?? 'h';
 if (typeof window[ns] !== 'undefined') {
-    console.log(`❌ @vbarbarosh/node-helpers@${"3.73.0"} was not injected — window.${ns} is already in use`);
+    console.log(`❌ @vbarbarosh/node-helpers@${"3.74.0"} was not injected — window.${ns} is already in use`);
 }
 else {
-    console.log(`🎉 @vbarbarosh/node-helpers@${"3.73.0"} successfully exposed as window.${ns}`);
+    console.log(`🎉 @vbarbarosh/node-helpers@${"3.74.0"} successfully exposed as window.${ns}`);
     window[ns] = {};
     // https://github.com/webpack/webpack/issues/625
     // https://webpack.js.org/guides/dependency-management/#require-context

docs/data.json

@@ -331,11 +331,11 @@
             "markdown": null
         },
         {
-            "id": "array_chunk_jobs",
-            "name": "array_chunk_jobs",
-            "file": "src/array_chunk_jobs.js",
-            "require": "const array_chunk_jobs = require('@vbarbarosh/node-helpers/src/array_chunk_jobs');",
-            "source_code": "const clamp = require('./clamp');\n\n/**\n * Split an array of jobs between up to `max_threads`, while trying to put at least\n * `min_jobs_per_thread` items into each chunk.\n *\n * - If an array is empty → returns [].\n * - If there are too few items to satisfy `min_items_per_chunk`, even for 1 chunk,\n *   everything goes into a single chunk.\n *\n * Alternative names:\n *   - array_chunk_balanced\n *\n * @param array\n * @param max_threads\n * @param min_jobs_per_thread\n * @returns {*[]}\n */\nfunction array_chunk_jobs(array = [], max_threads = 1, min_jobs_per_thread = 1)\n{\n    const total_threads = clamp(1, max_threads, Math.floor(array.length / min_jobs_per_thread));\n    const jobs_per_thread = Math.floor(array.length / total_threads);\n    let extra = array.length % total_threads;\n\n    const out = [];\n    for (let i = 0; i < array.length; ) {\n        const size = jobs_per_thread + (extra ? 1 : 0);\n        out.push(array.slice(i, i + size));\n        i += size;\n        if (extra) {\n            extra--;\n        }\n    }\n    return out;\n}\n\nmodule.exports = array_chunk_jobs;\n",
+            "id": "array_chunk_balanced",
+            "name": "array_chunk_balanced",
+            "file": "src/array_chunk_balanced.js",
+            "require": "const array_chunk_balanced = require('@vbarbarosh/node-helpers/src/array_chunk_balanced');",
+            "source_code": "const clamp = require('./clamp');\n\n/**\n * Split an array into up to `max_chunks` balanced chunks, while ensuring that\n * each chunk contains at least `min_items_per_chunk` items (when possible).\n *\n * The function distributes items as evenly as possible:\n * - Chunk sizes differ by at most 1 item.\n * - The number of chunks never exceeds `max_chunks`.\n *\n * Originally designed for distributing workload across threads\n * (e.g. `array_chunk_balanced(jobs, max_threads, min_jobs_per_thread)`).\n *\n * Edge cases:\n * - If the input array is empty → returns [].\n * - If there are too few items to satisfy `min_items_per_chunk`, even for a single\n *   chunk, all items are placed into one chunk.\n *\n * @param {Array} array\n * @param {number} max_chunks\n * @param {number} min_items_per_chunk\n * @returns {Array<Array>}\n */\nfunction array_chunk_balanced(array = [], max_chunks = 1, min_items_per_chunk = 1)\n{\n    const total_chunks = clamp(1, max_chunks, Math.floor(array.length / min_items_per_chunk));\n    const items_per_chunk = Math.floor(array.length / total_chunks);\n    let extra = array.length % total_chunks;\n\n    const out = [];\n    for (let i = 0; i < array.length; ) {\n        const size = items_per_chunk + (extra ? 1 : 0);\n        out.push(array.slice(i, i + size));\n        i += size;\n        if (extra) {\n            extra--;\n        }\n    }\n    return out;\n}\n\nmodule.exports = array_chunk_balanced;\n",
             "markdown": null
         },
         {

docs/index.html

@@ -11,7 +11,7 @@
 
 <script src="https://unpkg.com/axios@1.11.0/dist/axios.min.js"></script>
 <script src="https://unpkg.com/@vbarbarosh/ui-helpers@0.4.0/src/static/js/bundle.js"></script>
-<script src="https://unpkg.com/@vbarbarosh/node-helpers@3.73.0/dist/browser.js?var=h"></script>
+<script src="https://unpkg.com/@vbarbarosh/node-helpers@3.74.0/dist/browser.js?var=h"></script>
 <script src="js/components/main-demos.js"></script>
 <script src="js/components/main-header.js"></script>
 <script src="js/components/main-helpers.js"></script>

docs/js/components/main-demos.js

@@ -14,7 +14,7 @@ vue_component('main-demos', {
         demos: function () {
             const package_json = `{
   "dependencies": {
-    "@vbarbarosh/node-helpers": "^3.73.0"
+    "@vbarbarosh/node-helpers": "^3.74.0"
   }
 }`;
             const tmp = {};

docs/js/components/main-header.js

@@ -21,8 +21,8 @@ vue_component('main-header', {
 
             <p>A subset of <b>@vbarbarosh/node-helpers</b> is also available for browser:</p>
             <div>
-                <div class="rel"><copy-to-clipboard value='<script src="https://unpkg.com/@vbarbarosh/node-helpers@3.73.0/dist/browser.js?var=h">&lt;/script>"' /></div>
-                <prism-html value='<script src="https://unpkg.com/@vbarbarosh/node-helpers@3.73.0/dist/browser.js?var=h">&lt;/script>' />
+                <div class="rel"><copy-to-clipboard value='<script src="https://unpkg.com/@vbarbarosh/node-helpers@3.74.0/dist/browser.js?var=h">&lt;/script>"' /></div>
+                <prism-html value='<script src="https://unpkg.com/@vbarbarosh/node-helpers@3.74.0/dist/browser.js?var=h">&lt;/script>' />
             </div>
             <p>⚠️ All browser functions are exposed as <strong>window.h</strong>. This could be changed by <strong>?var=new_name</strong> query parameter.</p>
         </div>

package-lock.json

@@ -2,7 +2,7 @@
     "author": "Vladimir Barbarosh <vladimir.barbarosh@gmail.com>",
     "license": "MIT",
     "name": "@vbarbarosh/node-helpers",
-    "version": "3.73.0",
+    "version": "3.74.0",
     "description": "A set of helpers for JavaScript/Node.js",
     "unpkg": "dist/browser.js",
     "jsdelivr": "dist/browser.js",