@tarojs/router 4.0.0-beta.87 → 4.0.0-beta.89

package/LICENSE

@@ -154,8 +154,15 @@ See `/LICENSE` for details of the license.
 
 ==================
 
+MIT (stencil-vue2-output-target):
+The following files embed [stencil-vue2-output-target](https://github.com/diondree/stencil-vue2-output-target) MIT:
+`/packages/taro-components-library-vue2/src/vue-component-lib/utils.ts`
+See `/LICENSE` for details of the license.
+
+==================
+
 MIT (weui):
-The following files embed [weui](https://github.com/Tencent/weui) MIT:
+The following files embed [stencil-vue2-output-target](https://github.com/Tencent/weui) MIT:
 `/packages/taro-components/src/components/*.scss`
 See `/LICENSE.txt` for details of the license.
 
@@ -165,10 +172,3 @@ Apache-2.0 (intersection-observer):
 The following files embed [intersection-observer](https://github.com/GoogleChromeLabs/intersection-observer) Apache-2.0:
 `/packages/taro-api/src/polyfill/intersection-observer.ts`
 See `/LICENSE.txt` for details of the license.
-
-==================
-
-MIT (babel-plugin-jsx-dom-expressions):
-The following files embed [babel-plugin-jsx-dom-expressions](https://github.com/ryansolid/dom-expressions/blob/main/packages/babel-plugin-jsx-dom-expressions) MIT:
-`/packages/babel-plugin-transform-solid-jsx/src/*`
-See `/LICENSE` for details of the license.

package/dist/api.d.ts

@@ -1,7 +1,8 @@
 import Taro from '@tarojs/taro';
-export declare function navigateTo(option: Taro.navigateTo.Option): ReturnType<typeof Taro.navigateTo>;
-export declare function redirectTo(option: Taro.redirectTo.Option): ReturnType<typeof Taro.redirectTo>;
-export declare function navigateBack(option?: Taro.navigateBack.Option): ReturnType<typeof Taro.navigateBack>;
-export declare function switchTab(option: Taro.switchTab.Option): ReturnType<typeof Taro.switchTab>;
-export declare function reLaunch(option: Taro.reLaunch.Option): ReturnType<typeof Taro.reLaunch>;
-export declare function getCurrentPages(): Taro.Page[];
+declare function navigateTo(option: Taro.navigateTo.Option): ReturnType<typeof Taro.navigateTo>;
+declare function redirectTo(option: Taro.redirectTo.Option): ReturnType<typeof Taro.redirectTo>;
+declare function navigateBack(option?: Taro.navigateBack.Option): ReturnType<typeof Taro.navigateBack>;
+declare function switchTab(option: Taro.switchTab.Option): ReturnType<typeof Taro.switchTab>;
+declare function reLaunch(option: Taro.reLaunch.Option): ReturnType<typeof Taro.reLaunch>;
+declare function getCurrentPages(): Taro.Page[];
+export { navigateTo, redirectTo, navigateBack, switchTab, reLaunch, getCurrentPages };

package/dist/api.js

@@ -16,14 +16,13 @@ function processNavigateUrl(option) {
         const parts = routesAlias.getOrigin(history.location.pathname).split('/');
         parts.pop();
         pathPieces.pathname.split('/').forEach((item) => {
-            if (item === '.')
+            if (item === '.') {
                 return;
+            }
             item === '..' ? parts.pop() : parts.push(item);
         });
         pathPieces.pathname = parts.join('/');
     }
-    // 确保是 / 开头的路径
-    pathPieces.pathname = addLeadingSlash(pathPieces.pathname);
     // 处理自定义路由
     pathPieces.pathname = routesAlias.getAlias(addLeadingSlash(pathPieces.pathname));
     // 处理 basename
@@ -53,8 +52,21 @@ function navigate(option, method) {
                 if ('url' in option) {
                     const pathPieces = processNavigateUrl(option);
                     const state = { timestamp: Date.now() };
+                    if (pathPieces.pathname) {
+                        const originPath = routesAlias.getOrigin(pathPieces.pathname);
+                        if (!RouterConfig.isPage(addLeadingSlash(originPath)) && !RouterConfig.isPage(addLeadingSlash(pathPieces.pathname))) {
+                            const res = { errMsg: `${method}:fail page ${originPath} is not found` };
+                            fail === null || fail === void 0 ? void 0 : fail(res);
+                            complete === null || complete === void 0 ? void 0 : complete(res);
+                            if (fail || complete) {
+                                return resolve(res);
+                            }
+                            else {
+                                return reject(res);
+                            }
+                        }
+                    }
                     if (method === 'navigateTo') {
-                        // Note: 由于 spa 会针对弱网情况下，短时间内多次跳转同一个页面跳转加了锁，后续如果有用户反馈返回无效，那可能是这个问题
                         history.push(pathPieces, state);
                     }
                     else if (method === 'redirectTo' || method === 'switchTab') {

package/dist/events/resize.d.ts

@@ -1,2 +1,3 @@
-import type { PageInstance } from '@tarojs/runtime';
-export declare function bindPageResize(page: PageInstance): void;
+import { PageInstance } from '@tarojs/runtime';
+declare function bindPageResize(page: PageInstance): void;
+export { bindPageResize };

package/dist/events/scroll.d.ts

@@ -1,2 +1,3 @@
-import type { PageInstance } from '@tarojs/runtime';
-export declare function bindPageScroll(page: PageInstance, scrollEl: HTMLElement | Window, distance?: number): void;
+import { PageInstance } from '@tarojs/runtime';
+declare function bindPageScroll(page: PageInstance, scrollEl: HTMLElement | Window, distance?: number): void;
+export { bindPageScroll };

package/dist/history.d.ts

@@ -1,8 +1,6 @@
-import { Action, createBrowserHistory, createHashHistory } from 'history';
-import type { IH5RouterConfig } from '@tarojs/taro/types/compile';
-import type { Blocker, BrowserHistoryOptions, HashHistoryOptions, History, Listener, Location, Path, To } from 'history';
-import type { StateEvent } from '../types/history';
-export declare let history: History;
+import { IH5RouterConfig } from '@tarojs/taro/types/compile';
+import { StateEvent } from '../types/history';
+declare let history: History;
 declare class MpaHistory implements History {
     action: Action;
     get location(): Location;
@@ -19,8 +17,8 @@ declare class MpaHistory implements History {
     replaceState: globalThis.History['replaceState'];
     eventState(action: Required<StateEvent>['action']): (data: any, unused: string, url?: string | URL | null) => any;
 }
-export declare function setHistory(h: History, base?: string): void;
-export declare function createMpaHistory(_?: HashHistoryOptions | BrowserHistoryOptions): MpaHistory;
-export { createBrowserHistory, createHashHistory };
-export declare function setHistoryMode(mode?: IH5RouterConfig['mode'], base?: string): void;
-export declare function prependBasename(url?: string): string;
+declare function setHistory(h: History, base?: string): void;
+declare function createMpaHistory(_?: HashHistoryOptions | BrowserHistoryOptions): MpaHistory;
+declare function setHistoryMode(mode?: IH5RouterConfig['mode'], base?: string): void;
+declare function prependBasename(url?: string): string;
+export { history, setHistory, createMpaHistory, createBrowserHistory, createHashHistory, setHistoryMode, prependBasename };

package/dist/index.cjs.d.ts

@@ -0,0 +1,66 @@
+import { Action, createBrowserHistory, createHashHistory, Blocker, BrowserHistoryOptions, HashHistoryOptions, History, Listener, Location, Path, To } from "history";
+import { IH5RouterConfig } from "@tarojs/taro/types/compile";
+import { StateEvent } from "../types/history";
+import { MpaRouterConfig, SpaRouterConfig } from '../types/router';
+import Taro from "@tarojs/taro";
+import { AppInstance } from "@tarojs/runtime";
+import { MpaRouterConfig as MpaRouterConfig$0 } from "../../types/router";
+import { SpaRouterConfig as SpaRouterConfig$0 } from "../../types/router";
+declare let history: History;
+declare class MpaHistory implements History {
+    action: Action;
+    get location(): Location;
+    createHref(_to: To): string;
+    parseUrl(to: Partial<Path>): string;
+    push(to: Partial<Path>, _state?: Record<string, unknown>): void;
+    replace(to: Partial<Path>, _state?: Record<string, unknown>): void;
+    go(delta: number): void;
+    back: () => void;
+    forward: () => void;
+    listen(listener: Listener): () => void;
+    block(_blocker: Blocker): () => void;
+    pushState: globalThis.History["pushState"];
+    replaceState: globalThis.History["replaceState"];
+    eventState(action: Required<StateEvent>["action"]): (data: any, unused: string, url?: string | URL | null) => any;
+}
+declare function setHistory(h: History, base?: string): void;
+declare function createMpaHistory(_?: HashHistoryOptions | BrowserHistoryOptions): MpaHistory;
+declare function setHistoryMode(mode?: IH5RouterConfig["mode"], base?: string): void;
+declare function prependBasename(url?: string): string;
+declare function navigateTo(option: Taro.navigateTo.Option): ReturnType<typeof Taro.navigateTo>;
+declare function redirectTo(option: Taro.redirectTo.Option): ReturnType<typeof Taro.redirectTo>;
+declare function navigateBack(option?: Taro.navigateBack.Option): ReturnType<typeof Taro.navigateBack>;
+declare function switchTab(option: Taro.switchTab.Option): ReturnType<typeof Taro.switchTab>;
+declare function reLaunch(option: Taro.reLaunch.Option): ReturnType<typeof Taro.reLaunch>;
+declare function getCurrentPages(): Taro.Page[];
+// TODO 支持多路由 (APP 生命周期仅触发一次)
+/** Note: 关于多页面应用
+ * - 需要配置路由映射（根目录跳转、404 页面……）
+ * - app.onPageNotFound 事件不支持
+ * - 应用生命周期可能多次触发
+ * - TabBar 会多次加载
+ * - 不支持路由动画
+ */
+declare function createMultiRouter(history: History, app: AppInstance, config: MpaRouterConfig$0, framework?: string): Promise<void>;
+declare function createRouter(history: History, app: AppInstance, config: SpaRouterConfig$0, framework?: string): () => void;
+declare class RoutesAlias {
+    conf: Array<string[]>;
+    set(customRoutes?: Record<string, string | string[]>): void;
+    getConfig: (url?: string) => string[];
+    getOrigin: (url?: string) => string;
+    getAlias: (url?: string) => string;
+    getAll: (url?: string) => string[];
+}
+declare const routesAlias: RoutesAlias;
+declare const isWeixin: () => boolean;
+declare const isDingTalk: () => boolean;
+declare function setMpaTitle(title: string): void;
+declare function setTitle(title: string): void;
+declare function setNavigationBarStyle(option: {
+    backgroundColor: string;
+    frontColor: string;
+}): void;
+declare function setNavigationBarLoading(loading: boolean): void;
+declare function handleAppMount(config: SpaRouterConfig | MpaRouterConfig, _: History, appId?: string): void;
+declare function handleAppMountWithTabbar(config: SpaRouterConfig | MpaRouterConfig, history: History, appId?: string): void;
+export { navigateTo, redirectTo, navigateBack, switchTab, reLaunch, getCurrentPages, history, setHistory, createMpaHistory, createBrowserHistory, createHashHistory, setHistoryMode, prependBasename, createMultiRouter, createRouter, routesAlias, isWeixin, isDingTalk, setMpaTitle, setTitle, setNavigationBarStyle, setNavigationBarLoading, handleAppMount, handleAppMountWithTabbar };

package/dist/index.cjs.js

@@ -15,8 +15,7 @@ var UniversalRouter = require('universal-router');
 function loadAnimateStyle(ms = 300) {
     const css = `
 body {
-  /* 防止 iOS 页面滚动 */
-  overflow: hidden;
+  overflow: hidden; // 防止 iOS 页面滚动
 }
 .taro_router > .taro_page {
   position: absolute;
@@ -73,9 +72,8 @@ ${enableTabBar ? `
   }
 
 ` : ''}
-  .taro_page_shade:has(+.taro_page_stationed),
-  .taro_page_shade.taro_tabbar_page,
-  .taro_router > .taro_page.taro_page_show.taro_page_stationed:not(.taro_page_shade):not(.taro_tabbar_page):not(:last-child):has(+.taro_page_stationed) {
+  .taro_page_shade,
+  .taro_router > .taro_page.taro_page_show.taro_page_stationed:not(.taro_page_shade):not(.taro_tabbar_page):not(:last-child) {
     display: none;
   }
 `;
@@ -143,7 +141,7 @@ function loadNavigationBarStyle() {
     to {
       transform: rotate(360deg);
     }
-  }
+  }  
 
   .taro-navigation-bar-no-icon > .taro-navigation-bar-home {
     display: none;
@@ -265,9 +263,8 @@ class RouterConfig {
         return this.router.mode || 'hash';
     }
     static get customRoutes() { return this.router.customRoutes || {}; }
-    // 这个方法不考虑 basename 和 customRoutes，只判断原始的 url 是否在 pages 中
     static isPage(url = '') {
-        return this.pages.findIndex(e => runtime.addLeadingSlash(e) === url) !== -1;
+        return this.pages.findIndex(e => prependBasename(e) === url) !== -1;
     }
 }
 
@@ -536,14 +533,13 @@ function processNavigateUrl(option) {
         const parts = routesAlias.getOrigin(exports.history.location.pathname).split('/');
         parts.pop();
         pathPieces.pathname.split('/').forEach((item) => {
-            if (item === '.')
+            if (item === '.') {
                 return;
+            }
             item === '..' ? parts.pop() : parts.push(item);
         });
         pathPieces.pathname = parts.join('/');
     }
-    // 确保是 / 开头的路径
-    pathPieces.pathname = runtime.addLeadingSlash(pathPieces.pathname);
     // 处理自定义路由
     pathPieces.pathname = routesAlias.getAlias(runtime.addLeadingSlash(pathPieces.pathname));
     // 处理 basename
@@ -573,8 +569,21 @@ function navigate(option, method) {
                 if ('url' in option) {
                     const pathPieces = processNavigateUrl(option);
                     const state = { timestamp: Date.now() };
+                    if (pathPieces.pathname) {
+                        const originPath = routesAlias.getOrigin(pathPieces.pathname);
+                        if (!RouterConfig.isPage(runtime.addLeadingSlash(originPath)) && !RouterConfig.isPage(runtime.addLeadingSlash(pathPieces.pathname))) {
+                            const res = { errMsg: `${method}:fail page ${originPath} is not found` };
+                            fail === null || fail === void 0 ? void 0 : fail(res);
+                            complete === null || complete === void 0 ? void 0 : complete(res);
+                            if (fail || complete) {
+                                return resolve(res);
+                            }
+                            else {
+                                return reject(res);
+                            }
+                        }
+                    }
                     if (method === 'navigateTo') {
-                        // Note: 由于 spa 会针对弱网情况下，短时间内多次跳转同一个页面跳转加了锁，后续如果有用户反馈返回无效，那可能是这个问题
                         exports.history.push(pathPieces, state);
                     }
                     else if (method === 'redirectTo' || method === 'switchTab') {
@@ -844,8 +853,8 @@ const launchStampId$1 = createStampId$1();
  * - 不支持路由动画
  */
 function createMultiRouter(history, app, config, framework) {
+    var _a, _b, _c, _d, _e, _f;
     return tslib.__awaiter(this, void 0, void 0, function* () {
-        var _a, _b, _c, _d, _e, _f;
         if (typeof app.onUnhandledRejection === 'function') {
             window.addEventListener('unhandledrejection', app.onUnhandledRejection);
         }
@@ -853,7 +862,7 @@ function createMultiRouter(history, app, config, framework) {
         RouterConfig.config = config;
         const handler = new MultiPageHandler(config, history);
         const launchParam = {
-            path: config.pageName, // 多页面模式没新开一个页面相当于重启，所以直接使用当前页面路径
+            path: config.pageName,
             query: handler.getQuery(launchStampId$1),
             scene: 0,
             shareTicket: '',
@@ -932,7 +941,7 @@ class NavigationBarHandler {
         });
     }
     toHomeFn() {
-        reLaunch({ url: this.pageContext.originHomePage });
+        reLaunch({ url: this.pageContext.homePage });
     }
     backFn() {
         navigateBack();
@@ -981,7 +990,7 @@ class NavigationBarHandler {
         this.setNavigationLoading();
     }
     setCacheValue() {
-        const currentPage = this.pageContext.originPathname;
+        const currentPage = this.pageContext.currentPage;
         if (typeof this.cache[currentPage] !== 'object') {
             this.cache[currentPage] = {};
         }
@@ -1012,7 +1021,7 @@ class NavigationBarHandler {
         var _a;
         if (!this.navigationBarElement)
             return;
-        const currentPage = this.pageContext.originPathname;
+        const currentPage = this.pageContext.currentPage;
         let isShow;
         if (typeof show === 'boolean') {
             isShow = show;
@@ -1037,7 +1046,7 @@ class NavigationBarHandler {
         var _a, _b, _c;
         if (!this.navigationBarElement)
             return;
-        const currentPage = this.pageContext.originPathname;
+        const currentPage = this.pageContext.currentPage;
         let color;
         if (typeof backgroundColor === 'string') {
             color = backgroundColor;
@@ -1061,7 +1070,7 @@ class NavigationBarHandler {
         var _a, _b, _c;
         if (!this.navigationBarElement)
             return;
-        const currentPage = this.pageContext.originPathname;
+        const currentPage = this.pageContext.currentPage;
         let color;
         if (typeof fontColor === 'string') {
             color = fontColor;
@@ -1083,7 +1092,7 @@ class NavigationBarHandler {
     }
     setTitle(title) {
         var _a, _b, _c;
-        const currentPage = this.pageContext.originPathname;
+        const currentPage = this.pageContext.currentPage;
         let proceedTitle;
         if (typeof title === 'string') {
             proceedTitle = title;
@@ -1164,7 +1173,6 @@ class PageHandler {
         this.defaultAnimation = { duration: 300, delay: 50 };
         this.config = config;
         this.homePage = runtime.getHomePage(this.routes[0].path, this.basename, this.customRoutes, this.config.entryPagePath);
-        this.originHomePage = this.config.entryPagePath || this.routes[0].path || this.basename;
         this.mount();
         this.navigationBarHandler = new NavigationBarHandler(this);
     }
@@ -1198,14 +1206,14 @@ class PageHandler {
     }
     set pathname(p) { this.router.pathname = p; }
     get pathname() { return this.router.pathname; }
-    // Note: 把 pathname 转换为原始路径，主要是处理 customRoutes 和 basename
-    get originPathname() { return routesAlias.getOrigin(runtime.addLeadingSlash(runtime.stripBasename(this.pathname, this.basename))); }
     get basename() { return this.router.basename || ''; }
     get pageConfig() {
+        const routePath = runtime.addLeadingSlash(runtime.stripBasename(this.pathname, this.basename));
         const homePage = runtime.addLeadingSlash(this.homePage);
         return this.routes.find(r => {
+            var _a;
             const pagePath = runtime.addLeadingSlash(r.path);
-            return [pagePath, homePage].includes(this.originPathname);
+            return [pagePath, homePage].includes(routePath) || ((_a = routesAlias.getConfig(pagePath)) === null || _a === void 0 ? void 0 : _a.includes(routePath));
         });
     }
     isTabBar(pathname) {
@@ -1395,35 +1403,24 @@ class PageHandler {
             });
         }
     }
-    hide(page, animation = false) {
-        var _a, _b, _c, _d, _e, _f, _g;
+    hide(page) {
+        var _a;
         if (!page)
             return;
         // NOTE: 修复多页并发问题，此处可能因为路由跳转过快，执行时页面可能还没有创建成功
         const pageEl = this.getPageContainer(page);
         if (pageEl) {
-            if (animation) {
-                if (this.hideTimer) {
-                    clearTimeout(this.hideTimer);
-                    this.hideTimer = null;
-                    (_c = (_b = (_a = this.lastHidePage) === null || _a === void 0 ? void 0 : _a.classList) === null || _b === void 0 ? void 0 : _b.add) === null || _c === void 0 ? void 0 : _c.call(_b, 'taro_page_shade');
-                }
-                this.lastHidePage = pageEl;
-                this.hideTimer = setTimeout(() => {
-                    this.hideTimer = null;
-                    pageEl.classList.add('taro_page_shade');
-                }, this.animationDuration + this.animationDelay);
-                (_d = page.onHide) === null || _d === void 0 ? void 0 : _d.call(page);
-            }
-            else {
-                if (this.hideTimer) {
-                    clearTimeout(this.hideTimer);
-                    this.hideTimer = null;
-                    (_g = (_f = (_e = this.lastHidePage) === null || _e === void 0 ? void 0 : _e.classList) === null || _f === void 0 ? void 0 : _f.add) === null || _g === void 0 ? void 0 : _g.call(_f, 'taro_page_shade');
-                }
+            if (this.hideTimer) {
+                clearTimeout(this.hideTimer);
+                this.hideTimer = null;
                 pageEl.classList.add('taro_page_shade');
-                this.lastHidePage = pageEl;
             }
+            this.lastHidePage = pageEl;
+            this.hideTimer = setTimeout(() => {
+                this.hideTimer = null;
+                pageEl.classList.add('taro_page_shade');
+            }, this.animationDuration + this.animationDelay);
+            (_a = page.onHide) === null || _a === void 0 ? void 0 : _a.call(page);
         }
         else {
             setTimeout(() => this.hide(page), 0);
@@ -1494,10 +1491,6 @@ function createRouter(history$1, app, config, framework) {
     }
     RouterConfig.config = config;
     const handler = new PageHandler(config, history$1);
-    // Note: 弱网情况下，快速切换 tab，会造成同个页面实例被多次挂在到页面上，原因是资源请求是异步的，短时间内发起多个请求，
-    // 会在资源加载完成后，同时走到挂载的逻辑，造成 pageStampId 更新不及时，两个 page 的Id 相同，后面很多操作是通过 getElementById 来进行的
-    // 所以需要加一个锁来应对这个情况
-    const pageLock = {};
     routesAlias.set(handler.router.customRoutes);
     const basename = handler.router.basename;
     const routes = handler.routes.map(route => {
@@ -1519,35 +1512,29 @@ function createRouter(history$1, app, config, framework) {
     runtime.eventCenter.trigger('__taroRouterLaunch', launchParam);
     (_a = app.onLaunch) === null || _a === void 0 ? void 0 : _a.call(app, launchParam);
     app.onError && window.addEventListener('error', e => { var _a; return (_a = app.onError) === null || _a === void 0 ? void 0 : _a.call(app, e.message); });
-    const render = (_c) => tslib.__awaiter(this, [_c], void 0, function* ({ location, action }) {
-        var _d, _e, _f, _g, _h, _j, _k, _l;
-        // Note: 由于下面有异步加载操作 先不要在这里去设置 handler.pathname
-        const currentPathname = decodeURI(location.pathname);
-        if ((_d = window.__taroAppConfig) === null || _d === void 0 ? void 0 : _d.usingWindowScroll)
+    const render = ({ location, action }) => tslib.__awaiter(this, void 0, void 0, function* () {
+        var _c, _d, _e, _f, _g, _h, _j, _k;
+        handler.pathname = decodeURI(location.pathname);
+        if ((_c = window.__taroAppConfig) === null || _c === void 0 ? void 0 : _c.usingWindowScroll)
             window.scrollTo(0, 0);
         runtime.eventCenter.trigger('__taroRouterChange', {
             toLocation: {
-                path: currentPathname
+                path: handler.pathname
             }
         });
-        let element, context, params;
-        const routerPath = handler.router.forcePath || currentPathname;
-        pageLock[routerPath] = typeof pageLock[routerPath] === 'number' ? pageLock[routerPath] + 1 : 1;
-        const currentLock = pageLock[routerPath];
-        let postLock;
+        let element, params;
         try {
-            const result = yield router.resolve(routerPath);
-            [element, context, params] = yield Promise.all(result);
-            postLock = pageLock[routerPath];
+            const result = yield router.resolve(handler.router.forcePath || handler.pathname);
+            [element, , params] = yield Promise.all(result);
         }
         catch (error) {
             if (error.status === 404) {
                 const notFoundEvent = {
                     isEntryPage: stacks.length === 0,
-                    path: currentPathname,
+                    path: handler.pathname,
                     query: handler.getQuery(createStampId()),
                 };
-                (_e = app.onPageNotFound) === null || _e === void 0 ? void 0 : _e.call(app, notFoundEvent);
+                (_d = app.onPageNotFound) === null || _d === void 0 ? void 0 : _d.call(app, notFoundEvent);
                 runtime.eventCenter.trigger('__taroRouterNotFound', notFoundEvent);
             }
             else if (/Loading hot update .* failed./.test(error.message)) {
@@ -1558,16 +1545,13 @@ function createRouter(history$1, app, config, framework) {
                 throw error;
             }
         }
-        if (!element || currentLock !== postLock)
+        if (!element)
             return;
-        // Note: 异步结束后，在设置 handler.pathname
-        // context.pathname 在 universal-router 被处理过了，是发起资源请求的时候传入的 pathname，即 await router.resolve(routerPath) 这个 routerPath
-        handler.pathname = context.pathname;
-        const { pathname, pageConfig } = handler;
-        let enablePullDownRefresh = ((_f = config === null || config === void 0 ? void 0 : config.window) === null || _f === void 0 ? void 0 : _f.enablePullDownRefresh) || false;
-        let navigationStyle = ((_g = config === null || config === void 0 ? void 0 : config.window) === null || _g === void 0 ? void 0 : _g.navigationStyle) || 'default';
-        let navigationBarTextStyle = ((_h = config === null || config === void 0 ? void 0 : config.window) === null || _h === void 0 ? void 0 : _h.navigationBarTextStyle) || 'white';
-        let navigationBarBackgroundColor = ((_j = config === null || config === void 0 ? void 0 : config.window) === null || _j === void 0 ? void 0 : _j.navigationBarBackgroundColor) || '#000000';
+        const pageConfig = handler.pageConfig;
+        let enablePullDownRefresh = ((_e = config === null || config === void 0 ? void 0 : config.window) === null || _e === void 0 ? void 0 : _e.enablePullDownRefresh) || false;
+        let navigationStyle = ((_f = config === null || config === void 0 ? void 0 : config.window) === null || _f === void 0 ? void 0 : _f.navigationStyle) || 'default';
+        let navigationBarTextStyle = ((_g = config === null || config === void 0 ? void 0 : config.window) === null || _g === void 0 ? void 0 : _g.navigationBarTextStyle) || 'white';
+        let navigationBarBackgroundColor = ((_h = config === null || config === void 0 ? void 0 : config.window) === null || _h === void 0 ? void 0 : _h.navigationBarBackgroundColor) || '#000000';
         if (pageConfig) {
             if (typeof pageConfig.enablePullDownRefresh === 'boolean') {
                 enablePullDownRefresh = pageConfig.enablePullDownRefresh;
@@ -1584,7 +1568,8 @@ function createRouter(history$1, app, config, framework) {
         }
         runtime.eventCenter.trigger('__taroSetNavigationStyle', navigationStyle, navigationBarTextStyle, navigationBarBackgroundColor);
         const currentPage = runtime.Current.page;
-        const methodName = (_k = stacks.method) !== null && _k !== void 0 ? _k : '';
+        const pathname = handler.pathname;
+        const methodName = (_j = stacks.method) !== null && _j !== void 0 ? _j : '';
         const cacheTabs = stacks.getTabs();
         let shouldLoad = false;
         stacks.method = '';
@@ -1599,11 +1584,10 @@ function createRouter(history$1, app, config, framework) {
             }
             shouldLoad = true;
         }
-        else if (currentPage && handler.isTabBar(pathname)) {
+        else if (currentPage && handler.isTabBar(handler.pathname)) {
             if (handler.isSamePage(currentPage))
                 return;
             if (handler.isTabBar(currentPage.path)) {
-                // NOTE: 从 tabBar 页面切换到 tabBar 页面
                 handler.hide(currentPage);
                 stacks.pushTab(currentPage.path.split('?')[0]);
             }
@@ -1617,8 +1601,8 @@ function createRouter(history$1, app, config, framework) {
                     handler.unload(currentPage, stacks.length, true);
                 }
             }
-            if (cacheTabs[pathname]) {
-                stacks.popTab(pathname);
+            if (cacheTabs[handler.pathname]) {
+                stacks.popTab(handler.pathname);
                 return handler.show(stacks.getItem(0), pageConfig, 0);
             }
             shouldLoad = true;
@@ -1647,11 +1631,11 @@ function createRouter(history$1, app, config, framework) {
             shouldLoad = true;
         }
         else if (action === 'PUSH') {
-            handler.hide(currentPage, true);
+            handler.hide(currentPage);
             shouldLoad = true;
         }
         if (shouldLoad || stacks.length < 1) {
-            const el = (_l = element.default) !== null && _l !== void 0 ? _l : element;
+            const el = (_k = element.default) !== null && _k !== void 0 ? _k : element;
             const loadConfig = Object.assign({}, pageConfig);
             const stacksIndex = stacks.length;
             delete loadConfig['path'];
@@ -1740,11 +1724,11 @@ function handleAppMountWithTabbar(config, history, appId = config.appId || 'app'
     initNavigationBar(config, container);
 }
 
-Object.defineProperty(exports, "createBrowserHistory", {
+Object.defineProperty(exports, 'createBrowserHistory', {
   enumerable: true,
   get: function () { return history.createBrowserHistory; }
 });
-Object.defineProperty(exports, "createHashHistory", {
+Object.defineProperty(exports, 'createHashHistory', {
   enumerable: true,
   get: function () { return history.createHashHistory; }
 });

package/dist/index.d.ts

@@ -1,9 +1,10 @@
-import type { History } from 'history';
-import type { MpaRouterConfig, SpaRouterConfig } from '../types/router';
-export * from './api';
-export * from './history';
-export { createMultiRouter } from './router/mpa';
-export { createRouter } from './router/spa';
-export * from './utils';
-export declare function handleAppMount(config: SpaRouterConfig | MpaRouterConfig, _: History, appId?: string): void;
-export declare function handleAppMountWithTabbar(config: SpaRouterConfig | MpaRouterConfig, history: History, appId?: string): void;
+import { History } from "./history.js";
+import { MpaRouterConfig, SpaRouterConfig } from '../types/router';
+declare function handleAppMount(config: SpaRouterConfig | MpaRouterConfig, _: History, appId?: string): void;
+declare function handleAppMountWithTabbar(config: SpaRouterConfig | MpaRouterConfig, history: History, appId?: string): void;
+export * from "./api.js";
+export * from "./history.js";
+export { createMultiRouter } from "./router/mpa.js";
+export { createRouter } from "./router/spa.js";
+export * from "./utils/index.js";
+export { handleAppMount, handleAppMountWithTabbar };

package/dist/index.esm.d.ts

@@ -0,0 +1,66 @@
+import { Action, createBrowserHistory, createHashHistory, Blocker, BrowserHistoryOptions, HashHistoryOptions, History, Listener, Location, Path, To } from "history";
+import { IH5RouterConfig } from "@tarojs/taro/types/compile";
+import { StateEvent } from "../types/history";
+import { MpaRouterConfig, SpaRouterConfig } from '../types/router';
+import Taro from "@tarojs/taro";
+import { AppInstance } from "@tarojs/runtime";
+import { MpaRouterConfig as MpaRouterConfig$0 } from "../../types/router";
+import { SpaRouterConfig as SpaRouterConfig$0 } from "../../types/router";
+declare let history: History;
+declare class MpaHistory implements History {
+    action: Action;
+    get location(): Location;
+    createHref(_to: To): string;
+    parseUrl(to: Partial<Path>): string;
+    push(to: Partial<Path>, _state?: Record<string, unknown>): void;
+    replace(to: Partial<Path>, _state?: Record<string, unknown>): void;
+    go(delta: number): void;
+    back: () => void;
+    forward: () => void;
+    listen(listener: Listener): () => void;
+    block(_blocker: Blocker): () => void;
+    pushState: globalThis.History["pushState"];
+    replaceState: globalThis.History["replaceState"];
+    eventState(action: Required<StateEvent>["action"]): (data: any, unused: string, url?: string | URL | null) => any;
+}
+declare function setHistory(h: History, base?: string): void;
+declare function createMpaHistory(_?: HashHistoryOptions | BrowserHistoryOptions): MpaHistory;
+declare function setHistoryMode(mode?: IH5RouterConfig["mode"], base?: string): void;
+declare function prependBasename(url?: string): string;
+declare function navigateTo(option: Taro.navigateTo.Option): ReturnType<typeof Taro.navigateTo>;
+declare function redirectTo(option: Taro.redirectTo.Option): ReturnType<typeof Taro.redirectTo>;
+declare function navigateBack(option?: Taro.navigateBack.Option): ReturnType<typeof Taro.navigateBack>;
+declare function switchTab(option: Taro.switchTab.Option): ReturnType<typeof Taro.switchTab>;
+declare function reLaunch(option: Taro.reLaunch.Option): ReturnType<typeof Taro.reLaunch>;
+declare function getCurrentPages(): Taro.Page[];
+// TODO 支持多路由 (APP 生命周期仅触发一次)
+/** Note: 关于多页面应用
+ * - 需要配置路由映射（根目录跳转、404 页面……）
+ * - app.onPageNotFound 事件不支持
+ * - 应用生命周期可能多次触发
+ * - TabBar 会多次加载
+ * - 不支持路由动画
+ */
+declare function createMultiRouter(history: History, app: AppInstance, config: MpaRouterConfig$0, framework?: string): Promise<void>;
+declare function createRouter(history: History, app: AppInstance, config: SpaRouterConfig$0, framework?: string): () => void;
+declare class RoutesAlias {
+    conf: Array<string[]>;
+    set(customRoutes?: Record<string, string | string[]>): void;
+    getConfig: (url?: string) => string[];
+    getOrigin: (url?: string) => string;
+    getAlias: (url?: string) => string;
+    getAll: (url?: string) => string[];
+}
+declare const routesAlias: RoutesAlias;
+declare const isWeixin: () => boolean;
+declare const isDingTalk: () => boolean;
+declare function setMpaTitle(title: string): void;
+declare function setTitle(title: string): void;
+declare function setNavigationBarStyle(option: {
+    backgroundColor: string;
+    frontColor: string;
+}): void;
+declare function setNavigationBarLoading(loading: boolean): void;
+declare function handleAppMount(config: SpaRouterConfig | MpaRouterConfig, _: History, appId?: string): void;
+declare function handleAppMountWithTabbar(config: SpaRouterConfig | MpaRouterConfig, history: History, appId?: string): void;
+export { navigateTo, redirectTo, navigateBack, switchTab, reLaunch, getCurrentPages, history, setHistory, createMpaHistory, createBrowserHistory, createHashHistory, setHistoryMode, prependBasename, createMultiRouter, createRouter, routesAlias, isWeixin, isDingTalk, setMpaTitle, setTitle, setNavigationBarStyle, setNavigationBarLoading, handleAppMount, handleAppMountWithTabbar };