@pawover/kit 0.0.0-beta.19 → 0.0.0-beta.20

package/dist/{except-DUIiuC3p.d.ts → except-C38JazcR.d.ts}

@@ -1,4 +1,4 @@
-//#region node_modules/.pnpm/type-fest@5.4.2/node_modules/type-fest/source/union-to-intersection.d.ts
+//#region node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/union-to-intersection.d.ts
 /**
 Convert a union type to an intersection type using [distributive conditional types](https://www.typescriptlang.org/docs/handbook/release-notes/typescript-2-8.html#distributive-conditional-types).
 
@@ -32,7 +32,7 @@ Union extends unknown
 // The `& Union` is to ensure result of `UnionToIntersection<A | B>` is always assignable to `A | B`
 ? Intersection & Union : never;
 //#endregion
-//#region node_modules/.pnpm/type-fest@5.4.2/node_modules/type-fest/source/keys-of-union.d.ts
+//#region node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/keys-of-union.d.ts
 /**
 Create a union of all keys from a given type, even those exclusive to specific union members.
 
@@ -74,7 +74,7 @@ type KeysOfUnion<ObjectType> =
 // Hack to fix https://github.com/sindresorhus/type-fest/issues/1008
 keyof UnionToIntersection<ObjectType extends unknown ? Record<keyof ObjectType, never> : never>;
 //#endregion
-//#region node_modules/.pnpm/type-fest@5.4.2/node_modules/type-fest/source/is-any.d.ts
+//#region node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/is-any.d.ts
 /**
 Returns a boolean for whether the given type is `any`.
 
@@ -105,7 +105,7 @@ const anyA = get(anyObject, 'a');
 */
 type IsAny<T> = 0 extends 1 & NoInfer<T> ? true : false;
 //#endregion
-//#region node_modules/.pnpm/type-fest@5.4.2/node_modules/type-fest/source/is-optional-key-of.d.ts
+//#region node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/is-optional-key-of.d.ts
 /**
 Returns a boolean for whether the given key is an optional key of type.
 
@@ -148,7 +148,7 @@ type T5 = IsOptionalKeyOf<User | Admin, 'surname'>;
 */
 type IsOptionalKeyOf<Type extends object, Key$1 extends keyof Type> = IsAny<Type | Key$1> extends true ? never : Key$1 extends keyof Type ? Type extends Record<Key$1, Type[Key$1]> ? false : true : false;
 //#endregion
-//#region node_modules/.pnpm/type-fest@5.4.2/node_modules/type-fest/source/optional-keys-of.d.ts
+//#region node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/optional-keys-of.d.ts
 /**
 Extract all optional keys from the given type.
 
@@ -186,7 +186,7 @@ type OptionalKeysOf<Type extends object> = Type extends unknown // For distribut
 ? (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;
 //#endregion
-//#region node_modules/.pnpm/type-fest@5.4.2/node_modules/type-fest/source/required-keys-of.d.ts
+//#region node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/required-keys-of.d.ts
 /**
 Extract all required keys from the given type.
 
@@ -220,7 +220,7 @@ const validator3 = createValidation<User>('luckyNumber', value => value > 0);
 type RequiredKeysOf<Type extends object> = Type extends unknown // For distributing `Type`
 ? Exclude<keyof Type, OptionalKeysOf<Type>> : never;
 //#endregion
-//#region node_modules/.pnpm/type-fest@5.4.2/node_modules/type-fest/source/is-never.d.ts
+//#region node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/is-never.d.ts
 /**
 Returns a boolean for whether the given type is `never`.
 
@@ -276,7 +276,7 @@ type B = IsTrueFixed<never>;
 */
 type IsNever<T> = [T] extends [never] ? true : false;
 //#endregion
-//#region node_modules/.pnpm/type-fest@5.4.2/node_modules/type-fest/source/if.d.ts
+//#region node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/if.d.ts
 /**
 An if-else-like type that resolves depending on whether the given `boolean` type is `true` or `false`.
 
@@ -371,7 +371,7 @@ type Works = IncludesWithoutIf<HundredZeroes, '1'>;
 */
 type If<Type extends boolean, IfBranch, ElseBranch> = IsNever<Type> extends true ? ElseBranch : Type extends true ? IfBranch : ElseBranch;
 //#endregion
-//#region node_modules/.pnpm/type-fest@5.4.2/node_modules/type-fest/source/unknown-array.d.ts
+//#region node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/unknown-array.d.ts
 /**
 Represents an array with `unknown` value.
 
@@ -398,7 +398,7 @@ type C = IsArray<string>;
 */
 type UnknownArray = readonly unknown[];
 //#endregion
-//#region node_modules/.pnpm/type-fest@5.4.2/node_modules/type-fest/source/internal/type.d.ts
+//#region node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/internal/type.d.ts
 /**
 Returns a boolean for whether A is false.
 
@@ -462,7 +462,7 @@ Indicates the value of `exactOptionalPropertyTypes` compiler option.
 */
 type IsExactOptionalPropertyTypesEnabled = [(string | undefined)?] extends [string?] ? false : true;
 //#endregion
-//#region node_modules/.pnpm/type-fest@5.4.2/node_modules/type-fest/source/simplify.d.ts
+//#region node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/simplify.d.ts
 /**
 Useful to flatten the type output to improve type hints shown in editors. And also to transform an interface into a type to aide with assignability.
 
@@ -523,7 +523,7 @@ fn(someInterface as Simplify<SomeInterface>); // Good: transform an `interface`
 */
 type Simplify<T> = { [KeyType in keyof T]: T[KeyType] } & {};
 //#endregion
-//#region node_modules/.pnpm/type-fest@5.4.2/node_modules/type-fest/source/is-equal.d.ts
+//#region node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/is-equal.d.ts
 /**
 Returns a boolean for whether the two given types are equal.
 
@@ -554,7 +554,7 @@ type IsEqual<A, B> = [A] extends [B] ? [B] extends [A] ? _IsEqual<A, B> : false
 // This version fails the `equalWrappedTupleIntersectionToBeNeverAndNeverExpanded` test in `test-d/is-equal.ts`.
 type _IsEqual<A, B> = (<G>() => G extends A & G | G ? 1 : 2) extends (<G>() => G extends B & G | G ? 1 : 2) ? true : false;
 //#endregion
-//#region node_modules/.pnpm/type-fest@5.4.2/node_modules/type-fest/source/omit-index-signature.d.ts
+//#region node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/omit-index-signature.d.ts
 /**
 Omit any index signatures from the given object type, leaving only explicitly defined properties.
 
@@ -648,7 +648,7 @@ type ExampleWithoutIndexSignatures = OmitIndexSignature<Example>;
 */
 type OmitIndexSignature<ObjectType> = { [KeyType in keyof ObjectType as {} extends Record<KeyType, unknown> ? never : KeyType]: ObjectType[KeyType] };
 //#endregion
-//#region node_modules/.pnpm/type-fest@5.4.2/node_modules/type-fest/source/pick-index-signature.d.ts
+//#region node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/pick-index-signature.d.ts
 /**
 Pick only index signatures from the given object type, leaving out all explicitly defined properties.
 
@@ -696,7 +696,7 @@ type ExampleIndexSignature = PickIndexSignature<Example>;
 */
 type PickIndexSignature<ObjectType> = { [KeyType in keyof ObjectType as {} extends Record<KeyType, unknown> ? KeyType : never]: ObjectType[KeyType] };
 //#endregion
-//#region node_modules/.pnpm/type-fest@5.4.2/node_modules/type-fest/source/merge.d.ts
+//#region node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/merge.d.ts
 // Merges two objects without worrying about index signatures.
 type SimpleMerge<Destination, Source> = Simplify<{ [Key in keyof Destination as Key extends keyof Source ? never : Key]: Destination[Key] } & Source>;
 
@@ -739,10 +739,13 @@ Note: If you want a merge type that more accurately reflects the runtime behavio
 */
 type Merge<Destination, Source> = Destination extends unknown // For distributing `Destination`
 ? Source extends unknown // For distributing `Source`
-? Simplify<SimpleMerge<PickIndexSignature<Destination>, PickIndexSignature<Source>> & SimpleMerge<OmitIndexSignature<Destination>, OmitIndexSignature<Source>>> : never // Should never happen
+? If<IsEqual<Destination, Source>, Destination, _Merge<Destination, Source>> : never // Should never happen
 : never;
+// Should never happen
+
+type _Merge<Destination, Source> = Simplify<SimpleMerge<PickIndexSignature<Destination>, PickIndexSignature<Source>> & SimpleMerge<OmitIndexSignature<Destination>, OmitIndexSignature<Source>>>;
 //#endregion
-//#region node_modules/.pnpm/type-fest@5.4.2/node_modules/type-fest/source/internal/object.d.ts
+//#region node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/internal/object.d.ts
 /**
 Works similar to the built-in `Pick` utility type, except for the following differences:
 - Distributes over union types and allows picking keys from any member of the union type.
@@ -865,7 +868,7 @@ type E = CollapseLiterals<LiteralUnion<'foo' | 'bar', string> | null | undefined
 */
 type CollapseLiterals<T> = {} extends T ? T : T extends infer U & {} ? U : T;
 //#endregion
-//#region node_modules/.pnpm/type-fest@5.4.2/node_modules/type-fest/source/except.d.ts
+//#region node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/except.d.ts
 /**
 Filter out keys from an object.
 
@@ -965,4 +968,4 @@ type Except<ObjectType, KeysType extends keyof ObjectType, Options extends Excep
 type _Except<ObjectType, KeysType extends keyof ObjectType, Options extends Required<ExceptOptions>> = { [KeyType in keyof ObjectType as Filter<KeyType, KeysType>]: ObjectType[KeyType] } & (Options['requireExactProps'] extends true ? Partial<Record<KeysType, never>> : {});
 //#endregion
 export { Simplify as a, Not as c, IsNever as d, OptionalKeysOf as f, HomomorphicPick as i, UnknownArray as l, UnionToIntersection as m, ApplyDefaultOptions as n, IfNotAnyOrNever as o, IsAny as p, CollapseLiterals as r, IsExactOptionalPropertyTypesEnabled as s, Except as t, If as u };
-//# sourceMappingURL=except-DUIiuC3p.d.ts.map
+//# sourceMappingURL=except-C38JazcR.d.ts.map

package/dist/except-C38JazcR.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"except-C38JazcR.d.ts","names":["UnionToIntersection","Union","Intersection","UnionToIntersection","KeysOfUnion","ObjectType","Record","IsAny","T","NoInfer","IsAny","IsOptionalKeyOf","Type","Key","Record","IsOptionalKeyOf","OptionalKeysOf","Type","Key","OptionalKeysOf","RequiredKeysOf","Type","Exclude","IsNever","T","IsNever","If","Type","IfBranch","ElseBranch","UnknownArray","If","IsAny","IsNever","Primitive","UnknownArray","BuiltIns","Date","RegExp","NonRecursiveType","Function","Promise","MapsSetsOrArrays","ReadonlyMap","WeakKey","WeakMap","ReadonlySet","WeakSet","IsBothExtends","BaseType","FirstType","SecondType","HasMultipleCallSignatures","T","IsNotFalse","IsPrimitive","Not","A","IfNotAnyOrNever","IfAny","IfNever","IsAnyOrNever","IsExactOptionalPropertyTypesEnabled","Simplify","T","KeyType","IsNever","IsEqual","A","B","_IsEqual","G","OmitIndexSignature","ObjectType","KeyType","Record","PickIndexSignature","ObjectType","KeyType","Record","OmitIndexSignature","PickIndexSignature","Simplify","If","IsEqual","SimpleMerge","Destination","Source","Key","Merge","_Merge","Simplify","IsEqual","KeysOfUnion","RequiredKeysOf","Merge","OptionalKeysOf","IsAny","If","IsNever","FilterDefinedKeys","FilterOptionalKeys","MapsSetsOrArrays","NonRecursiveType","StringToNumber","ToString","BuildObject","Key","Value","CopiedFrom","PropertyKey","Pick","NumberKey","IsPlainObject","T","ObjectValue","K","NumberK","UndefinedToOptional","Exclude","HomomorphicPick","Keys","P","Extract","ValueOfUnion","Union","ReadonlyKeysOfUnion","ApplyDefaultOptions","Options","Defaults","SpecifiedOptions","Required","Omit","Record","Partial","CollapseLiterals","NormalizedKeys","ApplyDefaultOptions","IsEqual","Filter","KeyType","ExcludeType","ExceptOptions","DefaultExceptOptions","Except","ObjectType","KeysType","Options","_Except","Required","Record","Partial"],"sources":["../node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/union-to-intersection.d.ts","../node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/keys-of-union.d.ts","../node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/is-any.d.ts","../node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/is-optional-key-of.d.ts","../node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/optional-keys-of.d.ts","../node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/required-keys-of.d.ts","../node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/is-never.d.ts","../node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/if.d.ts","../node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/unknown-array.d.ts","../node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/internal/type.d.ts","../node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/simplify.d.ts","../node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/is-equal.d.ts","../node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/omit-index-signature.d.ts","../node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/pick-index-signature.d.ts","../node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/merge.d.ts","../node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/internal/object.d.ts","../node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/except.d.ts"],"sourcesContent":["/**\nConvert a union type to an intersection type using [distributive conditional types](https://www.typescriptlang.org/docs/handbook/release-notes/typescript-2-8.html#distributive-conditional-types).\n\nInspired by [this Stack Overflow answer](https://stackoverflow.com/a/50375286/2172153).\n\n@example\n```\nimport type {UnionToIntersection} from 'type-fest';\n\ntype Union = {the(): void} | {great(arg: string): void} | {escape: boolean};\n\ntype Intersection = UnionToIntersection<Union>;\n//=> {the(): void} & {great(arg: string): void} & {escape: boolean}\n```\n\n@category Type\n*/\nexport type UnionToIntersection<Union> = (\n\t// `extends unknown` is always going to be the case and is used to convert the\n\t// `Union` into a [distributive conditional\n\t// type](https://www.typescriptlang.org/docs/handbook/release-notes/typescript-2-8.html#distributive-conditional-types).\n\tUnion extends unknown\n\t\t// The union type is used as the only argument to a function since the union\n\t\t// of function arguments is an intersection.\n\t\t? (distributedUnion: Union) => void\n\t\t// This won't happen.\n\t\t: never\n\t\t// Infer the `Intersection` type since TypeScript represents the positional\n\t\t// arguments of unions of functions as an intersection of the union.\n) extends ((mergedIntersection: infer Intersection) => void)\n\t// The `& Union` is to ensure result of `UnionToIntersection<A | B>` is always assignable to `A | B`\n\t? Intersection & Union\n\t: never;\n\nexport {};\n","import type {UnionToIntersection} from './union-to-intersection.d.ts';\n\n/**\nCreate a union of all keys from a given type, even those exclusive to specific union members.\n\nUnlike the native `keyof` keyword, which returns keys present in **all** union members, this type returns keys from **any** member.\n\n@link https://stackoverflow.com/a/49402091\n\n@example\n```\nimport type {KeysOfUnion} from 'type-fest';\n\ntype A = {\n\tcommon: string;\n\ta: number;\n};\n\ntype B = {\n\tcommon: string;\n\tb: string;\n};\n\ntype C = {\n\tcommon: string;\n\tc: boolean;\n};\n\ntype Union = A | B | C;\n\ntype CommonKeys = keyof Union;\n//=> 'common'\n\ntype AllKeys = KeysOfUnion<Union>;\n//=> 'common' | 'a' | 'b' | 'c'\n```\n\n@category Object\n*/\nexport type KeysOfUnion<ObjectType> =\n  // Hack to fix https://github.com/sindresorhus/type-fest/issues/1008\n  keyof UnionToIntersection<ObjectType extends unknown ? Record<keyof ObjectType, never> : never>;\n\nexport {};\n","/**\nReturns a boolean for whether the given type is `any`.\n\n@link https://stackoverflow.com/a/49928360/1490091\n\nUseful in type utilities, such as disallowing `any`s to be passed to a function.\n\n@example\n```\nimport type {IsAny} from 'type-fest';\n\nconst typedObject = {a: 1, b: 2} as const;\nconst anyObject: any = {a: 1, b: 2};\n\nfunction get<O extends (IsAny<O> extends true ? {} : Record<string, number>), K extends keyof O = keyof O>(object: O, key: K) {\n\treturn object[key];\n}\n\nconst typedA = get(typedObject, 'a');\n//=> 1\n\nconst anyA = get(anyObject, 'a');\n//=> any\n```\n\n@category Type Guard\n@category Utilities\n*/\nexport type IsAny<T> = 0 extends 1 & NoInfer<T> ? true : false;\n\nexport {};\n","import type {IsAny} from './is-any.d.ts';\n\n/**\nReturns a boolean for whether the given key is an optional key of type.\n\nThis is useful when writing utility types or schema validators that need to differentiate `optional` keys.\n\n@example\n```\nimport type {IsOptionalKeyOf} from 'type-fest';\n\ntype User = {\n\tname: string;\n\tsurname: string;\n\n\tluckyNumber?: number;\n};\n\ntype Admin = {\n\tname: string;\n\tsurname?: string;\n};\n\ntype T1 = IsOptionalKeyOf<User, 'luckyNumber'>;\n//=> true\n\ntype T2 = IsOptionalKeyOf<User, 'name'>;\n//=> false\n\ntype T3 = IsOptionalKeyOf<User, 'name' | 'luckyNumber'>;\n//=> boolean\n\ntype T4 = IsOptionalKeyOf<User | Admin, 'name'>;\n//=> false\n\ntype T5 = IsOptionalKeyOf<User | Admin, 'surname'>;\n//=> boolean\n```\n\n@category Type Guard\n@category Utilities\n*/\nexport type IsOptionalKeyOf<Type extends object, Key extends keyof Type> =\n\tIsAny<Type | Key> extends true ? never\n\t\t: Key extends keyof Type\n\t\t\t? Type extends Record<Key, Type[Key]>\n\t\t\t\t? false\n\t\t\t\t: true\n\t\t\t: false;\n\nexport {};\n","import type {IsOptionalKeyOf} from './is-optional-key-of.d.ts';\n\n/**\nExtract all optional keys from the given type.\n\nThis is useful when you want to create a new type that contains different type values for the optional keys only.\n\n@example\n```\nimport type {OptionalKeysOf, Except} from 'type-fest';\n\ntype User = {\n\tname: string;\n\tsurname: string;\n\n\tluckyNumber?: number;\n};\n\nconst REMOVE_FIELD = Symbol('remove field symbol');\ntype UpdateOperation<Entity extends object> = Except<Partial<Entity>, OptionalKeysOf<Entity>> & {\n\t[Key in OptionalKeysOf<Entity>]?: Entity[Key] | typeof REMOVE_FIELD;\n};\n\nconst update1: UpdateOperation<User> = {\n\tname: 'Alice',\n};\n\nconst update2: UpdateOperation<User> = {\n\tname: 'Bob',\n\tluckyNumber: REMOVE_FIELD,\n};\n```\n\n@category Utilities\n*/\nexport type OptionalKeysOf<Type extends object> =\n\tType extends unknown // For distributing `Type`\n\t\t? (keyof {[Key in keyof Type as\n\t\t\tIsOptionalKeyOf<Type, Key> extends false\n\t\t\t\t? never\n\t\t\t\t: Key\n\t\t\t]: never\n\t\t}) & keyof Type // Intersect with `keyof Type` to ensure result of `OptionalKeysOf<Type>` is always assignable to `keyof Type`\n\t\t: never; // Should never happen\n\nexport {};\n","import type {OptionalKeysOf} from './optional-keys-of.d.ts';\n\n/**\nExtract all required keys from the given type.\n\nThis is useful when you want to create a new type that contains different type values for the required keys only or use the list of keys for validation purposes, etc...\n\n@example\n```\nimport type {RequiredKeysOf} from 'type-fest';\n\ndeclare function createValidation<\n\tEntity extends object,\n\tKey extends RequiredKeysOf<Entity> = RequiredKeysOf<Entity>,\n>(field: Key, validator: (value: Entity[Key]) => boolean): (entity: Entity) => boolean;\n\ntype User = {\n\tname: string;\n\tsurname: string;\n\tluckyNumber?: number;\n};\n\nconst validator1 = createValidation<User>('name', value => value.length < 25);\nconst validator2 = createValidation<User>('surname', value => value.length < 25);\n\n// @ts-expect-error\nconst validator3 = createValidation<User>('luckyNumber', value => value > 0);\n// Error: Argument of type '\"luckyNumber\"' is not assignable to parameter of type '\"name\" | \"surname\"'.\n```\n\n@category Utilities\n*/\nexport type RequiredKeysOf<Type extends object> =\n\tType extends unknown // For distributing `Type`\n\t\t? Exclude<keyof Type, OptionalKeysOf<Type>>\n\t\t: never; // Should never happen\n\nexport {};\n","/**\nReturns a boolean for whether the given type is `never`.\n\n@link https://github.com/microsoft/TypeScript/issues/31751#issuecomment-498526919\n@link https://stackoverflow.com/a/53984913/10292952\n@link https://www.zhenghao.io/posts/ts-never\n\nUseful in type utilities, such as checking if something does not occur.\n\n@example\n```\nimport type {IsNever, And} from 'type-fest';\n\ntype A = IsNever<never>;\n//=> true\n\ntype B = IsNever<any>;\n//=> false\n\ntype C = IsNever<unknown>;\n//=> false\n\ntype D = IsNever<never[]>;\n//=> false\n\ntype E = IsNever<object>;\n//=> false\n\ntype F = IsNever<string>;\n//=> false\n```\n\n@example\n```\nimport type {IsNever} from 'type-fest';\n\ntype IsTrue<T> = T extends true ? true : false;\n\n// When a distributive conditional is instantiated with `never`, the entire conditional results in `never`.\ntype A = IsTrue<never>;\n//=> never\n\n// If you don't want that behaviour, you can explicitly add an `IsNever` check before the distributive conditional.\ntype IsTrueFixed<T> =\n\tIsNever<T> extends true ? false : T extends true ? true : false;\n\ntype B = IsTrueFixed<never>;\n//=> false\n```\n\n@category Type Guard\n@category Utilities\n*/\nexport type IsNever<T> = [T] extends [never] ? true : false;\n\nexport {};\n","import type {IsNever} from './is-never.d.ts';\n\n/**\nAn if-else-like type that resolves depending on whether the given `boolean` type is `true` or `false`.\n\nUse-cases:\n- 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'>`.\n\nNote:\n- 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'`.\n- Returns the else branch if the given type is `never`. For example, `If<never, 'Y', 'N'>` will return `'N'`.\n\n@example\n```\nimport type {If} from 'type-fest';\n\ntype A = If<true, 'yes', 'no'>;\n//=> 'yes'\n\ntype B = If<false, 'yes', 'no'>;\n//=> 'no'\n\ntype C = If<boolean, 'yes', 'no'>;\n//=> 'yes' | 'no'\n\ntype D = If<any, 'yes', 'no'>;\n//=> 'yes' | 'no'\n\ntype E = If<never, 'yes', 'no'>;\n//=> 'no'\n```\n\n@example\n```\nimport type {If, IsAny, IsNever} from 'type-fest';\n\ntype A = If<IsAny<unknown>, 'is any', 'not any'>;\n//=> 'not any'\n\ntype B = If<IsNever<never>, 'is never', 'not never'>;\n//=> 'is never'\n```\n\n@example\n```\nimport type {If, IsEqual} from 'type-fest';\n\ntype IfEqual<T, U, IfBranch, ElseBranch> = If<IsEqual<T, U>, IfBranch, ElseBranch>;\n\ntype A = IfEqual<string, string, 'equal', 'not equal'>;\n//=> 'equal'\n\ntype B = IfEqual<string, number, 'equal', 'not equal'>;\n//=> 'not equal'\n```\n\nNote: Sometimes using the `If` type can make an implementation non–tail-recursive, which can impact performance. In such cases, it’s better to use a conditional directly. Refer to the following example:\n\n@example\n```\nimport type {If, IsEqual, StringRepeat} from 'type-fest';\n\ntype HundredZeroes = StringRepeat<'0', 100>;\n\n// The following implementation is not tail recursive\ntype Includes<S extends string, Char extends string> =\n\tS extends `${infer First}${infer Rest}`\n\t\t? If<IsEqual<First, Char>,\n\t\t\t'found',\n\t\t\tIncludes<Rest, Char>>\n\t\t: 'not found';\n\n// Hence, instantiations with long strings will fail\n// @ts-expect-error\ntype Fails = Includes<HundredZeroes, '1'>;\n//           ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n// Error: Type instantiation is excessively deep and possibly infinite.\n\n// However, if we use a simple conditional instead of `If`, the implementation becomes tail-recursive\ntype IncludesWithoutIf<S extends string, Char extends string> =\n\tS extends `${infer First}${infer Rest}`\n\t\t? IsEqual<First, Char> extends true\n\t\t\t? 'found'\n\t\t\t: IncludesWithoutIf<Rest, Char>\n\t\t: 'not found';\n\n// Now, instantiations with long strings will work\ntype Works = IncludesWithoutIf<HundredZeroes, '1'>;\n//=> 'not found'\n```\n\n@category Type Guard\n@category Utilities\n*/\nexport type If<Type extends boolean, IfBranch, ElseBranch> =\n\tIsNever<Type> extends true\n\t\t? ElseBranch\n\t\t: Type extends true\n\t\t\t? IfBranch\n\t\t\t: ElseBranch;\n\nexport {};\n","/**\nRepresents an array with `unknown` value.\n\nUse case: You want a type that all arrays can be assigned to, but you don't care about the value.\n\n@example\n```\nimport type {UnknownArray} from 'type-fest';\n\ntype IsArray<T> = T extends UnknownArray ? true : false;\n\ntype A = IsArray<['foo']>;\n//=> true\n\ntype B = IsArray<readonly number[]>;\n//=> true\n\ntype C = IsArray<string>;\n//=> false\n```\n\n@category Type\n@category Array\n*/\nexport type UnknownArray = readonly unknown[];\n\nexport {};\n","import type {If} from '../if.d.ts';\nimport type {IsAny} from '../is-any.d.ts';\nimport type {IsNever} from '../is-never.d.ts';\nimport type {Primitive} from '../primitive.d.ts';\nimport type {UnknownArray} from '../unknown-array.d.ts';\n\n/**\nMatches any primitive, `void`, `Date`, or `RegExp` value.\n*/\nexport type BuiltIns = Primitive | void | Date | RegExp;\n\n/**\nMatches non-recursive types.\n*/\nexport type NonRecursiveType = BuiltIns | Function | (new (...arguments_: any[]) => unknown) | Promise<unknown>;\n\n/**\nMatches maps, sets, or arrays.\n*/\nexport type MapsSetsOrArrays = ReadonlyMap<unknown, unknown> | WeakMap<WeakKey, unknown> | ReadonlySet<unknown> | WeakSet<WeakKey> | UnknownArray;\n\n/**\nReturns a boolean for whether the two given types extends the base type.\n*/\nexport type IsBothExtends<BaseType, FirstType, SecondType> = FirstType extends BaseType\n\t? SecondType extends BaseType\n\t\t? true\n\t\t: false\n\t: false;\n\n/**\nTest if the given function has multiple call signatures.\n\nNeeded to handle the case of a single call signature with properties.\n\nMultiple call signatures cannot currently be supported due to a TypeScript limitation.\n@see https://github.com/microsoft/TypeScript/issues/29732\n*/\nexport type HasMultipleCallSignatures<T extends (...arguments_: any[]) => unknown> =\n\tT extends {(...arguments_: infer A): unknown; (...arguments_: infer B): unknown}\n\t\t? B extends A\n\t\t\t? A extends B\n\t\t\t\t? false\n\t\t\t\t: true\n\t\t\t: true\n\t\t: false;\n\n/**\nReturns a boolean for whether the given `boolean` is not `false`.\n*/\nexport type IsNotFalse<T extends boolean> = [T] extends [false] ? false : true;\n\n/**\nReturns a boolean for whether the given type is primitive value or primitive type.\n\n@example\n```\ntype A = IsPrimitive<'string'>;\n//=> true\n\ntype B = IsPrimitive<string>;\n//=> true\n\ntype C = IsPrimitive<Object>;\n//=> false\n```\n*/\nexport type IsPrimitive<T> = [T] extends [Primitive] ? true : false;\n\n/**\nReturns a boolean for whether A is false.\n\n@example\n```\ntype A = Not<true>;\n//=> false\n\ntype B = Not<false>;\n//=> true\n```\n*/\nexport type Not<A extends boolean> = A extends true\n\t? false\n\t: A extends false\n\t\t? true\n\t\t: never;\n\n/**\nAn if-else-like type that resolves depending on whether the given type is `any` or `never`.\n\n@example\n```\n// When `T` is a NOT `any` or `never` (like `string`) => Returns `IfNotAnyOrNever` branch\ntype A = IfNotAnyOrNever<string, 'VALID', 'IS_ANY', 'IS_NEVER'>;\n//=> 'VALID'\n\n// When `T` is `any` => Returns `IfAny` branch\ntype B = IfNotAnyOrNever<any, 'VALID', 'IS_ANY', 'IS_NEVER'>;\n//=> 'IS_ANY'\n\n// When `T` is `never` => Returns `IfNever` branch\ntype C = IfNotAnyOrNever<never, 'VALID', 'IS_ANY', 'IS_NEVER'>;\n//=> 'IS_NEVER'\n```\n\nNote: Wrapping a tail-recursive type with `IfNotAnyOrNever` makes the implementation non-tail-recursive. To fix this, move the recursion into a helper type. Refer to the following example:\n\n@example\n```ts\nimport type {StringRepeat} from 'type-fest';\n\ntype NineHundredNinetyNineSpaces = StringRepeat<' ', 999>;\n\n// The following implementation is not tail recursive\ntype TrimLeft<S extends string> = IfNotAnyOrNever<S, S extends ` ${infer R}` ? TrimLeft<R> : S>;\n\n// Hence, instantiations with long strings will fail\n// @ts-expect-error\ntype T1 = TrimLeft<NineHundredNinetyNineSpaces>;\n//        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n// Error: Type instantiation is excessively deep and possibly infinite.\n\n// To fix this, move the recursion into a helper type\ntype TrimLeftOptimised<S extends string> = IfNotAnyOrNever<S, _TrimLeftOptimised<S>>;\n\ntype _TrimLeftOptimised<S extends string> = S extends ` ${infer R}` ? _TrimLeftOptimised<R> : S;\n\ntype T2 = TrimLeftOptimised<NineHundredNinetyNineSpaces>;\n//=> ''\n```\n*/\nexport type IfNotAnyOrNever<T, IfNotAnyOrNever, IfAny = any, IfNever = never> =\n\tIf<IsAny<T>, IfAny, If<IsNever<T>, IfNever, IfNotAnyOrNever>>;\n\n/**\nReturns a boolean for whether the given type is `any` or `never`.\n\nThis type can be better to use than {@link IfNotAnyOrNever `IfNotAnyOrNever`} in recursive types because it does not evaluate any branches.\n\n@example\n```\n// When `T` is a NOT `any` or `never` (like `string`) => Returns `false`\ntype A = IsAnyOrNever<string>;\n//=> false\n\n// When `T` is `any` => Returns `true`\ntype B = IsAnyOrNever<any>;\n//=> true\n\n// When `T` is `never` => Returns `true`\ntype C = IsAnyOrNever<never>;\n//=> true\n```\n*/\nexport type IsAnyOrNever<T> = IsNotFalse<IsAny<T> | IsNever<T>>;\n\n/**\nIndicates the value of `exactOptionalPropertyTypes` compiler option.\n*/\nexport type IsExactOptionalPropertyTypesEnabled = [(string | undefined)?] extends [string?]\n\t? false\n\t: true;\n\nexport {};\n","/**\nUseful to flatten the type output to improve type hints shown in editors. And also to transform an interface into a type to aide with assignability.\n\n@example\n```\nimport type {Simplify} from 'type-fest';\n\ntype PositionProps = {\n\ttop: number;\n\tleft: number;\n};\n\ntype SizeProps = {\n\twidth: number;\n\theight: number;\n};\n\n// In your editor, hovering over `Props` will show a flattened object with all the properties.\ntype Props = Simplify<PositionProps & SizeProps>;\n```\n\nSometimes it is desired to pass a value as a function argument that has a different type. At first inspection it may seem assignable, and then you discover it is not because the `value`'s type definition was defined as an interface. In the following example, `fn` requires an argument of type `Record<string, unknown>`. If the value is defined as a literal, then it is assignable. And if the `value` is defined as type using the `Simplify` utility the value is assignable.  But if the `value` is defined as an interface, it is not assignable because the interface is not sealed and elsewhere a non-string property could be added to the interface.\n\nIf the type definition must be an interface (perhaps it was defined in a third-party npm package), then the `value` can be defined as `const value: Simplify<SomeInterface> = ...`. Then `value` will be assignable to the `fn` argument.  Or the `value` can be cast as `Simplify<SomeInterface>` if you can't re-declare the `value`.\n\n@example\n```\nimport type {Simplify} from 'type-fest';\n\ninterface SomeInterface {\n\tfoo: number;\n\tbar?: string;\n\tbaz: number | undefined;\n}\n\ntype SomeType = {\n\tfoo: number;\n\tbar?: string;\n\tbaz: number | undefined;\n};\n\nconst literal = {foo: 123, bar: 'hello', baz: 456};\nconst someType: SomeType = literal;\nconst someInterface: SomeInterface = literal;\n\ndeclare function fn(object: Record<string, unknown>): void;\n\nfn(literal); // Good: literal object type is sealed\nfn(someType); // Good: type is sealed\n// @ts-expect-error\nfn(someInterface); // Error: Index signature for type 'string' is missing in type 'someInterface'. Because `interface` can be re-opened\nfn(someInterface as Simplify<SomeInterface>); // Good: transform an `interface` into a `type`\n```\n\n@link https://github.com/microsoft/TypeScript/issues/15300\n@see {@link SimplifyDeep}\n@category Object\n*/\nexport type Simplify<T> = {[KeyType in keyof T]: T[KeyType]} & {};\n\nexport {};\n","import type {IsNever} from './is-never.d.ts';\n/**\nReturns a boolean for whether the two given types are equal.\n\n@link https://github.com/microsoft/TypeScript/issues/27024#issuecomment-421529650\n@link https://stackoverflow.com/questions/68961864/how-does-the-equals-work-in-typescript/68963796#68963796\n\nUse-cases:\n- If you want to make a conditional branch based on the result of a comparison of two types.\n\n@example\n```\nimport type {IsEqual} from 'type-fest';\n\n// This type returns a boolean for whether the given array includes the given item.\n// `IsEqual` is used to compare the given array at position 0 and the given item and then return true if they are equal.\ntype Includes<Value extends readonly any[], Item> =\n\tValue extends readonly [Value[0], ...infer rest]\n\t\t? IsEqual<Value[0], Item> extends true\n\t\t\t? true\n\t\t\t: Includes<rest, Item>\n\t\t: false;\n```\n\n@category Type Guard\n@category Utilities\n*/\nexport type IsEqual<A, B> =\n\t[A] extends [B]\n\t\t? [B] extends [A]\n\t\t\t? _IsEqual<A, B>\n\t\t\t: false\n\t\t: false;\n\n// This version fails the `equalWrappedTupleIntersectionToBeNeverAndNeverExpanded` test in `test-d/is-equal.ts`.\ntype _IsEqual<A, B> =\n\t(<G>() => G extends A & G | G ? 1 : 2) extends\n\t(<G>() => G extends B & G | G ? 1 : 2)\n\t\t? true\n\t\t: false;\n\nexport {};\n","/**\nOmit any index signatures from the given object type, leaving only explicitly defined properties.\n\nThis is the counterpart of `PickIndexSignature`.\n\nUse-cases:\n- Remove overly permissive signatures from third-party types.\n\nThis type was taken from this [StackOverflow answer](https://stackoverflow.com/a/68261113/420747).\n\nIt relies on the fact that an empty object (`{}`) is assignable to an object with just an index signature, like `Record<string, unknown>`, but not to an object with explicitly defined keys, like `Record<'foo' | 'bar', unknown>`.\n\n(The actual value type, `unknown`, is irrelevant and could be any type. Only the key type matters.)\n\n```\nconst indexed: Record<string, unknown> = {}; // Allowed\n\n// @ts-expect-error\nconst keyed: Record<'foo', unknown> = {}; // Error\n// TS2739: Type '{}' is missing the following properties from type 'Record<\"foo\" | \"bar\", unknown>': foo, bar\n```\n\nInstead of causing a type error like the above, you can also use a [conditional type](https://www.typescriptlang.org/docs/handbook/2/conditional-types.html) to test whether a type is assignable to another:\n\n```\ntype Indexed = {} extends Record<string, unknown>\n\t? '✅ `{}` is assignable to `Record<string, unknown>`'\n\t: '❌ `{}` is NOT assignable to `Record<string, unknown>`';\n\ntype IndexedResult = Indexed;\n//=> '✅ `{}` is assignable to `Record<string, unknown>`'\n\ntype Keyed = {} extends Record<'foo' | 'bar', unknown>\n\t? '✅ `{}` is assignable to `Record<\\'foo\\' | \\'bar\\', unknown>`'\n\t: '❌ `{}` is NOT assignable to `Record<\\'foo\\' | \\'bar\\', unknown>`';\n\ntype KeyedResult = Keyed;\n//=> '❌ `{}` is NOT assignable to `Record<\\'foo\\' | \\'bar\\', unknown>`'\n```\n\nUsing a [mapped type](https://www.typescriptlang.org/docs/handbook/2/mapped-types.html#further-exploration), you can then check for each `KeyType` of `ObjectType`...\n\n```\ntype OmitIndexSignature<ObjectType> = {\n\t[KeyType in keyof ObjectType // Map each key of `ObjectType`...\n\t]: ObjectType[KeyType]; // ...to its original value, i.e. `OmitIndexSignature<Foo> == Foo`.\n};\n```\n\n...whether an empty object (`{}`) would be assignable to an object with that `KeyType` (`Record<KeyType, unknown>`)...\n\n```\ntype OmitIndexSignature<ObjectType> = {\n\t[KeyType in keyof ObjectType\n\t// Is `{}` assignable to `Record<KeyType, unknown>`?\n\tas {} extends Record<KeyType, unknown>\n\t\t? never // ✅ `{}` is assignable to `Record<KeyType, unknown>`\n\t\t: KeyType // ❌ `{}` is NOT assignable to `Record<KeyType, unknown>`\n\t]: ObjectType[KeyType];\n};\n```\n\nIf `{}` is assignable, it means that `KeyType` is an index signature and we want to remove it. If it is not assignable, `KeyType` is a \"real\" key and we want to keep it.\n\n@example\n```\nimport type {OmitIndexSignature} from 'type-fest';\n\ntype Example = {\n\t// These index signatures will be removed.\n\t[x: string]: any;\n\t[x: number]: any;\n\t[x: symbol]: any;\n\t[x: `head-${string}`]: string;\n\t[x: `${string}-tail`]: string;\n\t[x: `head-${string}-tail`]: string;\n\t[x: `${bigint}`]: string;\n\t[x: `embedded-${number}`]: string;\n\n\t// These explicitly defined keys will remain.\n\tfoo: 'bar';\n\tqux?: 'baz';\n};\n\ntype ExampleWithoutIndexSignatures = OmitIndexSignature<Example>;\n//=> {foo: 'bar'; qux?: 'baz'}\n```\n\n@see {@link PickIndexSignature}\n@category Object\n*/\nexport type OmitIndexSignature<ObjectType> = {\n\t[KeyType in keyof ObjectType as {} extends Record<KeyType, unknown>\n\t\t? never\n\t\t: KeyType]: ObjectType[KeyType];\n};\n\nexport {};\n","/**\nPick only index signatures from the given object type, leaving out all explicitly defined properties.\n\nThis is the counterpart of `OmitIndexSignature`.\n\n@example\n```\nimport type {PickIndexSignature} from 'type-fest';\n\ndeclare const symbolKey: unique symbol;\n\ntype Example = {\n\t// These index signatures will remain.\n\t[x: string]: unknown;\n\t[x: number]: unknown;\n\t[x: symbol]: unknown;\n\t[x: `head-${string}`]: string;\n\t[x: `${string}-tail`]: string;\n\t[x: `head-${string}-tail`]: string;\n\t[x: `${bigint}`]: string;\n\t[x: `embedded-${number}`]: string;\n\n\t// These explicitly defined keys will be removed.\n\t['kebab-case-key']: string;\n\t[symbolKey]: string;\n\tfoo: 'bar';\n\tqux?: 'baz';\n};\n\ntype ExampleIndexSignature = PickIndexSignature<Example>;\n// {\n// \t[x: string]: unknown;\n// \t[x: number]: unknown;\n// \t[x: symbol]: unknown;\n// \t[x: `head-${string}`]: string;\n// \t[x: `${string}-tail`]: string;\n// \t[x: `head-${string}-tail`]: string;\n// \t[x: `${bigint}`]: string;\n// \t[x: `embedded-${number}`]: string;\n// }\n```\n\n@see {@link OmitIndexSignature}\n@category Object\n*/\nexport type PickIndexSignature<ObjectType> = {\n\t[KeyType in keyof ObjectType as {} extends Record<KeyType, unknown>\n\t\t? KeyType\n\t\t: never]: ObjectType[KeyType];\n};\n\nexport {};\n","import type {OmitIndexSignature} from './omit-index-signature.d.ts';\nimport type {PickIndexSignature} from './pick-index-signature.d.ts';\nimport type {Simplify} from './simplify.d.ts';\nimport type {If} from './if.d.ts';\nimport type {IsEqual} from './is-equal.d.ts';\n\n// Merges two objects without worrying about index signatures.\ntype SimpleMerge<Destination, Source> = Simplify<{\n\t[Key in keyof Destination as Key extends keyof Source ? never : Key]: Destination[Key];\n} & Source>;\n\n/**\nMerge two types into a new type. Keys of the second type overrides keys of the first type.\n\n@example\n```\nimport type {Merge} from 'type-fest';\n\ntype Foo = {\n\t[x: string]: unknown;\n\t[x: number]: unknown;\n\tfoo: string;\n\tbar: symbol;\n};\n\ntype Bar = {\n\t[x: number]: number;\n\t[x: symbol]: unknown;\n\tbar: Date;\n\tbaz: boolean;\n};\n\nexport type FooBar = Merge<Foo, Bar>;\n//=> {\n// \t[x: string]: unknown;\n// \t[x: number]: number;\n// \t[x: symbol]: unknown;\n// \tfoo: string;\n// \tbar: Date;\n// \tbaz: boolean;\n// }\n```\n\nNote: If you want a merge type that more accurately reflects the runtime behavior of object spread or `Object.assign`, refer to the {@link ObjectMerge} type.\n\n@see {@link ObjectMerge}\n@category Object\n*/\nexport type Merge<Destination, Source> =\n\tDestination extends unknown // For distributing `Destination`\n\t\t? Source extends unknown // For distributing `Source`\n\t\t\t? If<IsEqual<Destination, Source>, Destination, _Merge<Destination, Source>>\n\t\t\t: never // Should never happen\n\t\t: never; // Should never happen\n\nexport type _Merge<Destination, Source> =\n\tSimplify<\n\t\tSimpleMerge<PickIndexSignature<Destination>, PickIndexSignature<Source>>\n\t\t& SimpleMerge<OmitIndexSignature<Destination>, OmitIndexSignature<Source>>\n\t>;\n\nexport {};\n","import type {Simplify} from '../simplify.d.ts';\nimport type {IsEqual} from '../is-equal.d.ts';\nimport type {KeysOfUnion} from '../keys-of-union.d.ts';\nimport type {RequiredKeysOf} from '../required-keys-of.d.ts';\nimport type {Merge} from '../merge.d.ts';\nimport type {OptionalKeysOf} from '../optional-keys-of.d.ts';\nimport type {IsAny} from '../is-any.d.ts';\nimport type {If} from '../if.d.ts';\nimport type {IsNever} from '../is-never.d.ts';\nimport type {FilterDefinedKeys, FilterOptionalKeys} from './keys.d.ts';\nimport type {MapsSetsOrArrays, NonRecursiveType} from './type.d.ts';\nimport type {StringToNumber, ToString} from './string.d.ts';\n\n/**\nCreate an object type with the given key `<Key>` and value `<Value>`.\n\nIt will copy the prefix and optional status of the same key from the given object `CopiedFrom` into the result.\n\n@example\n```\ntype A = BuildObject<'a', string>;\n//=> {a: string}\n\n// Copy `readonly` and `?` from the key `a` of `{readonly a?: any}`\ntype B = BuildObject<'a', string, {readonly a?: any}>;\n//=> {readonly a?: string}\n```\n*/\nexport type BuildObject<Key extends PropertyKey, Value, CopiedFrom extends object = {}> =\n\tKey extends keyof CopiedFrom\n\t\t? Pick<{[_ in keyof CopiedFrom]: Value}, Key>\n\t\t: Key extends `${infer NumberKey extends number}`\n\t\t\t? NumberKey extends keyof CopiedFrom\n\t\t\t\t? Pick<{[_ in keyof CopiedFrom]: Value}, NumberKey>\n\t\t\t\t: {[_ in Key]: Value}\n\t\t\t: {[_ in Key]: Value};\n\n/**\nReturns a boolean for whether the given type is a plain key-value object.\n*/\nexport type IsPlainObject<T> =\n\tIsNever<T> extends true\n\t\t? false\n\t\t: T extends NonRecursiveType | MapsSetsOrArrays\n\t\t\t? false\n\t\t\t: T extends object\n\t\t\t\t? true\n\t\t\t\t: false;\n\n/**\nExtract the object field type if T is an object and K is a key of T, return `never` otherwise.\n\nIt creates a type-safe way to access the member type of `unknown` type.\n*/\nexport type ObjectValue<T, K> =\n\tK extends keyof T\n\t\t? T[K]\n\t\t: ToString<K> extends keyof T\n\t\t\t? T[ToString<K>]\n\t\t\t: K extends `${infer NumberK extends number}`\n\t\t\t\t? NumberK extends keyof T\n\t\t\t\t\t? T[NumberK]\n\t\t\t\t\t: never\n\t\t\t\t: never;\n\n/**\nFor an object T, if it has any properties that are a union with `undefined`, make those into optional properties instead.\n\n@example\n```\ntype User = {\n\tfirstName: string;\n\tlastName: string | undefined;\n};\n\ntype OptionalizedUser = UndefinedToOptional<User>;\n//=> {\n// \tfirstName: string;\n// \tlastName?: string;\n// }\n```\n*/\nexport type UndefinedToOptional<T extends object> = Simplify<\n\t{\n\t// Property is not a union with `undefined`, keep it as-is.\n\t\t[Key in keyof Pick<T, FilterDefinedKeys<T>>]: T[Key];\n\t} & {\n\t// Property _is_ a union with defined value. Set as optional (via `?`) and remove `undefined` from the union.\n\t\t[Key in keyof Pick<T, FilterOptionalKeys<T>>]?: Exclude<T[Key], undefined>;\n\t}\n>;\n\n/**\nWorks similar to the built-in `Pick` utility type, except for the following differences:\n- Distributes over union types and allows picking keys from any member of the union type.\n- Primitives types are returned as-is.\n- Picks all keys if `Keys` is `any`.\n- Doesn't pick `number` from a `string` index signature.\n\n@example\n```\ntype ImageUpload = {\n\turl: string;\n\tsize: number;\n\tthumbnailUrl: string;\n};\n\ntype VideoUpload = {\n\turl: string;\n\tduration: number;\n\tencodingFormat: string;\n};\n\n// Distributes over union types and allows picking keys from any member of the union type\ntype MediaDisplay = HomomorphicPick<ImageUpload | VideoUpload, \"url\" | \"size\" | \"duration\">;\n//=> {url: string; size: number} | {url: string; duration: number}\n\n// Primitive types are returned as-is\ntype Primitive = HomomorphicPick<string | number, 'toUpperCase' | 'toString'>;\n//=> string | number\n\n// Picks all keys if `Keys` is `any`\ntype Any = HomomorphicPick<{a: 1; b: 2} | {c: 3}, any>;\n//=> {a: 1; b: 2} | {c: 3}\n\n// Doesn't pick `number` from a `string` index signature\ntype IndexSignature = HomomorphicPick<{[k: string]: unknown}, number>;\n//=> {}\n*/\nexport type HomomorphicPick<T, Keys extends KeysOfUnion<T>> = {\n\t[P in keyof T as Extract<P, Keys>]: T[P]\n};\n\n/**\nExtract all possible values for a given key from a union of object types.\n\n@example\n```\ntype Statuses = ValueOfUnion<{id: 1; status: 'open'} | {id: 2; status: 'closed'}, 'status'>;\n//=> \"open\" | \"closed\"\n```\n*/\nexport type ValueOfUnion<Union, Key extends KeysOfUnion<Union>> =\n\tUnion extends unknown ? Key extends keyof Union ? Union[Key] : never : never;\n\n/**\nExtract all readonly keys from a union of object types.\n\n@example\n```\ntype User = {\n\treadonly id: string;\n\tname: string;\n};\n\ntype Post = {\n\treadonly id: string;\n\treadonly author: string;\n\tbody: string;\n};\n\ntype ReadonlyKeys = ReadonlyKeysOfUnion<User | Post>;\n//=> \"id\" | \"author\"\n```\n*/\nexport type ReadonlyKeysOfUnion<Union> = Union extends unknown ? keyof {\n\t[Key in keyof Union as IsEqual<{[K in Key]: Union[Key]}, {readonly [K in Key]: Union[Key]}> extends true ? Key : never]: never\n} : never;\n\n/**\nMerges user specified options with default options.\n\n@example\n```\ntype PathsOptions = {maxRecursionDepth?: number; leavesOnly?: boolean};\ntype DefaultPathsOptions = {maxRecursionDepth: 10; leavesOnly: false};\ntype SpecifiedOptions = {leavesOnly: true};\n\ntype Result = ApplyDefaultOptions<PathsOptions, DefaultPathsOptions, SpecifiedOptions>;\n//=> {maxRecursionDepth: 10; leavesOnly: true}\n```\n\n@example\n```\n// Complains if default values are not provided for optional options\n\ntype PathsOptions = {maxRecursionDepth?: number; leavesOnly?: boolean};\ntype DefaultPathsOptions = {maxRecursionDepth: 10};\ntype SpecifiedOptions = {};\n\ntype Result = ApplyDefaultOptions<PathsOptions, DefaultPathsOptions, SpecifiedOptions>;\n//                                              ~~~~~~~~~~~~~~~~~~~\n// Property 'leavesOnly' is missing in type 'DefaultPathsOptions' but required in type '{ maxRecursionDepth: number; leavesOnly: boolean; }'.\n```\n\n@example\n```\n// Complains if an option's default type does not conform to the expected type\n\ntype PathsOptions = {maxRecursionDepth?: number; leavesOnly?: boolean};\ntype DefaultPathsOptions = {maxRecursionDepth: 10; leavesOnly: 'no'};\ntype SpecifiedOptions = {};\n\ntype Result = ApplyDefaultOptions<PathsOptions, DefaultPathsOptions, SpecifiedOptions>;\n//                                              ~~~~~~~~~~~~~~~~~~~\n// Types of property 'leavesOnly' are incompatible. Type 'string' is not assignable to type 'boolean'.\n```\n\n@example\n```\n// Complains if an option's specified type does not conform to the expected type\n\ntype PathsOptions = {maxRecursionDepth?: number; leavesOnly?: boolean};\ntype DefaultPathsOptions = {maxRecursionDepth: 10; leavesOnly: false};\ntype SpecifiedOptions = {leavesOnly: 'yes'};\n\ntype Result = ApplyDefaultOptions<PathsOptions, DefaultPathsOptions, SpecifiedOptions>;\n//                                                                   ~~~~~~~~~~~~~~~~\n// Types of property 'leavesOnly' are incompatible. Type 'string' is not assignable to type 'boolean'.\n```\n*/\nexport type ApplyDefaultOptions<\n\tOptions extends object,\n\tDefaults extends Simplify<Omit<Required<Options>, RequiredKeysOf<Options>> & Partial<Record<RequiredKeysOf<Options>, never>>>,\n\tSpecifiedOptions extends Options,\n> =\n\tIf<IsAny<SpecifiedOptions>, Defaults,\n\t\tIf<IsNever<SpecifiedOptions>, Defaults,\n\t\t\tSimplify<Merge<Defaults, {\n\t\t\t\t[Key in keyof SpecifiedOptions\n\t\t\t\tas Key extends OptionalKeysOf<Options> ? undefined extends SpecifiedOptions[Key] ? never : Key : Key\n\t\t\t\t]: SpecifiedOptions[Key]\n\t\t\t}> & Required<Options>>>>; // `& Required<Options>` ensures that `ApplyDefaultOptions<SomeOption, ...>` is always assignable to `Required<SomeOption>`\n\n/**\nCollapses literal types in a union into their corresponding primitive types, when possible. For example, `CollapseLiterals<'foo' | 'bar' | (string & {})>` returns `string`.\n\nNote: This doesn't collapse literals within tagged types. For example, `CollapseLiterals<Tagged<'foo' | (string & {}), 'Tag'>>` returns `(\"foo\" & Tag<\"Tag\", never>) | (string & Tag<\"Tag\", never>)` and not `string & Tag<\"Tag\", never>`.\n\nUse-case: For collapsing unions created using {@link LiteralUnion}.\n\n@example\n```\nimport type {LiteralUnion} from 'type-fest';\n\ntype A = CollapseLiterals<'foo' | 'bar' | (string & {})>;\n//=> string\n\ntype B = CollapseLiterals<LiteralUnion<1 | 2 | 3, number>>;\n//=> number\n\ntype C = CollapseLiterals<LiteralUnion<'onClick' | 'onChange', `on${string}`>>;\n//=> `on${string}`\n\ntype D = CollapseLiterals<'click' | 'change' | (`on${string}` & {})>;\n//=> 'click' | 'change' | `on${string}`\n\ntype E = CollapseLiterals<LiteralUnion<'foo' | 'bar', string> | null | undefined>;\n//=> string | null | undefined\n```\n*/\nexport type CollapseLiterals<T> = {} extends T\n\t? T\n\t: T extends infer U & {}\n\t\t? U\n\t\t: T;\n\n/**\nNormalize keys by including string and number representations wherever applicable.\n\n@example\n```ts\ntype A = NormalizedKeys<0 | '1'>;\n//=> 0 | '0' | 1 | '1'\n\ntype B = NormalizedKeys<string>;\n//=> string | number\n\ntype C = NormalizedKeys<number>;\n//=> number | `${number}`\n\ntype D = NormalizedKeys<symbol | 'foo'>;\n//=> symbol | 'foo'\n```\n*/\nexport type NormalizedKeys<Keys extends PropertyKey> =\n\t| Keys\n\t| (string extends Keys ? number : never)\n\t| StringToNumber<Keys & string>\n\t| ToString<Keys & number>;\n\nexport {};\n","import type {ApplyDefaultOptions} from './internal/index.d.ts';\nimport type {IsEqual} from './is-equal.d.ts';\n\n/**\nFilter out keys from an object.\n\nReturns `never` if `Exclude` is strictly equal to `Key`.\nReturns `never` if `Key` extends `Exclude`.\nReturns `Key` otherwise.\n\n@example\n```\ntype Filtered = Filter<'foo', 'foo'>;\n//=> never\n```\n\n@example\n```\ntype Filtered = Filter<'bar', string>;\n//=> never\n```\n\n@example\n```\ntype Filtered = Filter<'bar', 'foo'>;\n//=> 'bar'\n```\n\n@see {Except}\n*/\ntype Filter<KeyType, ExcludeType> = IsEqual<KeyType, ExcludeType> extends true ? never : (KeyType extends ExcludeType ? never : KeyType);\n\nexport type ExceptOptions = {\n\t/**\n\tDisallow assigning non-specified properties.\n\n\tNote that any omitted properties in the resulting type will be present in autocomplete as `undefined`.\n\n\t@default false\n\t*/\n\trequireExactProps?: boolean;\n};\n\ntype DefaultExceptOptions = {\n\trequireExactProps: false;\n};\n\n/**\nCreate a type from an object type without certain keys.\n\nWe recommend setting the `requireExactProps` option to `true`.\n\nThis type is a stricter version of [`Omit`](https://www.typescriptlang.org/docs/handbook/release-notes/typescript-3-5.html#the-omit-helper-type). The `Omit` type does not restrict the omitted keys to be keys present on the given type, while `Except` does. The benefits of a stricter type are avoiding typos and allowing the compiler to pick up on rename refactors automatically.\n\nThis type was proposed to the TypeScript team, which declined it, saying they prefer that libraries implement stricter versions of the built-in types ([microsoft/TypeScript#30825](https://github.com/microsoft/TypeScript/issues/30825#issuecomment-523668235)).\n\n@example\n```\nimport type {Except} from 'type-fest';\n\ntype Foo = {\n\ta: number;\n\tb: string;\n};\n\ntype FooWithoutA = Except<Foo, 'a'>;\n//=> {b: string}\n\n// @ts-expect-error\nconst fooWithoutA: FooWithoutA = {a: 1, b: '2'};\n// errors: 'a' does not exist in type '{ b: string; }'\n\ntype FooWithoutB = Except<Foo, 'b', {requireExactProps: true}>;\n//=> {a: number} & Partial<Record<'b', never>>\n\n// @ts-expect-error\nconst fooWithoutB: FooWithoutB = {a: 1, b: '2'};\n// errors at 'b': Type 'string' is not assignable to type 'undefined'.\n\n// The `Omit` utility type doesn't work when omitting specific keys from objects containing index signatures.\n\n// Consider the following example:\n\ntype UserData = {\n\t[metadata: string]: string;\n\temail: string;\n\tname: string;\n\trole: 'admin' | 'user';\n};\n\n// `Omit` clearly doesn't behave as expected in this case:\ntype PostPayload = Omit<UserData, 'email'>;\n//=> {[x: string]: string; [x: number]: string}\n\n// In situations like this, `Except` works better.\n// It simply removes the `email` key while preserving all the other keys.\ntype PostPayloadFixed = Except<UserData, 'email'>;\n//=> {[x: string]: string; name: string; role: 'admin' | 'user'}\n```\n\n@category Object\n*/\nexport type Except<ObjectType, KeysType extends keyof ObjectType, Options extends ExceptOptions = {}> =\n\t_Except<ObjectType, KeysType, ApplyDefaultOptions<ExceptOptions, DefaultExceptOptions, Options>>;\n\ntype _Except<ObjectType, KeysType extends keyof ObjectType, Options extends Required<ExceptOptions>> = {\n\t[KeyType in keyof ObjectType as Filter<KeyType, KeysType>]: ObjectType[KeyType];\n} & (Options['requireExactProps'] extends true\n\t? Partial<Record<KeysType, never>>\n\t: {});\n\nexport {};\n"],"x_google_ignoreList":[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16],"mappings":";;AAiBA;;;;;;;;;ACsBA;;;;;;;KDtBYA;;AEWZ;;AFPCC;;AGqBD;AAAA,EAAmEW,CAAAA,gBAAAA,EHlB5CX,KGkB4CW,EAAAA,GAAAA;AAC5DA;AAAAA,EAAOC;AAAbH;AACGG;AAAAA,CAAkBD,SAAAA,CAAAA,CAAAA,kBAAAA,EAAAA,KAAAA,aAAAA,EAAAA,GAAAA,IAAAA;AACjBA;AAAAA,EHdFV,YGcsBW,GHdPZ,KGcOY,GAAKD,KAAAA;;;;;;;;;;;AFN9B;;;;;;;;;ACXA;;;;ACcA;;;;;;;;;;;;;;;;ACPYI,KHIAZ,WGJc,CAAA,UAAAa,CAAAA;AACzBA;AACyBA,MHIlBd,mBGJkBc,CHIEZ,UGJFY,SAAAA,OAAAA,GHI+BX,MGJ/BW,CAAAA,MHI4CZ,UGJ5CY,EAAAA,KAAAA,CAAAA,GAAAA,KAAAA,CAAAA;;;;AJpB1B;;;;;;;;;ACsBA;;;;;;;;;ACXA;;;;ACcA;;;;;AAEIJ,KDhBQN,KCgBRM,CAAAA,CAAAA,CAAAA,GAAAA,CAAAA,SAAAA,CAAAA,GDhBiCJ,OCgBjCI,CDhByCL,CCgBzCK,CAAAA,GAAAA,IAAAA,GAAAA,KAAAA;;;;;;;;;;;AFLJ;;;;;;;;;ACXA;;;;ACcA;;;;;;;;;;;;;;;;ACPA;;;AAGmBI,KDIPN,eCJOM,CAAAA,aAAAA,MAAAA,EAAAA,cAAAA,MDIgDL,ICJhDK,CAAAA,GDKlBP,KCLwBQ,CDKlBN,ICLkBM,GDKXL,KCLWK,CAAAA,SAAAA,IAAAA,GAAAA,KAAAA,GDMrBL,KCNDE,SAAAA,MDMmBH,ICNnBG,GDOEH,ICLCM,SDKYJ,MCLZI,CDKmBL,KCLnBK,EDKwBN,ICLxBM,CDK6BL,KCL7BK,CAAAA,CAAAA,GAEOD,KAAAA,GAAI,IAAA;;;;;;;;;;;AHHjB;;;;;;;;;ACXA;;;;ACcA;;;;;;;;;;;;AAGwB,KCVZD,cDUY,CAAA,aAAA,MAAA,CAAA,GCTvBC;yBACyBA,QACvBF,gBAAgBE,MAAMC,qBAHbF,KAAAA,GAKNE,GAJLD,GACyBA,KAAAA,EACPA,CAAAA,GAAAA,MAINA,IAJMA,CAAAA;AAAAA,EAAMC,KAAAA;;;;;;;;;;;AHCzB;;;;;;;;;ACXA;;;;ACcA;;;;;;;;;AAG8BN,KEblBQ,cFakBR,CAAAA,aAAAA,MAAAA,CAAAA,GEZ7BS,IFYkCR,SAAAA,OAAAA,CAAAA;AAAAA,EEX/BS,OFWcR,CAAAA,MEXAO,IFWAP,EEXMK,cFWNL,CEXqBO,IFWrBP,CAAAA,CAAAA,GAAM,KAAA;;;;AH5BxB;;;;;;;;;ACsBA;;;;;;;;;ACXA;;;;ACcA;;;;;;;;;;;;;;;;ACPA;;;;;;;;;;;;ACHA;;AAEkBO,KCmBNE,ODnBMF,CAAAA,CAAAA,CAAAA,GAAAA,CCmBQG,CDnBRH,CAAAA,SAAAA,CAAAA,KAAAA,CAAAA,GAAAA,IAAAA,GAAAA,KAAAA;;;;;;;;;;;AJKlB;;;;;;;;;ACXA;;;;ACcA;;;;;;;;;;;;;;;;ACPA;;;;;;;;;;;;ACHA;;;;;;;;;;ACqBA;;;;ACyCA;;;;;;;;;;;ACtEA;;;;ACyDA;AAkDA;;;;;;;;;;;AA4BA;;KFjEYK,iDACXD,QAAQE,qBACLE,UGtCQkC,GHuCRpC,IGvCyCqC,SAAAA,IAAAA,GHwCxCpC,QGxC4CoC,GHyC5CnC,UGzC8CoC;;;;AVzCnD;;;;;;;;;ACsBA;;;;;;;;;ACXA;;;;ACcA;AAAmErD,KKlBvDkB,YAAAA,GLkBuDlB,SAAAA,OAAAA,EAAAA;;;;;;;;;;AKlBnE;;;;ACyDA;AAkDY8C,KAlDAF,GAkDAE,CAAAA,UAAe,OAAAA,CAAAA,GAlDUD,CAkDVC,SAAAA,IAAAA,GACjBL,KAAAA,GAjDPI,CAiDCzB,SAAAA,KAAAA,GAAU2B,IAAAA,GAAkBN,KAAAA;;;;;;AA2BhC;;;;ACrGA;;;;;;;;AC/BA;;;;;;;;;AAKU;;;;;;;;;;;;;AC2DV;;;;;AAGcoB,KHqCFf,eGrCEe,CAAAA,CAAAA,EAAAA,iBAAAA,EAAAA,QAAAA,GAAAA,EAAAA,UAAAA,KAAAA,CAAAA,GHsCb1C,EGtCwB2C,CHsCrB1C,KGtCqB0C,CHsCfrB,CGtCeqB,CAAAA,EHsCXf,KGtCWe,EHsCJ3C,EGtCI2C,CHsCDzC,OGtCCyC,CHsCOrB,CGtCPqB,CAAAA,EHsCWd,OGtCXc,EHsCoBhB,iBGtCpBgB,CAAAA,CAAAA;;;AE9CzB;AACCY,KL8GWxB,mCAAAA,GK9GXwB,CAAAA,CAAAA,MAAAA,GAAAA,SAAAA,CAAAA,CAAAA,CAAAA,SAAAA,CAAAA,MAAAA,CAAAA,CAAAA,GACGC,KAAAA,GACYD,IAAAA;;;;AdlChB;;;;;;;;;ACsBA;;;;;;;;;ACXA;;;;ACcA;;;;;;;;;;;;;;;;ACPA;;;;;;;;;;;;ACHA;;;;;;;KK0BYvB,kCAAiCC,IAAIA,EAAEC;;;AVzCnD;;;;;;;;;ACsBA;;;;;;;;;ACXA;;;;ACcA;;;;AACCvD,KQhBWyD,ORgBXzD,CAAAA,CAAAA,EAAAA,CAAAA,CAAAA,GACGG,CQhBFuD,CRgBEvD,CAAAA,SAAAA,CQhBUwD,CRgBVxD,CAAAA,GAAkBD,CQfjByD,CReiBzD,CAAAA,SAAAA,CQfLwD,CReKxD,CAAAA,GQdjB0D,QReA1D,CQfSwD,CReTxD,EQfYyD,CReZzD,CAAAA,GAAoBC,KAAAA,GAAKD,KAAAA;;KQVzB0D,QRUmB,CAAA,CAAA,EAAA,CAAA,CAAA,aQTbC,UAAUH,IAAIG,IAAIA,6BAClBA,UAAUF,IAAIE,IAAIA,oBPFjBvD,KAAAA;;;;AJlBZ;;;;;;;;;ACsBA;;;;;;;;;ACXA;;;;ACcA;;;;;;;;;;;;;;;;ACPA;;;;;;;;;;;;ACHA;;;;;;;;;;ACqBA;;;;ACyCA;;;;;;;;;;;ACtEA;;;;ACyDA;AAkDA;;;;;;;;;;AACG,KGzCSwD,kBHyCT,CAAA,UAAA,CAAA,GAAA,cA2BSV,MGnEOW,UHmEPX,IAAAA,CAAAA,CAAAA,SGnEgCa,MHmEG,CGnEID,OHmEJ,EAAA,OAAA,CAAA,WGjE3CA,UAAUD,WAAWC;;;;AZ7EzB;;;;;;;;;ACsBA;;;;;;;;;ACXA;;;;ACcA;;;;;;;;;;;;;;;;ACPA;;;;;;AAKMxD,KSKM0D,kBTLN1D,CAAAA,UAAAA,CAAAA,GAAAA,cAEOD,MSIM4D,UTJN5D,IAAAA,CAAAA,CAAAA,SSI+B8D,MTJ/B9D,CSIsC6D,OTJtC7D,EAAAA,OAAAA,CAAAA,GSKT6D,OTLa,WSMLD,WAAWC;;;;KCzClBO,mCAAmCH,yBACzBI,eAAeE,kBAAkBD,iBAAiBC,MAAMF,YAAYE,SAC/ED;;;;;;;;;;AZmBJ;;;;ACcA;;;;;;;;;;;;;;;;ACPA;;;;;;;;;KUaYE,6BACXH;EACGC;EACCJ,ETnBO/D,CSmBJgE,OTnBIhE,CSmBIkE,WTnBU,ESmBGC,MTnBHlE,CAAAA,ESmBYiE,WTnBZ,ESmByBI,MTnBzB,CSmBgCJ,WTnBhC,ESmB6CC,MTnB7C,CAAA,CAAA,GACzBlE,KAAAA,CAAAA;AAAAA,EACiBA,KAAAA;AAAAA;;AAAMF,KSqBZuE,MTrBYvE,CAAAA,WAAAA,EAAAA,MAAAA,CAAAA,GSsBvB+D,QTtBG5D,CSuBF+D,WTvBS,CSuBGJ,kBTvBH,CSuBsBK,WTvBtB,CAAA,ESuBoCL,kBTvBpC,CSuBuDM,MTvBvD,CAAA,CAAA,GSwBPF,YAAYL,mBAAmBM,cAAcN,mBAAmBO;;;ALqGpE;;;;ACrGA;;;;;;;;AC/BA;;;;;;;;;AAKU;;;;;;;;;;;;;AC2DV;;;AAC4CZ,KGqChC6C,eHrCgC7C,CAAAA,CAAAA,EAAAA,aGqCAkB,WHrCAlB,CGqCYuC,CHrCZvC,CAAAA,CAAAA,GAAAA,QAExCD,MGoCSwC,CHpCTxC,IGoCciD,OHpCdjD,CGoCsBgD,CHpCtBhD,EGoCyB+C,IHpCzB/C,CAAAA,GGoCiCwC,CHpCjCxC,CGoCmCgD,CHpCnChD,CAAAA,EAAUD;;AEvCd;;;;;;;;;;;;;;;;AC0EA;;;;;;;;;;AA4FA;;;;;;;;;;;;;;;;;;;;;;;;;AAS+FkC,KATnFoB,mBASmFpB,CAAMA,gBAAAA,MAAAA,EAC9FuB,iBARWvC,QAQXuC,CARoBE,IAQpBF,CARyBC,QAQzBD,CARkCF,OAQlCE,CAAAA,EAR4CpC,cAQ5CoC,CAR2DF,OAQ3DE,CAAAA,CAAAA,GARuEI,OAQvEJ,CAR+EG,MAQ/EH,CARsFpC,cAQtFoC,CARqGF,OAQrGE,CAAAA,EAAAA,KAAAA,CAAAA,CAAAA,CAAAA,EAAiBvB,yBAPEqB,OAOFrB,CAHZZ,GAFXG,EAMgB8B,CANb/B,KAMa+B,CANPE,gBAMOF,CAAAA,EANYC,QAMZD,EALf9B,EAKMiC,CALHhC,OAKGgC,CALKD,gBAKLC,CAAAA,EALwBF,QAKxBE,EAJLxC,QAAAA,CAASI,KAATJ,CAAesC,QAAftC,EAAAA,UADDO,MAEgBgC,gBAFhBhC,IAGKS,GAJNT,SAIkBF,cAJlBE,CAIiC8B,OAJjC9B,CAAAA,GAAAA,SAAAA,SAI8DgC,gBAJ9DhC,CAI+ES,GAJ/ET,CAAAA,GAAAA,KAAAA,GAI8FS,GAJ9FT,GAIoGS,GAJpGT,GAKMgC,gBALJ,CAKqBvB,GALrB,CAAA,EAmCS4B,CAAAA,GA7BJJ,QA6BII,CA7BKP,OA6BW,CAAA,CAAA,CAAA,CAAA;AAAA;;;;;;;;;ACpQiB;;;;;;;;AA+B7C;AASE;AA6DF;;;;;;;;;;AACQ,KD8JIO,gBC9JJ,CAAA,CAAA,CAAA,GAAA,CAAA,CAAA,SD8JqCrB,CC9JrC,GD+JLA,CC7JEkC,GD8JFlC,CC9J6C+B,SAAAA,KAAAA,EAAAA,GAAAA,CAAAA,CAAAA,GAAqCH,CAAAA,GDgKjF5B,CChKwEmC;;;;;;;;;;AflE5E;;;;;;;;;ACXA;;;;ACcA;;;;;;;KaZKV,MbeA/H,CAAAA,SAAAA,EAAAA,WAAAA,CAAAA,Gaf+B8H,Obe/B9H,CafuCgI,SbevChI,EafgDiI,WbehDjI,CAAAA,SAAAA,IAAAA,GAAAA,KAAAA,GAAAA,CafqFgI,SberFhI,SafqGiI,WberGjI,GAAAA,KAAAA,Gaf2HgI,Sbe3HhI,CAAAA;AAAyBA,KablBkI,aAAAA,GbakBlI;EAAKC;;;;;ECTlCI,iBAAAA,CAAAA,EAAAA,OAAAA;CACyBA;KYMrB8H,oBAAAA,GZLoB7H;EAAtBH,iBAAAA,EAAAA,KAAAA;CAEGG;;;;;;ACRN;;;;;;;;;;ACqBA;;;;ACyCA;;;;;;;;;;;ACtEA;;;;ACyDA;AAkDA;;;;;;;;;;;AA4BA;;;;ACrGA;;;;;;KM4CY8H,0CAA0CC,4BAA4BH,sBACjFM,QAAQH,YAAYC,UAAUT,oBAAoBK,eAAeC,sBAAsBI;KAEnFC,OL7EHhF,CAAAA,UAAAA,EAAAA,iBAAAA,MK6E8C6E,UL7E9C7E,EAAAA,gBK6E0EiF,QL7E1EjF,CK6EmF0E,aL7EnF1E,CAAAA,CAAAA,GAAAA,cAAYC,MK8EK4E,UL9EL5E,IK8EmBsE,ML9EnBtE,CK8E0BuE,OL9E1BvE,EK8EmC6E,QL9EnC7E,CAAAA,GK8E+C4E,UL9E/C5E,CK8E0DuE,OL9E1DvE,CAAAA,EACTA,GAAAA,CK8EA8E,OL9EA9E,CAAAA,mBAAAA,CAAAA,SAAAA,IAAAA,GK+EFkF,OL/EcnF,CK+ENkF,ML/EMlF,CK+EC8E,QL/ED9E,EAAAA,KAAAA,CAAAA,CAAAA,GACHA,CAAAA,CAAAA,CAAAA"}

package/dist/hooks-alova.js.map

@@ -1 +1 @@
-{"version":3,"file":"hooks-alova.js","names":[],"sources":["../src/hooks/alova/useAlovaRequest.ts","../src/hooks/alova/useAlovaWatcher.ts"],"sourcesContent":["/* eslint-disable ts/no-explicit-any */\n\nimport type { AlovaGenerics, Method } from \"alova\";\nimport {\n  type AlovaFrontMiddlewareContext,\n  type AlovaMethodHandler,\n  type CompleteHandler,\n  type ErrorHandler,\n  type RequestHookConfig,\n  type SuccessHandler,\n  useRequest,\n} from \"alova/client\";\n\ninterface HookConfig<AG extends AlovaGenerics, Args extends any[]> extends RequestHookConfig<AG, Args> {\n  onBeforeRequest?: (context: AlovaFrontMiddlewareContext<AG, Args>) => void;\n  onSuccess?: SuccessHandler<AG, Args>;\n  onError?: ErrorHandler<AG, Args>;\n  onComplete?: CompleteHandler<AG, Args>;\n}\n\nexport function useAlovaRequest<AG extends AlovaGenerics, Args extends any[] = any[]>(\n  methodHandler: Method<AG> | AlovaMethodHandler<AG, Args>,\n  hookConfig?: HookConfig<AG, Args> | undefined,\n) {\n  const config = hookConfig || {};\n  config.immediate ??= true;\n\n  if (config.onBeforeRequest) {\n    const middleware = config.middleware;\n    config.middleware = async (context, next) => {\n      config.onBeforeRequest?.(context);\n\n      if (middleware) {\n        async function run() {\n          await next();\n        }\n        await middleware?.(context, run);\n      } else {\n        await next();\n      }\n    };\n  }\n\n  const exposure = useRequest(methodHandler, config);\n\n  if (config.onSuccess) {\n    exposure.onSuccess(config.onSuccess);\n  }\n  if (config.onError) {\n    exposure.onError(config.onError);\n  }\n  if (config.onComplete) {\n    exposure.onComplete(config.onComplete);\n  }\n\n  return exposure;\n}\n","/* eslint-disable ts/no-explicit-any */\n\nimport type { AlovaGenerics, Method } from \"alova\";\nimport {\n  type AlovaMethodHandler,\n  type CompleteHandler,\n  type ErrorHandler,\n  type SuccessHandler,\n  type WatcherHookConfig,\n  useWatcher,\n} from \"alova/client\";\n\ninterface HookConfig<AG extends AlovaGenerics, Args extends any[]> extends WatcherHookConfig<AG, Args> {\n  onSuccess?: SuccessHandler<AG, Args>;\n  onError?: ErrorHandler<AG, Args>;\n  onComplete?: CompleteHandler<AG, Args>;\n}\n\nexport function useAlovaWatcher<AG extends AlovaGenerics, Args extends any[] = any[]>(\n  methodHandler: Method<AG> | AlovaMethodHandler<AG, Args>,\n  watchingStates: AG[\"StatesExport\"][\"Watched\"][],\n  hookConfig: HookConfig<AG, Args> = {},\n) {\n  const config = hookConfig || {};\n  const exposure = useWatcher(methodHandler, watchingStates, config);\n\n  if (config.onSuccess) {\n    exposure.onSuccess(config.onSuccess);\n  }\n  if (config.onError) {\n    exposure.onError(config.onError);\n  }\n  if (config.onComplete) {\n    exposure.onComplete(config.onComplete);\n  }\n\n  return exposure;\n}\n"],"mappings":";;;AAoBA,SAAgB,gBACd,eACA,YACA;CACA,MAAM,SAAS,cAAc,EAAE;AAC/B,QAAO,cAAP,OAAO,YAAc;AAErB,KAAI,OAAO,iBAAiB;EAC1B,MAAM,aAAa,OAAO;AAC1B,SAAO,aAAa,OAAO,SAAS,SAAS;AAC3C,UAAO,kBAAkB,QAAQ;AAEjC,OAAI,YAAY;IACd,eAAe,MAAM;AACnB,WAAM,MAAM;;AAEd,UAAM,aAAa,SAAS,IAAI;SAEhC,OAAM,MAAM;;;CAKlB,MAAM,WAAW,WAAW,eAAe,OAAO;AAElD,KAAI,OAAO,UACT,UAAS,UAAU,OAAO,UAAU;AAEtC,KAAI,OAAO,QACT,UAAS,QAAQ,OAAO,QAAQ;AAElC,KAAI,OAAO,WACT,UAAS,WAAW,OAAO,WAAW;AAGxC,QAAO;;;;;ACrCT,SAAgB,gBACd,eACA,gBACA,aAAmC,EAAE,EACrC;CACA,MAAM,SAAS,cAAc,EAAE;CAC/B,MAAM,WAAW,WAAW,eAAe,gBAAgB,OAAO;AAElE,KAAI,OAAO,UACT,UAAS,UAAU,OAAO,UAAU;AAEtC,KAAI,OAAO,QACT,UAAS,QAAQ,OAAO,QAAQ;AAElC,KAAI,OAAO,WACT,UAAS,WAAW,OAAO,WAAW;AAGxC,QAAO"}
+{"version":3,"file":"hooks-alova.js","names":[],"sources":["../src/hooks/alova/useAlovaRequest.ts","../src/hooks/alova/useAlovaWatcher.ts"],"sourcesContent":["/* eslint-disable ts/no-explicit-any */\n\nimport type { AlovaGenerics, Method } from \"alova\";\nimport {\n  type AlovaFrontMiddlewareContext,\n  type AlovaMethodHandler,\n  type CompleteHandler,\n  type ErrorHandler,\n  type RequestHookConfig,\n  type SuccessHandler,\n  useRequest,\n} from \"alova/client\";\n\ninterface HookConfig<AG extends AlovaGenerics, Args extends any[]> extends RequestHookConfig<AG, Args> {\n  onBeforeRequest?: (context: AlovaFrontMiddlewareContext<AG, Args>) => void;\n  onSuccess?: SuccessHandler<AG, Args>;\n  onError?: ErrorHandler<AG, Args>;\n  onComplete?: CompleteHandler<AG, Args>;\n}\n\nexport function useAlovaRequest<AG extends AlovaGenerics, Args extends any[] = any[]> (\n  methodHandler: Method<AG> | AlovaMethodHandler<AG, Args>,\n  hookConfig?: HookConfig<AG, Args> | undefined,\n) {\n  const config = hookConfig || {};\n  config.immediate ??= true;\n\n  if (config.onBeforeRequest) {\n    const middleware = config.middleware;\n    config.middleware = async (context, next) => {\n      config.onBeforeRequest?.(context);\n\n      if (middleware) {\n        async function run () {\n          await next();\n        }\n        await middleware?.(context, run);\n      } else {\n        await next();\n      }\n    };\n  }\n\n  const exposure = useRequest(methodHandler, config);\n\n  if (config.onSuccess) {\n    exposure.onSuccess(config.onSuccess);\n  }\n  if (config.onError) {\n    exposure.onError(config.onError);\n  }\n  if (config.onComplete) {\n    exposure.onComplete(config.onComplete);\n  }\n\n  return exposure;\n}\n","/* eslint-disable ts/no-explicit-any */\n\nimport type { AlovaGenerics, Method } from \"alova\";\nimport {\n  type AlovaMethodHandler,\n  type CompleteHandler,\n  type ErrorHandler,\n  type SuccessHandler,\n  type WatcherHookConfig,\n  useWatcher,\n} from \"alova/client\";\n\ninterface HookConfig<AG extends AlovaGenerics, Args extends any[]> extends WatcherHookConfig<AG, Args> {\n  onSuccess?: SuccessHandler<AG, Args>;\n  onError?: ErrorHandler<AG, Args>;\n  onComplete?: CompleteHandler<AG, Args>;\n}\n\nexport function useAlovaWatcher<AG extends AlovaGenerics, Args extends any[] = any[]> (\n  methodHandler: Method<AG> | AlovaMethodHandler<AG, Args>,\n  watchingStates: AG[\"StatesExport\"][\"Watched\"][],\n  hookConfig: HookConfig<AG, Args> = {},\n) {\n  const config = hookConfig || {};\n  const exposure = useWatcher(methodHandler, watchingStates, config);\n\n  if (config.onSuccess) {\n    exposure.onSuccess(config.onSuccess);\n  }\n  if (config.onError) {\n    exposure.onError(config.onError);\n  }\n  if (config.onComplete) {\n    exposure.onComplete(config.onComplete);\n  }\n\n  return exposure;\n}\n"],"mappings":";;;AAoBA,SAAgB,gBACd,eACA,YACA;CACA,MAAM,SAAS,cAAc,EAAE;AAC/B,QAAO,cAAP,OAAO,YAAc;AAErB,KAAI,OAAO,iBAAiB;EAC1B,MAAM,aAAa,OAAO;AAC1B,SAAO,aAAa,OAAO,SAAS,SAAS;AAC3C,UAAO,kBAAkB,QAAQ;AAEjC,OAAI,YAAY;IACd,eAAe,MAAO;AACpB,WAAM,MAAM;;AAEd,UAAM,aAAa,SAAS,IAAI;SAEhC,OAAM,MAAM;;;CAKlB,MAAM,WAAW,WAAW,eAAe,OAAO;AAElD,KAAI,OAAO,UACT,UAAS,UAAU,OAAO,UAAU;AAEtC,KAAI,OAAO,QACT,UAAS,QAAQ,OAAO,QAAQ;AAElC,KAAI,OAAO,WACT,UAAS,WAAW,OAAO,WAAW;AAGxC,QAAO;;;;;ACrCT,SAAgB,gBACd,eACA,gBACA,aAAmC,EAAE,EACrC;CACA,MAAM,SAAS,cAAc,EAAE;CAC/B,MAAM,WAAW,WAAW,eAAe,gBAAgB,OAAO;AAElE,KAAI,OAAO,UACT,UAAS,UAAU,OAAO,UAAU;AAEtC,KAAI,OAAO,QACT,UAAS,QAAQ,OAAO,QAAQ;AAElC,KAAI,OAAO,WACT,UAAS,WAAW,OAAO,WAAW;AAGxC,QAAO"}

package/dist/hooks-react.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks-react.d.ts","names":[],"sources":["../src/hooks/react/useCreation.ts","../src/hooks/react/useLatest.ts","../src/hooks/react/useMount.ts","../src/hooks/react/useResponsive.ts","../src/hooks/react/useUnmount.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AAgBA;;;AAAqE,iBAArD,WAAqD,CAAA,CAAA,CAAA,CAAA,OAAA,EAAA,GAAA,GAAvB,CAAuB,EAAA,IAAA,EAAd,cAAc,CAAA,EAAA,CAAA;;;;;;;AAArE;;AAAuD,iBCRvC,SDQuC,CAAA,CAAA,CAAA,CAAA,KAAA,ECRnB,CDQmB,CAAA,ECRf,SDQe,CCRL,CDQK,CAAA;;;KEXlD,aAAA,GAAgB,iBAAiB;;;AFWtC;;;;;iBEFgB,QAAA,SAAiB;;;KCV5B,UAAA;KAGA,gBAAA,GAAmB,OAAO;UAQd,qBAAA;;AHCjB;;;;EAAqE,iBAAA,CAAA,EGK/C,UHL+C;;qBGOhD;;AFfL,iBEiBA,aAAA,CFjBS,OAAA,CAAA,EEiBe,qBFjBf,CAAA,EAAA;EAAW,UAAA,kBAAA;EAAc,OAAA,YAAA;EAAV,SAAA,EAAA,OAAA;EAAS,gBAAA,wBAAA;;;;;;;;ADQjD;;AAAuD,iBILvC,UAAA,CJKuC,MAAA,EILpB,WJKoB,CAAA,EAAA,IAAA"}
+{"version":3,"file":"hooks-react.d.ts","names":[],"sources":["../src/hooks/react/useCreation.ts","../src/hooks/react/useLatest.ts","../src/hooks/react/useMount.ts","../src/hooks/react/useResponsive.ts","../src/hooks/react/useUnmount.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AAgBA;;;AAAsE,iBAAtD,WAAsD,CAAA,CAAA,CAAA,CAAA,OAAA,EAAA,GAAA,GAAvB,CAAuB,EAAA,IAAA,EAAd,cAAc,CAAA,EAAA,CAAA;;;;;;;AAAtE;;AAAwD,iBCRxC,SDQwC,CAAA,CAAA,CAAA,CAAA,KAAA,ECRnB,CDQmB,CAAA,ECRf,SDQe,CCRL,CDQK,CAAA;;;KEXnD,aAAA,GAAgB,iBAAiB;;;AFWtC;;;;;iBEFgB,QAAA,SAAkB;;;KCV7B,UAAA;KAGA,gBAAA,GAAmB,OAAO;UAQd,qBAAA;;AHCjB;;;;EAAsE,iBAAA,CAAA,EGKhD,UHLgD;;qBGOjD;;AFfL,iBEiBA,aAAA,CFjBS,OAAA,CAAA,EEiBgB,qBFjBhB,CAAA,EAAA;EAAY,UAAA,kBAAA;EAAc,OAAA,YAAA;EAAV,SAAA,EAAA,OAAA;EAAS,gBAAA,wBAAA;;;;;;;;ADQlD;;AAAwD,iBILxC,UAAA,CJKwC,MAAA,EILpB,WJKoB,CAAA,EAAA,IAAA"}

package/dist/hooks-react.js

@@ -1,4 +1,4 @@
-import { Et as isEqual, Mt as isFunction, S as objectAssign, ut as isPromiseLike, y as objectKeys } from "./utils-DET4yd5r.js";
+import { Et as isEqual, Mt as isFunction, S as objectAssign, ut as isPromiseLike, y as objectKeys } from "./utils-khUJYSj2.js";
 import { n as BREAK_POINT_TOKEN_ENUM } from "./enums-Bv0coVvD.js";
 import { useEffect, useRef, useState } from "react";
 

package/dist/hooks-react.js.map

@@ -1 +1 @@
-{"version":3,"file":"hooks-react.js","names":["defaultResponsiveValues: ResponsiveValues","responsiveConfig: ResponsiveConfig","responsiveValues: ResponsiveValues","tokens: BREAK_POINT_TOKEN_TYPE"],"sources":["../src/hooks/react/useCreation.ts","../src/hooks/react/useLatest.ts","../src/hooks/react/useMount.ts","../src/hooks/react/useResponsive.ts","../src/hooks/react/useUnmount.ts"],"sourcesContent":["import { useRef, type DependencyList } from \"react\";\nimport { isEqual } from \"src/utils\";\n\ninterface RefObject<T> {\n  deps: DependencyList;\n  result: T;\n  isInitialized: boolean;\n}\n\n/**\n * useCreation\n * @reference https://ahooks.js.org/zh-CN/hooks/use-creation\n *\n * @param factory\n * @param deps\n */\nexport function useCreation<T>(factory: () => T, deps: DependencyList) {\n  const { current } = useRef<RefObject<T>>({ deps, result: undefined!, isInitialized: false });\n\n  if (current.isInitialized === false || !isEqual(current.deps, deps)) {\n    current.deps = deps;\n    current.result = factory();\n    current.isInitialized = true;\n  }\n\n  return current.result;\n}\n\n","import { useRef, type RefObject } from \"react\";\n\n/**\n * 返回当前最新值的 Hook\n * @reference https://ahooks.js.org/zh-CN/hooks/use-latest\n *\n * @param value\n */\nexport function useLatest<T>(value: T): RefObject<T> {\n  const ref = useRef(value);\n  ref.current = value;\n\n  return ref;\n}\n\n","import type { AnyAsyncFunction } from \"@pawover/types\";\nimport { useEffect, useRef, type EffectCallback } from \"react\";\nimport { isFunction, isPromiseLike } from \"src/utils\";\nimport { useLatest } from \"./useLatest\";\n\ntype MountCallback = EffectCallback | AnyAsyncFunction;\n\n/**\n * 在组件初始化时执行的 Hook\n * - 即使在严格模式下也只执行一次\n * @reference https://ahooks.js.org/hooks/use-mount\n *\n * @param effect 副作用函数\n */\nexport function useMount(effect: MountCallback) {\n  if (!isFunction(effect)) {\n    console.error(`useMount expected parameter is a function, but got ${typeof effect}`);\n  }\n\n  const isMountedRef = useRef(false);\n  const effectRef = useLatest(effect);\n\n  useEffect(() => {\n    if (isMountedRef.current) {\n      return;\n    }\n\n    isMountedRef.current = true;\n    const result = effectRef.current?.();\n    // If fn returns a Promise, don't return it as cleanup function\n    if (isPromiseLike(result)) {\n      return;\n    }\n\n    return result as ReturnType<EffectCallback>;\n  }, []);\n}\n\n","import { useEffect, useState } from \"react\";\nimport { BREAK_POINT_TOKEN_ENUM, type BREAK_POINT_TOKEN_TYPE } from \"src/enums\";\nimport { objectAssign, objectKeys } from \"src/utils\";\n\ntype Breakpoint = \"xxl\" | \"xl\" | \"lg\" | \"md\" | \"sm\" | \"xs\";\ntype Subscriber = () => void;\ntype ResponsiveConfig = Record<Breakpoint, number>;\ntype ResponsiveValues = Record<Breakpoint, boolean>;\n\nconst subscriberList = new Set<Subscriber>();\nconst { XS, SM, MD, LG, XL, XXL } = BREAK_POINT_TOKEN_ENUM;\nconst defaultResponsiveValues: ResponsiveValues = { xxl: false, xl: false, lg: false, md: false, sm: false, xs: false };\nlet responsiveConfig: ResponsiveConfig = { xxl: XXL, xl: XL, lg: LG, md: MD, sm: SM, xs: XS };\nlet responsiveValues: ResponsiveValues = { ...defaultResponsiveValues };\n\nexport interface ResponsiveHookOptions {\n  /**\n   * 紧凑布局断点\n   * - 低于此断点时使用紧凑布局\n   * @default \"xl\"\n   */\n  compactBreakPoint?: Breakpoint;\n  /** 屏幕响应断点 token 配置 */\n  breakPointTokens?: BREAK_POINT_TOKEN_TYPE;\n}\nexport function useResponsive(options?: ResponsiveHookOptions) {\n  const { compactBreakPoint = \"xl\", breakPointTokens = {} } = options || {};\n  const tokens: BREAK_POINT_TOKEN_TYPE = objectAssign(BREAK_POINT_TOKEN_ENUM, breakPointTokens);\n  responsiveConfig = { xxl: tokens.XXL, xl: tokens.XL, lg: tokens.LG, md: tokens.MD, sm: tokens.SM, xs: tokens.XS };\n\n  calculate();\n\n  const [responsive, setResponsive] = useState<ResponsiveValues>(responsiveValues);\n  const isCompact = !responsive[compactBreakPoint];\n  const current = objectKeys(defaultResponsiveValues).find((key) => responsive[key] === true) || \"xs\";\n\n  useEffect(() => {\n    addListener();\n\n    const subscriber = () => {\n      setResponsive(responsiveValues);\n    };\n\n    subscriberList.add(subscriber);\n\n    return () => {\n      subscriberList.delete(subscriber);\n\n      if (subscriberList.size === 0) {\n        removeListener();\n      }\n    };\n  }, []);\n\n  return { responsive, current, isCompact, breakPointTokens: tokens };\n}\n\nfunction resizeListener() {\n  const oldInfo = responsiveValues;\n  calculate();\n\n  if (oldInfo === responsiveValues) {\n    return;\n  }\n\n  for (const subscriber of subscriberList) {\n    subscriber();\n  }\n}\nfunction addListener() {\n  window.addEventListener(\"resize\", resizeListener);\n}\nfunction removeListener() {\n  window.removeEventListener(\"resize\", resizeListener);\n}\nfunction calculate() {\n  const width = window.innerWidth;\n  const newValues = { ...defaultResponsiveValues };\n  let shouldUpdate = false;\n\n  for (const key of objectKeys(responsiveConfig)) {\n    newValues[key] = width >= responsiveConfig[key];\n    if (newValues[key] !== responsiveValues[key]) {\n      shouldUpdate = true;\n    }\n  }\n  if (shouldUpdate) {\n    responsiveValues = newValues;\n  }\n}\n\n","import type { AnyFunction } from \"@pawover/types\";\nimport { useEffect } from \"react\";\nimport { isFunction } from \"src/utils\";\nimport { useLatest } from \"./useLatest\";\n\n/**\n * 在组件卸载时执行的 Hook\n * @reference https://ahooks.js.org/zh-CN/hooks/use-unmount\n *\n * @param effect 副作用函数\n */\nexport function useUnmount(effect: AnyFunction) {\n  if (!isFunction(effect)) {\n    console.error(`useUnmount expected parameter is a function, got ${typeof effect}`);\n  }\n\n  const effectRef = useLatest(effect);\n\n  useEffect(\n    () => () => {\n      effectRef.current?.();\n    },\n    [],\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"hooks-react.js","names":["defaultResponsiveValues: ResponsiveValues","responsiveConfig: ResponsiveConfig","responsiveValues: ResponsiveValues","tokens: BREAK_POINT_TOKEN_TYPE"],"sources":["../src/hooks/react/useCreation.ts","../src/hooks/react/useLatest.ts","../src/hooks/react/useMount.ts","../src/hooks/react/useResponsive.ts","../src/hooks/react/useUnmount.ts"],"sourcesContent":["import { useRef, type DependencyList } from \"react\";\nimport { isEqual } from \"src/utils\";\n\ninterface RefObject<T> {\n  deps: DependencyList;\n  result: T;\n  isInitialized: boolean;\n}\n\n/**\n * useCreation\n * @reference https://ahooks.js.org/zh-CN/hooks/use-creation\n *\n * @param factory\n * @param deps\n */\nexport function useCreation<T> (factory: () => T, deps: DependencyList) {\n  const { current } = useRef<RefObject<T>>({ deps, result: undefined!, isInitialized: false });\n\n  if (current.isInitialized === false || !isEqual(current.deps, deps)) {\n    current.deps = deps;\n    current.result = factory();\n    current.isInitialized = true;\n  }\n\n  return current.result;\n}\n\n","import { useRef, type RefObject } from \"react\";\n\n/**\n * 返回当前最新值的 Hook\n * @reference https://ahooks.js.org/zh-CN/hooks/use-latest\n *\n * @param value\n */\nexport function useLatest<T> (value: T): RefObject<T> {\n  const ref = useRef(value);\n  ref.current = value;\n\n  return ref;\n}\n\n","import type { AnyAsyncFunction } from \"@pawover/types\";\nimport { useEffect, useRef, type EffectCallback } from \"react\";\nimport { isFunction, isPromiseLike } from \"src/utils\";\nimport { useLatest } from \"./useLatest\";\n\ntype MountCallback = EffectCallback | AnyAsyncFunction;\n\n/**\n * 在组件初始化时执行的 Hook\n * - 即使在严格模式下也只执行一次\n * @reference https://ahooks.js.org/hooks/use-mount\n *\n * @param effect 副作用函数\n */\nexport function useMount (effect: MountCallback) {\n  if (!isFunction(effect)) {\n    console.error(`useMount expected parameter is a function, but got ${typeof effect}`);\n  }\n\n  const isMountedRef = useRef(false);\n  const effectRef = useLatest(effect);\n\n  useEffect(() => {\n    if (isMountedRef.current) {\n      return;\n    }\n\n    isMountedRef.current = true;\n    const result = effectRef.current?.();\n    // If fn returns a Promise, don't return it as cleanup function\n    if (isPromiseLike(result)) {\n      return;\n    }\n\n    return result as ReturnType<EffectCallback>;\n  }, []);\n}\n\n","import { useEffect, useState } from \"react\";\nimport { BREAK_POINT_TOKEN_ENUM, type BREAK_POINT_TOKEN_TYPE } from \"src/enums\";\nimport { objectAssign, objectKeys } from \"src/utils\";\n\ntype Breakpoint = \"xxl\" | \"xl\" | \"lg\" | \"md\" | \"sm\" | \"xs\";\ntype Subscriber = () => void;\ntype ResponsiveConfig = Record<Breakpoint, number>;\ntype ResponsiveValues = Record<Breakpoint, boolean>;\n\nconst subscriberList = new Set<Subscriber>();\nconst { XS, SM, MD, LG, XL, XXL } = BREAK_POINT_TOKEN_ENUM;\nconst defaultResponsiveValues: ResponsiveValues = { xxl: false, xl: false, lg: false, md: false, sm: false, xs: false };\nlet responsiveConfig: ResponsiveConfig = { xxl: XXL, xl: XL, lg: LG, md: MD, sm: SM, xs: XS };\nlet responsiveValues: ResponsiveValues = { ...defaultResponsiveValues };\n\nexport interface ResponsiveHookOptions {\n  /**\n   * 紧凑布局断点\n   * - 低于此断点时使用紧凑布局\n   * @default \"xl\"\n   */\n  compactBreakPoint?: Breakpoint;\n  /** 屏幕响应断点 token 配置 */\n  breakPointTokens?: BREAK_POINT_TOKEN_TYPE;\n}\nexport function useResponsive (options?: ResponsiveHookOptions) {\n  const { compactBreakPoint = \"xl\", breakPointTokens = {} } = options || {};\n  const tokens: BREAK_POINT_TOKEN_TYPE = objectAssign(BREAK_POINT_TOKEN_ENUM, breakPointTokens);\n  responsiveConfig = { xxl: tokens.XXL, xl: tokens.XL, lg: tokens.LG, md: tokens.MD, sm: tokens.SM, xs: tokens.XS };\n\n  calculate();\n\n  const [responsive, setResponsive] = useState<ResponsiveValues>(responsiveValues);\n  const isCompact = !responsive[compactBreakPoint];\n  const current = objectKeys(defaultResponsiveValues).find((key) => responsive[key] === true) || \"xs\";\n\n  useEffect(() => {\n    addListener();\n\n    const subscriber = () => {\n      setResponsive(responsiveValues);\n    };\n\n    subscriberList.add(subscriber);\n\n    return () => {\n      subscriberList.delete(subscriber);\n\n      if (subscriberList.size === 0) {\n        removeListener();\n      }\n    };\n  }, []);\n\n  return { responsive, current, isCompact, breakPointTokens: tokens };\n}\n\nfunction resizeListener () {\n  const oldInfo = responsiveValues;\n  calculate();\n\n  if (oldInfo === responsiveValues) {\n    return;\n  }\n\n  for (const subscriber of subscriberList) {\n    subscriber();\n  }\n}\nfunction addListener () {\n  window.addEventListener(\"resize\", resizeListener);\n}\nfunction removeListener () {\n  window.removeEventListener(\"resize\", resizeListener);\n}\nfunction calculate () {\n  const width = window.innerWidth;\n  const newValues = { ...defaultResponsiveValues };\n  let shouldUpdate = false;\n\n  for (const key of objectKeys(responsiveConfig)) {\n    newValues[key] = width >= responsiveConfig[key];\n    if (newValues[key] !== responsiveValues[key]) {\n      shouldUpdate = true;\n    }\n  }\n  if (shouldUpdate) {\n    responsiveValues = newValues;\n  }\n}\n\n","import type { AnyFunction } from \"@pawover/types\";\nimport { useEffect } from \"react\";\nimport { isFunction } from \"src/utils\";\nimport { useLatest } from \"./useLatest\";\n\n/**\n * 在组件卸载时执行的 Hook\n * @reference https://ahooks.js.org/zh-CN/hooks/use-unmount\n *\n * @param effect 副作用函数\n */\nexport function useUnmount (effect: AnyFunction) {\n  if (!isFunction(effect)) {\n    console.error(`useUnmount expected parameter is a function, got ${typeof effect}`);\n  }\n\n  const effectRef = useLatest(effect);\n\n  useEffect(\n    () => () => {\n      effectRef.current?.();\n    },\n    [],\n  );\n}\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { a as Simplify, c as Not, d as IsNever, f as OptionalKeysOf, i as HomomorphicPick, l as UnknownArray, m as UnionToIntersection, n as ApplyDefaultOptions, o as IfNotAnyOrNever, p as IsAny, r as CollapseLiterals, s as IsExactOptionalPropertyTypesEnabled, t as Except, u as If } from "./except-DUIiuC3p.js";
+import { a as Simplify, c as Not, d as IsNever, f as OptionalKeysOf, i as HomomorphicPick, l as UnknownArray, m as UnionToIntersection, n as ApplyDefaultOptions, o as IfNotAnyOrNever, p as IsAny, r as CollapseLiterals, s as IsExactOptionalPropertyTypesEnabled, t as Except, u as If } from "./except-C38JazcR.js";
 import { a as AnyObject, i as AnyGeneratorFunction, n as AnyAsyncGeneratorFunction, o as PlainObject, r as AnyFunction, s as TreeLike, t as AnyAsyncFunction } from "./index-CjoMz104.js";
 import { BigNumber, MathExpression, MathJsInstance, Matrix } from "mathjs";
 
-//#region node_modules/.pnpm/type-fest@5.4.2/node_modules/type-fest/source/basic.d.ts
+//#region node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/basic.d.ts
 /**
 Matches a [`class`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Classes).
 
@@ -13,7 +13,7 @@ type Class<T, Arguments extends unknown[] = any[]> = {
   new (...arguments_: Arguments): T;
 };
 //#endregion
-//#region node_modules/.pnpm/type-fest@5.4.2/node_modules/type-fest/source/internal/array.d.ts
+//#region node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/internal/array.d.ts
 
 /**
 Transforms a tuple type by replacing it's rest element with a single element that has the same type as the rest element, while keeping all the non-rest elements intact.
@@ -57,7 +57,7 @@ type _CollapseRestElement<TArray extends UnknownArray, ForwardAccumulator extend
 : First], BackwardAccumulator> : never // Should never happen, since `[(infer First)?, ...infer Rest]` is a top-type for arrays.
 : never; // Should never happen
 //#endregion
-//#region node_modules/.pnpm/type-fest@5.4.2/node_modules/type-fest/source/numeric.d.ts
+//#region node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/numeric.d.ts
 type _Numeric = number | bigint;
 type Zero = 0 | 0n;
 
@@ -104,7 +104,7 @@ type IsNegative<T extends _Numeric> = T extends Negative<T> ? true : false;
 //#region node_modules/.pnpm/tagged-tag@1.0.0/node_modules/tagged-tag/index.d.ts
 declare const tag: unique symbol;
 //#endregion
-//#region node_modules/.pnpm/type-fest@5.4.2/node_modules/type-fest/source/tagged.d.ts
+//#region node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/tagged.d.ts
 // eslint-disable-next-line type-fest/require-exported-types
 type TagContainer<Token> = {
   readonly [tag]: Token;
@@ -280,7 +280,7 @@ type Person = {
 @deprecated Use {@link Tagged} instead
 */
 //#endregion
-//#region node_modules/.pnpm/type-fest@5.4.2/node_modules/type-fest/source/is-literal.d.ts
+//#region node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/is-literal.d.ts
 /**
 Returns a boolean for whether the given type is a `string` [literal type](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#literal-types).
 
@@ -343,7 +343,7 @@ type _IsStringLiteral<S> =
 // and since `{}` extends index signatures, the result becomes `false`.
 S extends string ? {} extends Record<S, never> ? false : true : false;
 //#endregion
-//#region node_modules/.pnpm/type-fest@5.4.2/node_modules/type-fest/source/tuple-of.d.ts
+//#region node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/tuple-of.d.ts
 /**
 Create a tuple type of the specified length with elements of the specified type.
 
@@ -411,7 +411,7 @@ Note: If you need a readonly tuple, simply wrap this type with `Readonly`, for e
 type TupleOf<Length extends number, Fill = unknown> = IfNotAnyOrNever<Length, _TupleOf<If<IsNegative<Length>, 0, Length>, Fill, []>, Fill[], []>;
 type _TupleOf<L extends number, Fill, Accumulator extends UnknownArray> = number extends L ? Fill[] : L extends Accumulator['length'] ? Accumulator : _TupleOf<L, Fill, [...Accumulator, Fill]>;
 //#endregion
-//#region node_modules/.pnpm/type-fest@5.4.2/node_modules/type-fest/source/or.d.ts
+//#region node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/or.d.ts
 /**
 Returns a boolean for whether either of two given types is true.
 
@@ -493,7 +493,7 @@ type Or<A$1 extends boolean, B$1 extends boolean> = _Or<If<IsNever<A$1>, false,
 
 type _Or<A$1 extends boolean, B$1 extends boolean> = A$1 extends true ? true : B$1 extends true ? true : false;
 //#endregion
-//#region node_modules/.pnpm/type-fest@5.4.2/node_modules/type-fest/source/all-extend.d.ts
+//#region node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/all-extend.d.ts
 /**
 @see {@link AllExtend}
 */
@@ -581,7 +581,7 @@ type _AllExtend<TArray extends UnknownArray, Type$1, Options extends Required<Al
 // If target `Type` is also `never` OR `strictNever` is disabled, recurse further.
 ? _AllExtend<Rest, Type$1, Options> : false : First extends Type$1 ? _AllExtend<Rest, Type$1, Options> : false : true>, false, false>;
 //#endregion
-//#region node_modules/.pnpm/type-fest@5.4.2/node_modules/type-fest/source/and.d.ts
+//#region node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/and.d.ts
 /**
 Returns a boolean for whether two given types are both true.
 
@@ -660,7 +660,7 @@ type G = And<never, never>;
 */
 type And<A$1 extends boolean, B$1 extends boolean> = AllExtend<[A$1, B$1], true>;
 //#endregion
-//#region node_modules/.pnpm/type-fest@5.4.2/node_modules/type-fest/source/union-to-tuple.d.ts
+//#region node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/union-to-tuple.d.ts
 /**
 Returns the last element of a union type.
 
@@ -709,7 +709,7 @@ const petList = Object.keys(pets) as UnionToTuple<Pet>;
 */
 type UnionToTuple<T, L = LastOfUnion<T>> = IsNever<T> extends false ? [...UnionToTuple<Exclude<T, L>>, L] : [];
 //#endregion
-//#region node_modules/.pnpm/type-fest@5.4.2/node_modules/type-fest/source/set-optional.d.ts
+//#region node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/set-optional.d.ts
 /**
 Create a type that makes the given keys optional. The remaining keys are kept as is. The sister of the `SetRequired` type.
 
@@ -743,7 +743,7 @@ Except<BaseType, Keys> &
 // Pick the keys that should be mutable from the base type and make them mutable.
 Partial<HomomorphicPick<BaseType, Keys>>> : never;
 //#endregion
-//#region node_modules/.pnpm/type-fest@5.4.2/node_modules/type-fest/source/value-of.d.ts
+//#region node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/value-of.d.ts
 /**
 Create a union of the given object's values, and optionally specify which keys to get the values from.
 
@@ -767,7 +767,7 @@ type C = ValueOf<{id: number; name: string; active: boolean}, 'id' | 'name'>;
 */
 type ValueOf<ObjectType, ValueType extends keyof ObjectType = keyof ObjectType> = ObjectType[ValueType];
 //#endregion
-//#region node_modules/.pnpm/type-fest@5.4.2/node_modules/type-fest/source/split.d.ts
+//#region node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/split.d.ts
 /**
 Split options.
 
@@ -826,7 +826,7 @@ type SplitHelper<S extends string, Delimiter extends string, Options extends Req
 : string[] : never // Should never happen
 : never; // Should never happen
 //#endregion
-//#region node_modules/.pnpm/type-fest@5.4.2/node_modules/type-fest/source/replace.d.ts
+//#region node_modules/.pnpm/type-fest@5.4.3/node_modules/type-fest/source/replace.d.ts
 type ReplaceOptions = {
   all?: boolean;
 };
@@ -1278,13 +1278,19 @@ declare function isWithinInterval(input: number, interval: [number, number], inc
 //#endregion
 //#region src/utils/object/cloneDeep.d.ts
 interface CloningStrategy {
-  cloneMap: <K$1, V$1>(parent: Map<K$1, V$1>, track: (newParent: Map<K$1, V$1>) => Map<K$1, V$1>, clone: <T>(value: T) => T) => Map<K$1, V$1> | null;
-  cloneSet: <T>(parent: Set<T>, track: (newParent: Set<T>) => Set<T>, clone: <T>(value: T) => T) => Set<T> | null;
-  cloneDate: (parent: Date, track: (newParent: Date) => Date, clone: <T>(value: T) => T) => Date | null;
-  cloneArray: <T>(parent: readonly T[], track: (newParent: T[]) => T[], clone: <T>(value: T) => T) => T[] | null;
-  cloneObject: <T extends AnyObject>(parent: T, track: (newParent: T) => T, clone: <T>(value: T) => T) => T | null;
-  cloneOther: <T>(parent: T, track: (newParent: T) => T, clone: <T>(value: T) => T) => T | null;
+  cloneMap: typeof cloneMap;
+  cloneSet: typeof cloneSet;
+  cloneDate: typeof cloneDate;
+  cloneArray: typeof cloneArray;
+  cloneObject: typeof cloneObject;
+  cloneOther: typeof cloneOther;
 }
+declare function cloneMap<K$1, V$1>(input: Map<K$1, V$1>, track: (newParent: Map<K$1, V$1>) => Map<K$1, V$1>, clone: <T>(value: T) => T): Map<K$1, V$1>;
+declare function cloneSet<T>(input: Set<T>, track: (newParent: Set<T>) => Set<T>, clone: <T>(value: T) => T): Set<T>;
+declare function cloneDate(input: Date, track: (newParent: Date) => Date): Date;
+declare function cloneArray<T>(input: readonly T[], track: (newParent: T[]) => T[], clone: <T>(value: T) => T): T[];
+declare function cloneObject<T extends AnyObject>(input: T, track: (newParent: T) => T, clone: <T>(value: T) => T): T;
+declare function cloneOther<T>(input: T, track: (newParent: T) => T): T;
 /**
  * 深度拷贝对象
  * - 支持 Array, Object, Map, Set
@@ -3133,22 +3139,35 @@ declare function isClass(value: unknown): value is Class<AnyObject>;
 //#endregion
 //#region src/utils/typeof/isDate.d.ts
 /**
- * 检查 value 是否为有效 Date 对象
+ * 检查 value 是否为 Date 对象
+ *
  * @param value 待检查值
- * @returns 是否为有效 Date
+ * @param invalidCheck 是否要求日期有效（非 Invalid Date）。默认 true
+ *   - true: 仅当是有效 Date 对象时返回 true（排除 new Date('invalid')）
+ *   - false: 只要 [[Prototype]] 是 Date 即返回 true（包含 Invalid Date）
+ * @returns 是否为 Date 对象，根据 invalidCheck 返回不同语义的 Date 判定
+ *
+ * @example
+ * ```ts
+ * isDate(new Date()); // true
+ * isDate(new Date('invalid')); // false
+ * isDate(new Date('invalid'), false); // true
+ * isDate(null); // false
+ * isDate({}); // false
+ * ```
  */
-declare function isDate(value: unknown): value is Date;
+declare function isDate(value: unknown, invalidCheck?: boolean): value is Date;
 //#endregion
 //#region src/utils/typeof/isEnumeration.d.ts
 /**
- * 判断一个值是否为有效的枚举对象
+ * 判断一个值是否为有效的枚举
  * - 枚举不能为空
  * - 枚举所有的值必须是 string 或 number
  *
- * @param obj
- * @returns
+ * @param enumeration 待检查值
+ * @returns 是否为有效的枚举
  */
-declare function isEnumeration(obj: unknown): [boolean, boolean];
+declare function isEnumeration(enumeration: unknown): [boolean, boolean];
 //#endregion
 //#region src/utils/typeof/isEqual.d.ts
 /**
@@ -3244,7 +3263,7 @@ declare function isNull(value: unknown): value is null;
  * 检查 value 是否为 number 类型
  *
  * @param value 待检查值
- * @param checkNaN 是否排除 `NaN`，默认为 `true`
+ * @param NaNCheck 是否排除 `NaN`，默认为 `true`
  * @returns 是否为 number
  * @example
  * ```ts
@@ -3253,7 +3272,7 @@ declare function isNull(value: unknown): value is null;
  * isNumber(NaN, false); // true
  * ```
  */
-declare function isNumber(value: unknown, checkNaN?: boolean): value is number;
+declare function isNumber(value: unknown, NaNCheck?: boolean): value is number;
 /**
  * 检查 value 是否为 NaN
  *