@typed/fx 1.32.0 → 2.0.0-beta.1

package/dist/Fx/combinators/flatMapConcurrentlyEffect.js

@@ -0,0 +1,13 @@
+import { dual, flow } from "effect/Function";
+import { fromEffect } from "../constructors/fromEffect.js";
+import { flatMapConcurrently } from "./flatMapConcurrently.js";
+/**
+ * Maps each element of an Fx to an Effect, running them concurrently with a limit.
+ *
+ * @param f - A function that maps an element `A` to an `Effect<B>`.
+ * @param concurrency - The maximum number of concurrent effects.
+ * @returns An `Fx` that emits the results of the effects.
+ * @since 1.0.0
+ * @category combinators
+ */
+export const flatMapConcurrentlyEffect = dual(3, (self, f, concurrency) => flatMapConcurrently(self, flow(f, fromEffect), concurrency));

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

@@ -0,0 +1,24 @@
+import type * as Effect from "effect/Effect";
+import type * as Scope from "effect/Scope";
+import type { Fx } from "../Fx.js";
+/**
+ * Type definition for flatMapEffect functions to support variable arguments.
+ * @since 1.0.0
+ * @category types
+ */
+export type FlatMapEffectLike<Args extends ReadonlyArray<any> = []> = {
+    <A, B, E2, R2>(f: (a: A) => Effect.Effect<B, E2, R2>, ...args: Args): <E, R>(self: Fx<A, E, R>) => Fx<B, E | E2, R | R2 | Scope.Scope>;
+    <A, E, R, B, E2, R2>(self: Fx<A, E, R>, f: (a: A) => Effect.Effect<B, E2, R2>, ...args: Args): Fx<B, E | E2, R | R2 | Scope.Scope>;
+};
+/**
+ * Maps each element of an Fx to an Effect, and merges the results.
+ *
+ * The effects are run concurrently.
+ *
+ * @param f - A function that maps an element `A` to an `Effect<B>`.
+ * @returns An `Fx` that emits the results of the effects.
+ * @since 1.0.0
+ * @category combinators
+ */
+export declare const flatMapEffect: FlatMapEffectLike;
+//# sourceMappingURL=flatMapEffect.d.ts.map

package/dist/Fx/combinators/flatMapEffect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatMapEffect.d.ts","sourceRoot":"","sources":["../../../src/Fx/combinators/flatMapEffect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAC;AAE7C,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAC;AAE3C,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAGnC;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,CAAC,IAAI,SAAS,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI;IACpE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EACX,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,EACrC,GAAG,IAAI,EAAE,IAAI,GACZ,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IAEpE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EACjB,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EACjB,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,EACrC,GAAG,IAAI,EAAE,IAAI,GACZ,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;CACxC,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,EAAE,iBAM3B,CAAC"}

package/dist/Fx/combinators/flatMapEffect.js

@@ -0,0 +1,14 @@
+import { dual, flow } from "effect/Function";
+import { fromEffect } from "../constructors/fromEffect.js";
+import { flatMap } from "./flatMap.js";
+/**
+ * Maps each element of an Fx to an Effect, and merges the results.
+ *
+ * The effects are run concurrently.
+ *
+ * @param f - A function that maps an element `A` to an `Effect<B>`.
+ * @returns An `Fx` that emits the results of the effects.
+ * @since 1.0.0
+ * @category combinators
+ */
+export const flatMapEffect = dual(2, (self, f) => flatMap(self, flow(f, fromEffect)));

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

@@ -0,0 +1,11 @@
+import type { Fx } from "../Fx.js";
+/**
+ * Flips the error and success channels of an Fx.
+ *
+ * @param fx - The `Fx` stream.
+ * @returns An `Fx` where errors are successes and successes are errors.
+ * @since 1.0.0
+ * @category combinators
+ */
+export declare const flip: <A, E, R>(fx: Fx<A, E, R>) => Fx<E, A, R>;
+//# sourceMappingURL=flip.d.ts.map

package/dist/Fx/combinators/flip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flip.d.ts","sourceRoot":"","sources":["../../../src/Fx/combinators/flip.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAEnC;;;;;;;GAOG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CACJ,CAAC"}

package/dist/Fx/combinators/flip.js

@@ -0,0 +1,11 @@
+import * as sinkCore from "../../Sink/combinators.js";
+import { make } from "../constructors/make.js";
+/**
+ * Flips the error and success channels of an Fx.
+ *
+ * @param fx - The `Fx` stream.
+ * @returns An `Fx` where errors are successes and successes are errors.
+ * @since 1.0.0
+ * @category combinators
+ */
+export const flip = (fx) => make((sink) => fx.run(sinkCore.flip(sink)));

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

@@ -0,0 +1,20 @@
+import * as Effect from "effect/Effect";
+import type { Fx } from "../Fx.js";
+/** Extract error type from Yieldable (Effect v4) */
+type _YE<Y> = Y extends Effect.Yieldable<any, any, infer E, any> ? E : never;
+/** Extract services type from Yieldable (Effect v4) */
+type _YS<Y> = Y extends Effect.Yieldable<any, any, any, infer R> ? R : never;
+/**
+ * Creates an Fx using a generator function (Effect.gen style).
+ *
+ * This allows writing Fx code in a synchronous-looking style, using `yield*` to composition.
+ * Note: The generator yields Effects, and the result is an Fx.
+ *
+ * @param f - The generator function.
+ * @returns An `Fx` representing the result of the generator.
+ * @since 1.0.0
+ * @category combinators
+ */
+export declare const gen: <Yield extends Effect.Yieldable<any, any, any, any>, Return extends Fx.Any>(f: () => Generator<Yield, Return, any>) => Fx<Fx.Success<Return>, Fx.Error<Return> | _YE<Yield>, Fx.Services<Return> | _YS<Yield>>;
+export {};
+//# sourceMappingURL=gen.d.ts.map

package/dist/Fx/combinators/gen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gen.d.ts","sourceRoot":"","sources":["../../../src/Fx/combinators/gen.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAGnC,oDAAoD;AACpD,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAC7E,uDAAuD;AACvD,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAE7E;;;;;;;;;;GAUG;AACH,eAAO,MAAM,GAAG,GAAI,KAAK,SAAS,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,SAAS,EAAE,CAAC,GAAG,EAC3F,GAAG,MAAM,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,KACrC,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAC3D,CAAC"}

package/dist/Fx/combinators/gen.js

@@ -0,0 +1,14 @@
+import * as Effect from "effect/Effect";
+import { unwrap } from "./unwrap.js";
+/**
+ * Creates an Fx using a generator function (Effect.gen style).
+ *
+ * This allows writing Fx code in a synchronous-looking style, using `yield*` to composition.
+ * Note: The generator yields Effects, and the result is an Fx.
+ *
+ * @param f - The generator function.
+ * @returns An `Fx` representing the result of the generator.
+ * @since 1.0.0
+ * @category combinators
+ */
+export const gen = (f) => unwrap(Effect.gen(f));

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

@@ -0,0 +1,20 @@
+import * as Effect from "effect/Effect";
+import type * as Scope from "effect/Scope";
+import type { Fx } from "../Fx.js";
+/** Extract error type from Yieldable (Effect v4) */
+type _YE<Y> = Y extends Effect.Yieldable<any, any, infer E, any> ? E : never;
+/** Extract services type from Yieldable (Effect v4) */
+type _YS<Y> = Y extends Effect.Yieldable<any, any, any, infer R> ? R : never;
+/**
+ * Creates a scoped Fx using a generator function.
+ *
+ * Similar to `gen`, but also handles resource management via Scope.
+ *
+ * @param f - The generator function.
+ * @returns An `Fx` representing the result of the generator.
+ * @since 1.0.0
+ * @category combinators
+ */
+export declare const genScoped: <Yield extends Effect.Yieldable<any, any, any, any>, A, E, R>(f: () => Generator<Yield, Fx<A, E, R>, any>) => Fx<A, E | _YE<Yield>, Exclude<R | _YS<Yield>, Scope.Scope>>;
+export {};
+//# sourceMappingURL=genScoped.d.ts.map

package/dist/Fx/combinators/genScoped.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"genScoped.d.ts","sourceRoot":"","sources":["../../../src/Fx/combinators/genScoped.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAGnC,oDAAoD;AACpD,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAC7E,uDAAuD;AACvD,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAE7E;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS,GAAI,KAAK,SAAS,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EACnF,GAAG,MAAM,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,KAC1C,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CACzB,CAAC"}

package/dist/Fx/combinators/genScoped.js

@@ -0,0 +1,13 @@
+import * as Effect from "effect/Effect";
+import { unwrapScoped } from "./unwrapScoped.js";
+/**
+ * Creates a scoped Fx using a generator function.
+ *
+ * Similar to `gen`, but also handles resource management via Scope.
+ *
+ * @param f - The generator function.
+ * @returns An `Fx` representing the result of the generator.
+ * @since 1.0.0
+ * @category combinators
+ */
+export const genScoped = (f) => unwrapScoped(Effect.gen(f));

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

@@ -0,0 +1,62 @@
+export * from "./catch.js";
+export * from "./changesWithEffect.js";
+export * from "./causes.js";
+export * from "./compact.js";
+export * from "./continueWith.js";
+export * from "./dropUntil.js";
+export * from "./additive.js";
+export * from "./ensuring.js";
+export * from "./exhaustLatestMap.js";
+export * from "./exhaustLatestMapEffect.js";
+export * from "./exhaustMap.js";
+export * from "./exhaustMapEffect.js";
+export * from "./exit.js";
+export * from "./filter.js";
+export * from "./filterEffect.js";
+export * from "./filterMap.js";
+export * from "./filterMapEffect.js";
+export * from "./filterMapLoop.js";
+export * from "./filterMapLoopCause.js";
+export * from "./filterMapLoopCauseEffect.js";
+export * from "./filterMapLoopEffect.js";
+export * from "./flatMap.js";
+export * from "./flatMapConcurrently.js";
+export * from "./flatMapConcurrentlyEffect.js";
+export * from "./flatMapEffect.js";
+export * from "./flip.js";
+export * from "./gen.js";
+export * from "./genScoped.js";
+export * from "./keyed.js";
+export * from "./loop.js";
+export * from "./loopCause.js";
+export * from "./loopCauseEffect.js";
+export * from "./loopEffect.js";
+export * from "./map.js";
+export * from "./mapBoth.js";
+export * from "./mapEffect.js";
+export * from "./mapError.js";
+export * from "./mergeAll.js";
+export * from "./mergeOrdered.js";
+export * from "./onError.js";
+export * from "./onExit.js";
+export * from "./onInterrupt.js";
+export * from "./provide.js";
+export * from "./result.js";
+export * from "./scan.js";
+export * from "./skip.js";
+export * from "./skipRepeats.js";
+export * from "./skipWhile.js";
+export * from "./skipRepeatsWith.js";
+export * from "./slice.js";
+export * from "./switchMap.js";
+export * from "./switchMapEffect.js";
+export * from "./take.js";
+export * from "./takeUntil.js";
+export * from "./takeWhile.js";
+export * from "./tapEffect.js";
+export * from "./tuple.js";
+export * from "./unwrap.js";
+export * from "./unwrapScoped.js";
+export * from "./when.js";
+export * from "./zip.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/Fx/combinators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/Fx/combinators/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC"}

package/dist/Fx/combinators/index.js

@@ -0,0 +1,61 @@
+export * from "./catch.js";
+export * from "./changesWithEffect.js";
+export * from "./causes.js";
+export * from "./compact.js";
+export * from "./continueWith.js";
+export * from "./dropUntil.js";
+export * from "./additive.js";
+export * from "./ensuring.js";
+export * from "./exhaustLatestMap.js";
+export * from "./exhaustLatestMapEffect.js";
+export * from "./exhaustMap.js";
+export * from "./exhaustMapEffect.js";
+export * from "./exit.js";
+export * from "./filter.js";
+export * from "./filterEffect.js";
+export * from "./filterMap.js";
+export * from "./filterMapEffect.js";
+export * from "./filterMapLoop.js";
+export * from "./filterMapLoopCause.js";
+export * from "./filterMapLoopCauseEffect.js";
+export * from "./filterMapLoopEffect.js";
+export * from "./flatMap.js";
+export * from "./flatMapConcurrently.js";
+export * from "./flatMapConcurrentlyEffect.js";
+export * from "./flatMapEffect.js";
+export * from "./flip.js";
+export * from "./gen.js";
+export * from "./genScoped.js";
+export * from "./keyed.js";
+export * from "./loop.js";
+export * from "./loopCause.js";
+export * from "./loopCauseEffect.js";
+export * from "./loopEffect.js";
+export * from "./map.js";
+export * from "./mapBoth.js";
+export * from "./mapEffect.js";
+export * from "./mapError.js";
+export * from "./mergeAll.js";
+export * from "./mergeOrdered.js";
+export * from "./onError.js";
+export * from "./onExit.js";
+export * from "./onInterrupt.js";
+export * from "./provide.js";
+export * from "./result.js";
+export * from "./scan.js";
+export * from "./skip.js";
+export * from "./skipRepeats.js";
+export * from "./skipWhile.js";
+export * from "./skipRepeatsWith.js";
+export * from "./slice.js";
+export * from "./switchMap.js";
+export * from "./switchMapEffect.js";
+export * from "./take.js";
+export * from "./takeUntil.js";
+export * from "./takeWhile.js";
+export * from "./tapEffect.js";
+export * from "./tuple.js";
+export * from "./unwrap.js";
+export * from "./unwrapScoped.js";
+export * from "./when.js";
+export * from "./zip.js";

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

@@ -0,0 +1,44 @@
+import * as Duration from "effect/Duration";
+import * as Scope from "effect/Scope";
+import * as RefSubject from "../../RefSubject/RefSubject.js";
+import type { Fx } from "../Fx.js";
+/**
+ * Configuration options for the `keyed` combinator.
+ * @since 1.0.0
+ * @category models
+ */
+export interface KeyedOptions<A, B, C, E2, R2> {
+    /**
+     * Function to extract a unique key from an element.
+     */
+    readonly getKey: (a: A) => B;
+    /**
+     * Function to transform a value into an Fx, receiving a RefSubject of the value.
+     * This allows the transformation to react to updates of the same item (same key).
+     */
+    readonly onValue: (ref: RefSubject.RefSubject<A>, key: B) => Fx<C, E2, R2 | Scope.Scope>;
+    /**
+     * Optional debounce duration for emission.
+     */
+    readonly debounce?: Duration.Input;
+}
+/**
+ * Efficiently transforms a list of values into a list of Fx streams, using keys to track identity.
+ *
+ * This is crucial for performance when rendering lists or managing collections of stateful entities.
+ * When the input list changes:
+ * - New keys cause `onValue` to be called.
+ * - Existing keys have their `RefSubject` updated with the new value.
+ * - Removed keys have their corresponding Fx and scope cleaned up.
+ *
+ * @param fx - An `Fx` emitting an array of values.
+ * @param options - Configuration options.
+ * @returns An `Fx` emitting an array of results.
+ * @since 1.0.0
+ * @category combinators
+ */
+export declare const keyed: {
+    <A, B extends PropertyKey, C, E2, R2>(options: KeyedOptions<A, B, C, E2, R2>): <E, R>(fx: Fx<ReadonlyArray<A>, E, R>) => Fx<ReadonlyArray<C>, E | E2, R | R2 | Scope.Scope>;
+    <A, E, R, B extends PropertyKey, C, E2, R2>(fx: Fx<ReadonlyArray<A>, E, R>, options: KeyedOptions<A, B, C, E2, R2>): Fx<ReadonlyArray<C>, E | E2, R | R2 | Scope.Scope>;
+};
+//# sourceMappingURL=keyed.d.ts.map

package/dist/Fx/combinators/keyed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyed.d.ts","sourceRoot":"","sources":["../../../src/Fx/combinators/keyed.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAQ5C,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAItC,OAAO,KAAK,UAAU,MAAM,gCAAgC,CAAC;AAE7D,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAMnC;;;;GAIG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE;IAC3C;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IACzF;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC;CACpC;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,KAAK,EAAE;IAClB,CAAC,CAAC,EAAE,CAAC,SAAS,WAAW,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAClC,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,GACrC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IAChG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,WAAW,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EACxC,EAAE,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAC9B,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,GACrC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;CAetD,CAAC"}

package/dist/Fx/combinators/keyed.js

@@ -0,0 +1,199 @@
+import * as Clock from "effect/Clock";
+import * as Duration from "effect/Duration";
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import * as Fiber from "effect/Fiber";
+import { dual, identity } from "effect/Function";
+import * as Option from "effect/Option";
+import { pipeArguments } from "effect/Pipeable";
+import { MaxOpsBeforeYield } from "effect/Scheduler";
+import * as Scope from "effect/Scope";
+import * as ServiceMap from "effect/ServiceMap";
+import * as SynchronizedRef from "effect/SynchronizedRef";
+import * as RefSubject from "../../RefSubject/RefSubject.js";
+import * as Sink from "../../Sink/Sink.js";
+import { diff, getKeyMap } from "../internal/diff.js";
+import { withScopedFork } from "../internal/scope.js";
+import { FxTypeId } from "../TypeId.js";
+/**
+ * Efficiently transforms a list of values into a list of Fx streams, using keys to track identity.
+ *
+ * This is crucial for performance when rendering lists or managing collections of stateful entities.
+ * When the input list changes:
+ * - New keys cause `onValue` to be called.
+ * - Existing keys have their `RefSubject` updated with the new value.
+ * - Removed keys have their corresponding Fx and scope cleaned up.
+ *
+ * @param fx - An `Fx` emitting an array of values.
+ * @param options - Configuration options.
+ * @returns An `Fx` emitting an array of results.
+ * @since 1.0.0
+ * @category combinators
+ */
+export const keyed = dual(2, function keyed(fx, options) {
+    return new Keyed(fx, options);
+});
+const StateContext = ServiceMap.Service("@services/StateContext");
+const VARIANCE = {
+    _A: identity,
+    _E: identity,
+    _R: identity,
+};
+class Keyed {
+    [FxTypeId] = VARIANCE;
+    fx;
+    options;
+    constructor(fx, options) {
+        this.fx = fx;
+        this.options = options;
+    }
+    run(sink) {
+        return Effect.withFiber((fiber) => runKeyed(this.fx, this.options, sink, fiber.id)).pipe(Effect.provideService(MaxOpsBeforeYield, Infinity));
+    }
+    pipe() {
+        return pipeArguments(this, arguments);
+    }
+}
+function emptyKeyedState() {
+    return {
+        entries: new Map(),
+        indices: new Map(),
+        previousValues: [],
+    };
+}
+function runKeyed(fx, options, sink, id) {
+    return withDebounceFork((debounceFork, parentScope) => {
+        const state = emptyKeyedState();
+        const emit = Effect.suspend(() => sink.onSuccess(getReadyIndices(state)));
+        const scheduleNextEmit = debounceFork(emit);
+        let first = true;
+        let previousKeyMap = new Map();
+        return fx.run(Sink.make(sink.onFailure, Effect.fn(function* (values) {
+            const previous = state.previousValues;
+            const keyMap = getKeyMap(values, options.getKey);
+            let changed = first;
+            first = false;
+            for (const patch of diff(previous, values, {
+                getKey: options.getKey,
+                previousKeyMap,
+                keyMap,
+            })) {
+                if (patch._tag === "Remove") {
+                    changed = true;
+                    yield* removeValue(state, patch, state.entries.get(patch.key));
+                }
+                else if (patch._tag === "Add") {
+                    changed = true;
+                    yield* addValue({
+                        state,
+                        values,
+                        patch,
+                        id,
+                        parentScope,
+                        keyedOptions: options,
+                        sink,
+                        scheduleNextEmit,
+                    });
+                }
+                else {
+                    yield* updateValue(state, values, patch);
+                }
+            }
+            state.previousValues = values;
+            previousKeyMap = keyMap;
+            if (changed) {
+                yield* scheduleNextEmit;
+            }
+            else {
+                yield* adjustTime();
+            }
+        })));
+    }, options.debounce || 1);
+}
+class KeyedEntry {
+    value;
+    index;
+    output;
+    ref;
+    interrupt;
+    constructor(value, index, output, ref, interrupt) {
+        this.value = value;
+        this.index = index;
+        this.output = output;
+        this.ref = ref;
+        this.interrupt = interrupt;
+    }
+}
+function getReadyIndices({ entries, indices, previousValues, }) {
+    const output = [];
+    for (let i = 0; i < previousValues.length; ++i) {
+        const key = indices.get(i);
+        if (key === undefined)
+            break;
+        const entry = entries.get(key);
+        if (Option.isSome(entry.output)) {
+            output.push(entry.output.value);
+        }
+        else {
+            break;
+        }
+    }
+    return output;
+}
+function* addValue(options) {
+    const { id, keyedOptions, parentScope, patch, scheduleNextEmit, sink, state, values } = options;
+    const { entries, indices } = state;
+    const value = values[patch.index];
+    const childScope = yield* Scope.fork(parentScope, "sequential");
+    const ref = yield* RefSubject.make(Effect.sync(() => entry.value)).pipe(Effect.provideService(Scope.Scope, childScope));
+    const entry = new KeyedEntry(value, patch.index, Option.none(), ref, Scope.close(childScope, Exit.interrupt(id)));
+    entries.set(patch.key, entry);
+    indices.set(patch.index, patch.key);
+    yield* Effect.forkIn(keyedOptions
+        .onValue(ref, patch.key)
+        .run(Sink.make((cause) => sink.onFailure(cause), (output) => {
+        entry.output = Option.some(output);
+        return scheduleNextEmit;
+    }))
+        .pipe(Effect.provideService(Scope.Scope, childScope)), parentScope);
+}
+function removeValue({ entries, indices }, patch, entry) {
+    entries.delete(patch.key);
+    indices.delete(patch.index);
+    return entry.interrupt;
+}
+function updateValue({ entries, indices }, values, patch) {
+    const key = patch.key;
+    const entry = entries.get(key);
+    if (patch._tag === "Moved") {
+        const currentKey = indices.get(patch.index);
+        if (currentKey === key) {
+            indices.delete(patch.index);
+        }
+        indices.set(patch.to, key);
+        entry.value = values[(entry.index = patch.to)];
+    }
+    else {
+        entry.value = values[(entry.index = patch.index)];
+    }
+    return RefSubject.set(entry.ref, entry.value);
+}
+function withDebounceFork(f, duration) {
+    return withScopedFork((fork, scope) => Effect.flatMap(SynchronizedRef.make(Option.none()), (ref) => Effect.flatMap(f((effect) => SynchronizedRef.updateEffect(ref, Option.match({
+        onNone: () => Effect.asSome(fork(Effect.delay(effect, duration))),
+        onSome: (fiber) => Fiber.interrupt(fiber).pipe(Effect.flatMap(() => fork(Effect.delay(effect, duration))), Effect.asSome),
+    })), scope), () => SynchronizedRef.updateEffect(ref, Option.match({
+        onNone: () => Effect.succeedNone,
+        onSome: (fiber) => Fiber.join(fiber).pipe(Effect.as(Option.none())),
+    })))), "sequential");
+}
+function* adjustTime() {
+    const services = yield* Effect.services();
+    const clock = ServiceMap.get(services, Clock.Clock);
+    if ("adjust" in clock) {
+        yield* clock.adjust(Duration.millis(1));
+    }
+    else {
+        yield* clock.sleep(Duration.millis(1));
+    }
+}

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

@@ -0,0 +1,16 @@
+import type { Fx } from "../Fx.js";
+/**
+ * Loops over an Fx with an accumulator, producing a new value for each element
+ * and updating the accumulator.
+ *
+ * @param seed - The initial value of the accumulator.
+ * @param f - A function that takes the accumulator and an element, returning a tuple of the emitted value and the new accumulator.
+ * @returns An `Fx` that emits the transformed values.
+ * @since 1.0.0
+ * @category combinators
+ */
+export declare const loop: {
+    <B, A, C>(seed: B, f: (acc: B, a: A) => readonly [C, B]): <E, R>(self: Fx<A, E, R>) => Fx<C, E, R>;
+    <A, E, R, B, C>(self: Fx<A, E, R>, seed: B, f: (acc: B, a: A) => readonly [C, B]): Fx<C, E, R>;
+};
+//# sourceMappingURL=loop.d.ts.map

package/dist/Fx/combinators/loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../../src/Fx/combinators/loop.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAEnC;;;;;;;;;GASG;AACH,eAAO,MAAM,IAAI,EAAE;IACjB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EACN,IAAI,EAAE,CAAC,EACP,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,GACnC,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAE5C,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;CAKhG,CAAC"}

package/dist/Fx/combinators/loop.js

@@ -0,0 +1,14 @@
+import { dual } from "effect/Function";
+import * as sinkCore from "../../Sink/combinators.js";
+import { make } from "../constructors/make.js";
+/**
+ * Loops over an Fx with an accumulator, producing a new value for each element
+ * and updating the accumulator.
+ *
+ * @param seed - The initial value of the accumulator.
+ * @param f - A function that takes the accumulator and an element, returning a tuple of the emitted value and the new accumulator.
+ * @returns An `Fx` that emits the transformed values.
+ * @since 1.0.0
+ * @category combinators
+ */
+export const loop = dual(3, (self, seed, f) => make((sink) => self.run(sinkCore.loop(sink, seed, f))));

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

@@ -0,0 +1,16 @@
+import type * as Cause from "effect/Cause";
+import type { Fx } from "../Fx.js";
+/**
+ * Loops over the failure causes of an Fx with an accumulator.
+ *
+ * @param seed - The initial state.
+ * @param f - The loop function for causes.
+ * @returns An `Fx` with transformed errors.
+ * @since 1.0.0
+ * @category combinators
+ */
+export declare const loopCause: {
+    <B, A, C>(seed: B, f: (acc: B, a: Cause.Cause<A>) => readonly [Cause.Cause<C>, B]): <E, R>(self: Fx<A, E, R>) => Fx<A, C, R>;
+    <A, E, R, B, C>(self: Fx<A, E, R>, seed: B, f: (acc: B, a: Cause.Cause<E>) => readonly [Cause.Cause<C>, B]): Fx<A, C, R>;
+};
+//# sourceMappingURL=loopCause.d.ts.map

package/dist/Fx/combinators/loopCause.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loopCause.d.ts","sourceRoot":"","sources":["../../../src/Fx/combinators/loopCause.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAC;AAI3C,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAEnC;;;;;;;;GAQG;AACH,eAAO,MAAM,SAAS,EAAE;IACtB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EACN,IAAI,EAAE,CAAC,EACP,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAC7D,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAE5C,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EACZ,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EACjB,IAAI,EAAE,CAAC,EACP,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAC7D,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;CAQhB,CAAC"}

package/dist/Fx/combinators/loopCause.js

@@ -0,0 +1,13 @@
+import { dual } from "effect/Function";
+import * as sinkCore from "../../Sink/combinators.js";
+import { make } from "../constructors/make.js";
+/**
+ * Loops over the failure causes of an Fx with an accumulator.
+ *
+ * @param seed - The initial state.
+ * @param f - The loop function for causes.
+ * @returns An `Fx` with transformed errors.
+ * @since 1.0.0
+ * @category combinators
+ */
+export const loopCause = dual(3, (self, seed, f) => make((sink) => self.run(sinkCore.loopCause(sink, seed, f))));

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

@@ -0,0 +1,17 @@
+import type * as Cause from "effect/Cause";
+import type * as Effect from "effect/Effect";
+import type { Fx } from "../Fx.js";
+/**
+ * Effectfully loops over the failure causes of an Fx with an accumulator.
+ *
+ * @param seed - The initial state.
+ * @param f - The effectful loop function for causes.
+ * @returns An `Fx` with transformed errors.
+ * @since 1.0.0
+ * @category combinators
+ */
+export declare const loopCauseEffect: {
+    <B, A, E, R2, C>(seed: B, f: (acc: B, a: Cause.Cause<A>) => Effect.Effect<readonly [Cause.Cause<C>, B], R2>): <R>(self: Fx<A, E, R>) => Fx<A, C | E, R | R2>;
+    <A, E, R, B, R2, C>(self: Fx<A, E, R>, seed: B, f: (acc: B, a: Cause.Cause<E>) => Effect.Effect<readonly [Cause.Cause<C>, B], E, R2>): Fx<A, C, R | R2>;
+};
+//# sourceMappingURL=loopCauseEffect.d.ts.map

package/dist/Fx/combinators/loopCauseEffect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loopCauseEffect.d.ts","sourceRoot":"","sources":["../../../src/Fx/combinators/loopCauseEffect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAC;AAI7C,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAEnC;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,EAAE;IAC5B,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EACb,IAAI,EAAE,CAAC,EACP,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAChF,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;IAElD,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAChB,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EACjB,IAAI,EAAE,CAAC,EACP,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GACnF,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;CASrB,CAAC"}