prepare

selfrefactor · Mar 31, 2024 · 7fb3959 · 7fb3959
1 parent e075a00
commit 7fb3959
Show file tree

Hide file tree

Showing 11 changed files with 116 additions and 20 deletions.
diff --git a/.github/README.md b/.github/README.md
@@ -10214,7 +10214,7 @@ This method is also known as P combinator.
 
 ```typescript
 
-once<T extends AnyFunction>(func: T): T
+once<T extends AnyFunction, C = unknown>(fn: T, context?: C): T
 ```
 
 It returns a function, which invokes only once `fn` function.
@@ -10235,7 +10235,7 @@ addOnce(1)
 <summary>All TypeScript definitions</summary>
 
 ```typescript
-once<T extends AnyFunction>(func: T): T;
+once<T extends AnyFunction, C = unknown>(fn: T, context?: C): T;
 ```
 
 </details>
@@ -10304,6 +10304,17 @@ test('happy path', () => {
   )).toBe(60)
   expect(addOneOnce(40)).toBe(60)
 })
+
+test('with context', () => {
+  const context = { name: 'fris' }
+  const getNameOnce = once(function (){
+    return this.name
+  }, context)
+
+  expect(getNameOnce()).toBe('fris')
+  expect(getNameOnce()).toBe('fris')
+  expect(getNameOnce()).toBe('fris')
+})
 ```
 
 </details>
@@ -10324,6 +10335,14 @@ describe('R.once', () => {
     const result = runOnce(1)
     result // $ExpectType number
   })
+  it('with context', () => {
+    const runOnce = once(function (this: any, x: number) {
+      return x + 2
+    })
+
+    const result = runOnce.call({}, 1)
+    result // $ExpectType number
+  })
 })
 ```
 
@@ -17071,7 +17090,7 @@ export function unless(predicate, whenFalse){
   if (arguments.length === 1){
     return _whenFalse => unless(predicate, _whenFalse)
   }
-
+  
   return input => predicate(input) ? input : whenFalse(input)
 }
 ```
@@ -18502,9 +18521,14 @@ describe('R.zipWith', () => {
 
 ## ❯ CHANGELOG
 
-9.1.1
+9.2.0
+
+- `R.once` TS type definition miss to context argument and its type - [Issue #728](https://github.com/selfrefactor/rambda/issues/728)
 
 - Faster R.equals with Object.is short circuit - https://github.com/selfrefactor/rambda/pull/725
+
+9.1.1
+
 - Fix R.cond transform is unary - https://github.com/selfrefactor/rambda/issues/720
 
 9.1.0

diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,6 +1,11 @@
-9.1.1
+9.2.0
+
+- `R.once` TS type definition miss to context argument and its type - [Issue #728](https://github.com/selfrefactor/rambda/issues/728)
 
 - Faster R.equals with Object.is short circuit - https://github.com/selfrefactor/rambda/pull/725
+
+9.1.1
+
 - Fix R.cond transform is unary - https://github.com/selfrefactor/rambda/issues/720
 
 9.1.0

diff --git a/README.md b/README.md
@@ -9607,7 +9607,7 @@ This method is also known as P combinator.
 
 ```typescript
 
-once<T extends AnyFunction>(func: T): T
+once<T extends AnyFunction, C = unknown>(fn: T, context?: C): T
 ```
 
 It returns a function, which invokes only once `fn` function.
@@ -9619,7 +9619,7 @@ It returns a function, which invokes only once `fn` function.
 <summary>All TypeScript definitions</summary>
 
 ```typescript
-once<T extends AnyFunction>(func: T): T;
+once<T extends AnyFunction, C = unknown>(fn: T, context?: C): T;
 ```
 
 </details>
@@ -9688,6 +9688,17 @@ test('happy path', () => {
   )).toBe(60)
   expect(addOneOnce(40)).toBe(60)
 })
+
+test('with context', () => {
+  const context = { name: 'fris' }
+  const getNameOnce = once(function (){
+    return this.name
+  }, context)
+
+  expect(getNameOnce()).toBe('fris')
+  expect(getNameOnce()).toBe('fris')
+  expect(getNameOnce()).toBe('fris')
+})
 ```
 
 </details>
@@ -9708,6 +9719,14 @@ describe('R.once', () => {
     const result = runOnce(1)
     result // $ExpectType number
   })
+  it('with context', () => {
+    const runOnce = once(function (this: any, x: number) {
+      return x + 2
+    })
+
+    const result = runOnce.call({}, 1)
+    result // $ExpectType number
+  })
 })
 ```
 
@@ -15880,7 +15899,7 @@ export function unless(predicate, whenFalse){
   if (arguments.length === 1){
     return _whenFalse => unless(predicate, _whenFalse)
   }
-
+  
   return input => predicate(input) ? input : whenFalse(input)
 }
 ```
@@ -17192,9 +17211,14 @@ describe('R.zipWith', () => {
 
 ## ❯ CHANGELOG
 
-9.1.1
+9.2.0
+
+- `R.once` TS type definition miss to context argument and its type - [Issue #728](https://github.com/selfrefactor/rambda/issues/728)
 
 - Faster R.equals with Object.is short circuit - https://github.com/selfrefactor/rambda/pull/725
+
+9.1.1
+
 - Fix R.cond transform is unary - https://github.com/selfrefactor/rambda/issues/720
 
 9.1.0

diff --git a/docs/README.md b/docs/README.md
@@ -9607,7 +9607,7 @@ This method is also known as P combinator.
 
 ```typescript
 
-once<T extends AnyFunction>(func: T): T
+once<T extends AnyFunction, C = unknown>(fn: T, context?: C): T
 ```
 
 It returns a function, which invokes only once `fn` function.
@@ -9619,7 +9619,7 @@ It returns a function, which invokes only once `fn` function.
 <summary>All TypeScript definitions</summary>
 
 ```typescript
-once<T extends AnyFunction>(func: T): T;
+once<T extends AnyFunction, C = unknown>(fn: T, context?: C): T;
 ```
 
 </details>
@@ -9688,6 +9688,17 @@ test('happy path', () => {
   )).toBe(60)
   expect(addOneOnce(40)).toBe(60)
 })
+
+test('with context', () => {
+  const context = { name: 'fris' }
+  const getNameOnce = once(function (){
+    return this.name
+  }, context)
+
+  expect(getNameOnce()).toBe('fris')
+  expect(getNameOnce()).toBe('fris')
+  expect(getNameOnce()).toBe('fris')
+})
 ```
 
 </details>
@@ -9708,6 +9719,14 @@ describe('R.once', () => {
     const result = runOnce(1)
     result // $ExpectType number
   })
+  it('with context', () => {
+    const runOnce = once(function (this: any, x: number) {
+      return x + 2
+    })
+
+    const result = runOnce.call({}, 1)
+    result // $ExpectType number
+  })
 })
 ```
 
@@ -15880,7 +15899,7 @@ export function unless(predicate, whenFalse){
   if (arguments.length === 1){
     return _whenFalse => unless(predicate, _whenFalse)
   }
-
+  
   return input => predicate(input) ? input : whenFalse(input)
 }
 ```
@@ -17192,9 +17211,14 @@ describe('R.zipWith', () => {
 
 ## ❯ CHANGELOG
 
-9.1.1
+9.2.0
+
+- `R.once` TS type definition miss to context argument and its type - [Issue #728](https://github.com/selfrefactor/rambda/issues/728)
 
 - Faster R.equals with Object.is short circuit - https://github.com/selfrefactor/rambda/pull/725
+
+9.1.1
+
 - Fix R.cond transform is unary - https://github.com/selfrefactor/rambda/issues/720
 
 9.1.0

diff --git a/files/index.d.ts b/files/index.d.ts
@@ -2754,7 +2754,7 @@ Notes:
 
 */
 // @SINGLE_MARKER
-export function once<T extends AnyFunction>(func: T): T;
+export function once<T extends AnyFunction, C = unknown>(fn: T, context?: C): T;
 
 /*
 Method: omit

diff --git a/immutable.d.ts b/immutable.d.ts
@@ -1167,7 +1167,7 @@ export function on<T, U, R>(binaryFn: (a: U, b: U) => R, unaryFn: (value: T) =>
 /**
  * It returns a function, which invokes only once `fn` function.
  */
-export function once<T extends AnyFunction>(func: T): T;
+export function once<T extends AnyFunction, C = unknown>(fn: T, context?: C): T;
 
 /**
  * Logical OR

diff --git a/index.d.ts b/index.d.ts
@@ -1167,7 +1167,7 @@ export function on<T, U, R>(binaryFn: (a: U, b: U) => R, unaryFn: (value: T) =>
 /**
  * It returns a function, which invokes only once `fn` function.
  */
-export function once<T extends AnyFunction>(func: T): T;
+export function once<T extends AnyFunction, C = unknown>(fn: T, context?: C): T;
 
 /**
  * Logical OR

diff --git a/source/once-spec.ts b/source/once-spec.ts
@@ -9,4 +9,12 @@ describe('R.once', () => {
     const result = runOnce(1)
     result // $ExpectType number
   })
+  it('with context', () => {
+    const runOnce = once(function (this: any, x: number) {
+      return x + 2
+    })
+
+    const result = runOnce.call({}, 1)
+    result // $ExpectType number
+  })
 })
diff --git a/source/once.spec.js b/source/once.spec.js
@@ -24,3 +24,14 @@ test('happy path', () => {
   )).toBe(60)
   expect(addOneOnce(40)).toBe(60)
 })
+
+test('with context', () => {
+  const context = { name: 'fris' }
+  const getNameOnce = once(function (){
+    return this.name
+  }, context)
+
+  expect(getNameOnce()).toBe('fris')
+  expect(getNameOnce()).toBe('fris')
+  expect(getNameOnce()).toBe('fris')
+})
diff --git a/source/unless.js b/source/unless.js
@@ -2,6 +2,6 @@ export function unless(predicate, whenFalse){
   if (arguments.length === 1){
     return _whenFalse => unless(predicate, _whenFalse)
   }
-
+  
   return input => predicate(input) ? input : whenFalse(input)
-}
+}
diff --git a/src/unless.js b/src/unless.js
@@ -2,6 +2,6 @@ export function unless(predicate, whenFalse){
   if (arguments.length === 1){
     return _whenFalse => unless(predicate, _whenFalse)
   }
-
+  
   return input => predicate(input) ? input : whenFalse(input)
-}
+}