yummies 7.11.0 → 7.13.0

package/data.cjs

@@ -1,65 +1,100 @@
-"use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const isShallowEqual = (a, b) => {
-  if (a === b) return true;
-  if (typeof a !== "object" || typeof b !== "object" || a === null || b === null) {
-    return false;
-  }
-  if (a.constructor !== b.constructor) return false;
-  const isArrayA = Array.isArray(a);
-  if (isArrayA !== Array.isArray(b)) return false;
-  if (isArrayA) {
-    const arrA = a;
-    const arrB = b;
-    if (arrA.length !== arrB.length) return false;
-    for (const [i, element] of arrA.entries()) {
-      if (element !== arrB[i]) return false;
-    }
-    return true;
-  }
-  if (a instanceof Date) return a.getTime() === b.getTime();
-  if (a instanceof RegExp) return a.toString() === b.toString();
-  const aKeys = Object.keys(a);
-  const bKeys = Object.keys(b);
-  if (aKeys.length !== bKeys.length) return false;
-  const bObj = b;
-  for (const key of aKeys) {
-    if (!Object.hasOwn(bObj, key) || a[key] !== bObj[key]) {
-      return false;
-    }
-  }
-  return true;
+//#region src/data.ts
+/**
+* Performs a shallow comparison for arrays, plain objects, dates and regular expressions.
+*
+* @example
+* ```ts
+* isShallowEqual({ id: 1 }, { id: 1 }); // true
+* ```
+*/
+var isShallowEqual = (a, b) => {
+	if (a === b) return true;
+	if (typeof a !== "object" || typeof b !== "object" || a === null || b === null) return false;
+	if (a.constructor !== b.constructor) return false;
+	const isArrayA = Array.isArray(a);
+	if (isArrayA !== Array.isArray(b)) return false;
+	if (isArrayA) {
+		const arrA = a;
+		const arrB = b;
+		if (arrA.length !== arrB.length) return false;
+		for (const [i, element] of arrA.entries()) if (element !== arrB[i]) return false;
+		return true;
+	}
+	if (a instanceof Date) return a.getTime() === b.getTime();
+	if (a instanceof RegExp) return a.toString() === b.toString();
+	const aKeys = Object.keys(a);
+	const bKeys = Object.keys(b);
+	if (aKeys.length !== bKeys.length) return false;
+	const bObj = b;
+	for (const key of aKeys) if (!Object.hasOwn(bObj, key) || a[key] !== bObj[key]) return false;
+	return true;
 };
-const toArray = (value) => {
-  return Array.isArray(value) ? value : [value];
+/**
+* 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];
 };
-const 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));
+/**
+* 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));
 };
-const safeJsonParse = (json, fallback = null) => {
-  if (json == null) return fallback;
-  try {
-    return JSON.parse(json);
-  } catch {
-    return fallback;
-  }
+/**
+* Parses JSON safely and returns a fallback value when parsing fails.
+*
+* @example
+* ```ts
+* safeJsonParse('{"enabled":true}', {}); // { enabled: true }
+* ```
+*/
+var safeJsonParse = (json, fallback = null) => {
+	if (json == null) return fallback;
+	try {
+		return JSON.parse(json);
+	} catch {
+		return fallback;
+	}
 };
-const UNSAFE_PROPERTY_KEYS = /* @__PURE__ */ new Set(["__proto__", "prototype", "constructor"]);
-const isUnsafeProperty = (key) => UNSAFE_PROPERTY_KEYS.has(key);
+var UNSAFE_PROPERTY_KEYS = new Set([
+	"__proto__",
+	"prototype",
+	"constructor"
+]);
+/**
+* Checks whether a property key is unsafe and can lead to prototype pollution.
+*
+* @example
+* isUnsafeProperty('__proto__'); // true
+* isUnsafeProperty('name'); // false
+*/
+var isUnsafeProperty = (key) => UNSAFE_PROPERTY_KEYS.has(key);
+//#endregion
 exports.flatMapDeep = flatMapDeep;
 exports.isShallowEqual = isShallowEqual;
 exports.isUnsafeProperty = isUnsafeProperty;
 exports.safeJsonParse = safeJsonParse;
 exports.toArray = toArray;
-//# sourceMappingURL=data.cjs.map
+
+//# sourceMappingURL=data.cjs.map

package/data.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"data.cjs","sources":["../src/data.ts"],"sourcesContent":["import type { AnyObject, Maybe } from 'yummies/types';\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\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\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\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"],"names":[],"mappings":";;AAEO,MAAM,iBAAiB,CAAC,GAAY,MAAwB;AACjE,MAAI,MAAM,EAAG,QAAO;AAEpB,MACE,OAAO,MAAM,YACb,OAAO,MAAM,YACb,MAAM,QACN,MAAM,MACN;AACA,WAAO;AAAA,EACT;AAEA,MAAI,EAAE,gBAAgB,EAAE,YAAa,QAAO;AAE5C,QAAM,WAAW,MAAM,QAAQ,CAAC;AAEhC,MAAI,aAAa,MAAM,QAAQ,CAAC,EAAG,QAAO;AAE1C,MAAI,UAAU;AACZ,UAAM,OAAO;AACb,UAAM,OAAO;AACb,QAAI,KAAK,WAAW,KAAK,OAAQ,QAAO;AAExC,eAAW,CAAC,GAAG,OAAO,KAAK,KAAK,WAAW;AACzC,UAAI,YAAY,KAAK,CAAC,EAAG,QAAO;AAAA,IAClC;AACA,WAAO;AAAA,EACT;AAEA,MAAI,aAAa,KAAM,QAAO,EAAE,QAAA,MAAe,EAAW,QAAA;AAE1D,MAAI,aAAa,OAAQ,QAAO,EAAE,SAAA,MAAgB,EAAa,SAAA;AAE/D,QAAM,QAAQ,OAAO,KAAK,CAAC;AAC3B,QAAM,QAAQ,OAAO,KAAK,CAAC;AAE3B,MAAI,MAAM,WAAW,MAAM,OAAQ,QAAO;AAE1C,QAAM,OAAO;AACb,aAAW,OAAO,OAAO;AACvB,QAAI,CAAC,OAAO,OAAO,MAAM,GAAG,KAAM,EAAgB,GAAG,MAAM,KAAK,GAAG,GAAG;AACpE,aAAO;AAAA,IACT;AAAA,EACF;AAEA,SAAO;AACT;AAEO,MAAM,UAAU,CAAS,UAAuC;AACrE,SAAO,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC,KAAK;AAC9C;AAIO,MAAM,cAAc,CACzB,KACA,OACgB;AAChB,QAAM,SAAoB,CAAA;AAE1B,QAAM,UAAU,CAAC,UAAoC;AACnD,QAAI,CAAC,MAAM,QAAQ,KAAK,GAAG;AACzB,aAAO,KAAK,KAAK;AACjB;AAAA,IACF;AAEA,eAAW,QAAQ,OAAO;AACxB,cAAQ,IAAI;AAAA,IACd;AAAA,EACF;AAEA,UAAQ,GAAG;AAEX,SAAO,OAAO,IAAI,CAAC,OAAO,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AACtD;AAEO,MAAM,gBAAgB,CAC3B,MACA,WAAsB,SACC;AACvB,MAAI,QAAQ,KAAM,QAAO;AAEzB,MAAI;AACF,WAAO,KAAK,MAAM,IAAI;AAAA,EACxB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,MAAM,uBAAuB,oBAAI,IAAI,CAAC,aAAa,aAAa,aAAa,CAAC;AASvE,MAAM,mBAAmB,CAAC,QAAa,qBAAqB,IAAI,GAAG;;;;;;"}
+{"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 * 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;;;;;;;;;;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"}

package/data.d.ts

@@ -1,9 +1,59 @@
 import { Maybe } from 'yummies/types';
 
+/**
+ * ---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.
+ *
+ * @example
+ * ```ts
+ * isShallowEqual({ id: 1 }, { id: 1 }); // true
+ * ```
+ */
 declare const isShallowEqual: (a: unknown, b: unknown) => boolean;
+/**
+ * Wraps a value in an array when it is not already an array.
+ *
+ * @example
+ * ```ts
+ * toArray('item'); // ['item']
+ * ```
+ */
 declare const toArray: <TValue>(value: TValue | TValue[]) => TValue[];
 type DeepArray<TValue> = TValue | Array<DeepArray<TValue>>;
+/**
+ * Recursively flattens a nested array and maps the collected values.
+ *
+ * @example
+ * ```ts
+ * flatMapDeep([1, [2, [3]]], (value) => value * 2); // [2, 4, 6]
+ * ```
+ */
 declare const flatMapDeep: <TSource, TNewValue>(arr: DeepArray<TSource>, fn: (value: TSource, i: number, arr: TSource[]) => TNewValue) => TNewValue[];
+/**
+ * Parses JSON safely and returns a fallback value when parsing fails.
+ *
+ * @example
+ * ```ts
+ * safeJsonParse('{"enabled":true}', {}); // { enabled: true }
+ * ```
+ */
 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.

package/data.js

@@ -1,65 +1,95 @@
-const isShallowEqual = (a, b) => {
-  if (a === b) return true;
-  if (typeof a !== "object" || typeof b !== "object" || a === null || b === null) {
-    return false;
-  }
-  if (a.constructor !== b.constructor) return false;
-  const isArrayA = Array.isArray(a);
-  if (isArrayA !== Array.isArray(b)) return false;
-  if (isArrayA) {
-    const arrA = a;
-    const arrB = b;
-    if (arrA.length !== arrB.length) return false;
-    for (const [i, element] of arrA.entries()) {
-      if (element !== arrB[i]) return false;
-    }
-    return true;
-  }
-  if (a instanceof Date) return a.getTime() === b.getTime();
-  if (a instanceof RegExp) return a.toString() === b.toString();
-  const aKeys = Object.keys(a);
-  const bKeys = Object.keys(b);
-  if (aKeys.length !== bKeys.length) return false;
-  const bObj = b;
-  for (const key of aKeys) {
-    if (!Object.hasOwn(bObj, key) || a[key] !== bObj[key]) {
-      return false;
-    }
-  }
-  return true;
+//#region src/data.ts
+/**
+* Performs a shallow comparison for arrays, plain objects, dates and regular expressions.
+*
+* @example
+* ```ts
+* isShallowEqual({ id: 1 }, { id: 1 }); // true
+* ```
+*/
+var isShallowEqual = (a, b) => {
+	if (a === b) return true;
+	if (typeof a !== "object" || typeof b !== "object" || a === null || b === null) return false;
+	if (a.constructor !== b.constructor) return false;
+	const isArrayA = Array.isArray(a);
+	if (isArrayA !== Array.isArray(b)) return false;
+	if (isArrayA) {
+		const arrA = a;
+		const arrB = b;
+		if (arrA.length !== arrB.length) return false;
+		for (const [i, element] of arrA.entries()) if (element !== arrB[i]) return false;
+		return true;
+	}
+	if (a instanceof Date) return a.getTime() === b.getTime();
+	if (a instanceof RegExp) return a.toString() === b.toString();
+	const aKeys = Object.keys(a);
+	const bKeys = Object.keys(b);
+	if (aKeys.length !== bKeys.length) return false;
+	const bObj = b;
+	for (const key of aKeys) if (!Object.hasOwn(bObj, key) || a[key] !== bObj[key]) return false;
+	return true;
 };
-const toArray = (value) => {
-  return Array.isArray(value) ? value : [value];
+/**
+* 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];
 };
-const 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));
+/**
+* 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));
 };
-const safeJsonParse = (json, fallback = null) => {
-  if (json == null) return fallback;
-  try {
-    return JSON.parse(json);
-  } catch {
-    return fallback;
-  }
+/**
+* Parses JSON safely and returns a fallback value when parsing fails.
+*
+* @example
+* ```ts
+* safeJsonParse('{"enabled":true}', {}); // { enabled: true }
+* ```
+*/
+var safeJsonParse = (json, fallback = null) => {
+	if (json == null) return fallback;
+	try {
+		return JSON.parse(json);
+	} catch {
+		return fallback;
+	}
 };
-const UNSAFE_PROPERTY_KEYS = /* @__PURE__ */ new Set(["__proto__", "prototype", "constructor"]);
-const isUnsafeProperty = (key) => UNSAFE_PROPERTY_KEYS.has(key);
-export {
-  flatMapDeep,
-  isShallowEqual,
-  isUnsafeProperty,
-  safeJsonParse,
-  toArray
-};
-//# sourceMappingURL=data.js.map
+var UNSAFE_PROPERTY_KEYS = new Set([
+	"__proto__",
+	"prototype",
+	"constructor"
+]);
+/**
+* Checks whether a property key is unsafe and can lead to prototype pollution.
+*
+* @example
+* isUnsafeProperty('__proto__'); // true
+* isUnsafeProperty('name'); // false
+*/
+var isUnsafeProperty = (key) => UNSAFE_PROPERTY_KEYS.has(key);
+//#endregion
+export { flatMapDeep, isShallowEqual, isUnsafeProperty, safeJsonParse, toArray };
+
+//# sourceMappingURL=data.js.map

package/data.js.map

@@ -1 +1 @@
-{"version":3,"file":"data.js","sources":["../src/data.ts"],"sourcesContent":["import type { AnyObject, Maybe } from 'yummies/types';\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\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\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\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"],"names":[],"mappings":"AAEO,MAAM,iBAAiB,CAAC,GAAY,MAAwB;AACjE,MAAI,MAAM,EAAG,QAAO;AAEpB,MACE,OAAO,MAAM,YACb,OAAO,MAAM,YACb,MAAM,QACN,MAAM,MACN;AACA,WAAO;AAAA,EACT;AAEA,MAAI,EAAE,gBAAgB,EAAE,YAAa,QAAO;AAE5C,QAAM,WAAW,MAAM,QAAQ,CAAC;AAEhC,MAAI,aAAa,MAAM,QAAQ,CAAC,EAAG,QAAO;AAE1C,MAAI,UAAU;AACZ,UAAM,OAAO;AACb,UAAM,OAAO;AACb,QAAI,KAAK,WAAW,KAAK,OAAQ,QAAO;AAExC,eAAW,CAAC,GAAG,OAAO,KAAK,KAAK,WAAW;AACzC,UAAI,YAAY,KAAK,CAAC,EAAG,QAAO;AAAA,IAClC;AACA,WAAO;AAAA,EACT;AAEA,MAAI,aAAa,KAAM,QAAO,EAAE,QAAA,MAAe,EAAW,QAAA;AAE1D,MAAI,aAAa,OAAQ,QAAO,EAAE,SAAA,MAAgB,EAAa,SAAA;AAE/D,QAAM,QAAQ,OAAO,KAAK,CAAC;AAC3B,QAAM,QAAQ,OAAO,KAAK,CAAC;AAE3B,MAAI,MAAM,WAAW,MAAM,OAAQ,QAAO;AAE1C,QAAM,OAAO;AACb,aAAW,OAAO,OAAO;AACvB,QAAI,CAAC,OAAO,OAAO,MAAM,GAAG,KAAM,EAAgB,GAAG,MAAM,KAAK,GAAG,GAAG;AACpE,aAAO;AAAA,IACT;AAAA,EACF;AAEA,SAAO;AACT;AAEO,MAAM,UAAU,CAAS,UAAuC;AACrE,SAAO,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC,KAAK;AAC9C;AAIO,MAAM,cAAc,CACzB,KACA,OACgB;AAChB,QAAM,SAAoB,CAAA;AAE1B,QAAM,UAAU,CAAC,UAAoC;AACnD,QAAI,CAAC,MAAM,QAAQ,KAAK,GAAG;AACzB,aAAO,KAAK,KAAK;AACjB;AAAA,IACF;AAEA,eAAW,QAAQ,OAAO;AACxB,cAAQ,IAAI;AAAA,IACd;AAAA,EACF;AAEA,UAAQ,GAAG;AAEX,SAAO,OAAO,IAAI,CAAC,OAAO,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AACtD;AAEO,MAAM,gBAAgB,CAC3B,MACA,WAAsB,SACC;AACvB,MAAI,QAAQ,KAAM,QAAO;AAEzB,MAAI;AACF,WAAO,KAAK,MAAM,IAAI;AAAA,EACxB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,MAAM,uBAAuB,oBAAI,IAAI,CAAC,aAAa,aAAa,aAAa,CAAC;AASvE,MAAM,mBAAmB,CAAC,QAAa,qBAAqB,IAAI,GAAG;"}
+{"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 * 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;;;;;;;;;;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"}