@naturalcycles/js-lib 15.72.0 → 15.72.1

package/dist/types.d.ts

@@ -298,15 +298,22 @@ export declare const _stringMapEntries: <T>(map: StringMap<T>) => [k: string, v:
 /**
  * Alias of `Object.keys`, but returns keys typed as `keyof T`, not as just `string`.
  * This is how TypeScript should work, actually.
+ *
+ * Object.keys always returns strings, so numeric keys are stringified via `${K}`.
+ * Symbol keys are excluded (Object.keys does not return symbols).
  */
-export declare const _objectKeys: <K extends PropertyKey>(obj: Partial<Record<K, any>>) => K[];
+export declare const _objectKeys: <K extends PropertyKey>(obj: Partial<Record<K, any>>) => (K extends string ? K : K extends number | bigint ? `${K}` : never)[];
 /**
  * Alias of `Object.entries`, but returns better-typed output.
  *
+ * Difference with _stringMapEntries?
+ * Use _stringMapEntries when the object is a StringMap<T> - it'll correctly infer T being not undefined.
+ * If the object is not a StringMap - use _objectEntries - it'll correctly infer object keys, which can be typed as Enum.
+ *
  * So e.g you can use _objectEntries(obj).map([k, v] => {})
  * and `k` will be `keyof obj` instead of generic `string`.
  */
-export declare const _objectEntries: <K extends PropertyKey, V>(obj: Partial<Record<K, V>>) => [k: K, v: V][];
+export declare const _objectEntries: <K extends PropertyKey, V>(obj: Partial<Record<K, V>>) => [k: K extends string ? K : K extends number | bigint ? `${K}` : never, v: V][];
 export type NullishValue = null | undefined;
 export type FalsyValue = false | '' | 0 | null | undefined;
 /**

package/dist/types.js

@@ -33,11 +33,18 @@ export const _stringMapEntries = Object.entries;
 /**
  * Alias of `Object.keys`, but returns keys typed as `keyof T`, not as just `string`.
  * This is how TypeScript should work, actually.
+ *
+ * Object.keys always returns strings, so numeric keys are stringified via `${K}`.
+ * Symbol keys are excluded (Object.keys does not return symbols).
  */
 export const _objectKeys = Object.keys;
 /**
  * Alias of `Object.entries`, but returns better-typed output.
  *
+ * Difference with _stringMapEntries?
+ * Use _stringMapEntries when the object is a StringMap<T> - it'll correctly infer T being not undefined.
+ * If the object is not a StringMap - use _objectEntries - it'll correctly infer object keys, which can be typed as Enum.
+ *
  * So e.g you can use _objectEntries(obj).map([k, v] => {})
  * and `k` will be `keyof obj` instead of generic `string`.
  */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@naturalcycles/js-lib",
   "type": "module",
-  "version": "15.72.0",
+  "version": "15.72.1",
   "dependencies": {
     "tslib": "^2"
   },
@@ -20,7 +20,7 @@
     "@typescript/native-preview": "7.0.0-dev.20260401.1",
     "crypto-js": "^4",
     "dayjs": "^1",
-    "@naturalcycles/dev-lib": "20.42.0"
+    "@naturalcycles/dev-lib": "18.4.2"
   },
   "exports": {
     ".": "./dist/index.js",

package/src/types.ts

@@ -373,20 +373,27 @@ export const _stringMapEntries = Object.entries as <T>(map: StringMap<T>) => [k:
 /**
  * Alias of `Object.keys`, but returns keys typed as `keyof T`, not as just `string`.
  * This is how TypeScript should work, actually.
+ *
+ * Object.keys always returns strings, so numeric keys are stringified via `${K}`.
+ * Symbol keys are excluded (Object.keys does not return symbols).
  */
 export const _objectKeys = Object.keys as <K extends PropertyKey>(
   obj: Partial<Record<K, any>>,
-) => K[]
+) => (K extends string ? K : K extends number | bigint ? `${K}` : never)[]
 
 /**
  * Alias of `Object.entries`, but returns better-typed output.
  *
+ * Difference with _stringMapEntries?
+ * Use _stringMapEntries when the object is a StringMap<T> - it'll correctly infer T being not undefined.
+ * If the object is not a StringMap - use _objectEntries - it'll correctly infer object keys, which can be typed as Enum.
+ *
  * So e.g you can use _objectEntries(obj).map([k, v] => {})
  * and `k` will be `keyof obj` instead of generic `string`.
  */
 export const _objectEntries = Object.entries as <K extends PropertyKey, V>(
   obj: Partial<Record<K, V>>,
-) => [k: K, v: V][]
+) => [k: K extends string ? K : K extends number | bigint ? `${K}` : never, v: V][]
 
 export type NullishValue = null | undefined
 export type FalsyValue = false | '' | 0 | null | undefined