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

package/index.d.ts

@@ -2,10 +2,15 @@
 
 import { __private } from 'cc';
 import { ChunkInfo } from '@cocos/creator-programming-quick-pack/lib/loader';
+import type { Component } from 'cc';
 import { EventEmitter } from 'events';
+import { default as i18n_2 } from 'i18next';
 import { NextFunction } from 'express';
+import type { Node as Node_2 } from 'cc';
 import { Request as Request_2 } from 'express';
 import { Response as Response_2 } from 'express';
+import type { Scene as Scene_2 } from 'cc';
+import type { Vec3 as Vec3_2 } from 'cc';
 
 /** 动画剪辑资源的 userData */
 declare interface AnimationClipAssetUserData {
@@ -475,6 +480,11 @@ export declare namespace Configuration {
  */
 declare type ConfigurationScope = 'default' | 'project';
 
+/**
+ * 创建类型
+ */
+declare const CREATE_TYPES: readonly ['scene', 'prefab'];
+
 /**
  * Create Asset // 创建资源
  */
@@ -707,6 +717,73 @@ declare function getStatus_2(): {
  */
 declare function getUrl(): string | undefined;
 
+/**
+ * 全局事件管理器
+ * 统一管理所有服务的事件监听，支持类型安全的事件订阅
+ */
+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 {
     gltfIndex: number;
@@ -888,6 +965,24 @@ declare interface GlTFUserData {
     };
 }
 
+export declare namespace i18n {
+    export {
+        i18n_2 as default
+    };
+}
+
+/**
+ * 添加/创建组件的选项
+ */
+declare interface IAddComponentOptions {
+    nodePathOrUuid: string;
+    component: string;
+}
+
+declare interface IApplyPrefabChangesParams {
+    nodePath: string;
+}
+
 declare interface IAssetConfig {
     displayName?: string;
     description?: string;
@@ -957,6 +1052,22 @@ declare interface IAssetMeta<T extends ISupportCreateType | 'unknown' = 'unknown
     name?: string;
 }
 
+/**
+ * 场景相关处理接口
+ */
+declare interface IAssetService extends IServiceEvents {
+    /**
+     * 资源发生变化时，进行处理
+     * @param uuid
+     */
+    assetChanged(uuid: string): Promise<void>;
+    /**
+     * 资源删除时，进行处理
+     * @param uuid
+     */
+    assetDeleted(uuid: string): Promise<void>;
+}
+
 declare type IAssetType =
 | ISupportCreateCCType
 | 'cc.Asset'               // 基础资源类型（instantiation-asset）
@@ -1026,11 +1137,72 @@ declare interface IBaseConfiguration extends EventEmitterMethods {
     save(): Promise<boolean>;
 }
 
+declare interface IBaseCreateNodeParams {
+    path: string;
+    name?: string;
+    workMode?: '2d' | '3d';
+    position?: IVec3;
+    keepWorldTransform?: boolean;
+    canvasRequired?: boolean;
+}
+
+/**
+ * 基础标识
+ */
+declare interface IBaseIdentifier {
+    assetName: string;
+    assetUuid: string;
+    assetUrl: string;
+    assetType: string;
+}
+
+declare interface 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;
+    propPath?: string;
+    index?: number;
+    record?: boolean;
+    dumpImmediately?: boolean;
+}
+
 declare interface IChunkContent {
     skeleton: null | string;
     clips: string[];
 }
 
+export declare interface ICLI {
+    Scene: IServiceManager;
+    SceneEvents: GlobalEventManager;
+}
+
+/**
+ * 关闭场景/预制体选项
+ */
+declare interface ICloseOptions {
+    urlOrUUID?: string;
+}
+
 declare interface ICocosConfigurationNode {
     id: string;
     title: string;
@@ -1060,6 +1232,183 @@ declare interface ICollisionMatrix {
     [x: string]: number;
 }
 
+/**
+ * CLI 使用的组件信息，属性值以扁平的 key-value 形式呈现
+ */
+declare interface IComponent extends IComponentIdentifier {
+    properties: {
+        [key: string]: IPropertyValueType;
+    };
+    prefab: ICompPrefabInfo | null;
+}
+
+/**
+ * 编辑器使用的组件详细信息，属性值以 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;
+    path: string;
+    uuid: string;
+    name: string;
+    type: string;
+    enabled: boolean;
+}
+
+/**
+ * 组件服务接口，定义了所有组件相关的操作方法
+ */
+declare interface IComponentService extends IServiceEvents {
+    /**
+     * 添加组件到指定节点，返回添加后的组件信息
+     * @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.path - 组件路径，支持路径、UUID 或资源 URL
+     * @returns 删除成功返回 true，失败返回 false
+     */
+    removeComponent(params: IRemoveComponentOptions): Promise<boolean>;
+    /**
+     * 设置组件属性
+     * - 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;
+     * ```
+     */
+    queryComponent(params: IQueryComponentOptions | string): Promise<IComponent | IComponentForEditor | null>;
+    /**
+     * 获取所有已注册的组件类名，包含内置与自定义组件
+     * @returns 组件类名数组，如 ['cc.Label', 'cc.Sprite', 'MyCustomComponent']
+     */
+    queryAllComponent(): Promise<string[]>;
+    /**
+     * 创建组件（编辑器使用），与 addComponent 不同的是仅返回是否成功
+     * @param params - 添加组件选项
+     * @param params.nodePathOrUuid - 目标节点路径或 UUID
+     * @param params.component - 组件类名
+     * @returns 创建成功返回 true，失败返回 false
+     */
+    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;
+}
+
+declare interface ICompPrefabInfo {
+    fileId: string;
+}
+
 /**
  * 配置的格式
  */
@@ -1070,6 +1419,14 @@ declare interface IConfiguration {
     [key: string]: any;
 }
 
+declare interface ICreateByAssetParams extends IBaseCreateNodeParams {
+    dbURL: string;
+}
+
+declare interface ICreateByNodeTypeParams extends IBaseCreateNodeParams {
+    nodeType: NodeType;
+}
+
 declare interface ICreateMenuInfo {
     // 新建菜单名称，支持 i18n:xxx
     label: string;
@@ -1093,6 +1450,27 @@ declare interface ICreateMenuInfo {
     fileNameCheckConfigs?: FileNameCheckConfig[];
 }
 
+/**
+ * 创建场景/预制体选项
+ */
+declare interface ICreateOptions {
+    type: ICreateType;
+    baseName: string;
+    targetDirectory: string;
+    templateType?: TSceneTemplateType;
+}
+
+declare interface ICreatePrefabFromNodeParams {
+    /** 要转换为预制体的源节点路径 */
+    nodePath: string;
+    /** 预制体资源保存 URL */
+    dbURL: string;
+    /** 是否强制覆盖现有资源 */
+    overwrite?: boolean;
+}
+
+declare type ICreateType = typeof CREATE_TYPES[number];
+
 declare type ICroppingConfig = {
     name: string;
     cache: Record<string, IDisplayModuleCache>,
@@ -1120,6 +1498,15 @@ declare type IDefaultConfig = {
 
 declare type IDefaultConfigKeys = 'defaultConfig' | 'default2d' | 'default3d' | 'defaultNative' | 'defaultSmallGames'
 
+declare interface IDeleteNodeParams {
+    path: string;
+    keepWorldTransform?: boolean;
+}
+
+declare interface IDeleteNodeResult {
+    path: string;
+}
+
 /**
  * 构建使用的设计分辨率数据
  */
@@ -1143,6 +1530,50 @@ declare interface IDisplayModuleItem extends IFeatureItem {
     options?: Record<string, IDisplayModuleItem>;
 }
 
+declare interface IEditorService extends IServiceEvents {
+    /**
+     * 当前编辑器类型
+     */
+    getCurrentEditorType(): 'scene' | 'prefab' | 'unknown';
+    /**
+     * 打开资产
+     * @param params
+     */
+    open(params: IOpenOptions): Promise<TEditorEntity>;
+    /**
+     * 关闭当前资产
+     */
+    close(params: ICloseOptions): Promise<boolean>;
+    /**
+     * 保存资产
+     */
+    save(params: ISaveOptions): Promise<IAssetInfo>;
+    /**
+     * 重载资产
+     * @param params
+     */
+    reload(params: IReloadOptions): Promise<ReloadResult>;
+    /**
+     * 创建新资产
+     * @param params
+     */
+    create(params: ICreateOptions): Promise<IBaseIdentifier>;
+    /**
+     * 是否有打开编辑器
+     */
+    hasOpen(): Promise<boolean>;
+    /**
+     * 获取当前打开的资产
+     */
+    queryCurrent(): Promise<TEditorEntity | null>;
+    /**
+     *
+     */
+    getRootNode(): TEditorInstance | null;
+    lock(): Promise<void>;
+    unlock(): void;
+}
+
 declare interface IEngineConfig extends IEngineModuleConfig {
     physicsConfig: IPhysicsConfig;
     macroConfig?: Record<string, string | number | boolean>;
@@ -1192,6 +1623,26 @@ declare interface IEngineProjectConfig extends Exclude<IEngineConfig, 'includeMo
     globalConfigKey?: string;
 }
 
+declare interface IEngineService extends IServiceEvents {
+    /**
+     * 初始化引擎服务，目前是暂时引擎 mainLoop
+     */
+    init(): Promise<void>;
+    /**
+     * 让引擎执行一帧
+     */
+    repaintInEditMode(): Promise<void>;
+}
+
+/**
+ * 执行组件方法的选项
+ */
+declare interface IExecuteComponentMethodOptions {
+    uuid: string;
+    name: string;
+    args: any[];
+}
+
 declare interface IFbxSetting {
     /**
      * https://github.com/cocos-creator/FBX-glTF-conv/pull/26
@@ -1279,6 +1730,32 @@ declare interface IGetPostConfig {
     handler: (req: Request_2, res: Response_2, next?: NextFunction) => Promise<void>;
 }
 
+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 IInitEngineInfo {
     importBase: string;
     nativeBase: string;
@@ -1286,6 +1763,10 @@ declare interface IInitEngineInfo {
     serverURL?: string;
 }
 
+declare interface IIsPrefabInstanceParams {
+    nodePath: string;
+}
+
 /** 图片资源的 userData  */
 declare interface ImageAssetUserData {
     /** 图片类型 */
@@ -1362,6 +1843,16 @@ declare type IModuleItem = IFeatureItem | IFeatureGroup;
 
 declare type IModules = Record<string, IModuleItem>;
 
+declare interface IMountedChildrenInfo {
+    targetInfo: ITargetInfo | null;
+    nodes: INodeIdentifier[];
+}
+
+declare interface IMountedComponentsInfo {
+    targetInfo: ITargetInfo | null;
+    components: IComponentIdentifier[];
+}
+
 /**
  * Import Asset // 导入资源
  */
@@ -1394,6 +1885,103 @@ declare function initEngine(enginePath: string, projectPath: string, serverURL?:
 
 declare function initProgrammingFacet(): Promise<ProgrammingFacet>;
 
+declare interface INode extends INodeIdentifier {
+    properties: INodeProperties;
+    components?: IComponent[] | IComponentIdentifier[];
+    children?: INode[];
+    prefab: IPrefabInfo | null;
+}
+
+declare interface INodeIdentifier {
+    nodeId: string;
+    path: string;
+    name: string;
+}
+
+declare interface INodeProperties {
+    position: IVec3;
+    rotation: IQuat;
+    eulerAngles: IVec3;
+    scale: IVec3;
+    mobility: MobilityMode;
+    layer: number;
+    active: boolean;
+}
+
+/**
+ * 节点的相关处理接口
+ */
+declare interface INodeService extends IServiceEvents {
+    /**
+     * 创建节点
+     * @param params
+     */
+    createNodeByType(params: ICreateByNodeTypeParams): Promise<INode | null>;
+    /**
+     * 创建节点
+     * @param params
+     */
+    createNodeByAsset(params: ICreateByAssetParams): Promise<INode | null>;
+    /**
+     * 删除节点
+     * @param params
+     */
+    deleteNode(params: IDeleteNodeParams): Promise<IDeleteNodeResult | null>;
+    /**
+     * 更新节点
+     * @param params
+     */
+    updateNode(params: IUpdateNodeParams): Promise<IUpdateNodeResult>;
+    /**
+     * 查询节点
+     */
+    queryNode(params: IQueryNodeParams): Promise<INode | null>;
+    /**
+     * 查询节点树（层级管理器格式）
+     */
+    queryNodeTree(params: IQueryNodeTreeParams): Promise<INodeTreeItem | null>;
+}
+
+declare interface INodeTreeComponent {
+    isCustom: boolean;
+    type: string;
+    value: string;
+    extends: string[];
+}
+
+declare interface INodeTreeItem {
+    name: string;
+    active: boolean;
+    locked: boolean;
+    type: string;
+    uuid: string;
+    children: INodeTreeItem[];
+    prefab: IPrefabStateInfo;
+    parent: string;
+    path: string;
+    isScene: boolean;
+    readonly: boolean;
+    components: INodeTreeComponent[];
+}
+
+/**
+ * 打开场景/预制体选项
+ */
+declare interface IOpenOptions {
+    urlOrUUID: string;
+    simpleNode?: boolean;
+}
+
+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 IPhysicsConfig {
     gravity: IVec3Like; // （0，-10， 0）
     allowSleep: boolean; // true
@@ -1424,6 +2012,76 @@ declare interface IPluginScriptInfo extends PluginScriptInfo {
     url: string;
 }
 
+declare interface IPrefab {
+    name: string;
+    uuid: string;
+    data: INodeIdentifier;
+    optimizationPolicy: OptimizationPolicy;
+    persistent: boolean;
+}
+
+declare interface IPrefabInfo {
+    /** 关联的预制体资源信息 */
+    asset?: IPrefab;
+    root?: INodeIdentifier;
+    instance?: IPrefabInstance;
+    fileId: string;
+    targetOverrides: ITargetOverrideInfo[];
+    nestedPrefabInstanceRoots: INodeIdentifier[];
+}
+
+declare interface IPrefabInstance {
+    fileId: string;
+    prefabRootNode?: INodeIdentifier;
+    mountedChildren: IMountedChildrenInfo[];
+    mountedComponents: IMountedComponentsInfo[];
+    propertyOverrides: IPropertyOverrideInfo[];
+    removedComponents: ITargetInfo[];
+}
+
+declare interface IPrefabService extends IServiceEvents {
+    /**
+     * 将节点转换为预制体资源
+     */
+    createPrefabFromNode(params: ICreatePrefabFromNodeParams): Promise<INode>;
+    /**
+     * 将节点的修改应用回预制体资源
+     */
+    applyPrefabChanges(params: IApplyPrefabChangesParams): Promise<boolean>;
+    /**
+     * 重置节点到预制体原始状态
+     */
+    revertToPrefab(params: IRevertToPrefabParams): Promise<boolean>;
+    /**
+     * 解耦预制体实例，使其成为普通节点
+     */
+    unpackPrefabInstance(params: IUnpackPrefabInstanceParams): Promise<INode>;
+    /**
+     * 检查节点是否为预制体实例
+     */
+    isPrefabInstance(params: IIsPrefabInstanceParams): Promise<boolean>;
+    /**
+     * 获取节点的预制体信息
+     */
+    getPrefabInfo(params: IGetPrefabInfoParams): Promise<IPrefabInfo | null>;
+    /**
+     * 移除 prefab info
+     * @param node
+     * @param removeNested
+     */
+    removePrefabInfoFromNode(node: Node_2, removeNested?: boolean): void;
+}
+
+declare interface IPrefabStateInfo {
+    state: PrefabState;
+    isUnwrappable: boolean;
+    isRevertable: boolean;
+    isApplicable: boolean;
+    isAddedChild: boolean;
+    isNested: boolean;
+    assetUuid: string;
+}
+
 declare interface IProject {
     /**
      * Gets the project directory path
@@ -1497,6 +2155,116 @@ declare interface IProject {
     updateInfo<T>(keyOrValue: string | ProjectInfo, value?: T): Promise<boolean>;
 }
 
+/**
+ * 组件的 dump 数据，以 IProperty 格式编码组件信息
+ * 与 IComponent 不同，所有属性（包括 uuid, name, enabled）都通过 encodeObject 编码为 IProperty
+ */
+declare interface IProperty {
+    value: { [key: string]: IPropertyValueType } | IPropertyValueType;
+    default?: any; // 默认值
+
+    // 多选节点之后，这里存储多个数据，用于自行判断多选后的显示效果，无需更新该数据
+    values?: ({ [key: string]: IPropertyValueType } | IPropertyValueType)[];
+
+    lock?: { [key in keyof Vec4]?: IPropertyLock };
+
+    cid?: string;
+    type?: string;
+    ui?: { name: string; data?: any }; // 是否用指定的 UI 组件，name 是组件的名称
+    readonly?: boolean;
+    visible?: boolean;
+    name?: string;
+
+    elementTypeData?: IProperty; // 数组里的数据的默认值 dump
+
+    path?: string; // 数据的搜索路径，这个是由使用方填充的
+
+    isArray?: boolean;
+    invalid?: boolean;
+    extends?: string[]; // 继承链
+    displayName?: string; // 显示到界面上的名字
+    displayOrder?: number; // 显示排序
+    help?: string; // 帮助文档的 url 地址
+    group?: IPropertyGroupOptions; // tab
+    tooltip?: string; // 提示文本
+    editor?: any; // 组件上定义的编辑器数据
+    animatable?: boolean; // 是否可以在动画中编辑
+    radioGroup?: boolean; // 是否渲染为 RadioGroup
+
+    // Enum
+    enumList?: any[]; // enum 类型的 list 选项数组
+
+    bitmaskList?: any[];
+
+    // Number
+    min?: number; // 数值类型的最小值
+    max?: number; // 数值类型的最大值
+    step?: number; // 数值类型的步进值
+    slide?: boolean; // 数组是否显示为滑块
+    unit?: string; // 显示的单位
+    radian?: boolean; // 标识是否为角度
+
+    // Label
+    multiline?: boolean; // 字符串是否允许换行
+    // nullable?: boolean; 属性是否允许为空
+
+    optionalTypes?: string[]; // 对属性是 object 且是可变类型的数据的支持，比如 render-pipeline
+
+    userData?: { [key: string]: any }; // 用户透传的数据
+}
+
+declare interface IPropertyGroupOptions {
+    id: string // 默认 'default'
+    name: string,
+    displayOrder: number, // 默认 Infinity, 排在最后面
+    style: string // 默认为 'tab'
+}
+
+declare type IPropertyLock = { 
+    default: number; 
+    message: string 
+};
+
+declare interface IPropertyOverrideInfo {
+    targetInfo: ITargetInfo | null;
+    propertyPath: string[];
+    value?: any;
+}
+
+declare type IPropertyValueType = IProperty | IProperty[] | null | undefined | number | boolean | string | Vec4 | Vec3 | Vec2 | Mat4 | any | Array<unknown>
+
+declare interface IQuat {
+    x: number;
+    y: number;
+    z: number;
+    w: number;
+}
+
+/**
+ * 查询注册类的过滤选项
+ */
+declare interface IQueryClassesOptions {
+    extends?: string | string[];
+    excludeSelf?: boolean;
+}
+
+/**
+ * 查询组件的选项
+ */
+declare interface IQueryComponentOptions {
+    path: string;
+}
+
+declare interface IQueryNodeParams {
+    path: string;
+    queryChildren: boolean;
+    queryComponent: boolean;
+}
+
+declare interface IQueryNodeTreeParams {
+    path?: string;
+}
+
 declare interface IRedirectInfo {
     // 跳转资源的类型
     type: string;
@@ -1504,6 +2272,167 @@ declare interface IRedirectInfo {
     uuid: string;
 }
 
+/**
+ * 软刷新场景/预制体选项
+ */
+declare interface IReloadOptions {
+    urlOrUUID?: string;
+}
+
+/**
+ * 删除组件的选项
+ */
+declare interface IRemoveComponentOptions {
+    path: string;
+}
+
+declare interface IRevertToPrefabParams {
+    nodePath: string;
+}
+
+/**
+ * 保持场景/预制体选项
+ */
+declare interface ISaveOptions {
+    urlOrUUID?: string;
+}
+
+/**
+ * 场景信息
+ */
+declare interface IScene extends IBaseIdentifier {
+    name: string;
+    prefab: IPrefabInfo | null;
+    children: INode[];
+    components: IComponentIdentifier[];
+}
+
+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 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 {
+    investigatePackerDriver(): Promise<void>;
+    loadScript(): Promise<void>;
+    removeScript(): Promise<void>;
+    scriptChange(): Promise<void>;
+    queryScriptCid(uuid: string): Promise<string | null>;
+    queryScriptName(uuid: string): Promise<string | null>;
+    isCustomComponent(classConstructor: Function): boolean;
+    suspend(condition: Promise<any>): void;
+}
+
+declare interface 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;
+    onEditorClosed?(): void;
+    onEditorSaved?(): void;
+    onNodeBeforeChanged?(node: Node_2): void;
+    onBeforeRemoveNode?(node: Node_2): void;
+    onBeforeAddNode?(node: Node_2): void;
+    onNodeChanged?(node: Node_2, opts: IChangeNodeOptions): void;
+    onBeforeNodeAdded?(node: Node_2): void;
+    onAddNode?(node: Node_2): void;
+    onRemoveNode?(node: Node_2): void;
+    onNodeAdded?(node: Node_2): void;
+    onNodeRemoved?(node: Node_2): void;
+    onAddComponent?(comp: Component): void;
+    onRemoveComponent?(comp: Component): void;
+    onSetPropertyComponent?(comp: Component): void;
+    onComponentAdded?(comp: Component): void;
+    onComponentRemoved?(comp: Component): void;
+    onBeforeRemoveComponent?(comp: Component): void;
+    onComponentBeforeChanged?(node: Node_2): void;
+    onBeforeComponentAdded?(name: string, node: Node_2): void;
+    onComponentChanged?(name: string, opts: IChangeNodeOptions): void;
+    onAssetDeleted?(uuid: string): void;
+    onAssetChanged?(uuid: string): void;
+    onAssetRefreshed?(uuid: string): void;
+    onScriptExecutionFinished?(): void;
+    onSelectionSelect?(uuid: string, uuids: string[]): void;
+    onSelectionUnselect?(uuid: string, uuids: string[]): void;
+    onSelectionClear?(): void;
+}
+
+export declare interface IServiceManager {
+    Editor: IEditorService;
+    Node: INodeService;
+    Component: IComponentService;
+    Script: IScriptService;
+    Asset: IAssetService;
+    Engine: IEngineService;
+    Prefab: IPrefabService;
+    Selection: ISelectionService;
+    Operation: IOperationService;
+    Undo: IUndoService;
+    Camera: ICameraService;
+    Gizmo: IGizmoService;
+    SceneView: ISceneViewService;
+}
+
+/**
+ * CLI 设置组件属性的选项
+ */
+declare interface ISetPropertyOptions {
+    componentPath: string;
+    properties: {
+        [key: string]: null | undefined | number | boolean | string | object | Array<unknown>;
+    };
+    record?: boolean;
+}
+
+/**
+ * 编辑器设置组件属性的选项
+ */
+declare interface ISetPropertyOptionsForEditor {
+    uuid: string;
+    path: string;
+    dump: IProperty;
+    record?: boolean;
+}
+
 declare interface ISocketConfig {
     connection: (socket: any) => void;
     disconnect: (socket: any) => void;
@@ -1560,6 +2489,18 @@ declare type ISupportCreateCCType =
 /** 支持创建的资源类型（从常量数组派生） */
 declare type ISupportCreateType = typeof SUPPORT_CREATE_TYPES[number];
 
+declare interface ITargetInfo {
+    localID: string[];
+}
+
+declare interface ITargetOverrideInfo {
+    source: IComponentIdentifier | INodeIdentifier | null;
+    sourceInfo: ITargetInfo | null;
+    propertyPath: string[];
+    target: INodeIdentifier | null;
+    targetInfo: ITargetInfo | null;
+}
+
 declare interface IUerDataConfigItem {
     key?: string; // 唯一标识符
     // 配置显示的名字，如果需要翻译，则传入 i18n:${key}
@@ -1582,6 +2523,40 @@ declare interface IUerDataConfigItem {
     };
 }
 
+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;
+    /** 递归解耦所有子预制体 */
+    recursive?: boolean;
+}
+
+declare interface IUpdateNodeParams {
+    path: string;
+    name?: string;
+    properties?: Partial<INodeProperties>;
+}
+
+declare interface IUpdateNodeResult {
+    path: string;
+}
+
+declare interface IVec3 {
+    x: number;
+    y: number;
+    z: number;
+}
+
 declare interface IVec3Like {
     x: number;
     y: number;
@@ -1649,6 +2624,28 @@ declare type MacroItem = {
 
 declare type MakeRequired<T, K extends keyof T> = T & Required<Pick<T, K>>;
 
+declare interface Mat4 {
+    m00: number;
+    m01: number;
+    m02: number;
+    m03: number;
+
+    m04: number;
+    m05: number;
+    m06: number;
+    m07: number;
+
+    m08: number;
+    m09: number;
+    m10: number;
+    m11: number;
+
+    m12: number;
+    m13: number;
+    m14: number;
+    m15: number;
+}
+
 export declare namespace Mcp {
     export {
         register,
@@ -1703,6 +2700,24 @@ declare interface Migration {
     migrate(moduleCache: Record<string, boolean>): Record<string, boolean>;
 }
 
+declare enum MobilityMode {
+    /**
+     * @en Static node
+     * @zh 静态节点
+     */
+    Static = 0,
+    /**
+     * @en Stationary node
+     * @zh 固定节点
+     */
+    Stationary = 1,
+    /**
+     * @en Movable node
+     * @zh 可移动节点
+     */
+    Movable = 2
+}
+
 declare interface ModuleRenderConfig {
     $schema?: string;
 
@@ -1729,6 +2744,66 @@ declare interface ModuleRenderConfig {
  */
 declare function moveAsset(source: string, target: string, options?: AssetOperationOption): Promise<any>;
 
+declare enum NodeEventType {
+    TRANSFORM_CHANGED = 'transform-changed',// 节点改变位置、旋转或缩放事件
+    SIZE_CHANGED = 'size-changed',// 当节点尺寸改变时触发的事件
+    ANCHOR_CHANGED = 'anchor-changed',// 当节点锚点改变时触发的事件
+    CHILD_ADDED = 'child-added',// 节点子类添加
+    CHILD_REMOVED = 'child-removed',// 节点子类移除
+    PARENT_CHANGED = 'parent-changed',// 父节点改变时触发的事件
+    CHILD_CHANGED = 'child-changed',// 子节点改变时触发的事件
+    COMPONENT_CHANGED = 'component-changed',// 组件数据发生改变时
+    ACTIVE_IN_HIERARCHY_CHANGE = 'active-in-hierarchy-changed',// 节点在hierarchy是否激活
+    NOTIFY_NODE_CHANGED = 'notify-node-changed',
+    PREFAB_INFO_CHANGED = 'prefab-info-changed',// prefab数据改变
+    LIGHT_PROBE_CHANGED = 'light-probe-changed',// 光照探针数据改变
+    SET_PROPERTY = 'set-property',// 设置节点上的属性
+    MOVE_ARRAY_ELEMENT = 'move-array-element',// 调整一个数组类型的数据内某个 item 的位置
+    REMOVE_ARRAY_ELEMENT = 'remove-array-element',// 删除一个数组元素
+    CREATE_COMPONENT = 'create-component',// 创建一个组件
+    RESET_COMPONENT = 'reset-component'
+}
+
+declare enum NodeType {
+    EMPTY = 'Empty',// 空节点
+    TERRAIN = 'Terrain',// 地形节点
+    CAMERA = 'Camera',// 摄像机节点(需要用过 TWorkMode 来区分 2D 和 3D)
+    SPRITE = 'Sprite',// 精灵节点(需要用过 TWorkMode 来区分 2D 和 3D)
+    SPRITE_SPLASH = 'SpriteSplash',// 单色
+    GRAPHICS = 'Graphics',// 图形节点
+    LABEL = 'Label',// 文本节点
+    MASK = 'Mask',// 遮罩节点
+    PARTICLE = 'Particle',// 粒子节点(需要用过 TWorkMode 来区分 2D 和 3D)
+    TILED_MAP = 'TiledMap',// 瓦片地图节点
+    CAPSULE = 'Capsule',// 胶囊体节点
+    CONE = 'Cone',// 圆锥体节点
+    CUBE = 'Cube',// 立方体节点
+    CYLINDER = 'Cylinder',// 圆柱体节点
+    PLANE = 'Plane',// 平面节点
+    QUAD = 'Quad',// 四边形节点
+    SPHERE = 'Sphere',// 球体节点
+    TORUS = 'Torus',// 圆环体节点
+    BUTTON = 'Button',// 按钮节点
+    CANVAS = 'Canvas',// 画布节点(需要用过 TWorkMode 来区分 2D 和 3D)
+    EDIT_BOX = 'EditBox',// 输入框节点
+    LAYOUT = 'Layout',// 布局节点
+    PAGE_VIEW = 'PageView',// 页面视图节点
+    PROGRESS_BAR = 'ProgressBar',// 进度条节点
+    RICH_TEXT = 'RichText',// 富文本节点
+    SCROLL_VIEW = 'ScrollView',// 滚动视图节点
+    SLIDER = 'Slider',// 滑动条节点
+    TOGGLE = 'Toggle',// 切换节点
+    TOGGLE_GROUP = 'ToggleGroup',// 切换组节点
+    VIDEO_PLAYER = 'VideoPlayer',// 视频播放器节点
+    WEB_VIEW = 'WebView',// 网页视图节点
+    WIDGET = 'Widget',// 小部件节点
+    DIRECTIONAL_LIGHT = 'Light-Directional',// 平行光
+    SPHERE_LIGHT = 'Light-Sphere',// 球面光
+    SPOT_LIGHT = 'Light-Spot',// 聚光灯
+    PROBE_LIGHT = 'Light-Probe-Group',// 光照探针
+    REFLECTION_LIGHT = 'Light-Reflection-Probe'
+}
+
 declare enum NormalImportSetting {
     /**
      * 如果模型文件中包含法线信息则导出法线，否则不导出法线。
@@ -1850,6 +2925,14 @@ declare function onReady(listener: () => void): () => void;
 
 declare function open_2(projectPath: string): Promise<void>;
 
+declare type OperationEvent = SceneDragEvent | SceneKeyboardEvent | SceneMouseEvent | 'resize';
+
+declare enum OptimizationPolicy {
+    AUTO = 0,
+    SINGLE_INSTANCE = 1,
+    MULTI_INSTANCE = 2
+}
+
 /** 粒子资源的 userData */
 declare interface ParticleAssetUserData {
     totalParticles: number;
@@ -1928,6 +3011,13 @@ declare interface PrefabAssetUserData {
     syncNodeName?: 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
+}
+
 declare class ProgrammingFacet {
     private _packerDriverUpdateCount;
     private _asyncIteration;
@@ -2223,6 +3313,18 @@ declare function reimportAsset(pathOrUrlOrUUID: string): Promise<IAssetInfo>;
 
 declare function reload(): Promise<void>;
 
+/**
+ * 重载结果
+ */
+declare enum ReloadResult {
+    SUCCESS = 0,
+    FAILED = 1,
+    QUEUED = 2,
+    NO_EDITOR = 3,
+    ASSET_NOT_FOUND = 4,
+    EDITOR_NOT_FOUND = 5
+}
+
 declare function remove(key: string, scope?: ConfigurationScope): Promise<boolean>;
 
 /**
@@ -2260,6 +3362,17 @@ export declare namespace Scene {
     };
 }
 
+/**
+ * 场景模板类型
+ */
+declare const SCENE_TEMPLATE_TYPE: readonly ['2d', '3d', 'quality'];
+
+declare type SceneDragEvent = 'onDragLeave' | 'onDragOver' | 'onDrop';
+
+declare type SceneKeyboardEvent = 'keydown' | 'keyup';
+
+declare type SceneMouseEvent = 'dblclick' | 'mousedown' | 'mousemove' | 'mouseup' | 'mousewheel';
+
 export declare namespace Scripting {
     export {
         init_7 as init,
@@ -2445,6 +3558,10 @@ declare enum TangentImportSetting {
     recalculate = 3
 }
 
+declare type TEditorEntity = IScene | INode;
+
+declare type TEditorInstance = Scene_2 | Node_2;
+
 declare interface Texture2DAssetUserData extends TextureBaseAssetUserData {
     isUuid?: boolean;
     imageUuidOrDatabaseUri?: string;
@@ -2487,6 +3604,8 @@ declare interface ThumbnailInfo {
 
 declare type ThumbnailSize = 'large' | 'small' | 'middle' | 'origin';
 
+declare type TSceneTemplateType = typeof SCENE_TEMPLATE_TYPE[number];
+
 /**
  * Clean up MCP state.
  * Note: does NOT stop the Express server — use the Server module for that.
@@ -2503,6 +3622,24 @@ declare function updateAssetUserData(urlOrUuidOrPath: string, path: string, valu
  */
 declare function updateDefaultUserData(handler: string, path: string, value: any): Promise<void>;
 
+declare interface Vec2 {
+    x: number;
+    y: number;
+}
+
+declare interface Vec3 {
+    x: number;
+    y: number;
+    z: number;
+}
+
+declare interface Vec4 {
+    x: number;
+    y: number;
+    z: number;
+    w: number;
+}
+
 declare type WrapMode = 'repeat' | 'clamp-to-edge' | 'mirrored-repeat';
 
 export { };