@wikicasa-dev/utilities 1.2.8 → 1.2.10

package/dist/index.js

@@ -3,53 +3,52 @@ import { rgba as a } from "./utils/ColorUtils.js";
 import { decodeCookie as i, encodeCookie as l, getCookie as p, removeCookie as n } from "./utils/CookieUtils.js";
 import { formatCurrency as E, formatCurrencyShort as f } from "./utils/CurrencyUtils.js";
 import { formatDate as d, formatDateToddMMYYYY as u, getStartAndEndOfDayUTC as x, subtractDaysFromDate as g } from "./utils/DateUtils.js";
-import { getCurrentDeviceSize as O, isMobile as C, isSafari as y, isWindows as P, isiOSDevice as S } from "./utils/DeviceDetectionUtils.js";
-import { emptyElem as L, getSingleElement as R, hideElem as T, showElem as D } from "./utils/DOMUtils.js";
-import { hash256 as h, hashEmail as G } from "./utils/EmailUtils.js";
-import { debounce as X, isPromise as M } from "./utils/FunctionUtils.js";
+import { getCurrentDeviceSize as O, isMobile as C, isSafari as S, isWindows as y, isiOSDevice as P } from "./utils/DeviceDetectionUtils.js";
+import { emptyElem as D, getSingleElement as L, hideElem as R, showElem as T } from "./utils/DOMUtils.js";
+import { hash256 as G, hashEmail as N } from "./utils/EmailUtils.js";
+import { debounce as h, isPromise as M } from "./utils/FunctionUtils.js";
 import { awaitableSetTimeout as I, createCustomEvent as w } from "./utils/GenericUtils.js";
 import { formatFloat as k, formatInteger as F, formatLocaleNumber as U, formatLocaleNumberAuto as Y, formatNumber as H, formatterNumberObj as W, parseLocaleNumber as z, parseLocaleNumberAuto as Q } from "./utils/NumberUtils.js";
-import { applyMergePatch as B, areObjectsEqual as K, deepCopy as V, getOrDefault as J, getOrNull as Z, invertFlatObject as $, invertKeyToValue as ee, isEmptyObject as oe, shallowCopyObjectTo as re } from "./utils/ObjectUtils.js";
+import { areObjectsEqual as B, deepCopy as K, getOrDefault as V, getOrNull as J, invertFlatObject as Z, invertKeyToValue as $, isEmptyObject as ee, mergeDeep as oe, shallowCopyObjectTo as re } from "./utils/ObjectUtils.js";
 import { observeOnce as ae } from "./utils/ObserverUtils.js";
 import { addPermissionStateListener as ie, onNotificationsPermissionChange as le } from "./utils/PermissionUtils.js";
 import { buildParams as ne, buildURL as se } from "./utils/RESB_UrlBuilder.js";
 import { capitalizeFirstLetter as fe, cleanASCII as ce, decodeTextWithEntities as de, replaceAll as ue, replaceAllTokens as xe, stringToHyphened as ge, strip as be } from "./utils/StringUtils.js";
 import { appendQueryString as Ce } from "./utils/URLBuilderUtils.js";
-import { COMPETITOR_REGEX as Pe, DATE_REGEX as Se, EMAIL_REGEX as Ae, EMAIL_REGEX_INTO_TEXT as Le, EXCLUDED_REGEX as Re, GLOBAL_PHONE_REGEX as Te, PASSWORD_REGEX as De, PHONE_REGEX as _e, ROOMS_REGEX as he, SQM_REGEX as Ge } from "./utils/RegexUtils.js";
-import { browserSupportGeolocation as Xe, getUserPosition as Me } from "./utils/GeolocationUtils.js";
+import { COMPETITOR_REGEX as ye, DATE_REGEX as Pe, EMAIL_REGEX as Ae, EMAIL_REGEX_INTO_TEXT as De, EXCLUDED_REGEX as Le, GLOBAL_PHONE_REGEX as Re, PASSWORD_REGEX as Te, PHONE_REGEX as _e, ROOMS_REGEX as Ge, SQM_REGEX as Ne } from "./utils/RegexUtils.js";
+import { browserSupportGeolocation as he, getUserPosition as Me } from "./utils/GeolocationUtils.js";
 import { formatAddress as Ie, formattedAddress as we } from "./utils/AdressUtils.js";
 import { googlePlaceConverter as ke } from "./utils/GAutocompleteUtils.js";
 import { downloadFile as Ue } from "./utils/DownloadUtils.js";
 import { calcPolygonCenter as He, encodePolygon as We, getMinMaxLatLng as ze, getPolygonString as Qe, parsePoints as qe, removeDuplicatePoints as Be } from "./utils/MapUtils.js";
 export {
-  Pe as COMPETITOR_REGEX,
-  Se as DATE_REGEX,
+  ye as COMPETITOR_REGEX,
+  Pe as DATE_REGEX,
   Ae as EMAIL_REGEX,
-  Le as EMAIL_REGEX_INTO_TEXT,
-  Re as EXCLUDED_REGEX,
-  Te as GLOBAL_PHONE_REGEX,
-  De as PASSWORD_REGEX,
+  De as EMAIL_REGEX_INTO_TEXT,
+  Le as EXCLUDED_REGEX,
+  Re as GLOBAL_PHONE_REGEX,
+  Te as PASSWORD_REGEX,
   _e as PHONE_REGEX,
-  he as ROOMS_REGEX,
-  Ge as SQM_REGEX,
+  Ge as ROOMS_REGEX,
+  Ne as SQM_REGEX,
   ie as addPermissionStateListener,
   Ce as appendQueryString,
-  B as applyMergePatch,
-  K as areObjectsEqual,
+  B as areObjectsEqual,
   I as awaitableSetTimeout,
-  Xe as browserSupportGeolocation,
+  he as browserSupportGeolocation,
   ne as buildParams,
   se as buildURL,
   He as calcPolygonCenter,
   fe as capitalizeFirstLetter,
   ce as cleanASCII,
   w as createCustomEvent,
-  X as debounce,
+  h as debounce,
   i as decodeCookie,
   de as decodeTextWithEntities,
-  V as deepCopy,
+  K as deepCopy,
   Ue as downloadFile,
-  L as emptyElem,
+  D as emptyElem,
   l as encodeCookie,
   We as encodePolygon,
   Ie as formatAddress,
@@ -67,25 +66,26 @@ export {
   p as getCookie,
   O as getCurrentDeviceSize,
   ze as getMinMaxLatLng,
-  J as getOrDefault,
-  Z as getOrNull,
+  V as getOrDefault,
+  J as getOrNull,
   Qe as getPolygonString,
-  R as getSingleElement,
+  L as getSingleElement,
   x as getStartAndEndOfDayUTC,
   Me as getUserPosition,
   ke as googlePlaceConverter,
-  h as hash256,
-  G as hashEmail,
-  T as hideElem,
-  $ as invertFlatObject,
-  ee as invertKeyToValue,
+  G as hash256,
+  N as hashEmail,
+  R as hideElem,
+  Z as invertFlatObject,
+  $ as invertKeyToValue,
   r as isArrNullOrEmpty,
-  oe as isEmptyObject,
+  ee as isEmptyObject,
   C as isMobile,
   M as isPromise,
-  y as isSafari,
-  P as isWindows,
-  S as isiOSDevice,
+  S as isSafari,
+  y as isWindows,
+  P as isiOSDevice,
+  oe as mergeDeep,
   ae as observeOnce,
   le as onNotificationsPermissionChange,
   z as parseLocaleNumber,
@@ -97,7 +97,7 @@ export {
   xe as replaceAllTokens,
   a as rgba,
   re as shallowCopyObjectTo,
-  D as showElem,
+  T as showElem,
   ge as stringToHyphened,
   be as strip,
   g as subtractDaysFromDate

package/dist/utils/ObjectUtils.d.ts

@@ -1,12 +1,8 @@
 import { Nullable, Optional } from '@wikicasa-dev/types';
 import { FlatInvert, InvertKeyToValue } from '../types/ObjectUtilsTypes';
 export type JsonPrimitive = string | number | boolean | null;
-export type JsonValue = JsonPrimitive | JsonValue[] | {
-    [key: string]: unknown;
-};
-export type JsonObject = {
-    [key: string]: JsonValue;
-};
+export type JsonValue = JsonPrimitive | JsonValue[] | Record<string, unknown>;
+export type JsonObject = Record<string, unknown>;
 export type MergePatch<T> = T extends JsonValue[] ? T : T extends object ? {
     [K in keyof T]?: MergePatch<T[K]> | null;
 } : T;
@@ -69,42 +65,51 @@ export declare const getOrDefault: <T>(value: T, defaultValue: NonNullable<T>) =
  */
 export declare const areObjectsEqual: (obj1?: object, obj2?: object) => boolean;
 /**
- * Applies a JSON Merge Patch (RFC 7396) to a source JSON object.
+ * Deeply merges a patch object into a source object.
  *
- * This function performs a deep, recursive merge between `source` and `patch`
- * following the JSON Merge Patch specification:
+ * This utility is designed for application state updates rather than API
+ * payload patching.
  *
+ * Merge rules:
+ *
+ * - `undefined` values remove the corresponding property.
+ * - `null` values are preserved and explicitly set the property to `null`.
  * - Objects are merged recursively.
- * - Arrays are replaced (not merged).
- * - Primitive values are replaced.
- * - `null` values in the patch explicitly remove the property.
+ * - Arrays are replaced entirely.
+ * - Primitive values replace the existing value.
+ *
+ * The function does not mutate the source object or the patch object.
  *
- * ### Example
+ * @example
  * ```ts
  * const source = {
- *   a: 1,
- *   b: { c: 2, d: 3 },
+ *   name: "John",
+ *   address: {
+ *     city: "Rome",
+ *     zip: "00100",
+ *   },
  * };
  *
  * const patch = {
- *   a: null,
- *   b: { d: 4 },
+ *   name: undefined,
+ *   address: {
+ *     city: null,
+ *   },
  * };
  *
- * const result = applyMergePatch(source, patch);
+ * const result = mergeDeep(source, patch);
+ *
  * // {
- * //   b: { c: 2, d: 4 }
+ * //   address: {
+ * //     city: null,
+ * //     zip: "00100",
+ * //   },
  * // }
  * ```
  *
- * ### Notes
- * - Only JSON-compatible values are supported.
- * - The function does not mutate the input objects.
- * - Non-object values (including arrays) are replaced entirely.
- *
- * @template T - Source object type
- * @param source - The original JSON object to apply the patch to.
- * @param patch - The JSON Merge Patch object describing changes.
- * @returns A new object resulting from applying the patch.
+ * @template T The source object type.
+ * @param source The original object to merge into.
+ * @param patch The partial update object.
+ * @returns A new object containing the merged result.
  */
-export declare const applyMergePatch: <T extends JsonObject>(source: T, patch: MergePatch<T>) => T;
+export declare const mergeDeep: <T extends object>(source: T, patch: MergePatch<T>) => T;

package/dist/utils/ObjectUtils.js

@@ -4,7 +4,7 @@ function u(e, t) {
       t[r] = e[r];
 }
 const y = (e) => !e || !Object.keys(e).length;
-function a(e) {
+function O(e) {
   if (!e) return null;
   for (const t in e) {
     const r = e[t];
@@ -13,13 +13,13 @@ function a(e) {
   }
   return { ...e };
 }
-const O = (e) => Object.entries(e).reduce(
+const a = (e) => Object.entries(e).reduce(
   (t, [r, n]) => (t[n] = r, t),
   {}
 ), g = (e) => Object.keys(e).reduce(
   (t, r) => (t[r] = r, t),
   {}
-), p = (e) => e ?? null, d = (e, t) => e ?? t, c = (e = {}, t = {}) => {
+), d = (e) => e ?? null, o = (e, t) => e ?? t, c = (e = {}, t = {}) => {
   if (e === null || t === null || e === void 0 || t === void 0 || typeof e != "object" && typeof t != "object")
     return e === t;
   if (e instanceof Date && t instanceof Date)
@@ -34,28 +34,26 @@ const O = (e) => Object.entries(e).reduce(
       t[s]
     )
   );
-}, l = (e) => e !== null && typeof e == "object" && !Array.isArray(e);
-function f(e, t) {
-  if (t === null)
+}, l = (e) => e !== null && typeof e == "object" && !Array.isArray(e), f = (e, t) => {
+  if (t === void 0)
     return;
   if (!l(e) || !l(t))
     return t;
   const r = { ...e };
   for (const n of Object.keys(t)) {
-    const s = t[n], i = f(e[n], s);
+    const s = t[n], i = f(r[n], s);
     i === void 0 ? delete r[n] : r[n] = i;
   }
   return r;
-}
-const k = (e, t) => f(e, t);
+}, p = (e, t) => f(e, t);
 export {
-  k as applyMergePatch,
   c as areObjectsEqual,
-  a as deepCopy,
-  d as getOrDefault,
-  p as getOrNull,
-  O as invertFlatObject,
+  O as deepCopy,
+  o as getOrDefault,
+  d as getOrNull,
+  a as invertFlatObject,
   g as invertKeyToValue,
   y as isEmptyObject,
+  p as mergeDeep,
   u as shallowCopyObjectTo
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wikicasa-dev/utilities",
-  "version": "1.2.8",
+  "version": "1.2.10",
   "description": "Wikicasa frontend utilities",
   "type": "module",
   "main": "dist/index.js",