@codeleap/query 7.0.1 → 7.1.1

package/dist/lib/QueryKeys.js

@@ -1,12 +1,3 @@
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 import { useMemo } from 'react';
 import { TypeGuards } from '@codeleap/types';
 import deepEqual from 'fast-deep-equal';
@@ -16,6 +7,8 @@ import deepEqual from 'fast-deep-equal';
  * @template F - The filter type used for list queries
  */
 export class QueryKeys {
+    queryName;
+    queryClient;
     /**
      * Creates a new QueryKeys instance
      * @param queryName - The name of the query used as base for all keys
@@ -48,7 +41,7 @@ export class QueryKeys {
     listKeyWithFilters(filters) {
         const hasValidFilters = !TypeGuards.isNil(filters) && (typeof filters !== 'object'
             ? Boolean(filters)
-            : Object.values(filters !== null && filters !== void 0 ? filters : {}).some(value => value != null && (typeof value !== 'string' || value.trim() !== '')));
+            : Object.values(filters ?? {}).some(value => value != null && (typeof value !== 'string' || value.trim() !== '')));
         return hasValidFilters ? [...this.keys.list, filters] : this.keys.list;
     }
     /**
@@ -79,9 +72,8 @@ export class QueryKeys {
      * @returns True if the query matches the query name
      */
     predicateQueryKeyAll(queryName, query) {
-        var _a;
-        const queryKey = (_a = query === null || query === void 0 ? void 0 : query.queryKey) === null || _a === void 0 ? void 0 : _a.join('/');
-        return queryKey === null || queryKey === void 0 ? void 0 : queryKey.includes(queryName);
+        const queryKey = query?.queryKey?.join('/');
+        return queryKey?.includes(queryName);
     }
     /**
      * Predicate function to check if a query is a list query for this query name
@@ -92,15 +84,14 @@ export class QueryKeys {
      * @returns True if the query is a list query and not in the ignore list
      */
     predicateQueryKeyList(queryName, query, toIgnoreQueryKeys) {
-        var _a;
-        const queryKey = (_a = query === null || query === void 0 ? void 0 : query.queryKey) === null || _a === void 0 ? void 0 : _a.join('/');
+        const queryKey = query?.queryKey?.join('/');
         if (!TypeGuards.isNil(toIgnoreQueryKeys)) {
-            const ignoreQueryKeys = Array.isArray(toIgnoreQueryKeys === null || toIgnoreQueryKeys === void 0 ? void 0 : toIgnoreQueryKeys[0]) ? toIgnoreQueryKeys : [toIgnoreQueryKeys];
-            if (ignoreQueryKeys.some(key => deepEqual(query === null || query === void 0 ? void 0 : query.queryKey, key))) {
+            const ignoreQueryKeys = Array.isArray(toIgnoreQueryKeys?.[0]) ? toIgnoreQueryKeys : [toIgnoreQueryKeys];
+            if (ignoreQueryKeys.some(key => deepEqual(query?.queryKey, key))) {
                 return false;
             }
         }
-        const isListQueryKey = (queryKey === null || queryKey === void 0 ? void 0 : queryKey.includes(queryName)) && (queryKey === null || queryKey === void 0 ? void 0 : queryKey.includes('list'));
+        const isListQueryKey = queryKey?.includes(queryName) && queryKey?.includes('list');
         return isListQueryKey;
     }
     /**
@@ -109,10 +100,11 @@ export class QueryKeys {
      * @param options - Optional invalidation options
      * @returns Promise that resolves when invalidation is complete
      */
-    invalidateAll(filters, options) {
-        return __awaiter(this, void 0, void 0, function* () {
-            return this.queryClient.invalidateQueries(Object.assign(Object.assign({}, filters), { predicate: (query) => this.predicateQueryKeyAll(this.queryName, query) }), options);
-        });
+    async invalidateAll(filters, options) {
+        return this.queryClient.invalidateQueries({
+            ...filters,
+            predicate: (query) => this.predicateQueryKeyAll(this.queryName, query),
+        }, options);
     }
     /**
      * Invalidates list queries, optionally with specific filters
@@ -122,14 +114,15 @@ export class QueryKeys {
      * @param options - Optional invalidation options
      * @returns Promise that resolves when invalidation is complete
      */
-    invalidateList(listFilters, ignoreQueryKeys, filters, options) {
-        return __awaiter(this, void 0, void 0, function* () {
-            if (!!listFilters) {
-                const queryKey = this.listKeyWithFilters(listFilters);
-                return this.queryClient.invalidateQueries(Object.assign(Object.assign({}, filters), { queryKey }), options);
-            }
-            return this.queryClient.invalidateQueries(Object.assign(Object.assign({}, filters), { predicate: (query) => this.predicateQueryKeyList(this.queryName, query, ignoreQueryKeys) }), options);
-        });
+    async invalidateList(listFilters, ignoreQueryKeys, filters, options) {
+        if (!!listFilters) {
+            const queryKey = this.listKeyWithFilters(listFilters);
+            return this.queryClient.invalidateQueries({ ...filters, queryKey }, options);
+        }
+        return this.queryClient.invalidateQueries({
+            ...filters,
+            predicate: (query) => this.predicateQueryKeyList(this.queryName, query, ignoreQueryKeys),
+        }, options);
     }
     /**
      * Invalidates a specific retrieve query by ID
@@ -138,11 +131,12 @@ export class QueryKeys {
      * @param options - Optional invalidation options
      * @returns Promise that resolves when invalidation is complete
      */
-    invalidateRetrieve(id, filters, options) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const queryKey = this.keys.retrieve(id);
-            return this.queryClient.invalidateQueries(Object.assign(Object.assign({}, filters), { queryKey }), options);
-        });
+    async invalidateRetrieve(id, filters, options) {
+        const queryKey = this.keys.retrieve(id);
+        return this.queryClient.invalidateQueries({
+            ...filters,
+            queryKey,
+        }, options);
     }
     /**
      * Refetches all queries for this query name
@@ -150,10 +144,11 @@ export class QueryKeys {
      * @param options - Optional refetch options
      * @returns Promise that resolves when refetch is complete
      */
-    refetchAll(filters, options) {
-        return __awaiter(this, void 0, void 0, function* () {
-            return this.queryClient.refetchQueries(Object.assign(Object.assign({}, filters), { predicate: (query) => this.predicateQueryKeyAll(this.queryName, query) }), options);
-        });
+    async refetchAll(filters, options) {
+        return this.queryClient.refetchQueries({
+            ...filters,
+            predicate: (query) => this.predicateQueryKeyAll(this.queryName, query),
+        }, options);
     }
     /**
      * Refetches list queries, optionally with specific filters
@@ -163,14 +158,15 @@ export class QueryKeys {
      * @param options - Optional refetch options
      * @returns Promise that resolves when refetch is complete
      */
-    refetchList(listFilters, ignoreQueryKeys, filters, options) {
-        return __awaiter(this, void 0, void 0, function* () {
-            if (!!listFilters) {
-                const queryKey = this.listKeyWithFilters(listFilters);
-                return this.queryClient.refetchQueries(Object.assign(Object.assign({}, filters), { queryKey }), options);
-            }
-            return this.queryClient.refetchQueries(Object.assign(Object.assign({}, filters), { predicate: (query) => this.predicateQueryKeyList(this.queryName, query, ignoreQueryKeys) }), options);
-        });
+    async refetchList(listFilters, ignoreQueryKeys, filters, options) {
+        if (!!listFilters) {
+            const queryKey = this.listKeyWithFilters(listFilters);
+            return this.queryClient.refetchQueries({ ...filters, queryKey }, options);
+        }
+        return this.queryClient.refetchQueries({
+            ...filters,
+            predicate: (query) => this.predicateQueryKeyList(this.queryName, query, ignoreQueryKeys),
+        }, options);
     }
     /**
      * Refetches a specific retrieve query by ID
@@ -179,11 +175,12 @@ export class QueryKeys {
      * @param options - Optional refetch options
      * @returns Promise that resolves when refetch is complete
      */
-    refetchRetrieve(id, filters, options) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const queryKey = this.keys.retrieve(id);
-            return this.queryClient.refetchQueries(Object.assign(Object.assign({}, filters), { queryKey }), options);
-        });
+    async refetchRetrieve(id, filters, options) {
+        const queryKey = this.keys.retrieve(id);
+        return this.queryClient.refetchQueries({
+            ...filters,
+            queryKey,
+        }, options);
     }
     /**
      * Removes a specific retrieve query data from the cache
@@ -191,10 +188,11 @@ export class QueryKeys {
      * @param filters - Optional filters to apply to the removal
      * @returns Promise that resolves when removal is complete
      */
-    removeRetrieveQueryData(id, filters) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const queryKey = this.keys.retrieve(id);
-            return this.queryClient.removeQueries(Object.assign(Object.assign({}, filters), { queryKey }));
+    async removeRetrieveQueryData(id, filters) {
+        const queryKey = this.keys.retrieve(id);
+        return this.queryClient.removeQueries({
+            ...filters,
+            queryKey,
         });
     }
     /**
@@ -205,14 +203,15 @@ export class QueryKeys {
      * @param options - Optional cancellation options
      * @returns Promise that resolves when cancellation is complete
      */
-    cancelListQueries(listFilters, ignoreQueryKeys, filters, options) {
-        return __awaiter(this, void 0, void 0, function* () {
-            if (!!listFilters) {
-                const queryKey = this.listKeyWithFilters(listFilters);
-                return this.queryClient.cancelQueries(Object.assign(Object.assign({}, filters), { queryKey }), options);
-            }
-            return this.queryClient.cancelQueries(Object.assign(Object.assign({}, filters), { predicate: (query) => this.predicateQueryKeyList(this.queryName, query, ignoreQueryKeys) }), options);
-        });
+    async cancelListQueries(listFilters, ignoreQueryKeys, filters, options) {
+        if (!!listFilters) {
+            const queryKey = this.listKeyWithFilters(listFilters);
+            return this.queryClient.cancelQueries({ ...filters, queryKey }, options);
+        }
+        return this.queryClient.cancelQueries({
+            ...filters,
+            predicate: (query) => this.predicateQueryKeyList(this.queryName, query, ignoreQueryKeys),
+        }, options);
     }
     /**
      * Gets list data from the cache, including both items array and item map
@@ -220,12 +219,11 @@ export class QueryKeys {
      * @returns Object containing items array and itemMap (keyed by ID)
      */
     getListData(filters) {
-        var _a;
         const queryKey = this.listKeyWithFilters(filters);
         const data = this.queryClient.getQueryData(queryKey);
-        const items = ((_a = data === null || data === void 0 ? void 0 : data.pages) !== null && _a !== void 0 ? _a : []).flat();
+        const items = (data?.pages ?? []).flat();
         const itemMap = items.reduce((acc, item) => {
-            acc[item === null || item === void 0 ? void 0 : item.id] = item;
+            acc[item?.id] = item;
             return acc;
         }, {});
         return {
@@ -249,29 +247,28 @@ export class QueryKeys {
       * @returns Item | undefined
      */
     getRetrieveData(id, options = {}) {
-        var _a;
         const { onlyQueryData = false, deepSearch = false, } = options;
         if (TypeGuards.isNil(id))
             return undefined;
         const queryKey = this.keys.retrieve(id);
         const queryData = this.queryClient.getQueryData(queryKey);
-        if (queryData === null || queryData === void 0 ? void 0 : queryData.id)
+        if (queryData?.id)
             return queryData;
         if (onlyQueryData)
             return undefined;
         if (!deepSearch) {
             const { itemMap } = this.getListData();
-            return itemMap === null || itemMap === void 0 ? void 0 : itemMap[id];
+            return itemMap?.[id];
         }
         const queries = this.getAllListQueries();
         for (const query of queries) {
-            const pages = (_a = query.state.data) === null || _a === void 0 ? void 0 : _a.pages;
-            if (!(pages === null || pages === void 0 ? void 0 : pages.length))
+            const pages = query.state.data?.pages;
+            if (!pages?.length)
                 continue;
             const item = pages
                 .filter(Boolean)
                 .flatMap(page => Array.isArray(page) ? page : [])
-                .find(item => (item === null || item === void 0 ? void 0 : item.id) === id);
+                .find(item => item?.id === id);
             if (item)
                 return item;
         }

package/dist/lib/QueryKeys.js.map

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

package/dist/lib/QueryManager.d.ts

@@ -1,27 +1,29 @@
 import { FetchInfiniteQueryOptions, FetchQueryOptions, QueryClient, QueryKey } from '@tanstack/react-query';
 import { QueryKeys } from './QueryKeys';
 import { Mutations } from './Mutations';
-import { CreateMutationCtx, CreateMutationOptions, ListPaginationResponse, ListQueryOptions, QueryItem, QueryManagerOptions, RetrieveQueryOptions, UpdateMutationCtx, UpdateMutationOptions, DeleteMutationCtx, DeleteMutationOptions } from '../types';
+import { CreateMutationCtx, CreateMutationOptions, ListPaginationResponse, ListQueryOptions, ListResponseMeta, QueryItem, QueryManagerOptions, RetrieveQueryOptions, UpdateMutationCtx, UpdateMutationOptions, DeleteMutationCtx, DeleteMutationOptions } from '../types';
 /**
  * Comprehensive query manager class that provides hooks and utilities for managing CRUD operations with React Query
  * @template T - The query item type that extends QueryItem
  * @template F - The filter type used for list queries
+ * @template M - Optional metadata shape returned alongside list items (e.g. `{ count: number }`). Defaults to `Record<string, unknown>`.
  *
  * @description
  * QueryManager provides a complete solution for managing list and individual item queries with:
  * - Infinite scroll pagination for lists
+ * - Support for list response metadata (e.g. total count) via envelope responses
  * - Optimistic updates for create, update, and delete operations
  * - Automatic cache synchronization between list and individual queries
  * - Built-in error handling and rollback mechanisms
  */
-export declare class QueryManager<T extends QueryItem, F> {
+export declare class QueryManager<T extends QueryItem, F, M extends ListResponseMeta = ListResponseMeta> {
     private options;
     queryClient: QueryClient;
     /**
      * Creates a new QueryManager instance
      * @param options - Configuration options for the query manager
      */
-    constructor(options: QueryManagerOptions<T, F>);
+    constructor(options: QueryManagerOptions<T, F, M>);
     /**
      * Gets the name of this query manager
      * @returns The query name used for identification
@@ -32,7 +34,7 @@ export declare class QueryManager<T extends QueryItem, F> {
      * @returns Object containing all configured function handlers
      */
     get functions(): {
-        list: ((limit: number, offset: number, filters: F) => Promise<ListPaginationResponse<T>>) | undefined;
+        list: ((limit: number, offset: number, filters: F) => Promise<import("..").ListFnResponse<T, M>>) | undefined;
         retrieve: ((id: T["id"]) => Promise<T>) | undefined;
         create: ((data: Partial<T>) => Promise<T>) | undefined;
         update: ((data: Partial<T>) => Promise<T>) | undefined;
@@ -45,20 +47,33 @@ export declare class QueryManager<T extends QueryItem, F> {
     /**
      * React hook for infinite scroll list queries with pagination
      * @param options - Configuration options for the list query
-     * @returns Object containing items array, query key, and query object
+     * @returns Object containing items array, response metadata, query key, and query object
+     *
+     * @description
+     * When `listFn` returns a `ListPaginationEnvelope` (an object with `listItems` and extra fields),
+     * the extra fields are exposed as typed `meta` in the return value. When `listFn` returns a plain
+     * array, `meta` is `null`. Meta is stored in the query cache under a companion key, so it
+     * survives component remounts and is available even when React Query serves from cache.
      *
      * @example
      * ```typescript
+     * // Plain array response (backward compatible)
      * const { items, query } = queryManager.useList({
      *   filters: { status: 'active' },
      *   limit: 20
      * })
+     *
+     * // Envelope response with metadata
+     * const { items, meta } = queryManager.useList({ filters })
+     * console.log(meta?.count) // total item count from the API
      * ```
      */
-    useList(options?: ListQueryOptions<T, F>): {
+    useList(options?: ListQueryOptions<T, F, M>): {
         items: T[];
+        meta: M | null;
         queryKey: readonly unknown[];
-        query: import("@tanstack/react-query").UseInfiniteQueryResult<import("..").ListSelector<T>, Error>;
+        query: import("@tanstack/react-query").UseInfiniteQueryResult<import("..").ListSelector<T, M>, Error>;
+        listLimit: number;
     };
     /**
      * React hook for retrieving a single item by ID
@@ -183,6 +198,8 @@ export declare class QueryManager<T extends QueryItem, F> {
      *
      * @description
      * Use this method to preload paginated list data that users are likely to need soon.
+     * Handles both plain array and envelope responses from `listFn`, but only caches the
+     * items — metadata is discarded during prefetch and populated on the first client-side fetch.
      *
      * @example
      * ```typescript
@@ -192,7 +209,6 @@ export declare class QueryManager<T extends QueryItem, F> {
      *     { staleTime: 5 * 60 * 1000 }
      *   )
      * }
-     *
      * ```
      */
     prefetchList(filters?: F, options?: Omit<FetchInfiniteQueryOptions<ListPaginationResponse<T>, Error, ListPaginationResponse<T>, QueryKey, number>, 'queryKey' | 'queryFn' | 'initialPageParam'> & {

package/dist/lib/QueryManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"QueryManager.d.ts","sourceRoot":"","sources":["../../src/lib/QueryManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,iBAAiB,EAAyC,WAAW,EAAE,QAAQ,EAA2C,MAAM,uBAAuB,CAAA;AAE3L,OAAO,EAAmB,SAAS,EAAE,MAAM,aAAa,CAAA;AACxD,OAAO,EAAmB,SAAS,EAAE,MAAM,aAAa,CAAA;AACxD,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,gBAAgB,EAAa,SAAS,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAA;AAKlQ;;;;;;;;;;;GAWG;AACH,qBAAa,YAAY,CAAC,CAAC,SAAS,SAAS,EAAE,CAAC;IAMlC,OAAO,CAAC,OAAO;IAL3B,WAAW,EAAE,WAAW,CAAA;IACxB;;;OAGG;gBACiB,OAAO,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC;IAMtD;;;OAGG;IACH,IAAI,IAAI,WAEP;IAED;;;OAGG;IACH,IAAI,SAAS;;;;;;MAQZ;IAED,sEAAsE;IACtE,SAAS,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAE1B,sDAAsD;IACtD,SAAS,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAE1B;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,OAAO,GAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAM;;;;;IAsE5C;;;;;;;;;;;;;;;;;;OAkBG;IACH,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,GAAE,oBAAoB,CAAC,CAAC,CAAM;;;;;IA0C9D;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,SAAS,CAAC,OAAO,GAAE,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAM;IAkEnD;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,SAAS,CAAC,OAAO,GAAE,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAM;IAiEnD;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,SAAS,CAAC,OAAO,GAAE,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAM;IAgEnD;;;;;;;;;;;;;;;;;OAiBG;IACH,gBAAgB,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,GAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,UAAU,GAAG,SAAS,CAAM;IAQzH;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,YAAY,CACV,OAAO,CAAC,EAAE,CAAC,EACX,OAAO,GAAE,IAAI,CAAC,yBAAyB,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,sBAAsB,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,kBAAkB,CAAC,GAAG;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAO;CAWzM"}
+{"version":3,"file":"QueryManager.d.ts","sourceRoot":"","sources":["../../src/lib/QueryManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,iBAAiB,EAAyC,WAAW,EAAE,QAAQ,EAA2C,MAAM,uBAAuB,CAAA;AAE3L,OAAO,EAAmB,SAAS,EAAE,MAAM,aAAa,CAAA;AACxD,OAAO,EAAmB,SAAS,EAAE,MAAM,aAAa,CAAA;AACxD,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,gBAAgB,EAAa,SAAS,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAA;AAKpR;;;;;;;;;;;;;GAaG;AACH,qBAAa,YAAY,CAAC,CAAC,SAAS,SAAS,EAAE,CAAC,EAAE,CAAC,SAAS,gBAAgB,GAAG,gBAAgB;IAMjF,OAAO,CAAC,OAAO;IAL3B,WAAW,EAAE,WAAW,CAAA;IACxB;;;OAGG;gBACiB,OAAO,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAMzD;;;OAGG;IACH,IAAI,IAAI,WAEP;IAED;;;OAGG;IACH,IAAI,SAAS;;;;;;MAQZ;IAED,sEAAsE;IACtE,SAAS,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAE1B,sDAAsD;IACtD,SAAS,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAE1B;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,OAAO,CAAC,OAAO,GAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAM;;;;;;;IAsF/C;;;;;;;;;;;;;;;;;;OAkBG;IACH,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,GAAE,oBAAoB,CAAC,CAAC,CAAM;;;;;IA0C9D;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,SAAS,CAAC,OAAO,GAAE,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAM;IAkEnD;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,SAAS,CAAC,OAAO,GAAE,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAM;IAiEnD;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,SAAS,CAAC,OAAO,GAAE,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAM;IAgEnD;;;;;;;;;;;;;;;;;OAiBG;IACH,gBAAgB,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,GAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,UAAU,GAAG,SAAS,CAAM;IAQzH;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,YAAY,CACV,OAAO,CAAC,EAAE,CAAC,EACX,OAAO,GAAE,IAAI,CAAC,yBAAyB,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,sBAAsB,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,kBAAkB,CAAC,GAAG;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAO;CAqBzM"}