type-fest 4.27.0 → 4.28.0

package/package.json

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

package/readme.md

@@ -20,12 +20,6 @@
 			<sup>Special thanks to:</sup>
 			<br>
 			<br>
-			<a href="https://standardresume.co/tech">
-				<img src="https://sindresorhus.com/assets/thanks/standard-resume-logo.svg" width="180"/>
-			</a>
-			<br>
-			<br>
-			<br>
 			<a href="https://workos.com/?utm_campaign=github_repo&utm_medium=referral&utm_content=type-fest&utm_source=github">
 				<div>
 					<img src="https://sindresorhus.com/assets/thanks/workos-logo-white-bg.svg" width="220" alt="WorkOS">
@@ -39,7 +33,6 @@
 			</a>
 			<br>
 			<br>
-			<br>
 			<a href="https://transloadit.com?utm_source=sindresorhus&utm_medium=referral&utm_campaign=sponsorship&utm_content=type-fest">
 				<picture>
 					<source width="350" media="(prefers-color-scheme: dark)" srcset="https://sindresorhus.com/assets/thanks/transloadit-logo-dark.svg">
@@ -65,6 +58,15 @@
 			</a>
 			<br>
 			<br>
+			<a href="https://nitric.io/?utm_campaign=github_repo&utm_medium=referral&utm_content=sindresorhus&utm_source=github">
+				<div>
+					<img width="230" src="https://sindresorhus.com/assets/thanks/nitric-logo.svg" alt="nitric logo">
+				</div>
+				<b>Effortless backends with infrastructure from code</b>
+				<div>
+					<sup>An open-source framework that supports any programming language, cloud provider, or deployment automation tool.</sup>
+				</div>
+			</a>
 		</p>
 	</div>
 	<br>
@@ -1051,4 +1053,7 @@ You can find some examples in the [TypeScript docs](https://www.typescriptlang.o
 
 ## License
 
+- [MIT](license-mit)
+- [CC0-1.0](license-cc0)
+
 SPDX-License-Identifier: (MIT OR CC0-1.0)

package/source/array-slice.d.ts

@@ -59,11 +59,13 @@ export type ArraySlice<
 	Array_ extends readonly unknown[],
 	Start extends number = never,
 	End extends number = never,
-> = And<IsEqual<Start, never>, IsEqual<End, never>> extends true
-	? Array_
-	: number extends Array_['length']
-		? VariableLengthArraySliceHelper<Array_, Start, End>
-		: ArraySliceHelper<Array_, IsEqual<Start, never> extends true ? 0 : Start, IsEqual<End, never> extends true ? Array_['length'] : End>;
+> = Array_ extends unknown // To distributive type
+	? And<IsEqual<Start, never>, IsEqual<End, never>> extends true
+		? Array_
+		: number extends Array_['length']
+			? VariableLengthArraySliceHelper<Array_, Start, End>
+			: ArraySliceHelper<Array_, IsEqual<Start, never> extends true ? 0 : Start, IsEqual<End, never> extends true ? Array_['length'] : End>
+	: never; // Never happens
 
 type VariableLengthArraySliceHelper<
 	Array_ extends readonly unknown[],

package/source/shared-union-fields-deep.d.ts

@@ -81,13 +81,10 @@ function displayPetInfo(petInfo: SharedUnionFieldsDeep<Cat | Dog>['info']) {
 @category Union
 */
 export type SharedUnionFieldsDeep<Union, Options extends SharedUnionFieldsDeepOptions = {recurseIntoArrays: false}> =
-// If `Union` is not a union type, return `Union` directly.
-IsUnion<Union> extends false
-	? Union
 	// `Union extends` will convert `Union`
 	// to a [distributive conditionaltype](https://www.typescriptlang.org/docs/handbook/release-notes/typescript-2-8.html#distributive-conditional-types).
 	// But this is not what we want, so we need to wrap `Union` with `[]` to prevent it.
-	: [Union] extends [NonRecursiveType | ReadonlyMap<unknown, unknown> | ReadonlySet<unknown>]
+	[Union] extends [NonRecursiveType | ReadonlyMap<unknown, unknown> | ReadonlySet<unknown>]
 		? Union
 		: [Union] extends [UnknownArray]
 			? Options['recurseIntoArrays'] extends true

package/source/tsconfig-json.d.ts

@@ -55,6 +55,8 @@ declare namespace TsConfigJson {
 			| 'ES2020'
 			| 'ES2021'
 			| 'ES2022'
+			| 'ES2023'
+			| 'ES2024'
 			| 'ESNext'
 			// Lowercase alternatives
 			| 'es3'
@@ -68,6 +70,8 @@ declare namespace TsConfigJson {
 			| 'es2020'
 			| 'es2021'
 			| 'es2022'
+			| 'es2023'
+			| 'es2024'
 			| 'esnext';
 
 		// eslint-disable-next-line unicorn/prevent-abbreviations
@@ -88,6 +92,8 @@ declare namespace TsConfigJson {
 			| 'ES2016'
 			| 'ES2016.Array.Include'
 			| 'ES2017'
+			| 'ES2017.ArrayBuffer'
+			| 'ES2017.Date'
 			| 'ES2017.Intl'
 			| 'ES2017.Object'
 			| 'ES2017.SharedMemory'
@@ -112,6 +118,7 @@ declare namespace TsConfigJson {
 			| 'ES2020.SharedMemory'
 			| 'ES2020.Intl'
 			| 'ES2021'
+			| 'ES2021.Intl'
 			| 'ES2021.Promise'
 			| 'ES2021.String'
 			| 'ES2021.WeakRef'
@@ -120,14 +127,29 @@ declare namespace TsConfigJson {
 			| 'ES2022.Error'
 			| 'ES2022.Intl'
 			| 'ES2022.Object'
-			| 'ES2022.SharedMemory'
-			| 'ES2022.String'
 			| 'ES2022.RegExp'
+			| 'ES2022.String'
+			| 'ES2023'
+			| 'ES2023.Array'
+			| 'ES2023.Collection'
+			| 'ES2023.Intl'
+			| 'ES2024'
+			| 'ES2024.ArrayBuffer'
+			| 'ES2024.Collection'
+			| 'ES2024.Object'
+			| 'ES2024.Promise'
+			| 'ES2024.Regexp'
+			| 'ES2024.SharedMemory'
+			| 'ES2024.String'
 			| 'ESNext'
 			| 'ESNext.Array'
 			| 'ESNext.AsyncIterable'
 			| 'ESNext.BigInt'
+			| 'ESNext.Collection'
+			| 'ESNext.Decorators'
+			| 'ESNext.Disposable'
 			| 'ESNext.Intl'
+			| 'ESNext.Iterator'
 			| 'ESNext.Promise'
 			| 'ESNext.String'
 			| 'ESNext.Symbol'
@@ -136,6 +158,7 @@ declare namespace TsConfigJson {
 			| 'DOM.Iterable'
 			| 'ScriptHost'
 			| 'WebWorker'
+			| 'WebWorker.AsyncIterable'
 			| 'WebWorker.ImportScripts'
 			| 'WebWorker.Iterable'
 			// Lowercase alternatives
@@ -155,6 +178,8 @@ declare namespace TsConfigJson {
 			| 'es2016'
 			| 'es2016.array.include'
 			| 'es2017'
+			| 'es2017.arraybuffer'
+			| 'es2017.date'
 			| 'es2017.intl'
 			| 'es2017.object'
 			| 'es2017.sharedmemory'
@@ -179,6 +204,7 @@ declare namespace TsConfigJson {
 			| 'es2020.sharedmemory'
 			| 'es2020.intl'
 			| 'es2021'
+			| 'es2021.intl'
 			| 'es2021.promise'
 			| 'es2021.string'
 			| 'es2021.weakref'
@@ -187,14 +213,29 @@ declare namespace TsConfigJson {
 			| 'es2022.error'
 			| 'es2022.intl'
 			| 'es2022.object'
-			| 'es2022.sharedmemory'
-			| 'es2022.string'
 			| 'es2022.regexp'
+			| 'es2022.string'
+			| 'es2023'
+			| 'es2023.array'
+			| 'es2023.collection'
+			| 'es2023.intl'
+			| 'es2024'
+			| 'es2024.arraybuffer'
+			| 'es2024.collection'
+			| 'es2024.object'
+			| 'es2024.promise'
+			| 'es2024.regexp'
+			| 'es2024.sharedmemory'
+			| 'es2024.string'
 			| 'esnext'
 			| 'esnext.array'
 			| 'esnext.asynciterable'
 			| 'esnext.bigint'
+			| 'esnext.collection'
+			| 'esnext.decorators'
+			| 'esnext.disposable'
 			| 'esnext.intl'
+			| 'esnext.iterator'
 			| 'esnext.promise'
 			| 'esnext.string'
 			| 'esnext.symbol'
@@ -203,6 +244,7 @@ declare namespace TsConfigJson {
 			| 'dom.iterable'
 			| 'scripthost'
 			| 'webworker'
+			| 'webworker.asynciterable'
 			| 'webworker.importscripts'
 			| 'webworker.iterable';
 
@@ -581,6 +623,13 @@ declare namespace TsConfigJson {
 		*/
 		isolatedModules?: boolean;
 
+		/**
+		Require sufficient annotation on exports so other tools can trivially generate declaration files.
+
+		@default false
+		*/
+		isolatedDeclarations?: boolean;
+
 		/**
 		Generates corresponding '.map' file.
 
@@ -694,6 +743,13 @@ declare namespace TsConfigJson {
 		*/
 		noUncheckedIndexedAccess?: boolean;
 
+		/**
+		Report error if failed to find a source file for a side effect import.
+
+		@default false
+		*/
+		noUncheckedSideEffectImports?: boolean;
+
 		/**
 		Report errors for fallthrough cases in switch statement.
 
@@ -729,6 +785,11 @@ declare namespace TsConfigJson {
 		*/
 		generateCpuProfile?: string;
 
+		/**
+		Generates an event trace and a list of types.
+		*/
+		generateTrace?: boolean;
+
 		/**
 		Base directory to resolve non-relative module names.
 		*/
@@ -878,6 +939,13 @@ declare namespace TsConfigJson {
 		*/
 		checkJs?: boolean;
 
+		/**
+		Built-in iterators are instantiated with a `TReturn` type of undefined instead of `any`.
+
+		@default false
+		*/
+		strictBuiltinIteratorReturn?: boolean;
+
 		/**
 		Disable bivariant parameter checking for function types.
 
@@ -1120,6 +1188,11 @@ declare namespace TsConfigJson {
 		Specifies a list of type declarations to be excluded from auto type acquisition. For example, `['jquery', 'lodash']`.
 		*/
 		exclude?: string[];
+
+		/**
+		Disable infering what types should be added based on filenames in a project.
+		*/
+		disableFilenameBasedTypeAcquisition?: boolean;
 	};
 
 	export type References = {