@ic-reactor/react 3.13.0 → 4.0.0-beta.2

package/dist/createInfiniteQuery.js

@@ -1,198 +0,0 @@
-/**
- * Infinite Query Factory - Generic wrapper for React Query paginated canister data
- *
- * Creates unified fetch/hook/invalidate functions for any paginated canister method.
- * Works with any Reactor instance.
- *
- * @example
- * const postsQuery = createInfiniteQuery(reactor, {
- *   functionName: "get_posts",
- *   initialPageParam: 0,
- *   getArgs: (cursor) => [{ cursor, limit: 10 }] as const,
- *   getNextPageParam: (lastPage) => lastPage.nextCursor,
- * })
- *
- * // In component
- * const { data, fetchNextPage, hasNextPage } = postsQuery.useInfiniteQuery()
- *
- * // Flatten all pages
- * const allPosts = data?.pages.flatMap(page => page.posts)
- *
- * // Invalidate cache
- * postsQuery.invalidate()
- */
-import { useMemo } from "react";
-import { useInfiniteQuery, } from "@tanstack/react-query";
-import { buildChainedSelect, callConfigForKey, mergeFactoryQueryKey, normalizeQueryData, pickFetchOptions, queryCacheControls, retryOption, useMountQueryClient, withQueryFactoryMethods, } from "./utils.js";
-// ============================================================================
-// Internal Implementation
-// ============================================================================
-const createInfiniteQueryImpl = (reactor, config) => {
-    const { functionName, callConfig, queryKey: customQueryKey, initialPageParam, getArgs, getKeyArgs, getNextPageParam, getPreviousPageParam, maxPages, staleTime = 5 * 60 * 1000, select, ...rest } = config;
-    // Fold the call arguments into the key. Without them every infinite query on
-    // a method shares one cache entry, so two lists with different `getArgs` (a
-    // different page size, a different filter) serve each other's pages — the
-    // arguments live in a closure, not in the config, so nothing else
-    // distinguishes them.
-    //
-    // The first page's args stand for the query's identity; `getKeyArgs` lets a
-    // caller drop the cursor field when it is part of those args.
-    const getQueryKey = () => {
-        const initialArgs = getArgs(initialPageParam);
-        const keyArgs = getKeyArgs?.(initialArgs) ?? initialArgs;
-        return reactor.generateQueryKey({
-            functionName,
-            queryKey: mergeFactoryQueryKey(customQueryKey, undefined, keyArgs),
-        }, callConfig);
-    };
-    // Query function - accepts QueryFunctionContext
-    const queryFn = async (context) => {
-        // pageParam is typed as unknown in QueryFunctionContext, but we know its type
-        const pageParam = context.pageParam;
-        const args = getArgs(pageParam);
-        const result = await reactor.callMethod({
-            functionName,
-            args,
-            callConfig: callConfigForKey(context.queryKey, callConfig),
-        });
-        return normalizeQueryData(result);
-    };
-    // Get infinite query options for fetchInfiniteQuery
-    const getInfiniteQueryOptions = () => {
-        const queryKey = getQueryKey();
-        return {
-            // How the query function runs, shared with the hook; see
-            // pickFetchOptions. An update method's `retry` defaults as
-            // `Reactor.getQueryRetry` says.
-            ...pickFetchOptions(rest),
-            ...retryOption(rest.retry, reactor.getQueryRetry(functionName, queryKey)),
-            queryKey,
-            queryFn,
-            initialPageParam,
-            getNextPageParam,
-        };
-    };
-    // Fetch function for loaders (cache-first, fetches first page)
-    const fetch = async () => {
-        // Check cache first
-        const cachedData = reactor.queryClient.getQueryData(getQueryKey());
-        if (cachedData !== undefined) {
-            return select ? select(cachedData) : cachedData;
-        }
-        // Fetch if not in cache. A sign-in or sign-out while it is in flight
-        // cancels it; it then runs again for the new identity rather than
-        // rejecting with TanStack's CancelledError, as `reactor.fetchQuery` does.
-        const result = await reactor.clientManager.fetchAcrossIdentitySwitch(() => reactor.queryClient.fetchInfiniteQuery(getInfiniteQueryOptions()));
-        // Result is already InfiniteData format
-        return select ? select(result) : result;
-    };
-    // Implementation
-    const useInfiniteQueryHook = (options) => {
-        useMountQueryClient(reactor.queryClient);
-        // Memoized and identity-preserving; see buildChainedSelect for why the
-        // function identity matters to the observer's select-result cache.
-        const chainedSelect = useMemo(() => buildChainedSelect(select, options?.select), [options?.select]);
-        const queryKey = getQueryKey();
-        return useInfiniteQuery({
-            queryKey,
-            queryFn,
-            initialPageParam,
-            getNextPageParam,
-            getPreviousPageParam,
-            maxPages,
-            staleTime,
-            ...rest,
-            ...options,
-            select: chainedSelect,
-            // The hook's `retry`, else the config's, else an update method's
-            // default; see `Reactor.getQueryRetry`.
-            ...retryOption(options?.retry ?? rest.retry, reactor.getQueryRetry(functionName, queryKey)),
-        }, reactor.queryClient);
-    };
-    // Invalidate function
-    const invalidate = async () => {
-        const queryKey = getQueryKey();
-        await reactor.queryClient.invalidateQueries({ queryKey });
-    };
-    // Get data from cache without fetching
-    const getCacheData = (selectFn) => {
-        const queryKey = getQueryKey();
-        const cachedRawData = reactor.queryClient.getQueryData(queryKey);
-        if (cachedRawData === undefined) {
-            return undefined;
-        }
-        // Apply config.select to raw cache data
-        const selectedData = (select ? select(cachedRawData) : cachedRawData);
-        // Apply optional select parameter
-        if (selectFn) {
-            return selectFn(selectedData);
-        }
-        return selectedData;
-    };
-    return {
-        fetch,
-        useInfiniteQuery: useInfiniteQueryHook,
-        invalidate,
-        getQueryKey,
-        getCacheData,
-        ...queryCacheControls(reactor, getQueryKey),
-    };
-};
-// ============================================================================
-// Factory Function
-// ============================================================================
-export function createInfiniteQuery(reactor, config) {
-    return createInfiniteQueryImpl(reactor, config);
-}
-// ============================================================================
-// Factory with Dynamic Args
-// ============================================================================
-/**
- * Create an infinite query factory that accepts getArgs at call time.
- * Useful when pagination logic varies by context.
- *
- * @template Service - The actor interface type
- * @template Method - The method name on the actor
- * @template Transform - The transformation key (identity, display, etc.)
- * @template TPageParam - The page parameter type
- * @template Selected - The type returned after select transformation
- *
- * @param reactor - The Reactor instance
- * @param config - Infinite query configuration (without getArgs)
- * @returns A function that accepts getArgs and returns an InfiniteQueryResult
- *
- * @example
- * const getPostsQuery = createInfiniteQueryFactory(reactor, {
- *   functionName: "get_posts",
- *   initialPageParam: 0,
- *   getKeyArgs: (args) => {
- *     const [{ userId }] = args
- *     return [{ userId }]
- *   },
- *   getNextPageParam: (lastPage) => lastPage.nextCursor,
- * })
- *
- * // Create query with specific args builder
- * const userPostsQuery = getPostsQuery((cursor) => [{ userId, cursor, limit: 10 }])
- * const { data, fetchNextPage } = userPostsQuery.useInfiniteQuery()
- *
- * // Every list this factory made, whatever its args and pages
- * await getPostsQuery.invalidate()
- */
-export function createInfiniteQueryFactory(reactor, config) {
-    const factory = (getArgs) => {
-        // `getKeyArgs` and the args-derived key segment are applied by the impl,
-        // which now does it for every infinite query rather than only for factories.
-        return createInfiniteQueryImpl(reactor, {
-            ...config,
-            getArgs,
-        });
-    };
-    // What every instance's key starts with: the method, the `callConfig`
-    // segments and the config `queryKey`. The args segment comes after them.
-    return withQueryFactoryMethods(factory, reactor, () => reactor.generateQueryKey({
-        functionName: config.functionName,
-        queryKey: config.queryKey,
-    }, config.callConfig));
-}
-//# sourceMappingURL=createInfiniteQuery.js.map

package/dist/createInfiniteQuery.js.map

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

package/dist/createMutation.d.ts

@@ -1,33 +0,0 @@
-/**
- * Mutation Factory - Generic wrapper for mutating canister data
- *
- * Creates unified mutation hooks for any canister method.
- * Works with any Reactor instance.
- * Use this when one mutation should support both React hooks and imperative
- * execution outside React.
- *
- * @example
- * const transferMutation = createMutation(reactor, {
- *   functionName: "transfer",
- *   // Refetched before onSuccess runs: a query factory covers every args
- *   // instance, a `{ functionName }` every query of that method
- *   invalidateQueries: [getBalance, { functionName: "get_history" }],
- *   onSuccess: () => console.log("Success!"),
- * })
- *
- * // In component
- * const { mutate, isPending } = transferMutation.useMutation()
- *
- * @example
- * const transferMutation = createMutation(reactor, {
- *   functionName: "transfer",
- *   onCanisterError: (err) => console.error(err.code),
- * })
- *
- * // Outside React (loader/service/script)
- * await transferMutation.execute([{ to: "aaaaa-aa", amount: "1000" }])
- */
-import type { Reactor, FunctionName, TransformKey } from "@ic-reactor/core";
-import type { MutationConfig, MutationResult, NoInfer } from "./types.js";
-export declare function createMutation<Service, Transform extends TransformKey, Method extends FunctionName<Service> = FunctionName<Service>, TOnMutateResult = unknown>(reactor: Reactor<Service, Transform>, config: MutationConfig<NoInfer<Service>, Method, Transform, TOnMutateResult | undefined>): MutationResult<Service, Method, Transform>;
-//# sourceMappingURL=createMutation.d.ts.map

package/dist/createMutation.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"createMutation.d.ts","sourceRoot":"","sources":["../src/createMutation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAOH,OAAO,KAAK,EACV,OAAO,EACP,YAAY,EAEZ,YAAY,EAGb,MAAM,kBAAkB,CAAA;AAEzB,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EAEd,OAAO,EACR,MAAM,YAAY,CAAA;AAuPnB,wBAAgB,cAAc,CAC5B,OAAO,EACP,SAAS,SAAS,YAAY,EAC9B,MAAM,SAAS,YAAY,CAAC,OAAO,CAAC,GAAG,YAAY,CAAC,OAAO,CAAC,EAC5D,eAAe,GAAG,OAAO,EAEzB,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,EAKpC,MAAM,EAAE,cAAc,CACpB,OAAO,CAAC,OAAO,CAAC,EAChB,MAAM,EACN,SAAS,EACT,eAAe,GAAG,SAAS,CAC5B,GACA,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAU5C"}

package/dist/createMutation.js

@@ -1,199 +0,0 @@
-/**
- * Mutation Factory - Generic wrapper for mutating canister data
- *
- * Creates unified mutation hooks for any canister method.
- * Works with any Reactor instance.
- * Use this when one mutation should support both React hooks and imperative
- * execution outside React.
- *
- * @example
- * const transferMutation = createMutation(reactor, {
- *   functionName: "transfer",
- *   // Refetched before onSuccess runs: a query factory covers every args
- *   // instance, a `{ functionName }` every query of that method
- *   invalidateQueries: [getBalance, { functionName: "get_history" }],
- *   onSuccess: () => console.log("Success!"),
- * })
- *
- * // In component
- * const { mutate, isPending } = transferMutation.useMutation()
- *
- * @example
- * const transferMutation = createMutation(reactor, {
- *   functionName: "transfer",
- *   onCanisterError: (err) => console.error(err.code),
- * })
- *
- * // Outside React (loader/service/script)
- * await transferMutation.execute([{ to: "aaaaa-aa", amount: "1000" }])
- */
-import { useMutation, } from "@tanstack/react-query";
-import { isCanisterError } from "@ic-reactor/core";
-import { invalidateTargets, useMountQueryClient } from "./utils.js";
-// ============================================================================
-// Internal Implementation
-// ============================================================================
-const createMutationImpl = (reactor, config) => {
-    const { functionName, callConfig, invalidateQueries: factoryInvalidateQueries, onSuccess: factoryOnSuccess, onCanisterError: factoryOnCanisterError, onError: factoryOnError, onMutate: factoryOnMutate, onSettled: factoryOnSettled, ...factoryOptions } = config;
-    /**
-     * Raw call without any invalidation logic.
-     * Used as mutationFn so that onSuccess handles all post-mutation work
-     * and there is no double-invalidation.
-     */
-    const callFn = (args) => reactor.callMethod({ functionName, args, callConfig });
-    /**
-     * The factory's own `onMutate` result for each call.
-     *
-     * TanStack Query stores one `onMutate` result per mutation and hands it to
-     * every callback. That slot holds the hook's result, which the mutation also
-     * exposes as `context`, so this map holds the factory's. Each key is the
-     * context object TanStack Query creates for a call and passes to every
-     * callback of that call.
-     */
-    const factoryOnMutateResults = new WeakMap();
-    /**
-     * The `onMutate` result a factory callback receives. A factory without its
-     * own `onMutate` gets the hook's, as it always has.
-     */
-    const factoryOnMutateResult = (onMutateResult, context) => (factoryOnMutate && context
-        ? factoryOnMutateResults.get(context)
-        : onMutateResult);
-    /**
-     * The options a mutation of this factory runs with, on both call paths: the
-     * factory's config, the hook's options on top when there is a hook, and the
-     * callbacks of both levels chained, factory first. `useMutation()` hands
-     * them to TanStack Query's `useMutation`, and `execute()` builds a mutation
-     * from them in the QueryClient's MutationCache.
-     */
-    const mutationOptions = (options) => {
-        const { invalidateQueries: hookInvalidateQueries, onCanisterError: hookOnCanisterError, ...restOptions } = options ?? {};
-        return {
-            mutationKey: reactor.getQueryOptions({ functionName }).queryKey,
-            ...factoryOptions,
-            ...restOptions,
-            // Use callFn (not execute) to avoid double-invalidation:
-            // factoryInvalidateQueries are handled in onSuccess below.
-            mutationFn: callFn,
-            onSuccess: async (data, variables, onMutateResult, context) => {
-                // 1. Factory-level invalidation
-                await invalidateTargets(reactor, factoryInvalidateQueries, callConfig);
-                // 2. Hook-level invalidation
-                await invalidateTargets(reactor, hookInvalidateQueries, callConfig);
-                // 3. Factory onSuccess
-                await factoryOnSuccess?.(data, variables, factoryOnMutateResult(onMutateResult, context), context);
-                // 4. Hook onSuccess
-                await restOptions.onSuccess?.(data, variables, onMutateResult, context);
-            },
-            onError: async (error, variables, onMutateResult, context) => {
-                if (isCanisterError(error)) {
-                    factoryOnCanisterError?.(error, variables);
-                    hookOnCanisterError?.(error, variables);
-                }
-                // Awaited in order, like `onSuccess`. TanStack Query holds
-                // `onSettled` and the settled state until this promise resolves, so
-                // an async `onError` must be part of it.
-                await factoryOnError?.(error, variables, factoryOnMutateResult(onMutateResult, context), context);
-                await restOptions.onError?.(error, variables, onMutateResult, context);
-            },
-            // `onMutate` and `onSettled` are composed like `onSuccess`/`onError`
-            // above. They used to arrive through the `...restOptions` spread, so a
-            // hook-level one silently replaced the factory's — factory teardown,
-            // telemetry or logging simply vanished the moment any call site passed
-            // its own, with no warning and no type error. Chaining is what a
-            // reader who has seen `onSuccess` chain already expects.
-            onMutate: async (variables, context) => {
-                if (factoryOnMutate) {
-                    const result = await factoryOnMutate(variables, context);
-                    if (context)
-                        factoryOnMutateResults.set(context, result);
-                }
-                // Without a hook-level `onMutate` this is `undefined`, and
-                // THookOnMutateResult is then `unknown`.
-                return (await restOptions.onMutate?.(variables, context));
-            },
-            onSettled: async (data, error, variables, onMutateResult, context) => {
-                await factoryOnSettled?.(data, error, variables, factoryOnMutateResult(onMutateResult, context), context);
-                await restOptions.onSettled?.(data, error, variables, onMutateResult, context);
-            },
-        };
-    };
-    /**
-     * Imperative execution for non-React usage.
-     *
-     * Builds the mutation in the QueryClient's MutationCache and runs it, as
-     * TanStack Query's `useMutation` does, with the options the hook path uses
-     * minus the hook's own. It used to call the canister and the factory's
-     * callbacks itself, so the MutationCache never saw it: its global
-     * `onError`, `onSuccess` and `onSettled` did not run, `useIsMutating` did
-     * not count it, and neither the factory's `retry` or `networkMode` nor the
-     * same options in the QueryClient's mutation defaults applied to the call.
-     * The factory's `onMutate` and `onSettled` did not run either.
-     *
-     * Now the factory's chain runs as it does through `useMutation()`:
-     * `onMutate`, then the factory's invalidation and `onSuccess`, or
-     * `onCanisterError` and `onError` on failure, then `onSettled`. Each factory
-     * callback gets the result of the factory's `onMutate` for this call. Only
-     * hook-level callbacks are absent, because there is no hook here to supply
-     * them.
-     *
-     * The QueryClient's mutation defaults apply as well, so a `mutations.retry`
-     * there re-sends a failed call here too. Each retry of an update method is
-     * a new call the canister runs; set `retry` on the factory (`false`, or
-     * `reactorUpdateRetry` to retry only a SysTransient rejection) to decide it
-     * per method.
-     *
-     * It resolves with the method's result. On failure it rejects with the
-     * call's error once the callbacks have run, so `await execute(...)` still
-     * rejects for the caller.
-     *
-     * Use this in route loaders, scripts, or server-side code.
-     */
-    const execute = async (args) => {
-        const { queryClient } = reactor;
-        const options = mutationOptions();
-        const { onError } = options;
-        // What the factory's `onError` or `onCanisterError` throws, if either
-        // does. execute() has always rejected with it, and a TanStack Query
-        // mutation at the 5.90.2 peer floor does too. Later releases reject with
-        // the call's error and report the thrown one as an unhandled rejection,
-        // which ends a Node script, so it is caught here and rethrown below.
-        let thrownByOnError;
-        const mutation = queryClient
-            .getMutationCache()
-            .build(queryClient, {
-            ...options,
-            onError: async (error, variables, onMutateResult, context) => {
-                try {
-                    await onError?.(error, variables, onMutateResult, context);
-                }
-                catch (thrown) {
-                    thrownByOnError = { error: thrown };
-                }
-            },
-        });
-        try {
-            return await mutation.execute(args);
-        }
-        catch (error) {
-            throw thrownByOnError ? thrownByOnError.error : error;
-        }
-    };
-    // Hook implementation
-    const useMutationHook = (options) => {
-        useMountQueryClient(reactor.queryClient);
-        return useMutation(mutationOptions(options), reactor.queryClient);
-    };
-    return { useMutation: useMutationHook, execute };
-};
-// ============================================================================
-// Public Factory Function
-// ============================================================================
-export function createMutation(reactor, 
-// A factory `onError` or `onSettled` gets no `onMutate` result when
-// `onMutate` throws, so the result can also be `undefined`. `onSuccess`
-// shares the type argument. It kept the `undefined` from when `execute()`
-// ran no `onMutate`, although it now always gets a result.
-config) {
-    return createMutationImpl(reactor, config);
-}
-//# sourceMappingURL=createMutation.js.map

package/dist/createMutation.js.map

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

package/dist/createQuery.d.ts

@@ -1,63 +0,0 @@
-/**
- * Query Factory - Generic wrapper for React Query-based canister data
- *
- * Creates unified fetch/hook/invalidate functions for any canister method.
- * Works with any Reactor instance.
- * Use this when the same read operation must work both inside React components
- * and outside React (loaders, actions, services, tests).
- *
- * @example
- * const userQuery = createQuery(todoManager, {
- *   functionName: "get_user",
- *   select: (result) => result.user,
- * })
- *
- * // In component
- * const { data: user } = userQuery.useQuery()
- *
- * @example
- * const userQuery = createQuery(todoManager, { functionName: "get_user", args: ["alice"] })
- *
- * // Outside React (loader/service/script)
- * await userQuery.fetch()
- * const cached = userQuery.getCacheData()
- * await userQuery.invalidate()
- */
-import type { Reactor, FunctionName, ReactorArgs, TransformKey } from "@ic-reactor/core";
-import type { QueryFnData, QueryError, QueryConfig, QueryResult, QueryFactoryConfig, SkippableQueryFactoryFn, NoInfer } from "./types.js";
-export declare function createQuery<Service, Transform extends TransformKey, Method extends FunctionName<Service> = FunctionName<Service>, Selected = QueryFnData<Service, Method, Transform>>(reactor: Reactor<Service, Transform>, config: QueryConfig<NoInfer<Service>, Method, Transform, Selected>): QueryResult<QueryFnData<Service, Method, Transform>, Selected, QueryError<Service, Method, Transform>>;
-/**
- * Create a query factory: a function that takes the method's args and returns
- * the query object for them, the same object for the same args.
- *
- * The function also has `getQueryKey()`, the key prefix every query it
- * returns shares, and `invalidate()`, which invalidates all of them whatever
- * their args. Pass the function itself to a mutation's `invalidateQueries` to
- * refresh every instance after the mutation.
- *
- * It also takes TanStack Query's `skipToken` in place of args, for a
- * component whose args are not known yet, and returns a query with only
- * `useQuery()`, which waits without fetching; see
- * {@link SkippableQueryFactoryFn}.
- *
- * @example
- * const getBalance = createQueryFactory(ledger, {
- *   functionName: "icrc1_balance_of",
- * })
- *
- * // In a component
- * const { data } = getBalance([{ owner, subaccount: [] }]).useQuery()
- *
- * // In a component whose owner may not be known yet
- * const { data: maybe } = getBalance(
- *   owner ? [{ owner, subaccount: [] }] : skipToken
- * ).useQuery()
- *
- * // Refetch every account's balance after a transfer
- * const transfer = createMutation(ledger, {
- *   functionName: "icrc1_transfer",
- *   invalidateQueries: [getBalance],
- * })
- */
-export declare function createQueryFactory<Service, Transform extends TransformKey, Method extends FunctionName<Service> = FunctionName<Service>, Selected = QueryFnData<Service, Method, Transform>>(reactor: Reactor<Service, Transform>, config: QueryFactoryConfig<NoInfer<Service>, Method, Transform, Selected>): SkippableQueryFactoryFn<ReactorArgs<Service, Method, Transform>, QueryResult<QueryFnData<Service, Method, Transform>, Selected, QueryError<Service, Method, Transform>>>;
-//# sourceMappingURL=createQuery.d.ts.map

package/dist/createQuery.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"createQuery.d.ts","sourceRoot":"","sources":["../src/createQuery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EACV,OAAO,EACP,YAAY,EACZ,WAAW,EACX,YAAY,EACb,MAAM,kBAAkB,CAAA;AAUzB,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,WAAW,EAGX,WAAW,EACX,kBAAkB,EAClB,uBAAuB,EAEvB,OAAO,EACR,MAAM,YAAY,CAAA;AAwLnB,wBAAgB,WAAW,CACzB,OAAO,EACP,SAAS,SAAS,YAAY,EAC9B,MAAM,SAAS,YAAY,CAAC,OAAO,CAAC,GAAG,YAAY,CAAC,OAAO,CAAC,EAC5D,QAAQ,GAAG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAElD,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,EACpC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,GACjE,WAAW,CACZ,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EACvC,QAAQ,EACR,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CACvC,CAKA;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EACP,SAAS,SAAS,YAAY,EAC9B,MAAM,SAAS,YAAY,CAAC,OAAO,CAAC,GAAG,YAAY,CAAC,OAAO,CAAC,EAC5D,QAAQ,GAAG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAElD,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,EACpC,MAAM,EAAE,kBAAkB,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,GACxE,uBAAuB,CACxB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EACvC,WAAW,CACT,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EACvC,QAAQ,EACR,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CACvC,CACF,CA6DA"}