rambda 8.0.0 → 8.2.0

package/README.md

@@ -33,13 +33,13 @@ You can test this example in <a href="https://rambda.now.sh?const%20result%20%3D
 
 ## ❯ Rambda's advantages
 
-### Typescript included
+### TypeScript included
 
-Typescript definitions are included in the library, in comparison to **Ramda**, where you need to additionally install `@types/ramda`.
+TypeScript definitions are included in the library, in comparison to **Ramda**, where you need to additionally install `@types/ramda`.
 
-Still, you need to be aware that functional programming features in `Typescript` are in development, which means that using **R.compose/R.pipe** can be problematic.
+Still, you need to be aware that functional programming features in `TypeScript` are in development, which means that using **R.compose/R.pipe** can be problematic.
 
-Important - Rambda version `7.1.0`(or higher) requires Typescript version `4.3.3`(or higher).
+Important - Rambda version `7.1.0`(or higher) requires TypeScript version `4.3.3`(or higher).
 
 #### Immutable TS definitions
 
@@ -96,16 +96,10 @@ Closing the issue is usually accompanied by publishing a new patch version of `R
 
 <details>
 <summary>
-  Click to see the full list of 80 Ramda methods not implemented in Rambda 
+  Click to see the full list of 72 Ramda methods not implemented in Rambda 
 </summary>
 
 - __
-- addIndex
-- addIndexRight
-- ap
-- aperture
-- applyTo
-- ascend
 - binary
 - call
 - collectBy
@@ -113,8 +107,6 @@ Closing the issue is usually accompanied by publishing a new patch version of `R
 - composeWith
 - construct
 - constructN
-- descend
-- differenceWith
 - dissocPath
 - dropRepeatsBy
 - empty
@@ -220,7 +212,7 @@ import {compose, add} from 'https://raw.githubusercontent.com/selfrefactor/rambd
 
 - Error handling, when wrong inputs are provided, may not be the same. This difference will be better documented once all brute force tests are completed.
 
-- Typescript definitions between `rambda` and `@types/ramda` may vary.
+- TypeScript definitions between `rambda` and `@types/ramda` may vary.
 
 > If you need more **Ramda** methods in **Rambda**, you may either submit a `PR` or check the extended version of **Rambda** - [Rambdax](https://github.com/selfrefactor/rambdax). In case of the former, you may want to consult with [Rambda contribution guidelines.](CONTRIBUTING.md)
 
@@ -341,6 +333,14 @@ It adds `a` and `b`.
 
 [![---------------](https://raw.githubusercontent.com/selfrefactor/rambda/master/files/separator.png)](#add)
 
+### addIndex
+
+[![---------------](https://raw.githubusercontent.com/selfrefactor/rambda/master/files/separator.png)](#addIndex)
+
+### addIndexRight
+
+[![---------------](https://raw.githubusercontent.com/selfrefactor/rambda/master/files/separator.png)](#addIndexRight)
+
 ### adjust
 
 ```typescript
@@ -350,11 +350,11 @@ adjust<T>(index: number, replaceFn: (x: T) => T, list: T[]): T[]
 
 It replaces `index` in array `list` with the result of `replaceFn(list[i])`.
 
-<a title="redirect to Rambda Repl site" href="https://rambda.now.sh?R.adjust(%0A%20%200%2C%0A%20%20a%20%3D%3E%20a%20%2B%201%2C%0A%20%20%5B0%2C%20100%5D%0Aconst%20result%20%3D%20)%20%2F%2F%20%3D%3E%20%5B1%2C%20100%5D">Try this <strong>R.adjust</strong> example in Rambda REPL</a>
+<a title="redirect to Rambda Repl site" href="https://rambda.now.sh?const%20result%20%3D%20R.adjust(%0A%20%200%2C%0A%20%20a%20%3D%3E%20a%20%2B%201%2C%0A%20%20%5B0%2C%20100%5D%0A)%20%2F%2F%20%3D%3E%20%5B1%2C%20100%5D">Try this <strong>R.adjust</strong> example in Rambda REPL</a>
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 adjust<T>(index: number, replaceFn: (x: T) => T, list: T[]): T[];
@@ -454,7 +454,7 @@ It returns `true`, if all members of array `list` returns `true`, when applied a
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 all<T>(predicate: (x: T) => boolean, list: T[]): boolean;
@@ -507,7 +507,7 @@ test('when false', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {all} from 'rambda'
@@ -550,7 +550,7 @@ It returns `true`, if all functions of `predicates` return `true`, when `input`
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 allPass<T>(predicates: ((x: T) => boolean)[]): (input: T) => boolean;
@@ -630,7 +630,7 @@ test('works with multiple inputs', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {allPass, filter} from 'rambda'
@@ -703,7 +703,7 @@ It returns `true`, if at least one member of `list` returns true, when passed to
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 any<T>(predicate: (x: T) => boolean, list: T[]): boolean;
@@ -756,7 +756,7 @@ test('with curry', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {any} from 'rambda'
@@ -800,7 +800,7 @@ It accepts list of `predicates` and returns a function. This function with its `
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 anyPass<T>(predicates: ((x: T) => boolean)[]): (input: T) => boolean;
@@ -893,7 +893,7 @@ test('works with multiple inputs', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {anyPass, filter} from 'rambda'
@@ -937,6 +937,140 @@ describe('anyPass', () => {
 
 [![---------------](https://raw.githubusercontent.com/selfrefactor/rambda/master/files/separator.png)](#anyPass)
 
+### ap
+
+```typescript
+
+ap<T, U>(fns: Array<(a: T) => U>[], vs: T[]): U[]
+```
+
+<details>
+
+<summary>All TypeScript definitions</summary>
+
+```typescript
+ap<T, U>(fns: Array<(a: T) => U>[], vs: T[]): U[];
+ap<T, U>(fns: Array<(a: T) => U>): (vs: T[]) => U[];
+ap<R, A, B>(fn: (r: R, a: A) => B, fn1: (r: R) => A): (r: R) => B;
+```
+
+</details>
+
+<details>
+
+<summary><strong>R.ap</strong> source</summary>
+
+```javascript
+export function ap(functions, input){
+  if (arguments.length === 1){
+    return _inputs => ap(functions, _inputs)
+  }
+
+  return functions.reduce((acc, fn) => [ ...acc, ...input.map(fn) ], [])
+}
+```
+
+</details>
+
+<details>
+
+<summary><strong>Tests</strong></summary>
+
+```javascript
+import { ap } from './ap.js'
+
+function mult2(x){
+  return x * 2
+}
+function plus3(x){
+  return x + 3
+}
+
+test('happy', () => {
+  expect(ap([ mult2, plus3 ], [ 1, 2, 3 ])).toEqual([ 2, 4, 6, 4, 5, 6 ])
+})
+```
+
+</details>
+
+[![---------------](https://raw.githubusercontent.com/selfrefactor/rambda/master/files/separator.png)](#ap)
+
+### aperture
+
+```typescript
+
+aperture<N extends number, T>(n: N, list: T[]): Array<Tuple<T, N>> | []
+```
+
+<details>
+
+<summary>All TypeScript definitions</summary>
+
+```typescript
+aperture<N extends number, T>(n: N, list: T[]): Array<Tuple<T, N>> | [];
+aperture<N extends number>(n: N): <T>(list: T[]) => Array<Tuple<T, N>> | [];
+```
+
+</details>
+
+<details>
+
+<summary><strong>R.aperture</strong> source</summary>
+
+```javascript
+export function aperture(step, list){
+  if (arguments.length === 1){
+    return _list => aperture(step, _list)
+  }
+  if (step > list.length) return []
+  let idx = 0
+  const limit = list.length - (step - 1)
+  const acc = new Array(limit)
+  while (idx < limit){
+    acc[ idx ] = list.slice(idx, idx + step)
+    idx += 1
+  }
+
+  return acc
+}
+```
+
+</details>
+
+<details>
+
+<summary><strong>Tests</strong></summary>
+
+```javascript
+import { aperture } from './aperture.js'
+
+const list = [ 1, 2, 3, 4, 5, 6, 7 ]
+
+test('happy', () => {
+  expect(aperture(1, list)).toEqual([ [ 1 ], [ 2 ], [ 3 ], [ 4 ], [ 5 ], [ 6 ], [ 7 ] ])
+  expect(aperture(2, list)).toEqual([
+    [ 1, 2 ],
+    [ 2, 3 ],
+    [ 3, 4 ],
+    [ 4, 5 ],
+    [ 5, 6 ],
+    [ 6, 7 ],
+  ])
+  expect(aperture(3, list)).toEqual([
+    [ 1, 2, 3 ],
+    [ 2, 3, 4 ],
+    [ 3, 4, 5 ],
+    [ 4, 5, 6 ],
+    [ 5, 6, 7 ],
+  ])
+  expect(aperture(8, list)).toEqual([])
+})
+```
+
+</details>
+
+[![---------------](https://raw.githubusercontent.com/selfrefactor/rambda/master/files/separator.png)](#aperture)
+
 ### append
 
 ```typescript
@@ -950,7 +1084,7 @@ It adds element `x` at the end of `list`.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 append<T>(x: T, list: T[]): T[];
@@ -1008,7 +1142,7 @@ test('with strings', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {append} from 'rambda'
@@ -1048,7 +1182,7 @@ This is useful for creating a fixed-arity function from a variadic function. `fn
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 apply<T = any>(fn: (...args: any[]) => T, args: any[]): T;
@@ -1092,7 +1226,7 @@ test('applies function to argument list', () => {
 
 test('provides no way to specify context', () => {
   const obj = {
-    method : function (){
+    method (){
       return this === obj
     },
   }
@@ -1105,7 +1239,7 @@ test('provides no way to specify context', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {apply, identity} from 'rambda'
@@ -1144,7 +1278,7 @@ applySpec<Spec extends Record<string, AnyFunction>>(
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 applySpec<Spec extends Record<string, AnyFunction>>(
@@ -1539,7 +1673,7 @@ test('restructure json object', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {multiply, applySpec, inc, dec, add} from 'rambda'
@@ -1571,6 +1705,14 @@ describe('applySpec', () => {
 
 [![---------------](https://raw.githubusercontent.com/selfrefactor/rambda/master/files/separator.png)](#applySpec)
 
+### applyTo
+
+[![---------------](https://raw.githubusercontent.com/selfrefactor/rambda/master/files/separator.png)](#applyTo)
+
+### ascend
+
+[![---------------](https://raw.githubusercontent.com/selfrefactor/rambda/master/files/separator.png)](#ascend)
+
 ### assoc
 
 It makes a shallow clone of `obj` with setting or overriding the property `prop` with `newValue`.
@@ -1592,7 +1734,7 @@ It makes a shallow clone of `obj` with setting or overriding with `newValue` the
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 assocPath<Output>(path: Path, newValue: any, obj: object): Output;
@@ -1683,6 +1825,22 @@ test('string can be used as path input', () => {
   expect(result).toEqual(expected)
 })
 
+test('difference with ramda - doesn\'t overwrite primitive values with keys in the path', () => {
+  const obj = { a : 'str' }
+  const result = assocPath(
+    [ 'a', 'b' ], 42, obj
+  )
+
+  expect(result).toEqual({
+    a : {
+      0 : 's',
+      1 : 't',
+      2 : 'r',
+      b : 42,
+    },
+  })
+})
+
 test('bug', () => {
   /*
     https://github.com/selfrefactor/rambda/issues/524
@@ -1831,7 +1989,7 @@ test('happy', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {assocPath} from 'rambda'
@@ -1885,7 +2043,7 @@ Creates a function that is bound to a context.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 bind<F extends AnyFunction, T>(fn: F, thisObj: T): (...args: Parameters<F>) => ReturnType<F>;
@@ -2010,7 +2168,7 @@ test('preserves arity', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {bind} from 'rambda'
@@ -2049,7 +2207,7 @@ This function will return `true`, if both `firstCondition` and `secondCondition`
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 both(pred1: Pred, pred2: Pred): Pred;
@@ -2127,7 +2285,7 @@ test('skip evaluation of the second expression', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {both} from 'rambda'
@@ -2193,7 +2351,7 @@ The method is also known as `flatMap`.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 chain<T, U>(fn: (n: T) => U[], list: T[]): U[];
@@ -2292,7 +2450,7 @@ test('@types/ramda broken test', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {chain} from 'rambda'
@@ -2404,7 +2562,7 @@ It counts elements in a list after each instance of the input list is passed thr
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 countBy<T extends unknown>(transformFn: (x: T) => any, list: T[]): Record<string, number>;
@@ -2462,7 +2620,7 @@ test('happy', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {countBy} from 'rambda'
@@ -2523,7 +2681,7 @@ Else, it returns the first truthy `inputArguments` instance(from left to right).
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 defaultTo<T>(defaultValue: T, input: T | null | undefined): T;
@@ -2590,7 +2748,7 @@ test('when inputArgument passes initial check', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {defaultTo} from 'rambda'
@@ -2611,6 +2769,10 @@ describe('R.defaultTo with Ramda spec', () => {
 
 [![---------------](https://raw.githubusercontent.com/selfrefactor/rambda/master/files/separator.png)](#defaultTo)
 
+### descend
+
+[![---------------](https://raw.githubusercontent.com/selfrefactor/rambda/master/files/separator.png)](#descend)
+
 ### difference
 
 ```typescript
@@ -2626,7 +2788,7 @@ It returns the uniq set of all elements in the first list `a` not contained in t
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 difference<T>(a: T[], b: T[]): T[];
@@ -2691,7 +2853,7 @@ test('should use R.equals', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {difference} from 'rambda'
@@ -2717,6 +2879,91 @@ describe('R.difference', () => {
 
 [![---------------](https://raw.githubusercontent.com/selfrefactor/rambda/master/files/separator.png)](#difference)
 
+### differenceWith
+
+```typescript
+
+differenceWith<T1, T2>(
+  pred: (a: T1, b: T2) => boolean,
+  list1: T1[],
+  list2: T2[],
+): T1[]
+```
+
+<details>
+
+<summary>All TypeScript definitions</summary>
+
+```typescript
+differenceWith<T1, T2>(
+  pred: (a: T1, b: T2) => boolean,
+  list1: T1[],
+  list2: T2[],
+): T1[];
+differenceWith<T1, T2>(
+  pred: (a: T1, b: T2) => boolean,
+): (list1: T1[], list2: T2[]) => T1[];
+differenceWith<T1, T2>(
+  pred: (a: T1, b: T2) => boolean,
+  list1: T1[],
+): (list2: T2[]) => T1[];
+```
+
+</details>
+
+<details>
+
+<summary><strong>R.differenceWith</strong> source</summary>
+
+```javascript
+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)
+```
+
+</details>
+
+<details>
+
+<summary><strong>Tests</strong></summary>
+
+```javascript
+import { differenceWith } from './differenceWith.js'
+
+test('happy', () => {
+  const foo = [ { a : 1 }, { a : 2 }, { a : 3 } ]
+  const bar = [ { a : 3 }, { a : 4 } ]
+  const fn = function (r, s){
+    return r.a === s.a
+  }
+  const result = differenceWith(
+    fn, foo, bar
+  )
+  expect(result).toEqual([ { a : 1 }, { a : 2 } ])
+})
+```
+
+</details>
+
+[![---------------](https://raw.githubusercontent.com/selfrefactor/rambda/master/files/separator.png)](#differenceWith)
+
 ### dissoc
 
 It returns a new object that does not contain property `prop`.
@@ -2744,7 +2991,7 @@ It returns `howMany` items dropped from beginning of list or string `input`.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 drop<T>(howMany: number, input: T[]): T[];
@@ -2808,7 +3055,7 @@ test('should return copy', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {drop} from 'rambda'
@@ -2857,7 +3104,7 @@ It returns `howMany` items dropped from the end of list or string `input`.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 dropLast<T>(howMany: number, input: T[]): T[];
@@ -2925,7 +3172,7 @@ test('should return copy', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {dropLast} from 'rambda'
@@ -2980,7 +3227,7 @@ It removes any successive duplicates according to `R.equals`.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 dropRepeats<T>(list: T[]): T[];
@@ -3070,7 +3317,7 @@ describe('brute force', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {dropRepeats} from 'rambda'
@@ -3115,7 +3362,7 @@ This `predicate` function will return `true`, if any of the two input predicates
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 either(firstPredicate: Pred, secondPredicate: Pred): Pred;
@@ -3200,7 +3447,7 @@ test('case 2', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {either} from 'rambda'
@@ -3257,7 +3504,7 @@ describe('R.either', () => {
 
 ```typescript
 
-endsWith(target: string, iterable: string): boolean
+endsWith<T extends string>(question: T, str: string): boolean
 ```
 
 When iterable is a string, then it behaves as `String.prototype.endsWith`.
@@ -3267,13 +3514,13 @@ When iterable is a list, then it uses R.equals to determine if the target list e
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
-endsWith(target: string, iterable: string): boolean;
-endsWith(target: string): (iterable: string) => boolean;
-endsWith<T>(target: T[], list: T[]): boolean;
-endsWith<T>(target: T[]): (list: T[]) => boolean;
+endsWith<T extends string>(question: T, str: string): boolean;
+endsWith<T extends string>(question: T): (str: string) => boolean;
+endsWith<T>(question: T[], list: T[]): boolean;
+endsWith<T>(question: T[]): (list: T[]) => boolean;
 ```
 
 </details>
@@ -3378,37 +3625,33 @@ describe('brute force', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {endsWith} from 'rambda'
 
-describe('R.endsWith - array as iterable', () => {
+describe('R.endsWith - array', () => {
   const target = [{a: 2}]
-  const iterable = [{a: 1}, {a: 2}]
+  const input = [{a: 1}, {a: 2}]
   it('happy', () => {
-    const result = endsWith(target, iterable)
-
+    const result = endsWith(target, input)
     result // $ExpectType boolean
   })
   it('curried', () => {
-    const result = endsWith(target)(iterable)
-
+    const result = endsWith(target)(input)
     result // $ExpectType boolean
   })
 })
 
-describe('R.endsWith - string as iterable', () => {
+describe('R.endsWith - string', () => {
   const target = 'bar'
-  const iterable = 'foo bar'
+  const input = 'foo bar'
   it('happy', () => {
-    const result = endsWith(target, iterable)
-
+    const result = endsWith(target, input)
     result // $ExpectType boolean
   })
   it('curried', () => {
-    const result = endsWith(target)(iterable)
-
+    const result = endsWith(target)(input)
     result // $ExpectType boolean
   })
 })
@@ -3439,7 +3682,7 @@ It deeply compares `x` and `y` and returns `true` if they are equal.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 equals<T>(x: T, y: T): boolean;
@@ -3965,7 +4208,7 @@ describe('brute force', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {equals} from 'rambda'
@@ -4006,7 +4249,7 @@ It takes object or array of functions as set of rules. These `rules` are applied
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 evolve<T, U>(rules: ((x: T) => U)[], list: T[]): U[];
@@ -4214,7 +4457,7 @@ describe('brute force', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {evolve, add} from 'rambda'
@@ -4269,7 +4512,7 @@ F(): boolean
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 F(): boolean;
@@ -4304,7 +4547,7 @@ It filters list or object `input` using a `predicate` function.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 filter<T>(predicate: Predicate<T>): (input: T[]) => T[];
@@ -4445,7 +4688,7 @@ test('bad inputs difference between Ramda and Rambda', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {filter} from 'rambda'
@@ -4513,7 +4756,7 @@ If there is no such element, it returns `undefined`.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 find<T>(predicate: (x: T) => boolean, list: T[]): T | undefined;
@@ -4557,12 +4800,12 @@ import { propEq } from './propEq.js'
 const list = [ { a : 1 }, { a : 2 }, { a : 3 } ]
 
 test('happy', () => {
-  const fn = propEq('a', 2)
+  const fn = propEq(2, 'a')
   expect(find(fn, list)).toEqual({ a : 2 })
 })
 
 test('with curry', () => {
-  const fn = propEq('a', 4)
+  const fn = propEq(4, 'a')
   expect(find(fn)(list)).toBeUndefined()
 })
 
@@ -4575,7 +4818,7 @@ test('with empty list', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {find} from 'rambda'
@@ -4615,7 +4858,7 @@ If there is no such element, then `-1` is returned.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 findIndex<T>(predicate: (x: T) => boolean, list: T[]): number;
@@ -4658,11 +4901,9 @@ import { propEq } from './propEq.js'
 const list = [ { a : 1 }, { a : 2 }, { a : 3 } ]
 
 test('happy', () => {
-  expect(findIndex(propEq('a', 2), list)).toBe(1)
-
-  expect(findIndex(propEq('a', 1))(list)).toBe(0)
-
-  expect(findIndex(propEq('a', 4))(list)).toEqual(-1)
+  expect(findIndex(propEq(2, 'a'), list)).toBe(1)
+  expect(findIndex(propEq(1, 'a'))(list)).toBe(0)
+  expect(findIndex(propEq(4, 'a'))(list)).toBe(-1)
 })
 ```
 
@@ -4670,7 +4911,7 @@ test('happy', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {findIndex} from 'rambda'
@@ -4710,7 +4951,7 @@ If there is no such element, then `undefined` is returned.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 findLast<T>(fn: (x: T) => boolean, list: T[]): T | undefined;
@@ -4799,7 +5040,7 @@ test('ramda 4', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {findLast} from 'rambda'
@@ -4839,7 +5080,7 @@ If there is no such element, then `-1` is returned.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 findLastIndex<T>(predicate: (x: T) => boolean, list: T[]): number;
@@ -4913,7 +5154,7 @@ test('ramda 1', () => {
 })
 
 test('ramda 2', () => {
-  expect(findLastIndex(even, [ 'zing' ])).toEqual(-1)
+  expect(findLastIndex(even, [ 'zing' ])).toBe(-1)
 })
 
 test('ramda 3', () => {
@@ -4921,7 +5162,7 @@ test('ramda 3', () => {
 })
 
 test('ramda 4', () => {
-  expect(findLastIndex(even, [])).toEqual(-1)
+  expect(findLastIndex(even, [])).toBe(-1)
 })
 ```
 
@@ -4929,7 +5170,7 @@ test('ramda 4', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {findLastIndex} from 'rambda'
@@ -4967,7 +5208,7 @@ It deeply flattens an array.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 flatten<T>(list: any[]): T[];
@@ -5026,7 +5267,7 @@ test('readme example', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {flatten} from 'rambda'
@@ -5064,7 +5305,7 @@ It applies `iterable` function over all members of `list` and returns `list`.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 forEach<T>(fn: Iterator<T, void>, list: T[]): T[];
@@ -5188,7 +5429,7 @@ test('returns the input', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {forEach} from 'rambda'
@@ -5280,7 +5521,7 @@ It returns `true` if `obj` has property `prop`.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 has<T>(prop: string, obj: T): boolean;
@@ -5330,7 +5571,7 @@ test('with non-object', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {has} from 'rambda'
@@ -5365,7 +5606,7 @@ It will return true, if `input` object has truthy `path`(calculated with `R.path
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 hasPath<T>(
@@ -5429,7 +5670,7 @@ test('when false', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {hasPath} from 'rambda'
@@ -5469,12 +5710,12 @@ It returns the first element of list or string `input`.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 head(input: string): string;
 head(emptyList: []): undefined;
-head<T>(input: T[]): T | undefined;
+head<T extends readonly unknown[]>(array: T): FirstArrayElement<T>
 ```
 
 </details>
@@ -5512,9 +5753,10 @@ test('head', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
+import {mixedList, mixedListConst} from '_internals/typescriptTestUtils'
 import {head} from 'rambda'
 
 describe('R.head', () => {
@@ -5522,12 +5764,18 @@ describe('R.head', () => {
     const result = head('foo')
     result // $ExpectType string
   })
-
   it('array', () => {
     const result = head([1, 2, 3])
-    result // $ExpectType number | undefined
+    result // $ExpectType number
+  })
+  it('mixed', () => {
+    const result = head(mixedList)
+    result // $ExpectType string | number
+  })
+  it('mixed const', () => {
+    const result = head(mixedListConst)
+    result // $ExpectType 1
   })
-
   it('empty array - case 1', () => {
     const result = head([])
     result // $ExpectType undefined
@@ -5535,7 +5783,7 @@ describe('R.head', () => {
   it('empty array - case 2', () => {
     const list = ['foo', 'bar'].filter(x => x.startsWith('a'))
     const result = head(list)
-    result // $ExpectType string | undefined
+    result // $ExpectType string
   })
 })
 ```
@@ -5567,7 +5815,7 @@ It just passes back the supplied `input` argument.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 identity<T>(input: T): T;
@@ -5605,7 +5853,7 @@ test('happy', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {identity} from 'rambda'
@@ -5641,7 +5889,7 @@ When `fn`` is called with `input` argument, it will return either `onTrue(input)
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 ifElse<T, TFiltered extends T, TOnTrueResult, TOnFalseResult>(
@@ -5784,7 +6032,7 @@ test('simple arity of 2', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {ifElse} from 'rambda'
@@ -5846,7 +6094,7 @@ It increments a number.
 
 ```typescript
 
-includes(valueToFind: string, input: string[] | string): boolean
+includes<T extends string>(valueToFind: T, input: string): boolean
 ```
 
 If `input` is string, then this method work as native `String.includes`.
@@ -5857,11 +6105,11 @@ If `input` is array, then `R.equals` is used to define if `valueToFind` belongs
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
-includes(valueToFind: string, input: string[] | string): boolean;
-includes(valueToFind: string): (input: string[] | string) => boolean;
+includes<T extends string>(valueToFind: T, input: string): boolean;
+includes<T extends string>(valueToFind: T): (input: string) => boolean;
 includes<T>(valueToFind: T, input: T[]): boolean;
 includes<T>(valueToFind: T): (input: T[]) => boolean;
 ```
@@ -5958,7 +6206,7 @@ test('throws on wrong input - match ramda behaviour', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {includes} from 'rambda'
@@ -5969,10 +6217,13 @@ describe('R.includes', () => {
   it('happy', () => {
     const result = includes({a: {b: '1'}}, list)
     result // $ExpectType boolean
+    const result2 = includes('oo', ['f', 'oo'])
+    result2 // $ExpectType boolean
   })
   it('with string', () => {
-    const result = includes('oo', 'foo')
-    const curriedResult = includes('oo')('foo')
+    const str = 'foo' as 'foo' | 'bar'
+    const result = includes('oo', str)
+    const curriedResult = includes('oo')(str)
 
     result // $ExpectType boolean
     curriedResult // $ExpectType boolean
@@ -6019,7 +6270,7 @@ It returns all but the last element of list or string `input`.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 init<T extends unknown[]>(input: T): T extends readonly [...infer U, any] ? U : [...T];
@@ -6075,7 +6326,7 @@ test('with string', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {init} from 'rambda'
@@ -6140,7 +6391,7 @@ It returns `true` if `x` is `empty`.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 isEmpty<T>(x: T): boolean;
@@ -6202,7 +6453,7 @@ test('happy', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {isEmpty} from 'rambda'
@@ -6232,7 +6483,7 @@ It returns `true` if `x` is either `null` or `undefined`.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 isNil(x: any): x is null | undefined;
@@ -6285,7 +6536,7 @@ It returns a string of all `list` instances joined with a `glue`.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 join<T>(glue: string, list: T[]): string;
@@ -6330,7 +6581,7 @@ test('curry', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {join} from 'rambda'
@@ -6360,7 +6611,7 @@ It applies list of function to a list of inputs.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 juxt<A extends any[], R1>(fns: [(...a: A) => R1]): (...a: A) => [R1];
@@ -6405,7 +6656,7 @@ test('happy', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {juxt} from 'rambda'
@@ -6436,7 +6687,7 @@ It applies `Object.keys` over `x` and returns its keys.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 keys<T extends object>(x: T): (keyof T)[];
@@ -6473,7 +6724,7 @@ test('happy', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {keys} from 'rambda'
@@ -6496,7 +6747,7 @@ describe('R.keys', () => {
 
 ```typescript
 
-last(str: string): string
+last(input: string): string
 ```
 
 It returns the last element of `input`, as the `input` can be either a string or an array.
@@ -6505,12 +6756,12 @@ It returns the last element of `input`, as the `input` can be either a string or
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
-last(str: string): string;
+last(input: string): string;
 last(emptyList: []): undefined;
-last<T extends any>(list: T[]): T | undefined;
+last<T extends readonly unknown[]>(array: T): LastArrayElement<T>
 ```
 
 </details>
@@ -6553,9 +6804,10 @@ test('with string', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
+import {mixedList, mixedListConst} from '_internals/typescriptTestUtils'
 import {last} from 'rambda'
 
 describe('R.last', () => {
@@ -6563,12 +6815,18 @@ describe('R.last', () => {
     const result = last('foo')
     result // $ExpectType string
   })
-
   it('array', () => {
     const result = last([1, 2, 3])
-    result // $ExpectType number | undefined
+    result // $ExpectType number
+  })
+  it('mixed', () => {
+    const result = last(mixedList)
+    result // $ExpectType string | number
+  })
+  it('mixed const', () => {
+    const result = last(mixedListConst)
+    result // $ExpectType "bar"
   })
-
   it('empty array - case 1', () => {
     const result = last([])
     result // $ExpectType undefined
@@ -6576,7 +6834,7 @@ describe('R.last', () => {
   it('empty array - case 2', () => {
     const list = ['foo', 'bar'].filter(x => x.startsWith('a'))
     const result = last(list)
-    result // $ExpectType string | undefined
+    result // $ExpectType string
   })
 })
 ```
@@ -6602,7 +6860,7 @@ If there is no such index, then `-1` is returned.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 lastIndexOf<T>(target: T, list: T[]): number;
@@ -6645,13 +6903,13 @@ test('with NaN', () => {
 })
 
 test('will throw with bad input', () => {
-  expect(lastIndexOfRamda([], true)).toEqual(-1)
+  expect(lastIndexOfRamda([], true)).toBe(-1)
   expect(() => indexOf([], true)).toThrowErrorMatchingInlineSnapshot('"indexOf is not defined"')
 })
 
 test('without list of objects - no R.equals', () => {
   expect(lastIndexOf(3, [ 1, 2, 3, 4 ])).toBe(2)
-  expect(lastIndexOf(10)([ 1, 2, 3, 4 ])).toEqual(-1)
+  expect(lastIndexOf(10)([ 1, 2, 3, 4 ])).toBe(-1)
 })
 
 test('list of objects uses R.equals', () => {
@@ -6699,7 +6957,7 @@ describe('brute force', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {lastIndexOf} from 'rambda'
@@ -6735,7 +6993,7 @@ It returns the `length` property of list or string `input`.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 length<T>(input: T[]): number;
@@ -6821,7 +7079,7 @@ The setter should not mutate the data structure.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 lens<T, U, V>(getter: (s: T) => U, setter: (a: U, s: T) => V): Lens;
@@ -6847,7 +7105,7 @@ export function lens(getter, setter){
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {lens, assoc} from 'rambda'
@@ -6884,7 +7142,7 @@ It returns a lens that focuses on specified `index`.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 lensIndex(index: number): Lens;
@@ -6975,7 +7233,7 @@ test('get (set(set s v1) v2) === v2', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {view, lensIndex} from 'rambda'
@@ -7011,7 +7269,7 @@ It returns a lens that focuses on specified `path`.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 lensPath(path: RamdaPath): Lens;
@@ -7171,7 +7429,7 @@ test('get (set(set s v1) v2) === v2', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {lensPath, view} from 'rambda'
@@ -7225,7 +7483,7 @@ It returns a lens that focuses on specified property `prop`.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 lensProp(prop: string): {
@@ -7357,7 +7615,7 @@ test('get (set(set s v1) v2) === v2', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {lensProp, view} from 'rambda'
@@ -7399,7 +7657,7 @@ It works with both array and object.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 map<T, U>(fn: ObjectIterator<T, U>, iterable: Dictionary<T>): Dictionary<U>;
@@ -7540,7 +7798,7 @@ test('bad inputs difference between Ramda and Rambda', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {map} from 'rambda'
@@ -7641,7 +7899,7 @@ It works the same way as `R.map` does for objects. It is added as Ramda also has
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 mapObjIndexed<T>(fn: ObjectIterator<T, T>, iterable: Dictionary<T>): Dictionary<T>;
@@ -7654,7 +7912,7 @@ mapObjIndexed<T, U>(fn: ObjectIterator<T, U>): (iterable: Dictionary<T>) => Dict
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {mapObjIndexed} from 'rambda'
@@ -7718,7 +7976,7 @@ Curried version of `String.prototype.match` which returns empty array, when ther
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 match(regExpression: RegExp, str: string): string[];
@@ -7775,7 +8033,7 @@ test('throwing', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {match} from 'rambda'
@@ -7835,7 +8093,7 @@ It returns the mean value of `list` input.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 mean(list: number[]): number;
@@ -7877,7 +8135,7 @@ test('with NaN', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {mean} from 'rambda'
@@ -7908,7 +8166,7 @@ It returns the median value of `list` input.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 median(list: number[]): number;
@@ -7963,7 +8221,7 @@ test('with empty array', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {median} from 'rambda'
@@ -8000,7 +8258,7 @@ It merges all objects of `list` array sequentially and returns the result.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 mergeAll<T>(list: object[]): T;
@@ -8053,13 +8311,36 @@ test('case 2', () => {
     baz : 3,
   })
 })
+
+describe('acts as if nil values are simply empty objects', () => {
+  it('if the first object is nil', () => {
+    expect(mergeAll([ null, { foo : 1 }, { foo : 2 }, { bar : 2 } ])).toEqual({
+      foo : 2,
+      bar : 2,
+    })
+  })
+
+  it('if the last object is nil', () => {
+    expect(mergeAll([ { foo : 1 }, { foo : 2 }, { bar : 2 }, undefined ])).toEqual({
+      foo : 2,
+      bar : 2,
+    })
+  })
+
+  it('if an intermediate object is nil', () => {
+    expect(mergeAll([ { foo : 1 }, { foo : 2 }, null, { bar : 2 } ])).toEqual({
+      foo : 2,
+      bar : 2,
+    })
+  })
+})
 ```
 
 </details>
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {mergeAll} from 'rambda'
@@ -8100,7 +8381,7 @@ Creates a new object with the own properties of the first object merged with the
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 mergeDeepRight<Output>(target: object, newProps: object): Output;
@@ -8280,7 +8561,7 @@ test('functions are not discarded', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {mergeDeepRight} from 'rambda'
@@ -8314,7 +8595,7 @@ Same as `R.merge`, but in opposite direction.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 mergeLeft<Output>(newProps: object, target: object): Output;
@@ -8378,7 +8659,7 @@ test('when undefined or null instead of object', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {mergeLeft} from 'rambda'
@@ -8423,7 +8704,7 @@ It takes two objects and a function, which will be used when there is an overlap
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 mergeWith(fn: (x: any, z: any) => any, a: Record<string, unknown>, b: Record<string, unknown>): Record<string, unknown>;
@@ -8444,8 +8725,10 @@ mergeWith<Output>(fn: (x: any, z: any) => any): <U, V>(a: U, b: V) => Output;
 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 => {
@@ -8501,13 +8784,46 @@ test('happy', () => {
   }
   expect(result).toEqual(expected)
 })
+
+// https://github.com/ramda/ramda/pull/3222/files#diff-d925d9188b478d2f1d4b26012c6dddac374f9e9d7a336604d654b9a113bfc857
+describe('acts as if nil values are simply empty objects', () => {
+  it('if the first object is nil and the second empty', () => {
+    expect(mergeWith(
+      concat, undefined, {}
+    )).toEqual({})
+  })
+
+  it('if the first object is empty and the second nil', () => {
+    expect(mergeWith(
+      concat, {}, null
+    )).toEqual({})
+  })
+
+  it('if both objects are nil', () => {
+    expect(mergeWith(
+      concat, undefined, null
+    )).toEqual({})
+  })
+
+  it('if the first object is not empty and the second is nil', () => {
+    expect(mergeWith(
+      concat, { a : 'a' }, null
+    )).toEqual({ a : 'a' })
+  })
+
+  it('if the first object is nil and the second is not empty', () => {
+    expect(mergeWith(
+      concat, undefined, { a : 'a' }
+    )).toEqual({ a : 'a' })
+  })
+})
 ```
 
 </details>
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {concat, mergeWith} from 'rambda'
@@ -8589,7 +8905,7 @@ modify<T extends object, K extends keyof T, P>(
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 modify<T extends object, K extends keyof T, P>(
@@ -8738,7 +9054,7 @@ describe('brute force', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {modify, add} from 'rambda'
@@ -8777,7 +9093,7 @@ It changes a property of object on the base of provided path and transformer fun
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 modifyPath<T extends Record<string, unknown>>(path: Path, fn: (x: any) => unknown, object: Record<string, unknown>): T;
@@ -8856,7 +9172,7 @@ test('with array', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {modifyPath} from 'rambda'
@@ -8925,7 +9241,7 @@ It returns `true`, if all members of array `list` returns `false`, when applied
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 none<T>(predicate: (x: T) => boolean, list: T[]): boolean;
@@ -8974,7 +9290,7 @@ test('when false curried', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {none} from 'rambda'
@@ -9004,70 +9320,6 @@ describe('R.none', () => {
 
 [![---------------](https://raw.githubusercontent.com/selfrefactor/rambda/master/files/separator.png)](#none)
 
-### nop
-
-```typescript
-
-nop(): void
-```
-
-It returns `undefined`.
-
-<a title="redirect to Rambda Repl site" href="https://rambda.now.sh?const%20result%20%3D%20R.nop()%0A%2F%2F%20%3D%3E%20undefined">Try this <strong>R.nop</strong> example in Rambda REPL</a>
-
-<details>
-
-<summary>All Typescript definitions</summary>
-
-```typescript
-nop(): void;
-```
-
-</details>
-
-<details>
-
-<summary><strong>R.nop</strong> source</summary>
-
-```javascript
-export function nop(){}
-```
-
-</details>
-
-<details>
-
-<summary><strong>Tests</strong></summary>
-
-```javascript
-import { nop } from './nop.js'
-
-test('call', () => {
-  expect(nop).not.toThrow()
-})
-```
-
-</details>
-
-<details>
-
-<summary><strong>Typescript</strong> test</summary>
-
-```typescript
-import {nop} from 'rambda'
-
-describe('R.nop', () => {
-  it('call', () => {
-    const result = nop()
-    result // $ExpectType void
-  })
-})
-```
-
-</details>
-
-[![---------------](https://raw.githubusercontent.com/selfrefactor/rambda/master/files/separator.png)](#nop)
-
 ### not
 
 ```typescript
@@ -9081,7 +9333,7 @@ It returns a boolean negated version of `input`.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 not(input: any): boolean;
@@ -9120,7 +9372,7 @@ test('not', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {not} from 'rambda'
@@ -9151,7 +9403,7 @@ Curried version of `input[index]`.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 nth(index: number, input: string): string;	
@@ -9214,7 +9466,7 @@ test('with negative index', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {nth} from 'rambda'
@@ -9272,7 +9524,7 @@ of<T>(x: T): T[]
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 of<T>(x: T): T[];
@@ -9310,7 +9562,7 @@ test('happy', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {of} from 'rambda'
@@ -9348,7 +9600,7 @@ It returns a partial copy of an `obj` without `propsToOmit` properties.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 omit<T, K extends string>(propsToOmit: K[], obj: T): Omit<T, K>;
@@ -9438,7 +9690,7 @@ test('happy', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {omit} from 'rambda'
@@ -9549,7 +9801,7 @@ It returns a function, which invokes only once `fn` function.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 once<T extends AnyFunction>(func: T): T;
@@ -9627,7 +9879,7 @@ test('happy path', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {once} from 'rambda'
@@ -9669,7 +9921,7 @@ It returns a copied **Object** or **Array** with modified value received by appl
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 over<T>(lens: Lens, fn: Arity1Fn, value: T): T;
@@ -9780,7 +10032,7 @@ The name comes from the fact that you partially inject the inputs.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 partial<V0, V1, T>(fn: (x0: V0, x1: V1) => T, args: [V0]): (x1: V1) => T;
@@ -9887,7 +10139,7 @@ test('ramda spec', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {partial} from 'rambda'
@@ -9933,7 +10185,7 @@ Initially the function knows only a part from the whole input object and then `R
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 partialObject<Input, PartialInput, Output>(
@@ -10033,7 +10285,7 @@ test('async function throwing an error', async () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {partialObject, delay} from 'rambda'
@@ -10093,7 +10345,7 @@ It will return array of two objects/arrays according to `predicate` function. Th
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 partition<T>(
@@ -10243,7 +10495,7 @@ test('readme example', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {partition} from 'rambda'
@@ -10306,7 +10558,7 @@ It will return `undefined`, if such path is not found.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 path<S, K0 extends keyof S = keyof S>(path: [K0], obj: S): S[K0];
@@ -10356,12 +10608,7 @@ path<T>(pathToSearch: RamdaPath, obj: any): T | undefined;
 ```javascript
 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
 
@@ -10379,6 +10626,16 @@ 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)
+}
 ```
 
 </details>
@@ -10428,7 +10685,7 @@ test('null is not a valid path', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {path} from 'rambda'
@@ -10508,7 +10765,7 @@ It returns `true` if `pathToSearch` of `input` object is equal to `target` value
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 pathEq(pathToSearch: Path, target: any, input: any): boolean;
@@ -10578,7 +10835,7 @@ test('when wrong path', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {pathEq} from 'rambda'
@@ -10642,7 +10899,7 @@ It reads `obj` input and returns either `R.path(pathToSearch, Record<string, unk
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 pathOr<T>(defaultValue: T, pathToSearch: Path, obj: any): T;
@@ -10726,7 +10983,7 @@ test('curry case (x,y)(z)', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {pathOr} from 'rambda'
@@ -10770,7 +11027,7 @@ Because it calls `R.path`, then `singlePath` can be either string or a list.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 paths<Input, T>(pathsToSearch: Path[], obj: Input): (T | undefined)[];
@@ -10868,7 +11125,7 @@ test('returns undefined for items not found', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {paths} from 'rambda'
@@ -10925,7 +11182,7 @@ String annotation of `propsToPick` is one of the differences between `Rambda` an
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 pick<T, K extends string | number | symbol>(propsToPick: K[], input: T): Pick<T, Exclude<keyof T, Exclude<keyof T, K>>>;
@@ -11057,7 +11314,7 @@ test('with symbol', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {pick} from 'rambda'
@@ -11128,7 +11385,7 @@ Same as `R.pick` but it won't skip the missing props, i.e. it will assign them t
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 pickAll<T, K extends keyof T>(propsToPicks: K[], input: T): Pick<T, K>;
@@ -11218,7 +11475,7 @@ test('with array as condition', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {pickAll} from 'rambda'
@@ -11299,7 +11556,7 @@ It returns list of the values of `property` taken from the all objects inside `l
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 pluck<K extends keyof T, T>(property: K, list: T[]): T[K][];
@@ -11359,7 +11616,7 @@ test('with number', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {pluck} from 'rambda'
@@ -11411,7 +11668,7 @@ It adds element `x` at the beginning of `list`.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 prepend<T>(x: T, input: T[]): T[];
@@ -11465,7 +11722,7 @@ test('with string instead of array', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {prepend} from 'rambda'
@@ -11501,7 +11758,7 @@ product(list: number[]): number
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 product(list: number[]): number;
@@ -11543,7 +11800,7 @@ test('bad input', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {product} from 'rambda'
@@ -11576,7 +11833,7 @@ If there is no such property, it returns `undefined`.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 prop<P extends keyof never, T>(propToFind: P, value: T): Prop<T, P>;
@@ -11630,49 +11887,33 @@ test('prop', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
-import {pipe, prop} from 'rambda'
+import {prop} from 'rambda'
 
 describe('R.prop', () => {
-  const obj = {a: 1, b: 'foo'}
-  interface Something {
-    a?: number,
-    b?: string,
+  interface Foo {
+    a: number,
+    b: string,
+    c?: number,
   }
+  const obj: Foo = {a: 1, b: 'foo'}
 
   it('issue #553', () => {
-    const result = prop('e', {e: 'test1', d: 'test2'})
-    const curriedResult = prop<string>('e')({e: 'test1', d: 'test2'})
-
-    result // $ExpectType string
-    curriedResult // $ExpectType string
-  })
-  it('happy', () => {
-    const result = prop('a', obj)
-
-    result // $ExpectType number
-  })
-  it('curried', () => {
-    const result = prop('b')(obj)
-
-    result // $ExpectType string
-  })
-  it('curried with explicit object type', () => {
-    const result = prop<'a', Something>('a')(obj)
-
-    result // $ExpectType number | undefined
-  })
-  it('curried with implicit object type', () => {
-    const result = pipe(value => value as Something, prop('b'))(obj)
-
-    result // $ExpectType undefined
-  })
-  it('curried with explicit result type', () => {
-    const result = prop<'b', string>('b')(obj)
+    const result = {
+      a: prop('a', obj),
+      b: prop('b', obj),
+      c: prop('c', obj),
+    }
+    const curriedResult = {
+      a: prop('a')(obj),
+      b: prop('b')(obj),
+      c: prop('c')(obj),
+    }
 
-    result // $ExpectType string
+    result // $ExpectType { a: number; b: string; c: number | undefined; }
+    curriedResult // $ExpectType { a: number; b: string; c: number | undefined; }
   })
 })
 
@@ -11700,7 +11941,7 @@ describe('with number as prop', () => {
 
 ```typescript
 
-propEq<K extends string | number>(propToFind: K, valueToMatch: any, obj: Record<K, any>): boolean
+propEq<K extends string | number>(valueToMatch: any, propToFind: K, obj: Record<K, any>): boolean
 ```
 
 It returns true if `obj` has property `propToFind` and its value is equal to `valueToMatch`.
@@ -11709,14 +11950,14 @@ It returns true if `obj` has property `propToFind` and its value is equal to `va
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
-propEq<K extends string | number>(propToFind: K, valueToMatch: any, obj: Record<K, any>): boolean;
-propEq<K extends string | number>(propToFind: K, valueToMatch: any): (obj: Record<K, any>) => boolean;
-propEq<K extends string | number>(propToFind: K): {
-  (valueToMatch: any, obj: Record<K, any>): boolean;
-  (valueToMatch: any): (obj: Record<K, any>) => boolean;
+propEq<K extends string | number>(valueToMatch: any, propToFind: K, obj: Record<K, any>): boolean;
+propEq<K extends string | number>(valueToMatch: any, propToFind: K): (obj: Record<K, any>) => boolean;
+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;
 };
 ```
 
@@ -11732,7 +11973,7 @@ import { equals } from './equals.js'
 import { prop } from './prop.js'
 
 function propEqFn(
-  propToFind, valueToMatch, obj
+  valueToMatch, propToFind, obj
 ){
   if (!obj) return false
 
@@ -11749,14 +11990,16 @@ export const propEq = curry(propEqFn)
 <summary><strong>Tests</strong></summary>
 
 ```javascript
+import { BAR, FOO } from './_internals/testUtils.js'
 import { propEq } from './propEq.js'
 
 test('happy', () => {
-  expect(propEq('foo', 'bar')({ foo : 'bar' })).toBeTrue()
-  expect(propEq('foo', 'bar')({ foo : 'baz' })).toBeFalse()
-  expect(propEq('foo')('bar')({ foo : 'baz' })).toBeFalse()
+  const obj = { [ FOO ] : BAR }
+  expect(propEq(BAR, FOO)(obj)).toBeTrue()
+  expect(propEq(1, FOO)(obj)).toBeFalse()
+  expect(propEq(1)(FOO)(obj)).toBeFalse()
   expect(propEq(
-    'foo', 'bar', null
+    1, 1, null
   )).toBeFalse()
 })
 
@@ -11774,7 +12017,7 @@ test('returns false if called with a null or undefined object', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {propEq} from 'rambda'
@@ -11787,12 +12030,12 @@ const objWithNumberIndex = {[numberProperty]: value}
 
 describe('R.propEq', () => {
   it('happy', () => {
-    const result = propEq(property, value, obj)
+    const result = propEq(value, property, obj)
     result // $ExpectType boolean
   })
 
   it('number is property', () => {
-    const result = propEq(1, value, objWithNumberIndex)
+    const result = propEq(value, 1, objWithNumberIndex)
     result // $ExpectType boolean
   })
 
@@ -11804,10 +12047,7 @@ describe('R.propEq', () => {
     const myObject: MyType = {}
     const valueToFind = '1111'
     // @ts-expect-error
-    propEq('optional', valueToFind, myObject)
-
-    // @ts-expect-error
-    propEq('optional', valueToFind, myObject)
+    propEq(valueToFind, 'optional', myObject)
   })
 
   it('imported from @types/ramda', () => {
@@ -11818,11 +12058,11 @@ describe('R.propEq', () => {
       foo: 'bar',
     }
     const value = ''
-    const result = propEq('foo', value)(obj)
+    const result = propEq(value, 'foo')(obj)
     result // $ExpectType boolean
 
     // @ts-expect-error
-    propEq('bar', value)(obj)
+    propEq(value, 'bar')(obj)
   })
 })
 ```
@@ -11844,7 +12084,7 @@ It returns `true` if `property` of `obj` is from `target` type.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 propIs<C extends AnyFunction, K extends keyof any>(type: C, name: K, obj: any): obj is Record<K, ReturnType<C>>;
@@ -11913,7 +12153,7 @@ test('when false', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {propIs} from 'rambda'
@@ -11951,7 +12191,7 @@ It returns either `defaultValue` or the value of `property` in `obj`.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 propOr<T, P extends string>(defaultValue: T, property: P, obj: Partial<Record<P, T>> | undefined): T;
@@ -12018,7 +12258,7 @@ test('propOr (currying)', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {propOr} from 'rambda'
@@ -12064,7 +12304,7 @@ It takes list with properties `propsToPick` and returns a list with property val
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 props<P extends string, T>(propsToPick: P[], obj: Record<P, T>): T[];
@@ -12128,7 +12368,7 @@ test('wrong input', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {props} from 'rambda'
@@ -12166,7 +12406,7 @@ It returns `true` if the object property satisfies a given predicate.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 propSatisfies<T>(predicate: Predicate<T>, property: string, obj: Record<string, T>): boolean;
@@ -12218,7 +12458,7 @@ test('when false', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {propSatisfies} from 'rambda'
@@ -12256,7 +12496,7 @@ It returns list of numbers between `startInclusive` to `endExclusive` markers.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 range(startInclusive: number, endExclusive: number): number[];
@@ -12323,7 +12563,7 @@ test('curry', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {range} from 'rambda'
@@ -12365,7 +12605,7 @@ It has the opposite effect of `R.filter`.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 reject<T>(predicate: Predicate<T>, list: T[]): T[];
@@ -12423,7 +12663,7 @@ test('with object', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {reject} from 'rambda'
@@ -12484,7 +12724,7 @@ repeat<T>(x: T): (timesToRepeat: number) => T[]
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 repeat<T>(x: T): (timesToRepeat: number) => T[];
@@ -12533,7 +12773,7 @@ test('repeat', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {repeat} from 'rambda'
@@ -12560,7 +12800,7 @@ describe('R.repeat', () => {
 
 ```typescript
 
-replace(strOrRegex: RegExp | string, replacer: string, str: string): string
+replace(strOrRegex: RegExp | string, replacer: RegExpReplacer, str: string): string
 ```
 
 It replaces `strOrRegex` found in `str` with `replacer`.
@@ -12569,12 +12809,12 @@ It replaces `strOrRegex` found in `str` with `replacer`.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
-replace(strOrRegex: RegExp | string, replacer: string, str: string): string;
-replace(strOrRegex: RegExp | string, replacer: string): (str: string) => string;
-replace(strOrRegex: RegExp | string): (replacer: string) => (str: string) => string;
+replace(strOrRegex: RegExp | string, replacer: RegExpReplacer, str: string): string;
+replace(strOrRegex: RegExp | string, replacer: RegExpReplacer): (str: string) => string;
+replace(strOrRegex: RegExp | string): (replacer: RegExpReplacer) => (str: string) => string;
 ```
 
 </details>
@@ -12606,20 +12846,24 @@ import { replace } from './replace.js'
 
 test('happy', () => {
   expect(replace(
-    'foo', 'yes', 'foo bar baz'
-  )).toBe('yes bar baz')
+    /\s/g, '|', 'foo bar baz'
+  )).toBe('foo|bar|baz')
 })
 
-test('1', () => {
-  expect(replace(/\s/g)('|')('foo bar baz')).toBe('foo|bar|baz')
-})
-
-test('2', () => {
-  expect(replace(/\s/g)('|', 'foo bar baz')).toBe('foo|bar|baz')
-})
+test('with function as replacer input', () => {
+  expect(replace(
+    /\s/g,
+    (
+      match, offset, str
+    ) => {
+      expect(match).toBe(' ')
+      expect([ 3, 7 ].includes(offset)).toBeTrue()
+      expect(str).toBe('foo bar baz')
 
-test('3', () => {
-  expect(replace(/\s/g, '|')('foo bar baz')).toBe('foo|bar|baz')
+      return '|'
+    },
+    'foo bar baz'
+  )).toBe('foo|bar|baz')
 })
 ```
 
@@ -12627,7 +12871,7 @@ test('3', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {replace} from 'rambda'
@@ -12644,6 +12888,16 @@ describe('R.replace', () => {
   it('with string as search pattern', () => {
     const result = replace('foo', replacer, str)
 
+    result // $ExpectType string
+  })
+  it('with function as replacer', () => {
+    const result = replace('f(o)o', (m: string, p1: string, offset: number) => {
+      m // $ExpectType string
+      p1 // $ExpectType string
+      offset // $ExpectType number
+      return p1
+    }, str)
+
     result // $ExpectType string
   })
 })
@@ -12657,6 +12911,16 @@ describe('R.replace - curried', () => {
   it('with string as search pattern', () => {
     const result = replace('foo', replacer)(str)
 
+    result // $ExpectType string
+  })
+  it('with function as replacer', () => {
+    const result = replace('f(o)o')((m: string, p1: string, offset: number) => {
+      m // $ExpectType string
+      p1 // $ExpectType string
+      offset // $ExpectType number
+      return p1
+    })(str)
+
     result // $ExpectType string
   })
 })
@@ -12679,7 +12943,7 @@ It returns a reversed copy of list or string `input`.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 reverse<T>(input: T[]): T[];
@@ -12693,10 +12957,9 @@ reverse(input: string): string;
 <summary><strong>R.reverse</strong> source</summary>
 
 ```javascript
-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()
@@ -12712,22 +12975,22 @@ export function reverse(listOrString){
 <summary><strong>Tests</strong></summary>
 
 ```javascript
-import { reverse } from './reverse.js'
+import {reverse} from './reverse.js'
 
 test('happy', () => {
-  expect(reverse([ 1, 2, 3 ])).toEqual([ 3, 2, 1 ])
+  expect(reverse([1, 2, 3])).toEqual([3, 2, 1])
 })
 
 test('with string', () => {
   expect(reverse('baz')).toBe('zab')
 })
 
-test('it doesn\'t mutate', () => {
-  const arr = [ 1, 2, 3 ]
+test("it doesn't mutate", () => {
+  const arr = [1, 2, 3]
 
-  expect(reverse(arr)).toEqual([ 3, 2, 1 ])
+  expect(reverse(arr)).toEqual([3, 2, 1])
 
-  expect(arr).toEqual([ 1, 2, 3 ])
+  expect(arr).toEqual([1, 2, 3])
 })
 ```
 
@@ -12735,7 +12998,7 @@ test('it doesn\'t mutate', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {reverse} from 'rambda'
@@ -12767,7 +13030,7 @@ It returns a copied **Object** or **Array** with modified `lens` focus set to `r
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 set<T, U>(lens: Lens, replacer: U, obj: T): T;
@@ -12782,16 +13045,12 @@ set(lens: Lens): <T, U>(replacer: U, obj: T) => T;
 <summary><strong>R.set</strong> source</summary>
 
 ```javascript
-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)
@@ -12804,43 +13063,39 @@ export const set = curry(setFn)
 <summary><strong>Tests</strong></summary>
 
 ```javascript
-import { assoc } from './assoc.js'
-import { lens } from './lens.js'
-import { lensIndex } from './lensIndex.js'
-import { lensPath } from './lensPath.js'
-import { prop } from './prop.js'
-import { set } from './set.js'
+import {assoc} from './assoc.js'
+import {lens} from './lens.js'
+import {lensIndex} from './lensIndex.js'
+import {lensPath} from './lensPath.js'
+import {prop} from './prop.js'
+import {set} from './set.js'
 
 const testObject = {
-  foo : 'bar',
-  baz : {
-    a : 'x',
-    b : 'y',
+  foo: 'bar',
+  baz: {
+    a: 'x',
+    b: 'y',
   },
 }
 
 test('assoc lens', () => {
   const assocLens = lens(prop('foo'), assoc('foo'))
-  const result = set(
-    assocLens, 'FOO', testObject
-  )
+  const result = set(assocLens, 'FOO', testObject)
   const expected = {
     ...testObject,
-    foo : 'FOO',
+    foo: 'FOO',
   }
   expect(result).toEqual(expected)
 })
 
 test('path lens', () => {
   const pathLens = lensPath('baz.a')
-  const result = set(
-    pathLens, 'z', testObject
-  )
+  const result = set(pathLens, 'z', testObject)
   const expected = {
     ...testObject,
-    baz : {
-      a : 'z',
-      b : 'y',
+    baz: {
+      a: 'z',
+      b: 'y',
     },
   }
   expect(result).toEqual(expected)
@@ -12849,10 +13104,8 @@ test('path lens', () => {
 test('index lens', () => {
   const indexLens = lensIndex(0)
 
-  const result = set(
-    indexLens, 3, [ 1, 2 ]
-  )
-  expect(result).toEqual([ 3, 2 ])
+  const result = set(indexLens, 3, [1, 2])
+  expect(result).toEqual([3, 2])
 })
 ```
 
@@ -12871,7 +13124,7 @@ slice(from: number, to: number, input: string): string
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 slice(from: number, to: number, input: string): string;
@@ -12936,7 +13189,7 @@ test('slice', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {slice} from 'rambda'
@@ -12972,7 +13225,7 @@ It returns copy of `list` sorted by `sortFn` function, where `sortFn` needs to r
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 sort<T>(sortFn: (a: T, b: T) => number, list: T[]): T[];
@@ -13025,7 +13278,7 @@ test('it doesn\'t mutate', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {sort} from 'rambda'
@@ -13065,7 +13318,7 @@ It returns copy of `list` sorted by `sortFn` function, where `sortFn` function r
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 sortBy<T>(sortFn: (a: T) => Ord, list: T[]): T[];
@@ -13142,7 +13395,7 @@ test('with compose', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {sortBy, pipe} from 'rambda'
@@ -13211,7 +13464,7 @@ Curried version of `String.prototype.split`
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 split(separator: string | RegExp): (str: string) => string[];
@@ -13258,7 +13511,7 @@ test('curried', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {split} from 'rambda'
@@ -13297,7 +13550,7 @@ It splits string or array at a given index.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 splitAt<T>(index: number, input: T[]): [T[], T[]];
@@ -13410,7 +13663,7 @@ test('with bad inputs', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {splitAt} from 'rambda'
@@ -13463,7 +13716,7 @@ It splits `input` into slices of `sliceLength`.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 splitEvery<T>(sliceLength: number, input: T[]): (T[])[];
@@ -13530,7 +13783,7 @@ test('with bad input', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {splitEvery} from 'rambda'
@@ -13570,7 +13823,7 @@ The first array contains all members of `list` before `predicate` returns `true`
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 splitWhen<T, U>(predicate: Predicate<T>, list: U[]): (U[])[];
@@ -13658,7 +13911,7 @@ test('with bad inputs', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {splitWhen} from 'rambda'
@@ -13688,7 +13941,7 @@ describe('R.splitWhen', () => {
 
 ```typescript
 
-startsWith(target: string, str: string): boolean
+startsWith<T extends string>(question: T, input: string): boolean
 ```
 
 When iterable is a string, then it behaves as `String.prototype.startsWith`.
@@ -13698,13 +13951,13 @@ When iterable is a list, then it uses R.equals to determine if the target list s
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
-startsWith(target: string, str: string): boolean;
-startsWith(target: string): (str: string) => boolean;
-startsWith<T>(target: T[], list: T[]): boolean;
-startsWith<T>(target: T[]): (list: T[]) => boolean;
+startsWith<T extends string>(question: T, input: string): boolean;
+startsWith<T extends string>(question: T): (input: string) => boolean;
+startsWith<T>(question: T[], input: T[]): boolean;
+startsWith<T>(question: T[]): (input: T[]) => boolean;
 ```
 
 </details>
@@ -13717,17 +13970,17 @@ startsWith<T>(target: T[]): (list: T[]) => boolean;
 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
@@ -13735,7 +13988,7 @@ export function startsWith(target, iterable){
     return result
   })
 
-  return filtered.length === target.length
+  return filtered.length === question.length
 }
 ```
 
@@ -13792,37 +14045,33 @@ describe('brute force', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {startsWith} from 'rambda'
 
-describe('R.startsWith - array as iterable', () => {
-  const target = [{a: 1}]
+describe('R.startsWith - array', () => {
+  const question = [{a: 1}]
   const iterable = [{a: 1}, {a: 2}]
   it('happy', () => {
-    const result = startsWith(target, iterable)
-
+    const result = startsWith(question, iterable)
     result // $ExpectType boolean
   })
   it('curried', () => {
-    const result = startsWith(target)(iterable)
-
+    const result = startsWith(question)(iterable)
     result // $ExpectType boolean
   })
 })
 
-describe('R.startsWith - string as iterable', () => {
-  const target = 'foo'
+describe('R.startsWith - string', () => {
+  const question = 'foo'
   const iterable = 'foo bar'
   it('happy', () => {
-    const result = startsWith(target, iterable)
-
+    const result = startsWith(question, iterable)
     result // $ExpectType boolean
   })
   it('curried', () => {
-    const result = startsWith(target)(iterable)
-
+    const result = startsWith(question)(iterable)
     result // $ExpectType boolean
   })
 })
@@ -13851,7 +14100,7 @@ sum(list: number[]): number
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 sum(list: number[]): number;
@@ -13902,7 +14151,7 @@ It returns a merged list of `x` and `y` with all equal elements removed.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 symmetricDifference<T>(x: T[], y: T[]): T[];
@@ -13963,7 +14212,7 @@ test('symmetricDifference with objects', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {symmetricDifference} from 'rambda'
@@ -14002,7 +14251,7 @@ T(): boolean
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 T(): boolean;
@@ -14037,7 +14286,7 @@ It returns all but the first element of `input`.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 tail<T extends unknown[]>(input: T): T extends [any, ...infer U] ? U : [...T];
@@ -14084,7 +14333,7 @@ test('tail', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {tail} from 'rambda'
@@ -14125,7 +14374,7 @@ It returns the first `howMany` elements of `input`.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 take<T>(howMany: number, input: T[]): T[];
@@ -14193,7 +14442,7 @@ test('with zero index', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {take} from 'rambda'
@@ -14246,7 +14495,7 @@ It returns the last `howMany` elements of `input`.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 takeLast<T>(howMany: number, input: T[]): T[];
@@ -14322,7 +14571,7 @@ test('with negative index', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {takeLast} from 'rambda'
@@ -14373,7 +14622,7 @@ takeLastWhile(predicate: (x: string) => boolean, input: string): string
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 takeLastWhile(predicate: (x: string) => boolean, input: string): string;
@@ -14452,7 +14701,7 @@ test('with string', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {takeLastWhile} from 'rambda'
@@ -14509,7 +14758,7 @@ One use case is debugging in the middle of `R.compose`.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 tap<T>(fn: (x: T) => void, input: T): T;
@@ -14555,7 +14804,7 @@ test('tap', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {tap, pipe} from 'rambda'
@@ -14589,7 +14838,7 @@ It determines whether `str` matches `regExpression`.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 test(regExpression: RegExp): (str: string) => boolean;
@@ -14638,7 +14887,7 @@ test('throws if first argument is not regex', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {test} from 'rambda'
@@ -14679,7 +14928,7 @@ The range array includes numbers between `0` and `howMany`(exclusive).
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 times<T>(fn: (i: number) => T, howMany: number): T[];
@@ -14745,7 +14994,7 @@ test('curry', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {times, identity} from 'rambda'
@@ -14773,7 +15022,7 @@ toLower<S extends string>(str: S): Lowercase<S>
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 toLower<S extends string>(str: S): Lowercase<S>;
@@ -14823,7 +15072,7 @@ It transforms an object to a list.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 toPairs<O extends object, K extends Extract<keyof O, string | number>>(obj: O): Array<{ [key in K]: [`${key}`, O[key]] }[K]>;
@@ -14871,7 +15120,7 @@ test('happy', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {toPairs} from 'rambda'
@@ -14906,7 +15155,7 @@ toString(x: unknown): string
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 toString(x: unknown): string;
@@ -14953,7 +15202,7 @@ toUpper<S extends string>(str: S): Uppercase<S>
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 toUpper<S extends string>(str: S): Uppercase<S>;
@@ -15001,7 +15250,7 @@ transpose<T>(list: (T[])[]): (T[])[]
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 transpose<T>(list: (T[])[]): (T[])[];
@@ -15077,7 +15326,7 @@ test('array with falsy values', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {transpose} from 'rambda'
@@ -15112,7 +15361,7 @@ trim(str: string): string
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 trim(str: string): string;
@@ -15179,7 +15428,7 @@ It calls a function `fn` with the list of values of the returned function.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 unapply<T = any>(fn: (args: any[]) => T): (...args: any[]) => T;
@@ -15302,7 +15551,7 @@ test('it works with converge', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {join, unapply, sum} from 'rambda'
@@ -15341,7 +15590,7 @@ It takes two lists and return a new list containing a merger of both list with r
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 union<T>(x: T[], y: T[]): T[];
@@ -15395,7 +15644,7 @@ test('with list of objects', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {union} from 'rambda'
@@ -15462,7 +15711,7 @@ It returns a new array containing only one copy of each element of `list`.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 uniq<T>(list: T[]): T[];
@@ -15530,7 +15779,7 @@ test('can distinct between string and number', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {uniq} from 'rambda'
@@ -15572,7 +15821,7 @@ This predicate should return true, if two elements are equal.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 uniqWith<T, U>(predicate: (x: T, y: T) => boolean, list: T[]): T[];
@@ -15657,7 +15906,7 @@ test('with list of strings', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {uniqWith} from 'rambda'
@@ -15695,7 +15944,7 @@ In the other case, the final output will be the `input` itself.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 unless<T, U>(predicate: (x: T) => boolean, whenFalseFn: (x: T) => U, x: T): T | U;
@@ -15747,7 +15996,7 @@ test('curried', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {unless, inc} from 'rambda'
@@ -15835,7 +16084,7 @@ describe('R.unless - curried', () => {
 
 ### unwind
 
-<a title="redirect to Rambda Repl site" href="https://rambda.now.sh?const%20obj%20%3D%20%7B%0A%20%20a%3A%201%2C%0A%20%20b%3A%20%5B2%2C%203%5D%2C%0A%7D%0Aconst%20result%20%3D%20unwind('b'%2C%20Record%3Cstring%2C%20unknown%3E)%0Aconst%20expected%20%3D%20%5B%7Ba%3A1%2C%20b%3A2%7D%2C%20%7Ba%3A1%2C%20b%3A3%7D%5D%0A%2F%2F%20%3D%3E%20%60result%60%20is%20equal%20to%20%60expected%60">Try this <strong>R.unwind</strong> example in Rambda REPL</a>
+<a title="redirect to Rambda Repl site" href="https://rambda.now.sh?const%20obj%20%3D%20%7B%0A%20%20a%3A%201%2C%0A%20%20b%3A%20%5B2%2C%203%5D%2C%0A%7D%0Aconst%20result%20%3D%20R.unwind('b'%2C%20obj)%0Aconst%20expected%20%3D%20%5B%7Ba%3A1%2C%20b%3A2%7D%2C%20%7Ba%3A1%2C%20b%3A3%7D%5D%0A%2F%2F%20%3D%3E%20%60result%60%20is%20equal%20to%20%60expected%60">Try this <strong>R.unwind</strong> example in Rambda REPL</a>
 
 [![---------------](https://raw.githubusercontent.com/selfrefactor/rambda/master/files/separator.png)](#unwind)
 
@@ -15852,7 +16101,7 @@ It returns a copy of `list` with updated element at `index` with `newValue`.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 update<T>(index: number, newValue: T, list: T[]): T[];
@@ -15942,7 +16191,7 @@ test('with negative index', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {update} from 'rambda'
@@ -15972,7 +16221,7 @@ With correct input, this is nothing more than `Object.values(Record<string, unkn
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 values<T extends object, K extends keyof T>(obj: T): T[K][];
@@ -16028,7 +16277,7 @@ test('with bad input', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {values} from 'rambda'
@@ -16062,7 +16311,7 @@ It returns the value of `lens` focus over `target` object.
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 view<T, U>(lens: Lens): (target: T) => U;
@@ -16112,7 +16361,7 @@ test('happy', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {lens, view, assoc} from 'rambda'
@@ -16150,7 +16399,7 @@ when<T, U>(predicate: (x: T) => boolean, whenTrueFn: (a: T) => U, input: T): T |
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 when<T, U>(predicate: (x: T) => boolean, whenTrueFn: (a: T) => U, input: T): T | U;
@@ -16201,7 +16450,7 @@ test('happy', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {when} from 'rambda'
@@ -16246,7 +16495,7 @@ It returns `true` if all each property in `conditions` returns `true` when appli
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 where<T, U>(conditions: T, input: U): boolean;
@@ -16328,7 +16577,7 @@ test('when false | early exit', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {where, equals} from 'rambda'
@@ -16380,7 +16629,7 @@ It will return `true` if all of `input` object fully or partially include `rule`
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 whereEq<T, U>(condition: T, input: U): boolean;
@@ -16466,7 +16715,7 @@ test('with wrong input', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {whereEq} from 'rambda'
@@ -16500,7 +16749,7 @@ It will return a new array, based on all members of `source` list that are not p
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 without<T>(matchAgainst: T[], source: T[]): T[];
@@ -16560,7 +16809,7 @@ test('with list of objects', () => {
 })
 
 test('ramda accepts string as target input while rambda throws', () => {
-  expect(withoutRamda('0:1', [ '0', '0:1' ])).toEqual([])
+  expect(withoutRamda('0:1', [ '0', '0:1' ])).toEqual([ '0:1' ])
   expect(() =>
     without('0:1', [ '0', '0:1' ])).toThrowErrorMatchingInlineSnapshot('"Cannot read property \'indexOf\' of 0:1"')
   expect(without([ '0:1' ], [ '0', '0:1' ])).toEqual([ '0' ])
@@ -16575,7 +16824,7 @@ test('ramda test', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {without} from 'rambda'
@@ -16614,7 +16863,7 @@ Logical XOR
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 xor(x: boolean, y: boolean): boolean;
@@ -16693,7 +16942,7 @@ test('when one argument is truthy and the other is falsy, it should return true'
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {xor} from 'rambda'
@@ -16727,7 +16976,7 @@ The returned list will be truncated to match the length of the shortest supplied
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 zip<K, V>(x: K[], y: V[]): KeyValuePair<K, V>[];
@@ -16803,7 +17052,7 @@ test('should truncate result to length of shorted input list', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {zip} from 'rambda'
@@ -16836,7 +17085,7 @@ It will return a new object with keys of `keys` array and values of `values` arr
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 zipObj<T, K extends string>(keys: K[], values: T[]): { [P in K]: T };
@@ -16915,7 +17164,7 @@ test('ignore extra keys', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {zipObj} from 'rambda'
@@ -16950,7 +17199,7 @@ zipWith<T, U, TResult>(fn: (x: T, y: U) => TResult, list1: T[], list2: U[]): TRe
 
 <details>
 
-<summary>All Typescript definitions</summary>
+<summary>All TypeScript definitions</summary>
 
 ```typescript
 zipWith<T, U, TResult>(fn: (x: T, y: U) => TResult, list1: T[], list2: U[]): TResult[];
@@ -17010,7 +17259,7 @@ test('when second list is longer', () => {
 
 <details>
 
-<summary><strong>Typescript</strong> test</summary>
+<summary><strong>TypeScript</strong> test</summary>
 
 ```typescript
 import {zipWith} from 'rambda'
@@ -17050,6 +17299,24 @@ describe('R.zipWith', () => {
 
 ## ❯ CHANGELOG
 
+8.2.0
+
+Add the following methods:
+
+- addIndex
+- addIndexRight
+- ap
+- aperture
+- applyTo
+- ascend
+- descend
+
+8.1.0
+
+- Fix input order of TS definitions for `R.propEq` method  - [Issue #688](https://github.com/selfrefactor/rambda/issues/688). The issue was due to 8.0.0 was shipped with TS definitions of `7.5.0` release.
+
+- Add `R.differenceWith` method  - [Issue #91](https://github.com/selfrefactor/rambdax/issues/91)
+
 8.0.0
 
 - handle falsy values in merge methods - https://github.com/ramda/ramda/pull/3222
@@ -17064,7 +17331,7 @@ describe('R.zipWith', () => {
 
 - `R.nop` is removed - it will be moved to `Rambdax` as `R.noop`
 
-- `R.includes` is no longer using string literal in Typescript definitions
+- `R.includes` is no longer using string literal in TypeScript definitions
 
 > Reason for breaking change - synchronize with Ramda `0.29.0` release:
 
@@ -17094,7 +17361,7 @@ describe('R.zipWith', () => {
 
 - Add `R.modify`
 
-- Allow multiple inputs in Typescript versions of `R.anyPass` and `R.allPass` - [Issue #642](https://github.com/selfrefactor/rambda/issues/604)
+- Allow multiple inputs in TypeScript versions of `R.anyPass` and `R.allPass` - [Issue #642](https://github.com/selfrefactor/rambda/issues/604)
 
 - Using wrong clone of object in `R.mergeDeepRight` - [Issue #650](https://github.com/selfrefactor/rambda/issues/650)
 
@@ -17104,7 +17371,7 @@ describe('R.zipWith', () => {
 
 7.2.1
 
-- Remove bad typings of `R.propIs` which caused the library to cannot be build with Typescript. 
+- Remove bad typings of `R.propIs` which caused the library to cannot be build with TypeScript. 
 
 - Drop support for `Wallaby` as per [https://github.com/wallabyjs/public/issues/3037](https://github.com/wallabyjs/public/issues/3037)
 
@@ -17138,7 +17405,7 @@ describe('R.zipWith', () => {
 
 - Replace `Async` with `Promise` as return type of `R.type`.
 
-- Add new types as Typescript output for `R.type` - "Map", "WeakMap", "Generator", "GeneratorFunction", "BigInt", "ArrayBuffer"
+- Add new types as TypeScript output for `R.type` - "Map", "WeakMap", "Generator", "GeneratorFunction", "BigInt", "ArrayBuffer"
 
 - Add `R.juxt` method
 
@@ -17166,7 +17433,7 @@ Rambda doesn't work with `pnpm` due to wrong export configuration - [Issue #619]
 
 7.0.0
 
-- Breaking change - sync `R.compose`/`R.pipe` with `@types/ramda`. That is significant change so as safeguard, it will lead a major bump. Important - this lead to raising required Typescript version to `4.2.2`. In other words, to use `Rambda` you'll need Typescript version `4.2.2` or newer.
+- Breaking change - sync `R.compose`/`R.pipe` with `@types/ramda`. That is significant change so as safeguard, it will lead a major bump. Important - this lead to raising required TypeScript version to `4.2.2`. In other words, to use `Rambda` you'll need TypeScript version `4.2.2` or newer.
 
 Related commit in `@types/ramda` - https://github.com/DefinitelyTyped/DefinitelyTyped/commit/286eff4f76d41eb8f091e7437eabd8a60d97fc1f#diff-4f74803fa83a81e47cb17a7d8a4e46a7e451f4d9e5ce2f1bd7a70a72d91f4bc1
 
@@ -17249,7 +17516,7 @@ Fixing `R.uniq` was done by improving `R.indexOf` which has performance implicat
 
 6.8.3
 
-- Fix Typescript build process with `rambda/immutable` - [Issue #572](https://github.com/selfrefactor/rambda/issues/572)
+- Fix TypeScript build process with `rambda/immutable` - [Issue #572](https://github.com/selfrefactor/rambda/issues/572)
 
 - Add `R.objOf` method
 
@@ -17269,7 +17536,7 @@ Fixing `R.uniq` was done by improving `R.indexOf` which has performance implicat
 
 6.7.0
 
-- Remove `ts-toolbelt` types from Typescript definitions. Most affected are the following methods, which lose one of its curried definitions:
+- Remove `ts-toolbelt` types from TypeScript definitions. Most affected are the following methods, which lose one of its curried definitions:
 
 1. R.maxBy
 2. R.minBy
@@ -17393,7 +17660,7 @@ Fix wrong versions in changelog
             </td>
             <td width="20%" align="center">
                 <h4>Useful Javascript libraries</h4>
-                <a href="https://github.com/selfrefactor/useful-javascript-libraries">Large collection of JavaScript,Typescript and Angular related repos links</a>
+                <a href="https://github.com/selfrefactor/useful-javascript-libraries">Large collection of JavaScript,TypeScript and Angular related repos links</a>
             </td>
             <td width="20%" align="center">
                 <h4>Run-fn</h4>