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

package/index.d.ts

@@ -2,18 +2,23 @@
 
 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 {
+export declare interface AnimationClipAssetUserData {
     /** 动画名称 */
     name: string;
 }
 
-declare interface AnimationImportSetting {
+export declare interface AnimationImportSetting {
     /**
      * glTf 中原始动画资源的名称。
      */
@@ -103,16 +108,16 @@ declare interface AnimationImportSetting {
 }
 
 /** 所有资源处理器类型的常量数组（用于 Zod enum 和 TypeScript type） */
-declare const ASSET_HANDLER_TYPES: string[];
+export declare const ASSET_HANDLER_TYPES: string[];
 
-declare enum AssetActionEnum {
+export declare enum AssetActionEnum {
     'add' = 0,
     'change' = 1,
     'delete' = 2,
     'none' = 3
 }
 
-declare interface AssetChangeInfo {
+export declare interface AssetChangeInfo {
     type: AssetChangeType;
     uuid: string;
     filePath: string;
@@ -120,12 +125,12 @@ declare interface AssetChangeInfo {
     userData: object;
 }
 
-declare type AssetChangeType = AssetActionEnum;
+export declare type AssetChangeType = AssetActionEnum;
 
 /**
  * 资源数据库启动参数
  */
-declare interface AssetDBOptions {
+export declare interface AssetDBOptions {
     name: string;
     target: string;
     library: string;
@@ -147,7 +152,7 @@ declare interface AssetDBOptions {
     importConcurrency?: number;
 }
 
-declare interface AssetDBOptions_2 {
+export declare interface AssetDBOptions_2 {
     name: string;
     target: string;
     library: string;
@@ -169,9 +174,9 @@ declare interface AssetDBOptions_2 {
 }
 
 /** 资源处理器类型（从常量数组派生） */
-declare type AssetHandlerType = typeof ASSET_HANDLER_TYPES[number] | 'database';
+export declare type AssetHandlerType = typeof ASSET_HANDLER_TYPES[number] | 'database';
 
-declare interface AssetInfo extends IAssetInfo {
+export declare interface AssetInfo extends IAssetInfo {
     // Asset name
     // 资源名字
     name: string;
@@ -215,14 +220,14 @@ declare interface AssetInfo extends IAssetInfo {
     invalid: boolean;
 }
 
-declare interface AssetOperationOption {
+export declare interface AssetOperationOption {
     // 是否强制覆盖已经存在的文件，默认 false，传递后会直接覆盖文件，未传递时有冲突会直接抛异常
     overwrite?: boolean;
     // 是否自动重命名冲突文件，默认 false ，传递后会以内部规则自动重命名冲突文件，新的文件名可以在返回值中获取
     rename?: boolean;
 }
 
-declare interface AssetOperationOption {
+export declare interface AssetOperationOption {
     // 是否强制覆盖已经存在的文件，默认 false
     overwrite?: boolean;
     // 是否自动重命名冲突文件，默认 false
@@ -290,7 +295,7 @@ export declare namespace Assets {
     };
 }
 
-declare interface AssetUserDataMap {
+export declare interface AssetUserDataMap {
     'animation-clip': AnimationClipAssetUserData;
     'auto-atlas': AutoAtlasAssetUserData;
     'label-atlas': LabelAtlasAssetUserData;
@@ -328,13 +333,13 @@ declare interface AssetUserDataMap {
 }
 
 /** 音频资源的 userData */
-declare interface AudioClipAssetUserData {
+export declare interface AudioClipAssetUserData {
     /** 下载模式：0-Web Audio, 1-DOM Audio */
     downloadMode: number;
 }
 
 /** 自动图集资源的 userData */
-declare interface AutoAtlasAssetUserData {
+export declare interface AutoAtlasAssetUserData {
     compressed: boolean;
     dest: any;
     /** 打包图像的尺寸 */
@@ -364,7 +369,7 @@ export declare namespace Base {
     };
 }
 
-declare interface BaseItem {
+export declare interface BaseItem {
     /**
      * @zh 在项目设置上显示的模块名称，支持 i18n 格式
      * @en the module name displayed on the project settings, can be configured in i18n format.
@@ -415,7 +420,7 @@ declare interface BaseItem {
 }
 
 /** 位图字体资源的 userData */
-declare interface BitmapFontAssetUserData {
+export declare interface BitmapFontAssetUserData {
     /** 字体配置 */
     _fntConfig: any;
     /** 字体大小 */
@@ -424,30 +429,30 @@ declare interface BitmapFontAssetUserData {
     textureUuid: string;
 }
 
-declare interface CategoryDetail extends CategoryInfo {
+export declare interface CategoryDetail extends CategoryInfo {
     modules: IModules;
 }
 
-declare interface CategoryInfo {
+export declare interface CategoryInfo {
     label?: string;
     description?: string;
     checkable?: boolean;
     required?: boolean;
 }
 
-declare interface CCEModuleConfig {
+export declare interface CCEModuleConfig {
     description: string;
     main: string;
     types: string;
 }
 
-declare type CCEModuleMap = {
+export declare type CCEModuleMap = {
     [moduleName: string]: CCEModuleConfig;
 } & {
     mapLocation: string;
 };
 
-declare function close_2(): Promise<void>;
+export declare function close_2(): Promise<void>;
 
 export declare namespace Configuration {
     export {
@@ -473,19 +478,24 @@ export declare namespace Configuration {
 /**
  * 配置范围
  */
-declare type ConfigurationScope = 'default' | 'project';
+export declare type ConfigurationScope = 'default' | 'project';
+
+/**
+ * 创建类型
+ */
+export declare const CREATE_TYPES: readonly ['scene', 'prefab'];
 
 /**
  * Create Asset // 创建资源
  */
-declare function createAsset(options: CreateAssetOptions): Promise<IAssetInfo>;
+export declare function createAsset(options: CreateAssetOptions): Promise<IAssetInfo>;
 
 /**
  * Create Asset By Type // 按类型创建资源
  */
-declare function createAssetByType(ccType: ISupportCreateType, dirOrUrl: string, baseName: string, options?: CreateAssetByTypeOptions): Promise<IAssetInfo>;
+export declare function createAssetByType(ccType: ISupportCreateType, dirOrUrl: string, baseName: string, options?: CreateAssetByTypeOptions): Promise<IAssetInfo>;
 
-declare interface CreateAssetByTypeOptions extends AssetOperationOption {
+export declare interface CreateAssetByTypeOptions extends AssetOperationOption {
     /**
      * 指定的模板名称，默认为 default
      */
@@ -497,7 +507,7 @@ declare interface CreateAssetByTypeOptions extends AssetOperationOption {
     content?: string | Buffer | JSON;
 }
 
-declare interface CreateAssetOptions {
+export declare interface CreateAssetOptions {
     // 资源创建的输出地址，支持绝对路径和 url
     target: string;
 
@@ -525,10 +535,10 @@ declare interface CreateAssetOptions {
 /**
  * Delete Asset // 删除资源
  */
-declare function deleteAsset(dbPath: string): Promise<IAssetInfo | null>;
+export declare function deleteAsset(dbPath: string): Promise<IAssetInfo | null>;
 
 /** 文件夹资源的 userData */
-declare interface DirectoryAssetUserData {
+export declare interface DirectoryAssetUserData {
     /** 是否是资源包 */
     isBundle?: boolean;
     /** 资源包配置 ID */
@@ -540,7 +550,7 @@ declare interface DirectoryAssetUserData {
 }
 
 /** Effect 着色器资源的 userData */
-declare interface EffectAssetUserData {
+export declare interface EffectAssetUserData {
     /** 预编译组合 */
     combinations?: any;
     /** 编辑器相关数据 */
@@ -595,7 +605,7 @@ export declare namespace Engine {
     };
 }
 
-declare interface EngineInfo {
+export declare interface EngineInfo {
     typescript: {
         type: 'builtin' | 'custom'; // 当前使用的引擎类型（内置或自定义)
         builtin: string, // 内置引擎地址
@@ -610,19 +620,19 @@ declare interface EngineInfo {
     version: string;
 }
 
-declare type EventEmitterMethods = Pick<EventEmitter, 'on' | 'off' | 'once' | 'emit'>;
+export declare type EventEmitterMethods = Pick<EventEmitter, 'on' | 'off' | 'once' | 'emit'>;
 
-declare interface ExecuteAssetDBScriptMethodOptions {
+export declare interface ExecuteAssetDBScriptMethodOptions {
     name: string;
     method: string;
     args?: any[];
 }
 
-declare interface Features {
+export declare interface Features {
     [feature: string]: IModuleItem;
 }
 
-declare interface FileNameCheckConfig {
+export declare interface FileNameCheckConfig {
     // 匹配规则
     regStr: string;
     // 匹配失败时的提示类型
@@ -631,16 +641,16 @@ declare interface FileNameCheckConfig {
     failedInfo: string;
 }
 
-declare type Filter = 'none' | 'nearest' | 'linear';
+export declare type Filter = 'none' | 'nearest' | 'linear';
 
-declare interface FilterPluginOptions {
+export declare interface FilterPluginOptions {
     loadPluginInEditor?: boolean;
     loadPluginInWeb?: boolean;
     loadPluginInNative?: boolean;
     loadPluginInMiniGame?: boolean;
 }
 
-declare interface FntData {
+export declare interface FntData {
     commonHeight?: number;
     fontSize?: number;
     atlasName?: string;
@@ -648,7 +658,7 @@ declare interface FntData {
     kerningDict?: KerningDict;
 }
 
-declare interface FontDef {
+export declare interface FontDef {
     rect: {
         x: number;
         y: number;
@@ -660,35 +670,35 @@ declare interface FontDef {
     xAdvance: number;
 }
 
-declare interface FontDefDictionary {
+export declare interface FontDefDictionary {
     [charId: number]: FontDef;
 }
 
 /**
  * Generate Thumbnail // 生成资源缩略图
  */
-declare function generateThumbnail(urlOrUUIDOrPath: string, size?: ThumbnailSize): Promise<ThumbnailInfo | null>;
+export declare function generateThumbnail(urlOrUUIDOrPath: string, size?: ThumbnailSize): Promise<ThumbnailInfo | null>;
 
-declare function get<T>(key: string, scope?: ConfigurationScope): Promise<T>;
+export declare function get<T>(key: string, scope?: ConfigurationScope): Promise<T>;
 
-declare function get_2(): Promise<Project_2>;
+export declare function get_2(): Promise<Project_2>;
 
-declare function getConfig(useDefault?: boolean): Promise<IEngineConfig>;
+export declare function getConfig(useDefault?: boolean): Promise<IEngineConfig>;
 
-declare function getConfigPath(): Promise<string>;
+export declare function getConfigPath(): Promise<string>;
 
-declare function getInfo(): Promise<EngineInfo>;
+export declare function getInfo(): Promise<EngineInfo>;
 
-declare function getInfo_2(): Promise<ProjectInfo>;
+export declare function getInfo_2(): Promise<ProjectInfo>;
 
-declare function getMetadata(): Promise<ICocosConfigurationNode[]>;
+export declare function getMetadata(): Promise<ICocosConfigurationNode[]>;
 
-declare function getProgrammingFacet(): Promise<ProgrammingFacet>;
+export declare function getProgrammingFacet(): Promise<ProgrammingFacet>;
 
 /**
  * Get the MCP registration status.
  */
-declare function getStatus(): {
+export declare function getStatus(): {
     registered: boolean;
     url?: string;
 };
@@ -696,7 +706,7 @@ declare function getStatus(): {
 /**
  * Get the server running status.
  */
-declare function getStatus_2(): {
+export declare function getStatus_2(): {
     running: boolean;
     url?: string;
 };
@@ -705,10 +715,77 @@ declare function getStatus_2(): {
  * Get the current server base URL.
  * Returns undefined if the server is not running.
  */
-declare function getUrl(): string | undefined;
+export 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 {
+export declare interface GltfAnimationAssetUserData {
     gltfIndex: number;
     events: Array<{
         frame: number;
@@ -744,20 +821,20 @@ declare interface GltfAnimationAssetUserData {
 }
 
 /** glTF 嵌入图片子资源的 userData */
-declare interface GltfEmbededImageAssetUserData extends IVirtualAssetUserData {
+export declare interface GltfEmbededImageAssetUserData extends IVirtualAssetUserData {
     /** 是否修复 Alpha 透明度瑕疵 */
     fixAlphaTransparencyArtifacts?: boolean;
 }
 
-declare type GltfpackOptions = Record<string, any>;
+export declare type GltfpackOptions = Record<string, any>;
 
 /** glTF Skeleton 子资源的 userData */
-declare interface GltfSkeletonAssetUserData extends IVirtualAssetUserData {
+export declare interface GltfSkeletonAssetUserData extends IVirtualAssetUserData {
     /** 骨骼数量 */
     jointsLength?: number;
 }
 
-declare interface GlTFUserData {
+export declare interface GlTFUserData {
     assetFinder?: SerializedAssetFinder;
 
     imageMetas: ImageMeta[];
@@ -888,14 +965,32 @@ declare interface GlTFUserData {
     };
 }
 
-declare interface IAssetConfig {
+export declare namespace i18n {
+    export {
+        i18n_2 as default
+    };
+}
+
+/**
+ * 添加/创建组件的选项
+ */
+export declare interface IAddComponentOptions {
+    nodePathOrUuid: string;
+    component: string;
+}
+
+export declare interface IApplyPrefabChangesParams {
+    nodePath: string;
+}
+
+export declare interface IAssetConfig {
     displayName?: string;
     description?: string;
     docURL?: string;
     userDataConfig?: Record<string, IUerDataConfigItem>;
 }
 
-declare interface IAssetDBInfo extends AssetDBOptions {
+export declare interface IAssetDBInfo extends AssetDBOptions {
     // 当前数据库的启动状态
     state: 'none' | 'start' | 'startup' | 'refresh'; // 是否已启动
 
@@ -906,7 +1001,7 @@ declare interface IAssetDBInfo extends AssetDBOptions {
     preImportExtList: string[];
 }
 
-declare interface IAssetInfo {
+export declare interface IAssetInfo {
     name: string; // 资源名字
     source: string; // url 地址
     loadUrl: string; // loader 加载的层级地址
@@ -942,7 +1037,7 @@ declare interface IAssetInfo {
     temp?: string; // 资源临时文件目录
 }
 
-declare interface IAssetMeta<T extends ISupportCreateType | 'unknown' = 'unknown'> {
+export declare interface IAssetMeta<T extends ISupportCreateType | 'unknown' = 'unknown'> {
     ver: string;
     importer: AssetHandlerType;
     imported: boolean;
@@ -957,7 +1052,23 @@ declare interface IAssetMeta<T extends ISupportCreateType | 'unknown' = 'unknown
     name?: string;
 }
 
-declare type IAssetType =
+/**
+ * 场景相关处理接口
+ */
+export declare interface IAssetService extends IServiceEvents {
+    /**
+     * 资源发生变化时，进行处理
+     * @param uuid
+     */
+    assetChanged(uuid: string): Promise<void>;
+    /**
+     * 资源删除时，进行处理
+     * @param uuid
+     */
+    assetDeleted(uuid: string): Promise<void>;
+}
+
+export declare type IAssetType =
 | ISupportCreateCCType
 | 'cc.Asset'               // 基础资源类型（instantiation-asset）
 | 'cce.Database'           // 数据库资源
@@ -986,7 +1097,7 @@ declare type IAssetType =
 /**
  * 配置基类接口
  */
-declare interface IBaseConfiguration extends EventEmitterMethods {
+export declare interface IBaseConfiguration extends EventEmitterMethods {
     /**
      * 模块名
      */
@@ -1026,12 +1137,73 @@ declare interface IBaseConfiguration extends EventEmitterMethods {
     save(): Promise<boolean>;
 }
 
-declare interface IChunkContent {
+export declare interface IBaseCreateNodeParams {
+    path: string;
+    name?: string;
+    workMode?: '2d' | '3d';
+    position?: IVec3;
+    keepWorldTransform?: boolean;
+    canvasRequired?: boolean;
+}
+
+/**
+ * 基础标识
+ */
+export declare interface IBaseIdentifier {
+    assetName: string;
+    assetUuid: string;
+    assetUrl: string;
+    assetType: string;
+}
+
+export 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;
+}
+
+export declare interface IChangeNodeOptions {
+    source?: 'editor' | 'undo' | 'engine';
+    type?: NodeEventType;
+    propPath?: string;
+    index?: number;
+    record?: boolean;
+    dumpImmediately?: boolean;
+}
+
+export declare interface IChunkContent {
     skeleton: null | string;
     clips: string[];
 }
 
-declare interface ICocosConfigurationNode {
+export declare interface ICLI {
+    Scene: IServiceManager;
+    SceneEvents: GlobalEventManager;
+}
+
+/**
+ * 关闭场景/预制体选项
+ */
+export declare interface ICloseOptions {
+    urlOrUUID?: string;
+}
+
+export declare interface ICocosConfigurationNode {
     id: string;
     title: string;
     group: string;
@@ -1039,7 +1211,7 @@ declare interface ICocosConfigurationNode {
     properties: Record<string, ICocosConfigurationPropertySchema>;
 }
 
-declare interface ICocosConfigurationPropertySchema {
+export declare interface ICocosConfigurationPropertySchema {
     type: 'string' | 'number' | 'boolean' | 'object' | 'array';
     default?: unknown;
     title?: string;
@@ -1056,21 +1228,206 @@ declare interface ICocosConfigurationPropertySchema {
     required?: string[];
 }
 
-declare interface ICollisionMatrix {
+export declare interface ICollisionMatrix {
     [x: string]: number;
 }
 
+/**
+ * CLI 使用的组件信息，属性值以扁平的 key-value 形式呈现
+ */
+export declare interface IComponent extends IComponentIdentifier {
+    properties: {
+        [key: string]: IPropertyValueType;
+    };
+    prefab: ICompPrefabInfo | null;
+}
+
+/**
+ * 编辑器使用的组件详细信息，属性值以 IProperty 编码形式呈现，
+ * 包含 type、readonly、default 等元信息，用于编辑器 Inspector 面板渲染
+ */
+export declare interface IComponentForEditor extends IProperty {
+    value: {
+        enabled: IPropertyValueType;
+        uuid: IPropertyValueType;
+        name: IPropertyValueType;
+    } & Record<string, IPropertyValueType>;
+    mountedRoot?: string;
+}
+
+/**
+ * 组件标识信息，包含组件的基本标识字段
+ */
+export declare interface IComponentIdentifier {
+    cid: string;
+    path: string;
+    uuid: string;
+    name: string;
+    type: string;
+    enabled: boolean;
+}
+
+/**
+ * 组件服务接口，定义了所有组件相关的操作方法
+ */
+export 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;
+}
+
+export declare interface ICompPrefabInfo {
+    fileId: string;
+}
+
 /**
  * 配置的格式
  */
-declare interface IConfiguration {
+export declare interface IConfiguration {
     /**
      * 其他配置
      */
     [key: string]: any;
 }
 
-declare interface ICreateMenuInfo {
+export declare interface ICreateByAssetParams extends IBaseCreateNodeParams {
+    dbURL: string;
+}
+
+export declare interface ICreateByNodeTypeParams extends IBaseCreateNodeParams {
+    nodeType: NodeType;
+}
+
+export declare interface ICreateMenuInfo {
     // 新建菜单名称，支持 i18n:xxx
     label: string;
     // 模板名称，默认为 default ，作为模板选择的唯一标识符
@@ -1093,7 +1450,28 @@ declare interface ICreateMenuInfo {
     fileNameCheckConfigs?: FileNameCheckConfig[];
 }
 
-declare type ICroppingConfig = {
+/**
+ * 创建场景/预制体选项
+ */
+export declare interface ICreateOptions {
+    type: ICreateType;
+    baseName: string;
+    targetDirectory: string;
+    templateType?: TSceneTemplateType;
+}
+
+export declare interface ICreatePrefabFromNodeParams {
+    /** 要转换为预制体的源节点路径 */
+    nodePath: string;
+    /** 预制体资源保存 URL */
+    dbURL: string;
+    /** 是否强制覆盖现有资源 */
+    overwrite?: boolean;
+}
+
+export declare type ICreateType = typeof CREATE_TYPES[number];
+
+export declare type ICroppingConfig = {
     name: string;
     cache: Record<string, IDisplayModuleCache>,
     flags: IFlags_2,
@@ -1102,28 +1480,37 @@ declare type ICroppingConfig = {
     moduleToFallBack?: Record<string, string>;
 }
 
-declare type ICroppingConfigDeprecatedFeature = {
+export declare type ICroppingConfigDeprecatedFeature = {
     value: boolean,
     version: string
 };
 
-declare interface ICustomJointTextureLayout {
+export declare interface ICustomJointTextureLayout {
     textureLength: number;
     contents: IChunkContent[];
 }
 
-declare type IDefaultConfig = {
+export declare type IDefaultConfig = {
     key: IDefaultConfigKeys;
     name: string;
     diyConfig: (cache: Record<string, IDisplayModuleCache>, flags: IFlags_2, includeModules: string[]) => void;
 }
 
-declare type IDefaultConfigKeys = 'defaultConfig' | 'default2d' | 'default3d' | 'defaultNative' | 'defaultSmallGames'
+export declare type IDefaultConfigKeys = 'defaultConfig' | 'default2d' | 'default3d' | 'defaultNative' | 'defaultSmallGames'
+
+export declare interface IDeleteNodeParams {
+    path: string;
+    keepWorldTransform?: boolean;
+}
+
+export declare interface IDeleteNodeResult {
+    path: string;
+}
 
 /**
  * 构建使用的设计分辨率数据
  */
-declare interface IDesignResolution {
+export declare interface IDesignResolution {
     height: number;
     width: number;
     fitWidth?: boolean;
@@ -1131,19 +1518,63 @@ declare interface IDesignResolution {
     policy?: number;
 }
 
-declare interface IDisplayModuleCache {
+export declare interface IDisplayModuleCache {
     _value: boolean;
     _option?: string; // 保存下拉选项的值
     _flags?: IFlags_2; // 保存下拉选项的值的联动开关
 }
 
-declare interface IDisplayModuleItem extends IFeatureItem {
+export declare interface IDisplayModuleItem extends IFeatureItem {
     _value: boolean;
     _option?: string;
     options?: Record<string, IDisplayModuleItem>;
 }
 
-declare interface IEngineConfig extends IEngineModuleConfig {
+export 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;
+}
+
+export declare interface IEngineConfig extends IEngineModuleConfig {
     physicsConfig: IPhysicsConfig;
     macroConfig?: Record<string, string | number | boolean>;
     sortingLayers: { id: number, name: string, value: number }[];
@@ -1161,14 +1592,14 @@ declare interface IEngineConfig extends IEngineModuleConfig {
     downloadMaxConcurrency: number;
 }
 
-declare interface IEngineModuleConfig {
+export declare interface IEngineModuleConfig {
     // ---- 模块配置相关 ----
     includeModules: string[];
     flags?: IFlags;
     noDeprecatedFeatures?: { value: boolean, version: string };
 }
 
-declare interface IEngineOptions {
+export declare interface IEngineOptions {
     /**
      * 引擎仓库根目录。
      */
@@ -1187,12 +1618,32 @@ declare interface IEngineOptions {
     features: string[];
 }
 
-declare interface IEngineProjectConfig extends Exclude<IEngineConfig, 'includeModules' | 'flags' | 'noDeprecatedFeatures'> {
+export declare interface IEngineProjectConfig extends Exclude<IEngineConfig, 'includeModules' | 'flags' | 'noDeprecatedFeatures'> {
     configs?: Record<string, IEngineModuleConfig>;
     globalConfigKey?: string;
 }
 
-declare interface IFbxSetting {
+export declare interface IEngineService extends IServiceEvents {
+    /**
+     * 初始化引擎服务，目前是暂时引擎 mainLoop
+     */
+    init(): Promise<void>;
+    /**
+     * 让引擎执行一帧
+     */
+    repaintInEditMode(): Promise<void>;
+}
+
+/**
+ * 执行组件方法的选项
+ */
+export declare interface IExecuteComponentMethodOptions {
+    uuid: string;
+    name: string;
+    args: any[];
+}
+
+export declare interface IFbxSetting {
     /**
      * https://github.com/cocos-creator/FBX-glTF-conv/pull/26
      */
@@ -1228,11 +1679,11 @@ declare interface IFbxSetting {
     matchMeshNames?: boolean;
 }
 
-declare interface IFeatureGroup extends BaseItem {
+export declare interface IFeatureGroup extends BaseItem {
     options: { [feature: string]: IFeatureItem };
 }
 
-declare interface IFeatureItem extends BaseItem {
+export declare interface IFeatureItem extends BaseItem {
     /**
      * @zh 是否默认以及允许包含在上传的各个小游戏引擎插件内，目前由于部分引擎模块包体较大，默认不会打包在官方的微信引擎分离插件内。（临时方案）
      * @en Whether it is included in the upload of the various engine plugins by default. Currently, because some engine modules are packaged in a large package, the official WeChat engine separation plugin does not package them by default. (Temporary solution)
@@ -1270,24 +1721,54 @@ declare interface IFeatureItem extends BaseItem {
     cmakeConfig?: string;
 }
 
-declare type IFlags = Record<string, boolean | number>;
+export declare type IFlags = Record<string, boolean | number>;
 
-declare type IFlags_2 = Record<string, boolean | number>;
+export declare type IFlags_2 = Record<string, boolean | number>;
 
-declare interface IGetPostConfig {
+export declare interface IGetPostConfig {
     url: string | RegExp;
     handler: (req: Request_2, res: Response_2, next?: NextFunction) => Promise<void>;
 }
 
-declare interface IInitEngineInfo {
+export declare interface IGetPrefabInfoParams {
+    nodePath: string;
+}
+
+export 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;
+}
+
+export declare interface IInitEngineInfo {
     importBase: string;
     nativeBase: string;
     writablePath: string;
     serverURL?: string;
 }
 
+export declare interface IIsPrefabInstanceParams {
+    nodePath: string;
+}
+
 /** 图片资源的 userData  */
-declare interface ImageAssetUserData {
+export declare interface ImageAssetUserData {
     /** 图片类型 */
     type: ImageImportType;
     /** 垂直翻转 */
@@ -1311,9 +1792,9 @@ declare interface ImageAssetUserData {
     alpha?: string;
 }
 
-declare type ImageImportType = 'raw' | 'texture' | 'normal map' | 'sprite-frame' | 'texture cube';
+export declare type ImageImportType = 'raw' | 'texture' | 'normal map' | 'sprite-frame' | 'texture cube';
 
-declare interface ImageMeta {
+export declare interface ImageMeta {
     /**
      * 图片名字。
      */
@@ -1334,14 +1815,14 @@ declare interface ImageMeta {
     remap?: string;
 }
 
-declare interface IMiddlewareContribution {
+export declare interface IMiddlewareContribution {
     get?: IGetPostConfig[];
     post?: IGetPostConfig[];
     staticFiles?: IStaticFileConfig[];
     socket?: ISocketConfig;
 }
 
-declare interface IModuleConfig {
+export declare interface IModuleConfig {
     moduleTreeDump: {
         default: IModules;
         categories: Record<string, CategoryDetail>;
@@ -1358,43 +1839,150 @@ declare interface IModuleConfig {
     }>;
 }
 
-declare type IModuleItem = IFeatureItem | IFeatureGroup;
+export declare type IModuleItem = IFeatureItem | IFeatureGroup;
+
+export declare type IModules = Record<string, IModuleItem>;
+
+export declare interface IMountedChildrenInfo {
+    targetInfo: ITargetInfo | null;
+    nodes: INodeIdentifier[];
+}
 
-declare type IModules = Record<string, IModuleItem>;
+export declare interface IMountedComponentsInfo {
+    targetInfo: ITargetInfo | null;
+    components: IComponentIdentifier[];
+}
 
 /**
  * Import Asset // 导入资源
  */
-declare function importAsset(source: string, target: string, options?: AssetOperationOption): Promise<IAssetInfo[]>;
+export declare function importAsset(source: string, target: string, options?: AssetOperationOption): Promise<IAssetInfo[]>;
 
-declare interface ImportMap {
+export declare interface ImportMap {
     imports?: Record<string, string>;
     scopes?: Record<string, Record<string, string>>;
 }
 
-declare function init(): Promise<void>;
+export declare function init(): Promise<void>;
 
-declare function init_2(projectPath: string): Promise<void>;
+export declare function init_2(projectPath: string): Promise<void>;
 
-declare function init_3(projectPath: string): Promise<void>;
+export declare function init_3(projectPath: string): Promise<void>;
 
-declare function init_4(projectPath: string): Promise<void>;
+export declare function init_4(projectPath: string): Promise<void>;
 
-declare function init_5(projectPath: string): Promise<void>;
+export declare function init_5(projectPath: string): Promise<void>;
 
 /**
  * Initialize the scene module.
  * Registers the scene middleware and initializes scene config.
  */
-declare function init_6(): Promise<void>;
+export declare function init_6(): Promise<void>;
+
+export declare function init_7(projectPath: string): Promise<void>;
 
-declare function init_7(projectPath: string): Promise<void>;
+export declare function initEngine(enginePath: string, projectPath: string, serverURL?: string): Promise<void>;
 
-declare function initEngine(enginePath: string, projectPath: string, serverURL?: string): Promise<void>;
+export declare function initProgrammingFacet(): Promise<ProgrammingFacet>;
 
-declare function initProgrammingFacet(): Promise<ProgrammingFacet>;
+export declare interface INode extends INodeIdentifier {
+    properties: INodeProperties;
+    components?: IComponent[] | IComponentIdentifier[];
+    children?: INode[];
+    prefab: IPrefabInfo | null;
+}
+
+export declare interface INodeIdentifier {
+    nodeId: string;
+    path: string;
+    name: string;
+}
+
+export declare interface INodeProperties {
+    position: IVec3;
+    rotation: IQuat;
+    eulerAngles: IVec3;
+    scale: IVec3;
+    mobility: MobilityMode;
+    layer: number;
+    active: boolean;
+}
+
+/**
+ * 节点的相关处理接口
+ */
+export 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 IPhysicsConfig {
+export declare interface INodeTreeComponent {
+    isCustom: boolean;
+    type: string;
+    value: string;
+    extends: string[];
+}
+
+export 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[];
+}
+
+/**
+ * 打开场景/预制体选项
+ */
+export declare interface IOpenOptions {
+    urlOrUUID: string;
+    simpleNode?: boolean;
+}
+
+export 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 IPhysicsConfig {
     gravity: IVec3Like; // （0，-10， 0）
     allowSleep: boolean; // true
     sleepThreshold: number; // 0.1，最小 0
@@ -1413,18 +2001,88 @@ declare interface IPhysicsConfig {
     };
 }
 
-declare interface IPhysicsMaterial {
+export declare interface IPhysicsMaterial {
     friction: number; // 0.5
     rollingFriction: number; // 0.1
     spinningFriction: number; // 0.1
     restitution: number; // 0.1
 }
 
-declare interface IPluginScriptInfo extends PluginScriptInfo {
+export declare interface IPluginScriptInfo extends PluginScriptInfo {
     url: string;
 }
 
-declare interface IProject {
+export declare interface IPrefab {
+    name: string;
+    uuid: string;
+    data: INodeIdentifier;
+    optimizationPolicy: OptimizationPolicy;
+    persistent: boolean;
+}
+
+export declare interface IPrefabInfo {
+    /** 关联的预制体资源信息 */
+    asset?: IPrefab;
+    root?: INodeIdentifier;
+    instance?: IPrefabInstance;
+    fileId: string;
+    targetOverrides: ITargetOverrideInfo[];
+    nestedPrefabInstanceRoots: INodeIdentifier[];
+}
+
+export declare interface IPrefabInstance {
+    fileId: string;
+    prefabRootNode?: INodeIdentifier;
+    mountedChildren: IMountedChildrenInfo[];
+    mountedComponents: IMountedComponentsInfo[];
+    propertyOverrides: IPropertyOverrideInfo[];
+    removedComponents: ITargetInfo[];
+}
+
+export 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;
+}
+
+export declare interface IPrefabStateInfo {
+    state: PrefabState;
+    isUnwrappable: boolean;
+    isRevertable: boolean;
+    isApplicable: boolean;
+    isAddedChild: boolean;
+    isNested: boolean;
+    assetUuid: string;
+}
+
+export declare interface IProject {
     /**
      * Gets the project directory path
      *
@@ -1497,26 +2155,297 @@ declare interface IProject {
     updateInfo<T>(keyOrValue: string | ProjectInfo, value?: T): Promise<boolean>;
 }
 
-declare interface IRedirectInfo {
+/**
+ * 组件的 dump 数据，以 IProperty 格式编码组件信息
+ * 与 IComponent 不同，所有属性（包括 uuid, name, enabled）都通过 encodeObject 编码为 IProperty
+ */
+export 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 }; // 用户透传的数据
+}
+
+export declare interface IPropertyGroupOptions {
+    id: string // 默认 'default'
+    name: string,
+    displayOrder: number, // 默认 Infinity, 排在最后面
+    style: string // 默认为 'tab'
+}
+
+export declare type IPropertyLock = { 
+    default: number; 
+    message: string 
+};
+
+export declare interface IPropertyOverrideInfo {
+    targetInfo: ITargetInfo | null;
+    propertyPath: string[];
+    value?: any;
+}
+
+export declare type IPropertyValueType = IProperty | IProperty[] | null | undefined | number | boolean | string | Vec4 | Vec3 | Vec2 | Mat4 | any | Array<unknown>
+
+export declare interface IQuat {
+    x: number;
+    y: number;
+    z: number;
+    w: number;
+}
+
+/**
+ * 查询注册类的过滤选项
+ */
+export declare interface IQueryClassesOptions {
+    extends?: string | string[];
+    excludeSelf?: boolean;
+}
+
+/**
+ * 查询组件的选项
+ */
+export declare interface IQueryComponentOptions {
+    path: string;
+}
+
+export declare interface IQueryNodeParams {
+    path: string;
+    queryChildren: boolean;
+    queryComponent: boolean;
+}
+
+export declare interface IQueryNodeTreeParams {
+    path?: string;
+}
+
+export declare interface IRedirectInfo {
     // 跳转资源的类型
     type: string;
     // 跳转资源的 uuid
     uuid: string;
 }
 
-declare interface ISocketConfig {
+/**
+ * 软刷新场景/预制体选项
+ */
+export declare interface IReloadOptions {
+    urlOrUUID?: string;
+}
+
+/**
+ * 删除组件的选项
+ */
+export declare interface IRemoveComponentOptions {
+    path: string;
+}
+
+export declare interface IRevertToPrefabParams {
+    nodePath: string;
+}
+
+/**
+ * 保持场景/预制体选项
+ */
+export declare interface ISaveOptions {
+    urlOrUUID?: string;
+}
+
+/**
+ * 场景信息
+ */
+export declare interface IScene extends IBaseIdentifier {
+    name: string;
+    prefab: IPrefabInfo | null;
+    children: INode[];
+    components: IComponentIdentifier[];
+}
+
+export 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;
+}
+
+export 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;
+}
+
+export 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;
+}
+
+export declare interface ISelectionService {
+    select(uuid: string): void;
+    unselect(uuid: string): void;
+    clear(): void;
+    query(): string[];
+    isSelect(uuid: string): boolean;
+    reset(): void;
+}
+
+export 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 设置组件属性的选项
+ */
+export declare interface ISetPropertyOptions {
+    componentPath: string;
+    properties: {
+        [key: string]: null | undefined | number | boolean | string | object | Array<unknown>;
+    };
+    record?: boolean;
+}
+
+/**
+ * 编辑器设置组件属性的选项
+ */
+export declare interface ISetPropertyOptionsForEditor {
+    uuid: string;
+    path: string;
+    dump: IProperty;
+    record?: boolean;
+}
+
+export declare interface ISocketConfig {
     connection: (socket: any) => void;
     disconnect: (socket: any) => void;
 }
 
-declare interface ISplashBackgroundColor {
+export declare interface ISplashBackgroundColor {
     x: number;
     y: number;
     z: number;
     w: number;
 }
 
-declare interface ISplashSetting {
+export declare interface ISplashSetting {
     displayRatio: number;
     totalTime: number;
     watermarkLocation: 'default' | 'topLeft' | 'topRight' | 'topCenter' | 'bottomLeft' | 'bottomCenter' | 'bottomRight';
@@ -1535,12 +2464,12 @@ declare interface ISplashSetting {
     }
 }
 
-declare interface IStaticFileConfig {
+export declare interface IStaticFileConfig {
     url: string;
     path: string;
 }
 
-declare type ISupportCreateCCType =
+export declare type ISupportCreateCCType =
 | 'cc.AnimationClip'        // 动画剪辑
 | 'cc.Script'               // 脚本（TypeScript/JavaScript）
 | 'cc.SpriteAtlas'          // 精灵图集（自动图集）
@@ -1558,9 +2487,21 @@ declare type ISupportCreateCCType =
 | 'cc.AnimationGraphVariant';
 
 /** 支持创建的资源类型（从常量数组派生） */
-declare type ISupportCreateType = typeof SUPPORT_CREATE_TYPES[number];
+export declare type ISupportCreateType = typeof SUPPORT_CREATE_TYPES[number];
+
+export declare interface ITargetInfo {
+    localID: string[];
+}
 
-declare interface IUerDataConfigItem {
+export declare interface ITargetOverrideInfo {
+    source: IComponentIdentifier | INodeIdentifier | null;
+    sourceInfo: ITargetInfo | null;
+    propertyPath: string[];
+    target: INodeIdentifier | null;
+    targetInfo: ITargetInfo | null;
+}
+
+export declare interface IUerDataConfigItem {
     key?: string; // 唯一标识符
     // 配置显示的名字，如果需要翻译，则传入 i18n:${key}
     label?: string;
@@ -1582,14 +2523,48 @@ declare interface IUerDataConfigItem {
     };
 }
 
-declare interface IVec3Like {
+export 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;
+}
+
+export declare interface IUnpackPrefabInstanceParams {
+    /** 要解耦的预制体实例节点 */
+    nodePath: string;
+    /** 递归解耦所有子预制体 */
+    recursive?: boolean;
+}
+
+export declare interface IUpdateNodeParams {
+    path: string;
+    name?: string;
+    properties?: Partial<INodeProperties>;
+}
+
+export declare interface IUpdateNodeResult {
+    path: string;
+}
+
+export declare interface IVec3 {
+    x: number;
+    y: number;
+    z: number;
+}
+
+export declare interface IVec3Like {
     x: number;
     y: number;
     z: number;
 }
 
 /** glTF 虚拟子资源的通用 userData */
-declare interface IVirtualAssetUserData {
+export declare interface IVirtualAssetUserData {
     /** 在 glTF 文件中的索引 */
     gltfIndex?: number;
     /** mesh 资源的面数 */
@@ -1605,20 +2580,20 @@ declare interface IVirtualAssetUserData {
 }
 
 /** JavaScript 资源的 userData */
-declare type JavaScriptAssetUserData = ScriptModuleUserData | PluginScriptUserData;
+export declare type JavaScriptAssetUserData = ScriptModuleUserData | PluginScriptUserData;
 
 /** JSON 资源的 userData */
-declare interface JsonAssetUserData {
+export declare interface JsonAssetUserData {
     /** 是否启用 JSON5 解析 */
     json5?: boolean;
 }
 
-declare interface KerningDict {
+export declare interface KerningDict {
     [key: number]: number;
 }
 
 /** 标签图集资源的 userData */
-declare interface LabelAtlasAssetUserData {
+export declare interface LabelAtlasAssetUserData {
     itemWidth: number;
     itemHeight: number;
     startChar: string;
@@ -1627,14 +2602,14 @@ declare interface LabelAtlasAssetUserData {
     _fntConfig: FntData;
 }
 
-declare interface LODsOption {
+export declare interface LODsOption {
     // 屏占比
     screenRatio: number;
     // 和 lod0 的减面比
     faceCount: number;
 }
 
-declare const enum LogLevel {
+export declare const enum LogLevel {
     NONE = 0,
     Error = 1,
     WARN = 2,
@@ -1642,12 +2617,34 @@ declare const enum LogLevel {
     DEBUG = 4
 }
 
-declare type MacroItem = {
+export declare type MacroItem = {
     key: string;
     value: boolean;
 }
 
-declare type MakeRequired<T, K extends keyof T> = T & Required<Pick<T, K>>;
+export declare type MakeRequired<T, K extends keyof T> = T & Required<Pick<T, K>>;
+
+export 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 {
@@ -1657,26 +2654,26 @@ export declare namespace Mcp {
     };
 }
 
-declare interface MeshClusterOptions {
+export declare interface MeshClusterOptions {
     enable: boolean;
     coneCluster?: boolean;
 }
 
-declare interface MeshCompressOptions {
+export declare interface MeshCompressOptions {
     enable: boolean;
     encode?: boolean;
     compress?: boolean;
     quantize?: boolean;
 }
 
-declare interface MeshOptimizeOptions {
+export declare interface MeshOptimizeOptions {
     enable: boolean;
     vertexCache?: boolean;
     vertexFetch?: boolean;
     overdraw?: boolean;
 }
 
-declare interface MeshOptimizerOption {
+export declare interface MeshOptimizerOption {
     // 是否启用此功能
     enable: boolean;
     // 减面算法，默认 simplify
@@ -1686,7 +2683,7 @@ declare interface MeshOptimizerOption {
     gltfpackOptions?: GltfpackOptions;
 }
 
-declare interface MeshSimplifyOptions {
+export declare interface MeshSimplifyOptions {
     enable: boolean;
     targetRatio?: number;
     autoErrorRate?: boolean;
@@ -1694,16 +2691,34 @@ declare interface MeshSimplifyOptions {
     lockBoundary?: boolean;
 }
 
-declare function migrate(): Promise<void>;
+export declare function migrate(): Promise<void>;
 
-declare function migrateFromProject(): Promise<IConfiguration>;
+export declare function migrateFromProject(): Promise<IConfiguration>;
 
-declare interface Migration {
+export declare interface Migration {
     version: string;
     migrate(moduleCache: Record<string, boolean>): Record<string, boolean>;
 }
 
-declare interface ModuleRenderConfig {
+export declare enum MobilityMode {
+    /**
+     * @en Static node
+     * @zh 静态节点
+     */
+    Static = 0,
+    /**
+     * @en Stationary node
+     * @zh 固定节点
+     */
+    Stationary = 1,
+    /**
+     * @en Movable node
+     * @zh 可移动节点
+     */
+    Movable = 2
+}
+
+export declare interface ModuleRenderConfig {
     $schema?: string;
 
     /**
@@ -1727,9 +2742,69 @@ declare interface ModuleRenderConfig {
 /**
  * Move Asset // 移动资源
  */
-declare function moveAsset(source: string, target: string, options?: AssetOperationOption): Promise<any>;
-
-declare enum NormalImportSetting {
+export declare function moveAsset(source: string, target: string, options?: AssetOperationOption): Promise<any>;
+
+export declare enum NodeEventType {
+    TRANSFORM_CHANGED = 'transform-changed',// 节点改变位置、旋转或缩放事件
+    SIZE_CHANGED = 'size-changed',// 当节点尺寸改变时触发的事件
+    ANCHOR_CHANGED = 'anchor-changed',// 当节点锚点改变时触发的事件
+    CHILD_ADDED = 'child-added',// 节点子类添加
+    CHILD_REMOVED = 'child-removed',// 节点子类移除
+    PARENT_CHANGED = 'parent-changed',// 父节点改变时触发的事件
+    CHILD_CHANGED = 'child-changed',// 子节点改变时触发的事件
+    COMPONENT_CHANGED = 'component-changed',// 组件数据发生改变时
+    ACTIVE_IN_HIERARCHY_CHANGE = 'active-in-hierarchy-changed',// 节点在hierarchy是否激活
+    NOTIFY_NODE_CHANGED = 'notify-node-changed',
+    PREFAB_INFO_CHANGED = 'prefab-info-changed',// prefab数据改变
+    LIGHT_PROBE_CHANGED = 'light-probe-changed',// 光照探针数据改变
+    SET_PROPERTY = 'set-property',// 设置节点上的属性
+    MOVE_ARRAY_ELEMENT = 'move-array-element',// 调整一个数组类型的数据内某个 item 的位置
+    REMOVE_ARRAY_ELEMENT = 'remove-array-element',// 删除一个数组元素
+    CREATE_COMPONENT = 'create-component',// 创建一个组件
+    RESET_COMPONENT = 'reset-component'
+}
+
+export declare 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'
+}
+
+export declare enum NormalImportSetting {
     /**
      * 如果模型文件中包含法线信息则导出法线，否则不导出法线。
      */
@@ -1764,7 +2839,7 @@ declare enum NormalImportSetting {
  * removeListener();
  * ```
  */
-declare function onAssetAdded(listener: (info: IAssetInfo) => void): () => void;
+export declare function onAssetAdded(listener: (info: IAssetInfo) => void): () => void;
 
 /**
  * Listen to Asset Changed Event // 监听资源变更事件
@@ -1780,7 +2855,7 @@ declare function onAssetAdded(listener: (info: IAssetInfo) => void): () => void;
  * removeListener();
  * ```
  */
-declare function onAssetChanged(listener: (info: IAssetInfo) => void): () => void;
+export declare function onAssetChanged(listener: (info: IAssetInfo) => void): () => void;
 
 /**
  * Listen to Asset Removed Event // 监听资源删除事件
@@ -1796,7 +2871,7 @@ declare function onAssetChanged(listener: (info: IAssetInfo) => void): () => voi
  * removeListener();
  * ```
  */
-declare function onAssetRemoved(listener: (info: IAssetInfo) => void): () => void;
+export declare function onAssetRemoved(listener: (info: IAssetInfo) => void): () => void;
 
 /**
  * Register listener for when a specific database finishes starting.
@@ -1810,14 +2885,14 @@ declare function onAssetRemoved(listener: (info: IAssetInfo) => void): () => voi
  * @param listener 回调函数，接收启动完成的 dbInfo
  * @returns 移除监听的函数
  */
-declare function onDBReady(listener: (dbInfo: IAssetDBInfo) => void): () => void;
+export declare function onDBReady(listener: (dbInfo: IAssetDBInfo) => void): () => void;
 
 /**
  * 注册 configurationManager 保存事件的监听器
  * 每次 cocos.config.json 被写入磁盘时触发
  * @returns 取消监听的函数
  */
-declare function onDidSave(callback: () => void): () => void;
+export declare function onDidSave(callback: () => void): () => void;
 
 /**
  * Register listener for initialization progress.
@@ -1831,7 +2906,7 @@ declare function onDidSave(callback: () => void): () => void;
  * @param listener 回调函数，包含当前进度、总数、当前处理的资源 url 和导入状态
  * @returns 移除监听的函数
  */
-declare function onProgress(listener: (current: number, total: number, url: string, state: 'processing' | 'success' | 'failed') => void): () => void;
+export declare function onProgress(listener: (current: number, total: number, url: string, state: 'processing' | 'success' | 'failed') => void): () => void;
 
 /**
  * Register listener for when all asset databases are fully initialized.
@@ -1846,12 +2921,20 @@ declare function onProgress(listener: (current: number, total: number, url: stri
  * @param listener 回调函数
  * @returns 移除监听的函数
  */
-declare function onReady(listener: () => void): () => void;
+export declare function onReady(listener: () => void): () => void;
+
+export declare function open_2(projectPath: string): Promise<void>;
 
-declare function open_2(projectPath: string): Promise<void>;
+export declare type OperationEvent = SceneDragEvent | SceneKeyboardEvent | SceneMouseEvent | 'resize';
+
+export declare enum OptimizationPolicy {
+    AUTO = 0,
+    SINGLE_INSTANCE = 1,
+    MULTI_INSTANCE = 2
+}
 
 /** 粒子资源的 userData */
-declare interface ParticleAssetUserData {
+export declare interface ParticleAssetUserData {
     totalParticles: number;
     life: number;
     lifeVar: number;
@@ -1894,7 +2977,7 @@ declare interface ParticleAssetUserData {
     spriteFrameUuid: string;
 }
 
-declare interface PluginScriptInfo {
+export declare interface PluginScriptInfo {
     /**
      * 脚本文件。
      */
@@ -1903,7 +2986,7 @@ declare interface PluginScriptInfo {
 }
 
 /** JavaScript 插件脚本的 userData */
-declare interface PluginScriptUserData {
+export declare interface PluginScriptUserData {
     isPlugin: true;
     /** 界面没有开放给用户。默认开启 */
     experimentalHideCommonJs?: boolean;
@@ -1921,14 +3004,21 @@ declare interface PluginScriptUserData {
 }
 
 /** 场景/预制体资源的 userData */
-declare interface PrefabAssetUserData {
+export declare interface PrefabAssetUserData {
     /** 是否为持久节点 */
     persistent?: boolean;
     /** 同步节点名称 */
     syncNodeName?: string;
 }
 
-declare class ProgrammingFacet {
+export 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
+}
+
+export declare class ProgrammingFacet {
     private _packerDriverUpdateCount;
     private _asyncIteration;
     static create(engine: IEngineOptions, projectPath: string): Promise<ProgrammingFacet>;
@@ -1975,7 +3065,7 @@ export declare namespace Project {
     };
 }
 
-declare class Project_2 implements IProject {
+export declare class Project_2 implements IProject {
     /**
      * The version of the Project
      */
@@ -2018,7 +3108,7 @@ declare class Project_2 implements IProject {
 /**
  * Project creator information
  */
-declare interface ProjectCreatorInfo {
+export declare interface ProjectCreatorInfo {
     /**
      * Version of the tool or engine used to create the project
      */
@@ -2047,7 +3137,7 @@ declare interface ProjectCreatorInfo {
 /**
  * Project information
  */
-declare interface ProjectInfo {
+export declare interface ProjectInfo {
     /**
      * Project name
      */
@@ -2084,39 +3174,39 @@ declare interface ProjectInfo {
  * - '2d': 2D Project
  * - '3d': 3D Project
  */
-declare type ProjectType = '2d' | '3d';
+export declare type ProjectType = '2d' | '3d';
 
 /**
  * Query Asset Config Map // 查询资源配置映射表
  */
-declare function queryAssetConfigMap(): Promise<Record<string, IAssetConfig>>;
+export declare function queryAssetConfigMap(): Promise<Record<string, IAssetConfig>>;
 
 /**
  * Query All Asset Database Info // 查询所有资源数据库信息
  */
-declare function queryAssetDBInfos(): Promise<Record<string, IAssetDBInfo>>;
+export declare function queryAssetDBInfos(): Promise<Record<string, IAssetDBInfo>>;
 
 /**
  * Query Asset Dependencies // 查询资源依赖
  */
-declare function queryAssetDependencies(uuidOrUrl: string, type?: QueryAssetType): Promise<string[]>;
+export declare function queryAssetDependencies(uuidOrUrl: string, type?: QueryAssetType): Promise<string[]>;
 
 /**
  * Query Asset Info // 查询资源信息
  */
-declare function queryAssetInfo(urlOrUUIDOrPath: string, dataKeys?: string[] | undefined): Promise<IAssetInfo | null>;
+export declare function queryAssetInfo(urlOrUUIDOrPath: string, dataKeys?: string[] | undefined): Promise<IAssetInfo | null>;
 
 /**
  * Batch Query Asset Info // 批量查询资源信息
  */
-declare function queryAssetInfos(options?: QueryAssetsOption): Promise<IAssetInfo[]>;
+export declare function queryAssetInfos(options?: QueryAssetsOption): Promise<IAssetInfo[]>;
 
 /**
  * Query Asset Metadata // 查询资源元数据
  */
-declare function queryAssetMeta(urlOrUUIDOrPath: string): Promise<IAssetMeta<'unknown'> | null>;
+export declare function queryAssetMeta(urlOrUUIDOrPath: string): Promise<IAssetMeta<'unknown'> | null>;
 
-declare interface QueryAssetsOption {
+export declare interface QueryAssetsOption {
     ccType?: string | string[], // 'cc.ImageAsset' 这类，多个用数组
     isBundle?: boolean, // 筛选 asset bundle 信息，搜索子包只能与 pattern 选项共存
     importer?: string | string[], // 导入名称，多个用数组
@@ -2132,24 +3222,24 @@ declare interface QueryAssetsOption {
     type?: string;
 }
 
-declare type QueryAssetType = 'asset' | 'script' | 'all';
+export declare type QueryAssetType = 'asset' | 'script' | 'all';
 
 /**
  * Query Asset User Data Config // 查询资源用户数据配置
  */
-declare function queryAssetUserDataConfig(urlOrUuidOrPath: string): Promise<false | Record<string, IUerDataConfigItem> | undefined>;
+export declare function queryAssetUserDataConfig(urlOrUuidOrPath: string): Promise<false | Record<string, IUerDataConfigItem> | undefined>;
 
 /**
  * Query Asset Users // 查询资源使用者
  */
-declare function queryAssetUsers(uuidOrUrl: string, type?: QueryAssetType): Promise<string[]>;
+export declare function queryAssetUsers(uuidOrUrl: string, type?: QueryAssetType): Promise<string[]>;
 
 /**
  * Query Creatable Asset Map // 查询可创建资源映射表
  */
-declare function queryCreateMap(): Promise<ICreateMenuInfo[]>;
+export declare function queryCreateMap(): Promise<ICreateMenuInfo[]>;
 
-declare function queryLayerBuiltin(): Promise<{
+export declare function queryLayerBuiltin(): Promise<{
     name: string;
     value: number;
 }[]>;
@@ -2157,34 +3247,34 @@ declare function queryLayerBuiltin(): Promise<{
 /**
  * Query Asset Path // 查询资源路径
  */
-declare function queryPath(urlOrUuid: string): Promise<string>;
+export declare function queryPath(urlOrUuid: string): Promise<string>;
 
 /**
  * Query Sorted Plugin Scripts // 查询排序后的插件脚本
  */
-declare function querySortedPlugins(filterOptions?: FilterPluginOptions): Promise<IPluginScriptInfo[]>;
+export declare function querySortedPlugins(filterOptions?: FilterPluginOptions): Promise<IPluginScriptInfo[]>;
 
-declare function querySortingLayerBuiltin(): Promise<readonly __private._cocos_sorting_sorting_layers__SortingItem[]>;
+export declare function querySortingLayerBuiltin(): Promise<readonly __private._cocos_sorting_sorting_layers__SortingItem[]>;
 
 /**
  * Query Thumbnail Handlers // 查询支持缩略图生成的资源处理器列表
  */
-declare function queryThumbnailHandlers(): string[];
+export declare function queryThumbnailHandlers(): string[];
 
 /**
  * Query Asset URL // 查询资源 URL
  */
-declare function queryUrl(uuidOrPath: string): Promise<string>;
+export declare function queryUrl(uuidOrPath: string): Promise<string>;
 
 /**
  * Query Asset UUID // 查询资源 UUID
  */
-declare function queryUUID(urlOrPath: string): Promise<string | null>;
+export declare function queryUUID(urlOrPath: string): Promise<string | null>;
 
 /**
  * Refresh Asset Directory // 刷新资源目录
  */
-declare function refresh(dir: string): Promise<number>;
+export declare function refresh(dir: string): Promise<number>;
 
 /**
  * MCP Facade Module
@@ -2205,7 +3295,7 @@ declare function refresh(dir: string): Promise<number>;
  *
  * @returns MCP endpoint URL (e.g. http://localhost:9527/mcp)
  */
-declare function register(): Promise<string>;
+export declare function register(): Promise<string>;
 
 /**
  * Register a middleware contribution (routes, static files, sockets)
@@ -2214,30 +3304,42 @@ declare function register(): Promise<string>;
  * @param name   Middleware identifier
  * @param module Middleware contribution config
  */
-declare function register_2(name: string, module: IMiddlewareContribution): Promise<void>;
+export declare function register_2(name: string, module: IMiddlewareContribution): Promise<void>;
 
 /**
  * Reimport Asset // 重新导入资源
  */
-declare function reimportAsset(pathOrUrlOrUUID: string): Promise<IAssetInfo>;
+export declare function reimportAsset(pathOrUrlOrUUID: string): Promise<IAssetInfo>;
+
+export declare function reload(): Promise<void>;
 
-declare function reload(): Promise<void>;
+/**
+ * 重载结果
+ */
+export 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>;
+export declare function remove(key: string, scope?: ConfigurationScope): Promise<boolean>;
 
 /**
  * Rename Asset // 重命名资源
  */
-declare function renameAsset(source: string, target: string, options?: AssetOperationOption): Promise<any>;
+export declare function renameAsset(source: string, target: string, options?: AssetOperationOption): Promise<any>;
 
 /** 渲染纹理资源的 userData */
-declare interface RenderTextureAssetUserData extends TextureBaseAssetUserData {
+export declare interface RenderTextureAssetUserData extends TextureBaseAssetUserData {
     width: number;
     height: number;
 }
 
 /** 渲染纹理精灵帧的 userData */
-declare interface RtSpriteFrameAssetUserData {
+export declare interface RtSpriteFrameAssetUserData {
     /** 图片 UUID 或数据库 URI */
     imageUuidOrDatabaseUri: string;
     /** 宽度 */
@@ -2246,12 +3348,12 @@ declare interface RtSpriteFrameAssetUserData {
     height?: number;
 }
 
-declare function save(force?: boolean): Promise<void>;
+export declare function save(force?: boolean): Promise<void>;
 
 /**
  * Save Asset // 保存资源
  */
-declare function saveAsset(pathOrUrlOrUUID: string, data: string | Buffer): Promise<IAssetInfo>;
+export declare function saveAsset(pathOrUrlOrUUID: string, data: string | Buffer): Promise<IAssetInfo>;
 
 export declare namespace Scene {
     export {
@@ -2260,6 +3362,17 @@ export declare namespace Scene {
     };
 }
 
+/**
+ * 场景模板类型
+ */
+export declare const SCENE_TEMPLATE_TYPE: readonly ['2d', '3d', 'quality'];
+
+export declare type SceneDragEvent = 'onDragLeave' | 'onDragOver' | 'onDrop';
+
+export declare type SceneKeyboardEvent = 'keydown' | 'keyup';
+
+export declare type SceneMouseEvent = 'dblclick' | 'mousedown' | 'mousemove' | 'mouseup' | 'mousewheel';
+
 export declare namespace Scripting {
     export {
         init_7 as init,
@@ -2273,11 +3386,11 @@ export declare namespace Scripting {
 }
 
 /** JavaScript 脚本模块的 userData */
-declare interface ScriptModuleUserData {
+export declare interface ScriptModuleUserData {
     isPlugin: false;
 }
 
-declare interface SerializedAssetFinder {
+export declare interface SerializedAssetFinder {
     meshes?: Array<string | null>;
     animations?: Array<string | null>;
     skeletons?: Array<string | null>;
@@ -2296,9 +3409,9 @@ export declare namespace Server {
     };
 }
 
-declare function set<T>(key: string, value: T, scope?: ConfigurationScope): Promise<boolean>;
+export declare function set<T>(key: string, value: T, scope?: ConfigurationScope): Promise<boolean>;
 
-declare interface SharedSettings {
+export declare interface SharedSettings {
     useDefineForClassFields: boolean;
     allowDeclareFields: boolean;
     loose: boolean;
@@ -2314,7 +3427,7 @@ declare interface SharedSettings {
     };
 }
 
-declare interface SimplifyOptions {
+export declare interface SimplifyOptions {
     // 压缩比例
     targetRatio?: number;
     // 防止破面
@@ -2326,13 +3439,13 @@ declare interface SimplifyOptions {
 }
 
 /** Spine 资源的 userData */
-declare interface SpineAssetUserData {
+export declare interface SpineAssetUserData {
     /** 图集资源的 UUID */
     atlasUuid: string;
 }
 
 /** 精灵图集资源的 userData */
-declare interface SpriteAtlasAssetUserData {
+export declare interface SpriteAtlasAssetUserData {
     /** 图集纹理名称 */
     atlasTextureName: string;
     /** 纹理 UUID */
@@ -2345,12 +3458,12 @@ declare interface SpriteAtlasAssetUserData {
     format: number;
 }
 
-declare interface SpriteFrameAssetUserData extends SpriteFrameBaseAssetUserData {
+export declare interface SpriteFrameAssetUserData extends SpriteFrameBaseAssetUserData {
     isUuid?: boolean;
     imageUuidOrDatabaseUri: string;
 }
 
-declare interface SpriteFrameBaseAssetUserData {
+export declare interface SpriteFrameBaseAssetUserData {
     trimType?: string;
     trimThreshold: number;
     rotated: boolean;
@@ -2374,7 +3487,7 @@ declare interface SpriteFrameBaseAssetUserData {
     vertices: SpriteFrameVertices;
 }
 
-declare interface SpriteFrameVertices {
+export declare interface SpriteFrameVertices {
     rawPosition: number[];
     indexes: number[];
     uv: number[];
@@ -2387,7 +3500,7 @@ declare interface SpriteFrameVertices {
 /**
  * Start Asset DB // 启动资源数据库，开始扫描和导入资源
  */
-declare function start(): Promise<void>;
+export declare function start(): Promise<void>;
 
 /**
  * Server Facade Module
@@ -2401,32 +3514,32 @@ declare function start(): Promise<void>;
  * @param port Optional port number; auto-selected if omitted
  * @returns The server base URL (e.g. http://localhost:9527)
  */
-declare function start_2(port?: number): Promise<string>;
+export declare function start_2(port?: number): Promise<string>;
 
 /**
  * 在独立的子进程中运行项目脚本编译
  * 以避免阻塞主进程
  */
-declare function startCompileScript(assetChanges?: AssetChangeInfo[]): Promise<void>;
+export declare function startCompileScript(assetChanges?: AssetChangeInfo[]): Promise<void>;
 
-declare function startEngineCompilation(force?: boolean): Promise<void>;
+export declare function startEngineCompilation(force?: boolean): Promise<void>;
 
 /**
  * Start the scene worker process.
  *
  * @param projectPath Path to the project directory
  */
-declare function startupWorker(projectPath: string): Promise<void>;
+export declare function startupWorker(projectPath: string): Promise<void>;
 
 /**
  * Stop the Express HTTP server.
  */
-declare function stop_2(): Promise<void>;
+export declare function stop_2(): Promise<void>;
 
 /** 支持创建的资源类型常量数组（用于 Zod enum 和 TypeScript type） */
-declare const SUPPORT_CREATE_TYPES: readonly ['animation-clip', 'typescript', 'auto-atlas', 'effect', 'scene', 'prefab', 'material', 'terrain', 'physics-material', 'label-atlas', 'render-texture', 'directory', 'effect-header'];
+export declare const SUPPORT_CREATE_TYPES: readonly ['animation-clip', 'typescript', 'auto-atlas', 'effect', 'scene', 'prefab', 'material', 'terrain', 'physics-material', 'label-atlas', 'render-texture', 'directory', 'effect-header'];
 
-declare enum TangentImportSetting {
+export declare enum TangentImportSetting {
     /**
      * 不在导出的网格中包含正切信息。
      */
@@ -2445,12 +3558,16 @@ declare enum TangentImportSetting {
     recalculate = 3
 }
 
-declare interface Texture2DAssetUserData extends TextureBaseAssetUserData {
+export declare type TEditorEntity = IScene | INode;
+
+export declare type TEditorInstance = Scene_2 | Node_2;
+
+export declare interface Texture2DAssetUserData extends TextureBaseAssetUserData {
     isUuid?: boolean;
     imageUuidOrDatabaseUri?: string;
 }
 
-declare interface TextureBaseAssetUserData {
+export declare interface TextureBaseAssetUserData {
     wrapModeS: WrapMode;
     wrapModeT: WrapMode;
     minfilter: Filter;
@@ -2459,7 +3576,7 @@ declare interface TextureBaseAssetUserData {
     anisotropy: number;
 }
 
-declare interface TextureCubeAssetUserData extends TextureBaseAssetUserData {
+export declare interface TextureCubeAssetUserData extends TextureBaseAssetUserData {
     imageDatabaseUri?: string;
     isRGBE: boolean;
 
@@ -2480,29 +3597,49 @@ declare interface TextureCubeAssetUserData extends TextureBaseAssetUserData {
     bottom?: string;
 }
 
-declare interface ThumbnailInfo {
+export declare interface ThumbnailInfo {
     type: 'icon' | 'image',
     value: string; // 具体 icon 名字或者 image 路径，image 路径支持绝对路径、 db:// 、 project:// 、和 packages:// 下的路径
 }
 
-declare type ThumbnailSize = 'large' | 'small' | 'middle' | 'origin';
+export declare type ThumbnailSize = 'large' | 'small' | 'middle' | 'origin';
+
+export 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.
  */
-declare function unregister(): Promise<void>;
+export declare function unregister(): Promise<void>;
 
 /**
  * Update Asset User Data // 更新资源用户数据
  */
-declare function updateAssetUserData(urlOrUuidOrPath: string, path: string, value: any): Promise<any>;
+export declare function updateAssetUserData(urlOrUuidOrPath: string, path: string, value: any): Promise<any>;
 
 /**
  * Update Default User Data // 更新默认用户数据
  */
-declare function updateDefaultUserData(handler: string, path: string, value: any): Promise<void>;
+export declare function updateDefaultUserData(handler: string, path: string, value: any): Promise<void>;
+
+export declare interface Vec2 {
+    x: number;
+    y: number;
+}
+
+export declare interface Vec3 {
+    x: number;
+    y: number;
+    z: number;
+}
+
+export declare interface Vec4 {
+    x: number;
+    y: number;
+    z: number;
+    w: number;
+}
 
-declare type WrapMode = 'repeat' | 'clamp-to-edge' | 'mirrored-repeat';
+export declare type WrapMode = 'repeat' | 'clamp-to-edge' | 'mirrored-repeat';
 
 export { };