type-fest 2.3.0 → 2.3.4

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "type-fest",
-	"version": "2.3.0",
+	"version": "2.3.4",
 	"description": "A collection of essential TypeScript types",
 	"license": "(MIT OR CC0-1.0)",
 	"repository": "sindresorhus/type-fest",
@@ -14,7 +14,7 @@
 		"node": ">=12.20"
 	},
 	"scripts": {
-		"test": "xo && tsd && tsc"
+		"test": "xo && tsd && tsc && node script/test/source-files-extension.js"
 	},
 	"files": [
 		"index.d.ts",

package/source/except.d.ts

@@ -1,3 +1,34 @@
+import {IsEqual} from './internal';
+
+/**
+Filter out keys from an object.
+
+Returns `never` if `Exclude` is strictly equal to `Key`.
+Returns `never` if `Key` extends `Exclude`.
+Returns `Key` otherwise.
+
+@example
+```
+type Filtered = Filter<'foo', 'foo'>;
+//=> never
+```
+
+@example
+```
+type Filtered = Filter<'bar', string>;
+//=> never
+```
+
+@example
+```
+type Filtered = Filter<'bar', 'foo'>;
+//=> 'bar'
+```
+
+@see {Except}
+*/
+type Filter<KeyType, ExcludeType> = IsEqual<KeyType, ExcludeType> extends true ? never : (KeyType extends ExcludeType ? never : KeyType);
+
 /**
 Create a type from an object type without certain keys.
 
@@ -21,4 +52,6 @@ type FooWithoutA = Except<Foo, 'a' | 'c'>;
 
 @category Utilities
 */
-export type Except<ObjectType, KeysType extends keyof ObjectType> = Pick<ObjectType, Exclude<keyof ObjectType, KeysType>>;
+export type Except<ObjectType, KeysType extends keyof ObjectType> = {
+	[KeyType in keyof ObjectType as Filter<KeyType, KeysType>]: ObjectType[KeyType];
+};

package/source/includes.d.ts

@@ -1,13 +1,4 @@
-/**
-Returns a boolean for whether the two given types are equal.
-
-@link https://github.com/microsoft/TypeScript/issues/27024#issuecomment-421529650
-*/
-type IsEqual<T, U> =
-	(<G>() => G extends T ? 1 : 2) extends
-	(<G>() => G extends U ? 1 : 2)
-		? true
-		: false;
+import {IsEqual} from './internal';
 
 /**
 Returns a boolean for whether the given array includes the given item.

package/source/internal.d.ts

@@ -0,0 +1,11 @@
+/**
+Returns a boolean for whether the two given types are equal.
+
+@link https://github.com/microsoft/TypeScript/issues/27024#issuecomment-421529650
+@link https://stackoverflow.com/questions/68961864/how-does-the-equals-work-in-typescript/68963796#68963796
+*/
+export type IsEqual<T, U> =
+	(<G>() => G extends T ? 1 : 2) extends
+	(<G>() => G extends U ? 1 : 2)
+		? true
+		: false;

package/source/last-array-element.d.ts

@@ -18,8 +18,10 @@ typeof lastOf(array);
 @category Template Literals
 */
 export type LastArrayElement<ValueType extends readonly unknown[]> =
-	ValueType extends [infer ElementType]
+	ValueType extends readonly [infer ElementType]
 		? ElementType
-		: ValueType extends [infer _, ...infer Tail]
-			? LastArrayElement<Tail>
-			: never;
+		: ValueType extends readonly [infer _, ...infer Tail]
+		? LastArrayElement<Tail>
+		: ValueType extends ReadonlyArray<infer ElementType>
+		? ElementType
+		: never;

package/source/promise-value.d.ts

@@ -24,6 +24,4 @@ let recursiveAsyncData: PromiseValue<RecursiveAsyncData> = Promise.resolve(Promi
 
 @category Utilities
 */
-export type PromiseValue<PromiseType, Otherwise = PromiseType> = PromiseType extends Promise<infer Value>
-	? {0: PromiseValue<Value>; 1: Value}[PromiseType extends Promise<unknown> ? 0 : 1]
-	: Otherwise;
+export type PromiseValue<PromiseType> = PromiseType extends PromiseLike<infer Value> ? PromiseValue<Value> : PromiseType;