@vinicunca/perkakas 0.5.4 → 1.0.0

package/dist/reduce.d.cts

@@ -0,0 +1,51 @@
+/**
+ * Executes a user-supplied "reducer" callback function on each element of the
+ * array, in order, passing in the return value from the calculation on the
+ * preceding element. The final result of running the reducer across all
+ * elements of the array is a single value. Equivalent to
+ * `Array.prototype.reduce`.
+ *
+ * @param data - The items to reduce.
+ * @param callbackfn - A function to execute for each element in the array. Its
+ * return value becomes the value of the accumulator parameter on the next
+ * invocation of callbackFn. For the last invocation, the return value becomes
+ * the return value of reduce().
+ * @param initialValue - A value to which accumulator is initialized the first
+ * time the callback is called. CallbackFn starts executing with the first value
+ * in the array as currentValue.
+ * @returns The value that results from running the "reducer" callback function
+ * to completion over the entire array.
+ * @signature
+ *    P.reduce(data, callbackfn, initialValue)
+ * @example
+ *    P.reduce([1, 2, 3, 4, 5], (acc, x) => acc + x, 100) // => 115
+ * @dataFirst
+ * @category Array
+ */
+declare function reduce<T, U>(data: ReadonlyArray<T>, callbackfn: (previousValue: U, currentValue: T, currentIndex: number, data: ReadonlyArray<T>) => U, initialValue: U): U;
+/**
+ * Executes a user-supplied "reducer" callback function on each element of the
+ * array, in order, passing in the return value from the calculation on the
+ * preceding element. The final result of running the reducer across all
+ * elements of the array is a single value. Equivalent to
+ * `Array.prototype.reduce`.
+ *
+ * @param callbackfn - A function to execute for each element in the array. Its
+ * return value becomes the value of the accumulator parameter on the next
+ * invocation of callbackFn. For the last invocation, the return value becomes
+ * the return value of reduce().
+ * @param initialValue - A value to which accumulator is initialized the first
+ * time the callback is called. CallbackFn starts executing with the first value
+ * in the array as currentValue.
+ * @returns The value that results from running the "reducer" callback function
+ * to completion over the entire array.
+ * @signature
+ *    P.reduce(fn, initialValue)(array)
+ * @example
+ *    P.pipe([1, 2, 3, 4, 5], P.reduce((acc, x) => acc + x, 100)) // => 115
+ * @dataLast
+ * @category Array
+ */
+declare function reduce<T, U>(callbackfn: (previousValue: U, currentValue: T, currentIndex: number, data: ReadonlyArray<T>) => U, initialValue: U): (data: ReadonlyArray<T>) => U;
+
+export { reduce };

package/dist/reduce.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Executes a user-supplied "reducer" callback function on each element of the
+ * array, in order, passing in the return value from the calculation on the
+ * preceding element. The final result of running the reducer across all
+ * elements of the array is a single value. Equivalent to
+ * `Array.prototype.reduce`.
+ *
+ * @param data - The items to reduce.
+ * @param callbackfn - A function to execute for each element in the array. Its
+ * return value becomes the value of the accumulator parameter on the next
+ * invocation of callbackFn. For the last invocation, the return value becomes
+ * the return value of reduce().
+ * @param initialValue - A value to which accumulator is initialized the first
+ * time the callback is called. CallbackFn starts executing with the first value
+ * in the array as currentValue.
+ * @returns The value that results from running the "reducer" callback function
+ * to completion over the entire array.
+ * @signature
+ *    P.reduce(data, callbackfn, initialValue)
+ * @example
+ *    P.reduce([1, 2, 3, 4, 5], (acc, x) => acc + x, 100) // => 115
+ * @dataFirst
+ * @category Array
+ */
+declare function reduce<T, U>(data: ReadonlyArray<T>, callbackfn: (previousValue: U, currentValue: T, currentIndex: number, data: ReadonlyArray<T>) => U, initialValue: U): U;
+/**
+ * Executes a user-supplied "reducer" callback function on each element of the
+ * array, in order, passing in the return value from the calculation on the
+ * preceding element. The final result of running the reducer across all
+ * elements of the array is a single value. Equivalent to
+ * `Array.prototype.reduce`.
+ *
+ * @param callbackfn - A function to execute for each element in the array. Its
+ * return value becomes the value of the accumulator parameter on the next
+ * invocation of callbackFn. For the last invocation, the return value becomes
+ * the return value of reduce().
+ * @param initialValue - A value to which accumulator is initialized the first
+ * time the callback is called. CallbackFn starts executing with the first value
+ * in the array as currentValue.
+ * @returns The value that results from running the "reducer" callback function
+ * to completion over the entire array.
+ * @signature
+ *    P.reduce(fn, initialValue)(array)
+ * @example
+ *    P.pipe([1, 2, 3, 4, 5], P.reduce((acc, x) => acc + x, 100)) // => 115
+ * @dataLast
+ * @category Array
+ */
+declare function reduce<T, U>(callbackfn: (previousValue: U, currentValue: T, currentIndex: number, data: ReadonlyArray<T>) => U, initialValue: U): (data: ReadonlyArray<T>) => U;
+
+export { reduce };

package/dist/reduce.js

@@ -0,0 +1 @@
+import{a}from"./chunk-7DDJ7DZF.js";import"./chunk-JFXZ246Y.js";import"./chunk-KQGY2DBY.js";export{a as reduce};

package/dist/reverse.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkH7YM6WEOcjs = require('./chunk-H7YM6WEO.cjs');require('./chunk-Y74ER22O.cjs');require('./chunk-7T4AVFYJ.cjs');exports.reverse = _chunkH7YM6WEOcjs.a;

package/dist/reverse.d.cts

@@ -0,0 +1,27 @@
+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 };

package/dist/reverse.d.ts

@@ -0,0 +1,27 @@
+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 };

package/dist/reverse.js

@@ -0,0 +1 @@
+import{a}from"./chunk-43F3C5SP.js";import"./chunk-JFXZ246Y.js";import"./chunk-KQGY2DBY.js";export{a as reverse};

package/dist/round.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkR22OILXQcjs = require('./chunk-R22OILXQ.cjs');require('./chunk-WBJ2VSGC.cjs');require('./chunk-Y74ER22O.cjs');require('./chunk-7T4AVFYJ.cjs');exports.round = _chunkR22OILXQcjs.a;

package/dist/round.d.cts

@@ -0,0 +1,37 @@
+/**
+ * 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 };

package/dist/round.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 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 };

package/dist/round.js

@@ -0,0 +1 @@
+import{a}from"./chunk-F7KW3CUF.js";import"./chunk-KCUIAELF.js";import"./chunk-JFXZ246Y.js";import"./chunk-KQGY2DBY.js";export{a as round};

package/dist/sample.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkPHSDYGVDcjs = require('./chunk-PHSDYGVD.cjs');require('./chunk-Y74ER22O.cjs');require('./chunk-7T4AVFYJ.cjs');exports.sample = _chunkPHSDYGVDcjs.a;

package/dist/sample.d.cts

@@ -0,0 +1,54 @@
+import { I as IterableContainer } from './types-DCY4LHuA.cjs';
+import 'type-fest';
+
+type Sampled<T extends IterableContainer, N extends number> = number extends N ? SampledGeneric<T> : undefined extends T[N] ? T : SampledLiteral<T, N>;
+type SampledGeneric<T extends IterableContainer> = T[number] extends never ? T : T extends readonly [infer First, ...infer Rest] ? [First, ...SampledGeneric<Rest>] | SampledGeneric<Rest> : Array<T[number]>;
+type SampledLiteral<T extends IterableContainer, N extends number, Iteration extends Array<unknown> = []> = Iteration['length'] extends N ? [] : T extends readonly [infer First, ...infer Tail] ? [
+    First | Tail[number],
+    ...SampledLiteral<Tail, N, [unknown, ...Iteration]>
+] : T extends readonly [...infer Head, infer Last] ? [...SampledLiteral<Head, N, [unknown, ...Iteration]>, Last] : [T[number], ...SampledLiteral<T, N, [unknown, ...Iteration]>] | SampledLiteral<T, N, [unknown, ...Iteration]>;
+/**
+ * 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<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<T extends IterableContainer, N extends number = number>(sampleSize: N): (data: T) => Sampled<T, N>;
+
+export { sample };

package/dist/sample.d.ts

@@ -0,0 +1,54 @@
+import { I as IterableContainer } from './types-DCY4LHuA.js';
+import 'type-fest';
+
+type Sampled<T extends IterableContainer, N extends number> = number extends N ? SampledGeneric<T> : undefined extends T[N] ? T : SampledLiteral<T, N>;
+type SampledGeneric<T extends IterableContainer> = T[number] extends never ? T : T extends readonly [infer First, ...infer Rest] ? [First, ...SampledGeneric<Rest>] | SampledGeneric<Rest> : Array<T[number]>;
+type SampledLiteral<T extends IterableContainer, N extends number, Iteration extends Array<unknown> = []> = Iteration['length'] extends N ? [] : T extends readonly [infer First, ...infer Tail] ? [
+    First | Tail[number],
+    ...SampledLiteral<Tail, N, [unknown, ...Iteration]>
+] : T extends readonly [...infer Head, infer Last] ? [...SampledLiteral<Head, N, [unknown, ...Iteration]>, Last] : [T[number], ...SampledLiteral<T, N, [unknown, ...Iteration]>] | SampledLiteral<T, N, [unknown, ...Iteration]>;
+/**
+ * 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<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<T extends IterableContainer, N extends number = number>(sampleSize: N): (data: T) => Sampled<T, N>;
+
+export { sample };

package/dist/sample.js

@@ -0,0 +1 @@
+import{a}from"./chunk-E2NINCLI.js";import"./chunk-JFXZ246Y.js";import"./chunk-KQGY2DBY.js";export{a as sample};

package/dist/set-path.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkNNU5DU4Fcjs = require('./chunk-NNU5DU4F.cjs');require('./chunk-Y74ER22O.cjs');require('./chunk-7T4AVFYJ.cjs');exports.setPath = _chunkNNU5DU4Fcjs.a; exports.setPathImplementation = _chunkNNU5DU4Fcjs.b;

package/dist/set-path.d.cts

@@ -0,0 +1,40 @@
+type Path<T, Prefix extends ReadonlyArray<unknown> = readonly []> = T extends ReadonlyArray<unknown> ? Path<T[number], readonly [...Prefix, number]> | Prefix : T extends object ? 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 extends Path<T>> = TPath extends readonly [
+    infer Head,
+    ...infer Rest
+] ? Head extends keyof T ? Rest extends Path<T[Head]> ? ValueAtPath<T[Head], Rest> : never : never : T;
+/**
+ * Sets the value at `path` of `object`.
+ *
+ * For simple cases where the path is only one level deep, prefer `set` instead.
+ *
+ * @param data - The target method.
+ * @param path - The array of properties.
+ * @param value - The value to set.
+ * @signature
+ *    P.setPath(obj, path, value)
+ * @example
+ *    P.setPath({ a: { b: 1 } }, ['a', 'b'], 2) // => { a: { b: 2 } }
+ * @dataFirst
+ * @category Object
+ */
+declare function setPath<T, TPath extends Path<T>>(data: T, path: TPath, value: ValueAtPath<T, TPath>): T;
+/**
+ * Sets the value at `path` of `object`.
+ *
+ * @param path - The array of properties.
+ * @param value - The value to set.
+ * @signature
+ *    P.setPath(path, value)(obj)
+ * @example
+ *    P.pipe({ a: { b: 1 } }, P.setPath(['a', 'b'], 2)) // { a: { b: 2 } }
+ * @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 setPathImplementation(data: unknown, path: ReadonlyArray<PropertyKey>, value: unknown): unknown;
+
+export { setPath, setPathImplementation };

package/dist/set-path.d.ts

@@ -0,0 +1,40 @@
+type Path<T, Prefix extends ReadonlyArray<unknown> = readonly []> = T extends ReadonlyArray<unknown> ? Path<T[number], readonly [...Prefix, number]> | Prefix : T extends object ? 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 extends Path<T>> = TPath extends readonly [
+    infer Head,
+    ...infer Rest
+] ? Head extends keyof T ? Rest extends Path<T[Head]> ? ValueAtPath<T[Head], Rest> : never : never : T;
+/**
+ * Sets the value at `path` of `object`.
+ *
+ * For simple cases where the path is only one level deep, prefer `set` instead.
+ *
+ * @param data - The target method.
+ * @param path - The array of properties.
+ * @param value - The value to set.
+ * @signature
+ *    P.setPath(obj, path, value)
+ * @example
+ *    P.setPath({ a: { b: 1 } }, ['a', 'b'], 2) // => { a: { b: 2 } }
+ * @dataFirst
+ * @category Object
+ */
+declare function setPath<T, TPath extends Path<T>>(data: T, path: TPath, value: ValueAtPath<T, TPath>): T;
+/**
+ * Sets the value at `path` of `object`.
+ *
+ * @param path - The array of properties.
+ * @param value - The value to set.
+ * @signature
+ *    P.setPath(path, value)(obj)
+ * @example
+ *    P.pipe({ a: { b: 1 } }, P.setPath(['a', 'b'], 2)) // { a: { b: 2 } }
+ * @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 setPathImplementation(data: unknown, path: ReadonlyArray<PropertyKey>, value: unknown): unknown;
+
+export { setPath, setPathImplementation };

package/dist/set-path.js

@@ -0,0 +1 @@
+import{a,b}from"./chunk-NQR6HZYF.js";import"./chunk-JFXZ246Y.js";import"./chunk-KQGY2DBY.js";export{a as setPath,b as setPathImplementation};

package/dist/set.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunk7EJQW5L6cjs = require('./chunk-7EJQW5L6.cjs');require('./chunk-Y74ER22O.cjs');require('./chunk-7T4AVFYJ.cjs');exports.set = _chunk7EJQW5L6cjs.a;

package/dist/set.d.cts

@@ -0,0 +1,38 @@
+import { U as UpsertProp } from './types-DCY4LHuA.cjs';
+import 'type-fest';
+
+/**
+ * Sets the `value` at `prop` of `object`.
+ *
+ * To add a new property to an object, or to override its type, use `addProp`
+ * instead, and to set a property within a nested object use `setPath`.
+ *
+ * @param obj - The target method.
+ * @param prop - The property name.
+ * @param value - The value to set.
+ * @signature
+ *    P.set(obj, prop, value)
+ * @example
+ *    P.set({ a: 1 }, 'a', 2) // => { a: 2 }
+ * @dataFirst
+ * @category Object
+ */
+declare function set<T, K extends keyof T, V extends Required<T>[K]>(obj: T, prop: K, value: V): UpsertProp<T, K, V>;
+/**
+ * Sets the `value` at `prop` of `object`.
+ *
+ * To add a new property to an object, or to override it's type use `addProp`
+ * instead.
+ *
+ * @param prop - The property name.
+ * @param value - The value to set.
+ * @signature
+ *    P.set(prop, value)(obj)
+ * @example
+ *    P.pipe({ a: 1 }, P.set('a', 2)) // => { a: 2 }
+ * @dataLast
+ * @category Object
+ */
+declare function set<T, K extends keyof T, V extends Required<T>[K]>(prop: K, value: V): (obj: T) => UpsertProp<T, K, V>;
+
+export { set };

package/dist/set.d.ts

@@ -0,0 +1,38 @@
+import { U as UpsertProp } from './types-DCY4LHuA.js';
+import 'type-fest';
+
+/**
+ * Sets the `value` at `prop` of `object`.
+ *
+ * To add a new property to an object, or to override its type, use `addProp`
+ * instead, and to set a property within a nested object use `setPath`.
+ *
+ * @param obj - The target method.
+ * @param prop - The property name.
+ * @param value - The value to set.
+ * @signature
+ *    P.set(obj, prop, value)
+ * @example
+ *    P.set({ a: 1 }, 'a', 2) // => { a: 2 }
+ * @dataFirst
+ * @category Object
+ */
+declare function set<T, K extends keyof T, V extends Required<T>[K]>(obj: T, prop: K, value: V): UpsertProp<T, K, V>;
+/**
+ * Sets the `value` at `prop` of `object`.
+ *
+ * To add a new property to an object, or to override it's type use `addProp`
+ * instead.
+ *
+ * @param prop - The property name.
+ * @param value - The value to set.
+ * @signature
+ *    P.set(prop, value)(obj)
+ * @example
+ *    P.pipe({ a: 1 }, P.set('a', 2)) // => { a: 2 }
+ * @dataLast
+ * @category Object
+ */
+declare function set<T, K extends keyof T, V extends Required<T>[K]>(prop: K, value: V): (obj: T) => UpsertProp<T, K, V>;
+
+export { set };

package/dist/set.js

@@ -0,0 +1 @@
+import{a}from"./chunk-QIM2PMWS.js";import"./chunk-JFXZ246Y.js";import"./chunk-KQGY2DBY.js";export{a as set};

package/dist/shuffle.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkNNK6R67Ecjs = require('./chunk-NNK6R67E.cjs');require('./chunk-Y74ER22O.cjs');require('./chunk-7T4AVFYJ.cjs');exports.shuffle = _chunkNNK6R67Ecjs.a;

package/dist/shuffle.d.cts

@@ -0,0 +1,25 @@
+/**
+ * Shuffles the input array, returning a new array with the same elements in a random order.
+ *
+ * @param items - The array to shuffle.
+ * @signature
+ *    P.shuffle(array)
+ * @example
+ *    P.shuffle([4, 2, 7, 5]) // => [7, 5, 4, 2]
+ * @dataFirst
+ * @category Array
+ */
+declare function shuffle<T>(items: ReadonlyArray<T>): Array<T>;
+/**
+ * Shuffles the input array, returning a new array with the same elements in a random order.
+ *
+ * @signature
+ *    P.shuffle()(array)
+ * @example
+ *    P.pipe([4, 2, 7, 5], P.shuffle()) // => [7, 5, 4, 2]
+ * @dataLast
+ * @category Array
+ */
+declare function shuffle<T>(): (items: ReadonlyArray<T>) => Array<T>;
+
+export { shuffle };

package/dist/shuffle.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Shuffles the input array, returning a new array with the same elements in a random order.
+ *
+ * @param items - The array to shuffle.
+ * @signature
+ *    P.shuffle(array)
+ * @example
+ *    P.shuffle([4, 2, 7, 5]) // => [7, 5, 4, 2]
+ * @dataFirst
+ * @category Array
+ */
+declare function shuffle<T>(items: ReadonlyArray<T>): Array<T>;
+/**
+ * Shuffles the input array, returning a new array with the same elements in a random order.
+ *
+ * @signature
+ *    P.shuffle()(array)
+ * @example
+ *    P.pipe([4, 2, 7, 5], P.shuffle()) // => [7, 5, 4, 2]
+ * @dataLast
+ * @category Array
+ */
+declare function shuffle<T>(): (items: ReadonlyArray<T>) => Array<T>;
+
+export { shuffle };

package/dist/shuffle.js

@@ -0,0 +1 @@
+import{a}from"./chunk-HUWRVMPE.js";import"./chunk-JFXZ246Y.js";import"./chunk-KQGY2DBY.js";export{a as shuffle};

package/dist/sleep.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkHC3HZK4Qcjs = require('./chunk-HC3HZK4Q.cjs');exports.sleep = _chunkHC3HZK4Qcjs.a;

package/dist/sleep.d.cts

@@ -0,0 +1,15 @@
+/**
+ * Delay execution for a given number of milliseconds.
+ *
+ * @param timeout the number of milliseconds to wait
+ * @signature
+ *  sleep(timeout)
+ * @example
+ *  import { sleep } from '@vinicunca/perkakas';
+ *
+ *  sleep(1000); // => Promise<void>
+ * @category Function
+ */
+declare function sleep(timeout: number): Promise<void>;
+
+export { sleep };

package/dist/sleep.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Delay execution for a given number of milliseconds.
+ *
+ * @param timeout the number of milliseconds to wait
+ * @signature
+ *  sleep(timeout)
+ * @example
+ *  import { sleep } from '@vinicunca/perkakas';
+ *
+ *  sleep(1000); // => Promise<void>
+ * @category Function
+ */
+declare function sleep(timeout: number): Promise<void>;
+
+export { sleep };

package/dist/sleep.js

@@ -0,0 +1 @@
+import{a}from"./chunk-6SYP2DRD.js";export{a as sleep};

package/dist/slice-string.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunk3WCOFJCScjs = require('./chunk-3WCOFJCS.cjs');exports.sliceString = _chunk3WCOFJCScjs.a;