Support Map in itx to allow limited chaining

Author: BooleanCat

it/itx/map.go

@@ -2,6 +2,12 @@ package itx
 
 import "github.com/BooleanCat/go-functional/v2/it"
 
+// Map is a convenience method [it.Map] returning an [Iterator] to support
+// chaining.
+func Map[V any, W any](iterator func(func(V) bool), f func(V) W) Iterator[W] {
+	return Iterator[W](it.Map(iterator, f))
+}
+
 // Transform is a convenience method for chaining [it.Map] on [Iterator]s where
 // the provided functions argument type is the same as its return type.
 //

it/itx/map_test.go

@@ -3,10 +3,18 @@ package itx_test
 import (
 	"fmt"
 	"maps"
+	"slices"
 
 	"github.com/BooleanCat/go-functional/v2/it/itx"
 )
 
+func ExampleMap() {
+	fmt.Println(itx.Map(slices.Values([]int{0, 1, 2}), func(v int) int {
+		return v + 1
+	}).Collect())
+	// Output: [1 2 3]
+}
+
 func ExampleIterator_Transform() {
 	fmt.Println(itx.FromSlice([]int{0, 1, 2}).Transform(func(v int) int {
 		return v + 1