@ray-js/api 1.7.80 → 1.7.82

package/@types/MiniKit.d.ts

@@ -1,13 +1,28 @@
 /**
  * MiniKit
  *
- * @version 3.33.2
+ * @version 3.35.3
  */
 declare namespace ty {
   /**
    * 获取客户端预拉取的数据，此接口不会等待，有数据会立即返回，没有数据会返回空
    * @public
    * @since MiniKit 3.20.2
+   * @example Demo
+   * ```tsx
+   * // fetchApiKeys are the "key" names configured under preFetch in the miniapp app.json
+   * // (not atop api names). Data is only returned if it was prefetched & cached at cold start.
+   * ty.getBackgroundFetchData({
+   *   fetchType: "pre",
+   *   fetchApiKeys: ["key1"],
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function getBackgroundFetchData(params?: {
@@ -52,6 +67,21 @@ declare namespace ty {
    * 此接口提供给基础库使用，业务方需要使用onBackgroundFetchData事件来获取预拉取的数据，调用时有数据会立即返回，没有数据会等待
    * @public
    * @since MiniKit 3.20.2
+   * @example Demo
+   * ```tsx
+   * // apiKey is the "key" name configured under preFetch in the miniapp app.json.
+   * ty.registerBackgroundFetchData({
+   *   fetchType: "pre",
+   *   apiKey: "key1",
+   *   registerId: "ttt-demo-register-id",
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function registerBackgroundFetchData(params: {
@@ -79,7 +109,7 @@ declare namespace ty {
        * 缓存数据
        * @since MiniKit 3.20.2
        */
-      fetchedData: {}
+      fetchedData: Record<string, any>
       /**
        * 客户端拿到缓存数据的时间戳
        * @since MiniKit 3.20.2
@@ -111,6 +141,19 @@ declare namespace ty {
    * 特殊方法：是否异层渲染响应
    * @public
    * @since MiniKit 2.3.0
+   * @example Demo
+   * ```tsx
+   * ty.nativeDisabled({
+   *   nativeDisabled: true,
+   *   pageId: "ttt-demo-page-id",
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function nativeDisabled(params: {
@@ -121,7 +164,7 @@ declare namespace ty {
     nativeDisabled: boolean
     /**
      * 需要禁止或启用手势分发的页面id
-     * @since MiniKit 2.3.12
+     * @since MiniKit 2.4.2
      */
     pageId: string
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
@@ -148,6 +191,22 @@ declare namespace ty {
    * 通用方法：用于基础库给原生异层渲染组件发送消息
    * @public
    * @since MiniKit 2.3.0
+   * @example Demo
+   * ```tsx
+   * ty.nativeInovke({
+   *   type: 0,
+   *   apiName: "demoApi",
+   *   id: "ttt-demo-view-id",
+   *   pageId: "ttt-demo-page-id",
+   *   params: {},
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function nativeInovke(params: {
@@ -176,11 +235,11 @@ declare namespace ty {
      * 参数等
      * @since MiniKit 2.3.0
      */
-    params: Record<string, Object>
+    params: Record<string, Record<string, any>>
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: {}) => void
+    success?: (params: Record<string, any>) => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -201,6 +260,17 @@ declare namespace ty {
    * 获取权限的配置信息
    * @public
    * @since MiniKit 2.6.0
+   * @example Demo
+   * ```tsx
+   * ty.getPermissionConfig({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function getPermissionConfig(params?: {
@@ -234,12 +304,23 @@ declare namespace ty {
    * 获取权限的配置信息
    * @public
    * @since MiniKit 2.6.0
+   * @example Demo
+   * ```tsx
+   * ty.getPermissionConfig({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function getPermissionConfigSync(): {
     /**
      * 权限相关配置信息
-     * @since MiniKit 3.2.0
+     * @since MiniKit 2.6.0
      */
     result: Record<string, any>
   }
@@ -248,6 +329,17 @@ declare namespace ty {
    * 调起客户端小程序设置界面，返回用户设置的操作结果。
    * @public
    * @since MiniKit 2.6.0
+   * @example Demo
+   * ```tsx
+   * ty.openSetting({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function openSetting(params?: {
@@ -283,6 +375,18 @@ declare namespace ty {
    * false: 关闭vconsole
    * @public
    * @since MiniKit 2.6.0
+   * @example Demo
+   * ```tsx
+   * ty.changeDebugMode({
+   *   isEnable: true,
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function changeDebugMode(params: {
@@ -294,7 +398,7 @@ declare namespace ty {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -315,13 +419,24 @@ declare namespace ty {
    * 打开帮助中心，默认：面板小程序会跳转到面板帮助中心，普通小程序会跳转到App帮助中心
    * @public
    * @since MiniKit 2.6.0
+   * @example Demo
+   * ```tsx
+   * ty.openHelpCenter({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function openHelpCenter(params?: {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -342,6 +457,14 @@ declare namespace ty {
    * 显示 tabBar 某一项的右上角的红点
    * @public
    * @since MiniKit 1.0.0
+   * @example Demo
+   * ```tsx
+   * ty.showTabBarRedDot({
+   *   index: 0,
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function showTabBarRedDot(params: {
@@ -353,7 +476,7 @@ declare namespace ty {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -374,6 +497,14 @@ declare namespace ty {
    * 显示 tabBar
    * @public
    * @since MiniKit 1.0.0
+   * @example Demo
+   * ```tsx
+   * ty.showTabBar({
+   *   animation: true,
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function showTabBar(params: {
@@ -385,7 +516,7 @@ declare namespace ty {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -406,6 +537,17 @@ declare namespace ty {
    * 动态设置 tabBar 的整体样式
    * @public
    * @since MiniKit 1.0.0
+   * @example Demo
+   * ```tsx
+   * ty.setTabBarStyle({
+   *   color: "#999999",
+   *   selectedColor: "#000000",
+   *   backgroundColor: "#FFFFFF",
+   *   borderStyle: "black",
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function setTabBarStyle(params: {
@@ -432,7 +574,7 @@ declare namespace ty {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -453,6 +595,17 @@ declare namespace ty {
    * 动态设置 tabBar 某一项的内容
    * @public
    * @since MiniKit 1.0.0
+   * @example Demo
+   * ```tsx
+   * ty.setTabBarItem({
+   *   index: 0,
+   *   text: "Home",
+   *   iconPath: "/assets/tab_home.png",
+   *   selectedIconPath: "/assets/tab_home_selected.png",
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function setTabBarItem(params: {
@@ -479,7 +632,7 @@ declare namespace ty {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -500,6 +653,15 @@ declare namespace ty {
    * 为 tabBar 某一项的右上角添加文本
    * @public
    * @since MiniKit 1.0.0
+   * @example Demo
+   * ```tsx
+   * ty.setTabBarBadge({
+   *   index: 0,
+   *   text: "99",
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function setTabBarBadge(params: {
@@ -516,7 +678,7 @@ declare namespace ty {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -537,6 +699,14 @@ declare namespace ty {
    * 移除 tabBar 某一项右上角的文本
    * @public
    * @since MiniKit 1.0.0
+   * @example Demo
+   * ```tsx
+   * ty.removeTabBarBadge({
+   *   index: 0,
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function removeTabBarBadge(params: {
@@ -548,7 +718,7 @@ declare namespace ty {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -569,6 +739,14 @@ declare namespace ty {
    * 隐藏 tabBar 某一项的右上角的红点
    * @public
    * @since MiniKit 1.0.0
+   * @example Demo
+   * ```tsx
+   * ty.hideTabBarRedDot({
+   *   index: 0,
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function hideTabBarRedDot(params: {
@@ -580,7 +758,7 @@ declare namespace ty {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -601,6 +779,14 @@ declare namespace ty {
    * 隐藏 tabBar
    * @public
    * @since MiniKit 1.0.0
+   * @example Demo
+   * ```tsx
+   * ty.hideTabBar({
+   *   animation: true,
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function hideTabBar(params: {
@@ -612,7 +798,7 @@ declare namespace ty {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -632,26 +818,43 @@ declare namespace ty {
   /**
    * 发起highway请求
    * @public
-   * @since MiniKit 1.0.0
+   * @since MiniKit 2.3.6
+   * @example Demo
+   * ```tsx
+   * // Highway RESTful request: api is a "/v1.0/..." url, method is GET/POST,
+   * // data depends on the specific highway api. (Real usage from @ray-js/ray miniapps.)
+   * ty.apiRequestByHighway({
+   *   api: "/v1.0/m/tc/album/pic/batch/download/url",
+   *   method: "POST",
+   *   data: {},
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function apiRequestByHighway(params: {
     /**
      * api 名称
-     * @since MiniKit 1.0.0
+     * @since MiniKit 2.3.6
      */
     api: string
     /**
-     * data 请求入参
-     * @since MiniKit 1.0.0
+     * Highway API 请求业务参数，字段结构由 api 对应的 Highway 接口定义
+     * @since MiniKit 2.3.6
      */
     data?: Record<string, any>
     /**
      * method 请求方法
-     * @since MiniKit 1.0.0
-     * @defaultValue HighwayMethod.GET
+     * @since MiniKit 2.3.6
+     * @defaultValue 'GET'
+     * @TEnum HighwayMethod
      */
-    method?: HighwayMethod
+    method?: "OPTIONS" | "GET" | "HEAD" | "POST" | "PUT" | "DELETE" | "TRACE" | "CONNECT"
     /**
      * requestId 请求ID，业务方不感知
      * @since MiniKit 3.27.0
@@ -666,16 +869,11 @@ declare namespace ty {
     complete?: () => void
     /** 接口调用成功的回调函数 */
     success?: (params: {
-      /**
-       * 接口返回数据的序列化对象，序列化失败时为null
-       * @since MiniKit 3.2.0
-       */
-      thing_json_?: {}
       /**
        * 接口返回的原始数据
        * @since MiniKit 3.2.0
        */
-      data: string
+      data: Record<string, any>
     }) => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
@@ -697,6 +895,14 @@ declare namespace ty {
    * 返回到上一个小程序。只有在当前小程序是被其他小程序打开时可以调用成功
    * @public
    * @since MiniKit 1.0.0
+   * @example Demo
+   * ```tsx
+   * ty.navigateBackMiniProgram({
+   *   extraData: { from: "ttt-demo" },
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function navigateBackMiniProgram(params?: {
@@ -708,7 +914,7 @@ declare namespace ty {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -729,13 +935,24 @@ declare namespace ty {
    * 退出当前小程序
    * @public
    * @since MiniKit 1.0.0
+   * @example Demo
+   * ```tsx
+   * ty.exitMiniProgram({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function exitMiniProgram(params?: {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -756,6 +973,17 @@ declare namespace ty {
    * 获取小程序启动时的参数。与App.onLaunch的回调参数一致。
    * @public
    * @since MiniKit 1.0.0
+   * @example Demo
+   * ```tsx
+   * ty.getLaunchOptions({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function getLaunchOptions(params?: {
@@ -770,10 +998,11 @@ declare namespace ty {
       path: string
       /**
        * 启动小程序的场景值
-       * @since MiniKit 3.14.1
-       * @defaultValue MiniAppScene.DEFAULT
+       * @since MiniKit 3.15.0
+       * @defaultValue 1000
+       * @TEnum MiniAppScene
        */
-      scene?: MiniAppScene
+      scene?: 1000 | 1001 | 1002
       /**
        * 启动小程序的 query 参数
        * @since MiniKit 3.2.0
@@ -816,33 +1045,45 @@ declare namespace ty {
    * 获取小程序启动时的参数。与App.onLaunch的回调参数一致。
    * @public
    * @since MiniKit 1.0.0
+   * @example Demo
+   * ```tsx
+   * ty.getLaunchOptions({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function getLaunchOptionsSync(): {
     /**
      * 启动小程序的路径 (代码包路径)
-     * @since MiniKit 3.2.0
+     * @since MiniKit 1.0.0
      */
     path: string
     /**
      * 启动小程序的场景值
-     * @since MiniKit 3.14.1
-     * @defaultValue MiniAppScene.DEFAULT
+     * @since MiniKit 3.15.0
+     * @defaultValue 1000
+     * @TEnum MiniAppScene
      */
-    scene?: MiniAppScene
+    scene?: 1000 | 1001 | 1002
     /**
      * 启动小程序的 query 参数
-     * @since MiniKit 3.2.0
+     * @since MiniKit 1.0.0
      */
     query: Record<string, any>
     /**
      * 分享转发
-     * @since MiniKit 3.2.0
+     * @since MiniKit 1.0.0
      */
     referrerInfo: ReferrerInfo
     /**
      * API 类别: default	默认类别; embedded 内嵌，通过打开半屏小程序能力打开的小程序
-     * @since MiniKit 3.2.0
+     * @since MiniKit 1.0.0
      * @defaultValue "default"
      */
     apiCategory?: string
@@ -857,6 +1098,17 @@ declare namespace ty {
    * 获取本次小程序启动时的参数。如果当前是冷启动，则返回值与App.onLaunch的回调参数一致；如果当前是热启动，则返回值与App.onShow 一致。
    * @public
    * @since MiniKit 1.0.0
+   * @example Demo
+   * ```tsx
+   * ty.getEnterOptions({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function getEnterOptions(params?: {
@@ -871,10 +1123,11 @@ declare namespace ty {
       path: string
       /**
        * 启动小程序的场景值
-       * @since MiniKit 3.14.1
-       * @defaultValue MiniAppScene.DEFAULT
+       * @since MiniKit 3.15.0
+       * @defaultValue 1000
+       * @TEnum MiniAppScene
        */
-      scene?: MiniAppScene
+      scene?: 1000 | 1001 | 1002
       /**
        * 启动小程序的 query 参数
        * @since MiniKit 3.2.0
@@ -917,33 +1170,45 @@ declare namespace ty {
    * 获取本次小程序启动时的参数。如果当前是冷启动，则返回值与App.onLaunch的回调参数一致；如果当前是热启动，则返回值与App.onShow 一致。
    * @public
    * @since MiniKit 1.0.0
+   * @example Demo
+   * ```tsx
+   * ty.getEnterOptions({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function getEnterOptionsSync(): {
     /**
      * 启动小程序的路径 (代码包路径)
-     * @since MiniKit 3.2.0
+     * @since MiniKit 1.0.0
      */
     path: string
     /**
      * 启动小程序的场景值
-     * @since MiniKit 3.14.1
-     * @defaultValue MiniAppScene.DEFAULT
+     * @since MiniKit 3.15.0
+     * @defaultValue 1000
+     * @TEnum MiniAppScene
      */
-    scene?: MiniAppScene
+    scene?: 1000 | 1001 | 1002
     /**
      * 启动小程序的 query 参数
-     * @since MiniKit 3.2.0
+     * @since MiniKit 1.0.0
      */
     query: Record<string, any>
     /**
      * 分享转发
-     * @since MiniKit 3.2.0
+     * @since MiniKit 1.0.0
      */
     referrerInfo: ReferrerInfo
     /**
      * API 类别: default	默认类别; embedded 内嵌，通过打开半屏小程序能力打开的小程序
-     * @since MiniKit 3.2.0
+     * @since MiniKit 1.0.0
      * @defaultValue "default"
      */
     apiCategory?: string
@@ -957,19 +1222,27 @@ declare namespace ty {
   /**
    * 设置小程序看板页标题，小程序名称，面板名称等
    * @public
-   * @since MiniKit 1.0.0
+   * @since MiniKit 2.0.6
+   * @example Demo
+   * ```tsx
+   * ty.setBoardTitle({
+   *   title: "TTT Demo Board",
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function setBoardTitle(params: {
     /**
      * 看板页标题
-     * @since MiniKit 1.0.0
+     * @since MiniKit 2.0.6
      */
     title: string
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -989,7 +1262,15 @@ declare namespace ty {
   /**
    * 设置小程序看板页标题，小程序名称，面板名称等
    * @public
-   * @since MiniKit 1.0.0
+   * @since MiniKit 2.0.6
+   * @example Demo
+   * ```tsx
+   * ty.setBoardTitle({
+   *   title: "TTT Demo Board",
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function setBoardTitleSync(boardBean?: BoardBean): null
@@ -998,6 +1279,14 @@ declare namespace ty {
    * 设置小程序看板页icon，小程序icon，面板icon等
    * @public
    * @since MiniKit 2.3.17
+   * @example Demo
+   * ```tsx
+   * ty.setBoardIcon({
+   *   icon: "https://images.tuyacn.com/rms-static/b7bed040-87b8-11eb-864d-a9f07cbbdf37-1616051299140.png?tyName=logo_cn.png",
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function setBoardIcon(params: {
@@ -1009,7 +1298,7 @@ declare namespace ty {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -1030,6 +1319,14 @@ declare namespace ty {
    * 设置小程序看板页icon，小程序icon，面板icon等
    * @public
    * @since MiniKit 2.3.17
+   * @example Demo
+   * ```tsx
+   * ty.setBoardIcon({
+   *   icon: "https://images.tuyacn.com/rms-static/b7bed040-87b8-11eb-864d-a9f07cbbdf37-1616051299140.png?tyName=logo_cn.png",
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function setBoardIconSync(boardIconBean?: BoardIconBean): null
@@ -1038,13 +1335,24 @@ declare namespace ty {
    * 显示小程序看板页的标题和icon
    * @public
    * @since MiniKit 2.3.17
+   * @example Demo
+   * ```tsx
+   * ty.showBoardTitleIcon({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function showBoardTitleIcon(params?: {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -1065,6 +1373,17 @@ declare namespace ty {
    * 显示小程序看板页的标题和icon
    * @public
    * @since MiniKit 2.3.17
+   * @example Demo
+   * ```tsx
+   * ty.showBoardTitleIcon({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function showBoardTitleIconSync(): null
@@ -1073,13 +1392,24 @@ declare namespace ty {
    * 隐藏小程序看板页的标题和icon
    * @public
    * @since MiniKit 2.3.17
+   * @example Demo
+   * ```tsx
+   * ty.hideBoardTitleIcon({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function hideBoardTitleIcon(params?: {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -1100,6 +1430,17 @@ declare namespace ty {
    * 隐藏小程序看板页的标题和icon
    * @public
    * @since MiniKit 2.3.17
+   * @example Demo
+   * ```tsx
+   * ty.hideBoardTitleIcon({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function hideBoardTitleIconSync(): null
@@ -1108,6 +1449,17 @@ declare namespace ty {
    * 获取菜单按钮（右上角胶囊按钮）的布局位置信息。坐标信息以屏幕左上角为原点。
    * @public
    * @since MiniKit 2.3.0
+   * @example Demo
+   * ```tsx
+   * ty.getMenuButtonBoundingClientRect({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function getMenuButtonBoundingClientRect(params?: {
@@ -1166,37 +1518,48 @@ declare namespace ty {
    * 获取菜单按钮（右上角胶囊按钮）的布局位置信息。坐标信息以屏幕左上角为原点。
    * @public
    * @since MiniKit 2.3.0
+   * @example Demo
+   * ```tsx
+   * ty.getMenuButtonBoundingClientRect({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function getMenuButtonBoundingClientRectSync(): {
     /**
      * 宽度，单位：px
-     * @since MiniKit 3.2.0
+     * @since MiniKit 2.3.0
      */
     width: number
     /**
      * 高度，单位：px
-     * @since MiniKit 3.2.0
+     * @since MiniKit 2.3.0
      */
     height: number
     /**
      * 上边界坐标，单位：px
-     * @since MiniKit 3.2.0
+     * @since MiniKit 2.3.0
      */
     top: number
     /**
      * 右边界坐标，单位：px
-     * @since MiniKit 3.2.0
+     * @since MiniKit 2.3.0
      */
     right: number
     /**
      * 下边界坐标，单位：px
-     * @since MiniKit 3.2.0
+     * @since MiniKit 2.3.0
      */
     bottom: number
     /**
      * 左边界坐标，单位：px
-     * @since MiniKit 3.2.0
+     * @since MiniKit 2.3.0
      */
     left: number
   }
@@ -1205,6 +1568,14 @@ declare namespace ty {
    * 预下载智能小程序，此接口仅供提供预下载普通智能小程序调用，面板小程序的预下载需要使用另外的接口。
    * @public
    * @since MiniKit 2.3.0
+   * @example Demo
+   * ```tsx
+   * ty.preDownloadMiniApp({
+   *   miniAppId: "tyxxxxxxxxxxxxxxxx",
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function preDownloadMiniApp(params: {
@@ -1221,7 +1592,7 @@ declare namespace ty {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -1242,6 +1613,14 @@ declare namespace ty {
    * 调用接口获取登录凭证（code）。通过凭证进而换取用户登录态信息，包括用户在当前小程序的唯一标识（openid）、iot账号下的唯一标识（unionid）
    * @public
    * @since MiniKit 2.3.2
+   * @example Demo
+   * ```tsx
+   * ty.login({
+   *   timeout: 5000,
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function login(params?: {
@@ -1280,6 +1659,15 @@ declare namespace ty {
    * 屏幕旋转设置，auto / portrait / landscape。pad模式下不支持屏幕旋转
    * @public
    * @since MiniKit 2.4.1
+   * @example Demo
+   * ```tsx
+   * ty.setPageOrientation({
+   *   pageOrientation: "portrait",
+   *   reverse: false,
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function setPageOrientation(params: {
@@ -1296,7 +1684,7 @@ declare namespace ty {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -1317,13 +1705,24 @@ declare namespace ty {
    * 隐藏右上角胶囊按钮
    * @public
    * @since MiniKit 2.5.0
+   * @example Demo
+   * ```tsx
+   * ty.hideMenuButton({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function hideMenuButton(params?: {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -1344,13 +1743,24 @@ declare namespace ty {
    * 显示右上角胶囊按钮
    * @public
    * @since MiniKit 2.5.0
+   * @example Demo
+   * ```tsx
+   * ty.showMenuButton({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function showMenuButton(params?: {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -1371,13 +1781,24 @@ declare namespace ty {
    * 显示手机状态栏
    * @public
    * @since MiniKit 2.6.0
+   * @example Demo
+   * ```tsx
+   * ty.showStatusBar({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function showStatusBar(params?: {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -1398,13 +1819,24 @@ declare namespace ty {
    * 隐藏手机状态栏
    * @public
    * @since MiniKit 2.6.0
+   * @example Demo
+   * ```tsx
+   * ty.hideStatusBar({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function hideStatusBar(params?: {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -1425,13 +1857,24 @@ declare namespace ty {
    * 关闭小部件
    * @public
    * @since MiniKit 2.6.1
+   * @example Demo
+   * ```tsx
+   * ty.exitMiniWidget({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function exitMiniWidget(params?: {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -1452,6 +1895,14 @@ declare namespace ty {
    * 判断设备上是否有已经安装相应应用或可以处理URL的程序，返回结果是一个对象，只有一个参数，格式为Boolean值。
    * @public
    * @since MiniKit 3.0.0
+   * @example Demo
+   * ```tsx
+   * ty.canOpenURL({
+   *   url: "thingsmart://",
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function canOpenURL(params: {
@@ -1491,12 +1942,20 @@ declare namespace ty {
    * 判断设备上是否有已经安装相应应用或可以处理URL的程序，返回结果是一个对象，只有一个参数，格式为Boolean值。
    * @public
    * @since MiniKit 3.0.0
+   * @example Demo
+   * ```tsx
+   * ty.canOpenURL({
+   *   url: "thingsmart://",
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function canOpenURLSync(openURLBean?: OpenURLBean): {
     /**
      * 是否支持打开对应的url
-     * @since MiniKit 3.2.0
+     * @since MiniKit 3.0.0
      * @defaultValue false
      */
     isCanOpen?: boolean
@@ -1506,6 +1965,14 @@ declare namespace ty {
    * 打开设备上的某个应用或可以处理URL的程序。
    * @public
    * @since MiniKit 3.0.0
+   * @example Demo
+   * ```tsx
+   * ty.openURL({
+   *   url: "thingsmart://",
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function openURL(params: {
@@ -1517,7 +1984,7 @@ declare namespace ty {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -1538,6 +2005,17 @@ declare namespace ty {
    * 获取小程序账号信息
    * @public
    * @since MiniKit 3.1.0
+   * @example Demo
+   * ```tsx
+   * ty.getAccountInfo({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function getAccountInfo(params?: {
@@ -1571,12 +2049,23 @@ declare namespace ty {
    * 获取小程序账号信息
    * @public
    * @since MiniKit 3.1.0
+   * @example Demo
+   * ```tsx
+   * ty.getAccountInfo({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function getAccountInfoSync(): {
     /**
      * 小程序账号信息
-     * @since MiniKit 3.2.0
+     * @since MiniKit 3.1.0
      */
     miniProgram: MiniProgramAccountInfo
   }
@@ -1585,6 +2074,17 @@ declare namespace ty {
    * 获取小程序自定义配置
    * @public
    * @since MiniKit 3.11.5
+   * @example Demo
+   * ```tsx
+   * ty.getMiniAppConfig({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function getMiniAppConfig(params?: {
@@ -1596,7 +2096,7 @@ declare namespace ty {
        * 小程序自定义配置
        * @since MiniKit 3.11.5
        */
-      config: {}
+      config: Record<string, any>
     }) => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
@@ -1618,6 +2118,17 @@ declare namespace ty {
    * 获取小程序自定义配置
    * @public
    * @since MiniKit 3.11.5
+   * @example Demo
+   * ```tsx
+   * ty.getMiniAppConfig({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function getMiniAppConfigSync(): {
@@ -1625,20 +2136,31 @@ declare namespace ty {
      * 小程序自定义配置
      * @since MiniKit 3.11.5
      */
-    config: {}
+    config: Record<string, any>
   }
 
   /**
    * 唤起小程序看板页
    * @public
    * @since MiniKit 3.3.0
+   * @example Demo
+   * ```tsx
+   * ty.showBoard({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function showBoard(params?: {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -1659,15 +2181,27 @@ declare namespace ty {
    * 重置小程序看板页自定义栏item
    * @public
    * @since MiniKit 3.4.0
+   * @example Demo
+   * ```tsx
+   * ty.resetBoardMenus({
+   *   effectPage: "current",
+   *   menus: [
+   *     { key: "share", iconPath: "/assets/share.png", text: "Share", isShow: true },
+   *   ],
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function resetBoardMenus(params: {
     /**
      * 生效页面, 默认当前页面
      * @since MiniKit 3.4.0
-     * @defaultValue EffectPage.current
+     * @defaultValue 'current'
+     * @TEnum EffectPage
      */
-    effectPage?: EffectPage
+    effectPage?: "current" | "all"
     /**
      * item列表
      * @since MiniKit 3.4.0
@@ -1676,7 +2210,7 @@ declare namespace ty {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -1697,15 +2231,27 @@ declare namespace ty {
    * 重置小程序看板页默认栏item
    * @public
    * @since MiniKit 3.4.0
+   * @example Demo
+   * ```tsx
+   * ty.resetSystemMenus({
+   *   effectPage: "current",
+   *   menus: [
+   *     { key: "home", iconPath: "/assets/home.png", text: "Home", isShow: true },
+   *   ],
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function resetSystemMenus(params: {
     /**
      * 生效页面, 默认当前页面
      * @since MiniKit 3.4.0
-     * @defaultValue EffectPage.current
+     * @defaultValue 'current'
+     * @TEnum EffectPage
      */
-    effectPage?: EffectPage
+    effectPage?: "current" | "all"
     /**
      * item列表
      * @since MiniKit 3.4.0
@@ -1714,7 +2260,7 @@ declare namespace ty {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -1735,15 +2281,25 @@ declare namespace ty {
    * 针对具体的看板itemKey显示红点
    * @public
    * @since MiniKit 3.6.1
+   * @example Demo
+   * ```tsx
+   * ty.showRedBot({
+   *   effectPage: "current",
+   *   key: "share",
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function showRedBot(params: {
     /**
      * 生效页面, 默认当前页面
      * @since MiniKit 3.6.1
-     * @defaultValue EffectPage.current
+     * @defaultValue 'current'
+     * @TEnum EffectPage
      */
-    effectPage?: EffectPage
+    effectPage?: "current" | "all"
     /**
      * 看板item名称
      * @since MiniKit 3.6.1
@@ -1752,7 +2308,7 @@ declare namespace ty {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -1773,15 +2329,25 @@ declare namespace ty {
    * 针对具体的看板itemKey隐藏红点
    * @public
    * @since MiniKit 3.6.1
+   * @example Demo
+   * ```tsx
+   * ty.hiddenRedBot({
+   *   effectPage: "current",
+   *   key: "share",
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function hiddenRedBot(params: {
     /**
      * 生效页面, 默认当前页面
      * @since MiniKit 3.6.1
-     * @defaultValue EffectPage.current
+     * @defaultValue 'current'
+     * @TEnum EffectPage
      */
-    effectPage?: EffectPage
+    effectPage?: "current" | "all"
     /**
      * 看板item名称
      * @since MiniKit 3.6.1
@@ -1790,7 +2356,7 @@ declare namespace ty {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -1811,13 +2377,24 @@ declare namespace ty {
    * 关闭小程序页面加载框, 如果页面配置中配置了manualHideLoading:true，需要手动调用此接口关闭加载框
    * @public
    * @since MiniKit 3.12.1
+   * @example Demo
+   * ```tsx
+   * ty.hideRenderLoading({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function hideRenderLoading(params?: {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -1838,6 +2415,14 @@ declare namespace ty {
    * 设置小程序页面背景图片，调用后小程序导航栏背景色将变为透明
    * @public
    * @since MiniKit 3.12.1
+   * @example Demo
+   * ```tsx
+   * ty.setBackgroundImage({
+   *   imageUrl: "https://images.tuyacn.com/rms-static/b7bed040-87b8-11eb-864d-a9f07cbbdf37-1616051299140.png?tyName=logo_cn.png",
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function setBackgroundImage(params: {
@@ -1849,7 +2434,7 @@ declare namespace ty {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -1870,6 +2455,14 @@ declare namespace ty {
    * 设置小程序页面背景颜色
    * @public
    * @since MiniKit 3.14.0
+   * @example Demo
+   * ```tsx
+   * ty.setBackgroundColor({
+   *   color: "#FFFFFF",
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function setBackgroundColor(params: {
@@ -1881,7 +2474,7 @@ declare namespace ty {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -1902,13 +2495,24 @@ declare namespace ty {
    * 重新载入小程序
    * @public
    * @since MiniKit 3.22.1
+   * @example Demo
+   * ```tsx
+   * ty.reloadMiniProgram({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function reloadMiniProgram(params?: {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -1929,6 +2533,16 @@ declare namespace ty {
    * 给native发送通知
    * @public
    * @since MiniKit 3.20.0
+   * @example Demo
+   * ```tsx
+   * ty.sendNotificationToNative({
+   *   eventId: "ttt_demo_event",
+   *   name: "ttt_demo_notification",
+   *   payload: { from: "ttt-demo" },
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function sendNotificationToNative(params: {
@@ -1942,10 +2556,15 @@ declare namespace ty {
      * @since MiniKit 3.20.0
      */
     name: string
+    /**
+     * name: 业务数据
+     * @since MiniKit 3.34.0
+     */
+    payload?: Record<string, any>
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -1966,13 +2585,20 @@ declare namespace ty {
    * 在当前页面显示导航条加载动画
    * @public
    * @since MiniKit 1.0.0
+   * @example Demo
+   * ```tsx
+   * ty.showNavigationBarLoading({
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function showNavigationBarLoading(params?: {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -1993,6 +2619,14 @@ declare namespace ty {
    * 动态设置当前页面的标题
    * @public
    * @since MiniKit 1.0.0
+   * @example Demo
+   * ```tsx
+   * ty.setNavigationBarTitle({
+   *   title: "TTT Demo Title",
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function setNavigationBarTitle(params: {
@@ -2004,7 +2638,7 @@ declare namespace ty {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -2025,6 +2659,16 @@ declare namespace ty {
    * 设置页面导航条颜色
    * @public
    * @since MiniKit 1.0.0
+   * @example Demo
+   * ```tsx
+   * ty.setNavigationBarColor({
+   *   frontColor: "#000000",
+   *   backgroundColor: "#FFFFFF",
+   *   animation: { duration: 300, timingFunc: "easeInOut" },
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function setNavigationBarColor(params: {
@@ -2046,7 +2690,7 @@ declare namespace ty {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -2067,13 +2711,20 @@ declare namespace ty {
    * 在当前页面隐藏导航条加载动画
    * @public
    * @since MiniKit 1.0.0
+   * @example Demo
+   * ```tsx
+   * ty.hideNavigationBarLoading({
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function hideNavigationBarLoading(params?: {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -2094,13 +2745,20 @@ declare namespace ty {
    * 隐藏返回首页按钮
    * @public
    * @since MiniKit 1.0.0
+   * @example Demo
+   * ```tsx
+   * ty.hideHomeButton({
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function hideHomeButton(params?: {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -2121,6 +2779,15 @@ declare namespace ty {
    * 路由到新页面
    * @public
    * @since MiniKit 1.0.0
+   * @example Demo
+   * ```tsx
+   * ty.navigateTo({
+   *   url: "pages/index/index",
+   *   type: "full",
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function navigateTo(params: {
@@ -2160,7 +2827,7 @@ declare namespace ty {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -2181,6 +2848,14 @@ declare namespace ty {
    * 关闭当前页面，返回上一页面或多级页面
    * @public
    * @since MiniKit 1.0.0
+   * @example Demo
+   * ```tsx
+   * ty.navigateBack({
+   *   delta: 1,
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function navigateBack(params?: {
@@ -2193,7 +2868,7 @@ declare namespace ty {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -2214,6 +2889,14 @@ declare namespace ty {
    * 关闭当前页面，跳转到应用内的某个页面
    * @public
    * @since MiniKit 1.0.0
+   * @example Demo
+   * ```tsx
+   * ty.redirectTo({
+   *   url: "pages/index/index",
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function redirectTo(params: {
@@ -2225,7 +2908,7 @@ declare namespace ty {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -2246,6 +2929,14 @@ declare namespace ty {
    * 关闭所有页面，打开到应用内的某个页面
    * @public
    * @since MiniKit 1.0.0
+   * @example Demo
+   * ```tsx
+   * ty.reLaunch({
+   *   url: "pages/index/index",
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function reLaunch(params: {
@@ -2257,7 +2948,7 @@ declare namespace ty {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -2278,6 +2969,14 @@ declare namespace ty {
    * 跳转到 tabBar 页面，并关闭其他所有非 tabBar 页面
    * @public
    * @since MiniKit 1.0.0
+   * @example Demo
+   * ```tsx
+   * ty.switchTab({
+   *   url: "pages/index/index",
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function switchTab(params: {
@@ -2289,7 +2988,7 @@ declare namespace ty {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -2310,6 +3009,14 @@ declare namespace ty {
    * 判断自定义API是否可用
    * @public
    * @since MiniKit 2.4.2
+   * @example Demo
+   * ```tsx
+   * ty.extApiCanIUse({
+   *   api: "getDeviceInfo",
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function extApiCanIUse(params: {
@@ -2348,12 +3055,20 @@ declare namespace ty {
    * 判断自定义API是否可用
    * @public
    * @since MiniKit 2.4.2
+   * @example Demo
+   * ```tsx
+   * ty.extApiCanIUse({
+   *   api: "getDeviceInfo",
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function extApiCanIUseSync(caniuseBean?: CanIUseBean): {
     /**
      * 当前版本是否可用
-     * @since MiniKit 3.2.0
+     * @since MiniKit 2.4.2
      */
     result: boolean
   }
@@ -2362,6 +3077,15 @@ declare namespace ty {
    * 调用自定义API
    * @public
    * @since MiniKit 2.4.2
+   * @example Demo
+   * ```tsx
+   * ty.extApiInvoke({
+   *   api: "getDeviceInfo",
+   *   params: {},
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function extApiInvoke(params: {
@@ -2383,7 +3107,7 @@ declare namespace ty {
        * extApi返回数据
        * @since MiniKit 3.2.0
        */
-      data?: {}
+      data?: Record<string, any>
     }) => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
@@ -2405,20 +3129,37 @@ declare namespace ty {
    * 调用自定义API
    * @public
    * @since MiniKit 2.4.2
+   * @example Demo
+   * ```tsx
+   * ty.extApiInvoke({
+   *   api: "getDeviceInfo",
+   *   params: {},
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function extApiInvokeSync(extApiBean?: ExtApiBean): {
     /**
      * extApi返回数据
-     * @since MiniKit 3.2.0
+     * @since MiniKit 2.4.2
      */
-    data?: {}
+    data?: Record<string, any>
   }
 
   /**
    * 接收缓存结果，提供给基础库调用
    * @public
    * @since MiniKit 3.27.0
+   * @example Demo
+   * ```tsx
+   * ty.receiveApiRequestCache({
+   *   requestId: "ttt-demo-request-id",
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function receiveApiRequestCache(params: {
@@ -2436,7 +3177,7 @@ declare namespace ty {
        * thing_data_ 出参结构体， JSON序列化
        * @since MiniKit 3.27.0
        */
-      thing_json_?: {}
+      thing_json_?: Record<string, any>
       /**
        * 元数据
        * @since MiniKit 3.27.0
@@ -2446,7 +3187,7 @@ declare namespace ty {
        * 序列化返回结果
        * @since MiniKit 3.27.0
        */
-      result: {}
+      result: Record<string, any>
       /**
        * apiName
        * @since MiniKit 3.27.0
@@ -2473,6 +3214,14 @@ declare namespace ty {
    * 移除对应API的请求缓存
    * @public
    * @since MiniKit 3.27.0
+   * @example Demo
+   * ```tsx
+   * ty.removeApiRequestCache({
+   *   apiList: [{ apiName: "m.life.app.ai.config", version: "2.0" }],
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function removeApiRequestCache(params: {
@@ -2484,7 +3233,7 @@ declare namespace ty {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -2505,13 +3254,20 @@ declare namespace ty {
    * 开始下拉刷新。调用后触发当前页面下拉刷新动画，效果与用户手动下拉刷新一致。
    * @public
    * @since MiniKit 1.0.0
+   * @example Demo
+   * ```tsx
+   * ty.startPullDownRefresh({
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function startPullDownRefresh(params?: {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -2532,13 +3288,20 @@ declare namespace ty {
    * 停止当前页面下拉刷新。
    * @public
    * @since MiniKit 1.0.0
+   * @example Demo
+   * ```tsx
+   * ty.stopPullDownRefresh({
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function stopPullDownRefresh(params?: {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -2559,6 +3322,14 @@ declare namespace ty {
    * 是否允许页面滚动
    * @public
    * @since MiniKit 3.30.0
+   * @example Demo
+   * ```tsx
+   * ty.enablePageScroll({
+   *   scrollEnable: true,
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function enablePageScroll(params?: {
@@ -2571,7 +3342,7 @@ declare namespace ty {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -2592,19 +3363,28 @@ declare namespace ty {
    * 移除当前widget视图, 仅在widget内部调用且不支持Dialog形式
    * @public
    * @since MiniKit 3.5.4
+   * @example Demo
+   * ```tsx
+   * ty.widgetRemove({
+   *   mode: "ONCE",
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function widgetRemove(params?: {
     /**
      * 移除模式
      * @since MiniKit 3.5.4
-     * @defaultValue WidgetMode.ONCE
+     * @defaultValue 'ONCE'
+     * @TEnum WidgetMode
      */
-    mode?: WidgetMode
+    mode?: "ONCE" | "FOREVER"
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -2624,7 +3404,13 @@ declare namespace ty {
   /**
    * 原生上报的事件
    * @public
-   * @since MiniKit 3.33.0
+   * @since MiniKit 2.3.0
+   * @example Demo
+   * ```tsx
+   * ty.onNativeEvent(e => {
+   *   console.log(e);
+   * });
+   * ```
    * @platform iOS Android
    */
   export function onNativeEvent(
@@ -2634,7 +3420,13 @@ declare namespace ty {
   /**
    * 原生上报的事件
    * @public
-   * @since MiniKit 3.33.0
+   * @since MiniKit 2.3.0
+   * @example Demo
+   * ```tsx
+   * const listener = function (res) { console.log(res) }
+   * ty.onNativeEvent(listener)
+   * ty.offNativeEvent(listener)
+   * ```
    * @platform iOS Android
    */
   export function offNativeEvent(
@@ -2644,7 +3436,13 @@ declare namespace ty {
   /**
    * 添加监听体验评分结束事件方法
    * @public
-   * @since MiniKit 3.33.0
+   * @since MiniKit 3.18.2
+   * @example Demo
+   * ```tsx
+   * ty.onExperienceRateEnd(e => {
+   *   console.log(e);
+   * });
+   * ```
    * @platform iOS Android
    */
   export function onExperienceRateEnd(
@@ -2653,6 +3451,7 @@ declare namespace ty {
        * 体验评分结果
        * id: 评分表示
        * detail: 评分详情
+       * @since MiniKit 3.18.2
        */
       source: string
     }) => void
@@ -2661,7 +3460,15 @@ declare namespace ty {
   /**
    * 移除监听体验评分结束事件方法
    * @public
-   * @since MiniKit 3.33.0
+   * @since MiniKit 3.18.2
+   * @example Demo
+   * ```tsx
+   * const handler = e => {
+   *   console.log(e);
+   * };
+   * ty.onExperienceRateEnd(handler);
+   * ty.offExperienceRateEnd(handler);
+   * ```
    * @platform iOS Android
    */
   export function offExperienceRateEnd(
@@ -2670,11 +3477,13 @@ declare namespace ty {
        * 体验评分结果
        * id: 评分表示
        * detail: 评分详情
+       * @since MiniKit 3.18.2
        */
       source: string
     }) => void
   ): void
 
+  /** @since MiniKit 3.20.2 */
   export interface FetchBean {
     /**
      * 拉取数据的类型，默认pre：表示预拉取
@@ -2689,13 +3498,21 @@ declare namespace ty {
     fetchApiKeys?: string[]
   }
 
+  /** @since MiniKit 3.20.2 */
   export interface FetchDataResp {
-    /** 缓存数据 */
-    fetchedData: {}
-    /** 客户端拿到缓存数据的时间戳 */
+    /**
+     * 缓存数据
+     * @since MiniKit 3.20.2
+     */
+    fetchedData: Record<string, any>
+    /**
+     * 客户端拿到缓存数据的时间戳
+     * @since MiniKit 3.20.2
+     */
     timeStamp: number
   }
 
+  /** @since MiniKit 3.20.2 */
   export interface FetchResponse {
     /**
      * 缓存数据
@@ -2704,6 +3521,7 @@ declare namespace ty {
     fetchedData: Record<string, FetchDataResp>
   }
 
+  /** @since MiniKit 3.20.2 */
   export interface RegisterBean {
     /**
      * 拉取数据的类型，默认pre：表示预拉取
@@ -2723,12 +3541,13 @@ declare namespace ty {
     registerId: string
   }
 
+  /** @since MiniKit 3.20.2 */
   export interface RegisterResponse {
     /**
      * 缓存数据
      * @since MiniKit 3.20.2
      */
-    fetchedData: {}
+    fetchedData: Record<string, any>
     /**
      * 客户端拿到缓存数据的时间戳
      * @since MiniKit 3.20.2
@@ -2741,6 +3560,7 @@ declare namespace ty {
     registerId: string
   }
 
+  /** @since MiniKit 2.3.0 */
   export interface NativeDisabledParam {
     /**
      * 禁用异层渲染手势分发
@@ -2749,13 +3569,12 @@ declare namespace ty {
     nativeDisabled: boolean
     /**
      * 需要禁止或启用手势分发的页面id
-     * @since MiniKit 2.3.12
+     * @since MiniKit 2.4.2
      */
     pageId: string
   }
 
-  export interface Object {}
-
+  /** @since MiniKit 2.3.0 */
   export interface NativeParams {
     /**
      * 原生组件类型
@@ -2782,60 +3601,90 @@ declare namespace ty {
      * 参数等
      * @since MiniKit 2.3.0
      */
-    params: Record<string, Object>
+    params: Record<string, Record<string, any>>
   }
 
+  /** @since MiniKit 2.3.0 */
   export interface NativeUploadData {
-    /** 原生组件的EventName */
+    /**
+     * 原生组件的EventName
+     * @since MiniKit 2.3.0
+     */
     eventName: string
-    /** 异层渲染原生视图id */
+    /**
+     * 异层渲染原生视图id
+     * @since MiniKit 2.3.0
+     */
     id: string
-    /** 小程序页面id */
+    /**
+     * 小程序页面id
+     * @since MiniKit 2.3.0
+     */
     pageId: string
-    /** 数据等 */
-    data: Record<string, Object>
+    /**
+     * 数据等
+     * @since MiniKit 2.3.0
+     */
+    data: Record<string, Record<string, any>>
   }
 
+  /** @since MiniKit 2.3.0 */
   export interface ViewId {
-    /** 异层渲染原生视图id */
+    /**
+     * 异层渲染原生视图id
+     * @since MiniKit 2.3.0
+     */
     viewId: string
   }
 
+  /** @since MiniKit 2.3.0 */
   export interface RegisterNativeEventBody {
-    /** key对应的内容 */
+    /**
+     * key对应的内容
+     * @since MiniKit 2.3.0
+     */
     data: string
   }
 
+  /** @since MiniKit 2.3.0 */
   export interface SuccessMessage {
-    /** key对应的内容 */
+    /**
+     * key对应的内容
+     * @since MiniKit 2.3.0
+     */
     data: string
   }
 
+  /** @since MiniKit 3.18.2 */
   export interface RateEventEndBody {
     /**
      * 体验评分结果
      * id: 评分表示
      * detail: 评分详情
+     * @since MiniKit 3.18.2
      */
     source: string
   }
 
+  /** @since MiniKit 2.6.0 */
   export interface PermissionConfig {
     /**
      * 权限相关配置信息
-     * @since MiniKit 3.2.0
+     * @since MiniKit 2.6.0
      */
     result: Record<string, any>
   }
 
+  /** @since MiniKit 2.6.0 */
   export interface AuthSetting {
     /**
      * 用户授权设置信息
-     * @since MiniKit 3.2.0
+     * @since MiniKit 2.6.0
      */
     scope: Record<string, boolean>
   }
 
+  /** @since MiniKit 2.6.0 */
   export interface DebugModeSetting {
     /**
      * 调试模式开关
@@ -2844,14 +3693,16 @@ declare namespace ty {
     isEnable: boolean
   }
 
+  /** @since MiniKit 3.15.2 */
   export interface TabBarIndexBean {
     /**
      * tabBar 的哪一项，从左边算起
-     * @since MiniKit 1.0.0
+     * @since MiniKit 3.15.2
      */
     index: number
   }
 
+  /** @since MiniKit 1.0.0 */
   export interface OperateTabBarParams {
     /**
      * 是否需要动画效果
@@ -2860,6 +3711,7 @@ declare namespace ty {
     animation: boolean
   }
 
+  /** @since MiniKit 1.0.0 */
   export interface TabBarStyleParams {
     /**
      * tab 上的文字默认颜色
@@ -2883,6 +3735,7 @@ declare namespace ty {
     borderStyle: string
   }
 
+  /** @since MiniKit 1.0.0 */
   export interface TabBarItemParams {
     /**
      * tabBar 的哪一项，从左边算起
@@ -2906,6 +3759,7 @@ declare namespace ty {
     selectedIconPath: string
   }
 
+  /** @since MiniKit 1.0.0 */
   export interface TabBarBadgeParams {
     /**
      * tabBar 的哪一项，从左边算起
@@ -2919,43 +3773,79 @@ declare namespace ty {
     text: string
   }
 
+  /** @since MiniKit 2.3.6 */
   export enum HighwayMethod {
-    /** HTTP 请求 OPTIONS */
+    /**
+     * HTTP 请求 OPTIONS
+     * @since MiniKit 2.3.6
+     */
     OPTIONS = "OPTIONS",
 
-    /** HTTP 请求 GET */
+    /**
+     * HTTP 请求 GET
+     * @since MiniKit 2.3.6
+     */
     GET = "GET",
 
-    /** HTTP 请求 HEAD */
+    /**
+     * HTTP 请求 HEAD
+     * @since MiniKit 2.3.6
+     */
     HEAD = "HEAD",
 
-    /** HTTP 请求 POST */
+    /**
+     * HTTP 请求 POST
+     * @since MiniKit 2.3.6
+     */
     POST = "POST",
 
-    /** HTTP 请求 PUT */
+    /**
+     * HTTP 请求 PUT
+     * @since MiniKit 2.3.6
+     */
     PUT = "PUT",
 
-    /** HTTP 请求 DELETE */
+    /**
+     * HTTP 请求 DELETE
+     * @since MiniKit 2.3.6
+     */
     DELETE = "DELETE",
 
-    /** HTTP 请求 TRACE */
+    /**
+     * HTTP 请求 TRACE
+     * @since MiniKit 2.3.6
+     */
     TRACE = "TRACE",
 
-    /** HTTP 请求 TRACE */
+    /**
+     * HTTP 请求 CONNECT
+     * @since MiniKit 2.3.6
+     */
     CONNECT = "CONNECT",
   }
 
+  /** @since MiniKit 3.27.0 */
   export enum CachePolicy {
-    /** 仅发起网络请求，不使用缓存 */
+    /**
+     * 仅发起网络请求，不使用缓存
+     * @since MiniKit 3.27.0
+     */
     NETWORK_ONLY = "NETWORK_ONLY",
 
-    /** 先使用缓存，缓存不存在时发起网络请求 */
+    /**
+     * 先使用缓存，缓存不存在时发起网络请求
+     * @since MiniKit 3.27.0
+     */
     CACHE_ELSE_NETWORK = "CACHE_ELSE_NETWORK",
 
-    /** 优先使用缓存，同时发起网络请求，网络请求结果会通过事件下发 */
+    /**
+     * 优先使用缓存，同时发起网络请求，网络请求结果会通过事件下发
+     * @since MiniKit 3.27.0
+     */
     CACHE_THEN_NETWORK = "CACHE_THEN_NETWORK",
   }
 
+  /** @since MiniKit 3.27.0 */
   export interface ApiRequestCacheBean {
     /**
      * 缓存超时时间，单位秒
@@ -2965,28 +3855,31 @@ declare namespace ty {
     /**
      * 缓存策略，默认 CachePolicy.CACHE_THEN_NETWORK
      * @since MiniKit 3.27.0
-     * @defaultValue CachePolicy.CACHE_THEN_NETWORK
+     * @defaultValue 'CACHE_THEN_NETWORK'
+     * @TEnum CachePolicy
      */
-    policy?: CachePolicy
+    policy?: "NETWORK_ONLY" | "CACHE_ELSE_NETWORK" | "CACHE_THEN_NETWORK"
   }
 
+  /** @since MiniKit 2.3.6 */
   export interface HighwayRequestBean {
     /**
      * api 名称
-     * @since MiniKit 1.0.0
+     * @since MiniKit 2.3.6
      */
     api: string
     /**
-     * data 请求入参
-     * @since MiniKit 1.0.0
+     * Highway API 请求业务参数，字段结构由 api 对应的 Highway 接口定义
+     * @since MiniKit 2.3.6
      */
     data?: Record<string, any>
     /**
      * method 请求方法
-     * @since MiniKit 1.0.0
-     * @defaultValue HighwayMethod.GET
+     * @since MiniKit 2.3.6
+     * @defaultValue 'GET'
+     * @TEnum HighwayMethod
      */
-    method?: HighwayMethod
+    method?: "OPTIONS" | "GET" | "HEAD" | "POST" | "PUT" | "DELETE" | "TRACE" | "CONNECT"
     /**
      * requestId 请求ID，业务方不感知
      * @since MiniKit 3.27.0
@@ -2999,21 +3892,21 @@ declare namespace ty {
     cache?: ApiRequestCacheBean
   }
 
+  /** @since MiniKit 2.3.6 */
   export interface HighwayRequestResponse {
-    /**
-     * 接口返回数据的序列化对象，序列化失败时为null
-     * @since MiniKit 3.2.0
-     */
-    thing_json_?: {}
     /**
      * 接口返回的原始数据
-     * @since MiniKit 3.2.0
+     * @since MiniKit 2.3.6
      */
-    data: string
+    data: Record<string, any>
   }
 
+  /** @since MiniKit 3.29.2 */
   export interface MiniappLogContext {
-    /** managerId */
+    /**
+     * managerId
+     * @since MiniKit 3.29.2
+     */
     logManagerId: number
     /**
      * 业务类型，比如：Framework、 DeviceDetail等，必传
@@ -3027,6 +3920,7 @@ declare namespace ty {
     publicParam?: Record<string, string>
   }
 
+  /** @since MiniKit 3.29.2 */
   export interface LogManagerCode {
     /**
      * 错误码
@@ -3051,8 +3945,12 @@ declare namespace ty {
     isEvent?: boolean
   }
 
+  /** @since MiniKit 3.29.2 */
   export interface LogManagerReqContext {
-    /** managerId */
+    /**
+     * managerId
+     * @since MiniKit 3.29.2
+     */
     logManagerId: number
     /**
      * errorCode
@@ -3068,9 +3966,10 @@ declare namespace ty {
      * 自定义参数，（限制1000个字符）
      * @since MiniKit 3.29.2
      */
-    params?: Object
+    params?: Record<string, any>
   }
 
+  /** @since MiniKit 1.0.0 */
   export interface BackMiniProgramBean {
     /**
      * 需要返回给上一个小程序的数据，上一个小程序可在 App.onShow 中获取到这份数据
@@ -3079,17 +3978,28 @@ declare namespace ty {
     extraData?: Record<string, any>
   }
 
+  /** @since MiniKit 3.15.0 */
   export enum MiniAppScene {
-    /** 默认值 */
+    /**
+     * 默认值
+     * @since MiniKit 3.15.0
+     */
     DEFAULT = 1000,
 
-    /** 通过最近使用小程序列表进入 */
+    /**
+     * 通过最近使用小程序列表进入
+     * @since MiniKit 3.15.0
+     */
     RECENTLY_USED = 1001,
 
-    /** 通过URL映射进入 */
+    /**
+     * 通过URL映射进入
+     * @since MiniKit 3.15.0
+     */
     URL_MAPPING = 1002,
   }
 
+  /** @since MiniKit 1.0.0 */
   export interface ReferrerInfo {
     /**
      * 来源小程序的 appId
@@ -3103,31 +4013,33 @@ declare namespace ty {
     extraData: Record<string, any>
   }
 
+  /** @since MiniKit 1.0.0 */
   export interface MiniAppOptions {
     /**
      * 启动小程序的路径 (代码包路径)
-     * @since MiniKit 3.2.0
+     * @since MiniKit 1.0.0
      */
     path: string
     /**
      * 启动小程序的场景值
-     * @since MiniKit 3.14.1
-     * @defaultValue MiniAppScene.DEFAULT
+     * @since MiniKit 3.15.0
+     * @defaultValue 1000
+     * @TEnum MiniAppScene
      */
-    scene?: MiniAppScene
+    scene?: 1000 | 1001 | 1002
     /**
      * 启动小程序的 query 参数
-     * @since MiniKit 3.2.0
+     * @since MiniKit 1.0.0
      */
     query: Record<string, any>
     /**
      * 分享转发
-     * @since MiniKit 3.2.0
+     * @since MiniKit 1.0.0
      */
     referrerInfo: ReferrerInfo
     /**
      * API 类别: default	默认类别; embedded 内嵌，通过打开半屏小程序能力打开的小程序
-     * @since MiniKit 3.2.0
+     * @since MiniKit 1.0.0
      * @defaultValue "default"
      */
     apiCategory?: string
@@ -3138,14 +4050,16 @@ declare namespace ty {
     extraQuery?: Record<string, any>
   }
 
+  /** @since MiniKit 2.0.6 */
   export interface BoardBean {
     /**
      * 看板页标题
-     * @since MiniKit 1.0.0
+     * @since MiniKit 2.0.6
      */
     title: string
   }
 
+  /** @since MiniKit 2.3.17 */
   export interface BoardIconBean {
     /**
      * 看板页icon
@@ -3154,39 +4068,41 @@ declare namespace ty {
     icon: string
   }
 
+  /** @since MiniKit 2.3.0 */
   export interface CapsuleButtonRectBean {
     /**
      * 宽度，单位：px
-     * @since MiniKit 3.2.0
+     * @since MiniKit 2.3.0
      */
     width: number
     /**
      * 高度，单位：px
-     * @since MiniKit 3.2.0
+     * @since MiniKit 2.3.0
      */
     height: number
     /**
      * 上边界坐标，单位：px
-     * @since MiniKit 3.2.0
+     * @since MiniKit 2.3.0
      */
     top: number
     /**
      * 右边界坐标，单位：px
-     * @since MiniKit 3.2.0
+     * @since MiniKit 2.3.0
      */
     right: number
     /**
      * 下边界坐标，单位：px
-     * @since MiniKit 3.2.0
+     * @since MiniKit 2.3.0
      */
     bottom: number
     /**
      * 左边界坐标，单位：px
-     * @since MiniKit 3.2.0
+     * @since MiniKit 2.3.0
      */
     left: number
   }
 
+  /** @since MiniKit 2.3.0 */
   export interface PreDownloadMiniAppParams {
     /**
      * 小程序id
@@ -3200,6 +4116,7 @@ declare namespace ty {
     miniAppVersion?: string
   }
 
+  /** @since MiniKit 2.3.2 */
   export interface LoginBean {
     /**
      * 超时时间，单位ms
@@ -3208,14 +4125,16 @@ declare namespace ty {
     timeout?: number
   }
 
+  /** @since MiniKit 2.3.2 */
   export interface LoginResult {
     /**
      * 用户登录凭证（有效期五分钟）
-     * @since MiniKit 3.2.0
+     * @since MiniKit 2.3.2
      */
     code: string
   }
 
+  /** @since MiniKit 2.4.1 */
   export interface OrientationBean {
     /**
      * 屏幕旋转设置， auto / portrait / landscape (默认landscape-right)
@@ -3229,6 +4148,7 @@ declare namespace ty {
     reverse?: boolean
   }
 
+  /** @since MiniKit 3.0.0 */
   export interface OpenURLBean {
     /**
      * 要打开的url
@@ -3237,15 +4157,17 @@ declare namespace ty {
     url: string
   }
 
+  /** @since MiniKit 3.0.0 */
   export interface CanOpenURLResultBean {
     /**
      * 是否支持打开对应的url
-     * @since MiniKit 3.2.0
+     * @since MiniKit 3.0.0
      * @defaultValue false
      */
     isCanOpen?: boolean
   }
 
+  /** @since MiniKit 3.1.0 */
   export interface MiniProgramAccountInfo {
     /**
      * 小程序 appId
@@ -3284,30 +4206,40 @@ declare namespace ty {
     providerType: string
   }
 
+  /** @since MiniKit 3.1.0 */
   export interface AccountInfoResp {
     /**
      * 小程序账号信息
-     * @since MiniKit 3.2.0
+     * @since MiniKit 3.1.0
      */
     miniProgram: MiniProgramAccountInfo
   }
 
+  /** @since MiniKit 3.11.5 */
   export interface MiniAppConfigResp {
     /**
      * 小程序自定义配置
      * @since MiniKit 3.11.5
      */
-    config: {}
+    config: Record<string, any>
   }
 
+  /** @since MiniKit 3.4.0 */
   export enum EffectPage {
-    /** 当前页面 */
+    /**
+     * 当前页面
+     * @since MiniKit 3.4.0
+     */
     current = "current",
 
-    /** 所有页面 */
+    /**
+     * 所有页面
+     * @since MiniKit 3.4.0
+     */
     all = "all",
   }
 
+  /** @since MiniKit 3.4.0 */
   export interface BoardItemBean {
     /**
      * item名称
@@ -3332,13 +4264,15 @@ declare namespace ty {
     isShow?: boolean
   }
 
+  /** @since MiniKit 3.4.0 */
   export interface BoardMenusBean {
     /**
      * 生效页面, 默认当前页面
      * @since MiniKit 3.4.0
-     * @defaultValue EffectPage.current
+     * @defaultValue 'current'
+     * @TEnum EffectPage
      */
-    effectPage?: EffectPage
+    effectPage?: "current" | "all"
     /**
      * item列表
      * @since MiniKit 3.4.0
@@ -3346,13 +4280,15 @@ declare namespace ty {
     menus: BoardItemBean[]
   }
 
+  /** @since MiniKit 3.6.1 */
   export interface RedBodReq {
     /**
      * 生效页面, 默认当前页面
      * @since MiniKit 3.6.1
-     * @defaultValue EffectPage.current
+     * @defaultValue 'current'
+     * @TEnum EffectPage
      */
-    effectPage?: EffectPage
+    effectPage?: "current" | "all"
     /**
      * 看板item名称
      * @since MiniKit 3.6.1
@@ -3360,6 +4296,7 @@ declare namespace ty {
     key: string
   }
 
+  /** @since MiniKit 3.12.1 */
   export interface BackgroundImageBean {
     /**
      * 图片地址，支持网络图片和本地图片
@@ -3368,6 +4305,7 @@ declare namespace ty {
     imageUrl: string
   }
 
+  /** @since MiniKit 3.14.0 */
   export interface BackgroundColorBean {
     /**
      * 当前页面背景颜色
@@ -3376,8 +4314,12 @@ declare namespace ty {
     color: string
   }
 
+  /** @since MiniKit 3.6.0 */
   export interface CreateReq {
-    /** managerId: 通知管理器id */
+    /**
+     * managerId: 通知管理器id
+     * @since MiniKit 3.6.0
+     */
     managerId: string
     /**
      * name: 通知名称
@@ -3386,11 +4328,16 @@ declare namespace ty {
     name: string
   }
 
+  /** @since MiniKit 3.6.0 */
   export interface ObserverReq {
-    /** managerId: 通知管理器id */
+    /**
+     * managerId: 通知管理器id
+     * @since MiniKit 3.6.0
+     */
     managerId: string
   }
 
+  /** @since MiniKit 3.20.0 */
   export interface SendNotificationToNativeParams {
     /**
      * eventId: 事件id
@@ -3402,15 +4349,28 @@ declare namespace ty {
      * @since MiniKit 3.20.0
      */
     name: string
+    /**
+     * name: 业务数据
+     * @since MiniKit 3.34.0
+     */
+    payload?: Record<string, any>
   }
 
+  /** @since MiniKit 3.6.0 */
   export interface Received {
-    /** managerId */
+    /**
+     * managerId
+     * @since MiniKit 3.6.0
+     */
     managerId: string
-    /** data: 通知内容 */
-    data: {}
+    /**
+     * data: 通知内容
+     * @since MiniKit 3.6.0
+     */
+    data: Record<string, any>
   }
 
+  /** @since MiniKit 1.0.0 */
   export interface NavigationBarLoadingParams {
     /**
      * 页面标题
@@ -3419,6 +4379,7 @@ declare namespace ty {
     title: string
   }
 
+  /** @since MiniKit 1.0.0 */
   export interface NavigationBarColorAnimationInfo {
     /**
      * 动画变化时间，单位 ms
@@ -3438,6 +4399,7 @@ declare namespace ty {
     timingFunc?: string
   }
 
+  /** @since MiniKit 1.0.0 */
   export interface NavigationBarColorParams {
     /**
      * 前景颜色值，包括按钮、标题、状态栏的颜色，仅支持 #ffffff 和 #000000
@@ -3456,6 +4418,7 @@ declare namespace ty {
     animation: NavigationBarColorAnimationInfo
   }
 
+  /** @since MiniKit 1.0.0 */
   export interface RouteBean {
     /**
      * 页面路径, 参数需要做 url encode 处理
@@ -3492,55 +4455,62 @@ declare namespace ty {
     animationType?: string
   }
 
+  /** @since MiniKit 2.4.8 */
   export interface BackRouteBean {
     /**
      * 返回的页面数，如果 delta 大于现有页面数，则返回到首页
-     * @since MiniKit 1.0.0
+     * @since MiniKit 2.4.8
      * @defaultValue 1
      */
     delta?: number
   }
 
+  /** @since MiniKit 3.15.2 */
   export interface RedirectBean {
     /**
      * 页面路径, 参数需要做 url encode 处理
-     * @since MiniKit 1.0.0
+     * @since MiniKit 3.15.2
      */
     url: string
   }
 
+  /** @since MiniKit 3.15.2 */
   export interface ReLaunchBean {
     /**
      * 页面路径, 参数需要做 url encode 处理
-     * @since MiniKit 1.0.0
+     * @since MiniKit 3.15.2
      */
     url: string
   }
 
+  /** @since MiniKit 3.15.2 */
   export interface SwitchTabBean {
     /**
      * 页面路径, 不支持参数
-     * @since MiniKit 1.0.0
+     * @since MiniKit 3.15.2
      */
     url: string
   }
 
+  /** @since MiniKit 3.15.2 */
   export interface CanIUseBean {
     /**
      * api名称
-     * @since MiniKit 2.4.2
+     * @since MiniKit 3.15.2
      */
     api: string
   }
 
+  /** @since MiniKit 2.4.2 */
   export interface SuccessResult {
     /**
      * 当前版本是否可用
-     * @since MiniKit 3.2.0
+     * @since MiniKit 2.4.2
      */
     result: boolean
   }
 
+  /** @since MiniKit 2.4.2 */
   export interface ExtApiBean {
     /**
      * api名称
@@ -3554,14 +4524,16 @@ declare namespace ty {
     params?: Record<string, any>
   }
 
+  /** @since MiniKit 2.4.2 */
   export interface InvokeResult {
     /**
      * extApi返回数据
-     * @since MiniKit 3.2.0
+     * @since MiniKit 2.4.2
      */
-    data?: {}
+    data?: Record<string, any>
   }
 
+  /** @since MiniKit 3.27.0 */
   export interface ReceiveApiRequestCacheReq {
     /**
      * requestId 请求ID
@@ -3570,13 +4542,14 @@ declare namespace ty {
     requestId: string
   }
 
+  /** @since MiniKit 3.27.0 */
   export interface ReceiveApiRequestCacheRes {
     /**
      * 请求结果
      * thing_data_ 出参结构体， JSON序列化
      * @since MiniKit 3.27.0
      */
-    thing_json_?: {}
+    thing_json_?: Record<string, any>
     /**
      * 元数据
      * @since MiniKit 3.27.0
@@ -3586,7 +4559,7 @@ declare namespace ty {
      * 序列化返回结果
      * @since MiniKit 3.27.0
      */
-    result: {}
+    result: Record<string, any>
     /**
      * apiName
      * @since MiniKit 3.27.0
@@ -3594,6 +4567,7 @@ declare namespace ty {
     api: string
   }
 
+  /** @since MiniKit 3.27.0 */
   export interface RemoveApiRequestCacheBean {
     /**
      * apiName API名称
@@ -3607,6 +4581,7 @@ declare namespace ty {
     version: string
   }
 
+  /** @since MiniKit 3.27.0 */
   export interface RemoveApiRequestCacheReq {
     /**
      * apiList 需要删除缓存的API列表
@@ -3615,6 +4590,7 @@ declare namespace ty {
     apiList: RemoveApiRequestCacheBean[]
   }
 
+  /** @since MiniKit 3.30.0 */
   export interface EnablePageScrollBean {
     /**
      * 是否允许页面滚动
@@ -3624,21 +4600,30 @@ declare namespace ty {
     scrollEnable?: boolean
   }
 
+  /** @since MiniKit 3.5.4 */
   export enum WidgetMode {
-    /** 单次移除 */
+    /**
+     * 单次移除
+     * @since MiniKit 3.5.4
+     */
     ONCE = "ONCE",
 
-    /** 永久移除 */
+    /**
+     * 永久移除
+     * @since MiniKit 3.5.4
+     */
     FOREVER = "FOREVER",
   }
 
+  /** @since MiniKit 3.5.4 */
   export interface MiniWidgetRemoveBean {
     /**
      * 移除模式
      * @since MiniKit 3.5.4
-     * @defaultValue WidgetMode.ONCE
+     * @defaultValue 'ONCE'
+     * @TEnum WidgetMode
      */
-    mode?: WidgetMode
+    mode?: "ONCE" | "FOREVER"
   }
 
   interface MiniLogManager {
@@ -3646,6 +4631,21 @@ declare namespace ty {
      * 打印info日志
      * @public
      * @since MiniKit 3.29.2
+     * @example Demo
+     * ```tsx
+     * const manager = await ty.getMiniLogManager({ os: "Framework", success: () => {}, fail: () => {} });
+     * manager.logInfo({
+     *   code: { code: "10001", module: "demo", msg: "demo log" },
+     *   desc: "ttt logInfo demo",
+     *   params: {},
+     *   success: data => {
+     *     console.log(data);
+     *   },
+     *   fail: error => {
+     *     console.error(error);
+     *   },
+     * });
+     * ```
      * @platform iOS Android
      */
     logInfo(params: {
@@ -3663,11 +4663,11 @@ declare namespace ty {
        * 自定义参数，（限制1000个字符）
        * @since MiniKit 3.29.2
        */
-      params?: Object
+      params?: Record<string, any>
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
       complete?: () => void
       /** 接口调用成功的回调函数 */
-      success?: (params: null) => void
+      success?: () => void
       /** 接口调用失败的回调函数 */
       fail?: (params: {
         /** 错误信息 */
@@ -3688,6 +4688,21 @@ declare namespace ty {
      * 打印error日志
      * @public
      * @since MiniKit 3.29.2
+     * @example Demo
+     * ```tsx
+     * const manager = await ty.getMiniLogManager({ os: "Framework", success: () => {}, fail: () => {} });
+     * manager.logError({
+     *   code: { code: "10001", module: "demo", msg: "demo log" },
+     *   desc: "ttt logError demo",
+     *   params: {},
+     *   success: data => {
+     *     console.log(data);
+     *   },
+     *   fail: error => {
+     *     console.error(error);
+     *   },
+     * });
+     * ```
      * @platform iOS Android
      */
     logError(params: {
@@ -3705,11 +4720,11 @@ declare namespace ty {
        * 自定义参数，（限制1000个字符）
        * @since MiniKit 3.29.2
        */
-      params?: Object
+      params?: Record<string, any>
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
       complete?: () => void
       /** 接口调用成功的回调函数 */
-      success?: (params: null) => void
+      success?: () => void
       /** 接口调用失败的回调函数 */
       fail?: (params: {
         /** 错误信息 */
@@ -3730,6 +4745,21 @@ declare namespace ty {
      * 打印warn日志
      * @public
      * @since MiniKit 3.29.2
+     * @example Demo
+     * ```tsx
+     * const manager = await ty.getMiniLogManager({ os: "Framework", success: () => {}, fail: () => {} });
+     * manager.logWarn({
+     *   code: { code: "10001", module: "demo", msg: "demo log" },
+     *   desc: "ttt logWarn demo",
+     *   params: {},
+     *   success: data => {
+     *     console.log(data);
+     *   },
+     *   fail: error => {
+     *     console.error(error);
+     *   },
+     * });
+     * ```
      * @platform iOS Android
      */
     logWarn(params: {
@@ -3747,11 +4777,11 @@ declare namespace ty {
        * 自定义参数，（限制1000个字符）
        * @since MiniKit 3.29.2
        */
-      params?: Object
+      params?: Record<string, any>
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
       complete?: () => void
       /** 接口调用成功的回调函数 */
-      success?: (params: null) => void
+      success?: () => void
       /** 接口调用失败的回调函数 */
       fail?: (params: {
         /** 错误信息 */
@@ -3772,6 +4802,19 @@ declare namespace ty {
    * 创建日志实例对象
    * @public
    * @since MiniKit 3.29.2
+   * @example Demo
+   * ```tsx
+   * const manager = await ty.getMiniLogManager({
+   *   os: "Framework",
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * console.log(manager);
+   * ```
    * @platform iOS Android
    */
   export function getMiniLogManager(params: {
@@ -3788,7 +4831,7 @@ declare namespace ty {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -3810,6 +4853,14 @@ declare namespace ty {
      * 停止监听通知
      * @public
      * @since MiniKit 3.6.0
+     * @example Demo
+     * ```tsx
+     * const manager = await ty.createNativeEventManager({ name: "ttt_demo_notification", success: () => {}, fail: () => {} });
+     * manager.offerListener({
+     *   success: data => { console.log(data); },
+     *   fail: error => { console.error(error); },
+     * });
+     * ```
      * @platform iOS Android
      * @deprecated offListener
      */
@@ -3817,7 +4868,7 @@ declare namespace ty {
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
       complete?: () => void
       /** 接口调用成功的回调函数 */
-      success?: (params: null) => void
+      success?: () => void
       /** 接口调用失败的回调函数 */
       fail?: (params: {
         /** 错误信息 */
@@ -3837,28 +4888,58 @@ declare namespace ty {
     /**
      * 开始监听通知
      * @public
+     * @since MiniKit 3.6.0
+     * @example Demo
+     * ```tsx
+     * const manager = await ty.createNativeEventManager({ name: "ttt_demo_notification", success: () => {}, fail: () => {} });
+     * manager.onListener(e => {
+     *   console.log(e);
+     * });
+     * ```
      * @platform iOS Android
      */
     onListener(
       listener: (params: {
-        /** managerId */
+        /**
+         * managerId
+         * @since MiniKit 3.6.0
+         */
         managerId: string
-        /** data: 通知内容 */
-        data: {}
+        /**
+         * data: 通知内容
+         * @since MiniKit 3.6.0
+         */
+        data: Record<string, any>
       }) => void
     ): void
 
     /**
      * 停止监听通知
      * @public
+     * @since MiniKit 3.15.2
+     * @example Demo
+     * ```tsx
+     * const manager = await ty.createNativeEventManager({ name: "ttt_demo_notification", success: () => {}, fail: () => {} });
+     * const handler = e => {
+     *   console.log(e);
+     * };
+     * manager.onListener(handler);
+     * manager.offListener(handler);
+     * ```
      * @platform iOS Android
      */
     offListener(
       listener: (params: {
-        /** managerId */
+        /**
+         * managerId
+         * @since MiniKit 3.6.0
+         */
         managerId: string
-        /** data: 通知内容 */
-        data: {}
+        /**
+         * data: 通知内容
+         * @since MiniKit 3.6.0
+         */
+        data: Record<string, any>
       }) => void
     ): void
   }
@@ -3866,6 +4947,15 @@ declare namespace ty {
    * 创建原生通知管理器
    * @public
    * @since MiniKit 3.6.0
+   * @example Demo
+   * ```tsx
+   * const manager = await ty.createNativeEventManager({
+   *   name: "ttt_demo_notification",
+   *   success: data => { console.log(data); },
+   *   fail: error => { console.error(error); },
+   * });
+   * console.log(manager);
+   * ```
    * @platform iOS Android
    */
   export function createNativeEventManager(params: {
@@ -3877,7 +4967,7 @@ declare namespace ty {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */