Deprecate yielder.prepend

src/gleam/yielder.gleam

@@ -1641,7 +1641,24 @@ pub fn yield(element: a, next: fn() -> Yielder(a)) -> Yielder(a) {
 /// // -> [0, 1, 2, 3]
 /// ```
 ///
+@deprecated("Use `yielder.push_front` instead.")
 pub fn prepend(yielder: Yielder(a), element: a) -> Yielder(a) {
   use <- yield(element)
   yielder
 }
+
+/// Add a new element to the start of a yielder.
+///
+/// ## Examples
+///
+/// ```gleam
+/// let yielder = from_list([1, 2, 3]) |> prepend(0)
+///
+/// yielder.to_list
+/// // -> [0, 1, 2, 3]
+/// ```
+///
+pub fn push_front(yielder: Yielder(a), element: a) -> Yielder(a) {
+  use <- yield(element)
+  yielder
+}

test/gleam_yielder_test.gleam

@@ -742,3 +742,10 @@ pub fn prepend_test() {
   |> yielder.to_list
   |> should.equal([0, 1, 2, 3])
 }
+
+pub fn prepend_element_test() {
+  yielder.from_list([1, 2, 3])
+  |> yielder.push_front(0)
+  |> yielder.to_list
+  |> should.equal([0, 1, 2, 3])
+}