@eslint-react/eff 2.3.13-beta.2 → 2.3.13-next.1

package/dist/index.d.ts

@@ -19,7 +19,7 @@ type NarrowedTo<T, Base> = Extract<T, Base> extends never ? Base : 0 extends 1 &
 /**
  * A function that takes a guard function as predicate and returns a guard that negates it.
  *
- * @param predicate The guard function to negate.
+ * @param predicate - The guard function to negate.
  * @returns Function A guard function.
  */
 declare function not<T, S extends T>(predicate: (data: T) => data is S): (data: T) => data is Exclude<T, S>;
@@ -27,8 +27,8 @@ declare function not<T>(predicate: (data: T) => boolean): (data: T) => boolean;
 /**
  * A function that takes two guard functions as predicates and returns a guard that checks if either of them is true.
  *
- * @param a The first guard function.
- * @param b The second guard function.
+ * @param a - The first guard function.
+ * @param b - The second guard function.
  * @returns Function A guard function.
  */
 declare function or<T, S extends T, U extends T>(a: (data: T) => data is S, b: (data: T) => data is U): (data: T) => data is S | U;
@@ -38,28 +38,28 @@ declare function or<T>(a: (data: T) => boolean, b: (data: T) => boolean): (data:
 /**
  * A function that checks if the passed parameter is an Array and narrows its type accordingly.
  *
- * @param data The variable to check.
+ * @param data - The variable to check.
  * @returns True if the passed input is an Array, false otherwise. s
  */
 declare function isArray<T>(data: ArrayLike<unknown> | T): data is NarrowedTo<T, ReadonlyArray<unknown>>;
 /**
  * Checks if the given parameter is of type `"object"` via `typeof`, excluding `null`.
  *
- * @param data The variable to be checked for being an object type.
+ * @param data - The variable to be checked for being an object type.
  * @returns The input type, narrowed to only objects.
  */
 declare function isObject<T>(data: T | object): data is NarrowedTo<T, object>;
 /**
  * A function that checks if the passed parameter is truthy and narrows its type accordingly.
  *
- * @param data The variable to check.
+ * @param data - The variable to check.
  * @returns True if the passed input is truthy, false otherwise.
  */
 declare function isTruthy<T>(data: T): data is Exclude<T, "" | 0 | false | null | undefined>;
 /**
  * Tests if a value is a `function`.
  *
- * @param input The value to test.
+ * @param input - The value to test.
  * @example
  * ```ts
  * import * as assert from "node:assert"
@@ -74,7 +74,7 @@ declare function isTruthy<T>(data: T): data is Exclude<T, "" | 0 | false | null
 declare const isFunction: (input: unknown) => input is Function;
 /**
  * Returns its argument.
- * @param x The value to return.
+ * @param x - The value to return.
  */
 declare function identity<T>(x: T): T;
 /**
@@ -139,8 +139,8 @@ declare function identity<T>(x: T): T;
  * console.log(pipe(2, sum(3))) // 5
  * ```
  *
- * @param arity The arity of the uncurried function or a predicate that determines if the function is being used in a data-first or data-last style.
- * @param body The function to be curried.
+ * @param arity - The arity of the uncurried function or a predicate that determines if the function is being used in a data-first or data-last style.
+ * @param body - The function to be curried.
  * @since 1.0.0
  */
 declare const dual: {
@@ -150,7 +150,7 @@ declare const dual: {
 /**
  * Apply a function to a given value.
  *
- * @param a The value to apply.
+ * @param a - The value to apply.
  * @example
  * ```ts
  * import * as assert from "node:assert"
@@ -165,7 +165,7 @@ declare const dual: {
 declare const apply: <A>(a: A) => <B>(self: (a: A) => B) => B;
 /**
  * Returns a function that always returns the same value.
- * @param x The value to return.
+ * @param x - The value to return.
  */
 declare function constant<T>(x: T): () => T;
 /**
@@ -187,7 +187,7 @@ declare function constFalse(): false;
 /**
  * Reverses the order of arguments for a curried function.
  *
- * @param f The function to flip.
+ * @param f - The function to flip.
  * @example
  * ```ts
  * import * as assert from "node:assert"
@@ -228,14 +228,14 @@ declare const compose: {
  *
  * This function is particularly useful when it's necessary to specify that certain cases are impossible.
  *
- * @param _ The value of type `never` that is passed to the function.
+ * @param _ - The value of type `never` that is passed to the function.
  * @since 1.0.0
  */
 declare const absurd: <A>(_: never) => A;
 /**
  * Creates a   version of this function: instead of `n` arguments, it accepts a single tuple argument.
  *
- * @param f The function to be converted.
+ * @param f - The function to be converted.
  * @example
  * ```ts
  * import * as assert from "node:assert"
@@ -252,7 +252,7 @@ declare const tupled: <A extends ReadonlyArray<unknown>, B>(f: (...a: A) => B) =
 /**
  * Inverse function of `tupled`.
  *
- * @param f The function to be converted.
+ * @param f - The function to be converted.
  * @example
  * ```ts
  * import * as assert from "node:assert"
@@ -267,8 +267,8 @@ declare const tupled: <A extends ReadonlyArray<unknown>, B>(f: (...a: A) => B) =
  */
 declare const untupled: <A extends ReadonlyArray<unknown>, B>(f: (a: A) => B) => (...a: A) => B;
 /**
- * @param self The value to pipe.
- * @param args The functions to apply.
+ * @param self - The value to pipe.
+ * @param args - The functions to apply.
  * @since 1.0.0
  */
 declare const pipeArguments: <A>(self: A, args: IArguments) => unknown;
@@ -338,7 +338,7 @@ declare const pipeArguments: <A>(self: A, args: IArguments) => unknown;
  * // Output: 2
  * ```
  *
- * @param a The value to pipe.
+ * @param a - The value to pipe.
  * @param args
  * @since 1.0.0
  */
@@ -367,7 +367,7 @@ declare function pipe<A, B = never, C = never, D = never, E = never, F = never,
  *
  * See also [`pipe`](#pipe).
  *
- * @param ab The first function to apply.
+ * @param ab - The first function to apply.
  * @param bc
  * @param cd
  * @param de
@@ -402,17 +402,17 @@ declare function flow<A extends ReadonlyArray<unknown>, B = never, C = never, D
 declare function flow<A extends ReadonlyArray<unknown>, B = never, C = never, D = never, E = never, F = never, G = never, H = never, I = never, J = never>(ab: (...a: A) => B, bc: (b: B) => C, cd: (c: C) => D, de: (d: D) => E, ef: (e: E) => F, fg: (f: F) => G, gh: (g: G) => H, hi: (h: H) => I, ij: (i: I) => J): (...a: A) => J;
 /**
  * Retrieves a value from a Map or WeakMap if the key exists, or computes a new value if it doesn't.
- * @param map The Map or WeakMap to get from
- * @param key The key to look up in the Map or WeakMap
- * @param callback The function to call to generate a new value if the key doesn't exist
+ * @param map - The Map or WeakMap to get from
+ * @param key - The key to look up in the Map or WeakMap
+ * @param callback - The function to call to generate a new value if the key doesn't exist
  */
 declare function getOrElse<K extends WeakKey, V>(map: WeakMap<K, V>, key: K, callback: () => V): V;
 declare function getOrElse<K, V>(map: Map<K, V>, key: K, callback: () => V): V;
 /**
  * Retrieves a value from a Map or WeakMap if the key exists, or computes and stores a new value if it doesn't.
- * @param map The Map or WeakMap to get from or update
- * @param key The key to look up in the Map or WeakMap
- * @param callback The function to call to generate a new value if the key doesn't exist
+ * @param map - The Map or WeakMap to get from or update
+ * @param key - The key to look up in the Map or WeakMap
+ * @param callback - The function to call to generate a new value if the key doesn't exist
  * @returns The existing value for the key, or the newly computed value
  */
 declare function getOrElseUpdate<K extends WeakKey, V>(map: WeakMap<K, V>, key: K, callback: () => V): V;
@@ -420,8 +420,8 @@ declare function getOrElseUpdate<K, V>(map: Map<K, V>, key: K, callback: () => V
 /**
  * Attempts to add a value to a Set, but only if it doesn't already exist.
  *
- * @param set The Set to potentially add to
- * @param value The value to add if it doesn't already exist in the Set
+ * @param set - The Set to potentially add to
+ * @param value - The value to add if it doesn't already exist in the Set
  * @returns true if the value was added, false if it already existed
  */
 declare function tryAddToSet<T>(set: Set<T>, value: T): boolean;

package/dist/index.js

@@ -12,7 +12,7 @@ function or(a, b) {
 /**
 * A function that checks if the passed parameter is an Array and narrows its type accordingly.
 *
-* @param data The variable to check.
+* @param data - The variable to check.
 * @returns True if the passed input is an Array, false otherwise. s
 */
 function isArray(data) {
@@ -21,7 +21,7 @@ function isArray(data) {
 /**
 * Checks if the given parameter is of type `"object"` via `typeof`, excluding `null`.
 *
-* @param data The variable to be checked for being an object type.
+* @param data - The variable to be checked for being an object type.
 * @returns The input type, narrowed to only objects.
 */
 function isObject(data) {
@@ -30,7 +30,7 @@ function isObject(data) {
 /**
 * A function that checks if the passed parameter is truthy and narrows its type accordingly.
 *
-* @param data The variable to check.
+* @param data - The variable to check.
 * @returns True if the passed input is truthy, false otherwise.
 */
 function isTruthy(data) {
@@ -39,7 +39,7 @@ function isTruthy(data) {
 /**
 * Tests if a value is a `function`.
 *
-* @param input The value to test.
+* @param input - The value to test.
 * @example
 * ```ts
 * import * as assert from "node:assert"
@@ -54,7 +54,7 @@ function isTruthy(data) {
 const isFunction = (input) => typeof input === "function";
 /**
 * Returns its argument.
-* @param x The value to return.
+* @param x - The value to return.
 */
 function identity(x) {
 	return x;
@@ -121,8 +121,8 @@ function identity(x) {
 * console.log(pipe(2, sum(3))) // 5
 * ```
 *
-* @param arity The arity of the uncurried function or a predicate that determines if the function is being used in a data-first or data-last style.
-* @param body The function to be curried.
+* @param arity - The arity of the uncurried function or a predicate that determines if the function is being used in a data-first or data-last style.
+* @param body - The function to be curried.
 * @since 1.0.0
 */
 const dual = function(arity, body) {
@@ -156,7 +156,7 @@ const dual = function(arity, body) {
 /**
 * Apply a function to a given value.
 *
-* @param a The value to apply.
+* @param a - The value to apply.
 * @example
 * ```ts
 * import * as assert from "node:assert"
@@ -171,7 +171,7 @@ const dual = function(arity, body) {
 const apply = (a) => (self) => self(a);
 /**
 * Returns a function that always returns the same value.
-* @param x The value to return.
+* @param x - The value to return.
 */
 function constant(x) {
 	return () => x;
@@ -201,7 +201,7 @@ function constFalse() {
 /**
 * Reverses the order of arguments for a curried function.
 *
-* @param f The function to flip.
+* @param f - The function to flip.
 * @example
 * ```ts
 * import * as assert from "node:assert"
@@ -239,7 +239,7 @@ const compose = dual(2, (ab, bc) => (a) => bc(ab(a)));
 *
 * This function is particularly useful when it's necessary to specify that certain cases are impossible.
 *
-* @param _ The value of type `never` that is passed to the function.
+* @param _ - The value of type `never` that is passed to the function.
 * @since 1.0.0
 */
 const absurd = (_) => {
@@ -248,7 +248,7 @@ const absurd = (_) => {
 /**
 * Creates a   version of this function: instead of `n` arguments, it accepts a single tuple argument.
 *
-* @param f The function to be converted.
+* @param f - The function to be converted.
 * @example
 * ```ts
 * import * as assert from "node:assert"
@@ -265,7 +265,7 @@ const tupled = (f) => (a) => f(...a);
 /**
 * Inverse function of `tupled`.
 *
-* @param f The function to be converted.
+* @param f - The function to be converted.
 * @example
 * ```ts
 * import * as assert from "node:assert"
@@ -280,8 +280,8 @@ const tupled = (f) => (a) => f(...a);
 */
 const untupled = (f) => (...a) => f(a);
 /**
-* @param self The value to pipe.
-* @param args The functions to apply.
+* @param self - The value to pipe.
+* @param args - The functions to apply.
 * @since 1.0.0
 */
 const pipeArguments = (self, args) => {
@@ -348,8 +348,8 @@ function getOrElseUpdate(map, key, callback) {
 /**
 * Attempts to add a value to a Set, but only if it doesn't already exist.
 *
-* @param set The Set to potentially add to
-* @param value The value to add if it doesn't already exist in the Set
+* @param set - The Set to potentially add to
+* @param value - The value to add if it doesn't already exist in the Set
 * @returns true if the value was added, false if it already existed
 */
 function tryAddToSet(set, value) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eslint-react/eff",
-  "version": "2.3.13-beta.2",
+  "version": "2.3.13-next.1",
   "description": "JavaScript and TypeScript utilities (previously some re-exports of the effect library).",
   "homepage": "https://github.com/Rel1cx/eslint-react",
   "bugs": {