@cocos/cocos-cli-types 0.0.1-alpha.21.1 → 0.0.1-alpha.22.1

package/service.d.ts

@@ -0,0 +1,2344 @@
+import { default as cc_2 } from 'cc';
+import { Component } from 'cc';
+import { GeometryRenderer as GeometryRenderer_2 } from 'cc';
+import { Node as Node_2 } from 'cc';
+import { Scene } from 'cc';
+import { TransformBit } from 'cc';
+import { Vec3 as Vec3_2 } from 'cc';
+
+/** 动画剪辑资源的 userData */
+declare interface AnimationClipAssetUserData {
+    /** 动画名称 */
+    name: string;
+}
+
+declare interface AnimationImportSetting {
+    /**
+     * glTf 中原始动画资源的名称。
+     */
+    name: string;
+
+    /**
+     * 原始动画的长度，单位为秒。
+     */
+    duration: number;
+
+    /**
+     * 用户查看、切割原始动画时的 FPS 设定。
+     */
+    fps: number;
+
+    /**
+     * 对原始动画的划分，由用户配置。
+     * 若此资源存在，所有划分出的动画成为 glTf 资源下的独立动画并将被导出；
+     * 否则，直接导入原始动画资源。
+     */
+    splits: Array<{
+        /**
+         * 以前的 ID。如果存在，优先使用这个 ID 来创建子资源，以防止改名后 UUID 变化。
+         */
+        previousId?: string;
+
+        /**
+         * 划分出的动画的名称。
+         */
+        name: string;
+
+        /**
+         * 划分的起始时刻，单位为秒。
+         */
+        from: number;
+
+        /**
+         * 划分的终止时刻，单位为秒。
+         */
+        to: number;
+
+        /**
+         * 用户查看划分出的子动画时的 FPS 设定。
+         */
+        fps?: number;
+
+        /**
+         * 速度。
+         */
+        speed?: number;
+
+        /**
+         * 动画循环模式。
+         */
+        wrapMode?: number;
+
+        /**
+         * 额外的动画辅助曲线信息。
+         */
+        auxiliaryCurves?: Record<
+        string,
+            {
+            /**
+             * 序列化后的曲线。
+             */
+            curve: unknown;
+        }
+        >;
+
+        /**
+         * 加性动画导入设置。
+         */
+        additive?: {
+            /**
+             * 是否将动画导入为加性动画。
+             */
+            enabled: boolean;
+
+            /**
+             * 参考动画。
+             * 若设置，将参考该动画第 0 帧的姿势计算加性动画；
+             * 否则，则将参考第动画本身第 0 帧的姿势进行计算。
+             */
+            refClip?: string;
+        };
+    }>;
+}
+
+/** 所有资源处理器类型的常量数组（用于 Zod enum 和 TypeScript type） */
+declare const ASSET_HANDLER_TYPES: string[];
+
+/** 资源处理器类型（从常量数组派生） */
+declare type AssetHandlerType = typeof ASSET_HANDLER_TYPES[number] | 'database';
+
+export declare class AssetService extends BaseService<IAssetEvents> implements IAssetService {
+    /**
+     * 主进程监听 asset 事件，所触发事件
+     * @param uuid
+     */
+    assetChanged(uuid: string): Promise<void>;
+    /**
+     * 主进程监听 asset 事件，所触发事件
+     * @param uuid
+     */
+    assetDeleted(uuid: string): Promise<void>;
+    onEditorOpened(): void;
+    onNodeChanged(node: Node_2): void;
+    onComponentAdded(comp: Component): void;
+    onComponentRemoved(comp: Component): void;
+    releaseAsset(assetUUID: string): void;
+}
+
+declare interface AssetUserDataMap {
+    'animation-clip': AnimationClipAssetUserData;
+    'auto-atlas': AutoAtlasAssetUserData;
+    'label-atlas': LabelAtlasAssetUserData;
+    'render-texture': RenderTextureAssetUserData;
+    'directory': DirectoryAssetUserData;
+    'texture-cube': TextureCubeAssetUserData;
+    'erp-texture-cube': TextureCubeAssetUserData;
+    'image': ImageAssetUserData;
+    'sprite-frame': SpriteFrameAssetUserData;
+    'texture': Texture2DAssetUserData;
+    'spine-data': SpineAssetUserData;
+    'javascript': JavaScriptAssetUserData;
+    'gltf-animation': GltfAnimationAssetUserData;
+    'particle': ParticleAssetUserData;
+    'json': JsonAssetUserData;
+    'prefab': PrefabAssetUserData;
+    'scene': PrefabAssetUserData;
+    'effect': EffectAssetUserData;
+    'audio-clip': AudioClipAssetUserData;
+    'bitmap-font': BitmapFontAssetUserData;
+    'gltf-skeleton': GltfSkeletonAssetUserData;
+    'gltf-embeded-image': GltfEmbededImageAssetUserData;
+    'gltf-mesh': IVirtualAssetUserData;
+    'gltf-material': IVirtualAssetUserData;
+    'gltf-scene': IVirtualAssetUserData;
+    'gltf': GlTFUserData;
+    'fbx': GlTFUserData;
+    'sprite-atlas': SpriteAtlasAssetUserData;
+    'rt-sprite-frame': RtSpriteFrameAssetUserData;
+    'sign-image': ImageAssetUserData;
+    'alpha-image': ImageAssetUserData;
+
+    // 无特定 userData 的资源类型（仅保留 unknown）
+    'unknown': any;
+}
+
+/** 音频资源的 userData */
+declare interface AudioClipAssetUserData {
+    /** 下载模式：0-Web Audio, 1-DOM Audio */
+    downloadMode: number;
+}
+
+/** 自动图集资源的 userData */
+declare interface AutoAtlasAssetUserData {
+    compressed: boolean;
+    dest: any;
+    /** 打包图像的尺寸 */
+    maxWidth: number;
+    maxHeight: number;
+    /** 图像的边距 */
+    padding: number;
+    allowRotation: boolean;
+    forceSquared: boolean;
+    powerOfTwo: boolean;
+    algorithm: string;
+    format: string;
+    quality: number;
+    contourBleed: boolean;
+    paddingBleed: boolean;
+    filterUnused: boolean;
+    removeTextureInBundle: boolean;
+    removeImageInBundle: boolean;
+    removeSpriteAtlasInBundle: boolean;
+    platformSettings: any;
+    textureSetting: any;
+}
+
+declare class BaseService<TEvents extends Record<string, any>> {
+    protected isOpen: boolean;
+    /**
+     * 触发事件
+     * @param event 事件名称
+     * @param args 事件参数（根据事件类型自动推断）
+     */
+    protected emit<K extends keyof TEvents>(event: K, ...args: TEvents[K]): void;
+    /**
+     * 跨进程广播事件
+     */
+    broadcast<K extends keyof TEvents>(event: K, ...args: TEvents[K]): void;
+    /**
+     * 监听事件
+     * @param event 事件名称
+     * @param listener 事件监听器
+     */
+    protected on<K extends keyof TEvents>(event: K, listener: TEvents[K] extends void ? () => void : (payload: TEvents[K]) => void): void;
+    /**
+     * 一次性监听事件
+     * @param event 事件名称
+     * @param listener 事件监听器
+     */
+    protected once<K extends keyof TEvents>(event: K, listener: TEvents[K] extends void ? () => void : (payload: TEvents[K]) => void): void;
+    /**
+     * 移除事件监听器
+     * @param event 事件名称
+     * @param listener 事件监听器
+     */
+    protected off<K extends keyof TEvents>(event: K, listener: TEvents[K] extends void ? () => void : (payload: TEvents[K]) => void): void;
+    /**
+     * 清除事件监听器
+     * @param event 事件名称，如果不提供则清除所有
+     */
+    protected clear(event?: keyof TEvents): void;
+}
+
+/** 位图字体资源的 userData */
+declare interface BitmapFontAssetUserData {
+    /** 字体配置 */
+    _fntConfig: any;
+    /** 字体大小 */
+    fontSize: number;
+    /** 纹理 UUID */
+    textureUuid: string;
+}
+
+/**
+ * 子进程节点处理器
+ * 在子进程中处理所有节点相关操作
+ */
+export declare class ComponentService extends BaseService<IComponentEvents> implements IComponentService {
+    modeName: SceneModeType;
+    protected _sceneEventListener: ISceneEvents[];
+    protected _recycleComponent: Record<string, Component>;
+    constructor();
+    /**
+     * 查询当前正在编辑的模式名字
+     */
+    queryMode(): SceneModeType;
+    onAddComponent(comp: Component, opts?: IOptionBase): void;
+    onRemoveComponent(comp: Component, opts?: IOptionBase): void;
+    onComponentAdded(comp: Component, opts?: IOptionBase): void;
+    onComponentRemoved(comp: Component, opts?: IOptionBase): void;
+    dispatchEvents(eventName: keyof ISceneEvents, ...args: any[any]): void;
+    private addComponentImpl;
+    addComponent(params: IAddComponentOptions): Promise<IComponent>;
+    /**
+     * 创建组件
+     * @param params
+     */
+    private requireComponentList;
+    createComponent(params: IAddComponentOptions): Promise<boolean>;
+    checkComponentsCollision(node: Node_2): Promise<void>;
+    checkDynamicBodyShape(ndoe: Node_2): void;
+    /**
+     * 通过 path、uuid 或 url 查找组件实例
+     */
+    private findComponent;
+    removeComponent(params: IRemoveComponentOptions): Promise<boolean>;
+    queryComponent(params: IQueryComponentOptions): Promise<IComponent | IComponentForPinK | null>;
+    setProperty(options: ISetPropertyOptions): Promise<boolean>;
+    /**
+     * 查询一个节点的实例
+     * @param {*} uuid
+     * @return {cc.Node}
+     */
+    query(uuid: string | undefined): Node_2 | null;
+    setPropertyForPink(uuid: string, path: string, dump: IProperty, record?: boolean): Promise<boolean>;
+    private setPropertyImp;
+    queryAllComponent(): Promise<string[]>;
+    init(): void;
+    private readonly CompMgrEventHandlers;
+    private compMgrEventHandlers;
+    /**
+     * 注册引擎 Node 管理相关事件的监听
+     */
+    registerCompMgrEvents(): void;
+    unregisterCompMgrEvents(): void;
+    /**
+     * 添加到组件缓存
+     * @param {String} uuid
+     * @param {cc.Component} component
+     */
+    add(uuid: string, component: Component): void;
+    /**
+     * 移除组件缓存
+     * @param {String} uuid
+     * @param {cc.Component} component
+     */
+    remove(uuid: string, component: Component): void;
+    /**
+     * 重置组件
+     * @param uuid component 的 uuid
+     */
+    resetComponent(params: IQueryComponentOptions): Promise<boolean>;
+    executeComponentMethod(options: IExecuteComponentMethodOptions): Promise<boolean>;
+}
+
+/**
+ * 创建类型
+ */
+declare const CREATE_TYPES: readonly ['scene', 'prefab'];
+
+/** 文件夹资源的 userData */
+declare interface DirectoryAssetUserData {
+    /** 是否是资源包 */
+    isBundle?: boolean;
+    /** 资源包配置 ID */
+    bundleConfigID?: string;
+    /** 资源包名称 */
+    bundleName?: string;
+    /** 优先级 */
+    priority?: number;
+}
+
+/**
+ * EditorAsset - 统一的编辑器管理入口
+ * 作为调度器，根据资源类型动态创建和管理编辑器实例
+ */
+export declare class EditorService extends BaseService<IEditorEvents> implements IEditorService {
+    private needReloadAgain;
+    private lastSceneOrNode;
+    private reloadPromise;
+    private currentEditorUuid;
+    private editorMap;
+    private lockCount;
+    private lockPromise;
+    private lockResolve;
+    private _isReloading;
+    lock(): Promise<void>;
+    unlock(): void;
+    waitLocks(): Promise<void>;
+    /**
+     * 当前编辑的类型
+     */
+    getCurrentEditorType(): 'scene' | 'prefab' | 'unknown';
+    /**
+     * 是否打开场景
+     */
+    hasOpen(): Promise<boolean>;
+    /**
+     * 根据资源类型创建对应的编辑器
+     */
+    private createEditor;
+    queryCurrent(): Promise<IScene | INode | null>;
+    getRootNode(): cc_2.Scene | cc_2.Node | null;
+    open(params: IOpenOptions): Promise<IScene | INode>;
+    close(params: ICloseOptions): Promise<boolean>;
+    save(params: ISaveOptions): Promise<IAssetInfo>;
+    reload(params: IReloadOptions): Promise<ReloadResult>;
+    create(params: ICreateOptions): Promise<IBaseIdentifier>;
+    onScriptExecutionFinished(): void;
+}
+
+/** Effect 着色器资源的 userData */
+declare interface EffectAssetUserData {
+    /** 预编译组合 */
+    combinations?: any;
+    /** 编辑器相关数据 */
+    editor?: any;
+}
+
+/**
+ * 引擎管理器，用于引擎相关操作
+ */
+export declare class EngineService extends BaseService<IEngineEvents> implements IEngineService {
+    private _setTimeoutId;
+    private _rafId;
+    private _maxDeltaTimeInEM;
+    private _stateRecord;
+    private _shouldRepaintInEM;
+    private _tickInEM;
+    private _tickedFrameInEM;
+    private _paused;
+    private _capture;
+    private _bindTick;
+    private geometryRenderer;
+    private _sceneTick;
+    init(): Promise<void>;
+    setTimeout(callback: any, time: number): void;
+    clearTimeout(): void;
+    repaintInEditMode(): Promise<void>;
+    setFrameRate(fps: number): void;
+    startTick(): void;
+    stopTick(): void;
+    tickInEditMode(deltaTime: number): void;
+    getGeometryRenderer(): GeometryRenderer & Pick<GeometryRenderer_2, 'addDashedLine' | 'addTriangle' | 'addQuad' | 'addBoundingBox' | 'addCross' | 'addFrustum' | 'addCapsule' | 'addCylinder' | 'addCone' | 'addCircle' | 'addArc' | 'addPolygon' | 'addDisc' | 'addSector' | 'addSphere' | 'addTorus' | 'addOctahedron' | 'addBezier' | 'addMesh' | 'addIndexedMesh'>;
+    resume(): void;
+    pause(): void;
+    private _tick;
+    private _isTickAllowed;
+    get capture(): boolean;
+    set capture(b: boolean);
+    onEditorOpened(): void;
+    onEditorClosed(): void;
+    onEditorReload(): void;
+    onNodeChanged(): void;
+    onComponentAdded(): void;
+    onComponentRemoved(): void;
+    onSetPropertyComponent(): void;
+}
+
+declare type Filter = 'none' | 'nearest' | 'linear';
+
+declare interface FntData {
+    commonHeight?: number;
+    fontSize?: number;
+    atlasName?: string;
+    fontDefDictionary?: FontDefDictionary;
+    kerningDict?: KerningDict;
+}
+
+declare interface FontDef {
+    rect: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    xOffset: number;
+    yOffset: number;
+    xAdvance: number;
+}
+
+declare interface FontDefDictionary {
+    [charId: number]: FontDef;
+}
+
+declare class GeometryRenderer {
+    private _renderer;
+    private _dataMap;
+    constructor();
+    get renderer(): any;
+    set renderer(renderer: any);
+    flush(): void;
+    removeData(method: string): void;
+    removeDataAll(): void;
+}
+
+/**
+ * 获取全部 Service
+ */
+export declare function getServiceAll(): any[];
+
+/** glTF 动画资源的 userData */
+declare interface GltfAnimationAssetUserData {
+    gltfIndex: number;
+    events: Array<{
+        frame: number;
+        func: string;
+        params: string[];
+    }>;
+    editorExtras?: unknown;
+    embeddedPlayers?: Array<{
+        editorExtras?: unknown;
+        begin: number;
+        end: number;
+        reconciledSpeed: boolean;
+        playable:
+        | {
+            type: 'animation-clip';
+            path: string;
+            clip: string;
+        }
+        | {
+            type: 'particle-system';
+            path: string;
+        };
+    }>;
+    auxiliaryCurves?: Record<string, { curve: any }>;
+    wrapMode: number;
+    speed?: number;
+    sample?: number;
+    span?: {
+        from: number;
+        to: number;
+    };
+    additive?: any;
+}
+
+/** glTF 嵌入图片子资源的 userData */
+declare interface GltfEmbededImageAssetUserData extends IVirtualAssetUserData {
+    /** 是否修复 Alpha 透明度瑕疵 */
+    fixAlphaTransparencyArtifacts?: boolean;
+}
+
+declare type GltfpackOptions = Record<string, any>;
+
+/** glTF Skeleton 子资源的 userData */
+declare interface GltfSkeletonAssetUserData extends IVirtualAssetUserData {
+    /** 骨骼数量 */
+    jointsLength?: number;
+}
+
+declare interface GlTFUserData {
+    assetFinder?: SerializedAssetFinder;
+
+    imageMetas: ImageMeta[];
+
+    // Normal import settings
+    // @default required
+    normals?: NormalImportSetting;
+
+    // Tangent import settings;
+    // @default required
+    tangents?: TangentImportSetting;
+
+    /**
+     * Controls how to import morph normals.
+     * @default Exclude.
+     */
+    morphNormals?: NormalImportSetting.exclude | NormalImportSetting.optional;
+
+    // Whether to extract material assets out of embedded (sub)assets,
+    // so that the assets become editable.
+    // @default false
+    dumpMaterials?: boolean;
+
+    // only for chat avatar
+    redirectMaterialMap?: Record<string, string>;
+
+    // The directory to dump the materials.
+    // Default to a direct sub-folder prefixed with 'Materials_' under current path.
+    materialDumpDir?: string;
+
+    /**
+     * Whether to use vertex colors(if valid) in material.
+     * @default false
+     */
+    useVertexColors?: boolean;
+
+    /**
+     * Whether to enable depth-write if the material specify the `BLEND` mode.
+     * See https://github.com/KhronosGroup/glTF/tree/master/specification/2.0#alpha-coverage
+     * @default false
+     */
+    depthWriteInAlphaModeBlend?: boolean;
+
+    // @default true
+    skipValidation?: boolean;
+
+    /**
+     * 整个数组由导入器创建。`name` 和 `duration` 也都由导入器写入修改，外部不允许修改。
+     * `splits` 是允许用户配置的。
+     */
+    animationImportSettings?: AnimationImportSetting[];
+
+    /**
+     * 是否将所有动画挂载到生成的预制体上。
+     * @default false
+     */
+    mountAllAnimationsOnPrefab?: boolean;
+
+    /**
+     * 使用旧的 FBX 导入器。（在非 FBX 导入器上是 `undefined`）
+     */
+    legacyFbxImporter?: boolean;
+
+    /**
+     * 禁用 Mesh 分割，默认勾选
+     */
+    disableMeshSplit?: boolean;
+
+    /**
+     * 允许数据访问。
+     */
+    allowMeshDataAccess?: boolean;
+
+    /**
+     * 是否添加填充顶点色
+     * @default false
+     */
+    addVertexColor?: boolean;
+
+    /**
+     * 若开启并且模型场景顶部仅有一个节点，那么以该节点作为根节点转换为 Prefab。
+     * 否则，以场景为根节点转换为 Prefab。见 cocos/cocos-engine#11858 。
+     */
+    promoteSingleRootNode?: boolean;
+    /*
+    * 若开启则自动生成 Lightmap UV，并将 UV 写入第二个通道（若第二个通道有 UV ， 则该 UV 会被覆盖）
+    * 否则，使用默认 UV 。
+    */
+    generateLightmapUVNode?: boolean;
+
+    /**
+     * 关于 FBX 的配置。仅当 `legacyFbxImporter === false` 时有效。
+     */
+    fbx?: IFbxSetting;
+
+    /**
+     * 减面配置
+     */
+    meshOptimizer?: MeshOptimizerOption;
+
+    /**
+     * mesh 优化配置
+     */
+    meshOptimize?: MeshOptimizeOptions;
+
+    /**
+     * 是否开启 mesh 减面
+     */
+    meshSimplify?: MeshSimplifyOptions;
+
+    /**
+     * MeshCluster Options
+     */
+    meshCluster?: MeshClusterOptions;
+
+    /**
+     * Mesh compression options
+     */
+    meshCompress?: MeshCompressOptions;
+
+    lods?: {
+        // 是否开启 LODS
+        enable: boolean;
+        // fbx 是否自带 LOD
+        hasBuiltinLOD: boolean;
+        // fbx 各层级 lod 的配置
+        options: LODsOption[];
+    };
+}
+
+/**
+ * 创建/添加组件
+ */
+declare interface IAddComponentOptions {
+    nodePathOrUuid: string;
+    component: string;
+}
+
+declare interface IApplyPrefabChangesParams {
+    nodePath: string;
+}
+
+/**
+ * 资源事件类型
+ */
+declare interface IAssetEvents {
+    'asset:change': [uuid: string];
+    'asset:deleted': [uuid: string];
+    'asset-refresh': [uuid: string];
+}
+
+declare interface IAssetInfo {
+    name: string; // 资源名字
+    source: string; // url 地址
+    loadUrl: string; // loader 加载的层级地址
+    url: string; // loader 加载地址会去掉扩展名，这个参数不去掉
+    file: string; // 绝对路径
+    uuid: string; // 资源的唯一 ID
+    importer: AssetHandlerType; // 使用的导入器名字
+    imported: boolean; // 是否结束导入过程
+    invalid: boolean; // 是否导入成功
+    type: IAssetType; // 类型
+    isDirectory: boolean; // 是否是文件夹
+    library: { [key: string]: string }; // 导入资源的 map
+
+    // dataKeys 作用范围
+    isBundle?: boolean; // 是否是文件夹
+    displayName?: string; // 资源用于显示的名字
+    readonly?: boolean; // 是否只读
+    visible?: boolean; // 是否显示
+    subAssets?: { [key: string]: IAssetInfo }; // 子资源 map
+    // 虚拟资源可以实例化成实体的话，会带上这个扩展名
+    instantiation?: string;
+    redirect?: IRedirectInfo; // 跳转指向资源
+    meta?: IAssetMeta,
+    parent?: {
+        source: string;
+        library: { [key: string]: string };
+        uuid: string;
+    };
+    extends?: string[]; // 资源的继承链信息
+    mtime?: number; // 资源文件的 mtime
+    depends?: string[]; // 依赖的资源 uuid 信息
+    dependeds?: string[]; // 被依赖的资源 uuid 信息
+}
+
+declare interface IAssetMeta<T extends ISupportCreateType | 'unknown' = 'unknown'> {
+    ver: string;
+    importer: AssetHandlerType;
+    imported: boolean;
+    uuid: string;
+    files: string[];
+    subMetas: {
+        [index: string]: IAssetMeta<'unknown'>;
+    };
+    userData: AssetUserDataMap[T extends keyof AssetUserDataMap ? T : 'unknown'];
+    displayName?: string;
+    id?: string;
+    name?: string;
+}
+
+/**
+ * 场景相关处理接口
+ */
+declare interface IAssetService extends IServiceEvents {
+    /**
+     * 资源发生变化时，进行处理
+     * @param uuid
+     */
+    assetChanged(uuid: string): Promise<void>;
+    /**
+     * 资源删除时，进行处理
+     * @param uuid
+     */
+    assetDeleted(uuid: string): Promise<void>;
+}
+
+declare type IAssetType =
+| ISupportCreateCCType
+| 'cc.Asset'               // 基础资源类型（instantiation-asset）
+| 'cce.Database'           // 数据库资源
+| 'cce.EffectHeader'       // 着色器头文件
+| 'cc.VideoClip'           // 视频剪辑
+| 'cc.TiledMapAsset'       // 瓦片地图
+| 'cc.TTFFont'             // TTF 字体
+| 'cc.Texture2D'           // 2D 纹理
+| 'cc.SpriteFrame'         // 精灵帧（sprite-frame、rt-sprite-frame）
+| 'cc.ImageAsset'          // 图片资源（image、gltf/image、image/alpha、image/sign、texture-cube-face）
+| 'cc.TextAsset'           // 文本资源
+| 'cc.JsonAsset'           // JSON 资源
+| 'cc.AudioClip'           // 音频剪辑
+| 'cc.BitmapFont'          // 位图字体
+| 'cc.BufferAsset'         // 缓冲区资源
+| 'cc.ParticleAsset'       // 粒子资源
+| 'cc.RenderPipeline'     // 渲染管线
+| 'cc.Skeleton'            // 骨骼（gltf/skeleton、instantiation-asset/skeleton）
+| 'cc.Mesh'                // 网格（gltf/mesh、instantiation-asset/mesh）
+| 'sp.SkeletonData'        // Spine 骨骼数据
+| 'dragonBones.DragonBonesAsset'      // DragonBones 资源
+| 'dragonBones.DragonBonesAtlasAsset' // DragonBones 图集资源
+| 'RenderStage'            // 渲染阶段
+| 'RenderFlow';
+
+declare interface IBaseCreateNodeParams {
+    path: string;
+    name?: string;
+    workMode?: '2d' | '3d';
+    position?: IVec3;
+    keepWorldTransform?: boolean;
+    canvasRequired?: boolean;
+}
+
+/**
+ * 基础标识
+ */
+declare interface IBaseIdentifier {
+    assetName: string;
+    assetUuid: string;
+    assetUrl: string;
+    assetType: string;
+}
+
+declare interface IChangeNodeOptions {
+    source?: 'editor' | 'undo' | 'engine';
+    type?: NodeEventType;
+    propPath?: string;
+    index?: number;
+    record?: boolean;
+    dumpImmediately?: boolean;
+}
+
+/**
+ * 关闭场景/预制体选项
+ */
+declare interface ICloseOptions {
+    urlOrUUID?: string;
+}
+
+/**
+ * 代表组件属性信息
+ */
+declare interface IComponent extends IComponentIdentifier {
+    properties: {
+        [key: string]: IPropertyValueType;
+    };
+    prefab: ICompPrefabInfo | null;
+}
+
+/**
+ * 场景事件类型
+ */
+declare interface IComponentEvents extends INodeEvents {
+    'component:add': [Component];
+    'component:before-remove': [Component];
+    'component:remove': [Component];
+    'component:set-property': [Component, IChangeNodeOptions];
+    'component:added': [Component];
+    'component:removed': [Component];
+    'component:before-add-component': [string, Node_2];
+}
+
+declare interface IComponentForPinK extends IProperty {
+    value: {
+        enabled: IPropertyValueType;
+        uuid: IPropertyValueType;
+        name: IPropertyValueType;
+    } & Record<string, IPropertyValueType>;
+    mountedRoot?: string;
+}
+
+/**
+ * 代表一个组件
+ */
+declare interface IComponentIdentifier {
+    cid: string;
+    path: string;
+    uuid: string;
+    name: string;
+    type: string;
+    enabled: boolean;
+}
+
+/**
+ * 组件的相关处理接口
+ */
+declare interface IComponentService extends IServiceEvents {
+    /**
+     * 添加组件
+     * @param params
+     */
+    addComponent(params: IAddComponentOptions): Promise<IComponent>;
+    /**
+     * 创建组件
+     * @param params
+     */
+    createComponent(params: IAddComponentOptions): Promise<boolean>;
+    /**
+     * 删除组件
+     * @param params
+     */
+    removeComponent(params: IRemoveComponentOptions): Promise<boolean>;
+    /**
+     * 设置组件属性
+     * @param params
+     */
+    setProperty(params: ISetPropertyOptions): Promise<boolean>;
+    /**
+     * 设置组件属性，pink专属接口，因为结构与ISetPropertyOptions是不同的
+     * @param params
+     */
+    setPropertyForPink(uuid: string, path: string, dump: IProperty, record?: boolean): Promise<boolean>;
+    /**
+     * 查询组件
+     */
+    queryComponent(params: IQueryComponentOptions): Promise<IComponent | IComponentForPinK | null>;
+    /**
+     * 获取所有组件名，包含内置与自定义组件
+     */
+    queryAllComponent(): Promise<string[]>;
+    /**
+     * 复位组件
+     */
+    resetComponent(params: IQueryComponentOptions): Promise<boolean>;
+    /**
+     * 执行组件方法
+     */
+    executeComponentMethod(options: IExecuteComponentMethodOptions): Promise<boolean>;
+    init(): void;
+    unregisterCompMgrEvents(): void;
+}
+
+declare interface ICompPrefabInfo {
+    fileId: string;
+}
+
+declare interface ICreateByAssetParams extends IBaseCreateNodeParams {
+    dbURL: string;
+}
+
+declare interface ICreateByNodeTypeParams extends IBaseCreateNodeParams {
+    nodeType: NodeType;
+}
+
+/**
+ * 创建场景/预制体选项
+ */
+declare interface ICreateOptions {
+    type: ICreateType;
+    baseName: string;
+    targetDirectory: string;
+    templateType?: TSceneTemplateType;
+}
+
+declare interface ICreatePrefabFromNodeParams {
+    /** 要转换为预制体的源节点路径 */
+    nodePath: string;
+    /** 预制体资源保存 URL */
+    dbURL: string;
+    /** 是否强制覆盖现有资源 */
+    overwrite?: boolean;
+}
+
+declare type ICreateType = typeof CREATE_TYPES[number];
+
+declare interface IDeleteNodeParams {
+    path: string;
+    keepWorldTransform?: boolean;
+}
+
+declare interface IDeleteNodeResult {
+    path: string;
+}
+
+/**
+ * 事件类型
+ */
+declare interface IEditorEvents {
+    'editor:open': [];
+    'editor:close': [];
+    'editor:save': [];
+    'editor:reload': [];
+}
+
+declare interface IEditorService extends IServiceEvents {
+    /**
+     * 当前编辑器类型
+     */
+    getCurrentEditorType(): 'scene' | 'prefab' | 'unknown';
+    /**
+     * 打开资产
+     * @param params
+     */
+    open(params: IOpenOptions): Promise<TEditorEntity>;
+    /**
+     * 关闭当前资产
+     */
+    close(params: ICloseOptions): Promise<boolean>;
+    /**
+     * 保存资产
+     */
+    save(params: ISaveOptions): Promise<IAssetInfo>;
+    /**
+     * 重载资产
+     * @param params
+     */
+    reload(params: IReloadOptions): Promise<ReloadResult>;
+    /**
+     * 创建新资产
+     * @param params
+     */
+    create(params: ICreateOptions): Promise<IBaseIdentifier>;
+    /**
+     * 是否有打开编辑器
+     */
+    hasOpen(): Promise<boolean>;
+    /**
+     * 获取当前打开的资产
+     */
+    queryCurrent(): Promise<TEditorEntity | null>;
+    /**
+     *
+     */
+    getRootNode(): TEditorInstance | null;
+    lock(): Promise<void>;
+    unlock(): void;
+}
+
+declare interface IEngineEvents {
+    'engine:update': [];
+    'engine:ticked': [];
+}
+
+declare interface IEngineService extends IServiceEvents {
+    /**
+     * 初始化引擎服务，目前是暂时引擎 mainLoop
+     */
+    init(): Promise<void>;
+    /**
+     * 让引擎执行一帧
+     */
+    repaintInEditMode(): Promise<void>;
+}
+
+/**
+ * 执行组件方法选项
+ */
+declare interface IExecuteComponentMethodOptions {
+    uuid: string;
+    name: string;
+    args: any[];
+}
+
+declare interface IFbxSetting {
+    /**
+     * https://github.com/cocos-creator/FBX-glTF-conv/pull/26
+     */
+    unitConversion?: 'geometry-level' | 'hierarchy-level' | 'disabled';
+
+    /**
+     * 动画烘焙速率。单位为 FPS。
+     * 一般来说有以下几种 FPS 选项。
+     * - NTSC video 30/60
+     * - PAL video 25
+     * - Film 24
+     * 见 https://knowledge.autodesk.com/support/3ds-max/learn-explore/caas/CloudHelp/cloudhelp/2020/ENU/3DSMax-Reference/files/GUID-92B75FD6-C112-44D6-AB89-DB50D11AE0DE-htm.html 。
+     * 为了以后的拓展性，我们目前仅支持用户从这几种选项中选择。
+     * @default 24
+     */
+    animationBakeRate?: 0 | 24 | 25 | 30 | 60;
+
+    /**
+     * 在导出动画时，是否优先使用 FBX 内记录的时间范围。
+     * @default true
+     */
+    preferLocalTimeSpan?: boolean;
+
+    /**
+     * 是否为导入的材质匹配DCC的光照模型.
+     * 在导入时,若此字段为 `undefined` 时,该字段将被初始化为当前配置的"是否开启智能材质转换".
+     */
+    smartMaterialEnabled?: boolean;
+
+    /**
+     * 匹配 DCC 原始模型名称。
+     */
+    matchMeshNames?: boolean;
+}
+
+declare interface IGetPrefabInfoParams {
+    nodePath: string;
+}
+
+declare interface IIsPrefabInstanceParams {
+    nodePath: string;
+}
+
+/** 图片资源的 userData  */
+declare interface ImageAssetUserData {
+    /** 图片类型 */
+    type: ImageImportType;
+    /** 垂直翻转 */
+    flipVertical?: boolean;
+    /** 消除透明伪影 */
+    fixAlphaTransparencyArtifacts?: boolean;
+    /** 是否为 RGBE */
+    isRGBE?: boolean;
+    /** 这个图片是不是拥有 alpha 通道 */
+    hasAlpha?: boolean;
+    /** 重定向的 uuid */
+    redirect?: string;
+    visible?: boolean;
+    /** 是否翻转绿通道 */
+    flipGreenChannel?: boolean;
+
+    /**
+     * 部分资源导入后可能产生多张图像资源
+     */
+    sign?: string;
+    alpha?: string;
+}
+
+declare type ImageImportType = 'raw' | 'texture' | 'normal map' | 'sprite-frame' | 'texture cube';
+
+declare interface ImageMeta {
+    /**
+     * 图片名字。
+     */
+    name?: string;
+
+    /**
+     * 模型文件中该图片的 URI，可能是以下形式：
+     *   - Database URL，这种路径的图片存在项目目录中；
+     *   - uuid URI，这种路径的图片已经作为子资源导入，路径代表子资源的 uuid。
+     * 如果未定义，表示此图片未指定源或指定的源无法解析。
+     */
+    uri?: string;
+
+    /**
+     * 用户设置的图片对象。
+     * 3.8.0 以前使用路径，3.8.0 之后使用 UUID。
+     */
+    remap?: string;
+}
+
+declare interface IMountedChildrenInfo {
+    targetInfo: ITargetInfo | null;
+    nodes: INodeIdentifier[];
+}
+
+declare interface IMountedComponentsInfo {
+    targetInfo: ITargetInfo | null;
+    components: IComponentIdentifier[];
+}
+
+declare interface INode extends INodeIdentifier {
+    properties: INodeProperties;
+    components?: IComponent[] | IComponentIdentifier[];
+    children?: INode[];
+    prefab: IPrefabInfo | null;
+}
+
+/**
+ * 节点事件类型
+ */
+declare interface INodeEvents {
+    'node:before-remove': [Node_2];
+    'node:before-change': [Node_2];
+    'node:change': [Node_2, IChangeNodeOptions];
+    'node:before-add': [Node_2];
+    'node:add': [Node_2];
+    'node:added': [Node_2];
+    'node:remove': [Node_2];
+    'node:removed': [Node_2, IChangeNodeOptions];
+}
+
+declare interface INodeIdentifier {
+    nodeId: string;
+    path: string;
+    name: string;
+}
+
+declare interface INodeProperties {
+    position: IVec3;
+    rotation: IQuat;
+    eulerAngles: IVec3;
+    scale: IVec3;
+    mobility: MobilityMode;
+    layer: number;
+    active: boolean;
+}
+
+/**
+ * 节点的相关处理接口
+ */
+declare interface INodeService extends IServiceEvents {
+    /**
+     * 创建节点
+     * @param params
+     */
+    createNodeByType(params: ICreateByNodeTypeParams): Promise<INode | null>;
+    /**
+     * 创建节点
+     * @param params
+     */
+    createNodeByAsset(params: ICreateByAssetParams): Promise<INode | null>;
+    /**
+     * 删除节点
+     * @param params
+     */
+    deleteNode(params: IDeleteNodeParams): Promise<IDeleteNodeResult | null>;
+    /**
+     * 更新节点
+     * @param params
+     */
+    updateNode(params: IUpdateNodeParams): Promise<IUpdateNodeResult>;
+    /**
+     * 查询节点
+     */
+    queryNode(params: IQueryNodeParams): Promise<INode | null>;
+    /**
+     * 查询节点树（层级管理器格式）
+     */
+    queryNodeTree(params: IQueryNodeTreeParams): Promise<INodeTreeItem | null>;
+}
+
+declare interface INodeTreeComponent {
+    isCustom: boolean;
+    type: string;
+    value: string;
+    extends: string[];
+}
+
+declare interface INodeTreeItem {
+    name: string;
+    active: boolean;
+    locked: boolean;
+    type: string;
+    children: INodeTreeItem[];
+    prefab: IPrefabStateInfo;
+    parent: string;
+    path: string;
+    isScene: boolean;
+    readonly: boolean;
+    components: INodeTreeComponent[];
+}
+
+/**
+ * 打开场景/预制体选项
+ */
+declare interface IOpenOptions {
+    urlOrUUID: string;
+    simpleNode?: boolean;
+}
+
+export declare interface IOptionBase {
+    modeName?: string;
+}
+
+declare interface IPrefab {
+    name: string;
+    uuid: string;
+    data: INodeIdentifier;
+    optimizationPolicy: OptimizationPolicy;
+    persistent: boolean;
+}
+
+/**
+ * 预制体事件类型
+ */
+declare interface IPrefabEvents {
+}
+
+declare interface IPrefabInfo {
+    /** 关联的预制体资源信息 */
+    asset?: IPrefab;
+    root?: INodeIdentifier;
+    instance?: IPrefabInstance;
+    fileId: string;
+    targetOverrides: ITargetOverrideInfo[];
+    nestedPrefabInstanceRoots: INodeIdentifier[];
+}
+
+declare interface IPrefabInstance {
+    fileId: string;
+    prefabRootNode?: INodeIdentifier;
+    mountedChildren: IMountedChildrenInfo[];
+    mountedComponents: IMountedComponentsInfo[];
+    propertyOverrides: IPropertyOverrideInfo[];
+    removedComponents: ITargetInfo[];
+}
+
+declare interface IPrefabService extends IServiceEvents {
+    /**
+     * 将节点转换为预制体资源
+     */
+    createPrefabFromNode(params: ICreatePrefabFromNodeParams): Promise<INode>;
+    /**
+     * 将节点的修改应用回预制体资源
+     */
+    applyPrefabChanges(params: IApplyPrefabChangesParams): Promise<boolean>;
+    /**
+     * 重置节点到预制体原始状态
+     */
+    revertToPrefab(params: IRevertToPrefabParams): Promise<boolean>;
+    /**
+     * 解耦预制体实例，使其成为普通节点
+     */
+    unpackPrefabInstance(params: IUnpackPrefabInstanceParams): Promise<INode>;
+    /**
+     * 检查节点是否为预制体实例
+     */
+    isPrefabInstance(params: IIsPrefabInstanceParams): Promise<boolean>;
+    /**
+     * 获取节点的预制体信息
+     */
+    getPrefabInfo(params: IGetPrefabInfoParams): Promise<IPrefabInfo | null>;
+    /**
+     * 移除 prefab info
+     * @param node
+     * @param removeNested
+     */
+    removePrefabInfoFromNode(node: Node_2, removeNested?: boolean): void;
+}
+
+declare interface IPrefabStateInfo {
+    state: PrefabState;
+    isUnwrappable: boolean;
+    isRevertable: boolean;
+    isApplicable: boolean;
+    isAddedChild: boolean;
+    isNested: boolean;
+    assetUuid: string;
+}
+
+/**
+ * 组件的 dump 数据，以 IProperty 格式编码组件信息
+ * 与 IComponent 不同，所有属性（包括 uuid, name, enabled）都通过 encodeObject 编码为 IProperty
+ */
+declare interface IProperty {
+    value: { [key: string]: IPropertyValueType } | IPropertyValueType;
+    default?: any; // 默认值
+
+    // 多选节点之后，这里存储多个数据，用于自行判断多选后的显示效果，无需更新该数据
+    values?: ({ [key: string]: IPropertyValueType } | IPropertyValueType)[];
+
+    lock?: { [key in keyof Vec4]?: IPropertyLock };
+
+    cid?: string;
+    type?: string;
+    ui?: { name: string; data?: any }; // 是否用指定的 UI 组件，name 是组件的名称
+    readonly?: boolean;
+    visible?: boolean;
+    name?: string;
+
+    elementTypeData?: IProperty; // 数组里的数据的默认值 dump
+
+    path?: string; // 数据的搜索路径，这个是由使用方填充的
+
+    isArray?: boolean;
+    invalid?: boolean;
+    extends?: string[]; // 继承链
+    displayName?: string; // 显示到界面上的名字
+    displayOrder?: number; // 显示排序
+    help?: string; // 帮助文档的 url 地址
+    group?: IPropertyGroupOptions; // tab
+    tooltip?: string; // 提示文本
+    editor?: any; // 组件上定义的编辑器数据
+    animatable?: boolean; // 是否可以在动画中编辑
+    radioGroup?: boolean; // 是否渲染为 RadioGroup
+
+    // Enum
+    enumList?: any[]; // enum 类型的 list 选项数组
+
+    bitmaskList?: any[];
+
+    // Number
+    min?: number; // 数值类型的最小值
+    max?: number; // 数值类型的最大值
+    step?: number; // 数值类型的步进值
+    slide?: boolean; // 数组是否显示为滑块
+    unit?: string; // 显示的单位
+    radian?: boolean; // 标识是否为角度
+
+    // Label
+    multiline?: boolean; // 字符串是否允许换行
+    // nullable?: boolean; 属性是否允许为空
+
+    optionalTypes?: string[]; // 对属性是 object 且是可变类型的数据的支持，比如 render-pipeline
+
+    userData?: { [key: string]: any }; // 用户透传的数据
+}
+
+declare interface IPropertyGroupOptions {
+    id: string // 默认 'default'
+    name: string,
+    displayOrder: number, // 默认 Infinity, 排在最后面
+    style: string // 默认为 'tab'
+}
+
+declare type IPropertyLock = { 
+    default: number; 
+    message: string 
+};
+
+declare interface IPropertyOverrideInfo {
+    targetInfo: ITargetInfo | null;
+    propertyPath: string[];
+    value?: any;
+}
+
+declare type IPropertyValueType = IProperty | IProperty[] | null | undefined | number | boolean | string | Vec4 | Vec3 | Vec2 | Mat4 | any | Array<unknown>
+
+declare interface IQuat {
+    x: number;
+    y: number;
+    z: number;
+    w: number;
+}
+
+/**
+ * 查询组件
+ */
+declare interface IQueryComponentOptions {
+    pathOrUuidOrUrl: string;
+    isFull?: boolean;
+}
+
+declare interface IQueryNodeParams {
+    path: string;
+    queryChildren: boolean;
+    queryComponent: boolean;
+}
+
+declare interface IQueryNodeTreeParams {
+    path?: string;
+}
+
+declare interface IRedirectInfo {
+    // 跳转资源的类型
+    type: string;
+    // 跳转资源的 uuid
+    uuid: string;
+}
+
+/**
+ * 软刷新场景/预制体选项
+ */
+declare interface IReloadOptions {
+    urlOrUUID?: string;
+}
+
+/**
+ * 删除组件
+ */
+declare interface IRemoveComponentOptions {
+    pathOrUuidOrUrl: string;
+}
+
+declare interface IRevertToPrefabParams {
+    nodePath: string;
+}
+
+/**
+ * 保持场景/预制体选项
+ */
+declare interface ISaveOptions {
+    urlOrUUID?: string;
+}
+
+/**
+ * 场景信息
+ */
+declare interface IScene extends IBaseIdentifier {
+    name: string;
+    prefab: IPrefabInfo | null;
+    children: INode[];
+    components: IComponentIdentifier[];
+}
+
+export declare interface ISceneEvents {
+    onAddComponent?(comp: Component): void;
+    onRemoveComponent?(comp: Component): void;
+    onComponentAdded?(comp: Component, opts?: IOptionBase): void;
+    onComponentRemoved?(comp: Component, opts?: IOptionBase): void;
+}
+
+declare interface IScriptEvents {
+    /**
+     * 当脚本刷新并执行完成时触发
+     */
+    'script:execution-finished': [];
+}
+
+declare interface IScriptService extends IServiceEvents {
+    investigatePackerDriver(): Promise<void>;
+    loadScript(): Promise<void>;
+    removeScript(): Promise<void>;
+    scriptChange(): Promise<void>;
+    queryScriptCid(uuid: string): Promise<string | null>;
+    queryScriptName(uuid: string): Promise<string | null>;
+    isCustomComponent(classConstructor: Function): boolean;
+    suspend(condition: Promise<any>): void;
+}
+
+declare interface IServiceEvents {
+    onEditorOpened?(): void;
+    onEditorReload?(): void;
+    onEditorClosed?(): void;
+    onEditorSaved?(): void;
+    onNodeBeforeChanged?(node: Node_2): void;
+    onBeforeRemoveNode?(node: Node_2): void;
+    onBeforeAddNode?(node: Node_2): void;
+    onNodeChanged?(node: Node_2, opts: IChangeNodeOptions): void;
+    onBeforeNodeAdded?(node: Node_2): void;
+    onAddNode?(node: Node_2): void;
+    onRemoveNode?(node: Node_2): void;
+    onNodeAdded?(node: Node_2): void;
+    onNodeRemoved?(node: Node_2): void;
+    onAddComponent?(comp: Component): void;
+    onRemoveComponent?(comp: Component): void;
+    onSetPropertyComponent?(comp: Component): void;
+    onComponentAdded?(comp: Component): void;
+    onComponentRemoved?(comp: Component): void;
+    onBeforeRemoveComponent?(comp: Component): void;
+    onComponentBeforeChanged?(node: Node_2): void;
+    onBeforeComponentAdded?(name: string, node: Node_2): void;
+    onComponentChanged?(name: string, opts: IChangeNodeOptions): void;
+    onAssetDeleted?(uuid: string): void;
+    onAssetChanged?(uuid: string): void;
+    onAssetRefreshed?(uuid: string): void;
+    onScriptExecutionFinished?(): void;
+}
+
+declare interface IServiceManager {
+    Editor: IEditorService;
+    Node: INodeService;
+    Component: IComponentService;
+    Script: IScriptService;
+    Asset: IAssetService;
+    Engine: IEngineService;
+    Prefab: IPrefabService;
+}
+
+/**
+ * 查询组件
+ */
+declare interface ISetPropertyOptions {
+    componentPath: string;
+    properties: {
+        [key: string]: null | undefined | number | boolean | string | object | Array<unknown>;
+    };
+    record?: boolean;
+}
+
+declare type ISupportCreateCCType =
+| 'cc.AnimationClip'        // 动画剪辑
+| 'cc.Script'               // 脚本（TypeScript/JavaScript）
+| 'cc.SpriteAtlas'          // 精灵图集（自动图集）
+| 'cc.EffectAsset'          // 着色器效果
+| 'cc.SceneAsset'           // 场景
+| 'cc.Prefab'               // 预制体
+| 'cc.Material'             // 材质
+| 'cc.TextureCube'          // 立方体贴图
+| 'cc.TerrainAsset'         // 地形
+| 'cc.PhysicsMaterial'      // 物理材质
+| 'cc.LabelAtlas'           // 标签图集
+| 'cc.RenderTexture'        // 渲染纹理
+| 'cc.AnimationGraph'       // 动画图
+| 'cc.AnimationMask'        // 动画遮罩
+| 'cc.AnimationGraphVariant';
+
+/** 支持创建的资源类型（从常量数组派生） */
+declare type ISupportCreateType = typeof SUPPORT_CREATE_TYPES[number];
+
+declare interface ITargetInfo {
+    localID: string[];
+}
+
+declare interface ITargetOverrideInfo {
+    source: IComponentIdentifier | INodeIdentifier | null;
+    sourceInfo: ITargetInfo | null;
+    propertyPath: string[];
+    target: INodeIdentifier | null;
+    targetInfo: ITargetInfo | null;
+}
+
+declare interface IUnpackPrefabInstanceParams {
+    /** 要解耦的预制体实例节点 */
+    nodePath: string;
+    /** 递归解耦所有子预制体 */
+    recursive?: boolean;
+}
+
+declare interface IUpdateNodeParams {
+    path: string;
+    name?: string;
+    properties?: Partial<INodeProperties>;
+}
+
+declare interface IUpdateNodeResult {
+    path: string;
+}
+
+declare interface IVec3 {
+    x: number;
+    y: number;
+    z: number;
+}
+
+/** glTF 虚拟子资源的通用 userData */
+declare interface IVirtualAssetUserData {
+    /** 在 glTF 文件中的索引 */
+    gltfIndex?: number;
+    /** mesh 资源的面数 */
+    triangleCount?: number;
+    /** mesh 所在 lod 层级 */
+    lodLevel?: number;
+    /** 根据 lod 配置自动生成 */
+    lodOptions?: {
+        /** 自动生成的 mesh 占原 mesh 的百分比 */
+        faceCount: number;
+    };
+    [key: string]: any;
+}
+
+/** JavaScript 资源的 userData */
+declare type JavaScriptAssetUserData = ScriptModuleUserData | PluginScriptUserData;
+
+/** JSON 资源的 userData */
+declare interface JsonAssetUserData {
+    /** 是否启用 JSON5 解析 */
+    json5?: boolean;
+}
+
+declare interface KerningDict {
+    [key: number]: number;
+}
+
+/** 标签图集资源的 userData */
+declare interface LabelAtlasAssetUserData {
+    itemWidth: number;
+    itemHeight: number;
+    startChar: string;
+    fontSize: number;
+    spriteFrameUuid: string;
+    _fntConfig: FntData;
+}
+
+declare interface LODsOption {
+    // 屏占比
+    screenRatio: number;
+    // 和 lod0 的减面比
+    faceCount: number;
+}
+
+declare interface Mat4 {
+    m00: number;
+    m01: number;
+    m02: number;
+    m03: number;
+
+    m04: number;
+    m05: number;
+    m06: number;
+    m07: number;
+
+    m08: number;
+    m09: number;
+    m10: number;
+    m11: number;
+
+    m12: number;
+    m13: number;
+    m14: number;
+    m15: number;
+}
+
+declare interface MeshClusterOptions {
+    enable: boolean;
+    coneCluster?: boolean;
+}
+
+declare interface MeshCompressOptions {
+    enable: boolean;
+    encode?: boolean;
+    compress?: boolean;
+    quantize?: boolean;
+}
+
+declare interface MeshOptimizeOptions {
+    enable: boolean;
+    vertexCache?: boolean;
+    vertexFetch?: boolean;
+    overdraw?: boolean;
+}
+
+declare interface MeshOptimizerOption {
+    // 是否启用此功能
+    enable: boolean;
+    // 减面算法，默认 simplify
+    algorithm?: 'gltfpack' | 'simplify';
+    simplifyOptions?: SimplifyOptions;
+    // 已废弃，仅做简单记录
+    gltfpackOptions?: GltfpackOptions;
+}
+
+declare interface MeshSimplifyOptions {
+    enable: boolean;
+    targetRatio?: number;
+    autoErrorRate?: boolean;
+    errorRate?: number;
+    lockBoundary?: boolean;
+}
+
+declare enum MobilityMode {
+    /**
+     * @en Static node
+     * @zh 静态节点
+     */
+    Static = 0,
+    /**
+     * @en Stationary node
+     * @zh 固定节点
+     */
+    Stationary = 1,
+    /**
+     * @en Movable node
+     * @zh 可移动节点
+     */
+    Movable = 2
+}
+
+declare enum NodeEventType {
+    TRANSFORM_CHANGED = 'transform-changed',// 节点改变位置、旋转或缩放事件
+    SIZE_CHANGED = 'size-changed',// 当节点尺寸改变时触发的事件
+    ANCHOR_CHANGED = 'anchor-changed',// 当节点锚点改变时触发的事件
+    CHILD_ADDED = 'child-added',// 节点子类添加
+    CHILD_REMOVED = 'child-removed',// 节点子类移除
+    PARENT_CHANGED = 'parent-changed',// 父节点改变时触发的事件
+    CHILD_CHANGED = 'child-changed',// 子节点改变时触发的事件
+    COMPONENT_CHANGED = 'component-changed',// 组件数据发生改变时
+    ACTIVE_IN_HIERARCHY_CHANGE = 'active-in-hierarchy-changed',// 节点在hierarchy是否激活
+    NOTIFY_NODE_CHANGED = 'notify-node-changed',
+    PREFAB_INFO_CHANGED = 'prefab-info-changed',// prefab数据改变
+    LIGHT_PROBE_CHANGED = 'light-probe-changed',// 光照探针数据改变
+    SET_PROPERTY = 'set-property',// 设置节点上的属性
+    MOVE_ARRAY_ELEMENT = 'move-array-element',// 调整一个数组类型的数据内某个 item 的位置
+    REMOVE_ARRAY_ELEMENT = 'remove-array-element',// 删除一个数组元素
+    CREATE_COMPONENT = 'create-component',// 创建一个组件
+    RESET_COMPONENT = 'reset-component'
+}
+
+/**
+ * 子进程节点处理器
+ * 在子进程中处理所有节点相关操作
+ */
+export declare class NodeService extends BaseService<INodeEvents> implements INodeService {
+    createNodeByType(params: ICreateByNodeTypeParams): Promise<INode | null>;
+    createNodeByAsset(params: ICreateByAssetParams): Promise<INode | null>;
+    _createNode(assetUuid: string | null, canvasNeeded: boolean, checkUITransform: boolean, params: ICreateByNodeTypeParams | ICreateByAssetParams): Promise<INode | null>;
+    /**
+     * 获取或创建路径节点
+     */
+    private _getOrCreateNodeByPath;
+    /**
+     * 确保路径存在，如果不存在则创建空节点
+     */
+    private _ensurePathExists;
+    deleteNode(params: IDeleteNodeParams): Promise<IDeleteNodeResult | null>;
+    private _walkNode;
+    updateNode(params: IUpdateNodeParams): Promise<IUpdateNodeResult>;
+    queryNode(params: IQueryNodeParams): Promise<INode | null>;
+    queryNodeTree(params: IQueryNodeTreeParams): Promise<INodeTreeItem | null>;
+    /**
+     * 确保节点有 UITransform 组件
+     * 目前只需保障在创建空节点的时候检查任意上级是否为 canvas
+     */
+    ensureUITransformComponent(node: Node_2): void;
+    /**
+     * 检查并根据需要创建 canvas节点或为父级添加UITransform组件，返回父级节点，如果需要canvas节点，则父级节点会是canvas节点
+     * @param workMode
+     * @param canvasRequiredParam
+     * @param parent
+     * @param position
+     * @returns
+     */
+    checkCanvasRequired(workMode: string, canvasRequiredParam: boolean | undefined, parent: Node_2 | null, position: Vec3_2 | undefined): Promise<Node_2 | null>;
+    onEditorOpened(): void;
+    onEditorClosed(): void;
+    private readonly NodeHandlers;
+    private nodeHandlers;
+    /**
+     * 监听引擎发出的 node 事件
+     * @param {*} node
+     */
+    registerEventListeners(node: Node_2): void;
+    /**
+     * 取消监听引擎发出的node事件
+     * @param {*} node
+     */
+    unregisterEventListeners(node: Node_2): void;
+    private readonly NodeMgrEventHandlers;
+    private nodeMgrEventHandlers;
+    /**
+     * 注册引擎 Node 管理相关事件的监听
+     */
+    registerNodeMgrEvents(): void;
+    unregisterNodeMgrEvents(): void;
+    onNodeTransformChanged(node: Node_2, transformBit: TransformBit): void;
+    onNodeSizeChanged(node: Node_2): void;
+    onNodeAnchorChanged(node: Node_2): void;
+    onNodeParentChanged(parent: Node_2, child: Node_2): void;
+    onLightProbeChanged(node: Node_2): void;
+    /**
+     * 添加一个节点到管理器内
+     * @param uuid
+     * @param {*} node
+     */
+    add(uuid: string, node: Node_2): void;
+    /**
+     * 一个节点被修改,由 EditorExtends.Node.emit('change') 触发
+     * @param uuid
+     * @param node
+     */
+    change(uuid: string, node: Node_2): void;
+    /**
+     * 从管理器内移除一个指定的节点
+     * @param uuid
+     * @param {*} node
+     */
+    remove(uuid: string, node: Node_2): void;
+}
+
+declare enum NodeType {
+    EMPTY = 'Empty',// 空节点
+    TERRAIN = 'Terrain',// 地形节点
+    CAMERA = 'Camera',// 摄像机节点(需要用过 TWorkMode 来区分 2D 和 3D)
+    SPRITE = 'Sprite',// 精灵节点(需要用过 TWorkMode 来区分 2D 和 3D)
+    SPRITE_SPLASH = 'SpriteSplash',// 单色
+    GRAPHICS = 'Graphics',// 图形节点
+    LABEL = 'Label',// 文本节点
+    MASK = 'Mask',// 遮罩节点
+    PARTICLE = 'Particle',// 粒子节点(需要用过 TWorkMode 来区分 2D 和 3D)
+    TILED_MAP = 'TiledMap',// 瓦片地图节点
+    CAPSULE = 'Capsule',// 胶囊体节点
+    CONE = 'Cone',// 圆锥体节点
+    CUBE = 'Cube',// 立方体节点
+    CYLINDER = 'Cylinder',// 圆柱体节点
+    PLANE = 'Plane',// 平面节点
+    QUAD = 'Quad',// 四边形节点
+    SPHERE = 'Sphere',// 球体节点
+    TORUS = 'Torus',// 圆环体节点
+    BUTTON = 'Button',// 按钮节点
+    CANVAS = 'Canvas',// 画布节点(需要用过 TWorkMode 来区分 2D 和 3D)
+    EDIT_BOX = 'EditBox',// 输入框节点
+    LAYOUT = 'Layout',// 布局节点
+    PAGE_VIEW = 'PageView',// 页面视图节点
+    PROGRESS_BAR = 'ProgressBar',// 进度条节点
+    RICH_TEXT = 'RichText',// 富文本节点
+    SCROLL_VIEW = 'ScrollView',// 滚动视图节点
+    SLIDER = 'Slider',// 滑动条节点
+    TOGGLE = 'Toggle',// 切换节点
+    TOGGLE_GROUP = 'ToggleGroup',// 切换组节点
+    VIDEO_PLAYER = 'VideoPlayer',// 视频播放器节点
+    WEB_VIEW = 'WebView',// 网页视图节点
+    WIDGET = 'Widget',// 小部件节点
+    DIRECTIONAL_LIGHT = 'Light-Directional',// 平行光
+    SPHERE_LIGHT = 'Light-Sphere',// 球面光
+    SPOT_LIGHT = 'Light-Spot',// 聚光灯
+    PROBE_LIGHT = 'Light-Probe-Group',// 光照探针
+    REFLECTION_LIGHT = 'Light-Reflection-Probe'
+}
+
+declare enum NormalImportSetting {
+    /**
+     * 如果模型文件中包含法线信息则导出法线，否则不导出法线。
+     */
+    optional = 0,
+    /**
+     * 不在导出的网格中包含法线信息。
+     */
+    exclude = 1,
+    /**
+     * 如果模型文件中包含法线信息则导出法线，否则重新计算并导出法线。
+     */
+    require = 2,
+    /**
+     * 不管模型文件中是否包含法线信息，直接重新计算并导出法线。
+     */
+    recalculate = 3
+}
+
+declare enum OptimizationPolicy {
+    AUTO = 0,
+    SINGLE_INSTANCE = 1,
+    MULTI_INSTANCE = 2
+}
+
+/** 粒子资源的 userData */
+declare interface ParticleAssetUserData {
+    totalParticles: number;
+    life: number;
+    lifeVar: number;
+    emissionRate: number;
+    duration: number;
+    srcBlendFactor: number;
+    dstBlendFactor: number;
+    startColor: any;
+    startColorVar: any;
+    endColor: any;
+    endColorVar: any;
+    startSize: number;
+    startSizeVar: number;
+    endSize: number;
+    endSizeVar: number;
+    positionType: number;
+    sourcePos: any;
+    posVar: any;
+    angle: number;
+    angleVar: number;
+    startSpin: number;
+    startSpinVar: number;
+    endSpin: number;
+    endSpinVar: number;
+    emitterMode: number;
+    gravity: any;
+    speed: number;
+    speedVar: number;
+    radialAccel: number;
+    radialAccelVar: number;
+    tangentialAccel: number;
+    tangentialAccelVar: number;
+    rotationIsDir: boolean;
+    startRadius: number;
+    startRadiusVar: number;
+    endRadius: number;
+    endRadiusVar: number;
+    rotatePerS: number;
+    rotatePerSVar: number;
+    spriteFrameUuid: string;
+}
+
+/** JavaScript 插件脚本的 userData */
+declare interface PluginScriptUserData {
+    isPlugin: true;
+    /** 界面没有开放给用户。默认开启 */
+    experimentalHideCommonJs?: boolean;
+    /** 界面没有开放给用户。默认开启 */
+    experimentalHideAmd?: boolean;
+    /** 仅当 executionScope 为 enclosed 时有效。指定了要模拟的全局变量 */
+    simulateGlobals?: string[];
+    /** 执行作用域 */
+    executionScope?: 'enclosed' | 'global';
+    /** 插件执行时机 */
+    loadPluginInEditor?: boolean;
+    loadPluginInWeb?: boolean;
+    loadPluginInMiniGame?: boolean;
+    loadPluginInNative?: boolean;
+}
+
+/** 场景/预制体资源的 userData */
+declare interface PrefabAssetUserData {
+    /** 是否为持久节点 */
+    persistent?: boolean;
+    /** 同步节点名称 */
+    syncNodeName?: string;
+}
+
+export declare class PrefabService extends BaseService<IPrefabEvents> implements IPrefabService {
+    private _softReloadTimer;
+    private _utils;
+    init(): void;
+    /**
+     * 将节点转换为预制体资源
+     */
+    createPrefabFromNode(params: ICreatePrefabFromNodeParams): Promise<INode>;
+    /**
+     * 将节点的修改应用回预制体资源
+     */
+    applyPrefabChanges(params: IApplyPrefabChangesParams): Promise<boolean>;
+    /**
+     * 重置节点到预制体原始状态
+     */
+    revertToPrefab(params: IRevertToPrefabParams): Promise<boolean>;
+    /**
+     * 解耦预制体实例，使其成为普通节点
+     */
+    unpackPrefabInstance(params: IUnpackPrefabInstanceParams): Promise<INode>;
+    /**
+     * 检查节点是否为预制体实例
+     */
+    isPrefabInstance(params: IIsPrefabInstanceParams): Promise<boolean>;
+    /**
+     * 获取节点的预制体信息
+     */
+    getPrefabInfo(params: IGetPrefabInfoParams): Promise<IPrefabInfo | null>;
+    onEditorOpened(): void;
+    onNodeRemoved(node: Node_2): void;
+    onNodeChangedInGeneralMode(node: Node_2, opts: IChangeNodeOptions, root: Node_2 | Scene | null): void;
+    onAddNode(node: Node_2): void;
+    onNodeAdded(node: Node_2): void;
+    onNodeChanged(node: Node_2, opts?: IChangeNodeOptions): void;
+    onSetPropertyComponent(comp: Component, opts?: IChangeNodeOptions): void;
+    removePrefabInfoFromNode(node: Node_2, removeNested?: boolean): void;
+    checkToRemoveTargetOverride(source: Node_2 | Component, root: Node_2 | Scene | null): void;
+    /**
+     * 从一个节点生成一个PrefabAsset
+     * @param nodeUUID
+     * @param url
+     * @param options
+     */
+    createPrefabAssetFromNode(nodeUUID: string, url: string, options?: {
+        undo: boolean;
+        overwrite: boolean;
+    }): Promise<Node_2 | null>;
+    /**
+     * 将一个 node 与一个 prefab 关联到一起
+     * @param nodeUUID
+     * @param {*} assetUuid 关联的资源
+     */
+    linkNodeWithPrefabAsset(nodeUUID: string | Node_2, assetUuid: string | any): Promise<void>;
+    /**
+     * 从一个节点生成 prefab数据
+     * 返回序列化数据
+     * @param {*} nodeUUID
+     */
+    generatePrefabDataFromNode(nodeUUID: string | Node_2): {
+        prefabData: string;
+        clearedReference: any;
+    } | null;
+    /**
+     * 还原一个PrefabInstance的数据为它所关联的PrefabAsset
+     * @param nodeUUID node
+     */
+    revertPrefab(nodeUUID: Node_2 | string): Promise<boolean>;
+    getUnlinkNodeUuids(uuid: string, removeNested?: boolean): string[];
+    /**
+     * 解除PrefabInstance对PrefabAsset的关联
+     * @param nodeUUID 节点或节点的UUID
+     * @param removeNested 是否递归的解除子节点PrefabInstance
+     */
+    unWrapPrefabInstance(nodeUUID: string, removeNested?: boolean): boolean;
+    unWrapPrefabInstanceInPrefabMode(nodeUUID: string | Node_2, removeNested?: boolean): boolean;
+    /**
+     * 将一个PrefabInstance的数据应用到对应的Asset资源上
+     * @param nodeUUID uuid
+     */
+    applyPrefab(nodeUUID: string): Promise<boolean>;
+    onAddComponent(comp: Component): void;
+    onComponentAdded(comp: Component): void;
+    onRemoveComponentInGeneralMode(comp: Component, rootNode: Node_2 | Scene | null): void;
+    onComponentRemovedInGeneralMode(comp: Component, rootNode: Node_2 | Scene | null): void;
+    revertRemovedComponent(nodeUUID: string, fileID: string): Promise<void>;
+    applyRemovedComponent(nodeUUID: string, fileID: string): Promise<void>;
+    onAssetChanged(uuid: string): Promise<void>;
+    onAssetDeleted(uuid: string): Promise<void>;
+    /**
+     * 将一个节点恢复到关联的 prefab 的状态
+     * @param {*} nodeUuid
+     */
+    revert(nodeUuid: string): void;
+    /**
+     * 将一个节点的修改，应用到关联的 prefab 上
+     * @param {*} nodeUuid
+     */
+    sync(nodeUuid: string): void;
+    createNodeFromPrefabAsset(asset: any): Node_2 | null;
+    filterChildOfAssetOfPrefabInstance(uuids: string | string[], operationTips: string): string[];
+    filterPartOfPrefabAsset(uuids: string | string[], operationTips: string): string[];
+    filterChildOfPrefabAssetWhenRemoveNode(uuids: string | string[]): string[];
+    filterChildOfPrefabAssetWhenSetParent(uuids: string | string[]): string[];
+    canModifySibling(uuid: string, target: number, offset: number): boolean;
+    filterPartOfPrefabAssetWhenCreateComponent(uuids: string | string[]): string[];
+    filterPartOfPrefabAssetWhenRemoveComponent(uuids: string | string[]): string[];
+    /**
+     * 暴力遍历root所有属性，找到rule返回true的路径
+     * 比如找Scene节点的路径，rule = (obj)=> return obj.globals
+     * @param root 根节点
+     * @param rule 判断函数
+     * @returns
+     */
+    findPathWithRule(root: Node_2, rule: Function): string[];
+}
+
+declare enum PrefabState {
+    NotAPrefab = 0,// Normal node, not a Prefab
+    PrefabChild = 1,// Child node of a Prefab, without PrefabInstance
+    PrefabInstance = 2,// Root node of a Prefab that contains a PrefabInstance
+    PrefabLostAsset = 3
+}
+
+/** 类装饰器：注册 Service 类，自动收集所有公有方法 */
+export declare function register(name?: string): ClassDecorator;
+
+/**
+ * 重载结果
+ */
+declare enum ReloadResult {
+    SUCCESS = 0,
+    FAILED = 1,
+    QUEUED = 2,
+    NO_EDITOR = 3,
+    ASSET_NOT_FOUND = 4,
+    EDITOR_NOT_FOUND = 5
+}
+
+/** 渲染纹理资源的 userData */
+declare interface RenderTextureAssetUserData extends TextureBaseAssetUserData {
+    width: number;
+    height: number;
+}
+
+/** 渲染纹理精灵帧的 userData */
+declare interface RtSpriteFrameAssetUserData {
+    /** 图片 UUID 或数据库 URI */
+    imageUuidOrDatabaseUri: string;
+    /** 宽度 */
+    width?: number;
+    /** 高度 */
+    height?: number;
+}
+
+/**
+ * 场景模板类型
+ */
+declare const SCENE_TEMPLATE_TYPE: readonly ['2d', '3d', 'quality'];
+
+declare enum SceneModeType {
+    General = 'general',
+    Prefab = 'prefab',
+    Animation = 'animation',
+    Preview = 'preview',
+    Unset = ''
+}
+
+/** JavaScript 脚本模块的 userData */
+declare interface ScriptModuleUserData {
+    isPlugin: false;
+}
+
+export declare class ScriptService extends BaseService<IScriptEvents> implements IScriptService {
+    private _executor;
+    private _suspendPromise;
+    private _syncPluginScripts;
+    private _reloadScripts;
+    /**
+     * 非引擎定义的组件
+     * @private
+     */
+    private customComponents;
+    constructor();
+    /**
+     * 挂起脚本管理器直到 `condition` 结束，才会进行下一次执行。
+     * @param condition
+     */
+    suspend(condition: Promise<void>): void;
+    init(): Promise<void>;
+    investigatePackerDriver(): Promise<void>;
+    /**
+     * 传入一个 uuid 返回这个 uuid 对应的脚本组件名字
+     * @param uuid
+     */
+    queryScriptName(uuid: string): Promise<string | null>;
+    /**
+     * 传入一个 uuid 返回这个 uuid 对应的脚本的 cid
+     * @param uuid
+     */
+    queryScriptCid(uuid: string): Promise<string | null>;
+    /**
+     * 是否是自定义脚本（不是引擎定义的组件）
+     * @param classConstructor
+     */
+    isCustomComponent(classConstructor: Function): boolean;
+    _loadScripts(): Promise<void>;
+    /**
+     * 加载脚本时触发
+     */
+    loadScript(): Promise<void>;
+    /**
+     * 删除脚本时触发
+     */
+    removeScript(): Promise<void>;
+    /**
+     * 脚本发生变化时触发
+     */
+    scriptChange(): Promise<void>;
+    private _executeAsync;
+    private _execute;
+    /**
+     * 防止插件脚本切换到项目脚本或者反之时，没有同步插件脚本列表
+     * 这里使用了 AsyncIterationConcurrency1 功能，为了防止被多次调用，进行了迭代合并
+     * @private
+     */
+    private _syncPluginScriptListAsync;
+    /**
+     * 同步插件脚本列表到 Executor
+     * @private
+     */
+    private _syncPluginScriptList;
+    private _handleImportException;
+}
+
+declare interface SerializedAssetFinder {
+    meshes?: Array<string | null>;
+    animations?: Array<string | null>;
+    skeletons?: Array<string | null>;
+    textures?: Array<string | null>;
+    materials?: Array<string | null>;
+    scenes?: Array<string | null>;
+}
+
+/**
+ * 全局代理：通过 Service.Editor.xxx() 访问
+ */
+export declare const Service: IServiceManager;
+
+/**
+ * 范例
+ * @register('Scene')
+ * class SceneManager {
+ *   loadScene(name: string) {
+ *     console.log(`loading scene: ${name}`);
+ *   }
+ *
+ *   unloadScene(name: string) {
+ *     console.log(`unloading scene: ${name}`);
+ *   }
+ *
+ *   private internal() {
+ *     console.log('private logic');
+ *   }
+ * }
+ *
+ * // 使用
+ * import { Service } from './service';
+ * Service.Editor.loadScene('Main');
+ */
+export declare type ServiceName = keyof IServiceManager;
+
+declare interface SimplifyOptions {
+    // 压缩比例
+    targetRatio?: number;
+    // 防止破面
+    enableSmartLink?: boolean;
+    // 误差距离
+    agressiveness?: number;
+    // 计算迭代次数
+    maxIterationCount?: number;
+}
+
+/** Spine 资源的 userData */
+declare interface SpineAssetUserData {
+    /** 图集资源的 UUID */
+    atlasUuid: string;
+}
+
+/** 精灵图集资源的 userData */
+declare interface SpriteAtlasAssetUserData {
+    /** 图集纹理名称 */
+    atlasTextureName: string;
+    /** 纹理 UUID */
+    textureUuid: string | null;
+    /** 精灵帧列表 */
+    frames: SpriteFrameAssetUserData[];
+    /** 资源 UUID */
+    uuid: string;
+    /** 格式版本 */
+    format: number;
+}
+
+declare interface SpriteFrameAssetUserData extends SpriteFrameBaseAssetUserData {
+    isUuid?: boolean;
+    imageUuidOrDatabaseUri: string;
+}
+
+declare interface SpriteFrameBaseAssetUserData {
+    trimType?: string;
+    trimThreshold: number;
+    rotated: boolean;
+    offsetX: number;
+    offsetY: number;
+    trimX: number;
+    trimY: number;
+    width: number;
+    height: number;
+    rawWidth: number;
+    rawHeight: number;
+    borderTop: number;
+    borderBottom: number;
+    borderLeft: number;
+    borderRight: number;
+    packable?: boolean;
+    pixelsToUnit: number;
+    pivotX: number;
+    pivotY: number;
+    meshType: number;
+    vertices: SpriteFrameVertices;
+}
+
+declare interface SpriteFrameVertices {
+    rawPosition: number[];
+    indexes: number[];
+    uv: number[];
+    nuv: number[];
+    triangles?: number[];
+    minPos: number[];
+    maxPos: number[];
+}
+
+/** 支持创建的资源类型常量数组（用于 Zod enum 和 TypeScript type） */
+declare const SUPPORT_CREATE_TYPES: readonly ['animation-clip', 'typescript', 'auto-atlas', 'effect', 'scene', 'prefab', 'material', 'terrain', 'physics-material', 'label-atlas', 'render-texture', 'directory', 'effect-header'];
+
+declare enum TangentImportSetting {
+    /**
+     * 不在导出的网格中包含正切信息。
+     */
+    exclude = 0,
+    /**
+     * 如果模型文件中包含正切信息则导出正切，否则不导出正切。
+     */
+    optional = 1,
+    /**
+     * 如果模型文件中包含正切信息则导出正切，否则若纹理坐标存在则重新计算并导出正切。
+     */
+    require = 2,
+    /**
+     * 不管模型文件中是否包含正切信息，直接重新计算并导出正切。
+     */
+    recalculate = 3
+}
+
+declare type TEditorEntity = IScene | INode;
+
+declare type TEditorInstance = Scene | Node_2;
+
+declare interface Texture2DAssetUserData extends TextureBaseAssetUserData {
+    isUuid?: boolean;
+    imageUuidOrDatabaseUri?: string;
+}
+
+declare interface TextureBaseAssetUserData {
+    wrapModeS: WrapMode;
+    wrapModeT: WrapMode;
+    minfilter: Filter;
+    magfilter: Filter;
+    mipfilter: Filter;
+    anisotropy: number;
+}
+
+declare interface TextureCubeAssetUserData extends TextureBaseAssetUserData {
+    imageDatabaseUri?: string;
+    isRGBE: boolean;
+
+    mipBakeMode: number;
+    /**
+     * `0` 意味着默认。见 https://github.com/cocos-creator/3d-tasks/issues/2253
+     */
+    faceSize?: number;
+    // 符号资源 uuid
+    sign?: string;
+
+    // 六个面的 UUID
+    front?: string;
+    back?: string;
+    left?: string;
+    right?: string;
+    top?: string;
+    bottom?: string;
+}
+
+declare type TSceneTemplateType = typeof SCENE_TEMPLATE_TYPE[number];
+
+declare interface Vec2 {
+    x: number;
+    y: number;
+}
+
+declare interface Vec3 {
+    x: number;
+    y: number;
+    z: number;
+}
+
+declare interface Vec4 {
+    x: number;
+    y: number;
+    z: number;
+    w: number;
+}
+
+declare type WrapMode = 'repeat' | 'clamp-to-edge' | 'mirrored-repeat';
+
+export { };