@micro-zoe/micro-app 1.0.0-rc.0 → 1.0.0-rc.10

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

@@ -110,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;
@@ -125,7 +125,9 @@ declare module '@micro-zoe/micro-app/libs/utils' {
     };
     export const rawDefineProperty: (o: any, p: string | number | symbol, attributes: PropertyDescriptor & ThisType<any>) => any;
     export const rawDefineProperties: (o: any, properties: PropertyDescriptorMap & ThisType<any>) => any;
+    export const rawToString: () => string;
     export const rawHasOwnProperty: (v: string | number | symbol) => boolean;
+    export const toTypeString: (value: unknown) => string;
     export function isUndefined(target: unknown): target is undefined;
     export function isNull(target: unknown): target is null;
     export function isString(target: unknown): target is string;
@@ -141,6 +143,10 @@ declare module '@micro-zoe/micro-app/libs/utils' {
     export function isURL(target: unknown): target is URL;
     export function isElement(target: unknown): target is Element;
     export function isNode(target: unknown): target is Node;
+    export function isCanvasElement(target: unknown): target is HTMLCanvasElement;
+    export function isAnchorElement(target: unknown): target is HTMLAnchorElement;
+    export function isAudioElement(target: unknown): target is HTMLAudioElement;
+    export function isVideoElement(target: unknown): target is HTMLVideoElement;
     export function isLinkElement(target: unknown): target is HTMLLinkElement;
     export function isStyleElement(target: unknown): target is HTMLStyleElement;
     export function isScriptElement(target: unknown): target is HTMLScriptElement;
@@ -148,8 +154,12 @@ 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
         * @param msg message
@@ -168,6 +178,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
         */
@@ -196,7 +212,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;
@@ -230,28 +248,33 @@ declare module '@micro-zoe/micro-app/libs/utils' {
         */
     export function promiseRequestIdle(callback: CallableFunction): Promise<void>;
     export function setCurrentAppName(appName: string | null): void;
-    export function throttleDeferForSetAppName(appName: string): void;
     export function getCurrentAppName(): string | null;
-    export function removeDomScope(): 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
         */
     export function pureCreateElement<K extends keyof MicroAppElementTagNameMap>(tagName: K, options?: ElementCreationOptions): MicroAppElementTagNameMap[K];
-    /**
-        * clone origin elements to target
-        * @param origin Cloned element
-        * @param target Accept cloned elements
-        * @param deep deep clone or transfer dom
-        */
-    export function cloneContainer<T extends Element | ShadowRoot, Q extends Element | ShadowRoot>(target: Q, origin: T, deep: boolean): Q;
     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
         */
@@ -309,7 +332,18 @@ declare module '@micro-zoe/micro-app/libs/utils' {
         * @param args arguments
         */
     export function execMicroAppGlobalHook(fn: Func | null, appName: string, hookName: string, ...args: unknown[]): void;
+    /**
+        * remove all childNode from target node
+        * @param $dom target node
+        */
     export function clearDOM($dom: HTMLElement | ShadowRoot | Document): void;
+    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;
+    /**
+        * Is the object empty
+        * target maybe number, string, array ...
+        */
+    export function isEmptyObject(target: unknown): boolean;
 }
 
 declare module '@micro-zoe/micro-app/interact' {