@vlian/framework 1.0.0

package/dist/request/types.d.ts

@@ -0,0 +1,395 @@
+/**
+ * 请求库核心类型定义
+ */
+/**
+ * HTTP 请求方法
+ */
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';
+/**
+ * 请求头类型
+ */
+export type RequestHeaders = Record<string, string | number | boolean>;
+/**
+ * 请求查询参数类型
+ */
+export type RequestQuery = Record<string, string | number | boolean | null | undefined>;
+/**
+ * 请求体类型
+ */
+export type RequestBody = string | FormData | URLSearchParams | Blob | ArrayBuffer | Record<string, unknown> | null;
+/**
+ * 请求配置选项
+ *
+ * @template TResponse - 响应数据类型（用于类型推导）
+ */
+export interface RequestOptions<TResponse = unknown> {
+    /**
+     * 响应类型占位符（用于类型推导，实际不使用）
+     * @internal
+     */
+    _responseType?: TResponse;
+    /**
+     * 请求方法
+     */
+    method?: HttpMethod;
+    /**
+     * 请求 URL
+     */
+    url: string;
+    /**
+     * 请求头
+     */
+    headers?: RequestHeaders;
+    /**
+     * 查询参数
+     */
+    query?: RequestQuery;
+    /**
+     * 请求体
+     */
+    body?: RequestBody;
+    /**
+     * 请求超时时间（毫秒）
+     */
+    timeout?: number;
+    /**
+     * 是否允许跨域请求
+     */
+    credentials?: 'include' | 'same-origin' | 'omit';
+    /**
+     * 响应类型
+     */
+    responseType?: 'json' | 'text' | 'blob' | 'arrayBuffer' | 'formData';
+    /**
+     * 是否中止请求
+     */
+    signal?: AbortSignal;
+    /**
+     * 请求元数据（用于插件扩展）
+     */
+    meta?: Record<string, unknown>;
+    /**
+     * 请求标签（用于缓存、监控等）
+     */
+    tags?: string[];
+    /**
+     * 是否跳过默认插件
+     */
+    skipPlugins?: string[];
+    /**
+     * 请求重试配置
+     */
+    retry?: RetryConfig;
+    /**
+     * 请求缓存配置
+     */
+    cache?: CacheConfig;
+    /**
+     * 请求验证配置
+     */
+    validation?: ValidationConfig;
+}
+/**
+ * 重试配置
+ */
+export interface RetryConfig {
+    /**
+     * 最大重试次数
+     */
+    maxAttempts?: number;
+    /**
+     * 重试延迟（毫秒）
+     */
+    delay?: number;
+    /**
+     * 重试延迟策略（指数退避）
+     */
+    exponentialBackoff?: boolean;
+    /**
+     * 重试条件函数
+     */
+    shouldRetry?: (error: unknown, attempt: number) => boolean;
+    /**
+     * 重试延迟计算函数
+     */
+    calculateDelay?: (attempt: number) => number;
+}
+/**
+ * 缓存配置
+ */
+export interface CacheConfig {
+    /**
+     * 缓存键
+     */
+    key?: string;
+    /**
+     * 缓存时间（毫秒）
+     */
+    ttl?: number;
+    /**
+     * 是否强制刷新
+     */
+    forceRefresh?: boolean;
+    /**
+     * 缓存存储类型
+     */
+    storage?: 'memory' | 'localStorage' | 'sessionStorage';
+    /**
+     * 缓存条件函数
+     */
+    shouldCache?: (response: Response<unknown>) => boolean;
+}
+/**
+ * 验证配置
+ *
+ * @template TResponse - 响应数据类型
+ */
+export interface ValidationConfig {
+    /**
+     * 请求参数验证 Schema（Zod）
+     */
+    requestSchema?: unknown;
+    /**
+     * 响应数据验证 Schema（Zod）
+     */
+    responseSchema?: unknown;
+    /**
+     * 验证失败时的处理方式
+     */
+    onValidationError?: (error: unknown) => void;
+}
+/**
+ * 响应对象
+ *
+ * @template TData - 响应数据类型
+ * @template TMeta - 响应元数据类型
+ */
+export interface Response<TData = unknown, TMeta = Record<string, unknown>> {
+    /**
+     * 响应数据
+     */
+    data: TData;
+    /**
+     * HTTP 状态码
+     */
+    status: number;
+    /**
+     * HTTP 状态文本
+     */
+    statusText: string;
+    /**
+     * 响应头
+     */
+    headers: RequestHeaders;
+    /**
+     * 响应元数据（由插件注入）
+     */
+    meta?: TMeta;
+    /**
+     * 原始响应对象（适配器提供）
+     */
+    raw?: unknown;
+}
+/**
+ * 请求错误类型
+ */
+export declare enum RequestErrorType {
+    /**
+     * 网络错误
+     */
+    NETWORK_ERROR = "NETWORK_ERROR",
+    /**
+     * 超时错误
+     */
+    TIMEOUT_ERROR = "TIMEOUT_ERROR",
+    /**
+     * HTTP 错误（4xx, 5xx）
+     */
+    HTTP_ERROR = "HTTP_ERROR",
+    /**
+     * 取消错误
+     */
+    ABORT_ERROR = "ABORT_ERROR",
+    /**
+     * 验证错误
+     */
+    VALIDATION_ERROR = "VALIDATION_ERROR",
+    /**
+     * 未知错误
+     */
+    UNKNOWN_ERROR = "UNKNOWN_ERROR"
+}
+/**
+ * 请求错误代码
+ */
+export declare enum RequestErrorCode {
+    /**
+     * 网络连接失败
+     */
+    NETWORK_CONNECTION_FAILED = "NETWORK_CONNECTION_FAILED",
+    /**
+     * 请求超时
+     */
+    REQUEST_TIMEOUT = "REQUEST_TIMEOUT",
+    /**
+     * 服务器错误（5xx）
+     */
+    SERVER_ERROR = "SERVER_ERROR",
+    /**
+     * 客户端错误（4xx）
+     */
+    CLIENT_ERROR = "CLIENT_ERROR",
+    /**
+     * 请求被取消
+     */
+    REQUEST_ABORTED = "REQUEST_ABORTED",
+    /**
+     * 响应验证失败
+     */
+    RESPONSE_VALIDATION_FAILED = "RESPONSE_VALIDATION_FAILED",
+    /**
+     * 请求参数验证失败
+     */
+    REQUEST_VALIDATION_FAILED = "REQUEST_VALIDATION_FAILED"
+}
+/**
+ * 请求错误类
+ */
+export declare class RequestError extends Error {
+    /**
+     * 错误类型
+     */
+    type: RequestErrorType;
+    /**
+     * 错误代码
+     */
+    code: RequestErrorCode;
+    /**
+     * HTTP 状态码（如果有）
+     */
+    status?: number;
+    /**
+     * 原始错误
+     */
+    cause?: unknown;
+    /**
+     * 请求配置
+     */
+    request?: RequestOptions;
+    /**
+     * 响应数据（如果有）
+     */
+    response?: Response;
+    /**
+     * 错误上下文
+     */
+    context?: Record<string, unknown>;
+    constructor(message: string, type: RequestErrorType, code: RequestErrorCode, options?: {
+        status?: number;
+        cause?: unknown;
+        request?: RequestOptions;
+        response?: Response;
+        context?: Record<string, unknown>;
+    });
+}
+/**
+ * 请求上下文
+ *
+ * @template TRequest - 请求配置类型
+ * @template TResponse - 响应类型
+ * @template TMeta - 元数据类型
+ */
+export interface RequestContext<TRequest = RequestOptions, TResponse = Response, TMeta = Record<string, unknown>> {
+    /**
+     * 请求配置
+     */
+    request: TRequest;
+    /**
+     * 响应（如果已收到）
+     */
+    response?: TResponse;
+    /**
+     * 错误（如果发生）
+     */
+    error?: RequestError;
+    /**
+     * 上下文元数据（由插件注入）
+     */
+    meta: TMeta;
+    /**
+     * 请求开始时间
+     */
+    startTime: number;
+    /**
+     * 请求结束时间（如果已完成）
+     */
+    endTime?: number;
+    /**
+     * 请求耗时（毫秒）
+     */
+    duration?: number;
+    /**
+     * 重试次数
+     */
+    retryCount: number;
+    /**
+     * 是否已取消
+     */
+    cancelled: boolean;
+    /**
+     * 中止控制器
+     */
+    abortController?: AbortController;
+}
+/**
+ * 适配器能力声明
+ */
+export interface AdapterCapabilities {
+    /**
+     * 是否支持取消请求
+     */
+    supportsAbort?: boolean;
+    /**
+     * 是否支持超时
+     */
+    supportsTimeout?: boolean;
+    /**
+     * 是否支持进度追踪
+     */
+    supportsProgress?: boolean;
+    /**
+     * 是否支持拦截器
+     */
+    supportsInterceptors?: boolean;
+}
+/**
+ * 请求客户端配置
+ */
+export interface RequestClientConfig {
+    /**
+     * 基础 URL
+     */
+    baseURL?: string;
+    /**
+     * 默认请求头
+     */
+    defaultHeaders?: RequestHeaders;
+    /**
+     * 默认超时时间（毫秒）
+     */
+    defaultTimeout?: number;
+    /**
+     * 默认适配器（按需加载）
+     * 可以是适配器名称字符串，或返回适配器的工厂函数
+     */
+    defaultAdapter?: string | (() => Promise<import('./adapter/RequestAdapter').RequestAdapter>);
+    /**
+     * 插件列表
+     */
+    plugins?: Array<import('./plugin/RequestPlugin').RequestPlugin>;
+    /**
+     * 是否启用开发模式
+     */
+    devMode?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/request/types.d.ts.map

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

package/dist/request/types.js

@@ -0,0 +1,97 @@
+/**
+ * 请求库核心类型定义
+ */ /**
+ * HTTP 请求方法
+ */ function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+/**
+ * 请求错误类型
+ */ export var RequestErrorType = /*#__PURE__*/ function(RequestErrorType) {
+    /**
+   * 网络错误
+   */ RequestErrorType["NETWORK_ERROR"] = "NETWORK_ERROR";
+    /**
+   * 超时错误
+   */ RequestErrorType["TIMEOUT_ERROR"] = "TIMEOUT_ERROR";
+    /**
+   * HTTP 错误（4xx, 5xx）
+   */ RequestErrorType["HTTP_ERROR"] = "HTTP_ERROR";
+    /**
+   * 取消错误
+   */ RequestErrorType["ABORT_ERROR"] = "ABORT_ERROR";
+    /**
+   * 验证错误
+   */ RequestErrorType["VALIDATION_ERROR"] = "VALIDATION_ERROR";
+    /**
+   * 未知错误
+   */ RequestErrorType["UNKNOWN_ERROR"] = "UNKNOWN_ERROR";
+    return RequestErrorType;
+}({});
+/**
+ * 请求错误代码
+ */ export var RequestErrorCode = /*#__PURE__*/ function(RequestErrorCode) {
+    /**
+   * 网络连接失败
+   */ RequestErrorCode["NETWORK_CONNECTION_FAILED"] = "NETWORK_CONNECTION_FAILED";
+    /**
+   * 请求超时
+   */ RequestErrorCode["REQUEST_TIMEOUT"] = "REQUEST_TIMEOUT";
+    /**
+   * 服务器错误（5xx）
+   */ RequestErrorCode["SERVER_ERROR"] = "SERVER_ERROR";
+    /**
+   * 客户端错误（4xx）
+   */ RequestErrorCode["CLIENT_ERROR"] = "CLIENT_ERROR";
+    /**
+   * 请求被取消
+   */ RequestErrorCode["REQUEST_ABORTED"] = "REQUEST_ABORTED";
+    /**
+   * 响应验证失败
+   */ RequestErrorCode["RESPONSE_VALIDATION_FAILED"] = "RESPONSE_VALIDATION_FAILED";
+    /**
+   * 请求参数验证失败
+   */ RequestErrorCode["REQUEST_VALIDATION_FAILED"] = "REQUEST_VALIDATION_FAILED";
+    return RequestErrorCode;
+}({});
+/**
+ * 请求错误类
+ */ export class RequestError extends Error {
+    constructor(message, type, code, options){
+        super(message), /**
+   * 错误类型
+   */ _define_property(this, "type", void 0), /**
+   * 错误代码
+   */ _define_property(this, "code", void 0), /**
+   * HTTP 状态码（如果有）
+   */ _define_property(this, "status", void 0), /**
+   * 原始错误
+   */ _define_property(this, "cause", void 0), /**
+   * 请求配置
+   */ _define_property(this, "request", void 0), /**
+   * 响应数据（如果有）
+   */ _define_property(this, "response", void 0), /**
+   * 错误上下文
+   */ _define_property(this, "context", void 0);
+        this.name = 'RequestError';
+        this.type = type;
+        this.code = code;
+        this.status = options?.status;
+        this.cause = options?.cause;
+        this.request = options?.request;
+        this.response = options?.response;
+        this.context = options?.context;
+    }
+}
+
+//# sourceMappingURL=types.js.map

package/dist/request/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/request/types.ts"],"sourcesContent":["/**\n * 请求库核心类型定义\n */\n\n/**\n * HTTP 请求方法\n */\nexport type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';\n\n/**\n * 请求头类型\n */\nexport type RequestHeaders = Record<string, string | number | boolean>;\n\n/**\n * 请求查询参数类型\n */\nexport type RequestQuery = Record<string, string | number | boolean | null | undefined>;\n\n/**\n * 请求体类型\n */\nexport type RequestBody = string | FormData | URLSearchParams | Blob | ArrayBuffer | Record<string, unknown> | null;\n\n/**\n * 请求配置选项\n * \n * @template TResponse - 响应数据类型（用于类型推导）\n */\nexport interface RequestOptions<TResponse = unknown> {\n  /**\n   * 响应类型占位符（用于类型推导，实际不使用）\n   * @internal\n   */\n  _responseType?: TResponse;\n\n  /**\n   * 请求方法\n   */\n  method?: HttpMethod;\n\n  /**\n   * 请求 URL\n   */\n  url: string;\n\n  /**\n   * 请求头\n   */\n  headers?: RequestHeaders;\n\n  /**\n   * 查询参数\n   */\n  query?: RequestQuery;\n\n  /**\n   * 请求体\n   */\n  body?: RequestBody;\n\n  /**\n   * 请求超时时间（毫秒）\n   */\n  timeout?: number;\n\n  /**\n   * 是否允许跨域请求\n   */\n  credentials?: 'include' | 'same-origin' | 'omit';\n\n  /**\n   * 响应类型\n   */\n  responseType?: 'json' | 'text' | 'blob' | 'arrayBuffer' | 'formData';\n\n  /**\n   * 是否中止请求\n   */\n  signal?: AbortSignal;\n\n  /**\n   * 请求元数据（用于插件扩展）\n   */\n  meta?: Record<string, unknown>;\n\n  /**\n   * 请求标签（用于缓存、监控等）\n   */\n  tags?: string[];\n\n  /**\n   * 是否跳过默认插件\n   */\n  skipPlugins?: string[];\n\n  /**\n   * 请求重试配置\n   */\n  retry?: RetryConfig;\n\n  /**\n   * 请求缓存配置\n   */\n  cache?: CacheConfig;\n\n  /**\n   * 请求验证配置\n   */\n  validation?: ValidationConfig;\n}\n\n/**\n * 重试配置\n */\nexport interface RetryConfig {\n  /**\n   * 最大重试次数\n   */\n  maxAttempts?: number;\n\n  /**\n   * 重试延迟（毫秒）\n   */\n  delay?: number;\n\n  /**\n   * 重试延迟策略（指数退避）\n   */\n  exponentialBackoff?: boolean;\n\n  /**\n   * 重试条件函数\n   */\n  shouldRetry?: (error: unknown, attempt: number) => boolean;\n\n  /**\n   * 重试延迟计算函数\n   */\n  calculateDelay?: (attempt: number) => number;\n}\n\n/**\n * 缓存配置\n */\nexport interface CacheConfig {\n  /**\n   * 缓存键\n   */\n  key?: string;\n\n  /**\n   * 缓存时间（毫秒）\n   */\n  ttl?: number;\n\n  /**\n   * 是否强制刷新\n   */\n  forceRefresh?: boolean;\n\n  /**\n   * 缓存存储类型\n   */\n  storage?: 'memory' | 'localStorage' | 'sessionStorage';\n\n  /**\n   * 缓存条件函数\n   */\n  shouldCache?: (response: Response<unknown>) => boolean;\n}\n\n/**\n * 验证配置\n * \n * @template TResponse - 响应数据类型\n */\nexport interface ValidationConfig {\n  /**\n   * 请求参数验证 Schema（Zod）\n   */\n  requestSchema?: unknown;\n\n  /**\n   * 响应数据验证 Schema（Zod）\n   */\n  responseSchema?: unknown;\n\n  /**\n   * 验证失败时的处理方式\n   */\n  onValidationError?: (error: unknown) => void;\n}\n\n/**\n * 响应对象\n * \n * @template TData - 响应数据类型\n * @template TMeta - 响应元数据类型\n */\nexport interface Response<TData = unknown, TMeta = Record<string, unknown>> {\n  /**\n   * 响应数据\n   */\n  data: TData;\n\n  /**\n   * HTTP 状态码\n   */\n  status: number;\n\n  /**\n   * HTTP 状态文本\n   */\n  statusText: string;\n\n  /**\n   * 响应头\n   */\n  headers: RequestHeaders;\n\n  /**\n   * 响应元数据（由插件注入）\n   */\n  meta?: TMeta;\n\n  /**\n   * 原始响应对象（适配器提供）\n   */\n  raw?: unknown;\n}\n\n/**\n * 请求错误类型\n */\nexport enum RequestErrorType {\n  /**\n   * 网络错误\n   */\n  NETWORK_ERROR = 'NETWORK_ERROR',\n\n  /**\n   * 超时错误\n   */\n  TIMEOUT_ERROR = 'TIMEOUT_ERROR',\n\n  /**\n   * HTTP 错误（4xx, 5xx）\n   */\n  HTTP_ERROR = 'HTTP_ERROR',\n\n  /**\n   * 取消错误\n   */\n  ABORT_ERROR = 'ABORT_ERROR',\n\n  /**\n   * 验证错误\n   */\n  VALIDATION_ERROR = 'VALIDATION_ERROR',\n\n  /**\n   * 未知错误\n   */\n  UNKNOWN_ERROR = 'UNKNOWN_ERROR',\n}\n\n/**\n * 请求错误代码\n */\nexport enum RequestErrorCode {\n  /**\n   * 网络连接失败\n   */\n  NETWORK_CONNECTION_FAILED = 'NETWORK_CONNECTION_FAILED',\n\n  /**\n   * 请求超时\n   */\n  REQUEST_TIMEOUT = 'REQUEST_TIMEOUT',\n\n  /**\n   * 服务器错误（5xx）\n   */\n  SERVER_ERROR = 'SERVER_ERROR',\n\n  /**\n   * 客户端错误（4xx）\n   */\n  CLIENT_ERROR = 'CLIENT_ERROR',\n\n  /**\n   * 请求被取消\n   */\n  REQUEST_ABORTED = 'REQUEST_ABORTED',\n\n  /**\n   * 响应验证失败\n   */\n  RESPONSE_VALIDATION_FAILED = 'RESPONSE_VALIDATION_FAILED',\n\n  /**\n   * 请求参数验证失败\n   */\n  REQUEST_VALIDATION_FAILED = 'REQUEST_VALIDATION_FAILED',\n}\n\n/**\n * 请求错误类\n */\nexport class RequestError extends Error {\n  /**\n   * 错误类型\n   */\n  type: RequestErrorType;\n\n  /**\n   * 错误代码\n   */\n  code: RequestErrorCode;\n\n  /**\n   * HTTP 状态码（如果有）\n   */\n  status?: number;\n\n  /**\n   * 原始错误\n   */\n  cause?: unknown;\n\n  /**\n   * 请求配置\n   */\n  request?: RequestOptions;\n\n  /**\n   * 响应数据（如果有）\n   */\n  response?: Response;\n\n  /**\n   * 错误上下文\n   */\n  context?: Record<string, unknown>;\n\n  constructor(\n    message: string,\n    type: RequestErrorType,\n    code: RequestErrorCode,\n    options?: {\n      status?: number;\n      cause?: unknown;\n      request?: RequestOptions;\n      response?: Response;\n      context?: Record<string, unknown>;\n    }\n  ) {\n    super(message);\n    this.name = 'RequestError';\n    this.type = type;\n    this.code = code;\n    this.status = options?.status;\n    this.cause = options?.cause;\n    this.request = options?.request;\n    this.response = options?.response;\n    this.context = options?.context;\n  }\n}\n\n/**\n * 请求上下文\n * \n * @template TRequest - 请求配置类型\n * @template TResponse - 响应类型\n * @template TMeta - 元数据类型\n */\nexport interface RequestContext<TRequest = RequestOptions, TResponse = Response, TMeta = Record<string, unknown>> {\n  /**\n   * 请求配置\n   */\n  request: TRequest;\n\n  /**\n   * 响应（如果已收到）\n   */\n  response?: TResponse;\n\n  /**\n   * 错误（如果发生）\n   */\n  error?: RequestError;\n\n  /**\n   * 上下文元数据（由插件注入）\n   */\n  meta: TMeta;\n\n  /**\n   * 请求开始时间\n   */\n  startTime: number;\n\n  /**\n   * 请求结束时间（如果已完成）\n   */\n  endTime?: number;\n\n  /**\n   * 请求耗时（毫秒）\n   */\n  duration?: number;\n\n  /**\n   * 重试次数\n   */\n  retryCount: number;\n\n  /**\n   * 是否已取消\n   */\n  cancelled: boolean;\n\n  /**\n   * 中止控制器\n   */\n  abortController?: AbortController;\n}\n\n/**\n * 适配器能力声明\n */\nexport interface AdapterCapabilities {\n  /**\n   * 是否支持取消请求\n   */\n  supportsAbort?: boolean;\n\n  /**\n   * 是否支持超时\n   */\n  supportsTimeout?: boolean;\n\n  /**\n   * 是否支持进度追踪\n   */\n  supportsProgress?: boolean;\n\n  /**\n   * 是否支持拦截器\n   */\n  supportsInterceptors?: boolean;\n}\n\n/**\n * 请求客户端配置\n */\nexport interface RequestClientConfig {\n  /**\n   * 基础 URL\n   */\n  baseURL?: string;\n\n  /**\n   * 默认请求头\n   */\n  defaultHeaders?: RequestHeaders;\n\n  /**\n   * 默认超时时间（毫秒）\n   */\n  defaultTimeout?: number;\n\n  /**\n   * 默认适配器（按需加载）\n   * 可以是适配器名称字符串，或返回适配器的工厂函数\n   */\n  defaultAdapter?: string | (() => Promise<import('./adapter/RequestAdapter').RequestAdapter>);\n\n  /**\n   * 插件列表\n   */\n  plugins?: Array<import('./plugin/RequestPlugin').RequestPlugin>;\n\n  /**\n   * 是否启用开发模式\n   */\n  devMode?: boolean;\n}\n"],"names":["RequestErrorType","RequestErrorCode","RequestError","Error","message","type","code","options","status","cause","request","response","context","name"],"mappings":"AAAA;;CAEC,GAED;;CAEC;;;;;;;;;;;;;AAkOD;;CAEC,GACD,OAAO,IAAA,AAAKA,0CAAAA;IACV;;GAEC;IAGD;;GAEC;IAGD;;GAEC;IAGD;;GAEC;IAGD;;GAEC;IAGD;;GAEC;WA5BSA;MA8BX;AAED;;CAEC,GACD,OAAO,IAAA,AAAKC,0CAAAA;IACV;;GAEC;IAGD;;GAEC;IAGD;;GAEC;IAGD;;GAEC;IAGD;;GAEC;IAGD;;GAEC;IAGD;;GAEC;WAjCSA;MAmCX;AAED;;CAEC,GACD,OAAO,MAAMC,qBAAqBC;IAoChC,YACEC,OAAe,EACfC,IAAsB,EACtBC,IAAsB,EACtBC,OAMC,CACD;QACA,KAAK,CAACH,UA/CR;;GAEC,GACDC,uBAAAA,QAAAA,KAAAA,IAEA;;GAEC,GACDC,uBAAAA,QAAAA,KAAAA,IAEA;;GAEC,GACDE,uBAAAA,UAAAA,KAAAA,IAEA;;GAEC,GACDC,uBAAAA,SAAAA,KAAAA,IAEA;;GAEC,GACDC,uBAAAA,WAAAA,KAAAA,IAEA;;GAEC,GACDC,uBAAAA,YAAAA,KAAAA,IAEA;;GAEC,GACDC,uBAAAA,WAAAA,KAAAA;QAeE,IAAI,CAACC,IAAI,GAAG;QACZ,IAAI,CAACR,IAAI,GAAGA;QACZ,IAAI,CAACC,IAAI,GAAGA;QACZ,IAAI,CAACE,MAAM,GAAGD,SAASC;QACvB,IAAI,CAACC,KAAK,GAAGF,SAASE;QACtB,IAAI,CAACC,OAAO,GAAGH,SAASG;QACxB,IAAI,CAACC,QAAQ,GAAGJ,SAASI;QACzB,IAAI,CAACC,OAAO,GAAGL,SAASK;IAC1B;AACF"}