@catbee/utils 0.0.8-rc.0 → 0.0.8-rc.2

package/build/esm/utils/obj.utils.js

@@ -21,42 +21,6 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  */
-var __read = (this && this.__read) || function (o, n) {
-    var m = typeof Symbol === "function" && o[Symbol.iterator];
-    if (!m) return o;
-    var i = m.call(o), r, ar = [], e;
-    try {
-        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
-    }
-    catch (error) { e = { error: error }; }
-    finally {
-        try {
-            if (r && !r.done && (m = i["return"])) m.call(i);
-        }
-        finally { if (e) throw e.error; }
-    }
-    return ar;
-};
-var __values = (this && this.__values) || function(o) {
-    var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
-    if (m) return m.call(o);
-    if (o && typeof o.length === "number") return {
-        next: function () {
-            if (o && i >= o.length) o = void 0;
-            return { value: o && o[i++], done: !o };
-        }
-    };
-    throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
-};
-var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
-    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
-        if (ar || !(i in from)) {
-            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
-            ar[i] = from[i];
-        }
-    }
-    return to.concat(ar || Array.prototype.slice.call(from));
-};
 /**
  * Checks whether the object has no own enumerable properties.
  *
@@ -76,7 +40,7 @@ export function isObjEmpty(obj) {
  * @returns {Pick<T, K>} New object with picked keys.
  */
 export function pick(obj, keys) {
-    return Object.fromEntries(keys.map(function (key) { return [key, obj[key]]; }));
+    return Object.fromEntries(keys.map(key => [key, obj[key]]));
 }
 /**
  * Returns a new object with the specified keys omitted.
@@ -88,10 +52,7 @@ export function pick(obj, keys) {
  * @returns {Omit<T, K>} New object without omitted keys.
  */
 export function omit(obj, keys) {
-    return Object.fromEntries(Object.entries(obj).filter(function (_a) {
-        var _b = __read(_a, 1), key = _b[0];
-        return !keys.includes(key);
-    }));
+    return Object.fromEntries(Object.entries(obj).filter(([key]) => !keys.includes(key)));
 }
 /**
  * Deeply merges multiple objects into the target object (mutates and returns the target object, not pure).
@@ -101,30 +62,15 @@ export function omit(obj, keys) {
  * @param {...any[]} sources - The objects to merge from.
  * @returns {T} The merged object (same as target).
  */
-export function deepObjMerge(target) {
-    var e_1, _a, e_2, _b, e_3, _c;
-    var sources = [];
-    for (var _i = 1; _i < arguments.length; _i++) {
-        sources[_i - 1] = arguments[_i];
-    }
+export function deepObjMerge(target, ...sources) {
     if (!sources.length)
         return target;
-    var seen = new WeakMap();
+    const seen = new WeakMap();
     seen.set(target, target);
-    try {
-        for (var sources_1 = __values(sources), sources_1_1 = sources_1.next(); !sources_1_1.done; sources_1_1 = sources_1.next()) {
-            var s = sources_1_1.value;
-            if (s && typeof s === 'object') {
-                seen.set(s, target);
-            }
-        }
-    }
-    catch (e_1_1) { e_1 = { error: e_1_1 }; }
-    finally {
-        try {
-            if (sources_1_1 && !sources_1_1.done && (_a = sources_1.return)) _a.call(sources_1);
+    for (const s of sources) {
+        if (s && typeof s === 'object') {
+            seen.set(s, target);
         }
-        finally { if (e_1) throw e_1.error; }
     }
     function deepClone(value) {
         if (value === null || typeof value !== 'object')
@@ -137,24 +83,24 @@ export function deepObjMerge(target) {
         }
         // Array
         if (Array.isArray(value)) {
-            var clone_1 = [];
-            seen.set(value, clone_1);
-            value.forEach(function (item, i) { return (clone_1[i] = deepClone(item)); });
-            return clone_1;
+            const clone = [];
+            seen.set(value, clone);
+            value.forEach((item, i) => (clone[i] = deepClone(item)));
+            return clone;
         }
         // Set
         if (value instanceof Set) {
-            var clone_2 = new Set();
-            seen.set(value, clone_2);
-            value.forEach(function (item) { return clone_2.add(deepClone(item)); });
-            return clone_2;
+            const clone = new Set();
+            seen.set(value, clone);
+            value.forEach(item => clone.add(deepClone(item)));
+            return clone;
         }
         // Map
         if (value instanceof Map) {
-            var clone_3 = new Map();
-            seen.set(value, clone_3);
-            value.forEach(function (val, key) { return clone_3.set(key, deepClone(val)); });
-            return clone_3;
+            const clone = new Map();
+            seen.set(value, clone);
+            value.forEach((val, key) => clone.set(key, deepClone(val)));
+            return clone;
         }
         // RegExp
         if (value instanceof RegExp) {
@@ -166,10 +112,10 @@ export function deepObjMerge(target) {
         }
         // TypedArrays
         if (ArrayBuffer.isView(value) && !(value instanceof DataView)) {
-            var typed = value; // cast for TS
-            var ctor = typed.constructor;
+            const typed = value; // cast for TS
+            const ctor = typed.constructor;
             // List of standard TypedArray constructors
-            var typedArrayCtors = [
+            const typedArrayCtors = [
                 Int8Array,
                 Uint8Array,
                 Uint8ClampedArray,
@@ -182,29 +128,29 @@ export function deepObjMerge(target) {
                 BigInt64Array,
                 BigUint64Array
             ].filter(Boolean); // filter out undefined (for environments without BigInt)
-            var typedArrayCtorSet = new Set(typedArrayCtors);
+            const typedArrayCtorSet = new Set(typedArrayCtors);
             if (typeof ctor === 'function' && typedArrayCtorSet.has(ctor)) {
                 // Defensive: ensure buffer is an ArrayBuffer and slice is available
-                var buffer = typed.buffer && typeof typed.buffer.slice === 'function' ? typed.buffer.slice(0) : typed.buffer;
-                var clone_4 = new ctor(buffer, typed.byteOffset, typed.length);
-                seen.set(value, clone_4);
-                return clone_4;
+                const buffer = typed.buffer && typeof typed.buffer.slice === 'function' ? typed.buffer.slice(0) : typed.buffer;
+                const clone = new ctor(buffer, typed.byteOffset, typed.length);
+                seen.set(value, clone);
+                return clone;
             }
             else if (typeof typed.slice === 'function') {
                 // Fallback: try using slice if available (e.g., Node.js Buffer)
-                var clone_5 = typed.slice();
-                seen.set(value, clone_5);
-                return clone_5;
+                const clone = typed.slice();
+                seen.set(value, clone);
+                return clone;
             }
             else {
                 // Could not safely clone, throw an error for better debugging
                 throw new Error('Cannot deep clone unknown TypedArray type: ' + (typed && typed.constructor && typed.constructor.name));
             }
         }
-        var clone = Object.create(Object.getPrototypeOf(value));
+        const clone = Object.create(Object.getPrototypeOf(value));
         seen.set(value, clone);
-        Reflect.ownKeys(value).forEach(function (key) {
-            var descriptor = Object.getOwnPropertyDescriptor(value, key);
+        Reflect.ownKeys(value).forEach(key => {
+            const descriptor = Object.getOwnPropertyDescriptor(value, key);
             if (descriptor.get || descriptor.set) {
                 Object.defineProperty(clone, key, descriptor);
             }
@@ -215,9 +161,8 @@ export function deepObjMerge(target) {
         return clone;
     }
     function mergeProp(target, source, key) {
-        var e_4, _a;
-        var targetValue = target[key];
-        var sourceValue = source[key];
+        const targetValue = target[key];
+        const sourceValue = source[key];
         // Ignore undefined in source
         if (sourceValue === undefined)
             return;
@@ -243,51 +188,21 @@ export function deepObjMerge(target) {
         }
         // Plain objects → recursive merge
         if (isPlainObject(sourceValue) && isPlainObject(targetValue)) {
-            try {
-                for (var _b = __values(Reflect.ownKeys(sourceValue)), _c = _b.next(); !_c.done; _c = _b.next()) {
-                    var k = _c.value;
-                    mergeProp(targetValue, sourceValue, k);
-                }
-            }
-            catch (e_4_1) { e_4 = { error: e_4_1 }; }
-            finally {
-                try {
-                    if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
-                }
-                finally { if (e_4) throw e_4.error; }
+            for (const k of Reflect.ownKeys(sourceValue)) {
+                mergeProp(targetValue, sourceValue, k);
             }
             return;
         }
         // Default → overwrite with clone
         target[key] = deepClone(sourceValue);
     }
-    try {
-        for (var sources_2 = __values(sources), sources_2_1 = sources_2.next(); !sources_2_1.done; sources_2_1 = sources_2.next()) {
-            var source = sources_2_1.value;
-            if (source == null)
-                continue;
-            try {
-                for (var _d = (e_3 = void 0, __values(Reflect.ownKeys(source))), _e = _d.next(); !_e.done; _e = _d.next()) {
-                    var key = _e.value;
-                    mergeProp(target, source, key);
-                }
-            }
-            catch (e_3_1) { e_3 = { error: e_3_1 }; }
-            finally {
-                try {
-                    if (_e && !_e.done && (_c = _d.return)) _c.call(_d);
-                }
-                finally { if (e_3) throw e_3.error; }
-            }
+    for (const source of sources) {
+        if (source == null)
+            continue;
+        for (const key of Reflect.ownKeys(source)) {
+            mergeProp(target, source, key);
         }
     }
-    catch (e_2_1) { e_2 = { error: e_2_1 }; }
-    finally {
-        try {
-            if (sources_2_1 && !sources_2_1.done && (_b = sources_2.return)) _b.call(sources_2);
-        }
-        finally { if (e_2) throw e_2.error; }
-    }
     return target;
 }
 /**
@@ -301,7 +216,7 @@ export function isPlainObject(value) {
         return false;
     if (Array.isArray(value))
         return false;
-    var proto = Object.getPrototypeOf(value);
+    const proto = Object.getPrototypeOf(value);
     return proto === Object.prototype || proto === null;
 }
 /**
@@ -312,11 +227,9 @@ export function isPlainObject(value) {
  * @param {string} [prefix=""] - Optional prefix for nested keys (used internally).
  * @returns {Record<string, any>} A new object with flattened keys.
  */
-export function flattenObject(obj, prefix) {
-    if (prefix === void 0) { prefix = ''; }
-    return Object.entries(obj).reduce(function (acc, _a) {
-        var _b = __read(_a, 2), key = _b[0], value = _b[1];
-        var newKey = prefix ? "".concat(prefix, ".").concat(key) : key;
+export function flattenObject(obj, prefix = '') {
+    return Object.entries(obj).reduce((acc, [key, value]) => {
+        const newKey = prefix ? `${prefix}.${key}` : key;
         if (value && typeof value === 'object' && !Array.isArray(value)) {
             Object.assign(acc, flattenObject(value, newKey));
         }
@@ -338,11 +251,11 @@ export function getValueByPath(obj, path) {
     if (!obj || typeof obj !== 'object')
         return undefined;
     // Convert path like "a.b[0].c" into ["a", "b", "0", "c"]
-    var parts = path
+    const parts = path
         .replace(/\[(\d+)\]/g, '.$1') // convert [0] to .0
         .split('.')
         .filter(Boolean); // remove empty strings
-    return parts.reduce(function (acc, key) { return acc === null || acc === void 0 ? void 0 : acc[key]; }, obj);
+    return parts.reduce((acc, key) => acc?.[key], obj);
 }
 /**
  * Sets a value at a deeply nested key in an object using dot/bracket notation path.
@@ -358,18 +271,18 @@ export function setValueByPath(obj, path, value) {
     if (!obj || typeof obj !== 'object')
         return obj;
     // Convert path like "a.b[0].c" into ["a", "b", "0", "c"]
-    var parts = path
+    const parts = path
         .replace(/\[(\d+)\]/g, '.$1') // convert [0] to .0
         .split('.')
         .filter(Boolean); // remove empty strings
     // Handle empty path
     if (parts.length === 0)
         return obj;
-    var current = obj;
+    let current = obj;
     // Navigate to the parent of the target property
-    for (var i = 0; i < parts.length - 1; i++) {
-        var key = parts[i];
-        var isArrayIndex = !isNaN(Number(parts[i + 1]));
+    for (let i = 0; i < parts.length - 1; i++) {
+        const key = parts[i];
+        const isArrayIndex = !isNaN(Number(parts[i + 1]));
         if (current[key] === undefined) {
             // Create intermediate object or array based on next key type
             current[key] = isArrayIndex ? [] : {};
@@ -377,7 +290,7 @@ export function setValueByPath(obj, path, value) {
         current = current[key];
     }
     // Set the value at the final key
-    var finalKey = parts[parts.length - 1];
+    const finalKey = parts[parts.length - 1];
     current[finalKey] = value;
     return obj;
 }
@@ -409,7 +322,7 @@ export function isEqual(a, b) {
         if (a.length !== b.length)
             return false;
         // Check each element
-        for (var i = 0; i < a.length; i++) {
+        for (let i = 0; i < a.length; i++) {
             if (!isEqual(a[i], b[i]))
                 return false;
         }
@@ -420,12 +333,12 @@ export function isEqual(a, b) {
         return false;
     }
     // Compare object keys
-    var keysA = Object.keys(a);
-    var keysB = Object.keys(b);
+    const keysA = Object.keys(a);
+    const keysB = Object.keys(b);
     if (keysA.length !== keysB.length)
         return false;
     // Check if every key in A exists in B and has the same value
-    return keysA.every(function (key) { return Object.prototype.hasOwnProperty.call(b, key) && isEqual(a[key], b[key]); });
+    return keysA.every(key => Object.prototype.hasOwnProperty.call(b, key) && isEqual(a[key], b[key]));
 }
 /**
  * Filters object properties based on a predicate function.
@@ -436,10 +349,7 @@ export function isEqual(a, b) {
  * @returns {Partial<T>} New object with filtered properties.
  */
 export function filterObject(obj, predicate) {
-    return Object.fromEntries(Object.entries(obj).filter(function (_a) {
-        var _b = __read(_a, 2), key = _b[0], value = _b[1];
-        return predicate(value, key, obj);
-    }));
+    return Object.fromEntries(Object.entries(obj).filter(([key, value]) => predicate(value, key, obj)));
 }
 /**
  * Maps object values to new values using a mapping function.
@@ -451,10 +361,7 @@ export function filterObject(obj, predicate) {
  * @returns {Record<keyof T, U>} New object with mapped values.
  */
 export function mapObject(obj, mapFn) {
-    return Object.fromEntries(Object.entries(obj).map(function (_a) {
-        var _b = __read(_a, 2), key = _b[0], value = _b[1];
-        return [key, mapFn(value, key, obj)];
-    }));
+    return Object.fromEntries(Object.entries(obj).map(([key, value]) => [key, mapFn(value, key, obj)]));
 }
 /**
  * Recursively freezes an object and all its properties.
@@ -465,25 +372,14 @@ export function mapObject(obj, mapFn) {
  * @returns {Readonly<T>} The frozen object.
  */
 export function deepFreeze(obj) {
-    var e_5, _a;
     // Freeze primitive properties
     Object.freeze(obj);
-    try {
-        // Recursively freeze nested objects
-        for (var _b = __values(Object.getOwnPropertyNames(obj)), _c = _b.next(); !_c.done; _c = _b.next()) {
-            var prop = _c.value;
-            var value = obj[prop];
-            if (value !== null && typeof value === 'object' && !Object.isFrozen(value)) {
-                deepFreeze(value);
-            }
-        }
-    }
-    catch (e_5_1) { e_5 = { error: e_5_1 }; }
-    finally {
-        try {
-            if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+    // Recursively freeze nested objects
+    for (const prop of Object.getOwnPropertyNames(obj)) {
+        const value = obj[prop];
+        if (value !== null && typeof value === 'object' && !Object.isFrozen(value)) {
+            deepFreeze(value);
         }
-        finally { if (e_5) throw e_5.error; }
     }
     return obj;
 }
@@ -503,17 +399,14 @@ export function isObject(value) {
  * @param {string} [parentPath=""] - Internal param for recursion.
  * @returns {string[]} Array of all paths in dot notation.
  */
-export function getAllPaths(obj, parentPath) {
-    if (parentPath === void 0) { parentPath = ''; }
+export function getAllPaths(obj, parentPath = '') {
     if (!isObject(obj))
         return [];
-    return Object.entries(obj).flatMap(function (_a) {
-        var _b = __read(_a, 2), key = _b[0], value = _b[1];
-        var currentPath = parentPath ? "".concat(parentPath, ".").concat(key) : key;
+    return Object.entries(obj).flatMap(([key, value]) => {
+        const currentPath = parentPath ? `${parentPath}.${key}` : key;
         if (isObject(value)) {
-            return __spreadArray([currentPath], __read(getAllPaths(value, currentPath)), false);
+            return [currentPath, ...getAllPaths(value, currentPath)];
         }
         return [currentPath];
     });
 }
-//# sourceMappingURL=obj.utils.js.map

package/build/esm/utils/performance.utils.d.ts

@@ -133,4 +133,3 @@ export declare function trackMemoryUsage<T>(fn: () => T, options?: {
         diff: Record<string, number>;
     };
 };
-//# sourceMappingURL=performance.utils.d.ts.map