@naturalcycles/js-lib 15.48.1 → 15.49.0

package/dist/types.d.ts

@@ -288,17 +288,23 @@ export declare const _stringMapValues: <T>(map: StringMap<T>) => T[];
  */
 export declare const _stringMapEntries: <T>(map: StringMap<T>) => [k: string, v: T][];
 /**
- * Alias of `Object.keys`, but returns keys typed as `keyof T`, not as just `string`.
+ * Resolves to a string literal union of the keys of T, meaning they are
+ * always keys of T and always strings (never numbers or symbols).
+ */
+export type ObjectKey<T> = `${Extract<keyof T, string | number>}`;
+/**
+ * Alias of `Object.keys`, but returns keys with a string type that's as
+ * narrow as possible.
  * This is how TypeScript should work, actually.
  */
-export declare const _objectKeys: <T extends AnyObject>(obj: T) => (keyof T)[];
+export declare const _objectKeys: <T extends AnyObject>(obj: T) => ObjectKey<T>[];
 /**
  * Alias of `Object.entries`, but returns better-typed output.
  *
  * 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: <T extends AnyObject>(obj: T) => [k: keyof T, v: T[keyof T]][];
+export declare const _objectEntries: <T extends AnyObject>(obj: T) => [k: ObjectKey<T>, v: T[ObjectKey<T>]][];
 export type NullishValue = null | undefined;
 export type FalsyValue = false | '' | 0 | null | undefined;
 /**

package/dist/types.js

@@ -31,7 +31,8 @@ export const _stringMapValues = Object.values;
  */
 export const _stringMapEntries = Object.entries;
 /**
- * Alias of `Object.keys`, but returns keys typed as `keyof T`, not as just `string`.
+ * Alias of `Object.keys`, but returns keys with a string type that's as
+ * narrow as possible.
  * This is how TypeScript should work, actually.
  */
 export const _objectKeys = Object.keys;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@naturalcycles/js-lib",
   "type": "module",
-  "version": "15.48.1",
+  "version": "15.49.0",
   "dependencies": {
     "tslib": "^2",
     "undici": "^7",

package/src/types.ts

@@ -361,10 +361,17 @@ export const _stringMapValues = Object.values as <T>(map: StringMap<T>) => T[]
 export const _stringMapEntries = Object.entries as <T>(map: StringMap<T>) => [k: string, v: T][]
 
 /**
- * Alias of `Object.keys`, but returns keys typed as `keyof T`, not as just `string`.
+ * Resolves to a string literal union of the keys of T, meaning they are
+ * always keys of T and always strings (never numbers or symbols).
+ */
+export type ObjectKey<T> = `${Extract<keyof T, string | number>}`
+
+/**
+ * Alias of `Object.keys`, but returns keys with a string type that's as
+ * narrow as possible.
  * This is how TypeScript should work, actually.
  */
-export const _objectKeys = Object.keys as <T extends AnyObject>(obj: T) => (keyof T)[]
+export const _objectKeys = Object.keys as <T extends AnyObject>(obj: T) => ObjectKey<T>[]
 
 /**
  * Alias of `Object.entries`, but returns better-typed output.
@@ -374,7 +381,7 @@ export const _objectKeys = Object.keys as <T extends AnyObject>(obj: T) => (keyo
  */
 export const _objectEntries = Object.entries as <T extends AnyObject>(
   obj: T,
-) => [k: keyof T, v: T[keyof T]][]
+) => [k: ObjectKey<T>, v: T[ObjectKey<T>]][]
 
 export type NullishValue = null | undefined
 export type FalsyValue = false | '' | 0 | null | undefined