@bemoje/fn 0.0.2 → 1.0.0

package/index.d.ts

@@ -14,35 +14,18 @@ type Increment<T extends number> = Subtract<T, -1>;
 
 type RemoveArrayElement<T extends any[], Index extends number> = ArraySplice<T, Index, 1, []>;
 
-type ParametersWithout<T extends (...args: any[]) => any, Index extends number> = RemoveArrayElement<
-  Parameters<T>,
-  Index
->;
+type ParametersWithout<T extends (...args: any[]) => any, Index extends number> = RemoveArrayElement<Parameters<T>, Index>;
 
 /**
  * Removes elements from an array at specified indices.
  */
-type RemoveArrayElements<T extends any[], Indices extends number[], Offset extends number = 0> = Indices extends [
-  infer First extends number,
-  ...infer Rest extends number[],
-]
-  ? RemoveArrayElements<
-      RemoveArrayElement<T, Subtract<First, Offset>>,
-      Rest,
-      Offset extends number ? Increment<Offset> : never
-    >
-  : T;
+type RemoveArrayElements<T extends any[], Indices extends number[], Offset extends number = 0> = Indices extends [infer First extends number, ...infer Rest extends number[]] ? RemoveArrayElements<RemoveArrayElement<T, Subtract<First, Offset>>, Rest, Offset extends number ? Increment<Offset> : never> : T;
 
 /**
  * Binds a specified argument to the provided function, returning a new function that requires
  * only the remaining arguments at call time.
  */
-declare function bindArg<
-  Ret extends (...args: ParametersWithout<T, Index>) => ReturnType<T>,
-  Index extends number = number,
-  Value = unknown,
-  T extends (...args: any[]) => any = (...args: any[]) => any,
->(fn: T, boundArgIndex: Index, boundArgValue: Value): Ret;
+declare function bindArg<Ret extends (...args: ParametersWithout<T, Index>) => ReturnType<T>, Index extends number = number, Value = unknown, T extends (...args: any[]) => any = (...args: any[]) => any>(fn: T, boundArgIndex: Index, boundArgValue: Value): Ret;
 
 /**
  * Binds specified arguments to the provided function, returning a new function that requires
@@ -56,21 +39,13 @@ declare function bindArg<
  *
  * @returns A function that, when invoked, applies both bound and unbound arguments in the correct order.
  */
-declare function bindArgs<
-  T extends (...args: Any[]) => Any,
-  BoundArgs extends Partial<TupleToObject<Parameters<T>>>,
->(
-  fn: T,
-  boundArgs: BoundArgs,
-): (...args: RemoveArrayElements<Parameters<T>, UnionToTuple<Extract<keyof BoundArgs, number>>>) => ReturnType<T>;
+declare function bindArgs<T extends (...args: Any[]) => Any, BoundArgs extends Partial<TupleToObject<Parameters<T>>>>(fn: T, boundArgs: BoundArgs): (...args: RemoveArrayElements<Parameters<T>, UnionToTuple<Extract<keyof BoundArgs, number>>>) => ReturnType<T>;
 
 /**
  * Converts a function from a class method by by making the first argument take the place of the 'this' context.
  * The reverse of @see thisify.
  */
-declare function dethisify<T extends object, Args extends Any[], Ret>(
-  fn: (this: T, ...args: Args) => Ret,
-): (target: T, ...args: Args) => Ret;
+declare function dethisify<T extends object, Args extends Any[], Ret>(fn: (this: T, ...args: Args) => Ret): (target: T, ...args: Args) => Ret;
 
 /**
  * Wraps a function so that the given @see IFunctionSpyStrategy will be applied.
@@ -78,165 +53,95 @@ declare function dethisify<T extends object, Args extends Any[], Ret>(
  * @param spy The strategy to apply.
  * @param options Options.
  */
-declare function functionSpy<T, Data>(
-  func: TFunction,
-  spy: IFunctionSpyStrategy<T, Data>,
-  options?: FunctionSpyOptions<T, Data>,
-): TFunction;
+declare function functionSpy<T, Data>(func: TFunction, spy: IFunctionSpyStrategy<T, Data>, options?: FunctionSpyOptions<T, Data>): TFunction;
 interface FunctionSpyOptions<T, Data> {
-  /**
-   * Whether the function is async.
-   * If provided, execution is a bit faster.
-   */
-  async?: boolean;
-  /**
-   * Predicate function that determines whether to skip the spy's actions for a given function call.
-   */
-  ignore?: IgnorePredicate<T, Data>;
+    /**
+     * Whether the function is async.
+     * If provided, execution is a bit faster.
+     */
+    async?: boolean;
+    /**
+     * Predicate function that determines whether to skip the spy's actions for a given function call.
+     */
+    ignore?: IgnorePredicate<T, Data>;
 }
 /**
  * @see functionSpy
  */
 interface IFunctionSpyStrategy<T, Data> {
-  /**
-   * Action to perform before the function is invoked.
-   * @param thisContext The context in which the function is invoked.
-   * @param args The arguments passed to the function. Modify this array to change the arguments passed to the function.
-   * @returns Data to be passed to @see onReturn.
-   */
-  onInvoke<Args extends Any[]>(thisContext: T, args: Args): Data;
-  /**
-   * Action to perform before the function returns.
-   * @param data The data returned by @see onInvoke.
-   * @param retval The return value of the function.
-   * @returns The value to be returned by the wrapped function.
-   */
-  onReturn<Ret>(data: Data, retval: Ret): Ret;
+    /**
+     * Action to perform before the function is invoked.
+     * @param thisContext The context in which the function is invoked.
+     * @param args The arguments passed to the function. Modify this array to change the arguments passed to the function.
+     * @returns Data to be passed to @see onReturn.
+     */
+    onInvoke<Args extends Any[]>(thisContext: T, args: Args): Data;
+    /**
+     * Action to perform before the function returns.
+     * @param data The data returned by @see onInvoke.
+     * @param retval The return value of the function.
+     * @returns The value to be returned by the wrapped function.
+     */
+    onReturn<Ret>(data: Data, retval: Ret): Ret;
 }
 type IgnorePredicate<T, Data> = (func: TFunction, spy: IFunctionSpyStrategy<T, Data>, thisContext?: T) => boolean;
 
 /**
  * Preserves the name and length of a function or class constructor
  */
-declare function preserveNameAndLength<
-  S extends ((...args: Any[]) => Any) | (new (...args: Any[]) => Any),
-  F extends ((...args: Any[]) => Any) | (new (...args: Any[]) => Any),
->(source: S, target: F, adjustLengthBy?: number): F;
+declare function preserveNameAndLength<S extends ((...args: Any[]) => Any) | (new (...args: Any[]) => Any), F extends ((...args: Any[]) => Any) | (new (...args: Any[]) => Any)>(source: S, target: F, adjustLengthBy?: number): F;
 
 /**
  * Set the length of a function.
  */
-declare function setLength<T extends object>(
-  length:
-    | number
-    | {
-        length: number;
-      },
-  target: T,
-): T;
+declare function setLength<T extends object>(length: number | {
+    length: number;
+}, target: T): T;
 
 /**
  * Set the name of a function.
  */
-declare function setName<T extends object>(
-  name:
-    | string
-    | {
-        name: string;
-      },
-  target: T,
-): T;
+declare function setName<T extends object>(name: string | {
+    name: string;
+}, target: T): T;
 
 /**
  * Returns a function that redirects or 'proxies' the 'this' context of the input function
  * to a property of a given key.
  */
-declare function thisProxy<ThisTarget extends This, This extends object, Args extends AnyArgs, Ret>(
-  fn: (this: This, ...args: Args) => Ret,
-  proxy: PropertyKey,
-): (this: ThisTarget, ...args: Args) => Ret;
+declare function thisProxy<ThisTarget extends This, This extends object, Args extends AnyArgs, Ret>(fn: (this: This, ...args: Args) => Ret, proxy: PropertyKey): (this: ThisTarget, ...args: Args) => Ret;
 /**
  * Returns a function that redirects or 'proxies' the 'this' context of the input function
  * to a callback that returns the target object.
  */
-declare function thisProxy<ThisTarget extends This, This extends object, Args extends AnyArgs, Ret>(
-  fn: (this: This, ...args: Args) => Ret,
-  proxy: (object: ThisTarget) => This,
-): (this: ThisTarget, ...args: Args) => Ret;
+declare function thisProxy<ThisTarget extends This, This extends object, Args extends AnyArgs, Ret>(fn: (this: This, ...args: Args) => Ret, proxy: (object: ThisTarget) => This): (this: ThisTarget, ...args: Args) => Ret;
 type AnyArgs = any[];
 
 /**
  * Converts a function to a class method by making the 'this' context the first argument.
  */
-declare function thisify<T, Args extends Any[], Ret>(
-  fn: (target: T, ...args: Args) => Ret,
-): (this: T, ...args: Args) => Ret;
-type Thisify<T extends object, F extends (target: T, ...args: any[]) => Any> = (
-  this: T,
-  ...args: ArraySlice<Parameters<F>, 1>
-) => ReturnType<F>;
+declare function thisify<T, Args extends Any[], Ret>(fn: (target: T, ...args: Args) => Ret): (this: T, ...args: Args) => Ret;
+type Thisify<T extends object, F extends (target: T, ...args: any[]) => Any> = (this: T, ...args: ArraySlice<Parameters<F>, 1>) => ReturnType<F>;
 
 /**
  * Wraps a function to transform its return value using a transform function.
  */
-declare function transformReturnValue<T, Args extends any[], Ret, NewRet>(
-  fn: (this: T, ...args: Args) => Ret,
-  transform: (value: Ret) => NewRet,
-): (this: T, ...args: Args) => NewRet;
+declare function transformReturnValue<T, Args extends any[], Ret, NewRet>(fn: (this: T, ...args: Args) => Ret, transform: (value: Ret) => NewRet): (this: T, ...args: Args) => NewRet;
 
 /**
  * Wrap methods, getters and setters of an object with custom logic.
  */
 declare function wrapMethods<T extends object>(target: T, strat: WrapMethodsStrategy<T>): T;
 type DescriptorMethodType = 'get' | 'set' | 'method';
-type MethodFilter<T extends object = object> = (
-  target: T,
-  key: string | symbol,
-  type: DescriptorMethodType,
-  descriptor: PropertyDescriptor,
-) => boolean;
-type MethodWrapper<T extends object = object> = (
-  target: T,
-  key: string | symbol,
-  method: AnyFunction,
-) => AnyFunction | undefined;
-type GetterWrapper<T extends object = object> = (
-  target: T,
-  key: string | symbol,
-  getter: AnyGetter,
-) => AnyGetter | undefined;
-type SetterWrapper<T extends object = object> = (
-  target: T,
-  key: string | symbol,
-  setter: AnySetter,
-) => AnySetter | undefined;
+type MethodFilter<T extends object = object> = (target: T, key: string | symbol, type: DescriptorMethodType, descriptor: PropertyDescriptor) => boolean;
+type MethodWrapper<T extends object = object> = (target: T, key: string | symbol, method: AnyFunction) => AnyFunction | undefined;
+type GetterWrapper<T extends object = object> = (target: T, key: string | symbol, getter: AnyGetter) => AnyGetter | undefined;
+type SetterWrapper<T extends object = object> = (target: T, key: string | symbol, setter: AnySetter) => AnySetter | undefined;
 interface WrapMethodsStrategy<T extends object = object> {
-  filter?: MethodFilter<T>;
-  onGetter?: GetterWrapper<T>;
-  onSetter?: SetterWrapper<T>;
-  onMethod?: MethodWrapper<T>;
+    filter?: MethodFilter<T>;
+    onGetter?: GetterWrapper<T>;
+    onSetter?: SetterWrapper<T>;
+    onMethod?: MethodWrapper<T>;
 }
 
-export {
-  type DescriptorMethodType,
-  type FunctionSpyOptions,
-  type GetterWrapper,
-  type IFunctionSpyStrategy,
-  type IgnorePredicate,
-  type MethodFilter,
-  type MethodWrapper,
-  type SetterWrapper,
-  type Thisify,
-  type WrapMethodsStrategy,
-  bindArg,
-  bindArgs,
-  dethisify,
-  functionSpy,
-  preserveNameAndLength,
-  setLength,
-  setName,
-  thisProxy,
-  thisify,
-  transformReturnValue,
-  wrapMethods,
-};
+export { type DescriptorMethodType, type FunctionSpyOptions, type GetterWrapper, type IFunctionSpyStrategy, type IgnorePredicate, type MethodFilter, type MethodWrapper, type SetterWrapper, type Thisify, type WrapMethodsStrategy, bindArg, bindArgs, dethisify, functionSpy, preserveNameAndLength, setLength, setName, thisProxy, thisify, transformReturnValue, wrapMethods };

package/index.mjs

@@ -3,36 +3,30 @@ import { isAsyncFunction } from 'util/types';
 import { isFunction } from 'es-toolkit/predicate';
 
 var __defProp = Object.defineProperty;
-var __name = (target, value) => {
-  return __defProp(target, 'name', { value, configurable: true });
-};
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 
 // src/preserveNameAndLength.ts
 function preserveNameAndLength(source, target, adjustLengthBy = 0) {
   return Object.defineProperties(target, {
     name: {
       configurable: true,
-      value: source.name,
+      value: source.name
     },
     length: {
       configurable: true,
-      value: source.length + adjustLengthBy,
-    },
+      value: source.length + adjustLengthBy
+    }
   });
 }
-__name(preserveNameAndLength, 'preserveNameAndLength');
+__name(preserveNameAndLength, "preserveNameAndLength");
 
 // src/bindArg.ts
 function bindArg(fn, boundArgIndex, boundArgValue) {
-  return preserveNameAndLength(
-    fn,
-    (...args) => {
-      return fn(...args.slice(0, boundArgIndex), boundArgValue, ...args.slice(boundArgIndex));
-    },
-    -1,
-  );
+  return preserveNameAndLength(fn, (...args) => {
+    return fn(...args.slice(0, boundArgIndex), boundArgValue, ...args.slice(boundArgIndex));
+  }, -1);
 }
-__name(bindArg, 'bindArg');
+__name(bindArg, "bindArg");
 function bindArgs(fn, boundArgs) {
   const boundIndices = Object.keys(boundArgs).map(Number);
   const lastIndex = Math.max(fn.length - 1, ...boundIndices);
@@ -42,39 +36,27 @@ function bindArgs(fn, boundArgs) {
     const isBound = Object.hasOwn(boundArgs, index);
     const boundIndex = index;
     const unboundIndex = index - (isBound ? offset++ : offset);
-    return isBound
-      ? () => {
-          return boundArgs[boundIndex];
-        }
-      : (args) => {
-          return args[unboundIndex];
-        };
+    return isBound ? () => {
+      return boundArgs[boundIndex];
+    } : (args) => {
+      return args[unboundIndex];
+    };
   });
-  return preserveNameAndLength(
-    fn,
-    (...args) => {
-      return fn(
-        ...argGetters.map((get) => {
-          return get(args);
-        }),
-      );
-    },
-    boundIndices.length * -1,
-  );
+  return preserveNameAndLength(fn, (...args) => {
+    return fn(...argGetters.map((get) => {
+      return get(args);
+    }));
+  }, boundIndices.length * -1);
 }
-__name(bindArgs, 'bindArgs');
+__name(bindArgs, "bindArgs");
 
 // src/dethisify.ts
 function dethisify(fn) {
-  return preserveNameAndLength(
-    fn,
-    function (target, ...args) {
-      return fn.apply(target, args);
-    },
-    1,
-  );
+  return preserveNameAndLength(fn, function(target, ...args) {
+    return fn.apply(target, args);
+  }, 1);
 }
-__name(dethisify, 'dethisify');
+__name(dethisify, "dethisify");
 function functionSpy(func, spy, options = {}) {
   if (options.async === false) {
     return wrapSync(func, spy, options);
@@ -84,13 +66,13 @@ function functionSpy(func, spy, options = {}) {
     return wrapMaybeAsync(func, spy, options);
   }
 }
-__name(functionSpy, 'functionSpy');
+__name(functionSpy, "functionSpy");
 function wrapMaybeAsync(func, spy, options = {}) {
   const ignore = options.ignore;
   if (ignore && ignore(func, spy)) {
     return func;
   }
-  return preserveNameAndLength(func, function (...args) {
+  return preserveNameAndLength(func, function(...args) {
     if (ignore && ignore(func, spy, this)) {
       return func.apply(this, args);
     }
@@ -105,13 +87,13 @@ function wrapMaybeAsync(func, spy, options = {}) {
     }
   });
 }
-__name(wrapMaybeAsync, 'wrapMaybeAsync');
+__name(wrapMaybeAsync, "wrapMaybeAsync");
 function wrapSync(func, spy, options = {}) {
   const ignore = options.ignore;
   if (ignore && ignore(func, spy)) {
     return func;
   }
-  return preserveNameAndLength(func, function (...args) {
+  return preserveNameAndLength(func, function(...args) {
     if (ignore && ignore(func, spy, this)) {
       return func.apply(this, args);
     }
@@ -120,13 +102,13 @@ function wrapSync(func, spy, options = {}) {
     return spy.onReturn(data, retval);
   });
 }
-__name(wrapSync, 'wrapSync');
+__name(wrapSync, "wrapSync");
 function wrapAsync(func, spy, options = {}) {
   const ignore = options.ignore;
   if (ignore && ignore(func, spy)) {
     return func;
   }
-  return preserveNameAndLength(func, async function (...args) {
+  return preserveNameAndLength(func, async function(...args) {
     if (ignore && ignore(func, spy, this)) {
       return await func.apply(this, args);
     }
@@ -135,72 +117,68 @@ function wrapAsync(func, spy, options = {}) {
     return spy.onReturn(data, retval);
   });
 }
-__name(wrapAsync, 'wrapAsync');
+__name(wrapAsync, "wrapAsync");
 
 // src/setLength.ts
 function setLength(length, target) {
-  return Object.defineProperty(target, 'length', {
-    value: typeof length === 'number' ? length : length.length,
+  return Object.defineProperty(target, "length", {
+    value: typeof length === "number" ? length : length.length,
     enumerable: false,
-    configurable: true,
+    configurable: true
   });
 }
-__name(setLength, 'setLength');
+__name(setLength, "setLength");
 
 // src/setName.ts
 function setName(name, target) {
-  return Object.defineProperty(target, 'name', {
-    value: typeof name === 'string' ? name : name.name,
+  return Object.defineProperty(target, "name", {
+    value: typeof name === "string" ? name : name.name,
     configurable: true,
-    enumerable: false,
+    enumerable: false
   });
 }
-__name(setName, 'setName');
+__name(setName, "setName");
 function thisProxy(fn, proxy) {
   return isFunction(proxy) ? thisProxyCallback(fn, proxy) : thisProxyKey(fn, proxy);
 }
-__name(thisProxy, 'thisProxy');
+__name(thisProxy, "thisProxy");
 function thisProxyKey(fn, proxy) {
-  return preserveNameAndLength(fn, function (...args) {
+  return preserveNameAndLength(fn, function(...args) {
     const thisArg = this[proxy];
     return fn.apply(thisArg, args);
   });
 }
-__name(thisProxyKey, 'thisProxyKey');
+__name(thisProxyKey, "thisProxyKey");
 function thisProxyCallback(fn, proxy) {
-  return preserveNameAndLength(fn, function (...args) {
+  return preserveNameAndLength(fn, function(...args) {
     const thisArg = proxy(this);
     return fn.apply(thisArg, args);
   });
 }
-__name(thisProxyCallback, 'thisProxyCallback');
+__name(thisProxyCallback, "thisProxyCallback");
 
 // src/thisify.ts
 function thisify(fn) {
-  return preserveNameAndLength(
-    fn,
-    /* @__PURE__ */ __name(function f(...args) {
-      return fn(this, ...args);
-    }, 'f'),
-    -1,
-  );
+  return preserveNameAndLength(fn, /* @__PURE__ */ __name(function f(...args) {
+    return fn(this, ...args);
+  }, "f"), -1);
 }
-__name(thisify, 'thisify');
+__name(thisify, "thisify");
 
 // src/transformReturnValue.ts
 function transformReturnValue(fn, transform) {
-  return preserveNameAndLength(fn, function (...args) {
+  return preserveNameAndLength(fn, function(...args) {
     const result = fn.apply(this, args);
     return transform(result);
   });
 }
-__name(transformReturnValue, 'transformReturnValue');
+__name(transformReturnValue, "transformReturnValue");
 function wrapMethods(target, strat) {
   for (const [key, type, des] of iterateMethods(target)) {
     if (strat.filter && !strat.filter(target, key, type, des)) {
       continue;
     }
-    if (type === 'method') {
+    if (type === "method") {
       if (!strat.onMethod) {
         continue;
       }
@@ -212,9 +190,9 @@ function wrapMethods(target, strat) {
       Object.defineProperty(target, key, {
         value: preserveNameAndLength(orig, wrapped),
         configurable: des.configurable,
-        enumerable: des.enumerable,
+        enumerable: des.enumerable
       });
-    } else if (type === 'get') {
+    } else if (type === "get") {
       if (!strat.onGetter) {
         continue;
       }
@@ -226,9 +204,9 @@ function wrapMethods(target, strat) {
       Object.defineProperty(target, key, {
         get: preserveNameAndLength(orig, wrapped),
         configurable: des.configurable,
-        enumerable: des.enumerable,
+        enumerable: des.enumerable
       });
-    } else if (type === 'set') {
+    } else if (type === "set") {
       if (!strat.onSetter) {
         continue;
       }
@@ -240,13 +218,13 @@ function wrapMethods(target, strat) {
       Object.defineProperty(target, key, {
         set: preserveNameAndLength(orig, wrapped),
         configurable: des.configurable,
-        enumerable: des.enumerable,
+        enumerable: des.enumerable
       });
     }
   }
   return target;
 }
-__name(wrapMethods, 'wrapMethods');
+__name(wrapMethods, "wrapMethods");
 function* iterateMethods(target) {
   for (const key of Reflect.ownKeys(target)) {
     const des = Object.getOwnPropertyDescriptor(target, key);
@@ -254,29 +232,29 @@ function* iterateMethods(target) {
       continue;
     }
     if (isFunction(des.value)) {
-      yield [key, 'method', des];
+      yield [
+        key,
+        "method",
+        des
+      ];
     } else {
       if (isFunction(des.get)) {
-        yield [key, 'get', des];
+        yield [
+          key,
+          "get",
+          des
+        ];
       }
       if (isFunction(des.set)) {
-        yield [key, 'set', des];
+        yield [
+          key,
+          "set",
+          des
+        ];
       }
     }
   }
 }
-__name(iterateMethods, 'iterateMethods');
+__name(iterateMethods, "iterateMethods");
 
-export {
-  bindArg,
-  bindArgs,
-  dethisify,
-  functionSpy,
-  preserveNameAndLength,
-  setLength,
-  setName,
-  thisProxy,
-  thisify,
-  transformReturnValue,
-  wrapMethods,
-};
+export { bindArg, bindArgs, dethisify, functionSpy, preserveNameAndLength, setLength, setName, thisProxy, thisify, transformReturnValue, wrapMethods };

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@bemoje/fn",
-  "version": "0.0.2",
+  "version": "1.0.0",
+  "description": "fn",
   "type": "module",
   "sideEffects": false,
   "keywords": [
@@ -15,8 +16,7 @@
   },
   "dependencies": {
     "es-toolkit": "^1.44.0",
-    "type-fest": "^5.4.4",
-    "@types/node": "^24.3.1"
+    "type-fest": "^5.4.4"
   },
   "publishConfig": {
     "access": "public"