effect 4.0.1 → 4.0.2

package/src/Layer.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 { NonEmptyArray, NonEmptyReadonlyArray } from "./Array.ts"
@@ -48,6 +49,7 @@ 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
  */
@@ -68,6 +70,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
  */
@@ -84,6 +87,7 @@ export interface LayerUnify<A extends { [Unify.typeSymbol]?: any }> {
  * Type-level marker used by `Unify` for `Layer` types that should be ignored
  * during unification.
  *
+ * @stability stable
  * @category models
  * @since 4.0.0
  */
@@ -92,6 +96,7 @@ export interface LayerUnifyIgnore {}
 /**
  * The variance interface for Layer type parameters.
  *
+ * @stability stable
  * @category models
  * @since 2.0.0
  */
@@ -121,6 +126,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
  */
@@ -142,6 +148,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
  */
@@ -159,6 +166,7 @@ export type Services<T extends Any> = T extends infer L
  * @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
  */
@@ -174,6 +182,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
  */
@@ -216,6 +225,7 @@ const MemoMapTypeId = "~effect/Layer/MemoMap"
  * Effect.runSync(database.query("SELECT 1")) // => "result"
  * ```
  *
+ * @stability stable
  * @category models
  * @since 2.0.0
  */
@@ -285,6 +295,7 @@ const memoMapObserve = (entry: MemoMapEntry, scope: Scope.Scope): boolean => {
  * Layer.isLayer(notALayer) // => false
  * ```
  *
+ * @stability stable
  * @category guards
  * @since 2.0.0
  */
@@ -342,6 +353,7 @@ const fromBuildUnsafe = <ROut, E, RIn>(
  * Effect.runSync(Effect.provide(program, databaseLayer)) // => "result"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -389,6 +401,7 @@ export const fromBuild = <ROut, E, RIn>(
  * Effect.runSync(Effect.provide(program, databaseLayer)) // => "result"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -484,6 +497,7 @@ class MemoMapImpl implements MemoMap {
  * Effect.runSync(database.query("SELECT 1")) // => "result"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -503,6 +517,7 @@ export const makeMemoMapUnsafe = (): MemoMap => new MemoMapImpl()
  * @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
  */
@@ -537,6 +552,7 @@ export const forkMemoMapUnsafe = (parent: MemoMap): MemoMap => new MemoMapImpl(p
  * Effect.runSync(database.query("SELECT 1")) // => "result"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -556,6 +572,7 @@ export const makeMemoMap: Effect<MemoMap> = internalEffect.sync(makeMemoMapUnsaf
  * @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
  */
@@ -576,6 +593,7 @@ export const forkMemoMap = (parent: MemoMap): Effect<MemoMap> => internalEffect.
  *
  * @see {@link MemoMap} the memoization map type wrapped by this service
  *
+ * @stability stable
  * @category services
  * @since 3.13.0
  */
@@ -637,6 +655,7 @@ export class CurrentMemoMap extends Context.Service<CurrentMemoMap, MemoMap>()("
  * logs // => ["ready"]
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 2.0.0
  */
@@ -692,6 +711,7 @@ export const buildWithMemoMap: {
    * logs // => ["ready"]
    * ```
    *
+   * @stability stable
    * @category destructors
    * @since 2.0.0
    */
@@ -747,6 +767,7 @@ export const buildWithMemoMap: {
    * logs // => ["ready"]
    * ```
    *
+   * @stability stable
    * @category destructors
    * @since 2.0.0
    */
@@ -757,7 +778,7 @@ export const buildWithMemoMap: {
   scope: Scope.Scope
 ): Effect<Context.Context<ROut>, E, RIn> =>
   internalEffect.provideService(
-    internalEffect.map(self.build(memoMap, scope), Context.add(CurrentMemoMap, memoMap)),
+    internalEffect.map(internalEffect.suspend(() => self.build(memoMap, scope)), Context.add(CurrentMemoMap, memoMap)),
     CurrentMemoMap,
     memoMap
   ))
@@ -792,6 +813,7 @@ export const buildWithMemoMap: {
  * Effect.runSync(Effect.scoped(program)) // => "result"
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 2.0.0
  */
@@ -855,6 +877,7 @@ export const build = <RIn, E, ROut>(
  * logs // => ["Initializing database...", "Database closed"]
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 2.0.0
  */
@@ -908,6 +931,7 @@ export const buildWithScope: {
    * logs // => ["Initializing database...", "Database closed"]
    * ```
    *
+   * @stability stable
    * @category destructors
    * @since 2.0.0
    */
@@ -961,6 +985,7 @@ export const buildWithScope: {
    * logs // => ["Initializing database...", "Database closed"]
    * ```
    *
+   * @stability stable
    * @category destructors
    * @since 2.0.0
    */
@@ -1004,6 +1029,7 @@ export const buildWithScope: {
  *
  * @see {@link sync} for constructing layers from lazy values
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1035,6 +1061,7 @@ export const succeed: {
    *
    * @see {@link sync} for constructing layers from lazy values
    *
+   * @stability stable
    * @category constructors
    * @since 2.0.0
    */
@@ -1066,6 +1093,7 @@ export const succeed: {
    *
    * @see {@link sync} for constructing layers from lazy values
    *
+   * @stability stable
    * @category constructors
    * @since 2.0.0
    */
@@ -1121,6 +1149,7 @@ export const succeed: {
  *
  * @see {@link succeed} for providing a single service from a value
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1147,6 +1176,7 @@ export 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
  */
@@ -1183,6 +1213,7 @@ export const empty: Layer<never> = succeedContext(Context.empty())
  *
  * @see {@link succeed} for constructing layers from static values
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1218,6 +1249,7 @@ export const sync: {
    *
    * @see {@link succeed} for constructing layers from static values
    *
+   * @stability stable
    * @category constructors
    * @since 2.0.0
    */
@@ -1253,6 +1285,7 @@ export const sync: {
    *
    * @see {@link succeed} for constructing layers from static values
    *
+   * @stability stable
    * @category constructors
    * @since 2.0.0
    */
@@ -1298,6 +1331,7 @@ export 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
  */
@@ -1339,6 +1373,7 @@ export const syncContext = <A>(evaluate: LazyArg<Context.Context<A>>): Layer<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
  */
@@ -1378,6 +1413,7 @@ export 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
    */
@@ -1419,6 +1455,7 @@ export 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
    */
@@ -1471,6 +1508,7 @@ const effectImpl = <I, S, E, R>(
  *
  * @see {@link effect} for effectfully providing a single service
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1504,6 +1542,7 @@ export const effectContext = <A, E, R>(
  *
  * @see {@link empty} for a no-op layer that performs no construction work
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1535,6 +1574,7 @@ export const effectDiscard = <X, E, R>(effect: Effect<X, E, R>): Layer<never, E,
  * Effect.runSync(Effect.provide(Config, layer)) // => "https://api.example.com"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1574,6 +1614,7 @@ const unwrapKey = Context.Service<Layer<any, any, any>>("effect/Layer/unwrap")
  * Effect.runSync(Effect.provide(program, unwrappedLayer)) // => "result"
  * ```
  *
+ * @stability stable
  * @category converting
  * @since 4.0.0
  */
@@ -1643,6 +1684,7 @@ const mergeAllEffect = <Layers extends [Layer<never, any, any>, ...Array<Layer<n
  *
  * @see {@link merge} for merging one layer with another layer or array
  *
+ * @stability stable
  * @category zipping
  * @since 2.0.0
  */
@@ -1696,6 +1738,7 @@ export const mergeAll = <Layers extends [Layer<never, any, any>, ...Array<Layer<
  *
  * @see {@link mergeAll} for merging several layers at once
  *
+ * @stability stable
  * @category zipping
  * @since 2.0.0
  */
@@ -1742,6 +1785,7 @@ export const merge: {
    *
    * @see {@link mergeAll} for merging several layers at once
    *
+   * @stability stable
    * @category zipping
    * @since 2.0.0
    */
@@ -1788,6 +1832,7 @@ export const merge: {
    *
    * @see {@link mergeAll} for merging several layers at once
    *
+   * @stability stable
    * @category zipping
    * @since 2.0.0
    */
@@ -1841,6 +1886,7 @@ export const merge: {
    *
    * @see {@link mergeAll} for merging several layers at once
    *
+   * @stability stable
    * @category zipping
    * @since 2.0.0
    */
@@ -1887,6 +1933,7 @@ export const merge: {
    *
    * @see {@link mergeAll} for merging several layers at once
    *
+   * @stability stable
    * @category zipping
    * @since 2.0.0
    */
@@ -1999,6 +2046,7 @@ const provideWith = (
  *
  * @see {@link provideMerge} for retaining the dependency services
  *
+ * @stability stable
  * @category providing services
  * @since 2.0.0
  */
@@ -2080,6 +2128,7 @@ export const provide: {
    *
    * @see {@link provideMerge} for retaining the dependency services
    *
+   * @stability stable
    * @category providing services
    * @since 2.0.0
    */
@@ -2161,6 +2210,7 @@ export const provide: {
    *
    * @see {@link provideMerge} for retaining the dependency services
    *
+   * @stability stable
    * @category providing services
    * @since 2.0.0
    */
@@ -2249,6 +2299,7 @@ export const provide: {
    *
    * @see {@link provideMerge} for retaining the dependency services
    *
+   * @stability stable
    * @category providing services
    * @since 2.0.0
    */
@@ -2330,6 +2381,7 @@ export const provide: {
    *
    * @see {@link provideMerge} for retaining the dependency services
    *
+   * @stability stable
    * @category providing services
    * @since 2.0.0
    */
@@ -2427,6 +2479,7 @@ export const provide: {
  *
  * @see {@link provide} for keeping dependency services private
  *
+ * @stability stable
  * @category providing services
  * @since 2.0.0
  */
@@ -2514,6 +2567,7 @@ export const provideMerge: {
    *
    * @see {@link provide} for keeping dependency services private
    *
+   * @stability stable
    * @category providing services
    * @since 2.0.0
    */
@@ -2601,6 +2655,7 @@ export const provideMerge: {
    *
    * @see {@link provide} for keeping dependency services private
    *
+   * @stability stable
    * @category providing services
    * @since 2.0.0
    */
@@ -2695,6 +2750,7 @@ export const provideMerge: {
    *
    * @see {@link provide} for keeping dependency services private
    *
+   * @stability stable
    * @category providing services
    * @since 2.0.0
    */
@@ -2782,6 +2838,7 @@ export const provideMerge: {
    *
    * @see {@link provide} for keeping dependency services private
    *
+   * @stability stable
    * @category providing services
    * @since 2.0.0
    */
@@ -2873,6 +2930,7 @@ export const provideMerge: {
  * logs // => ["[DEBUG] Starting database query"]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -2949,6 +3007,7 @@ export const flatMap: {
    * logs // => ["[DEBUG] Starting database query"]
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 2.0.0
    */
@@ -3025,6 +3084,7 @@ export const flatMap: {
    * logs // => ["[DEBUG] Starting database query"]
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 2.0.0
    */
@@ -3060,6 +3120,7 @@ export 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
  */
@@ -3081,6 +3142,7 @@ export 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
    */
@@ -3102,6 +3164,7 @@ export 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
    */
@@ -3137,6 +3200,7 @@ export 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
  */
@@ -3158,6 +3222,7 @@ export 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
    */
@@ -3179,6 +3244,7 @@ export 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
    */
@@ -3200,6 +3266,7 @@ export 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
    */
@@ -3233,6 +3300,7 @@ export 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
  */
@@ -3255,6 +3323,7 @@ export 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
    */
@@ -3277,6 +3346,7 @@ export 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
    */
@@ -3299,6 +3369,7 @@ export 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
    */
@@ -3360,6 +3431,7 @@ export const tapCause: {
  * Effect.runSync(Effect.exit(program)) // => Exit.die(error)
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -3397,6 +3469,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
    */
@@ -3434,6 +3507,7 @@ export {
  *
  * @see {@link catchCause} for recovering with access to the full cause
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -3469,6 +3543,7 @@ export const catchTag: {
    *
    * @see {@link catchCause} for recovering with access to the full cause
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -3515,6 +3590,7 @@ export const catchTag: {
    *
    * @see {@link catchCause} for recovering with access to the full cause
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -3608,6 +3684,7 @@ export const catchTag: {
  *
  * @see {@link catchTag} for recovering from specific tagged errors
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -3664,6 +3741,7 @@ export const catchCause: {
    *
    * @see {@link catchTag} for recovering from specific tagged errors
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -3720,6 +3798,7 @@ export const catchCause: {
    *
    * @see {@link catchTag} for recovering from specific tagged errors
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -3753,6 +3832,7 @@ export const catchCause: {
  * transformation function `f`, and replaces the old service with the
  * transformed one.
  *
+ * @stability stable
  * @category providing services
  * @since 3.13.0
  */
@@ -3772,6 +3852,7 @@ export const updateService: {
    * transformation function `f`, and replaces the old service with the
    * transformed one.
    *
+   * @stability stable
    * @category providing services
    * @since 3.13.0
    */
@@ -3791,6 +3872,7 @@ export const updateService: {
    * transformation function `f`, and replaces the old service with the
    * transformed one.
    *
+   * @stability stable
    * @category providing services
    * @since 3.13.0
    */
@@ -3883,6 +3965,7 @@ export const updateService: {
  * await Effect.runPromise(program) // => { shared: true, fresh: false }
  * ```
  *
+ * @stability stable
  * @category layers
  * @since 2.0.0
  */
@@ -3930,6 +4013,7 @@ export 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
  */
@@ -3953,6 +4037,7 @@ export const launch = <RIn, E, ROut>(self: Layer<ROut, E, RIn>): Effect<never, E
  *
  * @see {@link mock} for creating a mock layer from a partial service implementation
  *
+ * @stability stable
  * @category testing
  * @since 3.17.0
  */
@@ -4027,6 +4112,7 @@ type AnyEffectOrStream =
  * Effect.runSync(testProgram) // => "Test User"
  * ```
  *
+ * @stability stable
  * @category testing
  * @since 3.17.0
  */
@@ -4085,6 +4171,7 @@ export const mock: {
    * Effect.runSync(testProgram) // => "Test User"
    * ```
    *
+   * @stability stable
    * @category testing
    * @since 3.17.0
    */
@@ -4143,6 +4230,7 @@ export const mock: {
    * Effect.runSync(testProgram) // => "Test User"
    * ```
    *
+   * @stability stable
    * @category testing
    * @since 3.17.0
    */
@@ -4227,6 +4315,7 @@ const ChannelTypeId: Channel.TypeId = "~effect/Channel"
  * const validLayer = satisfiesNumber(numberLayer)
  * ```
  *
+ * @stability stable
  * @category utility types
  * @since 4.0.0
  */
@@ -4255,6 +4344,7 @@ export const satisfiesSuccessType =
  * const validLayer = satisfiesError(typeErrorLayer)
  * ```
  *
+ * @stability stable
  * @category utility types
  * @since 4.0.0
  */
@@ -4284,6 +4374,7 @@ export const satisfiesErrorType =
  * const validLayer = satisfiesNumber(numberLayer)
  * ```
  *
+ * @stability stable
  * @category utility types
  * @since 4.0.0
  */
@@ -4312,6 +4403,7 @@ export const satisfiesServicesType =
  * @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
  */
@@ -4372,6 +4464,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
  */
@@ -4430,6 +4523,7 @@ export const span = (
  * Effect.runSync(Effect.provide(program, databaseLayer)) // => { spanId: "42", result: "Result: SELECT 1" }
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -4493,6 +4587,7 @@ export const parentSpan = (span: Tracer.AnySpan): Layer<Tracer.ParentSpan> =>
  * logs // => ["Application ready", "Application initialization completed: Success"]
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -4554,6 +4649,7 @@ export const withSpan: {
    * logs // => ["Application ready", "Application initialization completed: Success"]
    * ```
    *
+   * @stability stable
    * @category tracing
    * @since 2.0.0
    */
@@ -4617,6 +4713,7 @@ export const withSpan: {
    * logs // => ["Application ready", "Application initialization completed: Success"]
    * ```
    *
+   * @stability stable
    * @category tracing
    * @since 2.0.0
    */
@@ -4716,6 +4813,7 @@ export const withSpan: {
  * Effect.runSync(Effect.scoped(program)) // => { dbResult: "DB: SELECT * FROM users", cacheResult: "Cache: user:123" }
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -4783,6 +4881,7 @@ export const withParentSpan: {
    * Effect.runSync(Effect.scoped(program)) // => { dbResult: "DB: SELECT * FROM users", cacheResult: "Cache: user:123" }
    * ```
    *
+   * @stability stable
    * @category tracing
    * @since 2.0.0
    */
@@ -4852,6 +4951,7 @@ export const withParentSpan: {
    * Effect.runSync(Effect.scoped(program)) // => { dbResult: "DB: SELECT * FROM users", cacheResult: "Cache: user:123" }
    * ```
    *
+   * @stability stable
    * @category tracing
    * @since 2.0.0
    */