Merge branch 'master' into v2

Author: uhyo

README.md

@@ -2,6 +2,8 @@
 
 An alternative TypeScript standard library with better type definitions.
 
+[See the v2 branch for 2.0.0 that supports TypeScript 4.5.](https://github.com/uhyo/better-typescript-lib/tree/v2)
+
 ## The Problem
 
 While it is well known that TypeScript is not _very_ type safe due to the existence of `any` and other pitfalls, TypeScript's built-in type definitions are also to blame for that unsafety. For example, it is handy but very unsafe that the return type of `JSON.parse` is `any`.

lib/lib.es5.d.ts

@@ -217,16 +217,6 @@ type JSONValue =
     }
   | JSONValue[];
 
-type ReadonlyJSONValue =
-  | null
-  | string
-  | number
-  | boolean
-  | {
-      readonly [K in string]?: ReadonlyJSONValue;
-    }
-  | readonly ReadonlyJSONValue[];
-
 interface JSON {
   /**
    * Converts a JavaScript Object Notation (JSON) string into an object.
@@ -245,12 +235,8 @@ interface JSON {
    * @param space Adds indentation, white space, and line break characters to the return-value JSON text to make it easier to read.
    */
   stringify(
-    value: ReadonlyJSONValue,
-    replacer?: (
-      this: ReadonlyJSONValue,
-      key: string,
-      value: ReadonlyJSONValue
-    ) => any,
+    value: unknown,
+    replacer?: (this: unknown, key: string, value: unknown) => any,
     space?: string | number
   ): string;
   /**
@@ -260,7 +246,7 @@ interface JSON {
    * @param space Adds indentation, white space, and line break characters to the return-value JSON text to make it easier to read.
    */
   stringify(
-    value: ReadonlyJSONValue,
+    value: unknown,
     replacer?: (number | string)[] | null,
     space?: string | number
   ): string;

tests/src/es5.ts

@@ -86,6 +86,16 @@ expectType<{ foo: number; bar: string; baz: boolean }>(
   expectType<string>(JSON.stringify(readonlyArr));
   const readonlyObj = { foo: { bar: 1 } } as const;
   expectType<string>(JSON.stringify(readonlyObj));
+
+  // https://github.com/uhyo/better-typescript-lib/issues/5
+  interface Param {
+    id: string;
+    value: number;
+  }
+  +function foo(param: Param, readonlyParam: Readonly<Param>) {
+    JSON.stringify(param); // error
+    JSON.stringify(readonlyParam);
+  };
 }
 
 // ArrayConstructor