vrtalk-web-sdk 0.1.603 → 0.1.605

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

@@ -86,7 +86,7 @@ export declare class XrApiEventMeta {
     platform: XrApiPlatform;
     legacySignalSource?: string;
     legacySignalType?: string;
-    sourceScope?: 'image' | 'video';
+    sourceScope?: 'image' | 'video' | 'panel_button';
 }
 /** 类的种类：静态类（无实例、全静态方法）/ 实体类（空间实体或其子件，可作 entity_ref 变量类型） */
 export declare type XrApiClassKind = 'static' | 'entity';
@@ -114,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/vr-action.d.ts

@@ -6,7 +6,7 @@ import { MultiLanguageStr } from '../general/multi-language-str';
 import { FreeButton } from '../general/free-button';
 import { VrAppearanceStyle } from './vr-appearance-style';
 import { XrInteractionControlConfig, XrInteractionDataType } from './xr-interaction-control';
-export declare type XrActionCategory = 'basic' | 'condition' | 'count_loop' | 'expression_loop' | 'switch' | 'object_call' | 'foreach_loop';
+export declare type XrActionCategory = 'basic' | 'condition' | 'count_loop' | 'expression_loop' | 'switch' | 'object_call' | 'foreach_loop' | 'comment';
 export declare class XrActionCategoryDefine {
     static readonly BASIC: XrActionCategory;
     static readonly CONDITION: XrActionCategory;
@@ -15,6 +15,7 @@ export declare class XrActionCategoryDefine {
     static readonly SWITCH: XrActionCategory;
     static readonly OBJECT_CALL: XrActionCategory;
     static readonly FOREACH_LOOP: XrActionCategory;
+    static readonly COMMENT: XrActionCategory;
 }
 export declare type XrPlatform = 'VR' | 'AR';
 export declare class XrPlatformDefine {
@@ -25,7 +26,7 @@ export declare class XrBaseAction {
     actionCategory: XrActionCategory;
     backgroundColorMark: string;
 }
-export declare type XrAnyAction = XrConditionAction | XrCountLoopAction | XrExpressionLoopAction | XrSwitchAction | VrAction | XrObjectCallAction | XrForEachLoopAction;
+export declare type XrAnyAction = XrConditionAction | XrCountLoopAction | XrExpressionLoopAction | XrSwitchAction | VrAction | XrObjectCallAction | XrForEachLoopAction | XrCommentAction;
 /**
  * VR动作
  */
@@ -145,11 +146,12 @@ export declare class XrSwitchAction {
     caseList: XrSwitchCase[];
     defaultActionList: XrAnyAction[];
 }
-export declare type XrReceiverFrom = 'picker' | 'variable' | 'static_class';
+export declare type XrReceiverFrom = 'picker' | 'variable' | 'static_class' | 'user_function';
 export declare class XrReceiverFromDefine {
     static readonly PICKER: XrReceiverFrom;
     static readonly VARIABLE: XrReceiverFrom;
     static readonly STATIC_CLASS: XrReceiverFrom;
+    static readonly USER_FUNCTION: XrReceiverFrom;
 }
 /**
  * 接收者引用——「对象.方法」里的对象。
@@ -163,6 +165,7 @@ export declare class XrReceiverRef {
     entityParentPath: string[];
     variableScope?: XrVariableScopeType;
     variableKey?: string;
+    functionId: string;
 }
 export declare type XrCallArgKind = 'literal' | 'var_ref' | 'call' | 'closure';
 export declare class XrCallArgKindDefine {
@@ -214,6 +217,14 @@ export declare class XrForEachLoopAction {
     indexVarKey: string;
     actionList: XrAnyAction[];
 }
+/**
+ * 注释块（actionCategory='comment'）：仅用于在编辑器里给动作列表加一段说明文字，
+ * 运行时为纯 no-op —— player / Unity 遍历到直接跳过，不产生任何副作用（plan 纯加法）。
+ */
+export declare class XrCommentAction extends XrBaseAction {
+    actionCategory: XrActionCategory;
+    commentText: string;
+}
 export declare type VrActionType = 'system_common_wait' | 'system_set_interactive_state' | 'system_ui_settings_change' | 'system_color_space_scene_tint' | 'system_color_space_display_brightness' | 'component_general_change_visibility' | 'component_general_change_transform' | 'component_general_play_transition_animation' | 'component_general_stop_transition_animation' | 'component_2d_general_change_deformation_settings' | 'component_general_audio_source_play_control' | 'component_general_audio_source_pause' | 'component_general_audio_source_change_loop_mode' | 'component_2d_image_change_source' | 'component_2d_video_change_source' | 'component_2d_video_change_play_state' | 'component_2d_video_change_mute_state' | 'component_2d_text_change_source' | 'component_2d_panel_change_scene' | 'component_2d_panel_button_change_enabled' | 'component_tag_simulate_click' | 'component_3d_box_change_color' | 'component_3d_model_play_animation_clip' | 'component_3d_model_stop_animation_clip' | 'information_content_card_show' | 'information_content_card_close' | 'information_link_open' | 'information_link_close' | 'audio_center_play_list' | 'audio_center_pause' | 'audio_center_set_volume' | 'sweep_change_enabled' | 'sweep_change_panorama' | 'sweep_marker_change_enabled' | 'sweep_reset_to_default' | 'sweep_only_enable_current' | 'camera_move_to' | 'camera_dolly_move' | 'camera_dolly_stop' | 'navigation_start' | 'navigation_stop' | 'logic_variable_modify' | 'logic_variable_number_add' | 'logic_variable_number_subtract' | 'logic_variable_string_append' | 'logic_variable_string_trim_end' | 'logic_variable_string_advanced' | 'logic_variable_boolean_toggle' | 'flow_enter' | 'flow_exit' | 'send_broadcast' | 'system_state_scope_create' | 'system_state_scope_switch' | 'system_state_scope_destroy' | 'monitor_change_enabled' | 'monitor_switch_active_tab' | 'monitor_component_change_visibility' | 'monitor_video_change_play_state' | 'monitor_video_change_mute_state' | 'monitor_change_badge_text' | 'monitor_change_badge_style' | 'monitor_switch_active_scene' | 'monitor_change_popup_visible' | 'layer_change_visibility' | 'hamburger_menu_node_change_visibility' | 'hamburger_menu_change_open_state' | 'hamburger_menu_group_change_expanded' | 'canvas_component_change_visibility' | 'message_card_change_show_state' | 'message_card_show' | 'message_card_hide' | 'message_card_create_temporary' | 'message_card_destroy_temporary' | 'tts_play_voice' | 'tts_realtime_stream' | 'background_thread_start' | 'background_thread_pause' | 'background_thread_stop' | 'ai_agent_activate' | 'ai_agent_hide' | 'ai_agent_wake' | 'ai_agent_activate_and_send_user_message' | 'ai_agent_activate_and_inject_dialogue' | 'ai_agent_inject_hidden_state_message' | 'ai_agent_activate_and_inject_assistant_message' | 'system_open_webpage' | 'ability_enable' | 'ability_stop' | 'cloud_form_show_dialog' | 'cloud_form_collect_field' | 'cloud_form_submit' | 'cloud_form_reset' | 'hit_analytics_event' | 'popup_user_form_show_dialog' | 'logic_random_number' | 'logic_random_color' | 'logic_current_time' | 'logic_random_pick_string' | 'logic_random_pick_number' | 'logic_random_pick_boolean' | 'logic_random_pick_enum' | 'logic_random_pick_color' | 'logic_random_pick_css_color' | 'logic_random_pick_from_recommend_options' | 'visualization_controller_pop' | 'visualization_controller_hide' | 'visualization_controller_close_all' | 'ai_check_take_photo' | 'ai_check_run' | 'ray_hitter_activate' | 'ray_hitter_deactivate';
 export declare class VrActionTypeDefine {
     static readonly SYSTEM_COMMON_WAIT: VrActionType;

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;