@vinicunca/perkakas 1.6.0 → 1.7.1

package/dist/omit-by.d.cts

@@ -1,15 +1,15 @@
 import { Simplify, IfNever } from 'type-fest';
-import { E as EnumerableStringKeyOf } from './enumerable-string-key-of-BQ4aR5ep.cjs';
-import { E as EnumerableStringKeyedValueOf } from './enumerable-string-keyed-value-of-CLzltniW.cjs';
-import { I as IfBoundedRecord } from './if-bounded-record-Drd4UbBU.cjs';
-import { R as ReconstructedRecord } from './reconstructed-record-DchLaSO8.cjs';
+import { E as EnumerableStringKeyOf } from './enumerable-string-key-of-D8w_3Yg8.cjs';
+import { E as EnumerableStringKeyedValueOf } from './enumerable-string-keyed-value-of-BU9R_cEk.cjs';
+import { I as IsBoundedRecord } from './is-bounded-record-C9WAwfA8.cjs';
+import './to-string-DO8zw6jS.cjs';
 
 type PickSymbolKeys<T extends object> = {
     -readonly [P in keyof T as P extends symbol ? P : never]: T[P];
 };
-type PartialEnumerableKeys<T extends object> = T extends unknown ? Simplify<IfBoundedRecord<T, PickSymbolKeys<T> & {
+type PartialEnumerableKeys<T extends object> = T extends unknown ? Simplify<IsBoundedRecord<T> extends true ? PickSymbolKeys<T> & {
     -readonly [P in keyof T as P extends symbol ? never : P]?: Required<T>[P];
-}, ReconstructedRecord<T>>> : never;
+} : Record<EnumerableStringKeyOf<T>, EnumerableStringKeyedValueOf<T>>> : never;
 type PartialEnumerableKeysNarrowed<T extends object, S> = Simplify<ExactProps<T, S> & PartialProps<T, S> & PickSymbolKeys<T>>;
 type ExactProps<T, S> = {
     -readonly [P in keyof T as IsExactProp<T, P, S> extends true ? P : never]: Exclude<T[P], S>;

package/dist/omit-by.d.ts

@@ -1,15 +1,15 @@
 import { Simplify, IfNever } from 'type-fest';
-import { E as EnumerableStringKeyOf } from './enumerable-string-key-of-BQ4aR5ep.js';
-import { E as EnumerableStringKeyedValueOf } from './enumerable-string-keyed-value-of-CLzltniW.js';
-import { I as IfBoundedRecord } from './if-bounded-record-Drd4UbBU.js';
-import { R as ReconstructedRecord } from './reconstructed-record-DuxOLlMs.js';
+import { E as EnumerableStringKeyOf } from './enumerable-string-key-of-C4gsorXe.js';
+import { E as EnumerableStringKeyedValueOf } from './enumerable-string-keyed-value-of-BU9R_cEk.js';
+import { I as IsBoundedRecord } from './is-bounded-record-C9WAwfA8.js';
+import './to-string-DO8zw6jS.js';
 
 type PickSymbolKeys<T extends object> = {
     -readonly [P in keyof T as P extends symbol ? P : never]: T[P];
 };
-type PartialEnumerableKeys<T extends object> = T extends unknown ? Simplify<IfBoundedRecord<T, PickSymbolKeys<T> & {
+type PartialEnumerableKeys<T extends object> = T extends unknown ? Simplify<IsBoundedRecord<T> extends true ? PickSymbolKeys<T> & {
     -readonly [P in keyof T as P extends symbol ? never : P]?: Required<T>[P];
-}, ReconstructedRecord<T>>> : never;
+} : Record<EnumerableStringKeyOf<T>, EnumerableStringKeyedValueOf<T>>> : never;
 type PartialEnumerableKeysNarrowed<T extends object, S> = Simplify<ExactProps<T, S> & PartialProps<T, S> & PickSymbolKeys<T>>;
 type ExactProps<T, S> = {
     -readonly [P in keyof T as IsExactProp<T, P, S> extends true ? P : never]: Exclude<T[P], S>;

package/dist/omit-by.js

@@ -1 +1 @@
-import{a}from"./chunk-SQZULO7V.js";import"./chunk-J6WPJH72.js";import"./chunk-KGPDVVVV.js";export{a as omitBy};
+import{a}from"./chunk-FIO5FNV2.js";import"./chunk-J6WPJH72.js";import"./chunk-KGPDVVVV.js";import"./chunk-EK7ODJWE.js";export{a as omitBy};

package/dist/omit.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkOMHZCALNcjs = require('./chunk-OMHZCALN.cjs');require('./chunk-66JP4PUG.cjs');require('./chunk-XR72I63W.cjs');require('./chunk-GZJMERDJ.cjs');exports.omit = _chunkOMHZCALNcjs.a;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkOMHZCALNcjs = require('./chunk-OMHZCALN.cjs');require('./chunk-66JP4PUG.cjs');require('./chunk-XR72I63W.cjs');require('./chunk-GZJMERDJ.cjs');require('./chunk-MBGSSEZN.cjs');exports.omit = _chunkOMHZCALNcjs.a;

package/dist/omit.js

@@ -1 +1 @@
-import{a}from"./chunk-VI2QG3FU.js";import"./chunk-ITDJLXHO.js";import"./chunk-J6WPJH72.js";import"./chunk-KGPDVVVV.js";export{a as omit};
+import{a}from"./chunk-VI2QG3FU.js";import"./chunk-ITDJLXHO.js";import"./chunk-J6WPJH72.js";import"./chunk-KGPDVVVV.js";import"./chunk-EK7ODJWE.js";export{a as omit};

package/dist/once.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkJRDQRETRcjs = require('./chunk-JRDQRETR.cjs');exports.once = _chunkJRDQRETRcjs.a;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkJRDQRETRcjs = require('./chunk-JRDQRETR.cjs');require('./chunk-MBGSSEZN.cjs');exports.once = _chunkJRDQRETRcjs.a;

package/dist/once.js

@@ -1 +1 @@
-import{a}from"./chunk-C6IMN7SF.js";export{a as once};
+import{a}from"./chunk-C6IMN7SF.js";import"./chunk-EK7ODJWE.js";export{a as once};

package/dist/only.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkA3EBULR7cjs = require('./chunk-A3EBULR7.cjs');require('./chunk-XR72I63W.cjs');require('./chunk-GZJMERDJ.cjs');exports.only = _chunkA3EBULR7cjs.a;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkA3EBULR7cjs = require('./chunk-A3EBULR7.cjs');require('./chunk-XR72I63W.cjs');require('./chunk-GZJMERDJ.cjs');require('./chunk-MBGSSEZN.cjs');exports.only = _chunkA3EBULR7cjs.a;

package/dist/only.js

@@ -1 +1 @@
-import{a}from"./chunk-HR2LFFYB.js";import"./chunk-J6WPJH72.js";import"./chunk-KGPDVVVV.js";export{a as only};
+import{a}from"./chunk-HR2LFFYB.js";import"./chunk-J6WPJH72.js";import"./chunk-KGPDVVVV.js";import"./chunk-EK7ODJWE.js";export{a as only};

package/dist/partition.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkL7WDY53Icjs = require('./chunk-L7WDY53I.cjs');require('./chunk-XR72I63W.cjs');require('./chunk-GZJMERDJ.cjs');exports.partition = _chunkL7WDY53Icjs.a;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkL7WDY53Icjs = require('./chunk-L7WDY53I.cjs');require('./chunk-XR72I63W.cjs');require('./chunk-GZJMERDJ.cjs');require('./chunk-MBGSSEZN.cjs');exports.partition = _chunkL7WDY53Icjs.a;

package/dist/partition.js

@@ -1 +1 @@
-import{a}from"./chunk-6GEID3HE.js";import"./chunk-J6WPJH72.js";import"./chunk-KGPDVVVV.js";export{a as partition};
+import{a}from"./chunk-6GEID3HE.js";import"./chunk-J6WPJH72.js";import"./chunk-KGPDVVVV.js";import"./chunk-EK7ODJWE.js";export{a as partition};

package/dist/path-or.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunk25CFIH7Lcjs = require('./chunk-25CFIH7L.cjs');require('./chunk-XR72I63W.cjs');require('./chunk-GZJMERDJ.cjs');exports.pathOr = _chunk25CFIH7Lcjs.a;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunk25CFIH7Lcjs = require('./chunk-25CFIH7L.cjs');require('./chunk-XR72I63W.cjs');require('./chunk-GZJMERDJ.cjs');require('./chunk-MBGSSEZN.cjs');exports.pathOr = _chunk25CFIH7Lcjs.a;

package/dist/path-or.d.cts

@@ -47,6 +47,11 @@ type PathValue3<T, A extends keyof Pathable<T>, B extends keyof Pathable1<T, A>,
 /**
  * Gets the value at `path` of `object`. If the resolved value is `null` or `undefined`, the `defaultValue` is returned in its place.
  *
+ * Prefer `prop` over this function as it provides better typing and is more
+ * flexible when building solutions. To provide a default value using `prop`
+ * use a [Nullish coalescing operator](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Nullish_coalescing)
+ * after the call.
+ *
  * @param object - The target object.
  * @param path - The path of the property to get.
  * @param defaultValue - The default value.
@@ -63,6 +68,11 @@ declare function pathOr<T, A extends keyof Pathable<T>, B extends keyof Pathable
 /**
  * Gets the value at `path` of `object`. If the resolved value is `undefined`, the `defaultValue` is returned in its place.
  *
+ * Prefer `prop` over this function as it provides better typing and is more
+ * flexible when building solutions. To provide a default value using `prop`
+ * use a [Nullish coalescing operator](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Nullish_coalescing)
+ * after the call.
+ *
  * @param path - The path of the property to get.
  * @param defaultValue - The default value.
  * @signature P.pathOr(array, defaultValue)(object)

package/dist/path-or.d.ts

@@ -47,6 +47,11 @@ type PathValue3<T, A extends keyof Pathable<T>, B extends keyof Pathable1<T, A>,
 /**
  * Gets the value at `path` of `object`. If the resolved value is `null` or `undefined`, the `defaultValue` is returned in its place.
  *
+ * Prefer `prop` over this function as it provides better typing and is more
+ * flexible when building solutions. To provide a default value using `prop`
+ * use a [Nullish coalescing operator](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Nullish_coalescing)
+ * after the call.
+ *
  * @param object - The target object.
  * @param path - The path of the property to get.
  * @param defaultValue - The default value.
@@ -63,6 +68,11 @@ declare function pathOr<T, A extends keyof Pathable<T>, B extends keyof Pathable
 /**
  * Gets the value at `path` of `object`. If the resolved value is `undefined`, the `defaultValue` is returned in its place.
  *
+ * Prefer `prop` over this function as it provides better typing and is more
+ * flexible when building solutions. To provide a default value using `prop`
+ * use a [Nullish coalescing operator](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Nullish_coalescing)
+ * after the call.
+ *
  * @param path - The path of the property to get.
  * @param defaultValue - The default value.
  * @signature P.pathOr(array, defaultValue)(object)

package/dist/path-or.js

@@ -1 +1 @@
-import{a}from"./chunk-N6GBVESU.js";import"./chunk-J6WPJH72.js";import"./chunk-KGPDVVVV.js";export{a as pathOr};
+import{a}from"./chunk-N6GBVESU.js";import"./chunk-J6WPJH72.js";import"./chunk-KGPDVVVV.js";import"./chunk-EK7ODJWE.js";export{a as pathOr};

package/dist/perkakas-type-error-8wPb8T2y.d.cts

@@ -0,0 +1,17 @@
+import { Tagged } from 'type-fest';
+
+declare const PerkakasErrorSymbol: unique symbol;
+interface PerkakasTypeErrorOptions {
+    type?: unknown;
+    metadata?: unknown;
+}
+/**
+ * Used for reporting type errors in a more useful way than `never`.
+ */
+type PerkakasTypeError<FunctionName extends string, Message extends number | string, Options extends PerkakasTypeErrorOptions = {}> = Tagged<Options extends {
+    type: infer T;
+} ? T : typeof PerkakasErrorSymbol, `PerkakasTypeError(${FunctionName}): ${Message}.`, Options extends {
+    metadata: infer Metadata;
+} ? Metadata : never>;
+
+export type { PerkakasTypeError as P };

package/dist/perkakas-type-error-8wPb8T2y.d.ts

@@ -0,0 +1,17 @@
+import { Tagged } from 'type-fest';
+
+declare const PerkakasErrorSymbol: unique symbol;
+interface PerkakasTypeErrorOptions {
+    type?: unknown;
+    metadata?: unknown;
+}
+/**
+ * Used for reporting type errors in a more useful way than `never`.
+ */
+type PerkakasTypeError<FunctionName extends string, Message extends number | string, Options extends PerkakasTypeErrorOptions = {}> = Tagged<Options extends {
+    type: infer T;
+} ? T : typeof PerkakasErrorSymbol, `PerkakasTypeError(${FunctionName}): ${Message}.`, Options extends {
+    metadata: infer Metadata;
+} ? Metadata : never>;
+
+export type { PerkakasTypeError as P };

package/dist/pick-by.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkGSBNZGMOcjs = require('./chunk-GSBNZGMO.cjs');require('./chunk-XR72I63W.cjs');require('./chunk-GZJMERDJ.cjs');exports.pickBy = _chunkGSBNZGMOcjs.a;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkGSBNZGMOcjs = require('./chunk-GSBNZGMO.cjs');require('./chunk-XR72I63W.cjs');require('./chunk-GZJMERDJ.cjs');require('./chunk-MBGSSEZN.cjs');exports.pickBy = _chunkGSBNZGMOcjs.a;

package/dist/pick-by.d.cts

@@ -1,19 +1,18 @@
 import { Simplify, IfNever } from 'type-fest';
-import { E as EnumerableStringKeyOf } from './enumerable-string-key-of-BQ4aR5ep.cjs';
-import { E as EnumerableStringKeyedValueOf } from './enumerable-string-keyed-value-of-CLzltniW.cjs';
-import { I as IfBoundedRecord } from './if-bounded-record-Drd4UbBU.cjs';
-import { R as ReconstructedRecord } from './reconstructed-record-DchLaSO8.cjs';
+import { E as EnumerableStringKeyOf } from './enumerable-string-key-of-D8w_3Yg8.cjs';
+import { E as EnumerableStringKeyedValueOf } from './enumerable-string-keyed-value-of-BU9R_cEk.cjs';
+import { I as IsBoundedRecord } from './is-bounded-record-C9WAwfA8.cjs';
+import { T as ToString } from './to-string-DO8zw6jS.cjs';
 
-type EnumerableKey<T> = `${T extends number | string ? T : never}`;
-type EnumeratedPartial<T> = T extends unknown ? Simplify<IfBoundedRecord<T, {
-    -readonly [P in keyof T as EnumerableKey<P>]?: Required<T>[P];
-}, ReconstructedRecord<T>>> : never;
-type EnumeratedPartialNarrowed<T, S> = Simplify<ExactProps<T, S> & PartialProps<T, S>>;
+type EnumeratedPartial<T> = T extends unknown ? Simplify<IsBoundedRecord<T> extends true ? {
+    -readonly [P in keyof T as ToString<P>]?: Required<T>[P];
+} : Record<EnumerableStringKeyOf<T>, EnumerableStringKeyedValueOf<T>>> : never;
+type EnumeratedPartialNarrowed<T, S> = T extends unknown ? Simplify<IsBoundedRecord<T> extends true ? ExactProps<T, S> & PartialProps<T, S> : Record<EnumerableStringKeyOf<T>, Extract<EnumerableStringKeyedValueOf<T>, S>>> : never;
 type ExactProps<T, S> = {
-    -readonly [P in keyof T as EnumerableKey<IsExactProp<T, P, S> extends true ? P : never>]: Extract<Required<T>[P], S>;
+    -readonly [P in keyof T as ToString<IsExactProp<T, P, S> extends true ? P : never>]: Extract<Required<T>[P], S>;
 };
 type PartialProps<T, S> = {
-    -readonly [P in keyof T as EnumerableKey<IsPartialProp<T, P, S> extends true ? P : never>]?: IfNever<Extract<T[P], S>, S extends T[P] ? S : never, Extract<T[P], S>>;
+    -readonly [P in keyof T as ToString<IsPartialProp<T, P, S> extends true ? P : never>]?: IfNever<Extract<T[P], S>, S extends T[P] ? S : never, Extract<T[P], S>>;
 };
 type IsExactProp<T, P extends keyof T, S> = T[P] extends Extract<T[P], S> ? true : false;
 type IsPartialProp<T, P extends keyof T, S> = IsExactProp<T, P, S> extends true ? false : IfNever<Extract<T[P], S>, S extends T[P] ? true : false, true>;

package/dist/pick-by.d.ts

@@ -1,19 +1,18 @@
 import { Simplify, IfNever } from 'type-fest';
-import { E as EnumerableStringKeyOf } from './enumerable-string-key-of-BQ4aR5ep.js';
-import { E as EnumerableStringKeyedValueOf } from './enumerable-string-keyed-value-of-CLzltniW.js';
-import { I as IfBoundedRecord } from './if-bounded-record-Drd4UbBU.js';
-import { R as ReconstructedRecord } from './reconstructed-record-DuxOLlMs.js';
+import { E as EnumerableStringKeyOf } from './enumerable-string-key-of-C4gsorXe.js';
+import { E as EnumerableStringKeyedValueOf } from './enumerable-string-keyed-value-of-BU9R_cEk.js';
+import { I as IsBoundedRecord } from './is-bounded-record-C9WAwfA8.js';
+import { T as ToString } from './to-string-DO8zw6jS.js';
 
-type EnumerableKey<T> = `${T extends number | string ? T : never}`;
-type EnumeratedPartial<T> = T extends unknown ? Simplify<IfBoundedRecord<T, {
-    -readonly [P in keyof T as EnumerableKey<P>]?: Required<T>[P];
-}, ReconstructedRecord<T>>> : never;
-type EnumeratedPartialNarrowed<T, S> = Simplify<ExactProps<T, S> & PartialProps<T, S>>;
+type EnumeratedPartial<T> = T extends unknown ? Simplify<IsBoundedRecord<T> extends true ? {
+    -readonly [P in keyof T as ToString<P>]?: Required<T>[P];
+} : Record<EnumerableStringKeyOf<T>, EnumerableStringKeyedValueOf<T>>> : never;
+type EnumeratedPartialNarrowed<T, S> = T extends unknown ? Simplify<IsBoundedRecord<T> extends true ? ExactProps<T, S> & PartialProps<T, S> : Record<EnumerableStringKeyOf<T>, Extract<EnumerableStringKeyedValueOf<T>, S>>> : never;
 type ExactProps<T, S> = {
-    -readonly [P in keyof T as EnumerableKey<IsExactProp<T, P, S> extends true ? P : never>]: Extract<Required<T>[P], S>;
+    -readonly [P in keyof T as ToString<IsExactProp<T, P, S> extends true ? P : never>]: Extract<Required<T>[P], S>;
 };
 type PartialProps<T, S> = {
-    -readonly [P in keyof T as EnumerableKey<IsPartialProp<T, P, S> extends true ? P : never>]?: IfNever<Extract<T[P], S>, S extends T[P] ? S : never, Extract<T[P], S>>;
+    -readonly [P in keyof T as ToString<IsPartialProp<T, P, S> extends true ? P : never>]?: IfNever<Extract<T[P], S>, S extends T[P] ? S : never, Extract<T[P], S>>;
 };
 type IsExactProp<T, P extends keyof T, S> = T[P] extends Extract<T[P], S> ? true : false;
 type IsPartialProp<T, P extends keyof T, S> = IsExactProp<T, P, S> extends true ? false : IfNever<Extract<T[P], S>, S extends T[P] ? true : false, true>;

package/dist/pick-by.js

@@ -1 +1 @@
-import{a}from"./chunk-SWZW76TE.js";import"./chunk-J6WPJH72.js";import"./chunk-KGPDVVVV.js";export{a as pickBy};
+import{a}from"./chunk-SWZW76TE.js";import"./chunk-J6WPJH72.js";import"./chunk-KGPDVVVV.js";import"./chunk-EK7ODJWE.js";export{a as pickBy};

package/dist/pick.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkHRK4GMT2cjs = require('./chunk-HRK4GMT2.cjs');require('./chunk-XR72I63W.cjs');require('./chunk-GZJMERDJ.cjs');exports.pick = _chunkHRK4GMT2cjs.a;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkQPMGUF2Vcjs = require('./chunk-QPMGUF2V.cjs');require('./chunk-XR72I63W.cjs');require('./chunk-GZJMERDJ.cjs');require('./chunk-MBGSSEZN.cjs');exports.pick = _chunkQPMGUF2Vcjs.a;

package/dist/pick.d.cts

@@ -1,25 +1,69 @@
+import { KeysOfUnion, IsNever, EmptyObject, Writable } from 'type-fest';
+import { I as IsBoundedRecord, a as IsBounded } from './is-bounded-record-C9WAwfA8.cjs';
+import { I as IsUnion } from './is-union-Bx34mF34.cjs';
+import { T as TupleParts } from './tuple-parts-v6av7LMU.cjs';
+import './iterable-container-BTpDVdNc.cjs';
+import './perkakas-type-error-8wPb8T2y.cjs';
+
+type PickFromArray<T, Keys extends ReadonlyArray<KeysOfUnion<T>>> = T extends unknown ? Keys extends unknown ? IsNever<Extract<Keys[number], keyof T>> extends true ? EmptyObject : Writable<IsBoundedRecord<T> extends true ? PickBoundedFromArray<T, Keys> : PickUnbounded<T, Extract<Keys[number], keyof T>>> : 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<T, Keys extends ReadonlyArray<KeysOfUnion<T>>> = Pick<T, Extract<ItemsByUnion<TupleParts<Keys>['required']>['singular'] | ItemsByUnion<TupleParts<Keys>['suffix']>['singular'], keyof T>> & Partial<Pick<T, Extract<ItemsByUnion<TupleParts<Keys>['required']>['union'] | TupleParts<Keys>['optional'][number] | TupleParts<Keys>['item'] | ItemsByUnion<TupleParts<Keys>['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, Singular = never, Union = never> = T extends readonly [
+    infer Head,
+    ...infer Rest
+] ? IsUnion<Head> extends true ? ItemsByUnion<Rest, Singular, Union | Head> : ItemsByUnion<Rest, Singular | Head, Union> : {
+    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<Record<string, "world">, "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<T, Keys extends keyof T> = IsBounded<Keys> extends true ? Partial<Pick<T, Keys>> : Pick<T, Keys>;
 /**
- * Creates an object composed of the picked `object` properties.
+ * Creates an object composed of the picked `data` properties.
  *
- * @param names - The properties names.
+ * @param keys - The property names.
  * @signature P.pick([prop1, prop2])(object)
  * @example
  *    P.pipe({ a: 1, b: 2, c: 3, d: 4 }, P.pick(['a', 'd'])) // => { a: 1, d: 4 }
  * @dataLast
  * @category Object
  */
-declare function pick<T extends object, K extends keyof T>(names: ReadonlyArray<K>): (object: T) => Pick<T, K>;
+declare function pick<T extends object, const Keys extends ReadonlyArray<KeysOfUnion<T>>>(keys: Keys): (data: T) => PickFromArray<T, Keys>;
 /**
- * Creates an object composed of the picked `object` properties.
+ * Creates an object composed of the picked `data` properties.
  *
- * @param object - The target object.
- * @param names - The properties names.
+ * @param data - The target object.
+ * @param keys - The property names.
  * @signature P.pick(object, [prop1, prop2])
  * @example
  *    P.pick({ a: 1, b: 2, c: 3, d: 4 }, ['a', 'd']) // => { a: 1, d: 4 }
  * @dataFirst
  * @category Object
  */
-declare function pick<T extends object, K extends keyof T>(object: T, names: ReadonlyArray<K>): Pick<T, K>;
+declare function pick<T extends object, const Keys extends ReadonlyArray<KeysOfUnion<T>>>(data: T, keys: Keys): PickFromArray<T, Keys>;
 
 export { pick };

package/dist/pick.d.ts

@@ -1,25 +1,69 @@
+import { KeysOfUnion, IsNever, EmptyObject, Writable } from 'type-fest';
+import { I as IsBoundedRecord, a as IsBounded } from './is-bounded-record-C9WAwfA8.js';
+import { I as IsUnion } from './is-union-Bx34mF34.js';
+import { T as TupleParts } from './tuple-parts-BTivqbtT.js';
+import './iterable-container-BTpDVdNc.js';
+import './perkakas-type-error-8wPb8T2y.js';
+
+type PickFromArray<T, Keys extends ReadonlyArray<KeysOfUnion<T>>> = T extends unknown ? Keys extends unknown ? IsNever<Extract<Keys[number], keyof T>> extends true ? EmptyObject : Writable<IsBoundedRecord<T> extends true ? PickBoundedFromArray<T, Keys> : PickUnbounded<T, Extract<Keys[number], keyof T>>> : 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<T, Keys extends ReadonlyArray<KeysOfUnion<T>>> = Pick<T, Extract<ItemsByUnion<TupleParts<Keys>['required']>['singular'] | ItemsByUnion<TupleParts<Keys>['suffix']>['singular'], keyof T>> & Partial<Pick<T, Extract<ItemsByUnion<TupleParts<Keys>['required']>['union'] | TupleParts<Keys>['optional'][number] | TupleParts<Keys>['item'] | ItemsByUnion<TupleParts<Keys>['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, Singular = never, Union = never> = T extends readonly [
+    infer Head,
+    ...infer Rest
+] ? IsUnion<Head> extends true ? ItemsByUnion<Rest, Singular, Union | Head> : ItemsByUnion<Rest, Singular | Head, Union> : {
+    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<Record<string, "world">, "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<T, Keys extends keyof T> = IsBounded<Keys> extends true ? Partial<Pick<T, Keys>> : Pick<T, Keys>;
 /**
- * Creates an object composed of the picked `object` properties.
+ * Creates an object composed of the picked `data` properties.
  *
- * @param names - The properties names.
+ * @param keys - The property names.
  * @signature P.pick([prop1, prop2])(object)
  * @example
  *    P.pipe({ a: 1, b: 2, c: 3, d: 4 }, P.pick(['a', 'd'])) // => { a: 1, d: 4 }
  * @dataLast
  * @category Object
  */
-declare function pick<T extends object, K extends keyof T>(names: ReadonlyArray<K>): (object: T) => Pick<T, K>;
+declare function pick<T extends object, const Keys extends ReadonlyArray<KeysOfUnion<T>>>(keys: Keys): (data: T) => PickFromArray<T, Keys>;
 /**
- * Creates an object composed of the picked `object` properties.
+ * Creates an object composed of the picked `data` properties.
  *
- * @param object - The target object.
- * @param names - The properties names.
+ * @param data - The target object.
+ * @param keys - The property names.
  * @signature P.pick(object, [prop1, prop2])
  * @example
  *    P.pick({ a: 1, b: 2, c: 3, d: 4 }, ['a', 'd']) // => { a: 1, d: 4 }
  * @dataFirst
  * @category Object
  */
-declare function pick<T extends object, K extends keyof T>(object: T, names: ReadonlyArray<K>): Pick<T, K>;
+declare function pick<T extends object, const Keys extends ReadonlyArray<KeysOfUnion<T>>>(data: T, keys: Keys): PickFromArray<T, Keys>;
 
 export { pick };

package/dist/pick.js

@@ -1 +1 @@
-import{a}from"./chunk-6L5XEBJG.js";import"./chunk-J6WPJH72.js";import"./chunk-KGPDVVVV.js";export{a as pick};
+import{a}from"./chunk-DXA7AZUA.js";import"./chunk-J6WPJH72.js";import"./chunk-KGPDVVVV.js";import"./chunk-EK7ODJWE.js";export{a as pick};

package/dist/pipe.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkBO34ARLYcjs = require('./chunk-BO34ARLY.cjs');require('./chunk-N5JE6642.cjs');exports.pipe = _chunkBO34ARLYcjs.a;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkBO34ARLYcjs = require('./chunk-BO34ARLY.cjs');require('./chunk-N5JE6642.cjs');require('./chunk-MBGSSEZN.cjs');exports.pipe = _chunkBO34ARLYcjs.a;

package/dist/pipe.js

@@ -1 +1 @@
-import{a}from"./chunk-QHBVEZSR.js";import"./chunk-EPU4K3DD.js";export{a as pipe};
+import{a}from"./chunk-QHBVEZSR.js";import"./chunk-EPU4K3DD.js";import"./chunk-EK7ODJWE.js";export{a as pipe};

package/dist/piped.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunk2CBHJMXWcjs = require('./chunk-2CBHJMXW.cjs');require('./chunk-BO34ARLY.cjs');require('./chunk-N5JE6642.cjs');exports.piped = _chunk2CBHJMXWcjs.a;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunk2CBHJMXWcjs = require('./chunk-2CBHJMXW.cjs');require('./chunk-BO34ARLY.cjs');require('./chunk-N5JE6642.cjs');require('./chunk-MBGSSEZN.cjs');exports.piped = _chunk2CBHJMXWcjs.a;

package/dist/piped.js

@@ -1 +1 @@
-import{a}from"./chunk-N2NQKHB3.js";import"./chunk-QHBVEZSR.js";import"./chunk-EPU4K3DD.js";export{a as piped};
+import{a}from"./chunk-N2NQKHB3.js";import"./chunk-QHBVEZSR.js";import"./chunk-EPU4K3DD.js";import"./chunk-EK7ODJWE.js";export{a as piped};

package/dist/product.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkXY7YER5Ncjs = require('./chunk-XY7YER5N.cjs');require('./chunk-XR72I63W.cjs');require('./chunk-GZJMERDJ.cjs');exports.product = _chunkXY7YER5Ncjs.a;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkXY7YER5Ncjs = require('./chunk-XY7YER5N.cjs');require('./chunk-XR72I63W.cjs');require('./chunk-GZJMERDJ.cjs');require('./chunk-MBGSSEZN.cjs');exports.product = _chunkXY7YER5Ncjs.a;

package/dist/product.js

@@ -1 +1 @@
-import{a}from"./chunk-5T6DY3SA.js";import"./chunk-J6WPJH72.js";import"./chunk-KGPDVVVV.js";export{a as product};
+import{a}from"./chunk-5T6DY3SA.js";import"./chunk-J6WPJH72.js";import"./chunk-KGPDVVVV.js";import"./chunk-EK7ODJWE.js";export{a as product};

package/dist/prop.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkSOPOELNUcjs = require('./chunk-SOPOELNU.cjs');require('./chunk-XR72I63W.cjs');require('./chunk-GZJMERDJ.cjs');exports.prop = _chunkSOPOELNUcjs.a; exports.propImplementation = _chunkSOPOELNUcjs.b;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkHHNHTPVOcjs = require('./chunk-HHNHTPVO.cjs');require('./chunk-MBGSSEZN.cjs');exports.prop = _chunkHHNHTPVOcjs.a;