Add JSONValue and related types in types module

Author: A-yon Lee

augment/types.ts

@@ -8,7 +8,7 @@ declare global {
     }
 
     /** This interface represents the abstract constructor/class of the given `T` type. */
-    export interface AbstractConstructor<T = object> extends Function {
+    interface AbstractConstructor<T = object> extends Function {
         prototype: T;
     }
 
@@ -240,6 +240,18 @@ declare global {
      * ```
      */
     type Branded<T, B> = T & { [__brand]: B; };
+
+    type JSONPrimitive = string | number | boolean | null;
+    type JSONArray = JSONValue[];
+    type JSONObject = {
+        [key: string]: JSONValue | undefined;
+    };
+
+    /**
+     * The `JSONValue` type represents a value that can be serialized to JSON and
+     * deserialized from JSON without losing information.
+     */
+    type JSONValue = JSONPrimitive | JSONArray | JSONObject;
 }
 
 // @ts-ignore

bundle/jsext.js.map

@@ -1,6 +1,6 @@
 {
     "name": "@ayonli/jsext",
-    "version": "1.7.0",
+    "version": "1.7.1",
     "exports": {
         ".": "./index.ts",
         "./archive": "./archive.ts",

deno.json

@@ -1,6 +1,6 @@
 {
     "name": "@ayonli/jsext",
-    "version": "1.7.0",
+    "version": "1.7.1",
     "description": "A JavaScript extension package for building strong and modern applications.",
     "type": "module",
     "exports": {

esm/types.js

@@ -1,5 +1,5 @@
 /**
- * The missing utility types for TypeScript.
+ * The missing builtin classes of JavaScript and utility types for TypeScript.
  * @module
  */
 
@@ -258,3 +258,15 @@ export type MethodDecorator = {
     <T>(target: any, prop: string, desc: TypedPropertyDescriptor<T>): void | TypedPropertyDescriptor<T>;
     <F extends (...args: any[]) => any>(target: F, context: DecoratorContext): void | F;
 };
+
+export type JSONPrimitive = string | number | boolean | null;
+export type JSONArray = JSONValue[];
+export type JSONObject = {
+    [key: string]: JSONValue | undefined;
+};
+
+/**
+ * This type represents a value that can be serialized to JSON and deserialized
+ * from JSON safely without losing information.
+ */
+export type JSONValue = JSONPrimitive | JSONArray | JSONObject;