yummies 7.5.0 → 7.7.0

package/data.cjs

@@ -31,11 +31,11 @@ const isShallowEqual = (a, b) => {
   return true;
 };
 const flatMapDeep = (arr, fn) => Array.isArray(arr) ? arr.flatMap((c) => flatMapDeep(c, fn)) : [fn(arr, 0, [arr])];
-const safeJsonParse = (json) => {
+const safeJsonParse = (json, fallback = null) => {
   try {
     return JSON.parse(json);
   } catch {
-    return null;
+    return fallback;
   }
 };
 exports.flatMapDeep = flatMapDeep;

package/data.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"data.cjs","sources":["../src/data.ts"],"sourcesContent":["import type { AnyObject } 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 flatMapDeep = <TSource, TNewValue>(\n  arr: TSource | TSource[],\n  fn: (value: TSource, i: number, arr: TSource[]) => TNewValue,\n): TNewValue[] =>\n  Array.isArray(arr)\n    ? arr.flatMap((c: TSource): TNewValue[] => flatMapDeep(c, fn))\n    : [fn(arr, 0, [arr])];\n\nexport const safeJsonParse = (json: string) => {\n  try {\n    return JSON.parse(json);\n  } catch {\n    return null;\n  }\n};\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,cAAc,CACzB,KACA,OAEA,MAAM,QAAQ,GAAG,IACb,IAAI,QAAQ,CAAC,MAA4B,YAAY,GAAG,EAAE,CAAC,IAC3D,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC;AAEjB,MAAM,gBAAgB,CAAC,SAAiB;AAC7C,MAAI;AACF,WAAO,KAAK,MAAM,IAAI;AAAA,EACxB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;;;;"}
+{"version":3,"file":"data.cjs","sources":["../src/data.ts"],"sourcesContent":["import type { AnyObject } 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 flatMapDeep = <TSource, TNewValue>(\n  arr: TSource | TSource[],\n  fn: (value: TSource, i: number, arr: TSource[]) => TNewValue,\n): TNewValue[] =>\n  Array.isArray(arr)\n    ? arr.flatMap((c: TSource): TNewValue[] => flatMapDeep(c, fn))\n    : [fn(arr, 0, [arr])];\n\nexport const safeJsonParse = <TValue = any, TFallback = null>(\n  json: string,\n  fallback: TFallback = null as TFallback,\n): TValue | TFallback => {\n  try {\n    return JSON.parse(json);\n  } catch {\n    return fallback;\n  }\n};\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,cAAc,CACzB,KACA,OAEA,MAAM,QAAQ,GAAG,IACb,IAAI,QAAQ,CAAC,MAA4B,YAAY,GAAG,EAAE,CAAC,IAC3D,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC;AAEjB,MAAM,gBAAgB,CAC3B,MACA,WAAsB,SACC;AACvB,MAAI;AACF,WAAO,KAAK,MAAM,IAAI;AAAA,EACxB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;;;;"}

package/data.d.ts

@@ -1,5 +1,5 @@
 declare const isShallowEqual: (a: unknown, b: unknown) => boolean;
 declare const flatMapDeep: <TSource, TNewValue>(arr: TSource | TSource[], fn: (value: TSource, i: number, arr: TSource[]) => TNewValue) => TNewValue[];
-declare const safeJsonParse: (json: string) => any;
+declare const safeJsonParse: <TValue = any, TFallback = null>(json: string, fallback?: TFallback) => TValue | TFallback;
 
 export { flatMapDeep, isShallowEqual, safeJsonParse };

package/data.js

@@ -29,11 +29,11 @@ const isShallowEqual = (a, b) => {
   return true;
 };
 const flatMapDeep = (arr, fn) => Array.isArray(arr) ? arr.flatMap((c) => flatMapDeep(c, fn)) : [fn(arr, 0, [arr])];
-const safeJsonParse = (json) => {
+const safeJsonParse = (json, fallback = null) => {
   try {
     return JSON.parse(json);
   } catch {
-    return null;
+    return fallback;
   }
 };
 export {

package/data.js.map

@@ -1 +1 @@
-{"version":3,"file":"data.js","sources":["../src/data.ts"],"sourcesContent":["import type { AnyObject } 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 flatMapDeep = <TSource, TNewValue>(\n  arr: TSource | TSource[],\n  fn: (value: TSource, i: number, arr: TSource[]) => TNewValue,\n): TNewValue[] =>\n  Array.isArray(arr)\n    ? arr.flatMap((c: TSource): TNewValue[] => flatMapDeep(c, fn))\n    : [fn(arr, 0, [arr])];\n\nexport const safeJsonParse = (json: string) => {\n  try {\n    return JSON.parse(json);\n  } catch {\n    return null;\n  }\n};\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,cAAc,CACzB,KACA,OAEA,MAAM,QAAQ,GAAG,IACb,IAAI,QAAQ,CAAC,MAA4B,YAAY,GAAG,EAAE,CAAC,IAC3D,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC;AAEjB,MAAM,gBAAgB,CAAC,SAAiB;AAC7C,MAAI;AACF,WAAO,KAAK,MAAM,IAAI;AAAA,EACxB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;"}
+{"version":3,"file":"data.js","sources":["../src/data.ts"],"sourcesContent":["import type { AnyObject } 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 flatMapDeep = <TSource, TNewValue>(\n  arr: TSource | TSource[],\n  fn: (value: TSource, i: number, arr: TSource[]) => TNewValue,\n): TNewValue[] =>\n  Array.isArray(arr)\n    ? arr.flatMap((c: TSource): TNewValue[] => flatMapDeep(c, fn))\n    : [fn(arr, 0, [arr])];\n\nexport const safeJsonParse = <TValue = any, TFallback = null>(\n  json: string,\n  fallback: TFallback = null as TFallback,\n): TValue | TFallback => {\n  try {\n    return JSON.parse(json);\n  } catch {\n    return fallback;\n  }\n};\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,cAAc,CACzB,KACA,OAEA,MAAM,QAAQ,GAAG,IACb,IAAI,QAAQ,CAAC,MAA4B,YAAY,GAAG,EAAE,CAAC,IAC3D,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC;AAEjB,MAAM,gBAAgB,CAC3B,MACA,WAAsB,SACC;AACvB,MAAI;AACF,WAAO,KAAK,MAAM,IAAI;AAAA,EACxB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yummies",
-  "version": "7.5.0",
+  "version": "7.7.0",
   "keywords": [
     "javascript",
     "typescript",

package/types.d.ts

@@ -139,6 +139,16 @@ type DeepPartial<T> = T extends BrowserNativeObject ? T : {
  * @returns A type with specified keys optional and others required
  */
 type PartialKeys<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+/**
+ * Makes specified keys of a type possibly Maybe<T> while keeping the rest required.
+ *
+ * @template T - The original type
+ * @template TMaybeKeys - The keys to make possibly Maybe<T>
+ * @returns A type with specified keys possibly Maybe<T> and others required
+ */
+type MaybeKeys<T, TMaybeKeys extends keyof T> = {
+    [K in keyof T]: K extends TMaybeKeys ? Maybe<T[K]> : T[K];
+};
 /**
  * Makes specified keys of a type required while keeping the rest optional.
  *
@@ -444,4 +454,4 @@ type AnyBoolean = boolean & {};
  */
 type UpperFirst<S extends string> = S extends `${infer F}${infer R}` ? `${Uppercase<F>}${R}` : S;
 
-export type { AllPropertiesOptional, AnyBoolean, AnyFunction, AnyNumber, AnyObject, AnyPrimitive, AnyString, BrowserNativeObject, Class, CopyObject, DeepPartial, Defined, Dict, EmptyObject, ExtractEnumKeys, ExtractEnumValues, ExtractObjects, FalsyValues, Fn, HasKey, HasSpecificKey, IfEquals, IndexKeys, IsAny, IsArray, IsEmptyArray, IsFunction, IsObject, IsObjectEmpty, IsPartial, IsUnknown, KeyOfByValue, LiteralUnion, Maybe, MaybeArray, MaybeFalsy, MaybeFn, MaybePromise, MaybeValues, NonReadonly, NonUndefined, NotMaybe, NotNullable, Nullable, OmitByValue, OverrideKey, Params, PartialIf, PartialKeys, PickByValue, Primitive, ReadonlyKeys, RecordEntries, RenameKey, RequiredKeys, UnionToIntersection, Unpromise, UpperFirst, ValueOf, WithRequired, WritableKeys };
+export type { AllPropertiesOptional, AnyBoolean, AnyFunction, AnyNumber, AnyObject, AnyPrimitive, AnyString, BrowserNativeObject, Class, CopyObject, DeepPartial, Defined, Dict, EmptyObject, ExtractEnumKeys, ExtractEnumValues, ExtractObjects, FalsyValues, Fn, HasKey, HasSpecificKey, IfEquals, IndexKeys, IsAny, IsArray, IsEmptyArray, IsFunction, IsObject, IsObjectEmpty, IsPartial, IsUnknown, KeyOfByValue, LiteralUnion, Maybe, MaybeArray, MaybeFalsy, MaybeFn, MaybeKeys, MaybePromise, MaybeValues, NonReadonly, NonUndefined, NotMaybe, NotNullable, Nullable, OmitByValue, OverrideKey, Params, PartialIf, PartialKeys, PickByValue, Primitive, ReadonlyKeys, RecordEntries, RenameKey, RequiredKeys, UnionToIntersection, Unpromise, UpperFirst, ValueOf, WithRequired, WritableKeys };

package/types.global.d.ts

@@ -140,6 +140,16 @@ type DeepPartial<T> = T extends BrowserNativeObject ? T : {
  * @returns A type with specified keys optional and others required
  */
 type PartialKeys<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+/**
+ * Makes specified keys of a type possibly Maybe<T> while keeping the rest required.
+ *
+ * @template T - The original type
+ * @template TMaybeKeys - The keys to make possibly Maybe<T>
+ * @returns A type with specified keys possibly Maybe<T> and others required
+ */
+type MaybeKeys<T, TMaybeKeys extends keyof T> = {
+    [K in keyof T]: K extends TMaybeKeys ? Maybe<T[K]> : T[K];
+};
 /**
  * Makes specified keys of a type required while keeping the rest optional.
  *