@pithos/core 2.0.0

package/dist/taphos/collection/uniq.js

@@ -0,0 +1,34 @@
+/**
+ * Creates a duplicate-free version of an array, using SameValueZero for equality comparisons.
+ *
+ * @template T - The type of elements in the array.
+ * @param array - The array to inspect.
+ * @returns The new duplicate free array.
+ * @deprecated Use `[...new Set(array)]` or `Array.from(new Set(array))` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Set | Set - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_set | Browser support - Can I Use}
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/from | Array.from() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_array_from | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * const numbers = [1, 2, 2, 3, 3, 3, 4];
+ *
+ * // ❌ Deprecated approach
+ * const uniqueNumbers = uniq(numbers);
+ * console.log(uniqueNumbers); // [1, 2, 3, 4]
+ *
+ * // ✅ Recommended approach
+ * const uniqueNumbersNative = [...new Set(numbers)];
+ * console.log(uniqueNumbersNative); // [1, 2, 3, 4]
+ *
+ * // ✅ Alternative approach
+ * const uniqueNumbersFrom = Array.from(new Set(numbers));
+ * console.log(uniqueNumbersFrom); // [1, 2, 3, 4]
+ * ```
+ */
+export function uniq(array) {
+    return [...new Set(array)];
+}
+//# sourceMappingURL=uniq.js.map

package/dist/taphos/collection/uniq.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniq.js","sourceRoot":"","sources":["../../../src/taphos/collection/uniq.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,IAAI,CAAI,KAAU;IAChC,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7B,CAAC"}

package/dist/taphos/date/now.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Returns the number of milliseconds elapsed since January 1, 1970 00:00:00 UTC.
+ *
+ * @returns The current Unix timestamp in milliseconds.
+ * @deprecated Use `Date.now()` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/now | Date.now() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_date_now | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * const timestamp = now();
+ *
+ * // ✅ Recommended approach
+ * const timestamp = Date.now();
+ * ```
+ */
+export declare function now(): number;
+//# sourceMappingURL=now.d.ts.map

package/dist/taphos/date/now.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"now.d.ts","sourceRoot":"","sources":["../../../src/taphos/date/now.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,GAAG,IAAI,MAAM,CAE5B"}

package/dist/taphos/date/now.js

@@ -0,0 +1,22 @@
+/**
+ * Returns the number of milliseconds elapsed since January 1, 1970 00:00:00 UTC.
+ *
+ * @returns The current Unix timestamp in milliseconds.
+ * @deprecated Use `Date.now()` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/now | Date.now() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_date_now | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * const timestamp = now();
+ *
+ * // ✅ Recommended approach
+ * const timestamp = Date.now();
+ * ```
+ */
+export function now() {
+    return Date.now();
+}
+//# sourceMappingURL=now.js.map

package/dist/taphos/date/now.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"now.js","sourceRoot":"","sources":["../../../src/taphos/date/now.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,GAAG;IACjB,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC;AACpB,CAAC"}

package/dist/taphos/function/bind.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Creates a function bound to a given object (thisArg), with optional partial application of arguments.
+ *
+ * @template Func - The type of the function to bind.
+ * @param func - The function to bind.
+ * @param thisArg - The this binding of func.
+ * @param partials - The arguments to be partially applied.
+ * @returns The new bound function.
+ * @deprecated Use `function.bind(thisArg, ...args)` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function/bind | Function.bind() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_function_bind | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * const obj = {
+ *   name: 'John',
+ *   greet: function(greeting: string, punctuation: string) {
+ *     return `${greeting} ${this.name}${punctuation}`;
+ *   }
+ * };
+ *
+ * // ❌ Deprecated approach
+ * const boundGreet = bind(obj.greet, obj, 'Hello');
+ * console.log(boundGreet('!')); // "Hello John!"
+ *
+ * // ✅ Recommended approach
+ * const boundGreetNative = obj.greet.bind(obj, 'Hello');
+ * console.log(boundGreetNative('!')); // "Hello John!"
+ *
+ * // ✅ Alternative with arrow function (no this binding needed)
+ * const greetArrow = (greeting: string, punctuation: string) =>
+ *   `${greeting} ${obj.name}${punctuation}`;
+ * const boundGreetArrow = greetArrow.bind(null, 'Hello');
+ * console.log(boundGreetArrow('!')); // "Hello John!"
+ * ```
+ */
+export declare function bind<Func extends (...args: any[]) => any>(func: Func, thisArg: any, ...partials: any[]): (...args: any[]) => ReturnType<Func>;
+//# sourceMappingURL=bind.d.ts.map

package/dist/taphos/function/bind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bind.d.ts","sourceRoot":"","sources":["../../../src/taphos/function/bind.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,wBAAgB,IAAI,CAAC,IAAI,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACvD,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,GAAG,EACZ,GAAG,QAAQ,EAAE,GAAG,EAAE,GACjB,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,UAAU,CAAC,IAAI,CAAC,CAEtC"}

package/dist/taphos/function/bind.js

@@ -0,0 +1,42 @@
+/**
+ * Creates a function bound to a given object (thisArg), with optional partial application of arguments.
+ *
+ * @template Func - The type of the function to bind.
+ * @param func - The function to bind.
+ * @param thisArg - The this binding of func.
+ * @param partials - The arguments to be partially applied.
+ * @returns The new bound function.
+ * @deprecated Use `function.bind(thisArg, ...args)` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function/bind | Function.bind() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_function_bind | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * const obj = {
+ *   name: 'John',
+ *   greet: function(greeting: string, punctuation: string) {
+ *     return `${greeting} ${this.name}${punctuation}`;
+ *   }
+ * };
+ *
+ * // ❌ Deprecated approach
+ * const boundGreet = bind(obj.greet, obj, 'Hello');
+ * console.log(boundGreet('!')); // "Hello John!"
+ *
+ * // ✅ Recommended approach
+ * const boundGreetNative = obj.greet.bind(obj, 'Hello');
+ * console.log(boundGreetNative('!')); // "Hello John!"
+ *
+ * // ✅ Alternative with arrow function (no this binding needed)
+ * const greetArrow = (greeting: string, punctuation: string) =>
+ *   `${greeting} ${obj.name}${punctuation}`;
+ * const boundGreetArrow = greetArrow.bind(null, 'Hello');
+ * console.log(boundGreetArrow('!')); // "Hello John!"
+ * ```
+ */
+// INTENTIONAL: `any` required for Function.bind() compatibility - thisArg and partials have no type constraints in native bind
+export function bind(func, thisArg, ...partials) {
+    return func.bind(thisArg, ...partials);
+}
+//# sourceMappingURL=bind.js.map

package/dist/taphos/function/bind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bind.js","sourceRoot":"","sources":["../../../src/taphos/function/bind.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,+HAA+H;AAC/H,MAAM,UAAU,IAAI,CAClB,IAAU,EACV,OAAY,EACZ,GAAG,QAAe;IAElB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC,CAAC;AACzC,CAAC"}

package/dist/taphos/function/defer.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Defers invoking the function until the current call stack has cleared.
+ *
+ * @param func - The function to defer.
+ * @param args - The arguments to invoke the function with.
+ * @returns The timer id.
+ * @deprecated Use `setTimeout(fn, 0)` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/setTimeout | setTimeout() - MDN}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * defer(console.log, 'deferred');
+ *
+ * // ✅ Recommended approach
+ * setTimeout(() => console.log('deferred'), 0);
+ * ```
+ */
+export declare function defer<Args extends unknown[]>(func: (...args: Args) => void, ...args: Args): ReturnType<typeof setTimeout>;
+//# sourceMappingURL=defer.d.ts.map

package/dist/taphos/function/defer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defer.d.ts","sourceRoot":"","sources":["../../../src/taphos/function/defer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,KAAK,CAAC,IAAI,SAAS,OAAO,EAAE,EAC1C,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,IAAI,EAC7B,GAAG,IAAI,EAAE,IAAI,GACZ,UAAU,CAAC,OAAO,UAAU,CAAC,CAE/B"}

package/dist/taphos/function/defer.js

@@ -0,0 +1,23 @@
+/**
+ * Defers invoking the function until the current call stack has cleared.
+ *
+ * @param func - The function to defer.
+ * @param args - The arguments to invoke the function with.
+ * @returns The timer id.
+ * @deprecated Use `setTimeout(fn, 0)` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/setTimeout | setTimeout() - MDN}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * defer(console.log, 'deferred');
+ *
+ * // ✅ Recommended approach
+ * setTimeout(() => console.log('deferred'), 0);
+ * ```
+ */
+export function defer(func, ...args) {
+    return setTimeout(() => func(...args), 0);
+}
+//# sourceMappingURL=defer.js.map

package/dist/taphos/function/defer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defer.js","sourceRoot":"","sources":["../../../src/taphos/function/defer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,KAAK,CACnB,IAA6B,EAC7B,GAAG,IAAU;IAEb,OAAO,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;AAC5C,CAAC"}

package/dist/taphos/function/delay.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Invokes func after wait milliseconds.
+ *
+ * @param func - The function to delay.
+ * @param wait - The number of milliseconds to delay invocation.
+ * @param args - The arguments to invoke the function with.
+ * @returns The timer id.
+ * @deprecated Use `setTimeout(fn, wait)` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/setTimeout | setTimeout() - MDN}
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * delay(console.log, 1000, 'later');
+ *
+ * // ✅ Recommended approach
+ * setTimeout(() => console.log('later'), 1000);
+ * ```
+ */
+export declare function delay<Args extends unknown[]>(func: (...args: Args) => void, wait: number, ...args: Args): ReturnType<typeof setTimeout>;
+//# sourceMappingURL=delay.d.ts.map

package/dist/taphos/function/delay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delay.d.ts","sourceRoot":"","sources":["../../../src/taphos/function/delay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,KAAK,CAAC,IAAI,SAAS,OAAO,EAAE,EAC1C,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,IAAI,EAC7B,IAAI,EAAE,MAAM,EACZ,GAAG,IAAI,EAAE,IAAI,GACZ,UAAU,CAAC,OAAO,UAAU,CAAC,CAE/B"}

package/dist/taphos/function/delay.js

@@ -0,0 +1,24 @@
+/**
+ * Invokes func after wait milliseconds.
+ *
+ * @param func - The function to delay.
+ * @param wait - The number of milliseconds to delay invocation.
+ * @param args - The arguments to invoke the function with.
+ * @returns The timer id.
+ * @deprecated Use `setTimeout(fn, wait)` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/setTimeout | setTimeout() - MDN}
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * delay(console.log, 1000, 'later');
+ *
+ * // ✅ Recommended approach
+ * setTimeout(() => console.log('later'), 1000);
+ * ```
+ */
+export function delay(func, wait, ...args) {
+    return setTimeout(() => func(...args), wait);
+}
+//# sourceMappingURL=delay.js.map

package/dist/taphos/function/delay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delay.js","sourceRoot":"","sources":["../../../src/taphos/function/delay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,KAAK,CACnB,IAA6B,EAC7B,IAAY,EACZ,GAAG,IAAU;IAEb,OAAO,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;AAC/C,CAAC"}

package/dist/taphos/function/partial.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Creates a function that invokes func with partials prepended to the arguments it receives.
+ *
+ * @template Func - The type of the function to partially apply.
+ * @param func - The function to partially apply arguments to.
+ * @param partials - The arguments to be partially applied.
+ * @returns The new partially applied function.
+ * @deprecated Use arrow functions with closure or `Function.bind()` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function/bind | Function.bind() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_function_bind | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * const greet = (greeting: string, name: string, punctuation: string) =>
+ *   `${greeting} ${name}${punctuation}`;
+ *
+ * // ❌ Deprecated approach
+ * const sayHello = partial(greet, 'Hello');
+ * console.log(sayHello('John', '!')); // "Hello John!"
+ *
+ * // ✅ Recommended approach with bind
+ * const sayHelloBind = greet.bind(null, 'Hello');
+ * console.log(sayHelloBind('John', '!')); // "Hello John!"
+ *
+ * // ✅ Alternative with arrow function
+ * const sayHelloArrow = (name: string, punctuation: string) =>
+ *   greet('Hello', name, punctuation);
+ * console.log(sayHelloArrow('John', '!')); // "Hello John!"
+ * ```
+ */
+export declare function partial<Func extends (...args: any[]) => any>(func: Func, ...partials: any[]): (...args: any[]) => ReturnType<Func>;
+//# sourceMappingURL=partial.d.ts.map

package/dist/taphos/function/partial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"partial.d.ts","sourceRoot":"","sources":["../../../src/taphos/function/partial.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,wBAAgB,OAAO,CAAC,IAAI,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAC1D,IAAI,EAAE,IAAI,EACV,GAAG,QAAQ,EAAE,GAAG,EAAE,GACjB,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,UAAU,CAAC,IAAI,CAAC,CAEtC"}

package/dist/taphos/function/partial.js

@@ -0,0 +1,36 @@
+/**
+ * Creates a function that invokes func with partials prepended to the arguments it receives.
+ *
+ * @template Func - The type of the function to partially apply.
+ * @param func - The function to partially apply arguments to.
+ * @param partials - The arguments to be partially applied.
+ * @returns The new partially applied function.
+ * @deprecated Use arrow functions with closure or `Function.bind()` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function/bind | Function.bind() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_function_bind | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * const greet = (greeting: string, name: string, punctuation: string) =>
+ *   `${greeting} ${name}${punctuation}`;
+ *
+ * // ❌ Deprecated approach
+ * const sayHello = partial(greet, 'Hello');
+ * console.log(sayHello('John', '!')); // "Hello John!"
+ *
+ * // ✅ Recommended approach with bind
+ * const sayHelloBind = greet.bind(null, 'Hello');
+ * console.log(sayHelloBind('John', '!')); // "Hello John!"
+ *
+ * // ✅ Alternative with arrow function
+ * const sayHelloArrow = (name: string, punctuation: string) =>
+ *   greet('Hello', name, punctuation);
+ * console.log(sayHelloArrow('John', '!')); // "Hello John!"
+ * ```
+ */
+// INTENTIONAL: `any` required for Function.bind() compatibility - partials have no type constraints in native bind
+export function partial(func, ...partials) {
+    return func.bind(null, ...partials);
+}
+//# sourceMappingURL=partial.js.map

package/dist/taphos/function/partial.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"partial.js","sourceRoot":"","sources":["../../../src/taphos/function/partial.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,mHAAmH;AACnH,MAAM,UAAU,OAAO,CACrB,IAAU,EACV,GAAG,QAAe;IAElB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,QAAQ,CAAC,CAAC;AACtC,CAAC"}

package/dist/taphos/function/rest.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Creates a function that invokes func with the this binding of the created function
+ * and an array of arguments.
+ *
+ * @template Result - The return type of the function.
+ * @param func - The function to apply a rest parameter to.
+ * @param start - The start position of the rest parameter. Defaults to func.length - 1.
+ * @returns The new function.
+ * @deprecated Use rest parameters `(...args)` syntax directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Functions/rest_parameters | Rest parameters - MDN}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * const say = rest((what: string, names: string[]) => {
+ *   return what + ' ' + names.join(', ');
+ * });
+ * say('hello', 'fred', 'barney', 'pebbles');
+ * // => 'hello fred, barney, pebbles'
+ *
+ * // ✅ Recommended approach
+ * const say = (what: string, ...names: string[]) => {
+ *   return what + ' ' + names.join(', ');
+ * };
+ * say('hello', 'fred', 'barney', 'pebbles');
+ * // => 'hello fred, barney, pebbles'
+ * ```
+ */
+export declare function rest<Result>(func: (...args: unknown[]) => Result, start?: number): (...args: unknown[]) => Result;
+//# sourceMappingURL=rest.d.ts.map

package/dist/taphos/function/rest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest.d.ts","sourceRoot":"","sources":["../../../src/taphos/function/rest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,IAAI,CAAC,MAAM,EACzB,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,MAAM,EACpC,KAAK,CAAC,EAAE,MAAM,GACb,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,MAAM,CAehC"}

package/dist/taphos/function/rest.js

@@ -0,0 +1,44 @@
+/**
+ * Creates a function that invokes func with the this binding of the created function
+ * and an array of arguments.
+ *
+ * @template Result - The return type of the function.
+ * @param func - The function to apply a rest parameter to.
+ * @param start - The start position of the rest parameter. Defaults to func.length - 1.
+ * @returns The new function.
+ * @deprecated Use rest parameters `(...args)` syntax directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Functions/rest_parameters | Rest parameters - MDN}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * const say = rest((what: string, names: string[]) => {
+ *   return what + ' ' + names.join(', ');
+ * });
+ * say('hello', 'fred', 'barney', 'pebbles');
+ * // => 'hello fred, barney, pebbles'
+ *
+ * // ✅ Recommended approach
+ * const say = (what: string, ...names: string[]) => {
+ *   return what + ' ' + names.join(', ');
+ * };
+ * say('hello', 'fred', 'barney', 'pebbles');
+ * // => 'hello fred, barney, pebbles'
+ * ```
+ */
+export function rest(func, start) {
+    const startIndex = start === undefined ? Math.max(func.length - 1, 0) : start;
+    // Stryker disable next-line ConditionalExpression,BlockStatement: Fast-path optimization - generic fallback with slice(0) produces identical result
+    if (startIndex === 0) {
+        return function (...args) {
+            return func.call(this, args);
+        };
+    }
+    return function (...args) {
+        const leadingArgs = args.slice(0, startIndex);
+        const restArgs = args.slice(startIndex);
+        return func.apply(this, [...leadingArgs, restArgs]);
+    };
+}
+//# sourceMappingURL=rest.js.map

package/dist/taphos/function/rest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest.js","sourceRoot":"","sources":["../../../src/taphos/function/rest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,IAAI,CAClB,IAAoC,EACpC,KAAc;IAEd,MAAM,UAAU,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAE9E,oJAAoJ;IACpJ,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,UAAyB,GAAG,IAAe;YAChD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC/B,CAAC,CAAC;IACJ,CAAC;IAED,OAAO,UAAyB,GAAG,IAAe;QAChD,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;QAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,GAAG,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;IACtD,CAAC,CAAC;AACJ,CAAC"}

package/dist/taphos/function/spread.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Creates a function that invokes func with the this binding of the create function
+ * and an array of arguments much like Function#apply.
+ *
+ * @template Result - The return type of the function.
+ * @param func - The function to spread arguments over.
+ * @param start - The start position of the spread. Defaults to 0.
+ * @returns The new function.
+ * @deprecated Use the spread operator `...` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Spread_syntax | Spread syntax - MDN}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * const say = spread((who: string, what: string) => who + ' says ' + what);
+ * say(['fred', 'hello']);
+ * // => 'fred says hello'
+ *
+ * // ✅ Recommended approach
+ * const say = (who: string, what: string) => who + ' says ' + what;
+ * const args: [string, string] = ['fred', 'hello'];
+ * say(...args);
+ * // => 'fred says hello'
+ * ```
+ */
+export declare function spread<Result>(func: (...args: unknown[]) => Result, start?: number): (args: unknown[]) => Result;
+//# sourceMappingURL=spread.d.ts.map

package/dist/taphos/function/spread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spread.d.ts","sourceRoot":"","sources":["../../../src/taphos/function/spread.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAC3B,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,MAAM,EACpC,KAAK,SAAI,GACR,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,MAAM,CAa7B"}

package/dist/taphos/function/spread.js

@@ -0,0 +1,40 @@
+/**
+ * Creates a function that invokes func with the this binding of the create function
+ * and an array of arguments much like Function#apply.
+ *
+ * @template Result - The return type of the function.
+ * @param func - The function to spread arguments over.
+ * @param start - The start position of the spread. Defaults to 0.
+ * @returns The new function.
+ * @deprecated Use the spread operator `...` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Spread_syntax | Spread syntax - MDN}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * const say = spread((who: string, what: string) => who + ' says ' + what);
+ * say(['fred', 'hello']);
+ * // => 'fred says hello'
+ *
+ * // ✅ Recommended approach
+ * const say = (who: string, what: string) => who + ' says ' + what;
+ * const args: [string, string] = ['fred', 'hello'];
+ * say(...args);
+ * // => 'fred says hello'
+ * ```
+ */
+export function spread(func, start = 0) {
+    // Stryker disable next-line ConditionalExpression,BlockStatement,EqualityOperator: Fast-path optimization - generic fallback with slice(0) produces identical result
+    if (start === 0) {
+        return function (args) {
+            return func.apply(this, args);
+        };
+    }
+    return function (args) {
+        const leadingArgs = args.slice(0, start);
+        const spreadArgs = args.slice(start);
+        return func.apply(this, [...leadingArgs, ...spreadArgs]);
+    };
+}
+//# sourceMappingURL=spread.js.map

package/dist/taphos/function/spread.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spread.js","sourceRoot":"","sources":["../../../src/taphos/function/spread.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,MAAM,CACpB,IAAoC,EACpC,KAAK,GAAG,CAAC;IAET,qKAAqK;IACrK,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAChB,OAAO,UAAyB,IAAe;YAC7C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAChC,CAAC,CAAC;IACJ,CAAC;IAED,OAAO,UAAyB,IAAe;QAC7C,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACzC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,GAAG,WAAW,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC;IAC3D,CAAC,CAAC;AACJ,CAAC"}

package/dist/taphos/function/unary.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Creates a function that accepts up to one argument, ignoring any additional arguments.
+ *
+ * @template Result - The return type of the function.
+ * @param func - The function to cap arguments for.
+ * @returns The new capped function.
+ * @deprecated Use an inline arrow function instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Functions/Arrow_functions | Arrow functions - MDN}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * ['6', '8', '10'].map(unary(parseInt));
+ * // => [6, 8, 10]
+ *
+ * // ✅ Recommended approach
+ * ['6', '8', '10'].map(x => parseInt(x, 10));
+ * // => [6, 8, 10]
+ * ```
+ */
+export declare function unary<Result>(func: (arg: unknown) => Result): (arg: unknown) => Result;
+//# sourceMappingURL=unary.d.ts.map

package/dist/taphos/function/unary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unary.d.ts","sourceRoot":"","sources":["../../../src/taphos/function/unary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAC1B,IAAI,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,GAC7B,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,CAE1B"}

package/dist/taphos/function/unary.js

@@ -0,0 +1,25 @@
+/**
+ * Creates a function that accepts up to one argument, ignoring any additional arguments.
+ *
+ * @template Result - The return type of the function.
+ * @param func - The function to cap arguments for.
+ * @returns The new capped function.
+ * @deprecated Use an inline arrow function instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Functions/Arrow_functions | Arrow functions - MDN}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * ['6', '8', '10'].map(unary(parseInt));
+ * // => [6, 8, 10]
+ *
+ * // ✅ Recommended approach
+ * ['6', '8', '10'].map(x => parseInt(x, 10));
+ * // => [6, 8, 10]
+ * ```
+ */
+export function unary(func) {
+    return (arg) => func(arg);
+}
+//# sourceMappingURL=unary.js.map

package/dist/taphos/function/unary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unary.js","sourceRoot":"","sources":["../../../src/taphos/function/unary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,KAAK,CACnB,IAA8B;IAE9B,OAAO,CAAC,GAAY,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACrC,CAAC"}

package/dist/taphos/function/wrap.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Creates a function that provides value to wrapper as its first argument.
+ *
+ * @template Arg - The type of the first argument.
+ * @template Args - The types of additional arguments.
+ * @template Result - The return type.
+ * @param value - The value to wrap.
+ * @param wrapper - The wrapper function.
+ * @returns The new function.
+ * @deprecated Use a closure or higher-order function directly instead.
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * const p = wrap(escape, (func, text) => `<p>${func(text)}</p>`);
+ * p('fred, barney, & pebbles');
+ * // => '<p>fred, barney, &amp; pebbles</p>'
+ *
+ * // ✅ Recommended approach
+ * const p = (text: string) => `<p>${escape(text)}</p>`;
+ * p('fred, barney, & pebbles');
+ * // => '<p>fred, barney, &amp; pebbles</p>'
+ * ```
+ */
+export declare function wrap<Arg, Args extends unknown[], Result>(value: Arg, wrapper: (value: Arg, ...args: Args) => Result): (...args: Args) => Result;
+//# sourceMappingURL=wrap.d.ts.map

package/dist/taphos/function/wrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrap.d.ts","sourceRoot":"","sources":["../../../src/taphos/function/wrap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM,EACtD,KAAK,EAAE,GAAG,EACV,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,IAAI,KAAK,MAAM,GAC7C,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,MAAM,CAE3B"}