@heathenjs/taro-router 1.0.0

package/dist/router/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/router/index.ts"],"names":[],"mappings":"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"}

package/dist/router/type.d.ts

@@ -0,0 +1,35 @@
+export interface Route<E = any> {
+    /** 页面 url，与配置在 app.config.ts 中的一致 */
+    url: string;
+    /** 附加数据 */
+    ext?: E;
+}
+export type Page = {
+    dirName: string;
+    dirPath: string;
+    path: string;
+    fullPath: string;
+    packageName: string;
+};
+export declare enum NavigateType {
+    /** 保留当前页面，跳转到应用内的某个页面。但是不能跳到 tabbar 页面。使用 Router.back 可以返回到原页面。小程序中页面栈最多十层。 */
+    navigateTo = "navigateTo",
+    /** 关闭当前页面，跳转到应用内的某个页面。但是不允许跳转到 tabbar 页面。 */
+    redirectTo = "redirectTo",
+    /** 关闭所有页面，打开到应用内的某个页面 */
+    reLaunch = "reLaunch",
+    /** 跳转到 tabBar 页面，并关闭其他所有非 tabBar 页面 */
+    switchTab = "switchTab"
+}
+export interface NavigateOptions {
+    /** 跳转类型 */
+    type?: NavigateType;
+    /** 路由参数 */
+    params?: unknown;
+    /** 跳转完成的回调方法 */
+    complete?: (res: TaroGeneral.CallbackResult) => void;
+    /** 跳转失败的回调方法 */
+    fail?: (res: TaroGeneral.CallbackResult) => void;
+    /** 跳转成功的回调方法 */
+    success?: (res: TaroGeneral.CallbackResult) => void;
+}

package/dist/router/type.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NavigateType = void 0;
+var NavigateType;
+(function (NavigateType) {
+    /** 保留当前页面，跳转到应用内的某个页面。但是不能跳到 tabbar 页面。使用 Router.back 可以返回到原页面。小程序中页面栈最多十层。 */
+    NavigateType["navigateTo"] = "navigateTo";
+    /** 关闭当前页面，跳转到应用内的某个页面。但是不允许跳转到 tabbar 页面。 */
+    NavigateType["redirectTo"] = "redirectTo";
+    /** 关闭所有页面，打开到应用内的某个页面 */
+    NavigateType["reLaunch"] = "reLaunch";
+    /** 跳转到 tabBar 页面，并关闭其他所有非 tabBar 页面 */
+    NavigateType["switchTab"] = "switchTab";
+})(NavigateType || (exports.NavigateType = NavigateType = {}));
+//# sourceMappingURL=type.js.map

package/dist/router/type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.js","sourceRoot":"","sources":["../../src/router/type.ts"],"names":[],"mappings":";;;AAeA,IAAY,YASX;AATD,WAAY,YAAY;IACtB,+EAA+E;IAC/E,yCAAyB,CAAA;IACzB,6CAA6C;IAC7C,yCAAyB,CAAA;IACzB,yBAAyB;IACzB,qCAAqB,CAAA;IACrB,uCAAuC;IACvC,uCAAuB,CAAA;AACzB,CAAC,EATW,YAAY,4BAAZ,YAAY,QASvB"}

package/dist/router-back-listener/index.d.ts

@@ -0,0 +1,7 @@
+import { RouterBackListener } from './type';
+import { Route } from '../router';
+export type { RouterBackListener };
+export declare const routerBackListenerCollection: RouterBackListener[];
+/** 注册全局路由返回监听 */
+export declare function registerRouterBackListener(listener: RouterBackListener): void;
+export declare function execRouterBackListener(from: Route): void;

package/dist/router-back-listener/index.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.routerBackListenerCollection = void 0;
+exports.registerRouterBackListener = registerRouterBackListener;
+exports.execRouterBackListener = execRouterBackListener;
+const taro_1 = require("@tarojs/taro");
+exports.routerBackListenerCollection = [];
+/** 注册全局路由返回监听 */
+function registerRouterBackListener(listener) {
+    exports.routerBackListenerCollection.push(listener);
+}
+function execRouterBackListener(from) {
+    var _a;
+    const to = {
+        url: ((_a = taro_1.Current.router) === null || _a === void 0 ? void 0 : _a.path) || '',
+    };
+    for (const listener of exports.routerBackListenerCollection) {
+        listener(to, from);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/router-back-listener/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/router-back-listener/index.ts"],"names":[],"mappings":";;;AASA,gEAEC;AAED,wDAOC;AApBD,uCAAuC;AAM1B,QAAA,4BAA4B,GAAyB,EAAE,CAAC;AAErE,iBAAiB;AACjB,SAAgB,0BAA0B,CAAC,QAA4B;IACrE,oCAA4B,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC9C,CAAC;AAED,SAAgB,sBAAsB,CAAC,IAAW;;IAChD,MAAM,EAAE,GAAG;QACT,GAAG,EAAE,CAAA,MAAA,cAAO,CAAC,MAAM,0CAAE,IAAI,KAAI,EAAE;KAChC,CAAC;IACF,KAAK,MAAM,QAAQ,IAAI,oCAA4B,EAAE,CAAC;QACpD,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/router-back-listener/type.d.ts

@@ -0,0 +1,2 @@
+import { Route } from '../router';
+export type RouterBackListener = (to: Route, from: Route) => any;

package/dist/router-back-listener/type.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=type.js.map

package/dist/router-back-listener/type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.js","sourceRoot":"","sources":["../../src/router-back-listener/type.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@heathenjs/taro-router",
+  
+  "version": "1.0.0",
+  "description": "",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "prod": "tsc -p ./tsconfig.json",
+    "clean": "rimraf dist",
+    "build": "pnpm run clean && pnpm run prod",
+    "tsc": "tsc -p ./tsconfig.json --noEmit",
+    "lint": "eslint --ext .ts  --max-warnings 0 \"./src\" "
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "peerDependencies": {
+    "@tarojs/taro": "^3.6.35",
+    "react": "^18.0.0"
+  },
+  "dependencies": {
+    "normalize-path": "^3.0.0",
+    "query-string": "^7.0.0",
+    "ts-morph": "^21.0.1"
+  },
+  "devDependencies": {
+    "@types/normalize-path": "^3.0.0"
+  }
+}

package/src/constants.ts

@@ -0,0 +1,2 @@
+export const ROUTE_KEY = 'route_key';
+export const isBrowser = typeof document !== 'undefined' && !!document.scripts;

package/src/exception/index.ts

@@ -0,0 +1 @@
+export { NoPageException } from './no-page';

package/src/exception/no-page.ts

@@ -0,0 +1,5 @@
+export class NoPageException extends Error {
+  constructor() {
+    super('没有页面可以回退了');
+  }
+}

package/src/func/getCurrentRouteKey.ts

@@ -0,0 +1,10 @@
+import Taro from '@tarojs/taro';
+import { ROUTE_KEY } from '../constants';
+
+export function getCurrentRouteKey(): string {
+  if (!Taro.Current.page) {
+    return '';
+  }
+  // TODO: taro官方缺少类型定义，as any过渡一下
+  return (Taro.Current.page as any)[ROUTE_KEY];
+}

package/src/func/index.ts

@@ -0,0 +1,2 @@
+export * from './getCurrentRouteKey';
+export * from './isNil';

package/src/func/isNil.ts

@@ -0,0 +1,3 @@
+export function isNil(val: any) {
+  return val === undefined || val === null;
+}

package/src/index.ts

@@ -0,0 +1,12 @@
+import { Router } from './router';
+
+export { NoPageException } from './exception';
+export { execMiddlewares, getMiddlewares, registerMiddleware, registerMiddlewares } from './middleware';
+export { NavigateType, Router } from './router';
+export { registerRouterBackListener } from './router-back-listener';
+
+export type { Middleware, MiddlewareCondition, RouteContext } from './middleware';
+export type { NavigateOptions, Route } from './router';
+export type { RouterBackListener } from './router-back-listener';
+
+export default Router;

package/src/lib/compose.ts

@@ -0,0 +1,37 @@
+/**
+ * Compose `middleware` returning
+ * a fully valid middleware comprised
+ * of all those which are passed.
+ *
+ * @param {Array} middleware
+ * @return {Function}
+ */
+export function compose(middleware: Function[]) {
+  if (!Array.isArray(middleware)) throw new TypeError('Middleware stack must be an array!');
+  for (const fn of middleware) {
+    if (typeof fn !== 'function') throw new TypeError('Middleware must be composed of functions!');
+  }
+
+  /**
+   * @param {Object} context
+   * @return {Promise}
+   * @api public
+   */
+  return function (context: any, next?: Function) {
+    // last called middleware #
+    let index = -1;
+    const dispatch = (i: number): Promise<any> => {
+      if (i <= index) return Promise.reject(new Error('next() called multiple times'));
+      index = i;
+      let fn: Function | undefined = middleware[i];
+      if (i === middleware.length) fn = next;
+      if (!fn) return Promise.resolve();
+      try {
+        return Promise.resolve(fn(context, dispatch.bind(null, i + 1)));
+      } catch (err) {
+        return Promise.reject(err);
+      }
+    };
+    return dispatch(0);
+  };
+}

package/src/middleware/index.ts

@@ -0,0 +1,40 @@
+import { compose } from '../lib/compose';
+import { Middleware, MiddlewareCondition, RouteContext } from './type';
+
+export type { Middleware, RouteContext, MiddlewareCondition };
+
+export const middlewareCollection: {
+  middlewares: Middleware[];
+  condition?: MiddlewareCondition;
+}[] = [];
+
+export function registerMiddleware(middleware: Middleware, condition?: MiddlewareCondition) {
+  middlewareCollection.push({
+    middlewares: [middleware],
+    condition,
+  });
+}
+
+export function registerMiddlewares(middlewares: Middleware[], condition?: MiddlewareCondition) {
+  middlewareCollection.push({
+    middlewares,
+    condition,
+  });
+}
+
+export function getMiddlewares(ctx: RouteContext) {
+  return middlewareCollection
+    .filter((mc) => {
+      if (!mc.condition) return true;
+      else return mc.condition(ctx);
+    })
+    .map((mc) => mc.middlewares)
+    .reduce((pre, cur) => {
+      return [...pre, ...cur];
+    }, []);
+}
+
+export async function execMiddlewares(middlewares: Middleware[], ctx: RouteContext) {
+  const fn = compose(middlewares);
+  return await fn(ctx);
+}

package/src/middleware/type.ts

@@ -0,0 +1,16 @@
+import { NavigateType, Route } from '../router/type';
+
+export interface RouteContext<E = any> {
+  /** 目标路由 */
+  route: Route<E>;
+  /** 路由参数 */
+  params: any;
+  /** 跳转类型 */
+  type: NavigateType;
+  /** 路由所在包 */
+  packageName?: string;
+}
+
+export type Middleware<E = any> = (ctx: RouteContext<E>, next: () => Promise<any>) => Promise<void>;
+
+export type MiddlewareCondition = (ctx: RouteContext) => boolean;

package/src/page-data/index.ts

@@ -0,0 +1,67 @@
+import { getCurrentRouteKey } from '../func';
+
+export class PageData {
+  private static pageData: Map<string, any> = new Map();
+  private static pagePromise: Map<
+    string,
+    {
+      res: (val: any) => void;
+      rej: (err: any) => void;
+    }
+  > = new Map();
+
+  private static backResult: Map<string, any> = new Map();
+
+  static getPageData<T = any>(default_value?: T): T {
+    const route_key = getCurrentRouteKey();
+    const result = PageData.pageData.get(route_key) || default_value;
+    return result;
+  }
+
+  private static delPageData(route_key: string) {
+    PageData.pageData.delete(route_key);
+  }
+
+  private static delPagePromise(route_key: string) {
+    PageData.pagePromise.delete(route_key);
+  }
+
+  static setPageData(route_key: string, data: any) {
+    this.pageData.set(route_key, data);
+  }
+
+  static setPagePromise(
+    route_key: string,
+    options: {
+      res: (val: any) => void;
+      rej: (err: any) => void;
+    },
+  ) {
+    this.pagePromise.set(route_key, options);
+  }
+
+  static emitBack(route_key: string) {
+    const pme = PageData.pagePromise.get(route_key);
+    if (!pme) return;
+    const result = PageData.backResult.get(route_key);
+
+    PageData.delPageData(route_key);
+    PageData.delPagePromise(route_key);
+
+    if (result) {
+      PageData.backResult.delete(route_key);
+      if (result instanceof Error) {
+        pme.rej(result);
+      } else {
+        pme.res(result);
+      }
+    } else {
+      pme.res(null);
+    }
+  }
+
+  static setBackResult(result: any) {
+    const route_key = getCurrentRouteKey();
+    PageData.backResult.set(route_key, result);
+  }
+}

package/src/router/index.ts

@@ -0,0 +1,179 @@
+import Taro, { Current, getCurrentInstance } from '@tarojs/taro';
+import { ROUTE_KEY } from '../constants';
+import { NoPageException } from '../exception/no-page';
+import { getCurrentRouteKey, isNil } from '../func';
+import { execMiddlewares, getMiddlewares, RouteContext } from '../middleware';
+import { PageData } from '../page-data';
+import { execRouterBackListener } from '../router-back-listener';
+import { NavigateOptions, NavigateType, Page, Route } from './type';
+import { useRef } from 'react';
+
+export { NavigateType } from './type';
+export type { NavigateOptions, Route } from './type';
+
+export class Router {
+  /**
+   * 页面跳转
+   * @param route 目标路由对象
+   * @param options 跳转选项
+   */
+  static async navigate<T = any>(route: Route, options?: NavigateOptions): Promise<T> {
+    options = { ...{ type: NavigateType.navigateTo, params: {} }, ...options };
+    options.params = Object.assign({}, options.params);
+    const route_key = Date.now() + '';
+
+    // TODO: taro官方缺少类型定义，as any过渡一下
+    (Current as any)['_page'] = Current.page;
+    Object.defineProperties(Current, {
+      page: {
+        set: function (page) {
+          if (page === undefined || page === null) {
+            this._page = page;
+            return;
+          }
+          if (!page[ROUTE_KEY]) {
+            const originOnUnload = page.onUnload;
+            page.onUnload = function () {
+              originOnUnload && originOnUnload.apply(this);
+              PageData.emitBack(route_key);
+              setTimeout(() => execRouterBackListener(route));
+            };
+            page[ROUTE_KEY] = route_key;
+          }
+          this._page = page;
+        },
+        get: function () {
+          return this._page;
+        },
+      },
+    });
+
+    if (options.params) {
+      PageData.setPageData(route_key, options.params);
+    }
+
+    const pages = (Router?.['_pages'] ?? []) as Page[];
+
+    const context: RouteContext = {
+      route,
+      type: options.type!,
+      params: options.params,
+      packageName: pages.find((page) => page.path === route.url)?.packageName,
+    };
+
+    const middlewares = getMiddlewares(context);
+    middlewares.push(async (_, next) => {
+      switch (options!.type) {
+        case NavigateType.reLaunch:
+          await Taro.reLaunch({
+            url: route.url,
+            complete: options?.complete,
+            fail: options?.fail,
+            success: options?.success,
+          });
+          break;
+        case NavigateType.redirectTo:
+          await Taro.redirectTo({
+            url: route.url,
+            complete: options?.complete,
+            fail: options?.fail,
+            success: options?.success,
+          });
+          break;
+        case NavigateType.switchTab:
+          await Taro.switchTab({
+            url: route.url,
+            complete: options?.complete,
+            fail: options?.fail,
+            success: options?.success,
+          });
+          break;
+        default:
+          await Taro.navigateTo({
+            url: route.url,
+            complete: options?.complete,
+            fail: options?.fail,
+            success: options?.success,
+          });
+          break;
+      }
+      next();
+    });
+
+    return new Promise(async (res, rej) => {
+      try {
+        PageData.setPagePromise(route_key, { res, rej });
+        await execMiddlewares(middlewares, context);
+      } catch (err) {
+        rej(err);
+      }
+    });
+  }
+
+  /**
+   * 返回上一个页面
+   * @param result 返回给上一个页面的数据，如果 result 是 Error 的实例，则是抛出异常给上一个页面
+   * @param options 其他选项
+   */
+  static back(
+    result?: unknown,
+    options?: {
+      /** 返回的页面数，如果 delta 大于现有页面数，则返回到首页。 */
+      delta?: number;
+    },
+  ) {
+    if (!isNil(result)) {
+      PageData.setBackResult(result);
+    }
+
+    const currentPages = Taro.getCurrentPages();
+    if (currentPages.length > 1) {
+      return Taro.navigateBack(options);
+    }
+
+    throw new NoPageException();
+  }
+
+  /**
+   * 设置页面返回的数据
+   * 当物理键返回和左上角返回也需要带数据时会使用到
+   */
+  static setBackResult(result: any) {
+    PageData.setBackResult(result);
+  }
+
+  /**
+   * 获取页面携带过来的数据，混合顺序为 路由参数 > URL参数
+   * @param default_value 默认参数
+   */
+  static getParams<T extends Record<string, any> = {}>(): T {
+    const urlParams = Object.assign({}, getCurrentInstance().router?.params) as T;
+    const routerParams = PageData.getPageData<T>();
+    return {
+      ...urlParams,
+      ...routerParams,
+    };
+  }
+
+  /**
+   * 获取页面携带过来的数据，混合顺序为 路由参数 > URL参数
+   * @param default_value 默认参数
+   */
+  static useParams<T extends Record<string, any> = {}>(): T {
+    // eslint-disable-next-line react-hooks/rules-of-hooks
+    const { current } = useRef({
+      obj: {} as T,
+      initialized: false,
+    });
+    if (current.initialized === false) {
+      current.obj = this.getParams();
+      current.initialized = true;
+    }
+    return current.obj;
+  }
+
+  static setParams<T extends Record<string, any> = {}>(value: T) {
+    const route_key = getCurrentRouteKey();
+    PageData.setPageData(route_key, value);
+  }
+}

package/src/router/type.ts

@@ -0,0 +1,38 @@
+export interface Route<E = any> {
+  /** 页面 url，与配置在 app.config.ts 中的一致 */
+  url: string;
+  /** 附加数据 */
+  ext?: E;
+}
+
+export type Page = {
+  dirName: string;
+  dirPath: string;
+  path: string;
+  fullPath: string;
+  packageName: string;
+};
+
+export enum NavigateType {
+  /** 保留当前页面，跳转到应用内的某个页面。但是不能跳到 tabbar 页面。使用 Router.back 可以返回到原页面。小程序中页面栈最多十层。 */
+  navigateTo = 'navigateTo',
+  /** 关闭当前页面，跳转到应用内的某个页面。但是不允许跳转到 tabbar 页面。 */
+  redirectTo = 'redirectTo',
+  /** 关闭所有页面，打开到应用内的某个页面 */
+  reLaunch = 'reLaunch',
+  /** 跳转到 tabBar 页面，并关闭其他所有非 tabBar 页面 */
+  switchTab = 'switchTab',
+}
+
+export interface NavigateOptions {
+  /** 跳转类型 */
+  type?: NavigateType;
+  /** 路由参数 */
+  params?: unknown;
+  /** 跳转完成的回调方法 */
+  complete?: (res: TaroGeneral.CallbackResult) => void;
+  /** 跳转失败的回调方法 */
+  fail?: (res: TaroGeneral.CallbackResult) => void;
+  /** 跳转成功的回调方法 */
+  success?: (res: TaroGeneral.CallbackResult) => void;
+}

package/src/router-back-listener/index.ts

@@ -0,0 +1,21 @@
+import { Current } from '@tarojs/taro';
+import { RouterBackListener } from './type';
+import { Route } from '../router';
+
+export type { RouterBackListener };
+
+export const routerBackListenerCollection: RouterBackListener[] = [];
+
+/** 注册全局路由返回监听 */
+export function registerRouterBackListener(listener: RouterBackListener) {
+  routerBackListenerCollection.push(listener);
+}
+
+export function execRouterBackListener(from: Route) {
+  const to = {
+    url: Current.router?.path || '',
+  };
+  for (const listener of routerBackListenerCollection) {
+    listener(to, from);
+  }
+}

package/src/router-back-listener/type.ts

@@ -0,0 +1,3 @@
+import { Route } from '../router';
+
+export type RouterBackListener = (to: Route, from: Route) => any;

package/tsconfig.json

@@ -0,0 +1,25 @@
+{
+  "extends": "../../tsconfig",
+  "compilerOptions": {
+    "module": "CommonJS",
+    "removeComments": false,
+    "moduleResolution": "node",
+    "experimentalDecorators": false,
+    "noImplicitAny": false,
+    "allowSyntheticDefaultImports": true,
+    "esModuleInterop": true,
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "strictNullChecks": true,
+    "resolveJsonModule": true,
+    "sourceMap": true,
+    "skipLibCheck": true,
+    "target": "es2015",
+    "outDir": "dist",
+    "rootDir": "./src",
+    "declaration": true,
+    "noEmit": false
+  },
+  "include": ["./**/*.ts", "./**/*.tsx", "src/index.ts"],
+  "exclude": ["node_modules", "dist"]
+}