version 2.3.4

CHANGELOG.md

@@ -13,6 +13,11 @@
 **Note**: Gaps between patch versions are faulty/broken releases. **Note**: A feature tagged as Experimental is in a
 high state of flux, you're at risk of it changing without notice.
 
+# 2.3.4
+
+- **Experimental**
+  - `Lens`, `Prism`, `Optional`: add `Refinement` overload to `findFirst`, #148 (@wmaurer)
+
 # 2.3.3
 
 - **Experimental**

docs/modules/Lens.ts.md

@@ -121,7 +121,10 @@ Added in v2.3.0
 **Signature**
 
 ```ts
-export declare const findFirst: <A>(predicate: Predicate<A>) => <S>(sa: Lens<S, readonly A[]>) => Optional<S, A>
+export declare function findFirst<A, B extends A>(
+  refinement: Refinement<A, B>
+): <S>(sa: Lens<S, ReadonlyArray<A>>) => Optional<S, B>
+export declare function findFirst<A>(predicate: Predicate<A>): <S>(sa: Lens<S, ReadonlyArray<A>>) => Optional<S, A>
 ```
 
 Added in v2.3.2

docs/modules/Optional.ts.md

@@ -122,7 +122,10 @@ Added in v2.3.0
 **Signature**
 
 ```ts
-export declare const findFirst: <A>(predicate: Predicate<A>) => <S>(sa: Optional<S, readonly A[]>) => Optional<S, A>
+export declare function findFirst<A, B extends A>(
+  refinement: Refinement<A, B>
+): <S>(sa: Optional<S, ReadonlyArray<A>>) => Optional<S, B>
+export declare function findFirst<A>(predicate: Predicate<A>): <S>(sa: Optional<S, ReadonlyArray<A>>) => Optional<S, A>
 ```
 
 Added in v2.3.2

docs/modules/Prism.ts.md

@@ -122,7 +122,10 @@ Added in v2.3.0
 **Signature**
 
 ```ts
-export declare const findFirst: <A>(predicate: Predicate<A>) => <S>(sa: Prism<S, readonly A[]>) => Optional<S, A>
+export declare function findFirst<A, B extends A>(
+  refinement: Refinement<A, B>
+): <S>(sa: Prism<S, ReadonlyArray<A>>) => Optional<S, B>
+export declare function findFirst<A>(predicate: Predicate<A>): <S>(sa: Prism<S, ReadonlyArray<A>>) => Optional<S, A>
 ```
 
 Added in v2.3.2

package.json

@@ -1,6 +1,6 @@
 {
   "name": "monocle-ts",
-  "version": "2.3.3",
+  "version": "2.3.4",
   "description": "A porting of scala monocle library to TypeScript",
   "files": [
     "lib",
@@ -54,7 +54,7 @@
     "ts-node": "^8.0.2",
     "tslint": "^5.12.1",
     "tslint-config-standard": "^8.0.1",
-    "typescript": "^3.9.5"
+    "typescript": "^4.1.3"
   },
   "tags": [
     "typescript",

src/Lens.ts

@@ -240,7 +240,7 @@ export function findFirst<A, B extends A>(
 ): <S>(sa: Lens<S, ReadonlyArray<A>>) => Optional<S, B>
 export function findFirst<A>(predicate: Predicate<A>): <S>(sa: Lens<S, ReadonlyArray<A>>) => Optional<S, A>
 export function findFirst<A>(predicate: Predicate<A>): <S>(sa: Lens<S, ReadonlyArray<A>>) => Optional<S, A> {
-  return flow(_.findFirst, composeOptional)(predicate)
+  return composeOptional(_.findFirst(predicate))
 }
 
 // -------------------------------------------------------------------------------------

src/Optional.ts

@@ -227,7 +227,7 @@ export function findFirst<A, B extends A>(
 ): <S>(sa: Optional<S, ReadonlyArray<A>>) => Optional<S, B>
 export function findFirst<A>(predicate: Predicate<A>): <S>(sa: Optional<S, ReadonlyArray<A>>) => Optional<S, A>
 export function findFirst<A>(predicate: Predicate<A>): <S>(sa: Optional<S, ReadonlyArray<A>>) => Optional<S, A> {
-  return flow(_.findFirst, compose)(predicate)
+  return compose(_.findFirst(predicate))
 }
 
 // -------------------------------------------------------------------------------------

src/Prism.ts

@@ -263,7 +263,7 @@ export function findFirst<A, B extends A>(
 ): <S>(sa: Prism<S, ReadonlyArray<A>>) => Optional<S, B>
 export function findFirst<A>(predicate: Predicate<A>): <S>(sa: Prism<S, ReadonlyArray<A>>) => Optional<S, A>
 export function findFirst<A>(predicate: Predicate<A>): <S>(sa: Prism<S, ReadonlyArray<A>>) => Optional<S, A> {
-  return flow(_.findFirst, composeOptional)(predicate)
+  return composeOptional(_.findFirst(predicate))
 }
 
 // -------------------------------------------------------------------------------------