@cocos/cocos-cli-types 0.0.1-alpha.21.2 → 0.0.1-alpha.22.2

package/service.d.ts

@@ -1,7 +1,16 @@
+import { Camera } from 'cc';
 import { default as cc_2 } from 'cc';
+import { Color } from 'cc';
 import { Component } from 'cc';
+import { EventEmitter } from 'events';
 import { GeometryRenderer as GeometryRenderer_2 } from 'cc';
+import { gfx } from 'cc';
+import { ISizeLike } from 'cc';
+import { IVec3Like } from 'cc';
+import { MeshRenderer } from 'cc';
 import { Node as Node_2 } from 'cc';
+import { Quat } from 'cc';
+import { Rect } from 'cc';
 import { Scene } from 'cc';
 import { TransformBit } from 'cc';
 import { Vec3 as Vec3_2 } from 'cc';
@@ -240,18 +249,343 @@ declare interface BitmapFontAssetUserData {
     textureUuid: string;
 }
 
+declare class CameraController2D extends CameraControllerBase {
+    private _size;
+    private _modeFSM;
+    private _idleMode;
+    private _panMode;
+    private _lineColor;
+    private _grid;
+    private _contentRect;
+    private _scale2D;
+    protected _wheelSpeed: number;
+    protected _near: number;
+    protected _far: number;
+    private _spaceKeyHeld;
+    private _posAnim;
+    isMoving(): boolean;
+    get lineColor(): Color;
+    set lineColor(value: Color);
+    get grid(): Grid;
+    get contentRect(): Rect;
+    get scale2D(): number;
+    /**
+     * 同步 scale2D 到 Gizmo（如果可用）
+     */
+    private setScale2D;
+    showGrid(visible: boolean): void;
+    init(camera: Camera): void;
+    private _initMode;
+    private _initGrid;
+    set active(value: boolean);
+    private _adjustToCenter;
+    private _fitSizeCalc;
+    private _getSizeScale;
+    adjustCamera(immediate?: boolean): void;
+    private _updateOrthoHeight;
+    private _updateGridData;
+    updateGrid(): void;
+    private initOriginAxis;
+    updateOriginAxisByConfig(config: {
+        x?: boolean;
+        y?: boolean;
+    }, update?: boolean): void;
+    updateOriginAxis(): void;
+    focus(nodeUuids: string[], editorCameraInfo?: EditorCameraInfo, immediate?: boolean): void;
+    smoothScale(delta: number, curScale: number): number;
+    scale(delta: number, offsetX?: number, offsetY?: number): void;
+    fitSize(rect: Rect): void;
+    onMouseDown(event: ISceneMouseEvent): void;
+    onMouseMove(event: ISceneMouseEvent): void;
+    onMouseUp(event: ISceneMouseEvent): void;
+    onMouseWheel(event: ISceneMouseEvent): void;
+    onMouseDBlDown(event: ISceneMouseEvent): void;
+    onKeyDown(event: ISceneKeyboardEvent): void;
+    onKeyUp(event: ISceneKeyboardEvent): void;
+    onUpdate(deltaTime: number): void;
+    onResize(size?: ISizeLike): void;
+    refresh(): void;
+    zoomTo(scaleValue: number): void;
+    zoomUp(): void;
+    zoomDown(): void;
+    zoomReset(): void;
+    onDesignResolutionChange(): void;
+}
+
+declare class CameraController3D extends CameraControllerBase {
+    protected _wheelSpeed: number;
+    protected _near: number;
+    protected _far: number;
+    private _orthoScale;
+    private _minScalar;
+    homePos: Vec3_2;
+    homeRot: Quat;
+    sceneViewCenter: Vec3_2;
+    viewDist: number;
+    forward: Vec3_2;
+    private _curRot;
+    private _curEye;
+    private _lineColor;
+    private v3a;
+    private v3b;
+    private q1;
+    lastMouseWheelDeltaY: number;
+    maxMouseWheelDeltaY: number;
+    private _modeFSM;
+    private _idleMode;
+    private _orbitMode;
+    private _panMode;
+    private _wanderMode;
+    view?: number;
+    private hTicks;
+    private vTicks;
+    shiftKey?: boolean;
+    altKey?: boolean;
+    mousePressing: boolean;
+    lastFocusNodeUUID: string[];
+    private _posAnim;
+    private _rotAnim;
+    private _distAnim;
+    constructor();
+    init(camera: Camera): void;
+    showGrid(visible: boolean): void;
+    private initOriginAxis;
+    updateOriginAxisByConfig(config: {
+        x?: boolean;
+        y?: boolean;
+        z?: boolean;
+    }, update?: boolean): void;
+    getOriginAxisData(): {
+        minH: number;
+        maxH: number;
+        minV: number;
+        maxV: number;
+        yDist: number;
+    };
+    updateOriginAxisHorizontal(): void;
+    updateOriginAxisVertical(): void;
+    updateOriginAxis(): void;
+    private _initMode;
+    private _initLinearTick;
+    set active(value: boolean);
+    get wanderSpeed(): number;
+    set wanderSpeed(value: number);
+    get enableAcceleration(): boolean;
+    set enableAcceleration(value: boolean);
+    changeMode(command: string): Promise<void>;
+    reset(): void;
+    updateViewCenterByDist(viewDist: number): void;
+    scale(delta: number): void;
+    smoothScale(delta: number): void;
+    focusByNode(nodes: Node_2[], notChangeDist?: boolean, immediate?: boolean): void;
+    focus(nodeUuids: string[], editorCameraInfo?: EditorCameraInfo, immediate?: boolean): void;
+    focusByXY(hitPoint: Vec3_2, immediate?: boolean): void;
+    alignNodeToSceneView(nodeUuids: string[]): void;
+    alignCameraOrthoHeightToNode(cameras: Camera[]): void;
+    alignSceneViewToNode(nodeUuids: string[]): void;
+    isMoving(): boolean;
+    onMouseDBlDown(event: ISceneMouseEvent): void;
+    onMouseDown(event: ISceneMouseEvent): void;
+    onMouseMove(event: ISceneMouseEvent): void;
+    onMouseUp(event: ISceneMouseEvent): void;
+    onMouseWheel(event: ISceneMouseEvent): void;
+    onKeyDown(event: ISceneKeyboardEvent): void;
+    onKeyUp(event: ISceneKeyboardEvent): void;
+    onUpdate(deltaTime: number): void;
+    onResize(size: ISizeLike): void;
+    private _updateGridData;
+    updateGrid(): void;
+    refresh(): void;
+    rotateCameraToDir(dir: Vec3_2, rotateByViewDist: boolean): void;
+    getDepthSize(): number;
+    calcCameraPosInOrtho(): Vec3_2;
+    isOrtho(): boolean;
+    setOrthoHeight(newOrthoHeight: number): void;
+    changeProjection(): void;
+    zoomUp(): void;
+    zoomDown(): void;
+    zoomReset(): void;
+    onDesignResolutionChange(): void;
+}
+
+declare abstract class CameraControllerBase extends EventEmitter {
+    protected _camera: Camera;
+    protected camera_move_mode: CameraMoveMode;
+    protected _gridMeshComp: MeshRenderer;
+    protected _originAxisHorizontalMeshComp: MeshRenderer;
+    protected _originAxisVerticalMeshComp: MeshRenderer;
+    node: Node_2;
+    protected _isGridVisible: boolean;
+    protected originAxisX_Visible: boolean;
+    protected originAxisY_Visible: boolean;
+    protected originAxisZ_Visible: boolean;
+    protected readonly originAxisX_Color: Color;
+    protected readonly originAxisY_Color: Color;
+    protected readonly originAxisZ_Color: Color;
+    protected _near: number;
+    protected _far: number;
+    protected _wheelSpeed: number;
+    protected _wheelBaseScale: number;
+    get near(): number;
+    set near(value: number);
+    get far(): number;
+    set far(value: number);
+    get wheelSpeed(): number;
+    set wheelSpeed(value: number);
+    init(camera: Camera): void;
+    focus(nodes: string[], editorCameraInfo?: EditorCameraInfo, immediate?: boolean): void;
+    alignNodeToSceneView(nodes: string[]): void;
+    alignSceneViewToNode(nodes: string[]): void;
+    abstract isMoving(): boolean;
+    onMouseDBlDown(event: any): void;
+    onMouseDown(event: any): void;
+    onMouseMove(event: any): void;
+    onMouseUp(event: any): void;
+    onMouseWheel(event: any): void;
+    onKeyDown(event: any): void;
+    onKeyUp(event: any): void;
+    onResize(size: ISizeLike): void;
+    onUpdate(deltaTime: number): void;
+    onDesignResolutionChange(): void;
+    refresh(): void;
+    updateGrid(): void;
+    showGrid(visible: boolean): void;
+    set isGridVisible(value: boolean);
+    get isGridVisible(): boolean;
+    set active(_value: boolean);
+    rotateCameraToDir(dir: Vec3_2, rotateByViewDist: boolean): void;
+    changeProjection(): void;
+    zoomUp(): void;
+    zoomDown(): void;
+    zoomReset(): void;
+}
+
+declare enum CameraMoveMode {
+    IDLE = 0,
+    ORBIT = 1,
+    PAN = 2,
+    ZOOM = 3,
+    WANDER = 4
+}
+
+/**
+ * 相机服务，管理编辑器相机的 2D/3D 控制器切换、输入事件绑定和相机属性
+ */
+export declare class CameraService extends BaseService<ICameraEvents> implements ICameraService {
+    private _controller2D;
+    private _controller3D;
+    private _controller;
+    private _camera;
+    private _controllerFirstChange;
+    private _currentUuid;
+    private _cameraInfos;
+    get controller2D(): CameraController2D;
+    get controller3D(): CameraController3D;
+    get controller(): CameraControllerBase;
+    get camera(): EditorCameraComponent;
+    set is2D(value: boolean);
+    get is2D(): boolean;
+    init(): void;
+    /**
+     * 场景就绪时调用，创建编辑器相机并初始化控制器
+     */
+    onEditorOpened(): void;
+    initFromConfig(): Promise<void>;
+    private bindOperation;
+    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;
+    private onMouseDBlDown;
+    private onMouseDown;
+    private onMouseMove;
+    private onMouseUp;
+    private onMouseWheel;
+    private onKeyDown;
+    private onKeyUp;
+    onResize(size: any): void;
+    refresh(): void;
+    getCamera(): EditorCameraComponent;
+    /**
+     * 与原始编辑器 ScenePreview.detachSceneCameras 一致：
+     * 将所有非编辑器的场景相机从渲染管线中移除，并设置 tempWindow
+     * 使后续新建的相机默认渲染到离屏窗口，不干扰编辑器相机。
+     */
+    private _detachSceneCameras;
+    /**
+     * 新增的 Camera 组件也需要 detach，与原始编辑器 ScenePreview.onComponentAdded 一致
+     */
+    detachNewSceneCamera(comp: any): void;
+    private _focusOnSceneContent;
+    /**
+     * 场景保存时调用，可通过 RPC 持久化相机配置
+     */
+    onEditorSaved(): void;
+    onComponentAdded(comp: any): void;
+}
+
 /**
  * 子进程节点处理器
  * 在子进程中处理所有节点相关操作
  */
 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 | null>;
-    setProperty(options: ISetPropertyOptions): Promise<boolean>;
+    queryComponentImpl(params: IQueryComponentOptions, isEditor?: boolean): Promise<IComponent | IComponentForEditor | null>;
+    queryComponent(params: IQueryComponentOptions | string): Promise<IComponent | IComponentForEditor | null>;
+    setPropertyForCli(options: ISetPropertyOptions): Promise<boolean>;
+    setProperty(options: ISetPropertyOptions | ISetPropertyOptionsForEditor): Promise<boolean>;
+    /**
+     * 查询一个节点的实例
+     * @param {*} uuid
+     * @return {cc.Node}
+     */
+    query(uuid: string | undefined): Node_2 | null;
+    setPropertyForEditor(options: ISetPropertyOptionsForEditor): Promise<boolean>;
     private setPropertyImp;
     queryAllComponent(): Promise<string[]>;
+    queryComponentHasScript(name: string): Promise<boolean>;
+    queryClasses(options?: IQueryClassesOptions): Promise<{
+        name: string;
+    }[]>;
+    queryComponentFunctionOfNode(uuid: string): Promise<any>;
     init(): void;
     private readonly CompMgrEventHandlers;
     private compMgrEventHandlers;
@@ -272,6 +606,12 @@ export declare class ComponentService extends BaseService<IComponentEvents> impl
      * @param {cc.Component} component
      */
     remove(uuid: string, component: Component): void;
+    /**
+     * 重置组件
+     * @param uuid component 的 uuid
+     */
+    resetComponent(params: IQueryComponentOptions): Promise<boolean>;
+    executeComponentMethod(options: IExecuteComponentMethodOptions): Promise<boolean>;
 }
 
 /**
@@ -291,6 +631,44 @@ declare interface DirectoryAssetUserData {
     priority?: number;
 }
 
+declare class EditorCameraComponent extends Camera {
+    private _uiEditorGizmoCamera;
+    set projection(val: number);
+    get projection(): number;
+    set fov(val: number);
+    get fov(): number;
+    set orthoHeight(val: number);
+    get orthoHeight(): number;
+    set near(val: number);
+    get near(): number;
+    set far(val: number);
+    get far(): number;
+    set clearColor(val: Color);
+    get clearColor(): Color;
+    set clearDepth(val: number);
+    get clearDepth(): number;
+    set clearStencil(val: number);
+    get clearStencil(): number;
+    set clearFlags(val: gfx.ClearFlags);
+    get clearFlags(): gfx.ClearFlags;
+    set rect(val: Rect);
+    get rect(): Rect;
+    set screenScale(val: number);
+    get screenScale(): number;
+    onLoad(): void;
+    onEnable(): void;
+    onDisable(): void;
+    onDestroy(): void;
+    _createCamera(): void;
+}
+
+declare interface EditorCameraInfo {
+    position?: Vec3_2;
+    rotation?: Quat;
+    viewCenter?: Vec3_2;
+    viewDist?: number;
+}
+
 /**
  * EditorAsset - 统一的编辑器管理入口
  * 作为调度器，根据资源类型动态创建和管理编辑器实例
@@ -420,6 +798,122 @@ declare class GeometryRenderer {
  */
 export declare function getServiceAll(): any[];
 
+export declare class GizmoService extends BaseService<IGizmoEvents> implements IGizmoService {
+    gizmoRootNode: Node_2;
+    foregroundNode: Node_2;
+    backgroundNode: Node_2;
+    transformToolData: TransformToolData;
+    private _gizmoOperation;
+    private _iconVisible;
+    private _selection;
+    private _componentPool;
+    private _iconPool;
+    private _persistentPool;
+    get transformToolName(): string;
+    get 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;
+    private _getPool;
+    private _createGizmo;
+    private _showGizmo;
+    private _hideGizmo;
+    private _removeGizmo;
+    showAllGizmoOfNode(node: Node_2, recursive?: boolean): void;
+    removeAllGizmoOfNode(node: Node_2, recursive?: boolean): void;
+    clearAllGizmos(): void;
+    callAllGizmoFuncOfNode(node: Node_2, funcName: string, ...params: any[]): boolean;
+    onSelectionSelect(uuid: string): void;
+    onSelectionUnselect(uuid: string): void;
+    onSelectionClear(): void;
+    private _onNodeSelectionChanged;
+    onEditorOpened(): void;
+    onSceneOpened(): void;
+    onSceneClosed(): void;
+    onNodeChanged(node: Node_2): void;
+    onComponentAdded(comp: Component): void;
+    onComponentRemoved(comp: Component): void;
+    onNodeAdded(node: Node_2): void;
+    onNodeRemoved(node: Node_2): void;
+    private _showIconGizmosForScene;
+    private _walkSceneForIcons;
+    onUpdate(deltaTime: number): void;
+}
+
+export declare const globalEventEmitter: EventEmitter<[never]>;
+
+/**
+ * 全局事件管理器
+ * 统一管理所有服务的事件监听，支持类型安全的事件订阅
+ */
+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 {
     gltfIndex: number;
@@ -601,11 +1095,57 @@ declare interface GlTFUserData {
     };
 }
 
+declare class Grid {
+    private _canvasWidth;
+    private _canvasHeight;
+    hTicks: LinearTicks | null;
+    xAxisScale: number;
+    xAxisOffset: number;
+    xAnchor: number;
+    vTicks: LinearTicks | null;
+    yAxisScale: number;
+    yAxisOffset: number;
+    yAnchor: number;
+    private _xAnchorOffset;
+    private _yAnchorOffset;
+    pixelToValueH: Function | null;
+    valueToPixelH: Function | null;
+    pixelToValueV: Function | null;
+    valueToPixelV: Function | null;
+    xDirection: number;
+    yDirection: number;
+    xMinRange: number | null;
+    xMaxRange: number | null;
+    yMinRange: number | null;
+    yMaxRange: number | null;
+    constructor(canvasWidth: number, canvasHeight: number);
+    get canvasWidth(): number;
+    get canvasHeight(): number;
+    setAnchor(x: number, y: number): void;
+    setScaleH(lods: number[], minScale: number, maxScale: number): void;
+    setMappingH(minValue: number, maxValue: number, pixelRange: number): void;
+    setScaleV(lods: number[], minScale: number, maxScale: number): void;
+    setMappingV(minValue: number, maxValue: number, pixelRange: number): void;
+    pan(deltaPixelX: number, deltaPixelY: number): void;
+    panX(deltaPixelX: number): void;
+    panY(deltaPixelY: number): void;
+    xAxisScaleAt(pixelX: number, scale: number): void;
+    yAxisScaleAt(pixelY: number, scale: number): void;
+    xAxisSync(x: number, scaleX: number): void;
+    yAxisSync(y: number, scaleY: number): void;
+    resize(w: number, h: number): void;
+    get left(): any;
+    get right(): any;
+    get top(): any;
+    get bottom(): any;
+    updateRange(): void;
+}
+
 /**
- * 创建组件
+ * 添加/创建组件的选项
  */
 declare interface IAddComponentOptions {
-    nodePath: string;
+    nodePathOrUuid: string;
     component: string;
 }
 
@@ -655,6 +1195,7 @@ declare interface IAssetInfo {
     mtime?: number; // 资源文件的 mtime
     depends?: string[]; // 依赖的资源 uuid 信息
     dependeds?: string[]; // 被依赖的资源 uuid 信息
+    temp?: string; // 资源临时文件目录
 }
 
 declare interface IAssetMeta<T extends ISupportCreateType | 'unknown' = 'unknown'> {
@@ -733,6 +1274,33 @@ declare interface IBaseIdentifier {
     assetType: string;
 }
 
+declare interface ICameraEvents {
+    'camera:mode-change': [mode: number];
+    'camera:fov-changed': [fov: number];
+    'camera:projection-changed': [projection: number];
+}
+
+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;
@@ -750,7 +1318,7 @@ declare interface ICloseOptions {
 }
 
 /**
- * 代表组件属性信息
+ * CLI 使用的组件信息，属性值以扁平的 key-value 形式呈现
  */
 declare interface IComponent extends IComponentIdentifier {
     properties: {
@@ -760,19 +1328,33 @@ declare interface IComponent extends IComponentIdentifier {
 }
 
 /**
- * 场景事件类型
+ * 组件相关事件类型
  */
-declare interface IComponentEvents {
+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];
 }
 
 /**
- * 代表一个组件
+ * 编辑器使用的组件详细信息，属性值以 IProperty 编码形式呈现，
+ * 包含 type、readonly、default 等元信息，用于编辑器 Inspector 面板渲染
+ */
+declare interface IComponentForEditor extends IProperty {
+    value: {
+        enabled: IPropertyValueType;
+        uuid: IPropertyValueType;
+        name: IPropertyValueType;
+    } & Record<string, IPropertyValueType>;
+    mountedRoot?: string;
+}
+
+/**
+ * 组件标识信息，包含组件的基本标识字段
  */
 declare interface IComponentIdentifier {
     cid: string;
@@ -784,32 +1366,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
+     * 删除指定组件
+     * @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>;
     /**
-     * 查询组件
+     * 获取所有已注册的组件类名，包含内置与自定义组件
+     * @returns 组件类名数组，如 ['cc.Label', 'cc.Sprite', 'MyCustomComponent']
      */
-    queryComponent(params: IQueryComponentOptions): Promise<IComponent | null>;
+    queryAllComponent(): Promise<string[]>;
     /**
-     * 获取所有组件名，包含内置与自定义组件
+     * 创建组件（编辑器使用），与 addComponent 不同的是仅返回是否成功
+     * @param params - 添加组件选项
+     * @param params.nodePathOrUuid - 目标节点路径或 UUID
+     * @param params.component - 组件类名
+     * @returns 创建成功返回 true，失败返回 false
      */
-    queryAllComponent(): Promise<string[]>;
+    createComponent(params: IAddComponentOptions): Promise<boolean>;
+    /**
+     * 复位组件，将组件所有属性恢复为默认值
+     * @param params - 查询组件选项，用于定位要复位的组件
+     * @param params.path - 组件路径，支持路径、UUID 或资源 URL
+     * @returns 复位成功返回 true，失败返回 false
+     */
+    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 });
+     * ```
+     */
+    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;
 }
@@ -926,6 +1615,15 @@ declare interface IEngineService extends IServiceEvents {
     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
@@ -966,6 +1664,34 @@ declare interface IGetPrefabInfoParams {
     nodePath: string;
 }
 
+declare interface IGizmoEvents {
+    'gizmo:tool-changed': [name: string];
+    'gizmo:control-begin': [];
+    'gizmo:control-end': [];
+}
+
+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;
 }
@@ -1093,6 +1819,32 @@ declare interface INodeService extends IServiceEvents {
      * 查询节点
      */
     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;
+    uuid: string;
+    children: INodeTreeItem[];
+    prefab: IPrefabStateInfo;
+    parent: string;
+    path: string;
+    isScene: boolean;
+    readonly: boolean;
+    components: INodeTreeComponent[];
 }
 
 /**
@@ -1103,6 +1855,25 @@ declare interface IOpenOptions {
     simpleNode?: boolean;
 }
 
+export declare interface IOperationEvents {
+    'pointer-lock': [locked: boolean];
+    'pointer-change': [type: 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;
+}
+
+export declare interface IOptionBase {
+    modeName?: string;
+}
+
 declare interface IPrefab {
     name: string;
     uuid: string;
@@ -1169,16 +1940,86 @@ declare interface IPrefabService extends IServiceEvents {
     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[];
@@ -1195,7 +2036,15 @@ declare interface IQuat {
 }
 
 /**
- * 查询组件
+ * 查询注册类的过滤选项
+ */
+declare interface IQueryClassesOptions {
+    extends?: string | string[];
+    excludeSelf?: boolean;
+}
+
+/**
+ * 查询组件的选项
  */
 declare interface IQueryComponentOptions {
     path: string;
@@ -1207,6 +2056,10 @@ declare interface IQueryNodeParams {
     queryComponent: boolean;
 }
 
+declare interface IQueryNodeTreeParams {
+    path?: string;
+}
+
 declare interface IRedirectInfo {
     // 跳转资源的类型
     type: string;
@@ -1222,7 +2075,7 @@ declare interface IReloadOptions {
 }
 
 /**
- * 删除组件
+ * 删除组件的选项
  */
 declare interface IRemoveComponentOptions {
     path: string;
@@ -1249,6 +2102,66 @@ 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 ISceneKeyboardEvent {
+    key: string;
+    keyCode: number;
+    code: string;
+    repeat: boolean;
+    ctrlKey: boolean;
+    shiftKey: boolean;
+    altKey: boolean;
+    metaKey: boolean;
+}
+
+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 ISceneViewEvents {
+    'scene-view:light-changed': [isOn: boolean];
+    'scene-view:visibility-changed': [visible: boolean];
+}
+
+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 IScriptEvents {
     /**
      * 当脚本刷新并执行完成时触发
@@ -1263,10 +2176,25 @@ declare interface IScriptService extends IServiceEvents {
     scriptChange(): Promise<void>;
     queryScriptCid(uuid: string): Promise<string | null>;
     queryScriptName(uuid: string): Promise<string | null>;
-    isCustomComponent(classConstructor: Function): Promise<boolean>;
+    isCustomComponent(classConstructor: Function): boolean;
     suspend(condition: Promise<any>): void;
 }
 
+declare interface ISelectionEvents {
+    'selection:select': [uuid: string, uuids: string[]];
+    'selection:unselect': [uuid: string, uuids: string[]];
+    'selection:clear': [];
+}
+
+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;
@@ -1287,10 +2215,16 @@ declare interface IServiceEvents {
     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;
+    onSelectionSelect?(uuid: string, uuids: string[]): void;
+    onSelectionUnselect?(uuid: string, uuids: string[]): void;
+    onSelectionClear?(): void;
 }
 
 declare interface IServiceManager {
@@ -1301,10 +2235,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;
@@ -1314,6 +2254,25 @@ declare interface ISetPropertyOptions {
     record?: boolean;
 }
 
+/**
+ * 编辑器设置组件属性的选项
+ */
+declare interface ISetPropertyOptionsForEditor {
+    uuid: string;
+    path: string;
+    dump: IProperty;
+    record?: boolean;
+}
+
+declare interface ISnapConfigData {
+    position: IVec3Like;
+    rotation: number;
+    scale: number;
+    isPositionSnapEnabled: boolean;
+    isRotationSnapEnabled: boolean;
+    isScaleSnapEnabled: boolean;
+}
+
 declare type ISupportCreateCCType =
 | 'cc.AnimationClip'        // 动画剪辑
 | 'cc.Script'               // 脚本（TypeScript/JavaScript）
@@ -1346,6 +2305,21 @@ declare interface ITargetOverrideInfo {
     targetInfo: ITargetInfo | null;
 }
 
+declare interface IUndoEvents {
+    'undo:changed': [];
+}
+
+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;
@@ -1408,6 +2382,28 @@ declare interface LabelAtlasAssetUserData {
     _fntConfig: FntData;
 }
 
+declare class LinearTicks {
+    ticks: number[];
+    tickLods: number[];
+    tickRatios: number[];
+    minScale: number;
+    maxScale: number;
+    minValueScale: number;
+    maxValueScale: number;
+    minValue: number;
+    maxValue: number;
+    pixelRange: number;
+    minSpacing: number;
+    maxSpacing: number;
+    minTickLevel: number;
+    maxTickLevel: number;
+    initTicks(lods: number[], min: number, max: number): this;
+    spacing(min: number, max: number): this;
+    range(minValue: number, maxValue: number, range: number): this;
+    ticksAtLevel(level: number, excludeHigherLevel: boolean): number[];
+    levelForStep(step: number): number;
+}
+
 declare interface LODsOption {
     // 屏占比
     screenRatio: number;
@@ -1532,6 +2528,7 @@ export declare class NodeService extends BaseService<INodeEvents> implements INo
     private _walkNode;
     updateNode(params: IUpdateNodeParams): Promise<IUpdateNodeResult>;
     queryNode(params: IQueryNodeParams): Promise<INode | null>;
+    queryNodeTree(params: IQueryNodeTreeParams): Promise<INodeTreeItem | null>;
     /**
      * 确保节点有 UITransform 组件
      * 目前只需保障在创建空节点的时候检查任意上级是否为 canvas
@@ -1651,10 +2648,23 @@ declare enum NormalImportSetting {
     recalculate = 3
 }
 
+declare type OperationEvent = SceneDragEvent | SceneKeyboardEvent | SceneMouseEvent | 'resize';
+
+export declare class OperationService extends BaseService<IOperationEvents> {
+    private _manager;
+    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 enum OptimizationPolicy {
     AUTO = 0,
-    SINGLE_INSTANCE = 0,
-    MULTI_INSTANCE = 1
+    SINGLE_INSTANCE = 1,
+    MULTI_INSTANCE = 2
 }
 
 /** 粒子资源的 userData */
@@ -1843,6 +2853,13 @@ export declare class PrefabService extends BaseService<IPrefabEvents> implements
     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;
 
@@ -1879,6 +2896,38 @@ declare interface RtSpriteFrameAssetUserData {
  */
 declare const SCENE_TEMPLATE_TYPE: readonly ['2d', '3d', 'quality'];
 
+declare type SceneDragEvent = 'onDragLeave' | 'onDragOver' | 'onDrop';
+
+declare type SceneKeyboardEvent = 'keydown' | 'keyup';
+
+declare enum SceneModeType {
+    General = 'general',
+    Prefab = 'prefab',
+    Animation = 'animation',
+    Preview = 'preview',
+    Unset = ''
+}
+
+declare type SceneMouseEvent = 'dblclick' | 'mousedown' | 'mousemove' | 'mouseup' | 'mousewheel';
+
+export declare class SceneViewService extends BaseService<ISceneViewEvents> implements ISceneViewService {
+    private _sceneViewLight;
+    private _lightNode;
+    private _isVisible;
+    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;
+    get isVisible(): boolean;
+    set isVisible(value: boolean);
+    private _onIsSceneLightOn;
+}
+
 /** JavaScript 脚本模块的 userData */
 declare interface ScriptModuleUserData {
     isPlugin: false;
@@ -1916,7 +2965,7 @@ export declare class ScriptService extends BaseService<IScriptEvents> implements
      * 是否是自定义脚本（不是引擎定义的组件）
      * @param classConstructor
      */
-    isCustomComponent(classConstructor: Function): Promise<boolean>;
+    isCustomComponent(classConstructor: Function): boolean;
     _loadScripts(): Promise<void>;
     /**
      * 加载脚本时触发
@@ -1946,6 +2995,18 @@ export declare class ScriptService extends BaseService<IScriptEvents> implements
     private _handleImportException;
 }
 
+export declare class SelectionService extends BaseService<ISelectionEvents> implements ISelectionService {
+    private _uuids;
+    select(uuid: string): void;
+    unselect(uuid: string): void;
+    clear(): void;
+    query(): string[];
+    isSelect(uuid: string): boolean;
+    reset(): void;
+    private _callFocusInEditor;
+    private _callLostFocusInEditor;
+}
+
 declare interface SerializedAssetFinder {
     meshes?: Array<string | null>;
     animations?: Array<string | null>;
@@ -1960,6 +3021,8 @@ declare interface SerializedAssetFinder {
  */
 export declare const Service: IServiceManager;
 
+export declare const ServiceEvents: GlobalEventManager;
+
 /**
  * 范例
  * @register('Scene')
@@ -1994,6 +3057,29 @@ declare interface SimplifyOptions {
     maxIterationCount?: number;
 }
 
+declare class SnapConfigs extends EventEmitter {
+    private _position;
+    private _rotation;
+    private _scale;
+    private _isPositionSnapEnabled;
+    private _isRotationSnapEnabled;
+    private _isScaleSnapEnabled;
+    get position(): IVec3Like;
+    set position(value: IVec3Like);
+    get rotation(): number;
+    set rotation(value: number);
+    get scale(): number;
+    set scale(value: number);
+    get isPositionSnapEnabled(): boolean;
+    set isPositionSnapEnabled(value: boolean);
+    get isRotationSnapEnabled(): boolean;
+    set isRotationSnapEnabled(value: boolean);
+    get isScaleSnapEnabled(): boolean;
+    set isScaleSnapEnabled(value: boolean);
+    getPureDataObject(): ISnapConfigData;
+    initFromData(data: ISnapConfigData): void;
+}
+
 /** Spine 资源的 userData */
 declare interface SpineAssetUserData {
     /** 图集资源的 UUID */
@@ -2114,8 +3200,54 @@ declare interface TextureCubeAssetUserData extends TextureBaseAssetUserData {
     bottom?: string;
 }
 
+declare class TransformToolData extends EventEmitter {
+    private _toolName;
+    private _viewMode;
+    private _coordinate;
+    private _pivot;
+    private _isLocked;
+    private _is2D;
+    private _scale2D;
+    snapConfigs: SnapConfigs;
+    get toolName(): TransformToolDataToolNameType;
+    set toolName(value: TransformToolDataToolNameType);
+    get viewMode(): TransformToolDataViewMode;
+    set viewMode(value: TransformToolDataViewMode);
+    get coordinate(): TransformToolDataCoordinateType;
+    set coordinate(value: TransformToolDataCoordinateType);
+    get pivot(): TransformToolDataPivotType;
+    set pivot(value: TransformToolDataPivotType);
+    get isLocked(): boolean;
+    set isLocked(value: boolean);
+    get is2D(): boolean;
+    set is2D(value: boolean);
+    get scale2D(): number;
+    set scale2D(value: number);
+    set cameraOrthoHeight(value: number);
+}
+
+declare type TransformToolDataCoordinateType = 'local' | 'global';
+
+declare type TransformToolDataPivotType = 'pivot' | 'center';
+
+declare type TransformToolDataToolNameType = 'view' | 'position' | 'rotation' | 'scale' | 'rect';
+
+declare type TransformToolDataViewMode = 'view' | 'select';
+
 declare type TSceneTemplateType = typeof SCENE_TEMPLATE_TYPE[number];
 
+export declare class UndoService extends BaseService<IUndoEvents> implements IUndoService {
+    private _undoMgr;
+    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 Vec2 {
     x: number;
     y: number;