@uni-helper/vite-plugin-uni-pages 0.3.2 → 0.3.4

package/dist/index.d.cts

@@ -1,9 +1,11 @@
 import { Logger, ViteDevServer, Plugin } from 'vite';
-import { LoadConfigSource } from 'unconfig';
 import { CommentJSONValue } from 'comment-json';
+import { LoadConfigSource } from 'unconfig';
 import { FSWatcher } from 'chokidar';
+import { SFCParseOptions, SFCDescriptor, SFCBlock } from '@vue/compiler-sfc';
+import * as t from '@babel/types';
+import babelGenerator from '@babel/generator';
 import Debug from 'debug';
-import { SFCBlock, SFCDescriptor } from '@vue/compiler-sfc';
 
 interface ConditionItem {
     /**
@@ -154,130 +156,6 @@ interface TitleNViewButton {
     width?: PxSize | 'auto';
 }
 
-interface H5 {
-    /**
-     * 导航栏，详见 [导航栏](https://uniapp.dcloud.net.cn/collocation/pages#h5-titlenview)
-     */
-    titleNView?: false | {
-        /**
-         * 背景颜色，支持 HEX 颜色
-         *
-         * @default "#F7F7F7"
-         *
-         * @format color
-         */
-        backgroundColor?: HEXColor;
-        /**
-         * 自定义按钮，详见 [自定义按钮](https://uniapp.dcloud.net.cn/collocation/pages#app-titlenview-buttons)
-         */
-        buttons?: TitleNViewButton[];
-        /**
-         * 标题文字颜色，支持 HEX 颜色
-         *
-         * @default "#000000"
-         *
-         * @format color
-         */
-        titleColor?: HEXColor;
-        /**
-         * 标题文字内容
-         */
-        titleText?: string;
-        /**
-         * 标题文字大小
-         */
-        titleSize?: string;
-        /**
-         * 导航栏样式
-         *
-         * "default" 默认样式
-         *
-         * "transparent" 滚动透明渐变
-         *
-         * @default "default"
-         */
-        type?: 'default' | 'transparent';
-        /**
-         * 导航栏上的搜索框配置，详见 [searchInput](https://uniapp.dcloud.net.cn/collocation/pages#h5-searchinput)
-         *
-         * @desc 1.6.5
-         */
-        searchInput?: {
-            /**
-             * 是否自动获取焦点
-             *
-             * @default false
-             */
-            autoFocus?: boolean;
-            /**
-             * 非输入状态下文本的对齐方式
-             *
-             * "left" 居左对齐
-             *
-             * "right" 居右对齐
-             *
-             * "center" 居中对齐
-             *
-             * @default "center"
-             */
-            align?: 'center' | 'left' | 'right';
-            /**
-             * 背景颜色，支持 HEX 和 RGBA 颜色
-             *
-             * @default "rgba(255,255,255,0.5)"
-             *
-             * @format color
-             */
-            backgroundColor?: HEXColor | RGBAColor;
-            /**
-             * 输入框的圆角半径，单位为 px
-             *
-             * @default "0px"
-             */
-            borderRadius?: PxSize;
-            /**
-             * 提示文本
-             */
-            placeholder?: string;
-            /**
-             * 提示文本颜色，支持 HEX 颜色
-             *
-             * @default "#CCCCCC"
-             *
-             * @format color
-             */
-            placeholderColor?: HEXColor;
-            /**
-             * 是否禁止输入
-             *
-             * @default false
-             */
-            disabled?: boolean;
-            [x: string]: any;
-        };
-        [x: string]: any;
-    };
-    /**
-     * 下拉刷新，详见 [下拉刷新](https://uniapp.dcloud.net.cn/collocation/pages#h5-pulltorefresh)
-     */
-    pullToRefresh?: {
-        /**
-         * 下拉刷新控件颜色，支持 HEX 颜色
-         *
-         * @default "#2BD009"
-         */
-        color?: HEXColor;
-        /**
-         * 下拉刷新控件起始位置，支持支持单位为 px 的逻辑像素值或百分比
-         *
-         * @default "0px"
-         */
-        offset?: PxSize | PercentageSize;
-        [x: string]: any;
-    };
-    [x: string]: any;
-}
-
 interface AppPlus {
     /**
      * 窗体背景色，支持 HEX 颜色
@@ -1312,6 +1190,130 @@ interface AppPlus {
     [x: string]: any;
 }
 
+interface H5 {
+    /**
+     * 导航栏，详见 [导航栏](https://uniapp.dcloud.net.cn/collocation/pages#h5-titlenview)
+     */
+    titleNView?: false | {
+        /**
+         * 背景颜色，支持 HEX 颜色
+         *
+         * @default "#F7F7F7"
+         *
+         * @format color
+         */
+        backgroundColor?: HEXColor;
+        /**
+         * 自定义按钮，详见 [自定义按钮](https://uniapp.dcloud.net.cn/collocation/pages#app-titlenview-buttons)
+         */
+        buttons?: TitleNViewButton[];
+        /**
+         * 标题文字颜色，支持 HEX 颜色
+         *
+         * @default "#000000"
+         *
+         * @format color
+         */
+        titleColor?: HEXColor;
+        /**
+         * 标题文字内容
+         */
+        titleText?: string;
+        /**
+         * 标题文字大小
+         */
+        titleSize?: string;
+        /**
+         * 导航栏样式
+         *
+         * "default" 默认样式
+         *
+         * "transparent" 滚动透明渐变
+         *
+         * @default "default"
+         */
+        type?: 'default' | 'transparent';
+        /**
+         * 导航栏上的搜索框配置，详见 [searchInput](https://uniapp.dcloud.net.cn/collocation/pages#h5-searchinput)
+         *
+         * @desc 1.6.5
+         */
+        searchInput?: {
+            /**
+             * 是否自动获取焦点
+             *
+             * @default false
+             */
+            autoFocus?: boolean;
+            /**
+             * 非输入状态下文本的对齐方式
+             *
+             * "left" 居左对齐
+             *
+             * "right" 居右对齐
+             *
+             * "center" 居中对齐
+             *
+             * @default "center"
+             */
+            align?: 'center' | 'left' | 'right';
+            /**
+             * 背景颜色，支持 HEX 和 RGBA 颜色
+             *
+             * @default "rgba(255,255,255,0.5)"
+             *
+             * @format color
+             */
+            backgroundColor?: HEXColor | RGBAColor;
+            /**
+             * 输入框的圆角半径，单位为 px
+             *
+             * @default "0px"
+             */
+            borderRadius?: PxSize;
+            /**
+             * 提示文本
+             */
+            placeholder?: string;
+            /**
+             * 提示文本颜色，支持 HEX 颜色
+             *
+             * @default "#CCCCCC"
+             *
+             * @format color
+             */
+            placeholderColor?: HEXColor;
+            /**
+             * 是否禁止输入
+             *
+             * @default false
+             */
+            disabled?: boolean;
+            [x: string]: any;
+        };
+        [x: string]: any;
+    };
+    /**
+     * 下拉刷新，详见 [下拉刷新](https://uniapp.dcloud.net.cn/collocation/pages#h5-pulltorefresh)
+     */
+    pullToRefresh?: {
+        /**
+         * 下拉刷新控件颜色，支持 HEX 颜色
+         *
+         * @default "#2BD009"
+         */
+        color?: HEXColor;
+        /**
+         * 下拉刷新控件起始位置，支持支持单位为 px 的逻辑像素值或百分比
+         *
+         * @default "0px"
+         */
+        offset?: PxSize | PercentageSize;
+        [x: string]: any;
+    };
+    [x: string]: any;
+}
+
 /**
  * 设置编译到 mp-alipay 平台的特定样式，配置项参考 [MP-ALIPAY](https://uniapp.dcloud.net.cn/collocation/pages#mp-alipay) 和 <https://opendocs.alipay.com/mini/framework/app-json#window>
  *
@@ -1422,13 +1424,13 @@ interface 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-baidu 平台的特定样式，配置项参考 [MP-BAIDU](https://uniapp.dcloud.net.cn/collocation/pages.html#mp-baidu) 和 <https://smartprogram.baidu.com/docs/develop/framework/process/#window>
  *
- * 相应的类型是 MpWeixin
+ * 相应的类型是 MpBaidu
  *
- * @desc 微信小程序
+ * @desc 百度小程序
  */
-interface MpWeixin {
+interface MpBaidu {
     /**
      * 导航栏背景颜色，支持 HEX 颜色
      *
@@ -1454,19 +1456,11 @@ interface MpWeixin {
      *
      * "custom" 自定义导航栏，只保留右上角胶囊按钮
      *
-     * @desc iOS / Android 微信客户端 6.6.0，Windows 微信客户端不支持
+     * @desc 2.10.34
      *
      * @default "default"
      */
     navigationStyle?: 'default' | 'custom';
-    /**
-     * 在非首页、非页面栈最底层页面或非 tabbar 内页面中的导航栏展示 home 键
-     *
-     * @desc 微信客户端 8.0.24
-     *
-     * @default false
-     */
-    homeButton?: boolean;
     /**
      * 窗口的背景色，支持 HEX 颜色
      *
@@ -1482,94 +1476,64 @@ interface MpWeixin {
     /**
      * 顶部窗口的背景色，仅 iOS 支持
      *
-     * @desc 微信客户端 6.5.16
-     *
      * @default "#FFFFFF"
      */
     backgroundColorTop?: HEXColor | ThemeVar;
     /**
      * 底部窗口的背景色，仅 iOS 支持
      *
-     * @desc 微信客户端 6.5.16
-     *
      * @default "#FFFFFF"
      */
     backgroundColorBottom?: HEXColor | ThemeVar;
     /**
-     * 是否开启全局的下拉刷新，详见 [Page.onPullDownRefresh](https://developers.weixin.qq.com/miniprogram/dev/reference/api/Page.html#onpulldownrefresh)
+     * 是否开启全局的下拉刷新
      *
      * @default false
      */
     enablePullDownRefresh?: boolean;
     /**
-     * 页面上拉触底事件触发时距页面底部距离，单位为 px，详见 [Page.onReachBottom](https://developers.weixin.qq.com/miniprogram/dev/reference/api/Page.html#onreachbottom)
+     * 页面上拉触底事件触发时距页面底部距离，单位为 px
      *
      * @default 50
      */
     onReachBottomDistance?: number;
     /**
-     * 屏幕旋转设置，支持 auto / portrait / landscape，详见 [响应显示区域变化](https://developers.weixin.qq.com/miniprogram/dev/framework/view/resizable.html)
-     *
-     * "auto" 自动
-     *
-     * "portrait" 竖屏
-     *
-     * "landscape" 横屏
-     *
-     * @desc [2.4.0](https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html) (auto) / [2.5.0](https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html) (landscape)
-     *
-     * @default "portrait"
-     */
-    pageOrientation?: 'auto' | 'portrait' | 'landscape';
-    /**
-     * 重新启动策略配置
-     *
-     * "homePage" 如果从这个页面退出小程序，下次将从首页冷启动
-     *
-     * "homePageAndLatestPage" 如果从这个页面退出小程序，下次冷启动后立刻加载这个页面，页面的参数保持不变（不可用于 tab 页）
+     * 小程序页面是否禁止响应字体大小的设置
      *
-     * @desc [2.8.0](https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html)
-     */
-    restartStrategy?: 'homePage' | 'homePageAndLatestPage';
-    /**
-     * 页面初始渲染缓存配置，详见 [初始渲染缓存](https://developers.weixin.qq.com/miniprogram/dev/framework/view/initial-rendering-cache.html)
+     * "auto" 默认响应
      *
-     * @desc [2.11.1](https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html)
-     */
-    initialRenderingCache?: 'static' | 'dynamic';
-    /**
-     * 切入系统后台时，隐藏页面内容，保护用户隐私
+     * "none" 不响应
      *
-     * @desc [2.15.0](https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html)
+     * @desc 基础库版本 3.200.1
      *
-     * @default "none"
+     * @default "auto"
      */
-    visualEffectInBackground?: 'hidden' | 'none';
+    textSizeAdjust?: 'auto' | 'none';
     /**
-     * 控制预加载下个页面的时机，详见 [控制预加载下个页面的时机](https://developers.weixin.qq.com/miniprogram/dev/framework/performance/tips/runtime_nav.html#_2-4-%E6%8E%A7%E5%88%B6%E9%A2%84%E5%8A%A0%E8%BD%BD%E4%B8%8B%E4%B8%AA%E9%A1%B5%E9%9D%A2%E7%9A%84%E6%97%B6%E6%9C%BA)
+     * 屏幕旋转设置，支持 auto / portrait / landscape
      *
-     * "static" 在当前页面 onReady 触发 200ms 后触发预加载
+     * "auto" 自动
      *
-     * "auto" 渲染线程空闲时进行预加载，由基础库根据一段时间内 requestAnimationFrame 的触发频率算法判断
+     * "portrait" 竖屏
      *
-     * "manual" 由开发者通过调用 [wx.preloadWebview](https://developers.weixin.qq.com/miniprogram/dev/api/base/performance/wx.preloadWebview.html) 触发，开发者可以在页面主要内容的 setData 结束后手动触发
+     * "landscape" 横屏
      *
-     * @desc [2.15.0](https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html)
+     * @desc 基础库版本 3.450.8，web 化暂不支持
      *
-     * @default "static"
+     * @default "portrait"
      */
-    handleWebviewPreload?: 'static' | 'manual' | 'auto';
+    pageOrientation?: 'auto' | 'portrait' | 'landscape';
     [x: string]: any;
 }
 
 /**
- * 设置编译到 mp-baidu 平台的特定样式，配置项参考 [MP-BAIDU](https://uniapp.dcloud.net.cn/collocation/pages.html#mp-baidu) 和 <https://smartprogram.baidu.com/docs/develop/framework/process/#window>
+ * 设置编译到 mp-jd 平台的特定样式，配置项参考 <https://mp-docs.jd.com/doc/dev/framework/504#heading-3>
  *
- * 相应的类型是 MpBaidu
+ * 相应的类型是 MpJd
  *
- * @desc 百度小程序
+ * @desc 京东小程序
  */
-interface MpBaidu {
+interface MpJd {
     /**
      * 导航栏背景颜色，支持 HEX 颜色
      *
@@ -1595,13 +1559,11 @@ interface MpBaidu {
      *
      * "custom" 自定义导航栏，只保留右上角胶囊按钮
      *
-     * @desc 2.10.34
-     *
      * @default "default"
      */
     navigationStyle?: 'default' | 'custom';
     /**
-     * 窗口的背景色，支持 HEX 颜色
+     * 下拉窗口的背景色，不是页面的背景颜色
      *
      * @default "#FFFFFF"
      */
@@ -1625,54 +1587,22 @@ interface MpBaidu {
      */
     backgroundColorBottom?: HEXColor | ThemeVar;
     /**
-     * 是否开启全局的下拉刷新
+     * 是否开启全局的下拉刷新，详见 [Page.onPullDownRefresh](https://mp-docs.jd.com/doc/dev/framework/520#heading-10)
      *
      * @default false
      */
     enablePullDownRefresh?: boolean;
-    /**
-     * 页面上拉触底事件触发时距页面底部距离，单位为 px
-     *
-     * @default 50
-     */
-    onReachBottomDistance?: number;
-    /**
-     * 小程序页面是否禁止响应字体大小的设置
-     *
-     * "auto" 默认响应
-     *
-     * "none" 不响应
-     *
-     * @desc 基础库版本 3.200.1
-     *
-     * @default "auto"
-     */
-    textSizeAdjust?: 'auto' | 'none';
-    /**
-     * 屏幕旋转设置，支持 auto / portrait / landscape
-     *
-     * "auto" 自动
-     *
-     * "portrait" 竖屏
-     *
-     * "landscape" 横屏
-     *
-     * @desc 基础库版本 3.450.8，web 化暂不支持
-     *
-     * @default "portrait"
-     */
-    pageOrientation?: 'auto' | 'portrait' | 'landscape';
     [x: string]: any;
 }
 
 /**
- * 设置编译到 mp-toutiao 平台的特定样式，配置项参考 <https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/framework/general-configuration#window>
+ * 设置编译到 mp-kuaishou 平台的特定样式，配置项参考 <https://mp.kuaishou.com/docs/develop/frame/config/conf_appjson.html#window>
  *
- * 相应的类型是 MpToutiao
+ * 相应的类型是 MpKuaishou
  *
- * @desc 抖音小程序
+ * @desc 快手小程序
  */
-interface MpToutiao {
+interface MpKuaishou {
     /**
      * 导航栏背景颜色，支持 HEX 颜色
      *
@@ -1682,7 +1612,7 @@ interface MpToutiao {
      */
     navigationBarBackgroundColor?: HEXColor | ThemeVar;
     /**
-     * 导航栏标题颜色，同时影响标题颜色、右胶囊颜色、左返回箭头颜色
+     * 导航栏标题、状态栏颜色
      *
      * @default "white"
      */
@@ -1716,139 +1646,39 @@ interface MpToutiao {
     /**
      * 顶部窗口的背景色，仅 iOS 支持
      *
-     * @default 同 backgroundColor
+     * @default "#FFFFFF"
      */
     backgroundColorTop?: HEXColor | ThemeVar;
     /**
      * 底部窗口的背景色，仅 iOS 支持
      *
-     * @default 同 backgroundColor
+     * @default "#FFFFFF"
      */
     backgroundColorBottom?: HEXColor | ThemeVar;
     /**
-     * 是否开启全局的下拉刷新
+     * 是否开启全局的下拉刷新，详见 [Page.onPullDownRefresh](https://mp.kuaishou.com/docs/develop/frame/page/page_page.html#onpulldownrefresh)
      *
      * @default false
      */
     enablePullDownRefresh?: boolean;
     /**
-     * 页面上拉触底事件触发时距页面底部距离，单位为 px
+     * 页面上拉触底事件触发时距页面底部距离，单位为 px，详见 [Page.onReachBottom](https://mp.kuaishou.com/docs/develop/frame/page/page_page.html#onreachbottom)
      *
      * @default 50
      */
     onReachBottomDistance?: number;
     /**
-     * 仅在 navigationStyle 为 "default" 时生效，用来控制导航栏透明设置
-     *
-     * "always" 一直透明
+     * 屏幕旋转设置，支持 auto / portrait / landscape，详见 [响应显示区域变化](https://developers.weixin.qq.com/miniprogram/dev/framework/view/resizable.html)
      *
-     * "auto" 滑动自适应
+     * "auto" 自动
      *
-     * "none" 不透明
+     * "portrait" 竖屏
      *
-     * @default "none"
-     */
-    transparentTitle?: 'always' | 'auto' | 'none';
-    /**
-     * 框架骨架屏配置，仅支持配置 config 属性，优先级高于 app.json，详见 [小程序框架骨架屏](https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/guide/experience-optimization/list/skeleton)
+     * "landscape" 横屏
      *
-     * @desc 2.47.0
+     * @default "portrait"
      */
-    skeleton?: {
-        /**
-         * 包含超时移除及自动生成配置等
-         */
-        config?: {
-            /**
-             * 设置骨架屏超时移除时间，单位为 ms，为 0 时关闭超时移除
-             *
-             * @default 2000
-             */
-            timeout?: number;
-            /**
-             * 骨架屏显示时的动画
-             *
-             * @default 'spin'
-             */
-            loading?: 'spin' | 'chiaroscuro' | 'shine';
-            /**
-             * 骨架页面中图片块配置
-             *
-             * @default { shape: 'rect', color: '#efefef' }
-             */
-            image?: {
-                /**
-                 * 骨架页面中图片块形状
-                 *
-                 * circle 圆形
-                 *
-                 * rect 矩形
-                 *
-                 * @default "rect"
-                 */
-                shape?: 'circle' | 'rect';
-                /**
-                 * 骨架页面中图片块颜色，支持 HEX 颜色
-                 *
-                 * @default "#efefef"
-                 *
-                 * @format color
-                 */
-                color?: HEXColor;
-                [x: string]: any;
-            };
-            /**
-             * 骨架页面中被视为按钮块的配置
-             *
-             * @default { color: '#efefef }
-             */
-            button?: {
-                /**
-                 * 骨架页面中被视为按钮块的颜色，支持 HEX 颜色
-                 *
-                 * @default "#efefef"
-                 *
-                 * @format color
-                 */
-                color?: HEXColor;
-                [x: string]: any;
-            };
-            /**
-             * 骨架屏背景色，支持 HEX 颜色
-             *
-             * @default "#fff"
-             *
-             * @format color
-             */
-            backgroundColor?: HEXColor;
-            /**
-             * 默认为使用绝对定位占满全屏
-             *
-             * 当对自定义组件使用，作为局部加载的样式时，可设置为 "auto"，高度随内容高度撑开
-             *
-             * @default "fullscreen"
-             */
-            mode?: 'fullscreen' | 'auto';
-            /**
-             * CSS单位，元素绝对定位都使用 "vw" 与 "vh"
-             *
-             * @default "vw"
-             */
-            cssUnit?: 'px' | 'rem' | 'vw' | 'vh' | 'vmin' | 'vmax';
-            /**
-             * 生成骨架屏页面中 css 值保留的小数点位数，默认为 4
-             *
-             * @default 4
-             */
-            decimal?: number;
-            [x: string]: any;
-        };
-        /**
-         * 页面路径同骨架屏文件的对应关系
-         */
-        page?: Record<string, string>;
-        [x: string]: any;
-    };
+    pageOrientation?: 'auto' | 'portrait' | 'landscape';
     [x: string]: any;
 }
 
@@ -2047,13 +1877,13 @@ interface MpQq {
 }
 
 /**
- * 设置编译到 mp-kuaishou 平台的特定样式，配置项参考 <https://mp.kuaishou.com/docs/develop/frame/config/conf_appjson.html#window>
+ * 设置编译到 mp-toutiao 平台的特定样式，配置项参考 <https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/framework/general-configuration#window>
  *
- * 相应的类型是 MpKuaishou
+ * 相应的类型是 MpToutiao
  *
- * @desc 快手小程序
+ * @desc 抖音小程序
  */
-interface MpKuaishou {
+interface MpToutiao {
     /**
      * 导航栏背景颜色，支持 HEX 颜色
      *
@@ -2063,7 +1893,7 @@ interface MpKuaishou {
      */
     navigationBarBackgroundColor?: HEXColor | ThemeVar;
     /**
-     * 导航栏标题、状态栏颜色
+     * 导航栏标题颜色，同时影响标题颜色、右胶囊颜色、左返回箭头颜色
      *
      * @default "white"
      */
@@ -2097,50 +1927,150 @@ interface MpKuaishou {
     /**
      * 顶部窗口的背景色，仅 iOS 支持
      *
-     * @default "#FFFFFF"
+     * @default 同 backgroundColor
      */
     backgroundColorTop?: HEXColor | ThemeVar;
     /**
      * 底部窗口的背景色，仅 iOS 支持
      *
-     * @default "#FFFFFF"
+     * @default 同 backgroundColor
      */
     backgroundColorBottom?: HEXColor | ThemeVar;
     /**
-     * 是否开启全局的下拉刷新，详见 [Page.onPullDownRefresh](https://mp.kuaishou.com/docs/develop/frame/page/page_page.html#onpulldownrefresh)
+     * 是否开启全局的下拉刷新
      *
      * @default false
      */
     enablePullDownRefresh?: boolean;
     /**
-     * 页面上拉触底事件触发时距页面底部距离，单位为 px，详见 [Page.onReachBottom](https://mp.kuaishou.com/docs/develop/frame/page/page_page.html#onreachbottom)
+     * 页面上拉触底事件触发时距页面底部距离，单位为 px
      *
      * @default 50
      */
     onReachBottomDistance?: number;
     /**
-     * 屏幕旋转设置，支持 auto / portrait / landscape，详见 [响应显示区域变化](https://developers.weixin.qq.com/miniprogram/dev/framework/view/resizable.html)
+     * 仅在 navigationStyle 为 "default" 时生效，用来控制导航栏透明设置
      *
-     * "auto" 自动
+     * "always" 一直透明
      *
-     * "portrait" 竖屏
+     * "auto" 滑动自适应
      *
-     * "landscape" 横屏
+     * "none" 不透明
      *
-     * @default "portrait"
+     * @default "none"
      */
-    pageOrientation?: 'auto' | 'portrait' | 'landscape';
+    transparentTitle?: 'always' | 'auto' | 'none';
+    /**
+     * 框架骨架屏配置，仅支持配置 config 属性，优先级高于 app.json，详见 [小程序框架骨架屏](https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/guide/experience-optimization/list/skeleton)
+     *
+     * @desc 2.47.0
+     */
+    skeleton?: {
+        /**
+         * 包含超时移除及自动生成配置等
+         */
+        config?: {
+            /**
+             * 设置骨架屏超时移除时间，单位为 ms，为 0 时关闭超时移除
+             *
+             * @default 2000
+             */
+            timeout?: number;
+            /**
+             * 骨架屏显示时的动画
+             *
+             * @default 'spin'
+             */
+            loading?: 'spin' | 'chiaroscuro' | 'shine';
+            /**
+             * 骨架页面中图片块配置
+             *
+             * @default { shape: 'rect', color: '#efefef' }
+             */
+            image?: {
+                /**
+                 * 骨架页面中图片块形状
+                 *
+                 * circle 圆形
+                 *
+                 * rect 矩形
+                 *
+                 * @default "rect"
+                 */
+                shape?: 'circle' | 'rect';
+                /**
+                 * 骨架页面中图片块颜色，支持 HEX 颜色
+                 *
+                 * @default "#efefef"
+                 *
+                 * @format color
+                 */
+                color?: HEXColor;
+                [x: string]: any;
+            };
+            /**
+             * 骨架页面中被视为按钮块的配置
+             *
+             * @default { color: '#efefef }
+             */
+            button?: {
+                /**
+                 * 骨架页面中被视为按钮块的颜色，支持 HEX 颜色
+                 *
+                 * @default "#efefef"
+                 *
+                 * @format color
+                 */
+                color?: HEXColor;
+                [x: string]: any;
+            };
+            /**
+             * 骨架屏背景色，支持 HEX 颜色
+             *
+             * @default "#fff"
+             *
+             * @format color
+             */
+            backgroundColor?: HEXColor;
+            /**
+             * 默认为使用绝对定位占满全屏
+             *
+             * 当对自定义组件使用，作为局部加载的样式时，可设置为 "auto"，高度随内容高度撑开
+             *
+             * @default "fullscreen"
+             */
+            mode?: 'fullscreen' | 'auto';
+            /**
+             * CSS单位，元素绝对定位都使用 "vw" 与 "vh"
+             *
+             * @default "vw"
+             */
+            cssUnit?: 'px' | 'rem' | 'vw' | 'vh' | 'vmin' | 'vmax';
+            /**
+             * 生成骨架屏页面中 css 值保留的小数点位数，默认为 4
+             *
+             * @default 4
+             */
+            decimal?: number;
+            [x: string]: any;
+        };
+        /**
+         * 页面路径同骨架屏文件的对应关系
+         */
+        page?: Record<string, string>;
+        [x: string]: any;
+    };
     [x: string]: any;
 }
 
 /**
- * 设置编译到 mp-jd 平台的特定样式，配置项参考 <https://mp-docs.jd.com/doc/dev/framework/504#heading-3>
+ * 设置编译到 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>
  *
- * 相应的类型是 MpJd
+ * 相应的类型是 MpWeixin
  *
- * @desc 京东小程序
+ * @desc 微信小程序
  */
-interface MpJd {
+interface MpWeixin {
     /**
      * 导航栏背景颜色，支持 HEX 颜色
      *
@@ -2166,11 +2096,21 @@ interface MpJd {
      *
      * "custom" 自定义导航栏，只保留右上角胶囊按钮
      *
+     * @desc iOS / Android 微信客户端 6.6.0，Windows 微信客户端不支持
+     *
      * @default "default"
      */
     navigationStyle?: 'default' | 'custom';
     /**
-     * 下拉窗口的背景色，不是页面的背景颜色
+     * 在非首页、非页面栈最底层页面或非 tabbar 内页面中的导航栏展示 home 键
+     *
+     * @desc 微信客户端 8.0.24
+     *
+     * @default false
+     */
+    homeButton?: boolean;
+    /**
+     * 窗口的背景色，支持 HEX 颜色
      *
      * @default "#FFFFFF"
      */
@@ -2184,21 +2124,83 @@ interface MpJd {
     /**
      * 顶部窗口的背景色，仅 iOS 支持
      *
+     * @desc 微信客户端 6.5.16
+     *
      * @default "#FFFFFF"
      */
     backgroundColorTop?: HEXColor | ThemeVar;
     /**
      * 底部窗口的背景色，仅 iOS 支持
      *
+     * @desc 微信客户端 6.5.16
+     *
      * @default "#FFFFFF"
      */
     backgroundColorBottom?: HEXColor | ThemeVar;
     /**
-     * 是否开启全局的下拉刷新，详见 [Page.onPullDownRefresh](https://mp-docs.jd.com/doc/dev/framework/520#heading-10)
+     * 是否开启全局的下拉刷新，详见 [Page.onPullDownRefresh](https://developers.weixin.qq.com/miniprogram/dev/reference/api/Page.html#onpulldownrefresh)
      *
      * @default false
      */
     enablePullDownRefresh?: boolean;
+    /**
+     * 页面上拉触底事件触发时距页面底部距离，单位为 px，详见 [Page.onReachBottom](https://developers.weixin.qq.com/miniprogram/dev/reference/api/Page.html#onreachbottom)
+     *
+     * @default 50
+     */
+    onReachBottomDistance?: number;
+    /**
+     * 屏幕旋转设置，支持 auto / portrait / landscape，详见 [响应显示区域变化](https://developers.weixin.qq.com/miniprogram/dev/framework/view/resizable.html)
+     *
+     * "auto" 自动
+     *
+     * "portrait" 竖屏
+     *
+     * "landscape" 横屏
+     *
+     * @desc [2.4.0](https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html) (auto) / [2.5.0](https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html) (landscape)
+     *
+     * @default "portrait"
+     */
+    pageOrientation?: 'auto' | 'portrait' | 'landscape';
+    /**
+     * 重新启动策略配置
+     *
+     * "homePage" 如果从这个页面退出小程序，下次将从首页冷启动
+     *
+     * "homePageAndLatestPage" 如果从这个页面退出小程序，下次冷启动后立刻加载这个页面，页面的参数保持不变（不可用于 tab 页）
+     *
+     * @desc [2.8.0](https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html)
+     */
+    restartStrategy?: 'homePage' | 'homePageAndLatestPage';
+    /**
+     * 页面初始渲染缓存配置，详见 [初始渲染缓存](https://developers.weixin.qq.com/miniprogram/dev/framework/view/initial-rendering-cache.html)
+     *
+     * @desc [2.11.1](https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html)
+     */
+    initialRenderingCache?: 'static' | 'dynamic';
+    /**
+     * 切入系统后台时，隐藏页面内容，保护用户隐私
+     *
+     * @desc [2.15.0](https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html)
+     *
+     * @default "none"
+     */
+    visualEffectInBackground?: 'hidden' | 'none';
+    /**
+     * 控制预加载下个页面的时机，详见 [控制预加载下个页面的时机](https://developers.weixin.qq.com/miniprogram/dev/framework/performance/tips/runtime_nav.html#_2-4-%E6%8E%A7%E5%88%B6%E9%A2%84%E5%8A%A0%E8%BD%BD%E4%B8%8B%E4%B8%AA%E9%A1%B5%E9%9D%A2%E7%9A%84%E6%97%B6%E6%9C%BA)
+     *
+     * "static" 在当前页面 onReady 触发 200ms 后触发预加载
+     *
+     * "auto" 渲染线程空闲时进行预加载，由基础库根据一段时间内 requestAnimationFrame 的触发频率算法判断
+     *
+     * "manual" 由开发者通过调用 [wx.preloadWebview](https://developers.weixin.qq.com/miniprogram/dev/api/base/performance/wx.preloadWebview.html) 触发，开发者可以在页面主要内容的 setData 结束后手动触发
+     *
+     * @desc [2.15.0](https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html)
+     *
+     * @default "static"
+     */
+    handleWebviewPreload?: 'static' | 'manual' | 'auto';
     [x: string]: any;
 }
 
@@ -2921,12 +2923,32 @@ interface UserPagesConfig extends PagesConfig {
 
 declare function defineUniPages(config: UserPagesConfig): UserPagesConfig;
 
+declare class Page {
+    ctx: PageContext;
+    path: PagePath;
+    private rawOptions;
+    private options;
+    constructor(ctx: PageContext, path: PagePath);
+    getPageMeta(forceUpdate?: boolean): Promise<PageMetaDatum>;
+    hasChanged(): Promise<boolean>;
+    readPageMeta(): Promise<{
+        options: PageMetaDatum;
+        hasChanged: boolean;
+    }>;
+    private readPageMetaFromFile;
+}
+declare function parseSFC(code: string, options?: SFCParseOptions): SFCDescriptor;
+declare function tryPageMetaFromMacro(sfc: SFCDescriptor): Promise<UserPageMeta | undefined>;
+declare function tryPageMetaFromCustomBlock(sfc: SFCDescriptor, routeBlockLang: RouteBlockLang): Promise<UserPageMeta>;
+declare function findMacro(stmts: t.Statement[], filename: string): t.CallExpression | undefined;
+declare function findImports(stmts: t.Statement[]): t.ImportDeclaration[];
+
 declare class PageContext {
     private _server;
     pagesGlobConfig: PagesConfig | undefined;
     pagesConfigSourcePaths: string[];
-    pagesPath: PagePath[];
-    subPagesPath: Record<string, PagePath[]>;
+    pages: Map<string, Page>;
+    subPages: Map<string, Map<string, Page>>;
     pageMetaData: PageMetaDatum[];
     subPageMetaData: SubPageMetaDatum[];
     resolvedPagesJSONPath: string;
@@ -2946,7 +2968,6 @@ declare class PageContext {
     setupViteServer(server: ViteDevServer): void;
     setupWatcher(watcher: FSWatcher): Promise<void>;
     onUpdate(): void;
-    parsePage(page: PagePath): Promise<PageMetaDatum>;
     /**
      * parse pages rules && set page type
      * @param pages page path array
@@ -2954,7 +2975,7 @@ declare class PageContext {
      * @param overrides custom page config
      * @returns pages rules
      */
-    parsePages(pages: PagePath[], type: 'main' | 'sub', overrides?: PageMetaDatum[]): Promise<PageMetaDatum[]>;
+    parsePages(pages: Map<string, Page>, type: 'main' | 'sub', overrides?: PageMetaDatum[]): Promise<PageMetaDatum[]>;
     /**
      * set home page
      * @param result pages rules array
@@ -2980,6 +3001,7 @@ declare const debug: {
     error: Debug.Debugger;
     cache: Debug.Debugger;
     declaration: Debug.Debugger;
+    definePage: Debug.Debugger;
 };
 declare function extsToGlob(extensions: string[]): string;
 declare function isTargetFile(path: string): boolean;
@@ -2989,10 +3011,13 @@ declare function isTargetFile(path: string): boolean;
  * TODO: support merge middleware
  */
 declare function mergePageMetaDataArray(pageMetaData: PageMetaDatum[]): PageMetaDatum[];
-declare function useCachedPages(): {
-    setCache: (filePath: string, routeBlock?: SFCBlock) => void;
-    hasChanged: (filePath: string, routeBlock?: SFCBlock) => Promise<boolean>;
-};
+/**
+ * 执行 TypeScript 代码字符串并返回其返回值
+ * @param code - TypeScript 代码字符串
+ * @returns 返回值
+ */
+declare function execScript(code: string, filename: string): Promise<any>;
+declare const babelGenerate: typeof babelGenerator;
 
 interface CustomBlock {
     attr: Record<string, any>;
@@ -3000,6 +3025,7 @@ interface CustomBlock {
 }
 type debugType = keyof typeof debug;
 type ConfigSource = string | LoadConfigSource<PagesConfig> | LoadConfigSource<PagesConfig>[];
+type RouteBlockLang = 'json5' | 'jsonc' | 'json' | 'yaml' | 'yml';
 interface Options {
     /**
      * Generate TypeScript declaration for pages path
@@ -3049,7 +3075,7 @@ interface Options {
      * Set the default route block parser, or use `<route lang="xxx">` in SFC route block
      * @default 'json5'
      */
-    routeBlockLang: 'json5' | 'jsonc' | 'json' | 'yaml' | 'yml';
+    routeBlockLang: RouteBlockLang;
     /**
      * minify the `pages.json`
      * @default false
@@ -3110,12 +3136,28 @@ interface SubPageMetaDatum {
     root: string;
     pages: PageMetaDatum[];
 }
+interface UserPageMeta extends Partial<PageMetaDatum> {
+    /**
+     * 配置页面路径
+     * @deprecated 可选，将会根据文件路径自动生成
+     */
+    path?: string;
+}
+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;
 
 declare const MODULE_ID_VIRTUAL = "virtual:uni-pages";
 declare const RESOLVED_MODULE_ID_VIRTUAL = "\0virtual:uni-pages";
 declare const OUTPUT_NAME = "pages.json";
 declare const FILE_EXTENSIONS: string[];
 
+declare function parseCustomBlock(block: SFCBlock, filePath: string, routeBlockLang: RouteBlockLang): CustomBlock | undefined;
+declare function getRouteSfcBlock(sfc?: SFCDescriptor): SFCBlock | undefined;
+declare function getRouteBlock(path: string, blockStr: SFCBlock | undefined, routeBlockLang: RouteBlockLang): CustomBlock | undefined;
+
 /**
  * Resolves the files that are valid pages for the given context.
  */
@@ -3130,12 +3172,7 @@ declare function resolveOptions(userOptions: UserOptions, viteRoot?: string): Re
  */
 declare function resolvePageDirs(dir: string, root: string, exclude: string[]): string[];
 
-declare function parseSFC(code: string): Promise<SFCDescriptor>;
-declare function parseCustomBlock(block: SFCBlock, filePath: string, options: ResolvedOptions): CustomBlock | undefined;
-declare function getRouteSfcBlock(path: string): Promise<SFCBlock | undefined>;
-declare function getRouteBlock(path: string, blockStr: SFCBlock | undefined, options: ResolvedOptions): Promise<CustomBlock | undefined>;
-
 declare function VitePluginUniPages(userOptions?: UserOptions): Plugin;
 
-export { FILE_EXTENSIONS, MODULE_ID_VIRTUAL, OUTPUT_NAME, PageContext, RESOLVED_MODULE_ID_VIRTUAL, VitePluginUniPages, checkPagesJsonFile, debug, VitePluginUniPages as default, defineUniPages, extsToGlob, getPageFiles, getRouteBlock, getRouteSfcBlock, invalidatePagesModule, isTargetFile, mergePageMetaDataArray, parseCustomBlock, parseSFC, readFileSync, resolveOptions, resolvePageDirs, useCachedPages, writeFileSync };
-export type { Condition, ConditionItem, ConfigSource, CustomBlock, EasyCom, GlobalStyle, Options, PageMetaDatum, PagePath, PagesConfig, ResolvedOptions, SubPackage, SubPackages, SubPageMetaDatum, TabBar, TabBarIconFont, TabBarItem, TabBarMidButton, TheWindow, UniIdRouter, UserOptions, UserPagesConfig, debugType };
+export { FILE_EXTENSIONS, MODULE_ID_VIRTUAL, OUTPUT_NAME, Page, PageContext, RESOLVED_MODULE_ID_VIRTUAL, VitePluginUniPages, babelGenerate, checkPagesJsonFile, debug, VitePluginUniPages as default, definePage, defineUniPages, execScript, extsToGlob, findImports, findMacro, getPageFiles, getRouteBlock, getRouteSfcBlock, invalidatePagesModule, isTargetFile, mergePageMetaDataArray, parseCustomBlock, parseSFC, readFileSync, resolveOptions, resolvePageDirs, tryPageMetaFromCustomBlock, tryPageMetaFromMacro, writeFileSync };
+export type { Condition, ConditionItem, ConfigSource, CustomBlock, DefinePage, EasyCom, GlobalStyle, MaybeCallable, MaybePromise, MaybePromiseCallable, Options, PageMetaDatum, PagePath, PagesConfig, ResolvedOptions, RouteBlockLang, SubPackage, SubPackages, SubPageMetaDatum, TabBar, TabBarIconFont, TabBarItem, TabBarMidButton, TheWindow, UniIdRouter, UserOptions, UserPageMeta, UserPagesConfig, debugType };