@xunlei-open/miniapp-types 0.1.1-beta.4 → 0.1.1-beta.6

package/dist/index.d.cts

@@ -438,7 +438,42 @@ export interface WebviewCookie {
 }
 /** 可直接执行的 JavaScript 字符串，或会被序列化到 WebView 中执行的函数。 */
 export type WebviewExecutable<T = unknown> = string | ((...args: unknown[]) => T | Promise<T>);
+/** WebView 事件及其回调参数。导航和加载事件仅针对主页面，不包含 iframe。 */
+export interface WebviewEventMap {
+  /** 实际地址发生变化，包含同一文档内的导航；不表示页面已加载完成。 */
+  "url-changed": {
+    url: string;
+    /** 是否为 hash、History API 等同一文档内的地址变化。 */
+    sameDocument: boolean;
+  };
+  /**
+   * 主页面触发 window.load，表示文档及阻塞 load 的资源已结束加载，不代表业务异步任务完成。
+   * 刷新页面会触发；仅 hash 或 History API 引起的同一文档内导航不触发。
+   */
+  "load": {
+    url: string;
+  };
+  /** 页面加载失败。 */
+  "load-error": {
+    url: string;
+    message: string;
+  };
+  /** 页面已关闭。 */
+  "closed": {
+    /** 用户关闭窗口，或通过 close() 关闭页面。 */
+    reason: "user" | "api";
+  };
+}
+/** 取消本次监听，可重复调用，页面关闭后调用也安全。 */
+export type WebviewUnsubscribe = () => Promise<void>;
 export interface WebviewPage {
+  /**
+   * 注册事件监听；Promise 完成表示监听已就绪，并返回取消监听函数。
+   * 不回放当前状态；需要监听导航时，应在 goto() 前完成注册。
+   * 页面关闭时先通知 closed 监听器，再自动释放全部监听。
+   * 回调仅用于通知，不能阻止导航；宿主不等待异步回调，异步错误由调用方处理。
+   */
+  on<K extends keyof WebviewEventMap>(event: K, handler: (data: WebviewEventMap[K]) => void): Promise<WebviewUnsubscribe>;
   /** 在后续导航的页面上下文创建前注入脚本。 */
   addInitScript(script: string): Promise<void>;
   /** 导航到指定网址。 */
@@ -608,6 +643,51 @@ export interface XunleiRuntime {
   blob: XunleiRuntimeBlob;
   webview: XunleiRuntimeWebview;
 }
+/** 宿主主题模式。 */
+export type HostThemeMode = "light" | "dark";
+/** 宿主环境信息查询接口，页面和事件脚本均可用。 */
+export interface XunleiHostEnv {
+  /**
+   * 宿主默认下载目录，绝对路径。
+   * 用户在宿主中修改后，后续调用返回新值。
+   */
+  defaultDownloadDir(): Promise<string>;
+  /**
+   * 宿主当前主题模式；宿主设置为跟随系统时返回解析后的结果，不返回 auto。
+   * 主题变化后，后续调用返回新值。
+   */
+  themeMode(): Promise<HostThemeMode>;
+}
+export interface UiPickDirectoryOptions {
+  /** 对话框初始定位的目录，绝对路径；未指定时定位到宿主默认下载目录。 */
+  defaultPath?: string;
+}
+/** 目录选择结果。 */
+export interface UiPickDirectoryResult {
+  /** 用户选择的目录绝对路径。 */
+  path: string;
+}
+export interface UiOpenTaskListOptions {
+  /** 跳转后高亮选中的任务标识；任务不存在或不可见时仅跳转，不高亮。 */
+  taskId?: string;
+}
+/** 宿主 UI 操作接口，仅微应用页面可用，事件脚本不注入。 */
+export interface XunleiHostUi {
+  /** 打开宿主目录选择器；用户取消时返回 null，不视为错误。 */
+  pickDirectory(opts?: UiPickDirectoryOptions): Promise<UiPickDirectoryResult | null>;
+  /** 跳转到宿主任务列表页，可选高亮指定任务。 */
+  openTaskList(opts?: UiOpenTaskListOptions): Promise<void>;
+}
+/**
+ * 宿主环境与 UI 接口，与 info（微应用自身信息）相对。
+ * env 读宿主状态，页面和事件脚本均可用；ui 操作宿主界面，仅页面可用。
+ */
+export interface XunleiHost {
+  /** 宿主环境信息。 */
+  env: XunleiHostEnv;
+  /** 宿主 UI 操作，仅页面可用。 */
+  ui: XunleiHostUi;
+}
 export interface Xunlei {
   /** 微应用信息（只读）。 */
   info: XunleiInfo;
@@ -623,6 +703,8 @@ export interface Xunlei {
   events: XunleiEvents;
   /** 运行时能力接口。 */
   runtime: XunleiRuntime;
+  /** 宿主环境与 UI 接口。 */
+  host: XunleiHost;
 }
 export interface MiniappInfo {
   id: string;

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.ts"],"mappings":"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"}

package/dist/index.d.mts

@@ -438,7 +438,42 @@ export interface WebviewCookie {
 }
 /** 可直接执行的 JavaScript 字符串，或会被序列化到 WebView 中执行的函数。 */
 export type WebviewExecutable<T = unknown> = string | ((...args: unknown[]) => T | Promise<T>);
+/** WebView 事件及其回调参数。导航和加载事件仅针对主页面，不包含 iframe。 */
+export interface WebviewEventMap {
+  /** 实际地址发生变化，包含同一文档内的导航；不表示页面已加载完成。 */
+  "url-changed": {
+    url: string;
+    /** 是否为 hash、History API 等同一文档内的地址变化。 */
+    sameDocument: boolean;
+  };
+  /**
+   * 主页面触发 window.load，表示文档及阻塞 load 的资源已结束加载，不代表业务异步任务完成。
+   * 刷新页面会触发；仅 hash 或 History API 引起的同一文档内导航不触发。
+   */
+  "load": {
+    url: string;
+  };
+  /** 页面加载失败。 */
+  "load-error": {
+    url: string;
+    message: string;
+  };
+  /** 页面已关闭。 */
+  "closed": {
+    /** 用户关闭窗口，或通过 close() 关闭页面。 */
+    reason: "user" | "api";
+  };
+}
+/** 取消本次监听，可重复调用，页面关闭后调用也安全。 */
+export type WebviewUnsubscribe = () => Promise<void>;
 export interface WebviewPage {
+  /**
+   * 注册事件监听；Promise 完成表示监听已就绪，并返回取消监听函数。
+   * 不回放当前状态；需要监听导航时，应在 goto() 前完成注册。
+   * 页面关闭时先通知 closed 监听器，再自动释放全部监听。
+   * 回调仅用于通知，不能阻止导航；宿主不等待异步回调，异步错误由调用方处理。
+   */
+  on<K extends keyof WebviewEventMap>(event: K, handler: (data: WebviewEventMap[K]) => void): Promise<WebviewUnsubscribe>;
   /** 在后续导航的页面上下文创建前注入脚本。 */
   addInitScript(script: string): Promise<void>;
   /** 导航到指定网址。 */
@@ -608,6 +643,51 @@ export interface XunleiRuntime {
   blob: XunleiRuntimeBlob;
   webview: XunleiRuntimeWebview;
 }
+/** 宿主主题模式。 */
+export type HostThemeMode = "light" | "dark";
+/** 宿主环境信息查询接口，页面和事件脚本均可用。 */
+export interface XunleiHostEnv {
+  /**
+   * 宿主默认下载目录，绝对路径。
+   * 用户在宿主中修改后，后续调用返回新值。
+   */
+  defaultDownloadDir(): Promise<string>;
+  /**
+   * 宿主当前主题模式；宿主设置为跟随系统时返回解析后的结果，不返回 auto。
+   * 主题变化后，后续调用返回新值。
+   */
+  themeMode(): Promise<HostThemeMode>;
+}
+export interface UiPickDirectoryOptions {
+  /** 对话框初始定位的目录，绝对路径；未指定时定位到宿主默认下载目录。 */
+  defaultPath?: string;
+}
+/** 目录选择结果。 */
+export interface UiPickDirectoryResult {
+  /** 用户选择的目录绝对路径。 */
+  path: string;
+}
+export interface UiOpenTaskListOptions {
+  /** 跳转后高亮选中的任务标识；任务不存在或不可见时仅跳转，不高亮。 */
+  taskId?: string;
+}
+/** 宿主 UI 操作接口，仅微应用页面可用，事件脚本不注入。 */
+export interface XunleiHostUi {
+  /** 打开宿主目录选择器；用户取消时返回 null，不视为错误。 */
+  pickDirectory(opts?: UiPickDirectoryOptions): Promise<UiPickDirectoryResult | null>;
+  /** 跳转到宿主任务列表页，可选高亮指定任务。 */
+  openTaskList(opts?: UiOpenTaskListOptions): Promise<void>;
+}
+/**
+ * 宿主环境与 UI 接口，与 info（微应用自身信息）相对。
+ * env 读宿主状态，页面和事件脚本均可用；ui 操作宿主界面，仅页面可用。
+ */
+export interface XunleiHost {
+  /** 宿主环境信息。 */
+  env: XunleiHostEnv;
+  /** 宿主 UI 操作，仅页面可用。 */
+  ui: XunleiHostUi;
+}
 export interface Xunlei {
   /** 微应用信息（只读）。 */
   info: XunleiInfo;
@@ -623,6 +703,8 @@ export interface Xunlei {
   events: XunleiEvents;
   /** 运行时能力接口。 */
   runtime: XunleiRuntime;
+  /** 宿主环境与 UI 接口。 */
+  host: XunleiHost;
 }
 export interface MiniappInfo {
   id: string;

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;iBAGiB;;EAEhB;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA,aAAa;;EAEb;;EAEA,QAAQ;;EAER,SAAS;;EAET,cAAc;;EAEd,UAAU;;EAEV,UAAU;;EAEV,WAAW;;YAGA;iBAWK;GACf;;EAED;;YAGW;iBAEK;;EAEhB,OAAO;;EAEP;;iBAGgB;EAChB;EACA;;iBAGgB;EAChB;EACA;;iBAGgB;EAChB,OAAO;EACP,QAAQ;EACR;;YAGW;YAMA;EACX;EACA;;YAGW;iBAEK;EAChB;EACA;EACA;EACA;EACA,QAAQ;EACR,UAAU;;iBAGM;EAChB;EACA,OAAO;;;YAMI;YAEA;;YASA;EACX;EACA;EACA;EACA;;iBAGgB;EAChB,SAAS;;YAGE,WAAW;iBAEN;;EAEhB;;EAEA,QAAQ;;EAER;KAAY;;;iBAGI,yBAAyB;;EAEzC,UAAU,QAAQ,yBAAyB;;EAE3C,SAAS,aAAa,gBAAgB;;EAEtC,SAAS,cAAc;;iBAGP;EAChB;;EAEA;;EAEA;;iBAGgB;;EAEhB;;EAEA;;EAEA,OAAO;;iBAGS;;EAEhB;;YAGW,YAAY;iBAEP;;EAEhB;;EAEA;;EAEA,QAAQ;;iBAGQ;;EAEhB;;EAEA;;EAEA;;iBAKgB;EAChB;;EAEA;;EAEA,UAAU;;EAEV;;EAEA;;IAEC,KAAK,KAAK;IACV,KAAK;;IAEL,MAAM,KAAK;;;EAGZ,QAAQ;;EAER,UAAU;;EAEV;;EAEA;;EAEA;;;YAIW,mBAAmB,OAAO;iBAErB,kBAAkB,KAAK;EACvC;;EAEA;IAAQ;IAAc;;;EAEtB,UAAU;;iBAGM;EAChB;EACA;;iBAGgB;;EAEhB;;;;;;iBAOgB,sBAAsB;EACtC,MAAM,KAAK;IACV,KAAK;;;EAGN,OAAO,cAAc;;iBAGL,6BAA6B;;EAE7C,YAAY;;iBAGI;EAChB,KAAK;EACL,OAAO;;;iBAIS;;EAEhB;;EAEA,OAAO;;EAEP,OAAO;;iBAGS;;EAEhB;;EAEA;;EAEA,SAAS,iBAAiB;;EAE1B;;iBAGgB;;EAEhB;;EAEA;;iBAGgB;EAChB;;iBAGgB;;EAEhB;;EAEA;;IAEC;OAAY;;;;iBAIG;EAChB;EACA;;iBAGgB;EAChB;EACA;;;YAMW;EACX,OAAO;EACP,OAAO;EACP,OAAO;EACP,KAAK;;;YAIM;EACX,OAAO;EACP,OAAO;EACP,OAAO;;;iBAIS;;EAEhB,KAAK;;EAEL,MAAM;;;iBAIU;;EAEhB,MAAM;;;iBAIU;;EAEhB,MAAM;;EAEN,OAAO;;;iBAIS;;EAEhB,MAAM;;YAKK,0BACX,KAAK,qBACD;YAEO,wBACX,KAAK,mBACD;YAEO,wBACX,KAAK,mBACD;YAEO,uBAAuB,KAAK,kBAAkB;;iBAKzC;;EAEhB;;EAEA;;EAEA;;EAEA;;EAEA;;;iBAIgB;EAChB,MAAM,sBAAsB;EAC5B,KAAK,sBAAsB;EAC3B,KAAK,sBAAsB;EAC3B,MAAM,sBAAsB;;;iBAIZ;;GAEf,cAAc;;;iBAIC;;;;EAIhB,IAAI,cAAc;;;;EAIlB,IAAI,aAAa,gBAAgB;;;;EAIjC,OAAO,cAAc;;;;EAIrB,SAAS;;;;EAIT,QAAQ;;;iBAIQ;;EAEhB,OAAO,OAAO,kBAAkB,QAAQ;;EAExC,YAAY,OAAO,uBAAuB,QAAQ;;EAElD,KAAK,QAAQ,gBAAgB,QAAQ;;EAErC,OAAO,OAAO,kBAAkB,QAAQ;;EAExC,OAAO,OAAO,kBAAkB,QAAQ;;EAExC,OAAO,OAAO,kBAAkB,QAAQ;;iBAGxB,2BAA2B;;EAE3C;;IAEC,OAAO,OAAO,sBAAsB,QAAQ;;;iBAI7B;;EAEhB,UAAU,SAAS;;EAEnB,QAAQ,SAAS;;EAEjB,QAAQ,SAAS;;EAEjB,OAAO,SAAS;;;iBAMA;;;;;EAKhB;;EAEA;;EAEA;;EAEA;;EAEA;;iBAGgB;;EAEhB;;EAEA;;iBAGgB;;EAEhB;;iBAGgB;;EAEhB;;iBAGgB;;EAEhB;;EAEA;;iBAGgB,sCAAsC;;EAEtD;;EAEA;;iBAGgB;;EAEhB;;EAEA;;EAEA;;EAEA;;EAEA,4BAA4B;;EAE5B;;EAEA;;;YAIW,kBAAkB,6BAEtB,oBAAoB,IAAI,QAAQ;;iBAGvB;;EAEhB;IACC;;IAEA;;;;;;EAMD;IACC;;;EAGD;IACC;IACA;;;EAGD;;IAEC;;;;YAKU,2BAA2B;iBAEtB;;;;;;;EAOhB,GAAG,gBAAgB,iBAClB,OAAO,GACP,UAAU,MAAM,gBAAgB,cAC9B,QAAQ;;EAEX,cAAc,iBAAiB;;EAE/B,KAAK,aAAa,OAAO,qBAAqB;;EAE9C,QAAQ,aACP,YAAY,kBAAkB,OAC3B,kBACD,QAAQ;;EAEX,MAAM,mBAAmB;;EAEzB,MAAM,kBAAkB,OAAO,sBAAsB;;EAErD,KACC,kBACA,cACA,OAAO,qBACL;;EAEH,gBACC,kBACA,OAAO,gCACL;;EAEH,gBAAgB,aACf,YAAY,kBAAkB,OAC3B,kBACD,QAAQ;;EAEX,cAAc,QAAQ;;EAEtB,UAAU,QAAQ,gBAAgB;;EAElC,aAAa,QAAQ,gBAAgB;;EAErC,gBAAgB;;EAEhB,OAAO;;EAEP,WAAW;;EAEX,SAAS;;iBAGO;;EAEhB,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkDf,KAAK,OAAO,qBAAqB,QAAQ;;iBAKzB;;EAEhB;;EAEA;;YAGW,cACX,SAAS,oBACL,eAAe,cAAc,QAAQ,eAAe;iBAExC;;EAEhB;;EAEA;;EAEA;;iBAGgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsDhB,gBACC,QAAQ,OAAO,YACf,UAAU,uBACR;;;;;;;;;EASH,gBAAgB,cAAc;;iBAGd;EAChB,MAAM;EACN,SAAS;;;YAME;;iBAGK;;;;;EAKhB,sBAAsB;;;;;EAKtB,aAAa,QAAQ;;iBAGL;;EAEhB;;;iBAIgB;;EAEhB;;iBAGgB;;EAEhB;;;iBAIgB;;EAEhB,cACC,OAAO,yBACL,QAAQ;;EAEX,aAAa,OAAO,wBAAwB;;;;;;iBAO5B;;EAEhB,KAAK;;EAEL,IAAI;;iBAGY;;EAEhB,MAAM;;EAEN,QAAQ;;EAER,UAAU;;EAEV,SAAS;;EAET,OAAO;;EAEP,QAAQ;;EAER,SAAS;;EAET,MAAM;;iBAKU;EAChB;EACA;EACA;EACA;EACA,QAAQ;EACR;;YAGW,eAAe;;iBAGV;OACX,mBAAmB;GACvB,mBAAmB;;QAGb;QACD,QAAQ;QACR,cAAc"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xunlei-open/miniapp-types",
-  "version": "0.1.1-beta.4",
+  "version": "0.1.1-beta.6",
   "description": "TypeScript definitions for the Xunlei Miniapp manifest and runtime APIs",
   "type": "module",
   "main": "./dist/index.cjs",