effect 4.0.0-beta.70 → 4.0.0-beta.72

package/dist/Terminal.d.ts

@@ -1,19 +1,32 @@
 /**
- * The `Terminal` module defines the service interface used by platform
- * integrations to model command-line input and output. It gives programs a
- * uniform way to query terminal dimensions, read lines, stream low-level key
- * events, and write text without depending directly on Node, the browser, or a
- * test-specific console implementation.
- *
- * Use this module when building interactive command-line tools, prompts, or
- * platform abstractions that need terminal capabilities as an Effect service.
- * Implementations are supplied through context, so application code can depend
- * on `Terminal` while tests and runtimes provide the concrete behavior.
- *
- * `readLine` can fail with {@link QuitError} when the user requests to quit,
- * commonly via `Ctrl+C`. For lower-level interaction, `readInput` returns a
- * scoped stream of {@link UserInput} values containing parsed key metadata and
- * any raw character input.
+ * The `Terminal` module defines Effect's service for interactive terminal
+ * capabilities. Programs can query dimensions, read a line of input, subscribe
+ * to low-level key events, and display text without depending directly on Node,
+ * the browser, or a test-specific console implementation.
+ *
+ * **Mental model**
+ *
+ * `Terminal` sits above raw standard I/O. `Stdio` exposes process streams,
+ * while `Terminal` exposes already interpreted terminal operations as an Effect
+ * service. Application code depends on the {@link Terminal} service; platform
+ * runtimes and tests provide the concrete implementation, often by constructing
+ * one with {@link make}.
+ *
+ * **Common tasks**
+ *
+ * - Read prompt answers with `readLine` and handle user cancellation through
+ *   {@link QuitError}.
+ * - Build interactive prompts from `readInput` by consuming {@link UserInput}
+ *   values with parsed key metadata and optional raw character input.
+ * - Write terminal output through `display` while keeping platform failures in
+ *   the Effect error channel.
+ *
+ * **Gotchas**
+ *
+ * - `readLine` can fail with {@link QuitError} when the user requests to quit,
+ *   commonly via `Ctrl+C`.
+ * - `readInput` requires a `Scope` because the returned dequeue represents a
+ *   live input subscription.
  *
  * @since 4.0.0
  */
@@ -85,6 +98,13 @@ export interface Key {
  * A terminal input event containing an optional raw character and the parsed
  * key that was pressed.
  *
+ * **When to use**
+ *
+ * Use when consuming low-level terminal input events from `Terminal.readInput`
+ * and you need both raw character input and parsed key metadata.
+ *
+ * @see {@link Key} for the parsed key metadata stored on each input event
+ *
  * @category models
  * @since 4.0.0
  */
@@ -103,9 +123,16 @@ declare const QuitError_base: Schema.Class<QuitError, Schema.Struct<{
     readonly _tag: Schema.tag<"QuitError">;
 }>, Cause.YieldableError>;
 /**
- * A `QuitError` represents an error that occurs when a user attempts to
+ * Represents an error that occurs when a user attempts to
  * quit out of a `Terminal` prompt for input (usually by entering `ctrl`+`c`).
  *
+ * **When to use**
+ *
+ * Use when implementing terminal input or prompts that need to signal
+ * user-requested cancellation through the typed error channel.
+ *
+ * @see {@link isQuitError} for checking unknown errors when handling terminal cancellation
+ *
  * @category QuitError
  * @since 4.0.0
  */
@@ -120,19 +147,48 @@ export declare class QuitError extends QuitError_base {
 /**
  * Returns `true` if the provided value is a `Terminal.QuitError`.
  *
- * @category QuitError
+ * **When to use**
+ *
+ * Use to narrow unknown failures to `QuitError` when handling terminal input
+ * cancellation.
+ *
+ * **Details**
+ *
+ * Returns `true` when the value carries the `QuitError` runtime marker and
+ * narrows it to `QuitError`.
+ *
+ * @see {@link QuitError} for the error value produced when terminal input is quit
+ *
+ * @category guards
  * @since 4.0.0
  */
 export declare const isQuitError: (u: unknown) => u is QuitError;
 /**
- * Context service tag for accessing a `Terminal` implementation.
+ * Service tag for command-line input and output services.
  *
- * @category services
+ * **When to use**
+ *
+ * Use to access or provide platform terminal capabilities such as reading
+ * input, writing output, and inspecting terminal dimensions.
+ *
+ * @category tags
  * @since 4.0.0
  */
 export declare const Terminal: Context.Service<Terminal, Terminal>;
 /**
- * Creates a Terminal implementation
+ * Creates a `Terminal` service implementation.
+ *
+ * **When to use**
+ *
+ * Use to construct a custom `Terminal` service implementation from concrete
+ * terminal capabilities when writing a platform adapter, test implementation,
+ * or custom runtime service.
+ *
+ * **Details**
+ *
+ * The implementation object supplies `columns`, `rows`, `readInput`,
+ * `readLine`, and `display`; `make` attaches the `Terminal` service marker so
+ * the result can be provided through the `Terminal` context service.
  *
  * @category constructors
  * @since 4.0.0

package/dist/Terminal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Terminal.d.ts","sourceRoot":"","sources":["../src/Terminal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAA;AACxC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,KAAK,MAAM,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,KAAK,MAAM,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEvD,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAA;AACxC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAA;AAExC,QAAA,MAAM,MAAM,8BAA8B,CAAA;AAE1C;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,MAAM,CAAA;IAEhC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACvC;;OAEG;IAEH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACpC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IAC3F;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IACnD;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAAA;CACvE;AAED;;;;;;GAMG;AACH,MAAM,WAAW,GAAG;IAClB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CACxB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACrC;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAA;CAClB;AAED,QAAA,MAAM,eAAe,uCAAuC,CAAA;;;;AAE5D;;;;;;GAMG;AACH,qBAAa,SAAU,SAAQ,cAE7B;IACA;;;;OAIG;IACH,QAAQ,CAAC,CAAC,eAAe,CAAC,wCAAkB;CAC7C;AAED;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,SAAsD,CAAA;AAEpG;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAA+C,CAAA;AAExG;;;;;GAKG;AACH,eAAO,MAAM,IAAI,GACf,MAAM,IAAI,CAAC,QAAQ,EAAE,OAAO,MAAM,CAAC,KAClC,QAAsD,CAAA"}
+{"version":3,"file":"Terminal.d.ts","sourceRoot":"","sources":["../src/Terminal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAA;AACxC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,KAAK,MAAM,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,KAAK,MAAM,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEvD,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAA;AACxC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAA;AAExC,QAAA,MAAM,MAAM,8BAA8B,CAAA;AAE1C;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,MAAM,CAAA;IAEhC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACvC;;OAEG;IAEH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACpC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IAC3F;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IACnD;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAAA;CACvE;AAED;;;;;;GAMG;AACH,MAAM,WAAW,GAAG;IAClB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CACxB;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACrC;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAA;CAClB;AAED,QAAA,MAAM,eAAe,uCAAuC,CAAA;;;;AAE5D;;;;;;;;;;;;;GAaG;AACH,qBAAa,SAAU,SAAQ,cAE7B;IACA;;;;OAIG;IACH,QAAQ,CAAC,CAAC,eAAe,CAAC,wCAAkB;CAC7C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,WAAW,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,SAAsD,CAAA;AAEpG;;;;;;;;;;GAUG;AACH,eAAO,MAAM,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAA+C,CAAA;AAExG;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,IAAI,GACf,MAAM,IAAI,CAAC,QAAQ,EAAE,OAAO,MAAM,CAAC,KAClC,QAAsD,CAAA"}

package/dist/Terminal.js

@@ -4,9 +4,16 @@ import * as Schema from "./Schema.js";
 const TypeId = "~effect/platform/Terminal";
 const QuitErrorTypeId = "effect/platform/Terminal/QuitError";
 /**
- * A `QuitError` represents an error that occurs when a user attempts to
+ * Represents an error that occurs when a user attempts to
  * quit out of a `Terminal` prompt for input (usually by entering `ctrl`+`c`).
  *
+ * **When to use**
+ *
+ * Use when implementing terminal input or prompts that need to signal
+ * user-requested cancellation through the typed error channel.
+ *
+ * @see {@link isQuitError} for checking unknown errors when handling terminal cancellation
+ *
  * @category QuitError
  * @since 4.0.0
  */
@@ -23,19 +30,48 @@ export class QuitError extends /*#__PURE__*/Schema.ErrorClass("QuitError")({
 /**
  * Returns `true` if the provided value is a `Terminal.QuitError`.
  *
- * @category QuitError
+ * **When to use**
+ *
+ * Use to narrow unknown failures to `QuitError` when handling terminal input
+ * cancellation.
+ *
+ * **Details**
+ *
+ * Returns `true` when the value carries the `QuitError` runtime marker and
+ * narrows it to `QuitError`.
+ *
+ * @see {@link QuitError} for the error value produced when terminal input is quit
+ *
+ * @category guards
  * @since 4.0.0
  */
 export const isQuitError = u => Predicate.hasProperty(u, QuitErrorTypeId);
 /**
- * Context service tag for accessing a `Terminal` implementation.
+ * Service tag for command-line input and output services.
+ *
+ * **When to use**
  *
- * @category services
+ * Use to access or provide platform terminal capabilities such as reading
+ * input, writing output, and inspecting terminal dimensions.
+ *
+ * @category tags
  * @since 4.0.0
  */
 export const Terminal = /*#__PURE__*/Context.Service("effect/platform/Terminal");
 /**
- * Creates a Terminal implementation
+ * Creates a `Terminal` service implementation.
+ *
+ * **When to use**
+ *
+ * Use to construct a custom `Terminal` service implementation from concrete
+ * terminal capabilities when writing a platform adapter, test implementation,
+ * or custom runtime service.
+ *
+ * **Details**
+ *
+ * The implementation object supplies `columns`, `rows`, `readInput`,
+ * `readLine`, and `display`; `make` attaches the `Terminal` service marker so
+ * the result can be provided through the `Terminal` context service.
  *
  * @category constructors
  * @since 4.0.0

package/dist/Terminal.js.map

@@ -1 +1 @@
-{"version":3,"file":"Terminal.js","names":["Context","Predicate","Schema","TypeId","QuitErrorTypeId","QuitError","ErrorClass","_tag","tag","isQuitError","u","hasProperty","Terminal","Service","make","impl","of"],"sources":["../src/Terminal.ts"],"sourcesContent":[null],"mappings":"AAoBA,OAAO,KAAKA,OAAO,MAAM,cAAc;AAIvC,OAAO,KAAKC,SAAS,MAAM,gBAAgB;AAE3C,OAAO,KAAKC,MAAM,MAAM,aAAa;AAGrC,MAAMC,MAAM,GAAG,2BAA2B;AA+E1C,MAAMC,eAAe,GAAG,oCAAoC;AAE5D;;;;;;;AAOA,OAAM,MAAOC,SAAU,sBAAQH,MAAM,CAACI,UAAU,CAAY,WAAW,CAAC,CAAC;EACvEC,IAAI,eAAEL,MAAM,CAACM,GAAG,CAAC,WAAW;CAC7B,CAAC;EACA;;;;;EAKS,CAACJ,eAAe,IAAIA,eAAe;;AAG9C;;;;;;AAMA,OAAO,MAAMK,WAAW,GAAIC,CAAU,IAAqBT,SAAS,CAACU,WAAW,CAACD,CAAC,EAAEN,eAAe,CAAC;AAEpG;;;;;;AAMA,OAAO,MAAMQ,QAAQ,gBAAwCZ,OAAO,CAACa,OAAO,CAAC,0BAA0B,CAAC;AAExG;;;;;;AAMA,OAAO,MAAMC,IAAI,GACfC,IAAmC,IACtBH,QAAQ,CAACI,EAAE,CAAC;EAAE,GAAGD,IAAI;EAAE,CAACZ,MAAM,GAAGA;AAAM,CAAE,CAAC","ignoreList":[]}
+{"version":3,"file":"Terminal.js","names":["Context","Predicate","Schema","TypeId","QuitErrorTypeId","QuitError","ErrorClass","_tag","tag","isQuitError","u","hasProperty","Terminal","Service","make","impl","of"],"sources":["../src/Terminal.ts"],"sourcesContent":[null],"mappings":"AAiCA,OAAO,KAAKA,OAAO,MAAM,cAAc;AAIvC,OAAO,KAAKC,SAAS,MAAM,gBAAgB;AAE3C,OAAO,KAAKC,MAAM,MAAM,aAAa;AAGrC,MAAMC,MAAM,GAAG,2BAA2B;AAsF1C,MAAMC,eAAe,GAAG,oCAAoC;AAE5D;;;;;;;;;;;;;;AAcA,OAAM,MAAOC,SAAU,sBAAQH,MAAM,CAACI,UAAU,CAAY,WAAW,CAAC,CAAC;EACvEC,IAAI,eAAEL,MAAM,CAACM,GAAG,CAAC,WAAW;CAC7B,CAAC;EACA;;;;;EAKS,CAACJ,eAAe,IAAIA,eAAe;;AAG9C;;;;;;;;;;;;;;;;;;AAkBA,OAAO,MAAMK,WAAW,GAAIC,CAAU,IAAqBT,SAAS,CAACU,WAAW,CAACD,CAAC,EAAEN,eAAe,CAAC;AAEpG;;;;;;;;;;;AAWA,OAAO,MAAMQ,QAAQ,gBAAwCZ,OAAO,CAACa,OAAO,CAAC,0BAA0B,CAAC;AAExG;;;;;;;;;;;;;;;;;;AAkBA,OAAO,MAAMC,IAAI,GACfC,IAAmC,IACtBH,QAAQ,CAACI,EAAE,CAAC;EAAE,GAAGD,IAAI;EAAE,CAACZ,MAAM,GAAGA;AAAM,CAAE,CAAC","ignoreList":[]}

package/dist/Tracer.d.ts

@@ -146,7 +146,12 @@ export type SpanStatus = {
  */
 export type AnySpan = Span | ExternalSpan;
 /**
- * The string key used to identify the `ParentSpan` context service.
+ * Defines the string key for the parent-span context service.
+ *
+ * **When to use**
+ *
+ * Use when integrating lower-level tracing code that needs the raw context key
+ * for parent span lookup.
  *
  * **Example** (Reading the parent span key)
  *
@@ -410,6 +415,19 @@ export interface SpanLink {
 /**
  * Creates a `Tracer` value from a tracer implementation object.
  *
+ * **When to use**
+ *
+ * Use to create a custom tracing backend value that Effect can use when
+ * creating spans.
+ *
+ * **Details**
+ *
+ * `make` returns the supplied implementation object unchanged. The object must
+ * satisfy the `Tracer` contract, including a `span` method that returns a
+ * `Span`.
+ *
+ * @see {@link Span} for the span values returned by tracer implementations
+ *
  * @category constructors
  * @since 2.0.0
  */
@@ -447,9 +465,17 @@ export declare const externalSpan: (options: {
     readonly annotations?: Context.Context<never> | undefined;
 }) => ExternalSpan;
 /**
- * Reference used to disable trace propagation. When set on the fiber or span
- * annotations, new spans are created as non-propagating no-op spans and
- * disabled spans are skipped when deriving a parent span.
+ * Context reference for disabling trace propagation.
+ *
+ * **When to use**
+ *
+ * Use to prevent spans in a scope from propagating tracing context.
+ *
+ * **Details**
+ *
+ * When enabled on fiber or span annotations, new spans are created as
+ * non-propagating no-op spans and disabled spans are skipped when deriving a
+ * parent span.
  *
  * **Example** (Disabling span propagation)
  *
@@ -469,23 +495,56 @@ export declare const externalSpan: (options: {
  */
 export declare const DisablePropagation: Context.Reference<boolean>;
 /**
- * Reference for controlling the current trace level for dynamic filtering.
+ * Context reference for controlling the current trace level for dynamic filtering.
+ *
+ * **When to use**
+ *
+ * Use to set the default trace level for spans in a scope when span options do
+ * not provide `level`.
+ *
+ * **Details**
+ *
+ * The default value is `"Info"`. Span creation uses `options.level ??
+ * CurrentTraceLevel` before applying `MinimumTraceLevel`.
+ *
+ * @see {@link MinimumTraceLevel} for the threshold that decides whether spans at that level are sampled
  *
  * @category references
  * @since 4.0.0
  */
 export declare const CurrentTraceLevel: Context.Reference<LogLevel>;
 /**
- * Reference for setting the minimum trace level threshold. Spans and their
+ * Context reference for setting the minimum trace level threshold. Spans and their
  * descendants below this level will have their sampling decision forced to
  * false, preventing them from being exported.
  *
+ * **When to use**
+ *
+ * Use to set the trace-level threshold that controls whether spans are sampled
+ * by default.
+ *
+ * **Details**
+ *
+ * The default value is `"All"`. Span creation compares the span level from
+ * `options.level ?? CurrentTraceLevel` against this threshold.
+ *
+ * **Gotchas**
+ *
+ * Explicit `options.sampled` bypasses threshold computation.
+ *
+ * @see {@link CurrentTraceLevel} for the default span level used when options do not specify one
+ *
  * @category references
  * @since 4.0.0
  */
 export declare const MinimumTraceLevel: Context.Reference<LogLevel>;
 /**
- * The string key used to identify the active `Tracer` context reference.
+ * Defines the string key for the active tracer context reference.
+ *
+ * **When to use**
+ *
+ * Use when integrating lower-level tracing code that needs the raw context key
+ * for active tracer lookup.
  *
  * @category references
  * @since 4.0.0
@@ -522,6 +581,14 @@ export declare const Tracer: Context.Reference<Tracer>;
  * generates span and trace identifiers, stores attributes, events, and links,
  * and records `Started` or `Ended` status.
  *
+ * **Details**
+ *
+ * The constructor initializes the span with `Started` status, inherits the
+ * parent trace id or generates a new one, and always generates a new span id.
+ * Attributes, events, links, and status are then mutated through `Span` methods.
+ *
+ * @see {@link Span} for the interface implemented by native spans
+ *
  * @category native tracer
  * @since 4.0.0
  */

package/dist/Tracer.d.ts.map

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

package/dist/Tracer.js

@@ -44,7 +44,12 @@ import { constFalse } from "./Function.js";
 import * as Option from "./Option.js";
 const evaluate = "~effect/Effect/evaluate";
 /**
- * The string key used to identify the `ParentSpan` context service.
+ * Defines the string key for the parent-span context service.
+ *
+ * **When to use**
+ *
+ * Use when integrating lower-level tracing code that needs the raw context key
+ * for parent span lookup.
  *
  * **Example** (Reading the parent span key)
  *
@@ -82,6 +87,19 @@ export class ParentSpan extends /*#__PURE__*/Context.Service()(ParentSpanKey) {}
 /**
  * Creates a `Tracer` value from a tracer implementation object.
  *
+ * **When to use**
+ *
+ * Use to create a custom tracing backend value that Effect can use when
+ * creating spans.
+ *
+ * **Details**
+ *
+ * `make` returns the supplied implementation object unchanged. The object must
+ * satisfy the `Tracer` contract, including a `span` method that returns a
+ * `Span`.
+ *
+ * @see {@link Span} for the span values returned by tracer implementations
+ *
  * @category constructors
  * @since 2.0.0
  */
@@ -120,9 +138,17 @@ export const externalSpan = options => ({
   annotations: options.annotations ?? Context.empty()
 });
 /**
- * Reference used to disable trace propagation. When set on the fiber or span
- * annotations, new spans are created as non-propagating no-op spans and
- * disabled spans are skipped when deriving a parent span.
+ * Context reference for disabling trace propagation.
+ *
+ * **When to use**
+ *
+ * Use to prevent spans in a scope from propagating tracing context.
+ *
+ * **Details**
+ *
+ * When enabled on fiber or span annotations, new spans are created as
+ * non-propagating no-op spans and disabled spans are skipped when deriving a
+ * parent span.
  *
  * **Example** (Disabling span propagation)
  *
@@ -144,7 +170,19 @@ export const DisablePropagation = /*#__PURE__*/Context.Reference("effect/Tracer/
   defaultValue: constFalse
 });
 /**
- * Reference for controlling the current trace level for dynamic filtering.
+ * Context reference for controlling the current trace level for dynamic filtering.
+ *
+ * **When to use**
+ *
+ * Use to set the default trace level for spans in a scope when span options do
+ * not provide `level`.
+ *
+ * **Details**
+ *
+ * The default value is `"Info"`. Span creation uses `options.level ??
+ * CurrentTraceLevel` before applying `MinimumTraceLevel`.
+ *
+ * @see {@link MinimumTraceLevel} for the threshold that decides whether spans at that level are sampled
  *
  * @category references
  * @since 4.0.0
@@ -153,10 +191,26 @@ export const CurrentTraceLevel = /*#__PURE__*/Context.Reference("effect/Tracer/C
   defaultValue: () => "Info"
 });
 /**
- * Reference for setting the minimum trace level threshold. Spans and their
+ * Context reference for setting the minimum trace level threshold. Spans and their
  * descendants below this level will have their sampling decision forced to
  * false, preventing them from being exported.
  *
+ * **When to use**
+ *
+ * Use to set the trace-level threshold that controls whether spans are sampled
+ * by default.
+ *
+ * **Details**
+ *
+ * The default value is `"All"`. Span creation compares the span level from
+ * `options.level ?? CurrentTraceLevel` against this threshold.
+ *
+ * **Gotchas**
+ *
+ * Explicit `options.sampled` bypasses threshold computation.
+ *
+ * @see {@link CurrentTraceLevel} for the default span level used when options do not specify one
+ *
  * @category references
  * @since 4.0.0
  */
@@ -164,7 +218,12 @@ export const MinimumTraceLevel = /*#__PURE__*/Context.Reference("effect/Tracer/M
   defaultValue: () => "All"
 });
 /**
- * The string key used to identify the active `Tracer` context reference.
+ * Defines the string key for the active tracer context reference.
+ *
+ * **When to use**
+ *
+ * Use when integrating lower-level tracing code that needs the raw context key
+ * for active tracer lookup.
  *
  * @category references
  * @since 4.0.0
@@ -205,6 +264,14 @@ export const Tracer = /*#__PURE__*/Context.Reference(TracerKey, {
  * generates span and trace identifiers, stores attributes, events, and links,
  * and records `Started` or `Ended` status.
  *
+ * **Details**
+ *
+ * The constructor initializes the span with `Started` status, inherits the
+ * parent trace id or generates a new one, and always generates a new span id.
+ * Attributes, events, links, and status are then mutated through `Span` methods.
+ *
+ * @see {@link Span} for the interface implemented by native spans
+ *
  * @category native tracer
  * @since 4.0.0
  */

package/dist/Tracer.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tracer.js","names":["Context","constFalse","Option","evaluate","ParentSpanKey","ParentSpan","Service","make","options","externalSpan","_tag","spanId","traceId","sampled","annotations","empty","DisablePropagation","Reference","defaultValue","CurrentTraceLevel","MinimumTraceLevel","TracerKey","Tracer","span","NativeSpan","name","parent","links","startTime","kind","status","attributes","events","constructor","Map","getOrUndefined","randomHexString","end","endTime","exit","attribute","key","value","set","event","push","addLinks","characters","charactersLength","length","result","i","charAt","Math","floor","random"],"sources":["../src/Tracer.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"Tracer.js","names":["Context","constFalse","Option","evaluate","ParentSpanKey","ParentSpan","Service","make","options","externalSpan","_tag","spanId","traceId","sampled","annotations","empty","DisablePropagation","Reference","defaultValue","CurrentTraceLevel","MinimumTraceLevel","TracerKey","Tracer","span","NativeSpan","name","parent","links","startTime","kind","status","attributes","events","constructor","Map","getOrUndefined","randomHexString","end","endTime","exit","attribute","key","value","set","event","push","addLinks","characters","charactersLength","length","result","i","charAt","Math","floor","random"],"sources":["../src/Tracer.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}