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

package/{service.d.ts → cli.d.ts}

@@ -1,10 +1,7 @@
-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';
+import type { Component } from 'cc';
+import type { Node as Node_2 } from 'cc';
+import type { Scene } from 'cc';
+import type { Vec3 as Vec3_2 } from 'cc';
 
 /** 动画剪辑资源的 userData */
 declare interface AnimationClipAssetUserData {
@@ -107,24 +104,6 @@ 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;
@@ -193,43 +172,6 @@ declare interface AutoAtlasAssetUserData {
     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 {
     /** 字体配置 */
@@ -240,78 +182,6 @@ declare interface BitmapFontAssetUserData {
     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>;
-}
-
 /**
  * 创建类型
  */
@@ -329,45 +199,6 @@ declare interface DirectoryAssetUserData {
     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 {
     /** 预编译组合 */
@@ -376,46 +207,6 @@ declare interface EffectAssetUserData {
     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 {
@@ -442,21 +233,72 @@ 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[];
+export declare class GlobalEventManager {
+    /**
+     * 监听指定类型的事件（类型安全版本）
+     * @param event 事件名称
+     * @param listener 事件监听器
+     */
+    on<TEvents extends Record<string, any>>(event: keyof TEvents, listener: TEvents[keyof TEvents] extends void ? () => void : (payload: TEvents[keyof TEvents]) => void): void;
+    /**
+     * 监听指定类型的事件（通用版本）
+     * @param event 事件名称
+     * @param listener 事件监听器
+     */
+    on(event: string, listener: (...args: any[]) => void): void;
+    /**
+     * 监听指定类型的事件（一次性，类型安全版本）
+     * @param event 事件名称
+     * @param listener 事件监听器
+     */
+    once<TEvents extends Record<string, any>>(event: keyof TEvents, listener: TEvents[keyof TEvents] extends void ? () => void : (payload: TEvents[keyof TEvents]) => void): void;
+    /**
+     * 监听指定类型的事件（一次性，通用版本）
+     * @param event 事件名称
+     * @param listener 事件监听器
+     */
+    once(event: string, listener: (...args: any[]) => void): void;
+    /**
+     * 移除指定类型的事件监听器（类型安全版本）
+     * @param event 事件名称
+     * @param listener 事件监听器
+     */
+    off<TEvents extends Record<string, any>>(event: keyof TEvents, listener: TEvents[keyof TEvents] extends void ? () => void : (payload: TEvents[keyof TEvents]) => void): void;
+    /**
+     * 移除事件监听器（通用版本）
+     * @param event 事件名称
+     * @param listener 事件监听器
+     */
+    off(event: string, listener: (...args: any[]) => void): void;
+    /**
+     * 发射指定类型的事件（类型安全版本）
+     * @param event 事件名称
+     * @param args 事件参数
+     */
+    emit<TEvents extends Record<string, any>>(event: keyof TEvents, ...args: TEvents[keyof TEvents]): void;
+    /**
+     * 触发事件（通用版本）
+     * @param event 事件名称
+     * @param args 事件参数
+     */
+    emit(event: string, ...args: any[]): void;
+    /**
+     * 跨进程广播，传的参数需要能被序列化
+     * @param event 事件名称
+     * @param args 事件参数
+     */
+    broadcast<TEvents extends Record<string, any>>(event: keyof TEvents, ...args: TEvents[keyof TEvents]): void;
+    broadcast(event: string, ...args: any[]): void;
+    /**
+     * 清除事件监听器
+     * @param event 事件名称，如果不提供则清除所有
+     */
+    clear(event?: string): void;
+}
 
 /** glTF 动画资源的 userData */
 declare interface GltfAnimationAssetUserData {
@@ -640,7 +482,7 @@ declare interface GlTFUserData {
 }
 
 /**
- * 创建/添加组件
+ * 添加/创建组件的选项
  */
 declare interface IAddComponentOptions {
     nodePathOrUuid: string;
@@ -651,15 +493,6 @@ 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 地址
@@ -693,6 +526,7 @@ declare interface IAssetInfo {
     mtime?: number; // 资源文件的 mtime
     depends?: string[]; // 依赖的资源 uuid 信息
     dependeds?: string[]; // 被依赖的资源 uuid 信息
+    temp?: string; // 资源临时文件目录
 }
 
 declare interface IAssetMeta<T extends ISupportCreateType | 'unknown' = 'unknown'> {
@@ -771,6 +605,27 @@ declare interface IBaseIdentifier {
     assetType: string;
 }
 
+declare interface ICameraService {
+    init(): void;
+    initFromConfig(): Promise<void>;
+    is2D: boolean;
+    focus(nodes?: string[] | null, editorCameraInfo?: any, immediate?: boolean): void;
+    defaultFocus(uuid: string): void;
+    rotateCameraToDir(dir: Vec3_2, rotateByViewDist: boolean): void;
+    changeProjection(): void;
+    setGridVisible(value: boolean): void;
+    isGridVisible(): boolean;
+    setCameraProperty(options: any): void;
+    resetCameraProperty(): void;
+    getCameraFov(): number;
+    zoomUp(): void;
+    zoomDown(): void;
+    zoomReset(): void;
+    alignNodeToSceneView(nodes: string[]): void;
+    alignSceneViewToNode(nodes: string[]): void;
+    onUpdate(deltaTime: number): void;
+}
+
 declare interface IChangeNodeOptions {
     source?: 'editor' | 'undo' | 'engine';
     type?: NodeEventType;
@@ -780,6 +635,11 @@ declare interface IChangeNodeOptions {
     dumpImmediately?: boolean;
 }
 
+export declare interface ICLI {
+    Scene: IServiceManager;
+    SceneEvents: GlobalEventManager;
+}
+
 /**
  * 关闭场景/预制体选项
  */
@@ -788,7 +648,7 @@ declare interface ICloseOptions {
 }
 
 /**
- * 代表组件属性信息
+ * CLI 使用的组件信息，属性值以扁平的 key-value 形式呈现
  */
 declare interface IComponent extends IComponentIdentifier {
     properties: {
@@ -798,19 +658,10 @@ declare interface IComponent extends IComponentIdentifier {
 }
 
 /**
- * 场景事件类型
+ * 编辑器使用的组件详细信息，属性值以 IProperty 编码形式呈现，
+ * 包含 type、readonly、default 等元信息，用于编辑器 Inspector 面板渲染
  */
-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 {
+declare interface IComponentForEditor extends IProperty {
     value: {
         enabled: IPropertyValueType;
         uuid: IPropertyValueType;
@@ -820,7 +671,7 @@ declare interface IComponentForPinK extends IProperty {
 }
 
 /**
- * 代表一个组件
+ * 组件标识信息，包含组件的基本标识字段
  */
 declare interface IComponentIdentifier {
     cid: string;
@@ -832,50 +683,139 @@ declare interface IComponentIdentifier {
 }
 
 /**
- * 组件的相关处理接口
+ * 组件服务接口，定义了所有组件相关的操作方法
  */
 declare interface IComponentService extends IServiceEvents {
     /**
-     * 添加组件
-     * @param params
+     * 添加组件到指定节点，返回添加后的组件信息
+     * @param params - 添加组件选项
+     * @param params.nodePathOrUuid - 目标节点路径或 UUID
+     * @param params.component - 组件类名，支持精确匹配（'cc.Label'）和模糊匹配（'label'）
+     * @returns 添加成功后的组件信息
+     *
+     * @example
+     * ```ts
+     * // 通过节点路径 + 精确组件名
+     * const comp = await addComponent({ nodePathOrUuid: 'Canvas/MyNode', component: 'cc.Label' });
+     *
+     * // 通过节点 UUID + 模糊组件名
+     * const comp = await addComponent({ nodePathOrUuid: 'abc-123-uuid', component: 'label' });
+     * ```
      */
     addComponent(params: IAddComponentOptions): Promise<IComponent>;
     /**
-     * 创建组件
-     * @param params
-     */
-    createComponent(params: IAddComponentOptions): Promise<boolean>;
-    /**
-     * 删除组件
-     * @param params
+     * 删除指定组件
+     * @param params - 删除组件选项
+     * @param params.path - 组件路径，支持路径、UUID 或资源 URL
+     * @returns 删除成功返回 true，失败返回 false
      */
     removeComponent(params: IRemoveComponentOptions): Promise<boolean>;
     /**
      * 设置组件属性
-     * @param params
+     * - CLI 调用时传入 ISetPropertyOptions，通过 componentPath 定位，属性为扁平键值对
+     * - 编辑器调用时传入 ISetPropertyOptionsForEditor，通过节点 UUID + dump 路径定位，属性为 IProperty 格式
+     *
+     * @param params - 设置属性选项，根据调用方不同传入不同类型
+     * @returns 设置成功返回 true，失败返回 false
+     *
+     * @example
+     * ```ts
+     * // CLI 方式：通过 componentPath 定位，直接传属性键值对
+     * await setProperty({
+     *     componentPath: 'Canvas/cc.Label_1',
+     *     properties: { string: 'Hello', fontSize: 32 },
+     * });
+     *
+     * // 编辑器方式：通过节点 UUID + dump 路径定位，传 IProperty 格式
+     * await setProperty({
+     *     uuid: 'node-uuid',
+     *     path: '__comps__.0.string',
+     *     dump: { value: 'Hello', type: 'String' },
+     * });
+     * ```
+     */
+    setProperty(params: ISetPropertyOptions | ISetPropertyOptionsForEditor): Promise<boolean>;
+    /**
+     * 查询组件信息
+     * - 传入 IQueryComponentOptions 时，返回 IComponent 或 IComponent
+     * - 传入 string 时，返回 IComponentForEditor
+     *
+     * @param params - 查询选项或组件路径字符串
+     * @returns 如果传入的是 IQueryComponentOptions 时返回 IComponent，如果传入是string时返回 IComponentForEditor，未找到返回 null
+     *
+     * @example
+     * ```ts
+     * CLI 模式：返回 IComponent（扁平属性）
+     * const comp = await queryComponent({ path: 'Canvas/cc.Label_1' }) as IComponent;
+     *
+     * 编辑器模式：直接传 string，这里是uuid，因为与cli重复了，也支持 path 和 url
+     * const comp = await queryComponent('uuid') as IComponentForEditor;
+     * ```
      */
-    setProperty(params: ISetPropertyOptions): Promise<boolean>;
+    queryComponent(params: IQueryComponentOptions | string): Promise<IComponent | IComponentForEditor | null>;
     /**
-     * 设置组件属性，pink专属接口，因为结构与ISetPropertyOptions是不同的
-     * @param params
+     * 获取所有已注册的组件类名，包含内置与自定义组件
+     * @returns 组件类名数组，如 ['cc.Label', 'cc.Sprite', 'MyCustomComponent']
      */
-    setPropertyForPink(uuid: string, path: string, dump: IProperty, record?: boolean): Promise<boolean>;
+    queryAllComponent(): Promise<string[]>;
     /**
-     * 查询组件
+     * 创建组件（编辑器使用），与 addComponent 不同的是仅返回是否成功
+     * @param params - 添加组件选项
+     * @param params.nodePathOrUuid - 目标节点路径或 UUID
+     * @param params.component - 组件类名
+     * @returns 创建成功返回 true，失败返回 false
      */
-    queryComponent(params: IQueryComponentOptions): Promise<IComponent | IComponentForPinK | null>;
+    createComponent(params: IAddComponentOptions): Promise<boolean>;
     /**
-     * 获取所有组件名，包含内置与自定义组件
+     * 复位组件，将组件所有属性恢复为默认值
+     * @param params - 查询组件选项，用于定位要复位的组件
+     * @param params.path - 组件路径，支持路径、UUID 或资源 URL
+     * @returns 复位成功返回 true，失败返回 false
      */
-    queryAllComponent(): Promise<string[]>;
+    resetComponent(params: IQueryComponentOptions): Promise<boolean>;
     /**
-     * 复位组件
+     * 获取所有注册类名，支持按继承关系过滤
+     * @param options - 过滤选项，不传则返回所有注册类
+     * @param options.extends - 父类名称，只返回继承自该类的子类，支持字符串或字符串数组
+     * @param options.excludeSelf - 是否排除父类自身，默认 false
+     * @returns 类名对象数组，如 [{ name: 'cc.Label' }, { name: 'cc.Sprite' }]
+     *
+     * @example
+     * ```ts
+     * // 查询所有注册类
+     * const all = await queryClasses();
+     *
+     * // 查询 cc.Component 的所有子类（含自身）
+     * const comps = await queryClasses({ extends: 'cc.Component' });
+     *
+     * // 查询 cc.Component 的所有子类（排除自身）
+     * const subComps = await queryClasses({ extends: 'cc.Component', excludeSelf: true });
+     * ```
      */
-    resetComponent(params: IQueryComponentOptions): Promise<boolean>;
+    queryClasses(options?: IQueryClassesOptions): Promise<{
+        name: string;
+    }[]>;
+    /**
+     * 查询指定节点上所有组件暴露的可调用函数
+     * @param uuid - 节点 UUID
+     * @returns 节点上组件的函数信息，节点不存在时返回空对象
+     */
+    queryComponentFunctionOfNode(uuid: string): Promise<any>;
     /**
-     * 执行组件方法
+     * 执行组件上的指定方法
+     * @param options - 执行选项
+     * @param options.uuid - 组件实例的 UUID
+     * @param options.name - 要执行的方法名，如 'onLoad'、'start'
+     * @param options.args - 方法参数列表
+     * @returns 执行成功返回 true，失败返回 false
      */
     executeComponentMethod(options: IExecuteComponentMethodOptions): Promise<boolean>;
+    /**
+     * 查询指定名称的组件是否已注册（是否存在对应脚本）
+     * @param name - 组件类名，如 'cc.Label'
+     * @returns 存在返回 true，不存在返回 false
+     */
+    queryComponentHasScript(name: string): Promise<boolean>;
     init(): void;
     unregisterCompMgrEvents(): void;
 }
@@ -922,16 +862,6 @@ declare interface IDeleteNodeResult {
     path: string;
 }
 
-/**
- * 事件类型
- */
-declare interface IEditorEvents {
-    'editor:open': [];
-    'editor:close': [];
-    'editor:save': [];
-    'editor:reload': [];
-}
-
 declare interface IEditorService extends IServiceEvents {
     /**
      * 当前编辑器类型
@@ -976,11 +906,6 @@ declare interface IEditorService extends IServiceEvents {
     unlock(): void;
 }
 
-declare interface IEngineEvents {
-    'engine:update': [];
-    'engine:ticked': [];
-}
-
 declare interface IEngineService extends IServiceEvents {
     /**
      * 初始化引擎服务，目前是暂时引擎 mainLoop
@@ -993,7 +918,7 @@ declare interface IEngineService extends IServiceEvents {
 }
 
 /**
- * 执行组件方法选项
+ * 执行组件方法的选项
  */
 declare interface IExecuteComponentMethodOptions {
     uuid: string;
@@ -1041,6 +966,28 @@ declare interface IGetPrefabInfoParams {
     nodePath: string;
 }
 
+declare interface IGizmoService {
+    gizmoRootNode: any;
+    foregroundNode: any;
+    backgroundNode: any;
+    transformToolData: any;
+    transformToolName: string;
+    isViewMode: boolean;
+    init(): void;
+    initFromConfig(): Promise<void>;
+    saveConfig(): Promise<void>;
+    changeTool(name: string): void;
+    setCoordinate(coord: 'local' | 'global'): void;
+    setPivot(pivot: 'pivot' | 'center'): void;
+    lockGizmoTool(locked: boolean): void;
+    setIconVisible(visible: boolean): void;
+    showAllGizmoOfNode(node: any, recursive?: boolean): void;
+    removeAllGizmoOfNode(node: any, recursive?: boolean): void;
+    clearAllGizmos(): void;
+    callAllGizmoFuncOfNode(node: any, funcName: string, ...params: any[]): boolean;
+    onUpdate(deltaTime: number): void;
+}
+
 declare interface IIsPrefabInstanceParams {
     nodePath: string;
 }
@@ -1110,20 +1057,6 @@ declare interface INode extends INodeIdentifier {
     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;
@@ -1186,6 +1119,7 @@ declare interface INodeTreeItem {
     active: boolean;
     locked: boolean;
     type: string;
+    uuid: string;
     children: INodeTreeItem[];
     prefab: IPrefabStateInfo;
     parent: string;
@@ -1203,8 +1137,14 @@ declare interface IOpenOptions {
     simpleNode?: boolean;
 }
 
-export declare interface IOptionBase {
-    modeName?: string;
+declare interface IOperationService {
+    addListener(type: OperationEvent, listener: Function, priority?: number): void;
+    removeListener(type: OperationEvent, listener: Function): void;
+    dispatch(type: OperationEvent, ...args: any[]): void;
+    emitMouseEvent(type: string, event: ISceneMouseEvent, dpr?: number): void;
+    requestPointerLock(): void;
+    exitPointerLock(): void;
+    changePointer(type: string): void;
 }
 
 declare interface IPrefab {
@@ -1215,12 +1155,6 @@ declare interface IPrefab {
     persistent: boolean;
 }
 
-/**
- * 预制体事件类型
- */
-declare interface IPrefabEvents {
-}
-
 declare interface IPrefabInfo {
     /** 关联的预制体资源信息 */
     asset?: IPrefab;
@@ -1369,11 +1303,18 @@ declare interface IQuat {
 }
 
 /**
- * 查询组件
+ * 查询注册类的过滤选项
+ */
+declare interface IQueryClassesOptions {
+    extends?: string | string[];
+    excludeSelf?: boolean;
+}
+
+/**
+ * 查询组件的选项
  */
 declare interface IQueryComponentOptions {
-    pathOrUuidOrUrl: string;
-    isFull?: boolean;
+    path: string;
 }
 
 declare interface IQueryNodeParams {
@@ -1401,10 +1342,10 @@ declare interface IReloadOptions {
 }
 
 /**
- * 删除组件
+ * 删除组件的选项
  */
 declare interface IRemoveComponentOptions {
-    pathOrUuidOrUrl: string;
+    path: string;
 }
 
 declare interface IRevertToPrefabParams {
@@ -1428,18 +1369,41 @@ declare interface IScene extends IBaseIdentifier {
     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 ISceneMouseEvent {
+    x: number;
+    y: number;
+    clientX: number;
+    clientY: number;
+    deltaX: number;
+    deltaY: number;
+    wheelDeltaX: number;
+    wheelDeltaY: number;
+    moveDeltaX: number;
+    moveDeltaY: number;
+    leftButton: boolean;
+    middleButton: boolean;
+    rightButton: boolean;
+    button: number;
+    buttons: number;
+    ctrlKey: boolean;
+    shiftKey: boolean;
+    altKey: boolean;
+    metaKey: boolean;
+    hitPoint?: any;
+    type?: string;
+    handleName?: string;
 }
 
-declare interface IScriptEvents {
-    /**
-     * 当脚本刷新并执行完成时触发
-     */
-    'script:execution-finished': [];
+declare interface ISceneViewService {
+    init(): void;
+    initFromConfig(): Promise<void>;
+    saveConfig(): Promise<void>;
+    setSceneLightOn(enable: boolean): void;
+    querySceneLightOn(): boolean;
+    onSceneOpened(scene: any): void;
+    onSceneClosed(): void;
+    onComponentAdded(comp: Component): void;
+    onComponentRemoved(comp: Component): void;
 }
 
 declare interface IScriptService extends IServiceEvents {
@@ -1453,6 +1417,15 @@ declare interface IScriptService extends IServiceEvents {
     suspend(condition: Promise<any>): void;
 }
 
+declare interface ISelectionService {
+    select(uuid: string): void;
+    unselect(uuid: string): void;
+    clear(): void;
+    query(): string[];
+    isSelect(uuid: string): boolean;
+    reset(): void;
+}
+
 declare interface IServiceEvents {
     onEditorOpened?(): void;
     onEditorReload?(): void;
@@ -1480,9 +1453,12 @@ declare interface IServiceEvents {
     onAssetChanged?(uuid: string): void;
     onAssetRefreshed?(uuid: string): void;
     onScriptExecutionFinished?(): void;
+    onSelectionSelect?(uuid: string, uuids: string[]): void;
+    onSelectionUnselect?(uuid: string, uuids: string[]): void;
+    onSelectionClear?(): void;
 }
 
-declare interface IServiceManager {
+export declare interface IServiceManager {
     Editor: IEditorService;
     Node: INodeService;
     Component: IComponentService;
@@ -1490,10 +1466,16 @@ declare interface IServiceManager {
     Asset: IAssetService;
     Engine: IEngineService;
     Prefab: IPrefabService;
+    Selection: ISelectionService;
+    Operation: IOperationService;
+    Undo: IUndoService;
+    Camera: ICameraService;
+    Gizmo: IGizmoService;
+    SceneView: ISceneViewService;
 }
 
 /**
- * 查询组件
+ * CLI 设置组件属性的选项
  */
 declare interface ISetPropertyOptions {
     componentPath: string;
@@ -1503,6 +1485,16 @@ declare interface ISetPropertyOptions {
     record?: boolean;
 }
 
+/**
+ * 编辑器设置组件属性的选项
+ */
+declare interface ISetPropertyOptionsForEditor {
+    uuid: string;
+    path: string;
+    dump: IProperty;
+    record?: boolean;
+}
+
 declare type ISupportCreateCCType =
 | 'cc.AnimationClip'        // 动画剪辑
 | 'cc.Script'               // 脚本（TypeScript/JavaScript）
@@ -1535,6 +1527,17 @@ declare interface ITargetOverrideInfo {
     targetInfo: ITargetInfo | null;
 }
 
+declare interface IUndoService {
+    beginRecording(uuids: string[], options?: any): string;
+    endRecording(commandId: string): void;
+    cancelRecording(commandId: string): void;
+    undo(): Promise<void>;
+    redo(): Promise<void>;
+    snapshot(): void;
+    reset(): void;
+    isDirty(): boolean;
+}
+
 declare interface IUnpackPrefabInstanceParams {
     /** 要解耦的预制体实例节点 */
     nodePath: string;
@@ -1701,87 +1704,6 @@ declare enum NodeEventType {
     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',// 地形节点
@@ -1841,6 +1763,8 @@ declare enum NormalImportSetting {
     recalculate = 3
 }
 
+declare type OperationEvent = SceneDragEvent | SceneKeyboardEvent | SceneMouseEvent | 'resize';
+
 declare enum OptimizationPolicy {
     AUTO = 0,
     SINGLE_INSTANCE = 1,
@@ -1917,122 +1841,6 @@ declare interface PrefabAssetUserData {
     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
@@ -2040,9 +1848,6 @@ declare enum PrefabState {
     PrefabLostAsset = 3
 }
 
-/** 类装饰器：注册 Service 类，自动收集所有公有方法 */
-export declare function register(name?: string): ClassDecorator;
-
 /**
  * 重载结果
  */
@@ -2076,81 +1881,17 @@ declare interface RtSpriteFrameAssetUserData {
  */
 declare const SCENE_TEMPLATE_TYPE: readonly ['2d', '3d', 'quality'];
 
-declare enum SceneModeType {
-    General = 'general',
-    Prefab = 'prefab',
-    Animation = 'animation',
-    Preview = 'preview',
-    Unset = ''
-}
+declare type SceneDragEvent = 'onDragLeave' | 'onDragOver' | 'onDrop';
+
+declare type SceneKeyboardEvent = 'keydown' | 'keyup';
+
+declare type SceneMouseEvent = 'dblclick' | 'mousedown' | 'mousemove' | 'mouseup' | 'mousewheel';
 
 /** 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>;
@@ -2160,34 +1901,6 @@ declare interface SerializedAssetFinder {
     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;