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

package/dist/Fx/combinators/zip.d.ts

@@ -28,7 +28,7 @@ import type { Fx } from "../Fx.js";
  * @param that - The second Fx stream.
  * @returns An Fx that emits pairs `[A, B]`.
  * @since 1.0.0
- * @category combinators
+ * @category Combining sources
  */
 export declare const zip: {
     <A2, E2, R2>(that: Fx<A2, E2, R2>): <A, E, R>(self: Fx<A, E, R>) => Fx<readonly [A, A2], E | E2, R | R2>;
@@ -60,7 +60,7 @@ export declare const zip: {
  * @param f - Function to combine the pair `(a, b)` into a single value.
  * @returns An Fx that emits combined values.
  * @since 1.0.0
- * @category combinators
+ * @category Combining sources
  */
 export declare const zipWith: {
     <A, A2, E2, R2, B>(that: Fx<A2, E2, R2>, f: (a: A, b: A2) => B): <E, R>(self: Fx<A, E, R>) => Fx<B, E | E2, R | R2>;
@@ -93,7 +93,7 @@ export declare const zipWith: {
  * @param that - The second Fx stream.
  * @returns An Fx that emits `[AL, AR]` on every update from either stream.
  * @since 1.0.0
- * @category combinators
+ * @category Combining sources
  */
 export declare const zipLatest: {
     <AR, ER, RR>(that: Fx<AR, ER, RR>): <AL, EL, RL>(self: Fx<AL, EL, RL>) => Fx<readonly [AL, AR], EL | ER, RL | RR>;
@@ -126,7 +126,7 @@ export declare const zipLatest: {
  * @param f - Function to combine the latest `(left, right)` into a single value.
  * @returns An Fx that emits combined values.
  * @since 1.0.0
- * @category combinators
+ * @category Combining sources
  */
 export declare const zipLatestWith: {
     <AL, AR, ER, RR, B>(that: Fx<AR, ER, RR>, f: (left: AL, right: AR) => B): <EL, RL>(self: Fx<AL, EL, RL>) => Fx<B, EL | ER, RL | RR>;

package/dist/Fx/combinators/zip.js

@@ -37,7 +37,7 @@ import { tuple } from "./tuple.js";
  * @param that - The second Fx stream.
  * @returns An Fx that emits pairs `[A, B]`.
  * @since 1.0.0
- * @category combinators
+ * @category Combining sources
  */
 export const zip = dual(2, (self, that) => make((sink) => Effect.gen(function* () {
     const leftQueue = yield* Queue.unbounded();
@@ -95,7 +95,7 @@ export const zip = dual(2, (self, that) => make((sink) => Effect.gen(function* (
  * @param f - Function to combine the pair `(a, b)` into a single value.
  * @returns An Fx that emits combined values.
  * @since 1.0.0
- * @category combinators
+ * @category Combining sources
  */
 export const zipWith = dual(3, (self, that, f) => map(zip(self, that), (pair) => f(pair[0], pair[1])));
 /**
@@ -125,7 +125,7 @@ export const zipWith = dual(3, (self, that, f) => map(zip(self, that), (pair) =>
  * @param that - The second Fx stream.
  * @returns An Fx that emits `[AL, AR]` on every update from either stream.
  * @since 1.0.0
- * @category combinators
+ * @category Combining sources
  */
 export const zipLatest = dual(2, (self, that) => tuple(self, that));
 /**
@@ -155,6 +155,6 @@ export const zipLatest = dual(2, (self, that) => tuple(self, that));
  * @param f - Function to combine the latest `(left, right)` into a single value.
  * @returns An Fx that emits combined values.
  * @since 1.0.0
- * @category combinators
+ * @category Combining sources
  */
 export const zipLatestWith = dual(3, (self, that, f) => map(zipLatest(self, that), (pair) => f(pair[0], pair[1])));

package/dist/Fx/constructors/at.d.ts

@@ -27,7 +27,7 @@ import type { Fx } from "../Fx.js";
  * @param delay - The duration to wait before emitting.
  * @returns An `Fx` that emits the value after the delay.
  * @since 1.0.0
- * @category constructors
+ * @category Time and rate
  */
 export declare const at: {
     (delay: Duration.Input): <A>(value: A) => Fx<A>;

package/dist/Fx/constructors/at.js

@@ -28,6 +28,6 @@ import { make } from "./make.js";
  * @param delay - The duration to wait before emitting.
  * @returns An `Fx` that emits the value after the delay.
  * @since 1.0.0
- * @category constructors
+ * @category Time and rate
  */
 export const at = dual(2, (value, delay) => make((sink) => flatMap(sleep(delay), () => sink.onSuccess(value))));

package/dist/Fx/constructors/die.d.ts

@@ -26,7 +26,7 @@ import type { Fx } from "../Fx.js";
  * @param defect - The defect value.
  * @returns An `Fx` that dies immediately.
  * @since 1.0.0
- * @category constructors
+ * @category Failure sources
  */
 export declare const die: (defect: unknown) => Fx<never, never, never>;
 //# sourceMappingURL=die.d.ts.map

package/dist/Fx/constructors/die.js

@@ -28,6 +28,6 @@ import { failCause } from "./failCause.js";
  * @param defect - The defect value.
  * @returns An `Fx` that dies immediately.
  * @since 1.0.0
- * @category constructors
+ * @category Failure sources
  */
 export const die = /*#__PURE__*/ flow(Cause.die, failCause);

package/dist/Fx/constructors/empty.d.ts

@@ -20,7 +20,7 @@ import type { Fx } from "../Fx.js";
  * ```
  *
  * @since 1.0.0
- * @category constructors
+ * @category Value sources
  */
 export declare const empty: Fx<never, never, never>;
 //# sourceMappingURL=empty.d.ts.map

package/dist/Fx/constructors/empty.js

@@ -21,6 +21,6 @@ import { make } from "./make.js";
  * ```
  *
  * @since 1.0.0
- * @category constructors
+ * @category Value sources
  */
 export const empty = make(() => void_);

package/dist/Fx/constructors/fail.d.ts

@@ -26,7 +26,7 @@ import type { Fx } from "../Fx.js";
  * @param error - The error to fail with.
  * @returns An `Fx` that fails immediately.
  * @since 1.0.0
- * @category constructors
+ * @category Failure sources
  */
 export declare const fail: <E>(error: E) => Fx<never, E, never>;
 //# sourceMappingURL=fail.d.ts.map

package/dist/Fx/constructors/fail.js

@@ -28,6 +28,6 @@ import { failCause } from "./failCause.js";
  * @param error - The error to fail with.
  * @returns An `Fx` that fails immediately.
  * @since 1.0.0
- * @category constructors
+ * @category Failure sources
  */
 export const fail = /*#__PURE__*/ flow(Cause.fail, failCause);

package/dist/Fx/constructors/failCause.d.ts

@@ -28,7 +28,7 @@ import type { Fx } from "../Fx.js";
  * @param cause - The cause of failure.
  * @returns An `Fx` that terminates with the given cause.
  * @since 1.0.0
- * @category constructors
+ * @category Failure sources
  */
 export declare const failCause: <E>(cause: Cause.Cause<E>) => Fx<never, E, never>;
 //# sourceMappingURL=failCause.d.ts.map

package/dist/Fx/constructors/failCause.js

@@ -27,7 +27,7 @@ import { make } from "./make.js";
  * @param cause - The cause of failure.
  * @returns An `Fx` that terminates with the given cause.
  * @since 1.0.0
- * @category constructors
+ * @category Failure sources
  */
 export const failCause = (cause) => 
 /*#__PURE__*/ make((sink) => sink.onFailure(cause));

package/dist/Fx/constructors/fn.d.ts

@@ -16,7 +16,7 @@ import type { Fx } from "../Fx.js";
  * These are type-level contracts. They start no Effect or `Fx` run.
  *
  * @since 1.0.0
- * @category function
+ * @category Generator composition
  */
 export declare namespace fn {
     /**
@@ -47,7 +47,7 @@ export declare namespace fn {
      * ```
      *
      * @since 1.0.0
-     * @category models
+     * @category Type contracts
      */
     type Gen = {
         <Eff extends Effect.Effect<any, any, any>, ReturnFx extends Fx.Any, Args extends Array<any>>(body: (this: unassigned, ...args: Args) => Generator<Eff, ReturnFx>): (...args: Args) => Fx<Fx.Success<ReturnFx>, Fx.Error<ReturnFx> | Effect.Error<Eff>, Fx.Services<ReturnFx> | Effect.Services<Eff>>;
@@ -92,7 +92,7 @@ export declare namespace fn {
      * ```
      *
      * @since 1.0.0
-     * @category models
+     * @category Type contracts
      */
     type NonGen = {
         <Args extends Array<any>, ReturnFx extends Fx.Any>(body: (this: unassigned, ...args: Args) => ReturnFx): (...args: Args) => ReturnFx;
@@ -139,7 +139,7 @@ export declare namespace fn {
  * ```
  *
  * @since 1.0.0
- * @category constructors
+ * @category Generator composition
  */
 export declare const fn: fn.Gen & fn.NonGen & {
     (name: string, options?: SpanOptionsNoTrace): fn.Gen & fn.NonGen;

package/dist/Fx/constructors/fn.js

@@ -35,7 +35,7 @@ import { isFx } from "../TypeId.js";
  * ```
  *
  * @since 1.0.0
- * @category constructors
+ * @category Generator composition
  */
 export const fn = function (...args) {
     const [first, ...rest] = args;

package/dist/Fx/constructors/fromEffect.d.ts

@@ -30,7 +30,7 @@ import type { Fx } from "../Fx.js";
  * @param effect - The effect to convert.
  * @returns An `Fx` representing the execution of the effect.
  * @since 1.0.0
- * @category constructors
+ * @category Effect interop
  */
 export declare const fromEffect: <A, E = never, R = never>(effect: Effect.Effect<A, E, R>) => Fx<A, E, R>;
 /**
@@ -57,7 +57,7 @@ export declare const fromEffect: <A, E = never, R = never>(effect: Effect.Effect
  * ```
  *
  * @since 1.0.0
- * @category constructors
+ * @category Value sources
  */
 export declare const never: Fx<never, never, never>;
 //# sourceMappingURL=fromEffect.d.ts.map

package/dist/Fx/constructors/fromEffect.js

@@ -30,7 +30,7 @@ import { make } from "./make.js";
  * @param effect - The effect to convert.
  * @returns An `Fx` representing the execution of the effect.
  * @since 1.0.0
- * @category constructors
+ * @category Effect interop
  */
 export const fromEffect = (effect) => 
 /*#__PURE__*/ make((sink) => Effect.matchCauseEffect(effect, sink));
@@ -58,6 +58,6 @@ export const fromEffect = (effect) =>
  * ```
  *
  * @since 1.0.0
- * @category constructors
+ * @category Value sources
  */
 export const never = make(() => Effect.never);

package/dist/Fx/constructors/fromFailures.d.ts

@@ -28,7 +28,7 @@
  * @param failures - An iterable of failures.
  * @returns An `Fx` that fails with the combined failures.
  * @since 1.0.0
- * @category constructors
+ * @category Failure sources
  */
 export declare const fromFailures: <E>(failures: Iterable<E>) => import("../Fx.js").Fx<never, E, never>;
 //# sourceMappingURL=fromFailures.d.ts.map

package/dist/Fx/constructors/fromFailures.js

@@ -32,6 +32,6 @@ const fromFailuresCause = (failures) => Array.from(failures).reduce((acc, e) =>
  * @param failures - An iterable of failures.
  * @returns An `Fx` that fails with the combined failures.
  * @since 1.0.0
- * @category constructors
+ * @category Failure sources
  */
 export const fromFailures = /*#__PURE__*/ flow(fromFailuresCause, failCause);

package/dist/Fx/constructors/fromIterable.d.ts

@@ -28,7 +28,7 @@ import type { Fx } from "../Fx.js";
  * @param iterable - The iterable to emit values from.
  * @returns An `Fx` that emits the values from the iterable.
  * @since 1.0.0
- * @category constructors
+ * @category Value sources
  */
 export declare const fromIterable: <A>(iterable: Iterable<A>) => Fx<A>;
 //# sourceMappingURL=fromIterable.d.ts.map

package/dist/Fx/constructors/fromIterable.js

@@ -29,6 +29,6 @@ import { make } from "./make.js";
  * @param iterable - The iterable to emit values from.
  * @returns An `Fx` that emits the values from the iterable.
  * @since 1.0.0
- * @category constructors
+ * @category Value sources
  */
 export const fromIterable = (iterable) => make((sink) => forEach(iterable, sink.onSuccess, { discard: true }));

package/dist/Fx/constructors/fromSchedule.d.ts

@@ -9,7 +9,9 @@ import type { Fx } from "../Fx.js";
  *
  * Effect [Schedule](https://effect.website/docs/v4/api/effect/Schedule) values already
  * encode recurrence, delay, and typed schedule failures. `fromSchedule` exposes
- * those decisions as producer-driven ticks without another timing model.
+ * those decisions as producer-driven ticks without another timing model. The
+ * schedule governs all ticks: `Schedule.recurs(2)` emits twice here. In contrast,
+ * `repeat(source, Schedule.recurs(2))` runs an initial source plus two repeats.
  *
  * ## Ownership and lifetime
  *
@@ -23,14 +25,14 @@ import type { Fx } from "../Fx.js";
  * import { Schedule } from "effect"
  * import { collectAll, fromSchedule } from "@typed/fx/Fx"
  *
- * const threeTicks = fromSchedule(Schedule.recurs(2))
- * const program = collectAll(threeTicks)
+ * const twoTicks = fromSchedule(Schedule.recurs(2))
+ * const program = collectAll(twoTicks) // [undefined, undefined]
  * ```
  *
  * @param schedule - The schedule to follow.
  * @returns An `Fx` that emits periodically according to the schedule.
  * @since 1.0.0
- * @category constructors
+ * @category Time and rate
  */
 export declare const fromSchedule: <Error, Env>(schedule: Schedule<unknown, unknown, Error, Env>) => Fx<void, Error, Env>;
 //# sourceMappingURL=fromSchedule.d.ts.map

package/dist/Fx/constructors/fromSchedule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fromSchedule.d.ts","sourceRoot":"","sources":["../../../src/Fx/constructors/fromSchedule.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAGnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,YAAY,GAAI,KAAK,EAAE,GAAG,YAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,KAC/C,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAGnB,CAAC"}
+{"version":3,"file":"fromSchedule.d.ts","sourceRoot":"","sources":["../../../src/Fx/constructors/fromSchedule.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAGnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,YAAY,GAAI,KAAK,EAAE,GAAG,YAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,KAC/C,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAGnB,CAAC"}

package/dist/Fx/constructors/fromSchedule.js

@@ -9,7 +9,9 @@ import { make } from "./make.js";
  *
  * Effect [Schedule](https://effect.website/docs/v4/api/effect/Schedule) values already
  * encode recurrence, delay, and typed schedule failures. `fromSchedule` exposes
- * those decisions as producer-driven ticks without another timing model.
+ * those decisions as producer-driven ticks without another timing model. The
+ * schedule governs all ticks: `Schedule.recurs(2)` emits twice here. In contrast,
+ * `repeat(source, Schedule.recurs(2))` runs an initial source plus two repeats.
  *
  * ## Ownership and lifetime
  *
@@ -23,14 +25,14 @@ import { make } from "./make.js";
  * import { Schedule } from "effect"
  * import { collectAll, fromSchedule } from "@typed/fx/Fx"
  *
- * const threeTicks = fromSchedule(Schedule.recurs(2))
- * const program = collectAll(threeTicks)
+ * const twoTicks = fromSchedule(Schedule.recurs(2))
+ * const program = collectAll(twoTicks) // [undefined, undefined]
  * ```
  *
  * @param schedule - The schedule to follow.
  * @returns An `Fx` that emits periodically according to the schedule.
  * @since 1.0.0
- * @category constructors
+ * @category Time and rate
  */
 export const fromSchedule = (schedule) => 
 /*#__PURE__*/ make((sink) => catchCause(schedule_Effect(sink.onSuccess(), schedule), sink.onFailure));

package/dist/Fx/constructors/interrupt.d.ts

@@ -24,7 +24,7 @@
  * @param id - Optional numeric fiber identifier responsible for the interruption.
  * @returns An `Fx` that is interrupted.
  * @since 1.0.0
- * @category constructors
+ * @category Failure sources
  */
 export declare const interrupt: (fiberId?: number | undefined) => import("../Fx.js").Fx<never, never, never>;
 //# sourceMappingURL=interrupt.d.ts.map

package/dist/Fx/constructors/interrupt.js

@@ -27,6 +27,6 @@ import { failCause } from "./failCause.js";
  * @param id - Optional numeric fiber identifier responsible for the interruption.
  * @returns An `Fx` that is interrupted.
  * @since 1.0.0
- * @category constructors
+ * @category Failure sources
  */
 export const interrupt = /*#__PURE__*/ flow(Cause.interrupt, failCause);

package/dist/Fx/constructors/make.d.ts

@@ -18,10 +18,12 @@ import type { Fx } from "../Fx.js";
  *
  * ## Ownership and lifetime
  *
- * `make` only stores `run`; it starts no work. Every call to `Fx.run` executes that
- * function in the caller's fiber. The function must keep all acquisition and cleanup
- * inside its returned Effect or a required `Scope`; its error channel is `never`
- * because producer failures must be sent to `sink.onFailure`.
+ * `make` stores the callback without invoking it. Calling `fx.run(sink)` asks the
+ * callback to construct its Effect; executing that Effect performs the subscription.
+ * Keep acquisition, publication, and cleanup inside the returned Effect or a required
+ * `Scope`, rather than performing side effects while constructing it. The returned
+ * Effect has no typed failure channel because producer failures are delivered through
+ * `sink.onFailure`; defects and interruption can still affect the run.
  *
  * @example
  * ```ts
@@ -37,7 +39,7 @@ import type { Fx } from "../Fx.js";
  * @param run - A function that takes a `Sink` and returns an `Effect` that drives the stream.
  * @returns An `Fx` instance.
  * @since 1.0.0
- * @category constructors
+ * @category Callback sources
  */
 export declare const make: <A, E = never, R = never>(run: <RSink = never>(sink: Sink<A, E, RSink>) => Effect.Effect<unknown, never, R | RSink>) => Fx<A, E, R>;
 /**
@@ -56,7 +58,7 @@ export declare const make: <A, E = never, R = never>(run: <RSink = never>(sink:
  * inspect or interrupt that delivery. Retaining it after cleanup is unsupported.
  *
  * @since 1.0.0
- * @category models
+ * @category Callback protocol
  */
 export type Emit<A, E = never> = {
     /**
@@ -179,7 +181,7 @@ export type Emit<A, E = never> = {
  *              It can return a cleanup effect.
  * @returns An `Fx` adapted from the callback.
  * @since 1.0.0
- * @category constructors
+ * @category Callback sources
  */
 export declare const callback: <A, E = never, R = never>(run: (emit: Emit<A, E>) => void | Effect.Effect<unknown, never, R>) => Fx<A, E, R>;
 //# sourceMappingURL=make.d.ts.map

package/dist/Fx/constructors/make.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"make.d.ts","sourceRoot":"","sources":["../../../src/Fx/constructors/make.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAK1C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAsBnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,KAAK,OACrC,CAAC,KAAK,GAAG,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,KACxF,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAA2B,CAAC;AAEzC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,IAAI;IAC/B;;;;;;;;;;;;;;;OAeG;IACH,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC7C;;;;;;;;;;;;;;;OAeG;IACH,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC5D;;;;;;;;;;;;;;;OAeG;IACH,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC1C;;;;;;;;;;;;;;;OAeG;IACH,GAAG,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC/C;;;;;;;;;;;;;;;OAeG;IACH,IAAI,EAAE,MAAM,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;CACnC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,KAAK,OACzC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KACjE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CA6BV,CAAC"}
+{"version":3,"file":"make.d.ts","sourceRoot":"","sources":["../../../src/Fx/constructors/make.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAK1C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAsBnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,KAAK,OACrC,CAAC,KAAK,GAAG,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,KACxF,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAA2B,CAAC;AAEzC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,IAAI;IAC/B;;;;;;;;;;;;;;;OAeG;IACH,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC7C;;;;;;;;;;;;;;;OAeG;IACH,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC5D;;;;;;;;;;;;;;;OAeG;IACH,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC1C;;;;;;;;;;;;;;;OAeG;IACH,GAAG,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC/C;;;;;;;;;;;;;;;OAeG;IACH,IAAI,EAAE,MAAM,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;CACnC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,KAAK,OACzC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KACjE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CA6BV,CAAC"}

package/dist/Fx/constructors/make.js

@@ -35,10 +35,12 @@ class Make {
  *
  * ## Ownership and lifetime
  *
- * `make` only stores `run`; it starts no work. Every call to `Fx.run` executes that
- * function in the caller's fiber. The function must keep all acquisition and cleanup
- * inside its returned Effect or a required `Scope`; its error channel is `never`
- * because producer failures must be sent to `sink.onFailure`.
+ * `make` stores the callback without invoking it. Calling `fx.run(sink)` asks the
+ * callback to construct its Effect; executing that Effect performs the subscription.
+ * Keep acquisition, publication, and cleanup inside the returned Effect or a required
+ * `Scope`, rather than performing side effects while constructing it. The returned
+ * Effect has no typed failure channel because producer failures are delivered through
+ * `sink.onFailure`; defects and interruption can still affect the run.
  *
  * @example
  * ```ts
@@ -54,7 +56,7 @@ class Make {
  * @param run - A function that takes a `Sink` and returns an `Effect` that drives the stream.
  * @returns An `Fx` instance.
  * @since 1.0.0
- * @category constructors
+ * @category Callback sources
  */
 export const make = (run) => new Make(run);
 /**
@@ -91,7 +93,7 @@ export const make = (run) => new Make(run);
  *              It can return a cleanup effect.
  * @returns An `Fx` adapted from the callback.
  * @since 1.0.0
- * @category constructors
+ * @category Callback sources
  */
 export const callback = (run) => make((sink) => Effect.acquireUseRelease(Scope.make(), (scope) => withEarlyExit(sink, Effect.fn(function* (sink) {
     const services = yield* Effect.context();

package/dist/Fx/constructors/periodic.d.ts

@@ -35,7 +35,7 @@ import type { Fx } from "../Fx.js";
  * @param period - The duration between emissions.
  * @returns An `Fx` that emits repeatedly.
  * @since 1.0.0
- * @category constructors
+ * @category Time and rate
  */
 export declare const periodic: (period: Duration.Input) => Fx<void>;
 //# sourceMappingURL=periodic.d.ts.map

package/dist/Fx/constructors/periodic.js

@@ -35,7 +35,7 @@ import { fromSchedule } from "./fromSchedule.js";
  * @param period - The duration between emissions.
  * @returns An `Fx` that emits repeatedly.
  * @since 1.0.0
- * @category constructors
+ * @category Time and rate
  */
 export const periodic = (period) => 
 /*#__PURE__*/ fromSchedule(spaced(period));

package/dist/Fx/constructors/succeed.d.ts

@@ -23,7 +23,7 @@ import type { Fx } from "../Fx.js";
  * @param value - The value to emit.
  * @returns An `Fx` that emits the value.
  * @since 1.0.0
- * @category constructors
+ * @category Value sources
  */
 export declare const succeed: <A>(value: A) => Fx<A>;
 /**
@@ -47,7 +47,7 @@ export declare const succeed: <A>(value: A) => Fx<A>;
  * ```
  *
  * @since 1.0.0
- * @category constructors
+ * @category Value sources
  */
 export declare const succeedNull: Fx<null, never, never>;
 export { succeedNull as null };
@@ -72,7 +72,7 @@ export { succeedNull as null };
  * ```
  *
  * @since 1.0.0
- * @category constructors
+ * @category Value sources
  */
 export declare const succeedUndefined: Fx<undefined, never, never>;
 export { succeedUndefined as undefined };
@@ -97,7 +97,7 @@ export { succeedUndefined as undefined };
  * ```
  *
  * @since 1.0.0
- * @category constructors
+ * @category Value sources
  */
 export declare const succeedVoid: Fx<void, never, never>;
 export { succeedVoid as void };

package/dist/Fx/constructors/succeed.js

@@ -23,7 +23,7 @@ import { make } from "./make.js";
  * @param value - The value to emit.
  * @returns An `Fx` that emits the value.
  * @since 1.0.0
- * @category constructors
+ * @category Value sources
  */
 export const succeed = (value) => 
 /*#__PURE__*/ make((sink) => sink.onSuccess(value));
@@ -48,7 +48,7 @@ export const succeed = (value) =>
  * ```
  *
  * @since 1.0.0
- * @category constructors
+ * @category Value sources
  */
 export const succeedNull = succeed(null);
 export { succeedNull as null };
@@ -73,7 +73,7 @@ export { succeedNull as null };
  * ```
  *
  * @since 1.0.0
- * @category constructors
+ * @category Value sources
  */
 export const succeedUndefined = succeed(undefined);
 export { succeedUndefined as undefined };
@@ -98,7 +98,7 @@ export { succeedUndefined as undefined };
  * ```
  *
  * @since 1.0.0
- * @category constructors
+ * @category Value sources
  */
 export const succeedVoid = succeed(void 0);
 export { succeedVoid as void };

package/dist/Fx/constructors/suspend.d.ts

@@ -25,7 +25,7 @@ import type { Fx } from "../Fx.js";
  * ```
  *
  * @since 1.0.0
- * @category constructors
+ * @category Value sources
  */
 export declare const suspend: <A, E, R>(fx: () => Fx<A, E, R>) => Fx<A, E, R>;
 //# sourceMappingURL=suspend.d.ts.map

package/dist/Fx/constructors/suspend.js

@@ -26,6 +26,6 @@ import { make } from "./make.js";
  * ```
  *
  * @since 1.0.0
- * @category constructors
+ * @category Value sources
  */
 export const suspend = (fx) => make((sink) => Effect.suspend(() => fx().run(sink)));

package/dist/Fx/constructors/sync.d.ts

@@ -26,7 +26,7 @@ import type { Fx } from "../Fx.js";
  * @param evaluate - The synchronous function evaluated once per run.
  * @returns An Fx that emits the freshly evaluated value.
  * @since 2.0.0
- * @category constructors
+ * @category Value sources
  */
 export declare const sync: <A>(evaluate: () => A) => Fx<A>;
 //# sourceMappingURL=sync.d.ts.map

package/dist/Fx/constructors/sync.js

@@ -27,6 +27,6 @@ import { fromEffect } from "./fromEffect.js";
  * @param evaluate - The synchronous function evaluated once per run.
  * @returns An Fx that emits the freshly evaluated value.
  * @since 2.0.0
- * @category constructors
+ * @category Value sources
  */
 export const sync = (evaluate) => fromEffect(Effect.sync(evaluate));

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

@@ -30,7 +30,7 @@ import type { Fx } from "../Fx.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 declare const collectAll: <A, E = never, R = never>(fx: Fx<A, E, R>) => Effect.Effect<ReadonlyArray<A>, E, R>;
 /**
@@ -62,7 +62,7 @@ export declare const collectAll: <A, E = never, R = never>(fx: Fx<A, E, R>) => E
  * @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 declare const collectAllFork: <A, E = never, R = never>(fx: Fx<A, E, R>) => Effect.Effect<Fiber.Fiber<ReadonlyArray<A>, E>, never, R>;
 /**
@@ -92,7 +92,7 @@ export declare const collectAllFork: <A, E = never, R = never>(fx: Fx<A, E, R>)
  * @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 declare const collectUpTo: {
     (upTo: number): <A, E, R>(fx: Fx<A, E, R>) => Effect.Effect<ReadonlyArray<A>, E, R>;
@@ -128,7 +128,7 @@ export declare const collectUpTo: {
  * @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 declare const collectUpToFork: <A, E = never, R = never>(fx: Fx<A, E, R>, upTo: number) => Effect.Effect<Fiber.Fiber<ReadonlyArray<A>, E>, never, R>;
 //# sourceMappingURL=collect.d.ts.map