@pawover/kit 0.0.0-beta.4 → 0.0.0-beta.41

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

@@ -0,0 +1 @@
+{"version":3,"file":"except-MacUK44u.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.4/node_modules/type-fest/source/union-to-intersection.d.ts","../node_modules/.pnpm/type-fest@5.4.4/node_modules/type-fest/source/keys-of-union.d.ts","../node_modules/.pnpm/type-fest@5.4.4/node_modules/type-fest/source/is-any.d.ts","../node_modules/.pnpm/type-fest@5.4.4/node_modules/type-fest/source/is-optional-key-of.d.ts","../node_modules/.pnpm/type-fest@5.4.4/node_modules/type-fest/source/optional-keys-of.d.ts","../node_modules/.pnpm/type-fest@5.4.4/node_modules/type-fest/source/required-keys-of.d.ts","../node_modules/.pnpm/type-fest@5.4.4/node_modules/type-fest/source/is-never.d.ts","../node_modules/.pnpm/type-fest@5.4.4/node_modules/type-fest/source/if.d.ts","../node_modules/.pnpm/type-fest@5.4.4/node_modules/type-fest/source/unknown-array.d.ts","../node_modules/.pnpm/type-fest@5.4.4/node_modules/type-fest/source/internal/type.d.ts","../node_modules/.pnpm/type-fest@5.4.4/node_modules/type-fest/source/simplify.d.ts","../node_modules/.pnpm/type-fest@5.4.4/node_modules/type-fest/source/is-equal.d.ts","../node_modules/.pnpm/type-fest@5.4.4/node_modules/type-fest/source/omit-index-signature.d.ts","../node_modules/.pnpm/type-fest@5.4.4/node_modules/type-fest/source/pick-index-signature.d.ts","../node_modules/.pnpm/type-fest@5.4.4/node_modules/type-fest/source/merge.d.ts","../node_modules/.pnpm/type-fest@5.4.4/node_modules/type-fest/source/internal/object.d.ts","../node_modules/.pnpm/type-fest@5.4.4/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":"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"}

package/dist/hooks-alova.d.ts

@@ -1,23 +1,32 @@
 import * as alova_client0 from "alova/client";
-import { AlovaFrontMiddlewareContext, AlovaMethodHandler, CompleteHandler, ErrorHandler, RequestHookConfig, SuccessHandler, WatcherHookConfig } from "alova/client";
+import { AlovaFrontMiddlewareContext, AlovaMethodHandler, CompleteHandler, ErrorHandler, PaginationHookConfig, RequestHookConfig, SuccessHandler, WatcherHookConfig } from "alova/client";
 import { AlovaGenerics, Method } from "alova";
 
+//#region src/hooks/alova/useAlovaPagination.d.ts
+interface HookOptions$2<AG extends AlovaGenerics, L extends any[], Args extends any[]> extends PaginationHookConfig<AG, L> {
+  onBeforeRequest?: ((context: AlovaFrontMiddlewareContext<AG, any[]>) => void) | undefined;
+  onSuccess?: SuccessHandler<AG, Args> | undefined;
+  onError?: ErrorHandler<AG, Args> | undefined;
+  onComplete?: CompleteHandler<AG, Args> | undefined;
+}
+declare function useAlovaPagination<AG extends AlovaGenerics, L extends any[], Args extends any[]>(methodHandler: (page: number, pageSize: number, ...args: Args) => Method<AG>, hookOptions?: HookOptions$2<AG, L, Args> | undefined): alova_client0.UsePaginationExposure<AG, L, Args>;
+//#endregion
 //#region src/hooks/alova/useAlovaRequest.d.ts
-interface HookConfig$1<AG extends AlovaGenerics, Args extends any[]> extends RequestHookConfig<AG, Args> {
-  onBeforeRequest?: (context: AlovaFrontMiddlewareContext<AG, Args>) => void;
-  onSuccess?: SuccessHandler<AG, Args>;
-  onError?: ErrorHandler<AG, Args>;
-  onComplete?: CompleteHandler<AG, Args>;
+interface HookOptions$1<AG extends AlovaGenerics, Args extends any[]> extends RequestHookConfig<AG, Args> {
+  onBeforeRequest?: ((context: AlovaFrontMiddlewareContext<AG, Args>) => void) | undefined;
+  onSuccess?: SuccessHandler<AG, Args> | undefined;
+  onError?: ErrorHandler<AG, Args> | undefined;
+  onComplete?: CompleteHandler<AG, Args> | undefined;
 }
-declare function useAlovaRequest<AG extends AlovaGenerics, Args extends any[] = any[]>(methodHandler: Method<AG> | AlovaMethodHandler<AG, Args>, hookConfig?: HookConfig$1<AG, Args> | undefined): alova_client0.UseHookExposure<AG, Args, unknown>;
+declare function useAlovaRequest<AG extends AlovaGenerics, Args extends any[] = any[]>(methodHandler: Method<AG> | AlovaMethodHandler<AG, Args>, hookOptions?: HookOptions$1<AG, Args> | undefined): alova_client0.UseHookExposure<AG, Args, unknown>;
 //#endregion
 //#region src/hooks/alova/useAlovaWatcher.d.ts
-interface HookConfig<AG extends AlovaGenerics, Args extends any[]> extends WatcherHookConfig<AG, Args> {
-  onSuccess?: SuccessHandler<AG, Args>;
-  onError?: ErrorHandler<AG, Args>;
-  onComplete?: CompleteHandler<AG, Args>;
+interface HookOptions<AG extends AlovaGenerics, Args extends any[]> extends WatcherHookConfig<AG, Args> {
+  onSuccess?: SuccessHandler<AG, Args> | undefined;
+  onError?: ErrorHandler<AG, Args> | undefined;
+  onComplete?: CompleteHandler<AG, Args> | undefined;
 }
-declare function useAlovaWatcher<AG extends AlovaGenerics, Args extends any[] = any[]>(methodHandler: Method<AG> | AlovaMethodHandler<AG, Args>, watchingStates: AG["StatesExport"]["Watched"][], hookConfig?: HookConfig<AG, Args>): alova_client0.UseHookExposure<AG, Args, unknown>;
+declare function useAlovaWatcher<AG extends AlovaGenerics, Args extends any[] = any[]>(methodHandler: Method<AG> | AlovaMethodHandler<AG, Args>, watchingStates: AG["StatesExport"]["Watched"][], hookOptions?: HookOptions<AG, Args>): alova_client0.UseHookExposure<AG, Args, unknown>;
 //#endregion
-export { useAlovaRequest, useAlovaWatcher };
+export { useAlovaPagination, useAlovaRequest, useAlovaWatcher };
 //# sourceMappingURL=hooks-alova.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"hooks-alova.d.ts","names":[],"sources":["../src/hooks/alova/useAlovaRequest.ts","../src/hooks/alova/useAlovaWatcher.ts"],"sourcesContent":[],"mappings":";;;;;UAaU,wBAAsB,2CAA2C,kBAAkB,IAAI;8BACnE,4BAA4B,IAAI;cAChD,eAAe,IAAI;EAFvB,OAAA,CAAA,EAGE,YAHQ,CAGK,EAHL,EAGS,IAHT,CAAA;EAAY,UAAA,CAAA,EAIjB,eAJiB,CAID,EAJC,EAIG,IAJH,CAAA;;AAAiE,iBAOjF,eAPiF,CAAA,WAOtD,aAPsD,EAAA,aAAA,GAAA,EAAA,GAAA,GAAA,EAAA,CAAA,CAAA,aAAA,EAQhF,MARgF,CAQzE,EARyE,CAAA,GAQnE,kBARmE,CAQhD,EARgD,EAQ5C,IAR4C,CAAA,EAAA,UAAA,CAAA,EASlF,YATkF,CASvE,EATuE,EASnE,IATmE,CAAA,GAAA,SAAA,CAAA,EASlD,aAAA,CAAA,eATkD,CASlD,EATkD,EASlD,IATkD,EAAA,OAAA,CAAA;;;UCDvF,sBAAsB,2CAA2C,kBAAkB,IAAI;cACnF,eAAe,IAAI;YACrB,aAAa,IAAI;EDDnB,UAAA,CAAA,ECEK,eDFK,CCEW,EDFX,ECEe,IDFf,CAAA;;AAAyE,iBCK7E,eDL6E,CAAA,WCKlD,aDLkD,EAAA,aAAA,GAAA,EAAA,GAAA,GAAA,EAAA,CAAA,CAAA,aAAA,ECM5E,MDN4E,CCMrE,EDNqE,CAAA,GCM/D,kBDN+D,CCM5C,EDN4C,ECMxC,IDNwC,CAAA,EAAA,cAAA,ECO3E,EDP2E,CAAA,cAAA,CAAA,CAAA,SAAA,CAAA,EAAA,EAAA,UAAA,CAAA,ECQ/E,UDR+E,CCQpE,EDRoE,ECQhE,IDRgE,CAAA,CAAA,ECQtD,aAAA,CAAA,eDRsD,CCQtD,EDRsD,ECQtD,IDRsD,EAAA,OAAA,CAAA"}
+{"version":3,"file":"hooks-alova.d.ts","names":[],"sources":["../src/hooks/alova/useAlovaPagination.ts","../src/hooks/alova/useAlovaRequest.ts","../src/hooks/alova/useAlovaWatcher.ts"],"sourcesContent":[],"mappings":";;;;;UAYU,yBAAuB,4DAA4D,qBAAqB,IAAI;+BACvF,4BAA4B;cAC7C,eAAe,IAAI;EAFvB,OAAA,CAAA,EAGE,YAHS,CAGI,EAHJ,EAGQ,IAHR,CAAA,GAAA,SAAA;EAAY,UAAA,CAAA,EAIlB,eAJkB,CAIF,EAJE,EAIE,IAJF,CAAA,GAAA,SAAA;;AAAqF,iBAOtG,kBAPsG,CAAA,WAOxE,aAPwE,EAAA,UAAA,GAAA,EAAA,EAAA,aAAA,GAAA,EAAA,CAAA,CAAA,aAAA,EAAA,CAAA,IAAA,EAAA,MAAA,EAAA,QAAA,EAAA,MAAA,EAAA,GAAA,IAAA,EAQ3D,IAR2D,EAAA,GAQlD,MARkD,CAQ3C,EAR2C,CAAA,EAAA,WAAA,CAAA,EAStG,aATsG,CAS1F,EAT0F,EAStF,CATsF,EASnF,IATmF,CAAA,GAAA,SAAA,CAAA,EASlE,aAAA,CAAA,qBATkE,CASlE,EATkE,EASlE,CATkE,EASlE,IATkE,CAAA;;;UCC5G,yBAAuB,2CAA2C,kBAAkB,IAAI;+BACnE,4BAA4B,IAAI;cACjD,eAAe,IAAI;EDHvB,OAAA,CAAA,ECIE,YDJS,CCII,EDJJ,ECIQ,IDJR,CAAA,GAAA,SAAA;EAAY,UAAA,CAAA,ECKlB,eDLkB,CCKF,EDLE,ECKE,IDLF,CAAA,GAAA,SAAA;;AAAqF,iBCQtG,eDRsG,CAAA,WCQ3E,aDR2E,EAAA,aAAA,GAAA,EAAA,GAAA,GAAA,EAAA,CAAA,CAAA,aAAA,ECSrG,MDTqG,CCS9F,EDT8F,CAAA,GCSxF,kBDTwF,CCSrE,EDTqE,ECSjE,IDTiE,CAAA,EAAA,WAAA,CAAA,ECUtG,aDVsG,CCU1F,EDV0F,ECUtF,IDVsF,CAAA,GAAA,SAAA,CAAA,ECUrE,aAAA,CAAA,eDVqE,CCUrE,EDVqE,ECUrE,IDVqE,EAAA,OAAA,CAAA;;;UEA5G,uBAAuB,2CAA2C,kBAAkB,IAAI;cACpF,eAAe,IAAI;YACrB,aAAa,IAAI;EFFnB,UAAA,CAAA,EEGK,eFHM,CEGU,EFHV,EEGc,IFHd,CAAA,GAAA,SAAA;;AAA6F,iBEMlG,eFNkG,CAAA,WEMvE,aFNuE,EAAA,aAAA,GAAA,EAAA,GAAA,GAAA,EAAA,CAAA,CAAA,aAAA,EEOjG,MFPiG,CEO1F,EFP0F,CAAA,GEOpF,kBFPoF,CEOjE,EFPiE,EEO7D,IFP6D,CAAA,EAAA,cAAA,EEQhG,EFRgG,CAAA,cAAA,CAAA,CAAA,SAAA,CAAA,EAAA,EAAA,WAAA,CAAA,EESnG,WFTmG,CESvF,EFTuF,EESnF,IFTmF,CAAA,CAAA,EESzE,aAAA,CAAA,eFTyE,CESzE,EFTyE,EESzE,IFTyE,EAAA,OAAA,CAAA"}

package/dist/hooks-alova.js

@@ -1,39 +1,69 @@
-import { useRequest, useWatcher } from "alova/client";
+import { usePagination, useRequest, useWatcher } from "alova/client";
 
+//#region src/hooks/alova/useAlovaPagination.ts
+function useAlovaPagination(methodHandler, hookOptions) {
+	const options = {
+		...hookOptions,
+		immediate: hookOptions?.immediate ?? true
+	};
+	let isBeforeExecuted = false;
+	let isMiddlewareExecuted = false;
+	if (options.onBeforeRequest) {
+		const middleware = options.middleware;
+		options.middleware = async (context, next) => {
+			!isBeforeExecuted && options.onBeforeRequest?.(context);
+			isBeforeExecuted = true;
+			if (middleware && !isMiddlewareExecuted) {
+				isMiddlewareExecuted = true;
+				await middleware?.(context, next);
+			} else await next();
+		};
+	}
+	const exposure = usePagination(methodHandler, options);
+	if (options.onSuccess) exposure.onSuccess(options.onSuccess);
+	if (options.onError) exposure.onError(options.onError);
+	if (options.onComplete) exposure.onComplete(options.onComplete);
+	return exposure;
+}
+
+//#endregion
 //#region src/hooks/alova/useAlovaRequest.ts
-function useAlovaRequest(methodHandler, hookConfig) {
-	const config = hookConfig || {};
-	config.immediate ?? (config.immediate = true);
-	if (config.onBeforeRequest) {
-		const middleware = config.middleware;
-		config.middleware = async (context, next) => {
-			config.onBeforeRequest?.(context);
-			if (middleware) {
-				async function run() {
-					await next();
-				}
-				await middleware?.(context, run);
+function useAlovaRequest(methodHandler, hookOptions) {
+	const options = {
+		...hookOptions,
+		immediate: hookOptions?.immediate ?? true
+	};
+	let isBeforeExecuted = false;
+	let isMiddlewareExecuted = false;
+	if (options.onBeforeRequest) {
+		const middleware = options.middleware;
+		options.middleware = async (context, next) => {
+			!isBeforeExecuted && options.onBeforeRequest?.(context);
+			isBeforeExecuted = true;
+			if (middleware && !isMiddlewareExecuted) {
+				isMiddlewareExecuted = true;
+				await middleware?.(context, next);
 			} else await next();
 		};
 	}
-	const exposure = useRequest(methodHandler, config);
-	if (config.onSuccess) exposure.onSuccess(config.onSuccess);
-	if (config.onError) exposure.onError(config.onError);
-	if (config.onComplete) exposure.onComplete(config.onComplete);
+	const exposure = useRequest(methodHandler, options);
+	if (options.onSuccess) exposure.onSuccess(options.onSuccess);
+	if (options.onError) exposure.onError(options.onError);
+	if (options.onComplete) exposure.onComplete(options.onComplete);
 	return exposure;
 }
 
 //#endregion
 //#region src/hooks/alova/useAlovaWatcher.ts
-function useAlovaWatcher(methodHandler, watchingStates, hookConfig = {}) {
-	const config = hookConfig || {};
-	const exposure = useWatcher(methodHandler, watchingStates, config);
-	if (config.onSuccess) exposure.onSuccess(config.onSuccess);
-	if (config.onError) exposure.onError(config.onError);
-	if (config.onComplete) exposure.onComplete(config.onComplete);
+function useAlovaWatcher(methodHandler, watchingStates, hookOptions = {}) {
+	const options = hookOptions || {};
+	const exposure = useWatcher(methodHandler, watchingStates, options);
+	if (options.onSuccess) exposure.onSuccess(options.onSuccess);
+	if (options.onError) exposure.onError(options.onError);
+	if (options.onComplete) exposure.onComplete(options.onComplete);
 	return exposure;
 }
 
 //#endregion
-export { useAlovaRequest, useAlovaWatcher };
+export { useAlovaPagination, useAlovaRequest, useAlovaWatcher };
 //# sourceMappingURL=hooks-alova.js.map

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/useAlovaPagination.ts","../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  usePagination,\n  type AlovaFrontMiddlewareContext,\n  type CompleteHandler,\n  type ErrorHandler,\n  type PaginationHookConfig,\n  type SuccessHandler,\n} from \"alova/client\";\n\ninterface HookOptions<AG extends AlovaGenerics, L extends any[], Args extends any[]> extends PaginationHookConfig<AG, L> {\n  onBeforeRequest?: ((context: AlovaFrontMiddlewareContext<AG, any[]>) => void) | undefined;\n  onSuccess?: SuccessHandler<AG, Args> | undefined;\n  onError?: ErrorHandler<AG, Args> | undefined;\n  onComplete?: CompleteHandler<AG, Args> | undefined;\n}\n\nexport function useAlovaPagination<AG extends AlovaGenerics, L extends any[], Args extends any[]> (\n  methodHandler: (page: number, pageSize: number, ...args: Args) => Method<AG>,\n  hookOptions?: HookOptions<AG, L, Args> | undefined,\n) {\n  const options = { ...hookOptions, immediate: hookOptions?.immediate ?? true };\n  let isBeforeExecuted = false;\n  let isMiddlewareExecuted = false;\n\n  if (options.onBeforeRequest) {\n    const middleware = options.middleware;\n    options.middleware = async (context, next) => {\n      !isBeforeExecuted && options.onBeforeRequest?.(context);\n      isBeforeExecuted = true;\n\n      if (middleware && !isMiddlewareExecuted) {\n        isMiddlewareExecuted = true;\n        await middleware?.(context, next);\n      } else {\n        await next();\n      }\n    };\n  }\n\n  const exposure = usePagination(methodHandler, options);\n\n  if (options.onSuccess) {\n    exposure.onSuccess(options.onSuccess);\n  }\n  if (options.onError) {\n    exposure.onError(options.onError);\n  }\n  if (options.onComplete) {\n    exposure.onComplete(options.onComplete);\n  }\n\n  return exposure;\n}\n","/* 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 HookOptions<AG extends AlovaGenerics, Args extends any[]> extends RequestHookConfig<AG, Args> {\n  onBeforeRequest?: ((context: AlovaFrontMiddlewareContext<AG, Args>) => void) | undefined;\n  onSuccess?: SuccessHandler<AG, Args> | undefined;\n  onError?: ErrorHandler<AG, Args> | undefined;\n  onComplete?: CompleteHandler<AG, Args> | undefined;\n}\n\nexport function useAlovaRequest<AG extends AlovaGenerics, Args extends any[] = any[]> (\n  methodHandler: Method<AG> | AlovaMethodHandler<AG, Args>,\n  hookOptions?: HookOptions<AG, Args> | undefined,\n) {\n  const options = { ...hookOptions, immediate: hookOptions?.immediate ?? true };\n  let isBeforeExecuted = false;\n  let isMiddlewareExecuted = false;\n\n  if (options.onBeforeRequest) {\n    const middleware = options.middleware;\n    options.middleware = async (context, next) => {\n      !isBeforeExecuted && options.onBeforeRequest?.(context);\n      isBeforeExecuted = true;\n\n      if (middleware && !isMiddlewareExecuted) {\n        isMiddlewareExecuted = true;\n        await middleware?.(context, next);\n      } else {\n        await next();\n      }\n    };\n  }\n\n  const exposure = useRequest(methodHandler, options);\n\n  if (options.onSuccess) {\n    exposure.onSuccess(options.onSuccess);\n  }\n  if (options.onError) {\n    exposure.onError(options.onError);\n  }\n  if (options.onComplete) {\n    exposure.onComplete(options.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 HookOptions<AG extends AlovaGenerics, Args extends any[]> extends WatcherHookConfig<AG, Args> {\n  onSuccess?: SuccessHandler<AG, Args> | undefined;\n  onError?: ErrorHandler<AG, Args> | undefined;\n  onComplete?: CompleteHandler<AG, Args> | undefined;\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  hookOptions: HookOptions<AG, Args> = {},\n) {\n  const options = hookOptions || {};\n  const exposure = useWatcher(methodHandler, watchingStates, options);\n\n  if (options.onSuccess) {\n    exposure.onSuccess(options.onSuccess);\n  }\n  if (options.onError) {\n    exposure.onError(options.onError);\n  }\n  if (options.onComplete) {\n    exposure.onComplete(options.onComplete);\n  }\n\n  return exposure;\n}\n"],"mappings":";;;AAmBA,SAAgB,mBACd,eACA,aACA;CACA,MAAM,UAAU;EAAE,GAAG;EAAa,WAAW,aAAa,aAAa;EAAM;CAC7E,IAAI,mBAAmB;CACvB,IAAI,uBAAuB;AAE3B,KAAI,QAAQ,iBAAiB;EAC3B,MAAM,aAAa,QAAQ;AAC3B,UAAQ,aAAa,OAAO,SAAS,SAAS;AAC5C,IAAC,oBAAoB,QAAQ,kBAAkB,QAAQ;AACvD,sBAAmB;AAEnB,OAAI,cAAc,CAAC,sBAAsB;AACvC,2BAAuB;AACvB,UAAM,aAAa,SAAS,KAAK;SAEjC,OAAM,MAAM;;;CAKlB,MAAM,WAAW,cAAc,eAAe,QAAQ;AAEtD,KAAI,QAAQ,UACV,UAAS,UAAU,QAAQ,UAAU;AAEvC,KAAI,QAAQ,QACV,UAAS,QAAQ,QAAQ,QAAQ;AAEnC,KAAI,QAAQ,WACV,UAAS,WAAW,QAAQ,WAAW;AAGzC,QAAO;;;;;AClCT,SAAgB,gBACd,eACA,aACA;CACA,MAAM,UAAU;EAAE,GAAG;EAAa,WAAW,aAAa,aAAa;EAAM;CAC7E,IAAI,mBAAmB;CACvB,IAAI,uBAAuB;AAE3B,KAAI,QAAQ,iBAAiB;EAC3B,MAAM,aAAa,QAAQ;AAC3B,UAAQ,aAAa,OAAO,SAAS,SAAS;AAC5C,IAAC,oBAAoB,QAAQ,kBAAkB,QAAQ;AACvD,sBAAmB;AAEnB,OAAI,cAAc,CAAC,sBAAsB;AACvC,2BAAuB;AACvB,UAAM,aAAa,SAAS,KAAK;SAEjC,OAAM,MAAM;;;CAKlB,MAAM,WAAW,WAAW,eAAe,QAAQ;AAEnD,KAAI,QAAQ,UACV,UAAS,UAAU,QAAQ,UAAU;AAEvC,KAAI,QAAQ,QACV,UAAS,QAAQ,QAAQ,QAAQ;AAEnC,KAAI,QAAQ,WACV,UAAS,WAAW,QAAQ,WAAW;AAGzC,QAAO;;;;;ACrCT,SAAgB,gBACd,eACA,gBACA,cAAqC,EAAE,EACvC;CACA,MAAM,UAAU,eAAe,EAAE;CACjC,MAAM,WAAW,WAAW,eAAe,gBAAgB,QAAQ;AAEnE,KAAI,QAAQ,UACV,UAAS,UAAU,QAAQ,UAAU;AAEvC,KAAI,QAAQ,QACV,UAAS,QAAQ,QAAQ,QAAQ;AAEnC,KAAI,QAAQ,WACV,UAAS,WAAW,QAAQ,WAAW;AAGzC,QAAO"}

package/dist/hooks-react.d.ts

@@ -1,14 +1,69 @@
+import { s as BREAK_POINT_TOKEN_TYPE } from "./index-Bn_PNnsM.js";
+import { r as AnyFunction, t as AnyAsyncFunction } from "./index-DBPmnr4a.js";
 import { DependencyList, EffectCallback, RefObject } from "react";
 
-//#region src/hooks/react/useCreation.d.ts
+//#region node_modules/.pnpm/type-fest@5.4.4/node_modules/type-fest/source/tuple-to-union.d.ts
 
+/**
+Convert a tuple/array into a union type of its elements.
+
+This can be useful when you have a fixed set of allowed values and want a type defining only the allowed values, but do not want to repeat yourself.
+
+@example
+```
+import type {TupleToUnion} from 'type-fest';
+
+const destinations = ['a', 'b', 'c'] as const;
+
+type Destination = TupleToUnion<typeof destinations>;
+//=> 'a' | 'b' | 'c'
+
+function verifyDestination(destination: unknown): destination is Destination {
+	return destinations.includes(destination as any);
+}
+
+type RequestBody = {
+	deliverTo: Destination;
+};
+
+function verifyRequestBody(body: unknown): body is RequestBody {
+	const {deliverTo} = (body as any);
+	return typeof body === 'object' && body !== null && verifyDestination(deliverTo);
+}
+```
+
+Alternatively, you may use `typeof destinations[number]`. If `destinations` is a tuple, there is no difference. However if `destinations` is a string, the resulting type will the union of the characters in the string. Other types of `destinations` may result in a compile error. In comparison, TupleToUnion will return `never` if a tuple is not provided.
+
+@example
+```
+const destinations = ['a', 'b', 'c'] as const;
+
+type Destination = typeof destinations[number];
+//=> 'a' | 'b' | 'c'
+
+const erroringType = new Set(['a', 'b', 'c']);
+
+// @ts-expect-error
+type ErroringType = typeof erroringType[number];
+// Error: Type 'Set<string>' has no matching index signature for type 'number'. ts(2537)
+
+const numberBool: {[n: number]: boolean} = {1: true};
+
+type NumberBool = typeof numberBool[number];
+//=> boolean
+```
+
+@category Array
+*/
+type TupleToUnion<ArrayType> = ArrayType extends readonly unknown[] ? ArrayType[number] : never;
+//#endregion
+//#region src/hooks/react/useCreation.d.ts
 /**
  * useCreation
  * @reference https://ahooks.js.org/zh-CN/hooks/use-creation
  *
- * @template T
- * @param {() => T} factory
- * @param {DependencyList} deps
+ * @param factory
+ * @param deps
  */
 declare function useCreation<T>(factory: () => T, deps: DependencyList): T;
 //#endregion
@@ -17,8 +72,7 @@ declare function useCreation<T>(factory: () => T, deps: DependencyList): T;
  * 返回当前最新值的 Hook
  * @reference https://ahooks.js.org/zh-CN/hooks/use-latest
  *
- * @template T
- * @param {T} value
+ * @param value
  */
 declare function useLatest<T>(value: T): RefObject<T>;
 //#endregion
@@ -27,63 +81,49 @@ type MountCallback = EffectCallback | AnyAsyncFunction;
 /**
  * 在组件初始化时执行的 Hook
  * - 即使在严格模式下也只执行一次
- * @reference https://ahooks.js.org/hooks/use-mount
  *
- * @param {MountCallback} effect 副作用函数
+ * @param effect 副作用函数
  */
 declare function useMount(effect: MountCallback): void;
 //#endregion
-//#region src/enums/grid.d.ts
-type BREAK_POINT_TOKEN_TYPE = Record<keyof typeof BREAK_POINT_TOKEN_ENUM, number>;
-/** 屏幕响应断点 token 配置 */
-declare const BREAK_POINT_TOKEN_ENUM: {
-  readonly XS: 576;
-  readonly XSMin: 576;
-  readonly XSMax: 767;
-  readonly SM: 768;
-  readonly SMMin: 768;
-  readonly SMMax: 991;
-  readonly MD: 992;
-  readonly MDMin: 992;
-  readonly MDMax: 1199;
-  readonly LG: 1200;
-  readonly LGMin: 1200;
-  readonly LGMax: 1599;
-  readonly XL: 1600;
-  readonly XLMin: 1600;
-  readonly XLMax: 1919;
-  readonly XXL: 1920;
-  readonly XXLMin: 1920;
-};
-//#endregion
 //#region src/hooks/react/useResponsive.d.ts
-type Breakpoint = "xxl" | "xl" | "lg" | "md" | "sm" | "xs";
+type Breakpoint = TupleToUnion<typeof tuple>;
 type ResponsiveValues = Record<Breakpoint, boolean>;
+declare const tuple: readonly ["xxxl", "xxl", "xl", "lg", "md", "sm", "xs"];
 interface ResponsiveHookOptions {
-  /**
-   * 紧凑布局断点
-   * - 低于此断点时使用紧凑布局
-   * @default "xl"
-   */
-  compactBreakPoint?: Breakpoint;
   /** 屏幕响应断点 token 配置 */
   breakPointTokens?: BREAK_POINT_TOKEN_TYPE;
 }
 declare function useResponsive(options?: ResponsiveHookOptions): {
   responsive: ResponsiveValues;
-  current: Breakpoint;
-  isCompact: boolean;
+  current: "xxxl" | "xxl" | "xl" | "lg" | "md" | "sm" | "xs";
   breakPointTokens: BREAK_POINT_TOKEN_TYPE;
 };
 //#endregion
+//#region src/hooks/react/useTitle.d.ts
+interface TitleHookOptions {
+  /** 件卸载时是否恢复原始标题 */
+  isRestoreOnUnmount?: boolean;
+}
+/**
+ * 设置页面标题
+ * - 轻量级，适用于无路由库时设置页面标题
+ * - 多个 `useTitle` 实例会互相干扰，需在顶层组件使用
+ * - 无法处理 `document.title` 固有的竞态问题
+ *
+ * @param title 页面标题
+ * @param options 配置选项
+ */
+declare function useTitle(title: string, options?: TitleHookOptions | undefined): void;
+//#endregion
 //#region src/hooks/react/useUnmount.d.ts
 /**
  * 在组件卸载时执行的 Hook
  * @reference https://ahooks.js.org/zh-CN/hooks/use-unmount
  *
- * @param {AnyFunction} effect 副作用函数
+ * @param effect 副作用函数
  */
 declare function useUnmount(effect: AnyFunction): void;
 //#endregion
-export { ResponsiveHookOptions, useCreation, useLatest, useMount, useResponsive, useUnmount };
+export { ResponsiveHookOptions, useCreation, useLatest, useMount, useResponsive, useTitle, useUnmount };
 //# sourceMappingURL=hooks-react.d.ts.map

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/enums/grid.ts","../src/hooks/react/useResponsive.ts","../src/hooks/react/useUnmount.ts"],"sourcesContent":[],"mappings":";;;;;;AAiBA;;;;;;iBAAgB,8BAA8B,SAAS,iBAAc;;;;;AAArE;;;;;iBCRgB,oBAAoB,IAAI,UAAU;;;KCL7C,aAAA,GAAgB,iBAAiB;;AFatC;;;;;;iBEJgB,QAAA,SAAiB;;;KCbrB,sBAAA,GAAyB,oBAAoB;;cAE5C;EHeG,SAAA,EAAA,EAAA,GAAW;EAAmB,SAAA,KAAA,EAAA,GAAA;EAAS,SAAA,KAAA,EAAA,GAAA;EAAc,SAAA,EAAA,EAAA,GAAA;EAAA,SAAA,KAAA,EAAA,GAAA;;;;ECRrD,SAAA,KAAS,EAAA,IAAA;EAAW,SAAA,EAAA,EAAA,IAAA;EAAc,SAAA,KAAA,EAAA,IAAA;EAAV,SAAA,KAAA,EAAA,IAAA;EAAS,SAAA,EAAA,EAAA,IAAA;;;;ECL5C,SAAA,MAAA,EAAa,IAAA;AASlB,CAAA;;;KETK,UAAA;KAGA,gBAAA,GAAmB,OAAO;AJUf,UIFC,qBAAA,CJEU;EAAmB;;;;;sBIIxB;;EHZN,gBAAS,CAAA,EGcJ,sBHdI;;AAAyB,iBGgBlC,aAAA,CHhBkC,OAAA,CAAA,EGgBV,qBHhBU,CAAA,EAAA;EAAV,UAAA,kBAAA;EAAS,OAAA,YAAA;;;;;;;;;ADQjD;;;AAAqE,iBKPrD,UAAA,CLOqD,MAAA,EKPlC,WLOkC,CAAA,EAAA,IAAA"}
+{"version":3,"file":"hooks-react.d.ts","names":["TupleToUnion","ArrayType"],"sources":["../node_modules/.pnpm/type-fest@5.4.4/node_modules/type-fest/source/tuple-to-union.d.ts","../src/hooks/react/useCreation.ts","../src/hooks/react/useLatest.ts","../src/hooks/react/useMount.ts","../src/hooks/react/useResponsive.ts","../src/hooks/react/useTitle.ts","../src/hooks/react/useUnmount.ts"],"sourcesContent":["/**\nConvert a tuple/array into a union type of its elements.\n\nThis can be useful when you have a fixed set of allowed values and want a type defining only the allowed values, but do not want to repeat yourself.\n\n@example\n```\nimport type {TupleToUnion} from 'type-fest';\n\nconst destinations = ['a', 'b', 'c'] as const;\n\ntype Destination = TupleToUnion<typeof destinations>;\n//=> 'a' | 'b' | 'c'\n\nfunction verifyDestination(destination: unknown): destination is Destination {\n\treturn destinations.includes(destination as any);\n}\n\ntype RequestBody = {\n\tdeliverTo: Destination;\n};\n\nfunction verifyRequestBody(body: unknown): body is RequestBody {\n\tconst {deliverTo} = (body as any);\n\treturn typeof body === 'object' && body !== null && verifyDestination(deliverTo);\n}\n```\n\nAlternatively, you may use `typeof destinations[number]`. If `destinations` is a tuple, there is no difference. However if `destinations` is a string, the resulting type will the union of the characters in the string. Other types of `destinations` may result in a compile error. In comparison, TupleToUnion will return `never` if a tuple is not provided.\n\n@example\n```\nconst destinations = ['a', 'b', 'c'] as const;\n\ntype Destination = typeof destinations[number];\n//=> 'a' | 'b' | 'c'\n\nconst erroringType = new Set(['a', 'b', 'c']);\n\n// @ts-expect-error\ntype ErroringType = typeof erroringType[number];\n// Error: Type 'Set<string>' has no matching index signature for type 'number'. ts(2537)\n\nconst numberBool: {[n: number]: boolean} = {1: true};\n\ntype NumberBool = typeof numberBool[number];\n//=> boolean\n```\n\n@category Array\n*/\nexport type TupleToUnion<ArrayType> = ArrayType extends readonly unknown[] ? ArrayType[number] : never;\n\nexport {};\n"],"x_google_ignoreList":[0],"mappings":";;;;;;;;;;;AAmDA;;;;ACnCA;;;;;;;;ACRA;;;;;;;;ACP+D;AAY/D;;;;ACV8C;AAEhB;AACA;AAM9B;AAIA;;;;;;;;;ACEA;;;;ACPA;;;;KNwCYA,0BAA0BC,uCAAuCA;;;;;;;AAA7E;;;iBCnCgB,8BAA+B,SAAS,iBAAc;;;;;;;ADmCtE;;iBE3CgB,oBAAqB,IAAI,UAAU;;;KCH9C,aAAA,GAAgB,iBAAiB;;;AH8CtC;;;;ACnCgB,iBEHA,QAAA,CFGW,MAAA,EEHO,aFGP,CAAA,EAAA,IAAA;;;KGXtB,UAAA,GAAa,oBAAoB;KACjC,gBAAA,GAAmB,OAAO;cAEzB;AJ2CMD,UIvCK,qBAAA,CJuCOC;;qBIrCH;;AHEL,iBGAA,aAAA,CHAW,OAAA,CAAA,EGAc,qBHAd,CAAA,EAAA;EAAoB,UAAA,kBAAA;EAAS,OAAA,EAAA,MAAA,GAAA,KAAA,GAAA,IAAA,GAAA,IAAA,GAAA,IAAA,GAAA,IAAA,GAAA,IAAA;EAAc,gBAAA,wBAAA;CAAA;;;UIZ5D,gBAAA;;;;;AL+CV;;;;ACnCA;;;;AAAsE,iBIEtD,QAAA,CJFsD,KAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EIEnB,gBJFmB,GAAA,SAAA,CAAA,EAAA,IAAA;;;;;;;ADmCtE;;iBMxCgB,UAAA,SAAoB"}