@vinicunca/perkakas 1.7.1 → 1.8.0

package/dist/reverse.d.cts

@@ -1,27 +1,2 @@
-type Reverse<T extends ReadonlyArray<unknown>, R extends ReadonlyArray<unknown> = []> = ReturnType<T extends IsNoTuple<T> ? () => [...T, ...R] : T extends readonly [infer F, ...infer L] ? () => Reverse<L, [F, ...R]> : () => R>;
-type IsNoTuple<T> = T extends readonly [unknown, ...Array<unknown>] ? never : T;
-/**
- * Reverses array.
- *
- * @param array - The array.
- * @signature
- *    P.reverse(arr);
- * @example
- *    P.reverse([1, 2, 3]) // [3, 2, 1]
- * @dataFirst
- * @category Array
- */
-declare function reverse<T extends ReadonlyArray<unknown>>(array: T): Reverse<T>;
-/**
- * Reverses array.
- *
- * @signature
- *    P.reverse()(array);
- * @example
- *    P.reverse()([1, 2, 3]) // [3, 2, 1]
- * @dataLast
- * @category Array
- */
-declare function reverse<T extends ReadonlyArray<unknown>>(): (array: T) => Reverse<T>;
-
-export { reverse };
+import { reverse } from "./reverse-Bu350kg_.cjs";
+export { reverse };

package/dist/reverse.d.ts

@@ -1,27 +1,2 @@
-type Reverse<T extends ReadonlyArray<unknown>, R extends ReadonlyArray<unknown> = []> = ReturnType<T extends IsNoTuple<T> ? () => [...T, ...R] : T extends readonly [infer F, ...infer L] ? () => Reverse<L, [F, ...R]> : () => R>;
-type IsNoTuple<T> = T extends readonly [unknown, ...Array<unknown>] ? never : T;
-/**
- * Reverses array.
- *
- * @param array - The array.
- * @signature
- *    P.reverse(arr);
- * @example
- *    P.reverse([1, 2, 3]) // [3, 2, 1]
- * @dataFirst
- * @category Array
- */
-declare function reverse<T extends ReadonlyArray<unknown>>(array: T): Reverse<T>;
-/**
- * Reverses array.
- *
- * @signature
- *    P.reverse()(array);
- * @example
- *    P.reverse()([1, 2, 3]) // [3, 2, 1]
- * @dataLast
- * @category Array
- */
-declare function reverse<T extends ReadonlyArray<unknown>>(): (array: T) => Reverse<T>;
-
-export { reverse };
+import { reverse } from "./reverse-w5Ru5uLJ.js";
+export { reverse };

package/dist/reverse.js

@@ -1 +1 @@
-import{a}from"./chunk-JNQXGRDN.js";import"./chunk-J6WPJH72.js";import"./chunk-KGPDVVVV.js";import"./chunk-EK7ODJWE.js";export{a as reverse};
+import"./lazy-data-last-impl-7QfM1xXg.js";import"./curry-CzZjDrpv.js";import{reverse as e}from"./reverse-DZc8DCPA.js";export{e as reverse};

package/dist/round-BDhuebcp.d.ts

@@ -0,0 +1,39 @@
+//#region src/round.d.ts
+/**
+ * Rounds a given number to a specific precision.
+ * If you'd like to round to an integer (i.e. use this function with constant `precision === 0`),
+ * use `Math.round` instead, as it won't incur the additional library overhead.
+ *
+ * @param value - The number to round.
+ * @param precision - The precision to round to. Must be an integer between -15 and 15.
+ * @signature
+ *    P.round(value, precision);
+ * @example
+ *    P.round(123.9876, 3) // => 123.988
+ *    P.round(483.22243, 1) // => 483.2
+ *    P.round(8541, -1) // => 8540
+ *    P.round(456789, -3) // => 457000
+ * @dataFirst
+ * @category Number
+ */
+declare function round(value: number, precision: number): number;
+/**
+ * Rounds a given number to a specific precision.
+ * If you'd like to round to an integer (i.e. use this function with constant `precision === 0`),
+ * use `Math.round` instead, as it won't incur the additional library overhead.
+ *
+ * @param precision - The precision to round to. Must be an integer between -15 and 15.
+ * @signature
+ *    P.round(precision)(value);
+ * @example
+ *    P.round(3)(123.9876) // => 123.988
+ *    P.round(1)(483.22243) // => 483.2
+ *    P.round(-1)(8541) // => 8540
+ *    P.round(-3)(456789) // => 457000
+ * @dataLast
+ * @category Number
+ */
+declare function round(precision: number): (value: number) => number;
+//#endregion
+export { round };
+//# sourceMappingURL=round-BDhuebcp.d.ts.map

package/dist/round-BDhuebcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"round-BDhuebcp.d.ts","names":[],"sources":["../src/round.ts"],"sourcesContent":[],"mappings":";;AAoBA;AAkBA;;;;;;;;;;;;;;;iBAlBgB,KAAA;;;;;;;;;;;;;;;;;iBAkBA,KAAA"}

package/dist/round-CBhbfa_y.cjs

@@ -0,0 +1 @@
+const e=require(`./curry-BPVIsvo3.cjs`),t=require(`./with-precision-BgF-Y_mF.cjs`);function n(...n){return e.curry(t.withPrecision(Math.round),n)}Object.defineProperty(exports,`round`,{enumerable:!0,get:function(){return n}});

package/dist/round-DhclizH1.js

@@ -0,0 +1,2 @@
+import{curry as e}from"./curry-CzZjDrpv.js";import{withPrecision as t}from"./with-precision-BoiuafbM.js";function n(...n){return e(t(Math.round),n)}export{n as round};
+//# sourceMappingURL=round-DhclizH1.js.map

package/dist/round-DhclizH1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"round-DhclizH1.js","names":[],"sources":["../src/round.ts"],"sourcesContent":["import { curry } from './curry';\nimport { withPrecision } from './internal/with-precision';\n\n/**\n * Rounds a given number to a specific precision.\n * If you'd like to round to an integer (i.e. use this function with constant `precision === 0`),\n * use `Math.round` instead, as it won't incur the additional library overhead.\n *\n * @param value - The number to round.\n * @param precision - The precision to round to. Must be an integer between -15 and 15.\n * @signature\n *    P.round(value, precision);\n * @example\n *    P.round(123.9876, 3) // => 123.988\n *    P.round(483.22243, 1) // => 483.2\n *    P.round(8541, -1) // => 8540\n *    P.round(456789, -3) // => 457000\n * @dataFirst\n * @category Number\n */\nexport function round(value: number, precision: number): number;\n\n/**\n * Rounds a given number to a specific precision.\n * If you'd like to round to an integer (i.e. use this function with constant `precision === 0`),\n * use `Math.round` instead, as it won't incur the additional library overhead.\n *\n * @param precision - The precision to round to. Must be an integer between -15 and 15.\n * @signature\n *    P.round(precision)(value);\n * @example\n *    P.round(3)(123.9876) // => 123.988\n *    P.round(1)(483.22243) // => 483.2\n *    P.round(-1)(8541) // => 8540\n *    P.round(-3)(456789) // => 457000\n * @dataLast\n * @category Number\n */\nexport function round(precision: number): (value: number) => number;\n\nexport function round(...args: ReadonlyArray<unknown>): unknown {\n  return curry(withPrecision(Math.round), args);\n}\n"],"mappings":"yGAwCA,SAAgB,EAAM,GAAG,EAAuC,CAC9D,OAAO,EAAM,EAAc,KAAK,MAAM,CAAE,EAAK"}

package/dist/round-rQiLyN4w.d.cts

@@ -0,0 +1,39 @@
+//#region src/round.d.ts
+/**
+ * Rounds a given number to a specific precision.
+ * If you'd like to round to an integer (i.e. use this function with constant `precision === 0`),
+ * use `Math.round` instead, as it won't incur the additional library overhead.
+ *
+ * @param value - The number to round.
+ * @param precision - The precision to round to. Must be an integer between -15 and 15.
+ * @signature
+ *    P.round(value, precision);
+ * @example
+ *    P.round(123.9876, 3) // => 123.988
+ *    P.round(483.22243, 1) // => 483.2
+ *    P.round(8541, -1) // => 8540
+ *    P.round(456789, -3) // => 457000
+ * @dataFirst
+ * @category Number
+ */
+declare function round(value: number, precision: number): number;
+/**
+ * Rounds a given number to a specific precision.
+ * If you'd like to round to an integer (i.e. use this function with constant `precision === 0`),
+ * use `Math.round` instead, as it won't incur the additional library overhead.
+ *
+ * @param precision - The precision to round to. Must be an integer between -15 and 15.
+ * @signature
+ *    P.round(precision)(value);
+ * @example
+ *    P.round(3)(123.9876) // => 123.988
+ *    P.round(1)(483.22243) // => 483.2
+ *    P.round(-1)(8541) // => 8540
+ *    P.round(-3)(456789) // => 457000
+ * @dataLast
+ * @category Number
+ */
+declare function round(precision: number): (value: number) => number;
+//#endregion
+export { round };
+//# sourceMappingURL=round-rQiLyN4w.d.cts.map

package/dist/round-rQiLyN4w.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"round-rQiLyN4w.d.cts","names":[],"sources":["../src/round.ts"],"sourcesContent":[],"mappings":";;AAoBA;AAkBA;;;;;;;;;;;;;;;iBAlBgB,KAAA;;;;;;;;;;;;;;;;;iBAkBA,KAAA"}

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');require('./chunk-MBGSSEZN.cjs');exports.round = _chunkIRWDTBZTcjs.a;
+require(`./lazy-data-last-impl-3PAFkslW.cjs`),require(`./curry-BPVIsvo3.cjs`),require(`./with-precision-BgF-Y_mF.cjs`);const e=require(`./round-CBhbfa_y.cjs`);exports.round=e.round;

package/dist/round.d.cts

@@ -1,37 +1,2 @@
-/**
- * Rounds a given number to a specific precision.
- * If you'd like to round to an integer (i.e. use this function with constant `precision === 0`),
- * use `Math.round` instead, as it won't incur the additional library overhead.
- *
- * @param value - The number to round.
- * @param precision - The precision to round to. Must be an integer between -15 and 15.
- * @signature
- *    P.round(value, precision);
- * @example
- *    P.round(123.9876, 3) // => 123.988
- *    P.round(483.22243, 1) // => 483.2
- *    P.round(8541, -1) // => 8540
- *    P.round(456789, -3) // => 457000
- * @dataFirst
- * @category Number
- */
-declare function round(value: number, precision: number): number;
-/**
- * Rounds a given number to a specific precision.
- * If you'd like to round to an integer (i.e. use this function with constant `precision === 0`),
- * use `Math.round` instead, as it won't incur the additional library overhead.
- *
- * @param precision - The precision to round to. Must be an integer between -15 and 15.
- * @signature
- *    P.round(precision)(value);
- * @example
- *    P.round(3)(123.9876) // => 123.988
- *    P.round(1)(483.22243) // => 483.2
- *    P.round(-1)(8541) // => 8540
- *    P.round(-3)(456789) // => 457000
- * @dataLast
- * @category Number
- */
-declare function round(precision: number): (value: number) => number;
-
-export { round };
+import { round } from "./round-rQiLyN4w.cjs";
+export { round };

package/dist/round.d.ts

@@ -1,37 +1,2 @@
-/**
- * Rounds a given number to a specific precision.
- * If you'd like to round to an integer (i.e. use this function with constant `precision === 0`),
- * use `Math.round` instead, as it won't incur the additional library overhead.
- *
- * @param value - The number to round.
- * @param precision - The precision to round to. Must be an integer between -15 and 15.
- * @signature
- *    P.round(value, precision);
- * @example
- *    P.round(123.9876, 3) // => 123.988
- *    P.round(483.22243, 1) // => 483.2
- *    P.round(8541, -1) // => 8540
- *    P.round(456789, -3) // => 457000
- * @dataFirst
- * @category Number
- */
-declare function round(value: number, precision: number): number;
-/**
- * Rounds a given number to a specific precision.
- * If you'd like to round to an integer (i.e. use this function with constant `precision === 0`),
- * use `Math.round` instead, as it won't incur the additional library overhead.
- *
- * @param precision - The precision to round to. Must be an integer between -15 and 15.
- * @signature
- *    P.round(precision)(value);
- * @example
- *    P.round(3)(123.9876) // => 123.988
- *    P.round(1)(483.22243) // => 483.2
- *    P.round(-1)(8541) // => 8540
- *    P.round(-3)(456789) // => 457000
- * @dataLast
- * @category Number
- */
-declare function round(precision: number): (value: number) => number;
-
-export { round };
+import { round } from "./round-BDhuebcp.js";
+export { round };

package/dist/round.js

@@ -1 +1 @@
-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};
+import"./lazy-data-last-impl-7QfM1xXg.js";import"./curry-CzZjDrpv.js";import"./with-precision-BoiuafbM.js";import{round as e}from"./round-DhclizH1.js";export{e as round};

package/dist/sample-9vI5EmCM.d.cts

@@ -0,0 +1,69 @@
+import { IterableContainer } from "./iterable-container-V5sa0V_H.cjs";
+import { NTuple } from "./n-tuple-Co_jgwEn.cjs";
+import { PartialArray } from "./partial-array-CzOnr197.cjs";
+import { TupleParts } from "./tuple-parts-BIyABPYv.cjs";
+import { CoercedArray } from "./coerced-array-kVJtBrMl.cjs";
+import { FixedLengthArray, IsEqual, IsNever, NonNegativeInteger, Or, Writable } from "type-fest";
+
+//#region src/sample.d.ts
+type Sampled<T extends IterableContainer, N extends number> = Or<IsEqual<N, 0>, IsEqual<T['length'], 0>> extends true ? [] : IsNever<NonNegativeInteger<N>> extends true ? SampledPrimitive<T> : IsLongerThan<T, N> extends true ? SampledLiteral<T, N> : Writable<T>;
+/**
+ * When N is not a non-negative integer **literal** we can't use it in our
+ * reconstructing logic so we fallback to a simpler definition of the output of
+ * sample, which is any sub-tuple shape of T, of **any length**.
+ */
+type SampledPrimitive<T extends IterableContainer> = [...FixedSubTuples<TupleParts<T>['required']>, ...PartialArray<FixedSubTuples<TupleParts<T>['optional']>>, ...CoercedArray<TupleParts<T>['item']>, ...FixedSubTuples<TupleParts<T>['suffix']>];
+/**
+ * Knowing N is a non-negative literal integer we can construct all sub-tuples
+ * of T that are exactly N elements long.
+ */
+type SampledLiteral<T extends IterableContainer, N extends number> = Extract<FixedSubTuples<[...TupleParts<T>['required'], ...(IsNever<TupleParts<T>['item']> extends true ? [] : NTuple<TupleParts<T>['item'], N>), ...TupleParts<T>['suffix']]>, FixedLengthArray<unknown, N>> | SubSampled<TupleParts<T>['required'], TupleParts<T>['item'], TupleParts<T>['suffix'], N>;
+type SubSampled<Prefix extends ReadonlyArray<unknown>, Item, Suffix extends ReadonlyArray<unknown>, N extends number> = IsLongerThan<[...Prefix, ...Suffix], N> extends true ? never : [...Prefix, ...Suffix]['length'] extends N ? never : [...Prefix, ...Suffix] | SubSampled<[...Prefix, Item], Item, Suffix, N>;
+type IsLongerThan<T extends ReadonlyArray<unknown>, N extends number> = IsEqual<T[N], undefined> extends true ? false : true;
+type FixedSubTuples<T> = T extends readonly [infer Head, ...infer Rest] ? FixedSubTuples<Rest> | [Head, ...FixedSubTuples<Rest>] : [];
+/**
+ * Returns a random subset of size `sampleSize` from `array`.
+ *
+ * Maintains and infers most of the typing information that could be passed
+ * along to the output. This means that when using tuples, the output will be
+ * a tuple too, and when using literals, those literals would be preserved.
+ *
+ * The items in the result are kept in the same order as they are in the input.
+ * If you need to get a shuffled response you can pipe the shuffle function
+ * after this one.
+ *
+ * @param data - The array.
+ * @param sampleSize - The number of elements to take.
+ * @signature
+ *    P.sample(array, sampleSize)
+ * @example
+ *    P.sample(["hello", "world"], 1); // => ["hello"] // typed string[]
+ *    P.sample(["hello", "world"] as const, 1); // => ["world"] // typed ["hello" | "world"]
+ * @dataFirst
+ * @category Array
+ */
+declare function sample<const T extends IterableContainer, N extends number = number>(data: T, sampleSize: N): Sampled<T, N>;
+/**
+ * Returns a random subset of size `sampleSize` from `array`.
+ *
+ * Maintains and infers most of the typing information that could be passed
+ * along to the output. This means that when using tuples, the output will be
+ * a tuple too, and when using literals, those literals would be preserved.
+ *
+ * The items in the result are kept in the same order as they are in the input.
+ * If you need to get a shuffled response you can pipe the shuffle function
+ * after this one.
+ *
+ * @param sampleSize - The number of elements to take.
+ * @signature
+ *    P.sample(sampleSize)(array)
+ * @example
+ *    P.sample(1)(["hello", "world"]); // => ["hello"] // typed string[]
+ *    P.sample(1)(["hello", "world"] as const); // => ["world"] // typed ["hello" | "world"]
+ * @dataLast
+ * @category Array
+ */
+declare function sample<const T extends IterableContainer, N extends number = number>(sampleSize: N): (data: T) => Sampled<T, N>;
+//#endregion
+export { sample };
+//# sourceMappingURL=sample-9vI5EmCM.d.cts.map

package/dist/sample-9vI5EmCM.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sample-9vI5EmCM.d.cts","names":[],"sources":["../src/sample.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/sample-BHIZQL57.d.ts

@@ -0,0 +1,69 @@
+import { IterableContainer } from "./iterable-container-wtkYslN_.js";
+import { NTuple } from "./n-tuple-BELi5yRe.js";
+import { PartialArray } from "./partial-array-IoGI5gCo.js";
+import { TupleParts } from "./tuple-parts-BxpZLJ7r.js";
+import { CoercedArray } from "./coerced-array-DyA0Yc12.js";
+import { FixedLengthArray, IsEqual, IsNever, NonNegativeInteger, Or, Writable } from "type-fest";
+
+//#region src/sample.d.ts
+type Sampled<T extends IterableContainer, N extends number> = Or<IsEqual<N, 0>, IsEqual<T['length'], 0>> extends true ? [] : IsNever<NonNegativeInteger<N>> extends true ? SampledPrimitive<T> : IsLongerThan<T, N> extends true ? SampledLiteral<T, N> : Writable<T>;
+/**
+ * When N is not a non-negative integer **literal** we can't use it in our
+ * reconstructing logic so we fallback to a simpler definition of the output of
+ * sample, which is any sub-tuple shape of T, of **any length**.
+ */
+type SampledPrimitive<T extends IterableContainer> = [...FixedSubTuples<TupleParts<T>['required']>, ...PartialArray<FixedSubTuples<TupleParts<T>['optional']>>, ...CoercedArray<TupleParts<T>['item']>, ...FixedSubTuples<TupleParts<T>['suffix']>];
+/**
+ * Knowing N is a non-negative literal integer we can construct all sub-tuples
+ * of T that are exactly N elements long.
+ */
+type SampledLiteral<T extends IterableContainer, N extends number> = Extract<FixedSubTuples<[...TupleParts<T>['required'], ...(IsNever<TupleParts<T>['item']> extends true ? [] : NTuple<TupleParts<T>['item'], N>), ...TupleParts<T>['suffix']]>, FixedLengthArray<unknown, N>> | SubSampled<TupleParts<T>['required'], TupleParts<T>['item'], TupleParts<T>['suffix'], N>;
+type SubSampled<Prefix extends ReadonlyArray<unknown>, Item, Suffix extends ReadonlyArray<unknown>, N extends number> = IsLongerThan<[...Prefix, ...Suffix], N> extends true ? never : [...Prefix, ...Suffix]['length'] extends N ? never : [...Prefix, ...Suffix] | SubSampled<[...Prefix, Item], Item, Suffix, N>;
+type IsLongerThan<T extends ReadonlyArray<unknown>, N extends number> = IsEqual<T[N], undefined> extends true ? false : true;
+type FixedSubTuples<T> = T extends readonly [infer Head, ...infer Rest] ? FixedSubTuples<Rest> | [Head, ...FixedSubTuples<Rest>] : [];
+/**
+ * Returns a random subset of size `sampleSize` from `array`.
+ *
+ * Maintains and infers most of the typing information that could be passed
+ * along to the output. This means that when using tuples, the output will be
+ * a tuple too, and when using literals, those literals would be preserved.
+ *
+ * The items in the result are kept in the same order as they are in the input.
+ * If you need to get a shuffled response you can pipe the shuffle function
+ * after this one.
+ *
+ * @param data - The array.
+ * @param sampleSize - The number of elements to take.
+ * @signature
+ *    P.sample(array, sampleSize)
+ * @example
+ *    P.sample(["hello", "world"], 1); // => ["hello"] // typed string[]
+ *    P.sample(["hello", "world"] as const, 1); // => ["world"] // typed ["hello" | "world"]
+ * @dataFirst
+ * @category Array
+ */
+declare function sample<const T extends IterableContainer, N extends number = number>(data: T, sampleSize: N): Sampled<T, N>;
+/**
+ * Returns a random subset of size `sampleSize` from `array`.
+ *
+ * Maintains and infers most of the typing information that could be passed
+ * along to the output. This means that when using tuples, the output will be
+ * a tuple too, and when using literals, those literals would be preserved.
+ *
+ * The items in the result are kept in the same order as they are in the input.
+ * If you need to get a shuffled response you can pipe the shuffle function
+ * after this one.
+ *
+ * @param sampleSize - The number of elements to take.
+ * @signature
+ *    P.sample(sampleSize)(array)
+ * @example
+ *    P.sample(1)(["hello", "world"]); // => ["hello"] // typed string[]
+ *    P.sample(1)(["hello", "world"] as const); // => ["world"] // typed ["hello" | "world"]
+ * @dataLast
+ * @category Array
+ */
+declare function sample<const T extends IterableContainer, N extends number = number>(sampleSize: N): (data: T) => Sampled<T, N>;
+//#endregion
+export { sample };
+//# sourceMappingURL=sample-BHIZQL57.d.ts.map

package/dist/sample-BHIZQL57.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sample-BHIZQL57.d.ts","names":[],"sources":["../src/sample.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/sample-DEt8y7NC.js

@@ -0,0 +1,2 @@
+import{curry as e}from"./curry-CzZjDrpv.js";function t(...t){return e(n,t)}function n(e,t){if(t<=0)return[];if(t>=e.length)return[...e];let n=Math.min(t,e.length-t),r=new Set;for(;r.size<n;){let t=Math.floor(Math.random()*e.length);r.add(t)}return t===n?[...r].sort((e,t)=>e-t).map(t=>e[t]):e.filter((e,t)=>!r.has(t))}export{t as sample};
+//# sourceMappingURL=sample-DEt8y7NC.js.map

package/dist/sample-DEt8y7NC.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sample-DEt8y7NC.js","names":[],"sources":["../src/sample.ts"],"sourcesContent":["import type {\n  FixedLengthArray,\n  IsEqual,\n  IsNever,\n  NonNegativeInteger,\n  Or,\n  Writable,\n} from 'type-fest';\nimport type { CoercedArray } from './internal/types/coerced-array';\nimport type { IterableContainer } from './internal/types/iterable-container';\nimport type { NTuple } from './internal/types/n-tuple';\nimport type { PartialArray } from './internal/types/partial-array';\nimport type { TupleParts } from './internal/types/tuple-parts';\nimport { curry } from './curry';\n\ntype Sampled<T extends IterableContainer, N extends number>\n  = Or<IsEqual<N, 0>, IsEqual<T['length'], 0>> extends true\n    // Short-circuit on trivial inputs.\n    ? []\n    : IsNever<NonNegativeInteger<N>> extends true\n      ? SampledPrimitive<T>\n      : IsLongerThan<T, N> extends true\n        ? SampledLiteral<T, N>\n        // If our tuple can never fulfil the sample size the only valid sample\n        // is the whole input tuple. Because it's a shallow clone we also\n        // strip any readonly-ness.\n        : Writable<T>;\n\n/**\n * When N is not a non-negative integer **literal** we can't use it in our\n * reconstructing logic so we fallback to a simpler definition of the output of\n * sample, which is any sub-tuple shape of T, of **any length**.\n */\ntype SampledPrimitive<T extends IterableContainer> = [\n  ...FixedSubTuples<TupleParts<T>['required']>,\n  // TODO: This might be accurate, but We currently have no tests that check optional elements!\n  ...PartialArray<FixedSubTuples<TupleParts<T>['optional']>>,\n  ...CoercedArray<TupleParts<T>['item']>,\n  ...FixedSubTuples<TupleParts<T>['suffix']>,\n];\n/**\n * Knowing N is a non-negative literal integer we can construct all sub-tuples\n * of T that are exactly N elements long.\n */\ntype SampledLiteral<T extends IterableContainer, N extends number>\n  = | Extract<\n      FixedSubTuples<\n        [\n          ...TupleParts<T>['required'],\n          // TODO: This deliberately ignores optional elements which we don't have tests for either. In order to handle optional elements we can treat the \"optional\" tuple-part as more required elements.\n          // We add N elements of the `item` type to the tuple so that we\n          // consider any combination possible of elements of the prefix items,\n          // any amount of rest items, and suffix items.\n          ...(IsNever<TupleParts<T>['item']> extends true\n            ? []\n            : NTuple<TupleParts<T>['item'], N>),\n          ...TupleParts<T>['suffix'],\n        ]\n      >,\n      // This is just [unknown, unknown, ..., unknown] with N elements.\n      FixedLengthArray<unknown, N>\n    >\n  // In addition to all sub-tuples of length N, we also need to consider all\n  // tuples where the input is shorter than N. This will contribute exactly\n  // one sub-tuple at each length from the minimum length of T and up to N-1.\n    | SubSampled<\n      TupleParts<T>['required'],\n      // TODO: This deliberately ignores optional elements which we don't have tests for either. In order to handle optional elements we can treat the \"optional\" tuple-part as more required elements.\n      TupleParts<T>['item'],\n      TupleParts<T>['suffix'],\n      N\n    >;\n\n// We want to create a union of all sub-tuples where we incrementally add an\n// additional element of the type of the rest element in the middle between the\n// prefix and suffix until we \"fill\" the tuple to size N.\ntype SubSampled<\n  Prefix extends ReadonlyArray<unknown>,\n  Item,\n  Suffix extends ReadonlyArray<unknown>,\n  N extends number,\n>\n  = IsLongerThan<[...Prefix, ...Suffix], N> extends true\n    // We need to prevent overflows in case Prefix and Suffix are already long enough\n    ? never\n    : [...Prefix, ...Suffix]['length'] extends N\n        ? never\n        : [...Prefix, ...Suffix] | SubSampled<[...Prefix, Item], Item, Suffix, N>;\n\ntype IsLongerThan<T extends ReadonlyArray<unknown>, N extends number>\n  // Checking for `undefined` is a neat trick to avoid needing to compare\n  // integer literals because if N overflows the tuple then the type for that\n  // element will be `undefined`. This only works for fixed tuples!\n  = IsEqual<T[N], undefined> extends true ? false : true;\n\n// Assuming T is a fixed tuple we build all it's possible sub-tuples.\ntype FixedSubTuples<T> = T extends readonly [infer Head, ...infer Rest]\n  // For each element we either take it or skip it, and recurse over the rest.\n  ? FixedSubTuples<Rest> | [Head, ...FixedSubTuples<Rest>]\n  : [];\n\n/**\n * Returns a random subset of size `sampleSize` from `array`.\n *\n * Maintains and infers most of the typing information that could be passed\n * along to the output. This means that when using tuples, the output will be\n * a tuple too, and when using literals, those literals would be preserved.\n *\n * The items in the result are kept in the same order as they are in the input.\n * If you need to get a shuffled response you can pipe the shuffle function\n * after this one.\n *\n * @param data - The array.\n * @param sampleSize - The number of elements to take.\n * @signature\n *    P.sample(array, sampleSize)\n * @example\n *    P.sample([\"hello\", \"world\"], 1); // => [\"hello\"] // typed string[]\n *    P.sample([\"hello\", \"world\"] as const, 1); // => [\"world\"] // typed [\"hello\" | \"world\"]\n * @dataFirst\n * @category Array\n */\nexport function sample<const T extends IterableContainer, N extends number = number>(\n  data: T,\n  sampleSize: N,\n): Sampled<T, N>;\n\n/**\n * Returns a random subset of size `sampleSize` from `array`.\n *\n * Maintains and infers most of the typing information that could be passed\n * along to the output. This means that when using tuples, the output will be\n * a tuple too, and when using literals, those literals would be preserved.\n *\n * The items in the result are kept in the same order as they are in the input.\n * If you need to get a shuffled response you can pipe the shuffle function\n * after this one.\n *\n * @param sampleSize - The number of elements to take.\n * @signature\n *    P.sample(sampleSize)(array)\n * @example\n *    P.sample(1)([\"hello\", \"world\"]); // => [\"hello\"] // typed string[]\n *    P.sample(1)([\"hello\", \"world\"] as const); // => [\"world\"] // typed [\"hello\" | \"world\"]\n * @dataLast\n * @category Array\n */\nexport function sample<const T extends IterableContainer, N extends number = number>(\n  sampleSize: N,\n): (data: T) => Sampled<T, N>;\n\nexport function sample(...args: ReadonlyArray<unknown>): unknown {\n  return curry(sampleImplementation, args);\n}\n\nfunction sampleImplementation<T>(\n  data: ReadonlyArray<T>,\n  sampleSize: number,\n): Array<T> {\n  if (sampleSize <= 0) {\n    // Trivial\n    return [];\n  }\n\n  if (sampleSize >= data.length) {\n    // Trivial\n    return [...data];\n  }\n\n  // We have 2 modes of sampling, depending on the size of the sample requested.\n  // 1. If sampleSize is _small_, we generate indices that we then use to\n  // *EXTRACT* individual elements from the array.\n  // 2. If sampleSize is _large_, we instead generate indices to *EXCLUDE* from\n  // a full scan of the input array (via filtering).\n  //\n  // This allows us 2 optimizations that are the core of how this function\n  // works:\n  // 1. It is hard to generate a large number of unique indices, as the more\n  // indices we generate the more likely we are to generate one that is already\n  // in the set, which would require more iterations of the generation loop.\n  // Capping our effective sampleSize at n/2 would put an upper limit to the\n  // average number of iterations required (as a function of n).\n  // 2. If sample size is small enough, we never need to actually iterate over\n  // the full input array at all; instead we simply project the values we need\n  // via random access into the array. This means that for sampleSize (K) less\n  // than n/2, we run at O(klogk). For large sampleSize we need to iterate over\n  // the full input array, but we don't need to sort the indices because we can\n  // use the Set's 'has' method, so we effectively run at O(n).\n  const actualSampleSize = Math.min(sampleSize, data.length - sampleSize);\n\n  const sampleIndices = new Set<number>();\n  while (sampleIndices.size < actualSampleSize) {\n    const randomIndex = Math.floor(Math.random() * data.length);\n    sampleIndices.add(randomIndex);\n  }\n\n  if (sampleSize === actualSampleSize) {\n    return [...sampleIndices]\n      .sort((a, b) => a - b)\n      .map((index) => data[index]!);\n  }\n\n  return data.filter((_, index) => !sampleIndices.has(index));\n}\n"],"mappings":"4CAuJA,SAAgB,EAAO,GAAG,EAAuC,CAC/D,OAAO,EAAM,EAAsB,EAAK,CAG1C,SAAS,EACP,EACA,EACU,CACV,GAAI,GAAc,EAEhB,MAAO,EAAE,CAGX,GAAI,GAAc,EAAK,OAErB,MAAO,CAAC,GAAG,EAAK,CAsBlB,IAAM,EAAmB,KAAK,IAAI,EAAY,EAAK,OAAS,EAAW,CAEjE,EAAgB,IAAI,IAC1B,KAAO,EAAc,KAAO,GAAkB,CAC5C,IAAM,EAAc,KAAK,MAAM,KAAK,QAAQ,CAAG,EAAK,OAAO,CAC3D,EAAc,IAAI,EAAY,CAShC,OANI,IAAe,EACV,CAAC,GAAG,EAAc,CACtB,MAAM,EAAG,IAAM,EAAI,EAAE,CACrB,IAAK,GAAU,EAAK,GAAQ,CAG1B,EAAK,QAAQ,EAAG,IAAU,CAAC,EAAc,IAAI,EAAM,CAAC"}

package/dist/sample-arGcBCIK.cjs

@@ -0,0 +1 @@
+const e=require(`./curry-BPVIsvo3.cjs`);function t(...t){return e.curry(n,t)}function n(e,t){if(t<=0)return[];if(t>=e.length)return[...e];let n=Math.min(t,e.length-t),r=new Set;for(;r.size<n;){let t=Math.floor(Math.random()*e.length);r.add(t)}return t===n?[...r].sort((e,t)=>e-t).map(t=>e[t]):e.filter((e,t)=>!r.has(t))}Object.defineProperty(exports,`sample`,{enumerable:!0,get:function(){return t}});

package/dist/sample.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkALP5JUXXcjs = require('./chunk-ALP5JUXX.cjs');require('./chunk-XR72I63W.cjs');require('./chunk-GZJMERDJ.cjs');require('./chunk-MBGSSEZN.cjs');exports.sample = _chunkALP5JUXXcjs.a;
+require(`./lazy-data-last-impl-3PAFkslW.cjs`),require(`./curry-BPVIsvo3.cjs`);const e=require(`./sample-arGcBCIK.cjs`);exports.sample=e.sample;

package/dist/sample.d.cts

@@ -1,77 +1,8 @@
-import { Or, IsEqual, IsNever, NonNegativeInteger, FixedLengthArray, Writable } from 'type-fest';
-import { C as CoercedArray } from './coerced-array-DRz3tqda.cjs';
-import { I as IterableContainer } from './iterable-container-BTpDVdNc.cjs';
-import { N as NTuple } from './n-tuple-5jljrt4c.cjs';
-import { P as PartialArray } from './partial-array-Vnf1fBtl.cjs';
-import { T as TupleParts } from './tuple-parts-v6av7LMU.cjs';
-import './perkakas-type-error-8wPb8T2y.cjs';
-
-type Sampled<T extends IterableContainer, N extends number> = Or<IsEqual<N, 0>, IsEqual<T['length'], 0>> extends true ? [] : IsNever<NonNegativeInteger<N>> extends true ? SampledPrimitive<T> : IsLongerThan<T, N> extends true ? SampledLiteral<T, N> : Writable<T>;
-/**
- * When N is not a non-negative integer **literal** we can't use it in our
- * reconstructing logic so we fallback to a simpler definition of the output of
- * sample, which is any sub-tuple shape of T, of **any length**.
- */
-type SampledPrimitive<T extends IterableContainer> = [
-    ...FixedSubTuples<TupleParts<T>['required']>,
-    ...PartialArray<FixedSubTuples<TupleParts<T>['optional']>>,
-    ...CoercedArray<TupleParts<T>['item']>,
-    ...FixedSubTuples<TupleParts<T>['suffix']>
-];
-/**
- * Knowing N is a non-negative literal integer we can construct all sub-tuples
- * of T that are exactly N elements long.
- */
-type SampledLiteral<T extends IterableContainer, N extends number> = Extract<FixedSubTuples<[
-    ...TupleParts<T>['required'],
-    ...(IsNever<TupleParts<T>['item']> extends true ? [] : NTuple<TupleParts<T>['item'], N>),
-    ...TupleParts<T>['suffix']
-]>, FixedLengthArray<unknown, N>> | SubSampled<TupleParts<T>['required'], TupleParts<T>['item'], TupleParts<T>['suffix'], N>;
-type SubSampled<Prefix extends ReadonlyArray<unknown>, Item, Suffix extends ReadonlyArray<unknown>, N extends number> = IsLongerThan<[...Prefix, ...Suffix], N> extends true ? never : [...Prefix, ...Suffix]['length'] extends N ? never : [...Prefix, ...Suffix] | SubSampled<[...Prefix, Item], Item, Suffix, N>;
-type IsLongerThan<T extends ReadonlyArray<unknown>, N extends number> = IsEqual<T[N], undefined> extends true ? false : true;
-type FixedSubTuples<T> = T extends readonly [infer Head, ...infer Rest] ? FixedSubTuples<Rest> | [Head, ...FixedSubTuples<Rest>] : [];
-/**
- * Returns a random subset of size `sampleSize` from `array`.
- *
- * Maintains and infers most of the typing information that could be passed
- * along to the output. This means that when using tuples, the output will be
- * a tuple too, and when using literals, those literals would be preserved.
- *
- * The items in the result are kept in the same order as they are in the input.
- * If you need to get a shuffled response you can pipe the shuffle function
- * after this one.
- *
- * @param data - The array.
- * @param sampleSize - The number of elements to take.
- * @signature
- *    P.sample(array, sampleSize)
- * @example
- *    P.sample(["hello", "world"], 1); // => ["hello"] // typed string[]
- *    P.sample(["hello", "world"] as const, 1); // => ["world"] // typed ["hello" | "world"]
- * @dataFirst
- * @category Array
- */
-declare function sample<const T extends IterableContainer, N extends number = number>(data: T, sampleSize: N): Sampled<T, N>;
-/**
- * Returns a random subset of size `sampleSize` from `array`.
- *
- * Maintains and infers most of the typing information that could be passed
- * along to the output. This means that when using tuples, the output will be
- * a tuple too, and when using literals, those literals would be preserved.
- *
- * The items in the result are kept in the same order as they are in the input.
- * If you need to get a shuffled response you can pipe the shuffle function
- * after this one.
- *
- * @param sampleSize - The number of elements to take.
- * @signature
- *    P.sample(sampleSize)(array)
- * @example
- *    P.sample(1)(["hello", "world"]); // => ["hello"] // typed string[]
- *    P.sample(1)(["hello", "world"] as const); // => ["world"] // typed ["hello" | "world"]
- * @dataLast
- * @category Array
- */
-declare function sample<const T extends IterableContainer, N extends number = number>(sampleSize: N): (data: T) => Sampled<T, N>;
-
-export { sample };
+import "./iterable-container-V5sa0V_H.cjs";
+import "./n-tuple-Co_jgwEn.cjs";
+import "./partial-array-CzOnr197.cjs";
+import "./perkakas-type-error-0tHtaPbi.cjs";
+import "./tuple-parts-BIyABPYv.cjs";
+import "./coerced-array-kVJtBrMl.cjs";
+import { sample } from "./sample-9vI5EmCM.cjs";
+export { sample };

package/dist/sample.d.ts

@@ -1,77 +1,8 @@
-import { Or, IsEqual, IsNever, NonNegativeInteger, FixedLengthArray, Writable } from 'type-fest';
-import { C as CoercedArray } from './coerced-array-DRz3tqda.js';
-import { I as IterableContainer } from './iterable-container-BTpDVdNc.js';
-import { N as NTuple } from './n-tuple-5jljrt4c.js';
-import { P as PartialArray } from './partial-array-Vnf1fBtl.js';
-import { T as TupleParts } from './tuple-parts-BTivqbtT.js';
-import './perkakas-type-error-8wPb8T2y.js';
-
-type Sampled<T extends IterableContainer, N extends number> = Or<IsEqual<N, 0>, IsEqual<T['length'], 0>> extends true ? [] : IsNever<NonNegativeInteger<N>> extends true ? SampledPrimitive<T> : IsLongerThan<T, N> extends true ? SampledLiteral<T, N> : Writable<T>;
-/**
- * When N is not a non-negative integer **literal** we can't use it in our
- * reconstructing logic so we fallback to a simpler definition of the output of
- * sample, which is any sub-tuple shape of T, of **any length**.
- */
-type SampledPrimitive<T extends IterableContainer> = [
-    ...FixedSubTuples<TupleParts<T>['required']>,
-    ...PartialArray<FixedSubTuples<TupleParts<T>['optional']>>,
-    ...CoercedArray<TupleParts<T>['item']>,
-    ...FixedSubTuples<TupleParts<T>['suffix']>
-];
-/**
- * Knowing N is a non-negative literal integer we can construct all sub-tuples
- * of T that are exactly N elements long.
- */
-type SampledLiteral<T extends IterableContainer, N extends number> = Extract<FixedSubTuples<[
-    ...TupleParts<T>['required'],
-    ...(IsNever<TupleParts<T>['item']> extends true ? [] : NTuple<TupleParts<T>['item'], N>),
-    ...TupleParts<T>['suffix']
-]>, FixedLengthArray<unknown, N>> | SubSampled<TupleParts<T>['required'], TupleParts<T>['item'], TupleParts<T>['suffix'], N>;
-type SubSampled<Prefix extends ReadonlyArray<unknown>, Item, Suffix extends ReadonlyArray<unknown>, N extends number> = IsLongerThan<[...Prefix, ...Suffix], N> extends true ? never : [...Prefix, ...Suffix]['length'] extends N ? never : [...Prefix, ...Suffix] | SubSampled<[...Prefix, Item], Item, Suffix, N>;
-type IsLongerThan<T extends ReadonlyArray<unknown>, N extends number> = IsEqual<T[N], undefined> extends true ? false : true;
-type FixedSubTuples<T> = T extends readonly [infer Head, ...infer Rest] ? FixedSubTuples<Rest> | [Head, ...FixedSubTuples<Rest>] : [];
-/**
- * Returns a random subset of size `sampleSize` from `array`.
- *
- * Maintains and infers most of the typing information that could be passed
- * along to the output. This means that when using tuples, the output will be
- * a tuple too, and when using literals, those literals would be preserved.
- *
- * The items in the result are kept in the same order as they are in the input.
- * If you need to get a shuffled response you can pipe the shuffle function
- * after this one.
- *
- * @param data - The array.
- * @param sampleSize - The number of elements to take.
- * @signature
- *    P.sample(array, sampleSize)
- * @example
- *    P.sample(["hello", "world"], 1); // => ["hello"] // typed string[]
- *    P.sample(["hello", "world"] as const, 1); // => ["world"] // typed ["hello" | "world"]
- * @dataFirst
- * @category Array
- */
-declare function sample<const T extends IterableContainer, N extends number = number>(data: T, sampleSize: N): Sampled<T, N>;
-/**
- * Returns a random subset of size `sampleSize` from `array`.
- *
- * Maintains and infers most of the typing information that could be passed
- * along to the output. This means that when using tuples, the output will be
- * a tuple too, and when using literals, those literals would be preserved.
- *
- * The items in the result are kept in the same order as they are in the input.
- * If you need to get a shuffled response you can pipe the shuffle function
- * after this one.
- *
- * @param sampleSize - The number of elements to take.
- * @signature
- *    P.sample(sampleSize)(array)
- * @example
- *    P.sample(1)(["hello", "world"]); // => ["hello"] // typed string[]
- *    P.sample(1)(["hello", "world"] as const); // => ["world"] // typed ["hello" | "world"]
- * @dataLast
- * @category Array
- */
-declare function sample<const T extends IterableContainer, N extends number = number>(sampleSize: N): (data: T) => Sampled<T, N>;
-
-export { sample };
+import "./iterable-container-wtkYslN_.js";
+import "./n-tuple-BELi5yRe.js";
+import "./partial-array-IoGI5gCo.js";
+import "./perkakas-type-error-Da3ni385.js";
+import "./tuple-parts-BxpZLJ7r.js";
+import "./coerced-array-DyA0Yc12.js";
+import { sample } from "./sample-BHIZQL57.js";
+export { sample };

package/dist/sample.js

@@ -1 +1 @@
-import{a}from"./chunk-4Y6VRHEP.js";import"./chunk-J6WPJH72.js";import"./chunk-KGPDVVVV.js";import"./chunk-EK7ODJWE.js";export{a as sample};
+import"./lazy-data-last-impl-7QfM1xXg.js";import"./curry-CzZjDrpv.js";import{sample as e}from"./sample-DEt8y7NC.js";export{e as sample};