@naturalcycles/js-lib 14.110.0 → 14.111.0

package/dist/object/object.util.d.ts

@@ -135,19 +135,19 @@ export declare function _invert<T extends AnyObject>(o: T): {
 };
 export declare function _invertMap<K, V>(m: ReadonlyMap<K, V>): Map<V, K>;
 /**
- * Gets the property value at path of object. If the resolved value is undefined the defaultValue is used
- * in its place.
+ * Gets the property value at path of object.
  *
- * @param obj The object to query.
- * @param path The path of the property to get.
- * @param def The value returned if the resolved value is undefined.
- * @return Returns the resolved value.
+ * @example
+ * const obj = {a: 'a', b: 'b', c: { cc: 'cc' }}
+ * _get(obj, 'a') // 'a'
+ * _get(obj, 'c.cc') // 'cc'
+ * _get(obj, 'c[cc]') // 'cc'
+ * _get(obj, 'unknown.path') // undefined
  */
-export declare function _get<T extends AnyObject>(obj?: T, path?: string, def?: any): any;
+export declare function _get<T extends AnyObject>(obj?: T, path?: string): unknown;
 /**
  * Sets the value at path of object. If a portion of path doesn’t exist it’s created. Arrays are created for
- * missing index properties while objects are created for all other missing properties. Use _.setWith to
- * customize path creation.
+ * missing index properties while objects are created for all other missing properties.
  *
  * @param obj The object to modify.
  * @param path The path of the property to set.
@@ -156,7 +156,7 @@ export declare function _get<T extends AnyObject>(obj?: T, path?: string, def?:
  *
  * Based on: https://stackoverflow.com/a/54733755/4919972
  */
-export declare function _set<IN extends AnyObject, OUT = IN>(obj: IN, path: PropertyPath, value?: any): OUT;
+export declare function _set<T extends AnyObject>(obj: T, path: PropertyPath, value: any): T;
 /**
  * Checks if `path` is a direct property of `object` (not null, not undefined).
  *
@@ -181,4 +181,4 @@ export declare function _set<IN extends AnyObject, OUT = IN>(obj: IN, path: Prop
  * _.has(other, 'a');
  * // => false
  */
-export declare function _has<T extends AnyObject>(obj: T, path?: string): boolean;
+export declare function _has<T extends AnyObject>(obj: T, path: string): boolean;

package/dist/object/object.util.js

@@ -286,26 +286,25 @@ function _invertMap(m) {
 }
 exports._invertMap = _invertMap;
 /**
- * Gets the property value at path of object. If the resolved value is undefined the defaultValue is used
- * in its place.
+ * Gets the property value at path of object.
  *
- * @param obj The object to query.
- * @param path The path of the property to get.
- * @param def The value returned if the resolved value is undefined.
- * @return Returns the resolved value.
+ * @example
+ * const obj = {a: 'a', b: 'b', c: { cc: 'cc' }}
+ * _get(obj, 'a') // 'a'
+ * _get(obj, 'c.cc') // 'cc'
+ * _get(obj, 'c[cc]') // 'cc'
+ * _get(obj, 'unknown.path') // undefined
  */
-function _get(obj = {}, path = '', def) {
-    const res = path
+function _get(obj = {}, path = '') {
+    return path
         .replace(/\[([^\]]+)]/g, '.$1')
         .split('.')
-        .reduce((o, p) => o[p], obj);
-    return res === undefined ? def : res;
+        .reduce((o, p) => o?.[p], obj);
 }
 exports._get = _get;
 /**
  * Sets the value at path of object. If a portion of path doesn’t exist it’s created. Arrays are created for
- * missing index properties while objects are created for all other missing properties. Use _.setWith to
- * customize path creation.
+ * missing index properties while objects are created for all other missing properties.
  *
  * @param obj The object to modify.
  * @param path The path of the property to set.
@@ -336,7 +335,7 @@ function _set(obj, path, value) {
                     ? [] // Yes: assign a new array object
                     : {}), // No: assign a new plain object
     obj)[path[path.length - 1]] = value; // Finally assign the value to the last key
-    return obj; // Return the top-level object to allow chaining
+    return obj; // allow chaining
 }
 exports._set = _set;
 /**

package/dist-esm/object/object.util.js

@@ -263,25 +263,24 @@ export function _invertMap(m) {
     return inv;
 }
 /**
- * Gets the property value at path of object. If the resolved value is undefined the defaultValue is used
- * in its place.
+ * Gets the property value at path of object.
  *
- * @param obj The object to query.
- * @param path The path of the property to get.
- * @param def The value returned if the resolved value is undefined.
- * @return Returns the resolved value.
+ * @example
+ * const obj = {a: 'a', b: 'b', c: { cc: 'cc' }}
+ * _get(obj, 'a') // 'a'
+ * _get(obj, 'c.cc') // 'cc'
+ * _get(obj, 'c[cc]') // 'cc'
+ * _get(obj, 'unknown.path') // undefined
  */
-export function _get(obj = {}, path = '', def) {
-    const res = path
+export function _get(obj = {}, path = '') {
+    return path
         .replace(/\[([^\]]+)]/g, '.$1')
         .split('.')
-        .reduce((o, p) => o[p], obj);
-    return res === undefined ? def : res;
+        .reduce((o, p) => o === null || o === void 0 ? void 0 : o[p], obj);
 }
 /**
  * Sets the value at path of object. If a portion of path doesn’t exist it’s created. Arrays are created for
- * missing index properties while objects are created for all other missing properties. Use _.setWith to
- * customize path creation.
+ * missing index properties while objects are created for all other missing properties.
  *
  * @param obj The object to modify.
  * @param path The path of the property to set.
@@ -312,7 +311,7 @@ export function _set(obj, path, value) {
                     ? [] // Yes: assign a new array object
                     : {}), // No: assign a new plain object
     obj)[path[path.length - 1]] = value; // Finally assign the value to the last key
-    return obj; // Return the top-level object to allow chaining
+    return obj; // allow chaining
 }
 /**
  * Checks if `path` is a direct property of `object` (not null, not undefined).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturalcycles/js-lib",
-  "version": "14.110.0",
+  "version": "14.111.0",
   "scripts": {
     "prepare": "husky install",
     "build-prod": "build-prod-esm-cjs",

package/src/object/object.util.ts

@@ -311,27 +311,25 @@ export function _invertMap<K, V>(m: ReadonlyMap<K, V>): Map<V, K> {
 }
 
 /**
- * Gets the property value at path of object. If the resolved value is undefined the defaultValue is used
- * in its place.
+ * Gets the property value at path of object.
  *
- * @param obj The object to query.
- * @param path The path of the property to get.
- * @param def The value returned if the resolved value is undefined.
- * @return Returns the resolved value.
+ * @example
+ * const obj = {a: 'a', b: 'b', c: { cc: 'cc' }}
+ * _get(obj, 'a') // 'a'
+ * _get(obj, 'c.cc') // 'cc'
+ * _get(obj, 'c[cc]') // 'cc'
+ * _get(obj, 'unknown.path') // undefined
  */
-export function _get<T extends AnyObject>(obj = {} as T, path = '', def?: any): any {
-  const res = path
+export function _get<T extends AnyObject>(obj = {} as T, path = ''): unknown {
+  return path
     .replace(/\[([^\]]+)]/g, '.$1')
     .split('.')
-    .reduce((o, p) => o[p], obj)
-
-  return res === undefined ? def : res
+    .reduce((o, p) => o?.[p], obj)
 }
 
 /**
  * Sets the value at path of object. If a portion of path doesn’t exist it’s created. Arrays are created for
- * missing index properties while objects are created for all other missing properties. Use _.setWith to
- * customize path creation.
+ * missing index properties while objects are created for all other missing properties.
  *
  * @param obj The object to modify.
  * @param path The path of the property to set.
@@ -340,11 +338,7 @@ export function _get<T extends AnyObject>(obj = {} as T, path = '', def?: any):
  *
  * Based on: https://stackoverflow.com/a/54733755/4919972
  */
-export function _set<IN extends AnyObject, OUT = IN>(
-  obj: IN,
-  path: PropertyPath,
-  value?: any,
-): OUT {
+export function _set<T extends AnyObject>(obj: T, path: PropertyPath, value: any): T {
   if (!obj || Object(obj) !== obj || !path) return obj as any // When obj is not an object
 
   // If not yet an array, get the keys from the string-path
@@ -373,7 +367,7 @@ export function _set<IN extends AnyObject, OUT = IN>(
     obj,
   )[path[path.length - 1]!] = value // Finally assign the value to the last key
 
-  return obj as any // Return the top-level object to allow chaining
+  return obj // allow chaining
 }
 
 /**
@@ -400,7 +394,7 @@ export function _set<IN extends AnyObject, OUT = IN>(
  * _.has(other, 'a');
  * // => false
  */
-export function _has<T extends AnyObject>(obj: T, path?: string): boolean {
+export function _has<T extends AnyObject>(obj: T, path: string): boolean {
   const v = _get(obj, path)
   return v !== undefined && v !== null
 }