effect 4.0.0-beta.66 → 4.0.0-beta.67

package/dist/testing/TestClock.d.ts

@@ -15,6 +15,8 @@ import * as Layer from "../Layer.ts";
  *
  * For example, here is how we can test `Effect.timeout` using `TestClock`:
  *
+ * **Example** (Testing timeouts deterministically)
+ *
  * ```ts
  * import { Effect, Fiber, Option, pipe } from "effect"
  * import { TestClock } from "effect/testing"
@@ -40,7 +42,8 @@ import * as Layer from "../Layer.ts";
  * being tested, then adjust the clock time, and finally verify that the
  * expected effects have been performed.
  *
- * @example
+ * **Example** (Advancing time deterministically)
+ *
  * ```ts
  * import { Effect } from "effect"
  * import { TestClock } from "effect/testing"
@@ -62,8 +65,8 @@ import * as Layer from "../Layer.ts";
  * })
  * ```
  *
- * @since 2.0.0
  * @category models
+ * @since 2.0.0
  */
 export interface TestClock extends Clock.Clock {
     /**
@@ -84,7 +87,10 @@ export interface TestClock extends Clock.Clock {
     withLive<A, E, R>(effect: Effect.Effect<A, E, R>): Effect.Effect<A, E, R>;
 }
 /**
- * @example
+ * Namespace containing `TestClock` configuration and state types.
+ *
+ * **Example** (Configuring a test clock)
+ *
  * ```ts
  * import { Effect } from "effect"
  * import { TestClock } from "effect/testing"
@@ -101,12 +107,17 @@ export interface TestClock extends Clock.Clock {
  * })
  * ```
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export declare namespace TestClock {
     /**
-     * @example
+     * Options used when constructing a `TestClock`. `warningDelay` controls how
+     * long the live clock waits before logging a warning when a test uses time
+     * without advancing the test clock.
+     *
+     * **Example** (Configuring the warning delay)
+     *
      * ```ts
      * import { Effect } from "effect"
      * import { TestClock } from "effect/testing"
@@ -122,8 +133,8 @@ export declare namespace TestClock {
      * })
      * ```
      *
-     * @since 4.0.0
      * @category models
+     * @since 4.0.0
      */
     interface Options {
         /**
@@ -133,24 +144,12 @@ export declare namespace TestClock {
         readonly warningDelay?: Duration.Input;
     }
     /**
-     * @example
-     * ```ts
-     * import { Effect } from "effect"
-     * import { TestClock } from "effect/testing"
-     *
-     * const program = Effect.gen(function*() {
-     *   const testClock = yield* TestClock.make()
-     *
-     *   // The state represents the current timestamp and scheduled sleeps
-     *   const timestamp = testClock.currentTimeMillisUnsafe()
-     *   console.log(timestamp) // Current test time
-     *
-     *   // Internal state structure: { timestamp: number, sleeps: Array<[number, Latch.Latch]> }
-     * })
-     * ```
+     * Represents the state tracked by a `TestClock`, including the current
+     * millisecond timestamp and the sleeps scheduled to resume when the clock
+     * reaches their target time.
      *
-     * @since 4.0.0
      * @category models
+     * @since 4.0.0
      */
     interface State {
         readonly timestamp: number;
@@ -160,7 +159,8 @@ export declare namespace TestClock {
 /**
  * Creates a `TestClock` with optional configuration.
  *
- * @example
+ * **Example** (Creating a test clock)
+ *
  * ```ts
  * import { Effect } from "effect"
  * import { TestClock } from "effect/testing"
@@ -181,8 +181,8 @@ export declare namespace TestClock {
  * })
  * ```
  *
- * @since 4.0.0
  * @category constructors
+ * @since 4.0.0
  */
 export declare const make: (options?: TestClock.Options | undefined) => Effect.Effect<{
     currentTimeMillisUnsafe: () => number;
@@ -197,7 +197,8 @@ export declare const make: (options?: TestClock.Options | undefined) => Effect.E
 /**
  * Creates a `Layer` which constructs a `TestClock`.
  *
- * @example
+ * **Example** (Providing a test clock layer)
+ *
  * ```ts
  * import { Effect } from "effect"
  * import { TestClock } from "effect/testing"
@@ -216,15 +217,16 @@ export declare const make: (options?: TestClock.Options | undefined) => Effect.E
  * }).pipe(Effect.provide(testClockLayer))
  * ```
  *
- * @since 4.0.0
  * @category layers
+ * @since 4.0.0
  */
 export declare const layer: (options?: TestClock.Options) => Layer.Layer<TestClock>;
 /**
  * Retrieves the `TestClock` service for this test and uses it to run the
  * specified workflow.
  *
- * @example
+ * **Example** (Accessing the test clock)
+ *
  * ```ts
  * import { Effect } from "effect"
  * import { TestClock } from "effect/testing"
@@ -242,8 +244,8 @@ export declare const layer: (options?: TestClock.Options) => Layer.Layer<TestClo
  * })
  * ```
  *
- * @since 2.0.0
  * @category utils
+ * @since 2.0.0
  */
 export declare const testClockWith: <A, E, R>(f: (testClock: TestClock) => Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>;
 /**
@@ -251,7 +253,8 @@ export declare const testClockWith: <A, E, R>(f: (testClock: TestClock) => Effec
  * by the specified duration, running any actions scheduled for on or before
  * the new time in order.
  *
- * @example
+ * **Example** (Advancing the test clock)
+ *
  * ```ts
  * import { Effect } from "effect"
  * import { TestClock } from "effect/testing"
@@ -273,15 +276,16 @@ export declare const testClockWith: <A, E, R>(f: (testClock: TestClock) => Effec
  * })
  * ```
  *
- * @since 2.0.0
  * @category utils
+ * @since 2.0.0
  */
 export declare const adjust: (duration: Duration.Input) => Effect.Effect<void>;
 /**
  * Sets the current clock time to the specified `timestamp`. Any effects that
  * were scheduled to occur on or before the new time will be run in order.
  *
- * @example
+ * **Example** (Setting the test clock time)
+ *
  * ```ts
  * import { Duration, Effect } from "effect"
  * import { TestClock } from "effect/testing"
@@ -304,15 +308,16 @@ export declare const adjust: (duration: Duration.Input) => Effect.Effect<void>;
  * })
  * ```
  *
- * @since 2.0.0
  * @category utils
+ * @since 2.0.0
  */
 export declare const setTime: (timestamp: number) => Effect.Effect<void>;
 /**
  * Executes the specified effect with the live `Clock` instead of the
  * `TestClock`.
  *
- * @example
+ * **Example** (Running with the live clock)
+ *
  * ```ts
  * import { Clock, Effect } from "effect"
  * import { TestClock } from "effect/testing"
@@ -335,8 +340,8 @@ export declare const setTime: (timestamp: number) => Effect.Effect<void>;
  * })
  * ```
  *
- * @since 2.0.0
  * @category utils
+ * @since 2.0.0
  */
 export declare const withLive: <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>;
 //# sourceMappingURL=TestClock.d.ts.map

package/dist/testing/TestClock.d.ts.map

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

package/dist/testing/TestClock.js

@@ -1,4 +1,28 @@
 /**
+ * The `TestClock` module provides a controllable implementation of the Effect
+ * `Clock` service for tests. Instead of waiting for real time to pass, effects
+ * that use `Effect.sleep`, timeouts, schedules, retries, and other time-based
+ * operators can be driven deterministically by advancing the test clock.
+ *
+ * **Common use cases**
+ *
+ * - Testing sleeps, delays, timeouts, debouncing, retries, and schedules without
+ *   slowing the test suite down
+ * - Advancing time with {@link adjust} or jumping to an exact timestamp with
+ *   {@link setTime}
+ * - Running a specific effect against the live clock with {@link withLive}
+ *   while the rest of the test remains under test-clock control
+ *
+ * **Testing gotchas**
+ *
+ * - Effects that sleep semantically block until the clock is advanced far
+ *   enough, so tests usually fork the time-dependent effect before calling
+ *   {@link adjust} or {@link setTime}
+ * - Scheduled sleeps are resumed in clock-time order as the test clock moves
+ *   forward
+ * - If a test uses time but never advances the `TestClock`, the module starts a
+ *   delayed warning to help identify a hanging test
+ *
  * @since 2.0.0
  */
 import * as Arr from "../Array.js";
@@ -27,7 +51,8 @@ const SleepOrder = /*#__PURE__*/Order.flip(/*#__PURE__*/Order.Struct({
 /**
  * Creates a `TestClock` with optional configuration.
  *
- * @example
+ * **Example** (Creating a test clock)
+ *
  * ```ts
  * import { Effect } from "effect"
  * import { TestClock } from "effect/testing"
@@ -48,8 +73,8 @@ const SleepOrder = /*#__PURE__*/Order.flip(/*#__PURE__*/Order.Struct({
  * })
  * ```
  *
- * @since 4.0.0
  * @category constructors
+ * @since 4.0.0
  */
 export const make = /*#__PURE__*/Effect.fnUntraced(function* (options) {
   const config = Object.assign({}, defaultOptions, options);
@@ -153,7 +178,8 @@ export const make = /*#__PURE__*/Effect.fnUntraced(function* (options) {
 /**
  * Creates a `Layer` which constructs a `TestClock`.
  *
- * @example
+ * **Example** (Providing a test clock layer)
+ *
  * ```ts
  * import { Effect } from "effect"
  * import { TestClock } from "effect/testing"
@@ -172,15 +198,16 @@ export const make = /*#__PURE__*/Effect.fnUntraced(function* (options) {
  * }).pipe(Effect.provide(testClockLayer))
  * ```
  *
- * @since 4.0.0
  * @category layers
+ * @since 4.0.0
  */
 export const layer = /*#__PURE__*/flow(make, /*#__PURE__*/Layer.effect(Clock.Clock));
 /**
  * Retrieves the `TestClock` service for this test and uses it to run the
  * specified workflow.
  *
- * @example
+ * **Example** (Accessing the test clock)
+ *
  * ```ts
  * import { Effect } from "effect"
  * import { TestClock } from "effect/testing"
@@ -198,8 +225,8 @@ export const layer = /*#__PURE__*/flow(make, /*#__PURE__*/Layer.effect(Clock.Clo
  * })
  * ```
  *
- * @since 2.0.0
  * @category utils
+ * @since 2.0.0
  */
 export const testClockWith = f => Effect.withFiber(fiber => f(fiber.getRef(Clock.Clock)));
 /**
@@ -207,7 +234,8 @@ export const testClockWith = f => Effect.withFiber(fiber => f(fiber.getRef(Clock
  * by the specified duration, running any actions scheduled for on or before
  * the new time in order.
  *
- * @example
+ * **Example** (Advancing the test clock)
+ *
  * ```ts
  * import { Effect } from "effect"
  * import { TestClock } from "effect/testing"
@@ -229,15 +257,16 @@ export const testClockWith = f => Effect.withFiber(fiber => f(fiber.getRef(Clock
  * })
  * ```
  *
- * @since 2.0.0
  * @category utils
+ * @since 2.0.0
  */
 export const adjust = duration => testClockWith(testClock => testClock.adjust(duration));
 /**
  * Sets the current clock time to the specified `timestamp`. Any effects that
  * were scheduled to occur on or before the new time will be run in order.
  *
- * @example
+ * **Example** (Setting the test clock time)
+ *
  * ```ts
  * import { Duration, Effect } from "effect"
  * import { TestClock } from "effect/testing"
@@ -260,15 +289,16 @@ export const adjust = duration => testClockWith(testClock => testClock.adjust(du
  * })
  * ```
  *
- * @since 2.0.0
  * @category utils
+ * @since 2.0.0
  */
 export const setTime = timestamp => testClockWith(testClock => testClock.setTime(timestamp));
 /**
  * Executes the specified effect with the live `Clock` instead of the
  * `TestClock`.
  *
- * @example
+ * **Example** (Running with the live clock)
+ *
  * ```ts
  * import { Clock, Effect } from "effect"
  * import { TestClock } from "effect/testing"
@@ -291,8 +321,8 @@ export const setTime = timestamp => testClockWith(testClock => testClock.setTime
  * })
  * ```
  *
- * @since 2.0.0
  * @category utils
+ * @since 2.0.0
  */
 export const withLive = effect => testClockWith(testClock => testClock.withLive(effect));
 const WarningState = /*#__PURE__*/Data.taggedEnum();

package/dist/testing/TestClock.js.map

@@ -1 +1 @@
-{"version":3,"file":"TestClock.js","names":["Arr","Clock","Data","Duration","Effect","Fiber","flow","Latch","Layer","Order","Semaphore","warningMessage","defaultOptions","warningDelay","SleepOrder","flip","Struct","timestamp","Number","sequence","make","fnUntraced","options","config","Object","assign","sleeps","liveClock","clockWith","succeed","warningSemaphore","currentTimestamp","Date","getTime","warningState","WarningState","Start","currentTimeMillisUnsafe","currentTimeNanosUnsafe","BigInt","Math","floor","currentTimeMillis","sync","currentTimeNanos","withLive","effect","provideService","warningStart","withPermits","suspend","_tag","logWarning","pipe","delay","forkChild","interruptible","flatMap","fiber","Pending","void","warningDone","interrupt","andThen","Done","sleep","duration","millis","toMillis","end","latch","makeUnsafe","push","sort","await","runSemaphore","run","step","forkScoped","yieldNow","endTimestamp","isArrayNonEmpty","lastNonEmpty","entry","pop","openUnsafe","adjust","fromInputUnsafe","setTime","addFinalizer","layer","testClockWith","f","withFiber","getRef","testClock","taggedEnum"],"sources":["../../src/testing/TestClock.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"TestClock.js","names":["Arr","Clock","Data","Duration","Effect","Fiber","flow","Latch","Layer","Order","Semaphore","warningMessage","defaultOptions","warningDelay","SleepOrder","flip","Struct","timestamp","Number","sequence","make","fnUntraced","options","config","Object","assign","sleeps","liveClock","clockWith","succeed","warningSemaphore","currentTimestamp","Date","getTime","warningState","WarningState","Start","currentTimeMillisUnsafe","currentTimeNanosUnsafe","BigInt","Math","floor","currentTimeMillis","sync","currentTimeNanos","withLive","effect","provideService","warningStart","withPermits","suspend","_tag","logWarning","pipe","delay","forkChild","interruptible","flatMap","fiber","Pending","void","warningDone","interrupt","andThen","Done","sleep","duration","millis","toMillis","end","latch","makeUnsafe","push","sort","await","runSemaphore","run","step","forkScoped","yieldNow","endTimestamp","isArrayNonEmpty","lastNonEmpty","entry","pop","openUnsafe","adjust","fromInputUnsafe","setTime","addFinalizer","layer","testClockWith","f","withFiber","getRef","testClock","taggedEnum"],"sources":["../../src/testing/TestClock.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/testing/TestConsole.d.ts

@@ -9,7 +9,8 @@ import * as Layer from "../Layer.ts";
  * This interface extends the standard Console interface and adds methods to
  * retrieve logged messages for verification in tests.
  *
- * @example
+ * **Example** (Capturing console output in tests)
+ *
  * ```ts
  * import { Console, Effect } from "effect"
  * import * as TestConsole from "effect/testing/TestConsole"
@@ -26,8 +27,8 @@ import * as Layer from "../Layer.ts";
  * }).pipe(Effect.provide(TestConsole.layer))
  * ```
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export interface TestConsole extends Console.Console {
     /**
@@ -45,45 +46,48 @@ export interface TestConsole extends Console.Console {
  * The `TestConsole` namespace provides types and utilities for working with
  * test console implementations.
  *
- * @example
- * ```ts
- * // The TestConsole namespace provides types for testing
- * // Use TestConsole.make to create a test console instance
- * // Use TestConsole.layer to provide the service in tests
- * ```
- *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export declare namespace TestConsole {
     /**
      * Represents a console method name that can be invoked on the TestConsole.
      * This type includes all methods available on the Console interface.
      *
-     * @example
+     * **Example** (Typing captured console methods)
+     *
      * ```ts
-     * // Method represents console method names like:
-     * // "log", "error", "warn", "debug", "info", etc.
-     * // All methods from the Console interface are supported
+     * import type * as TestConsole from "effect/testing/TestConsole"
+     *
+     * const method: TestConsole.TestConsole.Method = "log"
+     *
+     * console.log(method) // "log"
      * ```
      *
-     * @since 4.0.0
      * @category models
+     * @since 4.0.0
      */
     type Method = keyof Console.Console;
     /**
      * Represents a single console method invocation captured by the TestConsole.
      * Each entry contains the method name and the parameters passed to it.
      *
-     * @example
+     * **Example** (Typing captured console entries)
+     *
      * ```ts
-     * // Entry represents captured console calls with their method and parameters
-     * // Each entry contains: { method: string, parameters: ReadonlyArray<unknown> }
-     * // Used internally by TestConsole to track all console operations
+     * import type * as TestConsole from "effect/testing/TestConsole"
+     *
+     * const entry: TestConsole.TestConsole.Entry = {
+     *   method: "error",
+     *   parameters: ["not found"]
+     * }
+     *
+     * console.log(entry.method) // "error"
+     * console.log(entry.parameters) // ["not found"]
      * ```
      *
-     * @since 4.0.0
      * @category models
+     * @since 4.0.0
      */
     interface Entry {
         readonly method: Method;
@@ -95,7 +99,8 @@ export declare namespace TestConsole {
  * The returned TestConsole implements the Console interface and provides
  * additional methods to retrieve logged messages.
  *
- * @example
+ * **Example** (Creating a test console)
+ *
  * ```ts
  * import { Console, Effect } from "effect"
  * import * as TestConsole from "effect/testing/TestConsole"
@@ -112,15 +117,16 @@ export declare namespace TestConsole {
  * }).pipe(Effect.provide(TestConsole.layer))
  * ```
  *
- * @since 4.0.0
  * @category constructors
+ * @since 4.0.0
  */
 export declare const make: Effect.Effect<TestConsole, never, never>;
 /**
  * Retrieves the `TestConsole` service for this test and uses it to run the
  * specified workflow.
  *
- * @example
+ * **Example** (Accessing the test console service)
+ *
  * ```ts
  * import { Effect } from "effect"
  * import * as TestConsole from "effect/testing/TestConsole"
@@ -139,8 +145,8 @@ export declare const make: Effect.Effect<TestConsole, never, never>;
  * ).pipe(Effect.provide(TestConsole.layer))
  * ```
  *
- * @since 4.0.0
  * @category utils
+ * @since 4.0.0
  */
 export declare const testConsoleWith: <A, E, R>(f: (console: TestConsole) => Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>;
 /**
@@ -148,7 +154,8 @@ export declare const testConsoleWith: <A, E, R>(f: (console: TestConsole) => Eff
  * This layer can be used to provide a TestConsole implementation
  * for testing purposes.
  *
- * @example
+ * **Example** (Providing a test console layer)
+ *
  * ```ts
  * import { Console, Effect } from "effect"
  * import * as TestConsole from "effect/testing/TestConsole"
@@ -165,15 +172,16 @@ export declare const testConsoleWith: <A, E, R>(f: (console: TestConsole) => Eff
  * }).pipe(Effect.provide(TestConsole.layer))
  * ```
  *
- * @since 4.0.0
  * @category layers
+ * @since 4.0.0
  */
 export declare const layer: Layer.Layer<TestConsole>;
 /**
  * Returns an array of all items that have been logged by the program using
  * `Console.log` thus far.
  *
- * @example
+ * **Example** (Reading captured log lines)
+ *
  * ```ts
  * import { Console, Effect } from "effect"
  * import * as TestConsole from "effect/testing/TestConsole"
@@ -194,15 +202,16 @@ export declare const layer: Layer.Layer<TestConsole>;
  * }).pipe(Effect.provide(TestConsole.layer))
  * ```
  *
- * @since 4.0.0
  * @category utils
+ * @since 4.0.0
  */
 export declare const logLines: Effect.Effect<ReadonlyArray<unknown>, never, never>;
 /**
  * Returns an array of all items that have been logged by the program using
  * `Console.error` thus far.
  *
- * @example
+ * **Example** (Reading captured error lines)
+ *
  * ```ts
  * import { Console, Effect } from "effect"
  * import * as TestConsole from "effect/testing/TestConsole"
@@ -221,8 +230,8 @@ export declare const logLines: Effect.Effect<ReadonlyArray<unknown>, never, neve
  * }).pipe(Effect.provide(TestConsole.layer))
  * ```
  *
- * @since 4.0.0
  * @category utils
+ * @since 4.0.0
  */
 export declare const errorLines: Effect.Effect<ReadonlyArray<unknown>, never, never>;
 //# sourceMappingURL=TestConsole.d.ts.map

package/dist/testing/TestConsole.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TestConsole.d.ts","sourceRoot":"","sources":["../../src/testing/TestConsole.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,OAAO,MAAM,eAAe,CAAA;AACxC,OAAO,KAAK,MAAM,MAAM,cAAc,CAAA;AACtC,OAAO,KAAK,KAAK,MAAM,aAAa,CAAA;AAEpC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,WAAY,SAAQ,OAAO,CAAC,OAAO;IAClD;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAA;IACxD;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAA;CAC3D;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,OAAO,WAAW,WAAW,CAAC;IACnC;;;;;;;;;;;;;OAaG;IACH,KAAY,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAA;IAE1C;;;;;;;;;;;;;OAaG;IACH,UAAiB,KAAK;QACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;QACvB,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;KAC5C;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,IAAI,0CAsCf,CAAA;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,OAAO,EAAE,WAAW,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CACvD,CAAA;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,WAAW,CAA8C,CAAA;AAEzF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,KAAK,CAExE,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,KAAK,CAE1E,CAAA"}
+{"version":3,"file":"TestConsole.d.ts","sourceRoot":"","sources":["../../src/testing/TestConsole.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,OAAO,MAAM,eAAe,CAAA;AACxC,OAAO,KAAK,MAAM,MAAM,cAAc,CAAA;AACtC,OAAO,KAAK,KAAK,MAAM,aAAa,CAAA;AAEpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,WAAW,WAAY,SAAQ,OAAO,CAAC,OAAO;IAClD;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAA;IACxD;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAA;CAC3D;AAED;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,WAAW,WAAW,CAAC;IACnC;;;;;;;;;;;;;;;;OAgBG;IACH,KAAY,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAA;IAE1C;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,UAAiB,KAAK;QACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;QACvB,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;KAC5C;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,IAAI,0CAsCf,CAAA;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,OAAO,EAAE,WAAW,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CACvD,CAAA;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,WAAW,CAA8C,CAAA;AAEzF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,KAAK,CAExE,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,KAAK,CAE1E,CAAA"}