@uni-helper/uni-pages-types 0.4.8 → 0.5.0

package/dist/index.d.mts

@@ -105,6 +105,9 @@ interface TitleNViewButton {
 }
 //#endregion
 //#region src/condition.d.ts
+/**
+ * @deprecated 请使用 ConditionListItem
+ */
 interface ConditionItem {
   /**
    * 启动模式名称
@@ -119,6 +122,25 @@ interface ConditionItem {
    */
   query?: string;
 }
+interface ConditionListItem {
+  /**
+   * 启动模式名称
+   */
+  name: string;
+  /**
+   * 启动页面路径
+   */
+  path: string;
+  /**
+   * 启动参数，可在页面的 onLoad 函数里获得
+   */
+  query?: string;
+  [x: string]: any;
+}
+type ConditionList = ConditionListItem[];
+/**
+ * 启动模式配置
+ */
 interface Condition {
   /**
    * 当前激活的模式，list 节点的索引值
@@ -127,10 +149,16 @@ interface Condition {
   /**
    * 启动模式列表
    */
-  list: ConditionItem[];
+  list: ConditionList;
+  [x: string]: any;
 }
 //#endregion
 //#region src/easycom.d.ts
+/**
+ * 组件自动引入规则
+ *
+ * @desc 2.5.5+
+ */
 interface EasyCom {
   /**
    * 是否开启自动扫描，开启后将会自动扫描符合 `components/组件名称/组件名称.vue` 目录结构的组件
@@ -151,7 +179,7 @@ interface EasyCom {
   custom?: Record<string, string>;
 }
 //#endregion
-//#region src/global-style/app-harmony.d.ts
+//#region src/style/app-harmony.d.ts
 /**
  * 设置编译到 App（Harmony）平台的特定样式
  *
@@ -161,15 +189,19 @@ interface EasyCom {
  */
 interface AppHarmony {
   /**
-   * 软键盘弹出模式，仅支持 "adjustResize" / "adjustPan"
+   * 软键盘弹出模式
+   *
+   * "adjustResize" 重新测量并压缩布局尺寸
+   *
+   * "adjustPan" 整体平移窗口而不改变布局大小
    *
    * @default "adjustPan"
    */
-  softInputMode?: 'adjustResize' | 'adjustPan';
+  softinputMode?: 'adjustResize' | 'adjustPan';
   [x: string]: any;
 }
 //#endregion
-//#region src/global-style/app-plus.d.ts
+//#region src/style/app-plus.d.ts
 interface AppPlus {
   /**
    * 窗体背景色，支持 HEX 颜色
@@ -1094,15 +1126,17 @@ interface AppPlus {
    *
    * @desc App-iOS
    */
-  softInputNavBar?: 'auto' | 'none';
+  softinputNavBar?: 'auto' | 'none';
   /**
    * 软键盘弹出模式，仅支持 "adjustResize" / "adjustPan"
    *
-   * @default "adjustPan"
+   * "adjustResize" 重新测量并压缩布局尺寸
    *
-   * @desc App
+   * "adjustPan" 整体平移窗口而不改变布局大小
+   *
+   * @default "adjustPan"
    */
-  softInputMode?: 'adjustResize' | 'adjustPan';
+  softinputMode?: 'adjustResize' | 'adjustPan';
   /**
    * 下拉刷新
    *
@@ -1204,7 +1238,7 @@ interface AppPlus {
   [x: string]: any;
 }
 //#endregion
-//#region src/global-style/h5.d.ts
+//#region src/style/h5.d.ts
 interface H5 {
   /**
    * 导航栏，详见 [导航栏](https://uniapp.dcloud.net.cn/collocation/pages#h5-titlenview)
@@ -1219,7 +1253,7 @@ interface H5 {
      */
     backgroundColor?: HEXColor;
     /**
-     * 自定义按钮，详见 [自定义按钮](https://uniapp.dcloud.net.cn/collocation/pages#app-titlenview-buttons)
+     * 自定义按钮，详见 [自定义按钮](https://uniapp.dcloud.net.cn/collocation/pages#h5-titlenview-buttons)
      */
     buttons?: TitleNViewButton[];
     /**
@@ -1310,16 +1344,20 @@ interface H5 {
   };
   /**
    * 下拉刷新，详见 [下拉刷新](https://uniapp.dcloud.net.cn/collocation/pages#h5-pulltorefresh)
+   *
+   * h5 平台下拉刷新动画，只有 circle 类型
    */
   pullToRefresh?: {
     /**
      * 下拉刷新控件颜色，支持 HEX 颜色
      *
      * @default "#2BD009"
+     *
+     * @format color
      */
     color?: HEXColor;
     /**
-     * 下拉刷新控件起始位置，支持支持单位为 px 的逻辑像素值或百分比
+     * 下拉刷新控件的起始位置，支持单位为 px 的逻辑像素值或百分比
      *
      * @default "0px"
      */
@@ -1329,9 +1367,9 @@ interface H5 {
   [x: string]: any;
 }
 //#endregion
-//#region src/global-style/mp-alipay.d.ts
+//#region src/style/mp-alipay.d.ts
 /**
- * 设置编译到 mp-alipay 平台的特定样式，配置项参考 [MP-ALIPAY](https://uniapp.dcloud.net.cn/collocation/pages#mp-alipay) 和 <https://opendocs.alipay.com/mini/framework/app-json#window>
+ * 设置编译到 mp-alipay 平台的特定样式，配置项参考 <https://opendocs.alipay.com/mini/framework/app-json#window>
  *
  * 相应的类型是 MpAlipay
  *
@@ -1357,7 +1395,7 @@ interface MpAlipay {
    */
   backgroundImageColor?: HEXColor;
   /**
-   * 下拉露出显示背景图的链接，支持网络地址和本地地址，尽量使用绝对地址
+   * 下拉露出显示背景图的链接
    */
   backgroundImageUrl?: string;
   /**
@@ -1423,13 +1461,15 @@ interface MpAlipay {
    */
   titlePenetrate?: 'YES' | 'NO';
   /**
-   * 导航栏图片地址，会替换当前文字标题，只支持 https 图片链接
+   * 导航栏图片地址
    */
   titleImage?: string;
   /**
    * 导航栏背景色，支持 HEX 颜色
+   *
+   * @format color
    */
-  titleBarColor?: HEXColor;
+  titleBarColor?: HEXColor | ThemeVar;
   /**
    * 导航栏前景色
    *
@@ -1439,9 +1479,9 @@ interface MpAlipay {
   [x: string]: any;
 }
 //#endregion
-//#region src/global-style/mp-baidu.d.ts
+//#region src/style/mp-baidu.d.ts
 /**
- * 设置编译到 mp-baidu 平台的特定样式，配置项参考 [MP-BAIDU](https://uniapp.dcloud.net.cn/collocation/pages.html#mp-baidu) 和 <https://smartprogram.baidu.com/docs/develop/framework/process/#window>
+ * 设置编译到 mp-baidu 平台的特定样式，配置项参考 <https://smartprogram.baidu.com/docs/develop/framework/process/#window>
  *
  * 相应的类型是 MpBaidu
  *
@@ -1494,12 +1534,16 @@ interface MpBaidu {
    * 顶部窗口的背景色，仅 iOS 支持
    *
    * @default "#FFFFFF"
+   *
+   * @format color
    */
   backgroundColorTop?: HEXColor | ThemeVar;
   /**
    * 底部窗口的背景色，仅 iOS 支持
    *
    * @default "#FFFFFF"
+   *
+   * @format color
    */
   backgroundColorBottom?: HEXColor | ThemeVar;
   /**
@@ -1543,7 +1587,7 @@ interface MpBaidu {
   [x: string]: any;
 }
 //#endregion
-//#region src/global-style/mp-harmony.d.ts
+//#region src/style/mp-harmony.d.ts
 /**
  * 设置编译到 mp-harmony 平台的特定样式，配置项参考 <https://developer.huawei.com/consumer/cn/doc/SPPartnerCenter-develop-Guides/extjson-description-0000002554249601>
  *
@@ -1574,6 +1618,8 @@ interface MpHarmony {
    * 窗口的背景色，支持 HEX 颜色
    *
    * @default "#FFFFFF"
+   *
+   * @format color
    */
   backgroundColor?: HEXColor | ThemeVar;
   /**
@@ -1597,7 +1643,7 @@ interface MpHarmony {
   [x: string]: any;
 }
 //#endregion
-//#region src/global-style/mp-jd.d.ts
+//#region src/style/mp-jd.d.ts
 /**
  * 设置编译到 mp-jd 平台的特定样式，配置项参考 <https://mp-docs.jd.com/doc/miniapp/dev/reference/2595#heading-3>
  *
@@ -1638,6 +1684,8 @@ interface MpJd {
    * 下拉窗口的背景色，不是页面的背景颜色
    *
    * @default "#FFFFFF"
+   *
+   * @format color
    */
   backgroundColor?: HEXColor | ThemeVar;
   /**
@@ -1650,12 +1698,16 @@ interface MpJd {
    * 顶部窗口的背景色，仅 iOS 支持
    *
    * @default "#FFFFFF"
+   *
+   * @format color
    */
   backgroundColorTop?: HEXColor | ThemeVar;
   /**
    * 底部窗口的背景色，仅 iOS 支持
    *
    * @default "#FFFFFF"
+   *
+   * @format color
    */
   backgroundColorBottom?: HEXColor | ThemeVar;
   /**
@@ -1673,7 +1725,7 @@ interface MpJd {
   [x: string]: any;
 }
 //#endregion
-//#region src/global-style/mp-kuaishou.d.ts
+//#region src/style/mp-kuaishou.d.ts
 /**
  * 设置编译到 mp-kuaishou 平台的特定样式，配置项参考 <https://mp.kuaishou.com/docs/develop/frame/config/conf_appjson.html#window>
  *
@@ -1685,7 +1737,7 @@ interface MpKuaishou {
   /**
    * 导航栏背景颜色，支持 HEX 颜色
    *
-   * @default "#000000"
+   * @default "#ffffff"
    *
    * @format color
    */
@@ -1714,6 +1766,8 @@ interface MpKuaishou {
    * 窗口的背景色，支持 HEX 颜色
    *
    * @default "#FFFFFF"
+   *
+   * @format color
    */
   backgroundColor?: HEXColor | ThemeVar;
   /**
@@ -1726,12 +1780,16 @@ interface MpKuaishou {
    * 顶部窗口的背景色，仅 iOS 支持
    *
    * @default "#FFFFFF"
+   *
+   * @format color
    */
   backgroundColorTop?: HEXColor | ThemeVar;
   /**
    * 底部窗口的背景色，仅 iOS 支持
    *
    * @default "#FFFFFF"
+   *
+   * @format color
    */
   backgroundColorBottom?: HEXColor | ThemeVar;
   /**
@@ -1761,7 +1819,7 @@ interface MpKuaishou {
   [x: string]: any;
 }
 //#endregion
-//#region src/global-style/mp-lark.d.ts
+//#region src/style/mp-lark.d.ts
 /**
  * 设置编译到 mp-lark 平台的特定样式，配置项参考 <https://open.feishu.cn/document/client-docs/gadget/introduction/global-settings#a172b7dd>
  *
@@ -1826,6 +1884,8 @@ interface MpLark {
    * @desc iOS, Android, PC(3.14.0+)
    *
    * @default "#FFFFFF"
+   *
+   * @format color
    */
   backgroundColor?: HEXColor | ThemeVar;
   /**
@@ -1842,6 +1902,8 @@ interface MpLark {
    * @desc iOS
    *
    * @default "#FFFFFF"
+   *
+   * @format color
    */
   backgroundColorTop?: HEXColor | ThemeVar;
   /**
@@ -1850,6 +1912,8 @@ interface MpLark {
    * @desc iOS
    *
    * @default "#FFFFFF"
+   *
+   * @format color
    */
   backgroundColorBottom?: HEXColor | ThemeVar;
   /**
@@ -1870,12 +1934,14 @@ interface MpLark {
   onReachBottomDistance?: number;
   /**
    * PCMode 模式下特定的窗口配置，支持的属性与通用 window 配置属性一致，仅当在 ext 内配置了 defaultPages.PCMode 时生效
+   *
+   * @desc PC(3.14.0+)
    */
   PCMode?: Omit<MpLark, 'PCMode'>;
   [x: string]: any;
 }
 //#endregion
-//#region src/global-style/mp-qq.d.ts
+//#region src/style/mp-qq.d.ts
 /**
  * 设置编译到 mp-qq 平台的特定样式，配置项参考 <https://q.qq.com/wiki/develop/miniprogram/frame/dispose.html#window>
  *
@@ -1916,6 +1982,8 @@ interface MpQq {
    * 窗口的背景色，支持 HEX 颜色
    *
    * @default "#FFFFFF"
+   *
+   * @format color
    */
   backgroundColor?: HEXColor | ThemeVar;
   /**
@@ -1928,12 +1996,16 @@ interface MpQq {
    * 顶部窗口的背景色，仅 iOS 支持
    *
    * @default "#FFFFFF"
+   *
+   * @format color
    */
   backgroundColorTop?: HEXColor | ThemeVar;
   /**
    * 底部窗口的背景色，仅 iOS 支持
    *
    * @default "#FFFFFF"
+   *
+   * @format color
    */
   backgroundColorBottom?: HEXColor | ThemeVar;
   /**
@@ -1963,7 +2035,7 @@ interface MpQq {
   [x: string]: any;
 }
 //#endregion
-//#region src/global-style/mp-toutiao.d.ts
+//#region src/style/mp-toutiao.d.ts
 /**
  * 设置编译到 mp-toutiao 平台的特定样式，配置项参考 <https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/framework/general-configuration#window>
  *
@@ -1991,7 +2063,13 @@ interface MpToutiao {
    */
   navigationBarTitleText?: string;
   /**
-   * 导航栏样式
+   * 导航栏样式，导航栏样式，仅支持 "default" / "custom"
+   *
+   * custom 模式可自定义导航栏，具体效果样式效果参照 [页面自定义结构文档](https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/open-capacity/basic-capacities/custom-page-structure/)
+   *
+   * 具体申请入口在[「控制台」-「我的应用」](https://developer.open-douyin.com/console?type=1)-「具体小程序」-「能力」-「互动能力」中完成自定义导航栏权限申请
+   *
+   * 注意：custom 需要申请权限，否则会阻碍代码包上传，2022 年 5 月 23 日会强制变动，详细参考[获取小程序页面结构自定义能力规范](https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/operation/platform-capabilities/custom-page-structure/custom/)
    *
    * "default" 默认样式
    *
@@ -2004,6 +2082,8 @@ interface MpToutiao {
    * 窗口的背景色，支持 HEX 颜色
    *
    * @default "#FFFFFF"
+   *
+   * @format color
    */
   backgroundColor?: HEXColor | ThemeVar;
   /**
@@ -2016,12 +2096,16 @@ interface MpToutiao {
    * 顶部窗口的背景色，仅 iOS 支持
    *
    * @default 同 backgroundColor
+   *
+   * @format color
    */
   backgroundColorTop?: HEXColor | ThemeVar;
   /**
    * 底部窗口的背景色，仅 iOS 支持
    *
    * @default 同 backgroundColor
+   *
+   * @format color
    */
   backgroundColorBottom?: HEXColor | ThemeVar;
   /**
@@ -2151,9 +2235,9 @@ interface MpToutiao {
   [x: string]: any;
 }
 //#endregion
-//#region src/global-style/mp-weixin.d.ts
+//#region src/style/mp-weixin.d.ts
 /**
- * 设置编译到 mp-weixin 平台的特定样式，配置项参考 [MP-WEIXIN](https://uniapp.dcloud.net.cn/collocation/pages#mp-weixin) 和 <https://developers.weixin.qq.com/miniprogram/dev/reference/configuration/app.html#window>
+ * 设置编译到 mp-weixin 平台的特定样式，配置项参考 <https://developers.weixin.qq.com/miniprogram/dev/reference/configuration/app.html#window>
  *
  * 相应的类型是 MpWeixin
  *
@@ -2185,7 +2269,13 @@ interface MpWeixin {
    *
    * "custom" 自定义导航栏，只保留右上角胶囊按钮
    *
-   * @desc iOS / Android 微信客户端 6.6.0，Windows 微信客户端不支持
+   * @desc iOS / Android 微信客户端 6.6.0，Windows / Mac 微信基础库 3.6.1
+   *
+   * @desc iOS/Android 客户端 7.0.0 以下版本，navigationStyle 只在 app.json 中生效
+   *
+   * @desc iOS/Android 客户端 6.7.2 版本开始，navigationStyle: custom 对 web-view 组件无效
+   *
+   * @desc 开启 custom 后，低版本客户端需要做好兼容。开发者工具基础库版本切到 1.7.0（不代表最低版本，只供调试用）可方便切到旧视觉
    *
    * @default "default"
    */
@@ -2202,6 +2292,8 @@ interface MpWeixin {
    * 窗口的背景色，支持 HEX 颜色
    *
    * @default "#FFFFFF"
+   *
+   * @format color
    */
   backgroundColor?: HEXColor | ThemeVar;
   /**
@@ -2216,6 +2308,8 @@ interface MpWeixin {
    * @desc 微信客户端 6.5.16
    *
    * @default "#FFFFFF"
+   *
+   * @format color
    */
   backgroundColorTop?: HEXColor | ThemeVar;
   /**
@@ -2224,6 +2318,8 @@ interface MpWeixin {
    * @desc 微信客户端 6.5.16
    *
    * @default "#FFFFFF"
+   *
+   * @format color
    */
   backgroundColorBottom?: HEXColor | ThemeVar;
   /**
@@ -2293,9 +2389,9 @@ interface MpWeixin {
   [x: string]: any;
 }
 //#endregion
-//#region src/global-style/mp-xhs.d.ts
+//#region src/style/mp-xhs.d.ts
 /**
- * 设置编译到 mp-xhs 平台的特定样式，配置项参考 <https://miniapp.xiaohongshu.com/doc/DC813994>
+ * 设置编译到 mp-xhs 平台的特定样式，配置项参考 <https://miniapp.xiaohongshu.com/doc/DC813994#anchorId-window>>
  *
  * 相应的类型是 MpXhs
  *
@@ -2334,6 +2430,8 @@ interface MpXhs {
    * 窗口的背景色，支持 HEX 颜色
    *
    * @default "#FFFFFF"
+   *
+   * @format color
    */
   backgroundColor?: HEXColor | ThemeVar;
   /**
@@ -2369,8 +2467,11 @@ interface MpXhs {
   [x: string]: any;
 }
 //#endregion
-//#region src/global-style/index.d.ts
-interface GlobalStyle {
+//#region src/style/index.d.ts
+/**
+ * globalStyle 与 pageStyle 共有的配置项
+ */
+interface BaseStyle {
   /**
    * 导航栏背景颜色（同状态栏背景色），支持 HEX 颜色
    *
@@ -2383,23 +2484,12 @@ interface GlobalStyle {
    * 导航栏标题颜色及状态栏前景颜色，仅支持 "black" / "white"
    *
    * @default "black"
-   *
-   * @desc 支付宝小程序不支持，请使用 my.setNavigationBar
    */
   'navigationBarTextStyle'?: 'black' | 'white' | ThemeVar;
   /**
    * 导航栏标题文字内容
    */
   'navigationBarTitleText'?: string;
-  /**
-   * 导航栏阴影
-   */
-  'navigationBarShadow'?: {
-    /**
-     * 阴影颜色
-     */
-    colorType?: 'grey' | 'blue' | 'green' | 'orange' | 'red' | 'yellow';
-  };
   /**
    * 导航栏样式，仅支持 "default" / "custom"
    *
@@ -2441,21 +2531,21 @@ interface GlobalStyle {
    */
   'onReachBottomDistance'?: number;
   /**
-   * 顶部窗口的背景色（bounce回弹区域）
+   * 顶部窗口的背景色（bounce 回弹区域），支持 HEX 颜色
    *
    * @default "#ffffff"
    *
-   * @desc iOS
+   * @desc 仅 iOS 平台
    *
    * @format color
    */
   'backgroundColorTop'?: HEXColor | ThemeVar;
   /**
-   * 底部窗口的背景色（bounce回弹区域）
+   * 底部窗口的背景色（bounce 回弹区域），支持 HEX 颜色
    *
    * @default "#ffffff"
    *
-   * @desc iOS
+   * @desc 仅 iOS 平台
    *
    * @format color
    */
@@ -2469,7 +2559,7 @@ interface GlobalStyle {
    */
   'titleImage'?: string;
   /**
-   * 导航栏整体（前景、背景）透明设置，仅支持 "always" / "auto" / "none
+   * 导航栏整体（前景、背景）透明设置，仅支持 "always" / "auto" / "none"
    *
    * "always" 一直透明
    *
@@ -2498,52 +2588,6 @@ interface GlobalStyle {
    * @desc 支付宝小程序
    */
   'allowsBounceVertical'?: 'YES' | 'NO';
-  /**
-   * 横屏配置，屏幕旋转设置，仅支持 "auto" / "portrait" / "landscape"，详见 [响应显示区域变化](https://developers.weixin.qq.com/miniprogram/dev/framework/view/resizable.html)
-   *
-   * "auto" 自动
-   *
-   * "portrait" 竖屏
-   *
-   * "landscape" 横屏
-   *
-   * @default "portrait"
-   *
-   * @desc App 2.4.7+、微信小程序、QQ小程序
-   */
-  'pageOrientation'?: 'auto' | 'portrait' | 'landscape';
-  /**
-   * 窗口显示的动画效果，详见 [窗口动画](https://uniapp.dcloud.net.cn/api/router#animation)
-   *
-   * @default "pop-in"
-   *
-   * @desc App
-   */
-  'animationType'?: AnimationType;
-  /**
-   * 窗口显示动画的持续时间，单位为 ms
-   *
-   * @default 300
-   *
-   * @desc App
-   */
-  'animationDuration'?: number;
-  /**
-   * 设置为 true 则页面整体不能上下滚动（bounce 效果），只在页面配置中有效，在 globalStyle 中设置无效
-   *
-   * @default false
-   *
-   * @desc 微信小程序（iOS）、百度小程序（iOS）
-   */
-  'disableScroll'?: boolean;
-  /**
-   * 是否禁用滑动返回
-   *
-   * @default false
-   *
-   * @desc App-iOS（3.4.0+）
-   */
-  'disableSwipeBack'?: boolean;
   /**
    * 设置编译到 App 平台的特定样式，配置项参考 [app-plus](https://uniapp.dcloud.net.cn/collocation/pages#app-plus)
    *
@@ -2569,7 +2613,7 @@ interface GlobalStyle {
    */
   'h5'?: H5;
   /**
-   * 设置编译到 mp-alipay 平台的特定样式，配置项参考 [MP-ALIPAY](https://uniapp.dcloud.net.cn/collocation/pages#mp-alipay) 和 <https://opendocs.alipay.com/mini/framework/app-json#window>
+   * 设置编译到 mp-alipay 平台的特定样式，配置项参考 [MP-ALIPAY](https://uniapp.dcloud.net.cn/collocation/pages#mp-alipay)
    *
    * 相应的类型是 MpAlipay
    *
@@ -2577,7 +2621,7 @@ interface GlobalStyle {
    */
   'mp-alipay'?: MpAlipay;
   /**
-   * 设置编译到 mp-weixin 平台的特定样式，配置项参考 [MP-WEIXIN](https://uniapp.dcloud.net.cn/collocation/pages#mp-weixin) 和 <https://developers.weixin.qq.com/miniprogram/dev/reference/configuration/app.html#window>
+   * 设置编译到 mp-weixin 平台的特定样式，配置项参考 [MP-WEIXIN](https://uniapp.dcloud.net.cn/collocation/pages#mp-weixin)
    *
    * 相应的类型是 MpWeixin
    *
@@ -2585,7 +2629,7 @@ interface GlobalStyle {
    */
   'mp-weixin'?: MpWeixin;
   /**
-   * 设置编译到 mp-baidu 平台的特定样式，配置项参考 [MP-BAIDU](https://uniapp.dcloud.net.cn/collocation/pages.html#mp-baidu) 和 <https://smartprogram.baidu.com/docs/develop/framework/process/#window>
+   * 设置编译到 mp-baidu 平台的特定样式，配置项参考 [MP-BAIDU](https://uniapp.dcloud.net.cn/collocation/pages.html#mp-baidu)
    *
    * 相应的类型是 MpBaidu
    *
@@ -2593,7 +2637,7 @@ interface GlobalStyle {
    */
   'mp-baidu'?: MpBaidu;
   /**
-   * 设置编译到 mp-toutiao 平台的特定样式，配置项参考 <https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/framework/general-configuration#window>
+   * 设置编译到 mp-toutiao 平台的特定样式
    *
    * 相应的类型是 MpToutiao
    *
@@ -2654,12 +2698,6 @@ interface GlobalStyle {
    * @desc App、微信小程序、支付宝小程序、百度小程序、京东小程序
    */
   'usingComponents'?: Record<string, string>;
-  /**
-   * 同层渲染，webrtc（实时音视频）无法正常时尝试配置为 "seperated" 强制关掉同层渲染
-   *
-   * @desc 微信小程序
-   */
-  'renderingMode'?: string;
   /**
    * 当存在 leftWindow 时，默认是否显示 leftWindow，详见 [topWindow](https://uniapp.dcloud.net.cn/collocation/pages.html#topwindow)
    *
@@ -2684,6 +2722,65 @@ interface GlobalStyle {
    * @desc H5
    */
   'rightWindow'?: boolean;
+  /**
+   * 当浏览器可见区域宽度大于 maxWidth 时两侧留白，当小于等于 maxWidth 时页面铺满，单位为 px
+   *
+   * 不同页面支持配置不同的 maxWidth
+   *
+   * maxWidth = leftWindow（可选）+ page（页面主体）+ rightWindow（可选）
+   *
+   * 使用时，页面内 fixed 元素需要使用 --window-left 和 --window-right 来保证布局位置正确
+   *
+   * @desc H5（2.9.9+）
+   */
+  'maxWidth'?: number;
+}
+/**
+ * globalStyle 节点的类型，用于设置应用的状态栏、导航条、标题、窗口背景色等
+ */
+interface GlobalStyle extends BaseStyle {
+  /**
+   * 页面容器背景色，支持 HEX 颜色
+   *
+   * @desc App、H5、小程序
+   *
+   * @format color
+   */
+  backgroundColorContent?: HEXColor | ThemeVar;
+  /**
+   * 横屏配置，屏幕旋转设置，仅支持 "auto" / "portrait" / "landscape"，详见 [响应显示区域变化](https://developers.weixin.qq.com/miniprogram/dev/framework/view/resizable.html)
+   *
+   * "auto" 自动
+   *
+   * "portrait" 竖屏
+   *
+   * "landscape" 横屏
+   *
+   * @default "portrait"
+   */
+  pageOrientation?: 'auto' | 'portrait' | 'landscape';
+  /**
+   * 窗口显示的动画效果，详见 [窗口动画](https://uniapp.dcloud.net.cn/api/router#animation)
+   *
+   * @default "pop-in"
+   *
+   * @desc App
+   */
+  animationType?: AnimationType;
+  /**
+   * 窗口显示动画的持续时间，单位为 ms
+   *
+   * @default 300
+   *
+   * @desc App
+   */
+  animationDuration?: number;
+  /**
+   * 同层渲染，webrtc（实时音视频）无法正常时尝试配置为 "seperated" 强制关掉同层渲染
+   *
+   * @desc 微信小程序
+   */
+  renderingMode?: string;
   /**
    * rpx 计算所支持的最大设备宽度，单位为 px
    *
@@ -2691,7 +2788,7 @@ interface GlobalStyle {
    *
    * @desc App（vue2 且不含 nvue）、H5（2.8.12+）
    */
-  'rpxCalcMaxDeviceWidth'?: number;
+  rpxCalcMaxDeviceWidth?: number;
   /**
    * rpx 计算使用的基准设备宽度，设备实际宽度超出 rpx 计算所支持的最大设备宽度时将按基准宽度计算，单位为 px
    *
@@ -2699,7 +2796,7 @@ interface GlobalStyle {
    *
    * @desc App（vue2 且不含 nvue）、H5（2.8.12+）
    */
-  'rpxCalcBaseDeviceWidth'?: number;
+  rpxCalcBaseDeviceWidth?: number;
   /**
    * rpx 计算特殊处理的值，始终按实际的设备宽度计算，单位为 rpx
    *
@@ -2707,30 +2804,161 @@ interface GlobalStyle {
    *
    * @desc App（vue2 且不含 nvue）、H5（2.8.12+）
    */
-  'rpxCalcIncludeWidth'?: number;
+  rpxCalcIncludeWidth?: number;
   /**
    * 是否使用动态 rpx，屏幕大小变化会重新渲染 rpx
    *
    * @default false
    *
-   * @desc App-nvue（vue3 固定值为 true） 3.2.13+
+   * @desc App-nvue（vue3 固定值为 true） 3.2.13+、App 5.0+
    */
-  'dynamicRpx'?: boolean;
+  dynamicRpx?: boolean;
+  [x: string]: any;
+}
+/**
+ * pages 每个页面 style 节点的类型，用于设置每个页面的状态栏、导航条、标题、窗口背景色等
+ *
+ * 页面中配置项会覆盖 globalStyle 中相同的配置项
+ */
+interface PageStyle extends BaseStyle {
   /**
-   * 当浏览器可见区域宽度大于 maxWidth 时两侧留白，当小于等于 maxWidth 时页面铺满，单位为 px
+   * 导航栏阴影，配置参考 [导航栏阴影](https://uniapp.dcloud.net.cn/collocation/pages#navigationbarshadow)
    *
-   * 不同页面支持配置不同的 maxWidth
+   * 微信/百度/头条小程序需要配置: "disableScroll": true
    *
-   * maxWidth = leftWindow（可选）+ page（页面主体）+ rightWindow（可选）
+   * 支付宝小程序需要配置 "allowsBounceVertical": "NO"
+   */
+  navigationBarShadow?: {
+    /**
+     * 阴影颜色
+     *
+     * 支持 grey、blue、green、orange、red、yellow
+     */
+    colorType?: 'grey' | 'blue' | 'green' | 'orange' | 'red' | 'yellow';
+  };
+  /**
+   * 设置为 true 则页面整体不能上下滚动（bounce 效果），只在页面配置中有效，在 globalStyle 中设置无效
    *
-   * 使用时，页面内 fixed 元素需要使用 --window-left 和 --window-right 来保证布局位置正确
+   * @default false
    *
-   * @desc H5（2.9.9+）
+   * @desc 微信小程序（iOS）、百度小程序（iOS）
    */
-  'maxWidth'?: number;
+  disableScroll?: boolean;
+  /**
+   * 是否禁用滑动返回
+   *
+   * @default false
+   *
+   * @desc App-iOS（3.4.0+）
+   */
+  disableSwipeBack?: boolean;
   [x: string]: any;
 }
 //#endregion
+//#region src/pages.d.ts
+/**
+ * @deprecated 请使用 Page
+ *
+ * pages 数组的元素类型
+ */
+interface PageMetaDatum {
+  /**
+   * 配置页面路径
+   */
+  path: string;
+  /**
+   * 配置页面窗口表现，配置项参考 [pageStyle](https://uniapp.dcloud.net.cn/collocation/pages#style)
+   */
+  style?: PageStyle;
+  /**
+   * 当前页面是否需要登录才可以访问，此配置优先级高于 uniIdRouter 下的 needLogin
+   *
+   * @default false
+   */
+  needLogin?: boolean;
+  [x: string]: any;
+}
+/**
+ * pages 数组的元素类型
+ */
+interface PageItem {
+  /**
+   * 配置页面路径
+   */
+  path: string;
+  /**
+   * 配置页面窗口表现，配置项参考 [pageStyle](https://uniapp.dcloud.net.cn/collocation/pages#style)
+   */
+  style?: PageStyle;
+  /**
+   * 当前页面是否需要登录才可以访问，此配置优先级高于 uniIdRouter 下的 needLogin
+   *
+   * @default false
+   */
+  needLogin?: boolean;
+  [x: string]: any;
+}
+/**
+ * 设置页面路径及窗口表现
+ *
+ * 文档中为必填，类型上保持可选，插件可由文件扫描自动生成
+ */
+type Pages = PageItem[];
+//#endregion
+//#region src/preload-rule.d.ts
+/**
+ * 进入页面后预下载分包的规则
+ */
+interface PreloadRuleItem {
+  /**
+   * 进入页面后预下载分包的 root 或 name
+   *
+   * __APP__ 表示主包
+   */
+  packages: string[];
+  /**
+   * 在指定网络下预下载
+   *
+   * "all" 不限网络
+   *
+   * "wifi" 仅 wifi 下预下载
+   *
+   * @default "wifi"
+   */
+  network?: 'all' | 'wifi';
+  [x: string]: any;
+}
+/**
+ * 分包预下载规则
+ *
+ * @desc 微信小程序、QQ 小程序、抖音小程序、支付宝小程序、京东小程序
+ */
+type PreloadRule = Record<string, PreloadRuleItem>;
+//#endregion
+//#region src/sub-packages.d.ts
+/**
+ * subPackages 数组的元素类型，即应用的子包
+ */
+interface SubPackage {
+  /**
+   * 子包的根目录
+   */
+  root: string;
+  /**
+   * 子包由哪些页面组成，参数同 pages
+   */
+  pages: Pages;
+  /**
+   * 子包的插件
+   */
+  plugins?: Record<string, any>;
+  [x: string]: any;
+}
+/**
+ * 分包加载配置，H5 不支持
+ */
+type SubPackages = SubPackage[];
+//#endregion
 //#region src/tab-bar.d.ts
 interface TabBarIconFont {
   /**
@@ -2747,10 +2975,14 @@ interface TabBarIconFont {
   fontSize?: string;
   /**
    * 字体图标颜色
+   *
+   * @format color
    */
   color?: HEXColor;
   /**
    * 字体图标选中颜色
+   *
+   * @format color
    */
   selectedColor?: HEXColor;
   [x: string]: any;
@@ -2770,6 +3002,9 @@ interface TabBarItem {
    * 当 position 为 "top" 时，此参数无效
    *
    * 不支持网络图片，不支持字体图标
+   *
+   * 支持 `@xxx` 主题变量：微信小程序 darkmode（themeLocation）下可按主题切换图标，
+   * uni-app 会原样透传该字段（官方文档表格只标注 String，但 darkmode 场景依赖主题变量）
    */
   iconPath?: string | ThemeVar;
   /**
@@ -2778,10 +3013,14 @@ interface TabBarItem {
    * 当 position 为 "top" 时，此参数无效
    *
    * 不支持网络图片，不支持字体图标
+   *
+   * 支持 `@xxx` 主题变量，同 iconPath 的 darkmode 说明
    */
   selectedIconPath?: string | ThemeVar;
   /**
-   * 该项是否显示，默认显示
+   * 该项是否显示
+   *
+   * @default true
    *
    * @desc App (3.2.10+)、H5 (3.2.10+)
    */
@@ -2796,7 +3035,7 @@ interface TabBarItem {
 }
 interface TabBarMidButton {
   /**
-   * 中间按钮的宽度，tabBar 其它项为减去此宽度后平分，默认值为与其它项平分宽度
+   * 中间按钮的宽度，tabBar 其它项为减去此宽度后平分
    *
    * @default "80px"
    */
@@ -2833,6 +3072,9 @@ interface TabBarMidButton {
   iconfont?: TabBarIconFont;
   [x: string]: any;
 }
+/**
+ * 设置底部 tab 的表现
+ */
 interface TabBar {
   /**
    * tab 上的文字默认颜色
@@ -2857,13 +3099,13 @@ interface TabBar {
    *
    * @default "black"
    *
-   * @desc App 2.3.4+、H5 3.0.0+
+   * @desc App 2.3.4+、H5 3.0.0+、微信小程序、小红书小程序、京东小程序
    *
    * @format color
    */
   borderStyle?: 'black' | 'white' | HEXColor | ThemeVar;
   /**
-   * iOS 高斯模糊效果，参考 [使用说明](https://ask.dcloud.net.cn/article/36617)
+   * iOS 高斯模糊效果，参考 [使用说明](https://uniapp.dcloud.net.cn/tutorial/app-blureffect.html)
    *
    * @default "none"
    *
@@ -2930,6 +3172,8 @@ interface TabBar {
   iconfontSrc?: string;
   /**
    * 设置背景图片，优先级高于 backgroundColor
+   *
+   * @desc App
    */
   backgroundImage?: string;
   /**
@@ -2944,11 +3188,15 @@ interface TabBar {
    * "no-repeat" 背景图片在垂直方向和水平方向都拉伸
    *
    * @default "no-repeat"
+   *
+   * @desc App
    */
   backgroundRepeat?: 'no-repeat' | 'repeat' | 'repeat-x' | 'repeat-y';
   /**
    * tabBar上红点颜色
    *
+   * @desc App
+   *
    * @format color
    */
   redDotColor?: string;
@@ -2973,99 +3221,21 @@ interface TabBar {
   [x: string]: any;
 }
 //#endregion
-//#region src/page-meta.d.ts
-interface PageMetaDatum {
-  /**
-   * 配置页面路径
-   */
-  path: string;
-  type?: string;
-  /**
-   * 配置页面窗口表现，配置项参考下方 pageStyle
-   */
-  style?: GlobalStyle;
-  /**
-   * 当前页面是否需要登录才可以访问，此配置优先级高于 uniIdRouter 下的 needLogin
-   */
-  needLogin?: boolean;
-  [x: string]: any;
-}
-type ExcludeIndexSignature<T> = { [K in keyof T as string extends K ? never : number extends K ? never : K]: T[K] };
-interface SubPageMetaDatum {
-  /**
-   * 子包的根目录
-   */
-  root: string;
-  /**
-   * 子包由哪些页面组成
-   */
-  pages: PageMetaDatum[];
-  /**
-   * 子包插件
-   */
-  plugins?: {
-    [pluginName: string]: {
-      version: string;
-      provider: string;
-      export?: string;
-      [key: string]: any;
-    };
-  };
-}
-interface UserTabBarItem extends Partial<TabBarItem> {
-  /**
-   * 配置页面路径
-   * @deprecated 可选，将会根据文件路径自动生成
-   */
-  pagePath?: string;
-  /**
-   * 排序，数字越小越靠前
-   */
-  index?: number;
-}
-interface UserPageMeta extends Partial<PageMetaDatum> {
-  /**
-   * 配置页面路径
-   * @deprecated 可选，将会根据文件路径自动生成
-   */
-  path?: string;
-  /**
-   * 底部 tabBar 的子项 [tabBar](https://uniapp.dcloud.net.cn/collocation/pages#tabBar)
-   */
-  tabBar?: UserTabBarItem;
-  [x: string]: any;
-}
-type MaybePromise<T> = T | Promise<T>;
-type MaybeCallable<T> = T | (() => T);
-type MaybePromiseCallable<T> = T | (() => T) | (() => Promise<T>);
-declare function definePage(options: MaybePromiseCallable<UserPageMeta>): void;
-type DefinePage = typeof definePage;
-//#endregion
-//#region src/sub-packages.d.ts
-interface SubPackage {
-  /**
-   * 子包的根目录
-   */
-  root: string;
-  /**
-   * 子包由哪些页面组成，参数同 pages
-   */
-  pages: PageMetaDatum[];
+//#region src/the-window.d.ts
+/**
+ * 配置显示该窗口的规则
+ */
+interface MatchMedia {
   /**
-   * 分包插件
+   * 当设备可见区域宽度 >= minWidth 时，显示该 window
+   *
+   * @default 768
    */
-  plugins?: {
-    [pluginName: string]: {
-      version: string;
-      provider: string;
-      export?: string;
-      [key: string]: any;
-    };
-  };
+  minWidth?: number;
 }
-type SubPackages = SubPackage[];
-//#endregion
-//#region src/the-window.d.ts
+/**
+ * leftWindow / topWindow / rightWindow 的类型
+ */
 interface TheWindow {
   /**
    * 配置页面路径
@@ -3074,43 +3244,43 @@ interface TheWindow {
   /**
    * 配置页面窗口表现，配置项参考 [pageStyle](https://uniapp.dcloud.net.cn/collocation/pages#style)
    */
-  style?: GlobalStyle;
+  style?: PageStyle;
   /**
    * 配置显示该窗口的规则，配置项参考 [matchMedia](https://uniapp.dcloud.net.cn/collocation/pages#matchmedia)
    */
-  matchMedia?: {
-    /**
-     * 当设备可见区域宽度 >= minWidth 时，显示该 window
-     *
-     * @default 768
-     */
-    minWidth?: number;
-  };
+  matchMedia?: MatchMedia;
+  [x: string]: any;
 }
 //#endregion
 //#region src/uni-id-router.d.ts
+/**
+ * 自动跳转相关配置，新增于 HBuilderX 3.5.0
+ *
+ * @desc uni-app 3.5.0+、uni-app-x 3.99+
+ */
 interface UniIdRouter {
   /**
    * 登录页面路径
    *
    * @example "pages/index/index"
    */
-  loginPage: string;
+  loginPage?: string;
   /**
-   * 需要登录才可以访问的页面列表，可以使用正则语法
+   * 需要登录才可访问的页面列表，可以使用正则语法
    *
    * @example ["pages/detail/.*"]
    */
-  needLogin: string[];
+  needLogin?: string[];
   /**
-   * 是否是否自动解析云对象及 clientDB 的错误码，如果是客户端 token 不正确或 token 过期则自动跳转配置的登录页面
+   * 是否自动解析云对象及 clientDB 的错误码，如果是客户端 token 不正确或 token 过期则自动跳转配置的登录页面，
    *
    * @default true
    */
   resToLogin?: boolean;
+  [x: string]: any;
 }
 //#endregion
-//#region src/pages-config.d.ts
+//#region src/config.d.ts
 /**
  * 对 uni-app 进行全局配置，决定页面文件的路径、窗口样式、原生的导航栏、底部的原生 tabBar 等，类似微信小程序中 app.json 的页面管理部分
  *
@@ -3123,8 +3293,10 @@ interface PagesConfig {
   globalStyle?: GlobalStyle;
   /**
    * 设置页面路径及窗口表现
+   *
+   * 文档中为必填，类型上保持可选，插件可由文件扫描自动生成
    */
-  pages?: PageMetaDatum[];
+  pages?: Pages;
   /**
    * 组件自动引入规则
    *
@@ -3148,45 +3320,18 @@ interface PagesConfig {
   /**
    * 分包预下载规则
    *
-   * @desc 微信小程序
+   * @desc 微信小程序、QQ 小程序、抖音小程序、支付宝小程序、京东小程序
    */
-  preloadRule?: {
-    /**
-     * 页面路径
-     */
-    [path: string]: {
-      /**
-       * 进入页面后预下载分包的 root 或 name
-       *
-       * __APP__ 表示主包
-       */
-      packages: string[];
-      /**
-       * 在指定网络下预下载
-       *
-       * "all" 不限网络
-       *
-       * "wifi" 仅 wifi 下预下载
-       *
-       * @default "wifi"
-       */
-      network?: 'all' | 'wifi';
-    };
-  };
+  preloadRule?: PreloadRule;
   /**
-   * `Worker` 代码放置的目录
+   * worker 代码目录
    *
-   * @desc 微信小程序
+   * @desc 微信小程序、支付宝小程序
    */
   workers?: string | {
-    /**
-     * `Worker` 代码放置的目录
-     */
     path: string;
     /**
-     * 是否打包为分包
-     *
-     * @desc 微信小程序基础库 v2.27.3
+     * 是否把 worker 打包为分包
      *
      * @default false
      */
@@ -3226,4 +3371,4 @@ interface PagesConfig {
 }
 interface UserPagesConfig extends PagesConfig {}
 //#endregion
-export { AnimationType, type AppHarmony, type AppPlus, Color, Condition, ConditionItem, DefinePage, EasyCom, ExcludeIndexSignature, GlobalStyle, type H5, HEXColor, MaybeCallable, MaybePromise, MaybePromiseCallable, type MpAlipay, type MpBaidu, type MpHarmony, type MpJd, type MpKuaishou, type MpLark, type MpQq, type MpToutiao, type MpWeixin, type MpXhs, PageMetaDatum, PagesConfig, PercentageSize, PxSize, RGBAColor, RGBColor, RpxSize, SubPackage, SubPackages, SubPageMetaDatum, TabBar, TabBarIconFont, TabBarItem, TabBarMidButton, TheWindow, ThemeVar, TitleNViewButton, UniIdRouter, UserPageMeta, UserPagesConfig, UserTabBarItem, definePage };
+export { AnimationType, type AppHarmony, type AppPlus, Color, Condition, ConditionItem, ConditionList, ConditionListItem, EasyCom, GlobalStyle, type H5, HEXColor, MatchMedia, type MpAlipay, type MpBaidu, type MpHarmony, type MpJd, type MpKuaishou, type MpLark, type MpQq, type MpToutiao, type MpWeixin, type MpXhs, PageItem, PageMetaDatum, PageStyle, Pages, PagesConfig, PercentageSize, PreloadRule, PreloadRuleItem, PxSize, RGBAColor, RGBColor, RpxSize, SubPackage, SubPackages, TabBar, TabBarIconFont, TabBarItem, TabBarMidButton, TheWindow, ThemeVar, TitleNViewButton, UniIdRouter, UserPagesConfig };