vite-plugin-taro-runtime 0.7.0 → 0.7.1-beta.2

package/dist/taro/types/api/open-api/invoice.d.ts

@@ -0,0 +1,87 @@
+import Taro from '../../index'
+
+declare module '../../index' {
+  namespace chooseInvoiceTitle {
+    interface Option {
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (result: SuccessCallbackResult) => void
+    }
+
+    interface SuccessCallbackResult extends TaroGeneral.CallbackResult {
+      /** 银行账号 */
+      bankAccount: string
+      /** 银行名称 */
+      bankName: string
+      /** 单位地址 */
+      companyAddress: string
+      /** 错误信息 */
+      errMsg: string
+      /** 抬头税号 */
+      taxNumber: string
+      /** 手机号码 */
+      telephone: string
+      /** 抬头名称 */
+      title: string
+      /** 抬头类型 */
+      type: keyof InvoiceType
+    }
+
+    /** 抬头类型 */
+    interface InvoiceType {
+      0: '单位'
+      1: '个人'
+    }
+  }
+
+  namespace chooseInvoice {
+    interface Option {
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (result: SuccessCallbackResult) => void
+    }
+
+    interface SuccessCallbackResult extends TaroGeneral.CallbackResult {
+      /** 用户选中的发票信息，格式为一个 JSON 字符串，包含三个字段： card_id：所选发票卡券的 cardId，encrypt_code：所选发票卡券的加密 code，报销方可以通过 cardId 和 encryptCode 获得报销发票的信息，app_id： 发票方的 appId。 */
+      invoiceInfo: string
+      /** 调用结果 */
+      errMsg: string
+    }
+  }
+
+  interface TaroStatic {
+    /** 选择用户的发票抬头。当前小程序必须关联一个公众号，且这个公众号是完成了[微信认证](https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1496554031_RD4xe)的，才能调用 chooseInvoiceTitle。
+     * @supported weapp
+     * @example
+     * ```tsx
+     * Taro.chooseInvoiceTitle({
+     *   success: function(res) {}
+     * })
+     * ```
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/open-api/invoice/wx.chooseInvoiceTitle.html
+     */
+    chooseInvoiceTitle(option?: chooseInvoiceTitle.Option): Promise<chooseInvoiceTitle.SuccessCallbackResult>
+
+    /** 选择用户已有的发票。
+     *
+     * **通过 cardId 和 encryptCode 获得报销发票的信息**
+     * 请参考[微信电子发票文档](https://mp.weixin.qq.com/wiki?t=resource/res_main&id=21517918939oae3U)中，「查询报销发票信息」部分。
+     * 其中 `access_token` 的获取请参考[auth.getAccessToken](https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/access-token/auth.getAccessToken.html)文档
+     * @supported weapp
+     * @example
+     * ```tsx
+     * Taro.chooseInvoice({
+     *   success: function (res) {}
+     * })
+     * ```
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/open-api/invoice/wx.chooseInvoice.html
+     */
+    chooseInvoice(option?: chooseInvoice.Option): Promise<chooseInvoice.SuccessCallbackResult>
+  }
+}

package/dist/taro/types/api/open-api/license-plate.d.ts

@@ -0,0 +1,27 @@
+import Taro from '../../index'
+
+declare module '../../index' {
+  namespace chooseLicensePlate {
+    interface Option {
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (result: SuccessCallbackResult) => void
+    }
+
+    interface SuccessCallbackResult extends TaroGeneral.CallbackResult {
+      /** 用户选择的车牌号 */
+      plateNumber: string
+    }
+  }
+
+  interface TaroStatic {
+    /** 选择车牌号
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/open-api/license-plate/wx.chooseLicensePlate.html
+     */
+    chooseLicensePlate(option?: chooseLicensePlate.Option): Promise<chooseLicensePlate.SuccessCallbackResult>
+  }
+}

package/dist/taro/types/api/open-api/login.d.ts

@@ -0,0 +1,115 @@
+import Taro from '../../index'
+
+declare module '../../index' {
+  namespace pluginLogin {
+    interface Option {
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (result: SuccessCallbackResult) => void
+    }
+    interface SuccessCallbackResult extends TaroGeneral.CallbackResult {
+      /** 用于换取 openpid 的凭证（有效期五分钟）。插件开发者可以用此 code 在开发者服务器后台调用 [auth.getPluginOpenPId](https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/user-info/auth.getPluginOpenPId.html) 换取 openpid。 */
+      code: string
+    }
+  }
+
+  namespace login {
+    interface Option {
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (result: SuccessCallbackResult) => void
+      /** 超时时间，单位ms */
+      timeout?: number
+      /** 未登录时, 是否强制调起登录框
+       * @supported tt
+       * @default true
+       */
+      force?: boolean
+    }
+    interface SuccessCallbackResult extends TaroGeneral.CallbackResult {
+      /** 用户登录凭证（有效期五分钟）。开发者需要在开发者服务器后台调用 [auth.code2Session](https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/login/auth.code2Session.html)，使用 code 换取 openid 和 session_key 等信息 */
+      code: string
+      /** 调用结果 */
+      errMsg: string
+      /** 用于标识当前设备, 无论登录与否都会返回, 有效期 5 分钟。
+       * @supported tt
+       */
+      anonymousCode?: string
+      /** 判断在当前 APP（头条、抖音等）是否处于登录状态。
+       * @supported tt
+       */
+      isLogin?: boolean
+    }
+  }
+
+  namespace checkSession {
+    interface Option {
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (res: TaroGeneral.CallbackResult) => void
+    }
+  }
+
+  interface TaroStatic {
+    /** **该接口仅在小程序插件中可调用**，调用接口获得插件用户标志凭证（code）。插件可以此凭证换取用于识别用户的标识 openpid。用户不同、宿主小程序不同或插件不同的情况下，该标识均不相同，即当且仅当同一个用户在同一个宿主小程序中使用同一个插件时，openpid 才会相同
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/open-api/login/wx.pluginLogin.html
+     */
+    pluginLogin(option?: pluginLogin.Option): Promise<pluginLogin.SuccessCallbackResult>
+
+    /** 调用接口获取登录凭证（code）。通过凭证进而换取用户登录态信息，包括用户的唯一标识（openid）及本次登录的会话密钥（session_key）等。用户数据的加解密通讯需要依赖会话密钥完成。更多使用方法详见 [小程序登录](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/login.html)。
+     * @supported weapp, jd, qq, tt, harmony_hybrid
+     * @example
+     * ```tsx
+     * Taro.login({
+     *   success: function (res) {
+     *     if (res.code) {
+     *       //发起网络请求
+     *       Taro.request({
+     *         url: 'https://test.com/onLogin',
+     *         data: {
+     *           code: res.code
+     *         }
+     *       })
+     *     } else {
+     *       console.log('登录失败！' + res.errMsg)
+     *     }
+     *   }
+     * })
+     * ```
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/open-api/login/wx.login.html
+     */
+    login(option?: login.Option): Promise<login.SuccessCallbackResult>
+
+    /** 检查登录态是否过期。
+     *
+     * 通过 Taro.login 接口获得的用户登录态拥有一定的时效性。用户越久未使用小程序，用户登录态越有可能失效。反之如果用户一直在使用小程序，则用户登录态一直保持有效。具体时效逻辑由微信维护，对开发者透明。开发者只需要调用 Taro.checkSession 接口检测当前用户登录态是否有效。
+     *
+     * 登录态过期后开发者可以再调用 Taro.login 获取新的用户登录态。调用 Taro.checkSession 成功说明当前 session_key 未过期，调用失败说明 session_key 已过期。更多使用方法详见 [小程序登录](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/login.html)。
+     * @supported weapp, swan, qq, tt
+     * @example
+     * ```tsx
+     * Taro.checkSession({
+     *   success: function () {
+     *     //session_key 未过期，并且在本生命周期一直有效
+     *   },
+     *   fail: function () {
+     *     // session_key 已经失效，需要重新执行登录流程
+     *     Taro.login() //重新登录
+     *   }
+     * })
+     * ```
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/open-api/login/wx.checkSession.html
+     */
+    checkSession(option?: checkSession.Option): Promise<TaroGeneral.CallbackResult>
+  }
+}

package/dist/taro/types/api/open-api/my-miniprogram.d.ts

@@ -0,0 +1,28 @@
+import Taro from '../../index'
+
+declare module '../../index' {
+  namespace checkIsAddedToMyMiniProgram {
+    interface Option {
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (res: SuccessCallbackResult) => void
+    }
+
+    interface SuccessCallbackResult extends TaroGeneral.CallbackResult {
+      /**是否被添加至 「我的小程序」 */
+      added: boolean
+    }
+  }
+
+  interface TaroStatic {
+    /**
+     * 检查小程序是否被添加至 「我的小程序」
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/open-api/my-miniprogram/wx.checkIsAddedToMyMiniProgram.html
+     */
+    checkIsAddedToMyMiniProgram(option?: checkIsAddedToMyMiniProgram.Option): void
+  }
+}

package/dist/taro/types/api/open-api/privacy.d.ts

@@ -0,0 +1,107 @@
+import Taro from '../../index'
+
+declare module '../../index' {
+  namespace getPrivacySetting {
+    interface Option {
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (result: SuccessCallbackResult) => void
+    }
+    interface SuccessCallbackResult extends TaroGeneral.CallbackResult {
+      /** 是否需要用户授权隐私协议（如果开发者没有在[mp后台-设置-服务内容声明-用户隐私保护指引]中声明隐私收集类型则会返回false；如果开发者声明了隐私收集，且用户之前同意过隐私协议则会返回false；如果开发者声明了隐私收集，且用户还没同意过则返回true；如果用户之前同意过、但后来小程序又新增了隐私收集类型也会返回true） */
+      needAuthorization: boolean
+      /** 隐私授权协议的名称 */
+      privacyContractName: string
+    }
+  }
+
+  namespace requirePrivacyAuthorize {
+    interface Option {
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (result: TaroGeneral.CallbackResult) => void
+    }
+  }
+
+  namespace openPrivacyContract {
+    interface Option {
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (result: TaroGeneral.CallbackResult) => void
+    }
+  }
+
+  namespace onNeedPrivacyAuthorization {
+    /**
+     * resolve 是 onNeedPrivacyAuthorization 的回调参数，是一个接口函数。
+     * 当触发 needPrivacyAuthorization 事件时，触发该事件的隐私接口或组件会处于 pending 状态。
+     * 如果调用 resolve({ buttonId: 'disagree-btn'， event:'agree' })，则触发当前 needPrivacyAuthorization 事件的原隐私接口或组件会继续执行。其中 buttonId 为隐私同意授权按钮的id，为确保用户有同意的操作，基础库会检查对应的同意按钮是否被点击过。
+     * 如果调用 resolve({ event: 'disagree' })，则触发当前 needPrivacyAuthorization 事件的原隐私接口或组件会失败并返回 API:fail privacy permission is not authorized 的错误信息。
+     * 在调用 resolve({ event: 'agree'/'disagree' }) 之前，开发者可以调用 resolve({ event: 'exposureAuthorization' }) 把隐私弹窗曝光告知平台。
+     */
+    interface ResolveOption {
+      /** 用户操作类型 */
+      event: 'exposureAuthorization' | 'agree' | 'disagree'
+      /** 同意授权按钮的id （仅event=agree时必填） */
+      buttonId?: string
+    }
+    /**
+     * 触发本次 onNeedPrivacyAuthorization 事件的关联信息
+     */
+    interface EventInfo {
+      referrer: string
+    }
+
+    /** 隐私授权监听函数 */
+    type Listener = (
+      /** 事件回调函数 */
+      resolve: (option: ResolveOption) => void,
+      /** 关联事件信息 */
+      eventInfo: EventInfo
+    ) => void
+  }
+
+  interface TaroStatic {
+    /**
+     * 查询隐私授权情况。隐私合规开发指南详情可见《小程序隐私协议开发指南》
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/open-api/privacy/wx.getPrivacySetting.html
+     */
+    getPrivacySetting(option?: getPrivacySetting.Option): void
+    /**
+     * 跳转至隐私协议页面。隐私合规开发指南详情可见《小程序隐私协议开发指南》
+     * @supported weapp
+     * @example
+     * ```tsx
+     * Taro.openPrivacyContract({
+     *   success: () => {}, // 打开成功
+     *   fail: () => {}, // 打开失败
+     *   complete: () => {}
+     * })
+     * ```
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/open-api/privacy/wx.openPrivacyContract.html
+     */
+    openPrivacyContract(option?: openPrivacyContract.Option): void
+    /**
+     * 模拟隐私接口调用，并触发隐私弹窗逻辑。隐私合规开发指南详情可见《小程序隐私协议开发指南》
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/open-api/privacy/wx.requirePrivacyAuthorize.html
+     */
+    requirePrivacyAuthorize(option?: requirePrivacyAuthorize.Option): void
+    /**
+     * 监听隐私接口需要用户授权事件。当需要用户进行隐私授权时会触发。触发该事件时，开发者需要弹出隐私协议说明，并在用户同意或拒绝授权后调用回调接口 resolve 触发原隐私接口或组件继续执行。隐私合规开发指南详情可见《小程序隐私协议开发指南》
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/open-api/privacy/wx.onNeedPrivacyAuthorization.html
+     */
+    onNeedPrivacyAuthorization(listener: onNeedPrivacyAuthorization.Listener): void
+  }
+}

package/dist/taro/types/api/open-api/redpackage.d.ts

@@ -0,0 +1,24 @@
+import Taro from '../../index'
+
+declare module '../../index' {
+  namespace showRedPackage {
+    interface Option {
+      /** 封面地址 */
+      url: string
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (res: TaroGeneral.CallbackResult) => void
+    }
+  }
+
+  interface TaroStatic {
+    /** 拉取h5领取红包封面页。获取参考红包封面地址参考 [微信红包封面开发平台](https://cover.weixin.qq.com/cgi-bin/mmcover-bin/readtemplate?t=page/index#/doc?page=introduce)。
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/open-api/redpackage/wx.showRedPackage.html
+     */
+    showRedPackage(option?: showRedPackage.Option): Promise<TaroGeneral.CallbackResult>
+  }
+}

package/dist/taro/types/api/open-api/settings.d.ts

@@ -0,0 +1,174 @@
+import Taro from '../../index'
+
+declare module '../../index' {
+  namespace openSetting {
+    interface Option {
+      /**
+       * 是否同时获取用户订阅消息的订阅状态，默认不获取。注意：withSubscriptions 只返回用户勾选过订阅面板中的“总是保持以上选择，不再询问”的订阅消息。
+       * @default false
+       */
+      withSubscriptions?: boolean
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (result: SuccessCallbackResult) => void
+    }
+
+    interface SuccessCallbackResult extends TaroGeneral.CallbackResult {
+      /** 用户授权结果 */
+      authSetting: AuthSetting
+      /** 用户订阅消息设置，接口参数 withSubscriptions 值为 true 时才会返回。 */
+      subscriptionsSetting: SubscriptionsSetting
+      /** 调用结果 */
+      errMsg: string
+    }
+  }
+
+  namespace getSetting {
+    interface Option {
+      /**
+       * 是否同时获取用户订阅消息的订阅状态，默认不获取。注意：withSubscriptions 只返回用户勾选过订阅面板中的“总是保持以上选择，不再询问”的订阅消息。
+       */
+      withSubscriptions?: boolean
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (result: SuccessCallbackResult) => void
+    }
+
+    interface SuccessCallbackResult extends TaroGeneral.CallbackResult {
+      /** 用户授权结果 */
+      authSetting: AuthSetting
+      /** 用户订阅消息设置，接口参数 withSubscriptions 值为 true 时才会返回。 */
+      subscriptionsSetting: SubscriptionsSetting
+      /** 在插件中调用时，当前宿主小程序的用户授权结果 */
+      miniprogramAuthSetting: AuthSetting
+      /** 调用结果 */
+      errMsg: string
+    }
+  }
+
+  /** 用户授权设置信息，详情参考[权限](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/authorize.html)
+   * @see https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/authorize.html
+  */
+  interface AuthSetting {
+    /** 是否授权用户信息，对应接口 [Taro.getUserInfo](/docs/apis/open-api/user-info/getUserInfo) */
+    'scope.userInfo'?: boolean
+    /** 是否授权地理位置，对应接口 [Taro.getLocation](/docs/apis/location/getLocation), [Taro.chooseLocation](/docs/apis/location/chooseLocation) */
+    'scope.userLocation'?: boolean
+    /** 是否授权通讯地址，对应接口 [Taro.chooseAddress](/docs/apis/open-api/address/chooseAddress) */
+    'scope.address'?: boolean
+    /** 是否授权发票抬头，对应接口 [Taro.chooseInvoiceTitle](/docs/apis/open-api/invoice/chooseInvoiceTitle) */
+    'scope.invoiceTitle'?: boolean
+    /** 是否授权获取发票，对应接口 [Taro.chooseInvoice](/docs/apis/open-api/invoice/chooseInvoice) */
+    'scope.invoice'?: boolean
+    /** 是否授权微信运动步数，对应接口 [Taro.getWeRunData](/docs/apis/open-api/werun/getWeRunData) */
+    'scope.werun'?: boolean
+    /** 是否授权录音功能，对应接口 [Taro.startRecord](/docs/apis/media/recorder/startRecord) */
+    'scope.record'?: boolean
+    /** 是否授权保存到相册 [Taro.saveImageToPhotosAlbum](/docs/apis/media/image/saveImageToPhotosAlbum), [Taro.saveVideoToPhotosAlbum](/docs/apis/media/video/saveVideoToPhotosAlbum) */
+    'scope.writePhotosAlbum'?: boolean
+    /** 是否授权摄像头，对应 [camera](/docs/components/media/camera) 组件 */
+    'scope.camera'?: boolean
+    /** 是否授权小程序在后台运行蓝牙，对应接口 [Taro.openBluetoothAdapterBackground](https://developers.weixin.qq.com/miniprogram/dev/api/open-api/setting/(wx.openBluetoothAdapterBackground).html) */
+    'scope.bluetoothBackground'?: boolean
+  }
+
+  /** 订阅消息设置
+   *
+   * 注意事项
+   * - itemSettings 只返回用户勾选过订阅面板中的“总是保持以上选择，不再询问”的订阅消息。
+   * @example
+   * ```tsx
+   * Taro.getSetting({
+   *   withSubscriptions: true,
+   *   success (res) {
+   *     console.log(res.authSetting)
+   *     // res.authSetting = {
+   *     //   "scope.userInfo": true,
+   *     //   "scope.userLocation": true
+   *     // }
+   *     console.log(res.subscriptionsSetting)
+   *     // res.subscriptionsSetting = {
+   *     //   mainSwitch: true, // 订阅消息总开关
+   *     //   itemSettings: {   // 每一项开关
+   *     //     SYS_MSG_TYPE_INTERACTIVE: 'accept', // 小游戏系统订阅消息
+   *     //     SYS_MSG_TYPE_RANK: 'accept'
+   *     //     zun-LzcQyW-edafCVvzPkK4de2Rllr1fFpw2A_x0oXE: 'reject', // 普通一次性订阅消息
+   *     //     ke_OZC_66gZxALLcsuI7ilCJSP2OJ2vWo2ooUPpkWrw: 'ban',
+   *     //   }
+   *     // }
+   *   }
+   * })
+   * ```
+   * @see https://developers.weixin.qq.com/miniprogram/dev/api/open-api/setting/SubscriptionsSetting.html
+  */
+  interface SubscriptionsSetting {
+    /** 订阅消息总开关，true 为开启，false 为关闭 */
+    mainSwitch: boolean
+    /** 每一项订阅消息的订阅状态。itemSettings对象的键为一次性订阅消息的模板id或系统订阅消息的类型
+     * - 一次性订阅消息使用方法详见 [Taro.requestSubscribeMessage](/docs/apis/open-api/subscribe-message/requestSubscribeMessage)
+     * - 永久订阅消息（仅小游戏可用）使用方法详见 [Taro.requestSubscribeSystemMessage](https://developers.weixin.qq.com/minigame/dev/api/open-api/subscribe-message/wx.requestSubscribeSystemMessage.html)
+     * @type "accept" | "reject" | "ban"
+     */
+    itemSettings: {
+      [TEMPLATE_ID: string]: keyof SubscriptionsSetting.TemplateReflex | string
+    }
+  }
+
+  namespace SubscriptionsSetting {
+    /** 模版消息订阅类型 */
+    interface TemplateReflex {
+      /** 表示用户同意订阅该条id对应的模板消息 */
+      accept
+      /** 表示用户拒绝订阅该条id对应的模板消息 */
+      reject
+      /** 表示已被后台封禁 */
+      ban
+    }
+  }
+
+  interface TaroStatic {
+    /** 调起客户端小程序设置界面，返回用户设置的操作结果。**设置界面只会出现小程序已经向用户请求过的[权限](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/authorize.html)**。
+     *
+     * 注意：[2.3.0](https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html) 版本开始，用户发生点击行为后，才可以跳转打开设置页，管理授权信息。[详情](https://developers.weixin.qq.com/community/develop/doc/000cea2305cc5047af5733de751008)
+     * @supported weapp, alipay, swan, jd, qq, tt, rn, harmony_hybrid
+     * @example
+     * ```tsx
+     * Taro.openSetting({
+     *   success: function (res) {
+     *     console.log(res.authSetting)
+     *     // res.authSetting = {
+     *     //   "scope.userInfo": true,
+     *     //   "scope.userLocation": true
+     *     // }
+     *   }
+     * })
+     * ```
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/open-api/setting/wx.openSetting.html
+     */
+    openSetting(option?: openSetting.Option): Promise<openSetting.SuccessCallbackResult>
+
+    /** 获取用户的当前设置。**返回值中只会出现小程序已经向用户请求过的[权限](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/authorize.html)**。
+     * @supported weapp, alipay, swan, jd, qq, tt, rn, harmony_hybrid
+     * @example
+     * ```tsx
+     * Taro.getSetting({
+     *   success: function (res) {
+     *     console.log(res.authSetting)
+     *     // res.authSetting = {
+     *     //   "scope.userInfo": true,
+     *     //   "scope.userLocation": true
+     *     // }
+     *   }
+     * })
+     * ```
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/open-api/setting/wx.getSetting.html
+     */
+    getSetting(option?: getSetting.Option): Promise<getSetting.SuccessCallbackResult>
+  }
+}