effect 4.0.0-rc.109 → 4.0.0-rc.110

package/ai-docs/src/70_cli/10_basics.ts

@@ -23,7 +23,8 @@ const tasks = Command.make("tasks").pipe(
     workspace,
     verbose: Flag.boolean("verbose").pipe(
       Flag.withAlias("v"),
-      Flag.withDescription("Print diagnostic output")
+      Flag.withDescription("Print diagnostic output"),
+      Flag.withDefault(false)
     )
   }),
   Command.withDescription("Track and manage tasks")
@@ -92,7 +93,8 @@ const list = Command.make(
       Flag.withDefault("open")
     ),
     json: Flag.boolean("json").pipe(
-      Flag.withDescription("Print machine-readable output")
+      Flag.withDescription("Print machine-readable output"),
+      Flag.withDefault(false)
     )
   },
   Effect.fn(function*({ status, json }) {

package/dist/Effect.d.ts

@@ -999,10 +999,10 @@ export declare const forEach: {
      * @category sequencing
      * @since 2.0.0
      */
-    <B, E, R, S extends Iterable<any>, const Discard extends boolean = false>(f: (a: Arr.ReadonlyArray.Infer<S>, i: number) => Effect<B, E, R>, options?: {
+    <A, B, E, R, S extends Iterable<A> = Iterable<A>, const Discard extends boolean = false>(f: (a: A, i: number) => Effect<B, E, R>, options?: {
         readonly concurrency?: Concurrency | undefined;
         readonly discard?: Discard | undefined;
-    } | undefined): (self: S) => Effect<Discard extends false ? Arr.ReadonlyArray.With<S, B> : void, E, R>;
+    } | undefined): (self: [S] extends [never] ? Iterable<A> : S) => Effect<Discard extends false ? Arr.ReadonlyArray.With<S, B> : void, E, R>;
     /**
      * Executes an effectful operation for each element in an `Iterable`.
      *
@@ -1072,6 +1072,31 @@ export declare const forEach: {
         readonly discard?: Discard | undefined;
     } | undefined): Effect<Discard extends false ? Arr.ReadonlyArray.With<S, B> : void, E, R>;
 };
+/**
+ * Returns the first element of the iterable produced by an effect, or fails
+ * with `NoSuchElementError` if the iterable is empty.
+ *
+ * **When to use**
+ *
+ * Use when an effect produces a collection that must contain at least one
+ * element and absence should be represented in the typed error channel.
+ *
+ * **Example** (Getting the first element)
+ *
+ * ```ts import.meta.vitest
+ * import { Effect, Option } from "effect"
+ *
+ * const first = await Effect.runPromise(Effect.head(Effect.succeed([1, 2, 3])))
+ * first // => 1
+ *
+ * const empty = Effect.head(Effect.succeed([] as Array<number>)).pipe(Effect.catchNoSuchElement)
+ * await Effect.runPromise(empty) // => Option.none()
+ * ```
+ *
+ * @category getters
+ * @since 2.0.0
+ */
+export declare const head: <A, E, R>(self: Effect<Iterable<A>, E, R>) => Effect<A, E | Cause.NoSuchElementError, R>;
 /**
  * Executes a body effect repeatedly while a condition holds true.
  *