@micro-zoe/micro-app 1.0.0-rc.4 → 1.0.0-rc.6

package/README.md

@@ -1,6 +1,6 @@
 <p align="center">
   <a href="https://micro-zoe.github.io/micro-app/">
-    <img src="https://zeroing.jd.com/micro-app/media/logo.png" alt="logo" width="200"/>
+    <img src="https://micro-zoe.github.io/micro-app/home/assets/logo.png" alt="logo" width="200"/>
   </a>
 </p>
 

package/lib/index.d.ts

@@ -4,7 +4,7 @@
 //   ../../@micro-app/types
 
 declare module '@micro-zoe/micro-app' {
-    export { default, MicroApp, getActiveApps, getAllApps, unmountApp, unmountAllApps, reload, renderApp, getAppStatus } from '@micro-zoe/micro-app/micro_app';
+    export { default, MicroApp, getActiveApps, getAllApps, unmountApp, unmountAllApps, reload, renderApp, } from '@micro-zoe/micro-app/micro_app';
     export { default as preFetch, } from '@micro-zoe/micro-app/prefetch';
     export { removeDomScope, pureCreateElement, version, } from '@micro-zoe/micro-app/libs/utils';
     export { EventCenterForMicroApp, } from '@micro-zoe/micro-app/interact';
@@ -60,12 +60,6 @@ declare module '@micro-zoe/micro-app/micro_app' {
         * @returns Promise<boolean>
         */
     export function renderApp(options: RenderAppOptions): Promise<boolean>;
-    /**
-        * get app state
-        * @param appName app.name
-        * @returns app.state
-        */
-    export function getAppStatus(appName: string): string | void;
     export class MicroApp extends EventCenterForBaseApp implements MicroAppBaseType {
             tagName: string;
             hasInit: boolean;
@@ -78,7 +72,6 @@ declare module '@micro-zoe/micro-app/micro_app' {
             getAllApps: typeof getAllApps;
             reload: typeof reload;
             renderApp: typeof renderApp;
-            getAppStatus: typeof getAppStatus;
             start(options?: OptionsType): void;
     }
     const microApp: MicroApp;
@@ -117,7 +110,7 @@ declare module '@micro-zoe/micro-app/prefetch' {
 }
 
 declare module '@micro-zoe/micro-app/libs/utils' {
-    import { Func, LocationQueryObject, MicroLocation, AttrsType, fiberTasks, MicroAppElementTagNameMap } from '@micro-app/types';
+    import { Func, LocationQueryObject, MicroLocation, AttrsType, fiberTasks, MicroAppElementTagNameMap, MicroAppElementInterface } from '@micro-app/types';
     export const version = "__MICRO_APP_VERSION__";
     export const isBrowser: boolean;
     export const globalThis: any;
@@ -157,8 +150,11 @@ declare module '@micro-zoe/micro-app/libs/utils' {
     export function isDivElement(target: unknown): target is HTMLDivElement;
     export function isImageElement(target: unknown): target is HTMLImageElement;
     export function isBaseElement(target: unknown): target is HTMLBaseElement;
+    export function isDocumentFragment(target: unknown): target is DocumentFragment;
     export function isMicroAppBody(target: unknown): target is HTMLElement;
+    export function isMicroAppHead(target: unknown): target is HTMLElement;
     export function isProxyDocument(target: unknown): target is Document;
+    export function isTargetExtension(path: string, suffix: string): boolean;
     export function includes(target: unknown[], searchElement: unknown, fromIndex?: number): boolean;
     /**
         * format error log
@@ -178,6 +174,12 @@ declare module '@micro-zoe/micro-app/libs/utils' {
         * @param args params
         */
     export function defer(fn: Func, ...args: unknown[]): void;
+    /**
+        * async execution with macro task
+        * @param fn callback
+        * @param args params
+        */
+    export function macro(fn: Func, delay?: number, ...args: unknown[]): void;
     /**
         * create URL as MicroLocation
         */
@@ -206,7 +208,9 @@ declare module '@micro-zoe/micro-app/libs/utils' {
         */
     export function formatAppName(name: string | null): string;
     /**
-        * Get valid address, such as https://xxx/xx/xx.html to https://xxx/xx/
+        * Get valid address, such as
+        *  1. https://domain/xx/xx.html to https://domain/xx/
+        *  2. https://domain/xx to https://domain/xx/
         * @param url app.url
         */
     export function getEffectivePath(url: string): string;
@@ -241,8 +245,19 @@ declare module '@micro-zoe/micro-app/libs/utils' {
     export function promiseRequestIdle(callback: CallableFunction): Promise<void>;
     export function setCurrentAppName(appName: string | null): void;
     export function getCurrentAppName(): string | null;
-    export function removeDomScope(force?: boolean): void;
     export function throttleDeferForSetAppName(appName: string): void;
+    export function setIframeCurrentAppName(appName: string | null): void;
+    export function getIframeCurrentAppName(): string | null;
+    export function throttleDeferForIframeAppName(appName: string): void;
+    export function getPreventSetState(): boolean;
+    /**
+        * prevent set appName
+        * usage:
+        * removeDomScope(true)
+        * -----> element scope point to base app <-----
+        * removeDomScope(false)
+        */
+    export function removeDomScope(force?: boolean): void;
     export function isSafari(): boolean;
     /**
         * Create pure elements
@@ -250,11 +265,12 @@ declare module '@micro-zoe/micro-app/libs/utils' {
     export function pureCreateElement<K extends keyof MicroAppElementTagNameMap>(tagName: K, options?: ElementCreationOptions): MicroAppElementTagNameMap[K];
     export function isInvalidQuerySelectorKey(key: string): boolean;
     export function isUniqueElement(key: string): boolean;
+    export type RootContainer = HTMLElement & MicroAppElementInterface;
     /**
         * get micro-app element
         * @param target app container
         */
-    export function getRootContainer(target: HTMLElement | ShadowRoot): HTMLElement;
+    export function getRootContainer(target: HTMLElement | ShadowRoot): RootContainer;
     /**
         * trim start & end
         */
@@ -317,16 +333,13 @@ declare module '@micro-zoe/micro-app/libs/utils' {
         * @param $dom target node
         */
     export function clearDOM($dom: HTMLElement | ShadowRoot | Document): void;
-    type BaseHTMLElementType = HTMLElement & {
-            new (): HTMLElement;
-            prototype: HTMLElement;
-    };
+    export function instanceOf<T extends new (...args: unknown[]) => unknown>(instance: unknown, constructor: T): instance is T extends new (...args: unknown[]) => infer R ? R : boolean;
+    export function formatEventType(type: string, appName: string): string;
     /**
-        * get HTMLElement from base app
-        * @returns HTMLElement
+        * Is the object empty
+        * target maybe number, string, array ...
         */
-    export function getBaseHTMLElement(): BaseHTMLElementType;
-    export {};
+    export function isEmptyObject(target: unknown): boolean;
 }
 
 declare module '@micro-zoe/micro-app/interact' {