type-fest 2.12.1 → 2.12.2

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "type-fest",
-	"version": "2.12.1",
+	"version": "2.12.2",
 	"description": "A collection of essential TypeScript types",
 	"license": "(MIT OR CC0-1.0)",
 	"repository": "sindresorhus/type-fest",

package/source/get.d.ts

@@ -97,10 +97,15 @@ type WithStringsKeys = keyof WithStrings;
 //=> 'foo' | '0'
 ```
 */
-type WithStringKeys<BaseType extends Record<string | number, any>> = {
-	[Key in StringKeyOf<BaseType>]: BaseType[Key]
+type WithStringKeys<BaseType> = {
+	[Key in StringKeyOf<BaseType>]: UncheckedIndex<BaseType, Key>
 };
 
+/**
+Perform a `T[U]` operation if `T` supports indexing.
+*/
+type UncheckedIndex<T, U extends string | number> = [T] extends [Record<string | number, any>] ? T[U] : never;
+
 /**
 Get a property of an object or array. Works when indexing arrays using number-literal-strings, for example, `PropertyOf<number[], '0'> = number`, and when indexing objects with number keys.
 

package/source/jsonify.d.ts

@@ -3,6 +3,13 @@ import {JsonPrimitive, JsonValue} from './basic';
 // Note: The return value has to be `any` and not `unknown` so it can match `void`.
 type NotJsonable = ((...args: any[]) => any) | undefined;
 
+// Note: Handles special case where Arrays with `undefined` are transformed to `'null'` by `JSON.stringify()`
+// Only use with array members
+type JsonifyArrayMember<T> =
+	T extends undefined ?
+		null | Exclude<T, undefined> :
+		Jsonify<T>;
+
 /**
 Transform a type to one that is assignable to the `JsonValue` type.
 
@@ -64,7 +71,7 @@ type Jsonify<T> =
 		? T extends JsonPrimitive
 			? T // Primitive is acceptable
 			: T extends Array<infer U>
-				? Array<Jsonify<U>> // It's an array: recursive call for its children
+				? Array<JsonifyArrayMember<U>> // It's an array: recursive call for its children
 				: T extends object
 					? T extends {toJSON(): infer J}
 						? (() => J) extends (() => JsonValue) // Is J assignable to JsonValue?

package/source/tsconfig-json.d.ts

@@ -598,6 +598,7 @@ declare namespace TsConfigJson {
 		Watch input files.
 
 		@default false
+		@deprecated Use watchOptions instead.
 		*/
 		watch?: boolean;
 
@@ -605,6 +606,8 @@ declare namespace TsConfigJson {
 		Specify the polling strategy to use when the system runs out of or doesn't support native file watchers.
 
 		Requires TypeScript version 3.8 or later.
+
+		@deprecated Use watchOptions.fallbackPolling instead.
 		*/
 		fallbackPolling?: CompilerOptions.FallbackPolling;
 
@@ -614,6 +617,7 @@ declare namespace TsConfigJson {
 		Requires TypeScript version 3.8 or later.
 
 		@default 'useFsEvents'
+		@deprecated Use watchOptions.watchDirectory instead.
 		*/
 		watchDirectory?: CompilerOptions.WatchDirectory;
 
@@ -623,6 +627,7 @@ declare namespace TsConfigJson {
 		Requires TypeScript version 3.8 or later.
 
 		@default 'useFsEvents'
+		@deprecated Use watchOptions.watchFile instead.
 		*/
 		watchFile?: CompilerOptions.WatchFile;
 
@@ -990,6 +995,71 @@ declare namespace TsConfigJson {
 		explainFiles?: boolean;
 	}
 
+	namespace WatchOptions {
+		export type WatchFileKind =
+			| 'FixedPollingInterval'
+			| 'PriorityPollingInterval'
+			| 'DynamicPriorityPolling'
+			| 'FixedChunkSizePolling'
+			| 'UseFsEvents'
+			| 'UseFsEventsOnParentDirectory';
+
+		export type WatchDirectoryKind =
+			| 'UseFsEvents'
+			| 'FixedPollingInterval'
+			| 'DynamicPriorityPolling'
+			| 'FixedChunkSizePolling';
+
+		export type PollingWatchKind =
+			| 'FixedInterval'
+			| 'PriorityInterval'
+			| 'DynamicPriority'
+			| 'FixedChunkSize';
+	}
+
+	export interface WatchOptions {
+
+		/**
+		Specify the strategy for watching individual files.
+
+		Requires TypeScript version 3.8 or later.
+
+		@default 'UseFsEvents'
+		*/
+		watchFile?: WatchOptions.WatchFileKind | Lowercase<WatchOptions.WatchFileKind>;
+
+		/**
+		Specify the strategy for watching directories under systems that lack recursive file-watching functionality.
+
+		Requires TypeScript version 3.8 or later.
+
+		@default 'UseFsEvents'
+		*/
+		watchDirectory?: WatchOptions.WatchDirectoryKind | Lowercase<WatchOptions.WatchDirectoryKind>;
+
+		/**
+		Specify the polling strategy to use when the system runs out of or doesn't support native file watchers.
+
+		Requires TypeScript version 3.8 or later.
+		*/
+		fallbackPolling?: WatchOptions.PollingWatchKind | Lowercase<WatchOptions.PollingWatchKind>;
+
+		/**
+		Enable synchronous updates on directory watchers for platforms that don't support recursive watching natively.
+		*/
+		synchronousWatchDirectory?: boolean;
+
+		/**
+		Specifies a list of directories to exclude from watch
+		*/
+		excludeDirectories?: string[];
+
+		/**
+		Specifies a list of files to exclude from watch
+		*/
+		excludeFiles?: string[];
+	}
+
 	/**
 	Auto type (.d.ts) acquisition options for this project.
 
@@ -1048,6 +1118,11 @@ export interface TsConfigJson {
 	*/
 	compilerOptions?: TsConfigJson.CompilerOptions;
 
+	/**
+	Instructs the TypeScript compiler how to watch files.
+	*/
+	watchOptions?: TsConfigJson.WatchOptions;
+
 	/**
 	Auto type (.d.ts) acquisition options for this project.