@vielzeug/toolkit 1.1.3 → 2.1.0

package/dist/object/diff.js

@@ -1,18 +1,20 @@
-import { isEqual as b } from "../typed/isEqual.js";
-import { isObject as r } from "../typed/isObject.js";
-function j(f, s, n = b) {
-  if (!f && !s) return {};
-  const o = {};
-  for (const t of /* @__PURE__ */ new Set([...Object.keys(f ?? {}), ...Object.keys(s ?? {})])) {
-    const e = f?.[t], i = s?.[t];
-    if (r(e) && r(i)) {
-      const c = j(e, i, n);
-      Object.keys(c).length > 0 && (o[t] = c);
-    } else n(e, i) || (o[t] = e);
-  }
-  return o;
+import { isEqual as e } from "../typed/isEqual.js";
+import { isObject as t } from "../typed/isObject.js";
+//#region src/object/diff.ts
+var n = Symbol("deleted");
+function r(i, a, o = e) {
+	if (!i && !a) return {};
+	let s = {};
+	for (let e of new Set([...Object.keys(i ?? {}), ...Object.keys(a ?? {})])) {
+		let c = i?.[e], l = a?.[e];
+		if (t(c) && t(l)) {
+			let t = r(c, l, o);
+			Object.keys(t).length > 0 && (s[e] = t);
+		} else o(c, l) || (s[e] = a != null && e in a && (i == null || !(e in i)) ? n : c);
+	}
+	return s;
 }
-export {
-  j as diff
-};
-//# sourceMappingURL=diff.js.map
+//#endregion
+export { n as DELETED, r as diff };
+
+//# sourceMappingURL=diff.js.map

package/dist/object/diff.js.map

@@ -1 +1 @@
-{"version":3,"file":"diff.js","sources":["../../src/object/diff.ts"],"sourcesContent":["import { isEqual } from '../typed/isEqual';\nimport { isObject } from '../typed/isObject';\nimport type { Obj } from '../types';\n\n/**\n * Computes the difference between two objects.\n *\n * @example\n * ```ts\n * const obj1 = { a: 1, b: 2, c: 3 };\n * const obj2 = { b: 2, c: 3, d: 4 };\n *\n * diff(obj1, obj2); // { d: 4 }\n * ```\n *\n * @param curr - The current object.\n * @param prev - The previous object.\n * @param [compareFn] - A custom function to compare values.\n * @returns An object containing new/modified properties.\n */\nexport function diff<T extends Obj>(\n  curr?: T,\n  prev?: T,\n  compareFn: (a: unknown, b: unknown) => boolean = isEqual,\n): Partial<T> {\n  if (!curr && !prev) return {} as Partial<T>;\n\n  const result: Record<string, unknown> = {};\n\n  for (const key of new Set([...Object.keys(curr ?? {}), ...Object.keys(prev ?? {})])) {\n    const _curr = curr?.[key];\n    const _prev = prev?.[key];\n\n    if (isObject(_curr) && isObject(_prev)) {\n      const nestedDiff = diff(_curr, _prev, compareFn) as Partial<T[keyof T]>;\n      if (Object.keys(nestedDiff).length > 0) {\n        result[key] = nestedDiff;\n      }\n    } else if (!compareFn(_curr, _prev)) {\n      result[key] = _curr;\n    }\n  }\n\n  return result as Partial<T>;\n}\n"],"names":["diff","curr","prev","compareFn","isEqual","result","key","_curr","_prev","isObject","nestedDiff"],"mappings":";;AAoBO,SAASA,EACdC,GACAC,GACAC,IAAiDC,GACrC;AACZ,MAAI,CAACH,KAAQ,CAACC,UAAa,CAAA;AAE3B,QAAMG,IAAkC,CAAA;AAExC,aAAWC,KAAO,oBAAI,IAAI,CAAC,GAAG,OAAO,KAAKL,KAAQ,CAAA,CAAE,GAAG,GAAG,OAAO,KAAKC,KAAQ,CAAA,CAAE,CAAC,CAAC,GAAG;AACnF,UAAMK,IAAQN,IAAOK,CAAG,GAClBE,IAAQN,IAAOI,CAAG;AAExB,QAAIG,EAASF,CAAK,KAAKE,EAASD,CAAK,GAAG;AACtC,YAAME,IAAaV,EAAKO,GAAOC,GAAOL,CAAS;AAC/C,MAAI,OAAO,KAAKO,CAAU,EAAE,SAAS,MACnCL,EAAOC,CAAG,IAAII;AAAA,IAElB,MAAA,CAAYP,EAAUI,GAAOC,CAAK,MAChCH,EAAOC,CAAG,IAAIC;AAAA,EAElB;AAEA,SAAOF;AACT;"}
+{"version":3,"file":"diff.js","names":[],"sources":["../../src/object/diff.ts"],"sourcesContent":["import type { Obj } from '../types';\n\nimport { isEqual } from '../typed/isEqual';\nimport { isObject } from '../typed/isObject';\n\n/** Sentinel value returned by `diff` when a key exists in `prev` but not in `curr`. */\nexport const DELETED: unique symbol = Symbol('deleted');\n\nexport type DiffResult<T extends Obj> = { [K in keyof T]?: T[K] | typeof DELETED };\n\n/**\n * Computes the difference between two objects.\n *\n * Keys present in `prev` but absent in `curr` are marked with the `DELETED` sentinel.\n *\n * @example\n * ```ts\n * import { diff, DELETED } from '@vielzeug/toolkit';\n *\n * diff({ a: 1, b: 2 }, { a: 1, b: 2, c: 3 }); // { c: DELETED }\n * diff({ a: 1, b: 99 }, { a: 1, b: 2 });       // { b: 99 }\n * ```\n *\n * @param curr - The current object.\n * @param prev - The previous object.\n * @param [compareFn] - A custom function to compare values.\n * @returns An object containing new/modified/deleted properties.\n */\nexport function diff<T extends Obj>(\n  curr?: T,\n  prev?: T,\n  compareFn: (a: unknown, b: unknown) => boolean = isEqual,\n): DiffResult<T> {\n  if (!curr && !prev) return {};\n\n  const result: Record<string, unknown> = {};\n\n  for (const key of new Set([...Object.keys(curr ?? {}), ...Object.keys(prev ?? {})])) {\n    const _curr = curr?.[key];\n    const _prev = prev?.[key];\n\n    if (isObject(_curr) && isObject(_prev)) {\n      const nestedDiff = diff(_curr as Obj, _prev as Obj, compareFn);\n\n      if (Object.keys(nestedDiff).length > 0) {\n        result[key] = nestedDiff;\n      }\n    } else if (!compareFn(_curr, _prev)) {\n      const wasDeleted = prev != null && key in prev && (curr == null || !(key in curr));\n\n      result[key] = wasDeleted ? DELETED : _curr;\n    }\n  }\n\n  return result as DiffResult<T>;\n}\n"],"mappings":";;;AAMA,IAAa,IAAyB,OAAO,UAAU;AAsBvD,SAAgB,EACd,GACA,GACA,IAAiD,GAClC;AACf,KAAI,CAAC,KAAQ,CAAC,EAAM,QAAO,EAAE;CAE7B,IAAM,IAAkC,EAAE;AAE1C,MAAK,IAAM,KAAO,IAAI,IAAI,CAAC,GAAG,OAAO,KAAK,KAAQ,EAAE,CAAC,EAAE,GAAG,OAAO,KAAK,KAAQ,EAAE,CAAC,CAAC,CAAC,EAAE;EACnF,IAAM,IAAQ,IAAO,IACf,IAAQ,IAAO;AAErB,MAAI,EAAS,EAAM,IAAI,EAAS,EAAM,EAAE;GACtC,IAAM,IAAa,EAAK,GAAc,GAAc,EAAU;AAE9D,GAAI,OAAO,KAAK,EAAW,CAAC,SAAS,MACnC,EAAO,KAAO;SAEN,EAAU,GAAO,EAAM,KAGjC,EAAO,KAFY,KAAQ,QAAQ,KAAO,MAAS,KAAQ,QAAQ,EAAE,KAAO,MAEjD,IAAU;;AAIzC,QAAO"}

package/dist/object/index.d.ts

@@ -0,0 +1,9 @@
+export * from './stash';
+export * from './diff';
+export * from './merge';
+export * from './parseJSON';
+export * from './path';
+export * from './proxy';
+export * from './prune';
+export * from './seek';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/object/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC"}

package/dist/object/merge.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("../typed/isArray.cjs"),f=require("../typed/isObject.cjs");function a(i="deep",...n){return n.length===0?{}:i==="shallow"?Object.assign({},...n):n.reduce((e,r)=>l(e,r,i),{})}function l(i,n,e){if(!f.isObject(n))return n;const r={...i};for(const c in n){if(!Object.hasOwn(n,c))continue;const t=n[c],u=r[c];r[c]=o.isArray(t)&&o.isArray(u)?b(u,t,e):f.isObject(t)&&f.isObject(u)?l(u,t,e):O(u,t,e)}return r}function b(i,n,e){return i?e==="arrayConcat"?i.concat(n):e==="arrayReplace"?n:Array.from(new Set([...i,...n])):n}function O(i,n,e){return typeof e=="function"?e(i,n):e==="lastWins"||n!==void 0?n:i}exports.merge=a;
-//# sourceMappingURL=merge.cjs.map
+const e=require(`../typed/isArray.cjs`),t=require(`../typed/isObject.cjs`);function n(e=`deep`,...t){return t.length===0?{}:e===`shallow`?Object.assign({},...t):t.reduce((t,n)=>a(t,n,e),{})}function r(...e){return n(`deep`,...e)}function i(...e){return n(`shallow`,...e)}function a(n,r,i){if(!t.isObject(r))return r;let c={...n};for(let n of Object.keys(r)){let l=r[n],u=c[n];c[n]=e.isArray(l)&&e.isArray(u)?o(u,l,i):t.isObject(l)&&t.isObject(u)?a(u,l,i):s(u,l,i)}return c}function o(e,t,n){return e?n===`arrayConcat`?e.concat(t):n===`arrayReplace`?t:[...e,...t]:t}function s(e,t,n){return typeof n==`function`?n(e,t):n===`lastWins`||t!==void 0?t:e}exports.deepMerge=r,exports.merge=n,exports.shallowMerge=i;
+//# sourceMappingURL=merge.cjs.map

package/dist/object/merge.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"merge.cjs","sources":["../../src/object/merge.ts"],"sourcesContent":["import { isArray } from '../typed/isArray';\nimport { isObject } from '../typed/isObject';\nimport type { Obj } from '../types';\n\n// #region MergeStrategy\ntype MergeStrategy =\n  | 'deep'\n  | 'shallow'\n  | 'lastWins'\n  | 'arrayConcat'\n  | 'arrayReplace'\n  // biome-ignore lint/suspicious/noExplicitAny: -\n  | ((target: any, source: any) => any);\n// #endregion MergeStrategy\n\ntype DeepMerge<T, U> = T extends Obj\n  ? U extends Obj\n    ? {\n        [K in keyof T | keyof U]: K extends keyof T\n          ? K extends keyof U\n            ? DeepMerge<T[K], U[K]>\n            : T[K]\n          : K extends keyof U\n            ? U[K]\n            : never;\n      }\n    : U\n  : U;\n\ntype Merge<T extends Obj[]> = T extends [infer First, ...infer Rest]\n  ? First extends Obj\n    ? Rest extends Obj[]\n      ? DeepMerge<First, Merge<Rest>>\n      : First\n    : Obj\n  : Obj;\n\n/**\n * Merges multiple objects based on a specified merge strategy.\n *\n * @example\n * ```ts\n * const obj1 = { a: 1, b: { x: 10, y: \"hello\" }, c: [1] };\n * const obj2 = { b: { y: 20, z: true }, c: [2] };\n * const obj3 = { d: false, c: [3] };\n *\n * merge(\"deep\", obj1, obj2, obj3); // { a: 1, b: { x: 10, y: 20, z: true }, c: [1, 2, 3], d: false }\n * merge(\"shallow\", obj1, obj2, obj3); // { a: 1, b: { y: 20, z: true }, c: [3], d: false }\n * ```\n *\n * @param [strategy='deep'] - The merging strategy to use.\n * @param items - The objects to merge.\n * @returns A new merged object.\n */\nexport function merge<T extends Obj[]>(strategy: MergeStrategy = 'deep', ...items: [...T]): Merge<T> {\n  if (items.length === 0) return {} as Merge<T>;\n\n  if (strategy === 'shallow') {\n    return Object.assign({}, ...items) as Merge<T>;\n  }\n\n  return items.reduce((acc, obj) => deepMerge(acc, obj, strategy) as unknown as Merge<T>, {} as Merge<T>);\n}\n\n/**\n * Deeply merges two objects based on the provided strategy.\n *\n * - Uses **direct property access** for performance.\n * - **Avoids redundant deep merging** where unnecessary.\n * - Optimized **array merging strategies**.\n *\n * @param target - The target object.\n * @param source - The source object.\n * @param strategy - The merge strategy.\n * @returns A new merged object.\n */\nfunction deepMerge<T extends Obj, U extends Obj>(target: T, source: U, strategy: MergeStrategy): DeepMerge<T, U> {\n  if (!isObject(source)) return source as DeepMerge<T, U>;\n\n  const result = { ...target } as DeepMerge<T, U>;\n\n  for (const key in source) {\n    if (!Object.hasOwn(source, key)) continue; // Prevent prototype pollution\n\n    const sourceValue = source[key];\n    const targetValue = result[key];\n\n    // biome-ignore lint/suspicious/noExplicitAny: -\n    (result as any)[key] =\n      isArray(sourceValue) && isArray(targetValue)\n        ? handleArrayMerge(targetValue, sourceValue, strategy)\n        : isObject(sourceValue) && isObject(targetValue)\n          ? deepMerge(targetValue, sourceValue, strategy)\n          : applyMergeStrategy(targetValue, sourceValue, strategy);\n  }\n\n  return result;\n}\n\n/**\n * Optimized array merge based on strategy.\n *\n * - `\"arrayConcat\"` → Concatenates arrays.\n * - `\"arrayReplace\"` → Replaces the existing array.\n * - Default: **Unique merge** (Set-based optimization).\n */\nfunction handleArrayMerge<T, U>(targetArray: T[] | undefined, sourceArray: U[], strategy: MergeStrategy): (T | U)[] {\n  if (!targetArray) return sourceArray;\n  // biome-ignore lint/suspicious/noExplicitAny: -\n  if (strategy === 'arrayConcat') return targetArray.concat(sourceArray as any);\n  if (strategy === 'arrayReplace') return sourceArray;\n  return Array.from(new Set([...targetArray, ...sourceArray])); // Unique merge\n}\n\n/**\n * Determines the appropriate value to assign based on the merge strategy.\n *\n * - `\"lastWins\"` → Overwrites with the latest value.\n * - Custom functions → Allows user-defined behavior.\n */\nfunction applyMergeStrategy<T, U>(target: T, source: U, strategy: MergeStrategy): T | U {\n  if (typeof strategy === 'function') return strategy(target, source);\n  return strategy === 'lastWins' || source !== undefined ? source : target;\n}\n"],"names":["merge","strategy","items","acc","obj","deepMerge","target","source","isObject","result","key","sourceValue","targetValue","isArray","handleArrayMerge","applyMergeStrategy","targetArray","sourceArray"],"mappings":"2JAsDO,SAASA,EAAuBC,EAA0B,UAAWC,EAAyB,CACnG,OAAIA,EAAM,SAAW,EAAU,CAAA,EAE3BD,IAAa,UACR,OAAO,OAAO,CAAA,EAAI,GAAGC,CAAK,EAG5BA,EAAM,OAAO,CAACC,EAAKC,IAAQC,EAAUF,EAAKC,EAAKH,CAAQ,EAA0B,EAAc,CACxG,CAcA,SAASI,EAAwCC,EAAWC,EAAWN,EAA0C,CAC/G,GAAI,CAACO,EAAAA,SAASD,CAAM,EAAG,OAAOA,EAE9B,MAAME,EAAS,CAAE,GAAGH,CAAA,EAEpB,UAAWI,KAAOH,EAAQ,CACxB,GAAI,CAAC,OAAO,OAAOA,EAAQG,CAAG,EAAG,SAEjC,MAAMC,EAAcJ,EAAOG,CAAG,EACxBE,EAAcH,EAAOC,CAAG,EAG7BD,EAAeC,CAAG,EACjBG,EAAAA,QAAQF,CAAW,GAAKE,EAAAA,QAAQD,CAAW,EACvCE,EAAiBF,EAAaD,EAAaV,CAAQ,EACnDO,EAAAA,SAASG,CAAW,GAAKH,EAAAA,SAASI,CAAW,EAC3CP,EAAUO,EAAaD,EAAaV,CAAQ,EAC5Cc,EAAmBH,EAAaD,EAAaV,CAAQ,CAC/D,CAEA,OAAOQ,CACT,CASA,SAASK,EAAuBE,EAA8BC,EAAkBhB,EAAoC,CAClH,OAAKe,EAEDf,IAAa,cAAsBe,EAAY,OAAOC,CAAkB,EACxEhB,IAAa,eAAuBgB,EACjC,MAAM,KAAK,IAAI,IAAI,CAAC,GAAGD,EAAa,GAAGC,CAAW,CAAC,CAAC,EAJlCA,CAK3B,CAQA,SAASF,EAAyBT,EAAWC,EAAWN,EAAgC,CACtF,OAAI,OAAOA,GAAa,WAAmBA,EAASK,EAAQC,CAAM,EAC3DN,IAAa,YAAcM,IAAW,OAAYA,EAASD,CACpE"}
+{"version":3,"file":"merge.cjs","names":[],"sources":["../../src/object/merge.ts"],"sourcesContent":["import type { Obj } from '../types';\n\nimport { isArray } from '../typed/isArray';\nimport { isObject } from '../typed/isObject';\n\n// #region MergeStrategy\ntype MergeStrategy =\n  | 'deep'\n  | 'shallow'\n  | 'lastWins'\n  | 'arrayConcat'\n  | 'arrayReplace'\n  | ((target: any, source: any) => any);\n// #endregion MergeStrategy\n\ntype DeepMerge<T, U> = T extends Obj\n  ? U extends Obj\n    ? {\n        [K in keyof T | keyof U]: K extends keyof T\n          ? K extends keyof U\n            ? DeepMerge<T[K], U[K]>\n            : T[K]\n          : K extends keyof U\n            ? U[K]\n            : never;\n      }\n    : U\n  : U;\n\ntype Merge<T extends Obj[]> = T extends [infer First, ...infer Rest]\n  ? First extends Obj\n    ? Rest extends Obj[]\n      ? DeepMerge<First, Merge<Rest>>\n      : First\n    : Obj\n  : Obj;\n\n/**\n * Merges multiple objects based on a specified merge strategy.\n *\n * @example\n * ```ts\n * const obj1 = { a: 1, b: { x: 10, y: \"hello\" }, c: [1] };\n * const obj2 = { b: { y: 20, z: true }, c: [2] };\n * const obj3 = { d: false, c: [3] };\n *\n * merge(\"deep\", obj1, obj2, obj3); // { a: 1, b: { x: 10, y: 20, z: true }, c: [1, 2, 3], d: false }\n * merge(\"shallow\", obj1, obj2, obj3); // { a: 1, b: { y: 20, z: true }, c: [3], d: false }\n * ```\n *\n * @param [strategy='deep'] - The merging strategy to use.\n * @param items - The objects to merge.\n * @returns A new merged object.\n */\nexport function merge<T extends Obj[]>(strategy: MergeStrategy = 'deep', ...items: [...T]): Merge<T> {\n  if (items.length === 0) return {} as Merge<T>;\n\n  if (strategy === 'shallow') {\n    return Object.assign({}, ...items) as Merge<T>;\n  }\n\n  return items.reduce((acc, obj) => mergeObjects(acc, obj, strategy) as unknown as Merge<T>, {} as Merge<T>);\n}\n\n/**\n * Merges objects deeply. Shorthand for `merge('deep', ...items)`.\n *\n * @example\n * ```ts\n * deepMerge({ a: { x: 1 } }, { a: { y: 2 } }); // { a: { x: 1, y: 2 } }\n * ```\n */\nexport function deepMerge<T extends Obj[]>(...items: [...T]): Merge<T> {\n  return merge('deep', ...items) as Merge<T>;\n}\n\n/**\n * Merges objects shallowly. Shorthand for `merge('shallow', ...items)`.\n *\n * @example\n * ```ts\n * shallowMerge({ a: 1, b: { x: 1 } }, { b: { y: 2 } }); // { a: 1, b: { y: 2 } }\n * ```\n */\nexport function shallowMerge<T extends Obj[]>(...items: [...T]): Merge<T> {\n  return merge('shallow', ...items) as Merge<T>;\n}\n\n/**\n * Deeply merges two objects based on the provided strategy.\n *\n * - Uses **direct property access** for performance.\n * - **Avoids redundant deep merging** where unnecessary.\n * - Optimized **array merging strategies**.\n *\n * @param target - The target object.\n * @param source - The source object.\n * @param strategy - The merge strategy.\n * @returns A new merged object.\n */\nfunction mergeObjects<T extends Obj, U extends Obj>(target: T, source: U, strategy: MergeStrategy): DeepMerge<T, U> {\n  if (!isObject(source)) return source as DeepMerge<T, U>;\n\n  const result = { ...target } as DeepMerge<T, U>;\n\n  for (const key of Object.keys(source)) {\n    const sourceValue = source[key];\n    const targetValue = result[key];\n\n    (result as any)[key] =\n      isArray(sourceValue) && isArray(targetValue)\n        ? handleArrayMerge(targetValue, sourceValue, strategy)\n        : isObject(sourceValue) && isObject(targetValue)\n          ? mergeObjects(targetValue as Obj, sourceValue as Obj, strategy)\n          : applyMergeStrategy(targetValue, sourceValue, strategy);\n  }\n\n  return result;\n}\n\n/**\n * Optimized array merge based on strategy.\n *\n * - `\"arrayConcat\"` → Concatenates arrays.\n * - `\"arrayReplace\"` → Replaces the existing array.\n * - Default: Concatenates arrays (same as `\"arrayConcat\"`).\n */\nfunction handleArrayMerge<T, U>(targetArray: T[] | undefined, sourceArray: U[], strategy: MergeStrategy): (T | U)[] {\n  if (!targetArray) return sourceArray;\n\n  if (strategy === 'arrayConcat') return targetArray.concat(sourceArray as any);\n\n  if (strategy === 'arrayReplace') return sourceArray;\n\n  return [...targetArray, ...sourceArray];\n}\n\n/**\n * Determines the appropriate value to assign based on the merge strategy.\n *\n * - `\"lastWins\"` → Overwrites with the latest value.\n * - Custom functions → Allows user-defined behavior.\n */\nfunction applyMergeStrategy<T, U>(target: T, source: U, strategy: MergeStrategy): T | U {\n  if (typeof strategy === 'function') return strategy(target, source);\n\n  return strategy === 'lastWins' || source !== undefined ? source : target;\n}\n"],"mappings":"2EAsDA,SAAgB,EAAuB,EAA0B,OAAQ,GAAG,EAAyB,CAOnG,OANI,EAAM,SAAW,EAAU,EAAE,CAE7B,IAAa,UACR,OAAO,OAAO,EAAE,CAAE,GAAG,EAAM,CAG7B,EAAM,QAAQ,EAAK,IAAQ,EAAa,EAAK,EAAK,EAAS,CAAyB,EAAE,CAAa,CAW5G,SAAgB,EAA2B,GAAG,EAAyB,CACrE,OAAO,EAAM,OAAQ,GAAG,EAAM,CAWhC,SAAgB,EAA8B,GAAG,EAAyB,CACxE,OAAO,EAAM,UAAW,GAAG,EAAM,CAenC,SAAS,EAA2C,EAAW,EAAW,EAA0C,CAClH,GAAI,CAAC,EAAA,SAAS,EAAO,CAAE,OAAO,EAE9B,IAAM,EAAS,CAAE,GAAG,EAAQ,CAE5B,IAAK,IAAM,KAAO,OAAO,KAAK,EAAO,CAAE,CACrC,IAAM,EAAc,EAAO,GACrB,EAAc,EAAO,GAE1B,EAAe,GACd,EAAA,QAAQ,EAAY,EAAI,EAAA,QAAQ,EAAY,CACxC,EAAiB,EAAa,EAAa,EAAS,CACpD,EAAA,SAAS,EAAY,EAAI,EAAA,SAAS,EAAY,CAC5C,EAAa,EAAoB,EAAoB,EAAS,CAC9D,EAAmB,EAAa,EAAa,EAAS,CAGhE,OAAO,EAUT,SAAS,EAAuB,EAA8B,EAAkB,EAAoC,CAOlH,OANK,EAED,IAAa,cAAsB,EAAY,OAAO,EAAmB,CAEzE,IAAa,eAAuB,EAEjC,CAAC,GAAG,EAAa,GAAG,EAAY,CANd,EAe3B,SAAS,EAAyB,EAAW,EAAW,EAAgC,CAGtF,OAFI,OAAO,GAAa,WAAmB,EAAS,EAAQ,EAAO,CAE5D,IAAa,YAAc,IAAW,IAAA,GAAY,EAAS"}

package/dist/object/merge.d.ts

@@ -0,0 +1,44 @@
+import type { Obj } from '../types';
+type MergeStrategy = 'deep' | 'shallow' | 'lastWins' | 'arrayConcat' | 'arrayReplace' | ((target: any, source: any) => any);
+type DeepMerge<T, U> = T extends Obj ? U extends Obj ? {
+    [K in keyof T | keyof U]: K extends keyof T ? K extends keyof U ? DeepMerge<T[K], U[K]> : T[K] : K extends keyof U ? U[K] : never;
+} : U : U;
+type Merge<T extends Obj[]> = T extends [infer First, ...infer Rest] ? First extends Obj ? Rest extends Obj[] ? DeepMerge<First, Merge<Rest>> : First : Obj : Obj;
+/**
+ * Merges multiple objects based on a specified merge strategy.
+ *
+ * @example
+ * ```ts
+ * const obj1 = { a: 1, b: { x: 10, y: "hello" }, c: [1] };
+ * const obj2 = { b: { y: 20, z: true }, c: [2] };
+ * const obj3 = { d: false, c: [3] };
+ *
+ * merge("deep", obj1, obj2, obj3); // { a: 1, b: { x: 10, y: 20, z: true }, c: [1, 2, 3], d: false }
+ * merge("shallow", obj1, obj2, obj3); // { a: 1, b: { y: 20, z: true }, c: [3], d: false }
+ * ```
+ *
+ * @param [strategy='deep'] - The merging strategy to use.
+ * @param items - The objects to merge.
+ * @returns A new merged object.
+ */
+export declare function merge<T extends Obj[]>(strategy?: MergeStrategy, ...items: [...T]): Merge<T>;
+/**
+ * Merges objects deeply. Shorthand for `merge('deep', ...items)`.
+ *
+ * @example
+ * ```ts
+ * deepMerge({ a: { x: 1 } }, { a: { y: 2 } }); // { a: { x: 1, y: 2 } }
+ * ```
+ */
+export declare function deepMerge<T extends Obj[]>(...items: [...T]): Merge<T>;
+/**
+ * Merges objects shallowly. Shorthand for `merge('shallow', ...items)`.
+ *
+ * @example
+ * ```ts
+ * shallowMerge({ a: 1, b: { x: 1 } }, { b: { y: 2 } }); // { a: 1, b: { y: 2 } }
+ * ```
+ */
+export declare function shallowMerge<T extends Obj[]>(...items: [...T]): Merge<T>;
+export {};
+//# sourceMappingURL=merge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../src/object/merge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAMpC,KAAK,aAAa,GACd,MAAM,GACN,SAAS,GACT,UAAU,GACV,aAAa,GACb,cAAc,GACd,CAAC,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,KAAK,GAAG,CAAC,CAAC;AAGxC,KAAK,SAAS,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,GAAG,GAChC,CAAC,SAAS,GAAG,GACX;KACG,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,SAAS,MAAM,CAAC,GACvC,CAAC,SAAS,MAAM,CAAC,GACf,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GACrB,CAAC,CAAC,CAAC,CAAC,GACN,CAAC,SAAS,MAAM,CAAC,GACf,CAAC,CAAC,CAAC,CAAC,GACJ,KAAK;CACZ,GACD,CAAC,GACH,CAAC,CAAC;AAEN,KAAK,KAAK,CAAC,CAAC,SAAS,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,GAChE,KAAK,SAAS,GAAG,GACf,IAAI,SAAS,GAAG,EAAE,GAChB,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,GAC7B,KAAK,GACP,GAAG,GACL,GAAG,CAAC;AAER;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,GAAG,EAAE,EAAE,QAAQ,GAAE,aAAsB,EAAE,GAAG,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAQnG;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,GAAG,EAAE,EAAE,GAAG,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAErE;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,GAAG,EAAE,EAAE,GAAG,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAExE"}

package/dist/object/merge.js

@@ -1,25 +1,31 @@
-import { isArray as c } from "../typed/isArray.js";
-import { isObject as u } from "../typed/isObject.js";
-function m(i = "deep", ...n) {
-  return n.length === 0 ? {} : i === "shallow" ? Object.assign({}, ...n) : n.reduce((e, r) => l(e, r, i), {});
+import { isArray as e } from "../typed/isArray.js";
+import { isObject as t } from "../typed/isObject.js";
+//#region src/object/merge.ts
+function n(e = "deep", ...t) {
+	return t.length === 0 ? {} : e === "shallow" ? Object.assign({}, ...t) : t.reduce((t, n) => a(t, n, e), {});
 }
-function l(i, n, e) {
-  if (!u(n)) return n;
-  const r = { ...i };
-  for (const o in n) {
-    if (!Object.hasOwn(n, o)) continue;
-    const f = n[o], t = r[o];
-    r[o] = c(f) && c(t) ? p(t, f, e) : u(f) && u(t) ? l(t, f, e) : a(t, f, e);
-  }
-  return r;
+function r(...e) {
+	return n("deep", ...e);
 }
-function p(i, n, e) {
-  return i ? e === "arrayConcat" ? i.concat(n) : e === "arrayReplace" ? n : Array.from(/* @__PURE__ */ new Set([...i, ...n])) : n;
+function i(...e) {
+	return n("shallow", ...e);
 }
-function a(i, n, e) {
-  return typeof e == "function" ? e(i, n) : e === "lastWins" || n !== void 0 ? n : i;
+function a(n, r, i) {
+	if (!t(r)) return r;
+	let c = { ...n };
+	for (let n of Object.keys(r)) {
+		let l = r[n], u = c[n];
+		c[n] = e(l) && e(u) ? o(u, l, i) : t(l) && t(u) ? a(u, l, i) : s(u, l, i);
+	}
+	return c;
 }
-export {
-  m as merge
-};
-//# sourceMappingURL=merge.js.map
+function o(e, t, n) {
+	return e ? n === "arrayConcat" ? e.concat(t) : n === "arrayReplace" ? t : [...e, ...t] : t;
+}
+function s(e, t, n) {
+	return typeof n == "function" ? n(e, t) : n === "lastWins" || t !== void 0 ? t : e;
+}
+//#endregion
+export { r as deepMerge, n as merge, i as shallowMerge };
+
+//# sourceMappingURL=merge.js.map

package/dist/object/merge.js.map

@@ -1 +1 @@
-{"version":3,"file":"merge.js","sources":["../../src/object/merge.ts"],"sourcesContent":["import { isArray } from '../typed/isArray';\nimport { isObject } from '../typed/isObject';\nimport type { Obj } from '../types';\n\n// #region MergeStrategy\ntype MergeStrategy =\n  | 'deep'\n  | 'shallow'\n  | 'lastWins'\n  | 'arrayConcat'\n  | 'arrayReplace'\n  // biome-ignore lint/suspicious/noExplicitAny: -\n  | ((target: any, source: any) => any);\n// #endregion MergeStrategy\n\ntype DeepMerge<T, U> = T extends Obj\n  ? U extends Obj\n    ? {\n        [K in keyof T | keyof U]: K extends keyof T\n          ? K extends keyof U\n            ? DeepMerge<T[K], U[K]>\n            : T[K]\n          : K extends keyof U\n            ? U[K]\n            : never;\n      }\n    : U\n  : U;\n\ntype Merge<T extends Obj[]> = T extends [infer First, ...infer Rest]\n  ? First extends Obj\n    ? Rest extends Obj[]\n      ? DeepMerge<First, Merge<Rest>>\n      : First\n    : Obj\n  : Obj;\n\n/**\n * Merges multiple objects based on a specified merge strategy.\n *\n * @example\n * ```ts\n * const obj1 = { a: 1, b: { x: 10, y: \"hello\" }, c: [1] };\n * const obj2 = { b: { y: 20, z: true }, c: [2] };\n * const obj3 = { d: false, c: [3] };\n *\n * merge(\"deep\", obj1, obj2, obj3); // { a: 1, b: { x: 10, y: 20, z: true }, c: [1, 2, 3], d: false }\n * merge(\"shallow\", obj1, obj2, obj3); // { a: 1, b: { y: 20, z: true }, c: [3], d: false }\n * ```\n *\n * @param [strategy='deep'] - The merging strategy to use.\n * @param items - The objects to merge.\n * @returns A new merged object.\n */\nexport function merge<T extends Obj[]>(strategy: MergeStrategy = 'deep', ...items: [...T]): Merge<T> {\n  if (items.length === 0) return {} as Merge<T>;\n\n  if (strategy === 'shallow') {\n    return Object.assign({}, ...items) as Merge<T>;\n  }\n\n  return items.reduce((acc, obj) => deepMerge(acc, obj, strategy) as unknown as Merge<T>, {} as Merge<T>);\n}\n\n/**\n * Deeply merges two objects based on the provided strategy.\n *\n * - Uses **direct property access** for performance.\n * - **Avoids redundant deep merging** where unnecessary.\n * - Optimized **array merging strategies**.\n *\n * @param target - The target object.\n * @param source - The source object.\n * @param strategy - The merge strategy.\n * @returns A new merged object.\n */\nfunction deepMerge<T extends Obj, U extends Obj>(target: T, source: U, strategy: MergeStrategy): DeepMerge<T, U> {\n  if (!isObject(source)) return source as DeepMerge<T, U>;\n\n  const result = { ...target } as DeepMerge<T, U>;\n\n  for (const key in source) {\n    if (!Object.hasOwn(source, key)) continue; // Prevent prototype pollution\n\n    const sourceValue = source[key];\n    const targetValue = result[key];\n\n    // biome-ignore lint/suspicious/noExplicitAny: -\n    (result as any)[key] =\n      isArray(sourceValue) && isArray(targetValue)\n        ? handleArrayMerge(targetValue, sourceValue, strategy)\n        : isObject(sourceValue) && isObject(targetValue)\n          ? deepMerge(targetValue, sourceValue, strategy)\n          : applyMergeStrategy(targetValue, sourceValue, strategy);\n  }\n\n  return result;\n}\n\n/**\n * Optimized array merge based on strategy.\n *\n * - `\"arrayConcat\"` → Concatenates arrays.\n * - `\"arrayReplace\"` → Replaces the existing array.\n * - Default: **Unique merge** (Set-based optimization).\n */\nfunction handleArrayMerge<T, U>(targetArray: T[] | undefined, sourceArray: U[], strategy: MergeStrategy): (T | U)[] {\n  if (!targetArray) return sourceArray;\n  // biome-ignore lint/suspicious/noExplicitAny: -\n  if (strategy === 'arrayConcat') return targetArray.concat(sourceArray as any);\n  if (strategy === 'arrayReplace') return sourceArray;\n  return Array.from(new Set([...targetArray, ...sourceArray])); // Unique merge\n}\n\n/**\n * Determines the appropriate value to assign based on the merge strategy.\n *\n * - `\"lastWins\"` → Overwrites with the latest value.\n * - Custom functions → Allows user-defined behavior.\n */\nfunction applyMergeStrategy<T, U>(target: T, source: U, strategy: MergeStrategy): T | U {\n  if (typeof strategy === 'function') return strategy(target, source);\n  return strategy === 'lastWins' || source !== undefined ? source : target;\n}\n"],"names":["merge","strategy","items","acc","obj","deepMerge","target","source","isObject","result","key","sourceValue","targetValue","isArray","handleArrayMerge","applyMergeStrategy","targetArray","sourceArray"],"mappings":";;AAsDO,SAASA,EAAuBC,IAA0B,WAAWC,GAAyB;AACnG,SAAIA,EAAM,WAAW,IAAU,CAAA,IAE3BD,MAAa,YACR,OAAO,OAAO,CAAA,GAAI,GAAGC,CAAK,IAG5BA,EAAM,OAAO,CAACC,GAAKC,MAAQC,EAAUF,GAAKC,GAAKH,CAAQ,GAA0B,EAAc;AACxG;AAcA,SAASI,EAAwCC,GAAWC,GAAWN,GAA0C;AAC/G,MAAI,CAACO,EAASD,CAAM,EAAG,QAAOA;AAE9B,QAAME,IAAS,EAAE,GAAGH,EAAA;AAEpB,aAAWI,KAAOH,GAAQ;AACxB,QAAI,CAAC,OAAO,OAAOA,GAAQG,CAAG,EAAG;AAEjC,UAAMC,IAAcJ,EAAOG,CAAG,GACxBE,IAAcH,EAAOC,CAAG;AAG7B,IAAAD,EAAeC,CAAG,IACjBG,EAAQF,CAAW,KAAKE,EAAQD,CAAW,IACvCE,EAAiBF,GAAaD,GAAaV,CAAQ,IACnDO,EAASG,CAAW,KAAKH,EAASI,CAAW,IAC3CP,EAAUO,GAAaD,GAAaV,CAAQ,IAC5Cc,EAAmBH,GAAaD,GAAaV,CAAQ;AAAA,EAC/D;AAEA,SAAOQ;AACT;AASA,SAASK,EAAuBE,GAA8BC,GAAkBhB,GAAoC;AAClH,SAAKe,IAEDf,MAAa,gBAAsBe,EAAY,OAAOC,CAAkB,IACxEhB,MAAa,iBAAuBgB,IACjC,MAAM,KAAK,oBAAI,IAAI,CAAC,GAAGD,GAAa,GAAGC,CAAW,CAAC,CAAC,IAJlCA;AAK3B;AAQA,SAASF,EAAyBT,GAAWC,GAAWN,GAAgC;AACtF,SAAI,OAAOA,KAAa,aAAmBA,EAASK,GAAQC,CAAM,IAC3DN,MAAa,cAAcM,MAAW,SAAYA,IAASD;AACpE;"}
+{"version":3,"file":"merge.js","names":[],"sources":["../../src/object/merge.ts"],"sourcesContent":["import type { Obj } from '../types';\n\nimport { isArray } from '../typed/isArray';\nimport { isObject } from '../typed/isObject';\n\n// #region MergeStrategy\ntype MergeStrategy =\n  | 'deep'\n  | 'shallow'\n  | 'lastWins'\n  | 'arrayConcat'\n  | 'arrayReplace'\n  | ((target: any, source: any) => any);\n// #endregion MergeStrategy\n\ntype DeepMerge<T, U> = T extends Obj\n  ? U extends Obj\n    ? {\n        [K in keyof T | keyof U]: K extends keyof T\n          ? K extends keyof U\n            ? DeepMerge<T[K], U[K]>\n            : T[K]\n          : K extends keyof U\n            ? U[K]\n            : never;\n      }\n    : U\n  : U;\n\ntype Merge<T extends Obj[]> = T extends [infer First, ...infer Rest]\n  ? First extends Obj\n    ? Rest extends Obj[]\n      ? DeepMerge<First, Merge<Rest>>\n      : First\n    : Obj\n  : Obj;\n\n/**\n * Merges multiple objects based on a specified merge strategy.\n *\n * @example\n * ```ts\n * const obj1 = { a: 1, b: { x: 10, y: \"hello\" }, c: [1] };\n * const obj2 = { b: { y: 20, z: true }, c: [2] };\n * const obj3 = { d: false, c: [3] };\n *\n * merge(\"deep\", obj1, obj2, obj3); // { a: 1, b: { x: 10, y: 20, z: true }, c: [1, 2, 3], d: false }\n * merge(\"shallow\", obj1, obj2, obj3); // { a: 1, b: { y: 20, z: true }, c: [3], d: false }\n * ```\n *\n * @param [strategy='deep'] - The merging strategy to use.\n * @param items - The objects to merge.\n * @returns A new merged object.\n */\nexport function merge<T extends Obj[]>(strategy: MergeStrategy = 'deep', ...items: [...T]): Merge<T> {\n  if (items.length === 0) return {} as Merge<T>;\n\n  if (strategy === 'shallow') {\n    return Object.assign({}, ...items) as Merge<T>;\n  }\n\n  return items.reduce((acc, obj) => mergeObjects(acc, obj, strategy) as unknown as Merge<T>, {} as Merge<T>);\n}\n\n/**\n * Merges objects deeply. Shorthand for `merge('deep', ...items)`.\n *\n * @example\n * ```ts\n * deepMerge({ a: { x: 1 } }, { a: { y: 2 } }); // { a: { x: 1, y: 2 } }\n * ```\n */\nexport function deepMerge<T extends Obj[]>(...items: [...T]): Merge<T> {\n  return merge('deep', ...items) as Merge<T>;\n}\n\n/**\n * Merges objects shallowly. Shorthand for `merge('shallow', ...items)`.\n *\n * @example\n * ```ts\n * shallowMerge({ a: 1, b: { x: 1 } }, { b: { y: 2 } }); // { a: 1, b: { y: 2 } }\n * ```\n */\nexport function shallowMerge<T extends Obj[]>(...items: [...T]): Merge<T> {\n  return merge('shallow', ...items) as Merge<T>;\n}\n\n/**\n * Deeply merges two objects based on the provided strategy.\n *\n * - Uses **direct property access** for performance.\n * - **Avoids redundant deep merging** where unnecessary.\n * - Optimized **array merging strategies**.\n *\n * @param target - The target object.\n * @param source - The source object.\n * @param strategy - The merge strategy.\n * @returns A new merged object.\n */\nfunction mergeObjects<T extends Obj, U extends Obj>(target: T, source: U, strategy: MergeStrategy): DeepMerge<T, U> {\n  if (!isObject(source)) return source as DeepMerge<T, U>;\n\n  const result = { ...target } as DeepMerge<T, U>;\n\n  for (const key of Object.keys(source)) {\n    const sourceValue = source[key];\n    const targetValue = result[key];\n\n    (result as any)[key] =\n      isArray(sourceValue) && isArray(targetValue)\n        ? handleArrayMerge(targetValue, sourceValue, strategy)\n        : isObject(sourceValue) && isObject(targetValue)\n          ? mergeObjects(targetValue as Obj, sourceValue as Obj, strategy)\n          : applyMergeStrategy(targetValue, sourceValue, strategy);\n  }\n\n  return result;\n}\n\n/**\n * Optimized array merge based on strategy.\n *\n * - `\"arrayConcat\"` → Concatenates arrays.\n * - `\"arrayReplace\"` → Replaces the existing array.\n * - Default: Concatenates arrays (same as `\"arrayConcat\"`).\n */\nfunction handleArrayMerge<T, U>(targetArray: T[] | undefined, sourceArray: U[], strategy: MergeStrategy): (T | U)[] {\n  if (!targetArray) return sourceArray;\n\n  if (strategy === 'arrayConcat') return targetArray.concat(sourceArray as any);\n\n  if (strategy === 'arrayReplace') return sourceArray;\n\n  return [...targetArray, ...sourceArray];\n}\n\n/**\n * Determines the appropriate value to assign based on the merge strategy.\n *\n * - `\"lastWins\"` → Overwrites with the latest value.\n * - Custom functions → Allows user-defined behavior.\n */\nfunction applyMergeStrategy<T, U>(target: T, source: U, strategy: MergeStrategy): T | U {\n  if (typeof strategy === 'function') return strategy(target, source);\n\n  return strategy === 'lastWins' || source !== undefined ? source : target;\n}\n"],"mappings":";;;AAsDA,SAAgB,EAAuB,IAA0B,QAAQ,GAAG,GAAyB;AAOnG,QANI,EAAM,WAAW,IAAU,EAAE,GAE7B,MAAa,YACR,OAAO,OAAO,EAAE,EAAE,GAAG,EAAM,GAG7B,EAAM,QAAQ,GAAK,MAAQ,EAAa,GAAK,GAAK,EAAS,EAAyB,EAAE,CAAa;;AAW5G,SAAgB,EAA2B,GAAG,GAAyB;AACrE,QAAO,EAAM,QAAQ,GAAG,EAAM;;AAWhC,SAAgB,EAA8B,GAAG,GAAyB;AACxE,QAAO,EAAM,WAAW,GAAG,EAAM;;AAenC,SAAS,EAA2C,GAAW,GAAW,GAA0C;AAClH,KAAI,CAAC,EAAS,EAAO,CAAE,QAAO;CAE9B,IAAM,IAAS,EAAE,GAAG,GAAQ;AAE5B,MAAK,IAAM,KAAO,OAAO,KAAK,EAAO,EAAE;EACrC,IAAM,IAAc,EAAO,IACrB,IAAc,EAAO;AAE1B,IAAe,KACd,EAAQ,EAAY,IAAI,EAAQ,EAAY,GACxC,EAAiB,GAAa,GAAa,EAAS,GACpD,EAAS,EAAY,IAAI,EAAS,EAAY,GAC5C,EAAa,GAAoB,GAAoB,EAAS,GAC9D,EAAmB,GAAa,GAAa,EAAS;;AAGhE,QAAO;;AAUT,SAAS,EAAuB,GAA8B,GAAkB,GAAoC;AAOlH,QANK,IAED,MAAa,gBAAsB,EAAY,OAAO,EAAmB,GAEzE,MAAa,iBAAuB,IAEjC,CAAC,GAAG,GAAa,GAAG,EAAY,GANd;;AAe3B,SAAS,EAAyB,GAAW,GAAW,GAAgC;AAGtF,QAFI,OAAO,KAAa,aAAmB,EAAS,GAAQ,EAAO,GAE5D,MAAa,cAAc,MAAW,KAAA,IAAY,IAAS"}

package/dist/object/parseJSON.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=require("../logit/dist/logit.cjs"),n=require("../typed/isNil.cjs"),u=require("../typed/isString.cjs");function l(e,s={}){const{defaultValue:t,reviver:a,validator:i,silent:o=!1}=s;if(!u.isString(e))return n.isNil(e)?t:e;try{const r=JSON.parse(e,a);if(i&&!i(r))throw new TypeError("Parsed JSON does not match the expected structure");return r??t}catch(r){return o||c.Logit.error("parseJSON() -> failed to parse object",r),t}}exports.parseJSON=l;
-//# sourceMappingURL=parseJSON.cjs.map
+const e=require(`../typed/isString.cjs`),t=require(`../typed/isNil.cjs`);function n(n,r={}){let{defaultValue:i,onError:a,reviver:o,validator:s}=r;if(!e.isString(n))return t.isNil(n)?i:n;try{let e=JSON.parse(n,o);if(s&&!s(e))throw TypeError(`Parsed JSON does not match the expected structure`);return e??i}catch(e){return a?.(e),i}}exports.parseJSON=n;
+//# sourceMappingURL=parseJSON.cjs.map

package/dist/object/parseJSON.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"parseJSON.cjs","sources":["../../src/object/parseJSON.ts"],"sourcesContent":["import { Logit } from '@vielzeug/logit';\nimport { isNil } from '../typed/isNil';\nimport { isString } from '../typed/isString';\n\ntype JSONValue = string | number | boolean | null | JSONValue[] | { [key: string]: JSONValue };\n\n// #region ParseJSONOptions\ntype ParseJSONOptions<T> = {\n  defaultValue?: T;\n  // biome-ignore lint/suspicious/noExplicitAny: -\n  reviver?: (key: string, value: any) => any;\n  // biome-ignore lint/suspicious/noExplicitAny: -\n  validator?: (value: any) => boolean;\n  silent?: boolean;\n};\n// #endregion ParseJSONOptions\n\n/**\n * Parses a JSON string and returns the resulting object.\n *\n * @example\n * ```ts\n * const json = '{\"a\":1,\"b\":2,\"c\":3}';\n * const result = parseJSON<Record<string, number>>(json, {\n *   defaultValue: { a: 0, b: 0, c: 0 },\n *   validator: (value) => Object.values(value).every(v => typeof v === 'number'),\n *   errorHandler: (err) => console.warn('Parsing failed:', err.message),\n *   silent: true\n * });\n * console.log(result); // { a: 1, b: 2, c: 3 }\n * ```\n *\n * @template T - The expected type of the parsed JSON.\n * @param json - The JSON string to parse. If not a string, it is returned as is.\n * @param options - Configuration options for parsing.\n *\n * @returns The parsed object if successful, otherwise the default value.\n */\nexport function parseJSON<T extends JSONValue>(json: unknown, options: ParseJSONOptions<T> = {}): T | undefined {\n  const { defaultValue, reviver, validator, silent = false } = options;\n\n  if (!isString(json)) return isNil(json) ? defaultValue : (json as T);\n\n  try {\n    const parsed = JSON.parse(json as string, reviver);\n\n    if (validator && !validator(parsed)) {\n      throw new TypeError('Parsed JSON does not match the expected structure');\n    }\n\n    return parsed ?? defaultValue;\n  } catch (err) {\n    if (!silent) {\n      Logit.error('parseJSON() -> failed to parse object', err);\n    }\n\n    return defaultValue;\n  }\n}\n"],"names":["parseJSON","json","options","defaultValue","reviver","validator","silent","isString","isNil","parsed","err","Logit"],"mappings":"8LAsCO,SAASA,EAA+BC,EAAeC,EAA+B,GAAmB,CAC9G,KAAM,CAAE,aAAAC,EAAc,QAAAC,EAAS,UAAAC,EAAW,OAAAC,EAAS,IAAUJ,EAE7D,GAAI,CAACK,EAAAA,SAASN,CAAI,SAAUO,EAAAA,MAAMP,CAAI,EAAIE,EAAgBF,EAE1D,GAAI,CACF,MAAMQ,EAAS,KAAK,MAAMR,EAAgBG,CAAO,EAEjD,GAAIC,GAAa,CAACA,EAAUI,CAAM,EAChC,MAAM,IAAI,UAAU,mDAAmD,EAGzE,OAAOA,GAAUN,CACnB,OAASO,EAAK,CACZ,OAAKJ,GACHK,QAAM,MAAM,wCAAyCD,CAAG,EAGnDP,CACT,CACF"}
+{"version":3,"file":"parseJSON.cjs","names":[],"sources":["../../src/object/parseJSON.ts"],"sourcesContent":["import { isNil } from '../typed/isNil';\nimport { isString } from '../typed/isString';\n\ntype JSONValue = string | number | boolean | null | JSONValue[] | { [key: string]: JSONValue };\n\n// #region ParseJSONOptions\ntype ParseJSONOptions<T> = {\n  defaultValue?: T;\n  onError?: (err: unknown) => void;\n  reviver?: (key: string, value: any) => any;\n  validator?: (value: any) => boolean;\n};\n// #endregion ParseJSONOptions\n\n/**\n * Parses a JSON string and returns the resulting object.\n *\n * @example\n * ```ts\n * const json = '{\"a\":1,\"b\":2,\"c\":3}';\n * const result = parseJSON<Record<string, number>>(json, {\n *   defaultValue: { a: 0, b: 0, c: 0 },\n *   validator: (value) => Object.values(value).every(v => typeof v === 'number'),\n *   onError: (err) => console.warn('Parsing failed:', err),\n * });\n * console.log(result); // { a: 1, b: 2, c: 3 }\n * ```\n *\n * @template T - The expected type of the parsed JSON.\n * @param json - The JSON string to parse. If not a string, it is returned as is.\n * @param options - Configuration options for parsing.\n *\n * @returns The parsed object if successful, otherwise the default value.\n */\nexport function parseJSON<T extends JSONValue>(json: unknown, options: ParseJSONOptions<T> = {}): T | undefined {\n  const { defaultValue, onError, reviver, validator } = options;\n\n  if (!isString(json)) return isNil(json) ? defaultValue : (json as T);\n\n  try {\n    const parsed = JSON.parse(json as string, reviver);\n\n    if (validator && !validator(parsed)) {\n      throw new TypeError('Parsed JSON does not match the expected structure');\n    }\n\n    return parsed ?? defaultValue;\n  } catch (err) {\n    onError?.(err);\n\n    return defaultValue;\n  }\n}\n"],"mappings":"yEAkCA,SAAgB,EAA+B,EAAe,EAA+B,EAAE,CAAiB,CAC9G,GAAM,CAAE,eAAc,UAAS,UAAS,aAAc,EAEtD,GAAI,CAAC,EAAA,SAAS,EAAK,CAAE,OAAO,EAAA,MAAM,EAAK,CAAG,EAAgB,EAE1D,GAAI,CACF,IAAM,EAAS,KAAK,MAAM,EAAgB,EAAQ,CAElD,GAAI,GAAa,CAAC,EAAU,EAAO,CACjC,MAAU,UAAU,oDAAoD,CAG1E,OAAO,GAAU,QACV,EAAK,CAGZ,OAFA,IAAU,EAAI,CAEP"}

package/dist/object/parseJSON.d.ts

@@ -0,0 +1,32 @@
+type JSONValue = string | number | boolean | null | JSONValue[] | {
+    [key: string]: JSONValue;
+};
+type ParseJSONOptions<T> = {
+    defaultValue?: T;
+    onError?: (err: unknown) => void;
+    reviver?: (key: string, value: any) => any;
+    validator?: (value: any) => boolean;
+};
+/**
+ * Parses a JSON string and returns the resulting object.
+ *
+ * @example
+ * ```ts
+ * const json = '{"a":1,"b":2,"c":3}';
+ * const result = parseJSON<Record<string, number>>(json, {
+ *   defaultValue: { a: 0, b: 0, c: 0 },
+ *   validator: (value) => Object.values(value).every(v => typeof v === 'number'),
+ *   onError: (err) => console.warn('Parsing failed:', err),
+ * });
+ * console.log(result); // { a: 1, b: 2, c: 3 }
+ * ```
+ *
+ * @template T - The expected type of the parsed JSON.
+ * @param json - The JSON string to parse. If not a string, it is returned as is.
+ * @param options - Configuration options for parsing.
+ *
+ * @returns The parsed object if successful, otherwise the default value.
+ */
+export declare function parseJSON<T extends JSONValue>(json: unknown, options?: ParseJSONOptions<T>): T | undefined;
+export {};
+//# sourceMappingURL=parseJSON.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parseJSON.d.ts","sourceRoot":"","sources":["../../src/object/parseJSON.ts"],"names":[],"mappings":"AAGA,KAAK,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAG/F,KAAK,gBAAgB,CAAC,CAAC,IAAI;IACzB,YAAY,CAAC,EAAE,CAAC,CAAC;IACjB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IACjC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,GAAG,CAAC;IAC3C,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC;CACrC,CAAC;AAGF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,GAAE,gBAAgB,CAAC,CAAC,CAAM,GAAG,CAAC,GAAG,SAAS,CAkB9G"}

package/dist/object/parseJSON.js

@@ -1,19 +1,18 @@
-import { Logit as p } from "../logit/dist/logit.js";
-import { isNil as f } from "../typed/isNil.js";
-import { isString as c } from "../typed/isString.js";
-function l(r, o = {}) {
-  const { defaultValue: t, reviver: a, validator: i, silent: s = !1 } = o;
-  if (!c(r)) return f(r) ? t : r;
-  try {
-    const e = JSON.parse(r, a);
-    if (i && !i(e))
-      throw new TypeError("Parsed JSON does not match the expected structure");
-    return e ?? t;
-  } catch (e) {
-    return s || p.error("parseJSON() -> failed to parse object", e), t;
-  }
+import { isString as e } from "../typed/isString.js";
+import { isNil as t } from "../typed/isNil.js";
+//#region src/object/parseJSON.ts
+function n(n, r = {}) {
+	let { defaultValue: i, onError: a, reviver: o, validator: s } = r;
+	if (!e(n)) return t(n) ? i : n;
+	try {
+		let e = JSON.parse(n, o);
+		if (s && !s(e)) throw TypeError("Parsed JSON does not match the expected structure");
+		return e ?? i;
+	} catch (e) {
+		return a?.(e), i;
+	}
 }
-export {
-  l as parseJSON
-};
-//# sourceMappingURL=parseJSON.js.map
+//#endregion
+export { n as parseJSON };
+
+//# sourceMappingURL=parseJSON.js.map

package/dist/object/parseJSON.js.map

@@ -1 +1 @@
-{"version":3,"file":"parseJSON.js","sources":["../../src/object/parseJSON.ts"],"sourcesContent":["import { Logit } from '@vielzeug/logit';\nimport { isNil } from '../typed/isNil';\nimport { isString } from '../typed/isString';\n\ntype JSONValue = string | number | boolean | null | JSONValue[] | { [key: string]: JSONValue };\n\n// #region ParseJSONOptions\ntype ParseJSONOptions<T> = {\n  defaultValue?: T;\n  // biome-ignore lint/suspicious/noExplicitAny: -\n  reviver?: (key: string, value: any) => any;\n  // biome-ignore lint/suspicious/noExplicitAny: -\n  validator?: (value: any) => boolean;\n  silent?: boolean;\n};\n// #endregion ParseJSONOptions\n\n/**\n * Parses a JSON string and returns the resulting object.\n *\n * @example\n * ```ts\n * const json = '{\"a\":1,\"b\":2,\"c\":3}';\n * const result = parseJSON<Record<string, number>>(json, {\n *   defaultValue: { a: 0, b: 0, c: 0 },\n *   validator: (value) => Object.values(value).every(v => typeof v === 'number'),\n *   errorHandler: (err) => console.warn('Parsing failed:', err.message),\n *   silent: true\n * });\n * console.log(result); // { a: 1, b: 2, c: 3 }\n * ```\n *\n * @template T - The expected type of the parsed JSON.\n * @param json - The JSON string to parse. If not a string, it is returned as is.\n * @param options - Configuration options for parsing.\n *\n * @returns The parsed object if successful, otherwise the default value.\n */\nexport function parseJSON<T extends JSONValue>(json: unknown, options: ParseJSONOptions<T> = {}): T | undefined {\n  const { defaultValue, reviver, validator, silent = false } = options;\n\n  if (!isString(json)) return isNil(json) ? defaultValue : (json as T);\n\n  try {\n    const parsed = JSON.parse(json as string, reviver);\n\n    if (validator && !validator(parsed)) {\n      throw new TypeError('Parsed JSON does not match the expected structure');\n    }\n\n    return parsed ?? defaultValue;\n  } catch (err) {\n    if (!silent) {\n      Logit.error('parseJSON() -> failed to parse object', err);\n    }\n\n    return defaultValue;\n  }\n}\n"],"names":["parseJSON","json","options","defaultValue","reviver","validator","silent","isString","isNil","parsed","err","Logit"],"mappings":";;;AAsCO,SAASA,EAA+BC,GAAeC,IAA+B,IAAmB;AAC9G,QAAM,EAAE,cAAAC,GAAc,SAAAC,GAAS,WAAAC,GAAW,QAAAC,IAAS,OAAUJ;AAE7D,MAAI,CAACK,EAASN,CAAI,UAAUO,EAAMP,CAAI,IAAIE,IAAgBF;AAE1D,MAAI;AACF,UAAMQ,IAAS,KAAK,MAAMR,GAAgBG,CAAO;AAEjD,QAAIC,KAAa,CAACA,EAAUI,CAAM;AAChC,YAAM,IAAI,UAAU,mDAAmD;AAGzE,WAAOA,KAAUN;AAAA,EACnB,SAASO,GAAK;AACZ,WAAKJ,KACHK,EAAM,MAAM,yCAAyCD,CAAG,GAGnDP;AAAA,EACT;AACF;"}
+{"version":3,"file":"parseJSON.js","names":[],"sources":["../../src/object/parseJSON.ts"],"sourcesContent":["import { isNil } from '../typed/isNil';\nimport { isString } from '../typed/isString';\n\ntype JSONValue = string | number | boolean | null | JSONValue[] | { [key: string]: JSONValue };\n\n// #region ParseJSONOptions\ntype ParseJSONOptions<T> = {\n  defaultValue?: T;\n  onError?: (err: unknown) => void;\n  reviver?: (key: string, value: any) => any;\n  validator?: (value: any) => boolean;\n};\n// #endregion ParseJSONOptions\n\n/**\n * Parses a JSON string and returns the resulting object.\n *\n * @example\n * ```ts\n * const json = '{\"a\":1,\"b\":2,\"c\":3}';\n * const result = parseJSON<Record<string, number>>(json, {\n *   defaultValue: { a: 0, b: 0, c: 0 },\n *   validator: (value) => Object.values(value).every(v => typeof v === 'number'),\n *   onError: (err) => console.warn('Parsing failed:', err),\n * });\n * console.log(result); // { a: 1, b: 2, c: 3 }\n * ```\n *\n * @template T - The expected type of the parsed JSON.\n * @param json - The JSON string to parse. If not a string, it is returned as is.\n * @param options - Configuration options for parsing.\n *\n * @returns The parsed object if successful, otherwise the default value.\n */\nexport function parseJSON<T extends JSONValue>(json: unknown, options: ParseJSONOptions<T> = {}): T | undefined {\n  const { defaultValue, onError, reviver, validator } = options;\n\n  if (!isString(json)) return isNil(json) ? defaultValue : (json as T);\n\n  try {\n    const parsed = JSON.parse(json as string, reviver);\n\n    if (validator && !validator(parsed)) {\n      throw new TypeError('Parsed JSON does not match the expected structure');\n    }\n\n    return parsed ?? defaultValue;\n  } catch (err) {\n    onError?.(err);\n\n    return defaultValue;\n  }\n}\n"],"mappings":";;;AAkCA,SAAgB,EAA+B,GAAe,IAA+B,EAAE,EAAiB;CAC9G,IAAM,EAAE,iBAAc,YAAS,YAAS,iBAAc;AAEtD,KAAI,CAAC,EAAS,EAAK,CAAE,QAAO,EAAM,EAAK,GAAG,IAAgB;AAE1D,KAAI;EACF,IAAM,IAAS,KAAK,MAAM,GAAgB,EAAQ;AAElD,MAAI,KAAa,CAAC,EAAU,EAAO,CACjC,OAAU,UAAU,oDAAoD;AAG1E,SAAO,KAAU;UACV,GAAK;AAGZ,SAFA,IAAU,EAAI,EAEP"}

package/dist/object/path.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l=require("../function/assert.cjs"),p=require("../typed/isArray.cjs"),y=require("../typed/isNil.cjs"),i=require("../typed/isObject.cjs");function d(e,n,o,c={}){l.assert(i.isObject(e),i.IS_OBJECT_ERROR_MSG,{args:{item:e},type:TypeError});const{throwOnMissing:s=!1,allowArrayIndex:f=!1}=c,u=n.split(/[.[\]]+/).filter(Boolean);let r=e;for(const t of u){if(y.isNil(r)||typeof r!="object")return a(`Cannot read property '${t}' of ${r}`,s,o);if(r=f&&p.isArray(r)&&/^\d+$/.test(t)?r[Number(t)]:r[t],r===void 0)return a(`Property '${t}' does not exist`,s,o)}return r}function a(e,n,o){if(n)throw new Error(e);return o}exports.path=d;
-//# sourceMappingURL=path.cjs.map
+const e=require(`../function/assert.cjs`),t=require(`../typed/isNil.cjs`),n=require(`../typed/isObject.cjs`);function r(r,i,a,o={}){e.assert(n.isObject(r),n.IS_OBJECT_ERROR_MSG,{args:{item:r},type:TypeError});let{throwOnMissing:s=!1}=o,c=i.split(/[.[\]]+/).filter(Boolean),l=r;for(let e of c){if(t.isNil(l)||typeof l!=`object`){if(s)throw Error(`Cannot read property '${e}' of ${l}`);return a}if(l=l[e],l===void 0){if(s)throw Error(`Property '${e}' does not exist`);return a}}return l}exports.get=r;
+//# sourceMappingURL=path.cjs.map

package/dist/object/path.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"path.cjs","sources":["../../src/object/path.ts"],"sourcesContent":["import { assert } from '../function/assert';\nimport { isArray } from '../typed/isArray';\nimport { isNil } from '../typed/isNil';\nimport { IS_OBJECT_ERROR_MSG, isObject } from '../typed/isObject';\nimport type { Obj } from '../types';\n\ntype PathValue<T, P extends string> = P extends `${infer Key}.${infer Rest}`\n  ? Key extends keyof T\n    ? PathValue<T[Key], Rest>\n    : undefined\n  : P extends keyof T\n    ? T[P]\n    : undefined;\n\n// #region PathOptions\ntype PathOptions = {\n  throwOnMissing?: boolean;\n  allowArrayIndex?: boolean;\n};\n// #endregion PathOptions\n\n/**\n * Retrieves the value at a given path of the object. If the value is undefined, the default value is returned.\n *\n * @example\n * ```ts\n * const obj = { a: { b: { c: 3 } }, d: [1, 2, 3] };\n *\n * getValue(obj, 'a.b.c'); // 3\n * getValue(obj, 'a.b.d', 'default'); // 'default'\n * getValue(obj, 'd[1]', undefined, { allowArrayIndex: true }); // 2\n * getValue(obj, 'e.f.g', 'default', { throwOnMissing: true }); // throws Error\n * ```\n *\n * @template T - The type of the object to query.\n * @template P - The type of the path string.\n * @param item - The object to query.\n * @param path - The path of the property to get.\n * @param [defaultValue] - The value returned for undefined resolved values.\n * @param [options] - Additional options for value retrieval.\n *\n * @returns The resolved value.\n *\n * @throws If throwOnMissing is true and the path doesn't exist.\n */\nexport function path<T extends Obj, P extends string>(\n  item: T,\n  path: P,\n  defaultValue?: unknown,\n  options: PathOptions = {},\n): PathValue<T, P> | undefined {\n  assert(isObject(item), IS_OBJECT_ERROR_MSG, { args: { item }, type: TypeError });\n\n  const { throwOnMissing = false, allowArrayIndex = false } = options;\n\n  const fragments = path.split(/[.[\\]]+/).filter(Boolean);\n  // biome-ignore lint/suspicious/noExplicitAny: -\n  let current: any = item;\n\n  for (const fragment of fragments) {\n    if (isNil(current) || typeof current !== 'object') {\n      return handleError(`Cannot read property '${fragment}' of ${current}`, throwOnMissing, defaultValue);\n    }\n\n    current =\n      allowArrayIndex && isArray(current) && /^\\d+$/.test(fragment) ? current[Number(fragment)] : current[fragment];\n\n    if (current === undefined) {\n      return handleError(`Property '${fragment}' does not exist`, throwOnMissing, defaultValue);\n    }\n  }\n\n  return current as PathValue<T, P>;\n}\n\nfunction handleError<T extends Obj, P extends string>(\n  message: string,\n  throwOnMissing: boolean,\n  defaultValue?: unknown,\n): PathValue<T, P> | undefined {\n  if (throwOnMissing) throw new Error(message);\n  return defaultValue as PathValue<T, P>;\n}\n"],"names":["path","item","defaultValue","options","assert","isObject","IS_OBJECT_ERROR_MSG","throwOnMissing","allowArrayIndex","fragments","current","fragment","isNil","handleError","isArray","message"],"mappings":"+NA6CO,SAASA,EACdC,EACAD,EACAE,EACAC,EAAuB,CAAA,EACM,CAC7BC,EAAAA,OAAOC,EAAAA,SAASJ,CAAI,EAAGK,sBAAqB,CAAE,KAAM,CAAE,KAAAL,CAAA,EAAQ,KAAM,UAAW,EAE/E,KAAM,CAAE,eAAAM,EAAiB,GAAO,gBAAAC,EAAkB,IAAUL,EAEtDM,EAAYT,EAAK,MAAM,SAAS,EAAE,OAAO,OAAO,EAEtD,IAAIU,EAAeT,EAEnB,UAAWU,KAAYF,EAAW,CAChC,GAAIG,EAAAA,MAAMF,CAAO,GAAK,OAAOA,GAAY,SACvC,OAAOG,EAAY,yBAAyBF,CAAQ,QAAQD,CAAO,GAAIH,EAAgBL,CAAY,EAMrG,GAHAQ,EACEF,GAAmBM,EAAAA,QAAQJ,CAAO,GAAK,QAAQ,KAAKC,CAAQ,EAAID,EAAQ,OAAOC,CAAQ,CAAC,EAAID,EAAQC,CAAQ,EAE1GD,IAAY,OACd,OAAOG,EAAY,aAAaF,CAAQ,mBAAoBJ,EAAgBL,CAAY,CAE5F,CAEA,OAAOQ,CACT,CAEA,SAASG,EACPE,EACAR,EACAL,EAC6B,CAC7B,GAAIK,EAAgB,MAAM,IAAI,MAAMQ,CAAO,EAC3C,OAAOb,CACT"}
+{"version":3,"file":"path.cjs","names":[],"sources":["../../src/object/path.ts"],"sourcesContent":["import type { Obj } from '../types';\n\nimport { assert } from '../function/assert';\nimport { isNil } from '../typed/isNil';\nimport { IS_OBJECT_ERROR_MSG, isObject } from '../typed/isObject';\n\ntype PathValue<T, P extends string> = P extends `${infer Key}.${infer Rest}`\n  ? Key extends keyof T\n    ? PathValue<T[Key], Rest>\n    : undefined\n  : P extends keyof T\n    ? T[P]\n    : undefined;\n\n// #region PathOptions\ntype PathOptions = {\n  throwOnMissing?: boolean;\n};\n// #endregion PathOptions\n\n/**\n * Retrieves the value at a given path of the object. If the value is undefined, the default value is returned.\n *\n * @example\n * ```ts\n * const obj = { a: { b: { c: 3 } }, d: [1, 2, 3] };\n *\n * getValue(obj, 'a.b.c'); // 3\n * getValue(obj, 'a.b.d', 'default'); // 'default'\n * getValue(obj, 'd[1]'); // 2\n * getValue(obj, 'e.f.g', 'default', { throwOnMissing: true }); // throws Error\n * ```\n *\n * @template T - The type of the object to query.\n * @template P - The type of the path string.\n * @param item - The object to query.\n * @param path - The dot-separated path of the property to get.\n * @param [defaultValue] - The value returned for undefined resolved values.\n * @param [options] - Additional options for value retrieval.\n *\n * @returns The resolved value.\n *\n * @throws If throwOnMissing is true and the path doesn't exist.\n */\nexport function get<T extends Obj, P extends string>(\n  item: T,\n  path: P,\n  defaultValue?: unknown,\n  options: PathOptions = {},\n): PathValue<T, P> | undefined {\n  assert(isObject(item), IS_OBJECT_ERROR_MSG, { args: { item }, type: TypeError });\n\n  const { throwOnMissing = false } = options;\n\n  const fragments = path.split(/[.[\\]]+/).filter(Boolean);\n  let current: any = item;\n\n  for (const fragment of fragments) {\n    if (isNil(current) || typeof current !== 'object') {\n      if (throwOnMissing) throw new Error(`Cannot read property '${fragment}' of ${current}`);\n\n      return defaultValue as PathValue<T, P>;\n    }\n\n    current = current[fragment];\n\n    if (current === undefined) {\n      if (throwOnMissing) throw new Error(`Property '${fragment}' does not exist`);\n\n      return defaultValue as PathValue<T, P>;\n    }\n  }\n\n  return current as PathValue<T, P>;\n}\n"],"mappings":"6GA4CA,SAAgB,EACd,EACA,EACA,EACA,EAAuB,EAAE,CACI,CAC7B,EAAA,OAAO,EAAA,SAAS,EAAK,CAAE,EAAA,oBAAqB,CAAE,KAAM,CAAE,OAAM,CAAE,KAAM,UAAW,CAAC,CAEhF,GAAM,CAAE,iBAAiB,IAAU,EAE7B,EAAY,EAAK,MAAM,UAAU,CAAC,OAAO,QAAQ,CACnD,EAAe,EAEnB,IAAK,IAAM,KAAY,EAAW,CAChC,GAAI,EAAA,MAAM,EAAQ,EAAI,OAAO,GAAY,SAAU,CACjD,GAAI,EAAgB,MAAU,MAAM,yBAAyB,EAAS,OAAO,IAAU,CAEvF,OAAO,EAKT,GAFA,EAAU,EAAQ,GAEd,IAAY,IAAA,GAAW,CACzB,GAAI,EAAgB,MAAU,MAAM,aAAa,EAAS,kBAAkB,CAE5E,OAAO,GAIX,OAAO"}

package/dist/object/path.d.ts

@@ -0,0 +1,32 @@
+import type { Obj } from '../types';
+type PathValue<T, P extends string> = P extends `${infer Key}.${infer Rest}` ? Key extends keyof T ? PathValue<T[Key], Rest> : undefined : P extends keyof T ? T[P] : undefined;
+type PathOptions = {
+    throwOnMissing?: boolean;
+};
+/**
+ * Retrieves the value at a given path of the object. If the value is undefined, the default value is returned.
+ *
+ * @example
+ * ```ts
+ * const obj = { a: { b: { c: 3 } }, d: [1, 2, 3] };
+ *
+ * getValue(obj, 'a.b.c'); // 3
+ * getValue(obj, 'a.b.d', 'default'); // 'default'
+ * getValue(obj, 'd[1]'); // 2
+ * getValue(obj, 'e.f.g', 'default', { throwOnMissing: true }); // throws Error
+ * ```
+ *
+ * @template T - The type of the object to query.
+ * @template P - The type of the path string.
+ * @param item - The object to query.
+ * @param path - The dot-separated path of the property to get.
+ * @param [defaultValue] - The value returned for undefined resolved values.
+ * @param [options] - Additional options for value retrieval.
+ *
+ * @returns The resolved value.
+ *
+ * @throws If throwOnMissing is true and the path doesn't exist.
+ */
+export declare function get<T extends Obj, P extends string>(item: T, path: P, defaultValue?: unknown, options?: PathOptions): PathValue<T, P> | undefined;
+export {};
+//# sourceMappingURL=path.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/object/path.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAMpC,KAAK,SAAS,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,GAAG,MAAM,GAAG,IAAI,MAAM,IAAI,EAAE,GACxE,GAAG,SAAS,MAAM,CAAC,GACjB,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,GACvB,SAAS,GACX,CAAC,SAAS,MAAM,CAAC,GACf,CAAC,CAAC,CAAC,CAAC,GACJ,SAAS,CAAC;AAGhB,KAAK,WAAW,GAAG;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAGF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,GAAG,CAAC,CAAC,SAAS,GAAG,EAAE,CAAC,SAAS,MAAM,EACjD,IAAI,EAAE,CAAC,EACP,IAAI,EAAE,CAAC,EACP,YAAY,CAAC,EAAE,OAAO,EACtB,OAAO,GAAE,WAAgB,GACxB,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,CAyB7B"}

package/dist/object/path.js

@@ -1,24 +1,26 @@
-import { assert as m } from "../function/assert.js";
-import { isArray as c } from "../typed/isArray.js";
-import { isNil as l } from "../typed/isNil.js";
-import { IS_OBJECT_ERROR_MSG as y, isObject as u } from "../typed/isObject.js";
-function w(o, n, e, i = {}) {
-  m(u(o), y, { args: { item: o }, type: TypeError });
-  const { throwOnMissing: s = !1, allowArrayIndex: p = !1 } = i, a = n.split(/[.[\]]+/).filter(Boolean);
-  let r = o;
-  for (const t of a) {
-    if (l(r) || typeof r != "object")
-      return f(`Cannot read property '${t}' of ${r}`, s, e);
-    if (r = p && c(r) && /^\d+$/.test(t) ? r[Number(t)] : r[t], r === void 0)
-      return f(`Property '${t}' does not exist`, s, e);
-  }
-  return r;
+import { assert as e } from "../function/assert.js";
+import { isNil as t } from "../typed/isNil.js";
+import { IS_OBJECT_ERROR_MSG as n, isObject as r } from "../typed/isObject.js";
+//#region src/object/path.ts
+function i(i, a, o, s = {}) {
+	e(r(i), n, {
+		args: { item: i },
+		type: TypeError
+	});
+	let { throwOnMissing: c = !1 } = s, l = a.split(/[.[\]]+/).filter(Boolean), u = i;
+	for (let e of l) {
+		if (t(u) || typeof u != "object") {
+			if (c) throw Error(`Cannot read property '${e}' of ${u}`);
+			return o;
+		}
+		if (u = u[e], u === void 0) {
+			if (c) throw Error(`Property '${e}' does not exist`);
+			return o;
+		}
+	}
+	return u;
 }
-function f(o, n, e) {
-  if (n) throw new Error(o);
-  return e;
-}
-export {
-  w as path
-};
-//# sourceMappingURL=path.js.map
+//#endregion
+export { i as get };
+
+//# sourceMappingURL=path.js.map

package/dist/object/path.js.map

@@ -1 +1 @@
-{"version":3,"file":"path.js","sources":["../../src/object/path.ts"],"sourcesContent":["import { assert } from '../function/assert';\nimport { isArray } from '../typed/isArray';\nimport { isNil } from '../typed/isNil';\nimport { IS_OBJECT_ERROR_MSG, isObject } from '../typed/isObject';\nimport type { Obj } from '../types';\n\ntype PathValue<T, P extends string> = P extends `${infer Key}.${infer Rest}`\n  ? Key extends keyof T\n    ? PathValue<T[Key], Rest>\n    : undefined\n  : P extends keyof T\n    ? T[P]\n    : undefined;\n\n// #region PathOptions\ntype PathOptions = {\n  throwOnMissing?: boolean;\n  allowArrayIndex?: boolean;\n};\n// #endregion PathOptions\n\n/**\n * Retrieves the value at a given path of the object. If the value is undefined, the default value is returned.\n *\n * @example\n * ```ts\n * const obj = { a: { b: { c: 3 } }, d: [1, 2, 3] };\n *\n * getValue(obj, 'a.b.c'); // 3\n * getValue(obj, 'a.b.d', 'default'); // 'default'\n * getValue(obj, 'd[1]', undefined, { allowArrayIndex: true }); // 2\n * getValue(obj, 'e.f.g', 'default', { throwOnMissing: true }); // throws Error\n * ```\n *\n * @template T - The type of the object to query.\n * @template P - The type of the path string.\n * @param item - The object to query.\n * @param path - The path of the property to get.\n * @param [defaultValue] - The value returned for undefined resolved values.\n * @param [options] - Additional options for value retrieval.\n *\n * @returns The resolved value.\n *\n * @throws If throwOnMissing is true and the path doesn't exist.\n */\nexport function path<T extends Obj, P extends string>(\n  item: T,\n  path: P,\n  defaultValue?: unknown,\n  options: PathOptions = {},\n): PathValue<T, P> | undefined {\n  assert(isObject(item), IS_OBJECT_ERROR_MSG, { args: { item }, type: TypeError });\n\n  const { throwOnMissing = false, allowArrayIndex = false } = options;\n\n  const fragments = path.split(/[.[\\]]+/).filter(Boolean);\n  // biome-ignore lint/suspicious/noExplicitAny: -\n  let current: any = item;\n\n  for (const fragment of fragments) {\n    if (isNil(current) || typeof current !== 'object') {\n      return handleError(`Cannot read property '${fragment}' of ${current}`, throwOnMissing, defaultValue);\n    }\n\n    current =\n      allowArrayIndex && isArray(current) && /^\\d+$/.test(fragment) ? current[Number(fragment)] : current[fragment];\n\n    if (current === undefined) {\n      return handleError(`Property '${fragment}' does not exist`, throwOnMissing, defaultValue);\n    }\n  }\n\n  return current as PathValue<T, P>;\n}\n\nfunction handleError<T extends Obj, P extends string>(\n  message: string,\n  throwOnMissing: boolean,\n  defaultValue?: unknown,\n): PathValue<T, P> | undefined {\n  if (throwOnMissing) throw new Error(message);\n  return defaultValue as PathValue<T, P>;\n}\n"],"names":["path","item","defaultValue","options","assert","isObject","IS_OBJECT_ERROR_MSG","throwOnMissing","allowArrayIndex","fragments","current","fragment","isNil","handleError","isArray","message"],"mappings":";;;;AA6CO,SAASA,EACdC,GACAD,GACAE,GACAC,IAAuB,CAAA,GACM;AAC7B,EAAAC,EAAOC,EAASJ,CAAI,GAAGK,GAAqB,EAAE,MAAM,EAAE,MAAAL,EAAA,GAAQ,MAAM,WAAW;AAE/E,QAAM,EAAE,gBAAAM,IAAiB,IAAO,iBAAAC,IAAkB,OAAUL,GAEtDM,IAAYT,EAAK,MAAM,SAAS,EAAE,OAAO,OAAO;AAEtD,MAAIU,IAAeT;AAEnB,aAAWU,KAAYF,GAAW;AAChC,QAAIG,EAAMF,CAAO,KAAK,OAAOA,KAAY;AACvC,aAAOG,EAAY,yBAAyBF,CAAQ,QAAQD,CAAO,IAAIH,GAAgBL,CAAY;AAMrG,QAHAQ,IACEF,KAAmBM,EAAQJ,CAAO,KAAK,QAAQ,KAAKC,CAAQ,IAAID,EAAQ,OAAOC,CAAQ,CAAC,IAAID,EAAQC,CAAQ,GAE1GD,MAAY;AACd,aAAOG,EAAY,aAAaF,CAAQ,oBAAoBJ,GAAgBL,CAAY;AAAA,EAE5F;AAEA,SAAOQ;AACT;AAEA,SAASG,EACPE,GACAR,GACAL,GAC6B;AAC7B,MAAIK,EAAgB,OAAM,IAAI,MAAMQ,CAAO;AAC3C,SAAOb;AACT;"}
+{"version":3,"file":"path.js","names":[],"sources":["../../src/object/path.ts"],"sourcesContent":["import type { Obj } from '../types';\n\nimport { assert } from '../function/assert';\nimport { isNil } from '../typed/isNil';\nimport { IS_OBJECT_ERROR_MSG, isObject } from '../typed/isObject';\n\ntype PathValue<T, P extends string> = P extends `${infer Key}.${infer Rest}`\n  ? Key extends keyof T\n    ? PathValue<T[Key], Rest>\n    : undefined\n  : P extends keyof T\n    ? T[P]\n    : undefined;\n\n// #region PathOptions\ntype PathOptions = {\n  throwOnMissing?: boolean;\n};\n// #endregion PathOptions\n\n/**\n * Retrieves the value at a given path of the object. If the value is undefined, the default value is returned.\n *\n * @example\n * ```ts\n * const obj = { a: { b: { c: 3 } }, d: [1, 2, 3] };\n *\n * getValue(obj, 'a.b.c'); // 3\n * getValue(obj, 'a.b.d', 'default'); // 'default'\n * getValue(obj, 'd[1]'); // 2\n * getValue(obj, 'e.f.g', 'default', { throwOnMissing: true }); // throws Error\n * ```\n *\n * @template T - The type of the object to query.\n * @template P - The type of the path string.\n * @param item - The object to query.\n * @param path - The dot-separated path of the property to get.\n * @param [defaultValue] - The value returned for undefined resolved values.\n * @param [options] - Additional options for value retrieval.\n *\n * @returns The resolved value.\n *\n * @throws If throwOnMissing is true and the path doesn't exist.\n */\nexport function get<T extends Obj, P extends string>(\n  item: T,\n  path: P,\n  defaultValue?: unknown,\n  options: PathOptions = {},\n): PathValue<T, P> | undefined {\n  assert(isObject(item), IS_OBJECT_ERROR_MSG, { args: { item }, type: TypeError });\n\n  const { throwOnMissing = false } = options;\n\n  const fragments = path.split(/[.[\\]]+/).filter(Boolean);\n  let current: any = item;\n\n  for (const fragment of fragments) {\n    if (isNil(current) || typeof current !== 'object') {\n      if (throwOnMissing) throw new Error(`Cannot read property '${fragment}' of ${current}`);\n\n      return defaultValue as PathValue<T, P>;\n    }\n\n    current = current[fragment];\n\n    if (current === undefined) {\n      if (throwOnMissing) throw new Error(`Property '${fragment}' does not exist`);\n\n      return defaultValue as PathValue<T, P>;\n    }\n  }\n\n  return current as PathValue<T, P>;\n}\n"],"mappings":";;;;AA4CA,SAAgB,EACd,GACA,GACA,GACA,IAAuB,EAAE,EACI;AAC7B,GAAO,EAAS,EAAK,EAAE,GAAqB;EAAE,MAAM,EAAE,SAAM;EAAE,MAAM;EAAW,CAAC;CAEhF,IAAM,EAAE,oBAAiB,OAAU,GAE7B,IAAY,EAAK,MAAM,UAAU,CAAC,OAAO,QAAQ,EACnD,IAAe;AAEnB,MAAK,IAAM,KAAY,GAAW;AAChC,MAAI,EAAM,EAAQ,IAAI,OAAO,KAAY,UAAU;AACjD,OAAI,EAAgB,OAAU,MAAM,yBAAyB,EAAS,OAAO,IAAU;AAEvF,UAAO;;AAKT,MAFA,IAAU,EAAQ,IAEd,MAAY,KAAA,GAAW;AACzB,OAAI,EAAgB,OAAU,MAAM,aAAa,EAAS,kBAAkB;AAE5E,UAAO;;;AAIX,QAAO"}

package/dist/object/proxy.cjs

@@ -0,0 +1,2 @@
+const e=require(`../typed/isObject.cjs`);function t(n,r){let{deep:i=!1,get:a,set:o,watch:s}=r,c=s?new Set(s):null;return new Proxy(n,{get(n,o,s){if(c&&!c.has(o))return Reflect.get(n,o,s);let l=Reflect.get(n,o,s);return a&&(l=a(o,l,n)),i&&e.isObject(l)?t(l,r):l},set(n,a,s,l){if(c&&!c.has(a))return Reflect.set(n,a,s,l);let u=n[a],d=o?o(a,s,u,n):s;return i&&e.isObject(d)?Reflect.set(n,a,t(d,r),l):Reflect.set(n,a,d,l)}})}exports.proxy=t;
+//# sourceMappingURL=proxy.cjs.map

package/dist/object/proxy.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.cjs","names":[],"sources":["../../src/object/proxy.ts"],"sourcesContent":["import type { Obj } from '../types';\n\nimport { isObject } from '../typed/isObject';\n\n// #region ProxyOptions\ntype ProxyOptions<T> = {\n  deep?: boolean;\n  get?: <K extends PropertyKey>(prop: K, val: unknown, target: T) => unknown;\n  set?: <K extends PropertyKey>(prop: K, curr: unknown, prev: unknown, target: T) => unknown;\n  watch?: (keyof T)[];\n};\n// #endregion ProxyOptions\n\n/**\n * Creates a new Proxy for the given object that invokes functions when properties are accessed or modified.\n *\n * @example\n * ```ts\n * const obj = { a: 1, b: 2 };\n * const log = (prop, curr, prev, target) => console.log(`Property '${prop}' changed from ${prev} to ${curr}`);\n * const proxyObj = proxy(obj, { set: log });\n * proxyObj.a = 3; // logs 'Property 'a' changed from 1 to 3'\n * ```\n *\n * @param item - The object to observe.\n * @param options - Configuration options for the proxy.\n * @param [options.set] - A function to call when a property is set.\n * @param [options.get] - A function to call when a property is accessed.\n * @param [options.deep] - If true, the proxy will also apply to nested objects.\n * @param [options.watch] - An array of property names to watch.\n *\n * @returns A new Proxy for the given object.\n */\nexport function proxy<T extends Obj>(item: T, options: ProxyOptions<T>): T {\n  const { deep = false, get, set, watch } = options;\n  const watchSet = watch ? new Set<PropertyKey>(watch as PropertyKey[]) : null;\n\n  const handler: ProxyHandler<T> = {\n    get(target, prop, receiver) {\n      if (watchSet && !watchSet.has(prop)) {\n        return Reflect.get(target, prop, receiver);\n      }\n\n      let value = Reflect.get(target, prop, receiver);\n\n      if (get) {\n        value = get(prop, value, target) as any;\n      }\n\n      if (deep && isObject(value)) {\n        return proxy(value as unknown as T, options);\n      }\n\n      return value;\n    },\n    set(target, prop, val, receiver) {\n      if (watchSet && !watchSet.has(prop)) {\n        return Reflect.set(target, prop, val, receiver);\n      }\n\n      const prev = target[prop as keyof T];\n      const value = set ? set(prop, val, prev, target) : val;\n\n      if (deep && isObject(value)) {\n        return Reflect.set(target, prop, proxy(value as unknown as T, options), receiver);\n      }\n\n      return Reflect.set(target, prop, value, receiver);\n    },\n  };\n\n  return new Proxy(item, handler);\n}\n"],"mappings":"yCAiCA,SAAgB,EAAqB,EAAS,EAA6B,CACzE,GAAM,CAAE,OAAO,GAAO,MAAK,MAAK,SAAU,EACpC,EAAW,EAAQ,IAAI,IAAiB,EAAuB,CAAG,KAoCxE,OAAO,IAAI,MAAM,EAlCgB,CAC/B,IAAI,EAAQ,EAAM,EAAU,CAC1B,GAAI,GAAY,CAAC,EAAS,IAAI,EAAK,CACjC,OAAO,QAAQ,IAAI,EAAQ,EAAM,EAAS,CAG5C,IAAI,EAAQ,QAAQ,IAAI,EAAQ,EAAM,EAAS,CAU/C,OARI,IACF,EAAQ,EAAI,EAAM,EAAO,EAAO,EAG9B,GAAQ,EAAA,SAAS,EAAM,CAClB,EAAM,EAAuB,EAAQ,CAGvC,GAET,IAAI,EAAQ,EAAM,EAAK,EAAU,CAC/B,GAAI,GAAY,CAAC,EAAS,IAAI,EAAK,CACjC,OAAO,QAAQ,IAAI,EAAQ,EAAM,EAAK,EAAS,CAGjD,IAAM,EAAO,EAAO,GACd,EAAQ,EAAM,EAAI,EAAM,EAAK,EAAM,EAAO,CAAG,EAMnD,OAJI,GAAQ,EAAA,SAAS,EAAM,CAClB,QAAQ,IAAI,EAAQ,EAAM,EAAM,EAAuB,EAAQ,CAAE,EAAS,CAG5E,QAAQ,IAAI,EAAQ,EAAM,EAAO,EAAS,EAEpD,CAE8B"}

package/dist/object/proxy.d.ts

@@ -0,0 +1,30 @@
+import type { Obj } from '../types';
+type ProxyOptions<T> = {
+    deep?: boolean;
+    get?: <K extends PropertyKey>(prop: K, val: unknown, target: T) => unknown;
+    set?: <K extends PropertyKey>(prop: K, curr: unknown, prev: unknown, target: T) => unknown;
+    watch?: (keyof T)[];
+};
+/**
+ * Creates a new Proxy for the given object that invokes functions when properties are accessed or modified.
+ *
+ * @example
+ * ```ts
+ * const obj = { a: 1, b: 2 };
+ * const log = (prop, curr, prev, target) => console.log(`Property '${prop}' changed from ${prev} to ${curr}`);
+ * const proxyObj = proxy(obj, { set: log });
+ * proxyObj.a = 3; // logs 'Property 'a' changed from 1 to 3'
+ * ```
+ *
+ * @param item - The object to observe.
+ * @param options - Configuration options for the proxy.
+ * @param [options.set] - A function to call when a property is set.
+ * @param [options.get] - A function to call when a property is accessed.
+ * @param [options.deep] - If true, the proxy will also apply to nested objects.
+ * @param [options.watch] - An array of property names to watch.
+ *
+ * @returns A new Proxy for the given object.
+ */
+export declare function proxy<T extends Obj>(item: T, options: ProxyOptions<T>): T;
+export {};
+//# sourceMappingURL=proxy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../../src/object/proxy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAKpC,KAAK,YAAY,CAAC,CAAC,IAAI;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,CAAC,CAAC,SAAS,WAAW,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC;IAC3E,GAAG,CAAC,EAAE,CAAC,CAAC,SAAS,WAAW,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC;IAC3F,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;CACrB,CAAC;AAGF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAuCzE"}