fix: add IOK to IORef

Signed-off-by: Dr. Carsten Leue <carsten.leue@de.ibm.com>

.github/workflows/build.yml

@@ -28,11 +28,11 @@ jobs:
       fail-fast: false  # Continue with other versions if one fails
     steps:
       # full checkout for semantic-release
-      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4.3.1
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
         with:
           fetch-depth: 0
       - name: Set up Go ${{ matrix.go-version }}
-        uses: actions/setup-go@v5
+        uses: actions/setup-go@v6
         with:
           go-version: ${{ matrix.go-version }}
           cache: true  # Enable Go module caching
@@ -66,11 +66,11 @@ jobs:
       matrix:
         go-version: ['1.24.x', '1.25.x']
     steps:
-      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4.3.1
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
         with:
           fetch-depth: 0
       - name: Set up Go ${{ matrix.go-version }}
-        uses: actions/setup-go@v5
+        uses: actions/setup-go@v6
         with:
           go-version: ${{ matrix.go-version }}
           cache: true  # Enable Go module caching
@@ -126,17 +126,17 @@ jobs:
     steps:
       # full checkout for semantic-release
       - name: Full checkout
-        uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4.3.1
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
         with:
           fetch-depth: 0
 
       - name: Set up Node.js ${{ env.NODE_VERSION }}
-        uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
+        uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6.2.0
         with:
           node-version: ${{ env.NODE_VERSION }}
 
       - name: Set up Go
-        uses: actions/setup-go@v5
+        uses: actions/setup-go@v6
         with:
           go-version: ${{ env.LATEST_GO_VERSION }}
           cache: true  # Enable Go module caching

go.sum

@@ -1,7 +1,3 @@
-github.com/cpuguy83/go-md2man/v2 v2.0.4 h1:wfIWP927BUkWJb2NmU/kNDYIBTh/ziUX91+lVfRxZq4=
-github.com/cpuguy83/go-md2man/v2 v2.0.4/go.mod h1:tgQtvFlXSQOSOSIRvRPT7W67SCa46tRHOmNcaadrF8o=
-github.com/cpuguy83/go-md2man/v2 v2.0.5 h1:ZtcqGrnekaHpVLArFSe4HK5DoKx1T0rq2DwVB0alcyc=
-github.com/cpuguy83/go-md2man/v2 v2.0.5/go.mod h1:tgQtvFlXSQOSOSIRvRPT7W67SCa46tRHOmNcaadrF8o=
 github.com/cpuguy83/go-md2man/v2 v2.0.7 h1:zbFlGlXEAKlwXpmvle3d8Oe3YnkKIK4xSRTd3sHPnBo=
 github.com/cpuguy83/go-md2man/v2 v2.0.7/go.mod h1:oOW0eioCTA6cOiMLiUPZOpcVxMig6NIQQ7OS05n1F4g=
 github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
@@ -10,20 +6,8 @@ github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZb
 github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
 github.com/russross/blackfriday/v2 v2.1.0 h1:JIOH55/0cWyOuilr9/qlrm0BSXldqnqwMsf35Ld67mk=
 github.com/russross/blackfriday/v2 v2.1.0/go.mod h1:+Rmxgy9KzJVeS9/2gXHxylqXiyQDYRxCVz55jmeOWTM=
-github.com/stretchr/testify v1.9.0 h1:HtqpIVDClZ4nwg75+f6Lvsy/wHu+3BoSGCbBAcpTsTg=
-github.com/stretchr/testify v1.9.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY=
-github.com/stretchr/testify v1.10.0 h1:Xv5erBjTwe/5IxqUQTdXv5kgmIvbHo3QQyRwhJsOfJA=
-github.com/stretchr/testify v1.10.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY=
-github.com/stretchr/testify v1.11.0 h1:ib4sjIrwZKxE5u/Japgo/7SJV3PvgjGiRNAvTVGqQl8=
-github.com/stretchr/testify v1.11.0/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD981Nm4B6U=
 github.com/stretchr/testify v1.11.1 h1:7s2iGBzp5EwR7/aIZr8ao5+dra3wiQyKjjFuvgVKu7U=
 github.com/stretchr/testify v1.11.1/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD981Nm4B6U=
-github.com/urfave/cli/v2 v2.27.4 h1:o1owoI+02Eb+K107p27wEX9Bb8eqIoZCfLXloLUSWJ8=
-github.com/urfave/cli/v2 v2.27.4/go.mod h1:m4QzxcD2qpra4z7WhzEGn74WZLViBnMpb1ToCAKdGRQ=
-github.com/urfave/cli/v2 v2.27.5 h1:WoHEJLdsXr6dDWoJgMq/CboDmyY/8HMMH1fTECbih+w=
-github.com/urfave/cli/v2 v2.27.5/go.mod h1:3Sevf16NykTbInEnD0yKkjDAeZDS0A6bzhBH5hrMvTQ=
-github.com/urfave/cli/v2 v2.27.6 h1:VdRdS98FNhKZ8/Az8B7MTyGQmpIr36O1EHybx/LaZ4g=
-github.com/urfave/cli/v2 v2.27.6/go.mod h1:3Sevf16NykTbInEnD0yKkjDAeZDS0A6bzhBH5hrMvTQ=
 github.com/urfave/cli/v2 v2.27.7 h1:bH59vdhbjLv3LAvIu6gd0usJHgoTTPhCFib8qqOwXYU=
 github.com/urfave/cli/v2 v2.27.7/go.mod h1:CyNAG/xg+iAOg0N4MPGZqVmv2rCoP267496AOXUZjA4=
 github.com/xrash/smetrics v0.0.0-20240521201337-686a1a2994c1 h1:gEOO8jv9F4OT7lGCjxCBTO/36wtF6j2nSip77qHd4x4=

renovate.json

@@ -22,7 +22,8 @@
             "matchDepTypes": [
                 "golang"
             ],
-            "enabled": false
+            "enabled": false,
+            "description": "Disable updates to the go directive in go.mod files - the directive identifies the minimum compatible Go version and should stay as small as possible for maximum compatibility"
         },
         {
             "matchUpdateTypes": [

v2/README.md

@@ -465,7 +465,7 @@ func process() IOResult[string] {
 - **ReaderIOResult** - Combine Reader, IO, and Result for complex workflows
 - **Array** - Functional array operations
 - **Record** - Functional record/map operations
-- **Optics** - Lens, Prism, Optional, and Traversal for immutable updates
+- **[Optics](./optics/README.md)** - Lens, Prism, Optional, and Traversal for immutable updates
 
 #### Idiomatic Packages (Tuple-based, High Performance)
 - **idiomatic/option** - Option monad using native Go `(value, bool)` tuples

v2/array/array.go

@@ -190,6 +190,11 @@ func MonadReduce[A, B any](fa []A, f func(B, A) B, initial B) B {
 	return G.MonadReduce(fa, f, initial)
 }
 
+//go:inline
+func MonadReduceWithIndex[A, B any](fa []A, f func(int, B, A) B, initial B) B {
+	return G.MonadReduceWithIndex(fa, f, initial)
+}
+
 // Reduce folds an array from left to right, applying a function to accumulate a result.
 //
 // Example:
@@ -234,6 +239,16 @@ func ReduceRef[A, B any](f func(B, *A) B, initial B) func([]A) B {
 }
 
 // Append adds an element to the end of an array, returning a new array.
+// This is a non-curried version that takes both the array and element as parameters.
+//
+// Example:
+//
+//	arr := []int{1, 2, 3}
+//	result := array.Append(arr, 4)
+//	// result: []int{1, 2, 3, 4}
+//	// arr: []int{1, 2, 3} (unchanged)
+//
+// For a curried version, see Push.
 //
 //go:inline
 func Append[A any](as []A, a A) []A {

v2/array/array_extended_test.go

@@ -16,308 +16,88 @@
 package array
 
 import (
-	"fmt"
 	"testing"
 
-	N "github.com/IBM/fp-go/v2/number"
-	O "github.com/IBM/fp-go/v2/option"
-	S "github.com/IBM/fp-go/v2/string"
 	"github.com/stretchr/testify/assert"
 )
 
-func TestReplicate(t *testing.T) {
-	result := Replicate(3, "a")
-	assert.Equal(t, []string{"a", "a", "a"}, result)
-
-	empty := Replicate(0, 42)
-	assert.Equal(t, []int{}, empty)
-}
-
-func TestMonadMap(t *testing.T) {
-	src := []int{1, 2, 3}
-	result := MonadMap(src, N.Mul(2))
-	assert.Equal(t, []int{2, 4, 6}, result)
-}
-
-func TestMonadMapRef(t *testing.T) {
-	src := []int{1, 2, 3}
-	result := MonadMapRef(src, func(x *int) int { return *x * 2 })
-	assert.Equal(t, []int{2, 4, 6}, result)
-}
-
-func TestMapWithIndex(t *testing.T) {
-	src := []string{"a", "b", "c"}
-	mapper := MapWithIndex(func(i int, s string) string {
-		return fmt.Sprintf("%d:%s", i, s)
-	})
-	result := mapper(src)
-	assert.Equal(t, []string{"0:a", "1:b", "2:c"}, result)
-}
-
-func TestMapRef(t *testing.T) {
-	src := []int{1, 2, 3}
-	mapper := MapRef(func(x *int) int { return *x * 2 })
-	result := mapper(src)
-	assert.Equal(t, []int{2, 4, 6}, result)
-}
-
-func TestFilterWithIndex(t *testing.T) {
-	src := []int{1, 2, 3, 4, 5}
-	filter := FilterWithIndex(func(i, x int) bool {
-		return i%2 == 0 && x > 2
-	})
-	result := filter(src)
-	assert.Equal(t, []int{3, 5}, result)
-}
-
-func TestFilterRef(t *testing.T) {
-	src := []int{1, 2, 3, 4, 5}
-	filter := FilterRef(func(x *int) bool { return *x > 2 })
-	result := filter(src)
-	assert.Equal(t, []int{3, 4, 5}, result)
-}
-
-func TestMonadFilterMap(t *testing.T) {
-	src := []int{1, 2, 3, 4}
-	result := MonadFilterMap(src, func(x int) O.Option[string] {
-		if x%2 == 0 {
-			return O.Some(fmt.Sprintf("even:%d", x))
-		}
-		return O.None[string]()
-	})
-	assert.Equal(t, []string{"even:2", "even:4"}, result)
-}
-
-func TestMonadFilterMapWithIndex(t *testing.T) {
-	src := []int{1, 2, 3, 4}
-	result := MonadFilterMapWithIndex(src, func(i, x int) O.Option[string] {
-		if i%2 == 0 {
-			return O.Some(fmt.Sprintf("%d:%d", i, x))
-		}
-		return O.None[string]()
-	})
-	assert.Equal(t, []string{"0:1", "2:3"}, result)
-}
-
-func TestFilterMapWithIndex(t *testing.T) {
-	src := []int{1, 2, 3, 4}
-	filter := FilterMapWithIndex(func(i, x int) O.Option[string] {
-		if i%2 == 0 {
-			return O.Some(fmt.Sprintf("%d:%d", i, x))
-		}
-		return O.None[string]()
-	})
-	result := filter(src)
-	assert.Equal(t, []string{"0:1", "2:3"}, result)
-}
-
-func TestFilterMapRef(t *testing.T) {
-	src := []int{1, 2, 3, 4, 5}
-	filter := FilterMapRef(
-		func(x *int) bool { return *x > 2 },
-		func(x *int) string { return fmt.Sprintf("val:%d", *x) },
-	)
-	result := filter(src)
-	assert.Equal(t, []string{"val:3", "val:4", "val:5"}, result)
-}
-
-func TestReduceWithIndex(t *testing.T) {
-	src := []int{1, 2, 3}
-	reducer := ReduceWithIndex(func(i, acc, x int) int {
-		return acc + i + x
+// TestMonadReduceWithIndex tests the MonadReduceWithIndex function
+func TestMonadReduceWithIndex(t *testing.T) {
+	// Test with integers - sum with index multiplication
+	numbers := []int{1, 2, 3, 4, 5}
+	result := MonadReduceWithIndex(numbers, func(idx, acc, val int) int {
+		return acc + (val * idx)
 	}, 0)
-	result := reducer(src)
-	assert.Equal(t, 9, result) // 0 + (0+1) + (1+2) + (2+3) = 9
-}
+	// Expected: 0*1 + 1*2 + 2*3 + 3*4 + 4*5 = 0 + 2 + 6 + 12 + 20 = 40
+	assert.Equal(t, 40, result)
 
-func TestReduceRightWithIndex(t *testing.T) {
-	src := []string{"a", "b", "c"}
-	reducer := ReduceRightWithIndex(func(i int, x, acc string) string {
-		return fmt.Sprintf("%s%d:%s", acc, i, x)
+	// Test with empty array
+	empty := []int{}
+	result2 := MonadReduceWithIndex(empty, func(idx, acc, val int) int {
+		return acc + val
+	}, 10)
+	assert.Equal(t, 10, result2)
+
+	// Test with strings - concatenate with index
+	words := []string{"a", "b", "c"}
+	result3 := MonadReduceWithIndex(words, func(idx int, acc, val string) string {
+		return acc + val + string(rune('0'+idx))
 	}, "")
-	result := reducer(src)
-	assert.Equal(t, "2:c1:b0:a", result)
+	assert.Equal(t, "a0b1c2", result3)
 }
 
-func TestReduceRef(t *testing.T) {
-	src := []int{1, 2, 3}
-	reducer := ReduceRef(func(acc int, x *int) int {
-		return acc + *x
-	}, 0)
-	result := reducer(src)
-	assert.Equal(t, 6, result)
-}
-
-func TestZero(t *testing.T) {
-	result := Zero[int]()
-	assert.Equal(t, []int{}, result)
-	assert.True(t, IsEmpty(result))
-}
-
-func TestMonadChain(t *testing.T) {
-	src := []int{1, 2, 3}
-	result := MonadChain(src, func(x int) []int {
-		return []int{x, x * 10}
-	})
-	assert.Equal(t, []int{1, 10, 2, 20, 3, 30}, result)
-}
-
-func TestChain(t *testing.T) {
-	src := []int{1, 2, 3}
-	chain := Chain(func(x int) []int {
-		return []int{x, x * 10}
-	})
-	result := chain(src)
-	assert.Equal(t, []int{1, 10, 2, 20, 3, 30}, result)
-}
-
-func TestMonadAp(t *testing.T) {
-	fns := []func(int) int{
-		N.Mul(2),
-		N.Add(10),
-	}
-	values := []int{1, 2}
-	result := MonadAp(fns, values)
-	assert.Equal(t, []int{2, 4, 11, 12}, result)
-}
-
-func TestMatchLeft(t *testing.T) {
-	matcher := MatchLeft(
-		func() string { return "empty" },
-		func(head int, tail []int) string {
-			return fmt.Sprintf("head:%d,tail:%v", head, tail)
-		},
-	)
-
-	assert.Equal(t, "empty", matcher([]int{}))
-	assert.Equal(t, "head:1,tail:[2 3]", matcher([]int{1, 2, 3}))
-}
-
-func TestTail(t *testing.T) {
-	assert.Equal(t, O.None[[]int](), Tail([]int{}))
-	assert.Equal(t, O.Some([]int{2, 3}), Tail([]int{1, 2, 3}))
-	assert.Equal(t, O.Some([]int{}), Tail([]int{1}))
-}
-
-func TestFirst(t *testing.T) {
-	assert.Equal(t, O.None[int](), First([]int{}))
-	assert.Equal(t, O.Some(1), First([]int{1, 2, 3}))
-}
-
-func TestLast(t *testing.T) {
-	assert.Equal(t, O.None[int](), Last([]int{}))
-	assert.Equal(t, O.Some(3), Last([]int{1, 2, 3}))
-	assert.Equal(t, O.Some(1), Last([]int{1}))
-}
-
-func TestUpsertAt(t *testing.T) {
-	src := []int{1, 2, 3}
-	upsert := UpsertAt(99)
-
-	result1 := upsert(src)
-	assert.Equal(t, []int{1, 2, 3, 99}, result1)
-}
-
-func TestSize(t *testing.T) {
-	assert.Equal(t, 0, Size([]int{}))
-	assert.Equal(t, 3, Size([]int{1, 2, 3}))
-}
-
-func TestMonadPartition(t *testing.T) {
-	src := []int{1, 2, 3, 4, 5}
-	result := MonadPartition(src, func(x int) bool { return x > 2 })
-	assert.Equal(t, []int{1, 2}, result.F1)
-	assert.Equal(t, []int{3, 4, 5}, result.F2)
-}
-
-func TestIsNil(t *testing.T) {
-	var nilSlice []int
-	assert.True(t, IsNil(nilSlice))
-	assert.False(t, IsNil([]int{}))
-	assert.False(t, IsNil([]int{1}))
-}
-
-func TestIsNonNil(t *testing.T) {
-	var nilSlice []int
-	assert.False(t, IsNonNil(nilSlice))
-	assert.True(t, IsNonNil([]int{}))
-	assert.True(t, IsNonNil([]int{1}))
-}
-
-func TestConstNil(t *testing.T) {
-	result := ConstNil[int]()
-	assert.True(t, IsNil(result))
-}
-
-func TestSliceRight(t *testing.T) {
-	src := []int{1, 2, 3, 4, 5}
-	slicer := SliceRight[int](2)
-	result := slicer(src)
-	assert.Equal(t, []int{3, 4, 5}, result)
-}
-
-func TestCopy(t *testing.T) {
-	src := []int{1, 2, 3}
-	copied := Copy(src)
-	assert.Equal(t, src, copied)
-	// Verify it's a different slice
-	copied[0] = 99
-	assert.Equal(t, 1, src[0])
-	assert.Equal(t, 99, copied[0])
-}
-
-func TestClone(t *testing.T) {
-	src := []int{1, 2, 3}
-	cloner := Clone(N.Mul(2))
-	result := cloner(src)
-	assert.Equal(t, []int{2, 4, 6}, result)
-}
-
-func TestFoldMapWithIndex(t *testing.T) {
-	src := []string{"a", "b", "c"}
-	folder := FoldMapWithIndex[string](S.Monoid)(func(i int, s string) string {
-		return fmt.Sprintf("%d:%s", i, s)
-	})
-	result := folder(src)
-	assert.Equal(t, "0:a1:b2:c", result)
-}
-
-func TestFold(t *testing.T) {
-	src := []int{1, 2, 3, 4, 5}
-	folder := Fold(N.MonoidSum[int]())
-	result := folder(src)
-	assert.Equal(t, 15, result)
-}
-
-func TestPush(t *testing.T) {
-	src := []int{1, 2, 3}
-	pusher := Push(4)
-	result := pusher(src)
+// TestAppend tests the Append function
+func TestAppend(t *testing.T) {
+	// Test appending to non-empty array
+	arr := []int{1, 2, 3}
+	result := Append(arr, 4)
 	assert.Equal(t, []int{1, 2, 3, 4}, result)
+	// Verify original array is unchanged
+	assert.Equal(t, []int{1, 2, 3}, arr)
+
+	// Test appending to empty array
+	empty := []int{}
+	result2 := Append(empty, 1)
+	assert.Equal(t, []int{1}, result2)
+
+	// Test appending strings
+	words := []string{"hello", "world"}
+	result3 := Append(words, "!")
+	assert.Equal(t, []string{"hello", "world", "!"}, result3)
+
+	// Test appending to nil array
+	var nilArr []int
+	result4 := Append(nilArr, 42)
+	assert.Equal(t, []int{42}, result4)
 }
 
-func TestMonadFlap(t *testing.T) {
-	fns := []func(int) string{
-		func(x int) string { return fmt.Sprintf("a%d", x) },
-		func(x int) string { return fmt.Sprintf("b%d", x) },
-	}
-	result := MonadFlap(fns, 5)
-	assert.Equal(t, []string{"a5", "b5"}, result)
-}
+// TestStrictEquals tests the StrictEquals function
+func TestStrictEquals(t *testing.T) {
+	eq := StrictEquals[int]()
 
-func TestFlap(t *testing.T) {
-	fns := []func(int) string{
-		func(x int) string { return fmt.Sprintf("a%d", x) },
-		func(x int) string { return fmt.Sprintf("b%d", x) },
-	}
-	flapper := Flap[string](5)
-	result := flapper(fns)
-	assert.Equal(t, []string{"a5", "b5"}, result)
-}
+	// Test equal arrays
+	arr1 := []int{1, 2, 3}
+	arr2 := []int{1, 2, 3}
+	assert.True(t, eq.Equals(arr1, arr2))
 
-func TestPrepend(t *testing.T) {
-	src := []int{2, 3, 4}
-	prepender := Prepend(1)
-	result := prepender(src)
-	assert.Equal(t, []int{1, 2, 3, 4}, result)
+	// Test different arrays
+	arr3 := []int{1, 2, 4}
+	assert.False(t, eq.Equals(arr1, arr3))
+
+	// Test different lengths
+	arr4 := []int{1, 2}
+	assert.False(t, eq.Equals(arr1, arr4))
+
+	// Test empty arrays
+	empty1 := []int{}
+	empty2 := []int{}
+	assert.True(t, eq.Equals(empty1, empty2))
+
+	// Test with strings
+	strEq := StrictEquals[string]()
+	words1 := []string{"hello", "world"}
+	words2 := []string{"hello", "world"}
+	words3 := []string{"hello", "there"}
+	assert.True(t, strEq.Equals(words1, words2))
+	assert.False(t, strEq.Equals(words1, words3))
 }

v2/array/bind.go

@@ -63,17 +63,26 @@ func Bind[S1, S2, T any](
 
 // Let attaches the result of a pure computation to a context S1 to produce a context S2.
 // Unlike Bind, the computation function returns a plain value T rather than []T.
+// This is useful when you need to compute a derived value from the current context
+// without introducing additional array elements.
 //
 // Example:
 //
-//	result := array.Let(
-//	    func(sum int) func(s struct{ X int }) struct{ X, Sum int } {
-//	        return func(s struct{ X int }) struct{ X, Sum int } {
-//	            return struct{ X, Sum int }{s.X, sum}
-//	        }
-//	    },
-//	    func(s struct{ X int }) int { return s.X * 2 },
+//	type State1 struct{ X int }
+//	type State2 struct{ X, Double int }
+//
+//	result := F.Pipe2(
+//	    []State1{{X: 5}, {X: 10}},
+//	    array.Let(
+//	        func(double int) func(s State1) State2 {
+//	            return func(s State1) State2 {
+//	                return State2{X: s.X, Double: double}
+//	            }
+//	        },
+//	        func(s State1) int { return s.X * 2 },
+//	    ),
 //	)
+//	// result: []State2{{X: 5, Double: 10}, {X: 10, Double: 20}}
 //
 //go:inline
 func Let[S1, S2, T any](
@@ -84,18 +93,25 @@ func Let[S1, S2, T any](
 }
 
 // LetTo attaches a constant value to a context S1 to produce a context S2.
-// This is useful for adding constant values to the context.
+// This is useful for adding constant values to the context without computation.
 //
 // Example:
 //
-//	result := array.LetTo(
-//	    func(name string) func(s struct{ X int }) struct{ X int; Name string } {
-//	        return func(s struct{ X int }) struct{ X int; Name string } {
-//	            return struct{ X int; Name string }{s.X, name}
-//	        }
-//	    },
-//	    "constant",
+//	type State1 struct{ X int }
+//	type State2 struct{ X int; Name string }
+//
+//	result := F.Pipe2(
+//	    []State1{{X: 1}, {X: 2}},
+//	    array.LetTo(
+//	        func(name string) func(s State1) State2 {
+//	            return func(s State1) State2 {
+//	                return State2{X: s.X, Name: name}
+//	            }
+//	        },
+//	        "constant",
+//	    ),
 //	)
+//	// result: []State2{{X: 1, Name: "constant"}, {X: 2, Name: "constant"}}
 //
 //go:inline
 func LetTo[S1, S2, T any](
@@ -107,15 +123,19 @@ func LetTo[S1, S2, T any](
 
 // BindTo initializes a new state S1 from a value T.
 // This is typically the first operation after Do to start building the context.
+// It transforms each element of type T into a state of type S1.
 //
 // Example:
 //
+//	type State struct{ X int }
+//
 //	result := F.Pipe2(
 //	    []int{1, 2, 3},
-//	    array.BindTo(func(x int) struct{ X int } {
-//	        return struct{ X int }{x}
+//	    array.BindTo(func(x int) State {
+//	        return State{X: x}
 //	    }),
 //	)
+//	// result: []State{{X: 1}, {X: 2}, {X: 3}}
 //
 //go:inline
 func BindTo[S1, T any](

v2/array/bind_extended_test.go

@@ -22,57 +22,176 @@ import (
 	"github.com/stretchr/testify/assert"
 )
 
-type TestState1 struct {
-	X int
-}
-
-type TestState2 struct {
-	X int
-	Y int
-}
-
+// TestLet tests the Let function
 func TestLet(t *testing.T) {
-	result := F.Pipe2(
-		Do(TestState1{}),
+	type State1 struct {
+		X int
+	}
+	type State2 struct {
+		X      int
+		Double int
+	}
+
+	// Test Let with pure computation
+	result := F.Pipe1(
+		[]State1{{X: 5}, {X: 10}},
 		Let(
-			func(y int) func(s TestState1) TestState2 {
-				return func(s TestState1) TestState2 {
-					return TestState2{X: s.X, Y: y}
+			func(double int) func(s State1) State2 {
+				return func(s State1) State2 {
+					return State2{X: s.X, Double: double}
 				}
 			},
-			func(s TestState1) int { return s.X * 2 },
+			func(s State1) int { return s.X * 2 },
 		),
-		Map(func(s TestState2) int { return s.X + s.Y }),
 	)
 
-	assert.Equal(t, []int{0}, result)
+	expected := []State2{{X: 5, Double: 10}, {X: 10, Double: 20}}
+	assert.Equal(t, expected, result)
+
+	// Test Let with empty array
+	empty := []State1{}
+	result2 := F.Pipe1(
+		empty,
+		Let(
+			func(double int) func(s State1) State2 {
+				return func(s State1) State2 {
+					return State2{X: s.X, Double: double}
+				}
+			},
+			func(s State1) int { return s.X * 2 },
+		),
+	)
+	assert.Equal(t, []State2{}, result2)
 }
 
+// TestLetTo tests the LetTo function
 func TestLetTo(t *testing.T) {
-	result := F.Pipe2(
-		Do(TestState1{X: 5}),
+	type State1 struct {
+		X int
+	}
+	type State2 struct {
+		X    int
+		Name string
+	}
+
+	// Test LetTo with constant value
+	result := F.Pipe1(
+		[]State1{{X: 1}, {X: 2}},
 		LetTo(
-			func(y int) func(s TestState1) TestState2 {
-				return func(s TestState1) TestState2 {
-					return TestState2{X: s.X, Y: y}
+			func(name string) func(s State1) State2 {
+				return func(s State1) State2 {
+					return State2{X: s.X, Name: name}
 				}
 			},
-			42,
+			"constant",
 		),
-		Map(func(s TestState2) int { return s.X + s.Y }),
 	)
 
-	assert.Equal(t, []int{47}, result)
+	expected := []State2{{X: 1, Name: "constant"}, {X: 2, Name: "constant"}}
+	assert.Equal(t, expected, result)
+
+	// Test LetTo with different constant
+	result2 := F.Pipe1(
+		[]State1{{X: 10}},
+		LetTo(
+			func(name string) func(s State1) State2 {
+				return func(s State1) State2 {
+					return State2{X: s.X, Name: name}
+				}
+			},
+			"test",
+		),
+	)
+
+	expected2 := []State2{{X: 10, Name: "test"}}
+	assert.Equal(t, expected2, result2)
 }
 
+// TestBindTo tests the BindTo function
 func TestBindTo(t *testing.T) {
+	type State struct {
+		X int
+	}
+
+	// Test BindTo with integers
 	result := F.Pipe1(
 		[]int{1, 2, 3},
-		BindTo(func(x int) TestState1 {
-			return TestState1{X: x}
+		BindTo(func(x int) State {
+			return State{X: x}
 		}),
 	)
 
-	expected := []TestState1{{X: 1}, {X: 2}, {X: 3}}
+	expected := []State{{X: 1}, {X: 2}, {X: 3}}
+	assert.Equal(t, expected, result)
+
+	// Test BindTo with strings
+	type StringState struct {
+		Value string
+	}
+
+	result2 := F.Pipe1(
+		[]string{"hello", "world"},
+		BindTo(func(s string) StringState {
+			return StringState{Value: s}
+		}),
+	)
+
+	expected2 := []StringState{{Value: "hello"}, {Value: "world"}}
+	assert.Equal(t, expected2, result2)
+
+	// Test BindTo with empty array
+	empty := []int{}
+	result3 := F.Pipe1(
+		empty,
+		BindTo(func(x int) State {
+			return State{X: x}
+		}),
+	)
+	assert.Equal(t, []State{}, result3)
+}
+
+// TestDoWithLetAndBindTo tests combining Do, Let, LetTo, and BindTo
+func TestDoWithLetAndBindTo(t *testing.T) {
+	type State1 struct {
+		X int
+	}
+	type State2 struct {
+		X      int
+		Double int
+	}
+	type State3 struct {
+		X      int
+		Double int
+		Name   string
+	}
+
+	// Test complex pipeline
+	result := F.Pipe3(
+		[]int{5, 10},
+		BindTo(func(x int) State1 {
+			return State1{X: x}
+		}),
+		Let(
+			func(double int) func(s State1) State2 {
+				return func(s State1) State2 {
+					return State2{X: s.X, Double: double}
+				}
+			},
+			func(s State1) int { return s.X * 2 },
+		),
+		LetTo(
+			func(name string) func(s State2) State3 {
+				return func(s State2) State3 {
+					return State3{X: s.X, Double: s.Double, Name: name}
+				}
+			},
+			"result",
+		),
+	)
+
+	expected := []State3{
+		{X: 5, Double: 10, Name: "result"},
+		{X: 10, Double: 20, Name: "result"},
+	}
 	assert.Equal(t, expected, result)
 }

v2/array/coverage.out

@@ -0,0 +1,137 @@
+mode: set
+github.com/IBM/fp-go/v2/array/any.go:34.65,36.2 1 1
+github.com/IBM/fp-go/v2/array/any.go:48.51,50.2 1 1
+github.com/IBM/fp-go/v2/array/array.go:30.33,32.2 1 1
+github.com/IBM/fp-go/v2/array/array.go:37.52,39.2 1 1
+github.com/IBM/fp-go/v2/array/array.go:44.39,46.2 1 0
+github.com/IBM/fp-go/v2/array/array.go:52.50,54.2 1 0
+github.com/IBM/fp-go/v2/array/array.go:58.54,61.23 3 0
+github.com/IBM/fp-go/v2/array/array.go:61.23,63.3 1 0
+github.com/IBM/fp-go/v2/array/array.go:64.2,64.11 1 0
+github.com/IBM/fp-go/v2/array/array.go:70.62,72.2 1 0
+github.com/IBM/fp-go/v2/array/array.go:83.48,85.2 1 1
+github.com/IBM/fp-go/v2/array/array.go:89.52,91.2 1 0
+github.com/IBM/fp-go/v2/array/array.go:93.55,96.23 3 0
+github.com/IBM/fp-go/v2/array/array.go:96.23,98.14 2 0
+github.com/IBM/fp-go/v2/array/array.go:98.14,100.4 1 0
+github.com/IBM/fp-go/v2/array/array.go:102.2,102.15 1 0
+github.com/IBM/fp-go/v2/array/array.go:105.75,108.23 3 0
+github.com/IBM/fp-go/v2/array/array.go:108.23,110.14 2 0
+github.com/IBM/fp-go/v2/array/array.go:110.14,112.4 1 0
+github.com/IBM/fp-go/v2/array/array.go:114.2,114.15 1 0
+github.com/IBM/fp-go/v2/array/array.go:120.54,122.2 1 1
+github.com/IBM/fp-go/v2/array/array.go:127.68,129.2 1 0
+github.com/IBM/fp-go/v2/array/array.go:132.58,134.2 1 0
+github.com/IBM/fp-go/v2/array/array.go:140.67,142.2 1 0
+github.com/IBM/fp-go/v2/array/array.go:148.78,150.2 1 0
+github.com/IBM/fp-go/v2/array/array.go:155.65,157.2 1 1
+github.com/IBM/fp-go/v2/array/array.go:162.76,164.2 1 0
+github.com/IBM/fp-go/v2/array/array.go:169.69,171.2 1 1
+github.com/IBM/fp-go/v2/array/array.go:174.80,175.26 1 0
+github.com/IBM/fp-go/v2/array/array.go:175.26,177.3 1 0
+github.com/IBM/fp-go/v2/array/array.go:180.64,182.25 2 0
+github.com/IBM/fp-go/v2/array/array.go:182.25,184.3 1 0
+github.com/IBM/fp-go/v2/array/array.go:185.2,185.16 1 0
+github.com/IBM/fp-go/v2/array/array.go:189.65,191.2 1 1
+github.com/IBM/fp-go/v2/array/array.go:194.79,196.2 1 1
+github.com/IBM/fp-go/v2/array/array.go:206.62,208.2 1 1
+github.com/IBM/fp-go/v2/array/array.go:214.76,216.2 1 0
+github.com/IBM/fp-go/v2/array/array.go:221.67,223.2 1 1
+github.com/IBM/fp-go/v2/array/array.go:229.81,231.2 1 0
+github.com/IBM/fp-go/v2/array/array.go:235.66,236.24 1 0
+github.com/IBM/fp-go/v2/array/array.go:236.24,238.3 1 0
+github.com/IBM/fp-go/v2/array/array.go:254.37,256.2 1 1
+github.com/IBM/fp-go/v2/array/array.go:261.34,263.2 1 1
+github.com/IBM/fp-go/v2/array/array.go:266.37,268.2 1 1
+github.com/IBM/fp-go/v2/array/array.go:273.25,275.2 1 1
+github.com/IBM/fp-go/v2/array/array.go:280.24,282.2 1 0
+github.com/IBM/fp-go/v2/array/array.go:287.25,289.2 1 1
+github.com/IBM/fp-go/v2/array/array.go:295.56,297.2 1 0
+github.com/IBM/fp-go/v2/array/array.go:308.54,310.2 1 1
+github.com/IBM/fp-go/v2/array/array.go:316.53,318.2 1 0
+github.com/IBM/fp-go/v2/array/array.go:324.50,326.2 1 1
+github.com/IBM/fp-go/v2/array/array.go:331.76,333.2 1 1
+github.com/IBM/fp-go/v2/array/array.go:338.83,340.2 1 0
+github.com/IBM/fp-go/v2/array/array.go:346.38,348.2 1 0
+github.com/IBM/fp-go/v2/array/array.go:354.36,356.2 1 1
+github.com/IBM/fp-go/v2/array/array.go:362.37,364.2 1 0
+github.com/IBM/fp-go/v2/array/array.go:370.36,372.2 1 0
+github.com/IBM/fp-go/v2/array/array.go:375.49,376.26 1 1
+github.com/IBM/fp-go/v2/array/array.go:376.26,380.35 4 1
+github.com/IBM/fp-go/v2/array/array.go:380.35,385.4 4 1
+github.com/IBM/fp-go/v2/array/array.go:386.3,386.16 1 1
+github.com/IBM/fp-go/v2/array/array.go:395.50,397.26 2 1
+github.com/IBM/fp-go/v2/array/array.go:397.26,398.18 1 1
+github.com/IBM/fp-go/v2/array/array.go:398.18,400.4 1 1
+github.com/IBM/fp-go/v2/array/array.go:401.3,401.25 1 1
+github.com/IBM/fp-go/v2/array/array.go:406.60,407.36 1 1
+github.com/IBM/fp-go/v2/array/array.go:407.36,409.3 1 1
+github.com/IBM/fp-go/v2/array/array.go:419.36,421.2 1 1
+github.com/IBM/fp-go/v2/array/array.go:424.49,426.2 1 1
+github.com/IBM/fp-go/v2/array/array.go:432.49,434.2 1 1
+github.com/IBM/fp-go/v2/array/array.go:440.42,442.2 1 0
+github.com/IBM/fp-go/v2/array/array.go:447.30,449.2 1 1
+github.com/IBM/fp-go/v2/array/array.go:456.78,458.2 1 0
+github.com/IBM/fp-go/v2/array/array.go:464.75,466.2 1 1
+github.com/IBM/fp-go/v2/array/array.go:469.32,471.2 1 0
+github.com/IBM/fp-go/v2/array/array.go:474.35,476.2 1 0
+github.com/IBM/fp-go/v2/array/array.go:479.28,481.2 1 0
+github.com/IBM/fp-go/v2/array/array.go:486.50,488.2 1 0
+github.com/IBM/fp-go/v2/array/array.go:493.29,495.2 1 0
+github.com/IBM/fp-go/v2/array/array.go:500.47,502.2 1 0
+github.com/IBM/fp-go/v2/array/array.go:507.67,509.2 1 1
+github.com/IBM/fp-go/v2/array/array.go:514.81,516.2 1 0
+github.com/IBM/fp-go/v2/array/array.go:521.45,523.2 1 0
+github.com/IBM/fp-go/v2/array/array.go:528.38,530.2 1 0
+github.com/IBM/fp-go/v2/array/array.go:605.43,607.2 1 1
+github.com/IBM/fp-go/v2/array/array.go:613.52,615.2 1 0
+github.com/IBM/fp-go/v2/array/array.go:621.49,623.2 1 0
+github.com/IBM/fp-go/v2/array/array.go:628.44,630.2 1 0
+github.com/IBM/fp-go/v2/array/array.go:714.33,716.2 1 1
+github.com/IBM/fp-go/v2/array/array.go:780.53,781.26 1 1
+github.com/IBM/fp-go/v2/array/array.go:781.26,782.47 1 1
+github.com/IBM/fp-go/v2/array/array.go:782.47,782.67 1 1
+github.com/IBM/fp-go/v2/array/array.go:839.31,841.2 1 1
+github.com/IBM/fp-go/v2/array/bind.go:36.7,38.2 1 1
+github.com/IBM/fp-go/v2/array/bind.go:60.20,62.2 1 1
+github.com/IBM/fp-go/v2/array/bind.go:91.20,93.2 1 1
+github.com/IBM/fp-go/v2/array/bind.go:120.20,122.2 1 1
+github.com/IBM/fp-go/v2/array/bind.go:143.19,145.2 1 1
+github.com/IBM/fp-go/v2/array/bind.go:166.20,168.2 1 1
+github.com/IBM/fp-go/v2/array/eq.go:35.37,37.49 2 1
+github.com/IBM/fp-go/v2/array/eq.go:37.49,39.3 1 1
+github.com/IBM/fp-go/v2/array/eq.go:43.45,45.2 1 1
+github.com/IBM/fp-go/v2/array/find.go:33.65,35.2 1 1
+github.com/IBM/fp-go/v2/array/find.go:48.79,50.2 1 1
+github.com/IBM/fp-go/v2/array/find.go:68.78,70.2 1 1
+github.com/IBM/fp-go/v2/array/find.go:76.89,78.2 1 1
+github.com/IBM/fp-go/v2/array/find.go:89.64,91.2 1 1
+github.com/IBM/fp-go/v2/array/find.go:97.78,99.2 1 1
+github.com/IBM/fp-go/v2/array/find.go:105.77,107.2 1 1
+github.com/IBM/fp-go/v2/array/find.go:113.88,115.2 1 1
+github.com/IBM/fp-go/v2/array/magma.go:38.50,40.2 1 1
+github.com/IBM/fp-go/v2/array/monad.go:39.65,41.2 1 1
+github.com/IBM/fp-go/v2/array/monoid.go:35.36,37.2 1 1
+github.com/IBM/fp-go/v2/array/monoid.go:48.42,50.2 1 1
+github.com/IBM/fp-go/v2/array/monoid.go:52.45,54.2 1 1
+github.com/IBM/fp-go/v2/array/monoid.go:68.45,73.48 3 1
+github.com/IBM/fp-go/v2/array/monoid.go:73.48,75.3 1 1
+github.com/IBM/fp-go/v2/array/monoid.go:77.2,77.12 1 1
+github.com/IBM/fp-go/v2/array/sequence.go:27.19,29.2 1 1
+github.com/IBM/fp-go/v2/array/sequence.go:69.22,71.2 1 1
+github.com/IBM/fp-go/v2/array/sequence.go:92.53,98.2 1 1
+github.com/IBM/fp-go/v2/array/sort.go:35.47,37.2 1 1
+github.com/IBM/fp-go/v2/array/sort.go:65.68,67.2 1 1
+github.com/IBM/fp-go/v2/array/sort.go:96.51,98.2 1 1
+github.com/IBM/fp-go/v2/array/traverse.go:66.34,68.2 1 1
+github.com/IBM/fp-go/v2/array/traverse.go:83.24,86.2 1 1
+github.com/IBM/fp-go/v2/array/traverse.go:94.39,96.2 1 1
+github.com/IBM/fp-go/v2/array/traverse.go:105.29,108.2 1 1
+github.com/IBM/fp-go/v2/array/traverse.go:110.142,117.46 1 1
+github.com/IBM/fp-go/v2/array/traverse.go:117.46,118.54 1 1
+github.com/IBM/fp-go/v2/array/traverse.go:118.54,125.4 1 1
+github.com/IBM/fp-go/v2/array/uniq.go:20.43,22.2 1 1
+github.com/IBM/fp-go/v2/array/uniq.go:49.60,51.2 1 1
+github.com/IBM/fp-go/v2/array/zip.go:38.73,40.2 1 1
+github.com/IBM/fp-go/v2/array/zip.go:58.55,60.2 1 1
+github.com/IBM/fp-go/v2/array/zip.go:81.62,83.2 1 1

v2/array/nonempty/array_test.go

@@ -764,14 +764,14 @@ func TestFoldMap(t *testing.T) {
 	t.Run("FoldMap with sum semigroup", func(t *testing.T) {
 		sumSemigroup := N.SemigroupSum[int]()
 		arr := From(1, 2, 3, 4)
-		result := FoldMap[int, int](sumSemigroup)(func(x int) int { return x * 2 })(arr)
+		result := FoldMap[int](sumSemigroup)(func(x int) int { return x * 2 })(arr)
 		assert.Equal(t, 20, result) // (1*2) + (2*2) + (3*2) + (4*2) = 20
 	})
 
 	t.Run("FoldMap with string concatenation", func(t *testing.T) {
 		concatSemigroup := STR.Semigroup
 		arr := From(1, 2, 3)
-		result := FoldMap[int, string](concatSemigroup)(func(x int) string { return fmt.Sprintf("%d", x) })(arr)
+		result := FoldMap[int](concatSemigroup)(func(x int) string { return fmt.Sprintf("%d", x) })(arr)
 		assert.Equal(t, "123", result)
 	})
 }

v2/array/sequence_extended_test.go

@@ -0,0 +1,78 @@
+// Copyright (c) 2023 - 2025 IBM Corp.
+// All rights reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package array
+
+import (
+	"testing"
+
+	O "github.com/IBM/fp-go/v2/option"
+	"github.com/stretchr/testify/assert"
+)
+
+// TestSequenceWithOption tests the generic Sequence function with Option monad
+func TestSequenceWithOption(t *testing.T) {
+	// Test with Option monad - all Some values
+	opts := From(
+		O.Some(1),
+		O.Some(2),
+		O.Some(3),
+	)
+
+	// Use the Sequence function with Option's applicative monoid
+	monoid := O.ApplicativeMonoid(Monoid[int]())
+	seq := Sequence(O.Map(Of[int]), monoid)
+	result := seq(opts)
+
+	assert.Equal(t, O.Of(From(1, 2, 3)), result)
+
+	// Test with Option monad - contains None
+	optsWithNone := From(
+		O.Some(1),
+		O.None[int](),
+		O.Some(3),
+	)
+
+	result2 := seq(optsWithNone)
+	assert.True(t, O.IsNone(result2))
+
+	// Test with empty array
+	empty := Empty[Option[int]]()
+	result3 := seq(empty)
+	assert.Equal(t, O.Some(Empty[int]()), result3)
+}
+
+// TestMonadSequence tests the MonadSequence function
+func TestMonadSequence(t *testing.T) {
+	// Test with Option monad
+	opts := From(
+		O.Some("hello"),
+		O.Some("world"),
+	)
+
+	monoid := O.ApplicativeMonoid(Monoid[string]())
+	result := MonadSequence(O.Map(Of[string]), monoid, opts)
+
+	assert.Equal(t, O.Of(From("hello", "world")), result)
+
+	// Test with None in the array
+	optsWithNone := From(
+		O.Some("hello"),
+		O.None[string](),
+	)
+
+	result2 := MonadSequence(O.Map(Of[string]), monoid, optsWithNone)
+	assert.Equal(t, O.None[[]string](), result2)
+}

v2/array/traverse_extended_test.go

@@ -0,0 +1,164 @@
+// Copyright (c) 2023 - 2025 IBM Corp.
+// All rights reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package array
+
+import (
+	"strconv"
+	"testing"
+
+	O "github.com/IBM/fp-go/v2/option"
+	"github.com/stretchr/testify/assert"
+)
+
+// TestMonadTraverse tests the MonadTraverse function
+func TestMonadTraverse(t *testing.T) {
+	// Test converting integers to strings via Option
+	numbers := []int{1, 2, 3}
+
+	result := MonadTraverse(
+		O.Of[[]string],
+		O.Map[[]string, func(string) []string],
+		O.Ap[[]string, string],
+		numbers,
+		func(n int) O.Option[string] {
+			return O.Some(strconv.Itoa(n))
+		},
+	)
+
+	assert.True(t, O.IsSome(result))
+	assert.Equal(t, []string{"1", "2", "3"}, O.GetOrElse(func() []string { return []string{} })(result))
+
+	// Test with a function that can return None
+	result2 := MonadTraverse(
+		O.Of[[]string],
+		O.Map[[]string, func(string) []string],
+		O.Ap[[]string, string],
+		numbers,
+		func(n int) O.Option[string] {
+			if n == 2 {
+				return O.None[string]()
+			}
+			return O.Some(strconv.Itoa(n))
+		},
+	)
+
+	assert.True(t, O.IsNone(result2))
+
+	// Test with empty array
+	empty := []int{}
+	result3 := MonadTraverse(
+		O.Of[[]string],
+		O.Map[[]string, func(string) []string],
+		O.Ap[[]string, string],
+		empty,
+		func(n int) O.Option[string] {
+			return O.Some(strconv.Itoa(n))
+		},
+	)
+
+	assert.True(t, O.IsSome(result3))
+	assert.Equal(t, []string{}, O.GetOrElse(func() []string { return nil })(result3))
+}
+
+// TestTraverseWithIndex tests the TraverseWithIndex function
+func TestTraverseWithIndex(t *testing.T) {
+	// Test with index-aware transformation
+	words := []string{"a", "b", "c"}
+
+	traverser := TraverseWithIndex(
+		O.Of[[]string],
+		O.Map[[]string, func(string) []string],
+		O.Ap[[]string, string],
+		func(idx int, s string) O.Option[string] {
+			return O.Some(s + strconv.Itoa(idx))
+		},
+	)
+
+	result := traverser(words)
+	assert.True(t, O.IsSome(result))
+	assert.Equal(t, []string{"a0", "b1", "c2"}, O.GetOrElse(func() []string { return []string{} })(result))
+
+	// Test with conditional None based on index
+	traverser2 := TraverseWithIndex(
+		O.Of[[]string],
+		O.Map[[]string, func(string) []string],
+		O.Ap[[]string, string],
+		func(idx int, s string) O.Option[string] {
+			if idx == 1 {
+				return O.None[string]()
+			}
+			return O.Some(s)
+		},
+	)
+
+	result2 := traverser2(words)
+	assert.True(t, O.IsNone(result2))
+}
+
+// TestMonadTraverseWithIndex tests the MonadTraverseWithIndex function
+func TestMonadTraverseWithIndex(t *testing.T) {
+	// Test with index-aware transformation
+	numbers := []int{10, 20, 30}
+
+	result := MonadTraverseWithIndex(
+		O.Of[[]string],
+		O.Map[[]string, func(string) []string],
+		O.Ap[[]string, string],
+		numbers,
+		func(idx, n int) O.Option[string] {
+			return O.Some(strconv.Itoa(n * idx))
+		},
+	)
+
+	assert.True(t, O.IsSome(result))
+	// Expected: [10*0, 20*1, 30*2] = ["0", "20", "60"]
+	assert.Equal(t, []string{"0", "20", "60"}, O.GetOrElse(func() []string { return []string{} })(result))
+
+	// Test with None at specific index
+	result2 := MonadTraverseWithIndex(
+		O.Of[[]string],
+		O.Map[[]string, func(string) []string],
+		O.Ap[[]string, string],
+		numbers,
+		func(idx, n int) O.Option[string] {
+			if idx == 2 {
+				return O.None[string]()
+			}
+			return O.Some(strconv.Itoa(n))
+		},
+	)
+
+	assert.True(t, O.IsNone(result2))
+}
+
+// TestMakeTraverseType tests the MakeTraverseType function
+func TestMakeTraverseType(t *testing.T) {
+	// Create a traverse type for Option
+	traverseType := MakeTraverseType[int, string, O.Option[string], O.Option[[]string], O.Option[func(string) []string]]()
+
+	// Use it to traverse an array
+	numbers := []int{1, 2, 3}
+	result := traverseType(
+		O.Of[[]string],
+		O.Map[[]string, func(string) []string],
+		O.Ap[[]string, string],
+	)(func(n int) O.Option[string] {
+		return O.Some(strconv.Itoa(n * 2))
+	})(numbers)
+
+	assert.True(t, O.IsSome(result))
+	assert.Equal(t, []string{"2", "4", "6"}, O.GetOrElse(func() []string { return []string{} })(result))
+}

v2/cli/apply.go

@@ -16,13 +16,14 @@
 package cli
 
 import (
+	"context"
 	"fmt"
 	"log"
 	"os"
 	"path/filepath"
 	"time"
 
-	C "github.com/urfave/cli/v2"
+	C "github.com/urfave/cli/v3"
 )
 
 func generateTraverseTuple(f *os.File, i int) {
@@ -422,10 +423,10 @@ func ApplyCommand() *C.Command {
 			flagCount,
 			flagFilename,
 		},
-		Action: func(ctx *C.Context) error {
+		Action: func(ctx context.Context, cmd *C.Command) error {
 			return generateApplyHelpers(
-				ctx.String(keyFilename),
-				ctx.Int(keyCount),
+				cmd.String(keyFilename),
+				cmd.Int(keyCount),
 			)
 		},
 	}

v2/cli/bind.go

@@ -16,13 +16,14 @@
 package cli
 
 import (
+	"context"
 	"fmt"
 	"log"
 	"os"
 	"path/filepath"
 	"time"
 
-	C "github.com/urfave/cli/v2"
+	C "github.com/urfave/cli/v3"
 )
 
 func createCombinations(n int, all, prev []int) [][]int {
@@ -284,10 +285,10 @@ func BindCommand() *C.Command {
 			flagCount,
 			flagFilename,
 		},
-		Action: func(ctx *C.Context) error {
+		Action: func(ctx context.Context, cmd *C.Command) error {
 			return generateBindHelpers(
-				ctx.String(keyFilename),
-				ctx.Int(keyCount),
+				cmd.String(keyFilename),
+				cmd.Int(keyCount),
 			)
 		},
 	}

v2/cli/commands.go

@@ -16,7 +16,7 @@
 package cli
 
 import (
-	C "github.com/urfave/cli/v2"
+	C "github.com/urfave/cli/v3"
 )
 
 func Commands() []*C.Command {

v2/cli/common.go

@@ -16,7 +16,7 @@
 package cli
 
 import (
-	C "github.com/urfave/cli/v2"
+	C "github.com/urfave/cli/v3"
 )
 
 const (

v2/cli/contextreaderioeither.go

@@ -16,6 +16,7 @@
 package cli
 
 import (
+	"context"
 	"fmt"
 	"log"
 	"os"
@@ -23,7 +24,7 @@ import (
 	"strings"
 
 	A "github.com/IBM/fp-go/v2/array"
-	C "github.com/urfave/cli/v2"
+	C "github.com/urfave/cli/v3"
 )
 
 // Deprecated:
@@ -261,10 +262,10 @@ func ContextReaderIOEitherCommand() *C.Command {
 			flagCount,
 			flagFilename,
 		},
-		Action: func(ctx *C.Context) error {
+		Action: func(ctx context.Context, cmd *C.Command) error {
 			return generateContextReaderIOEitherHelpers(
-				ctx.String(keyFilename),
-				ctx.Int(keyCount),
+				cmd.String(keyFilename),
+				cmd.Int(keyCount),
 			)
 		},
 	}

v2/cli/di.go

@@ -16,13 +16,14 @@
 package cli
 
 import (
+	"context"
 	"fmt"
 	"log"
 	"os"
 	"path/filepath"
 	"time"
 
-	C "github.com/urfave/cli/v2"
+	C "github.com/urfave/cli/v3"
 )
 
 func generateMakeProvider(f *os.File, i int) {
@@ -221,10 +222,10 @@ func DICommand() *C.Command {
 			flagCount,
 			flagFilename,
 		},
-		Action: func(ctx *C.Context) error {
+		Action: func(ctx context.Context, cmd *C.Command) error {
 			return generateDIHelpers(
-				ctx.String(keyFilename),
-				ctx.Int(keyCount),
+				cmd.String(keyFilename),
+				cmd.Int(keyCount),
 			)
 		},
 	}

v2/cli/either.go

@@ -16,13 +16,14 @@
 package cli
 
 import (
+	"context"
 	"fmt"
 	"log"
 	"os"
 	"path/filepath"
 	"time"
 
-	C "github.com/urfave/cli/v2"
+	C "github.com/urfave/cli/v3"
 )
 
 func eitherHKT(typeE string) func(typeA string) string {
@@ -190,10 +191,10 @@ func EitherCommand() *C.Command {
 			flagCount,
 			flagFilename,
 		},
-		Action: func(ctx *C.Context) error {
+		Action: func(ctx context.Context, cmd *C.Command) error {
 			return generateEitherHelpers(
-				ctx.String(keyFilename),
-				ctx.Int(keyCount),
+				cmd.String(keyFilename),
+				cmd.Int(keyCount),
 			)
 		},
 	}

v2/cli/identity.go

@@ -16,13 +16,14 @@
 package cli
 
 import (
+	"context"
 	"fmt"
 	"log"
 	"os"
 	"path/filepath"
 	"time"
 
-	C "github.com/urfave/cli/v2"
+	C "github.com/urfave/cli/v3"
 )
 
 func identityHKT(typeA string) string {
@@ -93,10 +94,10 @@ func IdentityCommand() *C.Command {
 			flagCount,
 			flagFilename,
 		},
-		Action: func(ctx *C.Context) error {
+		Action: func(ctx context.Context, cmd *C.Command) error {
 			return generateIdentityHelpers(
-				ctx.String(keyFilename),
-				ctx.Int(keyCount),
+				cmd.String(keyFilename),
+				cmd.Int(keyCount),
 			)
 		},
 	}

v2/cli/io.go

@@ -16,6 +16,7 @@
 package cli
 
 import (
+	"context"
 	"fmt"
 	"log"
 	"os"
@@ -23,7 +24,7 @@ import (
 	"time"
 
 	A "github.com/IBM/fp-go/v2/array"
-	C "github.com/urfave/cli/v2"
+	C "github.com/urfave/cli/v3"
 )
 
 func nonGenericIO(param string) string {
@@ -102,10 +103,10 @@ func IOCommand() *C.Command {
 			flagCount,
 			flagFilename,
 		},
-		Action: func(ctx *C.Context) error {
+		Action: func(ctx context.Context, cmd *C.Command) error {
 			return generateIOHelpers(
-				ctx.String(keyFilename),
-				ctx.Int(keyCount),
+				cmd.String(keyFilename),
+				cmd.Int(keyCount),
 			)
 		},
 	}

v2/cli/ioeither.go

@@ -16,6 +16,7 @@
 package cli
 
 import (
+	"context"
 	"fmt"
 	"log"
 	"os"
@@ -23,7 +24,7 @@ import (
 	"time"
 
 	A "github.com/IBM/fp-go/v2/array"
-	C "github.com/urfave/cli/v2"
+	C "github.com/urfave/cli/v3"
 )
 
 // [GA ~func() ET.Either[E, A], GB ~func() ET.Either[E, B], GTAB ~func() ET.Either[E, T.Tuple2[A, B]], E, A, B any](a GA, b GB) GTAB {
@@ -273,10 +274,10 @@ func IOEitherCommand() *C.Command {
 			flagCount,
 			flagFilename,
 		},
-		Action: func(ctx *C.Context) error {
+		Action: func(ctx context.Context, cmd *C.Command) error {
 			return generateIOEitherHelpers(
-				ctx.String(keyFilename),
-				ctx.Int(keyCount),
+				cmd.String(keyFilename),
+				cmd.Int(keyCount),
 			)
 		},
 	}

v2/cli/iooption.go

@@ -16,6 +16,7 @@
 package cli
 
 import (
+	"context"
 	"fmt"
 	"log"
 	"os"
@@ -23,7 +24,7 @@ import (
 	"time"
 
 	A "github.com/IBM/fp-go/v2/array"
-	C "github.com/urfave/cli/v2"
+	C "github.com/urfave/cli/v3"
 )
 
 func nonGenericIOOption(param string) string {
@@ -107,10 +108,10 @@ func IOOptionCommand() *C.Command {
 			flagCount,
 			flagFilename,
 		},
-		Action: func(ctx *C.Context) error {
+		Action: func(ctx context.Context, cmd *C.Command) error {
 			return generateIOOptionHelpers(
-				ctx.String(keyFilename),
-				ctx.Int(keyCount),
+				cmd.String(keyFilename),
+				cmd.Int(keyCount),
 			)
 		},
 	}

v2/cli/lens.go

@@ -17,6 +17,7 @@ package cli
 
 import (
 	"bytes"
+	"context"
 	"go/ast"
 	"go/parser"
 	"go/token"
@@ -28,7 +29,7 @@ import (
 	"text/template"
 
 	S "github.com/IBM/fp-go/v2/string"
-	C "github.com/urfave/cli/v2"
+	C "github.com/urfave/cli/v3"
 )
 
 const (
@@ -86,7 +87,9 @@ type templateData struct {
 }
 
 const lensStructTemplate = `
-// {{.Name}}Lenses provides lenses for accessing fields of {{.Name}}
+// {{.Name}}Lenses provides [lenses] for accessing fields of [{{.Name}}]
+//
+// [lenses]: __lens.Lens
 type {{.Name}}Lenses{{.TypeParams}} struct {
 	// mandatory fields
 {{- range .Fields}}
@@ -100,7 +103,10 @@ type {{.Name}}Lenses{{.TypeParams}} struct {
 {{- end}}
 }
 
-// {{.Name}}RefLenses provides lenses for accessing fields of {{.Name}} via a reference to {{.Name}}
+// {{.Name}}RefLenses provides [lenses] for accessing fields of [{{.Name}}] via a reference to [{{.Name}}]
+//
+//
+// [lenses]: __lens.Lens
 type {{.Name}}RefLenses{{.TypeParams}} struct {
 	// mandatory fields
 {{- range .Fields}}
@@ -111,23 +117,32 @@ type {{.Name}}RefLenses{{.TypeParams}} struct {
 {{- if .IsComparable}}
 	{{.Name}}O __lens_option.LensO[*{{$.Name}}{{$.TypeParamNames}}, {{.TypeName}}]
 {{- end}}
-{{- end}}
-	// prisms
-{{- range .Fields}}
-	{{.Name}}P __prism.Prism[*{{$.Name}}{{$.TypeParamNames}}, {{.TypeName}}]
 {{- end}}
 }
 
-// {{.Name}}Prisms provides prisms for accessing fields of {{.Name}}
+// {{.Name}}Prisms provides [prisms] for accessing fields of [{{.Name}}]
+//
+// [prisms]: __prism.Prism
 type {{.Name}}Prisms{{.TypeParams}} struct {
 {{- range .Fields}}
 	{{.Name}} __prism.Prism[{{$.Name}}{{$.TypeParamNames}}, {{.TypeName}}]
 {{- end}}
 }
+
+// {{.Name}}RefPrisms provides [prisms] for accessing fields of [{{.Name}}] via a reference to [{{.Name}}]
+//
+// [prisms]: __prism.Prism
+type {{.Name}}RefPrisms{{.TypeParams}} struct {
+{{- range .Fields}}
+	{{.Name}} __prism.Prism[*{{$.Name}}{{$.TypeParamNames}}, {{.TypeName}}]
+{{- end}}
+}
 `
 
 const lensConstructorTemplate = `
-// Make{{.Name}}Lenses creates a new {{.Name}}Lenses with lenses for all fields
+// Make{{.Name}}Lenses creates a new [{{.Name}}Lenses] with [lenses] for all fields
+//
+// [lenses]:__lens.Lens
 func Make{{.Name}}Lenses{{.TypeParams}}() {{.Name}}Lenses{{.TypeParamNames}} {
 	// mandatory lenses
 {{- range .Fields}}
@@ -157,7 +172,9 @@ func Make{{.Name}}Lenses{{.TypeParams}}() {{.Name}}Lenses{{.TypeParamNames}} {
 	}
 }
 
-// Make{{.Name}}RefLenses creates a new {{.Name}}RefLenses with lenses for all fields
+// Make{{.Name}}RefLenses creates a new [{{.Name}}RefLenses] with [lenses] for all fields
+//
+// [lenses]:__lens.Lens
 func Make{{.Name}}RefLenses{{.TypeParams}}() {{.Name}}RefLenses{{.TypeParamNames}} {
 	// mandatory lenses
 {{- range .Fields}}
@@ -195,7 +212,9 @@ func Make{{.Name}}RefLenses{{.TypeParams}}() {{.Name}}RefLenses{{.TypeParamNames
 	}
 }
 
-// Make{{.Name}}Prisms creates a new {{.Name}}Prisms with prisms for all fields
+// Make{{.Name}}Prisms creates a new [{{.Name}}Prisms] with [prisms] for all fields
+//
+// [prisms]:__prism.Prism
 func Make{{.Name}}Prisms{{.TypeParams}}() {{.Name}}Prisms{{.TypeParamNames}} {
 {{- range .Fields}}
 {{- if .IsComparable}}
@@ -235,6 +254,49 @@ func Make{{.Name}}Prisms{{.TypeParams}}() {{.Name}}Prisms{{.TypeParamNames}} {
 {{- end}}
 	}
 }
+
+// Make{{.Name}}RefPrisms creates a new [{{.Name}}RefPrisms] with [prisms] for all fields
+//
+// [prisms]:__prism.Prism
+func Make{{.Name}}RefPrisms{{.TypeParams}}() {{.Name}}RefPrisms{{.TypeParamNames}} {
+{{- range .Fields}}
+{{- if .IsComparable}}
+	_fromNonZero{{.Name}} := __option.FromNonZero[{{.TypeName}}]()
+	_prism{{.Name}} := __prism.MakePrismWithName(
+		func(s *{{$.Name}}{{$.TypeParamNames}}) __option.Option[{{.TypeName}}] { return _fromNonZero{{.Name}}(s.{{.Name}}) },
+		func(v {{.TypeName}}) *{{$.Name}}{{$.TypeParamNames}} {
+			{{- if .IsEmbedded}}
+			var result {{$.Name}}{{$.TypeParamNames}}
+			result.{{.Name}} = v
+			return &result
+			{{- else}}
+			return &{{$.Name}}{{$.TypeParamNames}}{ {{.Name}}: v }
+			{{- end}}
+		},
+		"{{$.Name}}{{$.TypeParamNames}}.{{.Name}}",
+	)
+{{- else}}
+	_prism{{.Name}} := __prism.MakePrismWithName(
+		func(s *{{$.Name}}{{$.TypeParamNames}}) __option.Option[{{.TypeName}}] { return __option.Some(s.{{.Name}}) },
+		func(v {{.TypeName}}) *{{$.Name}}{{$.TypeParamNames}} {
+			{{- if .IsEmbedded}}
+			var result {{$.Name}}{{$.TypeParamNames}}
+			result.{{.Name}} = v
+			return &result
+			{{- else}}
+			return &{{$.Name}}{{$.TypeParamNames}}{ {{.Name}}: v }
+			{{- end}}
+		},
+		"{{$.Name}}{{$.TypeParamNames}}.{{.Name}}",
+	)
+{{- end}}
+{{- end}}
+	return {{.Name}}RefPrisms{{.TypeParamNames}} {
+{{- range .Fields}}
+		{{.Name}}: _prism{{.Name}},
+{{- end}}
+	}
+}
 `
 
 var (
@@ -535,9 +597,9 @@ func extractEmbeddedFields(embedType ast.Expr, fileImports map[string]string, fi
 		}
 
 		for _, name := range field.Names {
-			// Only export lenses for exported fields
-			if name.IsExported() {
-				fieldTypeName := getTypeName(field.Type)
+			// Generate lenses for both exported and unexported fields
+			fieldTypeName := getTypeName(field.Type)
+			if true { // Keep the block structure for minimal changes
 				isOptional := false
 				baseType := fieldTypeName
 
@@ -697,9 +759,9 @@ func parseFile(filename string) ([]structInfo, string, error) {
 				continue
 			}
 			for _, name := range field.Names {
-				// Only export lenses for exported fields
-				if name.IsExported() {
-					typeName := getTypeName(field.Type)
+				// Generate lenses for both exported and unexported fields
+				typeName := getTypeName(field.Type)
+				if true { // Keep the block structure for minimal changes
 					isOptional := false
 					baseType := typeName
 					isComparable := false
@@ -934,12 +996,12 @@ func LensCommand() *C.Command {
 			flagVerbose,
 			flagIncludeTestFiles,
 		},
-		Action: func(ctx *C.Context) error {
+		Action: func(ctx context.Context, cmd *C.Command) error {
 			return generateLensHelpers(
-				ctx.String(keyLensDir),
-				ctx.String(keyFilename),
-				ctx.Bool(keyVerbose),
-				ctx.Bool(keyIncludeTestFile),
+				cmd.String(keyLensDir),
+				cmd.String(keyFilename),
+				cmd.Bool(keyVerbose),
+				cmd.Bool(keyIncludeTestFile),
 			)
 		},
 	}

v2/cli/lens_test.go

@@ -1086,3 +1086,255 @@ type ComparableBox[T comparable] struct {
 	// Verify that MakeLensRef is NOT used (since both fields are comparable)
 	assert.NotContains(t, contentStr, "__lens.MakeLensRefWithName(", "Should not use MakeLensRefWithName when all fields are comparable")
 }
+
+func TestParseFileWithUnexportedFields(t *testing.T) {
+	// Create a temporary test file
+	tmpDir := t.TempDir()
+	testFile := filepath.Join(tmpDir, "test.go")
+
+	testCode := `package testpkg
+
+// fp-go:Lens
+type Config struct {
+	PublicName  string
+	privateName string
+	PublicValue int
+	privateValue *int
+}
+`
+
+	err := os.WriteFile(testFile, []byte(testCode), 0o644)
+	require.NoError(t, err)
+
+	// Parse the file
+	structs, pkg, err := parseFile(testFile)
+	require.NoError(t, err)
+
+	// Verify results
+	assert.Equal(t, "testpkg", pkg)
+	assert.Len(t, structs, 1)
+
+	// Check Config struct
+	config := structs[0]
+	assert.Equal(t, "Config", config.Name)
+	assert.Len(t, config.Fields, 4, "Should include both exported and unexported fields")
+
+	// Check exported field
+	assert.Equal(t, "PublicName", config.Fields[0].Name)
+	assert.Equal(t, "string", config.Fields[0].TypeName)
+	assert.False(t, config.Fields[0].IsOptional)
+
+	// Check unexported field
+	assert.Equal(t, "privateName", config.Fields[1].Name)
+	assert.Equal(t, "string", config.Fields[1].TypeName)
+	assert.False(t, config.Fields[1].IsOptional)
+
+	// Check exported int field
+	assert.Equal(t, "PublicValue", config.Fields[2].Name)
+	assert.Equal(t, "int", config.Fields[2].TypeName)
+	assert.False(t, config.Fields[2].IsOptional)
+
+	// Check unexported pointer field
+	assert.Equal(t, "privateValue", config.Fields[3].Name)
+	assert.Equal(t, "*int", config.Fields[3].TypeName)
+	assert.True(t, config.Fields[3].IsOptional)
+}
+
+func TestGenerateLensHelpersWithUnexportedFields(t *testing.T) {
+	// Create a temporary directory with test files
+	tmpDir := t.TempDir()
+
+	testCode := `package testpkg
+
+// fp-go:Lens
+type MixedStruct struct {
+	PublicField  string
+	privateField int
+	OptionalPrivate *string
+}
+`
+
+	testFile := filepath.Join(tmpDir, "test.go")
+	err := os.WriteFile(testFile, []byte(testCode), 0o644)
+	require.NoError(t, err)
+
+	// Generate lens code
+	outputFile := "gen_lens.go"
+	err = generateLensHelpers(tmpDir, outputFile, false, false)
+	require.NoError(t, err)
+
+	// Verify the generated file exists
+	genPath := filepath.Join(tmpDir, outputFile)
+	_, err = os.Stat(genPath)
+	require.NoError(t, err)
+
+	// Read and verify the generated content
+	content, err := os.ReadFile(genPath)
+	require.NoError(t, err)
+
+	contentStr := string(content)
+
+	// Check for expected content
+	assert.Contains(t, contentStr, "package testpkg")
+	assert.Contains(t, contentStr, "MixedStructLenses")
+	assert.Contains(t, contentStr, "MakeMixedStructLenses")
+
+	// Check that lenses are generated for all fields (exported and unexported)
+	assert.Contains(t, contentStr, "PublicField __lens.Lens[MixedStruct, string]")
+	assert.Contains(t, contentStr, "privateField __lens.Lens[MixedStruct, int]")
+	assert.Contains(t, contentStr, "OptionalPrivate __lens.Lens[MixedStruct, *string]")
+
+	// Check lens constructors
+	assert.Contains(t, contentStr, "func(s MixedStruct) string { return s.PublicField }")
+	assert.Contains(t, contentStr, "func(s MixedStruct) int { return s.privateField }")
+	assert.Contains(t, contentStr, "func(s MixedStruct) *string { return s.OptionalPrivate }")
+
+	// Check setters
+	assert.Contains(t, contentStr, "func(s MixedStruct, v string) MixedStruct { s.PublicField = v; return s }")
+	assert.Contains(t, contentStr, "func(s MixedStruct, v int) MixedStruct { s.privateField = v; return s }")
+	assert.Contains(t, contentStr, "func(s MixedStruct, v *string) MixedStruct { s.OptionalPrivate = v; return s }")
+}
+
+func TestParseFileWithOnlyUnexportedFields(t *testing.T) {
+	// Create a temporary test file
+	tmpDir := t.TempDir()
+	testFile := filepath.Join(tmpDir, "test.go")
+
+	testCode := `package testpkg
+
+// fp-go:Lens
+type PrivateConfig struct {
+	name    string
+	value   int
+	enabled bool
+}
+`
+
+	err := os.WriteFile(testFile, []byte(testCode), 0o644)
+	require.NoError(t, err)
+
+	// Parse the file
+	structs, pkg, err := parseFile(testFile)
+	require.NoError(t, err)
+
+	// Verify results
+	assert.Equal(t, "testpkg", pkg)
+	assert.Len(t, structs, 1)
+
+	// Check PrivateConfig struct
+	config := structs[0]
+	assert.Equal(t, "PrivateConfig", config.Name)
+	assert.Len(t, config.Fields, 3, "Should include all unexported fields")
+
+	// Check all fields are unexported
+	assert.Equal(t, "name", config.Fields[0].Name)
+	assert.Equal(t, "value", config.Fields[1].Name)
+	assert.Equal(t, "enabled", config.Fields[2].Name)
+}
+
+func TestGenerateLensHelpersWithUnexportedEmbeddedFields(t *testing.T) {
+	// Create a temporary directory with test files
+	tmpDir := t.TempDir()
+
+	testCode := `package testpkg
+
+type BaseConfig struct {
+	publicBase  string
+	privateBase int
+}
+
+// fp-go:Lens
+type ExtendedConfig struct {
+	BaseConfig
+	PublicField  string
+	privateField bool
+}
+`
+
+	testFile := filepath.Join(tmpDir, "test.go")
+	err := os.WriteFile(testFile, []byte(testCode), 0o644)
+	require.NoError(t, err)
+
+	// Generate lens code
+	outputFile := "gen_lens.go"
+	err = generateLensHelpers(tmpDir, outputFile, false, false)
+	require.NoError(t, err)
+
+	// Verify the generated file exists
+	genPath := filepath.Join(tmpDir, outputFile)
+	_, err = os.Stat(genPath)
+	require.NoError(t, err)
+
+	// Read and verify the generated content
+	content, err := os.ReadFile(genPath)
+	require.NoError(t, err)
+
+	contentStr := string(content)
+
+	// Check for expected content
+	assert.Contains(t, contentStr, "package testpkg")
+	assert.Contains(t, contentStr, "ExtendedConfigLenses")
+
+	// Check that lenses are generated for embedded unexported fields
+	assert.Contains(t, contentStr, "publicBase __lens.Lens[ExtendedConfig, string]")
+	assert.Contains(t, contentStr, "privateBase __lens.Lens[ExtendedConfig, int]")
+
+	// Check that lenses are generated for direct fields (both exported and unexported)
+	assert.Contains(t, contentStr, "PublicField __lens.Lens[ExtendedConfig, string]")
+	assert.Contains(t, contentStr, "privateField __lens.Lens[ExtendedConfig, bool]")
+}
+
+func TestParseFileWithMixedFieldVisibility(t *testing.T) {
+	// Create a temporary test file with various field visibility patterns
+	tmpDir := t.TempDir()
+	testFile := filepath.Join(tmpDir, "test.go")
+
+	testCode := `package testpkg
+
+// fp-go:Lens
+type ComplexStruct struct {
+	// Exported fields
+	Name        string
+	Age         int
+	Email       *string
+	
+	// Unexported fields
+	password    string
+	secretKey   []byte
+	internalID  *int
+	
+	// Mixed with tags
+	PublicWithTag  string ` + "`json:\"public,omitempty\"`" + `
+	privateWithTag int    ` + "`json:\"private,omitempty\"`" + `
+}
+`
+
+	err := os.WriteFile(testFile, []byte(testCode), 0o644)
+	require.NoError(t, err)
+
+	// Parse the file
+	structs, pkg, err := parseFile(testFile)
+	require.NoError(t, err)
+
+	// Verify results
+	assert.Equal(t, "testpkg", pkg)
+	assert.Len(t, structs, 1)
+
+	// Check ComplexStruct
+	complex := structs[0]
+	assert.Equal(t, "ComplexStruct", complex.Name)
+	assert.Len(t, complex.Fields, 8, "Should include all fields regardless of visibility")
+
+	// Verify field names and types
+	fieldNames := []string{"Name", "Age", "Email", "password", "secretKey", "internalID", "PublicWithTag", "privateWithTag"}
+	for i, expectedName := range fieldNames {
+		assert.Equal(t, expectedName, complex.Fields[i].Name, "Field %d should be %s", i, expectedName)
+	}
+
+	// Check optional fields
+	assert.False(t, complex.Fields[0].IsOptional, "Name should not be optional")
+	assert.True(t, complex.Fields[2].IsOptional, "Email (pointer) should be optional")
+	assert.True(t, complex.Fields[5].IsOptional, "internalID (pointer) should be optional")
+	assert.True(t, complex.Fields[6].IsOptional, "PublicWithTag (with omitempty) should be optional")
+	assert.True(t, complex.Fields[7].IsOptional, "privateWithTag (with omitempty) should be optional")
+}

v2/cli/option.go

@@ -16,13 +16,14 @@
 package cli
 
 import (
+	"context"
 	"fmt"
 	"log"
 	"os"
 	"path/filepath"
 	"time"
 
-	C "github.com/urfave/cli/v2"
+	C "github.com/urfave/cli/v3"
 )
 
 func optionHKT(typeA string) string {
@@ -200,10 +201,10 @@ func OptionCommand() *C.Command {
 			flagCount,
 			flagFilename,
 		},
-		Action: func(ctx *C.Context) error {
+		Action: func(ctx context.Context, cmd *C.Command) error {
 			return generateOptionHelpers(
-				ctx.String(keyFilename),
-				ctx.Int(keyCount),
+				cmd.String(keyFilename),
+				cmd.Int(keyCount),
 			)
 		},
 	}

v2/cli/pipe.go

@@ -16,13 +16,14 @@
 package cli
 
 import (
+	"context"
 	"fmt"
 	"log"
 	"os"
 	"path/filepath"
 	"time"
 
-	C "github.com/urfave/cli/v2"
+	C "github.com/urfave/cli/v3"
 )
 
 func generateUnsliced(f *os.File, i int) {
@@ -423,10 +424,10 @@ func PipeCommand() *C.Command {
 			flagCount,
 			flagFilename,
 		},
-		Action: func(ctx *C.Context) error {
+		Action: func(ctx context.Context, cmd *C.Command) error {
 			return generatePipeHelpers(
-				ctx.String(keyFilename),
-				ctx.Int(keyCount),
+				cmd.String(keyFilename),
+				cmd.Int(keyCount),
 			)
 		},
 	}

v2/cli/reader.go

@@ -16,13 +16,14 @@
 package cli
 
 import (
+	"context"
 	"fmt"
 	"log"
 	"os"
 	"path/filepath"
 	"time"
 
-	C "github.com/urfave/cli/v2"
+	C "github.com/urfave/cli/v3"
 )
 
 func generateReaderFrom(f, fg *os.File, i int) {
@@ -154,10 +155,10 @@ func ReaderCommand() *C.Command {
 			flagCount,
 			flagFilename,
 		},
-		Action: func(ctx *C.Context) error {
+		Action: func(ctx context.Context, cmd *C.Command) error {
 			return generateReaderHelpers(
-				ctx.String(keyFilename),
-				ctx.Int(keyCount),
+				cmd.String(keyFilename),
+				cmd.Int(keyCount),
 			)
 		},
 	}

v2/cli/readerioeither.go

@@ -16,13 +16,14 @@
 package cli
 
 import (
+	"context"
 	"fmt"
 	"log"
 	"os"
 	"path/filepath"
 	"time"
 
-	C "github.com/urfave/cli/v2"
+	C "github.com/urfave/cli/v3"
 )
 
 func generateReaderIOEitherFrom(f, fg *os.File, i int) {
@@ -284,10 +285,10 @@ func ReaderIOEitherCommand() *C.Command {
 			flagCount,
 			flagFilename,
 		},
-		Action: func(ctx *C.Context) error {
+		Action: func(ctx context.Context, cmd *C.Command) error {
 			return generateReaderIOEitherHelpers(
-				ctx.String(keyFilename),
-				ctx.Int(keyCount),
+				cmd.String(keyFilename),
+				cmd.Int(keyCount),
 			)
 		},
 	}

v2/cli/tuple.go

@@ -16,6 +16,7 @@
 package cli
 
 import (
+	"context"
 	"fmt"
 	"log"
 	"os"
@@ -23,7 +24,7 @@ import (
 	"strings"
 	"time"
 
-	C "github.com/urfave/cli/v2"
+	C "github.com/urfave/cli/v3"
 )
 
 func writeTupleType(f *os.File, symbol string, i int) {
@@ -615,10 +616,10 @@ func TupleCommand() *C.Command {
 			flagCount,
 			flagFilename,
 		},
-		Action: func(ctx *C.Context) error {
+		Action: func(ctx context.Context, cmd *C.Command) error {
 			return generateTupleHelpers(
-				ctx.String(keyFilename),
-				ctx.Int(keyCount),
+				cmd.String(keyFilename),
+				cmd.Int(keyCount),
 			)
 		},
 	}

v2/consumer/consumer.go

@@ -177,3 +177,255 @@ func Local[R1, R2 any](f func(R2) R1) Operator[R1, R2] {
 		}
 	}
 }
+
+// Compose is an alias for Local that emphasizes the composition aspect of consumer transformation.
+// It composes a preprocessing function with a consumer, creating a new consumer that applies
+// the function before consuming the value.
+//
+// This function is semantically identical to Local but uses terminology that may be more familiar
+// to developers coming from functional programming backgrounds where "compose" is a common operation.
+//
+// See: https://github.com/fantasyland/fantasy-land?tab=readme-ov-file#profunctor
+//
+// The name "Compose" highlights that we're composing two operations:
+//  1. The transformation function f: R2 -> R1
+//  2. The consumer c: R1 -> ()
+//
+// Result: A composed consumer: R2 -> ()
+//
+// Type Parameters:
+//   - R1: The input type of the original Consumer (what it expects)
+//   - R2: The input type of the new Consumer (what you have)
+//
+// Parameters:
+//   - f: A function that converts R2 to R1 (preprocessing function)
+//
+// Returns:
+//   - An Operator that transforms Consumer[R1] into Consumer[R2]
+//
+// Example - Basic composition:
+//
+//	// Consumer that logs integers
+//	logInt := func(x int) {
+//	    fmt.Printf("Value: %d\n", x)
+//	}
+//
+//	// Compose with a string-to-int parser
+//	parseToInt := func(s string) int {
+//	    n, _ := strconv.Atoi(s)
+//	    return n
+//	}
+//
+//	logString := consumer.Compose(parseToInt)(logInt)
+//	logString("42") // Logs: "Value: 42"
+//
+// Example - Composing multiple transformations:
+//
+//	type Data struct {
+//	    Value string
+//	}
+//
+//	type Wrapper struct {
+//	    Data Data
+//	}
+//
+//	// Consumer that logs strings
+//	logString := func(s string) {
+//	    fmt.Println(s)
+//	}
+//
+//	// Compose transformations step by step
+//	extractData := func(w Wrapper) Data { return w.Data }
+//	extractValue := func(d Data) string { return d.Value }
+//
+//	logData := consumer.Compose(extractValue)(logString)
+//	logWrapper := consumer.Compose(extractData)(logData)
+//
+//	logWrapper(Wrapper{Data: Data{Value: "Hello"}}) // Logs: "Hello"
+//
+// Example - Function composition style:
+//
+//	// Compose is particularly useful when thinking in terms of function composition
+//	type Request struct {
+//	    Body []byte
+//	}
+//
+//	// Consumer that processes strings
+//	processString := func(s string) {
+//	    fmt.Printf("Processing: %s\n", s)
+//	}
+//
+//	// Compose byte-to-string conversion with processing
+//	bytesToString := func(b []byte) string {
+//	    return string(b)
+//	}
+//	extractBody := func(r Request) []byte {
+//	    return r.Body
+//	}
+//
+//	// Chain compositions
+//	processBytes := consumer.Compose(bytesToString)(processString)
+//	processRequest := consumer.Compose(extractBody)(processBytes)
+//
+//	processRequest(Request{Body: []byte("test")}) // Logs: "Processing: test"
+//
+// Relationship to Local:
+//   - Compose and Local are identical in implementation
+//   - Compose emphasizes the functional composition aspect
+//   - Local emphasizes the environment/context transformation aspect
+//   - Use Compose when thinking about function composition
+//   - Use Local when thinking about adapting to different contexts
+//
+// Use Cases:
+//   - Building processing pipelines with clear composition semantics
+//   - Adapting consumers in a functional programming style
+//   - Creating reusable consumer transformations
+//   - Chaining multiple preprocessing steps
+func Compose[R1, R2 any](f func(R2) R1) Operator[R1, R2] {
+	return Local(f)
+}
+
+// Contramap is the categorical name for the contravariant functor operation on Consumers.
+// It transforms a Consumer by preprocessing its input, making it the dual of the covariant
+// functor's map operation.
+//
+// See: https://github.com/fantasyland/fantasy-land?tab=readme-ov-file#contravariant
+//
+// In category theory, a contravariant functor reverses the direction of morphisms.
+// While a covariant functor maps f: A -> B to map(f): F[A] -> F[B],
+// a contravariant functor maps f: A -> B to contramap(f): F[B] -> F[A].
+//
+// For Consumers:
+//   - Consumer[A] is contravariant in A
+//   - Given f: R2 -> R1, contramap(f) transforms Consumer[R1] to Consumer[R2]
+//   - The direction is reversed: we go from Consumer[R1] to Consumer[R2]
+//
+// This is semantically identical to Local and Compose, but uses the standard
+// categorical terminology that emphasizes the contravariant nature of the transformation.
+//
+// Type Parameters:
+//   - R1: The input type of the original Consumer (what it expects)
+//   - R2: The input type of the new Consumer (what you have)
+//
+// Parameters:
+//   - f: A function that converts R2 to R1 (preprocessing function)
+//
+// Returns:
+//   - An Operator that transforms Consumer[R1] into Consumer[R2]
+//
+// Example - Basic contravariant mapping:
+//
+//	// Consumer that logs integers
+//	logInt := func(x int) {
+//	    fmt.Printf("Value: %d\n", x)
+//	}
+//
+//	// Contramap with a string-to-int parser
+//	parseToInt := func(s string) int {
+//	    n, _ := strconv.Atoi(s)
+//	    return n
+//	}
+//
+//	logString := consumer.Contramap(parseToInt)(logInt)
+//	logString("42") // Logs: "Value: 42"
+//
+// Example - Demonstrating contravariance:
+//
+//	// In covariant functors (like Option, Array), map goes "forward":
+//	// map: (A -> B) -> F[A] -> F[B]
+//	//
+//	// In contravariant functors (like Consumer), contramap goes "backward":
+//	// contramap: (B -> A) -> F[A] -> F[B]
+//
+//	type Animal struct{ Name string }
+//	type Dog struct{ Animal Animal; Breed string }
+//
+//	// Consumer for animals
+//	consumeAnimal := func(a Animal) {
+//	    fmt.Printf("Animal: %s\n", a.Name)
+//	}
+//
+//	// Function from Dog to Animal (B -> A)
+//	dogToAnimal := func(d Dog) Animal {
+//	    return d.Animal
+//	}
+//
+//	// Contramap creates Consumer[Dog] from Consumer[Animal]
+//	// Direction is reversed: Consumer[Animal] -> Consumer[Dog]
+//	consumeDog := consumer.Contramap(dogToAnimal)(consumeAnimal)
+//
+//	consumeDog(Dog{
+//	    Animal: Animal{Name: "Buddy"},
+//	    Breed:  "Golden Retriever",
+//	}) // Logs: "Animal: Buddy"
+//
+// Example - Contravariant functor laws:
+//
+//	// Law 1: Identity
+//	// contramap(identity) = identity
+//	identity := func(x int) int { return x }
+//	consumer1 := consumer.Contramap(identity)(consumeInt)
+//	// consumer1 behaves identically to consumeInt
+//
+//	// Law 2: Composition
+//	// contramap(f . g) = contramap(g) . contramap(f)
+//	// Note: composition order is reversed compared to covariant map
+//	f := func(s string) int { n, _ := strconv.Atoi(s); return n }
+//	g := func(b bool) string { if b { return "1" } else { return "0" } }
+//
+//	// These two are equivalent:
+//	consumer2 := consumer.Contramap(func(b bool) int { return f(g(b)) })(consumeInt)
+//	consumer3 := consumer.Contramap(g)(consumer.Contramap(f)(consumeInt))
+//
+// Example - Practical use with type hierarchies:
+//
+//	type Logger interface {
+//	    Log(string)
+//	}
+//
+//	type Message struct {
+//	    Text      string
+//	    Timestamp time.Time
+//	}
+//
+//	// Consumer that logs strings
+//	logString := func(s string) {
+//	    fmt.Println(s)
+//	}
+//
+//	// Contramap to handle Message types
+//	extractText := func(m Message) string {
+//	    return fmt.Sprintf("[%s] %s", m.Timestamp.Format(time.RFC3339), m.Text)
+//	}
+//
+//	logMessage := consumer.Contramap(extractText)(logString)
+//	logMessage(Message{
+//	    Text:      "Hello",
+//	    Timestamp: time.Now(),
+//	}) // Logs: "[2024-01-20T10:00:00Z] Hello"
+//
+// Relationship to Local and Compose:
+//   - Contramap, Local, and Compose are identical in implementation
+//   - Contramap emphasizes the categorical/theoretical aspect
+//   - Local emphasizes the context transformation aspect
+//   - Compose emphasizes the function composition aspect
+//   - Use Contramap when working with category theory concepts
+//   - Use Local when adapting to different contexts
+//   - Use Compose when building functional pipelines
+//
+// Category Theory Background:
+//   - Consumer[A] forms a contravariant functor
+//   - The contravariant functor laws must hold:
+//     1. contramap(id) = id
+//     2. contramap(f ∘ g) = contramap(g) ∘ contramap(f)
+//   - This is dual to the covariant functor (map) operation
+//   - Consumers are contravariant because they consume rather than produce values
+//
+// Use Cases:
+//   - Working with contravariant functors in a categorical style
+//   - Adapting consumers to work with more specific types
+//   - Building type-safe consumer transformations
+//   - Implementing profunctor patterns (Consumer is a profunctor)
+func Contramap[R1, R2 any](f func(R2) R1) Operator[R1, R2] {
+	return Local(f)
+}

v2/consumer/consumer_test.go

@@ -381,3 +381,513 @@ func TestLocal(t *testing.T) {
 		assert.Equal(t, 42, captured)
 	})
 }
+
+func TestContramap(t *testing.T) {
+	t.Run("basic contravariant mapping", func(t *testing.T) {
+		var captured int
+		consumeInt := func(x int) {
+			captured = x
+		}
+
+		parseToInt := func(s string) int {
+			n, _ := strconv.Atoi(s)
+			return n
+		}
+
+		consumeString := Contramap(parseToInt)(consumeInt)
+		consumeString("42")
+
+		assert.Equal(t, 42, captured)
+	})
+
+	t.Run("contravariant identity law", func(t *testing.T) {
+		// contramap(identity) = identity
+		var captured int
+		consumeInt := func(x int) {
+			captured = x
+		}
+
+		identity := function.Identity[int]
+		consumeIdentity := Contramap(identity)(consumeInt)
+
+		consumeIdentity(42)
+		assert.Equal(t, 42, captured)
+
+		// Should behave identically to original consumer
+		consumeInt(100)
+		capturedDirect := captured
+		consumeIdentity(100)
+		capturedMapped := captured
+
+		assert.Equal(t, capturedDirect, capturedMapped)
+	})
+
+	t.Run("contravariant composition law", func(t *testing.T) {
+		// contramap(f . g) = contramap(g) . contramap(f)
+		var captured int
+		consumeInt := func(x int) {
+			captured = x
+		}
+
+		f := func(s string) int {
+			n, _ := strconv.Atoi(s)
+			return n
+		}
+
+		g := func(b bool) string {
+			if b {
+				return "1"
+			}
+			return "0"
+		}
+
+		// Compose f and g manually
+		fg := func(b bool) int {
+			return f(g(b))
+		}
+
+		// Method 1: contramap(f . g)
+		consumer1 := Contramap(fg)(consumeInt)
+		consumer1(true)
+		result1 := captured
+
+		// Method 2: contramap(g) . contramap(f)
+		consumer2 := Contramap(g)(Contramap(f)(consumeInt))
+		consumer2(true)
+		result2 := captured
+
+		assert.Equal(t, result1, result2)
+		assert.Equal(t, 1, result1)
+	})
+
+	t.Run("type hierarchy adaptation", func(t *testing.T) {
+		type Animal struct {
+			Name string
+		}
+
+		type Dog struct {
+			Animal Animal
+			Breed  string
+		}
+
+		var capturedName string
+		consumeAnimal := func(a Animal) {
+			capturedName = a.Name
+		}
+
+		dogToAnimal := func(d Dog) Animal {
+			return d.Animal
+		}
+
+		consumeDog := Contramap(dogToAnimal)(consumeAnimal)
+		consumeDog(Dog{
+			Animal: Animal{Name: "Buddy"},
+			Breed:  "Golden Retriever",
+		})
+
+		assert.Equal(t, "Buddy", capturedName)
+	})
+
+	t.Run("field extraction with contramap", func(t *testing.T) {
+		type Message struct {
+			Text      string
+			Timestamp time.Time
+		}
+
+		var capturedText string
+		consumeString := func(s string) {
+			capturedText = s
+		}
+
+		extractText := func(m Message) string {
+			return m.Text
+		}
+
+		consumeMessage := Contramap(extractText)(consumeString)
+		consumeMessage(Message{
+			Text:      "Hello",
+			Timestamp: time.Now(),
+		})
+
+		assert.Equal(t, "Hello", capturedText)
+	})
+
+	t.Run("multiple contramap applications", func(t *testing.T) {
+		type Level3 struct{ Value int }
+		type Level2 struct{ L3 Level3 }
+		type Level1 struct{ L2 Level2 }
+
+		var captured int
+		consumeInt := func(x int) {
+			captured = x
+		}
+
+		extract3 := func(l3 Level3) int { return l3.Value }
+		extract2 := func(l2 Level2) Level3 { return l2.L3 }
+		extract1 := func(l1 Level1) Level2 { return l1.L2 }
+
+		// Chain contramap operations
+		consumeLevel3 := Contramap(extract3)(consumeInt)
+		consumeLevel2 := Contramap(extract2)(consumeLevel3)
+		consumeLevel1 := Contramap(extract1)(consumeLevel2)
+
+		consumeLevel1(Level1{L2: Level2{L3: Level3{Value: 42}}})
+
+		assert.Equal(t, 42, captured)
+	})
+
+	t.Run("contramap with calculation", func(t *testing.T) {
+		type Rectangle struct {
+			Width  int
+			Height int
+		}
+
+		var capturedArea int
+		consumeArea := func(area int) {
+			capturedArea = area
+		}
+
+		calculateArea := func(r Rectangle) int {
+			return r.Width * r.Height
+		}
+
+		consumeRectangle := Contramap(calculateArea)(consumeArea)
+		consumeRectangle(Rectangle{Width: 5, Height: 10})
+
+		assert.Equal(t, 50, capturedArea)
+	})
+
+	t.Run("contramap preserves side effects", func(t *testing.T) {
+		callCount := 0
+		consumer := func(x int) {
+			callCount++
+		}
+
+		transform := func(s string) int {
+			n, _ := strconv.Atoi(s)
+			return n
+		}
+
+		contramappedConsumer := Contramap(transform)(consumer)
+
+		contramappedConsumer("1")
+		contramappedConsumer("2")
+		contramappedConsumer("3")
+
+		assert.Equal(t, 3, callCount)
+	})
+
+	t.Run("contramap with pointer types", func(t *testing.T) {
+		var captured int
+		consumeInt := func(x int) {
+			captured = x
+		}
+
+		dereference := func(p *int) int {
+			if p == nil {
+				return 0
+			}
+			return *p
+		}
+
+		consumePointer := Contramap(dereference)(consumeInt)
+
+		value := 42
+		consumePointer(&value)
+		assert.Equal(t, 42, captured)
+
+		consumePointer(nil)
+		assert.Equal(t, 0, captured)
+	})
+
+	t.Run("contramap equivalence with Local", func(t *testing.T) {
+		var capturedLocal, capturedContramap int
+
+		consumeIntLocal := func(x int) {
+			capturedLocal = x
+		}
+
+		consumeIntContramap := func(x int) {
+			capturedContramap = x
+		}
+
+		transform := func(s string) int {
+			n, _ := strconv.Atoi(s)
+			return n
+		}
+
+		// Both should produce identical results
+		consumerLocal := Local(transform)(consumeIntLocal)
+		consumerContramap := Contramap(transform)(consumeIntContramap)
+
+		consumerLocal("42")
+		consumerContramap("42")
+
+		assert.Equal(t, capturedLocal, capturedContramap)
+		assert.Equal(t, 42, capturedLocal)
+	})
+}
+
+func TestCompose(t *testing.T) {
+	t.Run("basic composition", func(t *testing.T) {
+		var captured int
+		consumeInt := func(x int) {
+			captured = x
+		}
+
+		parseToInt := func(s string) int {
+			n, _ := strconv.Atoi(s)
+			return n
+		}
+
+		consumeString := Compose(parseToInt)(consumeInt)
+		consumeString("42")
+
+		assert.Equal(t, 42, captured)
+	})
+
+	t.Run("composing multiple transformations", func(t *testing.T) {
+		type Data struct {
+			Value string
+		}
+
+		type Wrapper struct {
+			Data Data
+		}
+
+		var captured string
+		consumeString := func(s string) {
+			captured = s
+		}
+
+		extractData := func(w Wrapper) Data { return w.Data }
+		extractValue := func(d Data) string { return d.Value }
+
+		// Compose step by step
+		consumeData := Compose(extractValue)(consumeString)
+		consumeWrapper := Compose(extractData)(consumeData)
+
+		consumeWrapper(Wrapper{Data: Data{Value: "Hello"}})
+
+		assert.Equal(t, "Hello", captured)
+	})
+
+	t.Run("function composition style", func(t *testing.T) {
+		type Request struct {
+			Body []byte
+		}
+
+		var captured string
+		processString := func(s string) {
+			captured = s
+		}
+
+		bytesToString := func(b []byte) string {
+			return string(b)
+		}
+
+		extractBody := func(r Request) []byte {
+			return r.Body
+		}
+
+		// Chain compositions
+		processBytes := Compose(bytesToString)(processString)
+		processRequest := Compose(extractBody)(processBytes)
+
+		processRequest(Request{Body: []byte("test")})
+
+		assert.Equal(t, "test", captured)
+	})
+
+	t.Run("compose with identity", func(t *testing.T) {
+		var captured int
+		consumeInt := func(x int) {
+			captured = x
+		}
+
+		identity := function.Identity[int]
+		composedConsumer := Compose(identity)(consumeInt)
+
+		composedConsumer(42)
+		assert.Equal(t, 42, captured)
+	})
+
+	t.Run("compose with field extraction", func(t *testing.T) {
+		type User struct {
+			Name  string
+			Email string
+			Age   int
+		}
+
+		var capturedName string
+		consumeName := func(name string) {
+			capturedName = name
+		}
+
+		extractName := func(u User) string {
+			return u.Name
+		}
+
+		consumeUser := Compose(extractName)(consumeName)
+		consumeUser(User{Name: "Alice", Email: "alice@example.com", Age: 30})
+
+		assert.Equal(t, "Alice", capturedName)
+	})
+
+	t.Run("compose with calculation", func(t *testing.T) {
+		type Circle struct {
+			Radius float64
+		}
+
+		var capturedArea float64
+		consumeArea := func(area float64) {
+			capturedArea = area
+		}
+
+		calculateArea := func(c Circle) float64 {
+			return 3.14159 * c.Radius * c.Radius
+		}
+
+		consumeCircle := Compose(calculateArea)(consumeArea)
+		consumeCircle(Circle{Radius: 5.0})
+
+		assert.InDelta(t, 78.53975, capturedArea, 0.00001)
+	})
+
+	t.Run("compose with slice operations", func(t *testing.T) {
+		var captured int
+		consumeLength := func(n int) {
+			captured = n
+		}
+
+		getLength := func(s []string) int {
+			return len(s)
+		}
+
+		consumeSlice := Compose(getLength)(consumeLength)
+		consumeSlice([]string{"a", "b", "c", "d"})
+
+		assert.Equal(t, 4, captured)
+	})
+
+	t.Run("compose with map operations", func(t *testing.T) {
+		var captured bool
+		consumeHasKey := func(has bool) {
+			captured = has
+		}
+
+		hasKey := func(m map[string]int) bool {
+			_, exists := m["key"]
+			return exists
+		}
+
+		consumeMap := Compose(hasKey)(consumeHasKey)
+
+		consumeMap(map[string]int{"key": 42})
+		assert.True(t, captured)
+
+		consumeMap(map[string]int{"other": 42})
+		assert.False(t, captured)
+	})
+
+	t.Run("compose preserves consumer behavior", func(t *testing.T) {
+		callCount := 0
+		consumer := func(x int) {
+			callCount++
+		}
+
+		transform := func(s string) int {
+			n, _ := strconv.Atoi(s)
+			return n
+		}
+
+		composedConsumer := Compose(transform)(consumer)
+
+		composedConsumer("1")
+		composedConsumer("2")
+		composedConsumer("3")
+
+		assert.Equal(t, 3, callCount)
+	})
+
+	t.Run("compose with error handling", func(t *testing.T) {
+		type Result struct {
+			Value int
+			Error error
+		}
+
+		var captured int
+		consumeInt := func(x int) {
+			captured = x
+		}
+
+		extractValue := func(r Result) int {
+			if r.Error != nil {
+				return -1
+			}
+			return r.Value
+		}
+
+		consumeResult := Compose(extractValue)(consumeInt)
+
+		consumeResult(Result{Value: 42, Error: nil})
+		assert.Equal(t, 42, captured)
+
+		consumeResult(Result{Value: 100, Error: assert.AnError})
+		assert.Equal(t, -1, captured)
+	})
+
+	t.Run("compose equivalence with Local", func(t *testing.T) {
+		var capturedLocal, capturedCompose int
+
+		consumeIntLocal := func(x int) {
+			capturedLocal = x
+		}
+
+		consumeIntCompose := func(x int) {
+			capturedCompose = x
+		}
+
+		transform := func(s string) int {
+			n, _ := strconv.Atoi(s)
+			return n
+		}
+
+		// Both should produce identical results
+		consumerLocal := Local(transform)(consumeIntLocal)
+		consumerCompose := Compose(transform)(consumeIntCompose)
+
+		consumerLocal("42")
+		consumerCompose("42")
+
+		assert.Equal(t, capturedLocal, capturedCompose)
+		assert.Equal(t, 42, capturedLocal)
+	})
+
+	t.Run("compose equivalence with Contramap", func(t *testing.T) {
+		var capturedCompose, capturedContramap int
+
+		consumeIntCompose := func(x int) {
+			capturedCompose = x
+		}
+
+		consumeIntContramap := func(x int) {
+			capturedContramap = x
+		}
+
+		transform := func(s string) int {
+			n, _ := strconv.Atoi(s)
+			return n
+		}
+
+		// All three should produce identical results
+		consumerCompose := Compose(transform)(consumeIntCompose)
+		consumerContramap := Contramap(transform)(consumeIntContramap)
+
+		consumerCompose("42")
+		consumerContramap("42")
+
+		assert.Equal(t, capturedCompose, capturedContramap)
+		assert.Equal(t, 42, capturedCompose)
+	})
+}

v2/context/ioresult/ioeither.go

@@ -44,7 +44,7 @@ import (
 //	    return result.Of("done")
 //	}
 //
-//	ctx, cancel := context.WithCancel(context.Background())
+//	ctx, cancel := context.WithCancel(t.Context())
 //	cancel() // Cancel immediately
 //
 //	wrapped := WithContext(ctx, computation)

v2/context/readerio/bracket.go

@@ -61,7 +61,7 @@ import (
 //
 //	// Safely read file with automatic cleanup
 //	safeRead := Bracket(acquireFile, readFile, closeFile)
-//	result := safeRead(context.Background())()
+//	result := safeRead(t.Context())()
 //
 //go:inline
 func Bracket[

v2/context/readerio/flip.go

@@ -50,7 +50,7 @@ import (
 //	// Sequence it to apply Config first
 //	sequenced := SequenceReader[Config, int](getMultiplier)
 //	cfg := Config{Timeout: 30}
-//	result := sequenced(cfg)(context.Background())() // Returns 60
+//	result := sequenced(cfg)(t.Context())() // Returns 60
 //
 //go:inline
 func SequenceReader[R, A any](ma ReaderIO[Reader[R, A]]) Reader[R, ReaderIO[A]] {
@@ -107,7 +107,7 @@ func SequenceReader[R, A any](ma ReaderIO[Reader[R, A]]) Reader[R, ReaderIO[A]]
 //
 //	// Provide Config to get final result
 //	cfg := Config{Multiplier: 5}
-//	finalResult := result(cfg)(context.Background())() // Returns 50
+//	finalResult := result(cfg)(t.Context())() // Returns 50
 //
 //go:inline
 func TraverseReader[R, A, B any](

v2/context/readerio/logging.go

@@ -81,7 +81,7 @@ func SLogWithCallback[A any](
 //	    Chain(SLog[string]("Extracted name")),
 //	)
 //
-//	result := pipeline(context.Background())()
+//	result := pipeline(t.Context())()
 //	// Logs: "Fetched user" value={ID:123 Name:"Alice"}
 //	// Logs: "Extracted name" value="Alice"
 //

v2/context/readerio/profunctor_test.go

@@ -45,7 +45,7 @@ func TestPromapBasic(t *testing.T) {
 		toString := strconv.Itoa
 
 		adapted := Promap(addKey, toString)(getValue)
-		result := adapted(context.Background())()
+		result := adapted(t.Context())()
 
 		assert.Equal(t, "42", result)
 	})
@@ -69,7 +69,7 @@ func TestContramapBasic(t *testing.T) {
 		}
 
 		adapted := Contramap[int](addKey)(getValue)
-		result := adapted(context.Background())()
+		result := adapted(t.Context())()
 
 		assert.Equal(t, 100, result)
 	})
@@ -90,7 +90,7 @@ func TestLocalBasic(t *testing.T) {
 		}
 
 		adapted := Local[bool](addTimeout)(getValue)
-		result := adapted(context.Background())()
+		result := adapted(t.Context())()
 
 		assert.True(t, result)
 	})

v2/context/readerio/reader.go

@@ -594,7 +594,7 @@ func Read[A any](r context.Context) func(ReaderIO[A]) IO[A] {
 //	)
 //
 //	// Create context with side effects (e.g., loading config)
-//	createContext := G.Of(context.WithValue(context.Background(), "key", "value"))
+//	createContext := G.Of(context.WithValue(t.Context(), "key", "value"))
 //
 //	// A computation that uses the context
 //	getValue := readerio.FromReader(func(ctx context.Context) string {
@@ -664,7 +664,7 @@ func ReadIO[A any](r IO[context.Context]) func(ReaderIO[A]) IO[A] {
 //	    getUser,
 //	    addUser,
 //	)
-//	user := result(context.Background())()  // Returns "Alice"
+//	user := result(t.Context())()  // Returns "Alice"
 //
 // Timeout Example:
 //
@@ -731,7 +731,7 @@ func Local[A any](f func(context.Context) (context.Context, context.CancelFunc))
 //	    fetchData,
 //	    readerio.WithTimeout[Data](5*time.Second),
 //	)
-//	data := result(context.Background())()  // Returns Data{} after 5s timeout
+//	data := result(t.Context())()  // Returns Data{} after 5s timeout
 //
 // Successful Example:
 //
@@ -740,7 +740,7 @@ func Local[A any](f func(context.Context) (context.Context, context.CancelFunc))
 //	    quickFetch,
 //	    readerio.WithTimeout[Data](5*time.Second),
 //	)
-//	data := result(context.Background())()  // Returns Data{Value: "quick"}
+//	data := result(t.Context())()  // Returns Data{Value: "quick"}
 func WithTimeout[A any](timeout time.Duration) Operator[A, A] {
 	return Local[A](func(ctx context.Context) (context.Context, context.CancelFunc) {
 		return context.WithTimeout(ctx, timeout)
@@ -791,12 +791,12 @@ func WithTimeout[A any](timeout time.Duration) Operator[A, A] {
 //	    fetchData,
 //	    readerio.WithDeadline[Data](deadline),
 //	)
-//	data := result(context.Background())()  // Returns Data{} if past deadline
+//	data := result(t.Context())()  // Returns Data{} if past deadline
 //
 // Combining with Parent Context:
 //
 //	// If parent context already has a deadline, the earlier one takes precedence
-//	parentCtx, cancel := context.WithDeadline(context.Background(), time.Now().Add(1*time.Hour))
+//	parentCtx, cancel := context.WithDeadline(t.Context(), time.Now().Add(1*time.Hour))
 //	defer cancel()
 //
 //	laterDeadline := time.Now().Add(2 * time.Hour)

v2/context/readerio/reader_test.go

@@ -31,7 +31,7 @@ func TestMonadMap(t *testing.T) {
 	rio := Of(5)
 	doubled := MonadMap(rio, N.Mul(2))
 
-	result := doubled(context.Background())()
+	result := doubled(t.Context())()
 	assert.Equal(t, 10, result)
 }
 
@@ -41,14 +41,14 @@ func TestMap(t *testing.T) {
 		Map(utils.Double),
 	)
 
-	assert.Equal(t, 2, g(context.Background())())
+	assert.Equal(t, 2, g(t.Context())())
 }
 
 func TestMonadMapTo(t *testing.T) {
 	rio := Of(42)
 	replaced := MonadMapTo(rio, "constant")
 
-	result := replaced(context.Background())()
+	result := replaced(t.Context())()
 	assert.Equal(t, "constant", result)
 }
 
@@ -58,7 +58,7 @@ func TestMapTo(t *testing.T) {
 		MapTo[int]("constant"),
 	)
 
-	assert.Equal(t, "constant", result(context.Background())())
+	assert.Equal(t, "constant", result(t.Context())())
 }
 
 func TestMonadChain(t *testing.T) {
@@ -67,7 +67,7 @@ func TestMonadChain(t *testing.T) {
 		return Of(n * 3)
 	})
 
-	assert.Equal(t, 15, result(context.Background())())
+	assert.Equal(t, 15, result(t.Context())())
 }
 
 func TestChain(t *testing.T) {
@@ -78,7 +78,7 @@ func TestChain(t *testing.T) {
 		}),
 	)
 
-	assert.Equal(t, 15, result(context.Background())())
+	assert.Equal(t, 15, result(t.Context())())
 }
 
 func TestMonadChainFirst(t *testing.T) {
@@ -89,7 +89,7 @@ func TestMonadChainFirst(t *testing.T) {
 		return Of("side effect")
 	})
 
-	value := result(context.Background())()
+	value := result(t.Context())()
 	assert.Equal(t, 42, value)
 	assert.Equal(t, 42, sideEffect)
 }
@@ -104,7 +104,7 @@ func TestChainFirst(t *testing.T) {
 		}),
 	)
 
-	value := result(context.Background())()
+	value := result(t.Context())()
 	assert.Equal(t, 42, value)
 	assert.Equal(t, 42, sideEffect)
 }
@@ -117,7 +117,7 @@ func TestMonadTap(t *testing.T) {
 		return Of(func() {})
 	})
 
-	value := result(context.Background())()
+	value := result(t.Context())()
 	assert.Equal(t, 42, value)
 	assert.Equal(t, 42, sideEffect)
 }
@@ -132,14 +132,14 @@ func TestTap(t *testing.T) {
 		}),
 	)
 
-	value := result(context.Background())()
+	value := result(t.Context())()
 	assert.Equal(t, 42, value)
 	assert.Equal(t, 42, sideEffect)
 }
 
 func TestOf(t *testing.T) {
 	rio := Of(100)
-	result := rio(context.Background())()
+	result := rio(t.Context())()
 
 	assert.Equal(t, 100, result)
 }
@@ -149,7 +149,7 @@ func TestMonadAp(t *testing.T) {
 	faIO := Of(5)
 	result := MonadAp(fabIO, faIO)
 
-	assert.Equal(t, 10, result(context.Background())())
+	assert.Equal(t, 10, result(t.Context())())
 }
 
 func TestAp(t *testing.T) {
@@ -158,7 +158,7 @@ func TestAp(t *testing.T) {
 		Ap[int](Of(1)),
 	)
 
-	assert.Equal(t, 2, g(context.Background())())
+	assert.Equal(t, 2, g(t.Context())())
 }
 
 func TestMonadApSeq(t *testing.T) {
@@ -166,7 +166,7 @@ func TestMonadApSeq(t *testing.T) {
 	faIO := Of(5)
 	result := MonadApSeq(fabIO, faIO)
 
-	assert.Equal(t, 15, result(context.Background())())
+	assert.Equal(t, 15, result(t.Context())())
 }
 
 func TestApSeq(t *testing.T) {
@@ -175,7 +175,7 @@ func TestApSeq(t *testing.T) {
 		ApSeq[int](Of(5)),
 	)
 
-	assert.Equal(t, 15, g(context.Background())())
+	assert.Equal(t, 15, g(t.Context())())
 }
 
 func TestMonadApPar(t *testing.T) {
@@ -183,7 +183,7 @@ func TestMonadApPar(t *testing.T) {
 	faIO := Of(5)
 	result := MonadApPar(fabIO, faIO)
 
-	assert.Equal(t, 15, result(context.Background())())
+	assert.Equal(t, 15, result(t.Context())())
 }
 
 func TestApPar(t *testing.T) {
@@ -192,12 +192,12 @@ func TestApPar(t *testing.T) {
 		ApPar[int](Of(5)),
 	)
 
-	assert.Equal(t, 15, g(context.Background())())
+	assert.Equal(t, 15, g(t.Context())())
 }
 
 func TestAsk(t *testing.T) {
 	rio := Ask()
-	ctx := context.WithValue(context.Background(), "key", "value")
+	ctx := context.WithValue(t.Context(), "key", "value")
 	result := rio(ctx)()
 
 	assert.Equal(t, ctx, result)
@@ -207,7 +207,7 @@ func TestFromIO(t *testing.T) {
 	ioAction := G.Of(42)
 	rio := FromIO(ioAction)
 
-	result := rio(context.Background())()
+	result := rio(t.Context())()
 	assert.Equal(t, 42, result)
 }
 
@@ -217,7 +217,7 @@ func TestFromReader(t *testing.T) {
 	}
 
 	rio := FromReader(rdr)
-	result := rio(context.Background())()
+	result := rio(t.Context())()
 
 	assert.Equal(t, 42, result)
 }
@@ -226,7 +226,7 @@ func TestFromLazy(t *testing.T) {
 	lazy := func() int { return 42 }
 	rio := FromLazy(lazy)
 
-	result := rio(context.Background())()
+	result := rio(t.Context())()
 	assert.Equal(t, 42, result)
 }
 
@@ -236,7 +236,7 @@ func TestMonadChainIOK(t *testing.T) {
 		return G.Of(n * 4)
 	})
 
-	assert.Equal(t, 20, result(context.Background())())
+	assert.Equal(t, 20, result(t.Context())())
 }
 
 func TestChainIOK(t *testing.T) {
@@ -247,7 +247,7 @@ func TestChainIOK(t *testing.T) {
 		}),
 	)
 
-	assert.Equal(t, 20, result(context.Background())())
+	assert.Equal(t, 20, result(t.Context())())
 }
 
 func TestMonadChainFirstIOK(t *testing.T) {
@@ -258,7 +258,7 @@ func TestMonadChainFirstIOK(t *testing.T) {
 		return G.Of("side effect")
 	})
 
-	value := result(context.Background())()
+	value := result(t.Context())()
 	assert.Equal(t, 42, value)
 	assert.Equal(t, 42, sideEffect)
 }
@@ -273,7 +273,7 @@ func TestChainFirstIOK(t *testing.T) {
 		}),
 	)
 
-	value := result(context.Background())()
+	value := result(t.Context())()
 	assert.Equal(t, 42, value)
 	assert.Equal(t, 42, sideEffect)
 }
@@ -286,7 +286,7 @@ func TestMonadTapIOK(t *testing.T) {
 		return G.Of(func() {})
 	})
 
-	value := result(context.Background())()
+	value := result(t.Context())()
 	assert.Equal(t, 42, value)
 	assert.Equal(t, 42, sideEffect)
 }
@@ -301,7 +301,7 @@ func TestTapIOK(t *testing.T) {
 		}),
 	)
 
-	value := result(context.Background())()
+	value := result(t.Context())()
 	assert.Equal(t, 42, value)
 	assert.Equal(t, 42, sideEffect)
 }
@@ -313,8 +313,8 @@ func TestDefer(t *testing.T) {
 		return Of(counter)
 	})
 
-	result1 := rio(context.Background())()
-	result2 := rio(context.Background())()
+	result1 := rio(t.Context())()
+	result2 := rio(t.Context())()
 
 	assert.Equal(t, 1, result1)
 	assert.Equal(t, 2, result2)
@@ -328,8 +328,8 @@ func TestMemoize(t *testing.T) {
 		return counter
 	}))
 
-	result1 := memoized(context.Background())()
-	result2 := memoized(context.Background())()
+	result1 := memoized(t.Context())()
+	result2 := memoized(t.Context())()
 
 	assert.Equal(t, 1, result1)
 	assert.Equal(t, 1, result2) // Same value, memoized
@@ -339,7 +339,7 @@ func TestFlatten(t *testing.T) {
 	nested := Of(Of(42))
 	flattened := Flatten(nested)
 
-	result := flattened(context.Background())()
+	result := flattened(t.Context())()
 	assert.Equal(t, 42, result)
 }
 
@@ -347,7 +347,7 @@ func TestMonadFlap(t *testing.T) {
 	fabIO := Of(N.Mul(3))
 	result := MonadFlap(fabIO, 7)
 
-	assert.Equal(t, 21, result(context.Background())())
+	assert.Equal(t, 21, result(t.Context())())
 }
 
 func TestFlap(t *testing.T) {
@@ -356,7 +356,7 @@ func TestFlap(t *testing.T) {
 		Flap[int](7),
 	)
 
-	assert.Equal(t, 21, result(context.Background())())
+	assert.Equal(t, 21, result(t.Context())())
 }
 
 func TestMonadChainReaderK(t *testing.T) {
@@ -365,7 +365,7 @@ func TestMonadChainReaderK(t *testing.T) {
 		return func(ctx context.Context) int { return n * 2 }
 	})
 
-	assert.Equal(t, 10, result(context.Background())())
+	assert.Equal(t, 10, result(t.Context())())
 }
 
 func TestChainReaderK(t *testing.T) {
@@ -376,7 +376,7 @@ func TestChainReaderK(t *testing.T) {
 		}),
 	)
 
-	assert.Equal(t, 10, result(context.Background())())
+	assert.Equal(t, 10, result(t.Context())())
 }
 
 func TestMonadChainFirstReaderK(t *testing.T) {
@@ -389,7 +389,7 @@ func TestMonadChainFirstReaderK(t *testing.T) {
 		}
 	})
 
-	value := result(context.Background())()
+	value := result(t.Context())()
 	assert.Equal(t, 42, value)
 	assert.Equal(t, 42, sideEffect)
 }
@@ -406,7 +406,7 @@ func TestChainFirstReaderK(t *testing.T) {
 		}),
 	)
 
-	value := result(context.Background())()
+	value := result(t.Context())()
 	assert.Equal(t, 42, value)
 	assert.Equal(t, 42, sideEffect)
 }
@@ -421,7 +421,7 @@ func TestMonadTapReaderK(t *testing.T) {
 		}
 	})
 
-	value := result(context.Background())()
+	value := result(t.Context())()
 	assert.Equal(t, 42, value)
 	assert.Equal(t, 42, sideEffect)
 }
@@ -438,14 +438,14 @@ func TestTapReaderK(t *testing.T) {
 		}),
 	)
 
-	value := result(context.Background())()
+	value := result(t.Context())()
 	assert.Equal(t, 42, value)
 	assert.Equal(t, 42, sideEffect)
 }
 
 func TestRead(t *testing.T) {
 	rio := Of(42)
-	ctx := context.Background()
+	ctx := t.Context()
 	ioAction := Read[int](ctx)(rio)
 	result := ioAction()
 
@@ -463,7 +463,7 @@ func TestComplexPipeline(t *testing.T) {
 		Map(N.Add(10)),
 	)
 
-	assert.Equal(t, 20, result(context.Background())()) // (5 * 2) + 10 = 20
+	assert.Equal(t, 20, result(t.Context())()) // (5 * 2) + 10 = 20
 }
 
 func TestFromIOWithChain(t *testing.T) {
@@ -476,7 +476,7 @@ func TestFromIOWithChain(t *testing.T) {
 		}),
 	)
 
-	assert.Equal(t, 15, result(context.Background())())
+	assert.Equal(t, 15, result(t.Context())())
 }
 
 func TestTapWithLogging(t *testing.T) {
@@ -496,14 +496,14 @@ func TestTapWithLogging(t *testing.T) {
 		}),
 	)
 
-	value := result(context.Background())()
+	value := result(t.Context())()
 	assert.Equal(t, 84, value)
 	assert.Equal(t, []int{42, 84}, logged)
 }
 
 func TestReadIO(t *testing.T) {
 	// Test basic ReadIO functionality
-	contextIO := G.Of(context.WithValue(context.Background(), "testKey", "testValue"))
+	contextIO := G.Of(context.WithValue(t.Context(), "testKey", "testValue"))
 	rio := FromReader(func(ctx context.Context) string {
 		if val := ctx.Value("testKey"); val != nil {
 			return val.(string)
@@ -519,7 +519,7 @@ func TestReadIO(t *testing.T) {
 
 func TestReadIOWithBackground(t *testing.T) {
 	// Test ReadIO with plain background context
-	contextIO := G.Of(context.Background())
+	contextIO := G.Of(t.Context())
 	rio := Of(42)
 
 	ioAction := ReadIO[int](contextIO)(rio)
@@ -530,7 +530,7 @@ func TestReadIOWithBackground(t *testing.T) {
 
 func TestReadIOWithChain(t *testing.T) {
 	// Test ReadIO with chained operations
-	contextIO := G.Of(context.WithValue(context.Background(), "multiplier", 3))
+	contextIO := G.Of(context.WithValue(t.Context(), "multiplier", 3))
 
 	result := F.Pipe1(
 		FromReader(func(ctx context.Context) int {
@@ -552,7 +552,7 @@ func TestReadIOWithChain(t *testing.T) {
 
 func TestReadIOWithMap(t *testing.T) {
 	// Test ReadIO with Map operations
-	contextIO := G.Of(context.Background())
+	contextIO := G.Of(t.Context())
 
 	result := F.Pipe2(
 		Of(5),
@@ -571,7 +571,7 @@ func TestReadIOWithSideEffects(t *testing.T) {
 	counter := 0
 	contextIO := func() context.Context {
 		counter++
-		return context.WithValue(context.Background(), "counter", counter)
+		return context.WithValue(t.Context(), "counter", counter)
 	}
 
 	rio := FromReader(func(ctx context.Context) int {
@@ -593,7 +593,7 @@ func TestReadIOMultipleExecutions(t *testing.T) {
 	counter := 0
 	contextIO := func() context.Context {
 		counter++
-		return context.Background()
+		return t.Context()
 	}
 
 	rio := Of(42)
@@ -609,7 +609,7 @@ func TestReadIOMultipleExecutions(t *testing.T) {
 
 func TestReadIOComparisonWithRead(t *testing.T) {
 	// Compare ReadIO with Read to show the difference
-	ctx := context.WithValue(context.Background(), "key", "value")
+	ctx := context.WithValue(t.Context(), "key", "value")
 
 	rio := FromReader(func(ctx context.Context) string {
 		if val := ctx.Value("key"); val != nil {
@@ -642,7 +642,7 @@ func TestReadIOWithComplexContext(t *testing.T) {
 
 	contextIO := G.Of(
 		context.WithValue(
-			context.WithValue(context.Background(), userKey, "Alice"),
+			context.WithValue(t.Context(), userKey, "Alice"),
 			tokenKey,
 			"secret123",
 		),
@@ -668,7 +668,7 @@ func TestReadIOWithComplexContext(t *testing.T) {
 
 func TestReadIOWithAsk(t *testing.T) {
 	// Test ReadIO combined with Ask
-	contextIO := G.Of(context.WithValue(context.Background(), "data", 100))
+	contextIO := G.Of(context.WithValue(t.Context(), "data", 100))
 
 	result := F.Pipe1(
 		Ask(),

v2/context/readerio/rec.go

@@ -53,7 +53,7 @@ import (
 //	}
 //
 //	countdown := TailRec(countdownStep)
-//	result := countdown(10)(context.Background())() // Returns "Done!"
+//	result := countdown(10)(t.Context())() // Returns "Done!"
 //
 // Example - Sum with context:
 //
@@ -77,7 +77,7 @@ import (
 //	}
 //
 //	sum := TailRec(sumStep)
-//	result := sum(SumState{numbers: []int{1, 2, 3, 4, 5}})(context.Background())()
+//	result := sum(SumState{numbers: []int{1, 2, 3, 4, 5}})(t.Context())()
 //	// Returns 15, safe even for very large slices
 //
 //go:inline

v2/context/readerio/retry.go

@@ -80,7 +80,7 @@ import (
 //	retryingFetch := Retrying(policy, fetchData, shouldRetry)
 //
 //	// Execute
-//	ctx := context.Background()
+//	ctx := t.Context()
 //	result := retryingFetch(ctx)() // Returns "success" after 3 attempts
 //
 //go:inline

v2/context/readerioresult/cancel.go

@@ -74,7 +74,7 @@ func WithContext[A any](ma ReaderIOResult[A]) ReaderIOResult[A] {
 //	safeFetch := WithContextK(fetchUser)
 //
 //	// If context is cancelled, returns immediately without executing fetchUser
-//	ctx, cancel := context.WithCancel(context.Background())
+//	ctx, cancel := context.WithCancel(t.Context())
 //	cancel() // Cancel immediately
 //	result := safeFetch(123)(ctx)() // Returns context.Canceled error
 //

v2/context/readerioresult/doc.go

@@ -113,7 +113,7 @@
 //	}
 //
 //	// Execute the computation
-//	ctx := context.Background()
+//	ctx := t.Context()
 //	result := fetchUser("123")(ctx)()
 //	// result is Either[error, User]
 //
@@ -161,7 +161,7 @@
 // All operations respect context cancellation. When a context is cancelled, operations
 // will return an error containing the cancellation cause:
 //
-//	ctx, cancel := context.WithCancelCause(context.Background())
+//	ctx, cancel := context.WithCancelCause(t.Context())
 //	cancel(errors.New("operation cancelled"))
 //	result := computation(ctx)() // Returns Left with cancellation error
 //

v2/context/readerioresult/eq.go

@@ -37,7 +37,7 @@ import (
 //	    return either.Eq(eq.FromEquals(func(x, y int) bool { return x == y }))(a, b)
 //	})
 //	eqRIE := Eq(eqInt)
-//	ctx := context.Background()
+//	ctx := t.Context()
 //	equal := eqRIE(ctx).Equals(Right[int](42), Right[int](42)) // true
 //
 //go:inline

v2/context/readerioresult/filter.go

@@ -43,7 +43,7 @@ import (
 //	onNegative := func(n int) error { return fmt.Errorf("%d is not positive", n) }
 //
 //	filter := readerioresult.FilterOrElse(isPositive, onNegative)
-//	result := filter(readerioresult.Right(42))(context.Background())()
+//	result := filter(readerioresult.Right(42))(t.Context())()
 //
 //go:inline
 func FilterOrElse[A any](pred Predicate[A], onFalse func(A) error) Operator[A, A] {

v2/context/readerioresult/flip.go

@@ -71,7 +71,7 @@ import (
 //
 //	// Now we can partially apply the Config
 //	cfg := Config{Timeout: 30}
-//	ctx := context.Background()
+//	ctx := t.Context()
 //	result := sequenced(ctx)(cfg)() // Returns Right(60)
 //
 // This is especially useful in point-free style when building computation pipelines:
@@ -133,7 +133,7 @@ func SequenceReader[R, A any](ma ReaderIOResult[Reader[R, A]]) Kleisli[R, A] {
 //
 //	// Partially apply the Database
 //	db := Database{ConnectionString: "localhost:5432"}
-//	ctx := context.Background()
+//	ctx := t.Context()
 //	result := sequenced(ctx)(db)() // Executes IO and returns Right("Query result...")
 //
 // In point-free style, this enables clean composition:
@@ -195,7 +195,7 @@ func SequenceReaderIO[R, A any](ma ReaderIOResult[RIO.ReaderIO[R, A]]) Kleisli[R
 //
 //	// Partially apply the Config
 //	cfg := Config{MaxRetries: 3}
-//	ctx := context.Background()
+//	ctx := t.Context()
 //	result := sequenced(ctx)(cfg)() // Returns Right(3)
 //
 //	// With invalid config
@@ -276,7 +276,7 @@ func SequenceReaderResult[R, A any](ma ReaderIOResult[RR.ReaderResult[R, A]]) Kl
 //
 //	// Now we can provide the Config to get the final result
 //	cfg := Config{Multiplier: 5}
-//	ctx := context.Background()
+//	ctx := t.Context()
 //	finalResult := result(cfg)(ctx)() // Returns Right(50)
 //
 // In point-free style, this enables clean composition:

v2/context/readerioresult/flip_test.go

@@ -41,7 +41,7 @@ func TestSequenceReader(t *testing.T) {
 		// The Reader environment (string) is now the first parameter
 		sequenced := SequenceReader(original)
 
-		ctx := context.Background()
+		ctx := t.Context()
 
 		// Test original
 		result1 := original(ctx)()
@@ -75,7 +75,7 @@ func TestSequenceReader(t *testing.T) {
 		}
 
 		db := Database{ConnectionString: "localhost:5432"}
-		ctx := context.Background()
+		ctx := t.Context()
 
 		expected := "Query on localhost:5432"
 
@@ -106,7 +106,7 @@ func TestSequenceReader(t *testing.T) {
 			}
 		}
 
-		ctx := context.Background()
+		ctx := t.Context()
 
 		// Test original with error
 		result1 := original(ctx)()
@@ -132,7 +132,7 @@ func TestSequenceReader(t *testing.T) {
 			}
 		}
 
-		ctx := context.Background()
+		ctx := t.Context()
 
 		// Sequence
 		sequenced := SequenceReader(original)
@@ -158,7 +158,7 @@ func TestSequenceReader(t *testing.T) {
 			}
 		}
 
-		ctx := context.Background()
+		ctx := t.Context()
 		sequenced := SequenceReader(original)
 
 		// Test with zero values
@@ -184,7 +184,7 @@ func TestSequenceReader(t *testing.T) {
 			}
 		}
 
-		ctx, cancel := context.WithCancel(context.Background())
+		ctx, cancel := context.WithCancel(t.Context())
 		cancel()
 
 		sequenced := SequenceReader(original)
@@ -217,14 +217,14 @@ func TestSequenceReader(t *testing.T) {
 		withConfig := sequenced(cfg)
 
 		// Now we have a ReaderIOResult[int] that can be used in different contexts
-		ctx1 := context.Background()
+		ctx1 := t.Context()
 		result1 := withConfig(ctx1)()
 		assert.True(t, either.IsRight(result1))
 		value1, _ := either.Unwrap(result1)
 		assert.Equal(t, 50, value1)
 
 		// Can reuse with different context
-		ctx2 := context.Background()
+		ctx2 := t.Context()
 		result2 := withConfig(ctx2)()
 		assert.True(t, either.IsRight(result2))
 		value2, _ := either.Unwrap(result2)
@@ -246,7 +246,7 @@ func TestSequenceReaderIO(t *testing.T) {
 			}
 		}
 
-		ctx := context.Background()
+		ctx := t.Context()
 		sequenced := SequenceReaderIO(original)
 
 		// Test original
@@ -273,7 +273,7 @@ func TestSequenceReaderIO(t *testing.T) {
 			}
 		}
 
-		ctx := context.Background()
+		ctx := t.Context()
 
 		// Test original with error
 		result1 := original(ctx)()
@@ -303,7 +303,7 @@ func TestSequenceReaderIO(t *testing.T) {
 			}
 		}
 
-		ctx, cancel := context.WithCancel(context.Background())
+		ctx, cancel := context.WithCancel(t.Context())
 		cancel()
 
 		sequenced := SequenceReaderIO(original)
@@ -327,7 +327,7 @@ func TestSequenceReaderResult(t *testing.T) {
 			}
 		}
 
-		ctx := context.Background()
+		ctx := t.Context()
 		sequenced := SequenceReaderResult(original)
 
 		// Test original
@@ -356,7 +356,7 @@ func TestSequenceReaderResult(t *testing.T) {
 			}
 		}
 
-		ctx := context.Background()
+		ctx := t.Context()
 
 		// Test original with error
 		result1 := original(ctx)()
@@ -384,7 +384,7 @@ func TestSequenceReaderResult(t *testing.T) {
 			}
 		}
 
-		ctx := context.Background()
+		ctx := t.Context()
 
 		// Test original with inner error
 		result1 := original(ctx)()
@@ -421,7 +421,7 @@ func TestSequenceReaderResult(t *testing.T) {
 			}
 		}
 
-		ctx := context.Background()
+		ctx := t.Context()
 
 		// Test outer error
 		sequenced1 := SequenceReaderResult(makeOriginal(-20))
@@ -460,7 +460,7 @@ func TestSequenceReaderResult(t *testing.T) {
 			}
 		}
 
-		ctx, cancel := context.WithCancel(context.Background())
+		ctx, cancel := context.WithCancel(t.Context())
 		cancel()
 
 		sequenced := SequenceReaderResult(original)
@@ -484,7 +484,7 @@ func TestSequenceEdgeCases(t *testing.T) {
 			}
 		}
 
-		ctx := context.Background()
+		ctx := t.Context()
 		empty := Empty{}
 		sequenced := SequenceReader(original)
 
@@ -514,7 +514,7 @@ func TestSequenceEdgeCases(t *testing.T) {
 			}
 		}
 
-		ctx := context.Background()
+		ctx := t.Context()
 		data := &Data{Value: 100}
 		sequenced := SequenceReader(original)
 
@@ -544,7 +544,7 @@ func TestSequenceEdgeCases(t *testing.T) {
 			}
 		}
 
-		ctx := context.Background()
+		ctx := t.Context()
 		sequenced := SequenceReader(original)
 
 		// Call multiple times with same inputs
@@ -583,7 +583,7 @@ func TestTraverseReader(t *testing.T) {
 
 		// Provide Config and execute
 		cfg := Config{Multiplier: 5}
-		ctx := context.Background()
+		ctx := t.Context()
 		finalResult := result(cfg)(ctx)()
 
 		assert.True(t, either.IsRight(finalResult))
@@ -614,7 +614,7 @@ func TestTraverseReader(t *testing.T) {
 
 		// Provide Config and execute
 		cfg := Config{Multiplier: 5}
-		ctx := context.Background()
+		ctx := t.Context()
 		finalResult := result(cfg)(ctx)()
 
 		assert.True(t, either.IsLeft(finalResult))
@@ -643,7 +643,7 @@ func TestTraverseReader(t *testing.T) {
 
 		// Provide Database and execute
 		db := Database{Prefix: "ID"}
-		ctx := context.Background()
+		ctx := t.Context()
 		finalResult := result(db)(ctx)()
 
 		assert.True(t, either.IsRight(finalResult))
@@ -673,7 +673,7 @@ func TestTraverseReader(t *testing.T) {
 
 		// Provide Settings and execute
 		settings := Settings{Prefix: "[", Suffix: "]"}
-		ctx := context.Background()
+		ctx := t.Context()
 		finalResult := result(settings)(ctx)()
 
 		assert.True(t, either.IsRight(finalResult))
@@ -705,14 +705,14 @@ func TestTraverseReader(t *testing.T) {
 		withConfig := result(cfg)
 
 		// Can now use with different contexts
-		ctx1 := context.Background()
+		ctx1 := t.Context()
 		finalResult1 := withConfig(ctx1)()
 		assert.True(t, either.IsRight(finalResult1))
 		value1, _ := either.Unwrap(finalResult1)
 		assert.Equal(t, 30, value1)
 
 		// Reuse with different context
-		ctx2 := context.Background()
+		ctx2 := t.Context()
 		finalResult2 := withConfig(ctx2)()
 		assert.True(t, either.IsRight(finalResult2))
 		value2, _ := either.Unwrap(finalResult2)
@@ -746,7 +746,7 @@ func TestTraverseReader(t *testing.T) {
 		result := traversed(original)
 
 		// Use canceled context
-		ctx, cancel := context.WithCancel(context.Background())
+		ctx, cancel := context.WithCancel(t.Context())
 		cancel()
 
 		cfg := Config{Value: 5}
@@ -778,7 +778,7 @@ func TestTraverseReader(t *testing.T) {
 
 		// Provide Config with zero offset
 		cfg := Config{Offset: 0}
-		ctx := context.Background()
+		ctx := t.Context()
 		finalResult := result(cfg)(ctx)()
 
 		assert.True(t, either.IsRight(finalResult))
@@ -807,7 +807,7 @@ func TestTraverseReader(t *testing.T) {
 
 		// Provide Config and execute
 		cfg := Config{Multiplier: 4}
-		ctx := context.Background()
+		ctx := t.Context()
 		finalResult := result(cfg)(ctx)()
 
 		assert.True(t, either.IsRight(finalResult))
@@ -843,7 +843,7 @@ func TestTraverseReader(t *testing.T) {
 
 		// Test with value within range
 		rules1 := ValidationRules{MinValue: 0, MaxValue: 100}
-		ctx := context.Background()
+		ctx := t.Context()
 		finalResult1 := result(rules1)(ctx)()
 		assert.True(t, either.IsRight(finalResult1))
 		value1, _ := either.Unwrap(finalResult1)

v2/context/readerioresult/http/builder/builder.go

@@ -42,7 +42,7 @@
 //	)
 //
 //	requester := RB.Requester(builder)
-//	result := requester(context.Background())()
+//	result := requester(t.Context())()
 package builder
 
 import (
@@ -103,7 +103,7 @@ import (
 //	    B.WithJSONBody(map[string]string{"name": "John"}),
 //	)
 //	requester := RB.Requester(builder)
-//	result := requester(context.Background())()
+//	result := requester(t.Context())()
 //
 // Example without body:
 //
@@ -113,7 +113,7 @@ import (
 //	    B.WithMethod("GET"),
 //	)
 //	requester := RB.Requester(builder)
-//	result := requester(context.Background())()
+//	result := requester(t.Context())()
 func Requester(builder *R.Builder) RIOEH.Requester {
 
 	withBody := F.Curry3(func(data []byte, url string, method string) RIOE.ReaderIOResult[*http.Request] {

v2/context/readerioresult/http/builder/builder_test.go

@@ -46,7 +46,7 @@ func TestBuilderWithQuery(t *testing.T) {
 		RIOE.Map(func(r *http.Request) *url.URL {
 			return r.URL
 		}),
-		RIOE.ChainFirstIOK(func(u *url.URL) IO.IO[any] {
+		RIOE.ChainFirstIOK(func(u *url.URL) IO.IO[Void] {
 			return IO.FromImpure(func() {
 				q := u.Query()
 				assert.Equal(t, "10", q.Get("limit"))
@@ -55,7 +55,7 @@ func TestBuilderWithQuery(t *testing.T) {
 		}),
 	)
 
-	assert.True(t, E.IsRight(req(context.Background())()))
+	assert.True(t, E.IsRight(req(t.Context())()))
 }
 
 // TestBuilderWithoutBody tests creating a request without a body
@@ -67,7 +67,7 @@ func TestBuilderWithoutBody(t *testing.T) {
 	)
 
 	requester := Requester(builder)
-	result := requester(context.Background())()
+	result := requester(t.Context())()
 
 	assert.True(t, E.IsRight(result), "Expected Right result")
 
@@ -90,7 +90,7 @@ func TestBuilderWithBody(t *testing.T) {
 	)
 
 	requester := Requester(builder)
-	result := requester(context.Background())()
+	result := requester(t.Context())()
 
 	assert.True(t, E.IsRight(result), "Expected Right result")
 
@@ -112,7 +112,7 @@ func TestBuilderWithHeaders(t *testing.T) {
 	)
 
 	requester := Requester(builder)
-	result := requester(context.Background())()
+	result := requester(t.Context())()
 
 	assert.True(t, E.IsRight(result), "Expected Right result")
 
@@ -130,7 +130,7 @@ func TestBuilderWithInvalidURL(t *testing.T) {
 	)
 
 	requester := Requester(builder)
-	result := requester(context.Background())()
+	result := requester(t.Context())()
 
 	assert.True(t, E.IsLeft(result), "Expected Left result for invalid URL")
 }
@@ -144,7 +144,7 @@ func TestBuilderWithEmptyMethod(t *testing.T) {
 	)
 
 	requester := Requester(builder)
-	result := requester(context.Background())()
+	result := requester(t.Context())()
 
 	// Empty method should still work (defaults to GET in http.NewRequest)
 	assert.True(t, E.IsRight(result), "Expected Right result")
@@ -161,7 +161,7 @@ func TestBuilderWithMultipleHeaders(t *testing.T) {
 	)
 
 	requester := Requester(builder)
-	result := requester(context.Background())()
+	result := requester(t.Context())()
 
 	assert.True(t, E.IsRight(result), "Expected Right result")
 
@@ -185,7 +185,7 @@ func TestBuilderWithBodyAndHeaders(t *testing.T) {
 	)
 
 	requester := Requester(builder)
-	result := requester(context.Background())()
+	result := requester(t.Context())()
 
 	assert.True(t, E.IsRight(result), "Expected Right result")
 
@@ -207,7 +207,7 @@ func TestBuilderContextCancellation(t *testing.T) {
 	requester := Requester(builder)
 
 	// Create a cancelled context
-	ctx, cancel := context.WithCancel(context.Background())
+	ctx, cancel := context.WithCancel(t.Context())
 	cancel() // Cancel immediately
 
 	result := requester(ctx)()
@@ -233,7 +233,7 @@ func TestBuilderWithDifferentMethods(t *testing.T) {
 			)
 
 			requester := Requester(builder)
-			result := requester(context.Background())()
+			result := requester(t.Context())()
 
 			assert.True(t, E.IsRight(result), "Expected Right result for method %s", method)
 
@@ -256,7 +256,7 @@ func TestBuilderWithJSON(t *testing.T) {
 	)
 
 	requester := Requester(builder)
-	result := requester(context.Background())()
+	result := requester(t.Context())()
 
 	assert.True(t, E.IsRight(result), "Expected Right result")
 
@@ -277,7 +277,7 @@ func TestBuilderWithBearer(t *testing.T) {
 	)
 
 	requester := Requester(builder)
-	result := requester(context.Background())()
+	result := requester(t.Context())()
 
 	assert.True(t, E.IsRight(result), "Expected Right result")
 

v2/context/readerioresult/http/builder/types.go

@@ -0,0 +1,7 @@
+package builder
+
+import "github.com/IBM/fp-go/v2/function"
+
+type (
+	Void = function.Void
+)

v2/context/readerioresult/http/request.go

@@ -28,7 +28,7 @@
 //	client := MakeClient(http.DefaultClient)
 //	request := MakeGetRequest("https://api.example.com/data")
 //	result := ReadJSON[MyType](client)(request)
-//	response := result(context.Background())()
+//	response := result(t.Context())()
 package http
 
 import (
@@ -157,8 +157,8 @@ func MakeClient(httpClient *http.Client) Client {
 //	client := MakeClient(http.DefaultClient)
 //	request := MakeGetRequest("https://api.example.com/data")
 //	fullResp := ReadFullResponse(client)(request)
-//	result := fullResp(context.Background())()
-func ReadFullResponse(client Client) RIOE.Kleisli[Requester, H.FullResponse] {
+//	result := fullResp(t.Context())()
+func ReadFullResponse(client Client) RIOE.Operator[*http.Request, H.FullResponse] {
 	return func(req Requester) RIOE.ReaderIOResult[H.FullResponse] {
 		return F.Flow3(
 			client.Do(req),
@@ -194,8 +194,8 @@ func ReadFullResponse(client Client) RIOE.Kleisli[Requester, H.FullResponse] {
 //	client := MakeClient(http.DefaultClient)
 //	request := MakeGetRequest("https://api.example.com/data")
 //	readBytes := ReadAll(client)
-//	result := readBytes(request)(context.Background())()
-func ReadAll(client Client) RIOE.Kleisli[Requester, []byte] {
+//	result := readBytes(request)(t.Context())()
+func ReadAll(client Client) RIOE.Operator[*http.Request, []byte] {
 	return F.Flow2(
 		ReadFullResponse(client),
 		RIOE.Map(H.Body),
@@ -218,8 +218,8 @@ func ReadAll(client Client) RIOE.Kleisli[Requester, []byte] {
 //	client := MakeClient(http.DefaultClient)
 //	request := MakeGetRequest("https://api.example.com/text")
 //	readText := ReadText(client)
-//	result := readText(request)(context.Background())()
-func ReadText(client Client) RIOE.Kleisli[Requester, string] {
+//	result := readText(request)(t.Context())()
+func ReadText(client Client) RIOE.Operator[*http.Request, string] {
 	return F.Flow2(
 		ReadAll(client),
 		RIOE.Map(B.ToString),
@@ -231,7 +231,7 @@ func ReadText(client Client) RIOE.Kleisli[Requester, string] {
 // Deprecated: Use [ReadJSON] instead. This function is kept for backward compatibility
 // but will be removed in a future version. The capitalized version follows Go naming
 // conventions for acronyms.
-func ReadJson[A any](client Client) RIOE.Kleisli[Requester, A] {
+func ReadJson[A any](client Client) RIOE.Operator[*http.Request, A] {
 	return ReadJSON[A](client)
 }
 
@@ -242,7 +242,7 @@ func ReadJson[A any](client Client) RIOE.Kleisli[Requester, A] {
 //  3. Reads the response body as bytes
 //
 // This function is used internally by ReadJSON to ensure proper JSON response handling.
-func readJSON(client Client) RIOE.Kleisli[Requester, []byte] {
+func readJSON(client Client) RIOE.Operator[*http.Request, []byte] {
 	return F.Flow3(
 		ReadFullResponse(client),
 		RIOE.ChainFirstEitherK(F.Flow2(
@@ -277,8 +277,8 @@ func readJSON(client Client) RIOE.Kleisli[Requester, []byte] {
 //	client := MakeClient(http.DefaultClient)
 //	request := MakeGetRequest("https://api.example.com/user/1")
 //	readUser := ReadJSON[User](client)
-//	result := readUser(request)(context.Background())()
-func ReadJSON[A any](client Client) RIOE.Kleisli[Requester, A] {
+//	result := readUser(request)(t.Context())()
+func ReadJSON[A any](client Client) RIOE.Operator[*http.Request, A] {
 	return F.Flow2(
 		readJSON(client),
 		RIOE.ChainEitherK(J.Unmarshal[A]),

v2/context/readerioresult/logging.go

@@ -65,7 +65,7 @@ var (
 	// This function assumes the context contains logging information; it will panic if not present.
 	getLoggingContext = F.Flow3(
 		loggingContextValue,
-		option.ToType[loggingContext],
+		option.InstanceOf[loggingContext],
 		option.GetOrElse(getDefaultLoggingContext),
 	)
 )
@@ -429,7 +429,7 @@ func LogEntryExitWithCallback[A any](
 //	loggedFetch := LogEntryExit[User]("fetchUser")(fetchUser(123))
 //
 //	// Execute
-//	result := loggedFetch(context.Background())()
+//	result := loggedFetch(t.Context())()
 //	// Logs:
 //	// [entering 1] fetchUser
 //	// [exiting  1] fetchUser [0.1s]
@@ -441,7 +441,7 @@ func LogEntryExitWithCallback[A any](
 //	}
 //
 //	logged := LogEntryExit[string]("failingOp")(failingOp())
-//	result := logged(context.Background())()
+//	result := logged(t.Context())()
 //	// Logs:
 //	// [entering 2] failingOp
 //	// [throwing 2] failingOp [0.0s]: connection timeout
@@ -461,7 +461,7 @@ func LogEntryExitWithCallback[A any](
 //	    LogEntryExit[[]Order]("fetchOrders"),
 //	)
 //
-//	result := pipeline(context.Background())()
+//	result := pipeline(t.Context())()
 //	// Logs:
 //	// [entering 3] fetchUser
 //	// [exiting  3] fetchUser [0.1s]
@@ -474,8 +474,8 @@ func LogEntryExitWithCallback[A any](
 //	op1 := LogEntryExit[Data]("operation1")(fetchData(1))
 //	op2 := LogEntryExit[Data]("operation2")(fetchData(2))
 //
-//	go op1(context.Background())()
-//	go op2(context.Background())()
+//	go op1(t.Context())()
+//	go op2(t.Context())()
 //	// Logs (order may vary):
 //	// [entering 5] operation1
 //	// [entering 6] operation2
@@ -615,7 +615,7 @@ func SLogWithCallback[A any](
 //	    Map(func(u User) string { return u.Name }),
 //	)
 //
-//	result := pipeline(context.Background())()
+//	result := pipeline(t.Context())()
 //	// If successful, logs: "Fetched user" value={ID:123 Name:"Alice"}
 //	// If error, logs: "Fetched user" error="user not found"
 //
@@ -679,7 +679,7 @@ func SLog[A any](message string) Kleisli[Result[A], A] {
 //	    Map(func(u User) string { return u.Name }),
 //	)
 //
-//	result := pipeline(context.Background())()
+//	result := pipeline(t.Context())()
 //	// Logs: "Fetched user" value={ID:123 Name:"Alice"}
 //	// Returns: result.Of("Alice")
 //
@@ -694,7 +694,7 @@ func SLog[A any](message string) Kleisli[Result[A], A] {
 //	    TapSLog[Payment]("Payment processed"),
 //	)
 //
-//	result := processOrder(context.Background())()
+//	result := processOrder(t.Context())()
 //	// Logs each successful step with the intermediate values
 //	// If any step fails, subsequent TapSLog calls don't log
 //

v2/context/readerioresult/logging_test.go

@@ -26,7 +26,7 @@ func TestLoggingContext(t *testing.T) {
 		LogEntryExit[string]("TestLoggingContext2"),
 	)
 
-	assert.Equal(t, result.Of("Sample"), data(context.Background())())
+	assert.Equal(t, result.Of("Sample"), data(t.Context())())
 }
 
 // TestLogEntryExitSuccess tests successful operation logging
@@ -43,7 +43,7 @@ func TestLogEntryExitSuccess(t *testing.T) {
 		LogEntryExit[string]("TestOperation"),
 	)
 
-	res := operation(context.Background())()
+	res := operation(t.Context())()
 
 	assert.Equal(t, result.Of("success value"), res)
 
@@ -70,7 +70,7 @@ func TestLogEntryExitError(t *testing.T) {
 		LogEntryExit[string]("FailingOperation"),
 	)
 
-	res := operation(context.Background())()
+	res := operation(t.Context())()
 
 	assert.True(t, result.IsLeft(res))
 
@@ -105,7 +105,7 @@ func TestLogEntryExitNested(t *testing.T) {
 		}),
 	)
 
-	res := outerOp(context.Background())()
+	res := outerOp(t.Context())()
 
 	assert.True(t, result.IsRight(res))
 
@@ -137,7 +137,7 @@ func TestLogEntryExitWithCallback(t *testing.T) {
 		LogEntryExitWithCallback[int](slog.LevelDebug, customCallback, "DebugOperation"),
 	)
 
-	res := operation(context.Background())()
+	res := operation(t.Context())()
 
 	assert.Equal(t, result.Of(42), res)
 
@@ -163,7 +163,7 @@ func TestLogEntryExitDisabled(t *testing.T) {
 		LogEntryExit[string]("DisabledOperation"),
 	)
 
-	res := operation(context.Background())()
+	res := operation(t.Context())()
 
 	assert.True(t, result.IsRight(res))
 
@@ -197,7 +197,7 @@ func TestLogEntryExitF(t *testing.T) {
 		LogEntryExitF(onEntry, onExit),
 	)
 
-	res := operation(context.Background())()
+	res := operation(t.Context())()
 
 	assert.True(t, result.IsRight(res))
 	assert.Equal(t, 1, entryCount, "Entry callback should be called once")
@@ -234,7 +234,7 @@ func TestLogEntryExitFWithError(t *testing.T) {
 		LogEntryExitF(onEntry, onExit),
 	)
 
-	res := operation(context.Background())()
+	res := operation(t.Context())()
 
 	assert.True(t, result.IsLeft(res))
 	assert.Equal(t, 1, entryCount, "Entry callback should be called once")
@@ -257,7 +257,7 @@ func TestLoggingIDUniqueness(t *testing.T) {
 			Of(i),
 			LogEntryExit[int]("Operation"),
 		)
-		op(context.Background())()
+		op(t.Context())()
 	}
 
 	logOutput := buf.String()
@@ -287,7 +287,7 @@ func TestLogEntryExitWithContextLogger(t *testing.T) {
 		Level: slog.LevelInfo,
 	}))
 
-	ctx := logging.WithLogger(contextLogger)(context.Background())
+	ctx := logging.WithLogger(contextLogger)(t.Context())
 
 	operation := F.Pipe1(
 		Of("context value"),
@@ -326,7 +326,7 @@ func TestLogEntryExitTiming(t *testing.T) {
 		LogEntryExit[string]("SlowOperation"),
 	)
 
-	res := operation(context.Background())()
+	res := operation(t.Context())()
 
 	assert.True(t, result.IsRight(res))
 
@@ -379,7 +379,7 @@ func TestLogEntryExitChainedOperations(t *testing.T) {
 		)),
 	)
 
-	res := pipeline(context.Background())()
+	res := pipeline(t.Context())()
 
 	assert.Equal(t, result.Of("2"), res)
 
@@ -408,7 +408,7 @@ func TestTapSLog(t *testing.T) {
 		Map(N.Mul(2)),
 	)
 
-	res := operation(context.Background())()
+	res := operation(t.Context())()
 
 	assert.Equal(t, result.Of(84), res)
 
@@ -443,7 +443,7 @@ func TestTapSLogInPipeline(t *testing.T) {
 		TapSLog[int]("Step 3: Final length"),
 	)
 
-	res := pipeline(context.Background())()
+	res := pipeline(t.Context())()
 
 	assert.Equal(t, result.Of(11), res)
 
@@ -472,7 +472,7 @@ func TestTapSLogWithError(t *testing.T) {
 		Map(N.Mul(2)),
 	)
 
-	res := pipeline(context.Background())()
+	res := pipeline(t.Context())()
 
 	assert.True(t, result.IsLeft(res))
 
@@ -504,7 +504,7 @@ func TestTapSLogWithStruct(t *testing.T) {
 		Map(func(u User) string { return u.Name }),
 	)
 
-	res := operation(context.Background())()
+	res := operation(t.Context())()
 
 	assert.Equal(t, result.Of("Alice"), res)
 
@@ -530,7 +530,7 @@ func TestTapSLogDisabled(t *testing.T) {
 		Map(N.Mul(2)),
 	)
 
-	res := operation(context.Background())()
+	res := operation(t.Context())()
 
 	assert.Equal(t, result.Of(84), res)
 
@@ -546,7 +546,7 @@ func TestTapSLogWithContextLogger(t *testing.T) {
 		Level: slog.LevelInfo,
 	}))
 
-	ctx := logging.WithLogger(contextLogger)(context.Background())
+	ctx := logging.WithLogger(contextLogger)(t.Context())
 
 	operation := F.Pipe2(
 		Of("test value"),
@@ -572,7 +572,7 @@ func TestSLogLogsSuccessValue(t *testing.T) {
 	oldLogger := logging.SetLogger(logger)
 	defer logging.SetLogger(oldLogger)
 
-	ctx := context.Background()
+	ctx := t.Context()
 
 	// Create a Result and log it
 	res1 := result.Of(42)
@@ -594,7 +594,7 @@ func TestSLogLogsErrorValue(t *testing.T) {
 	oldLogger := logging.SetLogger(logger)
 	defer logging.SetLogger(oldLogger)
 
-	ctx := context.Background()
+	ctx := t.Context()
 	testErr := errors.New("test error")
 
 	// Create an error Result and log it
@@ -620,7 +620,7 @@ func TestSLogWithCallbackCustomLevel(t *testing.T) {
 		return logger
 	}
 
-	ctx := context.Background()
+	ctx := t.Context()
 
 	// Create a Result and log it with custom callback
 	res1 := result.Of(42)
@@ -645,7 +645,7 @@ func TestSLogWithCallbackLogsError(t *testing.T) {
 		return logger
 	}
 
-	ctx := context.Background()
+	ctx := t.Context()
 	testErr := errors.New("warning error")
 
 	// Create an error Result and log it with custom callback

v2/context/readerioresult/profunctor_test.go

@@ -43,7 +43,7 @@ func TestPromapBasic(t *testing.T) {
 		toString := strconv.Itoa
 
 		adapted := Promap(addKey, toString)(getValue)
-		result := adapted(context.Background())()
+		result := adapted(t.Context())()
 
 		assert.Equal(t, R.Of("42"), result)
 	})
@@ -67,7 +67,7 @@ func TestContramapBasic(t *testing.T) {
 		}
 
 		adapted := Contramap[int](addKey)(getValue)
-		result := adapted(context.Background())()
+		result := adapted(t.Context())()
 
 		assert.Equal(t, R.Of(100), result)
 	})
@@ -91,7 +91,7 @@ func TestLocalBasic(t *testing.T) {
 		}
 
 		adapted := Local[string](addUser)(getValue)
-		result := adapted(context.Background())()
+		result := adapted(t.Context())()
 
 		assert.Equal(t, R.Of("Alice"), result)
 	})

v2/context/readerioresult/reader.go

@@ -222,7 +222,7 @@ func withCancelCauseFunc[A any](cancel context.CancelCauseFunc, ma IOResult[A])
 	return function.Pipe3(
 		ma,
 		ioresult.Swap[A],
-		ioeither.ChainFirstIOK[A](func(err error) func() any {
+		ioeither.ChainFirstIOK[A](func(err error) func() Void {
 			return io.FromImpure(func() { cancel(err) })
 		}),
 		ioeither.Swap[A],
@@ -1041,7 +1041,7 @@ func TapLeftIOK[A, B any](f io.Kleisli[error, B]) Operator[A, A] {
 //	    getUser,
 //	    addUser,
 //	)
-//	value, err := result(context.Background())()  // Returns ("Alice", nil)
+//	value, err := result(t.Context())()  // Returns ("Alice", nil)
 //
 // Timeout Example:
 //
@@ -1112,7 +1112,7 @@ func Local[A any](f func(context.Context) (context.Context, context.CancelFunc))
 //	    fetchData,
 //	    readerioresult.WithTimeout[Data](5*time.Second),
 //	)
-//	value, err := result(context.Background())()  // Returns (Data{}, context.DeadlineExceeded) after 5s
+//	value, err := result(t.Context())()  // Returns (Data{}, context.DeadlineExceeded) after 5s
 //
 // Successful Example:
 //
@@ -1121,7 +1121,7 @@ func Local[A any](f func(context.Context) (context.Context, context.CancelFunc))
 //	    quickFetch,
 //	    readerioresult.WithTimeout[Data](5*time.Second),
 //	)
-//	value, err := result(context.Background())()  // Returns (Data{Value: "quick"}, nil)
+//	value, err := result(t.Context())()  // Returns (Data{Value: "quick"}, nil)
 func WithTimeout[A any](timeout time.Duration) Operator[A, A] {
 	return Local[A](func(ctx context.Context) (context.Context, context.CancelFunc) {
 		return context.WithTimeout(ctx, timeout)
@@ -1173,12 +1173,12 @@ func WithTimeout[A any](timeout time.Duration) Operator[A, A] {
 //	    fetchData,
 //	    readerioresult.WithDeadline[Data](deadline),
 //	)
-//	value, err := result(context.Background())()  // Returns (Data{}, context.DeadlineExceeded) if past deadline
+//	value, err := result(t.Context())()  // Returns (Data{}, context.DeadlineExceeded) if past deadline
 //
 // Combining with Parent Context:
 //
 //	// If parent context already has a deadline, the earlier one takes precedence
-//	parentCtx, cancel := context.WithDeadline(context.Background(), time.Now().Add(1*time.Hour))
+//	parentCtx, cancel := context.WithDeadline(t.Context(), time.Now().Add(1*time.Hour))
 //	defer cancel()
 //
 //	laterDeadline := time.Now().Add(2 * time.Hour)

v2/context/readerioresult/reader_extended_test.go

@@ -36,56 +36,56 @@ func TestFromEither(t *testing.T) {
 	t.Run("Right value", func(t *testing.T) {
 		either := E.Right[error]("success")
 		result := FromEither(either)
-		assert.Equal(t, E.Right[error]("success"), result(context.Background())())
+		assert.Equal(t, E.Right[error]("success"), result(t.Context())())
 	})
 
 	t.Run("Left value", func(t *testing.T) {
 		err := errors.New("test error")
 		either := E.Left[string](err)
 		result := FromEither(either)
-		assert.Equal(t, E.Left[string](err), result(context.Background())())
+		assert.Equal(t, E.Left[string](err), result(t.Context())())
 	})
 }
 
 func TestFromResult(t *testing.T) {
 	t.Run("Success", func(t *testing.T) {
 		result := FromResult(E.Right[error](42))
-		assert.Equal(t, E.Right[error](42), result(context.Background())())
+		assert.Equal(t, E.Right[error](42), result(t.Context())())
 	})
 
 	t.Run("Error", func(t *testing.T) {
 		err := errors.New("test error")
 		result := FromResult(E.Left[int](err))
-		assert.Equal(t, E.Left[int](err), result(context.Background())())
+		assert.Equal(t, E.Left[int](err), result(t.Context())())
 	})
 }
 
 func TestLeft(t *testing.T) {
 	err := errors.New("test error")
 	result := Left[string](err)
-	assert.Equal(t, E.Left[string](err), result(context.Background())())
+	assert.Equal(t, E.Left[string](err), result(t.Context())())
 }
 
 func TestRight(t *testing.T) {
 	result := Right("success")
-	assert.Equal(t, E.Right[error]("success"), result(context.Background())())
+	assert.Equal(t, E.Right[error]("success"), result(t.Context())())
 }
 
 func TestOf(t *testing.T) {
 	result := Of(42)
-	assert.Equal(t, E.Right[error](42), result(context.Background())())
+	assert.Equal(t, E.Right[error](42), result(t.Context())())
 }
 
 func TestMonadMap(t *testing.T) {
 	t.Run("Map over Right", func(t *testing.T) {
 		result := MonadMap(Of(5), N.Mul(2))
-		assert.Equal(t, E.Right[error](10), result(context.Background())())
+		assert.Equal(t, E.Right[error](10), result(t.Context())())
 	})
 
 	t.Run("Map over Left", func(t *testing.T) {
 		err := errors.New("test error")
 		result := MonadMap(Left[int](err), N.Mul(2))
-		assert.Equal(t, E.Left[int](err), result(context.Background())())
+		assert.Equal(t, E.Left[int](err), result(t.Context())())
 	})
 }
 
@@ -93,34 +93,34 @@ func TestMap(t *testing.T) {
 	t.Run("Map with success", func(t *testing.T) {
 		mapper := Map(N.Mul(2))
 		result := mapper(Of(5))
-		assert.Equal(t, E.Right[error](10), result(context.Background())())
+		assert.Equal(t, E.Right[error](10), result(t.Context())())
 	})
 
 	t.Run("Map with error", func(t *testing.T) {
 		err := errors.New("test error")
 		mapper := Map(N.Mul(2))
 		result := mapper(Left[int](err))
-		assert.Equal(t, E.Left[int](err), result(context.Background())())
+		assert.Equal(t, E.Left[int](err), result(t.Context())())
 	})
 }
 
 func TestMonadMapTo(t *testing.T) {
 	t.Run("MapTo with success", func(t *testing.T) {
 		result := MonadMapTo(Of("original"), 42)
-		assert.Equal(t, E.Right[error](42), result(context.Background())())
+		assert.Equal(t, E.Right[error](42), result(t.Context())())
 	})
 
 	t.Run("MapTo with error", func(t *testing.T) {
 		err := errors.New("test error")
 		result := MonadMapTo(Left[string](err), 42)
-		assert.Equal(t, E.Left[int](err), result(context.Background())())
+		assert.Equal(t, E.Left[int](err), result(t.Context())())
 	})
 }
 
 func TestMapTo(t *testing.T) {
 	mapper := MapTo[string](42)
 	result := mapper(Of("original"))
-	assert.Equal(t, E.Right[error](42), result(context.Background())())
+	assert.Equal(t, E.Right[error](42), result(t.Context())())
 }
 
 func TestMonadChain(t *testing.T) {
@@ -128,7 +128,7 @@ func TestMonadChain(t *testing.T) {
 		result := MonadChain(Of(5), func(x int) ReaderIOResult[int] {
 			return Of(x * 2)
 		})
-		assert.Equal(t, E.Right[error](10), result(context.Background())())
+		assert.Equal(t, E.Right[error](10), result(t.Context())())
 	})
 
 	t.Run("Chain with error in first", func(t *testing.T) {
@@ -136,7 +136,7 @@ func TestMonadChain(t *testing.T) {
 		result := MonadChain(Left[int](err), func(x int) ReaderIOResult[int] {
 			return Of(x * 2)
 		})
-		assert.Equal(t, E.Left[int](err), result(context.Background())())
+		assert.Equal(t, E.Left[int](err), result(t.Context())())
 	})
 
 	t.Run("Chain with error in second", func(t *testing.T) {
@@ -144,7 +144,7 @@ func TestMonadChain(t *testing.T) {
 		result := MonadChain(Of(5), func(x int) ReaderIOResult[int] {
 			return Left[int](err)
 		})
-		assert.Equal(t, E.Left[int](err), result(context.Background())())
+		assert.Equal(t, E.Left[int](err), result(t.Context())())
 	})
 }
 
@@ -153,7 +153,7 @@ func TestChain(t *testing.T) {
 		return Of(x * 2)
 	})
 	result := chainer(Of(5))
-	assert.Equal(t, E.Right[error](10), result(context.Background())())
+	assert.Equal(t, E.Right[error](10), result(t.Context())())
 }
 
 func TestMonadChainFirst(t *testing.T) {
@@ -161,7 +161,7 @@ func TestMonadChainFirst(t *testing.T) {
 		result := MonadChainFirst(Of(5), func(x int) ReaderIOResult[string] {
 			return Of("ignored")
 		})
-		assert.Equal(t, E.Right[error](5), result(context.Background())())
+		assert.Equal(t, E.Right[error](5), result(t.Context())())
 	})
 
 	t.Run("ChainFirst propagates error from second", func(t *testing.T) {
@@ -169,7 +169,7 @@ func TestMonadChainFirst(t *testing.T) {
 		result := MonadChainFirst(Of(5), func(x int) ReaderIOResult[string] {
 			return Left[string](err)
 		})
-		assert.Equal(t, E.Left[int](err), result(context.Background())())
+		assert.Equal(t, E.Left[int](err), result(t.Context())())
 	})
 }
 
@@ -178,7 +178,7 @@ func TestChainFirst(t *testing.T) {
 		return Of("ignored")
 	})
 	result := chainer(Of(5))
-	assert.Equal(t, E.Right[error](5), result(context.Background())())
+	assert.Equal(t, E.Right[error](5), result(t.Context())())
 }
 
 func TestMonadApSeq(t *testing.T) {
@@ -186,7 +186,7 @@ func TestMonadApSeq(t *testing.T) {
 		fab := Of(N.Mul(2))
 		fa := Of(5)
 		result := MonadApSeq(fab, fa)
-		assert.Equal(t, E.Right[error](10), result(context.Background())())
+		assert.Equal(t, E.Right[error](10), result(t.Context())())
 	})
 
 	t.Run("ApSeq with error in function", func(t *testing.T) {
@@ -194,7 +194,7 @@ func TestMonadApSeq(t *testing.T) {
 		fab := Left[func(int) int](err)
 		fa := Of(5)
 		result := MonadApSeq(fab, fa)
-		assert.Equal(t, E.Left[int](err), result(context.Background())())
+		assert.Equal(t, E.Left[int](err), result(t.Context())())
 	})
 
 	t.Run("ApSeq with error in value", func(t *testing.T) {
@@ -202,7 +202,7 @@ func TestMonadApSeq(t *testing.T) {
 		fab := Of(N.Mul(2))
 		fa := Left[int](err)
 		result := MonadApSeq(fab, fa)
-		assert.Equal(t, E.Left[int](err), result(context.Background())())
+		assert.Equal(t, E.Left[int](err), result(t.Context())())
 	})
 }
 
@@ -210,7 +210,7 @@ func TestApSeq(t *testing.T) {
 	fa := Of(5)
 	fab := Of(N.Mul(2))
 	result := MonadApSeq(fab, fa)
-	assert.Equal(t, E.Right[error](10), result(context.Background())())
+	assert.Equal(t, E.Right[error](10), result(t.Context())())
 }
 
 func TestApPar(t *testing.T) {
@@ -218,11 +218,11 @@ func TestApPar(t *testing.T) {
 		fa := Of(5)
 		fab := Of(N.Mul(2))
 		result := MonadApPar(fab, fa)
-		assert.Equal(t, E.Right[error](10), result(context.Background())())
+		assert.Equal(t, E.Right[error](10), result(t.Context())())
 	})
 
 	t.Run("ApPar with cancelled context", func(t *testing.T) {
-		ctx, cancel := context.WithCancel(context.Background())
+		ctx, cancel := context.WithCancel(t.Context())
 		cancel()
 		fa := Of(5)
 		fab := Of(N.Mul(2))
@@ -239,7 +239,7 @@ func TestFromPredicate(t *testing.T) {
 			func(x int) error { return fmt.Errorf("value %d is not positive", x) },
 		)
 		result := pred(5)
-		assert.Equal(t, E.Right[error](5), result(context.Background())())
+		assert.Equal(t, E.Right[error](5), result(t.Context())())
 	})
 
 	t.Run("Predicate false", func(t *testing.T) {
@@ -248,7 +248,7 @@ func TestFromPredicate(t *testing.T) {
 			func(x int) error { return fmt.Errorf("value %d is not positive", x) },
 		)
 		result := pred(-5)
-		res := result(context.Background())()
+		res := result(t.Context())()
 		assert.True(t, E.IsLeft(res))
 	})
 }
@@ -259,7 +259,7 @@ func TestOrElse(t *testing.T) {
 			return Of(42)
 		})
 		result := fallback(Of(10))
-		assert.Equal(t, E.Right[error](10), result(context.Background())())
+		assert.Equal(t, E.Right[error](10), result(t.Context())())
 	})
 
 	t.Run("OrElse with error", func(t *testing.T) {
@@ -268,13 +268,13 @@ func TestOrElse(t *testing.T) {
 			return Of(42)
 		})
 		result := fallback(Left[int](err))
-		assert.Equal(t, E.Right[error](42), result(context.Background())())
+		assert.Equal(t, E.Right[error](42), result(t.Context())())
 	})
 }
 
 func TestAsk(t *testing.T) {
 	result := Ask()
-	ctx := context.Background()
+	ctx := t.Context()
 	res := result(ctx)()
 	assert.True(t, E.IsRight(res))
 	ctxResult := E.ToOption(res)
@@ -286,7 +286,7 @@ func TestMonadChainEitherK(t *testing.T) {
 		result := MonadChainEitherK(Of(5), func(x int) Either[int] {
 			return E.Right[error](x * 2)
 		})
-		assert.Equal(t, E.Right[error](10), result(context.Background())())
+		assert.Equal(t, E.Right[error](10), result(t.Context())())
 	})
 
 	t.Run("ChainEitherK with error", func(t *testing.T) {
@@ -294,7 +294,7 @@ func TestMonadChainEitherK(t *testing.T) {
 		result := MonadChainEitherK(Of(5), func(x int) Either[int] {
 			return E.Left[int](err)
 		})
-		assert.Equal(t, E.Left[int](err), result(context.Background())())
+		assert.Equal(t, E.Left[int](err), result(t.Context())())
 	})
 }
 
@@ -303,7 +303,7 @@ func TestChainEitherK(t *testing.T) {
 		return E.Right[error](x * 2)
 	})
 	result := chainer(Of(5))
-	assert.Equal(t, E.Right[error](10), result(context.Background())())
+	assert.Equal(t, E.Right[error](10), result(t.Context())())
 }
 
 func TestMonadChainFirstEitherK(t *testing.T) {
@@ -311,7 +311,7 @@ func TestMonadChainFirstEitherK(t *testing.T) {
 		result := MonadChainFirstEitherK(Of(5), func(x int) Either[string] {
 			return E.Right[error]("ignored")
 		})
-		assert.Equal(t, E.Right[error](5), result(context.Background())())
+		assert.Equal(t, E.Right[error](5), result(t.Context())())
 	})
 
 	t.Run("ChainFirstEitherK propagates error", func(t *testing.T) {
@@ -319,7 +319,7 @@ func TestMonadChainFirstEitherK(t *testing.T) {
 		result := MonadChainFirstEitherK(Of(5), func(x int) Either[string] {
 			return E.Left[string](err)
 		})
-		assert.Equal(t, E.Left[int](err), result(context.Background())())
+		assert.Equal(t, E.Left[int](err), result(t.Context())())
 	})
 }
 
@@ -328,7 +328,7 @@ func TestChainFirstEitherK(t *testing.T) {
 		return E.Right[error]("ignored")
 	})
 	result := chainer(Of(5))
-	assert.Equal(t, E.Right[error](5), result(context.Background())())
+	assert.Equal(t, E.Right[error](5), result(t.Context())())
 }
 
 func TestChainOptionK(t *testing.T) {
@@ -339,7 +339,7 @@ func TestChainOptionK(t *testing.T) {
 			return O.Some(x * 2)
 		})
 		result := chainer(Of(5))
-		assert.Equal(t, E.Right[error](10), result(context.Background())())
+		assert.Equal(t, E.Right[error](10), result(t.Context())())
 	})
 
 	t.Run("ChainOptionK with None", func(t *testing.T) {
@@ -349,7 +349,7 @@ func TestChainOptionK(t *testing.T) {
 			return O.None[int]()
 		})
 		result := chainer(Of(5))
-		res := result(context.Background())()
+		res := result(t.Context())()
 		assert.True(t, E.IsLeft(res))
 	})
 }
@@ -358,44 +358,44 @@ func TestFromIOEither(t *testing.T) {
 	t.Run("FromIOEither with success", func(t *testing.T) {
 		ioe := IOE.Of[error](42)
 		result := FromIOEither(ioe)
-		assert.Equal(t, E.Right[error](42), result(context.Background())())
+		assert.Equal(t, E.Right[error](42), result(t.Context())())
 	})
 
 	t.Run("FromIOEither with error", func(t *testing.T) {
 		err := errors.New("test error")
 		ioe := IOE.Left[int](err)
 		result := FromIOEither(ioe)
-		assert.Equal(t, E.Left[int](err), result(context.Background())())
+		assert.Equal(t, E.Left[int](err), result(t.Context())())
 	})
 }
 
 func TestFromIOResult(t *testing.T) {
 	ioe := IOE.Of[error](42)
 	result := FromIOResult(ioe)
-	assert.Equal(t, E.Right[error](42), result(context.Background())())
+	assert.Equal(t, E.Right[error](42), result(t.Context())())
 }
 
 func TestFromIO(t *testing.T) {
 	io := IOG.Of(42)
 	result := FromIO(io)
-	assert.Equal(t, E.Right[error](42), result(context.Background())())
+	assert.Equal(t, E.Right[error](42), result(t.Context())())
 }
 
 func TestFromReader(t *testing.T) {
 	reader := R.Of[context.Context](42)
 	result := FromReader(reader)
-	assert.Equal(t, E.Right[error](42), result(context.Background())())
+	assert.Equal(t, E.Right[error](42), result(t.Context())())
 }
 
 func TestFromLazy(t *testing.T) {
 	lazy := func() int { return 42 }
 	result := FromLazy(lazy)
-	assert.Equal(t, E.Right[error](42), result(context.Background())())
+	assert.Equal(t, E.Right[error](42), result(t.Context())())
 }
 
 func TestNever(t *testing.T) {
 	t.Run("Never with cancelled context", func(t *testing.T) {
-		ctx, cancel := context.WithCancel(context.Background())
+		ctx, cancel := context.WithCancel(t.Context())
 		result := Never[int]()
 
 		// Cancel immediately
@@ -406,7 +406,7 @@ func TestNever(t *testing.T) {
 	})
 
 	t.Run("Never with timeout", func(t *testing.T) {
-		ctx, cancel := context.WithTimeout(context.Background(), 100*time.Millisecond)
+		ctx, cancel := context.WithTimeout(t.Context(), 100*time.Millisecond)
 		defer cancel()
 
 		result := Never[int]()
@@ -419,7 +419,7 @@ func TestMonadChainIOK(t *testing.T) {
 	result := MonadChainIOK(Of(5), func(x int) IOG.IO[int] {
 		return IOG.Of(x * 2)
 	})
-	assert.Equal(t, E.Right[error](10), result(context.Background())())
+	assert.Equal(t, E.Right[error](10), result(t.Context())())
 }
 
 func TestChainIOK(t *testing.T) {
@@ -427,14 +427,14 @@ func TestChainIOK(t *testing.T) {
 		return IOG.Of(x * 2)
 	})
 	result := chainer(Of(5))
-	assert.Equal(t, E.Right[error](10), result(context.Background())())
+	assert.Equal(t, E.Right[error](10), result(t.Context())())
 }
 
 func TestMonadChainFirstIOK(t *testing.T) {
 	result := MonadChainFirstIOK(Of(5), func(x int) IOG.IO[string] {
 		return IOG.Of("ignored")
 	})
-	assert.Equal(t, E.Right[error](5), result(context.Background())())
+	assert.Equal(t, E.Right[error](5), result(t.Context())())
 }
 
 func TestChainFirstIOK(t *testing.T) {
@@ -442,7 +442,7 @@ func TestChainFirstIOK(t *testing.T) {
 		return IOG.Of("ignored")
 	})
 	result := chainer(Of(5))
-	assert.Equal(t, E.Right[error](5), result(context.Background())())
+	assert.Equal(t, E.Right[error](5), result(t.Context())())
 }
 
 func TestChainIOEitherK(t *testing.T) {
@@ -451,7 +451,7 @@ func TestChainIOEitherK(t *testing.T) {
 			return IOE.Of[error](x * 2)
 		})
 		result := chainer(Of(5))
-		assert.Equal(t, E.Right[error](10), result(context.Background())())
+		assert.Equal(t, E.Right[error](10), result(t.Context())())
 	})
 
 	t.Run("ChainIOEitherK with error", func(t *testing.T) {
@@ -460,7 +460,7 @@ func TestChainIOEitherK(t *testing.T) {
 			return IOE.Left[int](err)
 		})
 		result := chainer(Of(5))
-		assert.Equal(t, E.Left[int](err), result(context.Background())())
+		assert.Equal(t, E.Left[int](err), result(t.Context())())
 	})
 }
 
@@ -469,7 +469,7 @@ func TestDelay(t *testing.T) {
 		start := time.Now()
 		delayed := Delay[int](100 * time.Millisecond)
 		result := delayed(Of(42))
-		res := result(context.Background())()
+		res := result(t.Context())()
 		elapsed := time.Since(start)
 
 		assert.True(t, E.IsRight(res))
@@ -477,7 +477,7 @@ func TestDelay(t *testing.T) {
 	})
 
 	t.Run("Delay with cancelled context", func(t *testing.T) {
-		ctx, cancel := context.WithCancel(context.Background())
+		ctx, cancel := context.WithCancel(t.Context())
 
 		delayed := Delay[int](100 * time.Millisecond)
 		result := delayed(Of(42))
@@ -500,11 +500,11 @@ func TestDefer(t *testing.T) {
 	})
 
 	// First execution
-	res1 := deferred(context.Background())()
+	res1 := deferred(t.Context())()
 	assert.True(t, E.IsRight(res1))
 
 	// Second execution should generate a new computation
-	res2 := deferred(context.Background())()
+	res2 := deferred(t.Context())()
 	assert.True(t, E.IsRight(res2))
 
 	// Counter should be incremented for each execution
@@ -518,7 +518,7 @@ func TestTryCatch(t *testing.T) {
 				return 42, nil
 			}
 		})
-		assert.Equal(t, E.Right[error](42), result(context.Background())())
+		assert.Equal(t, E.Right[error](42), result(t.Context())())
 	})
 
 	t.Run("TryCatch with error", func(t *testing.T) {
@@ -528,7 +528,7 @@ func TestTryCatch(t *testing.T) {
 				return 0, err
 			}
 		})
-		assert.Equal(t, E.Left[int](err), result(context.Background())())
+		assert.Equal(t, E.Left[int](err), result(t.Context())())
 	})
 }
 
@@ -537,7 +537,7 @@ func TestMonadAlt(t *testing.T) {
 		first := Of(42)
 		second := func() ReaderIOResult[int] { return Of(100) }
 		result := MonadAlt(first, second)
-		assert.Equal(t, E.Right[error](42), result(context.Background())())
+		assert.Equal(t, E.Right[error](42), result(t.Context())())
 	})
 
 	t.Run("Alt with first error", func(t *testing.T) {
@@ -545,7 +545,7 @@ func TestMonadAlt(t *testing.T) {
 		first := Left[int](err)
 		second := func() ReaderIOResult[int] { return Of(100) }
 		result := MonadAlt(first, second)
-		assert.Equal(t, E.Right[error](100), result(context.Background())())
+		assert.Equal(t, E.Right[error](100), result(t.Context())())
 	})
 }
 
@@ -553,7 +553,7 @@ func TestAlt(t *testing.T) {
 	err := errors.New("test error")
 	alternative := Alt(func() ReaderIOResult[int] { return Of(100) })
 	result := alternative(Left[int](err))
-	assert.Equal(t, E.Right[error](100), result(context.Background())())
+	assert.Equal(t, E.Right[error](100), result(t.Context())())
 }
 
 func TestMemoize(t *testing.T) {
@@ -564,13 +564,13 @@ func TestMemoize(t *testing.T) {
 	}))
 
 	// First execution
-	res1 := computation(context.Background())()
+	res1 := computation(t.Context())()
 	assert.True(t, E.IsRight(res1))
 	val1 := E.ToOption(res1)
 	assert.Equal(t, O.Of(1), val1)
 
 	// Second execution should return cached value
-	res2 := computation(context.Background())()
+	res2 := computation(t.Context())()
 	assert.True(t, E.IsRight(res2))
 	val2 := E.ToOption(res2)
 	assert.Equal(t, O.Of(1), val2)
@@ -582,19 +582,19 @@ func TestMemoize(t *testing.T) {
 func TestFlatten(t *testing.T) {
 	nested := Of(Of(42))
 	result := Flatten(nested)
-	assert.Equal(t, E.Right[error](42), result(context.Background())())
+	assert.Equal(t, E.Right[error](42), result(t.Context())())
 }
 
 func TestMonadFlap(t *testing.T) {
 	fab := Of(N.Mul(2))
 	result := MonadFlap(fab, 5)
-	assert.Equal(t, E.Right[error](10), result(context.Background())())
+	assert.Equal(t, E.Right[error](10), result(t.Context())())
 }
 
 func TestFlap(t *testing.T) {
 	flapper := Flap[int](5)
 	result := flapper(Of(N.Mul(2)))
-	assert.Equal(t, E.Right[error](10), result(context.Background())())
+	assert.Equal(t, E.Right[error](10), result(t.Context())())
 }
 
 func TestFold(t *testing.T) {
@@ -608,7 +608,7 @@ func TestFold(t *testing.T) {
 			},
 		)
 		result := folder(Of(42))
-		assert.Equal(t, E.Right[error]("success: 42"), result(context.Background())())
+		assert.Equal(t, E.Right[error]("success: 42"), result(t.Context())())
 	})
 
 	t.Run("Fold with error", func(t *testing.T) {
@@ -622,7 +622,7 @@ func TestFold(t *testing.T) {
 			},
 		)
 		result := folder(Left[int](err))
-		assert.Equal(t, E.Right[error]("error: test error"), result(context.Background())())
+		assert.Equal(t, E.Right[error]("error: test error"), result(t.Context())())
 	})
 }
 
@@ -634,7 +634,7 @@ func TestGetOrElse(t *testing.T) {
 			}
 		})
 		result := getter(Of(42))
-		assert.Equal(t, 42, result(context.Background())())
+		assert.Equal(t, 42, result(t.Context())())
 	})
 
 	t.Run("GetOrElse with error", func(t *testing.T) {
@@ -645,19 +645,19 @@ func TestGetOrElse(t *testing.T) {
 			}
 		})
 		result := getter(Left[int](err))
-		assert.Equal(t, 0, result(context.Background())())
+		assert.Equal(t, 0, result(t.Context())())
 	})
 }
 
 func TestWithContext(t *testing.T) {
 	t.Run("WithContext with valid context", func(t *testing.T) {
 		computation := WithContext(Of(42))
-		result := computation(context.Background())()
+		result := computation(t.Context())()
 		assert.Equal(t, E.Right[error](42), result)
 	})
 
 	t.Run("WithContext with cancelled context", func(t *testing.T) {
-		ctx, cancel := context.WithCancel(context.Background())
+		ctx, cancel := context.WithCancel(t.Context())
 		cancel()
 
 		computation := WithContext(Of(42))
@@ -672,7 +672,7 @@ func TestEitherize0(t *testing.T) {
 	}
 	eitherized := Eitherize0(f)
 	result := eitherized()
-	assert.Equal(t, E.Right[error](42), result(context.Background())())
+	assert.Equal(t, E.Right[error](42), result(t.Context())())
 }
 
 func TestUneitherize0(t *testing.T) {
@@ -680,7 +680,7 @@ func TestUneitherize0(t *testing.T) {
 		return Of(42)
 	}
 	uneitherized := Uneitherize0(f)
-	result, err := uneitherized(context.Background())
+	result, err := uneitherized(t.Context())
 	assert.NoError(t, err)
 	assert.Equal(t, 42, result)
 }
@@ -691,7 +691,7 @@ func TestEitherize1(t *testing.T) {
 	}
 	eitherized := Eitherize1(f)
 	result := eitherized(5)
-	assert.Equal(t, E.Right[error](10), result(context.Background())())
+	assert.Equal(t, E.Right[error](10), result(t.Context())())
 }
 
 func TestUneitherize1(t *testing.T) {
@@ -699,14 +699,14 @@ func TestUneitherize1(t *testing.T) {
 		return Of(x * 2)
 	}
 	uneitherized := Uneitherize1(f)
-	result, err := uneitherized(context.Background(), 5)
+	result, err := uneitherized(t.Context(), 5)
 	assert.NoError(t, err)
 	assert.Equal(t, 10, result)
 }
 
 func TestSequenceT2(t *testing.T) {
 	result := SequenceT2(Of(1), Of(2))
-	res := result(context.Background())()
+	res := result(t.Context())()
 	assert.True(t, E.IsRight(res))
 	tuple := E.ToOption(res)
 	assert.True(t, O.IsSome(tuple))
@@ -717,13 +717,13 @@ func TestSequenceT2(t *testing.T) {
 
 func TestSequenceSeqT2(t *testing.T) {
 	result := SequenceSeqT2(Of(1), Of(2))
-	res := result(context.Background())()
+	res := result(t.Context())()
 	assert.True(t, E.IsRight(res))
 }
 
 func TestSequenceParT2(t *testing.T) {
 	result := SequenceParT2(Of(1), Of(2))
-	res := result(context.Background())()
+	res := result(t.Context())()
 	assert.True(t, E.IsRight(res))
 }
 
@@ -734,7 +734,7 @@ func TestTraverseArray(t *testing.T) {
 			return Of(x * 2)
 		})
 		result := traverser(arr)
-		res := result(context.Background())()
+		res := result(t.Context())()
 		assert.True(t, E.IsRight(res))
 		arrOpt := E.ToOption(res)
 		assert.Equal(t, O.Of([]int{2, 4, 6}), arrOpt)
@@ -750,7 +750,7 @@ func TestTraverseArray(t *testing.T) {
 			return Of(x * 2)
 		})
 		result := traverser(arr)
-		res := result(context.Background())()
+		res := result(t.Context())()
 		assert.True(t, E.IsLeft(res))
 	})
 }
@@ -758,7 +758,7 @@ func TestTraverseArray(t *testing.T) {
 func TestSequenceArray(t *testing.T) {
 	arr := []ReaderIOResult[int]{Of(1), Of(2), Of(3)}
 	result := SequenceArray(arr)
-	res := result(context.Background())()
+	res := result(t.Context())()
 	assert.True(t, E.IsRight(res))
 	arrOpt := E.ToOption(res)
 	assert.Equal(t, O.Of([]int{1, 2, 3}), arrOpt)
@@ -769,7 +769,7 @@ func TestTraverseRecord(t *testing.T) {
 	result := TraverseRecord[string](func(x int) ReaderIOResult[int] {
 		return Of(x * 2)
 	})(rec)
-	res := result(context.Background())()
+	res := result(t.Context())()
 	assert.True(t, E.IsRight(res))
 	recOpt := E.ToOption(res)
 	assert.True(t, O.IsSome(recOpt))
@@ -784,7 +784,7 @@ func TestSequenceRecord(t *testing.T) {
 		"b": Of(2),
 	}
 	result := SequenceRecord(rec)
-	res := result(context.Background())()
+	res := result(t.Context())()
 	assert.True(t, E.IsRight(res))
 	recOpt := E.ToOption(res)
 	assert.True(t, O.IsSome(recOpt))
@@ -798,7 +798,7 @@ func TestAltSemigroup(t *testing.T) {
 	err := errors.New("test error")
 
 	result := sg.Concat(Left[int](err), Of(42))
-	res := result(context.Background())()
+	res := result(t.Context())()
 	assert.Equal(t, E.Right[error](42), res)
 }
 
@@ -810,7 +810,7 @@ func TestApplicativeMonoid(t *testing.T) {
 	))
 
 	result := intAddMonoid.Concat(Of(5), Of(10))
-	res := result(context.Background())()
+	res := result(t.Context())()
 	assert.Equal(t, E.Right[error](15), res)
 }
 
@@ -835,7 +835,7 @@ func TestBracket(t *testing.T) {
 		}
 
 		result := Bracket(acquire, use, release)
-		res := result(context.Background())()
+		res := result(t.Context())()
 
 		assert.True(t, acquired)
 		assert.True(t, released)
@@ -863,7 +863,7 @@ func TestBracket(t *testing.T) {
 		}
 
 		result := Bracket(acquire, use, release)
-		res := result(context.Background())()
+		res := result(t.Context())()
 
 		assert.True(t, acquired)
 		assert.True(t, released)

v2/context/readerioresult/reader_test.go

@@ -29,7 +29,7 @@ import (
 
 func TestInnerContextCancelSemantics(t *testing.T) {
 	// start with a simple context
-	outer := context.Background()
+	outer := t.Context()
 
 	parent, parentCancel := context.WithCancel(outer)
 	defer parentCancel()
@@ -49,7 +49,7 @@ func TestInnerContextCancelSemantics(t *testing.T) {
 
 func TestOuterContextCancelSemantics(t *testing.T) {
 	// start with a simple context
-	outer := context.Background()
+	outer := t.Context()
 
 	parent, outerCancel := context.WithCancel(outer)
 	defer outerCancel()
@@ -69,7 +69,7 @@ func TestOuterContextCancelSemantics(t *testing.T) {
 
 func TestOuterAndInnerContextCancelSemantics(t *testing.T) {
 	// start with a simple context
-	outer := context.Background()
+	outer := t.Context()
 
 	parent, outerCancel := context.WithCancel(outer)
 	defer outerCancel()
@@ -95,7 +95,7 @@ func TestOuterAndInnerContextCancelSemantics(t *testing.T) {
 
 func TestCancelCauseSemantics(t *testing.T) {
 	// start with a simple context
-	outer := context.Background()
+	outer := t.Context()
 
 	parent, outerCancel := context.WithCancelCause(outer)
 	defer outerCancel(nil)
@@ -119,7 +119,7 @@ func TestCancelCauseSemantics(t *testing.T) {
 func TestTimer(t *testing.T) {
 	delta := 3 * time.Second
 	timer := Timer(delta)
-	ctx := context.Background()
+	ctx := t.Context()
 
 	t0 := time.Now()
 	res := timer(ctx)()
@@ -146,7 +146,7 @@ func TestCanceledApply(t *testing.T) {
 		Ap[string](errValue),
 	)
 
-	res := applied(context.Background())()
+	res := applied(t.Context())()
 	assert.Equal(t, E.Left[string](err), res)
 }
 
@@ -159,7 +159,7 @@ func TestRegularApply(t *testing.T) {
 		Ap[string](value),
 	)
 
-	res := applied(context.Background())()
+	res := applied(t.Context())()
 	assert.Equal(t, E.Of[error]("CARSTEN"), res)
 }
 
@@ -187,7 +187,7 @@ func TestWithResourceNoErrors(t *testing.T) {
 
 	resRIOE := WithResource[int](acquire, release)(body)
 
-	res := resRIOE(context.Background())()
+	res := resRIOE(t.Context())()
 
 	assert.Equal(t, 1, countAcquire)
 	assert.Equal(t, 1, countBody)
@@ -217,7 +217,7 @@ func TestWithResourceErrorInBody(t *testing.T) {
 
 	resRIOE := WithResource[int](acquire, release)(body)
 
-	res := resRIOE(context.Background())()
+	res := resRIOE(t.Context())()
 
 	assert.Equal(t, 1, countAcquire)
 	assert.Equal(t, 0, countBody)
@@ -247,7 +247,7 @@ func TestWithResourceErrorInAcquire(t *testing.T) {
 
 	resRIOE := WithResource[int](acquire, release)(body)
 
-	res := resRIOE(context.Background())()
+	res := resRIOE(t.Context())()
 
 	assert.Equal(t, 0, countAcquire)
 	assert.Equal(t, 0, countBody)
@@ -277,7 +277,7 @@ func TestWithResourceErrorInRelease(t *testing.T) {
 
 	resRIOE := WithResource[int](acquire, release)(body)
 
-	res := resRIOE(context.Background())()
+	res := resRIOE(t.Context())()
 
 	assert.Equal(t, 1, countAcquire)
 	assert.Equal(t, 1, countBody)
@@ -286,7 +286,7 @@ func TestWithResourceErrorInRelease(t *testing.T) {
 }
 
 func TestMonadChainFirstLeft(t *testing.T) {
-	ctx := context.Background()
+	ctx := t.Context()
 
 	// Test with Left value - function returns Left, always preserves original error
 	t.Run("Left value with function returning Left preserves original error", func(t *testing.T) {
@@ -353,7 +353,7 @@ func TestMonadChainFirstLeft(t *testing.T) {
 }
 
 func TestChainFirstLeft(t *testing.T) {
-	ctx := context.Background()
+	ctx := t.Context()
 
 	// Test with Left value - function returns Left, always preserves original error
 	t.Run("Left value with function returning Left preserves error", func(t *testing.T) {

v2/context/readerioresult/rec.go

@@ -108,7 +108,7 @@ import (
 //	countdown := readerioresult.TailRec(countdownStep)
 //
 //	// With cancellation
-//	ctx, cancel := context.WithTimeout(context.Background(), 500*time.Millisecond)
+//	ctx, cancel := context.WithTimeout(t.Context(), 500*time.Millisecond)
 //	defer cancel()
 //	result := countdown(10)(ctx)() // Will be cancelled after ~500ms
 //
@@ -141,7 +141,7 @@ import (
 //	}
 //
 //	processFiles := readerioresult.TailRec(processStep)
-//	ctx, cancel := context.WithCancel(context.Background())
+//	ctx, cancel := context.WithCancel(t.Context())
 //
 //	// Can be cancelled at any point during processing
 //	go func() {
@@ -159,7 +159,7 @@ import (
 //
 //	// Safe for very large inputs with cancellation support
 //	largeCountdown := readerioresult.TailRec(countdownStep)
-//	ctx := context.Background()
+//	ctx := t.Context()
 //	result := largeCountdown(1000000)(ctx)() // Safe, no stack overflow
 //
 // # Performance Considerations

v2/context/readerioresult/rec_test.go

@@ -44,7 +44,7 @@ func TestTailRec_BasicRecursion(t *testing.T) {
 	}
 
 	countdown := TailRec(countdownStep)
-	result := countdown(5)(context.Background())()
+	result := countdown(5)(t.Context())()
 
 	assert.Equal(t, E.Of[error]("Done!"), result)
 }
@@ -71,7 +71,7 @@ func TestTailRec_FactorialRecursion(t *testing.T) {
 	}
 
 	factorial := TailRec(factorialStep)
-	result := factorial(FactorialState{n: 5, acc: 1})(context.Background())()
+	result := factorial(FactorialState{n: 5, acc: 1})(t.Context())()
 
 	assert.Equal(t, E.Of[error](120), result) // 5! = 120
 }
@@ -95,7 +95,7 @@ func TestTailRec_ErrorHandling(t *testing.T) {
 	}
 
 	errorRecursion := TailRec(errorStep)
-	result := errorRecursion(5)(context.Background())()
+	result := errorRecursion(5)(t.Context())()
 
 	assert.True(t, E.IsLeft(result))
 	err := E.ToError(result)
@@ -125,7 +125,7 @@ func TestTailRec_ContextCancellation(t *testing.T) {
 	slowRecursion := TailRec(slowStep)
 
 	// Create a context that will be cancelled after 100ms
-	ctx, cancel := context.WithTimeout(context.Background(), 100*time.Millisecond)
+	ctx, cancel := context.WithTimeout(t.Context(), 100*time.Millisecond)
 	defer cancel()
 
 	start := time.Now()
@@ -159,7 +159,7 @@ func TestTailRec_ImmediateCancellation(t *testing.T) {
 	countdown := TailRec(countdownStep)
 
 	// Create an already cancelled context
-	ctx, cancel := context.WithCancel(context.Background())
+	ctx, cancel := context.WithCancel(t.Context())
 	cancel()
 
 	result := countdown(5)(ctx)()
@@ -186,7 +186,7 @@ func TestTailRec_StackSafety(t *testing.T) {
 	}
 
 	countdown := TailRec(countdownStep)
-	result := countdown(largeN)(context.Background())()
+	result := countdown(largeN)(t.Context())()
 
 	assert.Equal(t, E.Of[error](0), result)
 }
@@ -217,7 +217,7 @@ func TestTailRec_StackSafetyWithCancellation(t *testing.T) {
 	countdown := TailRec(countdownStep)
 
 	// Cancel after 50ms to allow some iterations but not all
-	ctx, cancel := context.WithTimeout(context.Background(), 50*time.Millisecond)
+	ctx, cancel := context.WithTimeout(t.Context(), 50*time.Millisecond)
 	defer cancel()
 
 	result := countdown(largeN)(ctx)()
@@ -274,7 +274,7 @@ func TestTailRec_ComplexState(t *testing.T) {
 			errors:    []error{},
 		}
 
-		result := processItems(initialState)(context.Background())()
+		result := processItems(initialState)(t.Context())()
 
 		assert.Equal(t, E.Of[error]([]string{"item1", "item2", "item3"}), result)
 	})
@@ -286,7 +286,7 @@ func TestTailRec_ComplexState(t *testing.T) {
 			errors:    []error{},
 		}
 
-		result := processItems(initialState)(context.Background())()
+		result := processItems(initialState)(t.Context())()
 
 		assert.True(t, E.IsLeft(result))
 		err := E.ToError(result)
@@ -336,7 +336,7 @@ func TestTailRec_CancellationDuringProcessing(t *testing.T) {
 	}
 
 	// Cancel after 100ms (should allow ~5 files to be processed)
-	ctx, cancel := context.WithTimeout(context.Background(), 100*time.Millisecond)
+	ctx, cancel := context.WithTimeout(t.Context(), 100*time.Millisecond)
 	defer cancel()
 
 	start := time.Now()
@@ -366,7 +366,7 @@ func TestTailRec_ZeroIterations(t *testing.T) {
 	}
 
 	immediate := TailRec(immediateStep)
-	result := immediate(100)(context.Background())()
+	result := immediate(100)(t.Context())()
 
 	assert.Equal(t, E.Of[error]("immediate"), result)
 }
@@ -392,7 +392,7 @@ func TestTailRec_ContextWithDeadline(t *testing.T) {
 	slowRecursion := TailRec(slowStep)
 
 	// Set deadline 80ms from now
-	ctx, cancel := context.WithDeadline(context.Background(), time.Now().Add(80*time.Millisecond))
+	ctx, cancel := context.WithDeadline(t.Context(), time.Now().Add(80*time.Millisecond))
 	defer cancel()
 
 	result := slowRecursion(10)(ctx)()
@@ -427,7 +427,7 @@ func TestTailRec_ContextWithValue(t *testing.T) {
 	}
 
 	valueRecursion := TailRec(valueStep)
-	ctx := context.WithValue(context.Background(), testKey, "test-value")
+	ctx := context.WithValue(t.Context(), testKey, "test-value")
 	result := valueRecursion(3)(ctx)()
 
 	assert.Equal(t, E.Of[error]("Done!"), result)

v2/context/readerioresult/retry.go

@@ -107,7 +107,7 @@ import (
 //	retryingFetch := Retrying(policy, fetchData, shouldRetry)
 //
 //	// Execute with a cancellable context
-//	ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
+//	ctx, cancel := context.WithTimeout(t.Context(), 5*time.Second)
 //	defer cancel()
 //	ioResult := retryingFetch(ctx)
 //	finalResult := ioResult()

v2/context/readerioresult/sync.go

@@ -48,7 +48,7 @@ func WithLock[A any](lock ReaderIOResult[context.CancelFunc]) Operator[A, A] {
 		function.Constant1[context.CancelFunc, ReaderIOResult[A]],
 		WithResource[A](lock, function.Flow2(
 			io.FromImpure[context.CancelFunc],
-			FromIO[any],
+			FromIO[Void],
 		)),
 	)
 }

v2/context/readerioresult/type.go

@@ -23,6 +23,7 @@ import (
 	"github.com/IBM/fp-go/v2/context/readerresult"
 	"github.com/IBM/fp-go/v2/either"
 	"github.com/IBM/fp-go/v2/endomorphism"
+	"github.com/IBM/fp-go/v2/function"
 	"github.com/IBM/fp-go/v2/io"
 	"github.com/IBM/fp-go/v2/ioeither"
 	"github.com/IBM/fp-go/v2/ioref"
@@ -152,4 +153,6 @@ type (
 	IORef[A any] = ioref.IORef[A]
 
 	State[S, A any] = state.State[S, A]
+
+	Void = function.Void
 )

v2/context/readerreaderioresult/bind_test.go

@@ -306,7 +306,7 @@ func TestBindReaderIOK(t *testing.T) {
 
 	res := F.Pipe2(
 		Do[AppConfig](State{Value: 10}),
-		BindReaderIOK[AppConfig](
+		BindReaderIOK(
 			func(v int) func(State) State {
 				return func(s State) State {
 					s.Value = v
@@ -662,7 +662,7 @@ func TestApOperations(t *testing.T) {
 	t.Run("ApReaderS", func(t *testing.T) {
 		res := F.Pipe2(
 			Do[AppConfig](State{}),
-			ApReaderS[AppConfig](
+			ApReaderS(
 				func(v int) func(State) State {
 					return func(s State) State {
 						s.Value1 = v
@@ -681,7 +681,7 @@ func TestApOperations(t *testing.T) {
 	t.Run("ApReaderIOS", func(t *testing.T) {
 		res := F.Pipe2(
 			Do[AppConfig](State{}),
-			ApReaderIOS[AppConfig](
+			ApReaderIOS(
 				func(v int) func(State) State {
 					return func(s State) State {
 						s.Value1 = v

v2/context/readerreaderioresult/bracket.go

@@ -87,9 +87,8 @@ import (
 //go:inline
 func Bracket[
 	R, A, B, ANY any](
-
 	acquire ReaderReaderIOResult[R, A],
-	use func(A) ReaderReaderIOResult[R, B],
+	use Kleisli[R, A, B],
 	release func(A, Result[B]) ReaderReaderIOResult[R, ANY],
 ) ReaderReaderIOResult[R, B] {
 	return RRIOE.Bracket(acquire, use, release)

v2/context/readerreaderioresult/context_test.go

@@ -22,6 +22,7 @@ import (
 	"time"
 
 	F "github.com/IBM/fp-go/v2/function"
+	N "github.com/IBM/fp-go/v2/number"
 	"github.com/IBM/fp-go/v2/result"
 	"github.com/IBM/fp-go/v2/retry"
 	"github.com/stretchr/testify/assert"
@@ -54,7 +55,7 @@ func TestContextCancellationInChain(t *testing.T) {
 	executed := false
 	computation := F.Pipe1(
 		Of[AppConfig](42),
-		Chain[AppConfig](func(n int) ReaderReaderIOResult[AppConfig, int] {
+		Chain(func(n int) ReaderReaderIOResult[AppConfig, int] {
 			return func(c AppConfig) ReaderIOResult[context.Context, int] {
 				return func(ctx context.Context) IOResult[int] {
 					return func() Result[int] {
@@ -231,7 +232,7 @@ func TestContextPropagationThroughMonadTransforms(t *testing.T) {
 		var capturedCtx context.Context
 		computation := F.Pipe1(
 			Of[AppConfig](42),
-			Chain[AppConfig](func(n int) ReaderReaderIOResult[AppConfig, int] {
+			Chain(func(n int) ReaderReaderIOResult[AppConfig, int] {
 				return func(c AppConfig) ReaderIOResult[context.Context, int] {
 					return func(ctx context.Context) IOResult[int] {
 						return func() Result[int] {
@@ -255,7 +256,7 @@ func TestContextPropagationThroughMonadTransforms(t *testing.T) {
 			return func(ctx context.Context) IOResult[func(int) int] {
 				return func() Result[func(int) int] {
 					capturedCtx = ctx
-					return result.Of(func(n int) int { return n * 2 })
+					return result.Of(N.Mul(2))
 				}
 			}
 		}
@@ -404,7 +405,7 @@ func TestContextCancellationBetweenSteps(t *testing.T) {
 				}
 			}
 		},
-		Chain[AppConfig](func(n int) ReaderReaderIOResult[AppConfig, int] {
+		Chain(func(n int) ReaderReaderIOResult[AppConfig, int] {
 			return func(c AppConfig) ReaderIOResult[context.Context, int] {
 				return func(ctx context.Context) IOResult[int] {
 					return func() Result[int] {

v2/context/readerreaderioresult/di_test.go

@@ -0,0 +1,76 @@
+package readerreaderioresult
+
+import (
+	"strconv"
+	"sync"
+	"testing"
+
+	A "github.com/IBM/fp-go/v2/array"
+	RES "github.com/IBM/fp-go/v2/context/readerioresult"
+	"github.com/IBM/fp-go/v2/function"
+	F "github.com/IBM/fp-go/v2/function"
+	"github.com/IBM/fp-go/v2/reader"
+	"github.com/IBM/fp-go/v2/result"
+	"github.com/stretchr/testify/assert"
+)
+
+type (
+	ConsoleDependency interface {
+		Log(msg string) IO[Void]
+	}
+
+	Res[A any] = RES.ReaderIOResult[A]
+
+	ConsoleEnv[A any] = ReaderReaderIOResult[ConsoleDependency, A]
+
+	consoleOnArray struct {
+		logs []string
+		mu   sync.Mutex
+	}
+)
+
+var (
+	logConsole = reader.Curry1(ConsoleDependency.Log)
+)
+
+func (c *consoleOnArray) Log(msg string) IO[Void] {
+	return func() Void {
+		c.mu.Lock()
+		defer c.mu.Unlock()
+
+		c.logs = append(c.logs, msg)
+		return function.VOID
+	}
+}
+
+func makeConsoleOnArray() *consoleOnArray {
+	return &consoleOnArray{}
+}
+
+func TestConsoleEnv(t *testing.T) {
+	console := makeConsoleOnArray()
+
+	prg := F.Pipe1(
+		Of[ConsoleDependency]("Hello World!"),
+		TapReaderIOK(logConsole),
+	)
+
+	res := prg(console)(t.Context())()
+
+	assert.Equal(t, result.Of("Hello World!"), res)
+	assert.Equal(t, A.Of("Hello World!"), console.logs)
+}
+
+func TestConsoleEnvWithLocal(t *testing.T) {
+	console := makeConsoleOnArray()
+
+	prg := F.Pipe1(
+		Of[ConsoleDependency](42),
+		TapReaderIOK(reader.WithLocal(logConsole, strconv.Itoa)),
+	)
+
+	res := prg(console)(t.Context())()
+
+	assert.Equal(t, result.Of(42), res)
+	assert.Equal(t, A.Of("42"), console.logs)
+}

v2/context/readerreaderioresult/doc.go

@@ -238,6 +238,236 @@
 //   - Retry logic with policy configuration and execution context
 //   - Resource management with bracket pattern across multiple contexts
 //
+// # Dependency Injection with the Outer Context
+//
+// The outer Reader context (type parameter R) provides a powerful mechanism for dependency injection
+// in functional programming. This pattern is explained in detail in Scott Wlaschin's talk:
+// "Dependency Injection, The Functional Way" - https://www.youtube.com/watch?v=xPlsVVaMoB0
+//
+// ## Core Concept
+//
+// Instead of using traditional OOP dependency injection frameworks, the Reader monad allows you to:
+//  1. Define functions that declare their dependencies as type parameters
+//  2. Compose these functions without providing the dependencies
+//  3. Supply all dependencies at the "end of the world" (program entry point)
+//
+// This approach provides:
+//   - Compile-time safety: Missing dependencies cause compilation errors
+//   - Explicit dependencies: Function signatures show exactly what they need
+//   - Easy testing: Mock dependencies by providing different values
+//   - Pure functions: Dependencies are passed as parameters, not global state
+//
+// ## Examples from the Video Adapted to fp-go
+//
+// ### Example 1: Basic Reader Pattern (Video: "Reader Monad Basics")
+//
+// In the video, Scott shows how to pass configuration through a chain of functions.
+// In fp-go with ReaderReaderIOResult:
+//
+//	// Define your dependencies
+//	type AppConfig struct {
+//	    DatabaseURL string
+//	    APIKey      string
+//	    MaxRetries  int
+//	}
+//
+//	// Functions declare their dependencies via the R type parameter
+//	func getConnectionString() ReaderReaderIOResult[AppConfig, string] {
+//	    return Asks[AppConfig](func(cfg AppConfig) string {
+//	        return cfg.DatabaseURL
+//	    })
+//	}
+//
+//	func connectToDatabase() ReaderReaderIOResult[AppConfig, *sql.DB] {
+//	    return MonadChain(
+//	        getConnectionString(),
+//	        func(connStr string) ReaderReaderIOResult[AppConfig, *sql.DB] {
+//	            return FromIO[AppConfig](func() result.Result[*sql.DB] {
+//	                db, err := sql.Open("postgres", connStr)
+//	                return result.FromEither(either.FromError(db, err))
+//	            })
+//	        },
+//	    )
+//	}
+//
+// ### Example 2: Composing Dependencies (Video: "Composing Reader Functions")
+//
+// The video demonstrates how Reader functions compose naturally.
+// In fp-go, you can compose operations that all share the same dependency:
+//
+//	func fetchUser(id int) ReaderReaderIOResult[AppConfig, User] {
+//	    return MonadChain(
+//	        connectToDatabase(),
+//	        func(db *sql.DB) ReaderReaderIOResult[AppConfig, User] {
+//	            return FromIO[AppConfig](func() result.Result[User] {
+//	                // Query database using db and return user
+//	                // The AppConfig is still available if needed
+//	            })
+//	        },
+//	    )
+//	}
+//
+//	func enrichUser(user User) ReaderReaderIOResult[AppConfig, EnrichedUser] {
+//	    return Asks[AppConfig, EnrichedUser](func(cfg AppConfig) EnrichedUser {
+//	        // Use cfg.APIKey to call external service
+//	        return EnrichedUser{User: user, Extra: "data"}
+//	    })
+//	}
+//
+//	// Compose without providing dependencies
+//	pipeline := function.Pipe2(
+//	    fetchUser(123),
+//	    Chain[AppConfig](enrichUser),
+//	)
+//
+//	// Provide dependencies at the end
+//	config := AppConfig{DatabaseURL: "...", APIKey: "...", MaxRetries: 3}
+//	ctx := context.Background()
+//	result := pipeline(config)(ctx)()
+//
+// ### Example 3: Local Context Modification (Video: "Local Environment")
+//
+// The video shows how to temporarily modify the environment for a sub-computation.
+// In fp-go, use the Local function:
+//
+//	// Run a computation with modified configuration
+//	func withRetries(retries int, action ReaderReaderIOResult[AppConfig, string]) ReaderReaderIOResult[AppConfig, string] {
+//	    return Local[string](func(cfg AppConfig) AppConfig {
+//	        // Create a modified config with different retry count
+//	        return AppConfig{
+//	            DatabaseURL: cfg.DatabaseURL,
+//	            APIKey:      cfg.APIKey,
+//	            MaxRetries:  retries,
+//	        }
+//	    })(action)
+//	}
+//
+//	// Use it
+//	result := withRetries(5, fetchUser(123))
+//
+// ### Example 4: Testing with Mock Dependencies (Video: "Testing with Reader")
+//
+// The video emphasizes how Reader makes testing easy by allowing mock dependencies.
+// In fp-go:
+//
+//	func TestFetchUser(t *testing.T) {
+//	    // Create a test configuration
+//	    testConfig := AppConfig{
+//	        DatabaseURL: "mock://test",
+//	        APIKey:      "test-key",
+//	        MaxRetries:  1,
+//	    }
+//
+//	    // Run the computation with test config
+//	    ctx := context.Background()
+//	    result := fetchUser(123)(testConfig)(ctx)()
+//
+//	    // Assert on the result
+//	    assert.True(t, either.IsRight(result))
+//	}
+//
+// ### Example 5: Multi-Layer Dependencies (Video: "Nested Readers")
+//
+// The video discusses nested readers for multi-layer architectures.
+// ReaderReaderIOResult provides exactly this with R (outer) and context.Context (inner):
+//
+//	type AppConfig struct {
+//	    DatabaseURL string
+//	}
+//
+//	// Outer context: Application-level configuration (AppConfig)
+//	// Inner context: Request-level context (context.Context)
+//	func handleRequest(userID int) ReaderReaderIOResult[AppConfig, Response] {
+//	    return func(cfg AppConfig) readerioresult.ReaderIOResult[context.Context, Response] {
+//	        // cfg is available here (outer context)
+//	        return func(ctx context.Context) ioresult.IOResult[Response] {
+//	            // ctx is available here (inner context)
+//	            // Both cfg and ctx can be used
+//	            return func() result.Result[Response] {
+//	                // Perform operation using both contexts
+//	                select {
+//	                case <-ctx.Done():
+//	                    return result.Error[Response](ctx.Err())
+//	                default:
+//	                    // Use cfg.DatabaseURL to connect
+//	                    return result.Of(Response{})
+//	                }
+//	            }
+//	        }
+//	    }
+//	}
+//
+// ### Example 6: Avoiding Global State (Video: "Problems with Global State")
+//
+// The video criticizes global state and shows how Reader solves this.
+// In fp-go, instead of:
+//
+//	// BAD: Global state
+//	var globalConfig AppConfig
+//
+//	func fetchUser(id int) result.Result[User] {
+//	    // Uses globalConfig implicitly
+//	    db := connectTo(globalConfig.DatabaseURL)
+//	    // ...
+//	}
+//
+// Use Reader to make dependencies explicit:
+//
+//	// GOOD: Explicit dependencies
+//	func fetchUser(id int) ReaderReaderIOResult[AppConfig, User] {
+//	    return MonadChain(
+//	        Ask[AppConfig](), // Explicitly request the config
+//	        func(cfg AppConfig) ReaderReaderIOResult[AppConfig, User] {
+//	            // Use cfg explicitly
+//	            return FromIO[AppConfig](func() result.Result[User] {
+//	                db := connectTo(cfg.DatabaseURL)
+//	                // ...
+//	            })
+//	        },
+//	    )
+//	}
+//
+// ## Benefits of This Approach
+//
+// 1. **Type Safety**: The compiler ensures all dependencies are provided
+// 2. **Testability**: Easy to provide mock dependencies for testing
+// 3. **Composability**: Functions compose naturally without dependency wiring
+// 4. **Explicitness**: Function signatures document their dependencies
+// 5. **Immutability**: Dependencies are immutable values, not mutable global state
+// 6. **Flexibility**: Use Local to modify dependencies for sub-computations
+// 7. **Separation of Concerns**: Business logic is separate from dependency resolution
+//
+// ## Comparison with Traditional DI
+//
+// Traditional OOP DI (e.g., Spring, Guice):
+//   - Runtime dependency resolution
+//   - Magic/reflection-based wiring
+//   - Implicit dependencies (hidden in constructors)
+//   - Mutable containers
+//
+// Reader-based DI (fp-go):
+//   - Compile-time dependency resolution
+//   - Explicit function composition
+//   - Explicit dependencies (in type signatures)
+//   - Immutable values
+//
+// ## When to Use Each Layer
+//
+// - **Outer Reader (R)**: Application-level dependencies that rarely change
+//   - Database connection pools
+//   - API keys and secrets
+//   - Feature flags
+//   - Application configuration
+//
+// - **Inner Reader (context.Context)**: Request-level dependencies that change per operation
+//   - Request IDs and tracing
+//   - Cancellation signals
+//   - Deadlines and timeouts
+//   - User authentication tokens
+//
+// This two-layer approach mirrors the video's discussion of nested readers and provides
+// a clean separation between application-level and request-level concerns.
+//
 // # Relationship to Other Packages
 //
 //   - readerreaderioeither: The generic version with configurable error and context types

v2/context/readerreaderioresult/flip.go

@@ -0,0 +1,291 @@
+// Copyright (c) 2023 - 2025 IBM Corp.
+// All rights reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package readerreaderioresult
+
+import (
+	"github.com/IBM/fp-go/v2/internal/readert"
+	"github.com/IBM/fp-go/v2/reader"
+	"github.com/IBM/fp-go/v2/readerioeither"
+	RRIOE "github.com/IBM/fp-go/v2/readerreaderioeither"
+)
+
+// Sequence swaps the order of nested environment parameters in a ReaderReaderIOResult computation.
+//
+// This function takes a ReaderReaderIOResult that produces another ReaderReaderIOResult and returns a
+// Kleisli arrow that reverses the order of the outer environment parameters (R1 and R2). The result is
+// a curried function that takes R1 first, then R2, and produces a computation with context.Context and error handling.
+//
+// Type Parameters:
+//   - R1: The first outer environment type (becomes the outermost after sequence)
+//   - R2: The second outer environment type (becomes inner after sequence)
+//   - A: The success value type
+//
+// Parameters:
+//   - ma: A ReaderReaderIOResult[R2, ReaderReaderIOResult[R1, A]]
+//
+// Returns:
+//   - A Kleisli[R2, R1, A], which is func(R1) ReaderReaderIOResult[R2, A]
+//
+// The function preserves error handling and IO effects at all levels while reordering the
+// outer environment dependencies. The inner context.Context layer remains unchanged.
+//
+// This is particularly useful when you need to change the order in which contexts are provided
+// to a nested computation, such as when composing operations that have different dependency orders.
+//
+// Example:
+//
+//	type AppConfig struct {
+//	    DatabaseURL string
+//	}
+//	type UserPrefs struct {
+//	    Theme string
+//	}
+//
+//	// Original: takes AppConfig, returns computation that may produce
+//	// another computation depending on UserPrefs
+//	original := func(cfg AppConfig) readerioresult.ReaderIOResult[context.Context,
+//	    ReaderReaderIOResult[UserPrefs, string]] {
+//	    return readerioresult.Of[context.Context](
+//	        Of[UserPrefs]("result"),
+//	    )
+//	}
+//
+//	// Sequence swaps UserPrefs and AppConfig order
+//	sequenced := Sequence[UserPrefs, AppConfig, string](original)
+//
+//	// Now provide UserPrefs first, then AppConfig
+//	ctx := context.Background()
+//	result := sequenced(UserPrefs{Theme: "dark"})(AppConfig{DatabaseURL: "db"})(ctx)()
+func Sequence[R1, R2, A any](ma ReaderReaderIOResult[R2, ReaderReaderIOResult[R1, A]]) Kleisli[R2, R1, A] {
+	return readert.Sequence(
+		readerioeither.Chain,
+		ma,
+	)
+}
+
+// SequenceReader swaps the order of environment parameters when the inner computation is a pure Reader.
+//
+// This function is similar to Sequence but specialized for the case where the innermost computation
+// is a pure Reader (without IO or error handling) rather than another ReaderReaderIOResult. It takes
+// a ReaderReaderIOResult that produces a Reader and returns a Kleisli arrow that reverses the order
+// of the outer environment parameters.
+//
+// Type Parameters:
+//   - R1: The first environment type (becomes outermost after sequence)
+//   - R2: The second environment type (becomes inner after sequence)
+//   - A: The success value type
+//
+// Parameters:
+//   - ma: A ReaderReaderIOResult[R2, Reader[R1, A]]
+//
+// Returns:
+//   - A Kleisli[R2, R1, A], which is func(R1) ReaderReaderIOResult[R2, A]
+//
+// The function lifts the pure Reader computation into the ReaderIOResult context (with context.Context
+// and error handling) while reordering the environment dependencies.
+//
+// Example:
+//
+//	type AppConfig struct {
+//	    Multiplier int
+//	}
+//	type Database struct {
+//	    ConnectionString string
+//	}
+//
+//	// Original: takes AppConfig, may produce a Reader[Database, int]
+//	original := func(cfg AppConfig) readerioresult.ReaderIOResult[context.Context, reader.Reader[Database, int]] {
+//	    return readerioresult.Of[context.Context](func(db Database) int {
+//	        return len(db.ConnectionString) * cfg.Multiplier
+//	    })
+//	}
+//
+//	// Sequence to provide Database first, then AppConfig
+//	sequenced := SequenceReader[Database, AppConfig, int](original)
+//	ctx := context.Background()
+//	result := sequenced(Database{ConnectionString: "localhost"})(AppConfig{Multiplier: 2})(ctx)()
+func SequenceReader[R1, R2, A any](ma ReaderReaderIOResult[R2, Reader[R1, A]]) Kleisli[R2, R1, A] {
+	return readert.SequenceReader(
+		readerioeither.Map,
+		ma,
+	)
+}
+
+// SequenceReaderIO swaps the order of environment parameters when the inner computation is a ReaderIO.
+//
+// This function is specialized for the case where the innermost computation is a ReaderIO
+// (with IO effects but no error handling) rather than another ReaderReaderIOResult. It takes
+// a ReaderReaderIOResult that produces a ReaderIO and returns a Kleisli arrow that reverses
+// the order of the outer environment parameters.
+//
+// Type Parameters:
+//   - R1: The first environment type (becomes outermost after sequence)
+//   - R2: The second environment type (becomes inner after sequence)
+//   - A: The success value type
+//
+// Parameters:
+//   - ma: A ReaderReaderIOResult[R2, ReaderIO[R1, A]]
+//
+// Returns:
+//   - A Kleisli[R2, R1, A], which is func(R1) ReaderReaderIOResult[R2, A]
+//
+// The function lifts the ReaderIO computation (which has IO effects but no error handling)
+// into the ReaderIOResult context (with context.Context and error handling) while reordering
+// the environment dependencies.
+//
+// Example:
+//
+//	type AppConfig struct {
+//	    FilePath string
+//	}
+//	type Logger struct {
+//	    Level string
+//	}
+//
+//	// Original: takes AppConfig, may produce a ReaderIO[Logger, string]
+//	original := func(cfg AppConfig) readerioresult.ReaderIOResult[context.Context, readerio.ReaderIO[Logger, string]] {
+//	    return readerioresult.Of[context.Context](func(logger Logger) io.IO[string] {
+//	        return func() string {
+//	            return fmt.Sprintf("[%s] Reading from %s", logger.Level, cfg.FilePath)
+//	        }
+//	    })
+//	}
+//
+//	// Sequence to provide Logger first, then AppConfig
+//	sequenced := SequenceReaderIO[Logger, AppConfig, string](original)
+//	ctx := context.Background()
+//	result := sequenced(Logger{Level: "INFO"})(AppConfig{FilePath: "/data"})(ctx)()
+func SequenceReaderIO[R1, R2, A any](ma ReaderReaderIOResult[R2, ReaderIO[R1, A]]) Kleisli[R2, R1, A] {
+	return RRIOE.SequenceReaderIO(ma)
+}
+
+// Traverse transforms a ReaderReaderIOResult computation by applying a function that produces
+// another ReaderReaderIOResult, effectively swapping the order of outer environment parameters.
+//
+// This function is useful when you have a computation that depends on environment R2 and
+// produces a value of type A, and you want to transform it using a function that takes A
+// and produces a computation depending on environment R1. The result is a curried function
+// that takes R1 first, then R2, and produces a computation with context.Context and error handling.
+//
+// Type Parameters:
+//   - R2: The outer environment type from the original computation
+//   - R1: The inner environment type introduced by the transformation
+//   - A: The input value type
+//   - B: The output value type
+//
+// Parameters:
+//   - f: A Kleisli arrow that transforms A into a ReaderReaderIOResult[R1, B]
+//
+// Returns:
+//   - A function that takes a ReaderReaderIOResult[R2, A] and returns a Kleisli[R2, R1, B],
+//     which is func(R1) ReaderReaderIOResult[R2, B]
+//
+// The function preserves error handling and IO effects while reordering the environment dependencies.
+// This is the generalized version of Sequence that also applies a transformation function.
+//
+// Example:
+//
+//	type AppConfig struct {
+//	    SystemID string
+//	}
+//	type UserConfig struct {
+//	    UserID int
+//	}
+//
+//	// Original computation depending on AppConfig
+//	original := Of[AppConfig](42)
+//
+//	// Transformation that introduces UserConfig dependency
+//	transform := func(n int) ReaderReaderIOResult[UserConfig, string] {
+//	    return func(userCfg UserConfig) readerioresult.ReaderIOResult[context.Context, string] {
+//	        return readerioresult.Of[context.Context](fmt.Sprintf("User %d: %d", userCfg.UserID, n))
+//	    }
+//	}
+//
+//	// Apply traverse to swap order and transform
+//	traversed := Traverse[AppConfig, UserConfig, int, string](transform)(original)
+//
+//	// Provide UserConfig first, then AppConfig
+//	ctx := context.Background()
+//	result := traversed(UserConfig{UserID: 1})(AppConfig{SystemID: "sys1"})(ctx)()
+func Traverse[R2, R1, A, B any](
+	f Kleisli[R1, A, B],
+) func(ReaderReaderIOResult[R2, A]) Kleisli[R2, R1, B] {
+	return readert.Traverse[ReaderReaderIOResult[R2, A]](
+		readerioeither.Map,
+		readerioeither.Chain,
+		f,
+	)
+}
+
+// TraverseReader transforms a ReaderReaderIOResult computation by applying a Reader-based function,
+// effectively introducing a new environment dependency.
+//
+// This function takes a Reader-based transformation (Kleisli arrow) and returns a function that
+// can transform a ReaderReaderIOResult. The result allows you to provide the Reader's environment (R1)
+// first, which then produces a ReaderReaderIOResult that depends on environment R2.
+//
+// Type Parameters:
+//   - R2: The outer environment type from the original ReaderReaderIOResult
+//   - R1: The inner environment type introduced by the Reader transformation
+//   - A: The input value type
+//   - B: The output value type
+//
+// Parameters:
+//   - f: A Reader-based Kleisli arrow that transforms A to B using environment R1
+//
+// Returns:
+//   - A function that takes a ReaderReaderIOResult[R2, A] and returns a Kleisli[R2, R1, B],
+//     which is func(R1) ReaderReaderIOResult[R2, B]
+//
+// The function preserves error handling and IO effects while adding the Reader environment dependency
+// and reordering the environment parameters. This is useful when you want to introduce a pure
+// (non-IO, non-error) environment dependency to an existing computation.
+//
+// Example:
+//
+//	type AppConfig struct {
+//	    Timeout int
+//	}
+//	type UserPreferences struct {
+//	    Theme string
+//	}
+//
+//	// Original computation depending on AppConfig
+//	original := Of[AppConfig](100)
+//
+//	// Pure Reader transformation that introduces UserPreferences dependency
+//	formatWithTheme := func(value int) reader.Reader[UserPreferences, string] {
+//	    return func(prefs UserPreferences) string {
+//	        return fmt.Sprintf("[%s theme] Value: %d", prefs.Theme, value)
+//	    }
+//	}
+//
+//	// Apply traverse to introduce UserPreferences and swap order
+//	traversed := TraverseReader[AppConfig, UserPreferences, int, string](formatWithTheme)(original)
+//
+//	// Provide UserPreferences first, then AppConfig
+//	ctx := context.Background()
+//	result := traversed(UserPreferences{Theme: "dark"})(AppConfig{Timeout: 30})(ctx)()
+func TraverseReader[R2, R1, A, B any](
+	f reader.Kleisli[R1, A, B],
+) func(ReaderReaderIOResult[R2, A]) Kleisli[R2, R1, B] {
+	return readert.TraverseReader[ReaderReaderIOResult[R2, A]](
+		readerioeither.Map,
+		readerioeither.Map,
+		f,
+	)
+}

v2/context/readerreaderioresult/flip_test.go

@@ -0,0 +1,778 @@
+// Copyright (c) 2023 - 2025 IBM Corp.
+// All rights reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package readerreaderioresult
+
+import (
+	"context"
+	"errors"
+	"fmt"
+	"testing"
+
+	RIORES "github.com/IBM/fp-go/v2/context/readerioresult"
+	F "github.com/IBM/fp-go/v2/function"
+	"github.com/IBM/fp-go/v2/io"
+	"github.com/IBM/fp-go/v2/reader"
+	"github.com/IBM/fp-go/v2/result"
+	"github.com/stretchr/testify/assert"
+)
+
+type Config1 struct {
+	value1 int
+}
+
+type Config2 struct {
+	value2 string
+}
+
+func TestSequence(t *testing.T) {
+	t.Run("swaps parameter order for simple types", func(t *testing.T) {
+		ctx := t.Context()
+
+		// Original: takes Config2, returns ReaderIOResult that may produce ReaderReaderIOResult[Config1, int]
+		original := func(cfg2 Config2) RIORES.ReaderIOResult[ReaderReaderIOResult[Config1, int]] {
+			return func(ctx1 context.Context) IOResult[ReaderReaderIOResult[Config1, int]] {
+				return func() Result[ReaderReaderIOResult[Config1, int]] {
+					return result.Of(func(cfg1 Config1) RIORES.ReaderIOResult[int] {
+						return func(ctx2 context.Context) IOResult[int] {
+							return func() Result[int] {
+								return result.Of(cfg1.value1 + len(cfg2.value2))
+							}
+						}
+					})
+				}
+			}
+		}
+
+		// Sequence swaps Config1 and Config2 order
+		sequenced := Sequence(original)
+
+		cfg1 := Config1{value1: 10}
+		cfg2 := Config2{value2: "hello"}
+
+		// Test original: Config2 -> Context -> Config1 -> Context
+		result1 := original(cfg2)(ctx)()
+		assert.True(t, result.IsRight(result1))
+		innerFunc1, _ := result.Unwrap(result1)
+		innerResult1 := innerFunc1(cfg1)(ctx)()
+		assert.Equal(t, result.Of(15), innerResult1)
+
+		// Test sequenced: Config1 -> Config2 -> Context
+		innerFunc2 := sequenced(cfg1)
+		innerResult2 := innerFunc2(cfg2)(ctx)()
+		assert.Equal(t, result.Of(15), innerResult2)
+	})
+
+	t.Run("preserves error handling", func(t *testing.T) {
+		ctx := t.Context()
+		testErr := errors.New("test error")
+
+		// Original that returns an error
+		original := func(cfg2 Config2) RIORES.ReaderIOResult[ReaderReaderIOResult[Config1, int]] {
+			return func(ctx context.Context) IOResult[ReaderReaderIOResult[Config1, int]] {
+				return func() Result[ReaderReaderIOResult[Config1, int]] {
+					return result.Left[ReaderReaderIOResult[Config1, int]](testErr)
+				}
+			}
+		}
+
+		sequenced := Sequence(original)
+
+		cfg1 := Config1{value1: 10}
+		cfg2 := Config2{value2: "hello"}
+
+		// Test sequenced preserves error
+		innerFunc := sequenced(cfg1)
+		outcome := innerFunc(cfg2)(ctx)()
+		assert.Equal(t, result.Left[int](testErr), outcome)
+	})
+
+	t.Run("works with nested computations", func(t *testing.T) {
+		ctx := t.Context()
+
+		// Original with nested logic
+		original := func(cfg2 Config2) RIORES.ReaderIOResult[ReaderReaderIOResult[Config1, string]] {
+			return func(ctx context.Context) IOResult[ReaderReaderIOResult[Config1, string]] {
+				return func() Result[ReaderReaderIOResult[Config1, string]] {
+					if len(cfg2.value2) == 0 {
+						return result.Left[ReaderReaderIOResult[Config1, string]](errors.New("empty string"))
+					}
+					return result.Of(func(cfg1 Config1) RIORES.ReaderIOResult[string] {
+						return func(ctx context.Context) IOResult[string] {
+							return func() Result[string] {
+								if cfg1.value1 < 0 {
+									return result.Left[string](errors.New("negative value"))
+								}
+								return result.Of(fmt.Sprintf("%s:%d", cfg2.value2, cfg1.value1))
+							}
+						}
+					})
+				}
+			}
+		}
+
+		sequenced := Sequence(original)
+
+		// Test with valid inputs
+		result1 := sequenced(Config1{value1: 42})(Config2{value2: "test"})(ctx)()
+		assert.Equal(t, result.Of("test:42"), result1)
+
+		// Test with empty string
+		result2 := sequenced(Config1{value1: 42})(Config2{value2: ""})(ctx)()
+		assert.True(t, result.IsLeft(result2))
+
+		// Test with negative value
+		result3 := sequenced(Config1{value1: -1})(Config2{value2: "test"})(ctx)()
+		assert.True(t, result.IsLeft(result3))
+	})
+
+	t.Run("works with zero values", func(t *testing.T) {
+		ctx := t.Context()
+
+		original := func(cfg2 Config2) RIORES.ReaderIOResult[ReaderReaderIOResult[Config1, int]] {
+			return func(ctx context.Context) IOResult[ReaderReaderIOResult[Config1, int]] {
+				return func() Result[ReaderReaderIOResult[Config1, int]] {
+					return result.Of(func(cfg1 Config1) RIORES.ReaderIOResult[int] {
+						return func(ctx context.Context) IOResult[int] {
+							return func() Result[int] {
+								return result.Of(cfg1.value1 + len(cfg2.value2))
+							}
+						}
+					})
+				}
+			}
+		}
+
+		sequenced := Sequence(original)
+
+		outcome := sequenced(Config1{value1: 0})(Config2{value2: ""})(ctx)()
+		assert.Equal(t, result.Of(0), outcome)
+	})
+
+	t.Run("maintains referential transparency", func(t *testing.T) {
+		ctx := t.Context()
+
+		original := func(cfg2 Config2) RIORES.ReaderIOResult[ReaderReaderIOResult[Config1, int]] {
+			return func(ctx context.Context) IOResult[ReaderReaderIOResult[Config1, int]] {
+				return func() Result[ReaderReaderIOResult[Config1, int]] {
+					return result.Of(func(cfg1 Config1) RIORES.ReaderIOResult[int] {
+						return func(ctx context.Context) IOResult[int] {
+							return func() Result[int] {
+								return result.Of(cfg1.value1 * len(cfg2.value2))
+							}
+						}
+					})
+				}
+			}
+		}
+
+		sequenced := Sequence(original)
+
+		cfg1 := Config1{value1: 3}
+		cfg2 := Config2{value2: "test"}
+
+		// Call multiple times with same inputs
+		for range 5 {
+			outcome := sequenced(cfg1)(cfg2)(ctx)()
+			assert.Equal(t, result.Of(12), outcome)
+		}
+	})
+}
+
+func TestSequenceReader(t *testing.T) {
+	t.Run("swaps parameter order for Reader types", func(t *testing.T) {
+		ctx := t.Context()
+
+		// Original: takes Config2, returns ReaderIOResult that may produce Reader[Config1, int]
+		original := func(cfg2 Config2) RIORES.ReaderIOResult[Reader[Config1, int]] {
+			return func(ctx context.Context) IOResult[Reader[Config1, int]] {
+				return func() Result[Reader[Config1, int]] {
+					return result.Of(func(cfg1 Config1) int {
+						return cfg1.value1 + len(cfg2.value2)
+					})
+				}
+			}
+		}
+
+		// Sequence swaps Config1 and Config2 order
+		sequenced := SequenceReader(original)
+
+		cfg1 := Config1{value1: 10}
+		cfg2 := Config2{value2: "hello"}
+
+		// Test original
+		result1 := original(cfg2)(ctx)()
+		assert.True(t, result.IsRight(result1))
+		innerFunc1, _ := result.Unwrap(result1)
+		value1 := innerFunc1(cfg1)
+		assert.Equal(t, 15, value1)
+
+		// Test sequenced
+		innerFunc2 := sequenced(cfg1)
+		result2 := innerFunc2(cfg2)(ctx)()
+		assert.True(t, result.IsRight(result2))
+		value2, _ := result.Unwrap(result2)
+		assert.Equal(t, 15, value2)
+	})
+
+	t.Run("preserves error handling", func(t *testing.T) {
+		ctx := t.Context()
+		testErr := errors.New("test error")
+
+		original := func(cfg2 Config2) RIORES.ReaderIOResult[Reader[Config1, int]] {
+			return func(ctx context.Context) IOResult[Reader[Config1, int]] {
+				return func() Result[Reader[Config1, int]] {
+					return result.Left[Reader[Config1, int]](testErr)
+				}
+			}
+		}
+
+		sequenced := SequenceReader(original)
+
+		outcome := sequenced(Config1{value1: 10})(Config2{value2: "hello"})(ctx)()
+		assert.Equal(t, result.Left[int](testErr), outcome)
+	})
+
+	t.Run("works with pure Reader computations", func(t *testing.T) {
+		ctx := t.Context()
+
+		original := func(cfg2 Config2) RIORES.ReaderIOResult[Reader[Config1, string]] {
+			return func(ctx context.Context) IOResult[Reader[Config1, string]] {
+				return func() Result[Reader[Config1, string]] {
+					if len(cfg2.value2) == 0 {
+						return result.Left[Reader[Config1, string]](errors.New("empty string"))
+					}
+					return result.Of(func(cfg1 Config1) string {
+						return fmt.Sprintf("%s:%d", cfg2.value2, cfg1.value1)
+					})
+				}
+			}
+		}
+
+		sequenced := SequenceReader(original)
+
+		// Test with valid inputs
+		result1 := sequenced(Config1{value1: 42})(Config2{value2: "test"})(ctx)()
+		assert.Equal(t, result.Of("test:42"), result1)
+
+		// Test with empty string
+		result2 := sequenced(Config1{value1: 42})(Config2{value2: ""})(ctx)()
+		assert.True(t, result.IsLeft(result2))
+	})
+
+	t.Run("works with zero values", func(t *testing.T) {
+		ctx := t.Context()
+
+		original := func(cfg2 Config2) RIORES.ReaderIOResult[Reader[Config1, int]] {
+			return func(ctx context.Context) IOResult[Reader[Config1, int]] {
+				return func() Result[Reader[Config1, int]] {
+					return result.Of(func(cfg1 Config1) int {
+						return cfg1.value1 + len(cfg2.value2)
+					})
+				}
+			}
+		}
+
+		sequenced := SequenceReader(original)
+
+		outcome := sequenced(Config1{value1: 0})(Config2{value2: ""})(ctx)()
+		assert.Equal(t, result.Of(0), outcome)
+	})
+
+	t.Run("maintains referential transparency", func(t *testing.T) {
+		ctx := t.Context()
+
+		original := func(cfg2 Config2) RIORES.ReaderIOResult[Reader[Config1, int]] {
+			return func(ctx context.Context) IOResult[Reader[Config1, int]] {
+				return func() Result[Reader[Config1, int]] {
+					return result.Of(func(cfg1 Config1) int {
+						return cfg1.value1 * len(cfg2.value2)
+					})
+				}
+			}
+		}
+
+		sequenced := SequenceReader(original)
+
+		cfg1 := Config1{value1: 3}
+		cfg2 := Config2{value2: "test"}
+
+		// Call multiple times with same inputs
+		for range 5 {
+			outcome := sequenced(cfg1)(cfg2)(ctx)()
+			assert.Equal(t, result.Of(12), outcome)
+		}
+	})
+}
+
+func TestSequenceReaderIO(t *testing.T) {
+	t.Run("swaps parameter order for ReaderIO types", func(t *testing.T) {
+		ctx := t.Context()
+
+		// Original: takes Config2, returns ReaderIOResult that may produce ReaderIO[Config1, int]
+		original := func(cfg2 Config2) RIORES.ReaderIOResult[ReaderIO[Config1, int]] {
+			return func(ctx context.Context) IOResult[ReaderIO[Config1, int]] {
+				return func() Result[ReaderIO[Config1, int]] {
+					return result.Of(func(cfg1 Config1) io.IO[int] {
+						return io.Of(cfg1.value1 + len(cfg2.value2))
+					})
+				}
+			}
+		}
+
+		// Sequence swaps Config1 and Config2 order
+		sequenced := SequenceReaderIO(original)
+
+		cfg1 := Config1{value1: 10}
+		cfg2 := Config2{value2: "hello"}
+
+		// Test original
+		result1 := original(cfg2)(ctx)()
+		assert.True(t, result.IsRight(result1))
+		innerFunc1, _ := result.Unwrap(result1)
+		value1 := innerFunc1(cfg1)()
+		assert.Equal(t, 15, value1)
+
+		// Test sequenced
+		innerFunc2 := sequenced(cfg1)
+		result2 := innerFunc2(cfg2)(ctx)()
+		assert.True(t, result.IsRight(result2))
+		value2, _ := result.Unwrap(result2)
+		assert.Equal(t, 15, value2)
+	})
+
+	t.Run("preserves error handling", func(t *testing.T) {
+		ctx := t.Context()
+		testErr := errors.New("test error")
+
+		original := func(cfg2 Config2) RIORES.ReaderIOResult[ReaderIO[Config1, int]] {
+			return func(ctx context.Context) IOResult[ReaderIO[Config1, int]] {
+				return func() Result[ReaderIO[Config1, int]] {
+					return result.Left[ReaderIO[Config1, int]](testErr)
+				}
+			}
+		}
+
+		sequenced := SequenceReaderIO(original)
+
+		outcome := sequenced(Config1{value1: 10})(Config2{value2: "hello"})(ctx)()
+		assert.Equal(t, result.Left[int](testErr), outcome)
+	})
+
+	t.Run("works with IO effects", func(t *testing.T) {
+		ctx := t.Context()
+		sideEffect := 0
+
+		original := func(cfg2 Config2) RIORES.ReaderIOResult[ReaderIO[Config1, string]] {
+			return func(ctx context.Context) IOResult[ReaderIO[Config1, string]] {
+				return func() Result[ReaderIO[Config1, string]] {
+					if len(cfg2.value2) == 0 {
+						return result.Left[ReaderIO[Config1, string]](errors.New("empty string"))
+					}
+					return result.Of(func(cfg1 Config1) io.IO[string] {
+						return func() string {
+							sideEffect = cfg1.value1
+							return fmt.Sprintf("%s:%d", cfg2.value2, cfg1.value1)
+						}
+					})
+				}
+			}
+		}
+
+		sequenced := SequenceReaderIO(original)
+
+		// Test with valid inputs
+		sideEffect = 0
+		result1 := sequenced(Config1{value1: 42})(Config2{value2: "test"})(ctx)()
+		assert.Equal(t, result.Of("test:42"), result1)
+		assert.Equal(t, 42, sideEffect)
+
+		// Test with empty string
+		sideEffect = 0
+		result2 := sequenced(Config1{value1: 42})(Config2{value2: ""})(ctx)()
+		assert.True(t, result.IsLeft(result2))
+		assert.Equal(t, 0, sideEffect) // Side effect should not occur
+	})
+
+	t.Run("works with zero values", func(t *testing.T) {
+		ctx := t.Context()
+
+		original := func(cfg2 Config2) RIORES.ReaderIOResult[ReaderIO[Config1, int]] {
+			return func(ctx context.Context) IOResult[ReaderIO[Config1, int]] {
+				return func() Result[ReaderIO[Config1, int]] {
+					return result.Of(func(cfg1 Config1) io.IO[int] {
+						return io.Of(cfg1.value1 + len(cfg2.value2))
+					})
+				}
+			}
+		}
+
+		sequenced := SequenceReaderIO(original)
+
+		outcome := sequenced(Config1{value1: 0})(Config2{value2: ""})(ctx)()
+		assert.Equal(t, result.Of(0), outcome)
+	})
+
+	t.Run("executes IO effects correctly", func(t *testing.T) {
+		ctx := t.Context()
+		counter := 0
+
+		original := func(cfg2 Config2) RIORES.ReaderIOResult[ReaderIO[Config1, int]] {
+			return func(ctx context.Context) IOResult[ReaderIO[Config1, int]] {
+				return func() Result[ReaderIO[Config1, int]] {
+					return result.Of(func(cfg1 Config1) io.IO[int] {
+						return func() int {
+							counter++
+							return cfg1.value1 + len(cfg2.value2)
+						}
+					})
+				}
+			}
+		}
+
+		sequenced := SequenceReaderIO(original)
+
+		cfg1 := Config1{value1: 10}
+		cfg2 := Config2{value2: "hello"}
+
+		// Each execution should increment counter
+		counter = 0
+		result1 := sequenced(cfg1)(cfg2)(ctx)()
+		assert.Equal(t, result.Of(15), result1)
+		assert.Equal(t, 1, counter)
+
+		result2 := sequenced(cfg1)(cfg2)(ctx)()
+		assert.Equal(t, result.Of(15), result2)
+		assert.Equal(t, 2, counter)
+	})
+}
+
+func TestTraverse(t *testing.T) {
+	t.Run("transforms and swaps parameter order", func(t *testing.T) {
+		ctx := t.Context()
+
+		// Original computation depending on Config2
+		original := Of[Config2](42)
+
+		// Transformation that introduces Config1 dependency
+		transform := func(n int) ReaderReaderIOResult[Config1, string] {
+			return func(cfg1 Config1) RIORES.ReaderIOResult[string] {
+				return func(ctx context.Context) IOResult[string] {
+					return func() Result[string] {
+						return result.Of(fmt.Sprintf("value=%d, cfg1=%d", n, cfg1.value1))
+					}
+				}
+			}
+		}
+
+		// Apply traverse to swap order and transform
+		traversed := Traverse[Config2](transform)(original)
+
+		cfg1 := Config1{value1: 100}
+		cfg2 := Config2{value2: "test"}
+
+		outcome := traversed(cfg1)(cfg2)(ctx)()
+		assert.Equal(t, result.Of("value=42, cfg1=100"), outcome)
+	})
+
+	t.Run("preserves error handling in original", func(t *testing.T) {
+		ctx := t.Context()
+		testErr := errors.New("test error")
+		original := Left[Config2, int](testErr)
+
+		transform := func(n int) ReaderReaderIOResult[Config1, string] {
+			return Of[Config1](fmt.Sprintf("%d", n))
+		}
+
+		traversed := Traverse[Config2](transform)(original)
+
+		outcome := traversed(Config1{value1: 100})(Config2{value2: "test"})(ctx)()
+		assert.Equal(t, result.Left[string](testErr), outcome)
+	})
+
+	t.Run("preserves error handling in transformation", func(t *testing.T) {
+		ctx := t.Context()
+		original := Of[Config2](42)
+		testErr := errors.New("transform error")
+
+		transform := func(n int) ReaderReaderIOResult[Config1, string] {
+			if n < 0 {
+				return Left[Config1, string](testErr)
+			}
+			return Of[Config1](fmt.Sprintf("%d", n))
+		}
+
+		// Test with negative value
+		originalNeg := Of[Config2](-1)
+		traversedNeg := Traverse[Config2](transform)(originalNeg)
+		resultNeg := traversedNeg(Config1{value1: 100})(Config2{value2: "test"})(ctx)()
+		assert.Equal(t, result.Left[string](testErr), resultNeg)
+
+		// Test with positive value
+		traversedPos := Traverse[Config2](transform)(original)
+		resultPos := traversedPos(Config1{value1: 100})(Config2{value2: "test"})(ctx)()
+		assert.Equal(t, result.Of("42"), resultPos)
+	})
+
+	t.Run("works with complex transformations", func(t *testing.T) {
+		ctx := t.Context()
+		original := Of[Config2](10)
+
+		transform := func(n int) ReaderReaderIOResult[Config1, int] {
+			return func(cfg1 Config1) RIORES.ReaderIOResult[int] {
+				return func(ctx context.Context) IOResult[int] {
+					return func() Result[int] {
+						return result.Of(n * cfg1.value1)
+					}
+				}
+			}
+		}
+
+		traversed := Traverse[Config2](transform)(original)
+
+		outcome := traversed(Config1{value1: 5})(Config2{value2: "test"})(ctx)()
+		assert.Equal(t, result.Of(50), outcome)
+	})
+
+	t.Run("can be composed with other operations", func(t *testing.T) {
+		ctx := t.Context()
+		original := Of[Config2](10)
+
+		transform := func(n int) ReaderReaderIOResult[Config1, int] {
+			return Of[Config1](n * 2)
+		}
+
+		outcome := F.Pipe2(
+			original,
+			Traverse[Config2](transform),
+			func(k Kleisli[Config2, Config1, int]) ReaderReaderIOResult[Config2, int] {
+				return k(Config1{value1: 5})
+			},
+		)
+
+		res := outcome(Config2{value2: "test"})(ctx)()
+		assert.Equal(t, result.Of(20), res)
+	})
+}
+
+func TestTraverseReader(t *testing.T) {
+	t.Run("transforms with pure Reader and swaps parameter order", func(t *testing.T) {
+		ctx := t.Context()
+
+		// Original computation depending on Config2
+		original := Of[Config2](100)
+
+		// Pure Reader transformation that introduces Config1 dependency
+		formatWithConfig := func(value int) reader.Reader[Config1, string] {
+			return func(cfg1 Config1) string {
+				return fmt.Sprintf("value=%d, multiplier=%d, result=%d", value, cfg1.value1, value*cfg1.value1)
+			}
+		}
+
+		// Apply traverse to introduce Config1 and swap order
+		traversed := TraverseReader[Config2](formatWithConfig)(original)
+
+		cfg1 := Config1{value1: 5}
+		cfg2 := Config2{value2: "test"}
+
+		outcome := traversed(cfg1)(cfg2)(ctx)()
+		assert.Equal(t, result.Of("value=100, multiplier=5, result=500"), outcome)
+	})
+
+	t.Run("preserves error handling", func(t *testing.T) {
+		ctx := t.Context()
+		testErr := errors.New("test error")
+		original := Left[Config2, int](testErr)
+
+		transform := func(n int) reader.Reader[Config1, string] {
+			return reader.Of[Config1](fmt.Sprintf("%d", n))
+		}
+
+		traversed := TraverseReader[Config2](transform)(original)
+
+		outcome := traversed(Config1{value1: 5})(Config2{value2: "test"})(ctx)()
+		assert.Equal(t, result.Left[string](testErr), outcome)
+	})
+
+	t.Run("works with pure computations", func(t *testing.T) {
+		ctx := t.Context()
+		original := Of[Config2](42)
+
+		// Pure transformation using Reader
+		double := func(n int) reader.Reader[Config1, int] {
+			return func(cfg1 Config1) int {
+				return n * cfg1.value1
+			}
+		}
+
+		traversed := TraverseReader[Config2](double)(original)
+
+		outcome := traversed(Config1{value1: 3})(Config2{value2: "test"})(ctx)()
+		assert.Equal(t, result.Of(126), outcome)
+	})
+
+	t.Run("works with zero values", func(t *testing.T) {
+		ctx := t.Context()
+		original := Of[Config2](0)
+
+		transform := func(n int) reader.Reader[Config1, int] {
+			return func(cfg1 Config1) int {
+				return n + cfg1.value1
+			}
+		}
+
+		traversed := TraverseReader[Config2](transform)(original)
+
+		outcome := traversed(Config1{value1: 0})(Config2{value2: ""})(ctx)()
+		assert.Equal(t, result.Of(0), outcome)
+	})
+
+	t.Run("maintains referential transparency", func(t *testing.T) {
+		ctx := t.Context()
+		original := Of[Config2](10)
+
+		transform := func(n int) reader.Reader[Config1, int] {
+			return func(cfg1 Config1) int {
+				return n * cfg1.value1
+			}
+		}
+
+		traversed := TraverseReader[Config2](transform)(original)
+
+		cfg1 := Config1{value1: 5}
+		cfg2 := Config2{value2: "test"}
+
+		// Call multiple times with same inputs
+		for range 5 {
+			outcome := traversed(cfg1)(cfg2)(ctx)()
+			assert.Equal(t, result.Of(50), outcome)
+		}
+	})
+
+	t.Run("can be used in composition", func(t *testing.T) {
+		ctx := t.Context()
+		original := Of[Config2](10)
+
+		multiply := func(n int) reader.Reader[Config1, int] {
+			return func(cfg1 Config1) int {
+				return n * cfg1.value1
+			}
+		}
+
+		outcome := F.Pipe2(
+			original,
+			TraverseReader[Config2](multiply),
+			func(k Kleisli[Config2, Config1, int]) ReaderReaderIOResult[Config2, int] {
+				return k(Config1{value1: 3})
+			},
+		)
+
+		res := outcome(Config2{value2: "test"})(ctx)()
+		assert.Equal(t, result.Of(30), res)
+	})
+}
+
+func TestFlipIntegration(t *testing.T) {
+	t.Run("Sequence and Traverse work together", func(t *testing.T) {
+		ctx := t.Context()
+
+		// Create a nested computation
+		nested := func(cfg2 Config2) RIORES.ReaderIOResult[ReaderReaderIOResult[Config1, int]] {
+			return func(ctx context.Context) IOResult[ReaderReaderIOResult[Config1, int]] {
+				return func() Result[ReaderReaderIOResult[Config1, int]] {
+					return result.Of(Of[Config1](len(cfg2.value2)))
+				}
+			}
+		}
+
+		// Sequence it
+		sequenced := Sequence(nested)
+
+		// Then traverse with a transformation
+		transform := func(n int) ReaderReaderIOResult[Config1, string] {
+			return Of[Config1](fmt.Sprintf("length=%d", n))
+		}
+
+		// Apply both operations
+		cfg1 := Config1{value1: 10}
+		cfg2 := Config2{value2: "hello"}
+
+		// First sequence
+		intermediate := sequenced(cfg1)(cfg2)(ctx)()
+		assert.Equal(t, result.Of(5), intermediate)
+
+		// Then apply traverse on a new computation
+		original := Of[Config2](5)
+		traversed := Traverse[Config2](transform)(original)
+		outcome := traversed(cfg1)(cfg2)(ctx)()
+		assert.Equal(t, result.Of("length=5"), outcome)
+	})
+
+	t.Run("all flip functions preserve error semantics", func(t *testing.T) {
+		ctx := t.Context()
+		testErr := errors.New("test error")
+		cfg1 := Config1{value1: 10}
+		cfg2 := Config2{value2: "test"}
+
+		// Test Sequence with error
+		seqErr := func(cfg2 Config2) RIORES.ReaderIOResult[ReaderReaderIOResult[Config1, int]] {
+			return func(ctx context.Context) IOResult[ReaderReaderIOResult[Config1, int]] {
+				return func() Result[ReaderReaderIOResult[Config1, int]] {
+					return result.Left[ReaderReaderIOResult[Config1, int]](testErr)
+				}
+			}
+		}
+		seqResult := Sequence(seqErr)(cfg1)(cfg2)(ctx)()
+		assert.True(t, result.IsLeft(seqResult))
+
+		// Test SequenceReader with error
+		seqReaderErr := func(cfg2 Config2) RIORES.ReaderIOResult[Reader[Config1, int]] {
+			return func(ctx context.Context) IOResult[Reader[Config1, int]] {
+				return func() Result[Reader[Config1, int]] {
+					return result.Left[Reader[Config1, int]](testErr)
+				}
+			}
+		}
+		seqReaderResult := SequenceReader(seqReaderErr)(cfg1)(cfg2)(ctx)()
+		assert.True(t, result.IsLeft(seqReaderResult))
+
+		// Test SequenceReaderIO with error
+		seqReaderIOErr := func(cfg2 Config2) RIORES.ReaderIOResult[ReaderIO[Config1, int]] {
+			return func(ctx context.Context) IOResult[ReaderIO[Config1, int]] {
+				return func() Result[ReaderIO[Config1, int]] {
+					return result.Left[ReaderIO[Config1, int]](testErr)
+				}
+			}
+		}
+		seqReaderIOResult := SequenceReaderIO(seqReaderIOErr)(cfg1)(cfg2)(ctx)()
+		assert.True(t, result.IsLeft(seqReaderIOResult))
+
+		// Test Traverse with error
+		travErr := Left[Config2, int](testErr)
+		travTransform := func(n int) ReaderReaderIOResult[Config1, string] {
+			return Of[Config1](fmt.Sprintf("%d", n))
+		}
+		travResult := Traverse[Config2](travTransform)(travErr)(cfg1)(cfg2)(ctx)()
+		assert.True(t, result.IsLeft(travResult))
+
+		// Test TraverseReader with error
+		travReaderErr := Left[Config2, int](testErr)
+		travReaderTransform := func(n int) reader.Reader[Config1, string] {
+			return reader.Of[Config1](fmt.Sprintf("%d", n))
+		}
+		travReaderResult := TraverseReader[Config2](travReaderTransform)(travReaderErr)(cfg1)(cfg2)(ctx)()
+		assert.True(t, result.IsLeft(travReaderResult))
+	})
+}

v2/context/readerreaderioresult/monoid.go

@@ -20,9 +20,32 @@ import (
 )
 
 type (
+	// Monoid represents a monoid structure for ReaderReaderIOResult[R, A].
+	// A monoid provides an identity element (empty) and an associative binary operation (concat).
 	Monoid[R, A any] = monoid.Monoid[ReaderReaderIOResult[R, A]]
 )
 
+// ApplicativeMonoid creates a monoid for ReaderReaderIOResult using applicative composition.
+// It combines values using the provided monoid m and the applicative Ap operation.
+// This allows combining multiple ReaderReaderIOResult values in parallel while merging their results.
+//
+// The resulting monoid satisfies:
+//   - Identity: concat(empty, x) = concat(x, empty) = x
+//   - Associativity: concat(concat(x, y), z) = concat(x, concat(y, z))
+//
+// Example:
+//
+//	import "github.com/IBM/fp-go/v2/monoid"
+//	import "github.com/IBM/fp-go/v2/number"
+//
+//	// Create a monoid for combining integers with addition
+//	intMonoid := ApplicativeMonoid[Config](number.MonoidSum)
+//
+//	// Combine multiple computations
+//	result := intMonoid.Concat(
+//	    Of[Config](10),
+//	    intMonoid.Concat(Of[Config](20), Of[Config](30)),
+//	) // Results in 60
 func ApplicativeMonoid[R, A any](m monoid.Monoid[A]) Monoid[R, A] {
 	return monoid.ApplicativeMonoid(
 		Of[R, A],
@@ -32,6 +55,13 @@ func ApplicativeMonoid[R, A any](m monoid.Monoid[A]) Monoid[R, A] {
 	)
 }
 
+// ApplicativeMonoidSeq creates a monoid for ReaderReaderIOResult using sequential applicative composition.
+// Similar to ApplicativeMonoid but evaluates effects sequentially rather than in parallel.
+//
+// Use this when:
+//   - Effects must be executed in a specific order
+//   - Side effects depend on sequential execution
+//   - You want to avoid concurrent execution
 func ApplicativeMonoidSeq[R, A any](m monoid.Monoid[A]) Monoid[R, A] {
 	return monoid.ApplicativeMonoid(
 		Of[R, A],
@@ -41,6 +71,13 @@ func ApplicativeMonoidSeq[R, A any](m monoid.Monoid[A]) Monoid[R, A] {
 	)
 }
 
+// ApplicativeMonoidPar creates a monoid for ReaderReaderIOResult using parallel applicative composition.
+// Similar to ApplicativeMonoid but explicitly evaluates effects in parallel.
+//
+// Use this when:
+//   - Effects are independent and can run concurrently
+//   - You want to maximize performance through parallelism
+//   - Order of execution doesn't matter
 func ApplicativeMonoidPar[R, A any](m monoid.Monoid[A]) Monoid[R, A] {
 	return monoid.ApplicativeMonoid(
 		Of[R, A],
@@ -50,6 +87,26 @@ func ApplicativeMonoidPar[R, A any](m monoid.Monoid[A]) Monoid[R, A] {
 	)
 }
 
+// AlternativeMonoid creates a monoid that combines ReaderReaderIOResult values using both
+// applicative composition and alternative (Alt) semantics.
+//
+// This monoid:
+//   - Uses Ap for combining successful values
+//   - Uses Alt for handling failures (tries alternatives on failure)
+//   - Provides a way to combine multiple computations with fallback behavior
+//
+// Example:
+//
+//	import "github.com/IBM/fp-go/v2/monoid"
+//	import "github.com/IBM/fp-go/v2/number"
+//
+//	intMonoid := AlternativeMonoid[Config](number.MonoidSum)
+//
+//	// If first computation fails, tries the second
+//	result := intMonoid.Concat(
+//	    Left[Config, int](errors.New("failed")),
+//	    Of[Config](42),
+//	) // Results in Right(42)
 func AlternativeMonoid[R, A any](m monoid.Monoid[A]) Monoid[R, A] {
 	return monoid.AlternativeMonoid(
 		Of[R, A],
@@ -60,6 +117,29 @@ func AlternativeMonoid[R, A any](m monoid.Monoid[A]) Monoid[R, A] {
 	)
 }
 
+// AltMonoid creates a monoid based solely on the Alt operation.
+// It provides a way to chain computations with fallback behavior.
+//
+// The monoid:
+//   - Uses the provided zero as the identity element
+//   - Uses Alt for concatenation (tries first, falls back to second on failure)
+//   - Implements a "first success" strategy
+//
+// Example:
+//
+//	zero := func() ReaderReaderIOResult[Config, int] {
+//	    return Left[Config, int](errors.New("no value"))
+//	}
+//	altMonoid := AltMonoid[Config, int](zero)
+//
+//	// Tries computations in order until one succeeds
+//	result := altMonoid.Concat(
+//	    Left[Config, int](errors.New("first failed")),
+//	    altMonoid.Concat(
+//	        Left[Config, int](errors.New("second failed")),
+//	        Of[Config](42),
+//	    ),
+//	) // Results in Right(42)
 func AltMonoid[R, A any](zero Lazy[ReaderReaderIOResult[R, A]]) Monoid[R, A] {
 	return monoid.AltMonoid(
 		zero,

v2/context/readerreaderioresult/promap.go

@@ -0,0 +1,168 @@
+package readerreaderioresult
+
+import (
+	"context"
+
+	"github.com/IBM/fp-go/v2/context/readerioresult"
+	"github.com/IBM/fp-go/v2/io"
+	"github.com/IBM/fp-go/v2/ioresult"
+	RRIOE "github.com/IBM/fp-go/v2/readerreaderioeither"
+	"github.com/IBM/fp-go/v2/result"
+)
+
+// Local modifies the outer environment before passing it to a computation.
+// Useful for providing different configurations to sub-computations.
+//
+//go:inline
+func Local[A, R1, R2 any](f func(R2) R1) func(ReaderReaderIOResult[R1, A]) ReaderReaderIOResult[R2, A] {
+	return RRIOE.Local[context.Context, error, A](f)
+}
+
+// LocalIOK transforms the outer environment of a ReaderReaderIOResult using an IO-based Kleisli arrow.
+// It allows you to modify the outer environment through an effectful computation before
+// passing it to the ReaderReaderIOResult.
+//
+// This is useful when the outer environment transformation itself requires IO effects,
+// such as reading from a file, making a network call, or accessing system resources,
+// but these effects cannot fail (or failures are not relevant).
+//
+// The transformation happens in two stages:
+//  1. The IO effect f is executed with the R2 environment to produce an R1 value
+//  2. The resulting R1 value is passed as the outer environment to the ReaderReaderIOResult[R1, A]
+//
+// Type Parameters:
+//   - A: The success type produced by the ReaderReaderIOResult
+//   - R1: The original outer environment type expected by the ReaderReaderIOResult
+//   - R2: The new input outer environment type
+//
+// Parameters:
+//   - f: An IO Kleisli arrow that transforms R2 to R1 with IO effects
+//
+// Returns:
+//   - A function that takes a ReaderReaderIOResult[R1, A] and returns a ReaderReaderIOResult[R2, A]
+//
+//go:inline
+func LocalIOK[A, R1, R2 any](f io.Kleisli[R2, R1]) func(ReaderReaderIOResult[R1, A]) ReaderReaderIOResult[R2, A] {
+	return RRIOE.LocalIOK[context.Context, error, A](f)
+}
+
+// LocalIOEitherK transforms the outer environment of a ReaderReaderIOResult using an IOResult-based Kleisli arrow.
+// It allows you to modify the outer environment through an effectful computation that can fail before
+// passing it to the ReaderReaderIOResult.
+//
+// This is useful when the outer environment transformation itself requires IO effects that can fail,
+// such as reading from a file that might not exist, making a network call that might timeout,
+// or parsing data that might be invalid.
+//
+// The transformation happens in two stages:
+//  1. The IOResult effect f is executed with the R2 environment to produce Result[R1]
+//  2. If successful (Ok), the R1 value is passed as the outer environment to the ReaderReaderIOResult[R1, A]
+//  3. If failed (Err), the error is propagated without executing the ReaderReaderIOResult
+//
+// Type Parameters:
+//   - A: The success type produced by the ReaderReaderIOResult
+//   - R1: The original outer environment type expected by the ReaderReaderIOResult
+//   - R2: The new input outer environment type
+//
+// Parameters:
+//   - f: An IOResult Kleisli arrow that transforms R2 to R1 with IO effects that can fail
+//
+// Returns:
+//   - A function that takes a ReaderReaderIOResult[R1, A] and returns a ReaderReaderIOResult[R2, A]
+//
+//go:inline
+func LocalIOEitherK[A, R1, R2 any](f ioresult.Kleisli[R2, R1]) func(ReaderReaderIOResult[R1, A]) ReaderReaderIOResult[R2, A] {
+	return RRIOE.LocalIOEitherK[context.Context, A](f)
+}
+
+// LocalIOResultK transforms the outer environment of a ReaderReaderIOResult using an IOResult-based Kleisli arrow.
+// This is a type-safe alias for LocalIOEitherK specialized for Result types (which use error as the error type).
+//
+// It allows you to modify the outer environment through an effectful computation that can fail before
+// passing it to the ReaderReaderIOResult.
+//
+// The transformation happens in two stages:
+//  1. The IOResult effect f is executed with the R2 environment to produce Result[R1]
+//  2. If successful (Ok), the R1 value is passed as the outer environment to the ReaderReaderIOResult[R1, A]
+//  3. If failed (Err), the error is propagated without executing the ReaderReaderIOResult
+//
+// Type Parameters:
+//   - A: The success type produced by the ReaderReaderIOResult
+//   - R1: The original outer environment type expected by the ReaderReaderIOResult
+//   - R2: The new input outer environment type
+//
+// Parameters:
+//   - f: An IOResult Kleisli arrow that transforms R2 to R1 with IO effects that can fail
+//
+// Returns:
+//   - A function that takes a ReaderReaderIOResult[R1, A] and returns a ReaderReaderIOResult[R2, A]
+//
+//go:inline
+func LocalIOResultK[A, R1, R2 any](f ioresult.Kleisli[R2, R1]) func(ReaderReaderIOResult[R1, A]) ReaderReaderIOResult[R2, A] {
+	return RRIOE.LocalIOEitherK[context.Context, A](f)
+}
+
+//go:inline
+func LocalResultK[A, R1, R2 any](f result.Kleisli[R2, R1]) func(ReaderReaderIOResult[R1, A]) ReaderReaderIOResult[R2, A] {
+	return RRIOE.LocalEitherK[context.Context, A](f)
+}
+
+// LocalReaderIOEitherK transforms the outer environment of a ReaderReaderIOResult using a ReaderIOResult-based Kleisli arrow.
+// It allows you to modify the outer environment through a computation that depends on the inner context
+// and can perform IO effects that may fail.
+//
+// This is useful when the outer environment transformation requires access to the inner context (e.g., context.Context)
+// and may perform IO operations that can fail, such as database queries, API calls, or file operations.
+//
+// The transformation happens in three stages:
+//  1. The ReaderIOResult effect f is executed with the R2 outer environment and inner context
+//  2. If successful (Ok), the R1 value is passed as the outer environment to the ReaderReaderIOResult[R1, A]
+//  3. If failed (Err), the error is propagated without executing the ReaderReaderIOResult
+//
+// Type Parameters:
+//   - A: The success type produced by the ReaderReaderIOResult
+//   - R1: The original outer environment type expected by the ReaderReaderIOResult
+//   - R2: The new input outer environment type
+//
+// Parameters:
+//   - f: A ReaderIOResult Kleisli arrow that transforms R2 to R1 with context-aware IO effects that can fail
+//
+// Returns:
+//   - A function that takes a ReaderReaderIOResult[R1, A] and returns a ReaderReaderIOResult[R2, A]
+//
+//go:inline
+func LocalReaderIOEitherK[A, R1, R2 any](f readerioresult.Kleisli[R2, R1]) func(ReaderReaderIOResult[R1, A]) ReaderReaderIOResult[R2, A] {
+	return RRIOE.LocalReaderIOEitherK[A](f)
+}
+
+// LocalReaderIOResultK transforms the outer environment of a ReaderReaderIOResult using a ReaderIOResult-based Kleisli arrow.
+// This is a type-safe alias for LocalReaderIOEitherK specialized for Result types (which use error as the error type).
+//
+// It allows you to modify the outer environment through a computation that depends on the inner context
+// and can perform IO effects that may fail.
+//
+// The transformation happens in three stages:
+//  1. The ReaderIOResult effect f is executed with the R2 outer environment and inner context
+//  2. If successful (Ok), the R1 value is passed as the outer environment to the ReaderReaderIOResult[R1, A]
+//  3. If failed (Err), the error is propagated without executing the ReaderReaderIOResult
+//
+// Type Parameters:
+//   - A: The success type produced by the ReaderReaderIOResult
+//   - R1: The original outer environment type expected by the ReaderReaderIOResult
+//   - R2: The new input outer environment type
+//
+// Parameters:
+//   - f: A ReaderIOResult Kleisli arrow that transforms R2 to R1 with context-aware IO effects that can fail
+//
+// Returns:
+//   - A function that takes a ReaderReaderIOResult[R1, A] and returns a ReaderReaderIOResult[R2, A]
+//
+//go:inline
+func LocalReaderIOResultK[A, R1, R2 any](f readerioresult.Kleisli[R2, R1]) func(ReaderReaderIOResult[R1, A]) ReaderReaderIOResult[R2, A] {
+	return RRIOE.LocalReaderIOEitherK[A](f)
+}
+
+//go:inline
+func LocalReaderReaderIOEitherK[A, R1, R2 any](f Kleisli[R2, R2, R1]) func(ReaderReaderIOResult[R1, A]) ReaderReaderIOResult[R2, A] {
+	return RRIOE.LocalReaderReaderIOEitherK[A](f)
+}

v2/context/readerreaderioresult/promap_test.go

@@ -0,0 +1,428 @@
+// Copyright (c) 2025 IBM Corp.
+// All rights reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package readerreaderioresult
+
+import (
+	"context"
+	"errors"
+	"fmt"
+	"testing"
+
+	"github.com/IBM/fp-go/v2/context/readerioresult"
+	"github.com/IBM/fp-go/v2/io"
+	"github.com/IBM/fp-go/v2/ioresult"
+	"github.com/IBM/fp-go/v2/result"
+	"github.com/stretchr/testify/assert"
+)
+
+type SimpleConfig struct {
+	Port int
+}
+
+type DetailedConfig struct {
+	Host string
+	Port int
+}
+
+// TestLocalIOK tests LocalIOK functionality
+func TestLocalIOK(t *testing.T) {
+	ctx := context.Background()
+
+	t.Run("basic IO transformation", func(t *testing.T) {
+		// IO effect that loads config from a path
+		loadConfig := func(path string) io.IO[SimpleConfig] {
+			return func() SimpleConfig {
+				// Simulate loading config
+				return SimpleConfig{Port: 8080}
+			}
+		}
+
+		// ReaderReaderIOResult that uses the config
+		useConfig := func(cfg SimpleConfig) readerioresult.ReaderIOResult[string] {
+			return func(ctx context.Context) ioresult.IOResult[string] {
+				return func() result.Result[string] {
+					return result.Of(fmt.Sprintf("Port: %d", cfg.Port))
+				}
+			}
+		}
+
+		// Compose using LocalIOK
+		adapted := LocalIOK[string](loadConfig)(useConfig)
+		res := adapted("config.json")(ctx)()
+
+		assert.Equal(t, result.Of("Port: 8080"), res)
+	})
+
+	t.Run("IO transformation with side effects", func(t *testing.T) {
+		var loadLog []string
+
+		loadData := func(key string) io.IO[int] {
+			return func() int {
+				loadLog = append(loadLog, "Loading: "+key)
+				return len(key) * 10
+			}
+		}
+
+		processData := func(n int) readerioresult.ReaderIOResult[string] {
+			return func(ctx context.Context) ioresult.IOResult[string] {
+				return func() result.Result[string] {
+					return result.Of(fmt.Sprintf("Processed: %d", n))
+				}
+			}
+		}
+
+		adapted := LocalIOK[string](loadData)(processData)
+		res := adapted("test")(ctx)()
+
+		assert.Equal(t, result.Of("Processed: 40"), res)
+		assert.Equal(t, []string{"Loading: test"}, loadLog)
+	})
+
+	t.Run("error propagation in ReaderReaderIOResult", func(t *testing.T) {
+		loadConfig := func(path string) io.IO[SimpleConfig] {
+			return func() SimpleConfig {
+				return SimpleConfig{Port: 8080}
+			}
+		}
+
+		// ReaderReaderIOResult that returns an error
+		failingOperation := func(cfg SimpleConfig) readerioresult.ReaderIOResult[string] {
+			return func(ctx context.Context) ioresult.IOResult[string] {
+				return func() result.Result[string] {
+					return result.Left[string](errors.New("operation failed"))
+				}
+			}
+		}
+
+		adapted := LocalIOK[string](loadConfig)(failingOperation)
+		res := adapted("config.json")(ctx)()
+
+		assert.True(t, result.IsLeft(res))
+	})
+}
+
+// TestLocalIOEitherK tests LocalIOEitherK functionality
+func TestLocalIOEitherK(t *testing.T) {
+	ctx := context.Background()
+
+	t.Run("basic IOResult transformation", func(t *testing.T) {
+		// IOResult effect that loads config from a path (can fail)
+		loadConfig := func(path string) ioresult.IOResult[SimpleConfig] {
+			return func() result.Result[SimpleConfig] {
+				if path == "" {
+					return result.Left[SimpleConfig](errors.New("empty path"))
+				}
+				return result.Of(SimpleConfig{Port: 8080})
+			}
+		}
+
+		// ReaderReaderIOResult that uses the config
+		useConfig := func(cfg SimpleConfig) readerioresult.ReaderIOResult[string] {
+			return func(ctx context.Context) ioresult.IOResult[string] {
+				return func() result.Result[string] {
+					return result.Of(fmt.Sprintf("Port: %d", cfg.Port))
+				}
+			}
+		}
+
+		// Compose using LocalIOEitherK
+		adapted := LocalIOEitherK[string](loadConfig)(useConfig)
+
+		// Success case
+		res := adapted("config.json")(ctx)()
+		assert.Equal(t, result.Of("Port: 8080"), res)
+
+		// Failure case
+		resErr := adapted("")(ctx)()
+		assert.True(t, result.IsLeft(resErr))
+	})
+
+	t.Run("error propagation from environment transformation", func(t *testing.T) {
+		loadConfig := func(path string) ioresult.IOResult[SimpleConfig] {
+			return func() result.Result[SimpleConfig] {
+				return result.Left[SimpleConfig](errors.New("file not found"))
+			}
+		}
+
+		useConfig := func(cfg SimpleConfig) readerioresult.ReaderIOResult[string] {
+			return func(ctx context.Context) ioresult.IOResult[string] {
+				return func() result.Result[string] {
+					return result.Of(fmt.Sprintf("Port: %d", cfg.Port))
+				}
+			}
+		}
+
+		adapted := LocalIOEitherK[string](loadConfig)(useConfig)
+		res := adapted("missing.json")(ctx)()
+
+		// Error from loadConfig should propagate
+		assert.True(t, result.IsLeft(res))
+	})
+}
+
+// TestLocalIOResultK tests LocalIOResultK functionality
+func TestLocalIOResultK(t *testing.T) {
+	ctx := context.Background()
+
+	t.Run("basic IOResult transformation", func(t *testing.T) {
+		// IOResult effect that loads config from a path (can fail)
+		loadConfig := func(path string) ioresult.IOResult[SimpleConfig] {
+			return func() result.Result[SimpleConfig] {
+				if path == "" {
+					return result.Left[SimpleConfig](errors.New("empty path"))
+				}
+				return result.Of(SimpleConfig{Port: 8080})
+			}
+		}
+
+		// ReaderReaderIOResult that uses the config
+		useConfig := func(cfg SimpleConfig) readerioresult.ReaderIOResult[string] {
+			return func(ctx context.Context) ioresult.IOResult[string] {
+				return func() result.Result[string] {
+					return result.Of(fmt.Sprintf("Port: %d", cfg.Port))
+				}
+			}
+		}
+
+		// Compose using LocalIOResultK
+		adapted := LocalIOResultK[string](loadConfig)(useConfig)
+
+		// Success case
+		res := adapted("config.json")(ctx)()
+		assert.Equal(t, result.Of("Port: 8080"), res)
+
+		// Failure case
+		resErr := adapted("")(ctx)()
+		assert.True(t, result.IsLeft(resErr))
+	})
+
+	t.Run("compose multiple LocalIOResultK", func(t *testing.T) {
+		// First transformation: string -> int (can fail)
+		parseID := func(s string) ioresult.IOResult[int] {
+			return func() result.Result[int] {
+				if s == "" {
+					return result.Left[int](errors.New("empty string"))
+				}
+				return result.Of(len(s) * 10)
+			}
+		}
+
+		// Second transformation: int -> SimpleConfig (can fail)
+		loadConfig := func(id int) ioresult.IOResult[SimpleConfig] {
+			return func() result.Result[SimpleConfig] {
+				if id < 0 {
+					return result.Left[SimpleConfig](errors.New("invalid ID"))
+				}
+				return result.Of(SimpleConfig{Port: 8000 + id})
+			}
+		}
+
+		// Use the config
+		formatConfig := func(cfg SimpleConfig) readerioresult.ReaderIOResult[string] {
+			return func(ctx context.Context) ioresult.IOResult[string] {
+				return func() result.Result[string] {
+					return result.Of(fmt.Sprintf("Port: %d", cfg.Port))
+				}
+			}
+		}
+
+		// Compose transformations
+		step1 := LocalIOResultK[string](loadConfig)(formatConfig)
+		step2 := LocalIOResultK[string](parseID)(step1)
+
+		// Success case
+		res := step2("test")(ctx)()
+		assert.Equal(t, result.Of("Port: 8040"), res)
+
+		// Failure in first transformation
+		resErr1 := step2("")(ctx)()
+		assert.True(t, result.IsLeft(resErr1))
+	})
+}
+
+// TestLocalReaderIOEitherK tests LocalReaderIOEitherK functionality
+func TestLocalReaderIOEitherK(t *testing.T) {
+	ctx := context.Background()
+
+	t.Run("basic ReaderIOResult transformation", func(t *testing.T) {
+		// ReaderIOResult effect that loads config from a path (can fail, uses context)
+		loadConfig := func(path string) readerioresult.ReaderIOResult[SimpleConfig] {
+			return func(ctx context.Context) ioresult.IOResult[SimpleConfig] {
+				return func() result.Result[SimpleConfig] {
+					if path == "" {
+						return result.Left[SimpleConfig](errors.New("empty path"))
+					}
+					// Could use context here for cancellation, logging, etc.
+					return result.Of(SimpleConfig{Port: 8080})
+				}
+			}
+		}
+
+		// ReaderReaderIOResult that uses the config
+		useConfig := func(cfg SimpleConfig) readerioresult.ReaderIOResult[string] {
+			return func(ctx context.Context) ioresult.IOResult[string] {
+				return func() result.Result[string] {
+					return result.Of(fmt.Sprintf("Port: %d", cfg.Port))
+				}
+			}
+		}
+
+		// Compose using LocalReaderIOEitherK
+		adapted := LocalReaderIOEitherK[string](loadConfig)(useConfig)
+
+		// Success case
+		res := adapted("config.json")(ctx)()
+		assert.Equal(t, result.Of("Port: 8080"), res)
+
+		// Failure case
+		resErr := adapted("")(ctx)()
+		assert.True(t, result.IsLeft(resErr))
+	})
+
+	t.Run("context propagation", func(t *testing.T) {
+		type ctxKey string
+		const key ctxKey = "test-key"
+
+		// ReaderIOResult that reads from context
+		loadFromContext := func(path string) readerioresult.ReaderIOResult[string] {
+			return func(ctx context.Context) ioresult.IOResult[string] {
+				return func() result.Result[string] {
+					if val := ctx.Value(key); val != nil {
+						return result.Of(val.(string))
+					}
+					return result.Left[string](errors.New("key not found in context"))
+				}
+			}
+		}
+
+		// ReaderReaderIOResult that uses the loaded value
+		useValue := func(val string) readerioresult.ReaderIOResult[string] {
+			return func(ctx context.Context) ioresult.IOResult[string] {
+				return func() result.Result[string] {
+					return result.Of("Loaded: " + val)
+				}
+			}
+		}
+
+		adapted := LocalReaderIOEitherK[string](loadFromContext)(useValue)
+
+		// With context value
+		ctxWithValue := context.WithValue(ctx, key, "test-value")
+		res := adapted("ignored")(ctxWithValue)()
+		assert.Equal(t, result.Of("Loaded: test-value"), res)
+
+		// Without context value
+		resErr := adapted("ignored")(ctx)()
+		assert.True(t, result.IsLeft(resErr))
+	})
+}
+
+// TestLocalReaderIOResultK tests LocalReaderIOResultK functionality
+func TestLocalReaderIOResultK(t *testing.T) {
+	ctx := context.Background()
+
+	t.Run("basic ReaderIOResult transformation", func(t *testing.T) {
+		// ReaderIOResult effect that loads config from a path (can fail, uses context)
+		loadConfig := func(path string) readerioresult.ReaderIOResult[SimpleConfig] {
+			return func(ctx context.Context) ioresult.IOResult[SimpleConfig] {
+				return func() result.Result[SimpleConfig] {
+					if path == "" {
+						return result.Left[SimpleConfig](errors.New("empty path"))
+					}
+					return result.Of(SimpleConfig{Port: 8080})
+				}
+			}
+		}
+
+		// ReaderReaderIOResult that uses the config
+		useConfig := func(cfg SimpleConfig) readerioresult.ReaderIOResult[string] {
+			return func(ctx context.Context) ioresult.IOResult[string] {
+				return func() result.Result[string] {
+					return result.Of(fmt.Sprintf("Port: %d", cfg.Port))
+				}
+			}
+		}
+
+		// Compose using LocalReaderIOResultK
+		adapted := LocalReaderIOResultK[string](loadConfig)(useConfig)
+
+		// Success case
+		res := adapted("config.json")(ctx)()
+		assert.Equal(t, result.Of("Port: 8080"), res)
+
+		// Failure case
+		resErr := adapted("")(ctx)()
+		assert.True(t, result.IsLeft(resErr))
+	})
+
+	t.Run("real-world: load and validate config with context", func(t *testing.T) {
+		type ConfigFile struct {
+			Path string
+		}
+
+		// Read file with context (can fail, uses context for cancellation)
+		readFile := func(cf ConfigFile) readerioresult.ReaderIOResult[string] {
+			return func(ctx context.Context) ioresult.IOResult[string] {
+				return func() result.Result[string] {
+					// Check context cancellation
+					select {
+					case <-ctx.Done():
+						return result.Left[string](ctx.Err())
+					default:
+					}
+
+					if cf.Path == "" {
+						return result.Left[string](errors.New("empty path"))
+					}
+					return result.Of(`{"port":9000}`)
+				}
+			}
+		}
+
+		// Parse config with context (can fail)
+		parseConfig := func(content string) readerioresult.ReaderIOResult[SimpleConfig] {
+			return func(ctx context.Context) ioresult.IOResult[SimpleConfig] {
+				return func() result.Result[SimpleConfig] {
+					if content == "" {
+						return result.Left[SimpleConfig](errors.New("empty content"))
+					}
+					return result.Of(SimpleConfig{Port: 9000})
+				}
+			}
+		}
+
+		// Use the config
+		useConfig := func(cfg SimpleConfig) readerioresult.ReaderIOResult[string] {
+			return func(ctx context.Context) ioresult.IOResult[string] {
+				return func() result.Result[string] {
+					return result.Of(fmt.Sprintf("Using port: %d", cfg.Port))
+				}
+			}
+		}
+
+		// Compose the pipeline
+		step1 := LocalReaderIOResultK[string](parseConfig)(useConfig)
+		step2 := LocalReaderIOResultK[string](readFile)(step1)
+
+		// Success case
+		res := step2(ConfigFile{Path: "app.json"})(ctx)()
+		assert.Equal(t, result.Of("Using port: 9000"), res)
+
+		// Failure case
+		resErr := step2(ConfigFile{Path: ""})(ctx)()
+		assert.True(t, result.IsLeft(resErr))
+	})
+}

v2/context/readerreaderioresult/reader.go

@@ -37,53 +37,83 @@ import (
 	"github.com/IBM/fp-go/v2/readerio"
 	"github.com/IBM/fp-go/v2/readeroption"
 	RRIOE "github.com/IBM/fp-go/v2/readerreaderioeither"
+	"github.com/IBM/fp-go/v2/result"
 )
 
+// FromReaderOption converts a ReaderOption to a ReaderReaderIOResult.
+// If the option is None, it uses the provided onNone function to generate an error.
+//
 //go:inline
 func FromReaderOption[R, A any](onNone Lazy[error]) Kleisli[R, ReaderOption[R, A], A] {
 	return RRIOE.FromReaderOption[R, context.Context, A](onNone)
 }
 
+// FromReaderIOResult lifts a ReaderIOResult into a ReaderReaderIOResult.
+// This adds an additional reader layer to the computation.
+//
 //go:inline
 func FromReaderIOResult[R, A any](ma ReaderIOResult[R, A]) ReaderReaderIOResult[R, A] {
-	return RRIOE.FromReaderIOEither[context.Context, error](ma)
+	return RRIOE.FromReaderIOEither[context.Context](ma)
 }
 
+// FromReaderIO lifts a ReaderIO into a ReaderReaderIOResult.
+// The IO computation is wrapped in a Right (success) value.
+//
 //go:inline
 func FromReaderIO[R, A any](ma ReaderIO[R, A]) ReaderReaderIOResult[R, A] {
 	return RRIOE.FromReaderIO[context.Context, error](ma)
 }
 
+// RightReaderIO lifts a ReaderIO into a ReaderReaderIOResult as a Right (success) value.
+// Alias for FromReaderIO.
+//
 //go:inline
 func RightReaderIO[R, A any](ma ReaderIO[R, A]) ReaderReaderIOResult[R, A] {
 	return RRIOE.RightReaderIO[context.Context, error](ma)
 }
 
+// LeftReaderIO lifts a ReaderIO that produces an error into a ReaderReaderIOResult as a Left (failure) value.
+//
 //go:inline
 func LeftReaderIO[A, R any](me ReaderIO[R, error]) ReaderReaderIOResult[R, A] {
 	return RRIOE.LeftReaderIO[context.Context, A](me)
 }
 
+// MonadMap applies a function to the value inside a ReaderReaderIOResult (Functor operation).
+// This is the monadic version that takes the computation as the first parameter.
+//
 //go:inline
 func MonadMap[R, A, B any](fa ReaderReaderIOResult[R, A], f func(A) B) ReaderReaderIOResult[R, B] {
 	return reader.MonadMap(fa, RIOE.Map(f))
 }
 
+// Map applies a function to the value inside a ReaderReaderIOResult (Functor operation).
+// This is the curried version that returns an operator.
+//
 //go:inline
 func Map[R, A, B any](f func(A) B) Operator[R, A, B] {
 	return reader.Map[R](RIOE.Map(f))
 }
 
+// MonadMapTo replaces the value inside a ReaderReaderIOResult with a constant value.
+// This is the monadic version that takes the computation as the first parameter.
+//
 //go:inline
 func MonadMapTo[R, A, B any](fa ReaderReaderIOResult[R, A], b B) ReaderReaderIOResult[R, B] {
 	return reader.MonadMap(fa, RIOE.MapTo[A](b))
 }
 
+// MapTo replaces the value inside a ReaderReaderIOResult with a constant value.
+// This is the curried version that returns an operator.
+//
 //go:inline
 func MapTo[R, A, B any](b B) Operator[R, A, B] {
 	return reader.Map[R](RIOE.MapTo[A](b))
 }
 
+// MonadChain sequences two computations, where the second depends on the result of the first (Monad operation).
+// This is the monadic version that takes the computation as the first parameter.
+//
 //go:inline
 func MonadChain[R, A, B any](fa ReaderReaderIOResult[R, A], f Kleisli[R, A, B]) ReaderReaderIOResult[R, B] {
 	return readert.MonadChain(
@@ -93,6 +123,10 @@ func MonadChain[R, A, B any](fa ReaderReaderIOResult[R, A], f Kleisli[R, A, B])
 	)
 }
 
+// MonadChainFirst sequences two computations but returns the result of the first.
+// Useful for performing side effects while preserving the original value.
+// This is the monadic version that takes the computation as the first parameter.
+//
 //go:inline
 func MonadChainFirst[R, A, B any](fa ReaderReaderIOResult[R, A], f Kleisli[R, A, B]) ReaderReaderIOResult[R, A] {
 	return chain.MonadChainFirst(
@@ -102,11 +136,18 @@ func MonadChainFirst[R, A, B any](fa ReaderReaderIOResult[R, A], f Kleisli[R, A,
 		f)
 }
 
+// MonadTap is an alias for MonadChainFirst.
+// Executes a side effect while preserving the original value.
+//
 //go:inline
 func MonadTap[R, A, B any](fa ReaderReaderIOResult[R, A], f Kleisli[R, A, B]) ReaderReaderIOResult[R, A] {
 	return MonadChainFirst(fa, f)
 }
 
+// MonadChainEitherK chains a computation that returns an Either.
+// The Either is automatically lifted into ReaderReaderIOResult.
+// This is the monadic version that takes the computation as the first parameter.
+//
 //go:inline
 func MonadChainEitherK[R, A, B any](ma ReaderReaderIOResult[R, A], f either.Kleisli[error, A, B]) ReaderReaderIOResult[R, B] {
 	return fromeither.MonadChainEitherK(
@@ -117,6 +158,10 @@ func MonadChainEitherK[R, A, B any](ma ReaderReaderIOResult[R, A], f either.Klei
 	)
 }
 
+// ChainEitherK chains a computation that returns an Either.
+// The Either is automatically lifted into ReaderReaderIOResult.
+// This is the curried version that returns an operator.
+//
 //go:inline
 func ChainEitherK[R, A, B any](f either.Kleisli[error, A, B]) Operator[R, A, B] {
 	return fromeither.ChainEitherK(
@@ -126,6 +171,19 @@ func ChainEitherK[R, A, B any](f either.Kleisli[error, A, B]) Operator[R, A, B]
 	)
 }
 
+//go:inline
+func ChainResultK[R, A, B any](f result.Kleisli[A, B]) Operator[R, A, B] {
+	return fromeither.ChainEitherK(
+		Chain[R, A, B],
+		FromEither[R, B],
+		f,
+	)
+}
+
+// MonadChainFirstEitherK chains a computation that returns an Either but preserves the original value.
+// Useful for validation or side effects that may fail.
+// This is the monadic version that takes the computation as the first parameter.
+//
 //go:inline
 func MonadChainFirstEitherK[R, A, B any](ma ReaderReaderIOResult[R, A], f either.Kleisli[error, A, B]) ReaderReaderIOResult[R, A] {
 	return fromeither.MonadChainFirstEitherK(
@@ -137,11 +195,17 @@ func MonadChainFirstEitherK[R, A, B any](ma ReaderReaderIOResult[R, A], f either
 	)
 }
 
+// MonadTapEitherK is an alias for MonadChainFirstEitherK.
+// Executes an Either-returning side effect while preserving the original value.
+//
 //go:inline
 func MonadTapEitherK[R, A, B any](ma ReaderReaderIOResult[R, A], f either.Kleisli[error, A, B]) ReaderReaderIOResult[R, A] {
 	return MonadChainFirstEitherK(ma, f)
 }
 
+// ChainFirstEitherK chains a computation that returns an Either but preserves the original value.
+// This is the curried version that returns an operator.
+//
 //go:inline
 func ChainFirstEitherK[R, A, B any](f either.Kleisli[error, A, B]) Operator[R, A, A] {
 	return fromeither.ChainFirstEitherK(
@@ -152,11 +216,18 @@ func ChainFirstEitherK[R, A, B any](f either.Kleisli[error, A, B]) Operator[R, A
 	)
 }
 
+// TapEitherK is an alias for ChainFirstEitherK.
+// Executes an Either-returning side effect while preserving the original value.
+//
 //go:inline
 func TapEitherK[R, A, B any](f either.Kleisli[error, A, B]) Operator[R, A, A] {
 	return ChainFirstEitherK[R](f)
 }
 
+// MonadChainReaderK chains a computation that returns a Reader.
+// The Reader is automatically lifted into ReaderReaderIOResult.
+// This is the monadic version that takes the computation as the first parameter.
+//
 //go:inline
 func MonadChainReaderK[R, A, B any](ma ReaderReaderIOResult[R, A], f reader.Kleisli[R, A, B]) ReaderReaderIOResult[R, B] {
 	return fromreader.MonadChainReaderK(
@@ -167,6 +238,10 @@ func MonadChainReaderK[R, A, B any](ma ReaderReaderIOResult[R, A], f reader.Klei
 	)
 }
 
+// ChainReaderK chains a computation that returns a Reader.
+// The Reader is automatically lifted into ReaderReaderIOResult.
+// This is the curried version that returns an operator.
+//
 //go:inline
 func ChainReaderK[R, A, B any](f reader.Kleisli[R, A, B]) Operator[R, A, B] {
 	return fromreader.ChainReaderK(
@@ -176,6 +251,9 @@ func ChainReaderK[R, A, B any](f reader.Kleisli[R, A, B]) Operator[R, A, B] {
 	)
 }
 
+// MonadChainFirstReaderK chains a computation that returns a Reader but preserves the original value.
+// This is the monadic version that takes the computation as the first parameter.
+//
 //go:inline
 func MonadChainFirstReaderK[R, A, B any](ma ReaderReaderIOResult[R, A], f reader.Kleisli[R, A, B]) ReaderReaderIOResult[R, A] {
 	return fromreader.MonadChainFirstReaderK(
@@ -186,11 +264,17 @@ func MonadChainFirstReaderK[R, A, B any](ma ReaderReaderIOResult[R, A], f reader
 	)
 }
 
+// MonadTapReaderK is an alias for MonadChainFirstReaderK.
+// Executes a Reader-returning side effect while preserving the original value.
+//
 //go:inline
 func MonadTapReaderK[R, A, B any](ma ReaderReaderIOResult[R, A], f reader.Kleisli[R, A, B]) ReaderReaderIOResult[R, A] {
 	return MonadChainFirstReaderK(ma, f)
 }
 
+// ChainFirstReaderK chains a computation that returns a Reader but preserves the original value.
+// This is the curried version that returns an operator.
+//
 //go:inline
 func ChainFirstReaderK[R, A, B any](f reader.Kleisli[R, A, B]) Operator[R, A, A] {
 	return fromreader.ChainFirstReaderK(
@@ -200,11 +284,18 @@ func ChainFirstReaderK[R, A, B any](f reader.Kleisli[R, A, B]) Operator[R, A, A]
 	)
 }
 
+// TapReaderK is an alias for ChainFirstReaderK.
+// Executes a Reader-returning side effect while preserving the original value.
+//
 //go:inline
 func TapReaderK[R, A, B any](f reader.Kleisli[R, A, B]) Operator[R, A, A] {
 	return ChainFirstReaderK(f)
 }
 
+// MonadChainReaderIOK chains a computation that returns a ReaderIO.
+// The ReaderIO is automatically lifted into ReaderReaderIOResult.
+// This is the monadic version that takes the computation as the first parameter.
+//
 //go:inline
 func MonadChainReaderIOK[R, A, B any](ma ReaderReaderIOResult[R, A], f readerio.Kleisli[R, A, B]) ReaderReaderIOResult[R, B] {
 	return fromreader.MonadChainReaderK(
@@ -215,6 +306,10 @@ func MonadChainReaderIOK[R, A, B any](ma ReaderReaderIOResult[R, A], f readerio.
 	)
 }
 
+// ChainReaderIOK chains a computation that returns a ReaderIO.
+// The ReaderIO is automatically lifted into ReaderReaderIOResult.
+// This is the curried version that returns an operator.
+//
 //go:inline
 func ChainReaderIOK[R, A, B any](f readerio.Kleisli[R, A, B]) Operator[R, A, B] {
 	return fromreader.ChainReaderK(
@@ -224,6 +319,9 @@ func ChainReaderIOK[R, A, B any](f readerio.Kleisli[R, A, B]) Operator[R, A, B]
 	)
 }
 
+// MonadChainFirstReaderIOK chains a computation that returns a ReaderIO but preserves the original value.
+// This is the monadic version that takes the computation as the first parameter.
+//
 //go:inline
 func MonadChainFirstReaderIOK[R, A, B any](ma ReaderReaderIOResult[R, A], f readerio.Kleisli[R, A, B]) ReaderReaderIOResult[R, A] {
 	return fromreader.MonadChainFirstReaderK(
@@ -234,11 +332,17 @@ func MonadChainFirstReaderIOK[R, A, B any](ma ReaderReaderIOResult[R, A], f read
 	)
 }
 
+// MonadTapReaderIOK is an alias for MonadChainFirstReaderIOK.
+// Executes a ReaderIO-returning side effect while preserving the original value.
+//
 //go:inline
 func MonadTapReaderIOK[R, A, B any](ma ReaderReaderIOResult[R, A], f readerio.Kleisli[R, A, B]) ReaderReaderIOResult[R, A] {
 	return MonadChainFirstReaderIOK(ma, f)
 }
 
+// ChainFirstReaderIOK chains a computation that returns a ReaderIO but preserves the original value.
+// This is the curried version that returns an operator.
+//
 //go:inline
 func ChainFirstReaderIOK[R, A, B any](f readerio.Kleisli[R, A, B]) Operator[R, A, A] {
 	return fromreader.ChainFirstReaderK(
@@ -248,11 +352,18 @@ func ChainFirstReaderIOK[R, A, B any](f readerio.Kleisli[R, A, B]) Operator[R, A
 	)
 }
 
+// TapReaderIOK is an alias for ChainFirstReaderIOK.
+// Executes a ReaderIO-returning side effect while preserving the original value.
+//
 //go:inline
 func TapReaderIOK[R, A, B any](f readerio.Kleisli[R, A, B]) Operator[R, A, A] {
 	return ChainFirstReaderIOK(f)
 }
 
+// MonadChainReaderEitherK chains a computation that returns a ReaderEither.
+// The ReaderEither is automatically lifted into ReaderReaderIOResult.
+// This is the monadic version that takes the computation as the first parameter.
+//
 //go:inline
 func MonadChainReaderEitherK[R, A, B any](ma ReaderReaderIOResult[R, A], f RE.Kleisli[R, error, A, B]) ReaderReaderIOResult[R, B] {
 	return fromreader.MonadChainReaderK(
@@ -263,6 +374,10 @@ func MonadChainReaderEitherK[R, A, B any](ma ReaderReaderIOResult[R, A], f RE.Kl
 	)
 }
 
+// ChainReaderEitherK chains a computation that returns a ReaderEither.
+// The ReaderEither is automatically lifted into ReaderReaderIOResult.
+// This is the curried version that returns an operator.
+//
 //go:inline
 func ChainReaderEitherK[R, A, B any](f RE.Kleisli[R, error, A, B]) Operator[R, A, B] {
 	return fromreader.ChainReaderK(
@@ -272,6 +387,9 @@ func ChainReaderEitherK[R, A, B any](f RE.Kleisli[R, error, A, B]) Operator[R, A
 	)
 }
 
+// MonadChainFirstReaderEitherK chains a computation that returns a ReaderEither but preserves the original value.
+// This is the monadic version that takes the computation as the first parameter.
+//
 //go:inline
 func MonadChainFirstReaderEitherK[R, A, B any](ma ReaderReaderIOResult[R, A], f RE.Kleisli[R, error, A, B]) ReaderReaderIOResult[R, A] {
 	return fromreader.MonadChainFirstReaderK(
@@ -282,11 +400,17 @@ func MonadChainFirstReaderEitherK[R, A, B any](ma ReaderReaderIOResult[R, A], f
 	)
 }
 
+// MonadTapReaderEitherK is an alias for MonadChainFirstReaderEitherK.
+// Executes a ReaderEither-returning side effect while preserving the original value.
+//
 //go:inline
 func MonadTapReaderEitherK[R, A, B any](ma ReaderReaderIOResult[R, A], f RE.Kleisli[R, error, A, B]) ReaderReaderIOResult[R, A] {
 	return MonadChainFirstReaderEitherK(ma, f)
 }
 
+// ChainFirstReaderEitherK chains a computation that returns a ReaderEither but preserves the original value.
+// This is the curried version that returns an operator.
+//
 //go:inline
 func ChainFirstReaderEitherK[R, A, B any](f RE.Kleisli[R, error, A, B]) Operator[R, A, A] {
 	return fromreader.ChainFirstReaderK(
@@ -296,25 +420,42 @@ func ChainFirstReaderEitherK[R, A, B any](f RE.Kleisli[R, error, A, B]) Operator
 	)
 }
 
+// TapReaderEitherK is an alias for ChainFirstReaderEitherK.
+// Executes a ReaderEither-returning side effect while preserving the original value.
+//
 //go:inline
 func TapReaderEitherK[R, A, B any](f RE.Kleisli[R, error, A, B]) Operator[R, A, A] {
 	return ChainFirstReaderEitherK(f)
 }
 
+// ChainReaderOptionK chains a computation that returns a ReaderOption.
+// If the option is None, it uses the provided onNone function to generate an error.
+// Returns a function that takes a ReaderOption Kleisli and returns an operator.
+//
 //go:inline
 func ChainReaderOptionK[R, A, B any](onNone Lazy[error]) func(readeroption.Kleisli[R, A, B]) Operator[R, A, B] {
 	return RRIOE.ChainReaderOptionK[R, context.Context, A, B](onNone)
 }
 
+// ChainFirstReaderOptionK chains a computation that returns a ReaderOption but preserves the original value.
+// If the option is None, it uses the provided onNone function to generate an error.
+// Returns a function that takes a ReaderOption Kleisli and returns an operator.
 func ChainFirstReaderOptionK[R, A, B any](onNone Lazy[error]) func(readeroption.Kleisli[R, A, B]) Operator[R, A, A] {
 	return RRIOE.ChainFirstReaderOptionK[R, context.Context, A, B](onNone)
 }
 
+// TapReaderOptionK is an alias for ChainFirstReaderOptionK.
+// Executes a ReaderOption-returning side effect while preserving the original value.
+//
 //go:inline
 func TapReaderOptionK[R, A, B any](onNone Lazy[error]) func(readeroption.Kleisli[R, A, B]) Operator[R, A, A] {
 	return ChainFirstReaderOptionK[R, A, B](onNone)
 }
 
+// MonadChainIOEitherK chains a computation that returns an IOEither.
+// The IOEither is automatically lifted into ReaderReaderIOResult.
+// This is the monadic version that takes the computation as the first parameter.
+//
 //go:inline
 func MonadChainIOEitherK[R, A, B any](ma ReaderReaderIOResult[R, A], f IOE.Kleisli[error, A, B]) ReaderReaderIOResult[R, B] {
 	return fromioeither.MonadChainIOEitherK(
@@ -325,6 +466,10 @@ func MonadChainIOEitherK[R, A, B any](ma ReaderReaderIOResult[R, A], f IOE.Kleis
 	)
 }
 
+// ChainIOEitherK chains a computation that returns an IOEither.
+// The IOEither is automatically lifted into ReaderReaderIOResult.
+// This is the curried version that returns an operator.
+//
 //go:inline
 func ChainIOEitherK[R, A, B any](f IOE.Kleisli[error, A, B]) Operator[R, A, B] {
 	return fromioeither.ChainIOEitherK(
@@ -334,6 +479,10 @@ func ChainIOEitherK[R, A, B any](f IOE.Kleisli[error, A, B]) Operator[R, A, B] {
 	)
 }
 
+// MonadChainIOK chains a computation that returns an IO.
+// The IO is automatically lifted into ReaderReaderIOResult.
+// This is the monadic version that takes the computation as the first parameter.
+//
 //go:inline
 func MonadChainIOK[R, A, B any](ma ReaderReaderIOResult[R, A], f io.Kleisli[A, B]) ReaderReaderIOResult[R, B] {
 	return fromio.MonadChainIOK(
@@ -344,6 +493,10 @@ func MonadChainIOK[R, A, B any](ma ReaderReaderIOResult[R, A], f io.Kleisli[A, B
 	)
 }
 
+// ChainIOK chains a computation that returns an IO.
+// The IO is automatically lifted into ReaderReaderIOResult.
+// This is the curried version that returns an operator.
+//
 //go:inline
 func ChainIOK[R, A, B any](f io.Kleisli[A, B]) Operator[R, A, B] {
 	return fromio.ChainIOK(
@@ -353,6 +506,9 @@ func ChainIOK[R, A, B any](f io.Kleisli[A, B]) Operator[R, A, B] {
 	)
 }
 
+// MonadChainFirstIOK chains a computation that returns an IO but preserves the original value.
+// This is the monadic version that takes the computation as the first parameter.
+//
 //go:inline
 func MonadChainFirstIOK[R, A, B any](ma ReaderReaderIOResult[R, A], f io.Kleisli[A, B]) ReaderReaderIOResult[R, A] {
 	return fromio.MonadChainFirstIOK(
@@ -364,11 +520,17 @@ func MonadChainFirstIOK[R, A, B any](ma ReaderReaderIOResult[R, A], f io.Kleisli
 	)
 }
 
+// MonadTapIOK is an alias for MonadChainFirstIOK.
+// Executes an IO-returning side effect while preserving the original value.
+//
 //go:inline
 func MonadTapIOK[R, A, B any](ma ReaderReaderIOResult[R, A], f io.Kleisli[A, B]) ReaderReaderIOResult[R, A] {
 	return MonadChainFirstIOK(ma, f)
 }
 
+// ChainFirstIOK chains a computation that returns an IO but preserves the original value.
+// This is the curried version that returns an operator.
+//
 //go:inline
 func ChainFirstIOK[R, A, B any](f io.Kleisli[A, B]) Operator[R, A, A] {
 	return fromio.ChainFirstIOK(
@@ -379,11 +541,18 @@ func ChainFirstIOK[R, A, B any](f io.Kleisli[A, B]) Operator[R, A, A] {
 	)
 }
 
+// TapIOK is an alias for ChainFirstIOK.
+// Executes an IO-returning side effect while preserving the original value.
+//
 //go:inline
 func TapIOK[R, A, B any](f io.Kleisli[A, B]) Operator[R, A, A] {
 	return ChainFirstIOK[R](f)
 }
 
+// ChainOptionK chains a computation that returns an Option.
+// If the option is None, it uses the provided onNone function to generate an error.
+// Returns a function that takes an Option Kleisli and returns an operator.
+//
 //go:inline
 func ChainOptionK[R, A, B any](onNone Lazy[error]) func(option.Kleisli[A, B]) Operator[R, A, B] {
 	return fromeither.ChainOptionK(
@@ -393,6 +562,9 @@ func ChainOptionK[R, A, B any](onNone Lazy[error]) func(option.Kleisli[A, B]) Op
 	)
 }
 
+// MonadAp applies a function wrapped in a ReaderReaderIOResult to a value wrapped in a ReaderReaderIOResult (Applicative operation).
+// This is the monadic version that takes both computations as parameters.
+//
 //go:inline
 func MonadAp[R, A, B any](fab ReaderReaderIOResult[R, func(A) B], fa ReaderReaderIOResult[R, A]) ReaderReaderIOResult[R, B] {
 	return readert.MonadAp[
@@ -405,6 +577,8 @@ func MonadAp[R, A, B any](fab ReaderReaderIOResult[R, func(A) B], fa ReaderReade
 	)
 }
 
+// MonadApSeq is like MonadAp but evaluates effects sequentially.
+//
 //go:inline
 func MonadApSeq[R, A, B any](fab ReaderReaderIOResult[R, func(A) B], fa ReaderReaderIOResult[R, A]) ReaderReaderIOResult[R, B] {
 	return readert.MonadAp[
@@ -417,6 +591,8 @@ func MonadApSeq[R, A, B any](fab ReaderReaderIOResult[R, func(A) B], fa ReaderRe
 	)
 }
 
+// MonadApPar is like MonadAp but evaluates effects in parallel.
+//
 //go:inline
 func MonadApPar[R, A, B any](fab ReaderReaderIOResult[R, func(A) B], fa ReaderReaderIOResult[R, A]) ReaderReaderIOResult[R, B] {
 	return readert.MonadAp[
@@ -429,6 +605,9 @@ func MonadApPar[R, A, B any](fab ReaderReaderIOResult[R, func(A) B], fa ReaderRe
 	)
 }
 
+// Ap applies a function wrapped in a ReaderReaderIOResult to a value wrapped in a ReaderReaderIOResult.
+// This is the curried version that returns an operator.
+//
 //go:inline
 func Ap[B, R, A any](fa ReaderReaderIOResult[R, A]) Operator[R, func(A) B, B] {
 	return readert.Ap[
@@ -440,6 +619,9 @@ func Ap[B, R, A any](fa ReaderReaderIOResult[R, A]) Operator[R, func(A) B, B] {
 	)
 }
 
+// Chain sequences two computations, where the second depends on the result of the first (Monad operation).
+// This is the curried version that returns an operator.
+//
 //go:inline
 func Chain[R, A, B any](f Kleisli[R, A, B]) Operator[R, A, B] {
 	return readert.Chain[ReaderReaderIOResult[R, A]](
@@ -448,6 +630,9 @@ func Chain[R, A, B any](f Kleisli[R, A, B]) Operator[R, A, B] {
 	)
 }
 
+// ChainFirst sequences two computations but returns the result of the first.
+// This is the curried version that returns an operator.
+//
 //go:inline
 func ChainFirst[R, A, B any](f Kleisli[R, A, B]) Operator[R, A, A] {
 	return chain.ChainFirst(
@@ -456,167 +641,261 @@ func ChainFirst[R, A, B any](f Kleisli[R, A, B]) Operator[R, A, A] {
 		f)
 }
 
+// Tap is an alias for ChainFirst.
+// Executes a side effect while preserving the original value.
+//
 //go:inline
 func Tap[R, A, B any](f Kleisli[R, A, B]) Operator[R, A, A] {
 	return ChainFirst(f)
 }
 
+// Right creates a ReaderReaderIOResult that succeeds with the given value.
+// This is the success constructor for the Result type.
+//
 //go:inline
 func Right[R, A any](a A) ReaderReaderIOResult[R, A] {
 	return RRIOE.Right[R, context.Context, error](a)
 }
 
+// Left creates a ReaderReaderIOResult that fails with the given error.
+// This is the failure constructor for the Result type.
+//
 //go:inline
 func Left[R, A any](e error) ReaderReaderIOResult[R, A] {
 	return RRIOE.Left[R, context.Context, A](e)
 }
 
+// Of creates a ReaderReaderIOResult that succeeds with the given value (Pointed operation).
+// Alias for Right.
+//
 //go:inline
 func Of[R, A any](a A) ReaderReaderIOResult[R, A] {
 	return RRIOE.Of[R, context.Context, error](a)
 }
 
+// Flatten removes one level of nesting from a nested ReaderReaderIOResult.
+// Converts ReaderReaderIOResult[R, ReaderReaderIOResult[R, A]] to ReaderReaderIOResult[R, A].
+//
 //go:inline
 func Flatten[R, A any](mma ReaderReaderIOResult[R, ReaderReaderIOResult[R, A]]) ReaderReaderIOResult[R, A] {
 	return MonadChain(mma, function.Identity[ReaderReaderIOResult[R, A]])
 }
 
+// FromEither lifts an Either into a ReaderReaderIOResult.
+//
 //go:inline
 func FromEither[R, A any](t Either[error, A]) ReaderReaderIOResult[R, A] {
 	return RRIOE.FromEither[R, context.Context](t)
 }
 
+// FromResult lifts a Result into a ReaderReaderIOResult.
+// Alias for FromEither since Result is Either[error, A].
+//
 //go:inline
 func FromResult[R, A any](t Result[A]) ReaderReaderIOResult[R, A] {
 	return FromEither[R](t)
 }
 
+// RightReader lifts a Reader into a ReaderReaderIOResult as a Right (success) value.
+//
 //go:inline
 func RightReader[R, A any](ma Reader[R, A]) ReaderReaderIOResult[R, A] {
 	return RRIOE.RightReader[context.Context, error](ma)
 }
 
+// LeftReader lifts a Reader that produces an error into a ReaderReaderIOResult as a Left (failure) value.
+//
 //go:inline
 func LeftReader[A, R any](ma Reader[R, error]) ReaderReaderIOResult[R, A] {
 	return RRIOE.LeftReader[context.Context, A](ma)
 }
 
+// FromReader lifts a Reader into a ReaderReaderIOResult.
+// The Reader's result is wrapped in a Right (success) value.
+//
 //go:inline
 func FromReader[R, A any](ma Reader[R, A]) ReaderReaderIOResult[R, A] {
 	return RRIOE.FromReader[context.Context, error](ma)
 }
 
+// RightIO lifts an IO into a ReaderReaderIOResult as a Right (success) value.
+//
 //go:inline
 func RightIO[R, A any](ma IO[A]) ReaderReaderIOResult[R, A] {
 	return RRIOE.RightIO[R, context.Context, error](ma)
 }
 
+// LeftIO lifts an IO that produces an error into a ReaderReaderIOResult as a Left (failure) value.
+//
 //go:inline
 func LeftIO[R, A any](ma IO[error]) ReaderReaderIOResult[R, A] {
 	return RRIOE.LeftIO[R, context.Context, A](ma)
 }
 
+// FromIO lifts an IO into a ReaderReaderIOResult.
+// The IO's result is wrapped in a Right (success) value.
+//
 //go:inline
 func FromIO[R, A any](ma IO[A]) ReaderReaderIOResult[R, A] {
 	return RRIOE.FromIO[R, context.Context, error](ma)
 }
 
+// FromIOEither lifts an IOEither into a ReaderReaderIOResult.
+//
 //go:inline
 func FromIOEither[R, A any](ma IOEither[error, A]) ReaderReaderIOResult[R, A] {
-	return RRIOE.FromIOEither[R, context.Context, error](ma)
+	return RRIOE.FromIOEither[R, context.Context](ma)
 }
 
+// FromIOResult lifts an IOResult into a ReaderReaderIOResult.
+// Alias for FromIOEither since IOResult is IOEither[error, A].
+//
 //go:inline
 func FromIOResult[R, A any](ma IOResult[A]) ReaderReaderIOResult[R, A] {
-	return RRIOE.FromIOEither[R, context.Context, error](ma)
+	return RRIOE.FromIOEither[R, context.Context](ma)
 }
 
+// FromReaderEither lifts a ReaderEither into a ReaderReaderIOResult.
+//
 //go:inline
 func FromReaderEither[R, A any](ma RE.ReaderEither[R, error, A]) ReaderReaderIOResult[R, A] {
-	return RRIOE.FromReaderEither[R, context.Context, error](ma)
+	return RRIOE.FromReaderEither[R, context.Context](ma)
 }
 
+// Ask retrieves the outer environment R.
+// Returns a ReaderReaderIOResult that succeeds with the environment value.
+//
 //go:inline
 func Ask[R any]() ReaderReaderIOResult[R, R] {
 	return RRIOE.Ask[R, context.Context, error]()
 }
 
+// Asks retrieves a value derived from the outer environment R using the provided function.
+//
 //go:inline
 func Asks[R, A any](r Reader[R, A]) ReaderReaderIOResult[R, A] {
 	return RRIOE.Asks[context.Context, error](r)
 }
 
+// FromOption converts an Option to a ReaderReaderIOResult.
+// If the option is None, it uses the provided onNone function to generate an error.
+// Returns a function that takes an Option and returns a ReaderReaderIOResult.
+//
 //go:inline
 func FromOption[R, A any](onNone Lazy[error]) func(Option[A]) ReaderReaderIOResult[R, A] {
 	return RRIOE.FromOption[R, context.Context, A](onNone)
 }
 
+// FromPredicate creates a ReaderReaderIOResult from a predicate.
+// If the predicate returns true, the value is wrapped in Right.
+// If false, onFalse is called to generate an error wrapped in Left.
+//
 //go:inline
 func FromPredicate[R, A any](pred func(A) bool, onFalse func(A) error) Kleisli[R, A, A] {
-	return RRIOE.FromPredicate[R, context.Context, error](pred, onFalse)
+	return RRIOE.FromPredicate[R, context.Context](pred, onFalse)
 }
 
+// MonadAlt provides alternative/fallback behavior.
+// If the first computation fails, it tries the second (lazy-evaluated).
+// This is the monadic version that takes both computations as parameters.
+//
 //go:inline
 func MonadAlt[R, A any](first ReaderReaderIOResult[R, A], second Lazy[ReaderReaderIOResult[R, A]]) ReaderReaderIOResult[R, A] {
 	return RRIOE.MonadAlt(first, second)
 }
 
+// Alt provides alternative/fallback behavior.
+// If the first computation fails, it tries the second (lazy-evaluated).
+// This is the curried version that returns an operator.
+//
 //go:inline
 func Alt[R, A any](second Lazy[ReaderReaderIOResult[R, A]]) Operator[R, A, A] {
 	return RRIOE.Alt(second)
 }
 
+// MonadFlap applies a value to a function wrapped in a ReaderReaderIOResult.
+// This is the monadic version that takes the computation as the first parameter.
+//
 //go:inline
 func MonadFlap[R, B, A any](fab ReaderReaderIOResult[R, func(A) B], a A) ReaderReaderIOResult[R, B] {
 	return functor.MonadFlap(MonadMap[R, func(A) B, B], fab, a)
 }
 
+// Flap applies a value to a function wrapped in a ReaderReaderIOResult.
+// This is the curried version that returns an operator.
+//
 //go:inline
 func Flap[R, B, A any](a A) Operator[R, func(A) B, B] {
 	return functor.Flap(Map[R, func(A) B, B], a)
 }
 
+// MonadMapLeft transforms the error value if the computation fails.
+// Has no effect if the computation succeeds.
+// This is the monadic version that takes the computation as the first parameter.
+//
 //go:inline
 func MonadMapLeft[R, A any](fa ReaderReaderIOResult[R, A], f Endmorphism[error]) ReaderReaderIOResult[R, A] {
-	return RRIOE.MonadMapLeft[R, context.Context](fa, f)
+	return RRIOE.MonadMapLeft(fa, f)
 }
 
+// MapLeft transforms the error value if the computation fails.
+// Has no effect if the computation succeeds.
+// This is the curried version that returns an operator.
+//
 //go:inline
 func MapLeft[R, A any](f Endmorphism[error]) Operator[R, A, A] {
 	return RRIOE.MapLeft[R, context.Context, A](f)
 }
 
-//go:inline
-func Local[A, R1, R2 any](f func(R2) R1) func(ReaderReaderIOResult[R1, A]) ReaderReaderIOResult[R2, A] {
-	return RRIOE.Local[context.Context, error, A](f)
-}
-
+// Read provides a specific outer environment value to a computation.
+// Converts ReaderReaderIOResult[R, A] to ReaderIOResult[context.Context, A].
+//
 //go:inline
 func Read[A, R any](r R) func(ReaderReaderIOResult[R, A]) ReaderIOResult[context.Context, A] {
 	return RRIOE.Read[context.Context, error, A](r)
 }
 
+// ReadIOEither provides an outer environment value from an IOEither to a computation.
+//
 //go:inline
 func ReadIOEither[A, R any](rio IOEither[error, R]) func(ReaderReaderIOResult[R, A]) ReaderIOResult[context.Context, A] {
 	return RRIOE.ReadIOEither[A, R, context.Context](rio)
 }
 
+// ReadIO provides an outer environment value from an IO to a computation.
+//
 //go:inline
 func ReadIO[A, R any](rio IO[R]) func(ReaderReaderIOResult[R, A]) ReaderIOResult[context.Context, A] {
-	return RRIOE.ReadIO[context.Context, error, A, R](rio)
+	return RRIOE.ReadIO[context.Context, error, A](rio)
 }
 
+// MonadChainLeft handles errors by chaining a recovery computation.
+// If the computation fails, the error is passed to f for recovery.
+// This is the monadic version that takes the computation as the first parameter.
+//
 //go:inline
 func MonadChainLeft[R, A any](fa ReaderReaderIOResult[R, A], f Kleisli[R, error, A]) ReaderReaderIOResult[R, A] {
-	return RRIOE.MonadChainLeft[R, context.Context, error, error, A](fa, f)
+	return RRIOE.MonadChainLeft(fa, f)
 }
 
+// ChainLeft handles errors by chaining a recovery computation.
+// If the computation fails, the error is passed to f for recovery.
+// This is the curried version that returns an operator.
+//
 //go:inline
 func ChainLeft[R, A any](f Kleisli[R, error, A]) func(ReaderReaderIOResult[R, A]) ReaderReaderIOResult[R, A] {
-	return RRIOE.ChainLeft[R, context.Context, error, error, A](f)
+	return RRIOE.ChainLeft(f)
 }
 
+// Delay adds a time delay before executing the computation.
+// Useful for rate limiting, retry backoff, or scheduled execution.
+//
 //go:inline
 func Delay[R, A any](delay time.Duration) Operator[R, A, A] {
 	return reader.Map[R](RIOE.Delay[A](delay))
 }
+
+//go:inline
+func Defer[R, A any](fa Lazy[ReaderReaderIOResult[R, A]]) ReaderReaderIOResult[R, A] {
+	return RRIOE.Defer(fa)
+}

v2/context/readerreaderioresult/reader_test.go

@@ -25,6 +25,7 @@ import (
 	"github.com/IBM/fp-go/v2/io"
 	"github.com/IBM/fp-go/v2/ioeither"
 	"github.com/IBM/fp-go/v2/ioresult"
+	N "github.com/IBM/fp-go/v2/number"
 	"github.com/IBM/fp-go/v2/option"
 	"github.com/IBM/fp-go/v2/reader"
 	RE "github.com/IBM/fp-go/v2/readereither"
@@ -56,7 +57,7 @@ func TestLeft(t *testing.T) {
 func TestMonadMap(t *testing.T) {
 	computation := MonadMap(
 		Of[AppConfig](21),
-		func(n int) int { return n * 2 },
+		N.Mul(2),
 	)
 	outcome := computation(defaultConfig)(t.Context())()
 	assert.Equal(t, result.Of(42), outcome)
@@ -65,7 +66,7 @@ func TestMonadMap(t *testing.T) {
 func TestMap(t *testing.T) {
 	computation := F.Pipe1(
 		Of[AppConfig](21),
-		Map[AppConfig](func(n int) int { return n * 2 }),
+		Map[AppConfig](N.Mul(2)),
 	)
 	outcome := computation(defaultConfig)(t.Context())()
 	assert.Equal(t, result.Of(42), outcome)
@@ -100,7 +101,7 @@ func TestMonadChain(t *testing.T) {
 func TestChain(t *testing.T) {
 	computation := F.Pipe1(
 		Of[AppConfig](21),
-		Chain[AppConfig](func(n int) ReaderReaderIOResult[AppConfig, int] {
+		Chain(func(n int) ReaderReaderIOResult[AppConfig, int] {
 			return Of[AppConfig](n * 2)
 		}),
 	)
@@ -126,7 +127,7 @@ func TestChainFirst(t *testing.T) {
 	sideEffect := 0
 	computation := F.Pipe1(
 		Of[AppConfig](42),
-		ChainFirst[AppConfig](func(n int) ReaderReaderIOResult[AppConfig, string] {
+		ChainFirst(func(n int) ReaderReaderIOResult[AppConfig, string] {
 			sideEffect = n
 			return Of[AppConfig]("ignored")
 		}),
@@ -140,7 +141,7 @@ func TestTap(t *testing.T) {
 	sideEffect := 0
 	computation := F.Pipe1(
 		Of[AppConfig](42),
-		Tap[AppConfig](func(n int) ReaderReaderIOResult[AppConfig, string] {
+		Tap(func(n int) ReaderReaderIOResult[AppConfig, string] {
 			sideEffect = n
 			return Of[AppConfig]("ignored")
 		}),
@@ -166,7 +167,7 @@ func TestFromEither(t *testing.T) {
 
 	t.Run("left", func(t *testing.T) {
 		err := errors.New("test error")
-		computation := FromEither[AppConfig, int](either.Left[int](err))
+		computation := FromEither[AppConfig](either.Left[int](err))
 		outcome := computation(defaultConfig)(t.Context())()
 		assert.True(t, result.IsLeft(outcome))
 	})
@@ -188,7 +189,7 @@ func TestFromResult(t *testing.T) {
 }
 
 func TestFromReader(t *testing.T) {
-	computation := FromReader[AppConfig](func(cfg AppConfig) int {
+	computation := FromReader(func(cfg AppConfig) int {
 		return len(cfg.DatabaseURL)
 	})
 	outcome := computation(defaultConfig)(t.Context())()
@@ -196,7 +197,7 @@ func TestFromReader(t *testing.T) {
 }
 
 func TestRightReader(t *testing.T) {
-	computation := RightReader[AppConfig](func(cfg AppConfig) int {
+	computation := RightReader(func(cfg AppConfig) int {
 		return len(cfg.LogLevel)
 	})
 	outcome := computation(defaultConfig)(t.Context())()
@@ -240,7 +241,7 @@ func TestFromIOEither(t *testing.T) {
 
 	t.Run("left", func(t *testing.T) {
 		err := errors.New("test error")
-		computation := FromIOEither[AppConfig, int](ioeither.Left[int](err))
+		computation := FromIOEither[AppConfig](ioeither.Left[int](err))
 		outcome := computation(defaultConfig)(t.Context())()
 		assert.True(t, result.IsLeft(outcome))
 	})
@@ -266,7 +267,7 @@ func TestFromIOResult(t *testing.T) {
 }
 
 func TestFromReaderIO(t *testing.T) {
-	computation := FromReaderIO[AppConfig](func(cfg AppConfig) io.IO[int] {
+	computation := FromReaderIO(func(cfg AppConfig) io.IO[int] {
 		return func() int { return len(cfg.DatabaseURL) }
 	})
 	outcome := computation(defaultConfig)(t.Context())()
@@ -274,7 +275,7 @@ func TestFromReaderIO(t *testing.T) {
 }
 
 func TestRightReaderIO(t *testing.T) {
-	computation := RightReaderIO[AppConfig](func(cfg AppConfig) io.IO[int] {
+	computation := RightReaderIO(func(cfg AppConfig) io.IO[int] {
 		return func() int { return len(cfg.LogLevel) }
 	})
 	outcome := computation(defaultConfig)(t.Context())()
@@ -292,7 +293,7 @@ func TestLeftReaderIO(t *testing.T) {
 
 func TestFromReaderEither(t *testing.T) {
 	t.Run("right", func(t *testing.T) {
-		computation := FromReaderEither[AppConfig](func(cfg AppConfig) either.Either[error, int] {
+		computation := FromReaderEither(func(cfg AppConfig) either.Either[error, int] {
 			return either.Right[error](len(cfg.DatabaseURL))
 		})
 		outcome := computation(defaultConfig)(t.Context())()
@@ -301,7 +302,7 @@ func TestFromReaderEither(t *testing.T) {
 
 	t.Run("left", func(t *testing.T) {
 		err := errors.New("test error")
-		computation := FromReaderEither[AppConfig, int](func(cfg AppConfig) either.Either[error, int] {
+		computation := FromReaderEither(func(cfg AppConfig) either.Either[error, int] {
 			return either.Left[int](err)
 		})
 		outcome := computation(defaultConfig)(t.Context())()
@@ -316,7 +317,7 @@ func TestAsk(t *testing.T) {
 }
 
 func TestAsks(t *testing.T) {
-	computation := Asks[AppConfig](func(cfg AppConfig) string {
+	computation := Asks(func(cfg AppConfig) string {
 		return cfg.DatabaseURL
 	})
 	outcome := computation(defaultConfig)(t.Context())()
@@ -395,7 +396,7 @@ func TestAlt(t *testing.T) {
 
 	computation := F.Pipe1(
 		Left[AppConfig, int](err),
-		Alt[AppConfig](func() ReaderReaderIOResult[AppConfig, int] {
+		Alt(func() ReaderReaderIOResult[AppConfig, int] {
 			return Of[AppConfig](99)
 		}),
 	)
@@ -404,7 +405,7 @@ func TestAlt(t *testing.T) {
 }
 
 func TestMonadFlap(t *testing.T) {
-	fab := Of[AppConfig](func(n int) int { return n * 2 })
+	fab := Of[AppConfig](N.Mul(2))
 	computation := MonadFlap(fab, 21)
 	outcome := computation(defaultConfig)(t.Context())()
 	assert.Equal(t, result.Of(42), outcome)
@@ -412,7 +413,7 @@ func TestMonadFlap(t *testing.T) {
 
 func TestFlap(t *testing.T) {
 	computation := F.Pipe1(
-		Of[AppConfig](func(n int) int { return n * 2 }),
+		Of[AppConfig](N.Mul(2)),
 		Flap[AppConfig, int](21),
 	)
 	outcome := computation(defaultConfig)(t.Context())()
@@ -457,10 +458,10 @@ func TestLocal(t *testing.T) {
 	}
 
 	computation := F.Pipe1(
-		Asks[AppConfig](func(cfg AppConfig) string {
+		Asks(func(cfg AppConfig) string {
 			return cfg.DatabaseURL
 		}),
-		Local[string, AppConfig, OtherConfig](func(other OtherConfig) AppConfig {
+		Local[string](func(other OtherConfig) AppConfig {
 			return AppConfig{DatabaseURL: other.URL, LogLevel: "debug"}
 		}),
 	)
@@ -470,7 +471,7 @@ func TestLocal(t *testing.T) {
 }
 
 func TestRead(t *testing.T) {
-	computation := Asks[AppConfig](func(cfg AppConfig) string {
+	computation := Asks(func(cfg AppConfig) string {
 		return cfg.DatabaseURL
 	})
 
@@ -480,7 +481,7 @@ func TestRead(t *testing.T) {
 }
 
 func TestReadIOEither(t *testing.T) {
-	computation := Asks[AppConfig](func(cfg AppConfig) string {
+	computation := Asks(func(cfg AppConfig) string {
 		return cfg.DatabaseURL
 	})
 
@@ -491,7 +492,7 @@ func TestReadIOEither(t *testing.T) {
 }
 
 func TestReadIO(t *testing.T) {
-	computation := Asks[AppConfig](func(cfg AppConfig) string {
+	computation := Asks(func(cfg AppConfig) string {
 		return cfg.DatabaseURL
 	})
 
@@ -517,7 +518,7 @@ func TestChainLeft(t *testing.T) {
 	err := errors.New("original error")
 	computation := F.Pipe1(
 		Left[AppConfig, int](err),
-		ChainLeft[AppConfig](func(e error) ReaderReaderIOResult[AppConfig, int] {
+		ChainLeft(func(e error) ReaderReaderIOResult[AppConfig, int] {
 			return Of[AppConfig](99)
 		}),
 	)
@@ -552,7 +553,7 @@ func TestChainEitherK(t *testing.T) {
 func TestChainReaderK(t *testing.T) {
 	computation := F.Pipe1(
 		Of[AppConfig](10),
-		ChainReaderK[AppConfig](func(n int) reader.Reader[AppConfig, int] {
+		ChainReaderK(func(n int) reader.Reader[AppConfig, int] {
 			return func(cfg AppConfig) int {
 				return n + len(cfg.LogLevel)
 			}
@@ -565,7 +566,7 @@ func TestChainReaderK(t *testing.T) {
 func TestChainReaderIOK(t *testing.T) {
 	computation := F.Pipe1(
 		Of[AppConfig](10),
-		ChainReaderIOK[AppConfig](func(n int) readerio.ReaderIO[AppConfig, int] {
+		ChainReaderIOK(func(n int) readerio.ReaderIO[AppConfig, int] {
 			return func(cfg AppConfig) io.IO[int] {
 				return func() int {
 					return n + len(cfg.DatabaseURL)
@@ -580,7 +581,7 @@ func TestChainReaderIOK(t *testing.T) {
 func TestChainReaderEitherK(t *testing.T) {
 	computation := F.Pipe1(
 		Of[AppConfig](10),
-		ChainReaderEitherK[AppConfig](func(n int) RE.ReaderEither[AppConfig, error, int] {
+		ChainReaderEitherK(func(n int) RE.ReaderEither[AppConfig, error, int] {
 			return func(cfg AppConfig) either.Either[error, int] {
 				return either.Right[error](n + len(cfg.LogLevel))
 			}
@@ -669,7 +670,7 @@ func TestChainOptionK(t *testing.T) {
 }
 
 func TestFromReaderIOResult(t *testing.T) {
-	computation := FromReaderIOResult[AppConfig](func(cfg AppConfig) ioresult.IOResult[int] {
+	computation := FromReaderIOResult(func(cfg AppConfig) ioresult.IOResult[int] {
 		return func() result.Result[int] {
 			return result.Of(len(cfg.DatabaseURL))
 		}
@@ -699,7 +700,7 @@ func TestFromReaderOption(t *testing.T) {
 }
 
 func TestMonadAp(t *testing.T) {
-	fab := Of[AppConfig](func(n int) int { return n * 2 })
+	fab := Of[AppConfig](N.Mul(2))
 	fa := Of[AppConfig](21)
 	computation := MonadAp(fab, fa)
 	outcome := computation(defaultConfig)(t.Context())()
@@ -709,8 +710,8 @@ func TestMonadAp(t *testing.T) {
 func TestAp(t *testing.T) {
 	fa := Of[AppConfig](21)
 	computation := F.Pipe1(
-		Of[AppConfig](func(n int) int { return n * 2 }),
-		Ap[int, AppConfig](fa),
+		Of[AppConfig](N.Mul(2)),
+		Ap[int](fa),
 	)
 	outcome := computation(defaultConfig)(t.Context())()
 	assert.Equal(t, result.Of(42), outcome)

v2/context/readerreaderioresult/retry.go

@@ -15,14 +15,73 @@
 package readerreaderioresult
 
 import (
-	"context"
-
 	RIOE "github.com/IBM/fp-go/v2/context/readerioresult"
 	F "github.com/IBM/fp-go/v2/function"
 	"github.com/IBM/fp-go/v2/reader"
 	"github.com/IBM/fp-go/v2/retry"
 )
 
+// Retrying executes an action with automatic retry logic based on a retry policy.
+// It retries the action when it fails or when the check predicate returns false.
+//
+// This function is useful for handling transient failures in operations like:
+//   - Network requests that may temporarily fail
+//   - Database operations that may encounter locks
+//   - External service calls that may be temporarily unavailable
+//
+// Parameters:
+//   - policy: Defines the retry behavior (number of retries, delays, backoff strategy)
+//   - action: The computation to retry, receives retry status information
+//   - check: Predicate to determine if the result should trigger a retry (returns true to continue, false to retry)
+//
+// The action receives a retry.RetryStatus that contains:
+//   - IterNumber: Current iteration number (0-based)
+//   - CumulativeDelay: Total delay accumulated so far
+//   - PreviousDelay: Delay from the previous iteration
+//
+// Returns:
+//   - A ReaderReaderIOResult that executes the action with retry logic
+//
+// Example:
+//
+//	import (
+//	    "errors"
+//	    "time"
+//	    "github.com/IBM/fp-go/v2/retry"
+//	)
+//
+//	type Config struct {
+//	    MaxRetries int
+//	    BaseDelay  time.Duration
+//	}
+//
+//	// Create a retry policy with exponential backoff
+//	policy := retry.ExponentialBackoff(100*time.Millisecond, 5*time.Second)
+//	policy = retry.LimitRetries(3, policy)
+//
+//	// Action that may fail transiently
+//	action := func(status retry.RetryStatus) ReaderReaderIOResult[Config, string] {
+//	    return func(cfg Config) ReaderIOResult[context.Context, string] {
+//	        return func(ctx context.Context) IOResult[string] {
+//	            return func() Either[error, string] {
+//	                // Simulate transient failure
+//	                if status.IterNumber < 2 {
+//	                    return either.Left[string](errors.New("transient error"))
+//	                }
+//	                return either.Right[error]("success")
+//	            }
+//	        }
+//	    }
+//	}
+//
+//	// Check if we should retry (retry on any error)
+//	check := func(result Result[string]) bool {
+//	    return either.IsRight(result) // Continue only if successful
+//	}
+//
+//	// Execute with retry logic
+//	result := Retrying(policy, action, check)
+//
 //go:inline
 func Retrying[R, A any](
 	policy retry.RetryPolicy,
@@ -30,7 +89,10 @@ func Retrying[R, A any](
 	check Predicate[Result[A]],
 ) ReaderReaderIOResult[R, A] {
 	// get an implementation for the types
-	return func(r R) ReaderIOResult[context.Context, A] {
-		return RIOE.Retrying(policy, F.Pipe1(action, reader.Map[retry.RetryStatus](reader.Read[ReaderIOResult[context.Context, A]](r))), check)
-	}
+	return F.Flow4(
+		reader.Read[RIOE.ReaderIOResult[A]],
+		reader.Map[retry.RetryStatus],
+		reader.Read[RIOE.Kleisli[retry.RetryStatus, A]](action),
+		F.Bind13of3(RIOE.Retrying[A])(policy, check),
+	)
 }

v2/context/readerreaderioresult/retry_test.go

@@ -21,6 +21,8 @@ import (
 	"testing"
 	"time"
 
+	N "github.com/IBM/fp-go/v2/number"
+	"github.com/IBM/fp-go/v2/reader"
 	"github.com/IBM/fp-go/v2/result"
 	"github.com/IBM/fp-go/v2/retry"
 	"github.com/stretchr/testify/assert"
@@ -45,9 +47,7 @@ func TestRetryingSuccess(t *testing.T) {
 		}
 	}
 
-	check := func(r Result[int]) bool {
-		return result.IsLeft(r)
-	}
+	check := result.IsLeft[int]
 
 	policy := retry.LimitRetries(5)
 
@@ -76,9 +76,7 @@ func TestRetryingFailureExhaustsRetries(t *testing.T) {
 		}
 	}
 
-	check := func(r Result[int]) bool {
-		return result.IsLeft(r)
-	}
+	check := result.IsLeft[int]
 
 	policy := retry.LimitRetries(3)
 
@@ -105,9 +103,7 @@ func TestRetryingNoRetryNeeded(t *testing.T) {
 		}
 	}
 
-	check := func(r Result[int]) bool {
-		return result.IsLeft(r)
-	}
+	check := result.IsLeft[int]
 
 	policy := retry.LimitRetries(5)
 
@@ -139,9 +135,7 @@ func TestRetryingWithDelay(t *testing.T) {
 		}
 	}
 
-	check := func(r Result[int]) bool {
-		return result.IsLeft(r)
-	}
+	check := result.IsLeft[int]
 
 	// Policy with delay
 	policy := retry.CapDelay(
@@ -181,9 +175,7 @@ func TestRetryingAccessesConfig(t *testing.T) {
 		}
 	}
 
-	check := func(r Result[int]) bool {
-		return result.IsLeft(r)
-	}
+	check := result.IsLeft[int]
 
 	policy := retry.LimitRetries(3)
 
@@ -214,9 +206,7 @@ func TestRetryingWithExponentialBackoff(t *testing.T) {
 		}
 	}
 
-	check := func(r Result[int]) bool {
-		return result.IsLeft(r)
-	}
+	check := result.IsLeft[int]
 
 	// Exponential backoff policy
 	policy := retry.CapDelay(
@@ -250,8 +240,8 @@ func TestRetryingCheckFunction(t *testing.T) {
 	// Retry while result is less than 3
 	check := func(r Result[int]) bool {
 		return result.Fold(
-			func(error) bool { return true },
-			func(v int) bool { return v < 3 },
+			reader.Of[error](true),
+			N.LessThan(3),
 		)(r)
 	}
 

v2/context/readerreaderioresult/traverse.go

@@ -0,0 +1,9 @@
+package readerreaderioresult
+
+import (
+	RRIOE "github.com/IBM/fp-go/v2/readerreaderioeither"
+)
+
+func TraverseArray[R, A, B any](f Kleisli[R, A, B]) Kleisli[R, []A, []B] {
+	return RRIOE.TraverseArray(f)
+}

v2/context/readerreaderioresult/types.go

@@ -1,3 +1,18 @@
+// Copyright (c) 2024 IBM Corp.
+// All rights reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
 package readerreaderioresult
 
 import (
@@ -5,6 +20,7 @@ import (
 
 	"github.com/IBM/fp-go/v2/either"
 	"github.com/IBM/fp-go/v2/endomorphism"
+	"github.com/IBM/fp-go/v2/function"
 	"github.com/IBM/fp-go/v2/io"
 	"github.com/IBM/fp-go/v2/ioeither"
 	"github.com/IBM/fp-go/v2/ioresult"
@@ -22,27 +38,117 @@ import (
 )
 
 type (
-	Option[A any]            = option.Option[A]
-	Lazy[A any]              = lazy.Lazy[A]
-	Reader[R, A any]         = reader.Reader[R, A]
-	ReaderOption[R, A any]   = readeroption.ReaderOption[R, A]
-	ReaderIO[R, A any]       = readerio.ReaderIO[R, A]
-	ReaderIOResult[R, A any] = readerioresult.ReaderIOResult[R, A]
-	Either[E, A any]         = either.Either[E, A]
-	Result[A any]            = result.Result[A]
-	IOEither[E, A any]       = ioeither.IOEither[E, A]
-	IOResult[A any]          = ioresult.IOResult[A]
-	IO[A any]                = io.IO[A]
+	// Option represents an optional value that may or may not be present.
+	// It's an alias for option.Option[A].
+	Option[A any] = option.Option[A]
 
+	// Lazy represents a lazily evaluated computation that produces a value of type A.
+	// It's an alias for lazy.Lazy[A].
+	Lazy[A any] = lazy.Lazy[A]
+
+	// Reader represents a computation that depends on an environment of type R
+	// and produces a value of type A.
+	// It's an alias for reader.Reader[R, A].
+	Reader[R, A any] = reader.Reader[R, A]
+
+	// ReaderOption represents a computation that depends on an environment of type R
+	// and produces an optional value of type A.
+	// It's an alias for readeroption.ReaderOption[R, A].
+	ReaderOption[R, A any] = readeroption.ReaderOption[R, A]
+
+	// ReaderIO represents a computation that depends on an environment of type R
+	// and performs side effects to produce a value of type A.
+	// It's an alias for readerio.ReaderIO[R, A].
+	ReaderIO[R, A any] = readerio.ReaderIO[R, A]
+
+	// ReaderIOResult represents a computation that depends on an environment of type R,
+	// performs side effects, and may fail with an error.
+	// It's an alias for readerioresult.ReaderIOResult[R, A].
+	ReaderIOResult[R, A any] = readerioresult.ReaderIOResult[R, A]
+
+	// Either represents a value that can be one of two types: Left (error) or Right (success).
+	// It's an alias for either.Either[E, A].
+	Either[E, A any] = either.Either[E, A]
+
+	// Result is a specialized Either with error as the left type.
+	// It's an alias for result.Result[A] which is Either[error, A].
+	Result[A any] = result.Result[A]
+
+	// IOEither represents a side-effecting computation that may fail with an error of type E
+	// or succeed with a value of type A.
+	// It's an alias for ioeither.IOEither[E, A].
+	IOEither[E, A any] = ioeither.IOEither[E, A]
+
+	// IOResult represents a side-effecting computation that may fail with an error
+	// or succeed with a value of type A.
+	// It's an alias for ioresult.IOResult[A] which is IOEither[error, A].
+	IOResult[A any] = ioresult.IOResult[A]
+
+	// IO represents a side-effecting computation that produces a value of type A.
+	// It's an alias for io.IO[A].
+	IO[A any] = io.IO[A]
+
+	// ReaderReaderIOEither is the base monad transformer that combines:
+	// - Reader[R, ...] for outer dependency injection
+	// - Reader[C, ...] for inner dependency injection (typically context.Context)
+	// - IO for side effects
+	// - Either[E, A] for error handling
+	// It's an alias for readerreaderioeither.ReaderReaderIOEither[R, C, E, A].
 	ReaderReaderIOEither[R, C, E, A any] = readerreaderioeither.ReaderReaderIOEither[R, C, E, A]
 
+	// ReaderReaderIOResult is the main type of this package, specializing ReaderReaderIOEither
+	// with context.Context as the inner reader type and error as the error type.
+	//
+	// Type structure:
+	//   ReaderReaderIOResult[R, A] = R -> context.Context -> IO[Either[error, A]]
+	//
+	// This represents a computation that:
+	// 1. Depends on an outer environment of type R (e.g., application config)
+	// 2. Depends on a context.Context for cancellation and request-scoped values
+	// 3. Performs side effects (IO)
+	// 4. May fail with an error or succeed with a value of type A
+	//
+	// This is the primary type used throughout the package for composing
+	// context-aware, effectful computations with error handling.
 	ReaderReaderIOResult[R, A any] = ReaderReaderIOEither[R, context.Context, error, A]
 
-	Kleisli[R, A, B any]  = Reader[A, ReaderReaderIOResult[R, B]]
-	Operator[R, A, B any] = Kleisli[R, ReaderReaderIOResult[R, A], B]
-	Lens[S, T any]        = lens.Lens[S, T]
-	Trampoline[L, B any]  = tailrec.Trampoline[L, B]
-	Predicate[A any]      = predicate.Predicate[A]
+	// Kleisli represents a function from A to a monadic value ReaderReaderIOResult[R, B].
+	// It's used for composing monadic functions using Kleisli composition.
+	//
+	// Type structure:
+	//   Kleisli[R, A, B] = A -> ReaderReaderIOResult[R, B]
+	//
+	// Kleisli arrows can be composed using Chain operations to build complex
+	// data transformation pipelines.
+	Kleisli[R, A, B any] = Reader[A, ReaderReaderIOResult[R, B]]
 
+	// Operator is a specialized Kleisli arrow that operates on monadic values.
+	// It takes a ReaderReaderIOResult[R, A] and produces a ReaderReaderIOResult[R, B].
+	//
+	// Type structure:
+	//   Operator[R, A, B] = ReaderReaderIOResult[R, A] -> ReaderReaderIOResult[R, B]
+	//
+	// Operators are useful for transforming monadic computations, such as
+	// adding retry logic, logging, or error recovery.
+	Operator[R, A, B any] = Kleisli[R, ReaderReaderIOResult[R, A], B]
+
+	// Lens represents an optic for focusing on a part of a data structure.
+	// It provides a way to get and set a field T within a structure S.
+	// It's an alias for lens.Lens[S, T].
+	Lens[S, T any] = lens.Lens[S, T]
+
+	// Trampoline is used for stack-safe recursion through tail call optimization.
+	// It's an alias for tailrec.Trampoline[L, B].
+	Trampoline[L, B any] = tailrec.Trampoline[L, B]
+
+	// Predicate represents a function that tests whether a value of type A
+	// satisfies some condition.
+	// It's an alias for predicate.Predicate[A].
+	Predicate[A any] = predicate.Predicate[A]
+
+	// Endmorphism represents a function from type A to type A.
+	// It's an alias for endomorphism.Endomorphism[A].
 	Endmorphism[A any] = endomorphism.Endomorphism[A]
+
+	Void = function.Void
 )

v2/di/erasure/provider.go

@@ -30,8 +30,8 @@ import (
 
 type (
 	// InjectableFactory is a factory function that can create an untyped instance of a service based on its [Dependency] identifier
-	InjectableFactory = func(Dependency) IOResult[any]
-	ProviderFactory   = func(InjectableFactory) IOResult[any]
+	InjectableFactory = ReaderIOResult[Dependency, any]
+	ProviderFactory   = ReaderIOResult[InjectableFactory, any]
 
 	paramIndex = map[int]int
 	paramValue = map[int]any

v2/di/erasure/types.go

@@ -4,6 +4,7 @@ import (
 	"github.com/IBM/fp-go/v2/iooption"
 	"github.com/IBM/fp-go/v2/ioresult"
 	"github.com/IBM/fp-go/v2/option"
+	"github.com/IBM/fp-go/v2/readerioresult"
 	"github.com/IBM/fp-go/v2/record"
 )
 
@@ -12,4 +13,5 @@ type (
 	IOResult[T any]            = ioresult.IOResult[T]
 	IOOption[T any]            = iooption.IOOption[T]
 	Entry[K comparable, V any] = record.Entry[K, V]
+	ReaderIOResult[R, T any]   = readerioresult.ReaderIOResult[R, T]
 )

v2/effect/bind.go

@@ -0,0 +1,264 @@
+// Copyright (c) 2023 - 2025 IBM Corp.
+// All rights reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package effect
+
+import (
+	"github.com/IBM/fp-go/v2/context/readerreaderioresult"
+	"github.com/IBM/fp-go/v2/either"
+	"github.com/IBM/fp-go/v2/io"
+	"github.com/IBM/fp-go/v2/ioeither"
+	"github.com/IBM/fp-go/v2/ioresult"
+	"github.com/IBM/fp-go/v2/reader"
+	"github.com/IBM/fp-go/v2/readerio"
+)
+
+//go:inline
+func Do[C, S any](
+	empty S,
+) Effect[C, S] {
+	return readerreaderioresult.Of[C](empty)
+}
+
+//go:inline
+func Bind[C, S1, S2, T any](
+	setter func(T) func(S1) S2,
+	f Kleisli[C, S1, T],
+) Operator[C, S1, S2] {
+	return readerreaderioresult.Bind(setter, f)
+}
+
+//go:inline
+func Let[C, S1, S2, T any](
+	setter func(T) func(S1) S2,
+	f func(S1) T,
+) Operator[C, S1, S2] {
+	return readerreaderioresult.Let[C](setter, f)
+}
+
+//go:inline
+func LetTo[C, S1, S2, T any](
+	setter func(T) func(S1) S2,
+	b T,
+) Operator[C, S1, S2] {
+	return readerreaderioresult.LetTo[C](setter, b)
+}
+
+//go:inline
+func BindTo[C, S1, T any](
+	setter func(T) S1,
+) Operator[C, T, S1] {
+	return readerreaderioresult.BindTo[C](setter)
+}
+
+//go:inline
+func ApS[C, S1, S2, T any](
+	setter func(T) func(S1) S2,
+	fa Effect[C, T],
+) Operator[C, S1, S2] {
+	return readerreaderioresult.ApS[C](setter, fa)
+}
+
+//go:inline
+func ApSL[C, S, T any](
+	lens Lens[S, T],
+	fa Effect[C, T],
+) Operator[C, S, S] {
+	return readerreaderioresult.ApSL[C](lens, fa)
+}
+
+//go:inline
+func BindL[C, S, T any](
+	lens Lens[S, T],
+	f func(T) Effect[C, T],
+) Operator[C, S, S] {
+	return readerreaderioresult.BindL[C](lens, f)
+}
+
+//go:inline
+func LetL[C, S, T any](
+	lens Lens[S, T],
+	f func(T) T,
+) Operator[C, S, S] {
+	return readerreaderioresult.LetL[C](lens, f)
+}
+
+//go:inline
+func LetToL[C, S, T any](
+	lens Lens[S, T],
+	b T,
+) Operator[C, S, S] {
+	return readerreaderioresult.LetToL[C](lens, b)
+}
+
+//go:inline
+func BindIOEitherK[C, S1, S2, T any](
+	setter func(T) func(S1) S2,
+	f ioeither.Kleisli[error, S1, T],
+) Operator[C, S1, S2] {
+	return readerreaderioresult.BindIOEitherK[C](setter, f)
+}
+
+//go:inline
+func BindIOResultK[C, S1, S2, T any](
+	setter func(T) func(S1) S2,
+	f ioresult.Kleisli[S1, T],
+) Operator[C, S1, S2] {
+	return readerreaderioresult.BindIOResultK[C](setter, f)
+}
+
+//go:inline
+func BindIOK[C, S1, S2, T any](
+	setter func(T) func(S1) S2,
+	f io.Kleisli[S1, T],
+) Operator[C, S1, S2] {
+	return readerreaderioresult.BindIOK[C](setter, f)
+}
+
+//go:inline
+func BindReaderK[C, S1, S2, T any](
+	setter func(T) func(S1) S2,
+	f reader.Kleisli[C, S1, T],
+) Operator[C, S1, S2] {
+	return readerreaderioresult.BindReaderK[C](setter, f)
+}
+
+//go:inline
+func BindReaderIOK[C, S1, S2, T any](
+	setter func(T) func(S1) S2,
+	f readerio.Kleisli[C, S1, T],
+) Operator[C, S1, S2] {
+	return readerreaderioresult.BindReaderIOK[C](setter, f)
+}
+
+//go:inline
+func BindEitherK[C, S1, S2, T any](
+	setter func(T) func(S1) S2,
+	f either.Kleisli[error, S1, T],
+) Operator[C, S1, S2] {
+	return readerreaderioresult.BindEitherK[C](setter, f)
+}
+
+//go:inline
+func BindIOEitherKL[C, S, T any](
+	lens Lens[S, T],
+	f ioeither.Kleisli[error, T, T],
+) Operator[C, S, S] {
+	return readerreaderioresult.BindIOEitherKL[C](lens, f)
+}
+
+//go:inline
+func BindIOKL[C, S, T any](
+	lens Lens[S, T],
+	f io.Kleisli[T, T],
+) Operator[C, S, S] {
+	return readerreaderioresult.BindIOKL[C](lens, f)
+}
+
+//go:inline
+func BindReaderKL[C, S, T any](
+	lens Lens[S, T],
+	f reader.Kleisli[C, T, T],
+) Operator[C, S, S] {
+	return readerreaderioresult.BindReaderKL[C](lens, f)
+}
+
+//go:inline
+func BindReaderIOKL[C, S, T any](
+	lens Lens[S, T],
+	f readerio.Kleisli[C, T, T],
+) Operator[C, S, S] {
+	return readerreaderioresult.BindReaderIOKL[C](lens, f)
+}
+
+//go:inline
+func ApIOEitherS[C, S1, S2, T any](
+	setter func(T) func(S1) S2,
+	fa IOEither[error, T],
+) Operator[C, S1, S2] {
+	return readerreaderioresult.ApIOEitherS[C](setter, fa)
+}
+
+//go:inline
+func ApIOS[C, S1, S2, T any](
+	setter func(T) func(S1) S2,
+	fa IO[T],
+) Operator[C, S1, S2] {
+	return readerreaderioresult.ApIOS[C](setter, fa)
+}
+
+//go:inline
+func ApReaderS[C, S1, S2, T any](
+	setter func(T) func(S1) S2,
+	fa Reader[C, T],
+) Operator[C, S1, S2] {
+	return readerreaderioresult.ApReaderS[C](setter, fa)
+}
+
+//go:inline
+func ApReaderIOS[C, S1, S2, T any](
+	setter func(T) func(S1) S2,
+	fa ReaderIO[C, T],
+) Operator[C, S1, S2] {
+	return readerreaderioresult.ApReaderIOS[C](setter, fa)
+}
+
+//go:inline
+func ApEitherS[C, S1, S2, T any](
+	setter func(T) func(S1) S2,
+	fa Either[error, T],
+) Operator[C, S1, S2] {
+	return readerreaderioresult.ApEitherS[C](setter, fa)
+}
+
+//go:inline
+func ApIOEitherSL[C, S, T any](
+	lens Lens[S, T],
+	fa IOEither[error, T],
+) Operator[C, S, S] {
+	return readerreaderioresult.ApIOEitherSL[C](lens, fa)
+}
+
+//go:inline
+func ApIOSL[C, S, T any](
+	lens Lens[S, T],
+	fa IO[T],
+) Operator[C, S, S] {
+	return readerreaderioresult.ApIOSL[C](lens, fa)
+}
+
+//go:inline
+func ApReaderSL[C, S, T any](
+	lens Lens[S, T],
+	fa Reader[C, T],
+) Operator[C, S, S] {
+	return readerreaderioresult.ApReaderSL[C](lens, fa)
+}
+
+//go:inline
+func ApReaderIOSL[C, S, T any](
+	lens Lens[S, T],
+	fa ReaderIO[C, T],
+) Operator[C, S, S] {
+	return readerreaderioresult.ApReaderIOSL[C](lens, fa)
+}
+
+//go:inline
+func ApEitherSL[C, S, T any](
+	lens Lens[S, T],
+	fa Either[error, T],
+) Operator[C, S, S] {
+	return readerreaderioresult.ApEitherSL[C](lens, fa)
+}

v2/effect/bind_test.go

@@ -0,0 +1,768 @@
+// Copyright (c) 2023 - 2025 IBM Corp.
+// All rights reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package effect
+
+import (
+	"errors"
+	"testing"
+
+	"github.com/IBM/fp-go/v2/either"
+	"github.com/IBM/fp-go/v2/io"
+	"github.com/IBM/fp-go/v2/ioeither"
+	"github.com/IBM/fp-go/v2/ioresult"
+	"github.com/IBM/fp-go/v2/optics/lens"
+	"github.com/IBM/fp-go/v2/reader"
+	"github.com/IBM/fp-go/v2/readerio"
+	"github.com/stretchr/testify/assert"
+)
+
+type BindState struct {
+	Name  string
+	Age   int
+	Email string
+}
+
+func TestDo(t *testing.T) {
+	t.Run("creates effect with initial state", func(t *testing.T) {
+		initial := BindState{Name: "Alice", Age: 30}
+		eff := Do[TestContext](initial)
+
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, initial, result)
+	})
+
+	t.Run("creates effect with empty struct", func(t *testing.T) {
+		type Empty struct{}
+		eff := Do[TestContext](Empty{})
+
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, Empty{}, result)
+	})
+}
+
+func TestBind(t *testing.T) {
+	t.Run("binds effect result to state", func(t *testing.T) {
+		initial := BindState{Name: "Alice"}
+
+		eff := Bind[TestContext](
+			func(age int) func(BindState) BindState {
+				return func(s BindState) BindState {
+					s.Age = age
+					return s
+				}
+			},
+			func(s BindState) Effect[TestContext, int] {
+				return Of[TestContext, int](30)
+			},
+		)(Do[TestContext](initial))
+
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, "Alice", result.Name)
+		assert.Equal(t, 30, result.Age)
+	})
+
+	t.Run("chains multiple binds", func(t *testing.T) {
+		initial := BindState{}
+
+		eff := Bind[TestContext](
+			func(email string) func(BindState) BindState {
+				return func(s BindState) BindState {
+					s.Email = email
+					return s
+				}
+			},
+			func(s BindState) Effect[TestContext, string] {
+				return Of[TestContext, string]("alice@example.com")
+			},
+		)(Bind[TestContext](
+			func(age int) func(BindState) BindState {
+				return func(s BindState) BindState {
+					s.Age = age
+					return s
+				}
+			},
+			func(s BindState) Effect[TestContext, int] {
+				return Of[TestContext, int](30)
+			},
+		)(Bind[TestContext](
+			func(name string) func(BindState) BindState {
+				return func(s BindState) BindState {
+					s.Name = name
+					return s
+				}
+			},
+			func(s BindState) Effect[TestContext, string] {
+				return Of[TestContext, string]("Alice")
+			},
+		)(Do[TestContext](initial))))
+
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, "Alice", result.Name)
+		assert.Equal(t, 30, result.Age)
+		assert.Equal(t, "alice@example.com", result.Email)
+	})
+
+	t.Run("propagates errors", func(t *testing.T) {
+		expectedErr := errors.New("bind error")
+		initial := BindState{Name: "Alice"}
+
+		eff := Bind[TestContext](
+			func(age int) func(BindState) BindState {
+				return func(s BindState) BindState {
+					s.Age = age
+					return s
+				}
+			},
+			func(s BindState) Effect[TestContext, int] {
+				return Fail[TestContext, int](expectedErr)
+			},
+		)(Do[TestContext](initial))
+
+		_, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.Error(t, err)
+		assert.Equal(t, expectedErr, err)
+	})
+}
+
+func TestLet(t *testing.T) {
+	t.Run("computes value and binds to state", func(t *testing.T) {
+		initial := BindState{Name: "Alice"}
+
+		eff := Let[TestContext](
+			func(age int) func(BindState) BindState {
+				return func(s BindState) BindState {
+					s.Age = age
+					return s
+				}
+			},
+			func(s BindState) int {
+				return len(s.Name) * 10
+			},
+		)(Do[TestContext](initial))
+
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, "Alice", result.Name)
+		assert.Equal(t, 50, result.Age) // len("Alice") * 10
+	})
+
+	t.Run("chains with Bind", func(t *testing.T) {
+		initial := BindState{Name: "Bob"}
+
+		eff := Let[TestContext](
+			func(email string) func(BindState) BindState {
+				return func(s BindState) BindState {
+					s.Email = email
+					return s
+				}
+			},
+			func(s BindState) string {
+				return s.Name + "@example.com"
+			},
+		)(Bind[TestContext](
+			func(age int) func(BindState) BindState {
+				return func(s BindState) BindState {
+					s.Age = age
+					return s
+				}
+			},
+			func(s BindState) Effect[TestContext, int] {
+				return Of[TestContext, int](25)
+			},
+		)(Do[TestContext](initial)))
+
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, "Bob", result.Name)
+		assert.Equal(t, 25, result.Age)
+		assert.Equal(t, "Bob@example.com", result.Email)
+	})
+}
+
+func TestLetTo(t *testing.T) {
+	t.Run("binds constant value to state", func(t *testing.T) {
+		initial := BindState{Name: "Alice"}
+
+		eff := LetTo[TestContext](
+			func(age int) func(BindState) BindState {
+				return func(s BindState) BindState {
+					s.Age = age
+					return s
+				}
+			},
+			42,
+		)(Do[TestContext](initial))
+
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, "Alice", result.Name)
+		assert.Equal(t, 42, result.Age)
+	})
+
+	t.Run("chains multiple LetTo", func(t *testing.T) {
+		initial := BindState{}
+
+		eff := LetTo[TestContext](
+			func(email string) func(BindState) BindState {
+				return func(s BindState) BindState {
+					s.Email = email
+					return s
+				}
+			},
+			"test@example.com",
+		)(LetTo[TestContext](
+			func(age int) func(BindState) BindState {
+				return func(s BindState) BindState {
+					s.Age = age
+					return s
+				}
+			},
+			30,
+		)(LetTo[TestContext](
+			func(name string) func(BindState) BindState {
+				return func(s BindState) BindState {
+					s.Name = name
+					return s
+				}
+			},
+			"Alice",
+		)(Do[TestContext](initial))))
+
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, "Alice", result.Name)
+		assert.Equal(t, 30, result.Age)
+		assert.Equal(t, "test@example.com", result.Email)
+	})
+}
+
+func TestBindTo(t *testing.T) {
+	t.Run("wraps value in state", func(t *testing.T) {
+		type SimpleState struct {
+			Value int
+		}
+
+		eff := BindTo[TestContext](func(v int) SimpleState {
+			return SimpleState{Value: v}
+		})(Of[TestContext, int](42))
+
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, 42, result.Value)
+	})
+
+	t.Run("starts a bind chain", func(t *testing.T) {
+		type State struct {
+			X int
+			Y string
+		}
+
+		eff := Let[TestContext](
+			func(y string) func(State) State {
+				return func(s State) State {
+					s.Y = y
+					return s
+				}
+			},
+			func(s State) string {
+				return "computed"
+			},
+		)(BindTo[TestContext](func(x int) State {
+			return State{X: x}
+		})(Of[TestContext, int](10)))
+
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, 10, result.X)
+		assert.Equal(t, "computed", result.Y)
+	})
+}
+
+func TestApS(t *testing.T) {
+	t.Run("applies effect and binds result to state", func(t *testing.T) {
+		initial := BindState{Name: "Alice"}
+		ageEffect := Of[TestContext, int](30)
+
+		eff := ApS[TestContext](
+			func(age int) func(BindState) BindState {
+				return func(s BindState) BindState {
+					s.Age = age
+					return s
+				}
+			},
+			ageEffect,
+		)(Do[TestContext](initial))
+
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, "Alice", result.Name)
+		assert.Equal(t, 30, result.Age)
+	})
+
+	t.Run("propagates errors from applied effect", func(t *testing.T) {
+		expectedErr := errors.New("aps error")
+		initial := BindState{Name: "Alice"}
+		ageEffect := Fail[TestContext, int](expectedErr)
+
+		eff := ApS[TestContext](
+			func(age int) func(BindState) BindState {
+				return func(s BindState) BindState {
+					s.Age = age
+					return s
+				}
+			},
+			ageEffect,
+		)(Do[TestContext](initial))
+
+		_, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.Error(t, err)
+		assert.Equal(t, expectedErr, err)
+	})
+}
+
+func TestBindIOK(t *testing.T) {
+	t.Run("binds IO operation to state", func(t *testing.T) {
+		initial := BindState{Name: "Alice"}
+
+		eff := BindIOK[TestContext](
+			func(age int) func(BindState) BindState {
+				return func(s BindState) BindState {
+					s.Age = age
+					return s
+				}
+			},
+			func(s BindState) io.IO[int] {
+				return func() int {
+					return 30
+				}
+			},
+		)(Do[TestContext](initial))
+
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, "Alice", result.Name)
+		assert.Equal(t, 30, result.Age)
+	})
+}
+
+func TestBindIOEitherK(t *testing.T) {
+	t.Run("binds successful IOEither to state", func(t *testing.T) {
+		initial := BindState{Name: "Alice"}
+
+		eff := BindIOEitherK[TestContext](
+			func(age int) func(BindState) BindState {
+				return func(s BindState) BindState {
+					s.Age = age
+					return s
+				}
+			},
+			func(s BindState) ioeither.IOEither[error, int] {
+				return ioeither.Of[error, int](30)
+			},
+		)(Do[TestContext](initial))
+
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, "Alice", result.Name)
+		assert.Equal(t, 30, result.Age)
+	})
+
+	t.Run("propagates IOEither error", func(t *testing.T) {
+		expectedErr := errors.New("ioeither error")
+		initial := BindState{Name: "Alice"}
+
+		eff := BindIOEitherK[TestContext](
+			func(age int) func(BindState) BindState {
+				return func(s BindState) BindState {
+					s.Age = age
+					return s
+				}
+			},
+			func(s BindState) ioeither.IOEither[error, int] {
+				return ioeither.Left[int, error](expectedErr)
+			},
+		)(Do[TestContext](initial))
+
+		_, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.Error(t, err)
+		assert.Equal(t, expectedErr, err)
+	})
+}
+
+func TestBindIOResultK(t *testing.T) {
+	t.Run("binds successful IOResult to state", func(t *testing.T) {
+		initial := BindState{Name: "Alice"}
+
+		eff := BindIOResultK[TestContext](
+			func(age int) func(BindState) BindState {
+				return func(s BindState) BindState {
+					s.Age = age
+					return s
+				}
+			},
+			func(s BindState) ioresult.IOResult[int] {
+				return ioresult.Of[int](30)
+			},
+		)(Do[TestContext](initial))
+
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, "Alice", result.Name)
+		assert.Equal(t, 30, result.Age)
+	})
+}
+
+func TestBindReaderK(t *testing.T) {
+	t.Run("binds Reader operation to state", func(t *testing.T) {
+		initial := BindState{Name: "Alice"}
+
+		eff := BindReaderK[TestContext](
+			func(age int) func(BindState) BindState {
+				return func(s BindState) BindState {
+					s.Age = age
+					return s
+				}
+			},
+			func(s BindState) reader.Reader[TestContext, int] {
+				return func(ctx TestContext) int {
+					return 30
+				}
+			},
+		)(Do[TestContext](initial))
+
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, "Alice", result.Name)
+		assert.Equal(t, 30, result.Age)
+	})
+}
+
+func TestBindReaderIOK(t *testing.T) {
+	t.Run("binds ReaderIO operation to state", func(t *testing.T) {
+		initial := BindState{Name: "Alice"}
+
+		eff := BindReaderIOK[TestContext](
+			func(age int) func(BindState) BindState {
+				return func(s BindState) BindState {
+					s.Age = age
+					return s
+				}
+			},
+			func(s BindState) readerio.ReaderIO[TestContext, int] {
+				return func(ctx TestContext) io.IO[int] {
+					return func() int {
+						return 30
+					}
+				}
+			},
+		)(Do[TestContext](initial))
+
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, "Alice", result.Name)
+		assert.Equal(t, 30, result.Age)
+	})
+}
+
+func TestBindEitherK(t *testing.T) {
+	t.Run("binds successful Either to state", func(t *testing.T) {
+		initial := BindState{Name: "Alice"}
+
+		eff := BindEitherK[TestContext](
+			func(age int) func(BindState) BindState {
+				return func(s BindState) BindState {
+					s.Age = age
+					return s
+				}
+			},
+			func(s BindState) either.Either[error, int] {
+				return either.Of[error, int](30)
+			},
+		)(Do[TestContext](initial))
+
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, "Alice", result.Name)
+		assert.Equal(t, 30, result.Age)
+	})
+
+	t.Run("propagates Either error", func(t *testing.T) {
+		expectedErr := errors.New("either error")
+		initial := BindState{Name: "Alice"}
+
+		eff := BindEitherK[TestContext](
+			func(age int) func(BindState) BindState {
+				return func(s BindState) BindState {
+					s.Age = age
+					return s
+				}
+			},
+			func(s BindState) either.Either[error, int] {
+				return either.Left[int, error](expectedErr)
+			},
+		)(Do[TestContext](initial))
+
+		_, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.Error(t, err)
+		assert.Equal(t, expectedErr, err)
+	})
+}
+
+func TestLensOperations(t *testing.T) {
+	// Create lenses for BindState
+	nameLens := lens.MakeLens(
+		func(s BindState) string { return s.Name },
+		func(s BindState, name string) BindState {
+			s.Name = name
+			return s
+		},
+	)
+
+	ageLens := lens.MakeLens(
+		func(s BindState) int { return s.Age },
+		func(s BindState, age int) BindState {
+			s.Age = age
+			return s
+		},
+	)
+
+	t.Run("ApSL applies effect using lens", func(t *testing.T) {
+		initial := BindState{Name: "Alice", Age: 25}
+		ageEffect := Of[TestContext, int](30)
+
+		eff := ApSL[TestContext](ageLens, ageEffect)(Do[TestContext](initial))
+
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, "Alice", result.Name)
+		assert.Equal(t, 30, result.Age)
+	})
+
+	t.Run("BindL binds effect using lens", func(t *testing.T) {
+		initial := BindState{Name: "Alice", Age: 25}
+
+		eff := BindL[TestContext](
+			ageLens,
+			func(age int) Effect[TestContext, int] {
+				return Of[TestContext, int](age + 5)
+			},
+		)(Do[TestContext](initial))
+
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, "Alice", result.Name)
+		assert.Equal(t, 30, result.Age)
+	})
+
+	t.Run("LetL computes value using lens", func(t *testing.T) {
+		initial := BindState{Name: "Alice", Age: 25}
+
+		eff := LetL[TestContext](
+			ageLens,
+			func(age int) int {
+				return age * 2
+			},
+		)(Do[TestContext](initial))
+
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, "Alice", result.Name)
+		assert.Equal(t, 50, result.Age)
+	})
+
+	t.Run("LetToL sets constant using lens", func(t *testing.T) {
+		initial := BindState{Name: "Alice", Age: 25}
+
+		eff := LetToL[TestContext](ageLens, 100)(Do[TestContext](initial))
+
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, "Alice", result.Name)
+		assert.Equal(t, 100, result.Age)
+	})
+
+	t.Run("chains lens operations", func(t *testing.T) {
+		initial := BindState{}
+
+		eff := LetToL[TestContext](
+			ageLens,
+			30,
+		)(LetToL[TestContext](
+			nameLens,
+			"Bob",
+		)(Do[TestContext](initial)))
+
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, "Bob", result.Name)
+		assert.Equal(t, 30, result.Age)
+	})
+}
+
+func TestApOperations(t *testing.T) {
+	t.Run("ApIOS applies IO effect", func(t *testing.T) {
+		initial := BindState{Name: "Alice"}
+		ioEffect := func() int { return 30 }
+
+		eff := ApIOS[TestContext](
+			func(age int) func(BindState) BindState {
+				return func(s BindState) BindState {
+					s.Age = age
+					return s
+				}
+			},
+			ioEffect,
+		)(Do[TestContext](initial))
+
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, 30, result.Age)
+	})
+
+	t.Run("ApReaderS applies Reader effect", func(t *testing.T) {
+		initial := BindState{Name: "Alice"}
+		readerEffect := func(ctx TestContext) int { return 30 }
+
+		eff := ApReaderS[TestContext](
+			func(age int) func(BindState) BindState {
+				return func(s BindState) BindState {
+					s.Age = age
+					return s
+				}
+			},
+			readerEffect,
+		)(Do[TestContext](initial))
+
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, 30, result.Age)
+	})
+
+	t.Run("ApEitherS applies Either effect", func(t *testing.T) {
+		initial := BindState{Name: "Alice"}
+		eitherEffect := either.Of[error, int](30)
+
+		eff := ApEitherS[TestContext](
+			func(age int) func(BindState) BindState {
+				return func(s BindState) BindState {
+					s.Age = age
+					return s
+				}
+			},
+			eitherEffect,
+		)(Do[TestContext](initial))
+
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, 30, result.Age)
+	})
+}
+
+func TestComplexBindChain(t *testing.T) {
+	t.Run("builds complex state with multiple operations", func(t *testing.T) {
+		type ComplexState struct {
+			Name    string
+			Age     int
+			Email   string
+			IsAdmin bool
+			Score   int
+		}
+
+		eff := LetTo[TestContext](
+			func(score int) func(ComplexState) ComplexState {
+				return func(s ComplexState) ComplexState {
+					s.Score = score
+					return s
+				}
+			},
+			100,
+		)(Let[TestContext](
+			func(isAdmin bool) func(ComplexState) ComplexState {
+				return func(s ComplexState) ComplexState {
+					s.IsAdmin = isAdmin
+					return s
+				}
+			},
+			func(s ComplexState) bool {
+				return s.Age >= 18
+			},
+		)(Let[TestContext](
+			func(email string) func(ComplexState) ComplexState {
+				return func(s ComplexState) ComplexState {
+					s.Email = email
+					return s
+				}
+			},
+			func(s ComplexState) string {
+				return s.Name + "@example.com"
+			},
+		)(Bind[TestContext](
+			func(age int) func(ComplexState) ComplexState {
+				return func(s ComplexState) ComplexState {
+					s.Age = age
+					return s
+				}
+			},
+			func(s ComplexState) Effect[TestContext, int] {
+				return Of[TestContext, int](25)
+			},
+		)(BindTo[TestContext](func(name string) ComplexState {
+			return ComplexState{Name: name}
+		})(Of[TestContext, string]("Alice"))))))
+
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, "Alice", result.Name)
+		assert.Equal(t, 25, result.Age)
+		assert.Equal(t, "Alice@example.com", result.Email)
+		assert.True(t, result.IsAdmin)
+		assert.Equal(t, 100, result.Score)
+	})
+}

v2/effect/dependencies.go

@@ -0,0 +1,110 @@
+package effect
+
+import (
+	thunk "github.com/IBM/fp-go/v2/context/readerioresult"
+	"github.com/IBM/fp-go/v2/context/readerreaderioresult"
+	"github.com/IBM/fp-go/v2/io"
+	"github.com/IBM/fp-go/v2/ioresult"
+	"github.com/IBM/fp-go/v2/result"
+)
+
+//go:inline
+func Local[C1, C2, A any](acc Reader[C1, C2]) Kleisli[C1, Effect[C2, A], A] {
+	return readerreaderioresult.Local[A](acc)
+}
+
+//go:inline
+func Contramap[C1, C2, A any](acc Reader[C1, C2]) Kleisli[C1, Effect[C2, A], A] {
+	return readerreaderioresult.Local[A](acc)
+}
+
+//go:inline
+func LocalIOK[A, C1, C2 any](f io.Kleisli[C2, C1]) func(Effect[C1, A]) Effect[C2, A] {
+	return readerreaderioresult.LocalIOK[A](f)
+}
+
+//go:inline
+func LocalIOResultK[A, C1, C2 any](f ioresult.Kleisli[C2, C1]) func(Effect[C1, A]) Effect[C2, A] {
+	return readerreaderioresult.LocalIOResultK[A](f)
+}
+
+//go:inline
+func LocalResultK[A, C1, C2 any](f result.Kleisli[C2, C1]) func(Effect[C1, A]) Effect[C2, A] {
+	return readerreaderioresult.LocalResultK[A](f)
+}
+
+//go:inline
+func LocalThunkK[A, C1, C2 any](f thunk.Kleisli[C2, C1]) func(Effect[C1, A]) Effect[C2, A] {
+	return readerreaderioresult.LocalReaderIOResultK[A](f)
+}
+
+// LocalEffectK transforms the context of an Effect using an Effect-returning function.
+// This is the most powerful context transformation function, allowing the transformation
+// itself to be effectful (can fail, perform I/O, and access the outer context).
+//
+// LocalEffectK takes a Kleisli arrow that:
+//   - Accepts the outer context C2
+//   - Returns an Effect that produces the inner context C1
+//   - Can fail with an error during context transformation
+//   - Can perform I/O operations during transformation
+//
+// This is useful when:
+//   - Context transformation requires I/O (e.g., loading config from a file)
+//   - Context transformation can fail (e.g., validating or parsing context)
+//   - Context transformation needs to access the outer context
+//
+// Type Parameters:
+//   - A: The value type produced by the effect
+//   - C1: The inner context type (required by the original effect)
+//   - C2: The outer context type (provided to the transformed effect)
+//
+// Parameters:
+//   - f: A Kleisli arrow (C2 -> Effect[C2, C1]) that transforms C2 to C1 effectfully
+//
+// Returns:
+//   - A function that transforms Effect[C1, A] to Effect[C2, A]
+//
+// Example:
+//
+//	type DatabaseConfig struct {
+//		ConnectionString string
+//	}
+//
+//	type AppConfig struct {
+//		ConfigPath string
+//	}
+//
+//	// Effect that needs DatabaseConfig
+//	dbEffect := effect.Of[DatabaseConfig, string]("query result")
+//
+//	// Transform AppConfig to DatabaseConfig effectfully
+//	// (e.g., load config from file, which can fail)
+//	loadConfig := func(app AppConfig) Effect[AppConfig, DatabaseConfig] {
+//		return effect.Chain[AppConfig](func(_ AppConfig) Effect[AppConfig, DatabaseConfig] {
+//			// Simulate loading config from file (can fail)
+//			return effect.Of[AppConfig, DatabaseConfig](DatabaseConfig{
+//				ConnectionString: "loaded from " + app.ConfigPath,
+//			})
+//		})(effect.Of[AppConfig, AppConfig](app))
+//	}
+//
+//	// Apply the transformation
+//	transform := effect.LocalEffectK[string, DatabaseConfig, AppConfig](loadConfig)
+//	appEffect := transform(dbEffect)
+//
+//	// Run with AppConfig
+//	ioResult := effect.Provide(AppConfig{ConfigPath: "/etc/app.conf"})(appEffect)
+//	readerResult := effect.RunSync(ioResult)
+//	result, err := readerResult(context.Background())
+//
+// Comparison with other Local functions:
+//   - Local/Contramap: Pure context transformation (C2 -> C1)
+//   - LocalIOK: IO-based transformation (C2 -> IO[C1])
+//   - LocalIOResultK: IO with error handling (C2 -> IOResult[C1])
+//   - LocalReaderIOResultK: Reader-based with IO and errors (C2 -> ReaderIOResult[C1])
+//   - LocalEffectK: Full Effect transformation (C2 -> Effect[C2, C1])
+//
+//go:inline
+func LocalEffectK[A, C1, C2 any](f Kleisli[C2, C2, C1]) func(Effect[C1, A]) Effect[C2, A] {
+	return readerreaderioresult.LocalReaderReaderIOEitherK[A](f)
+}

v2/effect/dependencies_test.go

@@ -0,0 +1,620 @@
+// Copyright (c) 2023 - 2025 IBM Corp.
+// All rights reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package effect
+
+import (
+	"context"
+	"fmt"
+	"testing"
+
+	"github.com/IBM/fp-go/v2/context/readerreaderioresult"
+	"github.com/stretchr/testify/assert"
+)
+
+type OuterContext struct {
+	Value  string
+	Number int
+}
+
+type InnerContext struct {
+	Value string
+}
+
+func TestLocal(t *testing.T) {
+	t.Run("transforms context for inner effect", func(t *testing.T) {
+		// Create an effect that uses InnerContext
+		innerEffect := Of[InnerContext, string]("result")
+
+		// Transform OuterContext to InnerContext
+		accessor := func(outer OuterContext) InnerContext {
+			return InnerContext{Value: outer.Value}
+		}
+
+		// Apply Local to transform the context
+		kleisli := Local[OuterContext, InnerContext, string](accessor)
+		outerEffect := kleisli(innerEffect)
+
+		// Run with OuterContext
+		ioResult := Provide[OuterContext, string](OuterContext{
+			Value:  "test",
+			Number: 42,
+		})(outerEffect)
+		readerResult := RunSync[string](ioResult)
+		result, err := readerResult(context.Background())
+
+		assert.NoError(t, err)
+		assert.Equal(t, "result", result)
+	})
+
+	t.Run("allows accessing outer context fields", func(t *testing.T) {
+		// Create an effect that reads from InnerContext
+		innerEffect := Chain[InnerContext](func(_ string) Effect[InnerContext, string] {
+			return Of[InnerContext, string]("inner value")
+		})(Of[InnerContext, string]("start"))
+
+		// Transform context
+		accessor := func(outer OuterContext) InnerContext {
+			return InnerContext{Value: outer.Value + " transformed"}
+		}
+
+		kleisli := Local[OuterContext, InnerContext, string](accessor)
+		outerEffect := kleisli(innerEffect)
+
+		// Run with OuterContext
+		ioResult := Provide[OuterContext, string](OuterContext{
+			Value:  "original",
+			Number: 100,
+		})(outerEffect)
+		readerResult := RunSync[string](ioResult)
+		result, err := readerResult(context.Background())
+
+		assert.NoError(t, err)
+		assert.Equal(t, "inner value", result)
+	})
+
+	t.Run("propagates errors from inner effect", func(t *testing.T) {
+		expectedErr := assert.AnError
+		innerEffect := Fail[InnerContext, string](expectedErr)
+
+		accessor := func(outer OuterContext) InnerContext {
+			return InnerContext{Value: outer.Value}
+		}
+
+		kleisli := Local[OuterContext, InnerContext, string](accessor)
+		outerEffect := kleisli(innerEffect)
+
+		ioResult := Provide[OuterContext, string](OuterContext{
+			Value:  "test",
+			Number: 42,
+		})(outerEffect)
+		readerResult := RunSync[string](ioResult)
+		_, err := readerResult(context.Background())
+
+		assert.Error(t, err)
+		assert.Equal(t, expectedErr, err)
+	})
+
+	t.Run("chains multiple Local transformations", func(t *testing.T) {
+		type Level1 struct {
+			A string
+		}
+		type Level2 struct {
+			B string
+		}
+		type Level3 struct {
+			C string
+		}
+
+		// Effect at deepest level
+		level3Effect := Of[Level3, string]("deep result")
+
+		// Transform Level2 -> Level3
+		local23 := Local[Level2, Level3, string](func(l2 Level2) Level3 {
+			return Level3{C: l2.B + "-c"}
+		})
+
+		// Transform Level1 -> Level2
+		local12 := Local[Level1, Level2, string](func(l1 Level1) Level2 {
+			return Level2{B: l1.A + "-b"}
+		})
+
+		// Compose transformations
+		level2Effect := local23(level3Effect)
+		level1Effect := local12(level2Effect)
+
+		// Run with Level1 context
+		ioResult := Provide[Level1, string](Level1{A: "a"})(level1Effect)
+		readerResult := RunSync[string](ioResult)
+		result, err := readerResult(context.Background())
+
+		assert.NoError(t, err)
+		assert.Equal(t, "deep result", result)
+	})
+
+	t.Run("works with complex context transformations", func(t *testing.T) {
+		type DatabaseConfig struct {
+			Host     string
+			Port     int
+			Database string
+		}
+
+		type AppConfig struct {
+			DB      DatabaseConfig
+			APIKey  string
+			Timeout int
+		}
+
+		// Effect that needs only DatabaseConfig
+		dbEffect := Of[DatabaseConfig, string]("connected")
+
+		// Extract DB config from AppConfig
+		accessor := func(app AppConfig) DatabaseConfig {
+			return app.DB
+		}
+
+		kleisli := Local[AppConfig, DatabaseConfig, string](accessor)
+		appEffect := kleisli(dbEffect)
+
+		// Run with full AppConfig
+		ioResult := Provide[AppConfig, string](AppConfig{
+			DB: DatabaseConfig{
+				Host:     "localhost",
+				Port:     5432,
+				Database: "mydb",
+			},
+			APIKey:  "secret",
+			Timeout: 30,
+		})(appEffect)
+		readerResult := RunSync[string](ioResult)
+		result, err := readerResult(context.Background())
+
+		assert.NoError(t, err)
+		assert.Equal(t, "connected", result)
+	})
+}
+
+func TestContramap(t *testing.T) {
+	t.Run("is equivalent to Local", func(t *testing.T) {
+		innerEffect := Of[InnerContext, int](42)
+
+		accessor := func(outer OuterContext) InnerContext {
+			return InnerContext{Value: outer.Value}
+		}
+
+		// Test Local
+		localKleisli := Local[OuterContext, InnerContext, int](accessor)
+		localEffect := localKleisli(innerEffect)
+
+		// Test Contramap
+		contramapKleisli := Contramap[OuterContext, InnerContext, int](accessor)
+		contramapEffect := contramapKleisli(innerEffect)
+
+		outerCtx := OuterContext{Value: "test", Number: 100}
+
+		// Run both
+		localIO := Provide[OuterContext, int](outerCtx)(localEffect)
+		localReader := RunSync[int](localIO)
+		localResult, localErr := localReader(context.Background())
+
+		contramapIO := Provide[OuterContext, int](outerCtx)(contramapEffect)
+		contramapReader := RunSync[int](contramapIO)
+		contramapResult, contramapErr := contramapReader(context.Background())
+
+		assert.NoError(t, localErr)
+		assert.NoError(t, contramapErr)
+		assert.Equal(t, localResult, contramapResult)
+	})
+
+	t.Run("transforms context correctly", func(t *testing.T) {
+		innerEffect := Of[InnerContext, string]("success")
+
+		accessor := func(outer OuterContext) InnerContext {
+			return InnerContext{Value: outer.Value + " modified"}
+		}
+
+		kleisli := Contramap[OuterContext, InnerContext, string](accessor)
+		outerEffect := kleisli(innerEffect)
+
+		ioResult := Provide[OuterContext, string](OuterContext{
+			Value:  "original",
+			Number: 50,
+		})(outerEffect)
+		readerResult := RunSync[string](ioResult)
+		result, err := readerResult(context.Background())
+
+		assert.NoError(t, err)
+		assert.Equal(t, "success", result)
+	})
+
+	t.Run("handles errors from inner effect", func(t *testing.T) {
+		expectedErr := assert.AnError
+		innerEffect := Fail[InnerContext, int](expectedErr)
+
+		accessor := func(outer OuterContext) InnerContext {
+			return InnerContext{Value: outer.Value}
+		}
+
+		kleisli := Contramap[OuterContext, InnerContext, int](accessor)
+		outerEffect := kleisli(innerEffect)
+
+		ioResult := Provide[OuterContext, int](OuterContext{
+			Value:  "test",
+			Number: 42,
+		})(outerEffect)
+		readerResult := RunSync[int](ioResult)
+		_, err := readerResult(context.Background())
+
+		assert.Error(t, err)
+		assert.Equal(t, expectedErr, err)
+	})
+}
+
+func TestLocalAndContramapInteroperability(t *testing.T) {
+	t.Run("can be used interchangeably", func(t *testing.T) {
+		type Config1 struct {
+			Value string
+		}
+		type Config2 struct {
+			Data string
+		}
+		type Config3 struct {
+			Info string
+		}
+
+		// Effect at deepest level
+		effect3 := Of[Config3, string]("result")
+
+		// Use Local for first transformation
+		local23 := Local[Config2, Config3, string](func(c2 Config2) Config3 {
+			return Config3{Info: c2.Data}
+		})
+
+		// Use Contramap for second transformation
+		contramap12 := Contramap[Config1, Config2, string](func(c1 Config1) Config2 {
+			return Config2{Data: c1.Value}
+		})
+
+		// Compose them
+		effect2 := local23(effect3)
+		effect1 := contramap12(effect2)
+
+		// Run
+		ioResult := Provide[Config1, string](Config1{Value: "test"})(effect1)
+		readerResult := RunSync[string](ioResult)
+		result, err := readerResult(context.Background())
+
+		assert.NoError(t, err)
+		assert.Equal(t, "result", result)
+	})
+}
+
+func TestLocalEffectK(t *testing.T) {
+	t.Run("transforms context using effectful function", func(t *testing.T) {
+		type DatabaseConfig struct {
+			ConnectionString string
+		}
+
+		type AppConfig struct {
+			ConfigPath string
+		}
+
+		// Effect that needs DatabaseConfig
+		dbEffect := Of[DatabaseConfig, string]("query result")
+
+		// Transform AppConfig to DatabaseConfig effectfully
+		loadConfig := func(app AppConfig) Effect[AppConfig, DatabaseConfig] {
+			return Of[AppConfig, DatabaseConfig](DatabaseConfig{
+				ConnectionString: "loaded from " + app.ConfigPath,
+			})
+		}
+
+		// Apply the transformation
+		transform := LocalEffectK[string, DatabaseConfig, AppConfig](loadConfig)
+		appEffect := transform(dbEffect)
+
+		// Run with AppConfig
+		ioResult := Provide[AppConfig, string](AppConfig{
+			ConfigPath: "/etc/app.conf",
+		})(appEffect)
+		readerResult := RunSync[string](ioResult)
+		result, err := readerResult(context.Background())
+
+		assert.NoError(t, err)
+		assert.Equal(t, "query result", result)
+	})
+
+	t.Run("propagates errors from context transformation", func(t *testing.T) {
+		type InnerCtx struct {
+			Value string
+		}
+
+		type OuterCtx struct {
+			Path string
+		}
+
+		innerEffect := Of[InnerCtx, string]("success")
+
+		expectedErr := assert.AnError
+		// Context transformation that fails
+		failingTransform := func(outer OuterCtx) Effect[OuterCtx, InnerCtx] {
+			return Fail[OuterCtx, InnerCtx](expectedErr)
+		}
+
+		transform := LocalEffectK[string, InnerCtx, OuterCtx](failingTransform)
+		outerEffect := transform(innerEffect)
+
+		ioResult := Provide[OuterCtx, string](OuterCtx{Path: "test"})(outerEffect)
+		readerResult := RunSync[string](ioResult)
+		_, err := readerResult(context.Background())
+
+		assert.Error(t, err)
+		assert.Equal(t, expectedErr, err)
+	})
+
+	t.Run("propagates errors from inner effect", func(t *testing.T) {
+		type InnerCtx struct {
+			Value string
+		}
+
+		type OuterCtx struct {
+			Path string
+		}
+
+		expectedErr := assert.AnError
+		innerEffect := Fail[InnerCtx, string](expectedErr)
+
+		// Successful context transformation
+		transform := func(outer OuterCtx) Effect[OuterCtx, InnerCtx] {
+			return Of[OuterCtx, InnerCtx](InnerCtx{Value: outer.Path})
+		}
+
+		transformK := LocalEffectK[string, InnerCtx, OuterCtx](transform)
+		outerEffect := transformK(innerEffect)
+
+		ioResult := Provide[OuterCtx, string](OuterCtx{Path: "test"})(outerEffect)
+		readerResult := RunSync[string](ioResult)
+		_, err := readerResult(context.Background())
+
+		assert.Error(t, err)
+		assert.Equal(t, expectedErr, err)
+	})
+
+	t.Run("allows effectful context transformation with IO operations", func(t *testing.T) {
+		type Config struct {
+			Data string
+		}
+
+		type AppContext struct {
+			ConfigFile string
+		}
+
+		// Effect that uses Config
+		configEffect := Chain[Config](func(cfg Config) Effect[Config, string] {
+			return Of[Config, string]("processed: " + cfg.Data)
+		})(readerreaderioresult.Ask[Config]())
+
+		// Effectful transformation that simulates loading config
+		loadConfigEffect := func(app AppContext) Effect[AppContext, Config] {
+			// Simulate IO operation (e.g., reading file)
+			return Of[AppContext, Config](Config{
+				Data: "loaded from " + app.ConfigFile,
+			})
+		}
+
+		transform := LocalEffectK[string, Config, AppContext](loadConfigEffect)
+		appEffect := transform(configEffect)
+
+		ioResult := Provide[AppContext, string](AppContext{
+			ConfigFile: "config.json",
+		})(appEffect)
+		readerResult := RunSync[string](ioResult)
+		result, err := readerResult(context.Background())
+
+		assert.NoError(t, err)
+		assert.Equal(t, "processed: loaded from config.json", result)
+	})
+
+	t.Run("chains multiple LocalEffectK transformations", func(t *testing.T) {
+		type Level1 struct {
+			A string
+		}
+		type Level2 struct {
+			B string
+		}
+		type Level3 struct {
+			C string
+		}
+
+		// Effect at deepest level
+		level3Effect := Of[Level3, string]("deep result")
+
+		// Transform Level2 -> Level3 effectfully
+		transform23 := LocalEffectK[string, Level3, Level2](func(l2 Level2) Effect[Level2, Level3] {
+			return Of[Level2, Level3](Level3{C: l2.B + "-c"})
+		})
+
+		// Transform Level1 -> Level2 effectfully
+		transform12 := LocalEffectK[string, Level2, Level1](func(l1 Level1) Effect[Level1, Level2] {
+			return Of[Level1, Level2](Level2{B: l1.A + "-b"})
+		})
+
+		// Compose transformations
+		level2Effect := transform23(level3Effect)
+		level1Effect := transform12(level2Effect)
+
+		// Run with Level1 context
+		ioResult := Provide[Level1, string](Level1{A: "a"})(level1Effect)
+		readerResult := RunSync[string](ioResult)
+		result, err := readerResult(context.Background())
+
+		assert.NoError(t, err)
+		assert.Equal(t, "deep result", result)
+	})
+
+	t.Run("accesses outer context during transformation", func(t *testing.T) {
+		type DatabaseConfig struct {
+			Host string
+			Port int
+		}
+
+		type AppConfig struct {
+			Environment string
+			DBHost      string
+			DBPort      int
+		}
+
+		// Effect that needs DatabaseConfig
+		dbEffect := Chain[DatabaseConfig](func(cfg DatabaseConfig) Effect[DatabaseConfig, string] {
+			return Of[DatabaseConfig, string](fmt.Sprintf("%s:%d", cfg.Host, cfg.Port))
+		})(readerreaderioresult.Ask[DatabaseConfig]())
+
+		// Transform using outer context
+		transformWithContext := func(app AppConfig) Effect[AppConfig, DatabaseConfig] {
+			// Access outer context to build inner context
+			prefix := ""
+			if app.Environment == "prod" {
+				prefix = "prod-"
+			}
+			return Of[AppConfig, DatabaseConfig](DatabaseConfig{
+				Host: prefix + app.DBHost,
+				Port: app.DBPort,
+			})
+		}
+
+		transform := LocalEffectK[string, DatabaseConfig, AppConfig](transformWithContext)
+		appEffect := transform(dbEffect)
+
+		ioResult := Provide[AppConfig, string](AppConfig{
+			Environment: "prod",
+			DBHost:      "localhost",
+			DBPort:      5432,
+		})(appEffect)
+		readerResult := RunSync[string](ioResult)
+		result, err := readerResult(context.Background())
+
+		assert.NoError(t, err)
+		assert.Contains(t, result, "prod-localhost")
+	})
+
+	t.Run("validates context during transformation", func(t *testing.T) {
+		type ValidatedConfig struct {
+			APIKey string
+		}
+
+		type RawConfig struct {
+			APIKey string
+		}
+
+		innerEffect := Of[ValidatedConfig, string]("success")
+
+		// Validation that can fail
+		validateConfig := func(raw RawConfig) Effect[RawConfig, ValidatedConfig] {
+			if raw.APIKey == "" {
+				return Fail[RawConfig, ValidatedConfig](assert.AnError)
+			}
+			return Of[RawConfig, ValidatedConfig](ValidatedConfig{
+				APIKey: raw.APIKey,
+			})
+		}
+
+		transform := LocalEffectK[string, ValidatedConfig, RawConfig](validateConfig)
+		outerEffect := transform(innerEffect)
+
+		// Test with invalid config
+		ioResult := Provide[RawConfig, string](RawConfig{APIKey: ""})(outerEffect)
+		readerResult := RunSync[string](ioResult)
+		_, err := readerResult(context.Background())
+
+		assert.Error(t, err)
+
+		// Test with valid config
+		ioResult2 := Provide[RawConfig, string](RawConfig{APIKey: "valid-key"})(outerEffect)
+		readerResult2 := RunSync[string](ioResult2)
+		result, err2 := readerResult2(context.Background())
+
+		assert.NoError(t, err2)
+		assert.Equal(t, "success", result)
+	})
+
+	t.Run("composes with other Local functions", func(t *testing.T) {
+		type Level1 struct {
+			Value string
+		}
+		type Level2 struct {
+			Data string
+		}
+		type Level3 struct {
+			Info string
+		}
+
+		// Effect at deepest level
+		effect3 := Of[Level3, string]("result")
+
+		// Use LocalEffectK for first transformation (effectful)
+		localEffectK23 := LocalEffectK[string, Level3, Level2](func(l2 Level2) Effect[Level2, Level3] {
+			return Of[Level2, Level3](Level3{Info: l2.Data})
+		})
+
+		// Use Local for second transformation (pure)
+		local12 := Local[Level1, Level2, string](func(l1 Level1) Level2 {
+			return Level2{Data: l1.Value}
+		})
+
+		// Compose them
+		effect2 := localEffectK23(effect3)
+		effect1 := local12(effect2)
+
+		// Run
+		ioResult := Provide[Level1, string](Level1{Value: "test"})(effect1)
+		readerResult := RunSync[string](ioResult)
+		result, err := readerResult(context.Background())
+
+		assert.NoError(t, err)
+		assert.Equal(t, "result", result)
+	})
+
+	t.Run("handles complex nested effects in transformation", func(t *testing.T) {
+		type InnerCtx struct {
+			Value int
+		}
+
+		type OuterCtx struct {
+			Multiplier int
+		}
+
+		// Effect that uses InnerCtx
+		innerEffect := Chain[InnerCtx](func(ctx InnerCtx) Effect[InnerCtx, int] {
+			return Of[InnerCtx, int](ctx.Value * 2)
+		})(readerreaderioresult.Ask[InnerCtx]())
+
+		// Complex transformation with nested effects
+		complexTransform := func(outer OuterCtx) Effect[OuterCtx, InnerCtx] {
+			return Of[OuterCtx, InnerCtx](InnerCtx{
+				Value: outer.Multiplier * 10,
+			})
+		}
+
+		transform := LocalEffectK[int, InnerCtx, OuterCtx](complexTransform)
+		outerEffect := transform(innerEffect)
+
+		ioResult := Provide[OuterCtx, int](OuterCtx{Multiplier: 3})(outerEffect)
+		readerResult := RunSync[int](ioResult)
+		result, err := readerResult(context.Background())
+
+		assert.NoError(t, err)
+		assert.Equal(t, 60, result) // 3 * 10 * 2
+	})
+}

v2/effect/doc.go

@@ -0,0 +1,222 @@
+// Copyright (c) 2023 - 2025 IBM Corp.
+// All rights reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/*
+Package effect provides a functional effect system for managing side effects in Go.
+
+# Overview
+
+The effect package is a high-level abstraction for composing effectful computations
+that may fail, require dependencies (context), and perform I/O operations. It is built
+on top of ReaderReaderIOResult, providing a clean API for dependency injection and
+error handling.
+
+# Naming Conventions
+
+The naming conventions in this package are modeled after effect-ts (https://effect.website/),
+a popular TypeScript library for functional effect systems. This alignment helps developers
+familiar with effect-ts to quickly understand and use this Go implementation.
+
+# Core Type
+
+The central type is Effect[C, A], which represents:
+  - C: The context/dependency type required by the effect
+  - A: The success value type produced by the effect
+
+An Effect can:
+  - Succeed with a value of type A
+  - Fail with an error
+  - Require a context of type C
+  - Perform I/O operations
+
+# Basic Operations
+
+Creating Effects:
+
+	// Create a successful effect
+	effect.Succeed[MyContext, string]("hello")
+
+	// Create a failed effect
+	effect.Fail[MyContext, string](errors.New("failed"))
+
+	// Lift a pure value into an effect
+	effect.Of[MyContext, int](42)
+
+Transforming Effects:
+
+	// Map over the success value
+	effect.Map[MyContext](func(x int) string {
+		return strconv.Itoa(x)
+	})
+
+	// Chain effects together (flatMap)
+	effect.Chain[MyContext](func(x int) Effect[MyContext, string] {
+		return effect.Succeed[MyContext, string](strconv.Itoa(x))
+	})
+
+	// Tap into an effect without changing its value
+	effect.Tap[MyContext](func(x int) Effect[MyContext, any] {
+		return effect.Succeed[MyContext, any](fmt.Println(x))
+	})
+
+# Dependency Injection
+
+Effects can access their required context:
+
+	// Transform the context before passing it to an effect
+	effect.Local[OuterCtx, InnerCtx](func(outer OuterCtx) InnerCtx {
+		return outer.Inner
+	})
+
+	// Provide a context to run an effect
+	effect.Provide[MyContext, string](myContext)
+
+# Do Notation
+
+The package provides "do notation" for composing effects in a sequential, imperative style:
+
+	type State struct {
+		X int
+		Y string
+	}
+
+	result := effect.Do[MyContext](State{}).
+		Bind(func(y string) func(State) State {
+			return func(s State) State {
+				s.Y = y
+				return s
+			}
+		}, fetchString).
+		Let(func(x int) func(State) State {
+			return func(s State) State {
+				s.X = x
+				return s
+			}
+		}, func(s State) int {
+			return len(s.Y)
+		})
+
+# Bind Operations
+
+The package provides various bind operations for integrating with other effect types:
+
+  - BindIOK: Bind an IO operation
+  - BindIOEitherK: Bind an IOEither operation
+  - BindIOResultK: Bind an IOResult operation
+  - BindReaderK: Bind a Reader operation
+  - BindReaderIOK: Bind a ReaderIO operation
+  - BindEitherK: Bind an Either operation
+
+Each bind operation has a corresponding "L" variant for working with lenses:
+  - BindL, BindIOKL, BindReaderKL, etc.
+
+# Applicative Operations
+
+Apply effects in parallel:
+
+	// Apply a function effect to a value effect
+	effect.Ap[string, MyContext](valueEffect)(functionEffect)
+
+	// Apply effects to build up a structure
+	effect.ApS[MyContext](setter, effect1)
+
+# Traversal
+
+Traverse collections with effects:
+
+	// Map an array with an effectful function
+	effect.TraverseArray[MyContext](func(x int) Effect[MyContext, string] {
+		return effect.Succeed[MyContext, string](strconv.Itoa(x))
+	})
+
+# Retry Logic
+
+Retry effects with configurable policies:
+
+	effect.Retrying[MyContext, string](
+		retryPolicy,
+		func(status retry.RetryStatus) Effect[MyContext, string] {
+			return fetchData()
+		},
+		func(result Result[string]) bool {
+			return result.IsLeft() // retry on error
+		},
+	)
+
+# Monoids
+
+Combine effects using monoid operations:
+
+	// Combine effects using applicative semantics
+	effect.ApplicativeMonoid[MyContext](stringMonoid)
+
+	// Combine effects using alternative semantics (first success)
+	effect.AlternativeMonoid[MyContext](stringMonoid)
+
+# Running Effects
+
+To execute an effect:
+
+	// Provide the context
+	ioResult := effect.Provide[MyContext, string](myContext)(myEffect)
+
+	// Run synchronously
+	readerResult := effect.RunSync(ioResult)
+
+	// Execute with a context.Context
+	value, err := readerResult(ctx)
+
+# Integration with Other Packages
+
+The effect package integrates seamlessly with other fp-go packages:
+  - either: For error handling
+  - io: For I/O operations
+  - reader: For dependency injection
+  - result: For result types
+  - retry: For retry logic
+  - monoid: For combining effects
+
+# Example
+
+	type Config struct {
+		APIKey string
+		BaseURL string
+	}
+
+	func fetchUser(id int) Effect[Config, User] {
+		return effect.Chain[Config](func(cfg Config) Effect[Config, User] {
+			// Use cfg.APIKey and cfg.BaseURL
+			return effect.Succeed[Config, User](User{ID: id})
+		})(effect.Of[Config, Config](Config{}))
+	}
+
+	func main() {
+		cfg := Config{APIKey: "key", BaseURL: "https://api.example.com"}
+		userEffect := fetchUser(42)
+
+		// Run the effect
+		ioResult := effect.Provide(cfg)(userEffect)
+		readerResult := effect.RunSync(ioResult)
+		user, err := readerResult(context.Background())
+
+		if err != nil {
+			log.Fatal(err)
+		}
+		fmt.Printf("User: %+v\n", user)
+	}
+*/
+package effect
+
+//go:generate go run ../main.go lens --dir . --filename gen_lens.go --include-test-files

v2/effect/effect.go

@@ -0,0 +1,51 @@
+package effect
+
+import (
+	"github.com/IBM/fp-go/v2/context/readerreaderioresult"
+	"github.com/IBM/fp-go/v2/function"
+	"github.com/IBM/fp-go/v2/result"
+)
+
+func Succeed[C, A any](a A) Effect[C, A] {
+	return readerreaderioresult.Of[C](a)
+}
+
+func Fail[C, A any](err error) Effect[C, A] {
+	return readerreaderioresult.Left[C, A](err)
+}
+
+func Of[C, A any](a A) Effect[C, A] {
+	return readerreaderioresult.Of[C](a)
+}
+
+func Map[C, A, B any](f func(A) B) Operator[C, A, B] {
+	return readerreaderioresult.Map[C](f)
+}
+
+func Chain[C, A, B any](f Kleisli[C, A, B]) Operator[C, A, B] {
+	return readerreaderioresult.Chain(f)
+}
+
+func Ap[B, C, A any](fa Effect[C, A]) Operator[C, func(A) B, B] {
+	return readerreaderioresult.Ap[B](fa)
+}
+
+func Suspend[C, A any](fa Lazy[Effect[C, A]]) Effect[C, A] {
+	return readerreaderioresult.Defer(fa)
+}
+
+func Tap[C, A, ANY any](f Kleisli[C, A, ANY]) Operator[C, A, A] {
+	return readerreaderioresult.Tap(f)
+}
+
+func Ternary[C, A, B any](pred Predicate[A], onTrue, onFalse Kleisli[C, A, B]) Kleisli[C, A, B] {
+	return function.Ternary(pred, onTrue, onFalse)
+}
+
+func ChainResultK[C, A, B any](f result.Kleisli[A, B]) Operator[C, A, B] {
+	return readerreaderioresult.ChainResultK[C](f)
+}
+
+func Read[A, C any](c C) func(Effect[C, A]) Thunk[A] {
+	return readerreaderioresult.Read[A](c)
+}

v2/effect/effect_test.go

@@ -0,0 +1,506 @@
+// Copyright (c) 2023 - 2025 IBM Corp.
+// All rights reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package effect
+
+import (
+	"context"
+	"errors"
+	"fmt"
+	"testing"
+
+	"github.com/IBM/fp-go/v2/result"
+	"github.com/stretchr/testify/assert"
+)
+
+type TestContext struct {
+	Value string
+}
+
+func runEffect[A any](eff Effect[TestContext, A], ctx TestContext) (A, error) {
+	ioResult := Provide[TestContext, A](ctx)(eff)
+	readerResult := RunSync[A](ioResult)
+	return readerResult(context.Background())
+}
+
+func TestSucceed(t *testing.T) {
+	t.Run("creates successful effect with value", func(t *testing.T) {
+		eff := Succeed[TestContext, int](42)
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, 42, result)
+	})
+
+	t.Run("creates successful effect with string", func(t *testing.T) {
+		eff := Succeed[TestContext, string]("hello")
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, "hello", result)
+	})
+
+	t.Run("creates successful effect with struct", func(t *testing.T) {
+		type User struct {
+			Name string
+			Age  int
+		}
+		user := User{Name: "Alice", Age: 30}
+		eff := Succeed[TestContext, User](user)
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, user, result)
+	})
+}
+
+func TestFail(t *testing.T) {
+	t.Run("creates failed effect with error", func(t *testing.T) {
+		expectedErr := errors.New("test error")
+		eff := Fail[TestContext, int](expectedErr)
+		_, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.Error(t, err)
+		assert.Equal(t, expectedErr, err)
+	})
+
+	t.Run("creates failed effect with custom error", func(t *testing.T) {
+		expectedErr := fmt.Errorf("custom error: %s", "details")
+		eff := Fail[TestContext, string](expectedErr)
+		_, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.Error(t, err)
+		assert.Equal(t, expectedErr, err)
+	})
+}
+
+func TestOf(t *testing.T) {
+	t.Run("lifts value into effect", func(t *testing.T) {
+		eff := Of[TestContext, int](100)
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, 100, result)
+	})
+
+	t.Run("is equivalent to Succeed", func(t *testing.T) {
+		value := "test value"
+		eff1 := Of[TestContext, string](value)
+		eff2 := Succeed[TestContext, string](value)
+
+		result1, err1 := runEffect(eff1, TestContext{Value: "test"})
+		result2, err2 := runEffect(eff2, TestContext{Value: "test"})
+
+		assert.NoError(t, err1)
+		assert.NoError(t, err2)
+		assert.Equal(t, result1, result2)
+	})
+}
+
+func TestMap(t *testing.T) {
+	t.Run("maps over successful effect", func(t *testing.T) {
+		eff := Of[TestContext, int](10)
+		mapped := Map[TestContext](func(x int) int {
+			return x * 2
+		})(eff)
+
+		result, err := runEffect(mapped, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, 20, result)
+	})
+
+	t.Run("maps to different type", func(t *testing.T) {
+		eff := Of[TestContext, int](42)
+		mapped := Map[TestContext](func(x int) string {
+			return fmt.Sprintf("value: %d", x)
+		})(eff)
+
+		result, err := runEffect(mapped, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, "value: 42", result)
+	})
+
+	t.Run("preserves error in failed effect", func(t *testing.T) {
+		expectedErr := errors.New("original error")
+		eff := Fail[TestContext, int](expectedErr)
+		mapped := Map[TestContext](func(x int) int {
+			return x * 2
+		})(eff)
+
+		_, err := runEffect(mapped, TestContext{Value: "test"})
+
+		assert.Error(t, err)
+		assert.Equal(t, expectedErr, err)
+	})
+
+	t.Run("chains multiple maps", func(t *testing.T) {
+		eff := Of[TestContext, int](5)
+		result := Map[TestContext](func(x int) int {
+			return x + 1
+		})(Map[TestContext](func(x int) int {
+			return x * 2
+		})(eff))
+
+		value, err := runEffect(result, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, 11, value) // (5 * 2) + 1
+	})
+}
+
+func TestChain(t *testing.T) {
+	t.Run("chains successful effects", func(t *testing.T) {
+		eff := Of[TestContext, int](10)
+		chained := Chain[TestContext](func(x int) Effect[TestContext, int] {
+			return Of[TestContext, int](x * 2)
+		})(eff)
+
+		result, err := runEffect(chained, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, 20, result)
+	})
+
+	t.Run("chains to different type", func(t *testing.T) {
+		eff := Of[TestContext, int](42)
+		chained := Chain[TestContext](func(x int) Effect[TestContext, string] {
+			return Of[TestContext, string](fmt.Sprintf("number: %d", x))
+		})(eff)
+
+		result, err := runEffect(chained, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, "number: 42", result)
+	})
+
+	t.Run("propagates first error", func(t *testing.T) {
+		expectedErr := errors.New("first error")
+		eff := Fail[TestContext, int](expectedErr)
+		chained := Chain[TestContext](func(x int) Effect[TestContext, int] {
+			return Of[TestContext, int](x * 2)
+		})(eff)
+
+		_, err := runEffect(chained, TestContext{Value: "test"})
+
+		assert.Error(t, err)
+		assert.Equal(t, expectedErr, err)
+	})
+
+	t.Run("propagates second error", func(t *testing.T) {
+		expectedErr := errors.New("second error")
+		eff := Of[TestContext, int](10)
+		chained := Chain[TestContext](func(x int) Effect[TestContext, int] {
+			return Fail[TestContext, int](expectedErr)
+		})(eff)
+
+		_, err := runEffect(chained, TestContext{Value: "test"})
+
+		assert.Error(t, err)
+		assert.Equal(t, expectedErr, err)
+	})
+
+	t.Run("chains multiple operations", func(t *testing.T) {
+		eff := Of[TestContext, int](5)
+		result := Chain[TestContext](func(x int) Effect[TestContext, int] {
+			return Of[TestContext, int](x + 10)
+		})(Chain[TestContext](func(x int) Effect[TestContext, int] {
+			return Of[TestContext, int](x * 2)
+		})(eff))
+
+		value, err := runEffect(result, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, 20, value) // (5 * 2) + 10
+	})
+}
+
+func TestAp(t *testing.T) {
+	t.Run("applies function effect to value effect", func(t *testing.T) {
+		fn := Of[TestContext, func(int) int](func(x int) int {
+			return x * 2
+		})
+		value := Of[TestContext, int](21)
+
+		result := Ap[int](value)(fn)
+		val, err := runEffect(result, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, 42, val)
+	})
+
+	t.Run("applies function to different type", func(t *testing.T) {
+		fn := Of[TestContext, func(int) string](func(x int) string {
+			return fmt.Sprintf("value: %d", x)
+		})
+		value := Of[TestContext, int](42)
+
+		result := Ap[string](value)(fn)
+		val, err := runEffect(result, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, "value: 42", val)
+	})
+
+	t.Run("propagates error from function effect", func(t *testing.T) {
+		expectedErr := errors.New("function error")
+		fn := Fail[TestContext, func(int) int](expectedErr)
+		value := Of[TestContext, int](42)
+
+		result := Ap[int](value)(fn)
+		_, err := runEffect(result, TestContext{Value: "test"})
+
+		assert.Error(t, err)
+		assert.Equal(t, expectedErr, err)
+	})
+
+	t.Run("propagates error from value effect", func(t *testing.T) {
+		expectedErr := errors.New("value error")
+		fn := Of[TestContext, func(int) int](func(x int) int {
+			return x * 2
+		})
+		value := Fail[TestContext, int](expectedErr)
+
+		result := Ap[int](value)(fn)
+		_, err := runEffect(result, TestContext{Value: "test"})
+
+		assert.Error(t, err)
+		assert.Equal(t, expectedErr, err)
+	})
+}
+
+func TestSuspend(t *testing.T) {
+	t.Run("suspends effect computation", func(t *testing.T) {
+		callCount := 0
+		eff := Suspend[TestContext, int](func() Effect[TestContext, int] {
+			callCount++
+			return Of[TestContext, int](42)
+		})
+
+		// Effect not executed yet
+		assert.Equal(t, 0, callCount)
+
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, 42, result)
+		assert.Equal(t, 1, callCount)
+	})
+
+	t.Run("suspends failing effect", func(t *testing.T) {
+		expectedErr := errors.New("suspended error")
+		eff := Suspend[TestContext, int](func() Effect[TestContext, int] {
+			return Fail[TestContext, int](expectedErr)
+		})
+
+		_, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.Error(t, err)
+		assert.Equal(t, expectedErr, err)
+	})
+
+	t.Run("allows lazy evaluation", func(t *testing.T) {
+		var value int
+		eff := Suspend[TestContext, int](func() Effect[TestContext, int] {
+			return Of[TestContext, int](value)
+		})
+
+		value = 10
+		result1, err1 := runEffect(eff, TestContext{Value: "test"})
+
+		value = 20
+		result2, err2 := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err1)
+		assert.NoError(t, err2)
+		assert.Equal(t, 10, result1)
+		assert.Equal(t, 20, result2)
+	})
+}
+
+func TestTap(t *testing.T) {
+	t.Run("executes side effect without changing value", func(t *testing.T) {
+		sideEffectValue := 0
+		eff := Of[TestContext, int](42)
+		tapped := Tap[TestContext](func(x int) Effect[TestContext, any] {
+			sideEffectValue = x * 2
+			return Of[TestContext, any](nil)
+		})(eff)
+
+		result, err := runEffect(tapped, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, 42, result)
+		assert.Equal(t, 84, sideEffectValue)
+	})
+
+	t.Run("propagates original error", func(t *testing.T) {
+		expectedErr := errors.New("original error")
+		eff := Fail[TestContext, int](expectedErr)
+		tapped := Tap[TestContext](func(x int) Effect[TestContext, any] {
+			return Of[TestContext, any](nil)
+		})(eff)
+
+		_, err := runEffect(tapped, TestContext{Value: "test"})
+
+		assert.Error(t, err)
+		assert.Equal(t, expectedErr, err)
+	})
+
+	t.Run("propagates tap error", func(t *testing.T) {
+		expectedErr := errors.New("tap error")
+		eff := Of[TestContext, int](42)
+		tapped := Tap[TestContext](func(x int) Effect[TestContext, any] {
+			return Fail[TestContext, any](expectedErr)
+		})(eff)
+
+		_, err := runEffect(tapped, TestContext{Value: "test"})
+
+		assert.Error(t, err)
+		assert.Equal(t, expectedErr, err)
+	})
+
+	t.Run("chains multiple taps", func(t *testing.T) {
+		values := []int{}
+		eff := Of[TestContext, int](10)
+		result := Tap[TestContext](func(x int) Effect[TestContext, any] {
+			values = append(values, x+2)
+			return Of[TestContext, any](nil)
+		})(Tap[TestContext](func(x int) Effect[TestContext, any] {
+			values = append(values, x+1)
+			return Of[TestContext, any](nil)
+		})(eff))
+
+		value, err := runEffect(result, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, 10, value)
+		assert.Equal(t, []int{11, 12}, values)
+	})
+}
+
+func TestTernary(t *testing.T) {
+	t.Run("executes onTrue when predicate is true", func(t *testing.T) {
+		kleisli := Ternary[TestContext, int, string](
+			func(x int) bool { return x > 10 },
+			func(x int) Effect[TestContext, string] {
+				return Of[TestContext, string]("greater")
+			},
+			func(x int) Effect[TestContext, string] {
+				return Of[TestContext, string]("less or equal")
+			},
+		)
+
+		result, err := runEffect(kleisli(15), TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, "greater", result)
+	})
+
+	t.Run("executes onFalse when predicate is false", func(t *testing.T) {
+		kleisli := Ternary[TestContext, int, string](
+			func(x int) bool { return x > 10 },
+			func(x int) Effect[TestContext, string] {
+				return Of[TestContext, string]("greater")
+			},
+			func(x int) Effect[TestContext, string] {
+				return Of[TestContext, string]("less or equal")
+			},
+		)
+
+		result, err := runEffect(kleisli(5), TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, "less or equal", result)
+	})
+
+	t.Run("handles errors in onTrue branch", func(t *testing.T) {
+		expectedErr := errors.New("true branch error")
+		kleisli := Ternary[TestContext, int, string](
+			func(x int) bool { return x > 10 },
+			func(x int) Effect[TestContext, string] {
+				return Fail[TestContext, string](expectedErr)
+			},
+			func(x int) Effect[TestContext, string] {
+				return Of[TestContext, string]("less or equal")
+			},
+		)
+
+		_, err := runEffect(kleisli(15), TestContext{Value: "test"})
+
+		assert.Error(t, err)
+		assert.Equal(t, expectedErr, err)
+	})
+
+	t.Run("handles errors in onFalse branch", func(t *testing.T) {
+		expectedErr := errors.New("false branch error")
+		kleisli := Ternary[TestContext, int, string](
+			func(x int) bool { return x > 10 },
+			func(x int) Effect[TestContext, string] {
+				return Of[TestContext, string]("greater")
+			},
+			func(x int) Effect[TestContext, string] {
+				return Fail[TestContext, string](expectedErr)
+			},
+		)
+
+		_, err := runEffect(kleisli(5), TestContext{Value: "test"})
+
+		assert.Error(t, err)
+		assert.Equal(t, expectedErr, err)
+	})
+}
+
+func TestEffectComposition(t *testing.T) {
+	t.Run("composes Map and Chain", func(t *testing.T) {
+		eff := Of[TestContext, int](5)
+		result := Chain[TestContext](func(x int) Effect[TestContext, string] {
+			return Of[TestContext, string](fmt.Sprintf("result: %d", x))
+		})(Map[TestContext](func(x int) int {
+			return x * 2
+		})(eff))
+
+		value, err := runEffect(result, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, "result: 10", value)
+	})
+
+	t.Run("composes Chain and Tap", func(t *testing.T) {
+		sideEffect := 0
+		eff := Of[TestContext, int](10)
+		result := Tap[TestContext](func(x int) Effect[TestContext, any] {
+			sideEffect = x
+			return Of[TestContext, any](nil)
+		})(Chain[TestContext](func(x int) Effect[TestContext, int] {
+			return Of[TestContext, int](x * 2)
+		})(eff))
+
+		value, err := runEffect(result, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, 20, value)
+		assert.Equal(t, 20, sideEffect)
+	})
+}
+
+func TestEffectWithResult(t *testing.T) {
+	t.Run("converts result to effect", func(t *testing.T) {
+		res := result.Of[int](42)
+		// This demonstrates integration with result package
+		assert.True(t, result.IsRight(res))
+	})
+}

v2/effect/gen_lens_test.go

@@ -0,0 +1,118 @@
+package effect
+
+// Code generated by go generate; DO NOT EDIT.
+// This file was generated by robots at
+// 2026-01-27 22:19:41.6840253 +0100 CET m=+0.008579701
+
+import (
+	__lens "github.com/IBM/fp-go/v2/optics/lens"
+	__option "github.com/IBM/fp-go/v2/option"
+	__prism "github.com/IBM/fp-go/v2/optics/prism"
+	__lens_option "github.com/IBM/fp-go/v2/optics/lens/option"
+	__iso_option "github.com/IBM/fp-go/v2/optics/iso/option"
+)
+
+// ComplexServiceLenses provides lenses for accessing fields of ComplexService
+type ComplexServiceLenses struct {
+	// mandatory fields
+	service1 __lens.Lens[ComplexService, Service1]
+	service2 __lens.Lens[ComplexService, Service2]
+	// optional fields
+	service1O __lens_option.LensO[ComplexService, Service1]
+	service2O __lens_option.LensO[ComplexService, Service2]
+}
+
+// ComplexServiceRefLenses provides lenses for accessing fields of ComplexService via a reference to ComplexService
+type ComplexServiceRefLenses struct {
+	// mandatory fields
+	service1 __lens.Lens[*ComplexService, Service1]
+	service2 __lens.Lens[*ComplexService, Service2]
+	// optional fields
+	service1O __lens_option.LensO[*ComplexService, Service1]
+	service2O __lens_option.LensO[*ComplexService, Service2]
+	// prisms
+	service1P __prism.Prism[*ComplexService, Service1]
+	service2P __prism.Prism[*ComplexService, Service2]
+}
+
+// ComplexServicePrisms provides prisms for accessing fields of ComplexService
+type ComplexServicePrisms struct {
+	service1 __prism.Prism[ComplexService, Service1]
+	service2 __prism.Prism[ComplexService, Service2]
+}
+
+// MakeComplexServiceLenses creates a new ComplexServiceLenses with lenses for all fields
+func MakeComplexServiceLenses() ComplexServiceLenses {
+	// mandatory lenses
+	lensservice1 := __lens.MakeLensWithName(
+		func(s ComplexService) Service1 { return s.service1 },
+		func(s ComplexService, v Service1) ComplexService { s.service1 = v; return s },
+		"ComplexService.service1",
+	)
+	lensservice2 := __lens.MakeLensWithName(
+		func(s ComplexService) Service2 { return s.service2 },
+		func(s ComplexService, v Service2) ComplexService { s.service2 = v; return s },
+		"ComplexService.service2",
+	)
+	// optional lenses
+	lensservice1O := __lens_option.FromIso[ComplexService](__iso_option.FromZero[Service1]())(lensservice1)
+	lensservice2O := __lens_option.FromIso[ComplexService](__iso_option.FromZero[Service2]())(lensservice2)
+	return ComplexServiceLenses{
+		// mandatory lenses
+		service1: lensservice1,
+		service2: lensservice2,
+		// optional lenses
+		service1O: lensservice1O,
+		service2O: lensservice2O,
+	}
+}
+
+// MakeComplexServiceRefLenses creates a new ComplexServiceRefLenses with lenses for all fields
+func MakeComplexServiceRefLenses() ComplexServiceRefLenses {
+	// mandatory lenses
+	lensservice1 := __lens.MakeLensStrictWithName(
+		func(s *ComplexService) Service1 { return s.service1 },
+		func(s *ComplexService, v Service1) *ComplexService { s.service1 = v; return s },
+		"(*ComplexService).service1",
+	)
+	lensservice2 := __lens.MakeLensStrictWithName(
+		func(s *ComplexService) Service2 { return s.service2 },
+		func(s *ComplexService, v Service2) *ComplexService { s.service2 = v; return s },
+		"(*ComplexService).service2",
+	)
+	// optional lenses
+	lensservice1O := __lens_option.FromIso[*ComplexService](__iso_option.FromZero[Service1]())(lensservice1)
+	lensservice2O := __lens_option.FromIso[*ComplexService](__iso_option.FromZero[Service2]())(lensservice2)
+	return ComplexServiceRefLenses{
+		// mandatory lenses
+		service1: lensservice1,
+		service2: lensservice2,
+		// optional lenses
+		service1O: lensservice1O,
+		service2O: lensservice2O,
+	}
+}
+
+// MakeComplexServicePrisms creates a new ComplexServicePrisms with prisms for all fields
+func MakeComplexServicePrisms() ComplexServicePrisms {
+	_fromNonZeroservice1 := __option.FromNonZero[Service1]()
+	_prismservice1 := __prism.MakePrismWithName(
+		func(s ComplexService) __option.Option[Service1] { return _fromNonZeroservice1(s.service1) },
+		func(v Service1) ComplexService {
+			return ComplexService{ service1: v }
+		},
+		"ComplexService.service1",
+	)
+	_fromNonZeroservice2 := __option.FromNonZero[Service2]()
+	_prismservice2 := __prism.MakePrismWithName(
+		func(s ComplexService) __option.Option[Service2] { return _fromNonZeroservice2(s.service2) },
+		func(v Service2) ComplexService {
+			return ComplexService{ service2: v }
+		},
+		"ComplexService.service2",
+	)
+	return ComplexServicePrisms {
+		service1: _prismservice1,
+		service2: _prismservice2,
+	}
+}

v2/effect/injection_test.go

@@ -0,0 +1,207 @@
+// Package effect demonstrates dependency injection using the Effect pattern.
+//
+// This test file shows how to build a type-safe dependency injection system where:
+// - An InjectionContainer can resolve services by ID (InjectionToken)
+// - Services are generic effects that depend on the container
+// - Lookup methods convert from untyped container to typed dependencies
+// - Handler functions depend type-safely on specific service interfaces
+package effect
+
+import (
+	"errors"
+	"fmt"
+	"testing"
+
+	thunk "github.com/IBM/fp-go/v2/context/readerioresult"
+	F "github.com/IBM/fp-go/v2/function"
+	"github.com/IBM/fp-go/v2/result"
+)
+
+type (
+	// InjectionToken is a unique identifier for services in the container
+	InjectionToken string
+
+	// InjectionContainer is an Effect that resolves services by their token.
+	// It takes an InjectionToken and returns a Thunk that produces any type.
+	// This allows the container to store and retrieve services of different types.
+	InjectionContainer = Effect[InjectionToken, any]
+
+	// Service is a generic Effect that depends on the InjectionContainer.
+	// It represents a computation that needs access to the dependency injection
+	// container to resolve its dependencies before producing a string result.
+	Service[T any] = Effect[InjectionContainer, T]
+
+	// Service1 is an example service interface that can be resolved from the container
+	Service1 interface {
+		GetService1() string
+	}
+
+	// Service2 is another example service interface
+	Service2 interface {
+		GetService2() string
+	}
+
+	// impl1 is a concrete implementation of Service1
+	impl1 struct{}
+	// impl2 is a concrete implementation of Service2
+	impl2 struct{}
+)
+
+// ComplexService demonstrates a more complex dependency injection scenario
+// where a service depends on multiple other services. This struct aggregates
+// Service1 and Service2, showing how to compose dependencies.
+// The fp-go:Lens directive generates lens functions for type-safe field access.
+//
+// fp-go:Lens
+type ComplexService struct {
+	service1 Service1
+	service2 Service2
+}
+
+func (_ *impl1) GetService1() string {
+	return "service1"
+}
+
+func (_ *impl2) GetService2() string {
+	return "service2"
+}
+
+const (
+	// service1 is the injection token for Service1
+	service1 = InjectionToken("service1")
+	// service2 is the injection token for Service2
+	service2 = InjectionToken("service2")
+)
+
+var (
+	// complexServiceLenses provides type-safe accessors for ComplexService fields,
+	// generated by the fp-go:Lens directive. These lenses are used in applicative
+	// composition to build the ComplexService from individual dependencies.
+	complexServiceLenses = MakeComplexServiceLenses()
+)
+
+// makeSampleInjectionContainer creates an InjectionContainer that can resolve services by ID.
+// The container maps InjectionTokens to their corresponding service implementations.
+// It returns an error if a requested service is not available.
+func makeSampleInjectionContainer() InjectionContainer {
+
+	return func(token InjectionToken) Thunk[any] {
+		switch token {
+		case service1:
+			return thunk.Of(any(&impl1{}))
+		case service2:
+			return thunk.Of(any(&impl2{}))
+		default:
+			return thunk.Left[any](errors.New("dependency not available"))
+		}
+	}
+}
+
+// handleService1 is an Effect that depends type-safely on Service1.
+// It demonstrates how to write handlers that work with specific service interfaces
+// rather than the untyped container, providing compile-time type safety.
+func handleService1() Effect[Service1, string] {
+	return func(ctx Service1) ReaderIOResult[string] {
+		return thunk.Of(fmt.Sprintf("Service1: %s", ctx.GetService1()))
+	}
+}
+
+// handleComplexService is an Effect that depends on ComplexService, which itself
+// aggregates multiple service dependencies (Service1 and Service2).
+// This demonstrates how to work with composite dependencies in a type-safe manner.
+func handleComplexService() Effect[ComplexService, string] {
+	return func(ctx ComplexService) ReaderIOResult[string] {
+		return thunk.Of(fmt.Sprintf("ComplexService: %s x %s", ctx.service1.GetService1(), ctx.service2.GetService2()))
+	}
+}
+
+// lookupService1 is a lookup method that converts from an untyped InjectionContainer
+// to a typed Service1 dependency. It performs two steps:
+// 1. Read[any](service1) - retrieves the service from the container by token
+// 2. ChainResultK(result.InstanceOf[Service1]) - safely casts from any to Service1
+// This conversion provides type safety when moving from the untyped container to typed handlers.
+var lookupService1 = F.Flow2(
+	Read[any](service1),
+	thunk.ChainResultK(result.InstanceOf[Service1]),
+)
+
+// lookupService2 is a lookup method for Service2, following the same pattern as lookupService1.
+// It retrieves Service2 from the container and safely casts it to the correct type.
+var lookupService2 = F.Flow2(
+	Read[any](service2),
+	thunk.ChainResultK(result.InstanceOf[Service2]),
+)
+
+// lookupComplexService demonstrates applicative composition for complex dependency injection.
+// It builds a ComplexService by composing multiple service lookups:
+// 1. Do[InjectionContainer](ComplexService{}) - starts with an empty ComplexService in the Effect context
+// 2. ApSL(complexServiceLenses.service1, lookupService1) - looks up Service1 and sets it using the lens
+// 3. ApSL(complexServiceLenses.service2, lookupService2) - looks up Service2 and sets it using the lens
+//
+// This applicative style allows parallel composition of independent dependencies,
+// building the complete ComplexService from its constituent parts in a type-safe way.
+var lookupComplexService = F.Pipe2(
+	Do[InjectionContainer](ComplexService{}),
+	ApSL(complexServiceLenses.service1, lookupService1),
+	ApSL(complexServiceLenses.service2, lookupService2),
+)
+
+// handleResult is a curried function that combines results from two services.
+// It demonstrates how to compose the outputs of multiple effects into a final result.
+// The curried form allows it to be used with applicative composition (ApS).
+func handleResult(s1 string) func(string) string {
+	return func(s2 string) string {
+		return fmt.Sprintf("Final Result: %s : %s", s1, s2)
+	}
+}
+
+// TestDependencyLookup demonstrates both simple and complex dependency injection patterns:
+//
+// Simple Pattern (handle1):
+// 1. Create an InjectionContainer with registered services
+// 2. Define a handler (handleService1) that depends on a single typed service interface
+// 3. Use a lookup method (lookupService1) to resolve the dependency from the container
+// 4. Compose the handler with the lookup using LocalThunkK to inject the dependency
+//
+// Complex Pattern (handleComplex):
+// 1. Define a handler (handleComplexService) that depends on a composite service (ComplexService)
+// 2. Use applicative composition (lookupComplexService) to build the composite from multiple lookups
+// 3. Each sub-dependency is resolved independently and combined using lenses
+// 4. LocalThunkK injects the complete composite dependency into the handler
+//
+// Service Composition:
+// - ApS combines the results of handle1 and handleComplex using handleResult
+// - This demonstrates how to compose multiple independent effects that share the same container
+// - The final result aggregates outputs from both simple and complex dependency patterns
+func TestDependencyLookup(t *testing.T) {
+
+	// Create the dependency injection container
+	container := makeSampleInjectionContainer()
+
+	// Simple dependency injection: single service lookup
+	// LocalThunkK transforms the handler to work with the container
+	handle1 := F.Pipe1(
+		handleService1(),
+		LocalThunkK[string](lookupService1),
+	)
+
+	// Complex dependency injection: composite service with multiple dependencies
+	// lookupComplexService uses applicative composition to build ComplexService
+	handleComplex := F.Pipe1(
+		handleComplexService(),
+		LocalThunkK[string](lookupComplexService),
+	)
+
+	// Compose both services using applicative style
+	// ApS applies handleResult to combine outputs from handle1 and handleComplex
+	result := F.Pipe1(
+		handle1,
+		ApS(handleResult, handleComplex),
+	)
+
+	// Execute: provide container, then context, then run the IO operation
+	res := result(container)(t.Context())()
+
+	fmt.Println(res)
+
+}

v2/effect/monoid.go

@@ -0,0 +1,14 @@
+package effect
+
+import (
+	"github.com/IBM/fp-go/v2/context/readerreaderioresult"
+	"github.com/IBM/fp-go/v2/monoid"
+)
+
+func ApplicativeMonoid[C, A any](m monoid.Monoid[A]) Monoid[Effect[C, A]] {
+	return readerreaderioresult.ApplicativeMonoid[C](m)
+}
+
+func AlternativeMonoid[C, A any](m monoid.Monoid[A]) Monoid[Effect[C, A]] {
+	return readerreaderioresult.AlternativeMonoid[C](m)
+}

v2/effect/monoid_test.go

@@ -0,0 +1,350 @@
+// Copyright (c) 2023 - 2025 IBM Corp.
+// All rights reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package effect
+
+import (
+	"errors"
+	"testing"
+
+	"github.com/IBM/fp-go/v2/monoid"
+	"github.com/stretchr/testify/assert"
+)
+
+func TestApplicativeMonoid(t *testing.T) {
+	t.Run("combines successful effects with string monoid", func(t *testing.T) {
+		stringMonoid := monoid.MakeMonoid(
+			func(a, b string) string { return a + b },
+			"",
+		)
+
+		effectMonoid := ApplicativeMonoid[TestContext, string](stringMonoid)
+
+		eff1 := Of[TestContext, string]("Hello")
+		eff2 := Of[TestContext, string](" ")
+		eff3 := Of[TestContext, string]("World")
+
+		combined := effectMonoid.Concat(eff1, effectMonoid.Concat(eff2, eff3))
+		result, err := runEffect(combined, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, "Hello World", result)
+	})
+
+	t.Run("combines successful effects with int monoid", func(t *testing.T) {
+		intMonoid := monoid.MakeMonoid(
+			func(a, b int) int { return a + b },
+			0,
+		)
+
+		effectMonoid := ApplicativeMonoid[TestContext, int](intMonoid)
+
+		eff1 := Of[TestContext, int](10)
+		eff2 := Of[TestContext, int](20)
+		eff3 := Of[TestContext, int](30)
+
+		combined := effectMonoid.Concat(eff1, effectMonoid.Concat(eff2, eff3))
+		result, err := runEffect(combined, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, 60, result)
+	})
+
+	t.Run("returns empty value for empty monoid", func(t *testing.T) {
+		stringMonoid := monoid.MakeMonoid(
+			func(a, b string) string { return a + b },
+			"empty",
+		)
+
+		effectMonoid := ApplicativeMonoid[TestContext, string](stringMonoid)
+
+		result, err := runEffect(effectMonoid.Empty(), TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, "empty", result)
+	})
+
+	t.Run("propagates first error", func(t *testing.T) {
+		expectedErr := errors.New("first error")
+		stringMonoid := monoid.MakeMonoid(
+			func(a, b string) string { return a + b },
+			"",
+		)
+
+		effectMonoid := ApplicativeMonoid[TestContext, string](stringMonoid)
+
+		eff1 := Fail[TestContext, string](expectedErr)
+		eff2 := Of[TestContext, string]("World")
+
+		combined := effectMonoid.Concat(eff1, eff2)
+		_, err := runEffect(combined, TestContext{Value: "test"})
+
+		assert.Error(t, err)
+		assert.Equal(t, expectedErr, err)
+	})
+
+	t.Run("propagates second error", func(t *testing.T) {
+		expectedErr := errors.New("second error")
+		stringMonoid := monoid.MakeMonoid(
+			func(a, b string) string { return a + b },
+			"",
+		)
+
+		effectMonoid := ApplicativeMonoid[TestContext, string](stringMonoid)
+
+		eff1 := Of[TestContext, string]("Hello")
+		eff2 := Fail[TestContext, string](expectedErr)
+
+		combined := effectMonoid.Concat(eff1, eff2)
+		_, err := runEffect(combined, TestContext{Value: "test"})
+
+		assert.Error(t, err)
+		assert.Equal(t, expectedErr, err)
+	})
+
+	t.Run("combines multiple effects", func(t *testing.T) {
+		intMonoid := monoid.MakeMonoid(
+			func(a, b int) int { return a * b },
+			1,
+		)
+
+		effectMonoid := ApplicativeMonoid[TestContext, int](intMonoid)
+
+		effects := []Effect[TestContext, int]{
+			Of[TestContext, int](2),
+			Of[TestContext, int](3),
+			Of[TestContext, int](4),
+			Of[TestContext, int](5),
+		}
+
+		combined := effectMonoid.Empty()
+		for _, eff := range effects {
+			combined = effectMonoid.Concat(combined, eff)
+		}
+
+		result, err := runEffect(combined, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, 120, result) // 1 * 2 * 3 * 4 * 5
+	})
+
+	t.Run("works with custom types", func(t *testing.T) {
+		type Counter struct {
+			Count int
+		}
+
+		counterMonoid := monoid.MakeMonoid(
+			func(a, b Counter) Counter {
+				return Counter{Count: a.Count + b.Count}
+			},
+			Counter{Count: 0},
+		)
+
+		effectMonoid := ApplicativeMonoid[TestContext, Counter](counterMonoid)
+
+		eff1 := Of[TestContext, Counter](Counter{Count: 5})
+		eff2 := Of[TestContext, Counter](Counter{Count: 10})
+		eff3 := Of[TestContext, Counter](Counter{Count: 15})
+
+		combined := effectMonoid.Concat(eff1, effectMonoid.Concat(eff2, eff3))
+		result, err := runEffect(combined, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, 30, result.Count)
+	})
+}
+
+func TestAlternativeMonoid(t *testing.T) {
+	t.Run("combines successful effects with monoid", func(t *testing.T) {
+		stringMonoid := monoid.MakeMonoid(
+			func(a, b string) string { return a + b },
+			"",
+		)
+
+		effectMonoid := AlternativeMonoid[TestContext, string](stringMonoid)
+
+		eff1 := Of[TestContext, string]("First")
+		eff2 := Of[TestContext, string]("Second")
+
+		combined := effectMonoid.Concat(eff1, eff2)
+		result, err := runEffect(combined, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, "FirstSecond", result) // Alternative still combines when both succeed
+	})
+
+	t.Run("tries second effect if first fails", func(t *testing.T) {
+		stringMonoid := monoid.MakeMonoid(
+			func(a, b string) string { return a + b },
+			"",
+		)
+
+		effectMonoid := AlternativeMonoid[TestContext, string](stringMonoid)
+
+		eff1 := Fail[TestContext, string](errors.New("first failed"))
+		eff2 := Of[TestContext, string]("Second")
+
+		combined := effectMonoid.Concat(eff1, eff2)
+		result, err := runEffect(combined, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, "Second", result)
+	})
+
+	t.Run("returns error if all effects fail", func(t *testing.T) {
+		expectedErr := errors.New("second error")
+		stringMonoid := monoid.MakeMonoid(
+			func(a, b string) string { return a + b },
+			"",
+		)
+
+		effectMonoid := AlternativeMonoid[TestContext, string](stringMonoid)
+
+		eff1 := Fail[TestContext, string](errors.New("first error"))
+		eff2 := Fail[TestContext, string](expectedErr)
+
+		combined := effectMonoid.Concat(eff1, eff2)
+		_, err := runEffect(combined, TestContext{Value: "test"})
+
+		assert.Error(t, err)
+		assert.Equal(t, expectedErr, err)
+	})
+
+	t.Run("returns empty value for empty monoid", func(t *testing.T) {
+		stringMonoid := monoid.MakeMonoid(
+			func(a, b string) string { return a + b },
+			"default",
+		)
+
+		effectMonoid := AlternativeMonoid[TestContext, string](stringMonoid)
+
+		result, err := runEffect(effectMonoid.Empty(), TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, "default", result)
+	})
+
+	t.Run("chains multiple alternatives", func(t *testing.T) {
+		intMonoid := monoid.MakeMonoid(
+			func(a, b int) int { return a + b },
+			0,
+		)
+
+		effectMonoid := AlternativeMonoid[TestContext, int](intMonoid)
+
+		eff1 := Fail[TestContext, int](errors.New("error 1"))
+		eff2 := Fail[TestContext, int](errors.New("error 2"))
+		eff3 := Of[TestContext, int](42)
+		eff4 := Of[TestContext, int](100)
+
+		combined := effectMonoid.Concat(
+			effectMonoid.Concat(eff1, eff2),
+			effectMonoid.Concat(eff3, eff4),
+		)
+
+		result, err := runEffect(combined, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, 142, result) // Combines successful values: 42 + 100
+	})
+
+	t.Run("works with custom types", func(t *testing.T) {
+		type Result struct {
+			Value string
+			Code  int
+		}
+
+		resultMonoid := monoid.MakeMonoid(
+			func(a, b Result) Result {
+				return Result{Value: a.Value + b.Value, Code: a.Code + b.Code}
+			},
+			Result{Value: "", Code: 0},
+		)
+
+		effectMonoid := AlternativeMonoid[TestContext, Result](resultMonoid)
+
+		eff1 := Fail[TestContext, Result](errors.New("failed"))
+		eff2 := Of[TestContext, Result](Result{Value: "success", Code: 200})
+		eff3 := Of[TestContext, Result](Result{Value: "backup", Code: 201})
+
+		combined := effectMonoid.Concat(effectMonoid.Concat(eff1, eff2), eff3)
+		result, err := runEffect(combined, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, "successbackup", result.Value) // Combines both successful values
+		assert.Equal(t, 401, result.Code)              // 200 + 201
+	})
+}
+
+func TestMonoidComparison(t *testing.T) {
+	t.Run("ApplicativeMonoid vs AlternativeMonoid with all success", func(t *testing.T) {
+		stringMonoid := monoid.MakeMonoid(
+			func(a, b string) string { return a + "," + b },
+			"",
+		)
+
+		applicativeMonoid := ApplicativeMonoid[TestContext, string](stringMonoid)
+		alternativeMonoid := AlternativeMonoid[TestContext, string](stringMonoid)
+
+		eff1 := Of[TestContext, string]("A")
+		eff2 := Of[TestContext, string]("B")
+
+		// Applicative combines values
+		applicativeResult, err1 := runEffect(
+			applicativeMonoid.Concat(eff1, eff2),
+			TestContext{Value: "test"},
+		)
+
+		// Alternative takes first
+		alternativeResult, err2 := runEffect(
+			alternativeMonoid.Concat(eff1, eff2),
+			TestContext{Value: "test"},
+		)
+
+		assert.NoError(t, err1)
+		assert.NoError(t, err2)
+		assert.Equal(t, "A,B", applicativeResult) // Combined with comma separator
+		assert.Equal(t, "A,B", alternativeResult) // Also combined (Alternative uses Alt semigroup)
+	})
+
+	t.Run("ApplicativeMonoid vs AlternativeMonoid with failures", func(t *testing.T) {
+		intMonoid := monoid.MakeMonoid(
+			func(a, b int) int { return a + b },
+			0,
+		)
+
+		applicativeMonoid := ApplicativeMonoid[TestContext, int](intMonoid)
+		alternativeMonoid := AlternativeMonoid[TestContext, int](intMonoid)
+
+		eff1 := Fail[TestContext, int](errors.New("error 1"))
+		eff2 := Of[TestContext, int](42)
+
+		// Applicative fails on first error
+		_, err1 := runEffect(
+			applicativeMonoid.Concat(eff1, eff2),
+			TestContext{Value: "test"},
+		)
+
+		// Alternative tries second on first failure
+		result2, err2 := runEffect(
+			alternativeMonoid.Concat(eff1, eff2),
+			TestContext{Value: "test"},
+		)
+
+		assert.Error(t, err1)
+		assert.NoError(t, err2)
+		assert.Equal(t, 42, result2)
+	})
+}

v2/effect/retry.go

@@ -0,0 +1,14 @@
+package effect
+
+import (
+	"github.com/IBM/fp-go/v2/context/readerreaderioresult"
+	"github.com/IBM/fp-go/v2/retry"
+)
+
+func Retrying[C, A any](
+	policy retry.RetryPolicy,
+	action Kleisli[C, retry.RetryStatus, A],
+	check Predicate[Result[A]],
+) Effect[C, A] {
+	return readerreaderioresult.Retrying(policy, action, check)
+}

v2/effect/retry_test.go

@@ -0,0 +1,377 @@
+// Copyright (c) 2023 - 2025 IBM Corp.
+// All rights reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package effect
+
+import (
+	"errors"
+	"testing"
+	"time"
+
+	"github.com/IBM/fp-go/v2/result"
+	"github.com/IBM/fp-go/v2/retry"
+	"github.com/stretchr/testify/assert"
+)
+
+func TestRetrying(t *testing.T) {
+	t.Run("succeeds on first attempt", func(t *testing.T) {
+		attemptCount := 0
+		policy := retry.LimitRetries(3)
+
+		eff := Retrying[TestContext, string](
+			policy,
+			func(status retry.RetryStatus) Effect[TestContext, string] {
+				attemptCount++
+				return Of[TestContext, string]("success")
+			},
+			func(res Result[string]) bool {
+				return result.IsLeft(res) // retry on error
+			},
+		)
+
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, "success", result)
+		assert.Equal(t, 1, attemptCount)
+	})
+
+	t.Run("retries on failure and eventually succeeds", func(t *testing.T) {
+		attemptCount := 0
+		policy := retry.LimitRetries(5)
+
+		eff := Retrying[TestContext, string](
+			policy,
+			func(status retry.RetryStatus) Effect[TestContext, string] {
+				attemptCount++
+				if attemptCount < 3 {
+					return Fail[TestContext, string](errors.New("temporary error"))
+				}
+				return Of[TestContext, string]("success after retries")
+			},
+			func(res Result[string]) bool {
+				return result.IsLeft(res) // retry on error
+			},
+		)
+
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, "success after retries", result)
+		assert.Equal(t, 3, attemptCount)
+	})
+
+	t.Run("exhausts retry limit", func(t *testing.T) {
+		attemptCount := 0
+		maxRetries := uint(3)
+		policy := retry.LimitRetries(maxRetries)
+
+		eff := Retrying[TestContext, string](
+			policy,
+			func(status retry.RetryStatus) Effect[TestContext, string] {
+				attemptCount++
+				return Fail[TestContext, string](errors.New("persistent error"))
+			},
+			func(res Result[string]) bool {
+				return result.IsLeft(res) // retry on error
+			},
+		)
+
+		_, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.Error(t, err)
+		assert.Equal(t, int(maxRetries+1), attemptCount) // initial attempt + retries
+	})
+
+	t.Run("does not retry on success", func(t *testing.T) {
+		attemptCount := 0
+		policy := retry.LimitRetries(5)
+
+		eff := Retrying[TestContext, int](
+			policy,
+			func(status retry.RetryStatus) Effect[TestContext, int] {
+				attemptCount++
+				return Of[TestContext, int](42)
+			},
+			func(res Result[int]) bool {
+				return result.IsLeft(res) // retry on error
+			},
+		)
+
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, 42, result)
+		assert.Equal(t, 1, attemptCount)
+	})
+
+	t.Run("uses custom retry predicate", func(t *testing.T) {
+		attemptCount := 0
+		policy := retry.LimitRetries(5)
+
+		eff := Retrying[TestContext, int](
+			policy,
+			func(status retry.RetryStatus) Effect[TestContext, int] {
+				attemptCount++
+				return Of[TestContext, int](attemptCount * 10)
+			},
+			func(res Result[int]) bool {
+				// Retry if value is less than 30
+				if result.IsRight(res) {
+					val, _ := result.Unwrap(res)
+					return val < 30
+				}
+				return true
+			},
+		)
+
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, 30, result)
+		assert.Equal(t, 3, attemptCount)
+	})
+
+	t.Run("tracks retry status", func(t *testing.T) {
+		var statuses []retry.RetryStatus
+		policy := retry.LimitRetries(3)
+
+		eff := Retrying[TestContext, string](
+			policy,
+			func(status retry.RetryStatus) Effect[TestContext, string] {
+				statuses = append(statuses, status)
+				if len(statuses) < 3 {
+					return Fail[TestContext, string](errors.New("retry"))
+				}
+				return Of[TestContext, string]("done")
+			},
+			func(res Result[string]) bool {
+				return result.IsLeft(res)
+			},
+		)
+
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, "done", result)
+		assert.Len(t, statuses, 3)
+		// First attempt has iteration 0
+		assert.Equal(t, uint(0), statuses[0].IterNumber)
+		assert.Equal(t, uint(1), statuses[1].IterNumber)
+		assert.Equal(t, uint(2), statuses[2].IterNumber)
+	})
+
+	t.Run("works with exponential backoff", func(t *testing.T) {
+		attemptCount := 0
+		policy := retry.Monoid.Concat(
+			retry.LimitRetries(3),
+			retry.ExponentialBackoff(10*time.Millisecond),
+		)
+
+		startTime := time.Now()
+		eff := Retrying[TestContext, string](
+			policy,
+			func(status retry.RetryStatus) Effect[TestContext, string] {
+				attemptCount++
+				if attemptCount < 3 {
+					return Fail[TestContext, string](errors.New("retry"))
+				}
+				return Of[TestContext, string]("success")
+			},
+			func(res Result[string]) bool {
+				return result.IsLeft(res)
+			},
+		)
+
+		result, err := runEffect(eff, TestContext{Value: "test"})
+		elapsed := time.Since(startTime)
+
+		assert.NoError(t, err)
+		assert.Equal(t, "success", result)
+		assert.Equal(t, 3, attemptCount)
+		// Should have some delay due to backoff
+		assert.Greater(t, elapsed, 10*time.Millisecond)
+	})
+
+	t.Run("combines with other effect operations", func(t *testing.T) {
+		attemptCount := 0
+		policy := retry.LimitRetries(3)
+
+		eff := Map[TestContext](func(s string) string {
+			return "mapped: " + s
+		})(Retrying[TestContext, string](
+			policy,
+			func(status retry.RetryStatus) Effect[TestContext, string] {
+				attemptCount++
+				if attemptCount < 2 {
+					return Fail[TestContext, string](errors.New("retry"))
+				}
+				return Of[TestContext, string]("success")
+			},
+			func(res Result[string]) bool {
+				return result.IsLeft(res)
+			},
+		))
+
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, "mapped: success", result)
+		assert.Equal(t, 2, attemptCount)
+	})
+
+	t.Run("retries with different error types", func(t *testing.T) {
+		attemptCount := 0
+		policy := retry.LimitRetries(5)
+		errors := []error{
+			errors.New("error 1"),
+			errors.New("error 2"),
+			errors.New("error 3"),
+		}
+
+		eff := Retrying[TestContext, string](
+			policy,
+			func(status retry.RetryStatus) Effect[TestContext, string] {
+				if attemptCount < len(errors) {
+					err := errors[attemptCount]
+					attemptCount++
+					return Fail[TestContext, string](err)
+				}
+				attemptCount++
+				return Of[TestContext, string]("finally succeeded")
+			},
+			func(res Result[string]) bool {
+				return result.IsLeft(res)
+			},
+		)
+
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, "finally succeeded", result)
+		assert.Equal(t, 4, attemptCount)
+	})
+
+	t.Run("no retry when predicate returns false", func(t *testing.T) {
+		attemptCount := 0
+		policy := retry.LimitRetries(5)
+
+		eff := Retrying[TestContext, string](
+			policy,
+			func(status retry.RetryStatus) Effect[TestContext, string] {
+				attemptCount++
+				return Fail[TestContext, string](errors.New("error"))
+			},
+			func(res Result[string]) bool {
+				return false // never retry
+			},
+		)
+
+		_, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.Error(t, err)
+		assert.Equal(t, 1, attemptCount) // only initial attempt
+	})
+
+	t.Run("retries with context access", func(t *testing.T) {
+		attemptCount := 0
+		policy := retry.LimitRetries(3)
+		ctx := TestContext{Value: "retry-context"}
+
+		eff := Retrying[TestContext, string](
+			policy,
+			func(status retry.RetryStatus) Effect[TestContext, string] {
+				attemptCount++
+				if attemptCount < 2 {
+					return Fail[TestContext, string](errors.New("retry"))
+				}
+				return Of[TestContext, string]("success with context")
+			},
+			func(res Result[string]) bool {
+				return result.IsLeft(res)
+			},
+		)
+
+		result, err := runEffect(eff, ctx)
+
+		assert.NoError(t, err)
+		assert.Equal(t, "success with context", result)
+		assert.Equal(t, 2, attemptCount)
+	})
+}
+
+func TestRetryingWithComplexScenarios(t *testing.T) {
+	t.Run("retry with state accumulation", func(t *testing.T) {
+		type State struct {
+			Attempts []int
+			Value    string
+		}
+
+		policy := retry.LimitRetries(4)
+
+		eff := Retrying[TestContext, State](
+			policy,
+			func(status retry.RetryStatus) Effect[TestContext, State] {
+				state := State{
+					Attempts: make([]int, status.IterNumber+1),
+					Value:    "attempt",
+				}
+				for i := uint(0); i <= status.IterNumber; i++ {
+					state.Attempts[i] = int(i)
+				}
+
+				if status.IterNumber < 2 {
+					return Fail[TestContext, State](errors.New("retry"))
+				}
+				return Of[TestContext, State](state)
+			},
+			func(res Result[State]) bool {
+				return result.IsLeft(res)
+			},
+		)
+
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, "attempt", result.Value)
+		assert.Equal(t, []int{0, 1, 2}, result.Attempts)
+	})
+
+	t.Run("retry with chain operations", func(t *testing.T) {
+		attemptCount := 0
+		policy := retry.LimitRetries(3)
+
+		eff := Chain[TestContext](func(x int) Effect[TestContext, string] {
+			return Of[TestContext, string]("final: " + string(rune('0'+x)))
+		})(Retrying[TestContext, int](
+			policy,
+			func(status retry.RetryStatus) Effect[TestContext, int] {
+				attemptCount++
+				if attemptCount < 2 {
+					return Fail[TestContext, int](errors.New("retry"))
+				}
+				return Of[TestContext, int](attemptCount)
+			},
+			func(res Result[int]) bool {
+				return result.IsLeft(res)
+			},
+		))
+
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Contains(t, result, "final:")
+	})
+}

v2/effect/run.go

@@ -0,0 +1,19 @@
+package effect
+
+import (
+	"context"
+
+	"github.com/IBM/fp-go/v2/context/readerreaderioresult"
+	"github.com/IBM/fp-go/v2/idiomatic/context/readerresult"
+	"github.com/IBM/fp-go/v2/result"
+)
+
+func Provide[C, A any](c C) func(Effect[C, A]) ReaderIOResult[A] {
+	return readerreaderioresult.Read[A](c)
+}
+
+func RunSync[A any](fa ReaderIOResult[A]) readerresult.ReaderResult[A] {
+	return func(ctx context.Context) (A, error) {
+		return result.Unwrap(fa(ctx)())
+	}
+}

v2/effect/run_test.go

@@ -0,0 +1,326 @@
+// Copyright (c) 2023 - 2025 IBM Corp.
+// All rights reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package effect
+
+import (
+	"context"
+	"errors"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+)
+
+func TestProvide(t *testing.T) {
+	t.Run("provides context to effect", func(t *testing.T) {
+		ctx := TestContext{Value: "test-value"}
+		eff := Of[TestContext, string]("result")
+
+		ioResult := Provide[TestContext, string](ctx)(eff)
+		readerResult := RunSync[string](ioResult)
+		result, err := readerResult(context.Background())
+
+		assert.NoError(t, err)
+		assert.Equal(t, "result", result)
+	})
+
+	t.Run("provides context with specific values", func(t *testing.T) {
+		type Config struct {
+			Host string
+			Port int
+		}
+
+		cfg := Config{Host: "localhost", Port: 8080}
+		eff := Of[Config, string]("connected")
+
+		ioResult := Provide[Config, string](cfg)(eff)
+		readerResult := RunSync[string](ioResult)
+		result, err := readerResult(context.Background())
+
+		assert.NoError(t, err)
+		assert.Equal(t, "connected", result)
+	})
+
+	t.Run("propagates errors", func(t *testing.T) {
+		expectedErr := errors.New("provide error")
+		ctx := TestContext{Value: "test"}
+		eff := Fail[TestContext, string](expectedErr)
+
+		ioResult := Provide[TestContext, string](ctx)(eff)
+		readerResult := RunSync[string](ioResult)
+		_, err := readerResult(context.Background())
+
+		assert.Error(t, err)
+		assert.Equal(t, expectedErr, err)
+	})
+
+	t.Run("works with different context types", func(t *testing.T) {
+		type SimpleContext struct {
+			ID int
+		}
+
+		ctx := SimpleContext{ID: 42}
+		eff := Of[SimpleContext, int](100)
+
+		ioResult := Provide[SimpleContext, int](ctx)(eff)
+		readerResult := RunSync[int](ioResult)
+		result, err := readerResult(context.Background())
+
+		assert.NoError(t, err)
+		assert.Equal(t, 100, result)
+	})
+
+	t.Run("provides context to chained effects", func(t *testing.T) {
+		ctx := TestContext{Value: "base"}
+
+		eff := Chain[TestContext](func(x int) Effect[TestContext, string] {
+			return Of[TestContext, string]("result")
+		})(Of[TestContext, int](42))
+
+		ioResult := Provide[TestContext, string](ctx)(eff)
+		readerResult := RunSync[string](ioResult)
+		result, err := readerResult(context.Background())
+
+		assert.NoError(t, err)
+		assert.Equal(t, "result", result)
+	})
+
+	t.Run("provides context to mapped effects", func(t *testing.T) {
+		ctx := TestContext{Value: "test"}
+
+		eff := Map[TestContext](func(x int) string {
+			return "mapped"
+		})(Of[TestContext, int](42))
+
+		ioResult := Provide[TestContext, string](ctx)(eff)
+		readerResult := RunSync[string](ioResult)
+		result, err := readerResult(context.Background())
+
+		assert.NoError(t, err)
+		assert.Equal(t, "mapped", result)
+	})
+}
+
+func TestRunSync(t *testing.T) {
+	t.Run("runs effect synchronously", func(t *testing.T) {
+		ctx := TestContext{Value: "test"}
+		eff := Of[TestContext, int](42)
+
+		ioResult := Provide[TestContext, int](ctx)(eff)
+		readerResult := RunSync[int](ioResult)
+		result, err := readerResult(context.Background())
+
+		assert.NoError(t, err)
+		assert.Equal(t, 42, result)
+	})
+
+	t.Run("runs effect with context.Context", func(t *testing.T) {
+		ctx := TestContext{Value: "test"}
+		eff := Of[TestContext, string]("hello")
+
+		ioResult := Provide[TestContext, string](ctx)(eff)
+		readerResult := RunSync[string](ioResult)
+
+		bgCtx := context.Background()
+		result, err := readerResult(bgCtx)
+
+		assert.NoError(t, err)
+		assert.Equal(t, "hello", result)
+	})
+
+	t.Run("propagates errors synchronously", func(t *testing.T) {
+		expectedErr := errors.New("sync error")
+		ctx := TestContext{Value: "test"}
+		eff := Fail[TestContext, int](expectedErr)
+
+		ioResult := Provide[TestContext, int](ctx)(eff)
+		readerResult := RunSync[int](ioResult)
+		_, err := readerResult(context.Background())
+
+		assert.Error(t, err)
+		assert.Equal(t, expectedErr, err)
+	})
+
+	t.Run("runs complex effect chains", func(t *testing.T) {
+		ctx := TestContext{Value: "test"}
+
+		eff := Chain[TestContext](func(x int) Effect[TestContext, int] {
+			return Of[TestContext, int](x * 2)
+		})(Chain[TestContext](func(x int) Effect[TestContext, int] {
+			return Of[TestContext, int](x + 10)
+		})(Of[TestContext, int](5)))
+
+		ioResult := Provide[TestContext, int](ctx)(eff)
+		readerResult := RunSync[int](ioResult)
+		result, err := readerResult(context.Background())
+
+		assert.NoError(t, err)
+		assert.Equal(t, 30, result) // (5 + 10) * 2
+	})
+
+	t.Run("handles multiple sequential runs", func(t *testing.T) {
+		ctx := TestContext{Value: "test"}
+		eff := Of[TestContext, int](42)
+
+		ioResult := Provide[TestContext, int](ctx)(eff)
+		readerResult := RunSync[int](ioResult)
+
+		// Run multiple times
+		result1, err1 := readerResult(context.Background())
+		result2, err2 := readerResult(context.Background())
+		result3, err3 := readerResult(context.Background())
+
+		assert.NoError(t, err1)
+		assert.NoError(t, err2)
+		assert.NoError(t, err3)
+		assert.Equal(t, 42, result1)
+		assert.Equal(t, 42, result2)
+		assert.Equal(t, 42, result3)
+	})
+
+	t.Run("works with different result types", func(t *testing.T) {
+		type User struct {
+			Name string
+			Age  int
+		}
+
+		ctx := TestContext{Value: "test"}
+		user := User{Name: "Alice", Age: 30}
+		eff := Of[TestContext, User](user)
+
+		ioResult := Provide[TestContext, User](ctx)(eff)
+		readerResult := RunSync[User](ioResult)
+		result, err := readerResult(context.Background())
+
+		assert.NoError(t, err)
+		assert.Equal(t, user, result)
+	})
+}
+
+func TestProvideAndRunSyncIntegration(t *testing.T) {
+	t.Run("complete workflow with success", func(t *testing.T) {
+		type AppConfig struct {
+			APIKey  string
+			Timeout int
+		}
+
+		cfg := AppConfig{APIKey: "secret", Timeout: 30}
+
+		// Create an effect that uses the config
+		eff := Of[AppConfig, string]("API call successful")
+
+		// Provide config and run
+		result, err := RunSync[string](Provide[AppConfig, string](cfg)(eff))(context.Background())
+
+		assert.NoError(t, err)
+		assert.Equal(t, "API call successful", result)
+	})
+
+	t.Run("complete workflow with error", func(t *testing.T) {
+		type AppConfig struct {
+			APIKey string
+		}
+
+		expectedErr := errors.New("API error")
+		cfg := AppConfig{APIKey: "secret"}
+
+		eff := Fail[AppConfig, string](expectedErr)
+
+		_, err := RunSync[string](Provide[AppConfig, string](cfg)(eff))(context.Background())
+
+		assert.Error(t, err)
+		assert.Equal(t, expectedErr, err)
+	})
+
+	t.Run("workflow with transformations", func(t *testing.T) {
+		ctx := TestContext{Value: "test"}
+
+		eff := Map[TestContext](func(x int) string {
+			return "final"
+		})(Chain[TestContext](func(x int) Effect[TestContext, int] {
+			return Of[TestContext, int](x * 2)
+		})(Of[TestContext, int](21)))
+
+		result, err := RunSync[string](Provide[TestContext, string](ctx)(eff))(context.Background())
+
+		assert.NoError(t, err)
+		assert.Equal(t, "final", result)
+	})
+
+	t.Run("workflow with bind operations", func(t *testing.T) {
+		type State struct {
+			X int
+			Y int
+		}
+
+		ctx := TestContext{Value: "test"}
+
+		eff := Bind[TestContext](
+			func(y int) func(State) State {
+				return func(s State) State {
+					s.Y = y
+					return s
+				}
+			},
+			func(s State) Effect[TestContext, int] {
+				return Of[TestContext, int](s.X * 2)
+			},
+		)(BindTo[TestContext](func(x int) State {
+			return State{X: x}
+		})(Of[TestContext, int](10)))
+
+		result, err := RunSync[State](Provide[TestContext, State](ctx)(eff))(context.Background())
+
+		assert.NoError(t, err)
+		assert.Equal(t, 10, result.X)
+		assert.Equal(t, 20, result.Y)
+	})
+
+	t.Run("workflow with context transformation", func(t *testing.T) {
+		type OuterCtx struct {
+			Value string
+		}
+		type InnerCtx struct {
+			Data string
+		}
+
+		outerCtx := OuterCtx{Value: "outer"}
+		innerEff := Of[InnerCtx, string]("inner result")
+
+		// Transform context
+		transformedEff := Local[OuterCtx, InnerCtx, string](func(outer OuterCtx) InnerCtx {
+			return InnerCtx{Data: outer.Value + "-transformed"}
+		})(innerEff)
+
+		result, err := RunSync[string](Provide[OuterCtx, string](outerCtx)(transformedEff))(context.Background())
+
+		assert.NoError(t, err)
+		assert.Equal(t, "inner result", result)
+	})
+
+	t.Run("workflow with array traversal", func(t *testing.T) {
+		ctx := TestContext{Value: "test"}
+		input := []int{1, 2, 3, 4, 5}
+
+		eff := TraverseArray[TestContext](func(x int) Effect[TestContext, int] {
+			return Of[TestContext, int](x * 2)
+		})(input)
+
+		result, err := RunSync[[]int](Provide[TestContext, []int](ctx)(eff))(context.Background())
+
+		assert.NoError(t, err)
+		assert.Equal(t, []int{2, 4, 6, 8, 10}, result)
+	})
+}

v2/effect/traverse.go

@@ -0,0 +1,7 @@
+package effect
+
+import "github.com/IBM/fp-go/v2/context/readerreaderioresult"
+
+func TraverseArray[C, A, B any](f Kleisli[C, A, B]) Kleisli[C, []A, []B] {
+	return readerreaderioresult.TraverseArray(f)
+}

v2/effect/traverse_test.go

@@ -0,0 +1,266 @@
+// Copyright (c) 2023 - 2025 IBM Corp.
+// All rights reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package effect
+
+import (
+	"errors"
+	"fmt"
+	"strconv"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+)
+
+func TestTraverseArray(t *testing.T) {
+	t.Run("traverses empty array", func(t *testing.T) {
+		input := []int{}
+		kleisli := TraverseArray[TestContext](func(x int) Effect[TestContext, string] {
+			return Of[TestContext, string](strconv.Itoa(x))
+		})
+
+		result, err := runEffect(kleisli(input), TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Empty(t, result)
+	})
+
+	t.Run("traverses array with single element", func(t *testing.T) {
+		input := []int{42}
+		kleisli := TraverseArray[TestContext](func(x int) Effect[TestContext, string] {
+			return Of[TestContext, string](strconv.Itoa(x))
+		})
+
+		result, err := runEffect(kleisli(input), TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, []string{"42"}, result)
+	})
+
+	t.Run("traverses array with multiple elements", func(t *testing.T) {
+		input := []int{1, 2, 3, 4, 5}
+		kleisli := TraverseArray[TestContext](func(x int) Effect[TestContext, string] {
+			return Of[TestContext, string](strconv.Itoa(x))
+		})
+
+		result, err := runEffect(kleisli(input), TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, []string{"1", "2", "3", "4", "5"}, result)
+	})
+
+	t.Run("transforms to different type", func(t *testing.T) {
+		input := []string{"hello", "world", "test"}
+		kleisli := TraverseArray[TestContext](func(s string) Effect[TestContext, int] {
+			return Of[TestContext, int](len(s))
+		})
+
+		result, err := runEffect(kleisli(input), TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, []int{5, 5, 4}, result)
+	})
+
+	t.Run("stops on first error", func(t *testing.T) {
+		expectedErr := errors.New("traverse error")
+		input := []int{1, 2, 3, 4, 5}
+		kleisli := TraverseArray[TestContext](func(x int) Effect[TestContext, string] {
+			if x == 3 {
+				return Fail[TestContext, string](expectedErr)
+			}
+			return Of[TestContext, string](strconv.Itoa(x))
+		})
+
+		_, err := runEffect(kleisli(input), TestContext{Value: "test"})
+
+		assert.Error(t, err)
+		assert.Equal(t, expectedErr, err)
+	})
+
+	t.Run("handles complex transformations", func(t *testing.T) {
+		type User struct {
+			ID   int
+			Name string
+		}
+
+		input := []int{1, 2, 3}
+		kleisli := TraverseArray[TestContext](func(id int) Effect[TestContext, User] {
+			return Of[TestContext, User](User{
+				ID:   id,
+				Name: fmt.Sprintf("User%d", id),
+			})
+		})
+
+		result, err := runEffect(kleisli(input), TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Len(t, result, 3)
+		assert.Equal(t, 1, result[0].ID)
+		assert.Equal(t, "User1", result[0].Name)
+		assert.Equal(t, 2, result[1].ID)
+		assert.Equal(t, "User2", result[1].Name)
+		assert.Equal(t, 3, result[2].ID)
+		assert.Equal(t, "User3", result[2].Name)
+	})
+
+	t.Run("chains with other operations", func(t *testing.T) {
+		input := []int{1, 2, 3}
+
+		eff := Chain[TestContext](func(strings []string) Effect[TestContext, int] {
+			total := 0
+			for _, s := range strings {
+				val, _ := strconv.Atoi(s)
+				total += val
+			}
+			return Of[TestContext, int](total)
+		})(TraverseArray[TestContext](func(x int) Effect[TestContext, string] {
+			return Of[TestContext, string](strconv.Itoa(x * 2))
+		})(input))
+
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, 12, result) // (1*2) + (2*2) + (3*2) = 2 + 4 + 6 = 12
+	})
+
+	t.Run("uses context in transformation", func(t *testing.T) {
+		input := []int{1, 2, 3}
+		kleisli := TraverseArray[TestContext](func(x int) Effect[TestContext, string] {
+			return Chain[TestContext](func(ctx TestContext) Effect[TestContext, string] {
+				return Of[TestContext, string](fmt.Sprintf("%s-%d", ctx.Value, x))
+			})(Of[TestContext, TestContext](TestContext{Value: "prefix"}))
+		})
+
+		result, err := runEffect(kleisli(input), TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, []string{"prefix-1", "prefix-2", "prefix-3"}, result)
+	})
+
+	t.Run("preserves order", func(t *testing.T) {
+		input := []int{5, 3, 8, 1, 9, 2}
+		kleisli := TraverseArray[TestContext](func(x int) Effect[TestContext, int] {
+			return Of[TestContext, int](x * 10)
+		})
+
+		result, err := runEffect(kleisli(input), TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, []int{50, 30, 80, 10, 90, 20}, result)
+	})
+
+	t.Run("handles large arrays", func(t *testing.T) {
+		size := 1000
+		input := make([]int, size)
+		for i := 0; i < size; i++ {
+			input[i] = i
+		}
+
+		kleisli := TraverseArray[TestContext](func(x int) Effect[TestContext, int] {
+			return Of[TestContext, int](x * 2)
+		})
+
+		result, err := runEffect(kleisli(input), TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Len(t, result, size)
+		assert.Equal(t, 0, result[0])
+		assert.Equal(t, 1998, result[999])
+	})
+
+	t.Run("composes multiple traversals", func(t *testing.T) {
+		input := []int{1, 2, 3}
+
+		// First traversal: int -> string
+		kleisli1 := TraverseArray[TestContext](func(x int) Effect[TestContext, string] {
+			return Of[TestContext, string](strconv.Itoa(x))
+		})
+
+		// Second traversal: string -> int (length)
+		kleisli2 := TraverseArray[TestContext](func(s string) Effect[TestContext, int] {
+			return Of[TestContext, int](len(s))
+		})
+
+		eff := Chain[TestContext](kleisli2)(kleisli1(input))
+
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, []int{1, 1, 1}, result) // All single-digit numbers have length 1
+	})
+
+	t.Run("handles nil array", func(t *testing.T) {
+		var input []int
+		kleisli := TraverseArray[TestContext](func(x int) Effect[TestContext, string] {
+			return Of[TestContext, string](strconv.Itoa(x))
+		})
+
+		result, err := runEffect(kleisli(input), TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Empty(t, result) // TraverseArray returns empty slice for nil input
+	})
+
+	t.Run("works with Map for post-processing", func(t *testing.T) {
+		input := []int{1, 2, 3}
+
+		eff := Map[TestContext](func(strings []string) string {
+			result := ""
+			for _, s := range strings {
+				result += s + ","
+			}
+			return result
+		})(TraverseArray[TestContext](func(x int) Effect[TestContext, string] {
+			return Of[TestContext, string](strconv.Itoa(x))
+		})(input))
+
+		result, err := runEffect(eff, TestContext{Value: "test"})
+
+		assert.NoError(t, err)
+		assert.Equal(t, "1,2,3,", result)
+	})
+
+	t.Run("error in middle of array", func(t *testing.T) {
+		expectedErr := errors.New("middle error")
+		input := []int{1, 2, 3, 4, 5, 6, 7, 8, 9, 10}
+		kleisli := TraverseArray[TestContext](func(x int) Effect[TestContext, string] {
+			if x == 5 {
+				return Fail[TestContext, string](expectedErr)
+			}
+			return Of[TestContext, string](strconv.Itoa(x))
+		})
+
+		_, err := runEffect(kleisli(input), TestContext{Value: "test"})
+
+		assert.Error(t, err)
+		assert.Equal(t, expectedErr, err)
+	})
+
+	t.Run("error at end of array", func(t *testing.T) {
+		expectedErr := errors.New("end error")
+		input := []int{1, 2, 3, 4, 5}
+		kleisli := TraverseArray[TestContext](func(x int) Effect[TestContext, string] {
+			if x == 5 {
+				return Fail[TestContext, string](expectedErr)
+			}
+			return Of[TestContext, string](strconv.Itoa(x))
+		})
+
+		_, err := runEffect(kleisli(input), TestContext{Value: "test"})
+
+		assert.Error(t, err)
+		assert.Equal(t, expectedErr, err)
+	})
+}

v2/effect/types.go

@@ -0,0 +1,37 @@
+package effect
+
+import (
+	"github.com/IBM/fp-go/v2/context/readerioresult"
+	"github.com/IBM/fp-go/v2/context/readerreaderioresult"
+	"github.com/IBM/fp-go/v2/either"
+	"github.com/IBM/fp-go/v2/io"
+	"github.com/IBM/fp-go/v2/ioeither"
+	"github.com/IBM/fp-go/v2/ioresult"
+	"github.com/IBM/fp-go/v2/lazy"
+	"github.com/IBM/fp-go/v2/monoid"
+	"github.com/IBM/fp-go/v2/optics/lens"
+	"github.com/IBM/fp-go/v2/predicate"
+	"github.com/IBM/fp-go/v2/reader"
+	"github.com/IBM/fp-go/v2/readerio"
+	"github.com/IBM/fp-go/v2/result"
+)
+
+type (
+	Either[E, A any]      = either.Either[E, A]
+	Reader[R, A any]      = reader.Reader[R, A]
+	ReaderIO[R, A any]    = readerio.ReaderIO[R, A]
+	IO[A any]             = io.IO[A]
+	IOEither[E, A any]    = ioeither.IOEither[E, A]
+	Lazy[A any]           = lazy.Lazy[A]
+	IOResult[A any]       = ioresult.IOResult[A]
+	ReaderIOResult[A any] = readerioresult.ReaderIOResult[A]
+	Monoid[A any]         = monoid.Monoid[A]
+	Effect[C, A any]      = readerreaderioresult.ReaderReaderIOResult[C, A]
+	Thunk[A any]          = ReaderIOResult[A]
+	Predicate[A any]      = predicate.Predicate[A]
+	Result[A any]         = result.Result[A]
+	Lens[S, T any]        = lens.Lens[S, T]
+
+	Kleisli[C, A, B any]  = readerreaderioresult.Kleisli[C, A, B]
+	Operator[C, A, B any] = readerreaderioresult.Operator[C, A, B]
+)

v2/either/either.go

@@ -504,7 +504,7 @@ func ToType[A, E any](onError func(any) E) func(any) Either[E, A] {
 	return func(value any) Either[E, A] {
 		return F.Pipe2(
 			value,
-			O.ToType[A],
+			O.InstanceOf[A],
 			O.Fold(F.Nullary3(F.Constant(value), onError, Left[A, E]), Right[E, A]),
 		)
 	}

v2/function/cache_test.go

@@ -169,7 +169,7 @@ func TestContramapMemoize(t *testing.T) {
 		}
 
 		// Cache by ID only
-		cacheByID := ContramapMemoize[string, User, int](func(u User) int {
+		cacheByID := ContramapMemoize[string](func(u User) int {
 			return u.ID
 		})
 
@@ -206,7 +206,7 @@ func TestContramapMemoize(t *testing.T) {
 			return p.Price * 1.1 // Add 10% markup
 		}
 
-		cacheBySKU := ContramapMemoize[float64, Product, string](func(p Product) string {
+		cacheBySKU := ContramapMemoize[float64](func(p Product) string {
 			return p.SKU
 		})
 
@@ -238,7 +238,7 @@ func TestContramapMemoize(t *testing.T) {
 		}
 
 		// Cache by method and path, ignore body
-		cacheByMethodPath := ContramapMemoize[string, Request, string](func(r Request) string {
+		cacheByMethodPath := ContramapMemoize[string](func(r Request) string {
 			return r.Method + ":" + r.Path
 		})
 
@@ -300,7 +300,7 @@ func TestCacheCallback(t *testing.T) {
 			return fmt.Sprintf("Result: %d", n)
 		}
 
-		memoizer := CacheCallback[string, int, int](
+		memoizer := CacheCallback(
 			Identity[int],
 			boundedCache(),
 		)
@@ -372,7 +372,7 @@ func TestCacheCallback(t *testing.T) {
 			return fmt.Sprintf("Processed: %s", item.Value)
 		}
 
-		memoizer := CacheCallback[string, Item, int](
+		memoizer := CacheCallback(
 			func(item Item) int { return item.ID },
 			simpleCache(),
 		)
@@ -445,7 +445,7 @@ func TestSingleElementCache(t *testing.T) {
 			return fmt.Sprintf("Result: %d", n*n)
 		}
 
-		memoizer := CacheCallback[string, int, int](
+		memoizer := CacheCallback(
 			Identity[int],
 			cache,
 		)
@@ -591,7 +591,7 @@ func TestMemoizeIntegration(t *testing.T) {
 		}
 
 		// First level: cache by UserID
-		cacheByUser := ContramapMemoize[string, Request, int](func(r Request) int {
+		cacheByUser := ContramapMemoize[string](func(r Request) int {
 			return r.UserID
 		})