@naturalcycles/js-lib 15.55.1 → 15.57.0

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

@@ -1,4 +1,4 @@
-import type { AnyObject, KeyValueTuple, MutateOptions, ObjectMapper, ObjectPredicate, Reviver, StringMap, ValueOf } from '../types.js';
+import type { AnyObject, KeyValueTuple, MutateOptions, ObjectMapper, ObjectPredicate, RequiredProp, Reviver, StringMap, ValueOf } from '../types.js';
 import { SKIP } from '../types.js';
 /**
  * Returns clone of `obj` with only `props` preserved.
@@ -228,4 +228,13 @@ export declare function _deepFreeze(o: any): void;
  * To make mutation extra clear - function returns void (unlike Object.assign).
  */
 export declare function _objectAssignExact<T extends AnyObject>(target: T, source: T): void;
+/**
+ * type MyObj = { a?: string, b?: string }
+ *
+ * const collection: MyObj[] = [...]
+ *
+ * const collectionA = collection.filter(_hasProp('a'))
+ * --> collectionA is now RequiredProp<MyObj, 'a'>[], i.e. { a: string, b?: string }[]
+ */
+export declare function _hasProp<T, Prop extends keyof T>(prop: Prop): (object: T) => object is RequiredProp<T, Prop>;
 export {};

package/dist/object/object.util.js

@@ -370,7 +370,7 @@ export function _set(obj, path, value) {
             a[c]
         : // No: create the key. Is the next key a potential array-index?
             (a[c] =
-                // eslint-disable-next-line
+                // oxlint-disable-next-line no-bitwise no-implicit-coercion unicorn/prefer-math-trunc
                 Math.abs(path[i + 1]) >> 0 === +path[i + 1]
                     ? [] // Yes: assign a new array object
                     : {}), // No: assign a new plain object
@@ -446,3 +446,16 @@ export function _objectAssignExact(target, source) {
         }
     }
 }
+/**
+ * type MyObj = { a?: string, b?: string }
+ *
+ * const collection: MyObj[] = [...]
+ *
+ * const collectionA = collection.filter(_hasProp('a'))
+ * --> collectionA is now RequiredProp<MyObj, 'a'>[], i.e. { a: string, b?: string }[]
+ */
+export function _hasProp(prop) {
+    return function (object) {
+        return typeof object[prop] !== 'undefined';
+    };
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@naturalcycles/js-lib",
   "type": "module",
-  "version": "15.55.1",
+  "version": "15.57.0",
   "dependencies": {
     "tslib": "^2",
     "undici": "^7",
@@ -9,11 +9,11 @@
   },
   "devDependencies": {
     "@types/crypto-js": "^4",
-    "@types/node": "^24",
+    "@types/node": "^25",
     "@types/semver": "^7",
     "crypto-js": "^4",
     "dayjs": "^1",
-    "@naturalcycles/dev-lib": "18.4.2"
+    "@naturalcycles/dev-lib": "20.15.0"
   },
   "exports": {
     ".": "./dist/index.js",

package/src/object/object.util.ts

@@ -5,6 +5,7 @@ import type {
   MutateOptions,
   ObjectMapper,
   ObjectPredicate,
+  RequiredProp,
   Reviver,
   StringMap,
   ValueOf,
@@ -442,7 +443,7 @@ export function _set<T extends AnyObject>(obj: T, path: PropertyPath, value: any
           a[c]
         : // No: create the key. Is the next key a potential array-index?
           (a[c] =
-            // eslint-disable-next-line
+            // oxlint-disable-next-line no-bitwise no-implicit-coercion unicorn/prefer-math-trunc
             Math.abs(path[i + 1]) >> 0 === +path[i + 1]
               ? [] // Yes: assign a new array object
               : {}), // No: assign a new plain object
@@ -527,3 +528,17 @@ export function _objectAssignExact<T extends AnyObject>(target: T, source: T): v
     }
   }
 }
+
+/**
+ * type MyObj = { a?: string, b?: string }
+ *
+ * const collection: MyObj[] = [...]
+ *
+ * const collectionA = collection.filter(_hasProp('a'))
+ * --> collectionA is now RequiredProp<MyObj, 'a'>[], i.e. { a: string, b?: string }[]
+ */
+export function _hasProp<T, Prop extends keyof T>(prop: Prop) {
+  return function (object: T): object is RequiredProp<T, Prop> {
+    return typeof object[prop] !== 'undefined'
+  }
+}