@zhongguo168a/yxeditor-common 0.0.15 → 0.0.17

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { HorizontalTextAlignment, VerticalTextAlignment, Scheduler, Prefab, Node, Component, ISchedulable, AssetManager, Asset, SpriteAtlas, Vec2, Vec3, Vec4 } from 'cc';
+import { HorizontalTextAlignment, VerticalTextAlignment, Scheduler, Prefab, Node, ISchedulable, AssetManager, Asset, SpriteAtlas, Camera, Canvas, Vec2, Vec3, Vec4, Widget, UITransform, math } from 'cc';
 
 interface IError {
     isCancel(): boolean;
@@ -483,856 +483,858 @@ declare class Route {
     protected _route: string;
 }
 
-declare class TreeIterator {
+declare class DictIterator {
     break(): void;
     isBreak(): boolean;
     protected _isBreak: any;
 }
-interface ITreeListItem {
-    /**
-     * 路径
-     */
-    path: string;
+declare class Dictionary<K = string, V = any> {
+    constructor(data?: any);
+    reset(data: any): void;
+    protected _reset(data: any, size?: number): void;
+    getData(): any;
     /**
-     * 自定义数据
+     * 如果使用了 onSet or onDelete，需要注意清理
      */
-    data?: any;
+    clear(): void;
     /**
-     * 功能性标签，用于开发组件时，记录组件的状态。例如title, icon, 显示树的组件，需要 expanded，selected标签
+     * 克隆自身所有项到【target】对象，并返回【target】对象
+     * @param target
      */
-    tags?: {
-        [key: string]: any;
-    };
+    clone(target: this): this;
+    resetByDict(dict: Dictionary): void;
+    onSet(caller: any, handler: (key: K, value: V) => void): void;
+    onDelete(caller: any, handler: (key: K, value: V) => void): void;
     /**
-     * 是否树叶
+     * 设置键值对，如果没有发生变化，不会触发onSet函数
+     * @param key
+     * @param value
      */
-    isLeaf: boolean;
-}
-declare class TreeNode<T = any> {
-    get root(): TreeRoot;
+    set(key: K, value: V): void;
+    private setData;
+    setByMap(m: any): void;
+    addDictionary(other: Dictionary<K, V>): void;
+    deleteDictionary(other: Dictionary<K, V>): void;
     /**
-     * 根节点
+     * 如果不存在，返回 undefined
+     * @param key
      */
-    protected _root: TreeRoot;
+    get(key: K): V;
+    exist(key: K): boolean;
+    delete(key: K): void;
+    private deleteData;
+    exists(key: K): boolean;
+    length(): number;
+    pop(key: K): [V, boolean];
+    isEmpty(): boolean;
+    items(): V[];
+    keys(): K[];
     /**
-     * 编号
+     *
+     * @param handler 可以使用【iterator】中断遍历
+     * @return iterator 获取是否中断了
      */
-    uuid: string;
+    forEach(handler: (key: K, val: V, iterator: DictIterator) => void): DictIterator;
     /**
-     * 编号
      */
-    id: string;
+    first(): V | undefined;
     /**
-     * 自定义数据
+     * @param handler 返回true结束迭代
      */
-    data: T;
+    firstByCondition(handler: (key: K, val: V) => boolean): V | undefined;
     /**
-     * 是否树叶
+     * 移除符合条件的项
+     * @param cond 可以使用【iterator】中断遍历
      */
-    isLeaf: boolean;
+    removeByCondition(cond: (key: K, val: V, iterator: DictIterator) => boolean): void;
     /**
-     * 功能性标签，用于开发组件时，记录组件的状态。例如title, icon, 显示树的组件，需要 expanded，selected标签
+     * 查找符合条件的项保存到【target】对象中，并返回【target】对象
+     * @param cond 可以使用【iterator】中断遍历
+     * @param target 存到目标对象中
      */
-    tags: {
+    findByCondition(cond: (key: K, val: V, iterator: DictIterator) => boolean, target: Dictionary): this;
+    groupByCondition(createKey: (key: K, val: V) => string, ITEM_CLASS?: any): {
         [key: string]: any;
     };
+    protected size: number;
+    private _data;
+    private _onSet;
+    private _onDelete;
+    private _onSetCaller;
+    private _onDeleteCaller;
+}
+
+declare class ListIterator {
+    break(): void;
+    isBreak(): boolean;
+    protected _isBreak: any;
+}
+declare class List<T = any> {
+    constructor();
+    onSet(caller: any, handler: (value: T) => void): void;
+    onDelete(caller: any, handler: (value: T) => void): void;
+    firstByCondition(conf: (index: number, item: T) => boolean): [number, T];
+    lastByCondition(conf: (index: number, item: T) => boolean): [number, T];
+    forEach(handler: (index: number, item: T, iterator: ListIterator) => void): ListIterator;
     /**
-     * 深度
+     * 移除符合条件的项, 从后往前遍历
+     * @param cond 可以使用【iterator】中断遍历
+     * @param removedList 设置后，可获得被移除的项
      */
-    get depth(): number;
-    private _depth;
+    removeByCondition(cond: (index: number, val: T, iterator: ListIterator) => boolean, removedList?: List): this;
     /**
-     * 父节点
+     * 查找符合条件的项保存到【target】对象中，并返回【target】对象
+     * @param cond 可以使用【iterator】中断遍历
+     * @param target 存到目标对象中
      */
-    parent: TreeNode;
+    findByCondition(cond: (index: number, val: T, iterator: ListIterator) => boolean, target: List): this;
+    pop(): T;
+    shift(): T;
+    first(): T;
+    last(): T;
+    removeAt(index: number): void;
+    remove(item: T): void;
     /**
-     * 子节点
+     * 把【other】的项合并到自身
+     * @param other
      */
-    children: TreeNode[];
+    removeList(other: List<T>): void;
+    sort(compareFn?: (a: T, b: T) => number): void;
+    reverse(): void;
+    clear(): void;
     /**
-     * 设置根
-     * @param val
+     * 克隆自身所有项到【target】对象，并返回【target】对象
+     * @param target
      */
-    setRoot(val: TreeRoot): void;
-    getTags(): {
-        [key: string]: any;
-    };
-    getTag(name: string): any;
-    removeTag(name: string): void;
-    setTag(name: string, value: any): void;
-    constructor(id: string, isLeaf?: boolean);
-    addChild(val: TreeNode): void;
-    getChildIndex(val: TreeNode): number;
-    insertChild(val: TreeNode, index: number): void;
-    removeChild(val: TreeNode): void;
-    removeChildren(): void;
-    get name(): string;
-    setDepth(val: number): void;
-    containsById(id: string): boolean;
+    clone(target: this): this;
+    get length(): number;
+    insertAt(index: number, ...item: T[]): void;
     /**
-     * 通过编号获取子节点
-     * @param id
+     * @param beforeItem
+     * @param item
      */
-    getChildById(id: string): TreeNode;
+    insertBefore(beforeItem: T, ...item: T[]): void;
     /**
-     * 返回相邻的上一个节点
+     * @param afterItem
+     * @param item
      */
-    prevNode(): TreeNode;
+    insertAfter(afterItem: T, ...item: T[]): void;
+    at(index: number): T;
+    set(index: number, item: T): void;
+    indexOf(item: T): number;
+    has(item: T): boolean;
+    push(item: T): void;
     /**
-     * 返回相邻的下一个节点
+     * 把【other】的项合并到自身
+     * @param other
      */
-    nextNode(): TreeNode;
+    pushList(other: List<T>): void;
+    getData(): T[];
+    resetData(val: T[]): void;
     /**
-     * 如果返回true则删除节点，包含当前节点
-     * @param f
+     * 随机获取【count】个项，并返回【target】对象
+     * @param count
+     * @param enableRepeat 允许重复
+     * @param target
      */
-    walkRemove(f: (node: TreeNode) => boolean): void;
-    private _walkRemove;
+    random(count: number, enableRepeat?: boolean, target?: List<T>): List<T>;
+    protected callPush(value: any): void;
+    protected callRemove(value: any): void;
+    protected _data: any[];
+    private _onSet;
+    private _onDelete;
+    private _onSetCaller;
+    private _onDeleteCaller;
+}
+
+declare class UIObjectDict extends Dictionary<string, any | List> {
     /**
-     * 如果返回true则继续，包含当前节点
-     * @param f
-     * @param inChild
+     * 获取唯一的
+     * @param prefab
      */
-    walk(f: (node: TreeNode) => boolean, inChild?: (node: TreeNode) => boolean): void;
-    private _walk;
+    uniqueObject(prefab: Prefab): Node;
+    removeObject(prefab: Prefab): void;
+    popObject(prefab: Prefab): any;
+    backObject(object: Node): void;
+    protected getList(key: any): List;
+}
+declare var uidict: UIObjectDict;
+
+declare class ViewController {
+    constructor(name: string);
+    open(...args: any[]): void;
+    close(): void;
+    get objectDict(): UIObjectDict;
+    get name(): string;
+    protected _objectDict: UIObjectDict;
+    private _name;
+}
+
+declare class PageController extends ViewController {
+    constructor(routeName: string, config?: {
+        layer?: string;
+        tags?: string[];
+        enableHistory?: boolean;
+    });
+    protected onOpening(page: Page): void;
+    protected onOpened(page: Page): void;
+    protected onClosing(page: Page): void;
+    protected onClosed(page: Page): void;
+    protected onRefresh(page: Page): void;
+    openByRoute(route: Route): Page;
+    private openPage;
+    openComplete(page: Page): void;
+    closeByRoute(route?: Route): Page;
+    private closePage;
+    closeComplete(page: Page): void;
+    refresh(): void;
+    get layer(): string;
+    hasTags(tags: string[]): boolean;
+    setLayer(name: string): this;
+    setTags(tags: string[]): this;
+    get lastPage(): Page;
+    get route(): Route;
+    get enableHistory(): boolean;
+    protected _enableHistory: boolean;
+    protected _route: Route;
+    protected _lastPage: Page;
+    protected _tags: {};
+    protected _layer: string;
+}
+declare class PageControllerDict extends Dictionary<string, PageController> {
+    getByName(name: string): PageController;
+}
+
+declare enum PageState {
     /**
-     * 从当前节点（包括）遍历父节点链，包含当前节点
-     * @param f
+     * 关闭
      */
-    walkParent(f: (node: TreeNode) => boolean): boolean;
+    Closed = 0,
     /**
-     * 从当前节点往前遍历（深度），包含当前节点
-     * @param f
-     * @param inChild
+     * 正在打开
      */
-    walkPrev(f: (node: TreeNode) => boolean, inChild?: (node: TreeNode) => boolean): any;
-    private _walkPrev;
-    dump(): void;
+    Opening = 1,
     /**
-     * 遍历节点，查找指定编号的节点
+     * 已打开
      */
-    findById(id: string): TreeNode;
+    Opened = 2,
     /**
-     * 如果返回true则继续
-     * @param f
+     * 正在关闭
      */
-    findOne(f: (node: TreeNode) => boolean): TreeNode;
-    private _findOne;
+    Closeing = 3
+}
+declare enum PageEvent {
+    Opening = "opening",
+    Opened = "opened",
+    Closeing = "closeing",
+    Closed = "closed",
+    Stop = "stop"
+}
+declare class Page extends EventManager {
+    constructor(controller: PageController, route: Route);
     /**
-     * 通过路径获取节点
-     * 格式为 /path1/path2/...
-     * 如果 path == "/"，则返回自身
-     * @param path
+     * 等待打开完成指令
      */
-    getNodeByPath(path: string): TreeNode;
-    protected getNodeByPathArr(pathArr: string[]): TreeNode;
-    getName(): string;
-    getPath(): string;
+    waitOpenComplete(): void;
+    waitCloseComplete(): void;
+    openComplete(): void;
+    closeComplete(): void;
+    stop(reason: LinkError): void;
     /**
-     * 如果返回true则继续
-     * @param f
+     * 等待发送的结果
+     * 如果返回 null，表示主动取消 [cancel]
      */
-    find(f: (node: TreeNode) => boolean): TreeNode[];
-    private _find;
-    toRoot(): TreeRoot;
-    clone(): TreeNode;
-    protected cloneChildrenTo(node: TreeNode): void;
-    fixDepthAndRoot(depth: number, root: TreeRoot): void;
+    wait(): Promise<this>;
     toString(): string;
+    get objectDict(): UIObjectDict;
+    protected _objectDict: UIObjectDict;
+    protected _waitOpenComplete: boolean;
+    protected _waitCloseComplete: boolean;
+    get controller(): PageController;
+    get route(): Route;
+    cache: {};
+    tags: {};
+    layer: string;
+    state: PageState;
+    protected _controller: PageController;
+    protected _route: Route;
 }
-declare class TreeRoot<NODE = any> extends EventManager {
+
+/**
+ * 视图管理器
+ * 打开一个视图的时候，可能会听过加载资源，读取数据，调整布局，切换特效等处理，所以使用视图模式封装视图打开关闭的逻辑
+ */
+declare class PageLayer {
+    name: string;
+    constructor(name: string);
+    close(): void;
     /**
-     * 添加数据节点
-     * dispatchParams = {node:TreeNode, parent:TreeNode|TreeRoot}
+     * 当前的页面
      */
-    static EVENT_ADD: string;
+    currentPage: Page;
+}
+
+declare class PageList extends List<Page> {
+}
+declare class PageRepo extends PageList {
+    constructor();
+    openByString(route: string): Page;
     /**
-     * 移除数据节点
-     * dispatchParams = {node:TreeNode, parent:TreeNode|TreeRoot}
+     * 打开页面
+     * 一个路由代表一个页面
+     * @param route
      */
-    static EVENT_REMOVE: string;
+    open(route: Route): Page;
+    close(route: Route): void;
     /**
-     * 插入数据节点
-     * dispatchParams = {node:TreeNode, before:TreeNode}
+     * 如果页面存在，则刷新
+     * @param route
      */
-    static EVENT_INSERT: string;
+    refresh(route: Route): void;
     /**
-     * 刷新数据节点
-     * dispatchParams = {node:TreeNode}
+     * 历史记录
      */
-    static EVENT_REFRESH: string;
+    getHistory(): Route[];
+    back(): void;
+    getByRoute(route: Route): Page;
+    listByTags(tags: string[]): PageList;
+    getLayerMain(): PageLayer;
     /**
-     * 设置数据时触发
-     * dispatchParams = {node:TreeNode}
+     * @param name
      */
-    static EVENT_DATA_SET: string;
+    getLayer(name: string): PageLayer;
+    protected getOrNewLayer(name: string): PageLayer;
+    getController(route: Route): PageController;
+    registerController(ctrl: PageController): void;
+    get objectDict(): UIObjectDict;
+    protected _objectDict: UIObjectDict;
+    protected _indexLayer: {};
+    protected _indexRoute: {};
+    protected _history: Route[];
+    protected _ctrlDict: PageControllerDict;
+}
+declare const pagerepo: PageRepo;
+
+/**
+ * 事件字符串分隔符
+ */
+
+/**
+ * 回调列表
+ */
+declare class CallbackList<PARAMS = any> {
+    constructor();
+    addListener(listener: Listener): void;
+    removeListener(listener: Listener): void;
     /**
-     * 设置数据时触发
-     * dispatchParams = {node:TreeNode, tag:string, value:any}
      */
-    static EVENT_TAGS_SET: string;
-    static create(): TreeRoot<any>;
+    create(): Listener<PARAMS>;
     /**
-     * 通过列表生成一个树结构
-     * @param items
-     * @param existed 列表将添加的已经存在的树结构
+     * 如果监听器已经不存在，则创建
+     * @param ident
      */
-    static createByList(items: ITreeListItem[], existed?: TreeRoot): TreeRoot;
-    static sortChildrenByName(node: TreeNode, des?: boolean): void;
-    constructor();
-    setNodeData(node: TreeNode, data: any): void;
-    setNodeTags(node: TreeNode, tag: string, value: any, force?: boolean): void;
-    getNodeByPath(path: string): TreeNode;
-    makeNodeByPath(path: string): TreeNode;
+    createByIdent(ident: any): Listener<PARAMS>;
+    removeByIdent(ident: any): void;
+    removeByCaller(caller: any): void;
+    getByIdent(ident: any): Listener;
     /**
-     * 添加节点，按照 node.path 添加到正确的位置
-     * @param node
-     * @param parentPath 如果父节点路径为 "", 则添加到起源节点
-     * @param autoCreateParent 如果父节点不存在，自动创建
+     * 派发事件
+     * @param params 事件参数
+     * @param subIdent
      */
-    addNode(node: TreeNode, parentPath?: string, autoCreateParent?: boolean): void;
-    removeNode(node: TreeNode): void;
-    removeChildren(node: TreeNode): void;
-    insertNode(node: TreeNode, before: TreeNode, resetId?: boolean): void;
-    walk(f: (node: TreeNode) => boolean, inChild?: (node: TreeNode) => boolean): void;
-    walkPrev(f: (node: TreeNode) => boolean, inChild?: (node: TreeNode) => boolean): void;
+    dispatch(params?: PARAMS, subIdent?: string): void;
+    protected _data: List<Listener<any>>;
+    protected _indexIdent: {};
+}
+
+declare class Listener<PARAMS = any> {
+    static create(ident?: string): Listener<any>;
+    constructor(ident?: string);
+    getCaller(): any;
+    setCaller(caller: any): this;
+    setSubIdent(val: string): this;
+    setCondition(condition: (listener: Listener<PARAMS>) => boolean): this;
+    setHandler(handler: (listener: Listener<PARAMS>) => void): this;
+    setOnParams(val: any): this;
+    getIdent(): string;
+    on(): this;
+    off(): this;
+    isOn(): boolean;
+    remove(): void;
     /**
-     * 派发 refresh 消息
-     * @param node
+     * 内部使用
+     * @param params
+     * @param subIdent 子编号
      */
-    refresh(node: TreeNode): void;
+    _dispatch(params: PARAMS, subIdent?: string): void;
+    getOnParams(): any;
+    getParams(): PARAMS;
+    protected onParams: any;
+    protected params: PARAMS;
+    protected ident: string;
+    protected _subIdent: string;
+    protected source: CallbackList;
+    protected _handler: (any: any) => void;
+    protected _condition: (any: any) => boolean;
+    protected caller: any;
+    protected _isOn: boolean;
+}
+
+/**
+ * 事件字符串分隔符
+ */
+
+/**
+ * 事件派发器
+ */
+declare class Dispatcher implements ISchedulable {
+    constructor(name?: string);
+    dispose(): void;
+    create(type: string, listener: Listener): void;
+    remove(type: string, listener: Listener): void;
+    getByIdent(type: string, ident: string): Listener;
     /**
-     * 克隆当前的树结
-     * * 新的tags克隆旧的data
-     * * 新的data指向旧的data
+     * @param type
+     * @param ident
      */
-    clone(): TreeRoot;
-    toString(): string;
-    createNode(id: string, isLeaf?: boolean): TreeNode;
+    createByIdent(type: string, ident: string): Listener;
     /**
-     * origin的第一个child
+     * 派发事件
+     * @param eventType 事件类型
+     * @param params 事件参数
      */
-    get firstNode(): TreeNode;
-    origin: TreeNode;
-}
-declare class TreeRootPlugin {
-    root: TreeRoot;
-}
-declare class TreeNodePlugin {
-    node: TreeNode;
+    dispatch(eventType: string, params?: any): void;
+    protected getList(type: string): CallbackList;
+    id?: string;
+    uuid?: string;
+    name: string;
+    protected isDispose: boolean;
+    protected typeToList: Dictionary<string, CallbackList<any>>;
 }
 
-interface IListItem {
-    /**
-     * 编号
-     */
-    id: string;
+declare class CallbackItem {
+    listener: Function;
+    caller: any;
+    once: boolean;
+}
+declare class SampleCallbackList {
+    constructor();
+    dispose(): void;
+    has(caller: any, listener: Function): boolean;
+    protected getItem(caller: any, listener: Function): CallbackItem;
     /**
-     * 自定义数据
+     * 监听事件，如果监听已经存在则返回
+     * @param caller
+     * @param listener 为了性能考虑， event使用了对象池处理。因此处理函数不应该保存event的引用。如有需要，可通过新建对象或Event.Clone()实现
      */
-    data?: any;
+    on(caller: any, listener: (ctx: this, params?: any) => void): CallbackItem;
+    once(caller: any, listener: (ctx: this, params?: any) => void): CallbackItem;
+    protected offItem(item: CallbackItem): void;
+    off(caller: any, listener: Function): void;
+    offAll(type?: string): void;
+    offAllCaller(caller: any): void;
     /**
-     * 功能性标签，用于开发组件时，记录组件的状态。例如title, icon, 显示树的组件，需要 expanded，selected标签
+     * 派发事件
+     * @param params 事件参数
      */
-    tags?: {
-        [key: string]: any;
-    };
+    dispatch(params?: any): void;
+    protected _callbackItems: CallbackItem[];
 }
-declare class ListNode {
-    static create(id: string, data?: any): ListNode;
-    constructor();
-    root: ListSource;
+
+declare class AssetURI {
+    name: string;
+    constructor(name: string);
+    loadType: number;
     uuid: string;
-    id: string;
-    data: any;
-    tags: {};
-    getTags(): {
-        [key: string]: any;
-    };
-    setTags(tags: {
-        [key: string]: any;
-    }): void;
-    getTag(name: string): any;
-    setTag(name: string, value: any): void;
+    path: string;
+    bundle: string;
 }
-declare class ListSource extends EventManager {
+declare class XAssetManager {
+    getAsset(uri: string): any;
+    getAssetByUUID(uuid: string): any;
+    getRoot(): AssetManager;
+}
+declare let assetx: XAssetManager;
+
+declare class TreeIterator {
+    break(): void;
+    isBreak(): boolean;
+    protected _isBreak: any;
+}
+interface ITreeListItem {
     /**
-     * 通过数组创建 ListSource。ListSource的id自动生成。如果需要指定编号，可设置 idCreator
-     * @param arr
-     * @param idCreator
+     * 路径
      */
-    static createByArray(arr: any[], idCreator?: (item: any) => string): ListSource;
-    static createByListItem(arr: IListItem[], target?: ListSource): any;
+    path: string;
     /**
-     * 设置数据时触发
-     * dispatchParams = {node:ListNode}
+     * 自定义数据
+     */
+    data?: any;
+    /**
+     * 功能性标签，用于开发组件时，记录组件的状态。例如title, icon, 显示树的组件，需要 expanded，selected标签
      */
-    static EVENT_ADD: string;
+    tags?: {
+        [key: string]: any;
+    };
     /**
-     * 设置数据时触发
-     * dispatchParams = {node:ListNode, index:number}
+     * 是否树叶
      */
-    static EVENT_REMOVE: string;
+    isLeaf: boolean;
+}
+declare class TreeNode<T = any> {
+    get root(): TreeRoot;
     /**
-     * 设置数据时触发
+     * 根节点
      */
-    static EVENT_REMOVE_ALL: string;
+    protected _root: TreeRoot;
     /**
-     * 刷新数据节点
-     * dispatchParams = {node:ListNode}
+     * 编号
      */
-    static EVENT_REFRESH: string;
+    uuid: string;
     /**
-     * 设置数据时触发
-     * dispatchParams = nodes: [ListNode], indexs: [number]
+     * 编号
      */
-    static EVENT_SWAP: string;
+    id: string;
     /**
-     * 设置数据时触发
-     * dispatchParams = {node:ListNode, data:any}
+     * 自定义数据
      */
-    static EVENT_DATA_SET: string;
+    data: T;
     /**
-     * 设置数据时触发
-     * dispatchParams = {node:ListNode, tag:string, value:any}
+     * 是否树叶
      */
-    static EVENT_TAGS_SET: string;
-    protected _identFunc: (node: ListNode) => boolean;
-    at(index: number): ListNode;
-    first(): ListNode;
-    last(): ListNode;
-    length(): number;
+    isLeaf: boolean;
     /**
-     * 添加项，无法添加相同的项
-     * @param node
-     * @param enableDispatch 默认为true
+     * 功能性标签，用于开发组件时，记录组件的状态。例如title, icon, 显示树的组件，需要 expanded，selected标签
      */
-    add(node: ListNode, enableDispatch?: boolean): void;
-    getById(id: string): ListNode;
-    remove(node: ListNode): void;
-    removeAll(): void;
-    swap(a: ListNode, b: ListNode): void;
-    contains(node: ListNode): boolean;
-    containsById(id: string): boolean;
-    indexOf(node: ListNode): number;
-    indexOfById(id: string): number;
-    setData(node: ListNode, data: any): void;
-    setNodeTags(node: ListNode, tag: string, value: any): void;
+    tags: {
+        [key: string]: any;
+    };
     /**
-     * 派发 refresh 消息
-     * @param node
+     * 深度
      */
-    refresh(node: ListNode): void;
-    walk(f: (node: ListNode) => boolean): boolean;
-    walkPrev(node: ListNode, f: (node: ListNode) => boolean): boolean;
-    get data(): any[];
-    private _data;
-}
-
-declare class DictIterator {
-    break(): void;
-    isBreak(): boolean;
-    protected _isBreak: any;
-}
-declare class Dictionary<K = string, V = any> {
-    constructor(data?: any);
-    reset(data: any): void;
-    protected _reset(data: any, size?: number): void;
-    getData(): any;
+    get depth(): number;
+    private _depth;
     /**
-     * 如果使用了 onSet or onDelete，需要注意清理
+     * 父节点
      */
-    clear(): void;
+    parent: TreeNode;
     /**
-     * 克隆自身所有项到【target】对象，并返回【target】对象
-     * @param target
+     * 子节点
      */
-    clone(target: this): this;
-    resetByDict(dict: Dictionary): void;
-    onSet(caller: any, handler: (key: K, value: V) => void): void;
-    onDelete(caller: any, handler: (key: K, value: V) => void): void;
+    children: TreeNode[];
     /**
-     * 设置键值对，如果没有发生变化，不会触发onSet函数
-     * @param key
-     * @param value
+     * 设置根
+     * @param val
      */
-    set(key: K, value: V): void;
-    private setData;
-    setByMap(m: any): void;
-    addDictionary(other: Dictionary<K, V>): void;
-    deleteDictionary(other: Dictionary<K, V>): void;
+    setRoot(val: TreeRoot): void;
+    getTags(): {
+        [key: string]: any;
+    };
+    getTag(name: string): any;
+    removeTag(name: string): void;
+    setTag(name: string, value: any): void;
+    constructor(id: string, isLeaf?: boolean);
+    addChild(val: TreeNode): void;
+    getChildIndex(val: TreeNode): number;
+    insertChild(val: TreeNode, index: number): void;
+    removeChild(val: TreeNode): void;
+    removeChildren(): void;
+    get name(): string;
+    setDepth(val: number): void;
+    containsById(id: string): boolean;
     /**
-     * 如果不存在，返回 undefined
-     * @param key
+     * 通过编号获取子节点
+     * @param id
      */
-    get(key: K): V;
-    exist(key: K): boolean;
-    delete(key: K): void;
-    private deleteData;
-    exists(key: K): boolean;
-    length(): number;
-    pop(key: K): [V, boolean];
-    isEmpty(): boolean;
-    items(): V[];
-    keys(): K[];
+    getChildById(id: string): TreeNode;
     /**
-     *
-     * @param handler 可以使用【iterator】中断遍历
-     * @return iterator 获取是否中断了
+     * 返回相邻的上一个节点
      */
-    forEach(handler: (key: K, val: V, iterator: DictIterator) => void): DictIterator;
+    prevNode(): TreeNode;
     /**
+     * 返回相邻的下一个节点
      */
-    first(): V | undefined;
+    nextNode(): TreeNode;
     /**
-     * @param handler 返回true结束迭代
+     * 如果返回true则删除节点，包含当前节点
+     * @param f
      */
-    firstByCondition(handler: (key: K, val: V) => boolean): V | undefined;
+    walkRemove(f: (node: TreeNode) => boolean): void;
+    private _walkRemove;
     /**
-     * 移除符合条件的项
-     * @param cond 可以使用【iterator】中断遍历
+     * 如果返回true则继续，包含当前节点
+     * @param f
+     * @param inChild
      */
-    removeByCondition(cond: (key: K, val: V, iterator: DictIterator) => boolean): void;
+    walk(f: (node: TreeNode) => boolean, inChild?: (node: TreeNode) => boolean): void;
+    private _walk;
     /**
-     * 查找符合条件的项保存到【target】对象中，并返回【target】对象
-     * @param cond 可以使用【iterator】中断遍历
-     * @param target 存到目标对象中
+     * 从当前节点（包括）遍历父节点链，包含当前节点
+     * @param f
      */
-    findByCondition(cond: (key: K, val: V, iterator: DictIterator) => boolean, target: Dictionary): this;
-    groupByCondition(createKey: (key: K, val: V) => string, ITEM_CLASS?: any): {
-        [key: string]: any;
-    };
-    protected size: number;
-    private _data;
-    private _onSet;
-    private _onDelete;
-    private _onSetCaller;
-    private _onDeleteCaller;
-}
-
-declare class DictNode {
-    static create(id: string, data?: any): DictNode;
-    constructor();
-    uuid: string;
-    id: string;
-    data: any;
-    tags: {};
-    getTags(): {
-        [key: string]: any;
-    };
-    getTag(name: string): any;
-    setTag(name: string, value: any): void;
+    walkParent(f: (node: TreeNode) => boolean): boolean;
     /**
-     * 清理【data】和【tags】
+     * 从当前节点往前遍历（深度），包含当前节点
+     * @param f
+     * @param inChild
      */
-    clean(): void;
-}
-declare class DictSource extends Dictionary<string, DictNode> {
+    walkPrev(f: (node: TreeNode) => boolean, inChild?: (node: TreeNode) => boolean): any;
+    private _walkPrev;
+    dump(): void;
     /**
-     * 刷新数据节点
-     * dispatchParams = {node:ListNode}
+     * 遍历节点，查找指定编号的节点
      */
-    static EVENT_REFRESH: string;
+    findById(id: string): TreeNode;
     /**
-     * 设置数据时触发
-     * dispatchParams = {node:ListNode, tag:string, value:any}
+     * 如果返回true则继续
+     * @param f
      */
-    static EVENT_TAGS_SET: string;
-    setNodeTags(node: DictNode, tag: string, value: any): void;
-    refreshNode(node: DictNode): void;
-    get dispatcher(): EventManager;
-    protected _dispatcher: EventManager;
-}
-
-declare class ListIterator {
-    break(): void;
-    isBreak(): boolean;
-    protected _isBreak: any;
-}
-declare class List<T = any> {
-    constructor();
-    onSet(caller: any, handler: (value: T) => void): void;
-    onDelete(caller: any, handler: (value: T) => void): void;
-    firstByCondition(conf: (index: number, item: T) => boolean): [number, T];
-    lastByCondition(conf: (index: number, item: T) => boolean): [number, T];
-    forEach(handler: (index: number, item: T, iterator: ListIterator) => void): ListIterator;
+    findOne(f: (node: TreeNode) => boolean): TreeNode;
+    private _findOne;
     /**
-     * 移除符合条件的项, 从后往前遍历
-     * @param cond 可以使用【iterator】中断遍历
-     * @param removedList 设置后，可获得被移除的项
+     * 通过路径获取节点
+     * 格式为 /path1/path2/...
+     * 如果 path == "/"，则返回自身
+     * @param path
      */
-    removeByCondition(cond: (index: number, val: T, iterator: ListIterator) => boolean, removedList?: List): this;
+    getNodeByPath(path: string): TreeNode;
+    protected getNodeByPathArr(pathArr: string[]): TreeNode;
+    getName(): string;
+    getPath(): string;
     /**
-     * 查找符合条件的项保存到【target】对象中，并返回【target】对象
-     * @param cond 可以使用【iterator】中断遍历
-     * @param target 存到目标对象中
+     * 如果返回true则继续
+     * @param f
      */
-    findByCondition(cond: (index: number, val: T, iterator: ListIterator) => boolean, target: List): this;
-    pop(): T;
-    shift(): T;
-    first(): T;
-    last(): T;
-    removeAt(index: number): void;
-    remove(item: T): void;
+    find(f: (node: TreeNode) => boolean): TreeNode[];
+    private _find;
+    toRoot(): TreeRoot;
+    clone(): TreeNode;
+    protected cloneChildrenTo(node: TreeNode): void;
+    fixDepthAndRoot(depth: number, root: TreeRoot): void;
+    toString(): string;
+}
+declare class TreeRoot<NODE = any> extends EventManager {
     /**
-     * 把【other】的项合并到自身
-     * @param other
+     * 添加数据节点
+     * dispatchParams = {node:TreeNode, parent:TreeNode|TreeRoot}
      */
-    removeList(other: List<T>): void;
-    sort(compareFn?: (a: T, b: T) => number): void;
-    reverse(): void;
-    clear(): void;
+    static EVENT_ADD: string;
     /**
-     * 克隆自身所有项到【target】对象，并返回【target】对象
-     * @param target
+     * 移除数据节点
+     * dispatchParams = {node:TreeNode, parent:TreeNode|TreeRoot}
      */
-    clone(target: this): this;
-    get length(): number;
-    insertAt(index: number, ...item: T[]): void;
+    static EVENT_REMOVE: string;
     /**
-     * @param beforeItem
-     * @param item
+     * 插入数据节点
+     * dispatchParams = {node:TreeNode, before:TreeNode}
      */
-    insertBefore(beforeItem: T, ...item: T[]): void;
+    static EVENT_INSERT: string;
     /**
-     * @param afterItem
-     * @param item
+     * 刷新数据节点
+     * dispatchParams = {node:TreeNode}
      */
-    insertAfter(afterItem: T, ...item: T[]): void;
-    at(index: number): T;
-    set(index: number, item: T): void;
-    indexOf(item: T): number;
-    has(item: T): boolean;
-    push(item: T): void;
+    static EVENT_REFRESH: string;
     /**
-     * 把【other】的项合并到自身
-     * @param other
+     * 设置数据时触发
+     * dispatchParams = {node:TreeNode}
      */
-    pushList(other: List<T>): void;
-    getData(): T[];
-    resetData(val: T[]): void;
+    static EVENT_DATA_SET: string;
     /**
-     * 随机获取【count】个项，并返回【target】对象
-     * @param count
-     * @param enableRepeat 允许重复
-     * @param target
+     * 设置数据时触发
+     * dispatchParams = {node:TreeNode, tag:string, value:any}
      */
-    random(count: number, enableRepeat?: boolean, target?: List<T>): List<T>;
-    protected callPush(value: any): void;
-    protected callRemove(value: any): void;
-    protected _data: any[];
-    private _onSet;
-    private _onDelete;
-    private _onSetCaller;
-    private _onDeleteCaller;
-}
-
-declare class UIObjectDict extends Dictionary<string, any | List> {
+    static EVENT_TAGS_SET: string;
+    static create(): TreeRoot<any>;
     /**
-     * 获取唯一的
-     * @param prefab
+     * 通过列表生成一个树结构
+     * @param items
+     * @param existed 列表将添加的已经存在的树结构
      */
-    uniqueObject(prefab: Prefab): Node;
-    removeObject(prefab: Prefab): void;
-    popObject(prefab: Prefab): any;
-    backObject(object: Node): void;
-    protected getList(key: any): List;
-}
-declare var uidict: UIObjectDict;
-
-declare class ViewController extends Component {
-    constructor(name: string);
-    open(...args: any[]): void;
-    close(): void;
-    get objectDict(): UIObjectDict;
-    protected _objectDict: UIObjectDict;
-}
-declare class ControllerDict extends Dictionary<string, ViewController> {
-    getByName(name: string): ViewController;
-    register(controller: ViewController): void;
-}
-declare var ctrlrepo: ControllerDict;
-
-declare class PageController extends ViewController {
-    constructor(routeName: string, config?: {
-        layer?: string;
-        tags?: string[];
-        enableHistory?: boolean;
-    });
-    protected onOpening(page: Page): void;
-    protected onOpened(page: Page): void;
-    protected onClosing(page: Page): void;
-    protected onClosed(page: Page): void;
-    protected onRefresh(page: Page): void;
-    openByRoute(route: Route): Page;
-    private openPage;
-    openComplete(page: Page): void;
-    closeByRoute(route?: Route): Page;
-    private closePage;
-    closeComplete(page: Page): void;
-    refresh(): void;
-    get layer(): string;
-    hasTags(tags: string[]): boolean;
-    setLayer(name: string): this;
-    setTags(tags: string[]): this;
-    get lastPage(): Page;
-    get route(): Route;
-    get enableHistory(): boolean;
-    protected _enableHistory: boolean;
-    protected _route: Route;
-    protected _lastPage: Page;
-    protected _tags: {};
-    protected _layer: string;
-}
-
-declare enum PageState {
+    static createByList(items: ITreeListItem[], existed?: TreeRoot): TreeRoot;
+    static sortChildrenByName(node: TreeNode, des?: boolean): void;
+    constructor();
+    setNodeData(node: TreeNode, data: any): void;
+    setNodeTags(node: TreeNode, tag: string, value: any, force?: boolean): void;
+    getNodeByPath(path: string): TreeNode;
+    makeNodeByPath(path: string): TreeNode;
     /**
-     * 关闭
+     * 添加节点，按照 node.path 添加到正确的位置
+     * @param node
+     * @param parentPath 如果父节点路径为 "", 则添加到起源节点
+     * @param autoCreateParent 如果父节点不存在，自动创建
      */
-    Closed = 0,
+    addNode(node: TreeNode, parentPath?: string, autoCreateParent?: boolean): void;
+    removeNode(node: TreeNode): void;
+    removeChildren(node: TreeNode): void;
+    insertNode(node: TreeNode, before: TreeNode, resetId?: boolean): void;
+    walk(f: (node: TreeNode) => boolean, inChild?: (node: TreeNode) => boolean): void;
+    walkPrev(f: (node: TreeNode) => boolean, inChild?: (node: TreeNode) => boolean): void;
     /**
-     * 正在打开
+     * 派发 refresh 消息
+     * @param node
      */
-    Opening = 1,
+    refresh(node: TreeNode): void;
     /**
-     * 已打开
+     * 克隆当前的树结
+     * * 新的tags克隆旧的data
+     * * 新的data指向旧的data
      */
-    Opened = 2,
+    clone(): TreeRoot;
+    toString(): string;
+    createNode(id: string, isLeaf?: boolean): TreeNode;
     /**
-     * 正在关闭
+     * origin的第一个child
      */
-    Closeing = 3
+    get firstNode(): TreeNode;
+    origin: TreeNode;
 }
-declare enum PageEvent {
-    Opening = "opening",
-    Opened = "opened",
-    Closeing = "closeing",
-    Closed = "closed",
-    Stop = "stop"
+declare class TreeRootPlugin {
+    root: TreeRoot;
 }
-declare class Page extends EventManager {
-    constructor(controller: PageController, route: Route);
+declare class TreeNodePlugin {
+    node: TreeNode;
+}
+
+interface IListItem {
     /**
-     * 等待打开完成指令
+     * 编号
      */
-    waitOpenComplete(): void;
-    waitCloseComplete(): void;
-    openComplete(): void;
-    closeComplete(): void;
-    stop(reason: LinkError): void;
+    id: string;
     /**
-     * 等待发送的结果
-     * 如果返回 null，表示主动取消 [cancel]
+     * 自定义数据
      */
-    wait(): Promise<this>;
-    toString(): string;
-    get objectDict(): UIObjectDict;
-    protected _objectDict: UIObjectDict;
-    protected _waitOpenComplete: boolean;
-    protected _waitCloseComplete: boolean;
-    get controller(): PageController;
-    get route(): Route;
-    cache: {};
-    tags: {};
-    layer: string;
-    state: PageState;
-    protected _controller: PageController;
-    protected _route: Route;
-}
-
-/**
- * 视图管理器
- * 打开一个视图的时候，可能会听过加载资源，读取数据，调整布局，切换特效等处理，所以使用视图模式封装视图打开关闭的逻辑
- */
-declare class PageLayer {
-    name: string;
-    constructor(name: string);
-    close(): void;
+    data?: any;
     /**
-     * 当前的页面
+     * 功能性标签，用于开发组件时，记录组件的状态。例如title, icon, 显示树的组件，需要 expanded，selected标签
      */
-    currentPage: Page;
-}
-
-declare class PageList extends List<Page> {
+    tags?: {
+        [key: string]: any;
+    };
 }
-declare class PageRepo extends PageList {
+declare class ListNode {
+    static create(id: string, data?: any): ListNode;
     constructor();
-    openByString(route: string): Page;
+    root: ListSource;
+    uuid: string;
+    id: string;
+    data: any;
+    tags: {};
+    getTags(): {
+        [key: string]: any;
+    };
+    setTags(tags: {
+        [key: string]: any;
+    }): void;
+    getTag(name: string): any;
+    setTag(name: string, value: any): void;
+}
+declare class ListSource extends EventManager {
     /**
-     * 打开页面
-     * 一个路由代表一个页面
-     * @param route
+     * 通过数组创建 ListSource。ListSource的id自动生成。如果需要指定编号，可设置 idCreator
+     * @param arr
+     * @param idCreator
      */
-    open(route: Route): Page;
-    close(route: Route): void;
+    static createByArray(arr: any[], idCreator?: (item: any) => string): ListSource;
+    static createByListItem(arr: IListItem[], target?: ListSource): any;
     /**
-     * 如果页面存在，则刷新
-     * @param route
+     * 设置数据时触发
+     * dispatchParams = {node:ListNode}
      */
-    refresh(route: Route): void;
+    static EVENT_ADD: string;
     /**
-     * 历史记录
+     * 设置数据时触发
+     * dispatchParams = {node:ListNode, index:number}
      */
-    getHistory(): Route[];
-    back(): void;
-    getByRoute(route: Route): Page;
-    listByTags(tags: string[]): PageList;
-    getLayerMain(): PageLayer;
+    static EVENT_REMOVE: string;
     /**
-     * @param name
+     * 设置数据时触发
      */
-    getLayer(name: string): PageLayer;
-    protected getOrNewLayer(name: string): PageLayer;
-    getController(route: Route): PageController;
-    get objectDict(): UIObjectDict;
-    protected _objectDict: UIObjectDict;
-    protected _indexLayer: {};
-    protected _indexRoute: {};
-    protected _history: Route[];
-}
-declare const pagerepo: PageRepo;
-
-/**
- * 事件字符串分隔符
- */
-
-/**
- * 回调列表
- */
-declare class CallbackList<PARAMS = any> {
-    constructor();
-    addListener(listener: Listener): void;
-    removeListener(listener: Listener): void;
+    static EVENT_REMOVE_ALL: string;
     /**
+     * 刷新数据节点
+     * dispatchParams = {node:ListNode}
      */
-    create(): Listener<PARAMS>;
+    static EVENT_REFRESH: string;
     /**
-     * 如果监听器已经不存在，则创建
-     * @param ident
+     * 设置数据时触发
+     * dispatchParams = nodes: [ListNode], indexs: [number]
      */
-    createByIdent(ident: any): Listener<PARAMS>;
-    removeByIdent(ident: any): void;
-    removeByCaller(caller: any): void;
-    getByIdent(ident: any): Listener;
+    static EVENT_SWAP: string;
     /**
-     * 派发事件
-     * @param params 事件参数
-     * @param subIdent
+     * 设置数据时触发
+     * dispatchParams = {node:ListNode, data:any}
      */
-    dispatch(params?: PARAMS, subIdent?: string): void;
-    protected _data: List<Listener<any>>;
-    protected _indexIdent: {};
-}
-
-declare class Listener<PARAMS = any> {
-    static create(ident?: string): Listener<any>;
-    constructor(ident?: string);
-    getCaller(): any;
-    setCaller(caller: any): this;
-    setSubIdent(val: string): this;
-    setCondition(condition: (listener: Listener<PARAMS>) => boolean): this;
-    setHandler(handler: (listener: Listener<PARAMS>) => void): this;
-    setOnParams(val: any): this;
-    getIdent(): string;
-    on(): this;
-    off(): this;
-    isOn(): boolean;
-    remove(): void;
+    static EVENT_DATA_SET: string;
     /**
-     * 内部使用
-     * @param params
-     * @param subIdent 子编号
+     * 设置数据时触发
+     * dispatchParams = {node:ListNode, tag:string, value:any}
      */
-    _dispatch(params: PARAMS, subIdent?: string): void;
-    getOnParams(): any;
-    getParams(): PARAMS;
-    protected onParams: any;
-    protected params: PARAMS;
-    protected ident: string;
-    protected _subIdent: string;
-    protected source: CallbackList;
-    protected _handler: (any: any) => void;
-    protected _condition: (any: any) => boolean;
-    protected caller: any;
-    protected _isOn: boolean;
-}
-
-/**
- * 事件字符串分隔符
- */
-
-/**
- * 事件派发器
- */
-declare class Dispatcher implements ISchedulable {
-    constructor(name?: string);
-    dispose(): void;
-    create(type: string, listener: Listener): void;
-    remove(type: string, listener: Listener): void;
-    getByIdent(type: string, ident: string): Listener;
+    static EVENT_TAGS_SET: string;
+    protected _identFunc: (node: ListNode) => boolean;
+    at(index: number): ListNode;
+    first(): ListNode;
+    last(): ListNode;
+    length(): number;
     /**
-     * @param type
-     * @param ident
+     * 添加项，无法添加相同的项
+     * @param node
+     * @param enableDispatch 默认为true
      */
-    createByIdent(type: string, ident: string): Listener;
+    add(node: ListNode, enableDispatch?: boolean): void;
+    getById(id: string): ListNode;
+    remove(node: ListNode): void;
+    removeAll(): void;
+    swap(a: ListNode, b: ListNode): void;
+    contains(node: ListNode): boolean;
+    containsById(id: string): boolean;
+    indexOf(node: ListNode): number;
+    indexOfById(id: string): number;
+    setData(node: ListNode, data: any): void;
+    setNodeTags(node: ListNode, tag: string, value: any): void;
     /**
-     * 派发事件
-     * @param eventType 事件类型
-     * @param params 事件参数
+     * 派发 refresh 消息
+     * @param node
      */
-    dispatch(eventType: string, params?: any): void;
-    protected getList(type: string): CallbackList;
-    id?: string;
-    uuid?: string;
-    name: string;
-    protected isDispose: boolean;
-    protected typeToList: Dictionary<string, CallbackList<any>>;
+    refresh(node: ListNode): void;
+    walk(f: (node: ListNode) => boolean): boolean;
+    walkPrev(node: ListNode, f: (node: ListNode) => boolean): boolean;
+    get data(): any[];
+    private _data;
 }
 
-declare class CallbackItem {
-    listener: Function;
-    caller: any;
-    once: boolean;
-}
-declare class SampleCallbackList {
+declare class DictNode {
+    static create(id: string, data?: any): DictNode;
     constructor();
-    dispose(): void;
-    has(caller: any, listener: Function): boolean;
-    protected getItem(caller: any, listener: Function): CallbackItem;
+    uuid: string;
+    id: string;
+    data: any;
+    tags: {};
+    getTags(): {
+        [key: string]: any;
+    };
+    getTag(name: string): any;
+    setTag(name: string, value: any): void;
     /**
-     * 监听事件，如果监听已经存在则返回
-     * @param caller
-     * @param listener 为了性能考虑， event使用了对象池处理。因此处理函数不应该保存event的引用。如有需要，可通过新建对象或Event.Clone()实现
+     * 清理【data】和【tags】
      */
-    on(caller: any, listener: (ctx: this, params?: any) => void): CallbackItem;
-    once(caller: any, listener: (ctx: this, params?: any) => void): CallbackItem;
-    protected offItem(item: CallbackItem): void;
-    off(caller: any, listener: Function): void;
-    offAll(type?: string): void;
-    offAllCaller(caller: any): void;
+    clean(): void;
+}
+declare class DictSource extends Dictionary<string, DictNode> {
     /**
-     * 派发事件
-     * @param params 事件参数
+     * 刷新数据节点
+     * dispatchParams = {node:ListNode}
      */
-    dispatch(params?: any): void;
-    protected _callbackItems: CallbackItem[];
-}
-
-declare class AssetURI {
-    name: string;
-    constructor(name: string);
-    loadType: number;
-    uuid: string;
-    path: string;
-    bundle: string;
-}
-declare class XAssetManager {
-    getAsset(uri: string): any;
-    getAssetByUUID(uuid: string): any;
-    getRoot(): AssetManager;
+    static EVENT_REFRESH: string;
+    /**
+     * 设置数据时触发
+     * dispatchParams = {node:ListNode, tag:string, value:any}
+     */
+    static EVENT_TAGS_SET: string;
+    setNodeTags(node: DictNode, tag: string, value: any): void;
+    refreshNode(node: DictNode): void;
+    get dispatcher(): EventManager;
+    protected _dispatcher: EventManager;
 }
-declare let assetx: XAssetManager;
 
 declare class LoaderItem {
     onComplete?: (err: any, asset: any) => void;
@@ -1507,34 +1509,91 @@ declare class Pool {
      */
     disposeObject(obj: any): void;
     /**
-     * 释放对象池
+     * 释放对象池
+     */
+    dispose(): void;
+}
+/**
+ * 对象池
+ */
+declare class SamplePool {
+    list: any[];
+    constructor();
+    /**
+     * 获取一个对象
+     */
+    get(): any;
+    /**
+     * 回收一个对象
+     * @param obj
+     */
+    put(obj: any): void;
+}
+/**
+ * 对象池
+ */
+declare class SamplePoolSet {
+    get(name: string): any;
+    put(name: string, item: any): void;
+    protected pools: {};
+}
+
+declare class ArrayUtil {
+    lastItem(array: any[]): any;
+    unique(array: any[]): any[];
+    removeSelf(arr: any[], item: any): void;
+    /**
+     *
+     * @param arr
+     * @param desc 降序
+     */
+    sortNumber(arr: any[], desc?: boolean): any[];
+    sortString(arr: any[], desc?: boolean): any[];
+    getByPath(target: any, key: string): any;
+    sortObject(arr: any[], desc: boolean, ...paths: string[]): any[];
+    sortBySeq(arr: any[], desc: boolean, seq: {
+        [key: string]: number;
+    }, key?: string): any[];
+    indexOfConf(arr: any[], caller: any, f: (item: any) => boolean): number;
+}
+declare const arrayutil: ArrayUtil;
+
+declare class BitUtil {
+    getState(state: number, key: number): boolean;
+    setState(state: number, key: number, value: boolean): number;
+    /**
+     * @param state
+     * @param key
      */
-    dispose(): void;
-}
-/**
- * 对象池
- */
-declare class SamplePool {
-    list: any[];
-    constructor();
+    getStateBig(state: bigint, key: bigint): boolean;
+    setStateBig(state: bigint, key: bigint, value: boolean): bigint;
     /**
-     * 获取一个对象
+     * key从0开始
+     * @param val
      */
-    get(): any;
+    convertToState(val: {
+        [key: string]: boolean;
+    }): number;
     /**
-     * 回收一个对象
-     * @param obj
+     * 判断是否匹配
+     * @param target
+     * @param match 0-返回true
      */
-    put(obj: any): void;
+    match(target: number, match: number): boolean;
 }
-/**
- * 对象池
- */
-declare class SamplePoolSet {
-    get(name: string): any;
-    put(name: string, item: any): void;
-    protected pools: {};
+declare const bitutil: BitUtil;
+
+declare class CameraUtil {
+    getUICamera(): Camera;
+}
+declare let camerautil: CameraUtil;
+
+declare class CanvasUtil {
+    getCanvas(): Canvas;
+    protected onSceneDestroyed(event: any): void;
+    _canvas: Canvas;
 }
+declare let canvasutil: CanvasUtil;
 
 declare class ConvertUtil {
     anyToBoolean(val: any, defaultValue?: boolean): boolean;
@@ -1550,6 +1609,97 @@ declare class ConvertUtil {
 }
 declare const convertutil: ConvertUtil;
 
+declare class DocUtil {
+    copyToClip(value: string): boolean;
+    selectText(textbox: any, startIndex: any, stopIndex: any): void;
+}
+declare var docutil: DocUtil;
+
+declare class EventUtil {
+}
+/**
+ * 框架的事件
+ */
+declare const eventutil: EventUtil;
+
+declare class FloatUtil {
+    epsilon: number;
+    neq(a: number, b: number, threshold?: number): boolean;
+    eq(a: number, b: number, threshold?: number): boolean;
+    gt(a: number, b: number, threshold?: number): boolean;
+    lt(a: number, b: number, threshold?: number): boolean;
+    geq(a: number, b: number, threshold?: number): boolean;
+    leq(a: number, b: number, threshold?: number): boolean;
+}
+declare let floatutil: FloatUtil;
+
+declare namespace formatutil {
+    /**
+     * 格式化数字
+     * @param format 第nn天
+     * @param val
+     */
+    function toChinese(formatter: string, val: number): string;
+    /**
+     * 转换为 x亿x万
+     * @param val
+     */
+    function format数字使用万亿(val: number | string): string;
+    /**
+     * 格式化货币，每N位增加一个逗号识别
+     * @param val
+     * @param N
+     */
+    function format数字使用逗号(val: number | string, N?: number): string;
+}
+
+declare enum GeometryDirection {
+    East = 0,
+    SouthEast = 1,
+    South = 2,
+    SouthWest = 3,
+    West = 4,
+    NorthWest = 5,
+    North = 6,
+    NorthEast = 7
+}
+declare class GeometryUtil {
+    /**
+     *  mode，8表示八方向，2表示二方向(左右），4表示4方向
+     * @param dot
+     * @param mode
+     */
+    angleToDirection(dot: number, mode?: number): GeometryDirection;
+}
+declare let geoutil: GeometryUtil;
+
+declare class IdentUtil {
+    /**
+     * 设置时间的基线，通过减去已经过去的时间，可缩短id长度
+     * 注：同一个项目必须拥有同样的基线，否则有几率出现相同的id！
+     * 注2：基线必须与精度符合
+     * @param time
+     */
+    setTimeBaseline(time: number): void;
+    protected _baseline: number;
+    /**
+     * 设置时间的精度
+     * @param precision
+     */
+    setTimePrecision(precision: "ms" | "s"): void;
+    protected _precision: string;
+    /**
+     * 设置随机数的长度
+     * @param value
+     */
+    setRandLength(value?: number): void;
+    protected _randLength: number;
+    genOne(): string;
+    protected _count: number;
+    protected _lastTime: number;
+}
+declare const identutil: IdentUtil;
+
 declare class MapUtil {
     /**
      * 获取所欲的值
@@ -1607,212 +1757,94 @@ declare class MapUtil {
      * 返回第一个符合条件的key
      * @param m
      * @param conf
-     */
-    keyOfConf(m: any, conf: (key: string, item: any) => boolean): string;
-    /**
-     * 比较对象，并返回包含差异的对象
-     * 如果返回 undefined 表示没有差异
-     * @param obj
-     * @param parent
-     * @param removeDefault
-     */
-    diff(obj: any, parent: any, removeDefault?: boolean): any;
-    /**
-     * 克隆对象
-     * @param obj
-     */
-    clone(obj: any): any;
-    /**
-     * 通过path设置属性，创建不存在的路径对象
-     * @param obj
-     * @param path "/key1/key2"
-     * @param data
-     */
-    setByPath(obj: any, path: string, data: any): void;
-    /**
-     * 通过path删除
-     * @param obj
-     * @param path "/key1/key2"
-     */
-    removeByPath(obj: any, path: string): void;
-    /**
-     * 通过path获取属性
-     * @param obj
-     * @param path
-     */
-    getByPath(obj: any, path: string): any;
-    flat(obj: any, split?: string): any;
-    _flat(obj: any, result: any, path: string, split?: string): any;
-    /**
-     * 比较两个对象，包括基础类型
-     * @param a
-     * @param b
-     */
-    compare(a: any, b: any): boolean;
-    /**
-     * 从[from]对象复制到 [to]对象
-     * 如果from字段为object并且等于null,则设置to字段为null
-     * 如果from字段为undefined, 则不覆盖
-     * @param from
-     * @param to
-     * @param tokey 如果[to]存在key才进行拷贝
-     */
-    copy(from: any, to: any, tokey?: boolean): void;
-    /**
-     * 去掉兼职
-     */
-    flatString(target: any): string;
-}
-declare const maputil: MapUtil;
-
-declare class UIUtil {
-    /**
-     * 格式化节点的uuid，用于树结构
-     * 树结构的路径的反斜杠与uuid有冲突
-     * @param uuid
-     */
-    formatUUIDForTree(uuid: string): string;
-    /**
-     * x, y 使用 鼠标点击事件产生的 event.getLocation()坐标
-     * @param target
-     * @param x
-     * @param y
-     */
-    hitTest(target: Node, x: number, y: number): boolean;
-    findNode(node: Node, name: string): Node;
-    walk(node: Node, f: (target: Node) => boolean): void;
-    _walk(node: Node, f: (target: Node) => boolean): boolean;
-}
-declare const uiutil: UIUtil;
-
-declare class EventUtil {
-}
-/**
- * 框架的事件
- */
-declare const eventutil: EventUtil;
-
-declare class NetUtil {
-    decodeLocationSearch(search: string): any;
-    encodeLocationSearch(params: any, firstChat?: "" | "?" | "&"): string;
-    getLocation(): Location;
-    /**
-     * 获取Loation的参数
-     */
-    getLocationParams(): any;
-}
-declare const netutil: NetUtil;
-
-declare class ArrayUtil {
-    lastItem(array: any[]): any;
-    unique(array: any[]): any[];
-    removeSelf(arr: any[], item: any): void;
-    /**
-     *
-     * @param arr
-     * @param desc 降序
-     */
-    sortNumber(arr: any[], desc?: boolean): any[];
-    sortString(arr: any[], desc?: boolean): any[];
-    getByPath(target: any, key: string): any;
-    sortObject(arr: any[], desc: boolean, ...paths: string[]): any[];
-    sortBySeq(arr: any[], desc: boolean, seq: {
-        [key: string]: number;
-    }, key?: string): any[];
-    indexOfConf(arr: any[], caller: any, f: (item: any) => boolean): number;
-}
-declare const arrayutil: ArrayUtil;
-
-declare class ScaleUtil {
-    tenToAny: string[];
-    allstr: string;
-    randString(size: number, n: number): string;
-    decimalTo(num: number, n: number): string;
-    findkey(instr: string): number;
-    toDecimal(num: string, n: number): number;
-}
-declare const scaleutil: ScaleUtil;
-
-declare class BitUtil {
-    getState(state: number, key: number): boolean;
-    setState(state: number, key: number, value: boolean): number;
+     */
+    keyOfConf(m: any, conf: (key: string, item: any) => boolean): string;
     /**
-     * @param state
-     * @param key
+     * 比较对象，并返回包含差异的对象
+     * 如果返回 undefined 表示没有差异
+     * @param obj
+     * @param parent
+     * @param removeDefault
      */
-    getStateBig(state: bigint, key: bigint): boolean;
-    setStateBig(state: bigint, key: bigint, value: boolean): bigint;
+    diff(obj: any, parent: any, removeDefault?: boolean): any;
     /**
-     * key从0开始
-     * @param val
+     * 克隆对象
+     * @param obj
      */
-    convertToState(val: {
-        [key: string]: boolean;
-    }): number;
+    clone(obj: any): any;
     /**
-     * 判断是否匹配
-     * @param target
-     * @param match 0-返回true
+     * 通过path设置属性，创建不存在的路径对象
+     * @param obj
+     * @param path "/key1/key2"
+     * @param data
      */
-    match(target: number, match: number): boolean;
-}
-declare const bitutil: BitUtil;
-
-declare class StringUtil {
-    lowerFirst(key: string): string;
-    upperFirst(key: string): string;
-    cjkEncode(text: any): string;
-    replaceFormat(format: string, source: any): string;
+    setByPath(obj: any, path: string, data: any): void;
     /**
-     *
-     * @param format
-     * @param source
+     * 通过path删除
+     * @param obj
+     * @param path "/key1/key2"
      */
-    evalFormat(format: string, source: any): string;
-    splitLast(val: string, separator: string): string;
+    removeByPath(obj: any, path: string): void;
     /**
-     * 从最后一个分隔符截断字符串，返回截断的左右字符串
-     * @param val
-     * @param separator
+     * 通过path获取属性
+     * @param obj
+     * @param path
      */
-    splitLastArray(val: string, separator: string): [string, string];
+    getByPath(obj: any, path: string): any;
+    flat(obj: any, split?: string): any;
+    _flat(obj: any, result: any, path: string, split?: string): any;
     /**
-     * 截断字符串
-     * @param val
-     * @param separator
-     * @return [最终的字符串, 被截断的字符串]
+     * 比较两个对象，包括基础类型
+     * @param a
+     * @param b
      */
-    truncateLast(val: string, separator: string): [string, string];
-    fill(str: string, char: string, length: number): string;
-}
-declare const stringutil: StringUtil;
-
-declare class IdentUtil {
+    compare(a: any, b: any): boolean;
     /**
-     * 设置时间的基线，通过减去已经过去的时间，可缩短id长度
-     * 注：同一个项目必须拥有同样的基线，否则有几率出现相同的id！
-     * 注2：基线必须与精度符合
-     * @param time
+     * 从[from]对象复制到 [to]对象
+     * 如果from字段为object并且等于null,则设置to字段为null
+     * 如果from字段为undefined, 则不覆盖
+     * @param from
+     * @param to
+     * @param tokey 如果[to]存在key才进行拷贝
      */
-    setTimeBaseline(time: number): void;
-    protected _baseline: number;
+    copy(from: any, to: any, tokey?: boolean): void;
     /**
-     * 设置时间的精度
-     * @param precision
+     * 去掉兼职
      */
-    setTimePrecision(precision: "ms" | "s"): void;
-    protected _precision: string;
+    flatString(target: any): string;
+}
+declare const maputil: MapUtil;
+
+declare class MathUtil {
+    version: number;
+    TempVec2: Vec2;
+    TempVec3: Vec3;
+    TempVec4: Vec4;
+    convertVec2to3(vec2: Vec2, useTemp?: boolean): Vec3;
+    convertVec3to2(vec3: Vec3, useTemp?: boolean): Vec2;
+    isOdd(value: number): boolean;
+}
+declare const mathutil: MathUtil;
+
+declare class NetUtil {
+    decodeLocationSearch(search: string): any;
+    encodeLocationSearch(params: any, firstChat?: "" | "?" | "&"): string;
+    getLocation(): Location;
     /**
-     * 设置随机数的长度
-     * @param value
+     * 获取Loation的参数
      */
-    setRandLength(value?: number): void;
-    protected _randLength: number;
-    genOne(): string;
-    protected _count: number;
-    protected _lastTime: number;
+    getLocationParams(): any;
 }
-declare const identutil: IdentUtil;
+declare const netutil: NetUtil;
+
+declare class PathUtil {
+    getDir(path: string): string;
+    getRelativePath(fromPath: string, toPath: string): string;
+    getSamePath(fromPath: string, toPath: string): string;
+    protected validatePath(path: string): void;
+    protected splitPath(path: string): string[];
+}
+declare const pathutil: PathUtil;
 
 declare class RandUtil {
     /**
@@ -1844,17 +1876,6 @@ declare class RandUtil {
 }
 declare const randutil: RandUtil;
 
-declare class MathUtil {
-    version: number;
-    TempVec2: Vec2;
-    TempVec3: Vec3;
-    TempVec4: Vec4;
-    convertVec2to3(vec2: Vec2, useTemp?: boolean): Vec3;
-    convertVec3to2(vec3: Vec3, useTemp?: boolean): Vec2;
-    isOdd(value: number): boolean;
-}
-declare const mathutil: MathUtil;
-
 declare class ResUtil {
     loadResource(path: string): Promise<[any, IError]>;
     preloadResource(path: string): Promise<[any, IError]>;
@@ -1867,6 +1888,48 @@ declare class ResUtil {
 }
 declare var resutil: ResUtil;
 
+declare function parsePlist(plist: any, texture: any): SpriteAtlas;
+declare function loadAtlas(url: any, callback: any): void;
+
+declare class ScaleUtil {
+    tenToAny: string[];
+    allstr: string;
+    randString(size: number, n: number): string;
+    decimalTo(num: number, n: number): string;
+    findkey(instr: string): number;
+    toDecimal(num: string, n: number): number;
+}
+declare const scaleutil: ScaleUtil;
+
+declare class StringUtil {
+    lowerFirst(key: string): string;
+    upperFirst(key: string): string;
+    cjkEncode(text: any): string;
+    replaceFormat(format: string, source: any): string;
+    /**
+     *
+     * @param format
+     * @param source
+     */
+    evalFormat(format: string, source: any): string;
+    splitLast(val: string, separator: string): string;
+    /**
+     * 从最后一个分隔符截断字符串，返回截断的左右字符串
+     * @param val
+     * @param separator
+     */
+    splitLastArray(val: string, separator: string): [string, string];
+    /**
+     * 截断字符串
+     * @param val
+     * @param separator
+     * @return [最终的字符串, 被截断的字符串]
+     */
+    truncateLast(val: string, separator: string): [string, string];
+    fill(str: string, char: string, length: number): string;
+}
+declare const stringutil: StringUtil;
+
 declare class TimeUtil {
     sleep(time: number): Promise<void>;
     /**
@@ -1883,68 +1946,104 @@ declare class TimeUtil {
 }
 declare const timeutil: TimeUtil;
 
-declare enum GeometryDirection {
-    East = 0,
-    SouthEast = 1,
-    South = 2,
-    SouthWest = 3,
-    West = 4,
-    NorthWest = 5,
-    North = 6,
-    NorthEast = 7
-}
-declare class GeometryUtil {
+declare class TreeUtil {
     /**
-     *  mode，8表示八方向，2表示二方向(左右），4表示4方向
-     * @param dot
-     * @param mode
+     * 保存指定标签[tag]的值等于[value]的节点
+     * @param root
+     * @param key 存储的键
+     * @param tag
+     * @param value
      */
-    angleToDirection(dot: number, mode?: number): GeometryDirection;
-}
-declare let geoutil: GeometryUtil;
-
-declare namespace formatutil {
+    saveTagToLocalStorage(root: TreeRoot, key: string, tag: string, value: any): void;
     /**
-     * 格式化数字
-     * @param format 第nn天
-     * @param val
+     * 从ls中加载指定标签[tag]的值还原到[root]。
+     * 返回localStorage是否存在键值
+     * @param root
+     * @param key
+     * @param tag
+     * @param value
      */
-    function toChinese(formatter: string, val: number): string;
+    loadTagFromLocalStorage(root: TreeRoot, key: string, tag: string, value: any): boolean;
+}
+declare var treeutil: TreeUtil;
+
+declare class UIUtil {
     /**
-     * 转换为 x亿x万
-     * @param val
+     * 格式化节点的uuid，用于树结构
+     * 树结构的路径的反斜杠与uuid有冲突
+     * @param uuid
      */
-    function format数字使用万亿(val: number | string): string;
+    formatUUIDForTree(uuid: string): string;
     /**
-     * 格式化货币，每N位增加一个逗号识别
-     * @param val
-     * @param N
+     * x, y 使用 鼠标点击事件产生的 event.getLocation()坐标
+     * @param target
+     * @param x
+     * @param y
      */
-    function format数字使用逗号(val: number | string, N?: number): string;
-}
-
-declare class FloatUtil {
-    epsilon: number;
-    neq(a: number, b: number, threshold?: number): boolean;
-    eq(a: number, b: number, threshold?: number): boolean;
-    gt(a: number, b: number, threshold?: number): boolean;
-    lt(a: number, b: number, threshold?: number): boolean;
-    geq(a: number, b: number, threshold?: number): boolean;
-    leq(a: number, b: number, threshold?: number): boolean;
+    hitTest(target: Node, x: number, y: number): boolean;
+    findNode(node: Node, name: string): Node;
+    walk(node: Node, f: (target: Node) => boolean): void;
+    _walk(node: Node, f: (target: Node) => boolean): boolean;
 }
-declare let floatutil: FloatUtil;
+declare const uiutil: UIUtil;
 
-declare class PathUtil {
-    getDir(path: string): string;
-    getRelativePath(fromPath: string, toPath: string): string;
-    getSamePath(fromPath: string, toPath: string): string;
-    protected validatePath(path: string): void;
-    protected splitPath(path: string): string[];
+declare class WidgetAlign {
+    node: Node;
+    targetNode: Node;
+    protected nodeWidget: Widget;
+    protected parentTransform: UITransform;
+    protected targetTransform: UITransform;
+    protected uipos: math.Vec3;
+    constructor(node: Node, targetNode: Node);
+    topTop(distance?: number): void;
+    topBottom(distance?: number): void;
+    leftleft(distance?: number): void;
+    leftRight(distance?: number): void;
+}
+declare class WidgetUtil {
+    /**
+     * 与目标顶对齐
+     * @param node 需要修改的节点
+     * @param parent 对齐的父节点
+     * @param distance
+     */
+    alignTop(node: Node, parent: Node, distance?: number): void;
+    /**
+     * 与目标顶对齐，node和target都必须在渲染树中
+     * @param node 需要修改的节点
+     * @param target 对齐目标
+     * @param distance
+     */
+    alignTopWorld(node: Node, target: Node, distance?: number): void;
+    /**
+     * 与目标顶对齐，node和target都必须在渲染树中
+     * @param node 需要修改的节点
+     * @param target 对齐目标
+     * @param distance
+     */
+    alignBottomWorld(node: Node, target: Node, distance?: number): void;
+    /**
+     * 调整【node】的widget，对齐【targetNode】
+     * @param node
+     * @param targetNode
+     */
+    align(node: Node, targetNode: Node): WidgetAlign;
+    /**
+     * 与目标右对齐
+     * @param node 需要修改的节点
+     * @param parent 对齐的父节点
+     * @param distance
+     */
+    alignLeft(node: Node, parent: Node, distance?: number): void;
+    /**
+     * 与目标右对齐
+     * @param node 需要修改的节点
+     * @param target 对齐目标
+     * @param distance
+     */
+    alignLeftWorld(node: Node, target: Node, distance?: number): void;
 }
-declare const pathutil: PathUtil;
-
-declare function parsePlist(plist: any, texture: any): SpriteAtlas;
-declare function loadAtlas(url: any, callback: any): void;
+declare var widgetutil: WidgetUtil;
 
-export { ArrayUtil, AssetLoader, AssetURI, BitUtil, CallbackList, Controller, ControllerDict, ControllerSet, ConvertUtil, DictIterator, DictNode, DictSource, Dictionary, Dispatcher, ErrorUtil, EventItem, EventManager, EventUtil, Factory, FloatUtil, GeometryUtil, IdentUtil, LOGGER_EVENT, LinkError, List, ListIterator, ListNode, ListSource, Listener, LogLevel, LogManager, Logger, MapUtil, MathUtil, Model, Module, NetUtil, Page, PageController, PageEvent, PageLayer, PageList, PageRepo, PageState, PathUtil, Pool, RandUtil, Route, SampleCallbackList, SamplePool, SamplePoolSet, ScaleUtil, SimpleModel, StringUtil, TimeUtil, Timer, TreeIterator, TreeNode, TreeNodePlugin, TreeRoot, TreeRootPlugin, UIManager, UIObjectDict, UIPoolConfig, UISingleConfig, UIUtil, ViewController, XAssetManager, XEvent, arrayutil, assetx, bitutil, convertutil, ctrlrepo, errorutil, eventmgr, eventutil, floatutil, formatutil, geoutil, identutil, loadAtlas, logmgr, maputil, mathutil, netutil, pagerepo, parseAtlas, parsePlist, pathutil, randutil, resutil, scaleutil, stringutil, timer, timeutil, uidict, uimgr, uiutil };
+export { ArrayUtil, AssetLoader, AssetURI, BitUtil, CallbackList, CameraUtil, CanvasUtil, Controller, ControllerSet, ConvertUtil, DictIterator, DictNode, DictSource, Dictionary, Dispatcher, DocUtil, ErrorUtil, EventItem, EventManager, EventUtil, Factory, FloatUtil, GeometryUtil, IdentUtil, LOGGER_EVENT, LinkError, List, ListIterator, ListNode, ListSource, Listener, LogLevel, LogManager, Logger, MapUtil, MathUtil, Model, Module, NetUtil, Page, PageController, PageControllerDict, PageEvent, PageLayer, PageList, PageRepo, PageState, PathUtil, Pool, RandUtil, Route, SampleCallbackList, SamplePool, SamplePoolSet, ScaleUtil, SimpleModel, StringUtil, TimeUtil, Timer, TreeIterator, TreeNode, TreeNodePlugin, TreeRoot, TreeRootPlugin, TreeUtil, UIManager, UIObjectDict, UIPoolConfig, UISingleConfig, UIUtil, ViewController, WidgetAlign, WidgetUtil, XAssetManager, XEvent, arrayutil, assetx, bitutil, camerautil, canvasutil, convertutil, docutil, errorutil, eventmgr, eventutil, floatutil, formatutil, geoutil, identutil, loadAtlas, logmgr, maputil, mathutil, netutil, pagerepo, parseAtlas, parsePlist, pathutil, randutil, resutil, scaleutil, stringutil, timer, timeutil, treeutil, uidict, uimgr, uiutil, widgetutil };
 export type { CreatorFunction, DisposeFunction, IController, IError, IEventManager, IExtend, IListItem, IModel, IModule, IModuleSample, ITreeListItem, RecycleFunction };