@satoshibits/functional 1.0.2

package/dist/predicates.mjs.map

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

package/dist/reader-result.d.mts

@@ -0,0 +1,422 @@
+/**
+ * @module reader-result
+ * @description Combines Reader (dependency injection) with Result (error handling)
+ * for asynchronous computations. This provides a powerful abstraction for
+ * building composable, testable applications with explicit error handling
+ * and dependency injection. Similar to fp-ts's ReaderTaskEither but tailored
+ * for our Result type and async/await patterns.
+ *
+ * @example
+ * ```typescript
+ * import { ReaderResult, liftAsync } from './reader-result.mts';
+ *
+ * // define dependencies
+ * interface Deps {
+ *   db: Database;
+ *   logger: Logger;
+ *   config: Config;
+ * }
+ *
+ * // create reusable operations
+ * const getUser = (id: string): ReaderResult<Deps, string, User> =>
+ *   ReaderResult.tryCatch(
+ *     async (deps) => deps.db.users.findById(id),
+ *     (error) => `Failed to fetch user: ${error}`
+ *   );
+ *
+ * // compose operations
+ * const program = ReaderResult.Do()
+ *   .pipe(ReaderResult.bind('user', () => getUser('123')))
+ *   .pipe(ReaderResult.bind('posts', ({ user }) => getUserPosts(user.id)))
+ *   .pipe(ReaderResult.map(({ user, posts }) => ({ ...user, posts })));
+ *
+ * // run with dependencies
+ * const result = await ReaderResult.run(dependencies)(program);
+ * ```
+ *
+ * @category Core
+ * @since 2025-07-03
+ */
+import type { Result } from './result.mjs';
+/**
+ * A computation that:
+ * - Reads from dependencies (R)
+ * - Is asynchronous (Promise)
+ * - Can fail with error E or succeed with value A
+ *
+ * @template R - The type of dependencies required by the computation
+ * @template E - The type of error that can occur
+ * @template A - The type of the success value
+ *
+ * @category Core Types
+ * @since 2025-07-03
+ */
+export type ReaderResult<R, E, A> = (deps: R) => Promise<Result<A, E>>;
+/**
+ * Constructors and combinators for ReaderResult
+ */
+export declare const ReaderResult: {
+    /**
+     * Lift a pure value into ReaderResult context.
+     * @description Creates a ReaderResult that always succeeds with the given value,
+     * ignoring the dependencies.
+     *
+     * @template R - The type of dependencies
+     * @template E - The error type
+     * @template A - The type of the value
+     * @param {A} value - The value to wrap
+     * @returns {ReaderResult<R, E, A>} A ReaderResult that always succeeds with the value
+     *
+     * @category Constructors
+     * @example
+     * const always42 = ReaderResult.of<Deps, string, number>(42);
+     * const result = await ReaderResult.run(deps)(always42);
+     * // => { success: true, data: 42 }
+     *
+     * @since 2025-07-03
+     */
+    of: <R, E, A>(value: A) => ReaderResult<R, E, A>;
+    /**
+     * Lift an error into ReaderResult context.
+     * @description Creates a ReaderResult that always fails with the given error,
+     * ignoring the dependencies.
+     *
+     * @template R - The type of dependencies
+     * @template E - The error type
+     * @template A - The success type
+     * @param {E} error - The error to wrap
+     * @returns {ReaderResult<R, E, A>} A ReaderResult that always fails with the error
+     *
+     * @category Constructors
+     * @example
+     * const alwaysFails = ReaderResult.fail<Deps, string, User>('User not found');
+     * const result = await ReaderResult.run(deps)(alwaysFails);
+     * // => { success: false, error: 'User not found' }
+     *
+     * @since 2025-07-03
+     */
+    fail: <R, E, A>(error: E) => ReaderResult<R, E, A>;
+    /**
+     * Sequential composition - the heart of ReaderResult.
+     * @description If first computation fails, short-circuit. Otherwise, feed result to next computation.
+     * This is the monadic bind operation that enables chaining ReaderResult computations.
+     *
+     * @template R - The type of dependencies
+     * @template E - The error type
+     * @template A - The input value type
+     * @template B - The output value type
+     * @param {(a: A) => ReaderResult<R, E, B>} f - Function that takes the success value and returns a new ReaderResult
+     * @returns {(ma: ReaderResult<R, E, A>) => ReaderResult<R, E, B>} A function that chains ReaderResults
+     *
+     * @category Combinators
+     * @example
+     * const getUser = (id: string): ReaderResult<Deps, string, User> => ...
+     * const getUserPosts = (userId: string): ReaderResult<Deps, string, Post[]> => ...
+     *
+     * const getUserWithPosts = ReaderResult.chain((user: User) =>
+     *   ReaderResult.map((posts: Post[]) => ({ ...user, posts }))(getUserPosts(user.id))
+     * )(getUser('123'));
+     *
+     * @since 2025-07-03
+     */
+    chain: <R, E, A, B>(f: (a: A) => ReaderResult<R, E, B>) => (ma: ReaderResult<R, E, A>) => ReaderResult<R, E, B>;
+    /**
+     * Map a pure function over the success value.
+     * @description Transforms the success value using a pure function. If the computation
+     * fails, the error is propagated unchanged.
+     *
+     * @template R - The type of dependencies
+     * @template E - The error type
+     * @template A - The input value type
+     * @template B - The output value type
+     * @param {(a: A) => B} f - Function to transform the success value
+     * @returns {(ma: ReaderResult<R, E, A>) => ReaderResult<R, E, B>} A function that maps over ReaderResult
+     *
+     * @category Transformations
+     * @example
+     * const double = ReaderResult.map((n: number) => n * 2);
+     * const program = double(ReaderResult.of<Deps, string, number>(21));
+     * const result = await ReaderResult.run(deps)(program);
+     * // => { success: true, data: 42 }
+     *
+     * @since 2025-07-03
+     */
+    map: <R, E, A, B>(f: (a: A) => B) => (ma: ReaderResult<R, E, A>) => ReaderResult<R, E, B>;
+    /**
+     * Map a function over the error value.
+     * @description Transforms the error value using a pure function. If the computation
+     * succeeds, the success value is propagated unchanged.
+     *
+     * @template R - The type of dependencies
+     * @template E - The input error type
+     * @template F - The output error type
+     * @template A - The value type
+     * @param {(e: E) => F} f - Function to transform the error
+     * @returns {(ma: ReaderResult<R, E, A>) => ReaderResult<R, F, A>} A function that maps over errors
+     *
+     * @category Transformations
+     * @example
+     * const enrichError = ReaderResult.mapError((e: string) => ({
+     *   message: e,
+     *   timestamp: new Date()
+     * }));
+     *
+     * @since 2025-07-03
+     */
+    mapError: <R, E, F, A>(f: (e: E) => F) => (ma: ReaderResult<R, E, A>) => ReaderResult<R, F, A>;
+    /**
+     * Access the dependencies.
+     * @description Returns a ReaderResult that succeeds with the current dependencies.
+     * Useful when you need to access the dependencies within a computation chain.
+     *
+     * @template R - The type of dependencies
+     * @template E - The error type
+     * @returns {ReaderResult<R, E, R>} A ReaderResult that returns the dependencies
+     *
+     * @category Dependencies
+     * @example
+     * const program = ReaderResult.Do()
+     *   .pipe(ReaderResult.bind('deps', () => ReaderResult.ask<Deps, string>()))
+     *   .pipe(ReaderResult.bind('config', ({ deps }) =>
+     *     ReaderResult.of(deps.config)
+     *   ));
+     *
+     * @since 2025-07-03
+     */
+    ask: <R, E>() => ReaderResult<R, E, R>;
+    /**
+     * Access a part of the dependencies.
+     * @description Returns a ReaderResult that succeeds with a projection of the dependencies.
+     * Useful for extracting specific values from the dependency container.
+     *
+     * @template R - The type of dependencies
+     * @template E - The error type
+     * @template A - The type of the extracted value
+     * @param {(deps: R) => A} f - Function to extract a value from dependencies
+     * @returns {ReaderResult<R, E, A>} A ReaderResult that returns the extracted value
+     *
+     * @category Dependencies
+     * @example
+     * const getConfig = ReaderResult.asks<Deps, string, Config>(deps => deps.config);
+     * const getLogger = ReaderResult.asks<Deps, string, Logger>(deps => deps.logger);
+     *
+     * @since 2025-07-03
+     */
+    asks: <R, E, A>(f: (deps: R) => A) => ReaderResult<R, E, A>;
+    /**
+     * Lift a Result into ReaderResult
+     */
+    fromResult: <R, E, A>(result: Result<A, E>) => ReaderResult<R, E, A>;
+    /**
+     * Lift an async operation that might throw into ReaderResult
+     */
+    tryCatch: <R, E, A>(f: (deps: R) => Promise<A>, onError: (error: unknown) => E) => ReaderResult<R, E, A>;
+    /**
+     * Execute ReaderResult with dependencies
+     */
+    run: <R, E, A>(deps: R) => (ma: ReaderResult<R, E, A>) => Promise<Result<A, E>>;
+    /**
+     * Combine two ReaderResults in parallel.
+     * @description Runs two ReaderResult computations in parallel and combines their results
+     * into a tuple. If either fails, returns the first failure.
+     *
+     * @template R - The type of dependencies
+     * @template E - The error type
+     * @template A - The first value type
+     * @template B - The second value type
+     * @param {ReaderResult<R, E, A>} ma - First computation
+     * @param {ReaderResult<R, E, B>} mb - Second computation
+     * @returns {ReaderResult<R, E, [A, B]>} A ReaderResult containing a tuple of both results
+     *
+     * @category Combinations
+     * @example
+     * const userAndPosts = ReaderResult.zip(
+     *   getUser('123'),
+     *   getUserPosts('123')
+     * );
+     *
+     * @since 2025-07-03
+     */
+    zip: <R, E, A, B>(ma: ReaderResult<R, E, A>, mb: ReaderResult<R, E, B>) => ReaderResult<R, E, [A, B]>;
+    /**
+     * Sequence an array of ReaderResults.
+     * @description Transforms an array of ReaderResults into a ReaderResult of an array.
+     * Executes each computation sequentially. If any fails, returns the first failure.
+     *
+     * @template R - The type of dependencies
+     * @template E - The error type
+     * @template A - The value type
+     * @param {readonly ReaderResult<R, E, A>[]} rrs - Array of ReaderResult computations
+     * @returns {ReaderResult<R, E, readonly A[]>} A ReaderResult containing an array of all results
+     *
+     * @category Combinations
+     * @example
+     * const userIds = ['123', '456', '789'];
+     * const getUsers = ReaderResult.sequence(
+     *   userIds.map(id => getUser(id))
+     * );
+     *
+     * @since 2025-07-03
+     */
+    sequence: <R, E, A>(rrs: readonly ReaderResult<R, E, A>[]) => ReaderResult<R, E, readonly A[]>;
+    /**
+     * Do notation for building up computations.
+     * @description Starts a Do notation chain for building complex computations
+     * in a more imperative style. Use with bind and let methods.
+     *
+     * @template R - The type of dependencies
+     * @template E - The error type
+     * @returns {ReaderResult<R, E, Record<string, never>>} An empty ReaderResult to start the chain
+     *
+     * @category Do Notation
+     * @example
+     * const program = ReaderResult.Do<Deps, string>()
+     *   .pipe(ReaderResult.bind('user', () => getUser('123')))
+     *   .pipe(ReaderResult.bind('posts', ({ user }) => getUserPosts(user.id)))
+     *   .pipe(ReaderResult.let('postCount', ({ posts }) => posts.length))
+     *   .pipe(ReaderResult.map(({ user, posts, postCount }) => ({
+     *     ...user,
+     *     posts,
+     *     stats: { postCount }
+     *   })));
+     *
+     * @since 2025-07-03
+     */
+    Do: <R, E>() => ReaderResult<R, E, Record<string, never>>;
+    /**
+     * Bind a computation result to a name (for Do notation)
+     */
+    bind: <R, E, A extends object, K extends string, B>(name: K, f: (a: A) => ReaderResult<R, E, B>) => (fa: ReaderResult<R, E, A>) => ReaderResult<R, E, A & Record<K, B>>;
+    /**
+     * Bind a value to a name (for Do notation)
+     */
+    let: <R, E, A extends object, K extends string, B>(name: K, f: (a: A) => B) => (fa: ReaderResult<R, E, A>) => ReaderResult<R, E, A & Record<K, B>>;
+    /**
+     * Provides a fallback ReaderResult if the original fails.
+     * @description The fallback function receives the error and returns a new ReaderResult.
+     * Useful for error recovery or providing default values.
+     *
+     * @template R - The type of dependencies
+     * @template E - The input error type
+     * @template F - The output error type
+     * @template A - The value type
+     * @param {(error: E) => ReaderResult<R, F, A>} onError - Function to handle the error
+     * @returns {(ma: ReaderResult<R, E, A>) => ReaderResult<R, F, A>} A function that adds fallback behavior
+     *
+     * @category Error Handling
+     * @example
+     * const getUserWithFallback = ReaderResult.orElse(
+     *   (error: string) => getDefaultUser()
+     * )(getUser('123'));
+     *
+     * @since 2025-07-03
+     */
+    orElse: <R, E, F, A>(onError: (error: E) => ReaderResult<R, F, A>) => (ma: ReaderResult<R, E, A>) => ReaderResult<R, F, A>;
+    /**
+     * Timeout for ReaderResult computations.
+     * If the computation doesn't complete within the specified time, it fails with the timeout error.
+     */
+    timeout: <R, E, A>(ms: number, timeoutError: E) => (ma: ReaderResult<R, E, A>) => ReaderResult<R, E, A>;
+    /**
+     * Retry a ReaderResult computation with exponential backoff.
+     * Only retries on failures, not on successful results.
+     */
+    retry: <R, E, A>(maxAttempts: number, baseDelay?: number, shouldRetry?: (error: E, attempt: number) => boolean) => (ma: ReaderResult<R, E, A>) => ReaderResult<R, E, A>;
+    /**
+     * Execute multiple ReaderResults in parallel and collect all results.
+     * @description Similar to sequence but runs in parallel rather than sequentially.
+     * More efficient for independent computations but still fails fast on first error.
+     *
+     * @template R - The type of dependencies
+     * @template E - The error type
+     * @template A - The value type
+     * @param {readonly ReaderResult<R, E, A>[]} rrs - Array of ReaderResult computations
+     * @returns {ReaderResult<R, E, readonly A[]>} A ReaderResult containing an array of all results
+     *
+     * @category Combinations
+     * @example
+     * // Fetch multiple users in parallel
+     * const userIds = ['123', '456', '789'];
+     * const getUsers = ReaderResult.sequencePar(
+     *   userIds.map(id => getUser(id))
+     * );
+     *
+     * @since 2025-07-03
+     */
+    sequencePar: <R, E, A>(rrs: readonly ReaderResult<R, E, A>[]) => ReaderResult<R, E, readonly A[]>;
+    /**
+     * Combine multiple ReaderResults in parallel into a tuple.
+     * Extends zip to work with any number of ReaderResults.
+     */
+    zipAll: <R, E, T extends readonly ReaderResult<R, E, unknown>[]>(...rrs: T) => ReaderResult<R, E, { [K in keyof T]: T[K] extends ReaderResult<R, E, infer A> ? A : never; }>;
+    /**
+     * Run multiple ReaderResults in parallel and collect all results or all errors.
+     * @description Unlike sequencePar, this doesn't short-circuit on the first error.
+     * Collects all errors if any computations fail, making it useful for validation scenarios.
+     *
+     * @template R - The type of dependencies
+     * @template E - The error type
+     * @template T - The record type mapping keys to ReaderResults
+     *
+     * @category Combinations
+     * @example
+     * const validation = ReaderResult.parallel({
+     *   name: validateName(input.name),
+     *   email: validateEmail(input.email),
+     *   age: validateAge(input.age)
+     * });
+     * // If any fail, returns all failures
+     *
+     * @since 2025-07-03
+     */
+    parallel: <R, E, T extends Record<string, ReaderResult<R, E, unknown>>>(rrs: T) => ReaderResult<R, {
+        key: keyof T;
+        error: E;
+    }[], { [K in keyof T]: T[K] extends ReaderResult<R, E, infer A> ? A : never; }>;
+};
+/**
+ * Helper to create ReaderResult from a domain function that returns Result.
+ * @description Lifts a pure function that returns a Result into the ReaderResult context.
+ * Useful for integrating existing Result-based functions.
+ *
+ * @template R - The type of dependencies
+ * @template E - The error type
+ * @template A - The value type
+ * @template Args - The argument types
+ * @param {(...args: Args) => Result<A, E>} f - Function that returns a Result
+ * @returns {(...args: Args) => ReaderResult<R, E, A>} A function that returns a ReaderResult
+ *
+ * @category Helpers
+ * @example
+ * const validateAge = (age: number): Result<number, string> =>
+ *   age >= 18 ? Result.ok(age) : Result.err('Must be 18 or older');
+ *
+ * const validateAgeRR = liftDomain<Deps, string, number, [number]>(validateAge);
+ *
+ * @since 2025-07-03
+ */
+export declare const liftDomain: <R, E, A, Args extends unknown[]>(f: (...args: Args) => Result<A, E>) => (...args: Args) => ReaderResult<R, E, A>;
+/**
+ * Helper to create ReaderResult from an async function that might throw.
+ * @description Lifts an async function that might throw into the ReaderResult context,
+ * converting exceptions to typed errors.
+ *
+ * @template R - The type of dependencies
+ * @template E - The error type
+ * @template A - The value type
+ * @template Args - The argument types
+ * @param {(deps: R, ...args: Args) => Promise<A>} f - Async function that might throw
+ * @param {(error: unknown) => E} onError - Function to convert exceptions to errors
+ * @returns {(...args: Args) => ReaderResult<R, E, A>} A function that returns a ReaderResult
+ *
+ * @category Helpers
+ * @example
+ * const fetchUser = liftAsync<Deps, string, User, [string]>(
+ *   async (deps, id) => deps.api.getUser(id),
+ *   (error) => `Failed to fetch user: ${error}`
+ * );
+ *
+ * @since 2025-07-03
+ */
+export declare const liftAsync: <R, E, A, Args extends unknown[]>(f: (deps: R, ...args: Args) => Promise<A>, onError: (error: unknown) => E) => (...args: Args) => ReaderResult<R, E, A>;
+//# sourceMappingURL=reader-result.d.mts.map

package/dist/reader-result.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader-result.d.mts","sourceRoot":"","sources":["../src/reader-result.mts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAEvE;;GAEG;AACH,eAAO,MAAM,YAAY;IACvB;;;;;;;;;;;;;;;;;;OAkBG;SACE,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,CAAC,KAAG,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAG9C;;;;;;;;;;;;;;;;;;OAkBG;WACI,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,CAAC,KAAG,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAGhD;;;;;;;;;;;;;;;;;;;;;;OAsBG;YACK,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KACb,CAAC,CAAC,EAAE,CAAC,KAAK,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,UAE9B,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KACxB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IASxB;;;;;;;;;;;;;;;;;;;;OAoBG;UACG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KACX,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,UAEV,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KACxB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAGxB;;;;;;;;;;;;;;;;;;;;OAoBG;eACQ,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAChB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,UAEV,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KACxB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAQxB;;;;;;;;;;;;;;;;;;OAkBG;UACG,CAAC,EAAE,CAAC,OAAK,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAGpC;;;;;;;;;;;;;;;;;OAiBG;WACI,CAAC,EAAE,CAAC,EAAE,CAAC,KACT,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAChB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAGxB;;OAEG;iBACU,CAAC,EAAE,CAAC,EAAE,CAAC,UACV,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,KACnB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAGxB;;OAEG;eACQ,CAAC,EAAE,CAAC,EAAE,CAAC,KACb,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,WACjB,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC,KAC7B,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAUxB;;OAEG;UACG,CAAC,EAAE,CAAC,EAAE,CAAC,QACL,CAAC,UAEH,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KACxB,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAGxB;;;;;;;;;;;;;;;;;;;;;OAqBG;UACG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,MACV,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,MACrB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KACxB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAa7B;;;;;;;;;;;;;;;;;;;OAmBG;eACQ,CAAC,EAAE,CAAC,EAAE,CAAC,OACX,SAAS,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,KACpC,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC;IAenC;;;;;;;;;;;;;;;;;;;;;;OAsBG;SACE,CAAC,EAAE,CAAC,OAAK,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAGvD;;OAEG;WACI,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EAAE,CAAC,QAC1C,CAAC,KACJ,CAAC,CAAC,EAAE,CAAC,KAAK,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,UAE9B,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KACxB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAKvC;;OAEG;UACG,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EAAE,CAAC,QACzC,CAAC,KACJ,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,UAEV,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KACxB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAGvC;;;;;;;;;;;;;;;;;;;OAmBG;aACM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,WACR,CAAC,KAAK,EAAE,CAAC,KAAK,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,UAExC,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KACxB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IASxB;;;OAGG;cACO,CAAC,EAAE,CAAC,EAAE,CAAC,MACX,MAAM,gBACI,CAAC,UAEX,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KACxB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IASxB;;;OAGG;YACK,CAAC,EAAE,CAAC,EAAE,CAAC,eACA,MAAM,oCAEN,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,UAE/C,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KACxB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IA4BxB;;;;;;;;;;;;;;;;;;;;OAoBG;kBACW,CAAC,EAAE,CAAC,EAAE,CAAC,OACd,SAAS,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,KACpC,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC;IAenC;;;OAGG;aACM,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,SAAS,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,UACrD,CAAC,KACR,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,GAAE,CAAC;IAe/F;;;;;;;;;;;;;;;;;;;OAmBG;eACQ,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,OAC/D,CAAC,KACL,YAAY,CAAC,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC,CAAC;QAAC,KAAK,EAAE,CAAC,CAAA;KAAE,EAAE,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,GAAE,CAAC;CAsB3H,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,SAAS,OAAO,EAAE,KACrD,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,eAEzB,IAAI,KACZ,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CACc,CAAC;AAEtC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,SAAS,OAAO,EAAE,KACpD,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,WAChC,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC,eAErB,IAAI,KACZ,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAIpB,CAAC"}