qsh-webview-sdk 2.3.1 → 2.3.3

package/dist/index.d.ts

@@ -27,6 +27,27 @@ declare namespace UniWebView {
     data?: any;
   }
 
+  interface MiniProgramNavigateResult {
+    /** errMsg */
+    errMsg?: string;
+    [key: string]: any;
+  }
+
+  interface MiniProgramNavigateOptions {
+    /** target mini program id */
+    appid: string;
+    /** target mini program page path */
+    path?: string;
+    /** target mini program env */
+    env?: "release" | "trial" | "develop";
+    /** success callback */
+    success?: (res: MiniProgramNavigateResult) => void;
+    /** fail callback */
+    fail?: (error: any) => void;
+    /** complete callback */
+    complete?: () => void;
+  }
+
   /**
    * 环境信息
    */
@@ -207,10 +228,7 @@ declare namespace UniWebView {
     type: "weixin" | "plus" | "nvue" | "uvue" | "UniApp" | "webview" | "h5" | "offline";
   }
 
-  /** 高阶 toShare：内容类型（与 type 二选一） */
-  type ShareUniversalKind = "web" | "text" | "image" | "miniProgram";
-
-  /** 高阶 toShare：去向 */
+  /** 定向分享：去向 */
   type ShareUniversalScene = "chat" | "timeline";
 
   /** 各 kind 对应的 payload（按需传字段） */
@@ -233,46 +251,10 @@ declare namespace UniWebView {
     imageUrl: string;
   }
 
-  interface ShareUniversalPayloadMiniProgram {
-    title: string;
-    summary: string;
-    imageUrl: string;
-    miniProgram: {
-      /** 小程序原始 ID（gh_ 开头），uni.share type=5 要求 */
-      id: string;
-      path: string;
-      webUrl: string;
-      type?: 0 | 1 | 2;
-    };
-  }
-
   type ShareUniversalPayload =
     | ShareUniversalPayloadWeb
     | ShareUniversalPayloadText
-    | ShareUniversalPayloadImage
-    | ShareUniversalPayloadMiniProgram;
-
-  /**
-   * 微信分享选项（toShare 仅支持高阶入参）
-   */
-  interface ShareOptions {
-    kind: ShareUniversalKind;
-    /** 各 kind 对应字段见 ShareUniversalPayload */
-    payload?: ShareUniversalPayload;
-    /** 为 true 时不打印 hint 日志 */
-    silent?: boolean;
-    /**
-     * 为 true 且当前为微信 JS-SDK 环境时，走宿主 WebView 桥 toShareData（兼容原 toShareCallBack）
-     */
-    viaWebViewBridge?: boolean;
-    /** @deprecated 等同于 viaWebViewBridge */
-    isCallBack?: boolean;
-    /** 分享去向：0 / chat 聊天，1 / timeline 朋友圈 */
-    scene?: 0 | 1 | ShareUniversalScene;
-    success?: (res: ShareResult) => void;
-    fail?: (error: any) => void;
-    complete?: () => void;
-  }
+    | ShareUniversalPayloadImage;
 
   interface ShareResult {
     errMsg?: string;
@@ -287,6 +269,16 @@ declare namespace UniWebView {
     [key: string]: any;
   }
 
+  /** 定向分享模块参数（仅 H5 嵌入宿主 WebView 场景） */
+  interface ShareDirectedOptions {
+    kind: "web" | "text" | "image";
+    scene?: 0 | 1 | ShareUniversalScene;
+    payload: ShareUniversalPayload;
+    success?: (res: ShareResult) => void;
+    fail?: (error: any) => void;
+    complete?: () => void;
+  }
+
   interface BluetoothOptions {
     success?: (res: any) => void;
     fail?: (error: any) => void;
@@ -397,6 +389,7 @@ declare namespace UniWebView {
     switchTab(options: NavigateOptions): void;
     reLaunch(options: NavigateOptions): void;
     redirectTo(options: NavigateOptions): void;
+    navigateToMiniProgram(options: MiniProgramNavigateOptions): void;
     postMessage(options?: PostMessageOptions): void;
     getEnv(callback: (info: EnvironmentInfo) => void): void;
     chooseImage(options?: ChooseImageOptions): void;
@@ -415,6 +408,13 @@ declare namespace UniWebView {
     /** WebView 对象（兼容旧版本） */
     webView: WebView | null;
 
+    navigateToMiniProgram(
+      options: MiniProgramNavigateOptions,
+    ): Promise<MiniProgramNavigateResult> | void;
+    navigateToMiniProgramAsync(
+      options: Omit<MiniProgramNavigateOptions, "success" | "fail" | "complete">,
+    ): Promise<MiniProgramNavigateResult>;
+
     weixin: WeixinNamespace;
 
     /** 图片选择（Promise版本） */
@@ -436,19 +436,12 @@ declare namespace UniWebView {
     /** 图片大小类型枚举 */
     ImageSizeTypes: ImageSizeTypesEnum;
 
-    /** 微信分享 */
-    toShare(options: ShareOptions): Promise<ShareResult> | void;
-    toShareAsync(
-      options: Omit<ShareOptions, "success" | "fail" | "complete">,
+    /** 定向分享模块：仅 H5 -> 宿主 WebView */
+    shareDirected(options: ShareDirectedOptions): Promise<ShareResult> | void;
+    shareDirectedAsync(
+      options: Omit<ShareDirectedOptions, "success" | "fail" | "complete">,
     ): Promise<ShareResult>;
 
-    /** toShare 参数说明（结构化，可 JSON 展示） */
-    readonly TO_SHARE_PARAM_HELP: Readonly<Record<string, unknown>>;
-    /** 返回 toShare 参数说明对象 */
-    getToShareParamHelp(): Readonly<Record<string, unknown>>;
-    /** 在控制台打印 toShare 参数说明，并返回文本 */
-    printToShareParamHelp(): string;
-
     /** 蓝牙 API */
     openBluetoothAdapter(options?: BluetoothOptions): Promise<any> | void;
     openBluetoothAdapterAsync(options?: BluetoothOptions): Promise<any>;