@typed/fx 2.0.0-beta.6 → 2.0.0-beta.8

package/dist/Fx/run/collect.js

@@ -31,7 +31,7 @@ import { observe } from "./observe.js";
  * @param fx - The `Fx` to collect values from.
  * @returns An `Effect` that produces an array of all values when the `Fx` completes.
  * @since 1.0.0
- * @category runners
+ * @category Collecting values
  */
 export const collectAll = (fx) => Effect.suspend(() => {
     const values = [];
@@ -66,7 +66,7 @@ export const collectAll = (fx) => Effect.suspend(() => {
  * @param fx - The `Fx` to collect values from.
  * @returns An `Effect` that produces a `Fiber` which computes the array of values.
  * @since 1.0.0
- * @category runners
+ * @category Collecting values
  */
 export const collectAllFork = (fx) => Effect.forkChild(collectAll(fx), {
     startImmediately: true,
@@ -99,7 +99,7 @@ export const collectAllFork = (fx) => Effect.forkChild(collectAll(fx), {
  * @param upTo - The maximum number of values to collect.
  * @returns An `Effect` that produces an array of up to `n` values.
  * @since 1.0.0
- * @category runners
+ * @category Collecting values
  */
 export const collectUpTo = dual(2, (fx, upTo) => fx.pipe(take(upTo), collectAll));
 /**
@@ -132,7 +132,7 @@ export const collectUpTo = dual(2, (fx, upTo) => fx.pipe(take(upTo), collectAll)
  * @param upTo - The maximum number of values to collect.
  * @returns An `Effect` that produces a `Fiber` which computes the array of values.
  * @since 1.0.0
- * @category runners
+ * @category Collecting values
  */
 export const collectUpToFork = (fx, upTo) => Effect.forkChild(collectUpTo(fx, upTo), {
     startImmediately: true,

package/dist/Fx/run/first.d.ts

@@ -30,7 +30,7 @@ import type { Fx } from "../Fx.js";
  * @param fx - The `Fx` stream.
  * @returns An `Effect` that produces `Some(firstValue)` or `None`.
  * @since 1.0.0
- * @category runners
+ * @category Collecting values
  */
 export declare function first<A, E, R>(fx: Fx<A, E, R>): Effect<Option<A>, E, R>;
 //# sourceMappingURL=first.d.ts.map

package/dist/Fx/run/first.js

@@ -31,7 +31,7 @@ import { collectUpTo } from "./collect.js";
  * @param fx - The `Fx` stream.
  * @returns An `Effect` that produces `Some(firstValue)` or `None`.
  * @since 1.0.0
- * @category runners
+ * @category Collecting values
  */
 export function first(fx) {
     return pipe(fx, collectUpTo(1), map(head));

package/dist/Fx/run/fork.d.ts

@@ -34,7 +34,7 @@ import type { Fx } from "../Fx.js";
  * @param options - Configuration for the forked fiber.
  * @returns An `Effect` that produces a `Fiber`.
  * @since 1.0.0
- * @category runners
+ * @category Running effects
  */
 export declare const fork: <A, E, R>(fx: Fx<A, E, R>, options?: {
     readonly startImmediately?: boolean;
@@ -73,7 +73,7 @@ export declare const fork: <A, E, R>(fx: Fx<A, E, R>, options?: {
  * @param options - `RunOptions` for the execution.
  * @returns The created `Fiber`.
  * @since 1.0.0
- * @category runners
+ * @category Running effects
  */
 export declare const runFork: <A, E>(fx: Fx<A, E>, options?: RunOptions) => Fiber<void, E>;
 //# sourceMappingURL=fork.d.ts.map

package/dist/Fx/run/fork.js

@@ -33,7 +33,7 @@ import { drain } from "./observe.js";
  * @param options - Configuration for the forked fiber.
  * @returns An `Effect` that produces a `Fiber`.
  * @since 1.0.0
- * @category runners
+ * @category Running effects
  */
 export const fork = (fx, options) => effectFork(drain(fx), {
     startImmediately: options?.startImmediately ?? true,
@@ -72,6 +72,6 @@ export const fork = (fx, options) => effectFork(drain(fx), {
  * @param options - `RunOptions` for the execution.
  * @returns The created `Fiber`.
  * @since 1.0.0
- * @category runners
+ * @category Running effects
  */
 export const runFork = (fx, options) => effectRunFork(drain(fx), options);

package/dist/Fx/run/observe.d.ts

@@ -19,7 +19,9 @@ import type { Fx } from "../Fx.js";
  * run and completes when the source completes. Interruption interrupts the internal
  * fiber and source cleanup. Callback invocation follows the producer's delivery
  * behavior; `observe` adds no buffer or concurrency of its own. A source cause or a
- * callback failure fails the returned Effect as `E | E2`.
+ * callback failure fails the returned Effect as `E | E2` and stops further
+ * deliveries. The producer fiber finishes cleanup before observation settles;
+ * resources acquired in the caller's Scope retain that Scope's lifetime.
  *
  * @example
  * ```ts
@@ -37,7 +39,7 @@ import type { Fx } from "../Fx.js";
  * @param f - The function to call for each emitted value.
  * @returns An `Effect` that completes when the stream ends.
  * @since 1.0.0
- * @category runners
+ * @category Running effects
  */
 export declare const observe: {
     <A, E2 = never, R2 = never>(f: (value: A) => void | Effect<unknown, E2, R2>): <E, R>(fx: Fx<A, E, R>) => Effect<unknown, E | E2, R | R2>;
@@ -69,7 +71,7 @@ export declare const observe: {
  * @param fx - The `Fx` stream to drain.
  * @returns An `Effect` that completes when the stream ends.
  * @since 1.0.0
- * @category runners
+ * @category Running effects
  */
 export declare const drain: <A, E, R>(fx: Fx<A, E, R>) => Effect<void, E, R>;
 /**
@@ -109,7 +111,7 @@ export declare const drain: <A, E, R>(fx: Fx<A, E, R>) => Effect<void, E, R>;
  * @param fx - The `Fx` stream to run.
  * @returns A `Layer` that manages the background execution of the stream.
  * @since 1.0.0
- * @category runners
+ * @category Running effects
  */
 export declare const drainLayer: <A, E, R>(fx: Fx<A, E, R>) => Layer<never, E, Exclude<R, Scope>>;
 /**
@@ -150,7 +152,7 @@ export declare const drainLayer: <A, E, R>(fx: Fx<A, E, R>) => Layer<never, E, E
  * @param f - The function to call for each emitted value.
  * @returns A `Layer` that manages the background execution of the stream.
  * @since 1.0.0
- * @category runners
+ * @category Running effects
  */
 export declare const observeLayer: {
     <A, E2 = never, R2 = never>(f: (value: A) => void | Effect<unknown, E2, R2>): <E, R>(fx: Fx<A, E, R>) => Layer<never, E | E2, Exclude<R | R2, Scope>>;

package/dist/Fx/run/observe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"observe.d.ts","sourceRoot":"","sources":["../../../src/Fx/run/observe.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAe5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAEnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,eAAO,MAAM,OAAO,EAAE;IACpB,CAAC,CAAC,EAAE,EAAE,GAAG,KAAK,EAAE,EAAE,GAAG,KAAK,EACxB,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,GAC9C,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;IAE9D,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,KAAK,EAAE,EAAE,GAAG,KAAK,EAC9B,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EACf,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,GAC9C,MAAM,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;CAuBpC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,KAAK,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAG,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAA6B,CAAC;AAEhG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAG,KAAK,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CACjD,CAAC;AAEvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,eAAO,MAAM,YAAY,EAAE;IACzB,CAAC,CAAC,EAAE,EAAE,GAAG,KAAK,EAAE,EAAE,GAAG,KAAK,EACxB,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,GAC9C,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;IAE3E,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,KAAK,EAAE,EAAE,GAAG,KAAK,EAC9B,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EACf,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,GAC9C,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;CAOjD,CAAC"}
+{"version":3,"file":"observe.d.ts","sourceRoot":"","sources":["../../../src/Fx/run/observe.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAiB5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAEnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,eAAO,MAAM,OAAO,EAAE;IACpB,CAAC,CAAC,EAAE,EAAE,GAAG,KAAK,EAAE,EAAE,GAAG,KAAK,EACxB,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,GAC9C,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;IAE9D,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,KAAK,EAAE,EAAE,GAAG,KAAK,EAC9B,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EACf,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,GAC9C,MAAM,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;CAmCpC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,KAAK,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAG,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAA6B,CAAC;AAEhG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAG,KAAK,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CACjD,CAAC;AAEvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,eAAO,MAAM,YAAY,EAAE;IACzB,CAAC,CAAC,EAAE,EAAE,GAAG,KAAK,EAAE,EAAE,GAAG,KAAK,EACxB,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,GAC9C,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;IAE3E,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,KAAK,EAAE,EAAE,GAAG,KAAK,EAC9B,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EACf,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,GAC9C,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;CAOjD,CAAC"}

package/dist/Fx/run/observe.js

@@ -1,4 +1,4 @@
-import { callback, catchCause, failCause, forkScoped, isEffect, matchCauseEffect, runForkWith, contextWith, sync, void as void_, } from "effect/Effect";
+import { callback, catchCause, ensuring, failCause, forkScoped, isEffect, matchCauseEffect, runForkWith, contextWith, sync, suspend, void as void_, } from "effect/Effect";
 import { interrupt } from "effect/Fiber";
 import { dual } from "effect/Function";
 import { effectDiscard } from "effect/Layer";
@@ -20,7 +20,9 @@ import { make } from "../../Sink/Sink.js";
  * run and completes when the source completes. Interruption interrupts the internal
  * fiber and source cleanup. Callback invocation follows the producer's delivery
  * behavior; `observe` adds no buffer or concurrency of its own. A source cause or a
- * callback failure fails the returned Effect as `E | E2`.
+ * callback failure fails the returned Effect as `E | E2` and stops further
+ * deliveries. The producer fiber finishes cleanup before observation settles;
+ * resources acquired in the caller's Scope retain that Scope's lifetime.
  *
  * @example
  * ```ts
@@ -38,17 +40,30 @@ import { make } from "../../Sink/Sink.js";
  * @param f - The function to call for each emitted value.
  * @returns An `Effect` that completes when the stream ends.
  * @since 1.0.0
- * @category runners
+ * @category Running effects
  */
-export const observe = dual(2, (fx, f) => contextWith((services) => callback((resume) => {
-    const onFailure = (cause) => sync(() => resume(failCause(cause)));
-    const onSuccess = (value) => {
-        const result = f(value);
-        return isEffect(result) ? catchCause(result, onFailure) : void_;
-    };
-    const onDone = () => sync(() => resume(void_));
-    return fx.run(make(onFailure, onSuccess)).pipe(matchCauseEffect(make(onFailure, onDone)), runForkWith(services), interrupt);
-})));
+export const observe = dual(2, (fx, f) => contextWith((services) => {
+    let fiber;
+    return callback((resume) => {
+        let done = false;
+        const complete = (result) => sync(() => {
+            if (done)
+                return;
+            done = true;
+            resume(result);
+        });
+        const onFailure = (cause) => complete(failCause(cause));
+        const onSuccess = (value) => suspend(() => {
+            if (done)
+                return void_;
+            const result = f(value);
+            return isEffect(result) ? catchCause(result, onFailure) : void_;
+        });
+        fiber = fx
+            .run(make(onFailure, onSuccess))
+            .pipe(matchCauseEffect(make(onFailure, () => complete(void_))), runForkWith(services));
+    }).pipe(ensuring(suspend(() => (fiber === undefined ? void_ : interrupt(fiber)))));
+}));
 /**
  * Runs an `Fx` stream to completion, discarding all values.
  * Useful when the side effects of the stream are all that matter.
@@ -75,7 +90,7 @@ export const observe = dual(2, (fx, f) => contextWith((services) => callback((re
  * @param fx - The `Fx` stream to drain.
  * @returns An `Effect` that completes when the stream ends.
  * @since 1.0.0
- * @category runners
+ * @category Running effects
  */
 export const drain = (fx) => observe(fx, () => void_);
 /**
@@ -115,7 +130,7 @@ export const drain = (fx) => observe(fx, () => void_);
  * @param fx - The `Fx` stream to run.
  * @returns A `Layer` that manages the background execution of the stream.
  * @since 1.0.0
- * @category runners
+ * @category Running effects
  */
 export const drainLayer = (fx) => effectDiscard(forkScoped(drain(fx)));
 /**
@@ -156,6 +171,6 @@ export const drainLayer = (fx) => effectDiscard(forkScoped(drain(fx)));
  * @param f - The function to call for each emitted value.
  * @returns A `Layer` that manages the background execution of the stream.
  * @since 1.0.0
- * @category runners
+ * @category Running effects
  */
 export const observeLayer = dual(2, (fx, f) => effectDiscard(forkScoped(observe(fx, f))));

package/dist/Fx/run/runPromise.d.ts

@@ -30,7 +30,7 @@ import type { Fx } from "../Fx.js";
  * @param options - `RunOptions` for execution.
  * @returns A Promise resolving to the `Exit` of the execution.
  * @since 1.0.0
- * @category runners
+ * @category Running effects
  */
 export declare const runPromiseExit: <A, E>(fx: Fx<A, E>, options?: RunOptions) => Promise<Exit.Exit<void, E>>;
 /**
@@ -62,7 +62,7 @@ export declare const runPromiseExit: <A, E>(fx: Fx<A, E>, options?: RunOptions)
  * @param options - `RunOptions` for execution.
  * @returns A Promise that resolves when the stream completes.
  * @since 1.0.0
- * @category runners
+ * @category Running effects
  */
 export declare const runPromise: <A, E>(fx: Fx<A, E>, options?: RunOptions) => Promise<unknown>;
 //# sourceMappingURL=runPromise.d.ts.map

package/dist/Fx/run/runPromise.js

@@ -29,7 +29,7 @@ import { drain } from "./observe.js";
  * @param options - `RunOptions` for execution.
  * @returns A Promise resolving to the `Exit` of the execution.
  * @since 1.0.0
- * @category runners
+ * @category Running effects
  */
 export const runPromiseExit = (fx, options) => Effect.runPromiseExit(drain(fx), options);
 /**
@@ -61,6 +61,6 @@ export const runPromiseExit = (fx, options) => Effect.runPromiseExit(drain(fx),
  * @param options - `RunOptions` for execution.
  * @returns A Promise that resolves when the stream completes.
  * @since 1.0.0
- * @category runners
+ * @category Running effects
  */
 export const runPromise = (fx, options) => Effect.runPromise(drain(fx), options);

package/dist/Fx/stream.d.ts

@@ -15,7 +15,7 @@ import type * as Fx from "./Fx.js";
  * only when the resulting Stream is run.
  *
  * @since 1.0.0
- * @category models
+ * @category Operator options
  */
 export type ToStreamOptions = Parameters<typeof Stream.callback<unknown, unknown, unknown>>[1];
 /**
@@ -45,7 +45,7 @@ export type ToStreamOptions = Parameters<typeof Stream.callback<unknown, unknown
  * ```
  *
  * @since 1.0.0
- * @category interop
+ * @category Stream interop
  */
 export declare const toStream: <A, E, R>(fx: Fx.Fx<A, E, R>, options?: ToStreamOptions) => Stream.Stream<A, E, R>;
 /**
@@ -63,7 +63,7 @@ export declare const toStream: <A, E, R>(fx: Fx.Fx<A, E, R>, options?: ToStreamO
  * adapted `Fx` is run.
  *
  * @since 1.0.0
- * @category models
+ * @category Operator options
  */
 export type FromStreamOptions = Parameters<typeof Stream.mapEffect<unknown, unknown, unknown, unknown>>[1];
 /**
@@ -93,7 +93,7 @@ export type FromStreamOptions = Parameters<typeof Stream.mapEffect<unknown, unkn
  * ```
  *
  * @since 1.0.0
- * @category interop
+ * @category Stream interop
  */
 export declare const fromStream: <A, E, R>(stream: Stream.Stream<A, E, R>, options?: FromStreamOptions) => Fx.Fx<A, E, R>;
 //# sourceMappingURL=stream.d.ts.map

package/dist/Fx/stream.js

@@ -31,7 +31,7 @@ import { make } from "./constructors/make.js";
  * ```
  *
  * @since 1.0.0
- * @category interop
+ * @category Stream interop
  */
 export const toStream = (fx, options) => Stream.callback((queue) => Effect.flatMap(fx.run(Sink.make((cause) => Queue.failCause(queue, cause), (value) => Queue.offer(queue, value))), () => Queue.end(queue)), options);
 /**
@@ -61,6 +61,6 @@ export const toStream = (fx, options) => Stream.callback((queue) => Effect.flatM
  * ```
  *
  * @since 1.0.0
- * @category interop
+ * @category Stream interop
  */
 export const fromStream = (stream, options) => make((sink) => pipe(stream, Stream.mapEffect(sink.onSuccess, options), Stream.catchCause((cause) => Stream.fromEffect(sink.onFailure(cause))), Stream.runDrain));

package/dist/Push/Push.d.ts

@@ -64,7 +64,7 @@ import * as Sink from "../Sink.js";
  * ```
  *
  * @since 1.0.0
- * @category models
+ * @category Bidirectional contracts
  */
 export interface Push<in A, in E, out R, out B, out E2, out R2> extends Sink.Sink<A, E, R>, Fx.Fx<B, E2, R2> {
 }
@@ -83,7 +83,7 @@ export declare namespace Push {
      * This type alias creates no value or resource and changes no runtime lifetime.
      *
      * @since 1.0.0
-     * @category type-level
+     * @category Type contracts
      */
     type Any = Push<any, any, any, any, any, any>;
     /**
@@ -114,7 +114,7 @@ export declare namespace Push {
      * ```
      *
      * @since 1.0.0
-     * @category models
+     * @category Push services
      */
     interface Service<Self, Id extends string, A, E, B, E2> extends Push<A, E, Self, B, E2, Self> {
         /**
@@ -223,7 +223,7 @@ export declare namespace Push {
      * ```
      *
      * @since 1.0.0
-     * @category models
+     * @category Push services
      */
     interface Class<Self, Id extends string, A, E, B, E2> extends Service<Self, Id, A, E, B, E2> {
         /**
@@ -293,7 +293,7 @@ export declare namespace Push {
  * ```
  *
  * @since 1.0.0
- * @category constructors
+ * @category Push construction
  */
 export declare const make: {
     <B, E2, R2>(fx: Fx.Fx<B, E2, R2>): <A, E, R>(sink: Sink.Sink<A, E, R>) => Push<A, E, R, B, E2, R2>;
@@ -343,7 +343,7 @@ export declare const make: {
  * ```
  *
  * @since 1.0.0
- * @category combinators
+ * @category Transforming inputs
  */
 export declare const mapInput: {
     <C, A>(f: (c: C) => A): <E, R, B, E2, R2>(push: Push<A, E, R, B, E2, R2>) => Push<C, E, R, B, E2, R2>;
@@ -391,7 +391,7 @@ export declare const mapInput: {
  * ```
  *
  * @since 1.0.0
- * @category combinators
+ * @category Transforming inputs
  */
 export declare const mapInputEffect: {
     <C, R3, E, A>(f: (c: C) => Effect.Effect<A, E, R3>): <R, B, E2, R2>(push: Push<A, E, R, B, E2, R2>) => Push<C, E, R | R3, B, E2, R2>;
@@ -434,7 +434,7 @@ export declare const mapInputEffect: {
  * ```
  *
  * @since 1.0.0
- * @category combinators
+ * @category Selecting inputs
  */
 export declare const filterInput: {
     <A>(f: (a: A) => boolean): <E, R, B, E2, R2>(push: Push<A, E, R, B, E2, R2>) => Push<A, E, R, B, E2, R2>;
@@ -477,7 +477,7 @@ export declare const filterInput: {
  * ```
  *
  * @since 1.0.0
- * @category combinators
+ * @category Selecting inputs
  */
 export declare const filterInputEffect: {
     <A, R3, E>(f: (a: A) => Effect.Effect<boolean, E, R3>): <R, B, E2, R2>(push: Push<A, E, R, B, E2, R2>) => Push<A, E, R | R3, B, E2, R2>;
@@ -523,7 +523,7 @@ export declare const filterInputEffect: {
  * ```
  *
  * @since 1.0.0
- * @category combinators
+ * @category Selecting inputs
  */
 export declare const filterMapInput: {
     <C, A>(f: (c: C) => Option.Option<A>): <P extends Push.Any>(push: P) => Push<C, Sink.Error<P>, Sink.Services<P>, Fx.Fx.Success<P>, Fx.Fx.Error<P>, Fx.Fx.Services<P>>;
@@ -566,7 +566,7 @@ export declare const filterMapInput: {
  * ```
  *
  * @since 1.0.0
- * @category combinators
+ * @category Selecting inputs
  */
 export declare const filterMapInputEffect: {
     <C, R3, E, A>(f: (c: C) => Effect.Effect<Option.Option<A>, E, R3>): <R, B, E2, R2>(push: Push<A, E, R, B, E2, R2>) => Push<C, E, R | R3, B, E2, R2>;
@@ -618,7 +618,7 @@ export declare const filterMapInputEffect: {
  * ```
  *
  * @since 1.0.0
- * @category combinators
+ * @category Transforming outputs
  */
 export declare const map: {
     <B, C>(f: (b: B) => C): <A, E, R, E2, R2>(push: Push<A, E, R, B, E2, R2>) => Push<A, E, R, C, E2, R2>;
@@ -655,7 +655,7 @@ export declare const map: {
  * ```
  *
  * @since 1.0.0
- * @category combinators
+ * @category Transforming outputs
  */
 export declare const mapEffect: {
     <B, C, E3, R3>(f: (b: B) => Effect.Effect<C, E3, R3>): <A, E, R, E2, R2>(push: Push<A, E, R, B, E2, R2>) => Push<A, E, R, C, E2 | E3, R2 | R3>;
@@ -694,7 +694,7 @@ export declare const mapEffect: {
  * ```
  *
  * @since 1.0.0
- * @category combinators
+ * @category Output failures
  */
 export declare const mapError: {
     <E2, E3>(f: (e: E2) => E3): <A, E, R, B, R2>(push: Push<A, E, R, B, E2, R2>) => Push<A, E, R, B, E3, R2>;
@@ -733,7 +733,7 @@ export declare const mapError: {
  * ```
  *
  * @since 1.0.0
- * @category combinators
+ * @category Transforming outputs
  */
 export declare const mapBoth: {
     <B, C, E2, E3>(options: {
@@ -777,7 +777,7 @@ export declare const mapBoth: {
  * ```
  *
  * @since 1.0.0
- * @category combinators
+ * @category Selecting outputs
  */
 export declare const filter: {
     <B>(f: (b: B) => boolean): <A, E, R, E2, R2>(push: Push<A, E, R, B, E2, R2>) => Push<A, E, R, B, E2, R2>;
@@ -815,7 +815,7 @@ export declare const filter: {
  * ```
  *
  * @since 1.0.0
- * @category combinators
+ * @category Selecting outputs
  */
 export declare const filterEffect: {
     <B, R3, E3>(f: (b: B) => Effect.Effect<boolean, E3, R3>): <A, E, R, E2, R2>(push: Push<A, E, R, B, E2, R2>) => Push<A, E, R, B, E2 | E3, R2 | R3>;
@@ -852,7 +852,7 @@ export declare const filterEffect: {
  * ```
  *
  * @since 1.0.0
- * @category combinators
+ * @category Selecting outputs
  */
 export declare const filterMap: {
     <B, C>(f: (b: B) => Option.Option<C>): <A, E, R, E2, R2>(push: Push<A, E, R, B, E2, R2>) => Push<A, E, R, C, E2, R2>;
@@ -889,7 +889,7 @@ export declare const filterMap: {
  * ```
  *
  * @since 1.0.0
- * @category combinators
+ * @category Selecting outputs
  */
 export declare const filterMapEffect: {
     <B, C, E3, R3>(f: (b: B) => Effect.Effect<Option.Option<C>, E3, R3>): <A, E, R, E2, R2>(push: Push<A, E, R, B, E2, R2>) => Push<A, E, R, C, E2 | E3, R2 | R3>;
@@ -948,7 +948,7 @@ export declare const filterMapEffect: {
  * ```
  *
  * @since 1.0.0
- * @category combinators
+ * @category Concurrent output work
  */
 export declare const switchMap: {
     <B, C, E3, R3>(f: (b: B) => Fx.Fx<C, E3, R3>): <A, E, R, E2, R2>(push: Push<A, E, R, B, E2, R2>) => Push<A, E, R, C, E2 | E3, R2 | R3 | Scope.Scope>;
@@ -1002,7 +1002,7 @@ export declare const switchMap: {
  * ```
  *
  * @since 1.0.0
- * @category combinators
+ * @category Concurrent output work
  */
 export declare const switchMapEffect: {
     <B, C, E3, R3>(f: (b: B) => Effect.Effect<C, E3, R3>): <A, E, R, E2, R2>(push: Push<A, E, R, B, E2, R2>) => Push<A, E, R, C, E2 | E3, R2 | R3 | Scope.Scope>;
@@ -1058,7 +1058,7 @@ export declare const switchMapEffect: {
  * ```
  *
  * @since 1.0.0
- * @category combinators
+ * @category Concurrent output work
  */
 export declare const flatMap: {
     <B, C, E3, R3>(f: (b: B) => Fx.Fx<C, E3, R3>): <A, E, R, E2, R2>(push: Push<A, E, R, B, E2, R2>) => Push<A, E, R, C, E2 | E3, R2 | R3 | Scope.Scope>;
@@ -1109,7 +1109,7 @@ export declare const flatMap: {
  * ```
  *
  * @since 1.0.0
- * @category combinators
+ * @category Concurrent output work
  */
 export declare const flatMapEffect: {
     <B, C, E3, R3>(f: (b: B) => Effect.Effect<C, E3, R3>): <A, E, R, E2, R2>(push: Push<A, E, R, B, E2, R2>) => Push<A, E, R, C, E2 | E3, R2 | R3 | Scope.Scope>;
@@ -1169,7 +1169,7 @@ export declare const flatMapEffect: {
  * ```
  *
  * @since 1.0.0
- * @category combinators
+ * @category Concurrent output work
  */
 export declare const exhaustMap: {
     <B, C, E3, R3>(f: (b: B) => Fx.Fx<C, E3, R3>): <A, E, R, E2, R2>(push: Push<A, E, R, B, E2, R2>) => Push<A, E, R, C, E2 | E3, R2 | R3 | Scope.Scope>;
@@ -1222,7 +1222,7 @@ export declare const exhaustMap: {
  * ```
  *
  * @since 1.0.0
- * @category combinators
+ * @category Concurrent output work
  */
 export declare const exhaustMapEffect: {
     <B, C, E3, R3>(f: (b: B) => Effect.Effect<C, E3, R3>): <A, E, R, E2, R2>(push: Push<A, E, R, B, E2, R2>) => Push<A, E, R, C, E2 | E3, R2 | R3 | Scope.Scope>;
@@ -1283,7 +1283,7 @@ export declare const exhaustMapEffect: {
  * ```
  *
  * @since 1.0.0
- * @category combinators
+ * @category Concurrent output work
  */
 export declare const exhaustLatestMap: {
     <B, C, E3, R3>(f: (b: B) => Fx.Fx<C, E3, R3>): <A, E, R, E2, R2>(push: Push<A, E, R, B, E2, R2>) => Push<A, E, R, C, E2 | E3, R2 | R3 | Scope.Scope>;
@@ -1337,7 +1337,7 @@ export declare const exhaustLatestMap: {
  * ```
  *
  * @since 1.0.0
- * @category combinators
+ * @category Concurrent output work
  */
 export declare const exhaustLatestMapEffect: {
     <B, C, E3, R3>(f: (b: B) => Effect.Effect<C, E3, R3>): <A, E, R, E2, R2>(push: Push<A, E, R, B, E2, R2>) => Push<A, E, R, C, E2 | E3, R2 | R3 | Scope.Scope>;
@@ -1376,7 +1376,7 @@ export declare const exhaustLatestMapEffect: {
  * @param f - Reducer `(state, value) => [nextState, emitted]`.
  * @returns A `Push` whose Fx side emits the accumulated/mapped values.
  * @since 1.0.0
- * @category combinators
+ * @category Stateful outputs
  */
 export declare const mapAccum: {
     <S, B, C>(initial: S, f: (s: S, b: B) => readonly [S, C]): <A, E, R, E2, R2>(push: Push<A, E, R, B, E2, R2>) => Push<A, E, R, C, E2, R2>;
@@ -1451,7 +1451,7 @@ export declare const mapAccum: {
  * @param f - Effectful reducer `(state, value) => Effect<[nextState, emitted]>`.
  * @returns A `Push` whose Fx side emits the accumulated/mapped values.
  * @since 1.0.0
- * @category combinators
+ * @category Stateful outputs
  */
 export declare const mapAccumEffect: {
     <S, B, C, E3, R3>(initial: S, f: (s: S, b: B) => Effect.Effect<readonly [S, C], E3, R3>): <A, E, R, E2, R2>(push: Push<A, E, R, B, E2, R2>) => Push<A, E, R, C, E2 | E3, R2 | R3>;
@@ -1494,7 +1494,7 @@ export declare const mapAccumEffect: {
  * ```
  *
  * @since 1.0.0
- * @category services
+ * @category Push services
  */
 export declare function Service<Self, A, E = never, B = never, E2 = never>(): <const Id extends string>(id: Id) => Push.Class<Self, Id, A, E, B, E2>;
 //# sourceMappingURL=Push.d.ts.map