yummies 7.19.4 → 7.20.0

package/data.cjs

@@ -1,5 +1,42 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-//#region src/data.ts
+//#region src/data/flat-map-deep.ts
+/**
+* Recursively flattens a nested array and maps the collected values.
+*
+* @example
+* ```ts
+* flatMapDeep([1, [2, [3]]], (value) => value * 2); // [2, 4, 6]
+* ```
+*/
+var flatMapDeep = (arr, fn) => {
+	const source = [];
+	const collect = (value) => {
+		if (!Array.isArray(value)) {
+			source.push(value);
+			return;
+		}
+		for (const item of value) collect(item);
+	};
+	collect(arr);
+	return source.map((value, i) => fn(value, i, source));
+};
+//#endregion
+//#region src/data/has-enumerable-keys.ts
+/**
+* Checks whether an object has at least one enumerable key.
+*
+* @example
+* ```ts
+* hasEnumerableKeys({ id: 1 }); // true
+* hasEnumerableKeys({}); // false
+* ```
+*/
+var hasEnumerableKeys = (input) => {
+	for (const _key in input) return true;
+	return false;
+};
+//#endregion
+//#region src/data/is-shallow-equal.ts
 /**
 * Performs a shallow comparison for arrays, plain objects, dates and regular expressions.
 *
@@ -30,50 +67,23 @@ var isShallowEqual = (a, b) => {
 	for (const key of aKeys) if (!Object.hasOwn(bObj, key) || a[key] !== bObj[key]) return false;
 	return true;
 };
+//#endregion
+//#region src/data/is-unsafe-property.ts
+var UNSAFE_PROPERTY_KEYS = new Set([
+	"__proto__",
+	"prototype",
+	"constructor"
+]);
 /**
-* Checks whether an object has at least one enumerable key.
-*
-* @example
-* ```ts
-* hasEnumerableKeys({ id: 1 }); // true
-* hasEnumerableKeys({}); // false
-* ```
-*/
-var hasEnumerableKeys = (input) => {
-	for (const _key in input) return true;
-	return false;
-};
-/**
-* Wraps a value in an array when it is not already an array.
-*
-* @example
-* ```ts
-* toArray('item'); // ['item']
-* ```
-*/
-var toArray = (value) => {
-	return Array.isArray(value) ? value : [value];
-};
-/**
-* Recursively flattens a nested array and maps the collected values.
+* Checks whether a property key is unsafe and can lead to prototype pollution.
 *
 * @example
-* ```ts
-* flatMapDeep([1, [2, [3]]], (value) => value * 2); // [2, 4, 6]
-* ```
+* isUnsafeProperty('__proto__'); // true
+* isUnsafeProperty('name'); // false
 */
-var flatMapDeep = (arr, fn) => {
-	const source = [];
-	const collect = (value) => {
-		if (!Array.isArray(value)) {
-			source.push(value);
-			return;
-		}
-		for (const item of value) collect(item);
-	};
-	collect(arr);
-	return source.map((value, i) => fn(value, i, source));
-};
+var isUnsafeProperty = (key) => UNSAFE_PROPERTY_KEYS.has(key);
+//#endregion
+//#region src/data/safe-json-parse.ts
 /**
 * Parses JSON safely and returns a fallback value when parsing fails.
 *
@@ -90,19 +100,19 @@ var safeJsonParse = (json, fallback = null) => {
 		return fallback;
 	}
 };
-var UNSAFE_PROPERTY_KEYS = new Set([
-	"__proto__",
-	"prototype",
-	"constructor"
-]);
+//#endregion
+//#region src/data/to-array.ts
 /**
-* Checks whether a property key is unsafe and can lead to prototype pollution.
+* Wraps a value in an array when it is not already an array.
 *
 * @example
-* isUnsafeProperty('__proto__'); // true
-* isUnsafeProperty('name'); // false
+* ```ts
+* toArray('item'); // ['item']
+* ```
 */
-var isUnsafeProperty = (key) => UNSAFE_PROPERTY_KEYS.has(key);
+var toArray = (value) => {
+	return Array.isArray(value) ? value : [value];
+};
 //#endregion
 exports.flatMapDeep = flatMapDeep;
 exports.hasEnumerableKeys = hasEnumerableKeys;

package/data.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"data.cjs","names":[],"sources":["../src/data.ts"],"sourcesContent":["/**\n * ---header-docs-section---\n * # yummies/data\n *\n * ## Description\n *\n * General-purpose data helpers: shallow equality, normalizing values to arrays, and recursive\n * `flatMap`-style transforms. They complement `Array`/`Object` builtins when you need stable\n * comparisons for memoization or small structural utilities without pulling a large lodash-style\n * dependency into the bundle.\n *\n * ## Usage\n *\n * ```ts\n * import { isShallowEqual, toArray } from \"yummies/data\";\n * ```\n */\n\nimport type { AnyObject, Maybe } from 'yummies/types';\n\n/**\n * Performs a shallow comparison for arrays, plain objects, dates and regular expressions.\n *\n * @example\n * ```ts\n * isShallowEqual({ id: 1 }, { id: 1 }); // true\n * ```\n */\nexport const isShallowEqual = (a: unknown, b: unknown): boolean => {\n  if (a === b) return true;\n\n  if (\n    typeof a !== 'object' ||\n    typeof b !== 'object' ||\n    a === null ||\n    b === null\n  ) {\n    return false;\n  }\n\n  if (a.constructor !== b.constructor) return false;\n\n  const isArrayA = Array.isArray(a);\n\n  if (isArrayA !== Array.isArray(b)) return false;\n\n  if (isArrayA) {\n    const arrA = a as unknown[];\n    const arrB = b as unknown[];\n    if (arrA.length !== arrB.length) return false;\n\n    for (const [i, element] of arrA.entries()) {\n      if (element !== arrB[i]) return false;\n    }\n    return true;\n  }\n\n  if (a instanceof Date) return a.getTime() === (b as Date).getTime();\n\n  if (a instanceof RegExp) return a.toString() === (b as RegExp).toString();\n\n  const aKeys = Object.keys(a);\n  const bKeys = Object.keys(b);\n\n  if (aKeys.length !== bKeys.length) return false;\n\n  const bObj = b as AnyObject;\n  for (const key of aKeys) {\n    if (!Object.hasOwn(bObj, key) || (a as AnyObject)[key] !== bObj[key]) {\n      return false;\n    }\n  }\n\n  return true;\n};\n\n/**\n * Checks whether an object has at least one enumerable key.\n *\n * @example\n * ```ts\n * hasEnumerableKeys({ id: 1 }); // true\n * hasEnumerableKeys({}); // false\n * ```\n */\nexport const hasEnumerableKeys = (input: AnyObject): boolean => {\n  for (const _key in input) {\n    return true;\n  }\n  return false;\n};\n\n/**\n * Wraps a value in an array when it is not already an array.\n *\n * @example\n * ```ts\n * toArray('item'); // ['item']\n * ```\n */\nexport const toArray = <TValue>(value: TValue | TValue[]): TValue[] => {\n  return Array.isArray(value) ? value : [value];\n};\n\ntype DeepArray<TValue> = TValue | Array<DeepArray<TValue>>;\n\n/**\n * Recursively flattens a nested array and maps the collected values.\n *\n * @example\n * ```ts\n * flatMapDeep([1, [2, [3]]], (value) => value * 2); // [2, 4, 6]\n * ```\n */\nexport const flatMapDeep = <TSource, TNewValue>(\n  arr: DeepArray<TSource>,\n  fn: (value: TSource, i: number, arr: TSource[]) => TNewValue,\n): TNewValue[] => {\n  const source: TSource[] = [];\n\n  const collect = (value: DeepArray<TSource>): void => {\n    if (!Array.isArray(value)) {\n      source.push(value);\n      return;\n    }\n\n    for (const item of value) {\n      collect(item);\n    }\n  };\n\n  collect(arr);\n\n  return source.map((value, i) => fn(value, i, source));\n};\n\n/**\n * Parses JSON safely and returns a fallback value when parsing fails.\n *\n * @example\n * ```ts\n * safeJsonParse('{\"enabled\":true}', {}); // { enabled: true }\n * ```\n */\nexport const safeJsonParse = <TValue = any, TFallback = null>(\n  json: Maybe<string>,\n  fallback: TFallback = null as TFallback,\n): TValue | TFallback => {\n  if (json == null) return fallback;\n\n  try {\n    return JSON.parse(json);\n  } catch {\n    return fallback;\n  }\n};\n\nconst UNSAFE_PROPERTY_KEYS = new Set(['__proto__', 'prototype', 'constructor']);\n\n/**\n * Checks whether a property key is unsafe and can lead to prototype pollution.\n *\n * @example\n * isUnsafeProperty('__proto__'); // true\n * isUnsafeProperty('name'); // false\n */\nexport const isUnsafeProperty = (key: any) => UNSAFE_PROPERTY_KEYS.has(key);\n"],"mappings":";;;;;;;;;;AA4BA,IAAa,kBAAkB,GAAY,MAAwB;AACjE,KAAI,MAAM,EAAG,QAAO;AAEpB,KACE,OAAO,MAAM,YACb,OAAO,MAAM,YACb,MAAM,QACN,MAAM,KAEN,QAAO;AAGT,KAAI,EAAE,gBAAgB,EAAE,YAAa,QAAO;CAE5C,MAAM,WAAW,MAAM,QAAQ,EAAE;AAEjC,KAAI,aAAa,MAAM,QAAQ,EAAE,CAAE,QAAO;AAE1C,KAAI,UAAU;EACZ,MAAM,OAAO;EACb,MAAM,OAAO;AACb,MAAI,KAAK,WAAW,KAAK,OAAQ,QAAO;AAExC,OAAK,MAAM,CAAC,GAAG,YAAY,KAAK,SAAS,CACvC,KAAI,YAAY,KAAK,GAAI,QAAO;AAElC,SAAO;;AAGT,KAAI,aAAa,KAAM,QAAO,EAAE,SAAS,KAAM,EAAW,SAAS;AAEnE,KAAI,aAAa,OAAQ,QAAO,EAAE,UAAU,KAAM,EAAa,UAAU;CAEzE,MAAM,QAAQ,OAAO,KAAK,EAAE;CAC5B,MAAM,QAAQ,OAAO,KAAK,EAAE;AAE5B,KAAI,MAAM,WAAW,MAAM,OAAQ,QAAO;CAE1C,MAAM,OAAO;AACb,MAAK,MAAM,OAAO,MAChB,KAAI,CAAC,OAAO,OAAO,MAAM,IAAI,IAAK,EAAgB,SAAS,KAAK,KAC9D,QAAO;AAIX,QAAO;;;;;;;;;;;AAYT,IAAa,qBAAqB,UAA8B;AAC9D,MAAK,MAAM,QAAQ,MACjB,QAAO;AAET,QAAO;;;;;;;;;;AAWT,IAAa,WAAmB,UAAuC;AACrE,QAAO,MAAM,QAAQ,MAAM,GAAG,QAAQ,CAAC,MAAM;;;;;;;;;;AAa/C,IAAa,eACX,KACA,OACgB;CAChB,MAAM,SAAoB,EAAE;CAE5B,MAAM,WAAW,UAAoC;AACnD,MAAI,CAAC,MAAM,QAAQ,MAAM,EAAE;AACzB,UAAO,KAAK,MAAM;AAClB;;AAGF,OAAK,MAAM,QAAQ,MACjB,SAAQ,KAAK;;AAIjB,SAAQ,IAAI;AAEZ,QAAO,OAAO,KAAK,OAAO,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;;;;;;;;;;AAWvD,IAAa,iBACX,MACA,WAAsB,SACC;AACvB,KAAI,QAAQ,KAAM,QAAO;AAEzB,KAAI;AACF,SAAO,KAAK,MAAM,KAAK;SACjB;AACN,SAAO;;;AAIX,IAAM,uBAAuB,IAAI,IAAI;CAAC;CAAa;CAAa;CAAc,CAAC;;;;;;;;AAS/E,IAAa,oBAAoB,QAAa,qBAAqB,IAAI,IAAI"}
+{"version":3,"file":"data.cjs","names":[],"sources":["../src/data/flat-map-deep.ts","../src/data/has-enumerable-keys.ts","../src/data/is-shallow-equal.ts","../src/data/is-unsafe-property.ts","../src/data/safe-json-parse.ts","../src/data/to-array.ts"],"sourcesContent":["type DeepArray<TValue> = TValue | Array<DeepArray<TValue>>;\n\n/**\n * Recursively flattens a nested array and maps the collected values.\n *\n * @example\n * ```ts\n * flatMapDeep([1, [2, [3]]], (value) => value * 2); // [2, 4, 6]\n * ```\n */\nexport const flatMapDeep = <TSource, TNewValue>(\n  arr: DeepArray<TSource>,\n  fn: (value: TSource, i: number, arr: TSource[]) => TNewValue,\n): TNewValue[] => {\n  const source: TSource[] = [];\n\n  const collect = (value: DeepArray<TSource>): void => {\n    if (!Array.isArray(value)) {\n      source.push(value);\n      return;\n    }\n\n    for (const item of value) {\n      collect(item);\n    }\n  };\n\n  collect(arr);\n\n  return source.map((value, i) => fn(value, i, source));\n};\n","import type { AnyObject } from 'yummies/types';\n\n/**\n * Checks whether an object has at least one enumerable key.\n *\n * @example\n * ```ts\n * hasEnumerableKeys({ id: 1 }); // true\n * hasEnumerableKeys({}); // false\n * ```\n */\nexport const hasEnumerableKeys = (input: AnyObject): boolean => {\n  for (const _key in input) {\n    return true;\n  }\n  return false;\n};\n","import type { AnyObject } from 'yummies/types';\n\n/**\n * Performs a shallow comparison for arrays, plain objects, dates and regular expressions.\n *\n * @example\n * ```ts\n * isShallowEqual({ id: 1 }, { id: 1 }); // true\n * ```\n */\nexport const isShallowEqual = (a: unknown, b: unknown): boolean => {\n  if (a === b) return true;\n\n  if (\n    typeof a !== 'object' ||\n    typeof b !== 'object' ||\n    a === null ||\n    b === null\n  ) {\n    return false;\n  }\n\n  if (a.constructor !== b.constructor) return false;\n\n  const isArrayA = Array.isArray(a);\n\n  if (isArrayA !== Array.isArray(b)) return false;\n\n  if (isArrayA) {\n    const arrA = a as unknown[];\n    const arrB = b as unknown[];\n    if (arrA.length !== arrB.length) return false;\n\n    for (const [i, element] of arrA.entries()) {\n      if (element !== arrB[i]) return false;\n    }\n    return true;\n  }\n\n  if (a instanceof Date) return a.getTime() === (b as Date).getTime();\n\n  if (a instanceof RegExp) return a.toString() === (b as RegExp).toString();\n\n  const aKeys = Object.keys(a);\n  const bKeys = Object.keys(b);\n\n  if (aKeys.length !== bKeys.length) return false;\n\n  const bObj = b as AnyObject;\n  for (const key of aKeys) {\n    if (!Object.hasOwn(bObj, key) || (a as AnyObject)[key] !== bObj[key]) {\n      return false;\n    }\n  }\n\n  return true;\n};\n","const UNSAFE_PROPERTY_KEYS = new Set(['__proto__', 'prototype', 'constructor']);\n\n/**\n * Checks whether a property key is unsafe and can lead to prototype pollution.\n *\n * @example\n * isUnsafeProperty('__proto__'); // true\n * isUnsafeProperty('name'); // false\n */\nexport const isUnsafeProperty = (key: any) => UNSAFE_PROPERTY_KEYS.has(key);\n","import type { Maybe } from 'yummies/types';\n\n/**\n * Parses JSON safely and returns a fallback value when parsing fails.\n *\n * @example\n * ```ts\n * safeJsonParse('{\"enabled\":true}', {}); // { enabled: true }\n * ```\n */\nexport const safeJsonParse = <TValue = any, TFallback = null>(\n  json: Maybe<string>,\n  fallback: TFallback = null as TFallback,\n): TValue | TFallback => {\n  if (json == null) return fallback;\n\n  try {\n    return JSON.parse(json);\n  } catch {\n    return fallback;\n  }\n};\n","/**\n * Wraps a value in an array when it is not already an array.\n *\n * @example\n * ```ts\n * toArray('item'); // ['item']\n * ```\n */\nexport const toArray = <TValue>(value: TValue | TValue[]): TValue[] => {\n  return Array.isArray(value) ? value : [value];\n};\n"],"mappings":";;;;;;;;;;AAUA,IAAa,eACX,KACA,OACgB;CAChB,MAAM,SAAoB,CAAC;CAE3B,MAAM,WAAW,UAAoC;EACnD,IAAI,CAAC,MAAM,QAAQ,KAAK,GAAG;GACzB,OAAO,KAAK,KAAK;GACjB;EACF;EAEA,KAAK,MAAM,QAAQ,OACjB,QAAQ,IAAI;CAEhB;CAEA,QAAQ,GAAG;CAEX,OAAO,OAAO,KAAK,OAAO,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AACtD;;;;;;;;;;;;ACnBA,IAAa,qBAAqB,UAA8B;CAC9D,KAAK,MAAM,QAAQ,OACjB,OAAO;CAET,OAAO;AACT;;;;;;;;;;;ACNA,IAAa,kBAAkB,GAAY,MAAwB;CACjE,IAAI,MAAM,GAAG,OAAO;CAEpB,IACE,OAAO,MAAM,YACb,OAAO,MAAM,YACb,MAAM,QACN,MAAM,MAEN,OAAO;CAGT,IAAI,EAAE,gBAAgB,EAAE,aAAa,OAAO;CAE5C,MAAM,WAAW,MAAM,QAAQ,CAAC;CAEhC,IAAI,aAAa,MAAM,QAAQ,CAAC,GAAG,OAAO;CAE1C,IAAI,UAAU;EACZ,MAAM,OAAO;EACb,MAAM,OAAO;EACb,IAAI,KAAK,WAAW,KAAK,QAAQ,OAAO;EAExC,KAAK,MAAM,CAAC,GAAG,YAAY,KAAK,QAAQ,GACtC,IAAI,YAAY,KAAK,IAAI,OAAO;EAElC,OAAO;CACT;CAEA,IAAI,aAAa,MAAM,OAAO,EAAE,QAAQ,MAAO,EAAW,QAAQ;CAElE,IAAI,aAAa,QAAQ,OAAO,EAAE,SAAS,MAAO,EAAa,SAAS;CAExE,MAAM,QAAQ,OAAO,KAAK,CAAC;CAC3B,MAAM,QAAQ,OAAO,KAAK,CAAC;CAE3B,IAAI,MAAM,WAAW,MAAM,QAAQ,OAAO;CAE1C,MAAM,OAAO;CACb,KAAK,MAAM,OAAO,OAChB,IAAI,CAAC,OAAO,OAAO,MAAM,GAAG,KAAM,EAAgB,SAAS,KAAK,MAC9D,OAAO;CAIX,OAAO;AACT;;;ACxDA,IAAM,uBAAuB,IAAI,IAAI;CAAC;CAAa;CAAa;AAAa,CAAC;;;;;;;;AAS9E,IAAa,oBAAoB,QAAa,qBAAqB,IAAI,GAAG;;;;;;;;;;;ACC1E,IAAa,iBACX,MACA,WAAsB,SACC;CACvB,IAAI,QAAQ,MAAM,OAAO;CAEzB,IAAI;EACF,OAAO,KAAK,MAAM,IAAI;CACxB,QAAQ;EACN,OAAO;CACT;AACF;;;;;;;;;;;ACbA,IAAa,WAAmB,UAAuC;CACrE,OAAO,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC,KAAK;AAC9C"}

package/data.d.ts

@@ -1,32 +1,16 @@
 import { AnyObject, Maybe } from 'yummies/types';
 
+type DeepArray<TValue> = TValue | Array<DeepArray<TValue>>;
 /**
- * ---header-docs-section---
- * # yummies/data
- *
- * ## Description
- *
- * General-purpose data helpers: shallow equality, normalizing values to arrays, and recursive
- * `flatMap`-style transforms. They complement `Array`/`Object` builtins when you need stable
- * comparisons for memoization or small structural utilities without pulling a large lodash-style
- * dependency into the bundle.
- *
- * ## Usage
- *
- * ```ts
- * import { isShallowEqual, toArray } from "yummies/data";
- * ```
- */
-
-/**
- * Performs a shallow comparison for arrays, plain objects, dates and regular expressions.
+ * Recursively flattens a nested array and maps the collected values.
  *
  * @example
  * ```ts
- * isShallowEqual({ id: 1 }, { id: 1 }); // true
+ * flatMapDeep([1, [2, [3]]], (value) => value * 2); // [2, 4, 6]
  * ```
  */
-declare const isShallowEqual: (a: unknown, b: unknown) => boolean;
+declare const flatMapDeep: <TSource, TNewValue>(arr: DeepArray<TSource>, fn: (value: TSource, i: number, arr: TSource[]) => TNewValue) => TNewValue[];
+
 /**
  * Checks whether an object has at least one enumerable key.
  *
@@ -37,25 +21,26 @@ declare const isShallowEqual: (a: unknown, b: unknown) => boolean;
  * ```
  */
 declare const hasEnumerableKeys: (input: AnyObject) => boolean;
+
 /**
- * Wraps a value in an array when it is not already an array.
+ * Performs a shallow comparison for arrays, plain objects, dates and regular expressions.
  *
  * @example
  * ```ts
- * toArray('item'); // ['item']
+ * isShallowEqual({ id: 1 }, { id: 1 }); // true
  * ```
  */
-declare const toArray: <TValue>(value: TValue | TValue[]) => TValue[];
-type DeepArray<TValue> = TValue | Array<DeepArray<TValue>>;
+declare const isShallowEqual: (a: unknown, b: unknown) => boolean;
+
 /**
- * Recursively flattens a nested array and maps the collected values.
+ * Checks whether a property key is unsafe and can lead to prototype pollution.
  *
  * @example
- * ```ts
- * flatMapDeep([1, [2, [3]]], (value) => value * 2); // [2, 4, 6]
- * ```
+ * isUnsafeProperty('__proto__'); // true
+ * isUnsafeProperty('name'); // false
  */
-declare const flatMapDeep: <TSource, TNewValue>(arr: DeepArray<TSource>, fn: (value: TSource, i: number, arr: TSource[]) => TNewValue) => TNewValue[];
+declare const isUnsafeProperty: (key: any) => boolean;
+
 /**
  * Parses JSON safely and returns a fallback value when parsing fails.
  *
@@ -65,13 +50,15 @@ declare const flatMapDeep: <TSource, TNewValue>(arr: DeepArray<TSource>, fn: (va
  * ```
  */
 declare const safeJsonParse: <TValue = any, TFallback = null>(json: Maybe<string>, fallback?: TFallback) => TValue | TFallback;
+
 /**
- * Checks whether a property key is unsafe and can lead to prototype pollution.
+ * Wraps a value in an array when it is not already an array.
  *
  * @example
- * isUnsafeProperty('__proto__'); // true
- * isUnsafeProperty('name'); // false
+ * ```ts
+ * toArray('item'); // ['item']
+ * ```
  */
-declare const isUnsafeProperty: (key: any) => boolean;
+declare const toArray: <TValue>(value: TValue | TValue[]) => TValue[];
 
 export { flatMapDeep, hasEnumerableKeys, isShallowEqual, isUnsafeProperty, safeJsonParse, toArray };

package/data.js

@@ -1,4 +1,41 @@
-//#region src/data.ts
+//#region src/data/flat-map-deep.ts
+/**
+* Recursively flattens a nested array and maps the collected values.
+*
+* @example
+* ```ts
+* flatMapDeep([1, [2, [3]]], (value) => value * 2); // [2, 4, 6]
+* ```
+*/
+var flatMapDeep = (arr, fn) => {
+	const source = [];
+	const collect = (value) => {
+		if (!Array.isArray(value)) {
+			source.push(value);
+			return;
+		}
+		for (const item of value) collect(item);
+	};
+	collect(arr);
+	return source.map((value, i) => fn(value, i, source));
+};
+//#endregion
+//#region src/data/has-enumerable-keys.ts
+/**
+* Checks whether an object has at least one enumerable key.
+*
+* @example
+* ```ts
+* hasEnumerableKeys({ id: 1 }); // true
+* hasEnumerableKeys({}); // false
+* ```
+*/
+var hasEnumerableKeys = (input) => {
+	for (const _key in input) return true;
+	return false;
+};
+//#endregion
+//#region src/data/is-shallow-equal.ts
 /**
 * Performs a shallow comparison for arrays, plain objects, dates and regular expressions.
 *
@@ -29,50 +66,23 @@ var isShallowEqual = (a, b) => {
 	for (const key of aKeys) if (!Object.hasOwn(bObj, key) || a[key] !== bObj[key]) return false;
 	return true;
 };
+//#endregion
+//#region src/data/is-unsafe-property.ts
+var UNSAFE_PROPERTY_KEYS = new Set([
+	"__proto__",
+	"prototype",
+	"constructor"
+]);
 /**
-* Checks whether an object has at least one enumerable key.
-*
-* @example
-* ```ts
-* hasEnumerableKeys({ id: 1 }); // true
-* hasEnumerableKeys({}); // false
-* ```
-*/
-var hasEnumerableKeys = (input) => {
-	for (const _key in input) return true;
-	return false;
-};
-/**
-* Wraps a value in an array when it is not already an array.
-*
-* @example
-* ```ts
-* toArray('item'); // ['item']
-* ```
-*/
-var toArray = (value) => {
-	return Array.isArray(value) ? value : [value];
-};
-/**
-* Recursively flattens a nested array and maps the collected values.
+* Checks whether a property key is unsafe and can lead to prototype pollution.
 *
 * @example
-* ```ts
-* flatMapDeep([1, [2, [3]]], (value) => value * 2); // [2, 4, 6]
-* ```
+* isUnsafeProperty('__proto__'); // true
+* isUnsafeProperty('name'); // false
 */
-var flatMapDeep = (arr, fn) => {
-	const source = [];
-	const collect = (value) => {
-		if (!Array.isArray(value)) {
-			source.push(value);
-			return;
-		}
-		for (const item of value) collect(item);
-	};
-	collect(arr);
-	return source.map((value, i) => fn(value, i, source));
-};
+var isUnsafeProperty = (key) => UNSAFE_PROPERTY_KEYS.has(key);
+//#endregion
+//#region src/data/safe-json-parse.ts
 /**
 * Parses JSON safely and returns a fallback value when parsing fails.
 *
@@ -89,19 +99,19 @@ var safeJsonParse = (json, fallback = null) => {
 		return fallback;
 	}
 };
-var UNSAFE_PROPERTY_KEYS = new Set([
-	"__proto__",
-	"prototype",
-	"constructor"
-]);
+//#endregion
+//#region src/data/to-array.ts
 /**
-* Checks whether a property key is unsafe and can lead to prototype pollution.
+* Wraps a value in an array when it is not already an array.
 *
 * @example
-* isUnsafeProperty('__proto__'); // true
-* isUnsafeProperty('name'); // false
+* ```ts
+* toArray('item'); // ['item']
+* ```
 */
-var isUnsafeProperty = (key) => UNSAFE_PROPERTY_KEYS.has(key);
+var toArray = (value) => {
+	return Array.isArray(value) ? value : [value];
+};
 //#endregion
 export { flatMapDeep, hasEnumerableKeys, isShallowEqual, isUnsafeProperty, safeJsonParse, toArray };
 

package/data.js.map

@@ -1 +1 @@
-{"version":3,"file":"data.js","names":[],"sources":["../src/data.ts"],"sourcesContent":["/**\n * ---header-docs-section---\n * # yummies/data\n *\n * ## Description\n *\n * General-purpose data helpers: shallow equality, normalizing values to arrays, and recursive\n * `flatMap`-style transforms. They complement `Array`/`Object` builtins when you need stable\n * comparisons for memoization or small structural utilities without pulling a large lodash-style\n * dependency into the bundle.\n *\n * ## Usage\n *\n * ```ts\n * import { isShallowEqual, toArray } from \"yummies/data\";\n * ```\n */\n\nimport type { AnyObject, Maybe } from 'yummies/types';\n\n/**\n * Performs a shallow comparison for arrays, plain objects, dates and regular expressions.\n *\n * @example\n * ```ts\n * isShallowEqual({ id: 1 }, { id: 1 }); // true\n * ```\n */\nexport const isShallowEqual = (a: unknown, b: unknown): boolean => {\n  if (a === b) return true;\n\n  if (\n    typeof a !== 'object' ||\n    typeof b !== 'object' ||\n    a === null ||\n    b === null\n  ) {\n    return false;\n  }\n\n  if (a.constructor !== b.constructor) return false;\n\n  const isArrayA = Array.isArray(a);\n\n  if (isArrayA !== Array.isArray(b)) return false;\n\n  if (isArrayA) {\n    const arrA = a as unknown[];\n    const arrB = b as unknown[];\n    if (arrA.length !== arrB.length) return false;\n\n    for (const [i, element] of arrA.entries()) {\n      if (element !== arrB[i]) return false;\n    }\n    return true;\n  }\n\n  if (a instanceof Date) return a.getTime() === (b as Date).getTime();\n\n  if (a instanceof RegExp) return a.toString() === (b as RegExp).toString();\n\n  const aKeys = Object.keys(a);\n  const bKeys = Object.keys(b);\n\n  if (aKeys.length !== bKeys.length) return false;\n\n  const bObj = b as AnyObject;\n  for (const key of aKeys) {\n    if (!Object.hasOwn(bObj, key) || (a as AnyObject)[key] !== bObj[key]) {\n      return false;\n    }\n  }\n\n  return true;\n};\n\n/**\n * Checks whether an object has at least one enumerable key.\n *\n * @example\n * ```ts\n * hasEnumerableKeys({ id: 1 }); // true\n * hasEnumerableKeys({}); // false\n * ```\n */\nexport const hasEnumerableKeys = (input: AnyObject): boolean => {\n  for (const _key in input) {\n    return true;\n  }\n  return false;\n};\n\n/**\n * Wraps a value in an array when it is not already an array.\n *\n * @example\n * ```ts\n * toArray('item'); // ['item']\n * ```\n */\nexport const toArray = <TValue>(value: TValue | TValue[]): TValue[] => {\n  return Array.isArray(value) ? value : [value];\n};\n\ntype DeepArray<TValue> = TValue | Array<DeepArray<TValue>>;\n\n/**\n * Recursively flattens a nested array and maps the collected values.\n *\n * @example\n * ```ts\n * flatMapDeep([1, [2, [3]]], (value) => value * 2); // [2, 4, 6]\n * ```\n */\nexport const flatMapDeep = <TSource, TNewValue>(\n  arr: DeepArray<TSource>,\n  fn: (value: TSource, i: number, arr: TSource[]) => TNewValue,\n): TNewValue[] => {\n  const source: TSource[] = [];\n\n  const collect = (value: DeepArray<TSource>): void => {\n    if (!Array.isArray(value)) {\n      source.push(value);\n      return;\n    }\n\n    for (const item of value) {\n      collect(item);\n    }\n  };\n\n  collect(arr);\n\n  return source.map((value, i) => fn(value, i, source));\n};\n\n/**\n * Parses JSON safely and returns a fallback value when parsing fails.\n *\n * @example\n * ```ts\n * safeJsonParse('{\"enabled\":true}', {}); // { enabled: true }\n * ```\n */\nexport const safeJsonParse = <TValue = any, TFallback = null>(\n  json: Maybe<string>,\n  fallback: TFallback = null as TFallback,\n): TValue | TFallback => {\n  if (json == null) return fallback;\n\n  try {\n    return JSON.parse(json);\n  } catch {\n    return fallback;\n  }\n};\n\nconst UNSAFE_PROPERTY_KEYS = new Set(['__proto__', 'prototype', 'constructor']);\n\n/**\n * Checks whether a property key is unsafe and can lead to prototype pollution.\n *\n * @example\n * isUnsafeProperty('__proto__'); // true\n * isUnsafeProperty('name'); // false\n */\nexport const isUnsafeProperty = (key: any) => UNSAFE_PROPERTY_KEYS.has(key);\n"],"mappings":";;;;;;;;;AA4BA,IAAa,kBAAkB,GAAY,MAAwB;AACjE,KAAI,MAAM,EAAG,QAAO;AAEpB,KACE,OAAO,MAAM,YACb,OAAO,MAAM,YACb,MAAM,QACN,MAAM,KAEN,QAAO;AAGT,KAAI,EAAE,gBAAgB,EAAE,YAAa,QAAO;CAE5C,MAAM,WAAW,MAAM,QAAQ,EAAE;AAEjC,KAAI,aAAa,MAAM,QAAQ,EAAE,CAAE,QAAO;AAE1C,KAAI,UAAU;EACZ,MAAM,OAAO;EACb,MAAM,OAAO;AACb,MAAI,KAAK,WAAW,KAAK,OAAQ,QAAO;AAExC,OAAK,MAAM,CAAC,GAAG,YAAY,KAAK,SAAS,CACvC,KAAI,YAAY,KAAK,GAAI,QAAO;AAElC,SAAO;;AAGT,KAAI,aAAa,KAAM,QAAO,EAAE,SAAS,KAAM,EAAW,SAAS;AAEnE,KAAI,aAAa,OAAQ,QAAO,EAAE,UAAU,KAAM,EAAa,UAAU;CAEzE,MAAM,QAAQ,OAAO,KAAK,EAAE;CAC5B,MAAM,QAAQ,OAAO,KAAK,EAAE;AAE5B,KAAI,MAAM,WAAW,MAAM,OAAQ,QAAO;CAE1C,MAAM,OAAO;AACb,MAAK,MAAM,OAAO,MAChB,KAAI,CAAC,OAAO,OAAO,MAAM,IAAI,IAAK,EAAgB,SAAS,KAAK,KAC9D,QAAO;AAIX,QAAO;;;;;;;;;;;AAYT,IAAa,qBAAqB,UAA8B;AAC9D,MAAK,MAAM,QAAQ,MACjB,QAAO;AAET,QAAO;;;;;;;;;;AAWT,IAAa,WAAmB,UAAuC;AACrE,QAAO,MAAM,QAAQ,MAAM,GAAG,QAAQ,CAAC,MAAM;;;;;;;;;;AAa/C,IAAa,eACX,KACA,OACgB;CAChB,MAAM,SAAoB,EAAE;CAE5B,MAAM,WAAW,UAAoC;AACnD,MAAI,CAAC,MAAM,QAAQ,MAAM,EAAE;AACzB,UAAO,KAAK,MAAM;AAClB;;AAGF,OAAK,MAAM,QAAQ,MACjB,SAAQ,KAAK;;AAIjB,SAAQ,IAAI;AAEZ,QAAO,OAAO,KAAK,OAAO,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;;;;;;;;;;AAWvD,IAAa,iBACX,MACA,WAAsB,SACC;AACvB,KAAI,QAAQ,KAAM,QAAO;AAEzB,KAAI;AACF,SAAO,KAAK,MAAM,KAAK;SACjB;AACN,SAAO;;;AAIX,IAAM,uBAAuB,IAAI,IAAI;CAAC;CAAa;CAAa;CAAc,CAAC;;;;;;;;AAS/E,IAAa,oBAAoB,QAAa,qBAAqB,IAAI,IAAI"}
+{"version":3,"file":"data.js","names":[],"sources":["../src/data/flat-map-deep.ts","../src/data/has-enumerable-keys.ts","../src/data/is-shallow-equal.ts","../src/data/is-unsafe-property.ts","../src/data/safe-json-parse.ts","../src/data/to-array.ts"],"sourcesContent":["type DeepArray<TValue> = TValue | Array<DeepArray<TValue>>;\n\n/**\n * Recursively flattens a nested array and maps the collected values.\n *\n * @example\n * ```ts\n * flatMapDeep([1, [2, [3]]], (value) => value * 2); // [2, 4, 6]\n * ```\n */\nexport const flatMapDeep = <TSource, TNewValue>(\n  arr: DeepArray<TSource>,\n  fn: (value: TSource, i: number, arr: TSource[]) => TNewValue,\n): TNewValue[] => {\n  const source: TSource[] = [];\n\n  const collect = (value: DeepArray<TSource>): void => {\n    if (!Array.isArray(value)) {\n      source.push(value);\n      return;\n    }\n\n    for (const item of value) {\n      collect(item);\n    }\n  };\n\n  collect(arr);\n\n  return source.map((value, i) => fn(value, i, source));\n};\n","import type { AnyObject } from 'yummies/types';\n\n/**\n * Checks whether an object has at least one enumerable key.\n *\n * @example\n * ```ts\n * hasEnumerableKeys({ id: 1 }); // true\n * hasEnumerableKeys({}); // false\n * ```\n */\nexport const hasEnumerableKeys = (input: AnyObject): boolean => {\n  for (const _key in input) {\n    return true;\n  }\n  return false;\n};\n","import type { AnyObject } from 'yummies/types';\n\n/**\n * Performs a shallow comparison for arrays, plain objects, dates and regular expressions.\n *\n * @example\n * ```ts\n * isShallowEqual({ id: 1 }, { id: 1 }); // true\n * ```\n */\nexport const isShallowEqual = (a: unknown, b: unknown): boolean => {\n  if (a === b) return true;\n\n  if (\n    typeof a !== 'object' ||\n    typeof b !== 'object' ||\n    a === null ||\n    b === null\n  ) {\n    return false;\n  }\n\n  if (a.constructor !== b.constructor) return false;\n\n  const isArrayA = Array.isArray(a);\n\n  if (isArrayA !== Array.isArray(b)) return false;\n\n  if (isArrayA) {\n    const arrA = a as unknown[];\n    const arrB = b as unknown[];\n    if (arrA.length !== arrB.length) return false;\n\n    for (const [i, element] of arrA.entries()) {\n      if (element !== arrB[i]) return false;\n    }\n    return true;\n  }\n\n  if (a instanceof Date) return a.getTime() === (b as Date).getTime();\n\n  if (a instanceof RegExp) return a.toString() === (b as RegExp).toString();\n\n  const aKeys = Object.keys(a);\n  const bKeys = Object.keys(b);\n\n  if (aKeys.length !== bKeys.length) return false;\n\n  const bObj = b as AnyObject;\n  for (const key of aKeys) {\n    if (!Object.hasOwn(bObj, key) || (a as AnyObject)[key] !== bObj[key]) {\n      return false;\n    }\n  }\n\n  return true;\n};\n","const UNSAFE_PROPERTY_KEYS = new Set(['__proto__', 'prototype', 'constructor']);\n\n/**\n * Checks whether a property key is unsafe and can lead to prototype pollution.\n *\n * @example\n * isUnsafeProperty('__proto__'); // true\n * isUnsafeProperty('name'); // false\n */\nexport const isUnsafeProperty = (key: any) => UNSAFE_PROPERTY_KEYS.has(key);\n","import type { Maybe } from 'yummies/types';\n\n/**\n * Parses JSON safely and returns a fallback value when parsing fails.\n *\n * @example\n * ```ts\n * safeJsonParse('{\"enabled\":true}', {}); // { enabled: true }\n * ```\n */\nexport const safeJsonParse = <TValue = any, TFallback = null>(\n  json: Maybe<string>,\n  fallback: TFallback = null as TFallback,\n): TValue | TFallback => {\n  if (json == null) return fallback;\n\n  try {\n    return JSON.parse(json);\n  } catch {\n    return fallback;\n  }\n};\n","/**\n * Wraps a value in an array when it is not already an array.\n *\n * @example\n * ```ts\n * toArray('item'); // ['item']\n * ```\n */\nexport const toArray = <TValue>(value: TValue | TValue[]): TValue[] => {\n  return Array.isArray(value) ? value : [value];\n};\n"],"mappings":";;;;;;;;;AAUA,IAAa,eACX,KACA,OACgB;CAChB,MAAM,SAAoB,CAAC;CAE3B,MAAM,WAAW,UAAoC;EACnD,IAAI,CAAC,MAAM,QAAQ,KAAK,GAAG;GACzB,OAAO,KAAK,KAAK;GACjB;EACF;EAEA,KAAK,MAAM,QAAQ,OACjB,QAAQ,IAAI;CAEhB;CAEA,QAAQ,GAAG;CAEX,OAAO,OAAO,KAAK,OAAO,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AACtD;;;;;;;;;;;;ACnBA,IAAa,qBAAqB,UAA8B;CAC9D,KAAK,MAAM,QAAQ,OACjB,OAAO;CAET,OAAO;AACT;;;;;;;;;;;ACNA,IAAa,kBAAkB,GAAY,MAAwB;CACjE,IAAI,MAAM,GAAG,OAAO;CAEpB,IACE,OAAO,MAAM,YACb,OAAO,MAAM,YACb,MAAM,QACN,MAAM,MAEN,OAAO;CAGT,IAAI,EAAE,gBAAgB,EAAE,aAAa,OAAO;CAE5C,MAAM,WAAW,MAAM,QAAQ,CAAC;CAEhC,IAAI,aAAa,MAAM,QAAQ,CAAC,GAAG,OAAO;CAE1C,IAAI,UAAU;EACZ,MAAM,OAAO;EACb,MAAM,OAAO;EACb,IAAI,KAAK,WAAW,KAAK,QAAQ,OAAO;EAExC,KAAK,MAAM,CAAC,GAAG,YAAY,KAAK,QAAQ,GACtC,IAAI,YAAY,KAAK,IAAI,OAAO;EAElC,OAAO;CACT;CAEA,IAAI,aAAa,MAAM,OAAO,EAAE,QAAQ,MAAO,EAAW,QAAQ;CAElE,IAAI,aAAa,QAAQ,OAAO,EAAE,SAAS,MAAO,EAAa,SAAS;CAExE,MAAM,QAAQ,OAAO,KAAK,CAAC;CAC3B,MAAM,QAAQ,OAAO,KAAK,CAAC;CAE3B,IAAI,MAAM,WAAW,MAAM,QAAQ,OAAO;CAE1C,MAAM,OAAO;CACb,KAAK,MAAM,OAAO,OAChB,IAAI,CAAC,OAAO,OAAO,MAAM,GAAG,KAAM,EAAgB,SAAS,KAAK,MAC9D,OAAO;CAIX,OAAO;AACT;;;ACxDA,IAAM,uBAAuB,IAAI,IAAI;CAAC;CAAa;CAAa;AAAa,CAAC;;;;;;;;AAS9E,IAAa,oBAAoB,QAAa,qBAAqB,IAAI,GAAG;;;;;;;;;;;ACC1E,IAAa,iBACX,MACA,WAAsB,SACC;CACvB,IAAI,QAAQ,MAAM,OAAO;CAEzB,IAAI;EACF,OAAO,KAAK,MAAM,IAAI;CACxB,QAAQ;EACN,OAAO;CACT;AACF;;;;;;;;;;;ACbA,IAAa,WAAmB,UAAuC;CACrE,OAAO,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC,KAAK;AAC9C"}