@fuzdev/fuz_util 0.45.2 → 0.46.0

package/dist/array.d.ts

@@ -4,7 +4,7 @@ export declare const EMPTY_ARRAY: Array<any>;
 export declare const to_array: <T>(value: T) => T extends ReadonlyArray<any> ? T : Array<T>;
 /**
  * Removes an element from `array` at `index` in an unordered manner.
- * @mutates array swaps element at index with last element, then removes last element
+ * @mutates array - swaps element at index with last element, then removes last element
  */
 export declare const remove_unordered: (array: Array<any>, index: number) => void;
 /**

package/dist/array.js

@@ -4,7 +4,7 @@ export const EMPTY_ARRAY = Object.freeze([]);
 export const to_array = (value) => Array.isArray(value) ? value : [value];
 /**
  * Removes an element from `array` at `index` in an unordered manner.
- * @mutates array swaps element at index with last element, then removes last element
+ * @mutates array - swaps element at index with last element, then removes last element
  */
 export const remove_unordered = (array, index) => {
     array[index] = array[array.length - 1];

package/dist/async.d.ts

@@ -19,6 +19,24 @@ export interface Deferred<T> {
  * Creates a object with a `promise` and its `resolve`/`reject` handlers.
  */
 export declare const create_deferred: <T>() => Deferred<T>;
+/**
+ * Runs an async function on each item with controlled concurrency.
+ * Like `map_concurrent` but doesn't collect results (more efficient for side effects).
+ *
+ * @param items array of items to process
+ * @param fn async function to apply to each item
+ * @param concurrency maximum number of concurrent operations
+ *
+ * @example
+ * ```ts
+ * await each_concurrent(
+ *   file_paths,
+ *   async (path) => { await unlink(path); },
+ *   5, // max 5 concurrent deletions
+ * );
+ * ```
+ */
+export declare const each_concurrent: <T>(items: Array<T>, fn: (item: T, index: number) => Promise<void>, concurrency: number) => Promise<void>;
 /**
  * Maps over items with controlled concurrency, preserving input order.
  *

package/dist/async.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"async.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/async.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,IAAI,GAAI,iBAAY,KAAG,OAAO,CAAC,IAAI,CACQ,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,UAAU,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,OAAO,CAAC,OAAO,CACI,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC5B,MAAM,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,CAAC;CAC9B;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,OAAK,QAAQ,CAAC,CAAC,CAQ/C,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,cAAc,GAAU,CAAC,EAAE,CAAC,EACxC,OAAO,KAAK,CAAC,CAAC,CAAC,EACf,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EAC1C,aAAa,MAAM,KACjB,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAoDlB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,sBAAsB,GAAU,CAAC,EAAE,CAAC,EAChD,OAAO,KAAK,CAAC,CAAC,CAAC,EACf,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EAC1C,aAAa,MAAM,KACjB,OAAO,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CA6CxC,CAAC"}
+{"version":3,"file":"async.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/async.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,IAAI,GAAI,iBAAY,KAAG,OAAO,CAAC,IAAI,CACQ,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,UAAU,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,OAAO,CAAC,OAAO,CACI,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC5B,MAAM,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,CAAC;CAC9B;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,OAAK,QAAQ,CAAC,CAAC,CAQ/C,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,eAAe,GAAU,CAAC,EACtC,OAAO,KAAK,CAAC,CAAC,CAAC,EACf,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,EAC7C,aAAa,MAAM,KACjB,OAAO,CAAC,IAAI,CAgDd,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,cAAc,GAAU,CAAC,EAAE,CAAC,EACxC,OAAO,KAAK,CAAC,CAAC,CAAC,EACf,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EAC1C,aAAa,MAAM,KACjB,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAkDlB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,sBAAsB,GAAU,CAAC,EAAE,CAAC,EAChD,OAAO,KAAK,CAAC,CAAC,CAAC,EACf,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EAC1C,aAAa,MAAM,KACjB,OAAO,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CA6CxC,CAAC"}

package/dist/async.js

@@ -18,6 +18,68 @@ export const create_deferred = () => {
     });
     return { promise, resolve, reject };
 };
+/**
+ * Runs an async function on each item with controlled concurrency.
+ * Like `map_concurrent` but doesn't collect results (more efficient for side effects).
+ *
+ * @param items array of items to process
+ * @param fn async function to apply to each item
+ * @param concurrency maximum number of concurrent operations
+ *
+ * @example
+ * ```ts
+ * await each_concurrent(
+ *   file_paths,
+ *   async (path) => { await unlink(path); },
+ *   5, // max 5 concurrent deletions
+ * );
+ * ```
+ */
+export const each_concurrent = async (items, fn, concurrency) => {
+    if (concurrency < 1) {
+        throw new Error('concurrency must be at least 1');
+    }
+    let next_index = 0;
+    let active_count = 0;
+    let rejected = false;
+    return new Promise((resolve, reject) => {
+        const run_next = () => {
+            // Stop spawning if we've rejected
+            if (rejected)
+                return;
+            // Check if we're done
+            if (next_index >= items.length && active_count === 0) {
+                resolve();
+                return;
+            }
+            // Spawn workers up to concurrency limit
+            while (active_count < concurrency && next_index < items.length) {
+                const index = next_index++;
+                const item = items[index];
+                active_count++;
+                fn(item, index)
+                    .then(() => {
+                    if (rejected)
+                        return;
+                    active_count--;
+                    run_next();
+                })
+                    .catch((error) => {
+                    if (rejected)
+                        return;
+                    rejected = true;
+                    reject(error); // eslint-disable-line @typescript-eslint/prefer-promise-reject-errors
+                });
+            }
+        };
+        // Handle empty array
+        if (items.length === 0) {
+            resolve();
+            return;
+        }
+        run_next();
+    });
+};
 /**
  * Maps over items with controlled concurrency, preserving input order.
  *
@@ -43,7 +105,6 @@ export const map_concurrent = async (items, fn, concurrency) => {
     let next_index = 0;
     let active_count = 0;
     let rejected = false;
-    let reject_error;
     return new Promise((resolve, reject) => {
         const run_next = () => {
             // Stop spawning if we've rejected
@@ -71,8 +132,7 @@ export const map_concurrent = async (items, fn, concurrency) => {
                     if (rejected)
                         return;
                     rejected = true;
-                    reject_error = error;
-                    reject(reject_error); // eslint-disable-line @typescript-eslint/prefer-promise-reject-errors
+                    reject(error); // eslint-disable-line @typescript-eslint/prefer-promise-reject-errors
                 });
             }
         };

package/dist/dom.d.ts

@@ -18,14 +18,14 @@ export declare const is_interactive: (el: any) => boolean;
  * @param event
  * @param immediate defaults to `true` to use `stopImmediatePropagation` over `stopPropagation`
  * @param preventDefault defaults to `true`
- * @mutates event calls preventDefault(), stopPropagation(), or stopImmediatePropagation()
+ * @mutates event - calls preventDefault(), stopPropagation(), or stopImmediatePropagation()
  * @returns
  */
 export declare const swallow: <T extends Pick<Event, "preventDefault" | "stopPropagation" | "stopImmediatePropagation">>(event: T, immediate?: boolean, preventDefault?: boolean) => T;
 /**
  * Handles the value of an event's target and invokes a callback.
  * Defaults to swallowing the event to prevent default actions and propagation.
- * @mutates event calls `swallow()` which mutates the event if `swallow_event` is true
+ * @mutates event - calls `swallow()` which mutates the event if `swallow_event` is true
  */
 export declare const handle_target_value: (cb: (value: any, event: any) => void, swallow_event?: boolean) => (e: any) => void;
 /**

package/dist/dom.js

@@ -55,7 +55,7 @@ export const is_interactive = (el) => {
  * @param event
  * @param immediate defaults to `true` to use `stopImmediatePropagation` over `stopPropagation`
  * @param preventDefault defaults to `true`
- * @mutates event calls preventDefault(), stopPropagation(), or stopImmediatePropagation()
+ * @mutates event - calls preventDefault(), stopPropagation(), or stopImmediatePropagation()
  * @returns
  */
 export const swallow = (event, immediate = true, preventDefault = true) => {
@@ -73,7 +73,7 @@ export const swallow = (event, immediate = true, preventDefault = true) => {
 /**
  * Handles the value of an event's target and invokes a callback.
  * Defaults to swallowing the event to prevent default actions and propagation.
- * @mutates event calls `swallow()` which mutates the event if `swallow_event` is true
+ * @mutates event - calls `swallow()` which mutates the event if `swallow_event` is true
  */
 export const handle_target_value = (cb, swallow_event = true) => (e) => {
     if (swallow_event)

package/dist/fetch.d.ts

@@ -40,7 +40,7 @@ export interface FetchValueOptions<TValue, TParams = undefined> {
  * If the `value` is cached, only the cached safe subset of the `headers` are returned.
  * (currently just `etag` and `last-modified`)
  * Otherwise the full `res.headers` are included.
- * @mutates options.cache calls `cache.set()` to store fetched results if cache is provided
+ * @mutates options.cache - calls `cache.set()` to store fetched results if cache is provided
  */
 export declare const fetch_value: <TValue = any, TParams = undefined>(url: string | URL, options?: FetchValueOptions<TValue, TParams>) => Promise<Result<{
     value: TValue;

package/dist/fetch.js

@@ -28,7 +28,7 @@ const DEFAULT_GITHUB_API_VERSION_HEADER = '2022-11-28';
  * If the `value` is cached, only the cached safe subset of the `headers` are returned.
  * (currently just `etag` and `last-modified`)
  * Otherwise the full `res.headers` are included.
- * @mutates options.cache calls `cache.set()` to store fetched results if cache is provided
+ * @mutates options.cache - calls `cache.set()` to store fetched results if cache is provided
  */
 export const fetch_value = async (url, options) => {
     const { request, params, parse, token, cache, return_early_from_cache, log, fetch = globalThis.fetch, } = options ?? EMPTY_OBJECT;

package/dist/git.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/git.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"git.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/git.ts"],"names":[],"mappings":"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"}

package/dist/git.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { spawn, spawn_out } from './process.js';
+import { spawn, spawn_out, spawn_result_to_message } from './process.js';
 import { to_file_path } from './path.js';
 import { fs_exists } from './fs.js';
 /**
@@ -40,11 +40,11 @@ export const git_remote_branch_exists = async (origin = 'origin', branch, option
     if (result.ok) {
         return true;
     }
-    else if (result.code === 2) {
+    else if ('code' in result && result.code === 2) {
         return false;
     }
     else {
-        throw Error(`git_remote_branch_exists failed for origin '${origin}' and branch '${final_branch}' with code ${result.code}`);
+        throw Error(`git_remote_branch_exists failed for origin '${origin}' and branch '${final_branch}' with ${spawn_result_to_message(result)}`);
     }
 };
 /**
@@ -173,7 +173,7 @@ export const git_fetch = async (origin = 'origin', branch, options) => {
         args.push(branch);
     const result = await spawn('git', args, options);
     if (!result.ok) {
-        throw Error(`git_fetch failed for origin '${origin}' and branch '${branch}' with code ${result.code}`);
+        throw Error(`git_fetch failed for origin '${origin}' and branch '${branch}' with ${spawn_result_to_message(result)}`);
     }
 };
 /**
@@ -187,7 +187,7 @@ export const git_checkout = async (branch, options) => {
     }
     const result = await spawn('git', ['checkout', branch], options);
     if (!result.ok) {
-        throw Error(`git_checkout failed for branch '${branch}' with code ${result.code}`);
+        throw Error(`git_checkout failed for branch '${branch}' with ${spawn_result_to_message(result)}`);
     }
     return current_branch;
 };
@@ -200,7 +200,7 @@ export const git_pull = async (origin = 'origin', branch, options) => {
         args.push(branch);
     const result = await spawn('git', args, options);
     if (!result.ok) {
-        throw Error(`git_pull failed for branch '${branch}' with code ${result.code}`);
+        throw Error(`git_pull failed for branch '${branch}' with ${spawn_result_to_message(result)}`);
     }
 };
 /**
@@ -213,7 +213,7 @@ export const git_push = async (origin, branch, options, set_upstream = false) =>
         args.push('-u');
     const result = await spawn('git', args, options);
     if (!result.ok) {
-        throw Error(`git_push failed for branch '${final_branch}' with code ${result.code}`);
+        throw Error(`git_push failed for branch '${final_branch}' with ${spawn_result_to_message(result)}`);
     }
 };
 /**
@@ -231,7 +231,7 @@ export const git_push_to_create = async (origin = 'origin', branch, options) =>
     push_args.push(final_branch);
     const result = await spawn('git', push_args, options);
     if (!result.ok) {
-        throw Error(`git_push failed for branch '${final_branch}' with code ${result.code}`);
+        throw Error(`git_push failed for branch '${final_branch}' with ${spawn_result_to_message(result)}`);
     }
 };
 /**
@@ -240,7 +240,7 @@ export const git_push_to_create = async (origin = 'origin', branch, options) =>
 export const git_delete_local_branch = async (branch, options) => {
     const result = await spawn('git', ['branch', '-D', branch], options);
     if (!result.ok) {
-        throw Error(`git_delete_local_branch failed for branch '${branch}' with code ${result.code}`);
+        throw Error(`git_delete_local_branch failed for branch '${branch}' with ${spawn_result_to_message(result)}`);
     }
 };
 /**
@@ -249,7 +249,7 @@ export const git_delete_local_branch = async (branch, options) => {
 export const git_delete_remote_branch = async (origin, branch, options) => {
     const result = await spawn('git', ['push', origin, ':' + branch], options);
     if (!result.ok) {
-        throw Error(`git_delete_remote_branch failed for branch '${branch}' with code ${result.code}`);
+        throw Error(`git_delete_remote_branch failed for branch '${branch}' with ${spawn_result_to_message(result)}`);
     }
 };
 /**

package/dist/path.d.ts

@@ -57,7 +57,7 @@ export declare const parse_path_pieces: (raw_path: string) => Array<PathPiece>;
  * Converts a string into a URL-compatible slug.
  * @param str the string to convert
  * @param map_special_characters if `true`, characters like `ñ` are converted to their ASCII equivalents, runs around 5x faster when disabled
- * @mutates special_char_mappers calls `get_special_char_mappers()` which lazily initializes the module-level array if `map_special_characters` is true
+ * @mutates special_char_mappers - calls `get_special_char_mappers()` which lazily initializes the module-level array if `map_special_characters` is true
  */
 export declare const slugify: (str: string, map_special_characters?: boolean) => string;
 //# sourceMappingURL=path.d.ts.map

package/dist/path.js

@@ -46,7 +46,7 @@ export const parse_path_pieces = (raw_path) => {
  * Converts a string into a URL-compatible slug.
  * @param str the string to convert
  * @param map_special_characters if `true`, characters like `ñ` are converted to their ASCII equivalents, runs around 5x faster when disabled
- * @mutates special_char_mappers calls `get_special_char_mappers()` which lazily initializes the module-level array if `map_special_characters` is true
+ * @mutates special_char_mappers - calls `get_special_char_mappers()` which lazily initializes the module-level array if `map_special_characters` is true
  */
 export const slugify = (str, map_special_characters = true) => {
     let s = str.toLowerCase();
@@ -70,7 +70,7 @@ let special_char_mappers;
 /**
  * Lazily constructs `special_char_mappers` which
  * converts special characters to their ASCII equivalents.
- * @mutates special_char_mappers pushes mapper functions into module-level array on first call
+ * @mutates special_char_mappers - pushes mapper functions into module-level array on first call
  */
 const get_special_char_mappers = () => {
     if (special_char_mappers)

package/dist/print.d.ts

@@ -4,7 +4,7 @@ import type { Logger } from './log.js';
 export declare let st: typeof styleText;
 /**
  * Configures the module-level styling function for colored output.
- * @mutates st assigns the module-level `st` variable
+ * @mutates st - assigns the module-level `st` variable
  */
 export declare const configure_print_colors: (s: typeof styleText | null | undefined) => typeof styleText;
 /**

package/dist/print.js

@@ -1,7 +1,7 @@
 export let st = (_, v) => v;
 /**
  * Configures the module-level styling function for colored output.
- * @mutates st assigns the module-level `st` variable
+ * @mutates st - assigns the module-level `st` variable
  */
 export const configure_print_colors = (s) => {
     st = s ?? ((_, v) => v);