Restore Interface Documentation

Author: graphemecluster

build/logic/generate.ts

@@ -28,11 +28,7 @@ export function generate(
   const replacementTargets = scanBetterFile(printer, libFile);
 
   if (replacementTargets.size === 0) {
-    for (const statement of originalFile.statements) {
-      result += statement.getFullText(originalFile);
-    }
-    result += originalFile.text.slice(originalFile.endOfFileToken.pos);
-    return result;
+    return originalFile.text;
   }
 
   const consumedReplacements = new Set<string>();
@@ -133,7 +129,7 @@ export function generate(
         },
       ];
     });
-    result += printInterface(printer, statement, memberList);
+    result += printInterface(printer, statement, memberList, originalFile);
 
     if (emitOriginalAsComment) {
       result += "\n";
@@ -327,10 +323,12 @@ function isPartialReplacement(
 function printInterface(
   printer: ts.Printer,
   originalNode: ts.InterfaceDeclaration,
-  members: readonly { text: string }[]
+  members: readonly { text: string }[],
+  originalSourceFile: ts.SourceFile
 ): string {
-  const originalSourceFile = originalNode.getSourceFile();
-  let result = "";
+  let result = originalNode
+    .getFullText(originalSourceFile)
+    .slice(0, originalNode.getLeadingTriviaWidth(originalSourceFile));
   for (const dec of originalNode.decorators ?? []) {
     result += printer.printNode(
       ts.EmitHint.Unspecified,

docs/diff/es2015.collection.d.ts.md

@@ -5,7 +5,7 @@ Index: es2015.collection.d.ts
 ===================================================================
 --- es2015.collection.d.ts
 +++ es2015.collection.d.ts
-@@ -1,28 +1,25 @@
+@@ -1,28 +1,27 @@
  interface Map<K, V> {
    clear(): void;
    delete(key: K): boolean;
@@ -21,15 +21,15 @@ Index: es2015.collection.d.ts
    set(key: K, value: V): this;
    readonly size: number;
  }
--
+ 
  interface MapConstructor {
 -  new (): Map<any, any>;
    new <K, V>(entries?: readonly (readonly [K, V])[] | null): Map<K, V>;
 -  readonly prototype: Map<any, any>;
 +  readonly prototype: Map<unknown, unknown>;
  }
  declare var Map: MapConstructor;
--
+ 
  interface ReadonlyMap<K, V> {
 -  forEach(
 -    callbackfn: (value: V, key: K, map: ReadonlyMap<K, V>) => void,
@@ -41,12 +41,10 @@ Index: es2015.collection.d.ts
    get(key: K): V | undefined;
    has(key: K): boolean;
    readonly size: number;
-@@ -33,39 +30,35 @@
-   get(key: K): V | undefined;
-   has(key: K): boolean;
+@@ -35,37 +34,37 @@
    set(key: K, value: V): this;
  }
--
+ 
  interface WeakMapConstructor {
 -  new <K extends object = object, V = any>(
 -    entries?: readonly [K, V][] | null
@@ -57,7 +55,7 @@ Index: es2015.collection.d.ts
 +  readonly prototype: WeakMap<object, unknown>;
  }
  declare var WeakMap: WeakMapConstructor;
--
+ 
  interface Set<T> {
    add(value: T): this;
    clear(): void;
@@ -72,15 +70,15 @@ Index: es2015.collection.d.ts
    has(value: T): boolean;
    readonly size: number;
  }
--
+ 
  interface SetConstructor {
 -  new <T = any>(values?: readonly T[] | null): Set<T>;
 -  readonly prototype: Set<any>;
 +  new <T>(values?: readonly T[] | null): Set<T>;
 +  readonly prototype: Set<unknown>;
  }
  declare var Set: SetConstructor;
--
+ 
  interface ReadonlySet<T> {
 -  forEach(
 -    callbackfn: (value: T, value2: T, set: ReadonlySet<T>) => void,

docs/diff/es2015.core.d.ts.md

@@ -52,12 +52,9 @@ Index: es2015.core.d.ts
 
    /**
     * Changes all array elements from `start` to `end` index to a static `value` and returns the modified array
-@@ -51,26 +61,25 @@
-    * @param end If not specified, length of the this object is used as its default value.
-    */
-   copyWithin(target: number, start: number, end?: number): this;
+@@ -54,23 +64,23 @@
  }
--
+ 
  interface ArrayConstructor {
    /**
 -   * Creates an array from an array-like object.
@@ -88,15 +85,7 @@ Index: es2015.core.d.ts
 
    /**
     * Returns a new array from a set of elements.
-@@ -201,44 +210,42 @@
-    * @param x A numeric expression.
-    */
-   cbrt(x: number): number;
- }
--
- interface NumberConstructor {
-   /**
-    * The value of Number.EPSILON is the difference between 1 and the smallest value greater than 1
+@@ -209,36 +219,35 @@
     * that is representable as a Number value, which is approximately:
     * 2.2204460492503130808472633361816 x 10‍−‍16.
     */
@@ -137,13 +126,7 @@ Index: es2015.core.d.ts
    /**
     * The value of the largest integer n such that n and n + 1 are both exactly representable as
     * a Number value.
-@@ -267,51 +274,31 @@
-    * All other strings are considered decimal.
-    */
-   parseInt(string: string, radix?: number): number;
- }
--
- interface ObjectConstructor {
+@@ -273,45 +282,26 @@
    /**
     * Copy the values of all of the enumerable own properties from one or more source objects to a
     * target object. Returns the target object.
@@ -203,7 +186,7 @@ Index: es2015.core.d.ts
     * @param o Object to retrieve the symbols from.
     */
    getOwnPropertySymbols(o: any): symbol[];
-@@ -326,18 +313,24 @@
+@@ -326,16 +316,23 @@
     * Returns true if the values are the same value, false otherwise.
     * @param value1 The first value.
     * @param value2 The second value.
@@ -226,12 +209,10 @@ Index: es2015.core.d.ts
 +   */
 +  setPrototypeOf<T extends object>(o: T, proto: null): T;
  }
--
+ 
  interface ReadonlyArray<T> {
    /**
-    * Returns the value of the first element in the array where predicate is true, and undefined
-    * otherwise.
-@@ -346,20 +339,25 @@
+@@ -346,20 +343,25 @@
     * immediately returns that element value. Otherwise, find returns undefined.
     * @param thisArg If provided, it will be used as the this value for each invocation of
     * predicate. If it is not provided, undefined is used instead.
@@ -268,7 +249,7 @@ Index: es2015.core.d.ts
 
    /**
     * Returns the index of the first element in the array where predicate is true, and -1
-@@ -369,11 +367,11 @@
+@@ -369,11 +371,11 @@
     * findIndex immediately returns that element index. Otherwise, findIndex returns -1.
     * @param thisArg If provided, it will be used as the this value for each invocation of
     * predicate. If it is not provided, undefined is used instead.
@@ -283,17 +264,7 @@ Index: es2015.core.d.ts
  }
 
  interface RegExp {
-@@ -407,9 +405,8 @@
- interface RegExpConstructor {
-   new (pattern: RegExp | string, flags?: string): RegExp;
-   (pattern: RegExp | string, flags?: string): RegExp;
- }
--
- interface String {
-   /**
-    * Returns a nonnegative integer Number less than 1114112 (0x110000) that is the code point
-    * value of the UTF-16 encoded code point starting at the string element at position pos in
-@@ -433,26 +430,17 @@
+@@ -433,26 +435,17 @@
     * same as the corresponding elements of this object (converted to a String) starting at
     * endPosition – length(this). Otherwise returns false.
     */