Better Object.entries

package.json

@@ -83,6 +83,11 @@
       "types": "./dist/storage.d.ts",
       "import": "./dist/storage.mjs",
       "default": "./dist/storage.js"
+    },
+    "./object-entries": {
+      "types": "./dist/object-entries.d.ts",
+      "import": "./dist/object-entries.mjs",
+      "default": "./dist/object-entries.js"
     }
   },
   "keywords": [],

src/entrypoints/object-entries.d.ts

@@ -0,0 +1,3 @@
+interface ObjectConstructor {
+  entries<T>(o: T): T extends ArrayLike<any> ? { [K in Extract<keyof T, number>]: [`${K}`, T[K]] }[number][] : { [K in keyof T]: [K, T[K]] }[keyof T][];
+}

src/entrypoints/recommended.d.ts

@@ -6,3 +6,4 @@
 /// <reference path="set-has.d.ts" />
 /// <reference path="map-has.d.ts" />
 /// <reference path="array-index-of.d.ts" />
+/// <reference path="object-entries.d.ts" />

src/tests/object-entries.ts

@@ -0,0 +1,27 @@
+import { doNotExecute, Equal, Expect } from './utils';
+
+doNotExecute(async () => {
+  const result1 = Object.entries({ a: 1, b: 2, c: 3 } as const);
+  const result2 = Object.entries({ a: true, b: 'string', c: { field: 1 } } as const);
+  const result3 = Object.entries([1, 2, 3] as const);
+
+  type tests = [
+    // Basic functionality test
+    Expect<Equal<typeof result1, (['a', 1] | ["b", 2] | ['c', 3])[]>>,
+    // Complex values
+    Expect<Equal<typeof result2, (['a', true] | ['b', 'string'] | ['c', { readonly field: 1 }])[]>>,
+    // Array
+    Expect<Equal<typeof result3, [`${number}`, 1 | 2 | 3][]>>,
+  ];
+});
+
+doNotExecute(async () => {
+  const array = [1, 2, 3];
+  const readonlyArray = [1, 2, 3] as const;
+  const result1 = Object.entries(array);
+  const result2 = Object.entries(readonlyArray);
+
+  // Make sure arrays' index is a string in the result
+  result1[0][0] satisfies `${number}`;
+  result2[0][0] satisfies `${number}`;
+});