@visulima/tsconfig 1.1.22 → 1.2.0

package/CHANGELOG.md

@@ -1,3 +1,20 @@
+## @visulima/tsconfig [1.2.0](https://github.com/visulima/visulima/compare/@visulima/tsconfig@1.1.23...@visulima/tsconfig@1.2.0) (2025-09-24)
+
+### Features
+
+* **tsconfig:** added support for typescript 5.9 ([b107d4e](https://github.com/visulima/visulima/commit/b107d4ee8a1f6df34e8613b08a377786283c9ff0))
+
+## @visulima/tsconfig [1.1.23](https://github.com/visulima/visulima/compare/@visulima/tsconfig@1.1.22...@visulima/tsconfig@1.1.23) (2025-09-23)
+
+### Miscellaneous Chores
+
+* update package.json and pnpm-lock.yaml to include publint@0.3.12 and adjust build/test commands to exclude shared-utils ([1f7b3c0](https://github.com/visulima/visulima/commit/1f7b3c0381d77edfeec80ea1bf57b3469e929414))
+
+
+### Dependencies
+
+* **@visulima/fs:** upgraded to 3.1.9
+
 ## @visulima/tsconfig [1.1.22](https://github.com/visulima/visulima/compare/@visulima/tsconfig@1.1.21...@visulima/tsconfig@1.1.22) (2025-09-19)
 
 ### Miscellaneous Chores

package/README.md

@@ -101,7 +101,7 @@ const tsconfig = await readTsConfig("/Users/../Projects/visulima/packages/tsconf
 type TsConfigJson = object;
 ```
 
-Defined in: node\_modules/.pnpm/type-fest@4.41.0/node\_modules/type-fest/source/tsconfig-json.d.ts:1
+Defined in: node_modules/.pnpm/type-fest@4.41.0/node_modules/type-fest/source/tsconfig-json.d.ts:1
 
 Type for [TypeScript's `tsconfig.json` file](https://www.typescriptlang.org/docs/handbook/tsconfig-json.html) (TypeScript 3.7).
 
@@ -113,7 +113,7 @@ Type for [TypeScript's `tsconfig.json` file](https://www.typescriptlang.org/docs
 optional compileOnSave: boolean;
 ```
 
-Defined in: node\_modules/.pnpm/type-fest@4.41.0/node\_modules/type-fest/source/tsconfig-json.d.ts:1264
+Defined in: node_modules/.pnpm/type-fest@4.41.0/node_modules/type-fest/source/tsconfig-json.d.ts:1264
 
 Enable Compile-on-Save for this project.
 
@@ -123,7 +123,7 @@ Enable Compile-on-Save for this project.
 optional compilerOptions: CompilerOptions;
 ```
 
-Defined in: node\_modules/.pnpm/type-fest@4.41.0/node\_modules/type-fest/source/tsconfig-json.d.ts:1249
+Defined in: node_modules/.pnpm/type-fest@4.41.0/node_modules/type-fest/source/tsconfig-json.d.ts:1249
 
 Instructs the TypeScript compiler how to compile `.ts` files.
 
@@ -133,7 +133,7 @@ Instructs the TypeScript compiler how to compile `.ts` files.
 optional exclude: string[];
 ```
 
-Defined in: node\_modules/.pnpm/type-fest@4.41.0/node\_modules/type-fest/source/tsconfig-json.d.ts:1281
+Defined in: node_modules/.pnpm/type-fest@4.41.0/node_modules/type-fest/source/tsconfig-json.d.ts:1281
 
 Specifies a list of files to be excluded from compilation. The `exclude` property only affects the files included via the `include` property and not the `files` property.
 
@@ -145,7 +145,7 @@ Glob patterns require TypeScript version 2.0 or later.
 optional extends: string | string[];
 ```
 
-Defined in: node\_modules/.pnpm/type-fest@4.41.0/node\_modules/type-fest/source/tsconfig-json.d.ts:1269
+Defined in: node_modules/.pnpm/type-fest@4.41.0/node_modules/type-fest/source/tsconfig-json.d.ts:1269
 
 Path to base configuration file to inherit from.
 
@@ -155,7 +155,7 @@ Path to base configuration file to inherit from.
 optional files: string[];
 ```
 
-Defined in: node\_modules/.pnpm/type-fest@4.41.0/node\_modules/type-fest/source/tsconfig-json.d.ts:1274
+Defined in: node_modules/.pnpm/type-fest@4.41.0/node_modules/type-fest/source/tsconfig-json.d.ts:1274
 
 If no `files` or `include` property is present in a `tsconfig.json`, the compiler defaults to including all files in the containing directory and subdirectories except those specified by `exclude`. When a `files` property is specified, only those files and those specified by `include` are included.
 
@@ -165,7 +165,7 @@ If no `files` or `include` property is present in a `tsconfig.json`, the compile
 optional include: string[];
 ```
 
-Defined in: node\_modules/.pnpm/type-fest@4.41.0/node\_modules/type-fest/source/tsconfig-json.d.ts:1288
+Defined in: node_modules/.pnpm/type-fest@4.41.0/node_modules/type-fest/source/tsconfig-json.d.ts:1288
 
 Specifies a list of glob patterns that match files to be included in compilation.
 
@@ -177,7 +177,7 @@ If no `files` or `include` property is present in a `tsconfig.json`, the compile
 optional references: References[];
 ```
 
-Defined in: node\_modules/.pnpm/type-fest@4.41.0/node\_modules/type-fest/source/tsconfig-json.d.ts:1293
+Defined in: node_modules/.pnpm/type-fest@4.41.0/node_modules/type-fest/source/tsconfig-json.d.ts:1293
 
 Referenced projects.
 
@@ -187,7 +187,7 @@ Referenced projects.
 optional typeAcquisition: TypeAcquisition;
 ```
 
-Defined in: node\_modules/.pnpm/type-fest@4.41.0/node\_modules/type-fest/source/tsconfig-json.d.ts:1259
+Defined in: node_modules/.pnpm/type-fest@4.41.0/node_modules/type-fest/source/tsconfig-json.d.ts:1259
 
 Auto type (.d.ts) acquisition options for this project.
 
@@ -197,7 +197,7 @@ Auto type (.d.ts) acquisition options for this project.
 optional watchOptions: WatchOptions;
 ```
 
-Defined in: node\_modules/.pnpm/type-fest@4.41.0/node\_modules/type-fest/source/tsconfig-json.d.ts:1254
+Defined in: node_modules/.pnpm/type-fest@4.41.0/node_modules/type-fest/source/tsconfig-json.d.ts:1254
 
 Instructs the TypeScript compiler how to watch files.
 
@@ -209,7 +209,7 @@ Instructs the TypeScript compiler how to watch files.
 function findTsConfig(cwd?, options?): Promise<TsConfigResult>;
 ```
 
-Defined in: [packages/tsconfig/src/find-tsconfig.ts:30](https://github.com/visulima/visulima/blob/2ba2196cfa1aecc6ede047ef10ca5785def47ef1/packages/tsconfig/src/find-tsconfig.ts#L30)
+Defined in: [packages/tsconfig/src/find-tsconfig.ts:30](https://github.com/visulima/visulima/blob/afe199ce97ec3025aa13484407254660803d8d9c/packages/tsconfig/src/find-tsconfig.ts#L30)
 
 An asynchronous function that retrieves the TSConfig by searching for the "tsconfig.json" first,
 second attempt is to look for the "jsconfig.json" file from a given current working directory.
@@ -219,7 +219,7 @@ second attempt is to look for the "jsconfig.json" file from a given current work
 ##### cwd?
 
 Optional. The current working directory from which to search for the "tsconfig.json" file.
-             The type of `cwd` is `string`.
+The type of `cwd` is `string`.
 
 `string` | `URL`
 
@@ -232,13 +232,13 @@ Optional. The current working directory from which to search for the "tsconfig.j
 `Promise`\<[`TsConfigResult`](#tsconfigresult)\>
 
 A `Promise` that resolves to the TSConfig result object.
-         The return type of the function is `Promise<TsConfigResult>`.
+The return type of the function is `Promise<TsConfigResult>`.
 
 #### Throws
 
 An `Error` when the "tsconfig.json" file is not found.
 
-***
+---
 
 ### findTsConfigSync()
 
@@ -246,7 +246,7 @@ An `Error` when the "tsconfig.json" file is not found.
 function findTsConfigSync(cwd?, options?): TsConfigResult;
 ```
 
-Defined in: [packages/tsconfig/src/find-tsconfig.ts:69](https://github.com/visulima/visulima/blob/2ba2196cfa1aecc6ede047ef10ca5785def47ef1/packages/tsconfig/src/find-tsconfig.ts#L69)
+Defined in: [packages/tsconfig/src/find-tsconfig.ts:69](https://github.com/visulima/visulima/blob/afe199ce97ec3025aa13484407254660803d8d9c/packages/tsconfig/src/find-tsconfig.ts#L69)
 
 #### Parameters
 
@@ -262,7 +262,7 @@ Defined in: [packages/tsconfig/src/find-tsconfig.ts:69](https://github.com/visul
 
 [`TsConfigResult`](#tsconfigresult)
 
-***
+---
 
 ### readTsConfig()
 
@@ -270,7 +270,7 @@ Defined in: [packages/tsconfig/src/find-tsconfig.ts:69](https://github.com/visul
 function readTsConfig(tsconfigPath, options?): object;
 ```
 
-Defined in: [packages/tsconfig/src/read-tsconfig.ts:460](https://github.com/visulima/visulima/blob/2ba2196cfa1aecc6ede047ef10ca5785def47ef1/packages/tsconfig/src/read-tsconfig.ts#L460)
+Defined in: [packages/tsconfig/src/read-tsconfig.ts:460](https://github.com/visulima/visulima/blob/afe199ce97ec3025aa13484407254660803d8d9c/packages/tsconfig/src/read-tsconfig.ts#L460)
 
 #### Parameters
 
@@ -352,7 +352,7 @@ optional watchOptions: WatchOptions;
 
 Instructs the TypeScript compiler how to watch files.
 
-***
+---
 
 ### writeTsConfig()
 
@@ -360,7 +360,7 @@ Instructs the TypeScript compiler how to watch files.
 function writeTsConfig(tsConfig, options): Promise<void>;
 ```
 
-Defined in: [packages/tsconfig/src/write-tsconfig.ts:17](https://github.com/visulima/visulima/blob/2ba2196cfa1aecc6ede047ef10ca5785def47ef1/packages/tsconfig/src/write-tsconfig.ts#L17)
+Defined in: [packages/tsconfig/src/write-tsconfig.ts:17](https://github.com/visulima/visulima/blob/afe199ce97ec3025aa13484407254660803d8d9c/packages/tsconfig/src/write-tsconfig.ts#L17)
 
 An asynchronous function that writes the provided TypeScript configuration object to a tsconfig.json file.
 
@@ -386,7 +386,7 @@ intersection type of `WriteOptions` and a Record type with an optional `cwd` key
 A `Promise` that resolves when the tsconfig.json file has been written.
 The return type of function is `Promise<void>`.
 
-***
+---
 
 ### writeTsConfigSync()
 
@@ -394,7 +394,7 @@ The return type of function is `Promise<void>`.
 function writeTsConfigSync(tsConfig, options): void;
 ```
 
-Defined in: [packages/tsconfig/src/write-tsconfig.ts:35](https://github.com/visulima/visulima/blob/2ba2196cfa1aecc6ede047ef10ca5785def47ef1/packages/tsconfig/src/write-tsconfig.ts#L35)
+Defined in: [packages/tsconfig/src/write-tsconfig.ts:35](https://github.com/visulima/visulima/blob/afe199ce97ec3025aa13484407254660803d8d9c/packages/tsconfig/src/write-tsconfig.ts#L35)
 
 A function that writes the provided TypeScript configuration object to a tsconfig.json file.
 
@@ -420,7 +420,7 @@ intersection type of `WriteOptions` and a Record type with an optional `cwd` key
 A `Promise` that resolves when the tsconfig.json file has been written.
 The return type of function is `Promise<void>`.
 
-***
+---
 
 ### implicitBaseUrlSymbol
 
@@ -428,9 +428,9 @@ The return type of function is `Promise<void>`.
 const implicitBaseUrlSymbol: typeof implicitBaseUrlSymbol;
 ```
 
-Defined in: [packages/tsconfig/src/read-tsconfig.ts:457](https://github.com/visulima/visulima/blob/2ba2196cfa1aecc6ede047ef10ca5785def47ef1/packages/tsconfig/src/read-tsconfig.ts#L457)
+Defined in: [packages/tsconfig/src/read-tsconfig.ts:457](https://github.com/visulima/visulima/blob/afe199ce97ec3025aa13484407254660803d8d9c/packages/tsconfig/src/read-tsconfig.ts#L457)
 
-***
+---
 
 ### FindTsConfigOptions
 
@@ -438,14 +438,14 @@ Defined in: [packages/tsconfig/src/read-tsconfig.ts:457](https://github.com/visu
 type FindTsConfigOptions = ReadTsConfigOptions & object;
 ```
 
-Defined in: [packages/tsconfig/src/find-tsconfig.ts:10](https://github.com/visulima/visulima/blob/2ba2196cfa1aecc6ede047ef10ca5785def47ef1/packages/tsconfig/src/find-tsconfig.ts#L10)
+Defined in: [packages/tsconfig/src/find-tsconfig.ts:10](https://github.com/visulima/visulima/blob/afe199ce97ec3025aa13484407254660803d8d9c/packages/tsconfig/src/find-tsconfig.ts#L10)
 
 #### Type declaration
 
 ##### cache?
 
 ```ts
-optional cache: 
+optional cache:
   | Map<string, TsConfigJsonResolved>
   | boolean;
 ```
@@ -456,7 +456,7 @@ optional cache:
 optional configFileName: string;
 ```
 
-***
+---
 
 ### ReadTsConfigOptions
 
@@ -464,7 +464,7 @@ optional configFileName: string;
 type ReadTsConfigOptions = object;
 ```
 
-Defined in: [packages/tsconfig/src/read-tsconfig.ts:444](https://github.com/visulima/visulima/blob/2ba2196cfa1aecc6ede047ef10ca5785def47ef1/packages/tsconfig/src/read-tsconfig.ts#L444)
+Defined in: [packages/tsconfig/src/read-tsconfig.ts:444](https://github.com/visulima/visulima/blob/afe199ce97ec3025aa13484407254660803d8d9c/packages/tsconfig/src/read-tsconfig.ts#L444)
 
 #### Properties
 
@@ -474,7 +474,7 @@ Defined in: [packages/tsconfig/src/read-tsconfig.ts:444](https://github.com/visu
 optional tscCompatible: "5.3" | "5.4" | "5.5" | "5.6" | true;
 ```
 
-Defined in: [packages/tsconfig/src/read-tsconfig.ts:452](https://github.com/visulima/visulima/blob/2ba2196cfa1aecc6ede047ef10ca5785def47ef1/packages/tsconfig/src/read-tsconfig.ts#L452)
+Defined in: [packages/tsconfig/src/read-tsconfig.ts:452](https://github.com/visulima/visulima/blob/afe199ce97ec3025aa13484407254660803d8d9c/packages/tsconfig/src/read-tsconfig.ts#L452)
 
 Make the configuration compatible with the specified TypeScript version.
 
@@ -483,10 +483,10 @@ When `true`, it will make the configuration compatible with the latest TypeScrip
 ###### Default
 
 ```ts
-undefined
+undefined;
 ```
 
-***
+---
 
 ### TsConfigJsonResolved
 
@@ -494,9 +494,9 @@ undefined
 type TsConfigJsonResolved = Except<TsConfigJson, "extends">;
 ```
 
-Defined in: [packages/tsconfig/src/types.ts:3](https://github.com/visulima/visulima/blob/2ba2196cfa1aecc6ede047ef10ca5785def47ef1/packages/tsconfig/src/types.ts#L3)
+Defined in: [packages/tsconfig/src/types.ts:3](https://github.com/visulima/visulima/blob/afe199ce97ec3025aa13484407254660803d8d9c/packages/tsconfig/src/types.ts#L3)
 
-***
+---
 
 ### TsConfigResult
 
@@ -504,7 +504,7 @@ Defined in: [packages/tsconfig/src/types.ts:3](https://github.com/visulima/visul
 type TsConfigResult = object;
 ```
 
-Defined in: [packages/tsconfig/src/find-tsconfig.ts:15](https://github.com/visulima/visulima/blob/2ba2196cfa1aecc6ede047ef10ca5785def47ef1/packages/tsconfig/src/find-tsconfig.ts#L15)
+Defined in: [packages/tsconfig/src/find-tsconfig.ts:15](https://github.com/visulima/visulima/blob/afe199ce97ec3025aa13484407254660803d8d9c/packages/tsconfig/src/find-tsconfig.ts#L15)
 
 #### Properties
 
@@ -514,7 +514,7 @@ Defined in: [packages/tsconfig/src/find-tsconfig.ts:15](https://github.com/visul
 config: TsConfigJsonResolved;
 ```
 
-Defined in: [packages/tsconfig/src/find-tsconfig.ts:16](https://github.com/visulima/visulima/blob/2ba2196cfa1aecc6ede047ef10ca5785def47ef1/packages/tsconfig/src/find-tsconfig.ts#L16)
+Defined in: [packages/tsconfig/src/find-tsconfig.ts:16](https://github.com/visulima/visulima/blob/afe199ce97ec3025aa13484407254660803d8d9c/packages/tsconfig/src/find-tsconfig.ts#L16)
 
 ##### path
 
@@ -522,7 +522,7 @@ Defined in: [packages/tsconfig/src/find-tsconfig.ts:16](https://github.com/visul
 path: string;
 ```
 
-Defined in: [packages/tsconfig/src/find-tsconfig.ts:17](https://github.com/visulima/visulima/blob/2ba2196cfa1aecc6ede047ef10ca5785def47ef1/packages/tsconfig/src/find-tsconfig.ts#L17)
+Defined in: [packages/tsconfig/src/find-tsconfig.ts:17](https://github.com/visulima/visulima/blob/afe199ce97ec3025aa13484407254660803d8d9c/packages/tsconfig/src/find-tsconfig.ts#L17)
 
 <!-- /TYPEDOC -->
 

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const i=require("./packem_shared/findTsConfig-BBvqkZJ6.cjs"),e=require("./packem_shared/implicitBaseUrlSymbol-DMcyudm3.cjs"),n=require("./packem_shared/writeTsConfig-C99ubsh6.cjs");exports.findTsConfig=i.findTsConfig;exports.findTsConfigSync=i.findTsConfigSync;exports.implicitBaseUrlSymbol=e.implicitBaseUrlSymbol;exports.readTsConfig=e.readTsConfig;exports.writeTsConfig=n.writeTsConfig;exports.writeTsConfigSync=n.writeTsConfigSync;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const i=require("./packem_shared/findTsConfig-B1SNRXnt.cjs"),e=require("./packem_shared/implicitBaseUrlSymbol-B_X9pk9Z.cjs"),n=require("./packem_shared/writeTsConfig-C99ubsh6.cjs");exports.findTsConfig=i.findTsConfig;exports.findTsConfigSync=i.findTsConfigSync;exports.implicitBaseUrlSymbol=e.implicitBaseUrlSymbol;exports.readTsConfig=e.readTsConfig;exports.writeTsConfig=n.writeTsConfig;exports.writeTsConfigSync=n.writeTsConfigSync;

package/dist/index.d.cts

@@ -1,12 +1,83 @@
 import { WriteJsonOptions } from '@visulima/fs';
 
-declare global {
-	// eslint-disable-next-line @typescript-eslint/consistent-type-definitions -- It has to be an `interface` so that it can be merged.
-	interface SymbolConstructor {
-		readonly observable: symbol;
-	}
+/**
+Returns a boolean for whether the given type is `any`.
+
+@link https://stackoverflow.com/a/49928360/1490091
+
+Useful in type utilities, such as disallowing `any`s to be passed to a function.
+
+@example
+```
+import type {IsAny} from 'type-fest';
+
+const typedObject = {a: 1, b: 2} as const;
+const anyObject: any = {a: 1, b: 2};
+
+function get<O extends (IsAny<O> extends true ? {} : Record<string, number>), K extends keyof O = keyof O>(obj: O, key: K) {
+	return obj[key];
+}
+
+const typedA = get(typedObject, 'a');
+//=> 1
+
+const anyA = get(anyObject, 'a');
+//=> any
+```
+
+@category Type Guard
+@category Utilities
+*/
+type IsAny<T> = 0 extends 1 & NoInfer<T> ? true : false;
+
+/**
+Returns a boolean for whether the given key is an optional key of type.
+
+This is useful when writing utility types or schema validators that need to differentiate `optional` keys.
+
+@example
+```
+import type {IsOptionalKeyOf} from 'type-fest';
+
+interface User {
+	name: string;
+	surname: string;
+
+	luckyNumber?: number;
+}
+
+interface Admin {
+	name: string;
+	surname?: string;
 }
 
+type T1 = IsOptionalKeyOf<User, 'luckyNumber'>;
+//=> true
+
+type T2 = IsOptionalKeyOf<User, 'name'>;
+//=> false
+
+type T3 = IsOptionalKeyOf<User, 'name' | 'luckyNumber'>;
+//=> boolean
+
+type T4 = IsOptionalKeyOf<User | Admin, 'name'>;
+//=> false
+
+type T5 = IsOptionalKeyOf<User | Admin, 'surname'>;
+//=> boolean
+```
+
+@category Type Guard
+@category Utilities
+*/
+type IsOptionalKeyOf<Type extends object, Key extends keyof Type> =
+	IsAny<Type | Key> extends true ? never
+		: Key extends keyof Type
+			? Type extends Record<Key, Type[Key]>
+				? false
+				: true
+			: false;
+
 /**
 Extract all optional keys from the given type.
 
@@ -40,11 +111,14 @@ const update2: UpdateOperation<User> = {
 
 @category Utilities
 */
-type OptionalKeysOf<BaseType extends object> =
-	BaseType extends unknown // For distributing `BaseType`
-		? (keyof {
-			[Key in keyof BaseType as BaseType extends Record<Key, BaseType[Key]> ? never : Key]: never
-		}) & (keyof BaseType) // Intersect with `keyof BaseType` to ensure result of `OptionalKeysOf<BaseType>` is always assignable to `keyof BaseType`
+type OptionalKeysOf<Type extends object> =
+	Type extends unknown // For distributing `Type`
+		? (keyof {[Key in keyof Type as
+			IsOptionalKeyOf<Type, Key> extends false
+				? never
+				: Key
+			]: never
+		}) & keyof Type // Intersect with `keyof Type` to ensure result of `OptionalKeysOf<Type>` is always assignable to `keyof Type`
 		: never; // Should never happen
 
 /**
@@ -71,9 +145,9 @@ const validator2 = createValidation<User>('surname', value => value.length < 25)
 
 @category Utilities
 */
-type RequiredKeysOf<BaseType extends object> =
-	BaseType extends unknown // For distributing `BaseType`
-		? Exclude<keyof BaseType, OptionalKeysOf<BaseType>>
+type RequiredKeysOf<Type extends object> =
+	Type extends unknown // For distributing `Type`
+		? Exclude<keyof Type, OptionalKeysOf<Type>>
 		: never; // Should never happen
 
 /**
@@ -120,61 +194,68 @@ endIfEqual('abc', '123');
 type IsNever<T> = [T] extends [never] ? true : false;
 
 /**
-An if-else-like type that resolves depending on whether the given type is `never`.
+An if-else-like type that resolves depending on whether the given `boolean` type is `true` or `false`.
 
-@see {@link IsNever}
+Use-cases:
+- You can use this in combination with `Is*` types to create an if-else-like experience. For example, `If<IsAny<any>, 'is any', 'not any'>`.
+
+Note:
+- Returns a union of if branch and else branch if the given type is `boolean` or `any`. For example, `If<boolean, 'Y', 'N'>` will return `'Y' | 'N'`.
+- Returns the else branch if the given type is `never`. For example, `If<never, 'Y', 'N'>` will return `'N'`.
 
 @example
 ```
-import type {IfNever} from 'type-fest';
+import {If} from 'type-fest';
 
-type ShouldBeTrue = IfNever<never>;
-//=> true
+type A = If<true, 'yes', 'no'>;
+//=> 'yes'
 
-type ShouldBeBar = IfNever<'not never', 'foo', 'bar'>;
-//=> 'bar'
-```
+type B = If<false, 'yes', 'no'>;
+//=> 'no'
 
-@category Type Guard
-@category Utilities
-*/
-type IfNever<T, TypeIfNever = true, TypeIfNotNever = false> = (
-	IsNever<T> extends true ? TypeIfNever : TypeIfNotNever
-);
+type C = If<boolean, 'yes', 'no'>;
+//=> 'yes' | 'no'
 
-// Can eventually be replaced with the built-in once this library supports
-// TS5.4+ only. Tracked in https://github.com/sindresorhus/type-fest/issues/848
-type NoInfer<T> = T extends infer U ? U : never;
+type D = If<any, 'yes', 'no'>;
+//=> 'yes' | 'no'
 
-/**
-Returns a boolean for whether the given type is `any`.
+type E = If<never, 'yes', 'no'>;
+//=> 'no'
+```
 
-@link https://stackoverflow.com/a/49928360/1490091
+@example
+```
+import {If, IsAny, IsNever} from 'type-fest';
 
-Useful in type utilities, such as disallowing `any`s to be passed to a function.
+type A = If<IsAny<unknown>, 'is any', 'not any'>;
+//=> 'not any'
 
-@example
+type B = If<IsNever<never>, 'is never', 'not never'>;
+//=> 'is never'
 ```
-import type {IsAny} from 'type-fest';
 
-const typedObject = {a: 1, b: 2} as const;
-const anyObject: any = {a: 1, b: 2};
+@example
+```
+import {If, IsEqual} from 'type-fest';
 
-function get<O extends (IsAny<O> extends true ? {} : Record<string, number>), K extends keyof O = keyof O>(obj: O, key: K) {
-	return obj[key];
-}
+type IfEqual<T, U, IfBranch, ElseBranch> = If<IsEqual<T, U>, IfBranch, ElseBranch>;
 
-const typedA = get(typedObject, 'a');
-//=> 1
+type A = IfEqual<string, string, 'equal', 'not equal'>;
+//=> 'equal'
 
-const anyA = get(anyObject, 'a');
-//=> any
+type B = IfEqual<string, number, 'equal', 'not equal'>;
+//=> 'not equal'
 ```
 
 @category Type Guard
 @category Utilities
 */
-type IsAny<T> = 0 extends 1 & NoInfer<T> ? true : false;
+type If<Type extends boolean, IfBranch, ElseBranch> =
+	IsNever<Type> extends true
+		? ElseBranch
+		: Type extends true
+			? IfBranch
+			: ElseBranch;
 
 /**
 Returns a boolean for whether the two given types are equal.
@@ -455,33 +536,10 @@ export type FooBar = Merge<Foo, Bar>;
 */
 type Merge<Destination, Source> =
 Simplify<
-SimpleMerge<PickIndexSignature<Destination>, PickIndexSignature<Source>>
-& SimpleMerge<OmitIndexSignature<Destination>, OmitIndexSignature<Source>>
+	SimpleMerge<PickIndexSignature<Destination>, PickIndexSignature<Source>>
+	& SimpleMerge<OmitIndexSignature<Destination>, OmitIndexSignature<Source>>
 >;
 
-/**
-An if-else-like type that resolves depending on whether the given type is `any`.
-
-@see {@link IsAny}
-
-@example
-```
-import type {IfAny} from 'type-fest';
-
-type ShouldBeTrue = IfAny<any>;
-//=> true
-
-type ShouldBeBar = IfAny<'not any', 'foo', 'bar'>;
-//=> 'bar'
-```
-
-@category Type Guard
-@category Utilities
-*/
-type IfAny<T, TypeIfAny = true, TypeIfNotAny = false> = (
-	IsAny<T> extends true ? TypeIfAny : TypeIfNotAny
-);
-
 /**
 Merges user specified options with default options.
 
@@ -539,18 +597,13 @@ type ApplyDefaultOptions<
 	Defaults extends Simplify<Omit<Required<Options>, RequiredKeysOf<Options>> & Partial<Record<RequiredKeysOf<Options>, never>>>,
 	SpecifiedOptions extends Options,
 > =
-	IfAny<SpecifiedOptions, Defaults,
-	IfNever<SpecifiedOptions, Defaults,
-	Simplify<Merge<Defaults, {
-		[Key in keyof SpecifiedOptions
-		as Key extends OptionalKeysOf<Options>
-			? Extract<SpecifiedOptions[Key], undefined> extends never
-				? Key
-				: never
-			: Key
-		]: SpecifiedOptions[Key]
-	}> & Required<Options>> // `& Required<Options>` ensures that `ApplyDefaultOptions<SomeOption, ...>` is always assignable to `Required<SomeOption>`
-	>>;
+	If<IsAny<SpecifiedOptions>, Defaults,
+		If<IsNever<SpecifiedOptions>, Defaults,
+			Simplify<Merge<Defaults, {
+				[Key in keyof SpecifiedOptions
+				as Key extends OptionalKeysOf<Options> ? undefined extends SpecifiedOptions[Key] ? never : Key : Key
+				]: SpecifiedOptions[Key]
+			}> & Required<Options>>>>;
 
 /**
 Filter out keys from an object.
@@ -679,6 +732,7 @@ declare namespace TsConfigJson {
 			| 'ESNext'
 			| 'Node16'
 			| 'Node18'
+			| 'Node20'
 			| 'NodeNext'
 			| 'Preserve'
 			| 'None'
@@ -694,6 +748,7 @@ declare namespace TsConfigJson {
 			| 'esnext'
 			| 'node16'
 			| 'node18'
+			| 'node20'
 			| 'nodenext'
 			| 'preserve'
 			| 'none';
@@ -736,7 +791,6 @@ declare namespace TsConfigJson {
 			| 'es2024'
 			| 'esnext';
 
-		// eslint-disable-next-line unicorn/prevent-abbreviations
 		export type Lib =
 			| 'ES5'
 			| 'ES6'