@gongxh/bit-ui 0.0.1 → 0.0.2

package/dist/bit-ui.d.ts

@@ -1,5 +1,6 @@
 import { GComponent } from 'fairygui-cc';
-import { Component } from 'cc';
+import { JsonAsset } from 'cc';
+import { Module } from '@gongxh/bit-core';
 
 /** 窗口显示时，对其他窗口的隐藏处理类型 */
 declare enum WindowType {
@@ -23,17 +24,46 @@ declare enum AdapterType {
     /** 固定的 不适配 */
     Fixed = 2
 }
+/**
+ * 窗口属性基类
+ */
+interface IDecoratorInfo {
+    /** 构造函数 */
+    ctor: any;
+    /** 属性 */
+    props: Record<string, 1>;
+    /** 方法 */
+    callbacks: Record<string, Function>;
+    /** 控制器 */
+    controls: Record<string, 1>;
+    /** 动画 */
+    transitions: Record<string, 1>;
+    res: {
+        /** fgui包名 */
+        pkg: string;
+        /** 组件名 */
+        name: string;
+        /** 窗口组名称 可选(只有窗口才会设置) */
+        group?: string;
+        /** 内联的包名 当前界面需要引用其他包中的资源时使用 (只有窗口才会设置) */
+        inlinePkgs?: string[];
+    };
+}
 
 /**
  * @Author: Gongxh
  * @Date: 2024-12-08
  * @Description: 窗口顶边资源栏
  */
-interface IHeader {
+interface IHeader<T = any> {
     /** 资源栏名称 */
     name: string;
     /** 窗口适配类型 */
     adapterType: AdapterType;
+    /**
+     * 是否显示中
+     */
+    isShowing(): boolean;
 }
 
 /**
@@ -41,16 +71,17 @@ interface IHeader {
  * @Date: 2025-01-10
  * @Description: 窗口顶部资源栏信息
  */
-declare class WindowHeaderInfo {
+
+declare class HeaderInfo<T> {
     /** header名字 */
     name: string;
     /**
      * 创建 WindowHeaderInfo
      * @param {string} name header窗口名
      * @param {*} [userdata] 自定义数据
-     * @returns {WindowHeaderInfo}
+     * @returns {HeaderInfo}
      */
-    static create(name: string, userdata?: any): WindowHeaderInfo;
+    static create<T extends new () => IHeader, U>(ctor: T, userdata?: U): HeaderInfo<U>;
 }
 
 /**
@@ -59,7 +90,9 @@ declare class WindowHeaderInfo {
  * @Description:
  */
 
-interface IWindow {
+interface IWindow<TUserData = any, THeaderData = any> {
+    /** 窗口名称 */
+    name: string;
     /** 窗口类型 */
     type: WindowType;
     /** 窗口适配类型 */
@@ -71,394 +104,332 @@ interface IWindow {
      */
     isShowing(): boolean;
     /**
-     * 窗口是否被遮挡了
+     * 窗口是否在最上层
+     *
      */
-    isCover(): boolean;
+    isTop(): boolean;
     /** 获取资源栏数据 */
-    getHeaderInfo(): WindowHeaderInfo;
+    getHeaderInfo<THeaderData>(): HeaderInfo<THeaderData>;
+    /** 刷新资源栏 */
+    refreshHeader(): void;
 }
 
 /**
  * @Author: Gongxh
- * @Date: 2025-01-11
- * @Description: 窗口顶边栏
- * 窗口顶边资源栏 同组中只会有一个显示
+ * @Date: 2024-12-08
+ * @Description: 窗口组 (在同一个窗口容器的上的窗口)
  */
 
-declare abstract class UIHeader extends GComponent implements IHeader {
-    /** 窗口适配类型 */
-    adapterType: AdapterType;
-    protected abstract onInit(): void;
-    protected abstract onShow(window: IWindow, userdata?: any): void;
-    protected abstract onClose(): void;
-    protected onHide(): void;
-    protected onAdapted(): void;
-}
-
-/**
- * @Author: Gongxh
- * @Date: 2024-12-11
- * @Description: UI 装饰器
- */
-declare namespace _uidecorator {
-    interface IUIInfoBase {
-        /** 构造函数 */
-        ctor: any;
-        /** 属性 */
-        props: Record<string, 1>;
-        /** 方法 */
-        callbacks: Record<string, Function>;
-        /** 控制器 */
-        controls: Record<string, 1>;
-        /** 动画 */
-        transitions: Record<string, 1>;
-    }
-    /**
-     * 窗口属性注册数据结构
-     */
-    interface UIWindowInfo extends IUIInfoBase {
-        /** 配置信息 */
-        res: {
-            /** 窗口组名称 */
-            group: string;
-            /** fgui包名 */
-            pkg: string;
-            /** 窗口名 */
-            name: string;
-            /** 窗口bundle名 */
-            bundle: string;
-        };
-    }
-    /** 获取窗口注册信息 */
-    export function getWindowMaps(): Map<any, UIWindowInfo>;
+declare class WindowGroup {
     /**
-     * 窗口装饰器
-     * @param {string} groupName 窗口组名称
-     * @param {string} pkgName fgui包名
-     * @param {string} name 窗口名 (与fgui中的组件名一一对应)
+     * 获取窗口组的名称。
+     * @returns {string} 窗口组的名称。
      */
-    export function uiclass(groupName: string, pkgName: string, name: string, bundle?: string): Function;
+    get name(): string;
+    /** 获取窗口组的根节点 */
+    get root(): GComponent;
     /**
-     * 组件属性注册数据结构
+     * 获取当前窗口组中窗口的数量。
+     * @returns 窗口数量
      */
-    interface IUIComInfo extends IUIInfoBase {
-        /** 配置信息 */
-        res: {
-            /** fgui包名 */
-            pkg: string;
-            /** 组件名 */
-            name: string;
-        };
-    }
-    /** 获取组件注册信息 */
-    export function getComponentMaps(): Map<any, IUIComInfo>;
+    get size(): number;
+    /** 获取窗口组中窗口的名称列表 */
+    get windowNames(): string[];
     /**
-     * UI组件装饰器
-     * @param {string} pkg 包名
-     * @param {string} name 组件名
+     * 获取是否忽略查询的状态。
+     * @returns {boolean} 如果忽略查询，则返回 true，否则返回 false。
      */
-    export function uicom(pkg: string, name: string): Function;
-    /** header属性注册数据结构 */
-    interface IUIHeaderInfo extends IUIInfoBase {
-        /** 配置信息 */
-        res: {
-            /** fgui包名 */
-            pkg: string;
-            /** 组件名 */
-            name: string;
-            /** headerbundle名 */
-            bundle: string;
-        };
-    }
-    /** 获取header注册信息 */
-    export function getHeaderMaps(): Map<any, IUIHeaderInfo>;
+    get isIgnore(): boolean;
     /**
-     * UI header装饰器
-     * @param {string} pkg 包名
-     * @param {string} name 组件名
+     * 处理index下层窗口的隐藏状态的私有方法。递归调用
+     * @param index - 窗口索引
      */
-    export function uiheader(pkg: string, name: string, bundle?: string): Function;
+    private processWindowHideStatus;
+    hasWindow(name: string): boolean;
     /**
-     * UI属性装饰器
-     * @param {Object} target 实例成员的类的原型
-     * @param {string} name 属性名
-     *
-     * example: @uiprop node: GObject
+     * 获取窗口组顶部窗口实例
+     * @returns {IWindow} 顶部窗口实例
      */
-    export function uiprop(target: Object, name: string): any;
+    getTopWindow<T extends IWindow>(): T;
+}
+
+/**
+ * @Author: Gongxh
+ * @Date: 2024-12-14
+ * @Description: 窗口基类和fgui组件对接
+ */
+
+declare abstract class WindowBase<T = any, U = any> extends GComponent implements IWindow<T, U> {
+    /** 窗口类型 */
+    type: WindowType;
+    /** 窗口适配类型 */
+    adapterType: AdapterType;
+    /** 底部遮罩的透明度 */
+    bgAlpha: number;
+    isShowing(): boolean;
+    /** 是否在最上层显示 (除忽略的窗口组外, 显示到最上层时) */
+    isTop(): boolean;
     /**
-     * UI控制器装饰器
-     * @param {Object} target 实例成员的类的原型
-     * @param {string} name 属性名
-     *
-     * example: @uicontrol node: GObject
+     * 获取窗口顶部资源栏数据 默认返回空数组
+     * @returns {HeaderInfo}
      */
-    export function uicontrol(target: Object, name: string): any;
+    abstract getHeaderInfo<U>(): HeaderInfo<U>;
     /**
-     * UI动画装饰器
-     * @param {Object} target 实例成员的类的原型
-     * @param {string} name 属性名
-     *
-     * example: @uitransition node: GObject
+     * 刷新顶部资源栏
+     * 调用这个方法会重新创建 或者 刷新header
+     * 用来在同一个界面显示不同的header
      */
-    export function uitransition(target: Object, name: string): any;
+    refreshHeader(): void;
     /**
-     * 方法装饰器 (给点击事件用)
-     * @param {Object} target 实例成员的类的原型
-     * @param {string} name 方法名
+     * 用于在界面中关闭自己
      */
-    export function uiclick(target: Object, name: string, descriptor: PropertyDescriptor): void;
-    /** 首次UI注册完成 */
-    export function setRegisterFinish(): void;
-    export {};
+    protected removeSelf(): void;
+    protected abstract onAdapted(): void;
+    protected abstract onInit(): void;
+    protected abstract onClose(): void;
+    protected abstract onShow(userdata?: T): void;
+    protected abstract onShowFromHide(): void;
+    protected abstract onHide(): void;
+    protected abstract onToTop(): void;
+    protected abstract onToBottom(): void;
+    protected abstract onEmptyAreaClick(): void;
 }
 
 /**
  * @Author: Gongxh
- * @Date: 2025-02-25
- * @Description: 包配置格式
+ * @Date: 2024-12-14
+ * @Description:
  */
-interface IPackageConfig {
-    /** UI所在resources中的路径 */
-    uiPath: string;
-    /** 如果UI不在 resources 中，则需要配置 所在bundle下的路径名*/
-    bundlePaths?: {
-        [bundleName: string]: string;
-    };
-    /**
-     * 手动管理资源的包
-     * 1. 用于基础UI包, 提供一些最基础的组件，所有其他包都可能引用其中的内容
-     * 2. 资源header所在的包
-     * 3. 用于一些特殊场景, 比如需要和其他资源一起加载, 并且显示进度条的包
-     */
-    manualPackages: string[];
+
+declare abstract class Window<T = any, U = any> extends WindowBase<T, U> {
+    protected onAdapted(): void;
+    protected abstract onInit(): void;
+    protected abstract onClose(): void;
+    protected abstract onShow(userdata?: T): void;
+    protected onHide(): void;
+    protected onShowFromHide(): void;
+    protected onToTop(): void;
+    protected onToBottom(): void;
     /**
-     * 不推荐配置 只是提供一种特殊需求的实现方式
-     * 窗口引用到其他包中的资源 需要的配置信息
+     * 空白区域点击事件处理函数。
+     * 当用户点击窗口的空白区域时触发此方法。
      */
-    linkPackages: {
-        [windowName: string]: string[];
-    };
+    protected onEmptyAreaClick(): void;
     /**
-     * 关闭界面后，需要立即释放资源的包名（建议尽量少）
-     * 一般不建议包进行频繁装载卸载，因为每次装载卸载必然是要消耗CPU时间（意味着耗电）和产生大量GC的。UI系统占用的内存是可以精确估算的，你可以按照包的使用频率设定哪些包是需要立即释放的。
-     * 不包括手动管理的包
+     * 获取窗口顶部资源栏数据 默认返回空数组
+     * @returns {HeaderInfo}
      */
-    imReleasePackages: string[];
-}
-interface IPackageConfigRes {
-    /** 配置信息 */
-    config: IPackageConfig;
-    /** 显示加载等待窗 */
-    showWaitWindow: () => void;
-    /** 隐藏加载等待窗 */
-    hideWaitWindow: () => void;
-    /** 打开窗口时UI包加载失败 */
-    fail: (windowName: string, errmsg: string, pkgs: string[]) => void;
+    getHeaderInfo<U>(): HeaderInfo<U>;
 }
 
 /**
  * @Author: Gongxh
- * @Date: 2024-12-13
- * @Description:
+ * @Date: 2025-01-09
+ * @Description: 属性辅助类
  */
-interface WindowInfo {
-    /** 类的构造函数 */
-    ctor: any;
-    /** 窗口组名 */
-    group: string;
-    /** fgui包名 */
-    pkg: string;
-    /** 窗口名 */
-    name: string;
-    /** bundle名 */
-    bundle: string;
+interface IPropsConfig {
+    [packageName: string]: {
+        [componentName: string]: IPropsInfo;
+    };
+}
+interface IPropsInfo {
+    props: (string | number)[];
+    callbacks: (string | number)[];
+    controls: string[];
+    transitions: string[];
 }
 
 /**
  * @Author: Gongxh
- * @Date: 2024-12-08
- * @Description: 窗口组 (在同一个窗口容器的上的窗口)
+ * @Date: 2024-12-07
+ * @Description: 窗口管理类
  */
 
-declare class WindowGroup {
+/**
+ * 从窗口类型中提取 UserData 类型
+ */
+type ExtractUserData<T> = T extends Window<infer U, any> ? U : any;
+/**
+ * 从窗口构造函数中提取窗口实例类型
+ */
+type ExtractWindowInstance<T> = T extends new () => infer R ? R : never;
+declare class WindowManager {
+    private static _bgAlpha;
+    private static _bgColor;
     /**
-     * 获取窗口组的名称。
-     * @returns {string} 窗口组的名称。
+     * 添加手动管理资源加载 和 卸载的包名
+     * @param pkgName 包名
      */
-    get name(): string;
+    static addManualPackage(pkgName: string): void;
     /**
-     * 获取当前窗口组中窗口的数量。
-     * @returns 窗口数量
+     * 提供一种特殊需求 用来手动设置包所在的 bundle名 以及包在bundle中的路径
+     * @param name 窗口名称
+     * @param bundleName bundle名 默认: resources
+     * @param path 包在bundle中的路径 默认: ui目录
      */
-    get size(): number;
+    static setPackageInfo(pkgName: string, bundleName?: string, path?: string): void;
     /**
-     * 获取是否忽略查询的状态。
-     * @returns {boolean} 如果忽略查询，则返回 true，否则返回 false。
+     * 用于手动设置UI导出数据
+     * @param config UI导出数据
      */
-    get isIgnore(): boolean;
-    showWindow(info: WindowInfo, userdata?: any): void;
-    hasWindow(name: string): boolean;
+    static setUIConfig(config: IPropsConfig): void;
     /**
-     * 获取窗口组中顶部窗口的名称。
-     * @returns {string} 顶部窗口的名称。
+     * 设置UI包加载相关回调函数
+     * @param callbacks 包含加载回调的对象
+     * @param callbacks.showWaitWindow 显示加载等待窗的回调
+     * @param callbacks.hideWaitWindow 隐藏加载等待窗的回调
+     * @param callbacks.fail 打开窗口时资源加载失败的回调 code( 1:bundle加载失败 2:包加载失败 )
      */
-    getTopWindowName(): string;
+    static setPackageCallbacks(callbacks: {
+        showWaitWindow: () => void;
+        hideWaitWindow: () => void;
+        fail: (windowName: string, code: 1 | 2, message: string) => void;
+    }): void;
     /**
-     * 关闭窗口组中的所有窗口
-     */
-    closeAllWindow(): void;
-}
-
-/**
- * @Author: Gongxh
- * @Date: 2024-12-07
- * @Description: 窗口管理类
- */
-
-declare class UIManager {
-    /** 配置UI包的一些信息 (可以不配置 完全手动管理) */
-    static initPackageConfig(res: IPackageConfigRes): void;
-    /**
-     * 异步打开一个窗口 (如果UI包的资源未加载, 会自动加载 配合 UIManager.initPackageConfig一起使用)
-     * @param windowName 窗口名
+     * 异步打开一个窗口 (如果UI包的资源未加载, 会自动加载 可以配合 WindowManager.setPackageCallbacks一起使用)
+     * @param 窗口类
      * @param userdata 用户数据
      */
-    static showWindow(windowName: string, userdata?: any): Promise<void>;
+    static showWindow<T extends new () => Window<any, any>>(window: T, userdata?: ExtractUserData<ExtractWindowInstance<T>>): Promise<ExtractWindowInstance<T>>;
     /**
-     * 显示指定名称的窗口，并传递可选的用户数据。(用于已加载过资源的窗口)
-     * @param windowName - 窗口的名称。
-     * @param userdata - 可选参数，用于传递给窗口的用户数据。
+     * 关闭一个窗口
+     * @param ctor 窗口类
      */
-    static showWindowIm(windowName: string, userdata?: any): void;
+    static closeWindow<T extends new () => IWindow>(window: T): void;
     /**
-     * 关闭窗口
-     * @param windowName 窗口名
+     * 通过窗口名称关闭一个窗口
+     * @param name 窗口名称
      */
-    static closeWindow(windowName: string): void;
+    static closeWindowByName(name: string): void;
     /**
-     * 关闭所有窗口
-     * @param ignoreNames 忽略关闭的窗口名
+     * 是否存在窗口
+     * @param name 窗口名称
      */
-    static closeAllWindow(ignoreNames?: string[]): void;
-    /**
-     * 获取当前最顶层的窗口实例。
-     * @template T - 窗口实例的类型，必须继承自 IWindow 接口。
-     * @returns {T | null} - 返回最顶层的窗口实例，如果没有找到则返回 null。
-     * @description 该方法会遍历所有窗口组，找到最顶层的窗口并返回其实例。
-     */
-    static getTopWindow<T extends IWindow>(): T | null;
+    static hasWindow(name: string): boolean;
     /**
      * 根据窗口名称获取窗口实例。
      * @template T 窗口类型，必须继承自IWindow接口。
-     * @param name 窗口的名称。
+     * @param name 窗口名称
      * @returns 如果找到窗口，则返回对应类型的窗口实例；否则返回null。
      */
-    static getWindow<T extends IWindow>(name: string): T | null;
+    static getWindow<T extends IWindow>(name: string): T | undefined;
     /**
-     * 检查是否存在指定名称的窗口。
-     * @param name 窗口的名称。
-     * @returns 如果存在指定名称的窗口，则返回 true，否则返回 false。
+     * 获取当前最顶层的窗口实例。
+     * 默认会忽略掉忽略查询的窗口组
+     * @returns {T | null} - 返回最顶层的窗口实例，如果没有找到则返回 null。
      */
-    static hasWindow(name: string): boolean;
+    static getTopWindow<T extends IWindow, U>(isAll?: boolean): T | null;
+    /**
+     * 获取所有窗口组的名称列表（按层级顺序）
+     * @returns 窗口组的名称列表
+     */
+    static getGroupNames(): string[];
     /**
      * 根据给定的组名获取窗口组。如果组不存在，则抛出错误。
-     * @param groupName 窗口组的名称。
+     * @param name 窗口组名称
      * @returns 返回找到的窗口组。
      */
-    static getWindowGroup(groupName: string): WindowGroup;
+    static getWindowGroup(name: string): WindowGroup;
     /**
-     * 获取当前顶层窗口组的名称。
-     * 返回第一个包含至少一个窗口的窗口组名称。(该方法只检查不忽略查询的窗口组)
-     * 如果没有找到任何包含窗口的组，则返回空字符串。
+     * 关闭所有窗口
+     * @param ignores 不关闭的窗口
      */
-    static getTopGroupName(): string;
-    /** 动态注册窗口到资源池中 */
-    static dynamicRegisterWindow(ctor: any, group: string, pkg: string, name: string, bundle: string): void;
-    /** 动态注册窗口header到资源池中 */
-    static dynamicRegisterHeader(ctor: any, pkg: string, name: string, bundle: string): void;
-}
-
-/**
- * @Author: Gongxh
- * @Date: 2024-12-14
- * @Description: 窗口基类和fgui组件对接
- */
-
-declare abstract class UIWindow extends GComponent implements IWindow {
-    /** 窗口类型 */
-    type: WindowType;
-    /** 窗口适配类型 */
-    adapterType: AdapterType;
-    /** 底部遮罩的透明度 */
-    bgAlpha: number;
-    isShowing(): boolean;
-    isCover(): boolean;
+    static closeAllWindow(ignores?: IWindow[]): void;
     /**
-     * 获取窗口顶部资源栏数据 默认返回空数组
-     * @returns {WindowHeaderInfo[]}
+     * 释放不再使用中的自动加载的UI资源
+     * 针对在 UIModule 中设置了不自动释放资源的场景
      */
-    getHeaderInfo(): WindowHeaderInfo;
-    getHeader<T extends UIHeader>(): T | null;
-    protected abstract onAdapted(): void;
-    protected abstract onInit(): void;
-    protected abstract onClose(): void;
-    protected abstract onShow(userdata?: any): void;
-    protected abstract onShowFromHide(): void;
-    protected abstract onHide(): void;
-    protected abstract onCover(): void;
-    protected abstract onRecover(): void;
-    protected abstract onEmptyAreaClick(): void;
+    static releaseUnusedRes(): void;
 }
 
 /**
  * @Author: Gongxh
- * @Date: 2024-12-14
- * @Description:
+ * @Date: 2024-12-11
+ * @Description: UI 装饰器
  */
 
-declare abstract class Window extends UIWindow {
-    protected onAdapted(): void;
+declare namespace _uidecorator {
+    /** 获取窗口注册信息 */
+    function getWindowMaps(): Map<any, IDecoratorInfo>;
+    /** 获取组件注册信息 */
+    function getComponentMaps(): Map<any, IDecoratorInfo>;
+    /** 获取header注册信息 */
+    function getHeaderMaps(): Map<any, IDecoratorInfo>;
     /**
-     * 初始化窗口时调用的方法。
-     * 子类必须实现的方法，用来设置窗口的属性。
+     * 窗口装饰器
+     * @param {string} groupName 窗口组名称
+     * @param {string} pkgName fgui包名
+     * @param {string} name 窗口名 (与fgui中的组件名一一对应)
+     * @param {string[] | string} inlinePkgs 内联的包名 当前界面需要引用其他包中的资源时使用 引用多个包用数组 引用单个包用字符串
+     *
+     * @example @uiclass("窗口组", "UI包名", "MyWindow", ["包名1", "包名2"])
+     * @example @uiclass("窗口组", "UI包名", "MyWindow", "包名1")
      */
-    protected abstract onInit(): void;
+    function uiclass(groupName: string, pkgName: string, name: string, inlinePkgs?: string[] | string): Function;
     /**
-     * 窗口关闭时的处理逻辑。
-     * 子类可以重写此方法以实现自定义的关闭行为。
+     * UI组件装饰器
+     * @param {string} pkg 包名
+     * @param {string} name 组件名
      */
-    protected onClose(): void;
+    function uicom(pkg: string, name: string): Function;
     /**
-     * 窗口显示时的回调函数。
-     * @param userdata 可选参数，传递给窗口显示时的用户数据。
+     * UI header装饰器
+     * @param {string} pkg 包名
+     * @param {string} name 组件名
      */
-    protected onShow(userdata?: any): void;
+    function uiheader(pkg: string, name: string): Function;
     /**
-     * 隐藏窗口时的处理逻辑。
-     * 重写此方法以实现自定义的隐藏行为。
+     * UI属性装饰器
+     * @param {Object} target 实例成员的类的原型
+     * @param {string} name 属性名
+     *
+     * example: @uiprop node: GObject
      */
-    protected onHide(): void;
+    function uiprop(target: Object, name: string): any;
     /**
-     * 当窗口从隐藏状态变为显示状态时调用。
-     * 这个方法可以被子类重写以实现特定的显示逻辑。
+     * UI控制器装饰器
+     * @param {Object} target 实例成员的类的原型
+     * @param {string} name 属性名
+     *
+     * example: @uicontrol node: GObject
      */
-    protected onShowFromHide(): void;
+    function uicontrol(target: Object, name: string): any;
     /**
-     * 当窗口被覆盖时触发的事件处理函数。
-     * 子类可以重写此方法以添加自定义行为。
+     * UI动画装饰器
+     * @param {Object} target 实例成员的类的原型
+     * @param {string} name 属性名
+     *
+     * example: @uitransition node: GObject
      */
-    protected onCover(): void;
+    function uitransition(target: Object, name: string): any;
     /**
-     * 恢复窗口状态时的处理逻辑。
-     * 此方法在窗口从隐藏或最小化状态恢复时被调用。
+     * 方法装饰器 (给点击事件用)
+     * @param {Object} target 实例成员的类的原型
+     * @param {string} name 方法名
      */
-    protected onRecover(): void;
+    function uiclick(target: Object, name: string, descriptor: PropertyDescriptor): void;
+}
+
+/**
+ * @Author: Gongxh
+ * @Date: 2025-01-11
+ * @Description: 窗口顶边栏
+ * 窗口顶边资源栏 同组中只会有一个显示
+ */
+
+declare abstract class Header<T = any> extends GComponent implements IHeader<T> {
+    /** 窗口适配类型 */
+    adapterType: AdapterType;
+    protected abstract onInit(): void;
+    protected abstract onShow(userdata?: T): void;
+    protected onAdapted(): void;
+    protected onClose(): void;
+    protected onHide(): void;
+    protected onShowFromHide(): void;
     /**
-     * 空白区域点击事件处理函数。
-     * 当用户点击窗口的空白区域时触发此方法。
+     * 是否显示中
      */
-    protected onEmptyAreaClick(): void;
+    isShowing(): boolean;
 }
 
 /**
@@ -467,12 +438,13 @@ declare abstract class Window extends UIWindow {
  * @Description: cocos UI模块
  */
 
-declare class UIModule extends Component {
+declare class UIModule extends Module {
+    ui_config: JsonAsset;
+    bgAlpha: number;
+    autoReleaseUIRes: boolean;
     /** 模块名称 */
     moduleName: string;
-    /** 模块初始化完成后调用的函数 */
-    protected onInit(): void;
+    onInit(): void;
 }
 
-export { AdapterType, UIHeader, UIManager, UIModule, Window, WindowGroup, WindowHeaderInfo, WindowType, _uidecorator };
-export type { IPackageConfigRes };
+export { AdapterType, Header, HeaderInfo, UIModule, Window, WindowGroup, WindowManager, WindowType, _uidecorator };