ansuko 1.2.13 → 1.3.0

package/dist/index.d.ts

@@ -134,6 +134,52 @@ declare const castArray: <T>(value: T | T[] | null | undefined) => T[];
  * @category Object Utilities
  */
 declare const changes: <T extends Record<string, any>, E extends Record<string, any>>(sourceValue: T, currentValue: E, keys: string[], options?: ChangesOptions, finallyCallback?: ChangesAfterFinallyCallback<Record<string, any>>, notEmptyCallback?: ChangesAfterCallback<Record<string, any>>) => Record<string, any>;
+/**
+ * Executes a function and returns undefined if an error occurs.
+ * For functions returning a Promise, returns undefined if the Promise is rejected.
+ *
+ * @template T - The return type of the function
+ * @param fn - The function to execute
+ * @returns The result of the function execution, or undefined on error
+ *
+ * @example
+ * // Synchronous function
+ * swallow(() => data.remove() )
+ * // => undefined (error ignored)
+ *
+ * @example
+ * // Asynchronous function
+ * const data = await swallow(async () => await fetchData());
+ * // => data or undefined
+ */
+declare const swallow: <T>(fn: () => T) => T extends Promise<infer U> ? Promise<U | undefined> : T | undefined;
+/**
+ * Maps over an array, treating errors as undefined.
+ * When compact is true, filters out undefined results (errors).
+ *
+ * @template T - The array element type
+ * @template U - The function return type
+ * @param array - The array to process
+ * @param fn - The function to apply to each element
+ * @param compact - If true, filters out undefined results (errors) from the output
+ * @returns Array of results, or Promise of results for async functions
+ *
+ * @example
+ * // Keep errors as undefined
+ * const results = swallowMap(items, item => processItem(item));
+ * // => [result1, undefined, result3, ...]
+ *
+ * @example
+ * // Filter out errors (compact)
+ * const results = swallowMap(items, item => processItem(item), true);
+ * // => [result1, result3, ...]
+ *
+ * @example
+ * // Async processing
+ * const data = await swallowMap(urls, async url => await fetch(url), true);
+ * // => array of successful responses only
+ */
+declare const swallowMap: <T, U>(array: T[] | undefined | null, fn: (item: T, index: number) => U, compact?: boolean) => U extends Promise<infer V> ? Promise<V[]> : U[];
 /**
  * Returns nesting depth of arrays. Non-array: 0; empty array: 1. Uses minimum depth for mixed nesting.
  * @param ary - Array
@@ -175,6 +221,8 @@ export interface AnsukoType extends Omit<_.LoDashStatic, "castArray" | "isEmpty"
     jsonStringify: typeof jsonStringify;
     castArray: typeof castArray;
     changes: typeof changes;
+    swallow: typeof swallow;
+    swallowMap: typeof swallowMap;
     size: typeof _.size;
     isNil: typeof _.isNil;
     debounce: typeof _.debounce;
@@ -195,4 +243,4 @@ export interface AnsukoType extends Omit<_.LoDashStatic, "castArray" | "isEmpty"
 }
 declare const _default: AnsukoType;
 export default _default;
-export { isEmpty, toNumber, boolIf, isValidStr, valueOr, equalsOr, waited, parseJSON, jsonStringify, castArray, changes, arrayDepth, };
+export { isEmpty, toNumber, boolIf, isValidStr, valueOr, equalsOr, waited, parseJSON, jsonStringify, castArray, changes, swallow, swallowMap, arrayDepth, };

package/dist/index.js

@@ -447,6 +447,82 @@ const changes = (sourceValue, currentValue, keys, options, finallyCallback, notE
     }
     return diff;
 };
+/**
+ * Executes a function and returns undefined if an error occurs.
+ * For functions returning a Promise, returns undefined if the Promise is rejected.
+ *
+ * @template T - The return type of the function
+ * @param fn - The function to execute
+ * @returns The result of the function execution, or undefined on error
+ *
+ * @example
+ * // Synchronous function
+ * swallow(() => data.remove() )
+ * // => undefined (error ignored)
+ *
+ * @example
+ * // Asynchronous function
+ * const data = await swallow(async () => await fetchData());
+ * // => data or undefined
+ */
+const swallow = (fn) => {
+    try {
+        const result = fn();
+        if (result instanceof Promise) {
+            return result.catch(() => undefined);
+        }
+        return result;
+    }
+    catch {
+        return undefined;
+    }
+};
+/**
+ * Maps over an array, treating errors as undefined.
+ * When compact is true, filters out undefined results (errors).
+ *
+ * @template T - The array element type
+ * @template U - The function return type
+ * @param array - The array to process
+ * @param fn - The function to apply to each element
+ * @param compact - If true, filters out undefined results (errors) from the output
+ * @returns Array of results, or Promise of results for async functions
+ *
+ * @example
+ * // Keep errors as undefined
+ * const results = swallowMap(items, item => processItem(item));
+ * // => [result1, undefined, result3, ...]
+ *
+ * @example
+ * // Filter out errors (compact)
+ * const results = swallowMap(items, item => processItem(item), true);
+ * // => [result1, result3, ...]
+ *
+ * @example
+ * // Async processing
+ * const data = await swallowMap(urls, async url => await fetch(url), true);
+ * // => array of successful responses only
+ */
+const swallowMap = (array, fn, compact) => {
+    if (!array)
+        return [];
+    const results = array.map((item, index) => {
+        try {
+            const result = fn(item, index);
+            if (result instanceof Promise) {
+                return result.catch(() => undefined);
+            }
+            return result;
+        }
+        catch {
+            return undefined;
+        }
+    });
+    if (results.some(r => r instanceof Promise)) {
+        return Promise.all(results).then(resolved => compact ? resolved.filter(Boolean) : resolved);
+    }
+    return (compact ? results.filter(Boolean) : results);
+};
 /**
  * Returns nesting depth of arrays. Non-array: 0; empty array: 1. Uses minimum depth for mixed nesting.
  * @param ary - Array
@@ -502,7 +578,9 @@ export default {
     jsonStringify,
     castArray,
     changes,
+    swallow,
+    swallowMap,
     arrayDepth,
 };
 // 個別エクスポートはそのまま
-export { isEmpty, toNumber, boolIf, isValidStr, valueOr, equalsOr, waited, parseJSON, jsonStringify, castArray, changes, arrayDepth, };
+export { isEmpty, toNumber, boolIf, isValidStr, valueOr, equalsOr, waited, parseJSON, jsonStringify, castArray, changes, swallow, swallowMap, arrayDepth, };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ansuko",
-  "version": "1.2.13",
+  "version": "1.3.0",
   "description": "A modern JavaScript/TypeScript utility library that extends lodash with practical, intuitive behaviors. Fixes lodash quirks, adds Promise support, Japanese text processing, and GeoJSON utilities.",
   "keywords": [
     "lodash",