@gostack-framework/react 0.0.0-stage → 0.1.0

package/dist/api.d.ts

@@ -0,0 +1,83 @@
+import { type AxiosInstance, type AxiosRequestConfig } from "axios";
+export { serializeParams } from "./paramsSerializer";
+export { toFormData } from "./utils/toFormData";
+export type ValidationErrors = Record<string, string[]>;
+export declare class ApiError extends Error {
+    status?: number | undefined;
+    validationErrors: ValidationErrors;
+    cause?: unknown | undefined;
+    constructor(message: string, status?: number | undefined, validationErrors?: ValidationErrors, cause?: unknown | undefined);
+}
+export declare function normalizeApiError(error: unknown): ApiError;
+export interface RequestOptions extends Omit<AxiosRequestConfig, "url" | "method" | "data" | "auth"> {
+    auth?: "required" | "optional" | "none";
+}
+export interface HttpClient {
+    request<T = unknown>(method: string, url: string, data?: unknown, options?: RequestOptions): Promise<T>;
+    get<T = unknown>(url: string, options?: RequestOptions): Promise<T>;
+    post<T = unknown>(url: string, data?: unknown, options?: RequestOptions): Promise<T>;
+    put<T = unknown>(url: string, data?: unknown, options?: RequestOptions): Promise<T>;
+    patch<T = unknown>(url: string, data?: unknown, options?: RequestOptions): Promise<T>;
+    delete<T = unknown>(url: string, options?: RequestOptions): Promise<T>;
+    subscribeUnauthorized(listener: () => void): () => void;
+    resetUnauthorized(): void;
+}
+export interface HttpConfig {
+    baseURL: string;
+    timeout?: number;
+    withCredentials?: boolean;
+    getToken?: () => string | null | undefined | Promise<string | null | undefined>;
+    getLanguage?: () => string;
+    headers?: () => Record<string, string>;
+    onUnauthorized?: () => void;
+    onError?: (error: ApiError) => void;
+    instance?: AxiosInstance;
+}
+export declare function createHttpClient(config: HttpConfig): HttpClient;
+export interface PaginationMeta {
+    currentPage: number;
+    lastPage: number;
+    perPage: number;
+    total: number;
+}
+export interface PaginatedResponse<T> {
+    items: T[];
+    meta: PaginationMeta;
+}
+export interface ListQueryParams {
+    page?: number;
+    perPage?: number;
+    search?: string;
+    sortBy?: string;
+    sortOrder?: "asc" | "desc";
+    [key: string]: unknown;
+}
+export interface ResponseAdapter {
+    entity<T>(body: unknown): T;
+    list<T>(body: unknown): PaginatedResponse<T>;
+    params?: (params: ListQueryParams) => Record<string, unknown>;
+}
+export declare const standardAdapter: ResponseAdapter;
+export declare const itsmAdapter: ResponseAdapter;
+export interface CrudApi<T, Create = Partial<T>, Update = Partial<T>> {
+    getList(params?: ListQueryParams, signal?: AbortSignal): Promise<PaginatedResponse<T>>;
+    getById(id: string | number, signal?: AbortSignal): Promise<T>;
+    create(payload: Create): Promise<T>;
+    update(id: string | number, payload: Update): Promise<T>;
+    delete(id: string | number): Promise<void>;
+}
+export declare function createCrudApi<T, Create = Partial<T>, Update = Partial<T>>(config: {
+    client: HttpClient;
+    baseUrl: string;
+    adapter?: ResponseAdapter;
+    updateMethod?: "put" | "patch";
+    transformRequest?: (value: Create | Update) => unknown;
+}): CrudApi<T, Create, Update>;
+export declare function readApiConfig(env: Record<string, string | boolean | undefined>): {
+    BASE_URL: string;
+    TIMEOUT: number;
+    PROJECT_NAME: string;
+    ENV_MODE: string;
+    USE_MOCK_DATA: boolean;
+    TENANT_IDENTIFIER: string;
+};

package/dist/api.js

@@ -0,0 +1,170 @@
+import axios from "axios";
+import { serializeParams } from "./paramsSerializer.js";
+export { serializeParams } from "./paramsSerializer.js";
+export { toFormData } from "./utils/toFormData.js";
+export class ApiError extends Error {
+    status;
+    validationErrors;
+    cause;
+    constructor(message, status, validationErrors = {}, cause) {
+        super(message);
+        this.status = status;
+        this.validationErrors = validationErrors;
+        this.cause = cause;
+        this.name = "ApiError";
+    }
+}
+export function normalizeApiError(error) {
+    if (error instanceof ApiError)
+        return error;
+    if (axios.isAxiosError(error)) {
+        const data = error.response?.data;
+        const fields = Object.fromEntries(Object.entries(data?.validationErrors ?? data?.errors ?? {}).map(([key, value]) => [key, Array.isArray(value) ? value : [String(value)]]));
+        return new ApiError(data?.message ?? error.message, error.response?.status, fields, error);
+    }
+    return new ApiError(error instanceof Error ? error.message : String(error), undefined, {}, error);
+}
+export function createHttpClient(config) {
+    const instance = config.instance ??
+        axios.create({
+            baseURL: config.baseURL,
+            timeout: config.timeout ?? 30000,
+            withCredentials: config.withCredentials ?? false,
+            paramsSerializer: {
+                serialize: (params) => serializeParams(params),
+            },
+        });
+    const listeners = new Set();
+    let unauthorizedNotified = false;
+    const request = async (method, url, data, options = {}) => {
+        const { auth = "required", ...rest } = options;
+        const token = auth === "none" ? null : await config.getToken?.();
+        const headers = {
+            Accept: "application/json",
+            ...config.headers?.(),
+            ...(config.getLanguage
+                ? { "Accept-Language": config.getLanguage() }
+                : {}),
+            ...(token ? { Authorization: `Bearer ${token}` } : {}),
+            ...rest.headers,
+        };
+        try {
+            const response = await instance.request({
+                ...rest,
+                method,
+                url,
+                data,
+                headers,
+            });
+            if (auth === "required")
+                unauthorizedNotified = false;
+            return response.data;
+        }
+        catch (error) {
+            if (axios.isCancel(error))
+                throw error;
+            const normalized = normalizeApiError(error);
+            if (normalized.status === 401 &&
+                auth === "required" &&
+                !unauthorizedNotified) {
+                unauthorizedNotified = true;
+                config.onUnauthorized?.();
+                listeners.forEach((listener) => listener());
+            }
+            config.onError?.(normalized);
+            throw normalized;
+        }
+    };
+    return {
+        request,
+        get: (url, options) => request("GET", url, undefined, options),
+        post: (url, data, options) => request("POST", url, data, options),
+        put: (url, data, options) => request("PUT", url, data, options),
+        patch: (url, data, options) => request("PATCH", url, data, options),
+        delete: (url, options) => request("DELETE", url, undefined, options),
+        resetUnauthorized() {
+            unauthorizedNotified = false;
+        },
+        subscribeUnauthorized(listener) {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+    };
+}
+export const standardAdapter = {
+    entity: (body) => body,
+    list(body) {
+        const value = body;
+        if (!Array.isArray(value?.items) || !value?.meta)
+            throw new ApiError("Expected { items, meta } list response. Configure a response adapter.");
+        return value;
+    },
+};
+export const itsmAdapter = {
+    entity(body) {
+        return body.data;
+    },
+    list(body) {
+        const data = body.data;
+        if (!data)
+            throw new ApiError("Expected an ITSM data response.");
+        const items = data.items ?? data.data;
+        if (!Array.isArray(items))
+            throw new ApiError("Expected ITSM data.items or data.data array.");
+        return {
+            items: items,
+            meta: {
+                currentPage: Number(data.currentPage ?? data.current_page ?? 1),
+                lastPage: Number(data.lastPage ?? data.last_page ?? 1),
+                perPage: Number(data.perPage ?? data.per_page ?? items.length),
+                total: Number(data.total ?? items.length),
+            },
+        };
+    },
+    params({ perPage, ...params }) {
+        return {
+            ...params,
+            ...(perPage === undefined ? {} : { per_page: perPage }),
+        };
+    },
+};
+export function createCrudApi(config) {
+    const { client, baseUrl, adapter = standardAdapter } = config;
+    const detail = (id) => `${baseUrl.replace(/\/$/, "")}/${encodeURIComponent(String(id))}`;
+    return {
+        async getList(params = {}, signal) {
+            return adapter.list(await client.get(baseUrl, {
+                params: adapter.params?.(params) ?? params,
+                signal,
+            }));
+        },
+        async getById(id, signal) {
+            return adapter.entity(await client.get(detail(id), { signal }));
+        },
+        async create(payload) {
+            return adapter.entity(await client.post(baseUrl, config.transformRequest?.(payload) ?? payload));
+        },
+        async update(id, payload) {
+            return adapter.entity(await client[config.updateMethod ?? "put"](detail(id), config.transformRequest?.(payload) ?? payload));
+        },
+        async delete(id) {
+            await client.delete(detail(id));
+        },
+    };
+}
+export function readApiConfig(env) {
+    const timeout = Number(env.VITE_API_TIMEOUT ?? 30000);
+    if (!Number.isFinite(timeout) || timeout <= 0)
+        throw new Error("VITE_API_TIMEOUT must be a positive number.");
+    return {
+        BASE_URL: String(env.VITE_API_URL ?? "/api"),
+        TIMEOUT: timeout,
+        PROJECT_NAME: String(env.VITE_PROJECT_NAME ?? "gostack"),
+        ENV_MODE: String(env.MODE ?? "development"),
+        USE_MOCK_DATA: env.DEV === true && env.VITE_USE_MOCK_DATA === "true",
+        TENANT_IDENTIFIER: String(env.VITE_TENANT_IDENTIFIER ?? ""),
+    };
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

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

package/dist/auth.d.ts

@@ -0,0 +1,60 @@
+import { type ReactNode } from "react";
+import type { HttpClient } from "./api";
+import { type AccessRule } from "./types";
+export interface AuthSession {
+    user: {
+        id: string | number;
+        name: string;
+        [key: string]: unknown;
+    };
+    roles: string[];
+    permissions: string[];
+}
+export interface AuthAdapter {
+    getSession: (signal?: AbortSignal) => Promise<AuthSession | null>;
+    login: (credentials: {
+        email: string;
+        password: string;
+    }) => Promise<AuthSession>;
+    logout: () => Promise<void>;
+    subscribe?: (callback: () => void) => () => void;
+}
+interface AuthState {
+    session: AuthSession | null;
+    status: "loading" | "authenticated" | "anonymous";
+    error: Error | null;
+    enabled: boolean;
+    login: AuthAdapter["login"];
+    logout: () => Promise<void>;
+    expire: () => void;
+}
+export declare function AuthProvider({ adapter, children, onSessionChange, }: {
+    adapter?: AuthAdapter;
+    children: ReactNode;
+    onSessionChange?: () => void;
+}): import("react").JSX.Element;
+export declare function useAuth(): AuthState;
+export declare function usePermissions(): {
+    permissions: string[];
+    hasPermission: (p: string) => boolean;
+    hasAnyPermission: (p: string[]) => boolean;
+    hasAllPermissions: (p: string[]) => boolean;
+    hasRole: (r: string) => boolean;
+    can: (rule: AccessRule) => boolean;
+};
+export declare function HasPermission({ permissions, children, fallback, ...rule }: AccessRule & {
+    children: ReactNode;
+    fallback?: ReactNode;
+}): import("react").JSX.Element;
+export declare function createRestAuth(options: {
+    client: HttpClient;
+    endpoints: {
+        session: string;
+        login: string;
+        logout: string;
+    };
+    mapSession: (body: unknown) => AuthSession | null;
+    onLogin?: (body: unknown) => void | Promise<void>;
+    onLogout?: () => void | Promise<void>;
+}): AuthAdapter;
+export {};

package/dist/auth.js

@@ -0,0 +1,136 @@
+import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+import { createContext, useContext, useEffect, useRef, useState, } from "react";
+import { canAccess } from "./types.js";
+const AuthContext = createContext(null);
+export function AuthProvider({ adapter, children, onSessionChange, }) {
+    const [session, setSession] = useState(null);
+    const [status, setStatus] = useState(adapter ? "loading" : "anonymous");
+    const [error, setError] = useState(null);
+    const epoch = useRef(0);
+    const expire = () => {
+        epoch.current++;
+        setSession(null);
+        setStatus("anonymous");
+        onSessionChange?.();
+    };
+    useEffect(() => {
+        if (!adapter)
+            return;
+        const controller = new AbortController();
+        const restore = async () => {
+            const generation = ++epoch.current;
+            setStatus("loading");
+            try {
+                const value = await adapter.getSession(controller.signal);
+                if (!controller.signal.aborted && generation === epoch.current) {
+                    setSession(value);
+                    setStatus(value ? "authenticated" : "anonymous");
+                    setError(null);
+                    onSessionChange?.();
+                }
+            }
+            catch (e) {
+                if (!controller.signal.aborted && generation === epoch.current) {
+                    setError(e instanceof Error ? e : new Error(String(e)));
+                    setSession(null);
+                    setStatus("anonymous");
+                }
+            }
+        };
+        void restore();
+        const unsubscribe = adapter.subscribe?.(() => {
+            void restore();
+        });
+        return () => {
+            controller.abort();
+            unsubscribe?.();
+        };
+    }, [adapter]);
+    const login = async (credentials) => {
+        if (!adapter)
+            throw new Error("GoStack: authentication is not configured.");
+        const generation = ++epoch.current;
+        setError(null);
+        const value = await adapter.login(credentials);
+        if (generation === epoch.current) {
+            onSessionChange?.();
+            setSession(value);
+            setStatus("authenticated");
+        }
+        return value;
+    };
+    const logout = async () => {
+        try {
+            await adapter?.logout();
+        }
+        finally {
+            expire();
+        }
+    };
+    return (_jsx(AuthContext.Provider, { value: {
+            session,
+            status,
+            error,
+            enabled: !!adapter,
+            login,
+            logout,
+            expire,
+        }, children: children }));
+}
+export function useAuth() {
+    const value = useContext(AuthContext);
+    if (!value)
+        throw new Error("useAuth requires GoStack AuthProvider.");
+    return value;
+}
+export function usePermissions() {
+    const { session } = useAuth();
+    return {
+        permissions: session?.permissions ?? [],
+        hasPermission: (p) => !!session?.permissions.includes(p),
+        hasAnyPermission: (p) => p.some((v) => session?.permissions.includes(v)),
+        hasAllPermissions: (p) => p.every((v) => session?.permissions.includes(v)),
+        hasRole: (r) => !!session?.roles.includes(r),
+        can: (rule) => canAccess(rule, session),
+    };
+}
+export function HasPermission({ permissions, children, fallback = null, ...rule }) {
+    const { can } = usePermissions();
+    return _jsx(_Fragment, { children: can({ ...rule, permissions }) ? children : fallback });
+}
+export function createRestAuth(options) {
+    return {
+        async getSession(signal) {
+            try {
+                return options.mapSession(await options.client.get(options.endpoints.session, {
+                    signal,
+                    auth: "optional",
+                }));
+            }
+            catch (e) {
+                if (e.status === 401)
+                    return null;
+                throw e;
+            }
+        },
+        async login(credentials) {
+            const body = await options.client.post(options.endpoints.login, credentials, { auth: "none" });
+            await options.onLogin?.(body);
+            const session = options.mapSession(body);
+            if (!session)
+                throw new Error("GoStack: login response did not produce a session.");
+            return session;
+        },
+        async logout() {
+            try {
+                await options.client.post(options.endpoints.logout, undefined, {
+                    auth: "optional",
+                });
+            }
+            finally {
+                await options.onLogout?.();
+            }
+        },
+    };
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

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

package/dist/data.d.ts

@@ -0,0 +1,25 @@
+import { QueryClient } from "@tanstack/react-query";
+import type { CrudApi, ListQueryParams } from "./api";
+export declare const createQueryClient: () => QueryClient;
+export declare const createQueryKeys: (entity: string) => {
+    all: readonly [string];
+    lists: () => readonly [string, "list"];
+    list: (params?: ListQueryParams) => readonly [string, "list", ListQueryParams];
+    infinite: (params?: ListQueryParams) => readonly [string, "infinite", ListQueryParams];
+    details: () => readonly [string, "detail"];
+    detail: (id: string | number) => readonly [string, "detail", string | number];
+};
+export declare function createCrudHooks<T, Create = Partial<T>, Update = Partial<T>>({ api, keys, }: {
+    api: CrudApi<T, Create, Update>;
+    keys: ReturnType<typeof createQueryKeys>;
+}): {
+    useList(params?: ListQueryParams): import("@tanstack/react-query").UseQueryResult<import("./api").PaginatedResponse<T>, Error>;
+    useDetail(id?: string | number | null): import("@tanstack/react-query").UseQueryResult<T, Error>;
+    useInfinite(params?: ListQueryParams): import("@tanstack/react-query").UseInfiniteQueryResult<import("@tanstack/query-core").InfiniteData<import("./api").PaginatedResponse<T>, unknown>, Error>;
+    useCreate(): import("@tanstack/react-query").UseMutationResult<T, Error, Create, unknown>;
+    useUpdate(): import("@tanstack/react-query").UseMutationResult<T, Error, {
+        id: string | number;
+        data: Update;
+    }, unknown>;
+    useDelete(): import("@tanstack/react-query").UseMutationResult<void, Error, string | number, unknown>;
+};

package/dist/data.js

@@ -0,0 +1,73 @@
+import { QueryClient, useQuery, useInfiniteQuery, useMutation, useQueryClient, } from "@tanstack/react-query";
+export const createQueryClient = () => new QueryClient({
+    defaultOptions: {
+        queries: {
+            staleTime: 300000,
+            gcTime: 600000,
+            refetchOnWindowFocus: false,
+            retry: (count, error) => count < 2 &&
+                !(error && "status" in error && Number(error.status) < 500),
+        },
+        mutations: { retry: false },
+    },
+});
+export const createQueryKeys = (entity) => ({
+    all: [entity],
+    lists: () => [entity, "list"],
+    list: (params = {}) => [entity, "list", params],
+    infinite: (params = {}) => [entity, "infinite", params],
+    details: () => [entity, "detail"],
+    detail: (id) => [entity, "detail", id],
+});
+export function createCrudHooks({ api, keys, }) {
+    return {
+        useList(params = {}) {
+            return useQuery({
+                queryKey: keys.list(params),
+                queryFn: ({ signal }) => api.getList(params, signal),
+            });
+        },
+        useDetail(id) {
+            return useQuery({
+                queryKey: keys.detail(id ?? ""),
+                queryFn: ({ signal }) => api.getById(id, signal),
+                enabled: id !== null && id !== undefined && id !== "",
+            });
+        },
+        useInfinite(params = {}) {
+            return useInfiniteQuery({
+                queryKey: keys.infinite(params),
+                initialPageParam: 1,
+                queryFn: ({ pageParam, signal }) => api.getList({ ...params, page: pageParam }, signal),
+                getNextPageParam: (page) => page.meta.currentPage < page.meta.lastPage
+                    ? page.meta.currentPage + 1
+                    : undefined,
+            });
+        },
+        useCreate() {
+            const client = useQueryClient();
+            return useMutation({
+                mutationFn: (payload) => api.create(payload),
+                onSuccess: () => client.invalidateQueries({ queryKey: keys.all }),
+            });
+        },
+        useUpdate() {
+            const client = useQueryClient();
+            return useMutation({
+                mutationFn: ({ id, data }) => api.update(id, data),
+                onSuccess: () => client.invalidateQueries({ queryKey: keys.all }),
+            });
+        },
+        useDelete() {
+            const client = useQueryClient();
+            return useMutation({
+                mutationFn: (id) => api.delete(id),
+                onSuccess: (_, id) => {
+                    client.removeQueries({ queryKey: keys.detail(id) });
+                    return client.invalidateQueries({ queryKey: keys.all });
+                },
+            });
+        },
+    };
+}
+//# sourceMappingURL=data.js.map

package/dist/data.js.map

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

package/dist/examples.d.ts

@@ -0,0 +1,6 @@
+import { type CrudApi } from "./api";
+/** Explicit in-memory example source, never a fallback for remote failures. */
+export declare function createExampleApi<T extends {
+    id: string;
+    name?: string;
+}>(initial: T[]): CrudApi<T>;

package/dist/examples.js

@@ -0,0 +1,47 @@
+import { ApiError } from "./api.js";
+/** Explicit in-memory example source, never a fallback for remote failures. */
+export function createExampleApi(initial) {
+    let items = structuredClone(initial);
+    return {
+        async getList(params = {}, signal) {
+            signal?.throwIfAborted();
+            const page = Number(params.page ?? 1), perPage = Number(params.perPage ?? 25);
+            const filtered = items.filter((item) => !params.search ||
+                item.name
+                    ?.toLowerCase()
+                    .includes(String(params.search).toLowerCase()));
+            return {
+                items: structuredClone(filtered.slice((page - 1) * perPage, page * perPage)),
+                meta: {
+                    currentPage: page,
+                    perPage,
+                    lastPage: Math.max(1, Math.ceil(filtered.length / perPage)),
+                    total: filtered.length,
+                },
+            };
+        },
+        async getById(id, signal) {
+            signal?.throwIfAborted();
+            const item = items.find((value) => value.id === String(id));
+            if (!item)
+                throw new ApiError("Example item not found", 404);
+            return structuredClone(item);
+        },
+        async create(payload) {
+            const item = { ...payload, id: crypto.randomUUID() };
+            items.push(item);
+            return structuredClone(item);
+        },
+        async update(id, payload) {
+            const index = items.findIndex((item) => item.id === String(id));
+            if (index < 0)
+                throw new ApiError("Example item not found", 404);
+            items[index] = { ...items[index], ...payload, id: String(id) };
+            return structuredClone(items[index]);
+        },
+        async delete(id) {
+            items = items.filter((item) => item.id !== String(id));
+        },
+    };
+}
+//# sourceMappingURL=examples.js.map

package/dist/examples.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"examples.js","sourceRoot":"","sources":["../src/examples.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAgB,MAAM,OAAO,CAAC;AAC/C,+EAA+E;AAC/E,MAAM,UAAU,gBAAgB,CAC9B,OAAY;IAEZ,IAAI,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACrC,OAAO;QACL,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,EAAE,EAAE,MAAM;YAC/B,MAAM,EAAE,cAAc,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,EACnC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;YACzC,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAC3B,CAAC,IAAI,EAAE,EAAE,CACP,CAAC,MAAM,CAAC,MAAM;gBACd,IAAI,CAAC,IAAI;oBACP,EAAE,WAAW,EAAE;qBACd,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,CACnD,CAAC;YACF,OAAO;gBACL,KAAK,EAAE,eAAe,CACpB,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,GAAG,OAAO,CAAC,CACrD;gBACD,IAAI,EAAE;oBACJ,WAAW,EAAE,IAAI;oBACjB,OAAO;oBACP,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC;oBAC3D,KAAK,EAAE,QAAQ,CAAC,MAAM;iBACvB;aACF,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM;YACtB,MAAM,EAAE,cAAc,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;YAC5D,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,QAAQ,CAAC,wBAAwB,EAAE,GAAG,CAAC,CAAC;YAC7D,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,OAAO;YAClB,MAAM,IAAI,GAAG,EAAE,GAAG,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE,EAAO,CAAC;YAC1D,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjB,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO;YACtB,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;YAChE,IAAI,KAAK,GAAG,CAAC;gBAAE,MAAM,IAAI,QAAQ,CAAC,wBAAwB,EAAE,GAAG,CAAC,CAAC;YACjE,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,GAAG,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;YAC/D,OAAO,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QACvC,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,EAAE;YACb,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QACzD,CAAC;KACF,CAAC;AACJ,CAAC"}