@micro-zoe/micro-app 0.8.7 → 1.0.0-alpha.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@micro-zoe/micro-app",
-  "version": "0.8.7",
+  "version": "1.0.0-alpha.2",
   "description": "A lightweight, efficient and powerful micro front-end framework",
   "private": false,
   "main": "lib/index.min.js",
@@ -44,8 +44,6 @@
     "test": "jest",
     "test:watch": "jest --watch",
     "test:coverage": "jest --coverage",
-    "test:unit": "jest src/__tests__/unit",
-    "test:unit:coverage": "npm run test:unit -- --coverage",
     "prepublishOnly": "yarn build"
   },
   "repository": {

package/typings/global.d.ts

@@ -1,19 +1,43 @@
 declare module '@micro-app/types' {
   type AttrType = string | null
 
+  type NormalKey = string | number
+
   type Func = (...rest: any[]) => void
 
   type microAppWindowType = Window & any
 
+  type appName = string
+
   interface SandBoxInterface {
     proxyWindow: WindowProxy
     microAppWindow: Window // Proxy target
-    start (baseRoute: string): void
-    stop (): void
+    start (
+      baseRoute: string,
+      useMemoryRouter: boolean,
+      defaultPage: string,
+    ): void
+    stop (keepRouteState: boolean, clearEventSource: boolean): void
     // record umd snapshot before the first execution of umdHookMount
     recordUmdSnapshot (): void
     // rebuild umd snapshot before remount umd app
     rebuildUmdSnapshot (): void
+    setRouteInfoForKeepAliveApp (): void
+    removeRouteInfoForKeepAliveApp (): void
+  }
+
+  interface SandBoxAdapter {
+    // Variables that can only assigned to rawWindow
+    escapeSetterKeyList: PropertyKey[]
+
+    // Variables that can escape to rawWindow
+    staticEscapeProperties: PropertyKey[]
+
+    // Variables that scoped in child app
+    staticScopeProperties: PropertyKey[]
+
+    // adapter for react
+    // injectReactHRMProperty (): void
   }
 
   type sourceLinkInfo = {
@@ -50,10 +74,13 @@ declare module '@micro-app/types' {
     inline: boolean //  whether js runs in inline script mode, default is false
     scopecss: boolean // whether use css scoped, default is true
     useSandbox: boolean // whether use js sandbox, default is true
+    useMemoryRouter: boolean // whether use memoryRouter, default is true
     baseroute: string // route prefix, default is ''
+    keepRouteState: boolean // keep route state when unmount, default is false
     source: sourceType // sources of css, js, html
     sandBox: SandBoxInterface | null // sandbox
     umdMode: boolean // is umd mode
+    defaultPage: string // default page when mount
 
     // Load resources
     loadSourceCode (): void
@@ -69,6 +96,8 @@ declare module '@micro-app/types' {
       container?: HTMLElement | ShadowRoot,
       inline?: boolean,
       baseroute?: string,
+      keepRouteState?: boolean,
+      defaultPage?: string,
     ): void
 
     // unmount app
@@ -111,6 +140,7 @@ declare module '@micro-app/types' {
     url: string,
     disableScopecss?: boolean
     disableSandbox?: boolean
+    disableMemoryRouter?: boolean
     shadowDOM?: boolean
   }
 
@@ -126,8 +156,6 @@ declare module '@micro-app/types' {
     error?(e?: CustomEvent): void
   }
 
-  type AssetsChecker = (url: string) => boolean;
-
   type plugins = {
     // global plugin
     global?: Array<{
@@ -135,16 +163,10 @@ declare module '@micro-app/types' {
       scopeProperties?: Array<PropertyKey>
       // Properties that can be escape to rawWindow
       escapeProperties?: Array<PropertyKey>
-      // Exclude JS or CSS
-      excludeChecker?: AssetsChecker
-      // Ignore JS or CSS
-      ignoreChecker?: AssetsChecker
       // options for plugin as the third parameter of loader
       options?: unknown
       // handle function
       loader?: (code: string, url: string, options: unknown, info: sourceScriptInfo) => string
-      // html processor
-      processHtml?: (code: string, url: string, options: unknown) => string
     }>
 
     // plugin for special app
@@ -154,16 +176,10 @@ declare module '@micro-app/types' {
         scopeProperties?: Array<PropertyKey>
         // Properties that can be escape to rawWindow
         escapeProperties?: Array<PropertyKey>
-        // Exclude JS or CSS
-        excludeChecker?: AssetsChecker
-        // Ignore JS or CSS
-        ignoreChecker?: AssetsChecker
         // options for plugin as the third parameter of loader
         options?: unknown
         // handle function
         loader?: (code: string, url: string, options: unknown, info: sourceScriptInfo) => string
-        // html processor
-        processHtml?: (code: string, url: string, options: unknown) => string
       }>
     }
   }
@@ -182,6 +198,7 @@ declare module '@micro-app/types' {
     inline?: boolean
     disableScopecss?: boolean
     disableSandbox?: boolean
+    disableMemoryRouter?: boolean
     ssr?: boolean
     lifeCycles?: lifeCyclesType
     preFetchApps?: prefetchParamList
@@ -198,16 +215,171 @@ declare module '@micro-app/types' {
     inline?: boolean
     disableScopecss?: boolean
     disableSandbox?: boolean
+    disableMemoryRouter?: boolean
     ssr?: boolean
     lifeCycles?: lifeCyclesType
     plugins?: plugins
     fetch?: fetchType
     preFetch(apps: prefetchParamList): void
+    router: Router // eslint-disable-line
     start(options?: OptionsType): void
   }
 
   // special CallableFunction for interact
   type CallableFunctionForInteract = CallableFunction & { __APP_NAME__?: string, __AUTO_TRIGGER__?: boolean }
+
+  interface ShadowLocation {
+    [k: string]: string
+  }
+
+  interface MicroLocation extends Location, URL {
+    // shadowLocation is the current location information (href, pathname, search, hash)
+    shadowLocation: ShadowLocation
+    fullPath: string
+    [key: string]: any
+  }
+
+  type MicroHistory = ProxyHandler<History>
+  type MicroState = any
+  type HistoryProxyValue =
+    Pick<
+    History,
+    'length' |
+    'scrollRestoration' |
+    'state' |
+    'back' |
+    'forward' |
+    'go' |
+    'pushState' |
+    'replaceState'
+    > | CallableFunction
+  interface MicroRouter {
+    microLocation: MicroLocation
+    microHistory: MicroHistory
+  }
+  type LocationQueryValue = string | null
+  type LocationQueryObject = Record<
+  string,
+  LocationQueryValue | LocationQueryValue[]
+  >
+
+  type LocationQuery = {
+    hashQuery?: LocationQueryObject,
+    searchQuery?: LocationQueryObject
+  }
+
+  type GuardLocation = Record<keyof MicroLocation, any>
+
+  type CurrentRoute = Map<string, GuardLocation>
+
+  interface RouterTarget {
+    name: string
+    path: string
+    state?: unknown
+    replace?: boolean
+  }
+
+  type navigationMethod = (to: RouterTarget) => void
+
+  interface AccurateGuard {
+    [appName: string]: (to: GuardLocation, from: GuardLocation) => void
+  }
+
+  type GlobalNormalGuard = ((appName: string, to: GuardLocation, from: GuardLocation) => void)
+
+  type RouterGuard = AccurateGuard | GlobalNormalGuard
+
+  // Router API for developer
+  interface Router {
+    // current route of all apps
+    readonly current: CurrentRoute
+    /**
+     * encodeURI of microApp path
+     * @param path url path
+     */
+    encode(path: string): string
+    /**
+     * decodeURI of microApp path
+     * @param path url path
+     */
+    decode(path: string): ReturnType<Router['encode']>
+    /**
+     * Navigate to a new URL by pushing an entry in the history
+     * stack.
+     * @param to - Route location to navigate to
+     */
+    push: navigationMethod
+    /**
+     * Navigate to a new URL by replacing the current entry in
+     * the history stack.
+     *
+     * @param to - Route location to navigate to
+     */
+    replace: navigationMethod
+    /**
+     * Move forward or backward through the history. calling `history.go()`.
+     *
+     * @param delta - The position in the history to which you want to move,
+     * relative to the current page
+     */
+    go: Func
+    /**
+     * Go back in history if possible by calling `history.back()`.
+     */
+    back: Func
+    /**
+     * Go forward in history if possible by calling `history.forward()`.
+     */
+    forward: Func
+    /**
+     * Add a navigation guard that executes before any navigation
+     * @param guard global hook for
+     */
+    beforeEach(guard: RouterGuard): () => boolean
+    /**
+     * Add a navigation guard that executes after any navigation
+     * @param guard global hook for
+     */
+    afterEach(guard: RouterGuard): () => boolean
+    /**
+     * Add defaultPage to control the first rendered page
+     * @param appName app name
+     * @param path default page path
+     */
+    setDefaultPage(appName: string, path: string): () => boolean
+    /**
+     * Clear data of defaultPage that set by setDefaultPage
+     */
+    removeDefaultPage(appName: string): boolean
+    /**
+     * Get defaultPage that set by setDefaultPage
+     */
+    getDefaultPage(key: PropertyKey): string | undefined
+    /**
+     * Attach specified active app router info to browser url
+     */
+    attachToURL(appName: string): void
+    /**
+     * Attach all active app router info to browser url
+     */
+    attachAllToURL(): void
+    /**
+     * Record base app router, let child app control base app navigation
+     * It is global data
+     * @param baseRouter router instance of base app
+     */
+    setBaseAppRouter(baseRouter: unknown): void
+    /**
+     * get baseRouter from cache
+     */
+    getBaseAppRouter(): unknown
+  }
+
+  // result of add/remove microApp path on browser url
+  type HandleMicroPathResult = {
+    fullPath: string,
+    isAttach2Hash: boolean,
+  }
 }
 
 declare namespace JSX {