@cocos/cocos-cli-types 0.0.1-alpha.22.1 → 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,6 +249,292 @@ 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;
+}
+
 /**
  * 子进程节点处理器
  * 在子进程中处理所有节点相关操作
@@ -269,21 +564,28 @@ export declare class ComponentService extends BaseService<IComponentEvents> impl
     checkComponentsCollision(node: Node_2): Promise<void>;
     checkDynamicBodyShape(ndoe: Node_2): void;
     /**
-     * 通过 path、uuid 或 url 查找组件实例
+     * 通过 path 查找组件实例，支持路径、UUID 或 URL
      */
     private findComponent;
     removeComponent(params: IRemoveComponentOptions): Promise<boolean>;
-    queryComponent(params: IQueryComponentOptions): Promise<IComponent | IComponentForPinK | 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;
-    setPropertyForPink(uuid: string, path: string, dump: IProperty, record?: boolean): Promise<boolean>;
+    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;
@@ -329,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 - 统一的编辑器管理入口
  * 作为调度器，根据资源类型动态创建和管理编辑器实例
@@ -458,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;
@@ -639,8 +1095,54 @@ 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 {
     nodePathOrUuid: string;
@@ -693,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'> {
@@ -771,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;
@@ -788,7 +1318,7 @@ declare interface ICloseOptions {
 }
 
 /**
- * 代表组件属性信息
+ * CLI 使用的组件信息，属性值以扁平的 key-value 形式呈现
  */
 declare interface IComponent extends IComponentIdentifier {
     properties: {
@@ -798,7 +1328,7 @@ declare interface IComponent extends IComponentIdentifier {
 }
 
 /**
- * 场景事件类型
+ * 组件相关事件类型
  */
 declare interface IComponentEvents extends INodeEvents {
     'component:add': [Component];
@@ -810,7 +1340,11 @@ declare interface IComponentEvents extends INodeEvents {
     'component:before-add-component': [string, Node_2];
 }
 
-declare interface IComponentForPinK extends IProperty {
+/**
+ * 编辑器使用的组件详细信息，属性值以 IProperty 编码形式呈现，
+ * 包含 type、readonly、default 等元信息，用于编辑器 Inspector 面板渲染
+ */
+declare interface IComponentForEditor extends IProperty {
     value: {
         enabled: IPropertyValueType;
         uuid: IPropertyValueType;
@@ -820,7 +1354,7 @@ declare interface IComponentForPinK extends IProperty {
 }
 
 /**
- * 代表一个组件
+ * 组件标识信息，包含组件的基本标识字段
  */
 declare interface IComponentIdentifier {
     cid: string;
@@ -832,50 +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
-     */
-    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 });
+     * ```
+     */
+    queryClasses(options?: IQueryClassesOptions): Promise<{
+        name: string;
+    }[]>;
     /**
-     * 复位组件
+     * 查询指定节点上所有组件暴露的可调用函数
+     * @param uuid - 节点 UUID
+     * @returns 节点上组件的函数信息，节点不存在时返回空对象
      */
-    resetComponent(params: IQueryComponentOptions): Promise<boolean>;
+    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;
 }
@@ -993,7 +1616,7 @@ declare interface IEngineService extends IServiceEvents {
 }
 
 /**
- * 执行组件方法选项
+ * 执行组件方法的选项
  */
 declare interface IExecuteComponentMethodOptions {
     uuid: string;
@@ -1041,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;
 }
@@ -1186,6 +1837,7 @@ declare interface INodeTreeItem {
     active: boolean;
     locked: boolean;
     type: string;
+    uuid: string;
     children: INodeTreeItem[];
     prefab: IPrefabStateInfo;
     parent: string;
@@ -1203,6 +1855,21 @@ 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;
 }
@@ -1369,11 +2036,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 +2075,10 @@ declare interface IReloadOptions {
 }
 
 /**
- * 删除组件
+ * 删除组件的选项
  */
 declare interface IRemoveComponentOptions {
-    pathOrUuidOrUrl: string;
+    path: string;
 }
 
 declare interface IRevertToPrefabParams {
@@ -1435,6 +2109,59 @@ export declare interface ISceneEvents {
     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 {
     /**
      * 当脚本刷新并执行完成时触发
@@ -1453,6 +2180,21 @@ declare interface IScriptService extends IServiceEvents {
     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;
@@ -1480,6 +2222,9 @@ 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 {
@@ -1490,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;
@@ -1503,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）
@@ -1535,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;
@@ -1597,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;
@@ -1841,6 +2648,19 @@ 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 = 1,
@@ -2076,6 +2896,10 @@ 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',
@@ -2084,6 +2908,26 @@ declare enum SceneModeType {
     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;
@@ -2151,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>;
@@ -2165,6 +3021,8 @@ declare interface SerializedAssetFinder {
  */
 export declare const Service: IServiceManager;
 
+export declare const ServiceEvents: GlobalEventManager;
+
 /**
  * 范例
  * @register('Scene')
@@ -2199,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 */
@@ -2319,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;