effect 4.0.0-beta.69 → 4.0.0-beta.70

package/dist/Ref.d.ts

@@ -38,9 +38,10 @@ declare const TypeId = "~effect/Ref";
 /**
  * A mutable reference that provides atomic read, write, and update operations.
  *
- * Ref is a thread-safe mutable reference type that allows for atomic operations
- * on shared state. It supports both simple read/write operations and complex
- * atomic transformations.
+ * **Details**
+ *
+ * A `Ref` is a thread-safe mutable reference type for shared state. It supports
+ * simple read and write operations as well as atomic transformations.
  *
  * **Example** (Reading and updating a ref)
  *
@@ -107,8 +108,14 @@ export declare namespace Ref {
 /**
  * Creates a new Ref with the specified initial value (unsafe version).
  *
- * This function creates a Ref synchronously without wrapping in Effect.
- * Use this only when you're sure about the safety of immediate creation.
+ * **When to use**
+ *
+ * Use this when you need immediate synchronous construction and can guarantee
+ * that creating the `Ref` outside of `Effect` is safe.
+ *
+ * **Gotchas**
+ *
+ * Prefer `Ref.make` for Effect-wrapped creation in Effect programs.
  *
  * **Example** (Creating a ref unsafely)
  *
@@ -197,9 +204,7 @@ export declare const get: <A>(self: Ref<A>) => Effect.Effect<A, never, never>;
  */
 export declare const set: (<A>(value: A) => (self: Ref<A>) => Effect.Effect<void>) & (<A>(self: Ref<A>, value: A) => Effect.Effect<void>);
 /**
- * Atomically gets the current value of the Ref and sets it to the specified value.
- *
- * Returns the value that was in the Ref before the update.
+ * Atomically gets the current value of the Ref, sets it to the specified value, and returns the previous value.
  *
  * **Example** (Replacing a value atomically)
  *
@@ -223,9 +228,7 @@ export declare const set: (<A>(value: A) => (self: Ref<A>) => Effect.Effect<void
  */
 export declare const getAndSet: (<A>(value: A) => (self: Ref<A>) => Effect.Effect<A>) & (<A>(self: Ref<A>, value: A) => Effect.Effect<A>);
 /**
- * Atomically gets the current value of the Ref and updates it with the given function.
- *
- * Returns the value that was in the Ref before the update.
+ * Atomically gets the current value of the Ref, updates it with the given function, and returns the previous value.
  *
  * **Example** (Updating and returning the previous value)
  *
@@ -251,9 +254,11 @@ export declare const getAndUpdate: (<A>(f: (a: A) => A) => (self: Ref<A>) => Eff
 /**
  * Atomically gets the current value of the Ref and updates it with the given partial function.
  *
- * If the partial function returns `Option.some`, the Ref is updated with the new value.
- * If it returns `Option.none`, the Ref is left unchanged.
- * Always returns the value that was in the Ref before the attempted update.
+ * **Details**
+ *
+ * If the partial function returns `Option.some`, the Ref is updated with the
+ * new value. If it returns `Option.none`, the Ref is left unchanged. The effect
+ * always returns the value that was in the Ref before the attempted update.
  *
  * **Example** (Conditionally updating and returning the previous value)
  *
@@ -292,7 +297,10 @@ export declare const getAndUpdateSome: (<A>(pf: (a: A) => Option.Option<A>) => (
 /**
  * Atomically sets the value of the Ref to the specified value and returns the new value.
  *
- * This is useful when you want to set a value and immediately get it back in one atomic operation.
+ * **When to use**
+ *
+ * Use this when you want to set a value and immediately get it back in one
+ * atomic operation.
  *
  * **Example** (Setting and returning the new value)
  *
@@ -327,8 +335,11 @@ export declare const setAndGet: (<A>(value: A) => (self: Ref<A>) => Effect.Effec
 /**
  * Atomically modifies the value of the Ref using the given function.
  *
- * The function receives the current value and returns a tuple of [result, newValue].
- * The Ref is updated with the newValue and the result is returned.
+ * **Details**
+ *
+ * The function receives the current value and returns a tuple of
+ * `[result, newValue]`. The Ref is updated with `newValue`, and `result` is
+ * returned by the effect.
  *
  * **Example** (Modifying a value atomically)
  *
@@ -583,8 +594,10 @@ export declare const updateAndGet: (<A>(f: (a: A) => A) => (self: Ref<A>) => Eff
 /**
  * Atomically updates the value of the Ref using the given partial function.
  *
- * If the partial function returns `Option.some`, the Ref is updated with the new value.
- * If it returns `Option.none`, the Ref is left unchanged.
+ * **Details**
+ *
+ * If the partial function returns `Option.some`, the Ref is updated with the
+ * new value. If it returns `Option.none`, the Ref is left unchanged.
  *
  * **Example** (Conditionally updating a value)
  *
@@ -622,9 +635,11 @@ export declare const updateSome: (<A>(f: (a: A) => Option.Option<A>) => (self: R
 /**
  * Atomically updates the value of the Ref using the given partial function and returns the current value.
  *
- * If the partial function returns `Option.some`, the Ref is updated with the new value.
- * If it returns `Option.none`, the Ref is left unchanged.
- * Returns the current value of the Ref after the potential update.
+ * **Details**
+ *
+ * If the partial function returns `Option.some`, the Ref is updated with the
+ * new value. If it returns `Option.none`, the Ref is left unchanged. The effect
+ * returns the current value of the Ref after the potential update.
  *
  * **Example** (Conditionally updating and returning the current value)
  *
@@ -657,8 +672,14 @@ export declare const updateSomeAndGet: (<A>(pf: (a: A) => Option.Option<A>) => (
 /**
  * Gets the current value of the Ref synchronously (unsafe version).
  *
- * This function reads the current value without wrapping in Effect.
- * Use this only when you're sure about the safety of immediate access.
+ * **When to use**
+ *
+ * Use this when you need immediate synchronous access and can guarantee that
+ * reading the `Ref` outside of `Effect` is safe.
+ *
+ * **Gotchas**
+ *
+ * Prefer `Ref.get` for Effect-wrapped access in Effect programs.
  *
  * **Example** (Reading a ref unsafely)
  *

package/dist/Ref.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Ref.d.ts","sourceRoot":"","sources":["../src/Ref.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Ref.d.ts","sourceRoot":"","sources":["../src/Ref.ts"],"names":[],"mappings":"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"}

package/dist/Ref.js

@@ -49,8 +49,14 @@ const RefProto = {
 /**
  * Creates a new Ref with the specified initial value (unsafe version).
  *
- * This function creates a Ref synchronously without wrapping in Effect.
- * Use this only when you're sure about the safety of immediate creation.
+ * **When to use**
+ *
+ * Use this when you need immediate synchronous construction and can guarantee
+ * that creating the `Ref` outside of `Effect` is safe.
+ *
+ * **Gotchas**
+ *
+ * Prefer `Ref.make` for Effect-wrapped creation in Effect programs.
  *
  * **Example** (Creating a ref unsafely)
  *
@@ -143,9 +149,7 @@ export const get = self => Effect.sync(() => self.ref.current);
  */
 export const set = /*#__PURE__*/dual(2, (self, value) => Effect.sync(() => MutableRef.set(self.ref, value)));
 /**
- * Atomically gets the current value of the Ref and sets it to the specified value.
- *
- * Returns the value that was in the Ref before the update.
+ * Atomically gets the current value of the Ref, sets it to the specified value, and returns the previous value.
  *
  * **Example** (Replacing a value atomically)
  *
@@ -173,9 +177,7 @@ export const getAndSet = /*#__PURE__*/dual(2, (self, value) => Effect.sync(() =>
   return current;
 }));
 /**
- * Atomically gets the current value of the Ref and updates it with the given function.
- *
- * Returns the value that was in the Ref before the update.
+ * Atomically gets the current value of the Ref, updates it with the given function, and returns the previous value.
  *
  * **Example** (Updating and returning the previous value)
  *
@@ -205,9 +207,11 @@ export const getAndUpdate = /*#__PURE__*/dual(2, (self, f) => Effect.sync(() =>
 /**
  * Atomically gets the current value of the Ref and updates it with the given partial function.
  *
- * If the partial function returns `Option.some`, the Ref is updated with the new value.
- * If it returns `Option.none`, the Ref is left unchanged.
- * Always returns the value that was in the Ref before the attempted update.
+ * **Details**
+ *
+ * If the partial function returns `Option.some`, the Ref is updated with the
+ * new value. If it returns `Option.none`, the Ref is left unchanged. The effect
+ * always returns the value that was in the Ref before the attempted update.
  *
  * **Example** (Conditionally updating and returning the previous value)
  *
@@ -253,7 +257,10 @@ export const getAndUpdateSome = /*#__PURE__*/dual(2, (self, pf) => Effect.sync((
 /**
  * Atomically sets the value of the Ref to the specified value and returns the new value.
  *
- * This is useful when you want to set a value and immediately get it back in one atomic operation.
+ * **When to use**
+ *
+ * Use this when you want to set a value and immediately get it back in one
+ * atomic operation.
  *
  * **Example** (Setting and returning the new value)
  *
@@ -288,8 +295,11 @@ export const setAndGet = /*#__PURE__*/dual(2, (self, value) => Effect.sync(() =>
 /**
  * Atomically modifies the value of the Ref using the given function.
  *
- * The function receives the current value and returns a tuple of [result, newValue].
- * The Ref is updated with the newValue and the result is returned.
+ * **Details**
+ *
+ * The function receives the current value and returns a tuple of
+ * `[result, newValue]`. The Ref is updated with `newValue`, and `result` is
+ * returned by the effect.
  *
  * **Example** (Modifying a value atomically)
  *
@@ -448,8 +458,10 @@ export const updateAndGet = /*#__PURE__*/dual(2, (self, f) => Effect.sync(() =>
 /**
  * Atomically updates the value of the Ref using the given partial function.
  *
- * If the partial function returns `Option.some`, the Ref is updated with the new value.
- * If it returns `Option.none`, the Ref is left unchanged.
+ * **Details**
+ *
+ * If the partial function returns `Option.some`, the Ref is updated with the
+ * new value. If it returns `Option.none`, the Ref is left unchanged.
  *
  * **Example** (Conditionally updating a value)
  *
@@ -492,9 +504,11 @@ export const updateSome = /*#__PURE__*/dual(2, (self, f) => Effect.sync(() => {
 /**
  * Atomically updates the value of the Ref using the given partial function and returns the current value.
  *
- * If the partial function returns `Option.some`, the Ref is updated with the new value.
- * If it returns `Option.none`, the Ref is left unchanged.
- * Returns the current value of the Ref after the potential update.
+ * **Details**
+ *
+ * If the partial function returns `Option.some`, the Ref is updated with the
+ * new value. If it returns `Option.none`, the Ref is left unchanged. The effect
+ * returns the current value of the Ref after the potential update.
  *
  * **Example** (Conditionally updating and returning the current value)
  *
@@ -533,8 +547,14 @@ export const updateSomeAndGet = /*#__PURE__*/dual(2, (self, pf) => Effect.sync((
 /**
  * Gets the current value of the Ref synchronously (unsafe version).
  *
- * This function reads the current value without wrapping in Effect.
- * Use this only when you're sure about the safety of immediate access.
+ * **When to use**
+ *
+ * Use this when you need immediate synchronous access and can guarantee that
+ * reading the `Ref` outside of `Effect` is safe.
+ *
+ * **Gotchas**
+ *
+ * Prefer `Ref.get` for Effect-wrapped access in Effect programs.
  *
  * **Example** (Reading a ref unsafely)
  *

package/dist/Ref.js.map

@@ -1 +1 @@
-{"version":3,"file":"Ref.js","names":["Effect","dual","identity","PipeInspectableProto","MutableRef","TypeId","RefProto","_A","toJSON","_id","ref","makeUnsafe","value","self","Object","create","make","sync","get","current","set","getAndSet","getAndUpdate","f","getAndUpdateSome","pf","option","_tag","setAndGet","modify","b","a","modifySome","update","updateAndGet","updateSome","updateSomeAndGet","getUnsafe"],"sources":["../src/Ref.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"Ref.js","names":["Effect","dual","identity","PipeInspectableProto","MutableRef","TypeId","RefProto","_A","toJSON","_id","ref","makeUnsafe","value","self","Object","create","make","sync","get","current","set","getAndSet","getAndUpdate","f","getAndUpdateSome","pf","option","_tag","setAndGet","modify","b","a","modifySome","update","updateAndGet","updateSome","updateSomeAndGet","getUnsafe"],"sources":["../src/Ref.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/References.d.ts

@@ -18,31 +18,43 @@ import { MaxOpsBeforeYield, PreventSchedulerYield } from "./Scheduler.ts";
 import { CurrentTraceLevel, DisablePropagation, MinimumTraceLevel, type SpanLink, Tracer } from "./Tracer.ts";
 export { 
 /**
+ * Reference for the current trace level used for dynamic trace filtering.
+ *
  * @category references
  * @since 4.0.0
  */
 CurrentTraceLevel, 
 /**
+ * Reference used to disable trace propagation in the current context.
+ *
  * @category references
  * @since 4.0.0
  */
 DisablePropagation, 
 /**
+ * Reference controlling the maximum operation budget before a fiber yields to the scheduler.
+ *
  * @category references
  * @since 4.0.0
  */
 MaxOpsBeforeYield, 
 /**
+ * Reference setting the minimum trace level threshold for span sampling.
+ *
  * @category references
  * @since 4.0.0
  */
 MinimumTraceLevel, 
 /**
+ * Reference controlling whether the runtime bypasses scheduler yield checks.
+ *
  * @category references
  * @since 4.0.0
  */
 PreventSchedulerYield, 
 /**
+ * Reference for the active tracer service used to create spans.
+ *
  * @category references
  * @since 4.0.0
  */
@@ -147,7 +159,8 @@ export declare const CurrentLogAnnotations: Context.Reference<ReadonlyRecord<str
  * Reference for the current log severity used by `Effect.log` when no explicit
  * level is provided.
  *
- * **Notes**
+ * **Details**
+ *
  * Use `MinimumLogLevel` to control which log entries are filtered out.
  *
  * **Example** (Changing the current log level)
@@ -255,6 +268,7 @@ export declare const CurrentLogSpans: Context.Reference<ReadonlyArray<[label: st
  * fiber.
  *
  * **Details**
+ *
  * Effect and Layer tracing use this reference to attach stack-frame information
  * to failures and interruption causes. It is normally managed by tracing APIs
  * rather than provided directly by application code.
@@ -529,6 +543,7 @@ export declare const UnhandledLogLevel: Context.Reference<Severity | undefined>;
  * A captured stack-frame node used to describe the traced execution path.
  *
  * **Details**
+ *
  * Each frame has a span or operation `name`, a lazy `stack` supplier, and an
  * optional `parent` frame that links it to the previous captured frame.
  *
@@ -545,6 +560,7 @@ export interface StackFrame {
  * operations.
  *
  * **Details**
+ *
  * Providing this reference changes which `Logger` instances receive log entries
  * in the current context.
  *
@@ -556,6 +572,7 @@ export declare const CurrentLoggers: Context.Reference<ReadonlySet<Logger<unknow
  * Reference controlling whether the default console logger writes to stderr.
  *
  * **Details**
+ *
  * When set to `true`, the pretty console logger uses `console.error`; otherwise
  * it uses `console.log`.
  *

package/dist/References.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"References.d.ts","sourceRoot":"","sources":["../src/References.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,KAAK,OAAO,MAAM,cAAc,CAAA;AAG5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AACzE,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,KAAK,QAAQ,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAE7G,OAAO;AACL;;;GAGG;AACH,iBAAiB;AACjB;;;GAGG;AACH,kBAAkB;AAClB;;;GAGG;AACH,iBAAiB;AACjB;;;GAGG;AACH,iBAAiB;AACjB;;;GAGG;AACH,qBAAqB;AACrB;;;GAGG;AACH,MAAM,EACP,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,eAAO,MAAM,kBAAkB,EAAE,OAAO,CAAC,SAAS,CAAC,MAAM,GAAG,WAAW,CAAiC,CAAA;AAExG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,eAAO,MAAM,qBAAqB,EAAE,OAAO,CAAC,SAAS,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CACnD,CAAA;AAElC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,eAAO,MAAM,eAAe,EAAE,OAAO,CAAC,SAAS,CAAC,QAAQ,CAA8B,CAAA;AAEtF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AACH,eAAO,MAAM,eAAe,EAAE,OAAO,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CACrE,CAAA;AAE5B;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB,EAAE,OAAO,CAAC,SAAS,CAAC,UAAU,GAAG,SAAS,CAAgC,CAAA;AAExG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,eAAO,MAAM,eAAe,EAAE,OAAO,CAAC,SAAS,CAAC,QAAQ,CAA8B,CAAA;AAEtF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,eAAO,MAAM,aAAa,EAAE,OAAO,CAAC,SAAS,CAAC,OAAO,CAA4B,CAAA;AAEjF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,eAAO,MAAM,qBAAqB,EAAE,OAAO,CAAC,SAAS,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CACnD,CAAA;AAElC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AACH,eAAO,MAAM,eAAe,EAAE,OAAO,CAAC,SAAS,CAAC,aAAa,CAAC,QAAQ,CAAC,CAA8B,CAAA;AAErG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,eAAO,MAAM,mBAAmB,EAAE,OAAO,CAAC,SAAS,CAAC,OAAO,CAAkC,CAAA;AAE7F;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,OAAO,CAAC,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAgC,CAAA;AAEtG;;;;;;;;;GASG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,MAAM,GAAG,SAAS,CAAA;IACxC,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,CAAA;CACxC;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,EAAE,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAiC,CAAA;AAEjH;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,OAAO,CAA8B,CAAA;AAEjF,OAAO;AACL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,SAAS,EACV,MAAM,gBAAgB,CAAA"}
+{"version":3,"file":"References.d.ts","sourceRoot":"","sources":["../src/References.ts"],"names":[],"mappings":"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"}

package/dist/References.js

@@ -4,31 +4,43 @@ import { MaxOpsBeforeYield, PreventSchedulerYield } from "./Scheduler.js";
 import { CurrentTraceLevel, DisablePropagation, MinimumTraceLevel, Tracer } from "./Tracer.js";
 export {
 /**
+ * Reference for the current trace level used for dynamic trace filtering.
+ *
  * @category references
  * @since 4.0.0
  */
 CurrentTraceLevel,
 /**
+ * Reference used to disable trace propagation in the current context.
+ *
  * @category references
  * @since 4.0.0
  */
 DisablePropagation,
 /**
+ * Reference controlling the maximum operation budget before a fiber yields to the scheduler.
+ *
  * @category references
  * @since 4.0.0
  */
 MaxOpsBeforeYield,
 /**
+ * Reference setting the minimum trace level threshold for span sampling.
+ *
  * @category references
  * @since 4.0.0
  */
 MinimumTraceLevel,
 /**
+ * Reference controlling whether the runtime bypasses scheduler yield checks.
+ *
  * @category references
  * @since 4.0.0
  */
 PreventSchedulerYield,
 /**
+ * Reference for the active tracer service used to create spans.
+ *
  * @category references
  * @since 4.0.0
  */
@@ -133,7 +145,8 @@ export const CurrentLogAnnotations = references.CurrentLogAnnotations;
  * Reference for the current log severity used by `Effect.log` when no explicit
  * level is provided.
  *
- * **Notes**
+ * **Details**
+ *
  * Use `MinimumLogLevel` to control which log entries are filtered out.
  *
  * **Example** (Changing the current log level)
@@ -241,6 +254,7 @@ export const CurrentLogSpans = references.CurrentLogSpans;
  * fiber.
  *
  * **Details**
+ *
  * Effect and Layer tracing use this reference to attach stack-frame information
  * to failures and interruption causes. It is normally managed by tracing APIs
  * rather than provided directly by application code.
@@ -516,6 +530,7 @@ export const UnhandledLogLevel = references.UnhandledLogLevel;
  * operations.
  *
  * **Details**
+ *
  * Providing this reference changes which `Logger` instances receive log entries
  * in the current context.
  *
@@ -527,6 +542,7 @@ export const CurrentLoggers = internalEffect.CurrentLoggers;
  * Reference controlling whether the default console logger writes to stderr.
  *
  * **Details**
+ *
  * When set to `true`, the pretty console logger uses `console.error`; otherwise
  * it uses `console.log`.
  *

package/dist/References.js.map

@@ -1 +1 @@
-{"version":3,"file":"References.js","names":["internalEffect","references","MaxOpsBeforeYield","PreventSchedulerYield","CurrentTraceLevel","DisablePropagation","MinimumTraceLevel","Tracer","CurrentConcurrency","CurrentLogAnnotations","CurrentLogLevel","CurrentLogSpans","CurrentStackFrame","MinimumLogLevel","TracerEnabled","TracerSpanAnnotations","TracerSpanLinks","TracerTimingEnabled","UnhandledLogLevel","CurrentLoggers","LogToStderr","Scheduler"],"sources":["../src/References.ts"],"sourcesContent":[null],"mappings":"AAaA,OAAO,KAAKA,cAAc,MAAM,sBAAsB;AACtD,OAAO,KAAKC,UAAU,MAAM,0BAA0B;AAItD,SAASC,iBAAiB,EAAEC,qBAAqB,QAAQ,gBAAgB;AACzE,SAASC,iBAAiB,EAAEC,kBAAkB,EAAEC,iBAAiB,EAAiBC,MAAM,QAAQ,aAAa;AAE7G;AACE;;;;AAIAH,iBAAiB;AACjB;;;;AAIAC,kBAAkB;AAClB;;;;AAIAH,iBAAiB;AACjB;;;;AAIAI,iBAAiB;AACjB;;;;AAIAH,qBAAqB;AACrB;;;;AAIAI,MAAM;AAGR;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCA,OAAO,MAAMC,kBAAkB,GAA4CP,UAAU,CAACO,kBAAkB;AAExG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuDA,OAAO,MAAMC,qBAAqB,GAChCR,UAAU,CAACQ,qBAAqB;AAElC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6CA,OAAO,MAAMC,eAAe,GAAgCT,UAAU,CAACS,eAAe;AAEtF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4DA,OAAO,MAAMC,eAAe,GAC1BV,UAAU,CAACU,eAAe;AAE5B;;;;;;;;;;;;AAYA,OAAO,MAAMC,iBAAiB,GAA8CX,UAAU,CAACW,iBAAiB;AAExG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkDA,OAAO,MAAMC,eAAe,GAAgCZ,UAAU,CAACY,eAAe;AAEtF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6CA,OAAO,MAAMC,aAAa,GAA+Bb,UAAU,CAACa,aAAa;AAEjF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmDA,OAAO,MAAMC,qBAAqB,GAChCd,UAAU,CAACc,qBAAqB;AAElC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6DA,OAAO,MAAMC,eAAe,GAA+Cf,UAAU,CAACe,eAAe;AAErG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0CA,OAAO,MAAMC,mBAAmB,GAA+BhB,UAAU,CAACgB,mBAAmB;AAE7F;;;;;;;AAOA,OAAO,MAAMC,iBAAiB,GAA4CjB,UAAU,CAACiB,iBAAiB;AAkBtG;;;;;;;;;;;AAWA,OAAO,MAAMC,cAAc,GAAyDnB,cAAc,CAACmB,cAAc;AAEjH;;;;;;;;;;AAUA,OAAO,MAAMC,WAAW,GAA+BpB,cAAc,CAACoB,WAAW;AAEjF;AACE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCAC,SAAS,QACJ,gBAAgB","ignoreList":[]}
+{"version":3,"file":"References.js","names":["internalEffect","references","MaxOpsBeforeYield","PreventSchedulerYield","CurrentTraceLevel","DisablePropagation","MinimumTraceLevel","Tracer","CurrentConcurrency","CurrentLogAnnotations","CurrentLogLevel","CurrentLogSpans","CurrentStackFrame","MinimumLogLevel","TracerEnabled","TracerSpanAnnotations","TracerSpanLinks","TracerTimingEnabled","UnhandledLogLevel","CurrentLoggers","LogToStderr","Scheduler"],"sources":["../src/References.ts"],"sourcesContent":[null],"mappings":"AAaA,OAAO,KAAKA,cAAc,MAAM,sBAAsB;AACtD,OAAO,KAAKC,UAAU,MAAM,0BAA0B;AAItD,SAASC,iBAAiB,EAAEC,qBAAqB,QAAQ,gBAAgB;AACzE,SAASC,iBAAiB,EAAEC,kBAAkB,EAAEC,iBAAiB,EAAiBC,MAAM,QAAQ,aAAa;AAE7G;AACE;;;;;;AAMAH,iBAAiB;AACjB;;;;;;AAMAC,kBAAkB;AAClB;;;;;;AAMAH,iBAAiB;AACjB;;;;;;AAMAI,iBAAiB;AACjB;;;;;;AAMAH,qBAAqB;AACrB;;;;;;AAMAI,MAAM;AAGR;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCA,OAAO,MAAMC,kBAAkB,GAA4CP,UAAU,CAACO,kBAAkB;AAExG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuDA,OAAO,MAAMC,qBAAqB,GAChCR,UAAU,CAACQ,qBAAqB;AAElC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8CA,OAAO,MAAMC,eAAe,GAAgCT,UAAU,CAACS,eAAe;AAEtF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4DA,OAAO,MAAMC,eAAe,GAC1BV,UAAU,CAACU,eAAe;AAE5B;;;;;;;;;;;;;AAaA,OAAO,MAAMC,iBAAiB,GAA8CX,UAAU,CAACW,iBAAiB;AAExG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkDA,OAAO,MAAMC,eAAe,GAAgCZ,UAAU,CAACY,eAAe;AAEtF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6CA,OAAO,MAAMC,aAAa,GAA+Bb,UAAU,CAACa,aAAa;AAEjF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmDA,OAAO,MAAMC,qBAAqB,GAChCd,UAAU,CAACc,qBAAqB;AAElC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6DA,OAAO,MAAMC,eAAe,GAA+Cf,UAAU,CAACe,eAAe;AAErG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0CA,OAAO,MAAMC,mBAAmB,GAA+BhB,UAAU,CAACgB,mBAAmB;AAE7F;;;;;;;AAOA,OAAO,MAAMC,iBAAiB,GAA4CjB,UAAU,CAACiB,iBAAiB;AAmBtG;;;;;;;;;;;;AAYA,OAAO,MAAMC,cAAc,GAAyDnB,cAAc,CAACmB,cAAc;AAEjH;;;;;;;;;;;AAWA,OAAO,MAAMC,WAAW,GAA+BpB,cAAc,CAACoB,WAAW;AAEjF;AACE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCAC,SAAS,QACJ,gBAAgB","ignoreList":[]}

package/dist/Request.d.ts

@@ -56,7 +56,7 @@ export type Any = Request<any, any, any>;
 /**
  * Variance marker carried by every `Request`.
  *
- * **Notes**
+ * **Details**
  *
  * This marker preserves the success, error, and service requirement types for
  * Effect's type-level machinery. Users normally get it by extending `Request`.
@@ -173,7 +173,7 @@ export type Result<T extends Request<any, any, any>> = T extends Request<infer A
 /**
  * Prototype used by Effect's request constructors.
  *
- * **Notes**
+ * **Details**
  *
  * This low-level value provides the structural request marker for values
  * created by `Request.of`, `Request.tagged`, `Request.Class`, and
@@ -517,7 +517,7 @@ export interface Entry<out R> {
 /**
  * Creates a `Request.Entry` from its component fields.
  *
- * **Notes**
+ * **Details**
  *
  * This is a low-level helper for request runtime and resolver infrastructure;
  * most application code receives entries from a `RequestResolver` instead of

package/dist/Request.js

@@ -15,7 +15,7 @@ const requestVariance = /*#__PURE__*/Equal.byReferenceUnsafe({
 /**
  * Prototype used by Effect's request constructors.
  *
- * **Notes**
+ * **Details**
  *
  * This low-level value provides the structural request marker for values
  * created by `Request.of`, `Request.tagged`, `Request.Class`, and
@@ -253,7 +253,7 @@ export const succeed = /*#__PURE__*/dual(2, (self, value) => complete(self, core
 /**
  * Creates a `Request.Entry` from its component fields.
  *
- * **Notes**
+ * **Details**
  *
  * This is a low-level helper for request runtime and resolver infrastructure;
  * most application code receives entries from a `RequestResolver` instead of

package/dist/RequestResolver.d.ts

@@ -68,7 +68,7 @@ declare const TypeId = "~effect/RequestResolver";
  * received entry, usually by calling `completeUnsafe` or one of the `Request`
  * completion helpers.
  *
- * **Notes**
+ * **Gotchas**
  *
  * If a resolver finishes without completing an entry, the waiting request fails
  * because the resolver did not supply a result.
@@ -128,7 +128,7 @@ export declare namespace RequestResolver {
     /**
      * Variance marker carried by every `RequestResolver`.
      *
-     * **Notes**
+     * **Details**
      *
      * This marker preserves the request type accepted by the resolver for
      * Effect's type-level machinery. Users normally do not implement it directly.
@@ -199,6 +199,8 @@ export declare const make: <A extends Request.Any>(runAll: (entries: NonEmptyArr
 /**
  * Constructs a request resolver with the requests grouped by a calculated key.
  *
+ * **Details**
+ *
  * The key can use the Equal trait to determine if two keys are equal.
  *
  * **Example** (Grouping requests by key)
@@ -1354,11 +1356,7 @@ export declare const withCache: {
  * Cached results are loaded from the configured persistence store before
  * running the underlying resolver. Missing entries, and entries marked stale by
  * `staleWhileRevalidate`, are resolved normally and written back to the store.
- *
- * **Notes**
- *
- * Creating the persisted resolver requires `Persistence.Persistence` and
- * `Scope`.
+ * Creating the persisted resolver requires `Persistence.Persistence` and `Scope`.
  *
  * @category Persistence
  * @since 4.0.0
@@ -1372,11 +1370,7 @@ export declare const persisted: {
      * Cached results are loaded from the configured persistence store before
      * running the underlying resolver. Missing entries, and entries marked stale by
      * `staleWhileRevalidate`, are resolved normally and written back to the store.
-     *
-     * **Notes**
-     *
-     * Creating the persisted resolver requires `Persistence.Persistence` and
-     * `Scope`.
+     * Creating the persisted resolver requires `Persistence.Persistence` and `Scope`.
      *
      * @category Persistence
      * @since 4.0.0
@@ -1394,11 +1388,7 @@ export declare const persisted: {
      * Cached results are loaded from the configured persistence store before
      * running the underlying resolver. Missing entries, and entries marked stale by
      * `staleWhileRevalidate`, are resolved normally and written back to the store.
-     *
-     * **Notes**
-     *
-     * Creating the persisted resolver requires `Persistence.Persistence` and
-     * `Scope`.
+     * Creating the persisted resolver requires `Persistence.Persistence` and `Scope`.
      *
      * @category Persistence
      * @since 4.0.0