@shimotsuki/core 3.0.0 → 3.0.2

package/dist/index.d.ts

@@ -1,1113 +1,1114 @@
-import { Component, Node, Prefab, Vec3, Quat, math, Layers, AudioClip, AudioSource, Label, Button, Scene, SceneAsset, AsyncDelegate, Asset, Constructor, AssetManager, SpriteFrame, Sprite } from 'cc';
-import EventEmitter from 'eventemitter3';
-import { IReactionPublic, IReactionOptions } from '@shimotsuki/mobx';
-import { SocialGameClient, SocialGameClientOption, AllEventResponsePairs, ClientOption, MessageFns, AudienceOptions } from 'sgc';
-import { BinaryWriter } from '@bufbuild/protobuf/wire';
-import * as crypto_es_lib_cipher_core from 'crypto-es/lib/cipher-core';
-
-/**
-* @describe 基础管理类
-* @author 游金宇(KM)
-* @date 2024-09-12 11:49:30
-*/
-
-declare class BaseManager {
-    protected cat: Manager;
-    constructor(manager: Manager);
-}
-
-/**
- * 音频管理
- */
-declare class AudioManager extends BaseManager {
-    local_data: any;
-    private music;
-    private effect;
-    private _volume_music;
-    private _volume_effect;
-    private _switch_music;
-    private _switch_effect;
-    private local_store_key;
-    extra: {
-        [key: string]: any;
-    };
-    constructor(cat: Manager);
-    /**
-     * 设置背景音乐播放完成回调
-     * @param callback 背景音乐播放完成回调
-     */
-    setMusicComplete(callback?: Function | null): void;
-    /**
-     * 播放背景音乐
-     * @param url        资源地址
-     * @param callback   音乐播放完成事件
-     */
-    playMusic(url: string): Promise<void>;
-    playMusic(bundleName: string, url: string): Promise<void>;
-    /**
-     * 停止音乐
-     */
-    stopMusic(): void;
-    /**暂停音乐 */
-    pauseMusic(): void;
-    /**恢复音乐 */
-    resumeMusic(): void;
-    /**
-     * 获取背景音乐播放进度
-     */
-    get progressMusic(): number;
-    /**
-     * 设置背景乐播放进度
-     * @param value     播放进度值
-     */
-    set progressMusic(value: number);
-    /**
-     * 获取背景音乐音量
-     */
-    get volumeMusic(): number;
-    /**
-     * 设置背景音乐音量
-     * @param value     音乐音量值
-     */
-    set volumeMusic(value: number);
-    /**
-     * 获取背景音乐开关值
-     */
-    get switchMusic(): boolean;
-    /**
-     * 设置背景音乐开关值
-     * @param value     开关值
-     */
-    set switchMusic(value: boolean);
-    /**
-     * 播放音效
-     * @param url  资源地址
-     */
-    playEffect(url: string): Promise<void>;
-    playEffect(bundleName: string, url: string): Promise<void>;
-    /**
-     * 停止音效
-     */
-    stopEffect(): void;
-    /**
-     * 获取音效音量
-     */
-    get volumeEffect(): number;
-    /**
-     * 设置获取音效音量
-     * @param value     音效音量值
-     */
-    set volumeEffect(value: number);
-    /**
-     * 获取音效开关值
-     */
-    get switchEffect(): boolean;
-    /**
-     * 设置音效开关值
-     * @param value     音效开关值
-     */
-    set switchEffect(value: boolean);
-    /** 恢复当前暂停的音乐与音效播放 */
-    resumeAll(): void;
-    /** 暂停当前音乐与音效的播放 */
-    pauseAll(): void;
-    /** 停止当前音乐与音效的播放 */
-    stopAll(): void;
-    /** 保存音乐音效的音量、开关配置数据到本地 */
-    save(): this;
-    /** 本地加载音乐音效的音量、开关配置数据并设置到游戏中 */
-    load(): void;
-}
-
-/**
- * @describe 组件基类
- * @author 游金宇(KM)
- * @date 2023-09-19 12:32:22
- */
-
-type HOOK_NAME = 'destroyed' | 'started';
-type HOOK = {
-    [key in HOOK_NAME]?: () => void;
-};
-interface IUIOption<T extends object = {}, U extends object = {}> {
-    /**组件传值间属性值 */
-    props?: T;
-    /**组件数据 */
-    data?: U;
-    /**钩子 */
-    hook?: HOOK;
-}
-/**参数 */
-/**initUI->onAutoObserver->onLoad->start */
-declare class BaseComponent<T extends object = {}, K extends object = {}> extends Component {
-    /**组件(传值)属性 */
-    props: T;
-    /**自由属性 */
-    data: K;
-    cat: typeof globalThis._cat;
-    /**autorun销毁 */
-    private autorunDisposers;
-    /**reaction销毁 */
-    private reactionDisposers;
-    private eventEmitter;
-    hook: HOOK;
-    /**初始化UI(可在本函数中进行节点赋值或注册节点事件等...) */
-    protected initUI(): void;
-    protected __preload(): void;
-    constructor();
-    /**依赖收集生命周期(可以在该生命周期中注册依赖收集回调) */
-    protected onAutoObserver(): void;
-    /**添加自动收集 */
-    protected addAutorun(cb: (() => void) | (() => void)[]): this;
-    /**添加自动收集 */
-    protected addReaction<T, FireImmediately extends boolean = false>(expression: (r: IReactionPublic) => T, effect: (arg: T, prev: FireImmediately extends true ? T | undefined : T, r: IReactionPublic) => void, opts?: IReactionOptions<T, FireImmediately>): this;
-    protected addAudoListener<E extends EventEmitter<any>>(eventEmitter: E): E;
-    _onPreDestroy(): void;
-    protected onDisable(): void;
-    private deleteAllEventByEmitter;
-    protected onEnable(): void;
-    /**子类继承该方法(全局事件(this.cat.event)注册在components上的事件可以不添加取消监听(自动取消监听了)) */
-    protected onEventListener(): void;
-    /**子类继承该方法 */
-    protected addListener(): void;
-    /**子类继承该方法 */
-    protected removeListener(): void;
-    /**
-     * 添加到父节点指定层级
-     * @param parent 父节点
-     * @param index 插入的层级索引
-     * @param options 参数
-     * @returns 自身组件
-     */
-    addToParent(parent: Node | Prefab | Component, index: number, options?: IUIOption<T, K>): this;
-    addToParent(parent: Node | Prefab | Component, options?: IUIOption<T, K>): this;
-    /**设置属性(覆盖原有属性) */
-    setOptions(options?: IUIOption<T, K>): void;
-    /**设置data属性(更新) */
-    setUpdateData(data: Partial<K>): this | undefined;
-    /**设置props属性(更新)*/
-    setUpdateProps(props: Partial<T>): this | undefined;
-    /**从父节点移除并销毁 */
-    removeAndDestroy(): void;
-    /**设置坐标 */
-    setPosition(positin: Vec3): this;
-    setScale(scale: Vec3): this;
-    setAngle(angle: number): this;
-    setRotation(rotation: Quat): this;
-    setRotationFromEuler(rotation: math.Vec3): this;
-    /**显示(同onEnable) */
-    protected onShow(): void;
-    /**隐藏(同onDisable) */
-    protected onHide(): void;
-    /**设置节点和子节点的层级 */
-    setNodeAndChildrenLayer(layer: string | Layers.Enum): this;
-}
-
-/**
- * @describe UI层  所有的UI层需继承自该自组件
- * @author 游金宇(KM)
- * @date 2023-08-04 10:42:26
- */
-
-/**
- * left    从左往右
- * right   从右往左
- * top     从上往下
- * bot     从下往上
- * center  中间
- */
-type IDirection = 'left' | 'right' | 'top' | 'bot' | 'center';
-/**开启动画参数选项 */
-interface IOpenOptions<T extends object, U extends object> extends IUIOption<T, U> {
-    /**动画 */
-    isMotion?: boolean;
-    /**动画时间 */
-    duration?: number;
-    /**方向 */
-    direction?: IDirection;
-    /**是否回弹 */
-    isBounce?: boolean;
-    /**回弹时间 */
-    bounceDuration?: number;
-}
-/**关闭动画参数选项 */
-interface ICloseOptions<T extends object, U extends object> extends IUIOption<T, U> {
-    /**动画 */
-    isMotion?: boolean;
-    /**动画时间 */
-    duration?: number;
-    /**方向 */
-    direction?: IDirection;
-}
-declare class UILayer<T extends object = {}, U extends object = {}> extends BaseComponent<T, U> {
-    /**上次进入的方向 */
-    lastEnterDirection: IDirection;
-    /**屏幕尺寸 */
-    screen: math.Size;
-    /**是否正在关闭 */
-    isClosing: boolean;
-    /**组件所在的UI最顶层(不包含UI) */
-    root: Node;
-    constructor();
-    private _init;
-    /**显示动画 */
-    showTween<T extends object, U extends object = {}>({ isMotion, direction, duration, isBounce, bounceDuration }: IOpenOptions<T, U>): Promise<void>;
-    /**隐藏动画 */
-    hideTween<T extends object, U extends object>({ isMotion, direction, duration }: ICloseOptions<T, U>): Promise<void>;
-    private handle;
-    private deftween;
-}
-
-/**
-* @describe 音频组件基类
-* @author 游金宇(KM)
-* @date 2023-12-22 16:20:20
-*/
-
-/**
- * EFFECT 音效
- * BGM    音乐
- */
-declare enum AudioTypeEnum {
-    EFFECT = 0,
-    BGM = 1
-}
-declare class AudioSourceBaseComponent<T extends object = {}, K extends object = {}> extends BaseComponent<T, K> {
-    type: AudioTypeEnum;
-    clip: AudioClip;
-    loop: boolean;
-    volume: number;
-    playOnAwake: boolean;
-    audioSource: AudioSource;
-    onEnable(): void;
-    __preload(): void;
-    protected start(): void;
-    protected stopAudio(): void;
-    protected playAudio(): void;
-    protected onPlayEffectHandler(): void;
-    protected onStopEffectHandler(): void;
-    protected onPlayMusicHandler(): void;
-    protected onStopMusicHandler(): void;
-    _onPreDestroy(): void;
-}
-
-/**带有音频通道的UIlayer组件 */
-declare class AudioSourceUILayer<T extends object, U extends object = {}> extends UILayer<T, U> {
-    type: AudioTypeEnum;
-    clip: AudioClip;
-    loop: boolean;
-    volume: number;
-    playOnAwake: boolean;
-    audioSource: AudioSource;
-    onEnable(): void;
-    __preload(): void;
-    protected stopAudio(): void;
-    protected playAudio(): void;
-    protected onPlayEffectHandler(): void;
-    protected onStopEffectHandler(): void;
-    protected onPlayMusicHandler(): void;
-    protected onStopMusicHandler(): void;
-    _onPreDestroy(): void;
-}
-
-/**
-* @describe TOAST弹窗组件
-* @author 游金宇(KM)
-* @date 2024-09-12 11:42:29
-*/
-
-declare enum ToastType {
-    FIXED = 0,
-    SLIDE = 1
-}
-type ToastProps = {
-    title: string;
-    type?: ToastType;
-    fixed_time?: number;
-};
-declare class CoreToast extends BaseComponent<ToastProps> {
-    fixed_node: Node;
-    slide_node: Node;
-    fixed_label: Label;
-    slide_label: Label;
-    onLoad(): void;
-    protected start(): void;
-    show(): Promise<void>;
-    private playAnim;
-    onDestroy(): void;
-}
-
-/**
- * @describe 根级别的UI层  所有的ROOT UI层需继承自该自组件
- * @author 游金宇(KM)
- * @date 2023-08-04 10:42:26
- */
-
-declare class RootUILayer<T extends object> extends UILayer<T> {
-    protected onEnable(): void;
-    protected onDisable(): void;
-    private updateMask;
-}
-
-type CoreShowLoadingProps = {
-    /**标题 */
-    title?: string;
-    /**阻挡 */
-    mask?: boolean;
-    /**显示黑色(弹窗存在公共的遮罩，这里不需要重复设置) */
-    black?: boolean;
-};
-/**
-* @describe 加载框
-* @author 游金宇(KM)
-* @date 2024-09-12 11:49:51
-*/
-declare class CoreShowLoading extends RootUILayer<CoreShowLoadingProps> {
-    title: Label;
-    loadingTween: Node;
-    private loading_rotate;
-    protected onAutoObserver(): void;
-    update(deltaTime: number): void;
-}
-
-type CoreNoticeProps = {
-    text: string;
-    confrim?: () => void;
-};
-/**
-* @describe 通知框
-* @author 游金宇(KM)
-* @date 2024-09-12 11:49:51
-*/
-declare class CoreNotice<T extends CoreNoticeProps = CoreNoticeProps> extends RootUILayer<T> {
-    text: Label;
-    btn_confirm: Button;
-    btn_close: Button;
-    protected onLoad(): void;
-    start(): void;
-    protected onConfrimHandler(): void;
-    updateProps(props: CoreNoticeProps): void;
-}
-
-/**
- * @describe Scene层  所有的UI层需继承自该自组件
- * @author 游金宇(KM)
- * @date 2023-08-04 10:42:26
- */
-
-type SceneType<T> = T extends SceneLayer<infer U, infer K> ? {
-    props: U;
-    data: K;
-} : {
-    props: object;
-    data: object;
-};
-type ScenePropsType<T> = SceneType<T> extends {
-    props: infer U extends object;
-    data: infer K extends object;
-} ? U : never;
-type SceneDataType<T> = SceneType<T> extends {
-    props: infer U extends object;
-    data: infer K extends object;
-} ? K : never;
-declare class SceneLayer<T extends object = Object, K extends object = {}> extends BaseComponent<T, K> {
-    /**是否为重新加载场景 */
-    isReload: boolean;
-}
-
-declare enum ReconnectPrompt {
-    RECONNECTED = "\u91CD\u8FDE\u6210\u529F",
-    RECONNECTING = "\u6B63\u5728\u91CD\u8FDE",
-    MAX_RECONNECT = "\u91CD\u8FDE\u6B21\u6570\u8D85\u51FA\u9650\u5236,\u8BF7\u68C0\u67E5\u7F51\u7EDC",
-    RECONNECTED_ERROR = "\u91CD\u8FDE\u5931\u8D25,\u8BF7\u68C0\u67E5\u7F51\u7EDC",
-    CONNECT_PARAM_ERROR = "\u6E38\u620F\u53C2\u6570\u9519\u8BEF,\u8BF7\u91CD\u65B0\u52A0\u8F7D",
-    KICK = "\u8D26\u53F7\u5DF2\u4E0B\u7EBF",
-    OFFLINE = "\u7F51\u7EDC\u5DF2\u65AD\u5F00",
-    ONLINE = "\u7F51\u7EDC\u5DF2\u8FDE\u63A5",
-    GAME_ERROR = "\u8FDE\u63A5\u6E38\u620F\u670D\u9519\u8BEF"
-}
-
-/**
-* @describe GUI组件类
-* @author 游金宇(KM)
-* @date 2024-09-12 11:46:22
-*/
-
-type UIComponentType$1<T> = T extends UILayer<infer U, infer K> ? {
-    props: U;
-    data: K;
-} : {
-    props: object;
-    data: object;
-};
-type PropsType<T> = UIComponentType$1<T> extends {
-    props: infer U extends object;
-    data: infer K extends object;
-} ? U : never;
-type DataType<T> = UIComponentType$1<T> extends {
-    props: infer U extends object;
-    data: infer K extends object;
-} ? K : never;
-declare enum LayerType {
-    UI = 0,
-    /**加载 */
-    LOADING = 1,
-    /**提示 */
-    TOAST = 2,
-    /**断线重连 */
-    RECONNECTTION = 3,
-    /**系统服务通知(停机维护) */
-    NOTICE = 4
-}
-/**Gui层 */
-declare class Gui extends BaseComponent {
-    reconnection_ui_prefab: Prefab;
-    toast_ui_prefab: Prefab;
-    loading_ui_prefab: Prefab;
-    notice_ui_prefab: Prefab;
-    ui_prefab: Prefab;
-    root_ui: Node;
-    root_toast: Node;
-    root_mask: Node;
-    /**场景中的UI层 */
-    private ui_container_component;
-    /**断线重连UI弹窗 */
-    private reconnection_ui_component;
-    /**公告UI弹窗组件 */
-    private notice_ui_component;
-    /**加载UI弹窗 */
-    private loading_ui_component;
-    /**提示UI弹窗 */
-    private toast_ui_component;
-    /**当前场景对象名 */
-    currentScene: string;
-    protected onEventListener(): void;
-    init(cat: Manager): this;
-    protected start(): void;
-    private toastQueue;
-    private isScheduling;
-    private minInterval;
-    showToast(props: ToastProps): void;
-    private processQueueWithInterval;
-    /** 隐藏并清除所有提示 */
-    hideToast(): this;
-    /**显示Loading */
-    showLoading({ title, mask, black }?: CoreShowLoadingProps): this;
-    /**隐藏Loading */
-    hideLoading(): this;
-    /**
-     * 显示断线重连
-     * @param option 状态提示文案
-     */
-    showReconnect(option: ReconnectPrompt): this;
-    /**隐藏断线重连 */
-    hideReconnect(): this;
-    /**
-     * 显示公告
-     * @param option 参数
-     */
-    showNotice(option: CoreNoticeProps): this;
-    /**隐藏公告 */
-    hideNotice(): this;
-    /**
-     * 加载并切换游戏场景
-     * @param sceneName 场景名称、场景实例或场景资源，用于指定要加载的场景
-     * @param options 可选参数，可以是场景加载的配置选项，或者是一个表示是否重新加载的布尔值
-     * @param isReload 可选参数，明确指示是否重新加载场景（当options为布尔值时，此参数被忽略）
-     * @returns 返回当前实例，支持链式调用
-     */
-    loadScene<T>(sceneName: string): this;
-    loadScene<T>(sceneName: string, options: IUIOption<ScenePropsType<T>, SceneDataType<T>>): this;
-    loadScene<T>(sceneName: string, isReload: boolean): this;
-    loadScene<T>(sceneName: string, options: IUIOption<ScenePropsType<T>, SceneDataType<T>>, isReload: boolean): this;
-    loadScene<T>(scene: Scene | SceneAsset): this;
-    loadScene<T>(scene: Scene | SceneAsset, options: IUIOption<ScenePropsType<T>, SceneDataType<T>>): this;
-    loadScene<T>(scene: Scene | SceneAsset, isReload: boolean): this;
-    loadScene<T>(scene: Scene | SceneAsset, options: IUIOption<ScenePropsType<T>, SceneDataType<T>>, isReload: boolean): this;
-    /**重置场景(清除当前默认当前场景) */
-    resetScene(sceneName?: string): this;
-    /**清除场景 */
-    cleanScene(): void;
-    /**
-     * 场景变化
-    * @param scene 场景
-    * @param options 选项
-    * @param isReload 是否重新加载
-    */
-    changeScene<T>(scene: Scene, options?: IUIOption<ScenePropsType<T>, SceneDataType<T>>, isReload?: boolean): void;
-    private createUILayer;
-    /**重新加载当前场景 */
-    reloadScene(): void;
-    /**关闭UI */
-    closeUI<T extends UILayer<object>, U extends object>(ui: Node | T, options?: ICloseOptions<T, U>): Promise<void>;
-    /**
-     * 打开ui层
-     * @param ui 界面的节点或组件
-     * @param options 动画参数选项
-     */
-    openUI<T extends UILayer>(ui: Node, options?: IOpenOptions<PropsType<T>, DataType<T>>): Promise<void>;
-    /**根据节点或组件 查询根UI层(继承自UILayer的)节点或组件 */
-    private findUIBaseLayer;
-    /**根层的变化 */
-    private onRootUpdate;
-}
-
-declare class CoreBlackMask extends BaseComponent {
-    tween: Node;
-}
-
-/**
-* @describe UI容器管理 在场景节点下 会随着场景销毁(非常驻节点)
-* @author 游金宇(KM)
-* @date 2024-09-12 11:45:31
-*/
-
-declare class CoreUIContainer extends UILayer {
-    scene_mask_node: Node;
-    ui_container: Node;
-    gui: Gui;
-    protected onLoad(): void;
-    get scene_mask(): CoreBlackMask;
-    get brother(): Node[];
-    get tweenChildren(): Node[];
-    protected onEventListener(): void;
-    /**增加层级 */
-    addMask(): void;
-    /**减少层级 */
-    subMask(): void;
-    blockMaskSiblingIndexChanged(): void;
-    /**
-     * 将UI节点挂载在tween上执行动画
-     * @param node 节点
-     */
-    addNodeToTween(node: Node): this;
-    show(): void;
-    hide(): void;
-    setGui(gui: Gui): this;
-    /**根层的变化 */
-    uiMaskChanged(): void;
-    setSceneMaskActive(active: boolean): void;
-}
-
-/**
-* @describe 层级界面管理
-* @author 游金宇(KM)
-* @date 2023-08-03 20:02:45
-*/
-
-type UIComponentType<T> = T extends UILayer<infer U> ? U : void;
-type SceneComponentType<T> = T extends SceneLayer<infer U> ? U : void;
-/**预制体路径 */
-declare enum BasePrefab {
-    Root = "prefabs/root",
-    Toast = "prefabs/toast",
-    BlackMask = "prefabs/black-mask",
-    Loading = "prefabs/loading",
-    Notice = "prefabs/notice",
-    Reconnection = "prefabs/reconnection"
-}
-declare class GuiManager extends BaseManager {
-    #private;
-    /**常驻顶层UI节点层级 */
-    gui: Gui;
-    /**
-     * 获取预制体
-     * @param type 类型
-     * @returns
-     */
-    private getGuiPrefabByType;
-    /**初始化 */
-    init(): Promise<this>;
-}
-
-/**
-* @describe 基于社交游戏封装的游戏基础ws类
-* @author 游金宇(KM)
-* @date 2024-09-12 11:47:51
-*/
-
-type ExtendedClientOption = ClientOption & {
-    /** 是否弹出请求错误信息 */
-    showRequestErrInfo?: boolean;
-};
-declare class WrapperSocialGameClient extends SocialGameClient {
-    /**是否弹出请求错误信息 */
-    protected showRequestErrInfo: boolean;
-    /**日志黑名单 */
-    protected logBlackList: string[];
-    ignore: (route: string) => boolean;
-    constructor(name: string, opts: Partial<SocialGameClientOption>, eventResponsePairs: Partial<AllEventResponsePairs>, clientOption?: ExtendedClientOption);
-    destroy(): void;
-    GameRequest<U>(route: string, req: BinaryWriter, res: MessageFns<U>, { forwardReq, forwardResp }?: AudienceOptions): Promise<U>;
-    subscribe<T>(route: string, respType: MessageFns<T>, fn?: (data: T) => void): this;
-}
-
-declare class SocialGameClientManager extends BaseManager {
-    private managedClients;
-    /**在线 */
-    private isGlobalOnline;
-    /**在后台 */
-    private isInBackground;
-    /**正在重连 */
-    private reconnecting;
-    /**后台委托 */
-    readonly onEventHideDelegate: AsyncDelegate<() => (Promise<void> | void)>;
-    /**前台委托 */
-    readonly onEventShowDelegate: AsyncDelegate<() => (Promise<void> | void)>;
-    /**重载场景委托 */
-    readonly onEventReloadSceneDelegate: AsyncDelegate<() => (Promise<void> | void)>;
-    /**重连定时器 */
-    private reconnectTimer;
-    private scheduleReconnect;
-    get activeClients(): WrapperSocialGameClient[];
-    constructor(cat: Manager);
-    /**
-   * 创建并注册WebSocket客户端
-   * @param name 客户端唯一标识（如"game", "room"）
-   * @param clientOption 客户端配置选项
-   * @param opts 社交游戏选项
-   * @param eventResponsePairs 事件响应配置
-   */
-    createWebSocket(name: string, clientOption: ExtendedClientOption, opts: Partial<SocialGameClientOption>, eventResponsePairs: Partial<AllEventResponsePairs>): WrapperSocialGameClient;
-    register(client: WrapperSocialGameClient): void;
-    unregister(client: WrapperSocialGameClient): void;
-    private initGlobalListeners;
-    private handleGlobalStateChange;
-    private triggerReconnectAll;
-    private disconnectAll;
-    private handleSingleClose;
-    private handleSingleReconnect;
-    private handleSingleKick;
-}
-
-/**
-* @describe 游戏资管理
-* @author 游金宇(KM)
-* @date 2023-08-03 17:40:51
-*/
-
-type ProgressCallback = (completedCount: number, totalCount: number, item: any) => void;
-type CompleteCallback<T> = ((err: Error | null, data: T) => void) | null;
-type IRemoteOptions = {
-    [k: string]: any;
-    ext?: string;
-};
-type AssetType<T = Asset> = Constructor<T>;
-declare class ResLoader {
-    /**
-     * 获取资源
-     * @param path          资源路径
-     * @param type          资源类型
-     * @param bundleName    远程资源包名
-     */
-    get: <T extends Asset>(path: string, type?: AssetType<T> | null, bundleName?: string) => T | null;
-    /**
-     * 获取资源类型
-     */
-    isAssetType: <T>(value: any) => value is AssetType<T>;
-    /**
-     * 获取资源
-     * @param bundleName    远程包名
-     * @param paths         资源路径
-     * @param type          资源类型-
-     * @param onProgress    加载进度回调
-     * @param onComplete    加载完成回调
-    */
-    load<T extends Asset>(paths: string | string[]): void;
-    load<T extends Asset>(paths: string | string[], type: AssetType<T>): void;
-    load<T extends Asset>(paths: string, onComplete: CompleteCallback<T>): void;
-    load<T extends Asset>(paths: string, type: AssetType<T>, onComplete: CompleteCallback<T>): void;
-    load<T extends Asset>(paths: string, onProgress: ProgressCallback, onComplete: CompleteCallback<T>): void;
-    load<T extends Asset>(paths: string, type: AssetType<T>, onProgress: ProgressCallback, onComplete: CompleteCallback<T>): void;
-    load<T extends Asset>(paths: string[], onComplete: CompleteCallback<T[]>): void;
-    load<T extends Asset>(paths: string[], onProgress: ProgressCallback, onComplete: CompleteCallback<T[]>): void;
-    load<T extends Asset>(paths: string[], type: AssetType<T>, onComplete: CompleteCallback<T[]>): void;
-    load<T extends Asset>(paths: string[], type: AssetType<T>, onProgress: ProgressCallback, onComplete: CompleteCallback<T[]>): void;
-    load<T extends Asset>(bundleName: string, paths: string | string[]): void;
-    load<T extends Asset>(bundleName: string, paths: string | string[], type: AssetType<T>): void;
-    load<T extends Asset>(bundleName: string, paths: string, onComplete: CompleteCallback<T>): void;
-    load<T extends Asset>(bundleName: string, paths: string[], onComplete: CompleteCallback<T[]>): void;
-    load<T extends Asset>(bundleName: string, paths: string, type: AssetType<T>, onComplete: CompleteCallback<T>): void;
-    load<T extends Asset>(bundleName: string, paths: string[], type: AssetType<T>, onComplete: CompleteCallback<T[]>): void;
-    load<T extends Asset>(bundleName: string, paths: string, onProgress: ProgressCallback, onComplete: CompleteCallback<T>): void;
-    load<T extends Asset>(bundleName: string, paths: string[], onProgress: ProgressCallback, onComplete: CompleteCallback<T[]>): void;
-    load<T extends Asset>(bundleName: string, paths: string, type: AssetType<T>, onProgress: ProgressCallback, onComplete: CompleteCallback<T>): void;
-    load<T extends Asset>(bundleName: string, paths: string[], type: AssetType<T>, onProgress: ProgressCallback, onComplete: CompleteCallback<T[]>): void;
-    /**
-     * 加载文件夹
-     * @param bundleName    远程包名
-     * @param dir           文件夹名
-     * @param type          资源类型
-     * @param onProgress    加载进度回调
-     * @param onComplete    加载完成回调
-     */
-    loadDir<T extends Asset>(dir: string): void;
-    loadDir<T extends Asset>(dir: string, type: AssetType<T>): void;
-    loadDir<T extends Asset>(dir: string, onComplete: CompleteCallback<T[]>): void;
-    loadDir<T extends Asset>(dir: string, type: AssetType<T>, onProgress: ProgressCallback, onComplete: CompleteCallback<T[]>): void;
-    loadDir<T extends Asset>(bundleName: string, dir: string): void;
-    loadDir<T extends Asset>(bundleName: string, dir: string, type: AssetType<T>): void;
-    loadDir<T extends Asset>(bundleName: string, dir: string, onComplete: CompleteCallback<T[]>): void;
-    loadDir<T extends Asset>(bundleName: string, dir: string, type: AssetType<T>, onProgress: ProgressCallback, onComplete: CompleteCallback<T[]>): void;
-    /**
-     * 加载远程资源
-     * @param url           资源地址
-     * @param options       资源参数，例：{ ext: ".png" }
-     * @param onComplete    加载完成回调
-     *
-     * res.ResLoader.loadRemote(params.iconv, (err: Error, imageAsset: ImageAsset) => {
-        if (err) return error(err)
-            if (isValid(this.itemSp)) {
-                this.itemSp.spriteFrame = SpriteFrame.createWithImage(imageAsset)
-            }
-        })
-     */
-    loadRemote<T extends Asset>(url: string, options: IRemoteOptions, onComplete?: CompleteCallback<T>): void;
-    loadRemote<T extends Asset>(url: string, onComplete?: CompleteCallback<T>): void;
-    /**
-     * 加载bundle
-     * @param url       资源地址 <远程路径或者bundleName>
-     * @param complete  完成事件
-     * @param v         资源版本号
-     * @example
-     */
-    loadBundle: (url: string, version?: string) => Promise<AssetManager.Bundle>;
-    /** 释放预制依赖资源 */
-    releasePrefabtDepsRecursively: (uuid: string) => void;
-    /**
-     * 通过资源相对路径释放资源
-     * @param path          资源路径
-     * @param bundleName    远程资源包名
-     */
-    release: (path: string, bundleName?: string) => void;
-    /**
-     * 通过相对文件夹路径删除所有文件夹中资源
-     * @param path          资源文件夹路径
-     * @param bundleName    远程资源包名
-     */
-    releaseDir: (path: string, bundleName?: string) => void;
-    /** 打印缓存中所有资源信息 */
-    dump: () => void;
-    /**
-    * 加载分包中的资源并提供进度反馈。
-    * @param bundle - 已加载的分包。
-    * @param onProgress - 进度回调函数。
-    * @returns Promise<void> - 加载完成后的Promise。
-    */
-    loadAssetsWithProgress(bundle: AssetManager.Bundle, onProgress: (progress: number) => void): Promise<void>;
-}
-
-/**
-* @describe 基本数据
-* @author 游金宇(KM)
-* @date 2024-09-12 11:35:02
-*/
-
-declare class BaseStore {
-    protected rootStore: CoreStore;
-    constructor(rootStore: CoreStore);
-}
-
-declare class CoreStore extends BaseManager {
-}
-
-/**
- * MD5加密
- * @param msg 加密信息
- */
-declare const md5: (msg: string) => string;
-/** 初始化加密库 */
-declare const initCrypto: (key: string, iv: string) => void;
-/**
- * AES 加密
- * @param msg 加密信息
- * @param key aes加密的key
- * @param iv  aes加密的iv
- */
-declare const aesEncrypt: (msg: string, key: string, iv: string) => string;
-/**
- * AES 解密
- * @param str 解密字符串
- * @param key aes加密的key
- * @param iv  aes加密的iv
- */
-declare const aesDecrypt: (str: string, key: string, iv: string) => string;
-declare const JsonFormatter: {
-    stringify: (cipherParams: any) => string;
-    parse: (jsonStr: string) => crypto_es_lib_cipher_core.CipherParams;
-};
-
-declare const EncryptUtil_JsonFormatter: typeof JsonFormatter;
-declare const EncryptUtil_aesDecrypt: typeof aesDecrypt;
-declare const EncryptUtil_aesEncrypt: typeof aesEncrypt;
-declare const EncryptUtil_initCrypto: typeof initCrypto;
-declare const EncryptUtil_md5: typeof md5;
-declare namespace EncryptUtil {
-  export {
-    EncryptUtil_JsonFormatter as JsonFormatter,
-    EncryptUtil_aesDecrypt as aesDecrypt,
-    EncryptUtil_aesEncrypt as aesEncrypt,
-    EncryptUtil_initCrypto as initCrypto,
-    EncryptUtil_md5 as md5,
-  };
-}
-
-/**
-* @describe 工具类
-* @author 游金宇(KM)
-* @date 2023-08-02 20:16:42
-*/
-
-declare class CoreUtil extends BaseManager {
-    encryptUtil: typeof EncryptUtil;
-}
-
-/**
-* @describe 本地存储管理
-* @author 游金宇(KM)
-* @date 2023-08-03 17:58:51
-*/
-
-declare class StorageManager extends BaseManager {
-    private _key;
-    private _iv;
-    private _id;
-    /**
-     * 初始化密钥
-     * @param key aes加密的key
-     * @param iv  aes加密的iv
-     */
-    init(key: string, iv: string): void;
-    /**
-     * 设置用户唯一标识
-     * @param id
-     */
-    setUser(id: string): void;
-    /**
-     * 存储本地数据
-     * @param key 存储key
-     * @param value 存储值
-     * @returns
-     */
-    set(key: string, value: any): void;
-    /**
-     * 获取指定关键字的数据
-     * @param key          获取的关键字
-     * @param defaultValue 获取的默认值
-     * @returns
-     */
-    get(key: string, defaultValue?: any): string;
-    /** 获取指定关键字的数值 */
-    getNumber(key: string, defaultValue?: number): number;
-    /** 获取指定关键字的布尔值 */
-    getBoolean(key: string): boolean;
-    /** 获取指定关键字的JSON对象 */
-    getJson(key: string, defaultValue?: any): any;
-    /**
-     * 删除指定关键字的数据
-     * @param key 需要移除的关键字
-     * @returns
-     */
-    remove(key: string): void;
-    /** 清空整个本地存储 */
-    clear(): void;
-}
-
-/**
-* @describe 管理类
-* @author 游金宇(KM)
-* @date 2024-09-12 11:49:44
-*/
-
-declare class Manager {
-    #private;
-    static get instance(): Manager;
-    /**APP初始化事务 */
-    readonly onAppInitDelegate: AsyncDelegate<() => (Promise<void> | void)>;
-    /**插件初始化事务 */
-    readonly onPlugInInitDelegate: AsyncDelegate<() => (Promise<void> | void)>;
-    /**音频管理 */
-    get audio(): AudioManager;
-    /**全局事件管理 */
-    get event(): EventEmitter<string | symbol, any>;
-    /**gui管理 */
-    get gui(): Gui;
-    /**本地存储管理 */
-    get storage(): StorageManager;
-    /**资源管理 */
-    get res(): ResLoader;
-    /**工具类管理 */
-    get util(): CoreUtil;
-    /**社交游戏类 */
-    get socialGameClient(): SocialGameClientManager;
-    /**数据存储 */
-    get store(): CoreStore;
-    /**GUI bundle 名称 */
-    get gui_bundle_name(): string;
-    /**音效本地存储key */
-    get audio_local_store_key(): string;
-    /**默认音效路径 */
-    get default_audio_effect(): string;
-    /**GUI资源配置 */
-    setConfig: ({ default_audio_effect, gui_bundleName, audio_local_store_key }?: {
-        gui_bundleName?: string;
-        audio_local_store_key?: string;
-        default_audio_effect?: string;
-    }) => this;
-    /**启动 */
-    boot(): Promise<void>;
-    /**合并对象 */
-    merge<K extends keyof Manager, T extends object>(target: K, source: T): this;
-    /**
-     * 注册一个“插件级”初始化回调
-     * - 如果已初始化，立即执行
-     * - 否则排队到 onPlugInInitDelegate 中
-     */
-    appendPlugInInitDelegate(cb: () => Promise<void> | void): this;
-}
-
-declare enum AudioEventConstant {
-    /**音乐开 */
-    MUSIC_ON = "AudioEventConstant/MUSIC_ON",
-    /**音乐关 */
-    MUSIC_OFF = "AudioEventConstant/MUSIC_OFF",
-    /**音效开 */
-    EFFECT_ON = "AudioEventConstant/EFFECT_ON",
-    /**音效关 */
-    EFFECT_OFF = "AudioEventConstant/EFFECT_OFF",
-    /**暂停音频 */
-    PAUSE_AUDIO = "AudioEventConstant/PAUSE_AUDIO",
-    /**恢复音频 */
-    RESUME_AUDIO = "AudioEventConstant/RESUME_AUDIO"
-}
-
-/**
-* @describe 全局事件监听方法
-* @author 游金宇(KM)
-* @date 2023-08-03 18:13:36
-*/
-declare enum GlobalEventConstant {
-    /** 游戏从后台进入 */
-    EVENT_SHOW = "GlobalEventConstant/EVENT_SHOW",
-    /** 游戏切到后台 */
-    EVENT_HIDE = "GlobalEventConstant/EVENT_HIDE",
-    /** 游戏画笔尺寸变化事件 */
-    GAME_RESIZE = "GlobalEventConstant/GAME_RESIZE",
-    /**游戏关闭时间 */
-    EVENT_CLOSE = "GlobalEventConstant/EVENT_CLOSE",
-    /**网络连接 */
-    ONLINE = "GlobalEventConstant/ONLINE",
-    /**网络断开 */
-    OFFLINE = "GlobalEventConstant/OFFLINE",
-    /**ROOT_MASK更新 */
-    ROOT_MASK_UPDATE = "GlobalEventConstant/ROOT_MASK_UPDATE",
-    /**ROOT_MASK更新变化 */
-    ROOT_MASK_CHANGE = "GlobalEventConstant/ROOT_MASK_CHANGE"
-}
-
-type CoreUIModalProps = {
-    content: string | SpriteFrame | null;
-    confirmCB: () => void;
-    cancelCB: () => void;
-    onDestroy?: () => void;
-    title?: SpriteFrame;
-    style?: {
-        confirm?: SpriteFrame;
-        cancel?: SpriteFrame;
-    } | null;
-};
-/**
-* @describe 模态框
-* @author 游金宇(KM)
-* @date 2024-09-12 11:49:51
-*/
-declare class CoreUIModal extends UILayer<CoreUIModalProps> {
-    default_title: SpriteFrame;
-    title: Sprite;
-    prompt_content_str: Label;
-    prompt_content_spriteFrame: Sprite;
-    btn_confirm: Button;
-    confirm_spriteFrame: SpriteFrame;
-    btn_cancel: Button;
-    cancel_spriteFrame: SpriteFrame;
-    btn_close: Button;
-    isConfirm: boolean;
-    props: CoreUIModalProps;
-    protected onLoad(): void;
-    private close;
-    private onCancelHandler;
-    private onConfirmHandler;
-    onDestroy(): void;
-    private onCloseHandler;
-}
-
-type CoreReconnectionProps = {
-    content: ReconnectPrompt | null;
-};
-/**
-* @describe 重连框
-* @author 游金宇(KM)
-* @date 2024-09-12 11:49:51
-*/
-declare class CoreReconnection extends RootUILayer<CoreReconnectionProps> {
-    common_prompt_text: Label;
-    btn_confirm: Button;
-    btn_close: Button;
-    protected is_close: boolean;
-    props: CoreReconnectionProps;
-    protected initUI(): void;
-    protected onLoad(): void;
-    onDestroy(): void;
-    updateProps(props: ReconnectPrompt): void;
-    /**更新提示文案 */
-    protected updatePromptText(text: ReconnectPrompt, isAnim?: boolean): void;
-    protected onConfirmHandler(): void;
-}
-
-type TimerCallback = (executionTime: number) => void;
-declare class TimerManager extends BaseManager {
-    private timers;
-    private lastUpdateTime;
-    constructor(cat: Manager);
-    private onHandleAppBackground;
-    private onHandleAppForeground;
-    /**
-     * 注册一个计时器
-     * @param tag 注册计时器的对象
-     * @param interval 间隔时间（毫秒）
-     * @param callback 计时器回调函数
-     * @returns 计时器的唯一标识
-     */
-    registerInterval(tag: any, interval: number, callback: TimerCallback): void;
-    /**
-     * 注册一个延时器
-     * @param tag 注册延时器的对象
-     * @param delay 延时时间（毫秒）
-     * @param callback 延时器回调函数
-     * @returns 延时器的唯一标识
-     */
-    registerDelay(tag: any, delay: number, callback: TimerCallback): void;
-    /**
-    * 取消一个计时器或延时器
-    * @param tag 计时器或延时器的唯一标识
-    */
-    unregister(tag: any): void;
-    /**是否拥有定时器 */
-    has(object: any): boolean;
-    /**
-     * 更新计时器状态
-     * @param dt 间隔时间（毫秒）
-     */
-    private update;
-}
-
-declare const AudioEffect: <T extends string>(effect?: T, callBackFun?: Function) => MethodDecorator;
-declare const ButtonLock: (lockTime?: number, callBackFun?: Function) => (_target: any, _propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
-
-declare global {
-    var _cat: Manager;
-}
-declare const cat: Manager;
-
-export { AudioEffect, AudioEventConstant, AudioManager, AudioSourceBaseComponent, AudioSourceUILayer, AudioTypeEnum, BaseComponent, BaseManager, BasePrefab, BaseStore, ButtonLock, CoreBlackMask, CoreNotice, CoreReconnection, CoreShowLoading, CoreStore, CoreToast, CoreUIContainer, CoreUIModal, CoreUtil, GlobalEventConstant, Gui, GuiManager, LayerType, Manager, ReconnectPrompt, RootUILayer, SceneLayer, TimerManager, ToastType, UILayer, WrapperSocialGameClient, cat };
-export type { CoreNoticeProps, CoreShowLoadingProps, CoreUIModalProps, HOOK, ICloseOptions, IDirection, IOpenOptions, IUIOption, SceneComponentType, SceneDataType, ScenePropsType, ToastProps, UIComponentType };
+import { Component, Node, Prefab, Vec3, Quat, math, Layers, AudioClip, AudioSource, Label, Button, Scene, SceneAsset, AsyncDelegate, Asset, Constructor, AssetManager, SpriteFrame, Sprite } from 'cc';
+import EventEmitter from 'eventemitter3';
+import { IReactionPublic, IReactionOptions } from '@shimotsuki/mobx';
+import { SocialGameClient, SocialGameClientOption, AllEventResponsePairs, ClientOption, MessageFns, AudienceOptions } from 'sgc';
+import { BinaryWriter } from '@bufbuild/protobuf/wire';
+import * as crypto_es_lib_cipher_core from 'crypto-es/lib/cipher-core';
+
+/**
+* @describe 基础管理类
+* @author 游金宇(KM)
+* @date 2024-09-12 11:49:30
+*/
+
+declare class BaseManager {
+    protected cat: Manager;
+    constructor(manager: Manager);
+}
+
+/**
+ * 音频管理
+ */
+declare class AudioManager extends BaseManager {
+    local_data: any;
+    private music;
+    private effect;
+    private _volume_music;
+    private _volume_effect;
+    private _switch_music;
+    private _switch_effect;
+    private local_store_key;
+    extra: {
+        [key: string]: any;
+    };
+    constructor(cat: Manager);
+    /**
+     * 设置背景音乐播放完成回调
+     * @param callback 背景音乐播放完成回调
+     */
+    setMusicComplete(callback?: Function | null): void;
+    /**
+     * 播放背景音乐
+     * @param url        资源地址
+     * @param callback   音乐播放完成事件
+     */
+    playMusic(url: string): Promise<void>;
+    playMusic(bundleName: string, url: string): Promise<void>;
+    /**
+     * 停止音乐
+     */
+    stopMusic(): void;
+    /**暂停音乐 */
+    pauseMusic(): void;
+    /**恢复音乐 */
+    resumeMusic(): void;
+    /**
+     * 获取背景音乐播放进度
+     */
+    get progressMusic(): number;
+    /**
+     * 设置背景乐播放进度
+     * @param value     播放进度值
+     */
+    set progressMusic(value: number);
+    /**
+     * 获取背景音乐音量
+     */
+    get volumeMusic(): number;
+    /**
+     * 设置背景音乐音量
+     * @param value     音乐音量值
+     */
+    set volumeMusic(value: number);
+    /**
+     * 获取背景音乐开关值
+     */
+    get switchMusic(): boolean;
+    /**
+     * 设置背景音乐开关值
+     * @param value     开关值
+     */
+    set switchMusic(value: boolean);
+    /**
+     * 播放音效
+     * @param url  资源地址
+     */
+    playEffect(url: string): Promise<void>;
+    playEffect(bundleName: string, url: string): Promise<void>;
+    /**
+     * 停止音效
+     */
+    stopEffect(): void;
+    /**
+     * 获取音效音量
+     */
+    get volumeEffect(): number;
+    /**
+     * 设置获取音效音量
+     * @param value     音效音量值
+     */
+    set volumeEffect(value: number);
+    /**
+     * 获取音效开关值
+     */
+    get switchEffect(): boolean;
+    /**
+     * 设置音效开关值
+     * @param value     音效开关值
+     */
+    set switchEffect(value: boolean);
+    /** 恢复当前暂停的音乐与音效播放 */
+    resumeAll(): void;
+    /** 暂停当前音乐与音效的播放 */
+    pauseAll(): void;
+    /** 停止当前音乐与音效的播放 */
+    stopAll(): void;
+    /** 保存音乐音效的音量、开关配置数据到本地 */
+    save(): this;
+    /** 本地加载音乐音效的音量、开关配置数据并设置到游戏中 */
+    load(): void;
+}
+
+/**
+ * @describe 组件基类
+ * @author 游金宇(KM)
+ * @date 2023-09-19 12:32:22
+ */
+
+type HOOK_NAME = 'destroyed' | 'started';
+type HOOK = {
+    [key in HOOK_NAME]?: () => void;
+};
+interface IUIOption<T extends object = {}, U extends object = {}> {
+    /**组件传值间属性值 */
+    props?: T;
+    /**组件数据 */
+    data?: U;
+    /**钩子 */
+    hook?: HOOK;
+}
+/**参数 */
+/**initUI->onAutoObserver->onLoad->start */
+declare class BaseComponent<T extends object = {}, K extends object = {}> extends Component {
+    /**组件(传值)属性 */
+    props: T;
+    /**自由属性 */
+    data: K;
+    cat: typeof globalThis._cat;
+    /**autorun销毁 */
+    private autorunDisposers;
+    /**reaction销毁 */
+    private reactionDisposers;
+    private eventEmitter;
+    hook: HOOK;
+    /**初始化UI(可在本函数中进行节点赋值或注册节点事件等...) */
+    protected initUI(): void;
+    protected __preload(): void;
+    constructor();
+    /**依赖收集生命周期(可以在该生命周期中注册依赖收集回调) */
+    protected onAutoObserver(): void;
+    /**添加自动收集 */
+    protected addAutorun(cb: (() => void) | (() => void)[]): this;
+    /**添加自动收集 */
+    protected addReaction<T, FireImmediately extends boolean = false>(expression: (r: IReactionPublic) => T, effect: (arg: T, prev: FireImmediately extends true ? T | undefined : T, r: IReactionPublic) => void, opts?: IReactionOptions<T, FireImmediately>): this;
+    protected addAudoListener<E extends EventEmitter<any>>(eventEmitter: E): E;
+    _onPreDestroy(): void;
+    protected onDisable(): void;
+    private deleteAllEventByEmitter;
+    protected onEnable(): void;
+    /**子类继承该方法(全局事件(this.cat.event)注册在components上的事件可以不添加取消监听(自动取消监听了)) */
+    protected onEventListener(): void;
+    /**子类继承该方法 */
+    protected addListener(): void;
+    /**子类继承该方法 */
+    protected removeListener(): void;
+    /**
+     * 添加到父节点指定层级
+     * @param parent 父节点
+     * @param index 插入的层级索引
+     * @param options 参数
+     * @returns 自身组件
+     */
+    addToParent(parent: Node | Prefab | Component, index: number, options?: IUIOption<T, K>): this;
+    addToParent(parent: Node | Prefab | Component, options?: IUIOption<T, K>): this;
+    /**设置属性(覆盖原有属性) */
+    setOptions(options?: IUIOption<T, K>): void;
+    /**设置data属性(更新) */
+    setUpdateData(data: Partial<K>): this | undefined;
+    /**设置props属性(更新)*/
+    setUpdateProps(props: Partial<T>): this | undefined;
+    private toPlainObject;
+    /**从父节点移除并销毁 */
+    removeAndDestroy(): void;
+    /**设置坐标 */
+    setPosition(positin: Vec3): this;
+    setScale(scale: Vec3): this;
+    setAngle(angle: number): this;
+    setRotation(rotation: Quat): this;
+    setRotationFromEuler(rotation: math.Vec3): this;
+    /**显示(同onEnable) */
+    protected onShow(): void;
+    /**隐藏(同onDisable) */
+    protected onHide(): void;
+    /**设置节点和子节点的层级 */
+    setNodeAndChildrenLayer(layer: string | Layers.Enum): this;
+}
+
+/**
+ * @describe UI层  所有的UI层需继承自该自组件
+ * @author 游金宇(KM)
+ * @date 2023-08-04 10:42:26
+ */
+
+/**
+ * left    从左往右
+ * right   从右往左
+ * top     从上往下
+ * bot     从下往上
+ * center  中间
+ */
+type IDirection = 'left' | 'right' | 'top' | 'bot' | 'center';
+/**开启动画参数选项 */
+interface IOpenOptions<T extends object, U extends object> extends IUIOption<T, U> {
+    /**动画 */
+    isMotion?: boolean;
+    /**动画时间 */
+    duration?: number;
+    /**方向 */
+    direction?: IDirection;
+    /**是否回弹 */
+    isBounce?: boolean;
+    /**回弹时间 */
+    bounceDuration?: number;
+}
+/**关闭动画参数选项 */
+interface ICloseOptions<T extends object, U extends object> extends IUIOption<T, U> {
+    /**动画 */
+    isMotion?: boolean;
+    /**动画时间 */
+    duration?: number;
+    /**方向 */
+    direction?: IDirection;
+}
+declare class UILayer<T extends object = {}, U extends object = {}> extends BaseComponent<T, U> {
+    /**上次进入的方向 */
+    lastEnterDirection: IDirection;
+    /**屏幕尺寸 */
+    screen: math.Size;
+    /**是否正在关闭 */
+    isClosing: boolean;
+    /**组件所在的UI最顶层(不包含UI) */
+    root: Node;
+    constructor();
+    private _init;
+    /**显示动画 */
+    showTween<T extends object, U extends object = {}>({ isMotion, direction, duration, isBounce, bounceDuration }: IOpenOptions<T, U>): Promise<void>;
+    /**隐藏动画 */
+    hideTween<T extends object, U extends object>({ isMotion, direction, duration }: ICloseOptions<T, U>): Promise<void>;
+    private handle;
+    private deftween;
+}
+
+/**
+* @describe 音频组件基类
+* @author 游金宇(KM)
+* @date 2023-12-22 16:20:20
+*/
+
+/**
+ * EFFECT 音效
+ * BGM    音乐
+ */
+declare enum AudioTypeEnum {
+    EFFECT = 0,
+    BGM = 1
+}
+declare class AudioSourceBaseComponent<T extends object = {}, K extends object = {}> extends BaseComponent<T, K> {
+    type: AudioTypeEnum;
+    clip: AudioClip;
+    loop: boolean;
+    volume: number;
+    playOnAwake: boolean;
+    audioSource: AudioSource;
+    onEnable(): void;
+    __preload(): void;
+    protected start(): void;
+    protected stopAudio(): void;
+    protected playAudio(): void;
+    protected onPlayEffectHandler(): void;
+    protected onStopEffectHandler(): void;
+    protected onPlayMusicHandler(): void;
+    protected onStopMusicHandler(): void;
+    _onPreDestroy(): void;
+}
+
+/**带有音频通道的UIlayer组件 */
+declare class AudioSourceUILayer<T extends object, U extends object = {}> extends UILayer<T, U> {
+    type: AudioTypeEnum;
+    clip: AudioClip;
+    loop: boolean;
+    volume: number;
+    playOnAwake: boolean;
+    audioSource: AudioSource;
+    onEnable(): void;
+    __preload(): void;
+    protected stopAudio(): void;
+    protected playAudio(): void;
+    protected onPlayEffectHandler(): void;
+    protected onStopEffectHandler(): void;
+    protected onPlayMusicHandler(): void;
+    protected onStopMusicHandler(): void;
+    _onPreDestroy(): void;
+}
+
+/**
+* @describe TOAST弹窗组件
+* @author 游金宇(KM)
+* @date 2024-09-12 11:42:29
+*/
+
+declare enum ToastType {
+    FIXED = 0,
+    SLIDE = 1
+}
+type ToastProps = {
+    title: string;
+    type?: ToastType;
+    fixed_time?: number;
+};
+declare class CoreToast extends BaseComponent<ToastProps> {
+    fixed_node: Node;
+    slide_node: Node;
+    fixed_label: Label;
+    slide_label: Label;
+    onLoad(): void;
+    protected start(): void;
+    show(): Promise<void>;
+    private playAnim;
+    onDestroy(): void;
+}
+
+/**
+ * @describe 根级别的UI层  所有的ROOT UI层需继承自该自组件
+ * @author 游金宇(KM)
+ * @date 2023-08-04 10:42:26
+ */
+
+declare class RootUILayer<T extends object> extends UILayer<T> {
+    protected onEnable(): void;
+    protected onDisable(): void;
+    private updateMask;
+}
+
+type CoreShowLoadingProps = {
+    /**标题 */
+    title?: string;
+    /**阻挡 */
+    mask?: boolean;
+    /**显示黑色(弹窗存在公共的遮罩，这里不需要重复设置) */
+    black?: boolean;
+};
+/**
+* @describe 加载框
+* @author 游金宇(KM)
+* @date 2024-09-12 11:49:51
+*/
+declare class CoreShowLoading extends RootUILayer<CoreShowLoadingProps> {
+    title: Label;
+    loadingTween: Node;
+    private loading_rotate;
+    protected onAutoObserver(): void;
+    update(deltaTime: number): void;
+}
+
+type CoreNoticeProps = {
+    text: string;
+    confrim?: () => void;
+};
+/**
+* @describe 通知框
+* @author 游金宇(KM)
+* @date 2024-09-12 11:49:51
+*/
+declare class CoreNotice<T extends CoreNoticeProps = CoreNoticeProps> extends RootUILayer<T> {
+    text: Label;
+    btn_confirm: Button;
+    btn_close: Button;
+    protected onLoad(): void;
+    start(): void;
+    protected onConfrimHandler(): void;
+    updateProps(props: CoreNoticeProps): void;
+}
+
+/**
+ * @describe Scene层  所有的UI层需继承自该自组件
+ * @author 游金宇(KM)
+ * @date 2023-08-04 10:42:26
+ */
+
+type SceneType<T> = T extends SceneLayer<infer U, infer K> ? {
+    props: U;
+    data: K;
+} : {
+    props: object;
+    data: object;
+};
+type ScenePropsType<T> = SceneType<T> extends {
+    props: infer U extends object;
+    data: infer K extends object;
+} ? U : never;
+type SceneDataType<T> = SceneType<T> extends {
+    props: infer U extends object;
+    data: infer K extends object;
+} ? K : never;
+declare class SceneLayer<T extends object = Object, K extends object = {}> extends BaseComponent<T, K> {
+    /**是否为重新加载场景 */
+    isReload: boolean;
+}
+
+declare enum ReconnectPrompt {
+    RECONNECTED = "\u91CD\u8FDE\u6210\u529F",
+    RECONNECTING = "\u6B63\u5728\u91CD\u8FDE",
+    MAX_RECONNECT = "\u91CD\u8FDE\u6B21\u6570\u8D85\u51FA\u9650\u5236,\u8BF7\u68C0\u67E5\u7F51\u7EDC",
+    RECONNECTED_ERROR = "\u91CD\u8FDE\u5931\u8D25,\u8BF7\u68C0\u67E5\u7F51\u7EDC",
+    CONNECT_PARAM_ERROR = "\u6E38\u620F\u53C2\u6570\u9519\u8BEF,\u8BF7\u91CD\u65B0\u52A0\u8F7D",
+    KICK = "\u8D26\u53F7\u5DF2\u4E0B\u7EBF",
+    OFFLINE = "\u7F51\u7EDC\u5DF2\u65AD\u5F00",
+    ONLINE = "\u7F51\u7EDC\u5DF2\u8FDE\u63A5",
+    GAME_ERROR = "\u8FDE\u63A5\u6E38\u620F\u670D\u9519\u8BEF"
+}
+
+/**
+* @describe GUI组件类
+* @author 游金宇(KM)
+* @date 2024-09-12 11:46:22
+*/
+
+type UIComponentType$1<T> = T extends UILayer<infer U, infer K> ? {
+    props: U;
+    data: K;
+} : {
+    props: object;
+    data: object;
+};
+type PropsType<T> = UIComponentType$1<T> extends {
+    props: infer U extends object;
+    data: infer K extends object;
+} ? U : never;
+type DataType<T> = UIComponentType$1<T> extends {
+    props: infer U extends object;
+    data: infer K extends object;
+} ? K : never;
+declare enum LayerType {
+    UI = 0,
+    /**加载 */
+    LOADING = 1,
+    /**提示 */
+    TOAST = 2,
+    /**断线重连 */
+    RECONNECTTION = 3,
+    /**系统服务通知(停机维护) */
+    NOTICE = 4
+}
+/**Gui层 */
+declare class Gui extends BaseComponent {
+    reconnection_ui_prefab: Prefab;
+    toast_ui_prefab: Prefab;
+    loading_ui_prefab: Prefab;
+    notice_ui_prefab: Prefab;
+    ui_prefab: Prefab;
+    root_ui: Node;
+    root_toast: Node;
+    root_mask: Node;
+    /**场景中的UI层 */
+    private ui_container_component;
+    /**断线重连UI弹窗 */
+    private reconnection_ui_component;
+    /**公告UI弹窗组件 */
+    private notice_ui_component;
+    /**加载UI弹窗 */
+    private loading_ui_component;
+    /**提示UI弹窗 */
+    private toast_ui_component;
+    /**当前场景对象名 */
+    currentScene: string;
+    protected onEventListener(): void;
+    init(cat: Manager): this;
+    protected start(): void;
+    private toastQueue;
+    private isScheduling;
+    private minInterval;
+    showToast(props: ToastProps): void;
+    private processQueueWithInterval;
+    /** 隐藏并清除所有提示 */
+    hideToast(): this;
+    /**显示Loading */
+    showLoading({ title, mask, black }?: CoreShowLoadingProps): this;
+    /**隐藏Loading */
+    hideLoading(): this;
+    /**
+     * 显示断线重连
+     * @param option 状态提示文案
+     */
+    showReconnect(option: ReconnectPrompt): this;
+    /**隐藏断线重连 */
+    hideReconnect(): this;
+    /**
+     * 显示公告
+     * @param option 参数
+     */
+    showNotice(option: CoreNoticeProps): this;
+    /**隐藏公告 */
+    hideNotice(): this;
+    /**
+     * 加载并切换游戏场景
+     * @param sceneName 场景名称、场景实例或场景资源，用于指定要加载的场景
+     * @param options 可选参数，可以是场景加载的配置选项，或者是一个表示是否重新加载的布尔值
+     * @param isReload 可选参数，明确指示是否重新加载场景（当options为布尔值时，此参数被忽略）
+     * @returns 返回当前实例，支持链式调用
+     */
+    loadScene<T>(sceneName: string): this;
+    loadScene<T>(sceneName: string, options: IUIOption<ScenePropsType<T>, SceneDataType<T>>): this;
+    loadScene<T>(sceneName: string, isReload: boolean): this;
+    loadScene<T>(sceneName: string, options: IUIOption<ScenePropsType<T>, SceneDataType<T>>, isReload: boolean): this;
+    loadScene<T>(scene: Scene | SceneAsset): this;
+    loadScene<T>(scene: Scene | SceneAsset, options: IUIOption<ScenePropsType<T>, SceneDataType<T>>): this;
+    loadScene<T>(scene: Scene | SceneAsset, isReload: boolean): this;
+    loadScene<T>(scene: Scene | SceneAsset, options: IUIOption<ScenePropsType<T>, SceneDataType<T>>, isReload: boolean): this;
+    /**重置场景(清除当前默认当前场景) */
+    resetScene(sceneName?: string): this;
+    /**清除场景 */
+    cleanScene(): void;
+    /**
+     * 场景变化
+    * @param scene 场景
+    * @param options 选项
+    * @param isReload 是否重新加载
+    */
+    changeScene<T>(scene: Scene, options?: IUIOption<ScenePropsType<T>, SceneDataType<T>>, isReload?: boolean): void;
+    private createUILayer;
+    /**重新加载当前场景 */
+    reloadScene(): void;
+    /**关闭UI */
+    closeUI<T extends UILayer<object>, U extends object>(ui: Node | T, options?: ICloseOptions<T, U>): Promise<void>;
+    /**
+     * 打开ui层
+     * @param ui 界面的节点或组件
+     * @param options 动画参数选项
+     */
+    openUI<T extends UILayer>(ui: Node, options?: IOpenOptions<PropsType<T>, DataType<T>>): Promise<void>;
+    /**根据节点或组件 查询根UI层(继承自UILayer的)节点或组件 */
+    private findUIBaseLayer;
+    /**根层的变化 */
+    private onRootUpdate;
+}
+
+declare class CoreBlackMask extends BaseComponent {
+    tween: Node;
+}
+
+/**
+* @describe UI容器管理 在场景节点下 会随着场景销毁(非常驻节点)
+* @author 游金宇(KM)
+* @date 2024-09-12 11:45:31
+*/
+
+declare class CoreUIContainer extends UILayer {
+    scene_mask_node: Node;
+    ui_container: Node;
+    gui: Gui;
+    protected onLoad(): void;
+    get scene_mask(): CoreBlackMask;
+    get brother(): Node[];
+    get tweenChildren(): Node[];
+    protected onEventListener(): void;
+    /**增加层级 */
+    addMask(): void;
+    /**减少层级 */
+    subMask(): void;
+    blockMaskSiblingIndexChanged(): void;
+    /**
+     * 将UI节点挂载在tween上执行动画
+     * @param node 节点
+     */
+    addNodeToTween(node: Node): this;
+    show(): void;
+    hide(): void;
+    setGui(gui: Gui): this;
+    /**根层的变化 */
+    uiMaskChanged(): void;
+    setSceneMaskActive(active: boolean): void;
+}
+
+/**
+* @describe 层级界面管理
+* @author 游金宇(KM)
+* @date 2023-08-03 20:02:45
+*/
+
+type UIComponentType<T> = T extends UILayer<infer U> ? U : void;
+type SceneComponentType<T> = T extends SceneLayer<infer U> ? U : void;
+/**预制体路径 */
+declare enum BasePrefab {
+    Root = "prefabs/root",
+    Toast = "prefabs/toast",
+    BlackMask = "prefabs/black-mask",
+    Loading = "prefabs/loading",
+    Notice = "prefabs/notice",
+    Reconnection = "prefabs/reconnection"
+}
+declare class GuiManager extends BaseManager {
+    #private;
+    /**常驻顶层UI节点层级 */
+    gui: Gui;
+    /**
+     * 获取预制体
+     * @param type 类型
+     * @returns
+     */
+    private getGuiPrefabByType;
+    /**初始化 */
+    init(): Promise<this>;
+}
+
+/**
+* @describe 基于社交游戏封装的游戏基础ws类
+* @author 游金宇(KM)
+* @date 2024-09-12 11:47:51
+*/
+
+type ExtendedClientOption = ClientOption & {
+    /** 是否弹出请求错误信息 */
+    showRequestErrInfo?: boolean;
+};
+declare class WrapperSocialGameClient extends SocialGameClient {
+    /**是否弹出请求错误信息 */
+    protected showRequestErrInfo: boolean;
+    /**日志黑名单 */
+    protected logBlackList: string[];
+    ignore: (route: string) => boolean;
+    constructor(name: string, opts: Partial<SocialGameClientOption>, eventResponsePairs: Partial<AllEventResponsePairs>, clientOption?: ExtendedClientOption);
+    destroy(): void;
+    GameRequest<U>(route: string, req: BinaryWriter, res: MessageFns<U>, { forwardReq, forwardResp }?: AudienceOptions): Promise<U>;
+    subscribe<T>(route: string, respType: MessageFns<T>, fn?: (data: T) => void): this;
+}
+
+declare class SocialGameClientManager extends BaseManager {
+    private managedClients;
+    /**在线 */
+    private isGlobalOnline;
+    /**在后台 */
+    private isInBackground;
+    /**正在重连 */
+    private reconnecting;
+    /**后台委托 */
+    readonly onEventHideDelegate: AsyncDelegate<() => (Promise<void> | void)>;
+    /**前台委托 */
+    readonly onEventShowDelegate: AsyncDelegate<() => (Promise<void> | void)>;
+    /**重载场景委托 */
+    readonly onEventReloadSceneDelegate: AsyncDelegate<() => (Promise<void> | void)>;
+    /**重连定时器 */
+    private reconnectTimer;
+    private scheduleReconnect;
+    get activeClients(): WrapperSocialGameClient[];
+    constructor(cat: Manager);
+    /**
+   * 创建并注册WebSocket客户端
+   * @param name 客户端唯一标识（如"game", "room"）
+   * @param clientOption 客户端配置选项
+   * @param opts 社交游戏选项
+   * @param eventResponsePairs 事件响应配置
+   */
+    createWebSocket(name: string, clientOption: ExtendedClientOption, opts: Partial<SocialGameClientOption>, eventResponsePairs: Partial<AllEventResponsePairs>): WrapperSocialGameClient;
+    register(client: WrapperSocialGameClient): void;
+    unregister(client: WrapperSocialGameClient): void;
+    private initGlobalListeners;
+    private handleGlobalStateChange;
+    private triggerReconnectAll;
+    private disconnectAll;
+    private handleSingleClose;
+    private handleSingleReconnect;
+    private handleSingleKick;
+}
+
+/**
+* @describe 游戏资管理
+* @author 游金宇(KM)
+* @date 2023-08-03 17:40:51
+*/
+
+type ProgressCallback = (completedCount: number, totalCount: number, item: any) => void;
+type CompleteCallback<T> = ((err: Error | null, data: T) => void) | null;
+type IRemoteOptions = {
+    [k: string]: any;
+    ext?: string;
+};
+type AssetType<T = Asset> = Constructor<T>;
+declare class ResLoader {
+    /**
+     * 获取资源
+     * @param path          资源路径
+     * @param type          资源类型
+     * @param bundleName    远程资源包名
+     */
+    get: <T extends Asset>(path: string, type?: AssetType<T> | null, bundleName?: string) => T | null;
+    /**
+     * 获取资源类型
+     */
+    isAssetType: <T>(value: any) => value is AssetType<T>;
+    /**
+     * 获取资源
+     * @param bundleName    远程包名
+     * @param paths         资源路径
+     * @param type          资源类型-
+     * @param onProgress    加载进度回调
+     * @param onComplete    加载完成回调
+    */
+    load<T extends Asset>(paths: string | string[]): void;
+    load<T extends Asset>(paths: string | string[], type: AssetType<T>): void;
+    load<T extends Asset>(paths: string, onComplete: CompleteCallback<T>): void;
+    load<T extends Asset>(paths: string, type: AssetType<T>, onComplete: CompleteCallback<T>): void;
+    load<T extends Asset>(paths: string, onProgress: ProgressCallback, onComplete: CompleteCallback<T>): void;
+    load<T extends Asset>(paths: string, type: AssetType<T>, onProgress: ProgressCallback, onComplete: CompleteCallback<T>): void;
+    load<T extends Asset>(paths: string[], onComplete: CompleteCallback<T[]>): void;
+    load<T extends Asset>(paths: string[], onProgress: ProgressCallback, onComplete: CompleteCallback<T[]>): void;
+    load<T extends Asset>(paths: string[], type: AssetType<T>, onComplete: CompleteCallback<T[]>): void;
+    load<T extends Asset>(paths: string[], type: AssetType<T>, onProgress: ProgressCallback, onComplete: CompleteCallback<T[]>): void;
+    load<T extends Asset>(bundleName: string, paths: string | string[]): void;
+    load<T extends Asset>(bundleName: string, paths: string | string[], type: AssetType<T>): void;
+    load<T extends Asset>(bundleName: string, paths: string, onComplete: CompleteCallback<T>): void;
+    load<T extends Asset>(bundleName: string, paths: string[], onComplete: CompleteCallback<T[]>): void;
+    load<T extends Asset>(bundleName: string, paths: string, type: AssetType<T>, onComplete: CompleteCallback<T>): void;
+    load<T extends Asset>(bundleName: string, paths: string[], type: AssetType<T>, onComplete: CompleteCallback<T[]>): void;
+    load<T extends Asset>(bundleName: string, paths: string, onProgress: ProgressCallback, onComplete: CompleteCallback<T>): void;
+    load<T extends Asset>(bundleName: string, paths: string[], onProgress: ProgressCallback, onComplete: CompleteCallback<T[]>): void;
+    load<T extends Asset>(bundleName: string, paths: string, type: AssetType<T>, onProgress: ProgressCallback, onComplete: CompleteCallback<T>): void;
+    load<T extends Asset>(bundleName: string, paths: string[], type: AssetType<T>, onProgress: ProgressCallback, onComplete: CompleteCallback<T[]>): void;
+    /**
+     * 加载文件夹
+     * @param bundleName    远程包名
+     * @param dir           文件夹名
+     * @param type          资源类型
+     * @param onProgress    加载进度回调
+     * @param onComplete    加载完成回调
+     */
+    loadDir<T extends Asset>(dir: string): void;
+    loadDir<T extends Asset>(dir: string, type: AssetType<T>): void;
+    loadDir<T extends Asset>(dir: string, onComplete: CompleteCallback<T[]>): void;
+    loadDir<T extends Asset>(dir: string, type: AssetType<T>, onProgress: ProgressCallback, onComplete: CompleteCallback<T[]>): void;
+    loadDir<T extends Asset>(bundleName: string, dir: string): void;
+    loadDir<T extends Asset>(bundleName: string, dir: string, type: AssetType<T>): void;
+    loadDir<T extends Asset>(bundleName: string, dir: string, onComplete: CompleteCallback<T[]>): void;
+    loadDir<T extends Asset>(bundleName: string, dir: string, type: AssetType<T>, onProgress: ProgressCallback, onComplete: CompleteCallback<T[]>): void;
+    /**
+     * 加载远程资源
+     * @param url           资源地址
+     * @param options       资源参数，例：{ ext: ".png" }
+     * @param onComplete    加载完成回调
+     *
+     * res.ResLoader.loadRemote(params.iconv, (err: Error, imageAsset: ImageAsset) => {
+        if (err) return error(err)
+            if (isValid(this.itemSp)) {
+                this.itemSp.spriteFrame = SpriteFrame.createWithImage(imageAsset)
+            }
+        })
+     */
+    loadRemote<T extends Asset>(url: string, options: IRemoteOptions, onComplete?: CompleteCallback<T>): void;
+    loadRemote<T extends Asset>(url: string, onComplete?: CompleteCallback<T>): void;
+    /**
+     * 加载bundle
+     * @param url       资源地址 <远程路径或者bundleName>
+     * @param complete  完成事件
+     * @param v         资源版本号
+     * @example
+     */
+    loadBundle: (url: string, version?: string) => Promise<AssetManager.Bundle>;
+    /** 释放预制依赖资源 */
+    releasePrefabtDepsRecursively: (uuid: string) => void;
+    /**
+     * 通过资源相对路径释放资源
+     * @param path          资源路径
+     * @param bundleName    远程资源包名
+     */
+    release: (path: string, bundleName?: string) => void;
+    /**
+     * 通过相对文件夹路径删除所有文件夹中资源
+     * @param path          资源文件夹路径
+     * @param bundleName    远程资源包名
+     */
+    releaseDir: (path: string, bundleName?: string) => void;
+    /** 打印缓存中所有资源信息 */
+    dump: () => void;
+    /**
+    * 加载分包中的资源并提供进度反馈。
+    * @param bundle - 已加载的分包。
+    * @param onProgress - 进度回调函数。
+    * @returns Promise<void> - 加载完成后的Promise。
+    */
+    loadAssetsWithProgress(bundle: AssetManager.Bundle, onProgress: (progress: number) => void): Promise<void>;
+}
+
+/**
+* @describe 基本数据
+* @author 游金宇(KM)
+* @date 2024-09-12 11:35:02
+*/
+
+declare class BaseStore {
+    protected rootStore: CoreStore;
+    constructor(rootStore: CoreStore);
+}
+
+declare class CoreStore extends BaseManager {
+}
+
+/**
+ * MD5加密
+ * @param msg 加密信息
+ */
+declare const md5: (msg: string) => string;
+/** 初始化加密库 */
+declare const initCrypto: (key: string, iv: string) => void;
+/**
+ * AES 加密
+ * @param msg 加密信息
+ * @param key aes加密的key
+ * @param iv  aes加密的iv
+ */
+declare const aesEncrypt: (msg: string, key: string, iv: string) => string;
+/**
+ * AES 解密
+ * @param str 解密字符串
+ * @param key aes加密的key
+ * @param iv  aes加密的iv
+ */
+declare const aesDecrypt: (str: string, key: string, iv: string) => string;
+declare const JsonFormatter: {
+    stringify: (cipherParams: any) => string;
+    parse: (jsonStr: string) => crypto_es_lib_cipher_core.CipherParams;
+};
+
+declare const EncryptUtil_JsonFormatter: typeof JsonFormatter;
+declare const EncryptUtil_aesDecrypt: typeof aesDecrypt;
+declare const EncryptUtil_aesEncrypt: typeof aesEncrypt;
+declare const EncryptUtil_initCrypto: typeof initCrypto;
+declare const EncryptUtil_md5: typeof md5;
+declare namespace EncryptUtil {
+  export {
+    EncryptUtil_JsonFormatter as JsonFormatter,
+    EncryptUtil_aesDecrypt as aesDecrypt,
+    EncryptUtil_aesEncrypt as aesEncrypt,
+    EncryptUtil_initCrypto as initCrypto,
+    EncryptUtil_md5 as md5,
+  };
+}
+
+/**
+* @describe 工具类
+* @author 游金宇(KM)
+* @date 2023-08-02 20:16:42
+*/
+
+declare class CoreUtil extends BaseManager {
+    encryptUtil: typeof EncryptUtil;
+}
+
+/**
+* @describe 本地存储管理
+* @author 游金宇(KM)
+* @date 2023-08-03 17:58:51
+*/
+
+declare class StorageManager extends BaseManager {
+    private _key;
+    private _iv;
+    private _id;
+    /**
+     * 初始化密钥
+     * @param key aes加密的key
+     * @param iv  aes加密的iv
+     */
+    init(key: string, iv: string): void;
+    /**
+     * 设置用户唯一标识
+     * @param id
+     */
+    setUser(id: string): void;
+    /**
+     * 存储本地数据
+     * @param key 存储key
+     * @param value 存储值
+     * @returns
+     */
+    set(key: string, value: any): void;
+    /**
+     * 获取指定关键字的数据
+     * @param key          获取的关键字
+     * @param defaultValue 获取的默认值
+     * @returns
+     */
+    get(key: string, defaultValue?: any): string;
+    /** 获取指定关键字的数值 */
+    getNumber(key: string, defaultValue?: number): number;
+    /** 获取指定关键字的布尔值 */
+    getBoolean(key: string): boolean;
+    /** 获取指定关键字的JSON对象 */
+    getJson(key: string, defaultValue?: any): any;
+    /**
+     * 删除指定关键字的数据
+     * @param key 需要移除的关键字
+     * @returns
+     */
+    remove(key: string): void;
+    /** 清空整个本地存储 */
+    clear(): void;
+}
+
+/**
+* @describe 管理类
+* @author 游金宇(KM)
+* @date 2024-09-12 11:49:44
+*/
+
+declare class Manager {
+    #private;
+    static get instance(): Manager;
+    /**APP初始化事务 */
+    readonly onAppInitDelegate: AsyncDelegate<() => (Promise<void> | void)>;
+    /**插件初始化事务 */
+    readonly onPlugInInitDelegate: AsyncDelegate<() => (Promise<void> | void)>;
+    /**音频管理 */
+    get audio(): AudioManager;
+    /**全局事件管理 */
+    get event(): EventEmitter<string | symbol, any>;
+    /**gui管理 */
+    get gui(): Gui;
+    /**本地存储管理 */
+    get storage(): StorageManager;
+    /**资源管理 */
+    get res(): ResLoader;
+    /**工具类管理 */
+    get util(): CoreUtil;
+    /**社交游戏类 */
+    get socialGameClient(): SocialGameClientManager;
+    /**数据存储 */
+    get store(): CoreStore;
+    /**GUI bundle 名称 */
+    get gui_bundle_name(): string;
+    /**音效本地存储key */
+    get audio_local_store_key(): string;
+    /**默认音效路径 */
+    get default_audio_effect(): string;
+    /**GUI资源配置 */
+    setConfig: ({ default_audio_effect, gui_bundleName, audio_local_store_key }?: {
+        gui_bundleName?: string;
+        audio_local_store_key?: string;
+        default_audio_effect?: string;
+    }) => this;
+    /**启动 */
+    boot(): Promise<void>;
+    /**合并对象 */
+    merge<K extends keyof Manager, T extends object>(target: K, source: T): this;
+    /**
+     * 注册一个“插件级”初始化回调
+     * - 如果已初始化，立即执行
+     * - 否则排队到 onPlugInInitDelegate 中
+     */
+    appendPlugInInitDelegate(cb: () => Promise<void> | void): this;
+}
+
+declare enum AudioEventConstant {
+    /**音乐开 */
+    MUSIC_ON = "AudioEventConstant/MUSIC_ON",
+    /**音乐关 */
+    MUSIC_OFF = "AudioEventConstant/MUSIC_OFF",
+    /**音效开 */
+    EFFECT_ON = "AudioEventConstant/EFFECT_ON",
+    /**音效关 */
+    EFFECT_OFF = "AudioEventConstant/EFFECT_OFF",
+    /**暂停音频 */
+    PAUSE_AUDIO = "AudioEventConstant/PAUSE_AUDIO",
+    /**恢复音频 */
+    RESUME_AUDIO = "AudioEventConstant/RESUME_AUDIO"
+}
+
+/**
+* @describe 全局事件监听方法
+* @author 游金宇(KM)
+* @date 2023-08-03 18:13:36
+*/
+declare enum GlobalEventConstant {
+    /** 游戏从后台进入 */
+    EVENT_SHOW = "GlobalEventConstant/EVENT_SHOW",
+    /** 游戏切到后台 */
+    EVENT_HIDE = "GlobalEventConstant/EVENT_HIDE",
+    /** 游戏画笔尺寸变化事件 */
+    GAME_RESIZE = "GlobalEventConstant/GAME_RESIZE",
+    /**游戏关闭时间 */
+    EVENT_CLOSE = "GlobalEventConstant/EVENT_CLOSE",
+    /**网络连接 */
+    ONLINE = "GlobalEventConstant/ONLINE",
+    /**网络断开 */
+    OFFLINE = "GlobalEventConstant/OFFLINE",
+    /**ROOT_MASK更新 */
+    ROOT_MASK_UPDATE = "GlobalEventConstant/ROOT_MASK_UPDATE",
+    /**ROOT_MASK更新变化 */
+    ROOT_MASK_CHANGE = "GlobalEventConstant/ROOT_MASK_CHANGE"
+}
+
+type CoreUIModalProps = {
+    content: string | SpriteFrame | null;
+    confirmCB: () => void;
+    cancelCB: () => void;
+    onDestroy?: () => void;
+    title?: SpriteFrame;
+    style?: {
+        confirm?: SpriteFrame;
+        cancel?: SpriteFrame;
+    } | null;
+};
+/**
+* @describe 模态框
+* @author 游金宇(KM)
+* @date 2024-09-12 11:49:51
+*/
+declare class CoreUIModal extends UILayer<CoreUIModalProps> {
+    default_title: SpriteFrame;
+    title: Sprite;
+    prompt_content_str: Label;
+    prompt_content_spriteFrame: Sprite;
+    btn_confirm: Button;
+    confirm_spriteFrame: SpriteFrame;
+    btn_cancel: Button;
+    cancel_spriteFrame: SpriteFrame;
+    btn_close: Button;
+    isConfirm: boolean;
+    props: CoreUIModalProps;
+    protected onLoad(): void;
+    private close;
+    private onCancelHandler;
+    private onConfirmHandler;
+    onDestroy(): void;
+    private onCloseHandler;
+}
+
+type CoreReconnectionProps = {
+    content: ReconnectPrompt | null;
+};
+/**
+* @describe 重连框
+* @author 游金宇(KM)
+* @date 2024-09-12 11:49:51
+*/
+declare class CoreReconnection extends RootUILayer<CoreReconnectionProps> {
+    common_prompt_text: Label;
+    btn_confirm: Button;
+    btn_close: Button;
+    protected is_close: boolean;
+    props: CoreReconnectionProps;
+    protected initUI(): void;
+    protected onLoad(): void;
+    onDestroy(): void;
+    updateProps(props: ReconnectPrompt): void;
+    /**更新提示文案 */
+    protected updatePromptText(text: ReconnectPrompt, isAnim?: boolean): void;
+    protected onConfirmHandler(): void;
+}
+
+type TimerCallback = (executionTime: number) => void;
+declare class TimerManager extends BaseManager {
+    private timers;
+    private lastUpdateTime;
+    constructor(cat: Manager);
+    private onHandleAppBackground;
+    private onHandleAppForeground;
+    /**
+     * 注册一个计时器
+     * @param tag 注册计时器的对象
+     * @param interval 间隔时间（毫秒）
+     * @param callback 计时器回调函数
+     * @returns 计时器的唯一标识
+     */
+    registerInterval(tag: any, interval: number, callback: TimerCallback): void;
+    /**
+     * 注册一个延时器
+     * @param tag 注册延时器的对象
+     * @param delay 延时时间（毫秒）
+     * @param callback 延时器回调函数
+     * @returns 延时器的唯一标识
+     */
+    registerDelay(tag: any, delay: number, callback: TimerCallback): void;
+    /**
+    * 取消一个计时器或延时器
+    * @param tag 计时器或延时器的唯一标识
+    */
+    unregister(tag: any): void;
+    /**是否拥有定时器 */
+    has(object: any): boolean;
+    /**
+     * 更新计时器状态
+     * @param dt 间隔时间（毫秒）
+     */
+    private update;
+}
+
+declare const AudioEffect: <T extends string>(effect?: T, callBackFun?: Function) => MethodDecorator;
+declare const ButtonLock: (lockTime?: number, callBackFun?: Function) => (_target: any, _propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+
+declare global {
+    var _cat: Manager;
+}
+declare const cat: Manager;
+
+export { AudioEffect, AudioEventConstant, AudioManager, AudioSourceBaseComponent, AudioSourceUILayer, AudioTypeEnum, BaseComponent, BaseManager, BasePrefab, BaseStore, ButtonLock, CoreBlackMask, CoreNotice, CoreReconnection, CoreShowLoading, CoreStore, CoreToast, CoreUIContainer, CoreUIModal, CoreUtil, GlobalEventConstant, Gui, GuiManager, LayerType, Manager, ReconnectPrompt, RootUILayer, SceneLayer, TimerManager, ToastType, UILayer, WrapperSocialGameClient, cat };
+export type { CoreNoticeProps, CoreShowLoadingProps, CoreUIModalProps, HOOK, ICloseOptions, IDirection, IOpenOptions, IUIOption, SceneComponentType, SceneDataType, ScenePropsType, ToastProps, UIComponentType };