import { IsUnion } from "./IsUnion-CLAq6XkY.cjs"; import { TupleParts } from "./TupleParts-BV9kUr1M.cjs"; import { IsBounded, IsBoundedRecord } from "./IsBoundedRecord-CdmkKUY-.cjs"; import { EmptyObject, IsNever, KeysOfUnion, Writable } from "type-fest"; //#region src/pick.d.ts type PickFromArray>> = T extends unknown ? Keys extends unknown ? IsNever> extends true ? EmptyObject : Writable extends true ? PickBoundedFromArray : PickUnbounded>> : never : never; /** * Bounded records have bounded keys and result in a bounded output. The only * question left is whether to add the prop as-is, or make it optional. This * can be determined by the part of the keys array the prop is defined in, and * the way that element is defined: if the array contains a singular literal * key in either the required prefix or the suffix, we know that prop should be * picked as-is, otherwise, the key might not be present in the keys array so it * can only be picked optionally. */ type PickBoundedFromArray>> = Pick["required"]>["singular"] | ItemsByUnion["suffix"]>["singular"], keyof T>> & Partial["required"]>["union"] | TupleParts["optional"][number] | TupleParts["item"] | ItemsByUnion["suffix"]>["union"], keyof T>>>; /** * We split the fixed tuple item types into **singular** props (e.g., `"a"`), * and unions of several props (e.g., `"a" | "b"`). * * We assume that T is a fixed tuple (no optional or rest elements), and that * all elements in it are bounded (as defined by `IsBounded`). */ type ItemsByUnion = T extends readonly [infer Head, ...infer Rest] ? IsUnion extends true ? ItemsByUnion : ItemsByUnion : { singular: Singular; union: Union; }; /** * The built-in `Pick` is weird when it comes to picking bounded keys from * unbounded records. It reconstructs the output object regardless of the shape * of the input: `Pick, "hello">` results in the type * `{ hello: "world" }`, but you'd expect it to be optional because we don't * know if the record contains a `hello` prop or not! * * !Important: We assume T is unbounded and don't test for it! * * See: https://www.typescriptlang.org/play/?#code/PTAEE0HsFcHIBNQFMAeAHJBjALqAGqNpKAEZKigAGA3qABZIA2jkA-AFygBEA7pAE6N4XUAF9KAGlLRcAQ0ayAzgChsATwz5QAXlAAFAJaYA1gB4ASlgHxTi7PwMA7AOZTeAoVwB8bhs0jeANzKIBSgAHqsykA. */ type PickUnbounded = IsBounded extends true ? Partial> : Pick; /** * Creates an object composed of the picked `data` properties. * * @param keys - The property names. * @signature R.pick([prop1, prop2])(object) * @example * R.pipe({ a: 1, b: 2, c: 3, d: 4 }, R.pick(['a', 'd'])) // => { a: 1, d: 4 } * @dataLast * @category Object */ declare function pick>>(keys: Keys): (data: T) => PickFromArray; /** * Creates an object composed of the picked `data` properties. * * @param data - The target object. * @param keys - The property names. * @signature R.pick(object, [prop1, prop2]) * @example * R.pick({ a: 1, b: 2, c: 3, d: 4 }, ['a', 'd']) // => { a: 1, d: 4 } * @dataFirst * @category Object */ declare function pick>>(data: T, keys: Keys): PickFromArray; //#endregion export { pick }; //# sourceMappingURL=pick-CxKBC2Xi.d.cts.map