es2019.object

Author: uhyo

build/replacement.ts

@@ -41,4 +41,7 @@ export const replacement = new Map([
   ["lib.es2015.proxy.d.ts", new Set(["ProxyHandler"])],
   ["lib.es2015.reflect.d.ts", new Set(["Reflect"])],
   ["lib.es2017.object.d.ts", new Set(["ObjectConstructor"])],
+  ["lib.es2018.asyncgenerator.d.ts", new Set(["AsyncGenerator"])],
+  ["lib.es2018.asynciterable.d.ts", new Set(["AsyncIterator"])],
+  ["lib.es2019.object.d.ts", new Set(["ObjectConstructor"])],
 ]);

lib/lib.es2018.asyncgenerator.d.ts

@@ -0,0 +1,12 @@
+/// <reference no-default-lib="true"/>
+
+interface AsyncGenerator<T = unknown, TReturn = unknown, TNext = unknown>
+  extends AsyncIterator<T, TReturn, TNext> {
+  // NOTE: 'next' is defined using a tuple to ensure we report the correct assignability errors in all places.
+  next(...args: [] | [TNext]): Promise<IteratorResult<T, TReturn>>;
+  return(
+    value: TReturn | PromiseLike<TReturn>
+  ): Promise<IteratorResult<T, TReturn>>;
+  throw(e: any): Promise<IteratorResult<T, TReturn>>;
+  [Symbol.asyncIterator](): AsyncGenerator<T, TReturn, TNext>;
+}

lib/lib.es2018.asynciterable.d.ts

@@ -0,0 +1,10 @@
+/// <reference no-default-lib="true"/>
+
+interface AsyncIterator<T, TReturn = unknown, TNext = undefined> {
+  // NOTE: 'next' is defined using a tuple to ensure we report the correct assignability errors in all places.
+  next(...args: [] | [TNext]): Promise<IteratorResult<T, TReturn>>;
+  return?(
+    value?: TReturn | PromiseLike<TReturn>
+  ): Promise<IteratorResult<T, TReturn>>;
+  throw?(e?: any): Promise<IteratorResult<T, TReturn>>;
+}

lib/lib.es2019.object.d.ts

@@ -0,0 +1,11 @@
+/// <reference no-default-lib="true"/>
+
+interface ObjectConstructor {
+  /**
+   * Returns an object created by key-value entries for properties and methods
+   * @param entries An iterable object that contains key-value entries for properties and methods.
+   */
+  fromEntries<T extends readonly [PropertyKey, unknown]>(
+    entries: Iterable<T>
+  ): Record<T[0], T[1]>;
+}

tests/es2019.object.ts

@@ -0,0 +1,24 @@
+/// <reference path="../dist/lib/lib.es2019.d.ts" />
+
+import { expectType } from "tsd";
+
+// ObjectConstructor
+{
+  const arr1: [] = [];
+  const obj1 = Object.fromEntries(arr1);
+  expectType<{}>(obj1);
+
+  const arr2 = [
+    ["foo", 123],
+    ["bar", 456],
+  ] as const;
+  const obj2 = Object.fromEntries(arr2);
+  expectType<{
+    foo: 123 | 456;
+    bar: 123 | 456;
+  }>(obj2);
+
+  const arr3: [string, number][] = [];
+  const obj3 = Object.fromEntries(arr3);
+  expectType<Record<string, number>>(obj3);
+}