Add Jsonifiable type

index.d.ts

@@ -50,6 +50,7 @@ export type {SetReturnType} from './source/set-return-type';
 export type {Asyncify} from './source/asyncify';
 export type {Simplify} from './source/simplify';
 export type {Jsonify} from './source/jsonify';
+export type {Jsonifiable} from './source/jsonifiable';
 export type {Schema} from './source/schema';
 export type {LiteralToPrimitive} from './source/literal-to-primitive';
 export type {

readme.md

@@ -187,6 +187,7 @@ Click the type names for complete docs.
 ### JSON
 
 - [`Jsonify`](source/jsonify.d.ts) - Transform a type to one that is assignable to the `JsonValue` type.
+- [`Jsonifiable`](source/jsonifiable.d.ts) - Matches a value that can be losslessly converted to JSON.
 - [`JsonPrimitive`](source/basic.d.ts) - Matches a JSON primitive.
 - [`JsonObject`](source/basic.d.ts) - Matches a JSON object.
 - [`JsonArray`](source/basic.d.ts) - Matches a JSON array.

source/jsonifiable.d.ts

@@ -0,0 +1,32 @@
+import type {JsonPrimitive, JsonValue} from './basic';
+
+type JsonifiableObject = {[Key in string]?: Jsonifiable} | {toJSON: () => JsonValue};
+type JsonifiableArray = Jsonifiable[];
+
+/**
+Matches a value that can be losslessly converted to JSON.
+
+`undefined` is allowed in object fields (ex: `{a?: number}`) as a
+special case even though `JSON.stringify({a: undefined})` is `{}`.
+
+@example
+```
+import type {Jsonifiable} from 'type-fest';
+
+// @ts-expect-error
+const error: Jsonifiable = {
+    map: new Map([["a", 1]]),
+};
+JSON.stringify(error); // {"map": {}}
+
+const good: Jsonifiable = {
+    number: 3,
+    date: new Date(),
+    missing: undefined,
+}
+JSON.stringify(good); // {"number": 3, "date": "2022-10-17T22:22:35.920Z"}
+```
+
+@category JSON
+*/
+export type Jsonifiable = JsonPrimitive | JsonifiableObject | JsonifiableArray;

test-d/jsonifiable.ts

@@ -0,0 +1,16 @@
+import {expectAssignable, expectNotAssignable} from 'tsd';
+import type {Jsonifiable} from '..';
+
+expectAssignable<Jsonifiable>(1);
+expectAssignable<Jsonifiable>('');
+expectAssignable<Jsonifiable>(null);
+expectAssignable<Jsonifiable>(new Date());
+expectAssignable<Jsonifiable>({a: new Date()});
+expectAssignable<Jsonifiable>([new Date()]);
+expectAssignable<Jsonifiable>({a: undefined});
+
+expectNotAssignable<Jsonifiable>(undefined);
+expectNotAssignable<Jsonifiable>(new Map());
+expectNotAssignable<Jsonifiable>({a: new Map()});
+expectNotAssignable<Jsonifiable>([new Map()]);
+expectNotAssignable<Jsonifiable>({toJSON: () => new Date()});