effect 2.0.0-next.8 → 2.0.0

package/dist/dts/Scope.d.ts

@@ -0,0 +1,131 @@
+/**
+ * @since 2.0.0
+ */
+import type * as Context from "./Context.js";
+import type * as Effect from "./Effect.js";
+import type * as ExecutionStrategy from "./ExecutionStrategy.js";
+import type * as Exit from "./Exit.js";
+import type { Pipeable } from "./Pipeable.js";
+/**
+ * @since 2.0.0
+ * @category symbols
+ */
+export declare const ScopeTypeId: unique symbol;
+/**
+ * @since 2.0.0
+ * @category symbols
+ */
+export type ScopeTypeId = typeof ScopeTypeId;
+/**
+ * @since 2.0.0
+ * @category symbols
+ */
+export declare const CloseableScopeTypeId: unique symbol;
+/**
+ * @since 2.0.0
+ * @category symbols
+ */
+export type CloseableScopeTypeId = typeof CloseableScopeTypeId;
+/**
+ * @since 2.0.0
+ * @category models
+ */
+export interface Scope extends Pipeable {
+    readonly [ScopeTypeId]: ScopeTypeId;
+    readonly strategy: ExecutionStrategy.ExecutionStrategy;
+}
+/**
+ * @since 2.0.0
+ * @category models
+ */
+export interface CloseableScope extends Scope, Pipeable {
+    readonly [CloseableScopeTypeId]: CloseableScopeTypeId;
+}
+/**
+ * @since 2.0.0
+ * @category context
+ */
+export declare const Scope: Context.Tag<Scope, Scope>;
+/**
+ * @since 2.0.0
+ */
+export declare namespace Scope {
+    /**
+     * @since 2.0.0
+     * @category model
+     */
+    type Finalizer = (exit: Exit.Exit<unknown, unknown>) => Effect.Effect<never, never, void>;
+    /**
+     * @since 2.0.0
+     * @category model
+     */
+    type Closeable = CloseableScope;
+}
+/**
+ * Adds a finalizer to this scope. The finalizer is guaranteed to be run when
+ * the scope is closed.
+ *
+ * @since 2.0.0
+ * @category utils
+ */
+export declare const addFinalizer: (self: Scope, finalizer: Effect.Effect<never, never, unknown>) => Effect.Effect<never, never, void>;
+/**
+ * A simplified version of `addFinalizerWith` when the `finalizer` does not
+ * depend on the `Exit` value that the scope is closed with.
+ *
+ * @since 2.0.0
+ * @category utils
+ */
+export declare const addFinalizerExit: (self: Scope, finalizer: Scope.Finalizer) => Effect.Effect<never, never, void>;
+/**
+ * Closes a scope with the specified exit value, running all finalizers that
+ * have been added to the scope.
+ *
+ * @since 2.0.0
+ * @category destructors
+ */
+export declare const close: (self: CloseableScope, exit: Exit.Exit<unknown, unknown>) => Effect.Effect<never, never, void>;
+/**
+ * Extends the scope of an `Effect` workflow that needs a scope into this
+ * scope by providing it to the workflow but not closing the scope when the
+ * workflow completes execution. This allows extending a scoped value into a
+ * larger scope.
+ *
+ * @since 2.0.0
+ * @category utils
+ */
+export declare const extend: {
+    (scope: Scope): <R, E, A>(effect: Effect.Effect<R, E, A>) => Effect.Effect<Exclude<R, Scope>, E, A>;
+    <R, E, A>(effect: Effect.Effect<R, E, A>, scope: Scope): Effect.Effect<Exclude<R, Scope>, E, A>;
+};
+/**
+ * Forks a new scope that is a child of this scope. The child scope will
+ * automatically be closed when this scope is closed.
+ *
+ * @since 2.0.0
+ * @category utils
+ */
+export declare const fork: (self: Scope, strategy: ExecutionStrategy.ExecutionStrategy) => Effect.Effect<never, never, CloseableScope>;
+/**
+ * Uses the scope by providing it to an `Effect` workflow that needs a scope,
+ * guaranteeing that the scope is closed with the result of that workflow as
+ * soon as the workflow completes execution, whether by success, failure, or
+ * interruption.
+ *
+ * @since 2.0.0
+ * @category destructors
+ */
+export declare const use: {
+    (scope: CloseableScope): <R, E, A>(effect: Effect.Effect<R, E, A>) => Effect.Effect<Exclude<R, Scope>, E, A>;
+    <R, E, A>(effect: Effect.Effect<R, E, A>, scope: CloseableScope): Effect.Effect<Exclude<R, Scope>, E, A>;
+};
+/**
+ * Creates a Scope where Finalizers will run according to the `ExecutionStrategy`.
+ *
+ * If an ExecutionStrategy is not provided `sequential` will be used.
+ *
+ * @since 2.0.0
+ * @category constructors
+ */
+export declare const make: (executionStrategy?: ExecutionStrategy.ExecutionStrategy) => Effect.Effect<never, never, CloseableScope>;
+//# sourceMappingURL=Scope.d.ts.map

package/dist/dts/Scope.d.ts.map

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

package/dist/dts/ScopedCache.d.ts

@@ -0,0 +1,127 @@
+/**
+ * @since 2.0.0
+ */
+import type * as Cache from "./Cache.js";
+import type * as Duration from "./Duration.js";
+import type * as Effect from "./Effect.js";
+import type * as Exit from "./Exit.js";
+import type * as Option from "./Option.js";
+import type { Pipeable } from "./Pipeable.js";
+import type * as Scope from "./Scope.js";
+import type * as Types from "./Types.js";
+/**
+ * @since 2.0.0
+ * @category symbols
+ */
+export declare const ScopedCacheTypeId: unique symbol;
+/**
+ * @since 2.0.0
+ * @category symbols
+ */
+export type ScopedCacheTypeId = typeof ScopedCacheTypeId;
+/**
+ * @since 2.0.0
+ * @category models
+ */
+export interface ScopedCache<in Key, out Error, out Value> extends ScopedCache.Variance<Key, Error, Value>, Pipeable {
+    /**
+     * Retrieves the value associated with the specified key if it exists.
+     * Otherwise returns `Option.none`.
+     */
+    getOption(key: Key): Effect.Effect<Scope.Scope, Error, Option.Option<Value>>;
+    /**
+     * Retrieves the value associated with the specified key if it exists and the
+     * lookup function has completed. Otherwise returns `Option.none`.
+     */
+    getOptionComplete(key: Key): Effect.Effect<Scope.Scope, never, Option.Option<Value>>;
+    /**
+     * Returns statistics for this cache.
+     */
+    readonly cacheStats: Effect.Effect<never, never, Cache.CacheStats>;
+    /**
+     * Return whether a resource associated with the specified key exists in the
+     * cache. Sometime `contains` can return true if the resource is currently
+     * being created but not yet totally created.
+     */
+    contains(key: Key): Effect.Effect<never, never, boolean>;
+    /**
+     * Return statistics for the specified entry.
+     */
+    entryStats(key: Key): Effect.Effect<never, never, Option.Option<Cache.EntryStats>>;
+    /**
+     * Gets the value from the cache if it exists or otherwise computes it, the
+     * release action signals to the cache that the value is no longer being used
+     * and can potentially be finalized subject to the policies of the cache.
+     */
+    get(key: Key): Effect.Effect<Scope.Scope, Error, Value>;
+    /**
+     * Invalidates the resource associated with the specified key.
+     */
+    invalidate(key: Key): Effect.Effect<never, never, void>;
+    /**
+     * Invalidates all values in the cache.
+     */
+    readonly invalidateAll: Effect.Effect<never, never, void>;
+    /**
+     * Force the reuse of the lookup function to compute the returned scoped
+     * effect associated with the specified key immediately. Once the new resource
+     * is recomputed, the old resource associated to the key is cleaned (once all
+     * fiber using it are done with it). During the time the new resource is
+     * computed, concurrent call the .get will use the old resource if this one is
+     * not expired.
+     */
+    refresh(key: Key): Effect.Effect<never, Error, void>;
+    /**
+     * Returns the approximate number of values in the cache.
+     */
+    readonly size: Effect.Effect<never, never, number>;
+}
+/**
+ * @since 2.0.0
+ */
+export declare namespace ScopedCache {
+    /**
+     * @since 2.0.0
+     * @category models
+     */
+    interface Variance<in Key, out Error, out Value> {
+        readonly [ScopedCacheTypeId]: {
+            _Key: Types.Contravariant<Key>;
+            _Error: Types.Covariant<Error>;
+            _Value: Types.Covariant<Value>;
+        };
+    }
+}
+/**
+ * Constructs a new cache with the specified capacity, time to live, and
+ * lookup function.
+ *
+ * @since 2.0.0
+ * @category constructors
+ */
+export declare const make: <Key, Environment, Error, Value>(options: {
+    readonly lookup: Lookup<Key, Environment, Error, Value>;
+    readonly capacity: number;
+    readonly timeToLive: Duration.DurationInput;
+}) => Effect.Effect<Scope.Scope | Environment, never, ScopedCache<Key, Error, Value>>;
+/**
+ * Constructs a new cache with the specified capacity, time to live, and
+ * lookup function, where the time to live can depend on the `Exit` value
+ * returned by the lookup function.
+ *
+ * @since 2.0.0
+ * @category constructors
+ */
+export declare const makeWith: <Key, Environment, Error, Value>(options: {
+    readonly capacity: number;
+    readonly lookup: Lookup<Key, Environment, Error, Value>;
+    readonly timeToLive: (exit: Exit.Exit<Error, Value>) => Duration.DurationInput;
+}) => Effect.Effect<Scope.Scope | Environment, never, ScopedCache<Key, Error, Value>>;
+/**
+ * Similar to `Cache.Lookup`, but executes the lookup function within a `Scope`.
+ *
+ * @since 2.0.0
+ * @category models
+ */
+export type Lookup<Key, Environment, Error, Value> = (key: Key) => Effect.Effect<Environment | Scope.Scope, Error, Value>;
+//# sourceMappingURL=ScopedCache.d.ts.map

package/dist/dts/ScopedCache.d.ts.map

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

package/dist/dts/ScopedRef.d.ts

@@ -0,0 +1,83 @@
+/**
+ * @since 2.0.0
+ */
+import type * as Effect from "./Effect.js";
+import type { LazyArg } from "./Function.js";
+import type { Pipeable } from "./Pipeable.js";
+import type * as Scope from "./Scope.js";
+import type * as Types from "./Types.js";
+/**
+ * @since 2.0.0
+ * @category symbols
+ */
+export declare const ScopedRefTypeId: unique symbol;
+/**
+ * @since 2.0.0
+ * @category symbols
+ */
+export type ScopedRefTypeId = typeof ScopedRefTypeId;
+/**
+ * A `ScopedRef` is a reference whose value is associated with resources,
+ * which must be released properly. You can both get the current value of any
+ * `ScopedRef`, as well as set it to a new value (which may require new
+ * resources). The reference itself takes care of properly releasing resources
+ * for the old value whenever a new value is obtained.
+ *
+ * @since 2.0.0
+ * @category models
+ */
+export interface ScopedRef<in out A> extends ScopedRef.Variance<A>, Pipeable {
+}
+/**
+ * @since 2.0.0
+ */
+export declare namespace ScopedRef {
+    /**
+     * @since 2.0.0
+     * @category models
+     */
+    interface Variance<in out A> {
+        readonly [ScopedRefTypeId]: {
+            readonly _A: Types.Invariant<A>;
+        };
+    }
+}
+/**
+ * Creates a new `ScopedRef` from an effect that resourcefully produces a
+ * value.
+ *
+ * @since 2.0.0
+ * @category constructors
+ */
+export declare const fromAcquire: <R, E, A>(acquire: Effect.Effect<R, E, A>) => Effect.Effect<Scope.Scope | R, E, ScopedRef<A>>;
+/**
+ * Retrieves the current value of the scoped reference.
+ *
+ * @since 2.0.0
+ * @category getters
+ */
+export declare const get: <A>(self: ScopedRef<A>) => Effect.Effect<never, never, A>;
+/**
+ * Creates a new `ScopedRef` from the specified value. This method should
+ * not be used for values whose creation require the acquisition of resources.
+ *
+ * @since 2.0.0
+ * @category constructors
+ */
+export declare const make: <A>(evaluate: LazyArg<A>) => Effect.Effect<Scope.Scope, never, ScopedRef<A>>;
+/**
+ * Sets the value of this reference to the specified resourcefully-created
+ * value. Any resources associated with the old value will be released.
+ *
+ * This method will not return until either the reference is successfully
+ * changed to the new value, with old resources released, or until the attempt
+ * to acquire a new value fails.
+ *
+ * @since 2.0.0
+ * @category getters
+ */
+export declare const set: {
+    <A, R, E>(acquire: Effect.Effect<R, E, A>): (self: ScopedRef<A>) => Effect.Effect<Exclude<R, Scope.Scope>, E, void>;
+    <A, R, E>(self: ScopedRef<A>, acquire: Effect.Effect<R, E, A>): Effect.Effect<Exclude<R, Scope.Scope>, E, void>;
+};
+//# sourceMappingURL=ScopedRef.d.ts.map

package/dist/dts/ScopedRef.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScopedRef.d.ts","sourceRoot":"","sources":["../../src/ScopedRef.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,KAAK,MAAM,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAE5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAA;AAExC,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAA;AAExC;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,OAAO,MAAiC,CAAA;AAEtE;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAA;AAEpD;;;;;;;;;GASG;AACH,MAAM,WAAW,SAAS,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAE,SAAQ,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ;CAG3E;AAED;;GAEG;AACH,MAAM,CAAC,OAAO,WAAW,SAAS,CAAC;IACjC;;;OAGG;IACH,UAAiB,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;QAChC,QAAQ,CAAC,CAAC,eAAe,CAAC,EAAE;YAC1B,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;SAChC,CAAA;KACF;CACF;AAED;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAChC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAC5B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAwB,CAAA;AAE3E;;;;;GAKG;AACH,eAAO,MAAM,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAgB,CAAA;AAE1F;;;;;;GAMG;AACH,eAAO,MAAM,IAAI,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,CAAiB,CAAA;AAE/G;;;;;;;;;;GAUG;AACH,eAAO,MAAM,GAAG,EAAE;IAChB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAA;IACnH,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAA;CACjG,CAAA"}

package/dist/dts/Secret.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @since 2.0.0
+ */
+import type * as Equal from "./Equal.js";
+/**
+ * @since 2.0.0
+ * @category symbols
+ */
+export declare const SecretTypeId: unique symbol;
+/**
+ * @since 2.0.0
+ * @category symbols
+ */
+export type SecretTypeId = typeof SecretTypeId;
+/**
+ * @since 2.0.0
+ * @category models
+ */
+export interface Secret extends Secret.Proto, Equal.Equal {
+}
+/**
+ * @since 2.0.0
+ */
+export declare namespace Secret {
+    /**
+     * @since 2.0.0
+     * @category models
+     */
+    interface Proto {
+        readonly [SecretTypeId]: SecretTypeId;
+    }
+}
+/**
+ * @since 2.0.0
+ * @category refinements
+ */
+export declare const isSecret: (u: unknown) => u is Secret;
+/**
+ * @since 2.0.0
+ * @category constructors
+ */
+export declare const make: (bytes: Array<number>) => Secret;
+/**
+ * @since 2.0.0
+ * @category constructors
+ */
+export declare const fromIterable: (iterable: Iterable<string>) => Secret;
+/**
+ * @since 2.0.0
+ * @category constructors
+ */
+export declare const fromString: (text: string) => Secret;
+/**
+ * @since 2.0.0
+ * @category getters
+ */
+export declare const value: (self: Secret) => string;
+/**
+ * @since 2.0.0
+ * @category unsafe
+ */
+export declare const unsafeWipe: (self: Secret) => void;
+//# sourceMappingURL=Secret.d.ts.map

package/dist/dts/Secret.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Secret.d.ts","sourceRoot":"","sources":["../../src/Secret.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAA;AAGxC;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,OAAO,MAAoC,CAAA;AAEtE;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,YAAY,CAAA;AAE9C;;;GAGG;AACH,MAAM,WAAW,MAAO,SAAQ,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK;CAGxD;AAED;;GAEG;AACH,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B;;;OAGG;IACH,UAAiB,KAAK;QACpB,QAAQ,CAAC,CAAC,YAAY,CAAC,EAAE,YAAY,CAAA;KACtC;CACF;AAED;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,CAAC,IAAI,MAAgC,CAAA;AAE5E;;;GAGG;AACH,eAAO,MAAM,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,MAA4B,CAAA;AAEzE;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,MAAoC,CAAA;AAE/F;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAkC,CAAA;AAE7E;;;GAGG;AACH,eAAO,MAAM,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAA6B,CAAA;AAEnE;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAgC,CAAA"}

package/dist/dts/SingleProducerAsyncInput.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @since 2.0.0
+ */
+import type * as Cause from "./Cause.js";
+import type * as Effect from "./Effect.js";
+import type * as Either from "./Either.js";
+import type * as Exit from "./Exit.js";
+/**
+ * An MVar-like abstraction for sending data to channels asynchronously which is
+ * designed for one producer and multiple consumers.
+ *
+ * Features the following semantics:
+ *   - Buffer of size 1.
+ *   - When emitting, the producer waits for a consumer to pick up the value to
+ *     prevent "reading ahead" too much.
+ *   - Once an emitted element is read by a consumer, it is cleared from the
+ *     buffer, so that at most one consumer sees every emitted element.
+ *   - When sending a done or error signal, the producer does not wait for a
+ *     consumer to pick up the signal. The signal stays in the buffer after
+ *     being read by a consumer, so it can be propagated to multiple consumers.
+ *   - Trying to publish another emit/error/done after an error/done have
+ *     already been published results in an interruption.
+ *
+ * @since 2.0.0
+ * @category models
+ */
+export interface SingleProducerAsyncInput<in out Err, in out Elem, in out Done> extends AsyncInputProducer<Err, Elem, Done>, AsyncInputConsumer<Err, Elem, Done> {
+    readonly close: Effect.Effect<never, never, unknown>;
+    readonly take: Effect.Effect<never, never, Exit.Exit<Either.Either<Err, Done>, Elem>>;
+}
+/**
+ * Producer-side view of `SingleProducerAsyncInput` for variance purposes.
+ *
+ * @since 2.0.0
+ * @category models
+ */
+export interface AsyncInputProducer<in Err, in Elem, in Done> {
+    awaitRead(): Effect.Effect<never, never, unknown>;
+    done(value: Done): Effect.Effect<never, never, unknown>;
+    emit(element: Elem): Effect.Effect<never, never, unknown>;
+    error(cause: Cause.Cause<Err>): Effect.Effect<never, never, unknown>;
+}
+/**
+ * Consumer-side view of `SingleProducerAsyncInput` for variance purposes.
+ *
+ * @since 2.0.0
+ * @category models
+ */
+export interface AsyncInputConsumer<out Err, out Elem, out Done> {
+    takeWith<A>(onError: (cause: Cause.Cause<Err>) => A, onElement: (element: Elem) => A, onDone: (value: Done) => A): Effect.Effect<never, never, A>;
+}
+/**
+ * @since 2.0.0
+ * @category constructors
+ */
+export declare const make: <Err, Elem, Done>() => Effect.Effect<never, never, SingleProducerAsyncInput<Err, Elem, Done>>;
+//# sourceMappingURL=SingleProducerAsyncInput.d.ts.map

package/dist/dts/SingleProducerAsyncInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SingleProducerAsyncInput.d.ts","sourceRoot":"","sources":["../../src/SingleProducerAsyncInput.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAA;AACxC,OAAO,KAAK,KAAK,MAAM,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,KAAK,MAAM,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,KAAK,IAAI,MAAM,WAAW,CAAA;AAGtC;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,wBAAwB,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAC5E,SAAQ,kBAAkB,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,kBAAkB,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC;IAEhF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAA;CACtF;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI;IAC1D,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;IACjD,IAAI,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;IACvD,IAAI,CAAC,OAAO,EAAE,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;IACzD,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;CACrE;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI;IAC7D,QAAQ,CAAC,CAAC,EACR,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EACvC,SAAS,EAAE,CAAC,OAAO,EAAE,IAAI,KAAK,CAAC,EAC/B,MAAM,EAAE,CAAC,KAAK,EAAE,IAAI,KAAK,CAAC,GACzB,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAA;CAClC;AAED;;;GAGG;AACH,eAAO,MAAM,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,wBAAwB,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,CAChG,CAAA"}