@vinicunca/perkakas 1.6.0 → 1.7.0

package/dist/omit-by.d.ts

@@ -1,15 +1,16 @@
 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 If } from './if-D4QIikQ1.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<If<IsBoundedRecord<T>, 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.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,19 @@
 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 If } from './if-D4QIikQ1.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<If<IsBoundedRecord<T>, {
+    -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<If<IsBoundedRecord<T>, 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,19 @@
 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 If } from './if-D4QIikQ1.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<If<IsBoundedRecord<T>, {
+    -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<If<IsBoundedRecord<T>, 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 _chunkFOUZI2Q3cjs = require('./chunk-FOUZI2Q3.cjs');require('./chunk-XR72I63W.cjs');require('./chunk-GZJMERDJ.cjs');require('./chunk-MBGSSEZN.cjs');exports.pick = _chunkFOUZI2Q3cjs.a;

package/dist/pick.d.cts

@@ -1,25 +1,70 @@
+import { KeysOfUnion, IsNever, EmptyObject, Writable } from 'type-fest';
+import { I as If } from './if-D4QIikQ1.cjs';
+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 ? If<IsNever<Extract<Keys[number], keyof T>>, EmptyObject, Writable<If<IsBoundedRecord<T>, 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
+] ? If<IsUnion<Head>, 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> = If<IsBounded<Keys>, 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,70 @@
+import { KeysOfUnion, IsNever, EmptyObject, Writable } from 'type-fest';
+import { I as If } from './if-D4QIikQ1.js';
+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 ? If<IsNever<Extract<Keys[number], keyof T>>, EmptyObject, Writable<If<IsBoundedRecord<T>, 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
+] ? If<IsUnion<Head>, 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> = If<IsBounded<Keys>, 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-Z7D7Q6U3.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 _chunkSOPOELNUcjs = require('./chunk-SOPOELNU.cjs');require('./chunk-XR72I63W.cjs');require('./chunk-GZJMERDJ.cjs');require('./chunk-MBGSSEZN.cjs');exports.prop = _chunkSOPOELNUcjs.a; exports.propImplementation = _chunkSOPOELNUcjs.b;

package/dist/prop.js

@@ -1 +1 @@
-import{a,b}from"./chunk-NEIICTWC.js";import"./chunk-J6WPJH72.js";import"./chunk-KGPDVVVV.js";export{a as prop,b as propImplementation};
+import{a,b}from"./chunk-NEIICTWC.js";import"./chunk-J6WPJH72.js";import"./chunk-KGPDVVVV.js";import"./chunk-EK7ODJWE.js";export{a as prop,b as propImplementation};

package/dist/pull-object.cjs

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

package/dist/pull-object.d.cts

@@ -1,7 +1,8 @@
-import { B as BoundedPartial } from './bounded-partial-wqR8ceNQ.cjs';
+import { B as BoundedPartial } from './bounded-partial-BqwRN49U.cjs';
 import { I as IterableContainer } from './iterable-container-BTpDVdNc.cjs';
-import './if-bounded-record-Drd4UbBU.cjs';
+import './if-D4QIikQ1.cjs';
 import 'type-fest';
+import './is-bounded-record-C9WAwfA8.cjs';
 
 /**
  * Creates an object that maps the result of `valueExtractor` with a key

package/dist/pull-object.d.ts

@@ -1,7 +1,8 @@
-import { B as BoundedPartial } from './bounded-partial-CJjczH6j.js';
+import { B as BoundedPartial } from './bounded-partial-BzynYDVs.js';
 import { I as IterableContainer } from './iterable-container-BTpDVdNc.js';
-import './if-bounded-record-Drd4UbBU.js';
+import './if-D4QIikQ1.js';
 import 'type-fest';
+import './is-bounded-record-C9WAwfA8.js';
 
 /**
  * Creates an object that maps the result of `valueExtractor` with a key

package/dist/pull-object.js

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

package/dist/random-integer.cjs

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

package/dist/random-integer.js

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

package/dist/random-string.cjs

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

package/dist/random-string.js

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

package/dist/range.cjs

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

package/dist/range.js

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

package/dist/rank-by.cjs

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

package/dist/rank-by.d.cts

@@ -1,5 +1,5 @@
-import { N as NonEmptyArray } from './non-empty-array-C9Od1wmF.cjs';
 import { O as OrderRule } from './curry-order-rules-BKXCPBNx.cjs';
+import { N as NonEmptyArray } from './non-empty-array-C9Od1wmF.cjs';
 
 /**
  * Calculates the rank of an item in an array based on `rules`. The rank is the position where the item would appear in the sorted array. This function provides an efficient way to determine the rank in *O(n)* time, compared to *O(nlogn)* for the equivalent `sortedIndex(sortBy(data, ...rules), item)`.

package/dist/rank-by.d.ts

@@ -1,5 +1,5 @@
-import { N as NonEmptyArray } from './non-empty-array-C9Od1wmF.js';
 import { O as OrderRule } from './curry-order-rules-BKXCPBNx.js';
+import { N as NonEmptyArray } from './non-empty-array-C9Od1wmF.js';
 
 /**
  * Calculates the rank of an item in an array based on `rules`. The rank is the position where the item would appear in the sorted array. This function provides an efficient way to determine the rank in *O(n)* time, compared to *O(nlogn)* for the equivalent `sortedIndex(sortBy(data, ...rules), item)`.

package/dist/rank-by.js

@@ -1 +1 @@
-import{a}from"./chunk-G57ZPKMR.js";import"./chunk-7KBK2RWQ.js";export{a as rankBy};
+import{a}from"./chunk-G57ZPKMR.js";import"./chunk-7KBK2RWQ.js";import"./chunk-EK7ODJWE.js";export{a as rankBy};

package/dist/reduce.cjs

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

package/dist/reduce.js

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

package/dist/reverse.cjs

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

package/dist/reverse.js

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

package/dist/round.cjs

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

package/dist/round.js

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

package/dist/sample.cjs

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

package/dist/sample.js

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

package/dist/set-path.cjs

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

package/dist/set-path.d.cts

@@ -1,8 +1,19 @@
-type Path<T, Prefix extends ReadonlyArray<unknown> = []> = T extends ReadonlyArray<unknown> ? Path<T[number], [...Prefix, number]> | Prefix : T extends Record<PropertyKey, unknown> ? PathsOfObject<T, Prefix> | Prefix : Prefix;
-type PathsOfObject<T, Prefix extends ReadonlyArray<unknown>> = {
-    [K in keyof T]-?: Path<T[K], readonly [...Prefix, K]>;
-}[keyof T];
-type ValueAtPath<T, TPath> = TPath extends readonly [
+import { ValueOf } from 'type-fest';
+import { P as PerkakasTypeError } from './perkakas-type-error-8wPb8T2y.cjs';
+
+type Paths<T, Prefix extends ReadonlyArray<unknown> = []> = Prefix | (T extends object ? ValueOf<{
+    [K in ProperKeyOf<T>]-?: Paths<T[K], [...Prefix, K]>;
+}> : PerkakasTypeError<'setPath', 'Can only compute paths objects', {
+    type: never;
+    metadata: T;
+}>) extends infer Path ? Readonly<Path> : never;
+/**
+ * Array objects have all Array.prototype keys in their "keyof" type, which
+ * is not what we'd expect from the operator. We only want the numeric keys
+ * which represent proper elements of the array.
+ */
+type ProperKeyOf<T> = Extract<keyof T, T extends ReadonlyArray<unknown> ? number : keyof T>;
+type ValueAtPath<T, Path> = Path extends readonly [
     infer Head extends keyof T,
     ...infer Rest
 ] ? ValueAtPath<T[Head], Rest> : T;
@@ -21,7 +32,7 @@ type ValueAtPath<T, TPath> = TPath extends readonly [
  * @dataFirst
  * @category Object
  */
-declare function setPath<T, TPath extends Path<T>>(data: T, path: TPath, value: ValueAtPath<T, TPath>): T;
+declare function setPath<T, Path extends Paths<T>>(data: T, path: Path, value: ValueAtPath<T, Path>): T;
 /**
  * Sets the value at `path` of `object`.
  *
@@ -34,6 +45,6 @@ declare function setPath<T, TPath extends Path<T>>(data: T, path: TPath, value:
  * @dataLast
  * @category Object
  */
-declare function setPath<T, TPath extends Path<T>, Value extends ValueAtPath<T, TPath>>(path: TPath, value: Value): (data: T) => T;
+declare function setPath<T, Path extends Paths<T>, Value extends ValueAtPath<T, Path>>(path: Path, value: Value): (data: T) => T;
 
 export { setPath };