@djvlc/runtime-web 1.0.5 → 1.0.6

package/dist/index.d.ts

@@ -689,8 +689,8 @@ export declare function mount(container: string | HTMLElement, options: MountOpt
  * 挂载选项
  */
 export declare interface MountOptions {
-    /** 页面 UID */
-    pageUid: string;
+    /** 页面 ID（对应 contracts 中的 pageId） */
+    pageId: string;
     /** API 基础 URL */
     apiBaseUrl: string;
     /** CDN 基础 URL */
@@ -759,17 +759,21 @@ export declare function onVisibilityChange(callback: (visible: boolean) => void)
 
 /**
  * 页面解析结果（Runtime 使用）
+ *
+ * @description
+ * 这是 Runtime 内部使用的类型，从 PageResolveResponse 和 PageSnapshotJson 转换而来。
+ * 使用 pageId 符合 contracts 定义。
  */
 declare interface PageResolveResult {
-    /** 页面 UID */
-    pageUid: string;
+    /** 页面 ID（对应 contracts 中的 pageId） */
+    pageId: string;
     /** 页面版本 ID */
     pageVersionId: string;
     /** 页面 JSON（PageSchema） */
     pageJson: _djvlc_contracts_types.PageSchema;
     /** 组件清单 */
     manifest: _djvlc_contracts_types.PageManifest;
-    /** 运行时配置 */
+    /** 运行时配置（从 OpsConfig 转换而来） */
     runtimeConfig?: {
         /** 被阻断的组件列表 */
         blockedComponents?: Array<{
@@ -905,7 +909,7 @@ export declare const RUNTIME_VERSION: string;
  * 运行时上下文
  */
 declare interface RuntimeContext {
-    pageUid: string;
+    pageId: string;
     pageVersionId: string;
     runtimeVersion: string;
     userId?: string;
@@ -967,8 +971,8 @@ declare type RuntimeEventType = 'page:resolving' | 'page:resolved' | 'page:loadi
 export declare interface RuntimeOptions {
     /** 容器元素或选择器 */
     container: string | HTMLElement;
-    /** 页面 UID（pageId） */
-    pageUid: string;
+    /** 页面 ID（对应 contracts 中的 pageId） */
+    pageId: string;
     /** API 基础 URL */
     apiBaseUrl: string;
     /** CDN 基础 URL */
@@ -1211,7 +1215,7 @@ declare interface TrackEvent_2 {
     /** 事件数据 */
     data?: Record<string, unknown>;
     /** 页面 UID */
-    pageUid?: string;
+    pageId?: string;
     /** 页面版本 ID */
     pageVersionId?: string;
     /** 组件 ID */
@@ -1257,19 +1261,19 @@ export declare class TrackingManager {
     /**
      * 追踪页面访问
      */
-    trackPageView(pageUid: string, pageVersionId?: string): void;
+    trackPageView(pageId: string, pageVersionId?: string): void;
     /**
      * 追踪组件曝光
      */
-    trackComponentView(componentId: string, componentType: string, pageUid?: string): void;
+    trackComponentView(componentId: string, componentType: string, pageId?: string): void;
     /**
      * 追踪组件点击
      */
-    trackComponentClick(componentId: string, componentType: string, pageUid?: string): void;
+    trackComponentClick(componentId: string, componentType: string, pageId?: string): void;
     /**
      * 追踪动作执行
      */
-    trackAction(actionType: string, success: boolean, duration: number, pageUid?: string): void;
+    trackAction(actionType: string, success: boolean, duration: number, pageId?: string): void;
     /**
      * 追踪错误
      */