npm - rambda - Versions diffs - 7.5.0 → 8.1.0 - Mend

rambda 7.5.0 → 8.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (18) hide show

package/index.d.ts CHANGED Viewed

@@ -1,6 +1,23 @@
-export type RambdaTypes = "Object" | "Number" | "Boolean" | "String" | "Null" | "Array" | "RegExp" | "NaN" | "Function" | "Undefined" | "Async" | "Promise" | "Symbol" | "Set" | "Error" | "Map" | "WeakMap" | "Generator" | "GeneratorFunction" | "BigInt" | "ArrayBuffer";
+export type RambdaTypes = "Object" | "Number" | "Boolean" | "String" | "Null" | "Array" | "RegExp" | "NaN" | "Function" | "Undefined" | "Async" | "Promise" | "Symbol" | "Set" | "Error" | "Map" | "WeakMap" | "Generator" | "GeneratorFunction" | "BigInt" | "ArrayBuffer" | "Date"
+type LastArrayElement<ValueType extends readonly unknown[]> =
+	ValueType extends readonly [infer ElementType]
+		? ElementType
+		: ValueType extends readonly [infer _, ...infer Tail]
+			? LastArrayElement<Tail>
+			: ValueType extends ReadonlyArray<infer ElementType>
+				? ElementType
+				: never;
+type FirstArrayElement<ValueType extends readonly unknown[]> =
+	ValueType extends readonly [infer ElementType]
+		? ElementType
+		: ValueType extends readonly [...infer Head, infer _]
+			? FirstArrayElement<Head>
+			: ValueType extends ReadonlyArray<infer ElementType>
+				? ElementType
+				: never;
-// used in R.reduce to stop the loop
 export function reduceStopper<T>(input: T) : T
 export type IndexedIterator<T, U> = (x: T, i: number) => U;
 export type Iterator<T, U> = (x: T) => U;
@@ -39,8 +56,7 @@ type Pred = (...x: any[]) => boolean;
 export interface Dictionary<T> {[index: string]: T}
 type Partial<T> = { [P in keyof T]?: T[P]};
-type Evolvable<E extends Evolver> = {   [P in keyof E]?: Evolved<E[P]>;
-};
+type Evolvable<E extends Evolver> = {[P in keyof E]?: Evolved<E[P]>};
 type Evolver<T extends Evolvable<any> = any> = {   [key in keyof Partial<T>]: ((value: T[key]) => T[key]) | (T[key] extends Evolvable<any> ? Evolver<T[key]> : never);
 };
@@ -79,6 +95,19 @@ interface AssocPartialOne<K extends keyof any> {
 type AnyFunction = (...args: any[]) => unknown;
 type AnyConstructor = new (...args: any[]) => unknown;
+type RegExpReplacerFn =
+  | ((m: string, offset: number, s: string, groups?: Record<string, string>) => string)
+  | ((m: string, p1: string, offset: number, s: string, groups?: Record<string, string>) => string)
+  | ((m: string, p1: string, p2: string, offset: number, s: string, groups?: Record<string, string>) => string)
+  | ((m: string, p1: string, p2: string, p3: string, offset: number, s: string, groups?: Record<string, string>) => string)
+  | ((m: string, p1: string, p2: string, p3: string, p4: string, offset: number, s: string, groups?: Record<string, string>) => string)
+  | ((m: string, p1: string, p2: string, p3: string, p4: string, p5: string, offset: number, s: string, groups?: Record<string, string>) => string)
+  | ((m: string, p1: string, p2: string, p3: string, p4: string, p5: string, p6: string, offset: number, s: string, groups?: Record<string, string>) => string)
+  | ((m: string, p1: string, p2: string, p3: string, p4: string, p5: string, p6: string, p7: string, offset: number, s: string, groups?: Record<string, string>) => string)
+  | ((m: string, p1: string, p2: string, p3: string, p4: string, p5: string, p6: string, p7: string, p8: string, offset: number, s: string, groups?: Record<string, string>) => string)
+  | ((m: string, p1: string, p2: string, p3: string, p4: string, p5: string, p6: string, p7: string, p8: string, p9: string, offset: number, s: string, groups?: Record<string, string>) => string)
+type RegExpReplacer = string | RegExpReplacerFn
 // RAMBDAX INTERFACES
 // ============================================
 type Func<T> = (input: any) => T;
@@ -405,6 +434,19 @@ export function defaultTo<T>(defaultValue: T): (input: T | null | undefined) =>
 export function difference<T>(a: T[], b: T[]): T[];
 export function difference<T>(a: T[]): (b: T[]) => T[];
+export function differenceWith<T1, T2>(
+  pred: (a: T1, b: T2) => boolean,
+  list1: T1[],
+  list2: T2[],
+): T1[];
+export function differenceWith<T1, T2>(
+  pred: (a: T1, b: T2) => boolean,
+): (list1: T1[], list2: T2[]) => T1[];
+export function differenceWith<T1, T2>(
+  pred: (a: T1, b: T2) => boolean,
+  list1: T1[],
+): (list2: T2[]) => T1[];
 /**
  * It returns a new object that does not contain property `prop`.
  */
@@ -466,10 +508,10 @@ export function either(firstPredicate: Pred): (secondPredicate: Pred) => Pred;
  * When iterable is a string, then it behaves as `String.prototype.endsWith`.
  * When iterable is a list, then it uses R.equals to determine if the target list ends in the same way as the given target.
  */
-export function endsWith(target: string, iterable: string): boolean;
-export function endsWith(target: string): (iterable: string) => boolean;
-export function endsWith<T>(target: T[], list: T[]): boolean;
-export function endsWith<T>(target: T[]): (list: T[]) => boolean;
+export function endsWith<T extends string>(question: T, str: string): boolean;
+export function endsWith<T extends string>(question: T): (str: string) => boolean;
+export function endsWith<T>(question: T[], list: T[]): boolean;
+export function endsWith<T>(question: T[]): (list: T[]) => boolean;
 /**
  * It returns `true` if property `prop` in `obj1` is equal to property `prop` in `obj2` according to `R.equals`.
@@ -593,7 +635,7 @@ export function hasPath<T>(
  */
 export function head(input: string): string;
 export function head(emptyList: []): undefined;
-export function head<T>(input: T[]): T | undefined;
+export function head<T extends readonly unknown[]>(array: T): FirstArrayElement<T>
 /**
  * It returns `true` if its arguments `a` and `b` are identical.
@@ -630,8 +672,8 @@ export function inc(x: number): number;
  *
  * If `input` is array, then `R.equals` is used to define if `valueToFind` belongs to the list.
  */
-export function includes(valueToFind: string, input: string[] | string): boolean;
-export function includes(valueToFind: string): (input: string[] | string) => boolean;
+export function includes<T extends string>(valueToFind: T, input: string): boolean;
+export function includes<T extends string>(valueToFind: T): (input: string) => boolean;
 export function includes<T>(valueToFind: T, input: T[]): boolean;
 export function includes<T>(valueToFind: T): (input: T[]) => boolean;
@@ -718,9 +760,9 @@ export function keys<T>(x: T): string[];
 /**
  * It returns the last element of `input`, as the `input` can be either a string or an array.
  */
-export function last(str: string): string;
+export function last(input: string): string;
 export function last(emptyList: []): undefined;
-export function last<T extends any>(list: T[]): T | undefined;
+export function last<T extends readonly unknown[]>(array: T): LastArrayElement<T>
 /**
  * It returns the last index of `target` in `list` array.
@@ -923,11 +965,6 @@ export function negate(x: number): number;
 export function none<T>(predicate: (x: T) => boolean, list: T[]): boolean;
 export function none<T>(predicate: (x: T) => boolean): (list: T[]) => boolean;
-/**
- * It returns `undefined`.
- */
-export function nop(): void;
 /**
  * It returns a boolean negated version of `input`.
  */
@@ -1222,11 +1259,11 @@ export function prop<P extends keyof never, T>(propToFind: P): {
 /**
  * It returns true if `obj` has property `propToFind` and its value is equal to `valueToMatch`.
  */
-export function propEq<K extends string | number>(propToFind: K, valueToMatch: any, obj: Record<K, any>): boolean;
-export function propEq<K extends string | number>(propToFind: K, valueToMatch: any): (obj: Record<K, any>) => boolean;
-export function propEq<K extends string | number>(propToFind: K): {
-  (valueToMatch: any, obj: Record<K, any>): boolean;
-  (valueToMatch: any): (obj: Record<K, any>) => boolean;
+export function propEq<K extends string | number>(valueToMatch: any, propToFind: K, obj: Record<K, any>): boolean;
+export function propEq<K extends string | number>(valueToMatch: any, propToFind: K): (obj: Record<K, any>) => boolean;
+export function propEq(valueToMatch: any): {
+  <K extends string | number>(propToFind: K, obj: Record<K, any>): boolean;
+  <K extends string | number>(propToFind: K): (obj: Record<K, any>) => boolean;
 };
 /**
@@ -1289,9 +1326,9 @@ export function repeat<T>(x: T, timesToRepeat: number): T[];
 /**
  * It replaces `strOrRegex` found in `str` with `replacer`.
  */
-export function replace(strOrRegex: RegExp | string, replacer: string, str: string): string;
-export function replace(strOrRegex: RegExp | string, replacer: string): (str: string) => string;
-export function replace(strOrRegex: RegExp | string): (replacer: string) => (str: string) => string;
+export function replace(strOrRegex: RegExp | string, replacer: RegExpReplacer, str: string): string;
+export function replace(strOrRegex: RegExp | string, replacer: RegExpReplacer): (str: string) => string;
+export function replace(strOrRegex: RegExp | string): (replacer: RegExpReplacer) => (str: string) => string;
 /**
  * It returns a reversed copy of list or string `input`.
@@ -1368,10 +1405,10 @@ export function splitWhen<T>(predicate: Predicate<T>): <U>(list: U[]) => (U[])[]
  * When iterable is a string, then it behaves as `String.prototype.startsWith`.
  * When iterable is a list, then it uses R.equals to determine if the target list starts in the same way as the given target.
  */
-export function startsWith(target: string, str: string): boolean;
-export function startsWith(target: string): (str: string) => boolean;
-export function startsWith<T>(target: T[], list: T[]): boolean;
-export function startsWith<T>(target: T[]): (list: T[]) => boolean;
+export function startsWith<T extends string>(question: T, input: string): boolean;
+export function startsWith<T extends string>(question: T): (input: string) => boolean;
+export function startsWith<T>(question: T[], input: T[]): boolean;
+export function startsWith<T>(question: T[]): (input: T[]) => boolean;
 /**
  * Curried version of `x - y`

package/package.json CHANGED Viewed

@@ -1,15 +1,13 @@
 {
 	"name": "rambda",
-	"version": "7.5.0",
+	"version": "8.1.0",
 	"scripts": {
-		"publishx": "node files/publish",
+		"publish:experimental": "node files/publish",
 		"populatedocs": "cd ../rambda-scripts && yarn populate:docs",
 		"populatedocs:x": "cd ../rambda-scripts && yarn populate:docs:rambdax",
 		"populatereadme": "cd ../rambda-scripts && yarn populate:readme",
 		"populatereadme:x": "cd ../rambda-scripts && yarn populate:readme:rambdax",
 		"out": "yarn populatedocs && yarn populatereadme && yarn immutable && yarn build",
-		"pull": "cd ../rambda-scripts && git pull",
-		"outx": "yarn pull && yarn out",
 		"x": "yarn populatedocs:x && yarn populatereadme:x && yarn immutable:x",
 		"github": "cd ../rambda-scripts && yarn github",
 		"fix-docsify": "cd ../rambda-scripts && yarn fix-docsify:rambda",
@@ -26,48 +24,43 @@
 		"docs": "npx docsify-cli init ./docs && yarn fix-docsify",
 		"new": "cd ../rambda-scripts && yarn new",
 		"run:ramda:test": "cd ../rambda-scripts && yarn run:ramda:test",
-		"consume-typings:clone": "cd .. && git clone --depth 1 https://github.com/selfrefactor/rambda-scripts.git rambda-scripts-clone",
-		"consume-typings:execute": "cd ../rambda-scripts-clone/scripts/consume-typings && yarn start",
-		"consume-typings": "yarn consume-typings:clone && yarn consume-typings:execute",
-		"test:consume-typings": "jest source/_consumeTypings.test.js",
 		"test:typings": "dtslint --localTs ./node_modules/typescript/lib --expectOnly ./source",
 		"test:all": "jest source/*.spec.js -u --bail=false",
 		"test": "jest -o -u --watch",
 		"test:ci": "jest source/*.spec.js --coverage --no-cache -w 1",
-		"build:step": "yarn populatedocs && yarn populatereadme && yarn build:main",
+		"build:step": "yarn populatereadme && yarn build:main",
 		"benchmark:all": "yarn build:step && cd ../rambda-scripts && yarn benchmark:all",
 		"benchmark:check": "yarn build:step && METHOD=compose yarn benchmark:check:apply",
 		"benchmark:check:apply": "cd ../rambda-scripts && yarn check-benchmark",
 		"benchmark": "cd ../rambda-scripts && RAMBDA_RUN_ALL=ON RAMBDA_RUN_INDEXES=ON yarn benchmark",
-		"d:rambda-scripts": "cd ../rambda-scripts && run d",
-		"d": "yarn out && yarn lint && run d && yarn d:rambda-scripts"
+		"d": "yarn out && yarn lint && run d"
 	},
 	"dependencies": {},
 	"devDependencies": {
-		"@babel/core": "7.20.2",
-		"@babel/plugin-proposal-object-rest-spread": "7.20.2",
-		"@babel/preset-env": "7.20.2",
-		"@rollup/plugin-babel": "6.0.2",
-		"@rollup/plugin-commonjs": "23.0.2",
-		"@rollup/plugin-node-resolve": "15.0.1",
-		"@rollup/plugin-replace": "5.0.1",
-		"@types/jest": "29.2.2",
-		"@types/ramda": "0.28.23",
+		"@babel/core": "7.21.8",
+		"@babel/plugin-proposal-object-rest-spread": "7.20.7",
+		"@babel/preset-env": "7.21.5",
+		"@rollup/plugin-babel": "6.0.3",
+		"@rollup/plugin-commonjs": "25.0.0",
+		"@rollup/plugin-node-resolve": "15.0.2",
+		"@rollup/plugin-replace": "5.0.2",
+		"@types/jest": "29.5.1",
 		"combinate": "1.1.11",
 		"cross-env": "7.0.3",
 		"dtslint": "4.2.1",
-		"helpers-fn": "1.6.0",
+		"helpers-fn": "1.8.1",
 		"is-ci": "3.0.1",
-		"jest": "29.2.2",
-		"jest-extended": "3.1.0",
+		"jest": "29.5.0",
+		"jest-extended": "3.2.4",
 		"lodash": "4.17.21",
-		"rambdax": "8.1.0",
-		"ramda": "0.28.0",
-		"rollup": "3.2.5",
+		"rambdax": "9.1.1",
+		"ramda": "0.29.0",
+		"rollup": "3.22.0",
 		"rollup-plugin-cleanup": "3.2.1",
 		"rollup-plugin-sourcemaps": "0.6.3",
 		"rollup-plugin-uglify": "6.0.4",
-		"typescript": "4.8.4"
+		"types-ramda": "0.29.2",
+		"typescript": "5.0.4"
 	},
 	"jest": {
 		"testEnvironment": "node",
@@ -81,18 +74,6 @@
 			"!benchmarks"
 		]
 	},
-	"files": [
-		"dist",
-		"src",
-		"esm",
-		"mjs",
-		"README.md",
-		"CHANGELOG.md",
-		"index.d.ts",
-		"immutable.d.ts",
-		"rambda.js",
-		"immutable.js"
-	],
 	"repository": {
 		"type": "git",
 		"url": "git+https://github.com/selfrefactor/rambda.git"
@@ -100,11 +81,6 @@
 	"license": "MIT",
 	"author": "self_refactor",
 	"description": "Lightweight and faster alternative to Ramda with included TS definitions",
-	"sideEffects": false,
-	"main": "./dist/rambda.js",
-	"umd": "./dist/rambda.umd.js",
-	"module": "./rambda.js",
-	"types": "./index.d.ts",
 	"keywords": [
 		"ramda",
 		"fp",
@@ -112,5 +88,20 @@
 		"utility",
 		"lodash"
 	],
-	"homepage": "https://github.com/selfrefactor/rambda#readme"
+	"homepage": "https://github.com/selfrefactor/rambda#readme",
+	"files": [
+		"dist",
+		"src",
+		"README.md",
+		"CHANGELOG.md",
+		"index.d.ts",
+		"immutable.d.ts",
+		"rambda.js",
+		"immutable.js"
+	],
+	"sideEffects": false,
+	"main": "./dist/rambda.js",
+	"umd": "./dist/rambda.umd.js",
+	"module": "./rambda.js",
+	"types": "./index.d.ts"
 }

package/rambda.js CHANGED Viewed

@@ -1,4 +1,6 @@
 /// <reference types="./index.d.ts" />
+export * from './src/F.js'
+export * from './src/T.js'
 export * from './src/add.js'
 export * from './src/adjust.js'
 export * from './src/all.js'
@@ -29,6 +31,7 @@ export * from './src/curryN.js'
 export * from './src/dec.js'
 export * from './src/defaultTo.js'
 export * from './src/difference.js'
+export * from './src/differenceWith.js'
 export * from './src/dissoc.js'
 export * from './src/divide.js'
 export * from './src/drop.js'
@@ -42,7 +45,6 @@ export * from './src/endsWith.js'
 export * from './src/eqProps.js'
 export * from './src/equals.js'
 export * from './src/evolve.js'
-export * from './src/F.js'
 export * from './src/filter.js'
 export * from './src/find.js'
 export * from './src/findIndex.js'
@@ -102,7 +104,6 @@ export * from './src/move.js'
 export * from './src/multiply.js'
 export * from './src/negate.js'
 export * from './src/none.js'
-export * from './src/nop.js'
 export * from './src/not.js'
 export * from './src/nth.js'
 export * from './src/objOf.js'
@@ -129,8 +130,8 @@ export * from './src/prop.js'
 export * from './src/propEq.js'
 export * from './src/propIs.js'
 export * from './src/propOr.js'
-export * from './src/props.js'
 export * from './src/propSatisfies.js'
+export * from './src/props.js'
 export * from './src/range.js'
 export * from './src/reduce.js'
 export * from './src/reject.js'
@@ -149,7 +150,6 @@ export * from './src/startsWith.js'
 export * from './src/subtract.js'
 export * from './src/sum.js'
 export * from './src/symmetricDifference.js'
-export * from './src/T.js'
 export * from './src/tail.js'
 export * from './src/take.js'
 export * from './src/takeLast.js'

package/src/differenceWith.js ADDED Viewed

@@ -0,0 +1,20 @@
+import { curry } from './curry.js'
+import { _indexOf } from './equals.js'
+export function differenceWithFn(
+  fn, a, b
+){
+  const willReturn = []
+  const [ first, second ] = a.length > b.length ? [ a, b ] : [ b, a ]
+  first.forEach(item => {
+    const hasItem = second.some(secondItem => fn(item, secondItem))
+    if (!hasItem && _indexOf(item, willReturn) === -1){
+      willReturn.push(item)
+    }
+  })
+  return willReturn
+}
+export const differenceWith = curry(differenceWithFn)

package/src/isPromise.js CHANGED Viewed

@@ -1,5 +1,5 @@
 import { type } from './type.js'
 export function isPromise(x){
-  return 'Promise' === type(x)
+  return type(x) === 'Promise'
 }

package/src/mergeWith.js CHANGED Viewed

@@ -1,8 +1,10 @@
 import { curry } from './curry.js'
 function mergeWithFn(
-  mergeFn, a, b
+  mergeFn, aInput, bInput
 ){
+  const a = aInput ?? {}
+  const b = bInput ?? {}
   const willReturn = {}
   Object.keys(a).forEach(key => {

package/src/path.js CHANGED Viewed

@@ -1,11 +1,6 @@
 import { createPath } from './_internals/createPath.js'
-export function path(pathInput, obj){
-  if (arguments.length === 1) return _obj => path(pathInput, _obj)
-  if (obj === null || obj === undefined){
-    return undefined
-  }
+export function pathFn(pathInput, obj){
   let willReturn = obj
   let counter = 0
@@ -23,3 +18,13 @@ export function path(pathInput, obj){
   return willReturn
 }
+export function path(pathInput, obj){
+  if (arguments.length === 1) return _obj => path(pathInput, _obj)
+  if (obj === null || obj === undefined){
+    return undefined
+  }
+  return pathFn(pathInput, obj)
+}

package/src/propEq.js CHANGED Viewed

@@ -3,7 +3,7 @@ import { equals } from './equals.js'
 import { prop } from './prop.js'
 function propEqFn(
-  propToFind, valueToMatch, obj
+  valueToMatch, propToFind, obj
 ){
   if (!obj) return false

package/src/reduce.js CHANGED Viewed

@@ -10,6 +10,9 @@ class ReduceStopper{
 export function reduceFn(
   reducer, acc, list
 ){
+  if (list == null){
+    return acc
+  }
   if (!isArray(list)){
     throw new TypeError('reduce: list must be array or iterable')
   }

package/src/reverse.js CHANGED Viewed

@@ -1,7 +1,6 @@
-export function reverse(listOrString){
-  if (typeof listOrString === 'string'){
-    return listOrString.split('').reverse()
-      .join('')
+export function reverse(listOrString) {
+  if (typeof listOrString === 'string') {
+    return listOrString.split('').reverse().join('')
   }
   const clone = listOrString.slice()

package/src/set.js CHANGED Viewed

@@ -1,13 +1,9 @@
-import { always } from './always.js'
-import { curry } from './curry.js'
-import { over } from './over.js'
+import {always} from './always.js'
+import {curry} from './curry.js'
+import {over} from './over.js'
-function setFn(
-  lens, replacer, x
-){
-  return over(
-    lens, always(replacer), x
-  )
+function setFn(lens, replacer, x) {
+  return over(lens, always(replacer), x)
 }
 export const set = curry(setFn)

package/src/startsWith.js CHANGED Viewed

@@ -1,17 +1,17 @@
 import { isArray } from './_internals/isArray.js'
 import { equals } from './equals.js'
-export function startsWith(target, iterable){
+export function startsWith(question, iterable){
   if (arguments.length === 1)
-    return _iterable => startsWith(target, _iterable)
+    return _iterable => startsWith(question, _iterable)
   if (typeof iterable === 'string'){
-    return iterable.startsWith(target)
+    return iterable.startsWith(question)
   }
-  if (!isArray(target)) return false
+  if (!isArray(question)) return false
   let correct = true
-  const filtered = target.filter((x, index) => {
+  const filtered = question.filter((x, index) => {
     if (!correct) return false
     const result = equals(x, iterable[ index ])
     if (!result) correct = false
@@ -19,5 +19,5 @@ export function startsWith(target, iterable){
     return result
   })
-  return filtered.length === target.length
+  return filtered.length === question.length
 }

package/src/nop.js DELETED Viewed

	@@ -1 +0,0 @@
1	- export function nop(){}