@fluixi/utils 1.0.0-alpha.53

package/dist/lib/object/merge.js

@@ -0,0 +1,474 @@
+import { isPlainObject } from './utils.js';
+import { deepClone } from './clone.js';
+import { diffObjectDetailed, applyDiff, } from './diff.js';
+import { parseSelector } from './selector.js';
+export function merge(...sources) {
+    if (sources.length === 0)
+        return {};
+    // Check if we're merging arrays or objects
+    const firstItem = sources[0];
+    const isArrayMerge = Array.isArray(firstItem);
+    // Ensure consistent types (all objects or all arrays)
+    for (const source of sources) {
+        if (source && Array.isArray(source) !== isArrayMerge) {
+            throw new Error('Cannot mix arrays and objects in deepMerge');
+        }
+    }
+    // Create appropriate empty result
+    let result = isArrayMerge ? [] : {};
+    // Merge the sources into the result
+    for (const source of sources) {
+        // Skip null/undefined sources
+        if (source == null)
+            continue;
+        if (isArrayMerge) {
+            // Array merging - concatenate arrays after deep cloning items
+            const resultArray = result;
+            const sourceArray = source;
+            for (const item of sourceArray) {
+                resultArray.push(deepClone(item));
+            }
+        }
+        else {
+            // Object merging
+            if (!isPlainObject(source))
+                continue;
+            const resultObj = result;
+            const sourceObj = source;
+            // Handle regular properties
+            for (const key in sourceObj) {
+                if (Object.prototype.hasOwnProperty.call(sourceObj, key)) {
+                    const value = sourceObj[key];
+                    const existing = resultObj[key];
+                    if (existing === undefined) {
+                        // No existing value, deep clone the new value
+                        resultObj[key] = deepClone(value);
+                    }
+                    else if (Array.isArray(value) && Array.isArray(existing)) {
+                        // Both are arrays, concatenate them after deep cloning
+                        resultObj[key] = [
+                            ...existing,
+                            ...value.map((item) => deepClone(item)),
+                        ];
+                    }
+                    else if (isPlainObject(value) && isPlainObject(existing)) {
+                        // Both are plain objects, recursively merge
+                        resultObj[key] = merge(existing, value);
+                    }
+                    else {
+                        // Primitive or type mismatch, replace with cloned value
+                        resultObj[key] = deepClone(value);
+                    }
+                }
+            }
+            // Handle symbols
+            const symbols = Object.getOwnPropertySymbols(sourceObj);
+            for (const symbol of symbols) {
+                const value = sourceObj[symbol];
+                const existing = resultObj[symbol];
+                if (existing === undefined) {
+                    // No existing value, deep clone the new value
+                    resultObj[symbol] = deepClone(value);
+                }
+                else if (Array.isArray(value) && Array.isArray(existing)) {
+                    // Both are arrays, concatenate them after deep cloning
+                    resultObj[symbol] = [
+                        ...existing,
+                        ...value.map((item) => deepClone(item)),
+                    ];
+                }
+                else if (isPlainObject(value) && isPlainObject(existing)) {
+                    // Both are plain objects, recursively merge
+                    resultObj[symbol] = merge(existing, value);
+                }
+                else {
+                    // Primitive or type mismatch, replace with cloned value
+                    resultObj[symbol] = deepClone(value);
+                }
+            }
+        }
+    }
+    return result;
+}
+function getKey(value, keys) {
+    let key;
+    if (typeof value === 'undefined' || value === null)
+        return;
+    const data_keys = keys ? keys : ["id"];
+    if (typeof value === 'object') {
+        if (!Array.isArray(value)) {
+            let i = 0;
+            while (!key) {
+                key = data_keys[i];
+                i += 1;
+            }
+        }
+    }
+    return key;
+}
+export function mergeArrays(arr1, arr2, options) {
+    const { key, override = true } = options || {};
+    // 👉 Case 1: primitives
+    if (!key) {
+        return Array.from(new Set([...arr1, ...arr2]));
+    }
+    // 👉 Case 2: objects with key
+    const map = new Map();
+    for (const item of arr1) {
+        map.set(item[key], item);
+    }
+    for (const item of arr2) {
+        const existing = map.get(item[key]);
+        if (!existing) {
+            map.set(item[key], item);
+        }
+        else {
+            map.set(item[key], override
+                ? { ...existing, ...item } // merge + override
+                : { ...item, ...existing } // keep original
+            );
+        }
+    }
+    return Array.from(map.values());
+}
+function mergeInPlace(target, source) {
+    for (const key in source) {
+        const tVal = target[key];
+        const sVal = source[key];
+        const diff = diffObjectDetailed(tVal, sVal);
+        if (Array.isArray(tVal) && Array.isArray(sVal)) {
+            // keep same array reference
+            tVal.length = 0;
+            tVal.push(...sVal);
+        }
+        else if (typeof tVal === 'object' &&
+            typeof sVal === 'object' &&
+            tVal &&
+            sVal &&
+            diff.hasChanges) {
+            applyDiff(tVal, sVal);
+            // mergeInPlace(tVal, sVal);
+        }
+        else {
+            target[key] = sVal;
+        }
+    }
+}
+/**
+ * Merges objects or arrays with options for reference preservation and strict merging
+ *
+ * @param target - The target object/array to merge into (can be modified if preserveTarget is true)
+ * @param sources - The source objects/arrays to merge from
+ * @param options - Configuration options
+ * @returns The merged result
+ *
+ * @example
+ * // With reference preservation
+ * const obj1 = { a: 1, b: { c: 2 } };
+ * const result = deepMergeWithOptions(obj1, { b: { d: 3 }, e: 4 }, { preserveTarget: true });
+ * // result === obj1 (same reference)
+ * // result: { a: 1, b: { c: 2, d: 3 }, e: 4 }
+ *
+ * @example
+ * // With strict merging (only merge properties that exist in target)
+ * const obj1 = { a: 1, b: { c: 2 } };
+ * const result = deepMergeWithOptions(obj1, { b: { d: 3 }, e: 4 }, { strict: true });
+ * // result: { a: 1, b: { c: 2 } } - e is not added as it doesn't exist in obj1
+ */
+export function deepMergeWithOptions(target, ...args) {
+    if (args.length === 0)
+        return deepClone(target);
+    // Check if last argument is options
+    let options = { preserveTarget: false, strict: false };
+    let sources = args;
+    const lastArg = args[args.length - 1];
+    if (lastArg &&
+        typeof lastArg === 'object' &&
+        ('preserveTarget' in lastArg || 'strict' in lastArg)) {
+        options = { ...options, ...lastArg };
+        sources = args.slice(0, -1);
+    }
+    // Create or use target as result base
+    const result = options.preserveTarget ? target : deepClone(target);
+    // Ensure consistent types (all objects or all arrays)
+    const isArrayMerge = Array.isArray(result);
+    for (const source of sources) {
+        if (source && Array.isArray(source) !== isArrayMerge) {
+            throw new Error('Cannot mix arrays and objects in deepMergeWithOptions');
+        }
+    }
+    // Process each source
+    for (const source of sources) {
+        if (source == null)
+            continue;
+        if (isArrayMerge) {
+            // Array merging
+            const resultArray = result;
+            const sourceArray = source;
+            if (options.strict) {
+                // In strict mode, only modify existing array elements
+                for (let i = 0; i < resultArray.length && i < sourceArray.length; i++) {
+                    if (isPlainObject(resultArray[i]) && isPlainObject(sourceArray[i])) {
+                        resultArray[i] = deepMergeWithOptions(resultArray[i], sourceArray[i], options);
+                    }
+                    else {
+                        // For non-objects in strict mode, only replace if same type
+                        if (typeof resultArray[i] === typeof sourceArray[i]) {
+                            resultArray[i] = deepClone(sourceArray[i]);
+                        }
+                    }
+                }
+            }
+            else {
+                // In non-strict mode, concatenate arrays
+                // console.log('pushing', [...resultArray], [...sourceArray])
+                mergeInPlace(resultArray, sourceArray);
+                // if(sourceArray.length===resultArray.length){
+                //   for (let i=0; i<sourceArray.length; i++) {
+                //     const item = sourceArray[i];
+                //     // const result = resultArray[i];
+                //     // let index = -1;
+                //     // if(typeof item === 'object'){
+                //     //   const key = getKey(item);
+                //     //   if(key){
+                //     //     index = resultArray.find(s=>)
+                //     //   }else{
+                //     //   }
+                //     // }else{
+                //     // }
+                //     resultArray.push(deepClone(item));
+                //   }
+                // }else{
+                //   for (let i=0; i<sourceArray.length; i++) {
+                //     const item = sourceArray[i]
+                //     resultArray.push(deepClone(item));
+                //   }
+                // }
+            }
+        }
+        else {
+            // Object merging
+            if (!isPlainObject(source))
+                continue;
+            const resultObj = result;
+            const sourceObj = source;
+            // Handle regular properties
+            for (const key in sourceObj) {
+                if (!Object.prototype.hasOwnProperty.call(sourceObj, key))
+                    continue;
+                const value = sourceObj[key];
+                if (options.strict && !(key in resultObj)) {
+                    // In strict mode, skip properties that don't exist in the target
+                    continue;
+                }
+                const existing = resultObj[key];
+                if (existing === undefined) {
+                    // Property doesn't exist in result yet, clone and add it
+                    resultObj[key] = deepClone(value);
+                }
+                else if (Array.isArray(value) && Array.isArray(existing)) {
+                    // Both are arrays, handle according to options
+                    if (options.strict) {
+                        // In strict mode, recursively merge array elements
+                        resultObj[key] = deepMergeWithOptions(existing, value, options);
+                    }
+                    else {
+                        // In non-strict mode, concatenate arrays
+                        resultObj[key] = [
+                            ...existing,
+                            ...value.map((item) => deepClone(item)),
+                        ];
+                    }
+                }
+                else if (isPlainObject(value) && isPlainObject(existing)) {
+                    // Both are plain objects, recursively merge
+                    resultObj[key] = deepMergeWithOptions(existing, value, options);
+                }
+                else {
+                    // Primitive or type mismatch, replace with cloned value
+                    resultObj[key] = deepClone(value);
+                }
+            }
+            // Handle symbols
+            const symbols = Object.getOwnPropertySymbols(sourceObj);
+            for (const symbol of symbols) {
+                if (options.strict && !(symbol in resultObj)) {
+                    // In strict mode, skip symbols that don't exist in the target
+                    continue;
+                }
+                const value = sourceObj[symbol];
+                const existing = resultObj[symbol];
+                if (existing === undefined) {
+                    // Symbol doesn't exist in result yet, clone and add it
+                    resultObj[symbol] = deepClone(value);
+                }
+                else if (Array.isArray(value) && Array.isArray(existing)) {
+                    // Both are arrays, handle according to options
+                    if (options.strict) {
+                        // In strict mode, recursively merge array elements
+                        resultObj[symbol] = deepMergeWithOptions(existing, value, options);
+                    }
+                    else {
+                        // In non-strict mode, concatenate arrays
+                        resultObj[symbol] = [
+                            ...existing,
+                            ...value.map((item) => deepClone(item)),
+                        ];
+                    }
+                }
+                else if (isPlainObject(value) && isPlainObject(existing)) {
+                    // Both are plain objects, recursively merge
+                    resultObj[symbol] = deepMergeWithOptions(existing, value, options);
+                }
+                else {
+                    // Primitive or type mismatch, replace with cloned value
+                    resultObj[symbol] = deepClone(value);
+                }
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Deep merges objects/arrays while preserving the reference to the first object/array
+ * Modifies the first object directly rather than creating a new one
+ *
+ * @param target - The target object that will be modified
+ * @param sources - The source objects to merge from
+ * @returns The modified target object (same reference)
+ *
+ * @example
+ * const obj1 = { a: 1, b: { c: 2 } };
+ * const result = deepMergeKeepReference(obj1, { b: { d: 3 }, e: 4 });
+ * // result === obj1 (same reference)
+ * // obj1 is now: { a: 1, b: { c: 2, d: 3 }, e: 4 }
+ */
+export function deepMergeKeepReference(target, ...sources) {
+    return deepMergeWithOptions(target, ...sources, {
+        preserveTarget: true,
+    });
+}
+/**
+ * Strict deep merge - only merges properties that already exist in the target
+ * Does not add new properties that don't exist in the target
+ *
+ * @param target - The target object
+ * @param sources - The source objects to merge from
+ * @param preserveReference - Whether to preserve the reference to target (default: false)
+ * @returns The merged object
+ *
+ * @example
+ * const obj1 = { a: 1, b: { c: 2 } };
+ * const result = deepMergeStrict(obj1, { b: { d: 3 }, e: 4 });
+ * // result: { a: 1, b: { c: 2 } } - e is not added as it doesn't exist in obj1
+ * //                                 d is not added as it doesn't exist in obj1.b
+ */
+export function deepMergeStrict(target, ...args) {
+    // Check if last argument is a boolean flag for preserving reference
+    let preserveReference = false;
+    let sources = args;
+    if (args.length > 0 && typeof args[args.length - 1] === 'boolean') {
+        preserveReference = args[args.length - 1];
+        sources = args.slice(0, -1);
+    }
+    return deepMergeWithOptions(target, ...sources, {
+        preserveTarget: preserveReference,
+        strict: true,
+    });
+}
+/**
+ * Helper to merge a value into a structure based on selector
+ * @param target - Target object to merge into
+ * @param selector - Selector string
+ * @param value - Value to merge
+ * @example
+ * mergeIntoStructure({ a: { b: { c: 1 } } }, 'a.b.c', 2);
+ * // { a: { b: { c: 2 } } }
+ */
+export const mergeIntoStructure = (target, selector, value) => {
+    const segments = parseSelector(selector);
+    let current = target;
+    for (let i = 0; i < segments.length; i++) {
+        const segment = segments[i];
+        const isLast = i === segments.length - 1;
+        switch (segment.type) {
+            case 'property':
+                if (isLast) {
+                    current[String(segment.value)] = value;
+                }
+                else {
+                    if (!current[String(segment.value)]) {
+                        const nextSegment = segments[i + 1];
+                        current[String(segment.value)] =
+                            nextSegment.type === 'index' ||
+                                nextSegment.type === 'slice' ||
+                                nextSegment.type === 'union' ||
+                                nextSegment.type === 'wildcard'
+                                ? []
+                                : {};
+                    }
+                    current = current[String(segment.value)];
+                }
+                break;
+            case 'index':
+                if (!Array.isArray(current)) {
+                    current = [];
+                }
+                const index = segment.value;
+                if (isLast) {
+                    if (index >= current.length) {
+                        for (let j = current.length; j <= index; j++) {
+                            current.push(undefined);
+                        }
+                    }
+                    current[index] = value;
+                }
+                else {
+                    if (!current[index]) {
+                        const nextSegment = segments[i + 1];
+                        current[index] =
+                            nextSegment.type === 'index' ||
+                                nextSegment.type === 'slice' ||
+                                nextSegment.type === 'union' ||
+                                nextSegment.type === 'wildcard'
+                                ? []
+                                : {};
+                    }
+                    current = current[index];
+                }
+                break;
+            case 'wildcard':
+                // For wildcards in get, we need to handle all elements
+                if (Array.isArray(current)) {
+                    if (isLast) {
+                        // Fill all positions with value
+                        for (let j = 0; j < current.length; j++) {
+                            current[j] = value;
+                        }
+                    }
+                    else {
+                        // Ensure all elements have the structure
+                        const nextSegment = segments[i + 1];
+                        for (let j = 0; j < current.length; j++) {
+                            if (!current[j]) {
+                                current[j] =
+                                    nextSegment.type === 'index' ||
+                                        nextSegment.type === 'slice' ||
+                                        nextSegment.type === 'union' ||
+                                        nextSegment.type === 'wildcard'
+                                        ? []
+                                        : {};
+                            }
+                        }
+                        // Continue with first element (structure should be same for all)
+                        if (current.length > 0) {
+                            current = current[0];
+                        }
+                    }
+                }
+                break;
+        }
+    }
+};
+// Export aliases for convenience
+export { deepMergeKeepReference as deepMerge, deepMergeStrict as mergeStrict, deepMergeWithOptions as mergeWithOptions, };

package/dist/lib/object/merge.mjs

@@ -0,0 +1 @@
+var b=e=>e==null||Array.isArray(e)||typeof e=="function"||e instanceof Date||e instanceof RegExp||e instanceof Map||e instanceof Set||e instanceof Error?!1:typeof e=="object";function $(e){if(typeof e!="object"||e===null)return!1;let s=Object.getPrototypeOf(e);return s===Object.prototype||s===null}var w=(e,s)=>{if(e==null||typeof e!="object")return e;if(e instanceof Date)return new Date(e.getTime());if(e instanceof RegExp)return new RegExp(e.source,e.flags);if(e instanceof Map){let a=new Map;return e.forEach((c,t)=>{(!s||!s.some(r=>r.toString()===t.toString()))&&a.set(t,w(c))}),a}if(e instanceof Set){let a=new Set;return e.forEach(c=>{a.add(w(c))}),a}if(Array.isArray(e))return Array.from(e).map(a=>w(a));if(b(e)){let a={};for(let t in e)Object.prototype.hasOwnProperty.call(e,t)&&(!s||!s.some(r=>r.toString()===t.toString()))&&(a[t]=w(e[t]));let c=Object.getOwnPropertySymbols(e);for(let t of c)(!s||!s.some(r=>r.toString()===t.toString()))&&(a[t]=w(e[t]));return a}return e};var E=(e,s)=>e===s,O=(e,s)=>{if(e.length!==s.length)return!1;for(let a=0;a<e.length;a++)if(Array.isArray(e[a])&&Array.isArray(s[a])){if(!O(e[a],s[a]))return!1}else if(b(e[a])&&b(s[a])){if(!D(e[a],s[a]))return!1}else if(e[a]!==s[a])return!1;return!0},D=(e,s)=>{let a=Object.keys(e),c=Object.keys(s);if(a.length!==c.length)return!1;for(let t of a){if(!(t in s))return!1;let r=e[t],d=s[t];if(Array.isArray(r)&&Array.isArray(d)){if(!O(r,d))return!1}else if(b(r)&&b(d)){if(!D(r,d))return!1}else if(r!==d)return!1}return!0},P=(e,s,a={})=>{let{includeDeleted:c=!1,includeAdded:t=!0,deepArrayComparison:r=!0,equalityFn:d=E,preserveStructure:m=!1}=a;if(e==null&&s==null)return{};if(e==null)return t?{...s}:{};if(s==null){if(c){let u={};for(let A in e)u[A]=void 0;return u}return{}}if(!b(e)||!b(s))return d(e,s)?{}:s;let l={},f=new Set;for(let u in s){f.add(u);let A=e[u],S=s[u];if(!(u in e)){t&&(l[u]=S);continue}if(Array.isArray(A)&&Array.isArray(S)){r?O(A,S)?m&&(l[u]=void 0):l[u]=S:A!==S?l[u]=S:m&&(l[u]=void 0);continue}if(b(A)&&b(S)){let h=P(A,S,a);Object.keys(h).length>0?l[u]=h:m&&(l[u]=void 0);continue}d(A,S)?m&&(l[u]=void 0):l[u]=S}if(c)for(let u in e)f.has(u)||(l[u]=void 0);return l},C=(e,s,a={})=>{let c=[],t=[],r=[],d={},{includeDeleted:m=!1,includeAdded:l=!0,deepArrayComparison:f=!0,equalityFn:u=E}=a;if(Array.isArray(e)&&Array.isArray(s)){let h=Math.max(e.length,s.length),o=[],i=!1;for(let n=0;n<h;n++){let y=`[${n}]`;if(n>=e.length)c.push(y),o[n]=s[n],i=!0;else if(n>=s.length)t.push(y),i=!0;else{let p=e[n],g=s[n];b(p)&&b(g)||Array.isArray(p)&&Array.isArray(g)?C(p,g,a).hasChanges?(r.push(y),o[n]=g,i=!0):o[n]=p:u(p,g)?o[n]=p:(r.push(y),o[n]=g,i=!0)}}return{changes:i?o:{},added:c,deleted:t,modified:r,hasChanges:i||t.length>0}}let A=(h,o,i="")=>{let n={added:[],deleted:[],modified:[]};if(Array.isArray(h)&&Array.isArray(o)){let y=Math.max(h.length,o.length);for(let p=0;p<y;p++){let g=i?`${i}[${p}]`:`[${p}]`;if(p>=h.length)n.added.push(g);else if(p>=o.length)n.deleted.push(g);else{let T=h[p],x=o[p];if(b(T)&&b(x)){let k=A(T,x,g);n.added.push(...k.added),n.deleted.push(...k.deleted),n.modified.push(...k.modified)}else if(Array.isArray(T)&&Array.isArray(x)){let k=A(T,x,g);n.added.push(...k.added),n.deleted.push(...k.deleted),n.modified.push(...k.modified)}else T!==x&&n.modified.push(g)}}return n}if(b(h)&&b(o)){let y=new Set([...Object.keys(h||{}),...Object.keys(o||{})]);for(let p of y){let g=h?.[p],T=o?.[p],x=i?`${i}.${p}`:p;if(!(p in(h||{})))n.added.push(x);else if(!(p in(o||{})))n.deleted.push(x);else if(Array.isArray(g)&&Array.isArray(T)){if(!O(g,T)){let k=A(g,T,x);n.added.push(...k.added),n.deleted.push(...k.deleted),n.modified.push(...k.modified)}}else if(b(g)&&b(T)){let k=A(g,T,x);n.added.push(...k.added),n.deleted.push(...k.deleted),n.modified.push(...k.modified)}else g!==T&&n.modified.push(x)}}return n};if(e==null&&s==null)return{changes:{},added:c,deleted:t,modified:r,hasChanges:!1};if(e==null){if(l&&s)for(let h in s)c.push(h),d[h]=s[h];return{changes:d,added:c,deleted:t,modified:r,hasChanges:c.length>0}}if(s==null){if(m)for(let h in e)t.push(h),d[h]=void 0;return{changes:d,added:c,deleted:t,modified:r,hasChanges:t.length>0}}let S=new Set;for(let h in s){S.add(h);let o=e[h],i=s[h];if(!(h in e)){l&&(c.push(h),d[h]=i);continue}let n=!1;if(Array.isArray(o)&&Array.isArray(i)){if(n=f?!O(o,i):o!==i,n){let y=A(o,i,h);c.push(...y.added),t.push(...y.deleted),r.push(...y.modified),d[h]=i}}else if(b(o)&&b(i)){let y=P(o,i,a);if(n=Object.keys(y).length>0,n){let p=A(o,i,h);c.push(...p.added),t.push(...p.deleted),r.push(...p.modified),d[h]=y}}else n=!u(o,i),n&&(r.push(h),d[h]=i)}for(let h in e)S.has(h)||(t.push(h),d[h]=void 0);return{changes:d,added:c,deleted:t,modified:r,hasChanges:c.length>0||t.length>0||r.length>0}};function I(e){return!!(e&&(e.diff||e.changes)&&(e.modified||e.deleted||e.hasChanges))}var v=(e,s,a)=>{if(!I(s)){let n=s,y=a||!1;if(Array.isArray(e)&&Array.isArray(n)){let g=y?e:[...e];n.length<g.length&&(g.length=n.length);for(let T=0;T<n.length;T++){let x=n[T];x!==void 0&&(b(g[T])&&b(x)||Array.isArray(g[T])&&Array.isArray(x)?g[T]=v(g[T],x,y):g[T]=x)}return g}if(!b(e))return n;if(!b(n))return e;let p=y?e:{...e};for(let g in n){let T=n[g];T===void 0?delete p[g]:Array.isArray(p[g])&&Array.isArray(T)||b(p[g])&&b(T)?p[g]=v(p[g],T,y):p[g]=T}return p}let{diff:c,added:t=[],deleted:r=[],modified:d=[],changes:m,keepRef:l}=s,f=a!==void 0?a:l,u=m||c;if(!u)return e;let A=new Set(t),S=new Set(r),h=new Set(d),o=n=>{if(t.length===0&&r.length===0&&d.length===0)return!0;let y=n.split(/[.\[\]]+/).filter(Boolean);for(let p=0;p<=y.length;p++){let g=y.slice(0,p).join("."),T=y.slice(0,p).map((x,k)=>/^\d+$/.test(x)?`[${x}]`:k>0?`.${x}`:x).join("");if(A.has(g)||A.has(T)||S.has(g)||S.has(T)||h.has(g)||h.has(T))return!0}return!1};if(Array.isArray(e)&&Array.isArray(u)){let n=f?e:[...e];n.length=u.length;for(let y=0;y<u.length;y++){let p=`[${y}]`,g=u[y];g!==void 0&&o(p)&&(b(n[y])&&b(g)||Array.isArray(n[y])&&Array.isArray(g)?n[y]=v(n[y],g,f):n[y]=g)}return n}if(!b(e))return u;if(!b(u))return e;let i=f?e:{...e};for(let n of r)n.includes(".")||n.includes("[")||o(n)&&delete i[n];for(let n in u){let y=u[n];o(n)&&(y===void 0?delete i[n]:Array.isArray(i[n])&&Array.isArray(y)||b(i[n])&&b(y)?i[n]=v(i[n],y,f):i[n]=y)}return i};var j=(e,s={})=>{let{type:a="auto",throwOnError:c=!1}=s;if(!e||typeof e!="string")return[];let t=[],r="",d=!1,m=!1,l="",f="",u=0,S=a==="auto"?(o=>o.includes("..")?"descendant":o.includes("[?(")?"filter":o.includes("[:")||o.includes("[0:")?"slice":o.includes("[,")||o.includes("[0,1]")?"union":o.includes("[*]")||o.includes(".*.")?"wildcard":o.includes("[]")?"array-wildcard":o.includes("[")&&o.includes("]")?"bracket":"dot")(e):a,h=o=>{let i=o.trim();if(i==="*"||i==="")return{type:"wildcard",value:i===""?"[]":"*",raw:i===""?"[]":o};if(i==="[]")return{type:"wildcard",value:"[]",raw:o};if(/^-?\d+$/.test(i))return{type:"index",value:parseInt(i,10),raw:o};if(i.includes(":")){let n=i.split(":").map(g=>g.trim()),y=n[0]===""?0:parseInt(n[0],10),p=n[1]===""?1/0:parseInt(n[1],10);if(isNaN(y)||isNaN(p)){if(c)throw new Error(`Invalid slice notation: ${o}`);return{type:"wildcard",value:"*",raw:o}}return{type:"slice",value:[y,p],raw:o}}if(i.includes(",")){let n=i.split(",").map(y=>{let p=parseInt(y.trim(),10);return isNaN(p)?-1:p}).filter(y=>y>=0);if(n.length===0){if(c)throw new Error(`Invalid union notation: ${o}`);return{type:"wildcard",value:"*",raw:o}}return{type:"union",value:n,raw:o}}if(i.startsWith("?(")&&i.endsWith(")")){let n=i.slice(2,-1);try{return{type:"filter",value:F(n),raw:o}}catch(y){if(c)throw y;return{type:"wildcard",value:"*",raw:o}}}return i.startsWith('"')&&i.endsWith('"')||i.startsWith("'")&&i.endsWith("'")?{type:"property",value:i.slice(1,-1),raw:o}:{type:"property",value:i,raw:o}};for(let o=0;o<e.length;o++){let i=e[o],n=e[o+1];if((i==='"'||i==="'")&&!m){m=!0,l=i;continue}else if(i===l&&m){m=!1,l="",i==='"'||i==="'"||(d?f+=i:r+=i);continue}if(m){d?f+=i:r+=i;continue}if(i==="["&&!d){r&&(t.push({type:"property",value:r,raw:r}),r=""),d=!0,f="";continue}if(i==="]"&&d&&!m){d=!1;let p=h(f);t.push(p);continue}let y=t.length>0?t[t.length-1]:null;if(i==="."&&!d&&!m){if(n==="."){let p=e.split("..")[0];t.push({type:"property",value:p,raw:p}),t.push({type:"descendant",value:"..",raw:".."}),o++}else r&&(r==="*"?t.push({type:"wildcard",value:r,raw:r}):t.push({type:"property",value:r,raw:r}),r="");continue}if(d)f+=i;else if(y&&y.type!=="descendant")r+=i;else{let p=e.split(y?.raw)[1];p!==void 0?r=p:r+=i}}return r&&t.push({type:"property",value:r,raw:r}),t.map(o=>{if(o.type==="property"&&typeof o.value=="string"&&/^-?\d+$/.test(o.value)){let i=parseInt(o.value,10);if(!isNaN(i))return{...o,type:"index",value:i}}return o})},F=e=>{let s=e.replace(/@\.([a-zA-Z_$][\w$]*)/g,(a,c)=>`item.${c}`).replace(/@/g,"item");try{return new Function("item",`return ${s}`)}catch{throw new Error(`Invalid filter expression: ${e}`)}};function M(...e){if(e.length===0)return{};let s=e[0],a=Array.isArray(s);for(let t of e)if(t&&Array.isArray(t)!==a)throw new Error("Cannot mix arrays and objects in deepMerge");let c=a?[]:{};for(let t of e)if(t!=null)if(a){let r=c,d=t;for(let m of d)r.push(w(m))}else{if(!$(t))continue;let r=c,d=t;for(let l in d)if(Object.prototype.hasOwnProperty.call(d,l)){let f=d[l],u=r[l];u===void 0?r[l]=w(f):Array.isArray(f)&&Array.isArray(u)?r[l]=[...u,...f.map(A=>w(A))]:$(f)&&$(u)?r[l]=M(u,f):r[l]=w(f)}let m=Object.getOwnPropertySymbols(d);for(let l of m){let f=d[l],u=r[l];u===void 0?r[l]=w(f):Array.isArray(f)&&Array.isArray(u)?r[l]=[...u,...f.map(A=>w(A))]:$(f)&&$(u)?r[l]=M(u,f):r[l]=w(f)}}return c}function G(e,s,a){let{key:c,override:t=!0}=a||{};if(!c)return Array.from(new Set([...e,...s]));let r=new Map;for(let d of e)r.set(d[c],d);for(let d of s){let m=r.get(d[c]);m?r.set(d[c],t?{...m,...d}:{...d,...m}):r.set(d[c],d)}return Array.from(r.values())}function N(e,s){for(let a in s){let c=e[a],t=s[a],r=C(c,t);Array.isArray(c)&&Array.isArray(t)?(c.length=0,c.push(...t)):typeof c=="object"&&typeof t=="object"&&c&&t&&r.hasChanges?v(c,t):e[a]=t}}function R(e,...s){if(s.length===0)return w(e);let a={preserveTarget:!1,strict:!1},c=s,t=s[s.length-1];t&&typeof t=="object"&&("preserveTarget"in t||"strict"in t)&&(a={...a,...t},c=s.slice(0,-1));let r=a.preserveTarget?e:w(e),d=Array.isArray(r);for(let m of c)if(m&&Array.isArray(m)!==d)throw new Error("Cannot mix arrays and objects in deepMergeWithOptions");for(let m of c)if(m!=null)if(d){let l=r,f=m;if(a.strict)for(let u=0;u<l.length&&u<f.length;u++)$(l[u])&&$(f[u])?l[u]=R(l[u],f[u],a):typeof l[u]==typeof f[u]&&(l[u]=w(f[u]));else N(l,f)}else{if(!$(m))continue;let l=r,f=m;for(let A in f){if(!Object.prototype.hasOwnProperty.call(f,A))continue;let S=f[A];if(a.strict&&!(A in l))continue;let h=l[A];h===void 0?l[A]=w(S):Array.isArray(S)&&Array.isArray(h)?a.strict?l[A]=R(h,S,a):l[A]=[...h,...S.map(o=>w(o))]:$(S)&&$(h)?l[A]=R(h,S,a):l[A]=w(S)}let u=Object.getOwnPropertySymbols(f);for(let A of u){if(a.strict&&!(A in l))continue;let S=f[A],h=l[A];h===void 0?l[A]=w(S):Array.isArray(S)&&Array.isArray(h)?a.strict?l[A]=R(h,S,a):l[A]=[...h,...S.map(o=>w(o))]:$(S)&&$(h)?l[A]=R(h,S,a):l[A]=w(S)}}return r}function H(e,...s){return R(e,...s,{preserveTarget:!0})}function X(e,...s){let a=!1,c=s;return s.length>0&&typeof s[s.length-1]=="boolean"&&(a=s[s.length-1],c=s.slice(0,-1)),R(e,...c,{preserveTarget:a,strict:!0})}var Y=(e,s,a)=>{let c=j(s),t=e;for(let r=0;r<c.length;r++){let d=c[r],m=r===c.length-1;switch(d.type){case"property":if(m)t[String(d.value)]=a;else{if(!t[String(d.value)]){let f=c[r+1];t[String(d.value)]=f.type==="index"||f.type==="slice"||f.type==="union"||f.type==="wildcard"?[]:{}}t=t[String(d.value)]}break;case"index":Array.isArray(t)||(t=[]);let l=d.value;if(m){if(l>=t.length)for(let f=t.length;f<=l;f++)t.push(void 0);t[l]=a}else{if(!t[l]){let f=c[r+1];t[l]=f.type==="index"||f.type==="slice"||f.type==="union"||f.type==="wildcard"?[]:{}}t=t[l]}break;case"wildcard":if(Array.isArray(t))if(m)for(let f=0;f<t.length;f++)t[f]=a;else{let f=c[r+1];for(let u=0;u<t.length;u++)t[u]||(t[u]=f.type==="index"||f.type==="slice"||f.type==="union"||f.type==="wildcard"?[]:{});t.length>0&&(t=t[0])}break}}};export{H as deepMerge,H as deepMergeKeepReference,X as deepMergeStrict,R as deepMergeWithOptions,M as merge,G as mergeArrays,Y as mergeIntoStructure,X as mergeStrict,R as mergeWithOptions};

package/dist/lib/object/object.cjs

@@ -0,0 +1 @@
+"use strict";var l=Object.defineProperty;var d=Object.getOwnPropertyDescriptor;var p=Object.getOwnPropertyNames;var A=Object.prototype.hasOwnProperty;var g=(e,r)=>{for(var n in r)l(e,n,{get:r[n],enumerable:!0})},T=(e,r,n,t)=>{if(r&&typeof r=="object"||typeof r=="function")for(let s of p(r))!A.call(e,s)&&s!==n&&l(e,s,{get:()=>r[s],enumerable:!(t=d(r,s))||t.enumerable});return e};var O=e=>T(l({},"__esModule",{value:!0}),e);var h={};g(h,{clean:()=>y,deepFreeze:()=>u,defaults:()=>b,filter:()=>m,fromQueryString:()=>x,groupBy:()=>S,invert:()=>a,isNonNullObject:()=>$,size:()=>R,toQueryString:()=>w,transform:()=>k});module.exports=O(h);var i=e=>e==null||Array.isArray(e)||typeof e=="function"||e instanceof Date||e instanceof RegExp||e instanceof Map||e instanceof Set||e instanceof Error?!1:typeof e=="object";var f=(e,r)=>{if(e==null||typeof e!="object")return e;if(e instanceof Date)return new Date(e.getTime());if(e instanceof RegExp)return new RegExp(e.source,e.flags);if(e instanceof Map){let n=new Map;return e.forEach((t,s)=>{(!r||!r.some(o=>o.toString()===s.toString()))&&n.set(s,f(t))}),n}if(e instanceof Set){let n=new Set;return e.forEach(t=>{n.add(f(t))}),n}if(Array.isArray(e))return Array.from(e).map(n=>f(n));if(i(e)){let n={};for(let s in e)Object.prototype.hasOwnProperty.call(e,s)&&(!r||!r.some(o=>o.toString()===s.toString()))&&(n[s]=f(e[s]));let t=Object.getOwnPropertySymbols(e);for(let s of t)(!r||!r.some(o=>o.toString()===s.toString()))&&(n[s]=f(e[s]));return n}return e};var a=(e,r=!1)=>{if(Array.isArray(e))return e.map(t=>a(t,r));if(!i(e))return{};let n={};for(let t in e){let s=e[t];typeof s=="string"||typeof s=="number"||typeof s=="symbol"?n[s]=t:i(s)?r&&(n[t]=a(s,r)):Array.isArray(s)&&r&&(n[t]=s.map(o=>a(o,r)))}return n},m=(e,r)=>{if(Array.isArray(e))return e.filter(r);if(!i(e))return{};let n={};for(let t in e)r(e[t],t)&&(n[t]=e[t]);return n},y=(e,r=!1)=>{if(!i(e))return{};let n={};for(let t in e){let s=e[t];if(s!=null)if(r&&i(s)){let o=y(s,!0);Object.keys(o).length>0&&(n[t]=o)}else n[t]=s}return n},b=(e,r)=>{if(Array.isArray(e))return Array.isArray(r)?[...e,...r]:[...e,r];let n=f(e);for(let t in r)n[t]===void 0&&(n[t]=r[t]);return n},R=e=>i(e)?Object.keys(e).length:0,k=(e,r)=>{if(Array.isArray(e))return e.map(r);if(!i(e))return{};let n={};for(let t in e){let[s,o]=r(t,e[t]);n[s]=o}return n},S=(e,r)=>Array.isArray(e)?e.reduce((n,t)=>{let s=t[r];if(s==null)return n;let o=String(s);return n[o]||(n[o]=[]),n[o].push(t),n},{}):{},w=e=>{if(!i(e))return"";let r=[],n=(t,s)=>{s!=null&&(Array.isArray(s)?s.forEach(o=>{r.push(`${encodeURIComponent(t)}=${encodeURIComponent(o)}`)}):r.push(`${encodeURIComponent(t)}=${encodeURIComponent(s)}`))};for(let t in e)n(t,e[t]);return r.join("&")},x=e=>{if(!e||typeof e!="string")return{};let r=e.startsWith("?")?e.slice(1):e;if(!r)return{};let n={},t=r.split("&");for(let s of t){let[o,c]=s.split("=").map(decodeURIComponent);o&&(o in n?Array.isArray(n[o])?n[o].push(c||""):n[o]=[n[o],c||""]:n[o]=c||"")}return n},u=e=>{if(e==null||typeof e!="object")return e;Object.freeze(e);for(let n in e){let t=e[n];t!=null&&typeof t=="object"&&u(t)}let r=Object.getOwnPropertySymbols(e);for(let n of r){let t=e[n];t!=null&&typeof t=="object"&&u(t)}return e},$=e=>e!=null&&typeof e=="object"&&!Array.isArray(e);

package/dist/lib/object/object.d.ts

@@ -0,0 +1,128 @@
+import type { AnyObject, DeepReadonly, RecordObject } from './types.js';
+/**
+ * Inverts an object (swaps keys and values)
+ * @param obj - Source object
+ * @returns Inverted object
+ * @example
+ * invert({a: 1, b: 2}) // {1: 'a', 2: 'b'}
+ */
+export declare const invert: (obj: AnyObject, deep?: boolean) => AnyObject;
+/**
+ * Maps object values using a callback function
+ * @param obj - Source object
+ * @param callback - Mapping function
+ * @returns New object with mapped values
+ * @example
+ * mapValues({a: 1, b: 2}, (value) => value * 2) // {a: 2, b: 4}
+ */
+/**
+ * Maps object keys using a callback function
+ * @param obj - Source object
+ * @param callback - Mapping function
+ * @returns New object with mapped keys
+ * @example
+ * mapKeys({a: 1, b: 2}, (key) => key.toUpperCase()) // {A: 1, B: 2}
+ */
+/**
+ * Filters object properties using a predicate
+ * @param obj - Source object
+ * @param predicate - Filter function
+ * @returns New object with filtered properties
+ * @example
+ * filter({a: 1, b: 2, c: 3}, (value) => value > 1) // {b: 2, c: 3}
+ */
+export declare const filter: <T extends AnyObject>(obj: T, predicate: (value: T[keyof T], key: keyof T) => boolean) => T extends RecordObject ? Partial<T> : Partial<T>[];
+/**
+ * Flattens a nested object
+ * @param obj - Source object
+ * @param separator - Separator for nested keys (default: '.')
+ * @returns Flattened object
+ * @example
+ * flatten({a: {b: {c: 1}}, d: 2}) // {'a.b.c': 1, d: 2}
+ */
+/**
+ * Unflattens an object (reverse of flatten)
+ * @param obj - Source object
+ * @param separator - Separator used for nested keys (default: '.')
+ * @returns Unflattened object
+ * @example
+ * unflatten({'a.b.c': 1, d: 2}) // {a: {b: {c: 1}}, d: 2}
+ */
+/**
+ * Removes undefined or null properties from an object
+ * @param obj - Source object
+ * @param deep - Whether to clean recursively (default: false)
+ * @returns Cleaned object
+ * @example
+ * clean({a: 1, b: null, c: undefined, d: {e: null}}) // {a: 1, d: {}}
+ * clean({a: 1, b: null, d: {e: null}}, true) // {a: 1}
+ */
+export declare const clean: <T extends AnyObject>(obj: T, deep?: boolean) => Partial<T>;
+/**
+ * Creates a new object with default values
+ * @param defaults - Default values
+ * @param overrides - Override values
+ * @returns Merged object with defaults
+ * @example
+ * defaults({a: 1, b: 2}, {b: 3, c: 4}) // {a: 1, b: 3, c: 4}
+ */
+export declare const defaults: <T extends AnyObject, U extends AnyObject>(current: T, overrides: U) => T & U;
+/**
+ * Gets the size of an object (number of own enumerable properties)
+ * @param obj - Source object
+ * @returns Number of properties
+ * @example
+ * size({a: 1, b: 2, c: 3}) // 3
+ */
+export declare const size: (obj: AnyObject) => number;
+/**
+ * Creates a new object with the same keys but transformed values
+ * @param obj - Source object
+ * @param transformer - Transformation function
+ * @returns Transformed object
+ * @example
+ * transform({a: 1, b: 2}, (key, value) => ({[key]: value * 2})) // {a: 2, b: 4}
+ */
+export declare const transform: <T extends AnyObject>(obj: T, transformer: (key: keyof T, value: T[keyof T]) => [string, any]) => AnyObject;
+/**
+ * Groups an array of objects by a key
+ * @param array - Array of objects
+ * @param key - Key to group by
+ * @returns Grouped object
+ * @example
+ * groupBy([{type: 'a', value: 1}, {type: 'b', value: 2}, {type: 'a', value: 3}], 'type')
+ * // {a: [{type: 'a', value: 1}, {type: 'a', value: 3}], b: [{type: 'b', value: 2}]}
+ */
+export declare const groupBy: <T extends AnyObject>(array: T[], key: keyof T) => Record<string | number, T[]>;
+/**
+ * Converts an object to a query string
+ * @param obj - Source object
+ * @returns Query string
+ * @example
+ * toQueryString({a: 1, b: 'test', c: [1, 2, 3]}) // 'a=1&b=test&c=1&c=2&c=3'
+ */
+export declare const toQueryString: (obj: AnyObject) => string;
+/**
+ * Parses a query string to an object
+ * @param queryString - Query string
+ * @returns Parsed object
+ * @example
+ * fromQueryString('a=1&b=test&c=1&c=2&c=3') // {a: '1', b: 'test', c: ['1', '2', '3']}
+ */
+export declare const fromQueryString: (queryString: string) => AnyObject;
+/**
+ * Creates a frozen deep clone of an object
+ * @param obj - Source object
+ * @returns Deep frozen object
+ * @example
+ * const frozen = deepFreeze({a: {b: 1}})
+ * frozen.a.b = 2 // Error in strict mode
+ */
+export declare const deepFreeze: <T>(obj: T) => DeepReadonly<T>;
+/**
+ * Type guard for non-null object
+ * @param value - Value to check
+ * @returns True if value is a non-null object
+ */
+export declare const isNonNullObject: (value: unknown) => value is AnyObject;
+//# sourceMappingURL=object.d.ts.map

package/dist/lib/object/object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.d.ts","sourceRoot":"","sources":["../../../src/lib/object/object.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAIxE;;;;;;GAMG;AACH,eAAO,MAAM,MAAM,GAAI,KAAK,SAAS,EAAE,OAAM,OAAe,KAAG,SAgC9D,CAAC;AAEF;;;;;;;GAOG;AAqBH;;;;;;;GAOG;AAsBH;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM,GAAI,CAAC,SAAS,SAAS,EACxC,KAAK,CAAC,EACN,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,KAAK,OAAO,KACtD,CAAC,SAAS,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAiBlD,CAAC;AAEF;;;;;;;GAOG;AA+CH;;;;;;;GAOG;AA4DH;;;;;;;;GAQG;AACH,eAAO,MAAM,KAAK,GAAI,CAAC,SAAS,SAAS,EACvC,KAAK,CAAC,EACN,OAAM,OAAe,KACpB,OAAO,CAAC,CAAC,CAuBX,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,SAAS,SAAS,EAAE,CAAC,SAAS,SAAS,EAC/D,SAAS,CAAC,EACV,WAAW,CAAC,KACX,CAAC,GAAG,CAgBN,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,IAAI,GAAI,KAAK,SAAS,KAAG,MAMrC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,SAAS,SAAS,EAC3C,KAAK,CAAC,EACN,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,KAC9D,SAgBF,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,OAAO,GAAI,CAAC,SAAS,SAAS,EACzC,OAAO,CAAC,EAAE,EACV,KAAK,MAAM,CAAC,KACX,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,CAqB7B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,SAAS,KAAG,MAwB9C,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAAI,aAAa,MAAM,KAAG,SAkCrD,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,EAAE,KAAK,CAAC,KAAG,YAAY,CAAC,CAAC,CA4BpD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,SAEzD,CAAC"}