effect 4.0.1 → 4.0.3

package/dist/Layer.d.ts

@@ -7,6 +7,7 @@
  * combine with other layers, provide services to effects or streams, and attach
  * error handling, tracing, or lifecycle hooks.
  *
+ * @stability stable
  * @since 2.0.0
  */
 import type { NonEmptyReadonlyArray } from "./Array.ts";
@@ -38,6 +39,7 @@ declare const TypeId = "~effect/Layer";
  * provides, `E` as the possible errors during layer construction, and `RIn` as
  * the services this layer requires as dependencies.
  *
+ * @stability stable
  * @category models
  * @since 2.0.0
  */
@@ -55,6 +57,7 @@ export interface Layer<in ROut, out E = never, out RIn = never> extends Variance
  * This is used by Effect's pipe and unification machinery to preserve the
  * provided services, error, and requirements of a `Layer`.
  *
+ * @stability stable
  * @category models
  * @since 4.0.0
  */
@@ -67,6 +70,7 @@ export interface LayerUnify<A extends {
  * Type-level marker used by `Unify` for `Layer` types that should be ignored
  * during unification.
  *
+ * @stability stable
  * @category models
  * @since 4.0.0
  */
@@ -75,6 +79,7 @@ export interface LayerUnifyIgnore {
 /**
  * The variance interface for Layer type parameters.
  *
+ * @stability stable
  * @category models
  * @since 2.0.0
  */
@@ -104,6 +109,7 @@ export interface Variance<in ROut, out E, out RIn> {
  * @see {@link Error} for extracting construction errors from a layer type
  * @see {@link Success} for extracting provided services from a layer type
  *
+ * @stability stable
  * @category utility types
  * @since 3.9.0
  */
@@ -125,6 +131,7 @@ export interface Any {
  * @see {@link Success} for extracting the services provided by the same `Layer`
  * @see {@link Error} for extracting the construction failure type from the same `Layer`
  *
+ * @stability stable
  * @category utility types
  * @since 4.0.0
  */
@@ -140,6 +147,7 @@ export type Services<T extends Any> = T extends infer L ? L extends Layer<infer
  * @see {@link Success} for extracting the services provided by the same `Layer`
  * @see {@link Services} for extracting the dependency requirements of the same `Layer`
  *
+ * @stability stable
  * @category utility types
  * @since 2.0.0
  */
@@ -155,6 +163,7 @@ export type Error<T extends Any> = T extends Layer<infer _ROut, infer _E, infer
  * @see {@link Error} for extracting the layer construction error type instead
  * @see {@link Services} for extracting the layer input service requirements instead
  *
+ * @stability stable
  * @category utility types
  * @since 2.0.0
  */
@@ -195,6 +204,7 @@ declare const MemoMapTypeId = "~effect/Layer/MemoMap";
  * Effect.runSync(database.query("SELECT 1")) // => "result"
  * ```
  *
+ * @stability stable
  * @category models
  * @since 2.0.0
  */
@@ -224,6 +234,7 @@ export interface MemoMap {
  * Layer.isLayer(notALayer) // => false
  * ```
  *
+ * @stability stable
  * @category guards
  * @since 2.0.0
  */
@@ -258,6 +269,7 @@ export declare const isLayer: (u: unknown) => u is Layer<unknown, unknown, unkno
  * Effect.runSync(Effect.provide(program, databaseLayer)) // => "result"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -292,6 +304,7 @@ export declare const fromBuild: <ROut, E, RIn>(build: (memoMap: MemoMap, scope:
  * Effect.runSync(Effect.provide(program, databaseLayer)) // => "result"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -325,6 +338,7 @@ export declare const fromBuildMemo: <ROut, E, RIn>(build: (memoMap: MemoMap, sco
  * Effect.runSync(database.query("SELECT 1")) // => "result"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -343,6 +357,7 @@ export declare const makeMemoMapUnsafe: () => MemoMap;
  * @see {@link forkMemoMap} for allocating the child memo map inside `Effect`
  * @see {@link makeMemoMapUnsafe} for creating a root memo map without a parent
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -376,6 +391,7 @@ export declare const forkMemoMapUnsafe: (parent: MemoMap) => MemoMap;
  * Effect.runSync(database.query("SELECT 1")) // => "result"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -394,6 +410,7 @@ export declare const makeMemoMap: Effect<MemoMap>;
  * @see {@link forkMemoMapUnsafe} for the synchronous constructor variant
  * @see {@link buildWithMemoMap} for building layers with an explicit memo map
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -414,6 +431,7 @@ declare const CurrentMemoMap_base: Context.ServiceClass<CurrentMemoMap, "effect/
  *
  * @see {@link MemoMap} the memoization map type wrapped by this service
  *
+ * @stability stable
  * @category services
  * @since 3.13.0
  */
@@ -471,6 +489,7 @@ export declare class CurrentMemoMap extends CurrentMemoMap_base {
  * logs // => ["ready"]
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 2.0.0
  */
@@ -526,6 +545,7 @@ export declare const buildWithMemoMap: {
      * logs // => ["ready"]
      * ```
      *
+     * @stability stable
      * @category destructors
      * @since 2.0.0
      */
@@ -581,6 +601,7 @@ export declare const buildWithMemoMap: {
      * logs // => ["ready"]
      * ```
      *
+     * @stability stable
      * @category destructors
      * @since 2.0.0
      */
@@ -616,6 +637,7 @@ export declare const buildWithMemoMap: {
  * Effect.runSync(Effect.scoped(program)) // => "result"
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 2.0.0
  */
@@ -669,6 +691,7 @@ export declare const build: <RIn, E, ROut>(self: Layer<ROut, E, RIn>) => Effect<
  * logs // => ["Initializing database...", "Database closed"]
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 2.0.0
  */
@@ -722,6 +745,7 @@ export declare const buildWithScope: {
      * logs // => ["Initializing database...", "Database closed"]
      * ```
      *
+     * @stability stable
      * @category destructors
      * @since 2.0.0
      */
@@ -775,6 +799,7 @@ export declare const buildWithScope: {
      * logs // => ["Initializing database...", "Database closed"]
      * ```
      *
+     * @stability stable
      * @category destructors
      * @since 2.0.0
      */
@@ -807,6 +832,7 @@ export declare const buildWithScope: {
  *
  * @see {@link sync} for constructing layers from lazy values
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -838,6 +864,7 @@ export declare const succeed: {
      *
      * @see {@link sync} for constructing layers from lazy values
      *
+     * @stability stable
      * @category constructors
      * @since 2.0.0
      */
@@ -869,6 +896,7 @@ export declare const succeed: {
      *
      * @see {@link sync} for constructing layers from lazy values
      *
+     * @stability stable
      * @category constructors
      * @since 2.0.0
      */
@@ -918,6 +946,7 @@ export declare const succeed: {
  *
  * @see {@link succeed} for providing a single service from a value
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -942,6 +971,7 @@ export declare const succeedContext: <A>(context: Context.Context<A>) => Layer<A
  *
  * @see {@link effectDiscard} for running an effect while providing no services
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -977,6 +1007,7 @@ export declare const empty: Layer<never>;
  *
  * @see {@link succeed} for constructing layers from static values
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1012,6 +1043,7 @@ export declare const sync: {
      *
      * @see {@link succeed} for constructing layers from static values
      *
+     * @stability stable
      * @category constructors
      * @since 2.0.0
      */
@@ -1047,6 +1079,7 @@ export declare const sync: {
      *
      * @see {@link succeed} for constructing layers from static values
      *
+     * @stability stable
      * @category constructors
      * @since 2.0.0
      */
@@ -1086,6 +1119,7 @@ export declare const sync: {
  * @see {@link sync} for lazily providing a single service
  * @see {@link succeedContext} for providing an already available context
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1125,6 +1159,7 @@ export declare const syncContext: <A>(evaluate: LazyArg<Context.Context<A>>) =>
  * @see {@link effectContext} for effectfully providing multiple services
  * @see {@link effectDiscard} for running construction work without providing services
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1164,6 +1199,7 @@ export declare const effect: {
      * @see {@link effectContext} for effectfully providing multiple services
      * @see {@link effectDiscard} for running construction work without providing services
      *
+     * @stability stable
      * @category constructors
      * @since 2.0.0
      */
@@ -1203,6 +1239,7 @@ export declare const effect: {
      * @see {@link effectContext} for effectfully providing multiple services
      * @see {@link effectDiscard} for running construction work without providing services
      *
+     * @stability stable
      * @category constructors
      * @since 2.0.0
      */
@@ -1243,6 +1280,7 @@ export declare const effect: {
  *
  * @see {@link effect} for effectfully providing a single service
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1273,6 +1311,7 @@ export declare const effectContext: <A, E, R>(effect: Effect<Context.Context<A>,
  *
  * @see {@link empty} for a no-op layer that performs no construction work
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1302,6 +1341,7 @@ export declare const effectDiscard: <X, E, R>(effect: Effect<X, E, R>) => Layer<
  * Effect.runSync(Effect.provide(Config, layer)) // => "https://api.example.com"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1337,6 +1377,7 @@ export declare const suspend: <A, E, R>(evaluate: LazyArg<Layer<A, E, R>>) => La
  * Effect.runSync(Effect.provide(program, unwrappedLayer)) // => "result"
  * ```
  *
+ * @stability stable
  * @category converting
  * @since 4.0.0
  */
@@ -1386,6 +1427,7 @@ export declare const unwrap: <A, E1, R1, E, R>(self: Effect<Layer<A, E1, R1>, E,
  *
  * @see {@link merge} for merging one layer with another layer or array
  *
+ * @stability stable
  * @category zipping
  * @since 2.0.0
  */
@@ -1432,6 +1474,7 @@ export declare const mergeAll: <Layers extends [Layer<never, any, any>, ...Array
  *
  * @see {@link mergeAll} for merging several layers at once
  *
+ * @stability stable
  * @category zipping
  * @since 2.0.0
  */
@@ -1478,6 +1521,7 @@ export declare const merge: {
      *
      * @see {@link mergeAll} for merging several layers at once
      *
+     * @stability stable
      * @category zipping
      * @since 2.0.0
      */
@@ -1524,6 +1568,7 @@ export declare const merge: {
      *
      * @see {@link mergeAll} for merging several layers at once
      *
+     * @stability stable
      * @category zipping
      * @since 2.0.0
      */
@@ -1570,6 +1615,7 @@ export declare const merge: {
      *
      * @see {@link mergeAll} for merging several layers at once
      *
+     * @stability stable
      * @category zipping
      * @since 2.0.0
      */
@@ -1616,6 +1662,7 @@ export declare const merge: {
      *
      * @see {@link mergeAll} for merging several layers at once
      *
+     * @stability stable
      * @category zipping
      * @since 2.0.0
      */
@@ -1698,6 +1745,7 @@ export declare const merge: {
  *
  * @see {@link provideMerge} for retaining the dependency services
  *
+ * @stability stable
  * @category providing services
  * @since 2.0.0
  */
@@ -1779,6 +1827,7 @@ export declare const provide: {
      *
      * @see {@link provideMerge} for retaining the dependency services
      *
+     * @stability stable
      * @category providing services
      * @since 2.0.0
      */
@@ -1860,6 +1909,7 @@ export declare const provide: {
      *
      * @see {@link provideMerge} for retaining the dependency services
      *
+     * @stability stable
      * @category providing services
      * @since 2.0.0
      */
@@ -1941,6 +1991,7 @@ export declare const provide: {
      *
      * @see {@link provideMerge} for retaining the dependency services
      *
+     * @stability stable
      * @category providing services
      * @since 2.0.0
      */
@@ -2022,6 +2073,7 @@ export declare const provide: {
      *
      * @see {@link provideMerge} for retaining the dependency services
      *
+     * @stability stable
      * @category providing services
      * @since 2.0.0
      */
@@ -2110,6 +2162,7 @@ export declare const provide: {
  *
  * @see {@link provide} for keeping dependency services private
  *
+ * @stability stable
  * @category providing services
  * @since 2.0.0
  */
@@ -2197,6 +2250,7 @@ export declare const provideMerge: {
      *
      * @see {@link provide} for keeping dependency services private
      *
+     * @stability stable
      * @category providing services
      * @since 2.0.0
      */
@@ -2284,6 +2338,7 @@ export declare const provideMerge: {
      *
      * @see {@link provide} for keeping dependency services private
      *
+     * @stability stable
      * @category providing services
      * @since 2.0.0
      */
@@ -2371,6 +2426,7 @@ export declare const provideMerge: {
      *
      * @see {@link provide} for keeping dependency services private
      *
+     * @stability stable
      * @category providing services
      * @since 2.0.0
      */
@@ -2458,6 +2514,7 @@ export declare const provideMerge: {
      *
      * @see {@link provide} for keeping dependency services private
      *
+     * @stability stable
      * @category providing services
      * @since 2.0.0
      */
@@ -2535,6 +2592,7 @@ export declare const provideMerge: {
  * logs // => ["[DEBUG] Starting database query"]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -2611,6 +2669,7 @@ export declare const flatMap: {
      * logs // => ["[DEBUG] Starting database query"]
      * ```
      *
+     * @stability stable
      * @category sequencing
      * @since 2.0.0
      */
@@ -2687,6 +2746,7 @@ export declare const flatMap: {
      * logs // => ["[DEBUG] Starting database query"]
      * ```
      *
+     * @stability stable
      * @category sequencing
      * @since 2.0.0
      */
@@ -2709,6 +2769,7 @@ export declare const flatMap: {
  * @see {@link tapError} for running an effect when layer construction fails with a typed error
  * @see {@link tapCause} for running an effect when layer construction fails with any cause
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -2730,6 +2791,7 @@ export declare const tap: {
      * @see {@link tapError} for running an effect when layer construction fails with a typed error
      * @see {@link tapCause} for running an effect when layer construction fails with any cause
      *
+     * @stability stable
      * @category sequencing
      * @since 2.0.0
      */
@@ -2751,6 +2813,7 @@ export declare const tap: {
      * @see {@link tapError} for running an effect when layer construction fails with a typed error
      * @see {@link tapCause} for running an effect when layer construction fails with any cause
      *
+     * @stability stable
      * @category sequencing
      * @since 2.0.0
      */
@@ -2773,6 +2836,7 @@ export declare const tap: {
  * @see {@link tap} for running an effect when layer construction succeeds
  * @see {@link tapCause} for inspecting the full failure cause, including defects and interruption
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -2794,6 +2858,7 @@ export declare const tapError: {
      * @see {@link tap} for running an effect when layer construction succeeds
      * @see {@link tapCause} for inspecting the full failure cause, including defects and interruption
      *
+     * @stability stable
      * @category sequencing
      * @since 2.0.0
      */
@@ -2815,6 +2880,7 @@ export declare const tapError: {
      * @see {@link tap} for running an effect when layer construction succeeds
      * @see {@link tapCause} for inspecting the full failure cause, including defects and interruption
      *
+     * @stability stable
      * @category sequencing
      * @since 2.0.0
      */
@@ -2836,6 +2902,7 @@ export declare const tapError: {
      * @see {@link tap} for running an effect when layer construction succeeds
      * @see {@link tapCause} for inspecting the full failure cause, including defects and interruption
      *
+     * @stability stable
      * @category sequencing
      * @since 2.0.0
      */
@@ -2859,6 +2926,7 @@ export declare const tapError: {
  * @see {@link tapError} for observing only typed layer construction errors
  * @see {@link catchCause} for recovering from a layer construction failure by switching to another layer
  *
+ * @stability stable
  * @category sequencing
  * @since 4.0.0
  */
@@ -2881,6 +2949,7 @@ export declare const tapCause: {
      * @see {@link tapError} for observing only typed layer construction errors
      * @see {@link catchCause} for recovering from a layer construction failure by switching to another layer
      *
+     * @stability stable
      * @category sequencing
      * @since 4.0.0
      */
@@ -2903,6 +2972,7 @@ export declare const tapCause: {
      * @see {@link tapError} for observing only typed layer construction errors
      * @see {@link catchCause} for recovering from a layer construction failure by switching to another layer
      *
+     * @stability stable
      * @category sequencing
      * @since 4.0.0
      */
@@ -2925,6 +2995,7 @@ export declare const tapCause: {
      * @see {@link tapError} for observing only typed layer construction errors
      * @see {@link catchCause} for recovering from a layer construction failure by switching to another layer
      *
+     * @stability stable
      * @category sequencing
      * @since 4.0.0
      */
@@ -2973,6 +3044,7 @@ export declare const tapCause: {
  * Effect.runSync(Effect.exit(program)) // => Exit.die(error)
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -2993,6 +3065,7 @@ export {
  * @see {@link catchTag} for recovering from specific tagged errors
  * @see {@link catchCause} for recovering with access to the full cause
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -3028,6 +3101,7 @@ catch_ as catch };
  *
  * @see {@link catchCause} for recovering with access to the full cause
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -3063,6 +3137,7 @@ export declare const catchTag: {
      *
      * @see {@link catchCause} for recovering with access to the full cause
      *
+     * @stability stable
      * @category error handling
      * @since 4.0.0
      */
@@ -3098,6 +3173,7 @@ export declare const catchTag: {
      *
      * @see {@link catchCause} for recovering with access to the full cause
      *
+     * @stability stable
      * @category error handling
      * @since 4.0.0
      */
@@ -3155,6 +3231,7 @@ export declare const catchTag: {
  *
  * @see {@link catchTag} for recovering from specific tagged errors
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -3211,6 +3288,7 @@ export declare const catchCause: {
      *
      * @see {@link catchTag} for recovering from specific tagged errors
      *
+     * @stability stable
      * @category error handling
      * @since 4.0.0
      */
@@ -3267,6 +3345,7 @@ export declare const catchCause: {
      *
      * @see {@link catchTag} for recovering from specific tagged errors
      *
+     * @stability stable
      * @category error handling
      * @since 4.0.0
      */
@@ -3287,6 +3366,7 @@ export declare const catchCause: {
  * transformation function `f`, and replaces the old service with the
  * transformed one.
  *
+ * @stability stable
  * @category providing services
  * @since 3.13.0
  */
@@ -3306,6 +3386,7 @@ export declare const updateService: {
      * transformation function `f`, and replaces the old service with the
      * transformed one.
      *
+     * @stability stable
      * @category providing services
      * @since 3.13.0
      */
@@ -3325,6 +3406,7 @@ export declare const updateService: {
      * transformation function `f`, and replaces the old service with the
      * transformed one.
      *
+     * @stability stable
      * @category providing services
      * @since 3.13.0
      */
@@ -3405,6 +3487,7 @@ export declare const updateService: {
  * await Effect.runPromise(program) // => { shared: true, fresh: false }
  * ```
  *
+ * @stability stable
  * @category layers
  * @since 2.0.0
  */
@@ -3450,6 +3533,7 @@ export declare const fresh: <A, E, R>(self: Layer<A, E, R>) => Layer<A, E, R>;
  * await Effect.runPromise(program) // => ["Starting HTTP server..."]
  * ```
  *
+ * @stability stable
  * @category converting
  * @since 2.0.0
  */
@@ -3471,6 +3555,7 @@ export declare const launch: <RIn, E, ROut>(self: Layer<ROut, E, RIn>) => Effect
  *
  * @see {@link mock} for creating a mock layer from a partial service implementation
  *
+ * @stability stable
  * @category testing
  * @since 3.17.0
  */
@@ -3534,6 +3619,7 @@ type AnyEffectOrStream = Effect<any, any, any> | Stream.Stream<any, any, any> |
  * Effect.runSync(testProgram) // => "Test User"
  * ```
  *
+ * @stability stable
  * @category testing
  * @since 3.17.0
  */
@@ -3592,6 +3678,7 @@ export declare const mock: {
      * Effect.runSync(testProgram) // => "Test User"
      * ```
      *
+     * @stability stable
      * @category testing
      * @since 3.17.0
      */
@@ -3650,6 +3737,7 @@ export declare const mock: {
      * Effect.runSync(testProgram) // => "Test User"
      * ```
      *
+     * @stability stable
      * @category testing
      * @since 3.17.0
      */
@@ -3678,6 +3766,7 @@ export declare const mock: {
  * const validLayer = satisfiesNumber(numberLayer)
  * ```
  *
+ * @stability stable
  * @category utility types
  * @since 4.0.0
  */
@@ -3704,6 +3793,7 @@ export declare const satisfiesSuccessType: <ROut>() => <ROut2 extends ROut, E, R
  * const validLayer = satisfiesError(typeErrorLayer)
  * ```
  *
+ * @stability stable
  * @category utility types
  * @since 4.0.0
  */
@@ -3731,6 +3821,7 @@ export declare const satisfiesErrorType: <E>() => <ROut, E2 extends E, RIn>(laye
  * const validLayer = satisfiesNumber(numberLayer)
  * ```
  *
+ * @stability stable
  * @category utility types
  * @since 4.0.0
  */
@@ -3753,6 +3844,7 @@ export declare const satisfiesServicesType: <RIn>() => <ROut, E, RIn2 extends RI
  * @see {@link span} for creating a layer span
  * @see {@link withSpan} for wrapping layer construction in a span
  *
+ * @stability stable
  * @category options
  * @since 4.0.0
  */
@@ -3810,6 +3902,7 @@ export interface SpanOptions extends Tracer.SpanOptions {
  * logs // => ["Connecting to database", "Database connected", "database-init", "Span database-init ended with: Success"]
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -3853,6 +3946,7 @@ export declare const span: (name: string, options?: SpanOptions) => Layer<Tracer
  * Effect.runSync(Effect.provide(program, databaseLayer)) // => { spanId: "42", result: "Result: SELECT 1" }
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -3914,6 +4008,7 @@ export declare const parentSpan: (span: Tracer.AnySpan) => Layer<Tracer.ParentSp
  * logs // => ["Application ready", "Application initialization completed: Success"]
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -3975,6 +4070,7 @@ export declare const withSpan: {
      * logs // => ["Application ready", "Application initialization completed: Success"]
      * ```
      *
+     * @stability stable
      * @category tracing
      * @since 2.0.0
      */
@@ -4036,6 +4132,7 @@ export declare const withSpan: {
      * logs // => ["Application ready", "Application initialization completed: Success"]
      * ```
      *
+     * @stability stable
      * @category tracing
      * @since 2.0.0
      */
@@ -4104,6 +4201,7 @@ export declare const withSpan: {
  * Effect.runSync(Effect.scoped(program)) // => { dbResult: "DB: SELECT * FROM users", cacheResult: "Cache: user:123" }
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -4171,6 +4269,7 @@ export declare const withParentSpan: {
      * Effect.runSync(Effect.scoped(program)) // => { dbResult: "DB: SELECT * FROM users", cacheResult: "Cache: user:123" }
      * ```
      *
+     * @stability stable
      * @category tracing
      * @since 2.0.0
      */
@@ -4238,6 +4337,7 @@ export declare const withParentSpan: {
      * Effect.runSync(Effect.scoped(program)) // => { dbResult: "DB: SELECT * FROM users", cacheResult: "Cache: user:123" }
      * ```
      *
+     * @stability stable
      * @category tracing
      * @since 2.0.0
      */