vrtalk-web-sdk 0.1.602 → 0.1.604

package/dist/src/api-catalog/xr-api-catalog.d.ts

@@ -86,6 +86,7 @@ export declare class XrApiEventMeta {
     platform: XrApiPlatform;
     legacySignalSource?: string;
     legacySignalType?: string;
+    sourceScope?: 'image' | 'video' | 'panel_button';
 }
 /** 类的种类：静态类（无实例、全静态方法）/ 实体类（空间实体或其子件，可作 entity_ref 变量类型） */
 export declare type XrApiClassKind = 'static' | 'entity';
@@ -113,6 +114,7 @@ export declare class XrApiClassMeta {
     entityInfo?: XrApiEntityInfo;
     methods: XrApiMethodMeta[];
     events: XrApiEventMeta[];
+    excludeInheritedEventKeys?: string[];
     methodGroups: XrApiGroupMeta[];
 }
 export declare function apiParam(p: Partial<XrApiParamMeta> & {

package/dist/src/model/vr/xr-logic.d.ts

@@ -75,7 +75,7 @@ export declare class XrVariable {
  * - event:  事件载荷（监听回调期间临时压入的事件数据，泛化自 broadcast_msg）；表达式 _事件.$
  * 老 global/local/step/flow/ability/broadcast_msg/agent 保留，供迁移与向后兼容读老格式（plan §1.23）。
  */
-export declare type XrVariableScopeType = 'global' | 'shared' | 'local' | 'step' | 'flow' | 'ability' | 'broadcast_msg' | 'agent' | 'scene' | 'module' | 'func' | 'event';
+export declare type XrVariableScopeType = 'global' | 'shared' | 'local' | 'step' | 'flow' | 'ability' | 'broadcast_msg' | 'agent' | 'scene' | 'module' | 'file' | 'func' | 'event';
 export declare class XrVariableScopeTypeDefine {
     static readonly GLOBAL: XrVariableScopeType;
     static readonly SHARED: XrVariableScopeType;
@@ -87,6 +87,7 @@ export declare class XrVariableScopeTypeDefine {
     static readonly BROADCAST_MSG: XrVariableScopeType;
     static readonly SCENE: XrVariableScopeType;
     static readonly MODULE: XrVariableScopeType;
+    static readonly FILE: XrVariableScopeType;
     static readonly FUNC: XrVariableScopeType;
     static readonly EVENT: XrVariableScopeType;
 }

package/dist/src/model/vr/xr-program.d.ts

@@ -14,14 +14,18 @@ import type { XrAnyAction } from './vr-action';
  *     └─ programSceneList              场景（真隔离逻辑，多场景并发，plan §4.8）
  *          └─ XrProgramScene
  *               ├─ sceneVariableList         场景变量（场景内所有模块可见）
- *               ├─ moduleList                模块（.java 式；模块变量私有，plan §1.15）
+ *               ├─ moduleList                模块（= Java 包；模块变量私有，plan §1.15）
  *               └─ entityHandlerBindingList  组件函数绑定关系（实体事件↔本场景某模块的 handler 函数，plan §4.9）
  *                    └─ XrProgramModule
- *                         ├─ moduleVariableList
- *                         ├─ functionList     函数（调用即返回；组件事件监听也是这里的函数，plan §4.6）
- *                         ├─ subprogramList   常驻子程序（有生命周期，plan §4.6）
- *                         └─ folderList       可选的组织文件夹（plan §1.40）
+ *                         ├─ moduleVariableList  模块变量（_模块.$，本模块所有文件可见）
+ *                         └─ fileList            代码文件（= .java 文件；一个文件含多个函数）
+ *                              └─ XrProgramFile
+ *                                   ├─ fileVariableList  文件级变量（_文件.$，本文件内可见）
+ *                                   ├─ functionList      函数（调用即返回；组件事件监听也是这里的函数，plan §4.6）
+ *                                   ├─ subprogramList    常驻子程序（有生命周期，plan §4.6）
+ *                                   └─ folderList        可选的组织文件夹（plan §1.40）
  *
+ * 作用域链（方案甲+文件层）：共享 → 场景 → 模块 → 文件 → 函数 → 回调。
  * 说明：动作体暂用 XrAnyAction[]（现有 AST）；后续 Block AST 演进自 XrAnyAction，向后兼容。
  */
 /** 顶层「场景」——真隔离的逻辑工程，多个可并发运行，仅隔离逻辑（空间内容各场景共用，plan §1.6/§1.13） */
@@ -37,17 +41,24 @@ export declare class XrProgramScene extends VRTalkBaseData {
     moduleList: XrProgramModule[];
     entityHandlerBindingList: XrEntityHandlerBinding[];
 }
-/** 场景内「模块」——类似一个 .java 文件；模块变量私有，跨模块调用公开函数（plan §1.15） */
+/** 场景内「模块」——对应 Java 的「包」；模块变量私有，跨模块调用公开函数（plan §1.15）。模块内含多个代码文件。 */
 export declare class XrProgramModule extends VRTalkBaseData {
     name: MultiLanguageStr;
     remark: string;
     moduleVariableList: XrVariable[];
+    fileList: XrProgramFile[];
+}
+/** 模块内「代码文件」——对应 Java 的一个 .java 文件；一个文件含多个函数/子程序，并有文件级变量。 */
+export declare class XrProgramFile extends VRTalkBaseData {
+    name: MultiLanguageStr;
+    remark: string;
+    fileVariableList: XrVariable[];
     functionList: XrProgramFunction[];
     subprogramList: XrSubprogram[];
     folderList: XrProgramFolder[];
     sortMode: 'by-type' | 'by-name';
 }
-/** 模块内的组织文件夹（纯 UI 分组，plan §1.40） */
+/** 文件内的组织文件夹（纯 UI 分组，plan §1.40） */
 export declare class XrProgramFolder extends VRTalkBaseData {
     name: string;
     parentFolderId: string;
@@ -123,6 +134,7 @@ export declare class XrEntityHandlerBinding extends VRTalkBaseData {
     entityId: string;
     entityParentPath: string[];
     eventName: string;
+    eventSourceId: string;
     handlerFunctionId: string;
     moduleId: string;
 }