@sitecore-feaas/clientside 0.1.27 → 0.1.29

package/test/fetch.ts

@@ -0,0 +1,254 @@
+import { vi, describe, it, assert, beforeAll, expect, beforeEach } from 'vitest'
+import { CH1Node, serializeCH1RichText } from '../src/dom/data.js'
+import { clearFetchCache, fetchAndRevalidate } from '../src/fetch.js'
+const yesterday = new Date(2000, 1, 1, 0, 0, 0)
+const yesterdayNoon = new Date(2000, 1, 2, 12, 0, 0)
+const today = new Date(2000, 1, 2, 0, 0, 0)
+const todayNoon = new Date(2000, 1, 2, 12, 0, 0)
+describe('Fetch', () => {
+  beforeEach(() => {
+    // vi.useFakeTimers()
+    vi.setSystemTime(todayNoon)
+    clearFetchCache()
+    phases1.length = 0
+    phases2.length = 0
+  })
+  var phases1: [t: string, p: string][] = []
+  var phases2: [t: string, p: string][] = []
+  async function callback1(response: Response, phase: string) {
+    phases1.push([await response.clone().text(), phase])
+  }
+  async function callback2(response: Response, phase: string) {
+    phases2.push([await response.clone().text(), phase])
+  }
+  it('should deduplicate fresh requests', async () => {
+    const spy = vi.spyOn(global, 'fetch')
+    spy.mockImplementation(
+      async (url: string, options?: Parameters<typeof fetch>[1]) =>
+        new Response('A', {
+          headers: {
+            date: todayNoon.toUTCString()
+          }
+        })
+    )
+    await expect(
+      fetchAndRevalidate('a', undefined, undefined, callback1).then((r) => r.clone().text())
+    ).resolves.toEqual('A')
+    await expect(
+      fetchAndRevalidate('a', undefined, undefined, callback2).then((r) => r.clone().text())
+    ).resolves.toEqual('A')
+    expect(spy).toHaveBeenCalledTimes(1)
+    expect(phases1).toEqual([['A', 'initial']])
+    expect(phases2).toEqual([['A', 'initial']])
+    await expect(
+      fetchAndRevalidate('a', undefined, undefined, callback1).then((r) => r.clone().text())
+    ).resolves.toEqual('A')
+    expect(phases1).toEqual([
+      ['A', 'initial'],
+      ['A', 'initial']
+    ])
+    expect(phases2).toEqual([['A', 'initial']])
+    expect(spy).toHaveBeenCalledTimes(1)
+    clearFetchCache()
+    await expect(
+      fetchAndRevalidate('a', undefined, undefined, callback1).then((r) => r.clone().text())
+    ).resolves.toEqual('A')
+    expect(phases1).toEqual([
+      ['A', 'initial'],
+      ['A', 'initial'],
+      ['A', 'initial']
+    ])
+    expect(phases2).toEqual([['A', 'initial']])
+    await expect(
+      fetchAndRevalidate('a', undefined, undefined, callback2).then((r) => r.clone().text())
+    ).resolves.toEqual('A')
+    expect(phases1).toEqual([
+      ['A', 'initial'],
+      ['A', 'initial'],
+      ['A', 'initial']
+    ])
+    expect(phases2).toEqual([
+      ['A', 'initial'],
+      ['A', 'initial']
+    ])
+    expect(spy).toHaveBeenCalledTimes(2)
+  })
+  it('should deduplicate failing requests', async () => {
+    const spy = vi.spyOn(global, 'fetch')
+    spy.mockImplementation(
+      async (url: string, options?: Parameters<typeof fetch>[1]) =>
+        new Response('A', {
+          headers: {
+            date: todayNoon.toUTCString()
+          },
+          status: 400
+        })
+    )
+    expect(() =>
+      fetchAndRevalidate('a', undefined, undefined, callback1).then((r) => r.clone().text())
+    ).rejects.toEqual(new Error('Fetch failed'))
+    expect(() =>
+      fetchAndRevalidate('a', undefined, undefined, callback2).then((r) => r.clone().text())
+    ).rejects.toEqual(new Error('Fetch failed'))
+    expect(spy).toHaveBeenCalledTimes(1)
+    expect(phases1).toEqual([])
+    expect(phases2).toEqual([])
+    expect(() => fetchAndRevalidate('a').then((r) => r.clone().text())).rejects.toEqual(new Error('Fetch failed'))
+    clearFetchCache()
+    expect(() => fetchAndRevalidate('a').then((r) => r.clone().text())).rejects.toEqual(new Error('Fetch failed'))
+    expect(spy).toHaveBeenCalledTimes(2)
+    expect(() => fetchAndRevalidate('a').then((r) => r.clone().text())).rejects.toEqual(new Error('Fetch failed'))
+    expect(spy).toHaveBeenCalledTimes(2)
+    expect(phases1).toEqual([])
+    expect(phases2).toEqual([])
+  })
+  it('should deduplicate cached requests', async () => {
+    const spy = vi.spyOn(global, 'fetch')
+    spy.mockImplementation(async (url: string, options?: Parameters<typeof fetch>[1]) => {
+      if (options?.method == 'HEAD') {
+        return new Response('A', {
+          headers: {
+            date: yesterday.toUTCString()
+          }
+        })
+      } else {
+        return new Response('A', {
+          headers: {
+            date: yesterday.toUTCString()
+          }
+        })
+      }
+    })
+    await expect(
+      fetchAndRevalidate('a', undefined, undefined, callback1).then((r) => r.clone().text())
+    ).resolves.toEqual('A')
+    await expect(
+      fetchAndRevalidate('a', undefined, undefined, callback2).then((r) => r.clone().text())
+    ).resolves.toEqual('A')
+    expect(spy).toHaveBeenCalledTimes(2)
+    expect(phases1).toEqual([['A', 'initial']])
+    expect(phases2).toEqual([['A', 'initial']])
+    await expect(
+      fetchAndRevalidate('a', undefined, undefined, callback1).then((r) => r.clone().text())
+    ).resolves.toEqual('A')
+    expect(phases1).toEqual([
+      ['A', 'initial'],
+      ['A', 'initial']
+    ])
+    expect(phases2).toEqual([['A', 'initial']])
+    expect(spy).toHaveBeenCalledTimes(2)
+    clearFetchCache()
+    await expect(
+      fetchAndRevalidate('a', undefined, undefined, callback1).then((r) => r.clone().text())
+    ).resolves.toEqual('A')
+    expect(phases1).toEqual([
+      ['A', 'initial'],
+      ['A', 'initial'],
+      ['A', 'initial']
+    ])
+    expect(phases2).toEqual([['A', 'initial']])
+    await expect(
+      fetchAndRevalidate('a', undefined, undefined, callback2).then((r) => r.clone().text())
+    ).resolves.toEqual('A')
+    expect(phases1).toEqual([
+      ['A', 'initial'],
+      ['A', 'initial'],
+      ['A', 'initial']
+    ])
+    expect(phases2).toEqual([
+      ['A', 'initial'],
+      ['A', 'initial']
+    ])
+    expect(spy).toHaveBeenCalledTimes(4)
+  })
+  it('should deduplicate updated requests', async () => {
+    const spy = vi.spyOn(global, 'fetch')
+    spy.mockImplementation(async (url: string, options?: Parameters<typeof fetch>[1]) => {
+      if (options?.method == 'HEAD') {
+        return new Response('A', {
+          headers: {
+            'last-modified': today.toUTCString(),
+            date: todayNoon.toUTCString()
+          }
+        })
+      } else if (options?.cache == 'reload') {
+        return new Response('B', {
+          headers: {
+            'last-modified': today.toUTCString(),
+            date: today.toUTCString()
+          }
+        })
+      } else {
+        return new Response('A', {
+          headers: {
+            'last-modified': yesterday.toUTCString(),
+            date: yesterday.toUTCString()
+          }
+        })
+      }
+    })
+    await expect(
+      fetchAndRevalidate('a', undefined, undefined, callback1).then((r) => r.clone().text())
+    ).resolves.toEqual('B')
+    await expect(
+      fetchAndRevalidate('a', undefined, undefined, callback2).then((r) => r.clone().text())
+    ).resolves.toEqual('B')
+    expect(spy).toHaveBeenCalledTimes(3)
+    expect(phases1).toEqual([
+      ['A', 'initial'],
+      ['B', 'updated']
+    ])
+    expect(phases2).toEqual([
+      ['A', 'initial'],
+      ['B', 'updated']
+    ])
+    await expect(
+      fetchAndRevalidate('a', undefined, undefined, callback1).then((r) => r.clone().text())
+    ).resolves.toEqual('B')
+    expect(phases1).toEqual([
+      ['A', 'initial'],
+      ['B', 'updated'],
+      ['A', 'initial'],
+      ['B', 'updated']
+    ])
+    expect(phases2).toEqual([
+      ['A', 'initial'],
+      ['B', 'updated']
+    ])
+    expect(spy).toHaveBeenCalledTimes(3)
+    clearFetchCache()
+    await expect(
+      fetchAndRevalidate('a', undefined, undefined, callback1).then((r) => r.clone().text())
+    ).resolves.toEqual('B')
+    expect(phases1).toEqual([
+      ['A', 'initial'],
+      ['B', 'updated'],
+      ['A', 'initial'],
+      ['B', 'updated'],
+      ['A', 'initial'],
+      ['B', 'updated']
+    ])
+    expect(phases2).toEqual([
+      ['A', 'initial'],
+      ['B', 'updated']
+    ])
+    await expect(
+      fetchAndRevalidate('a', undefined, undefined, callback2).then((r) => r.clone().text())
+    ).resolves.toEqual('B')
+    expect(phases1).toEqual([
+      ['A', 'initial'],
+      ['B', 'updated'],
+      ['A', 'initial'],
+      ['B', 'updated'],
+      ['A', 'initial'],
+      ['B', 'updated']
+    ])
+    expect(phases2).toEqual([
+      ['A', 'initial'],
+      ['B', 'updated'],
+      ['A', 'initial'],
+      ['B', 'updated']
+    ])
+    expect(spy).toHaveBeenCalledTimes(6)
+  })
+})

package/test/tsconfig.json

@@ -8,8 +8,11 @@
   "references": [
     {
       "path": ".."
+    },
+    {
+      "path": "../src/ui"
     }
   ],
-  "include": ["./**/*.ts", "./**/*.tsx"],
+  "include": ["./**/*.ts", "./**/*.tsx", "../scripts/setup.ts"],
   "exclude": []
 }

package/types/cdn.d.ts

@@ -0,0 +1,57 @@
+import { ValidatableRequestPhase } from './fetch.js';
+export declare const DEFAULT_CDN_URL = "https://feaascomponentsapidev.blob.core.windows.net";
+export type FEAASCDNComponentParams = {
+    cdn?: string;
+    revision?: 'staging' | 'published' | 'saved' | number;
+    library: string;
+    component: string;
+    version: string;
+    /** @deprecated Use `cdn` instead */
+    hostname?: string;
+};
+export type FEAASCDNComponentSource = {
+    src: string;
+};
+export type FEAASCDNComponentParamsCustomizations = {
+    instance?: string;
+};
+export type FEAASCDNComponentProps = (FEAASCDNComponentParams | FEAASCDNComponentSource) & FEAASCDNComponentParamsCustomizations;
+export interface FEAASCDNStylesheetParams {
+    cdn?: string;
+    library: string;
+    revision?: 'staging' | 'published' | 'saved' | number;
+    /** @deprecated Use `cdn` instead */
+    hostname?: string;
+}
+export type FEAASCDNStylesheetSource = {
+    src: string;
+};
+export type FEAASCDNStylesheetProps = FEAASCDNStylesheetParams | FEAASCDNStylesheetSource;
+export declare function parseComponentSource(source: string): FEAASCDNComponentParams;
+export declare function getComponentSource(props: FEAASCDNComponentParams): string;
+export declare function getStylesheetSource(props: FEAASCDNStylesheetParams): string;
+export declare function parseStylesheetSource(source: string): FEAASCDNStylesheetParams;
+export declare function getComponentURL(props: FEAASCDNComponentProps): string;
+export declare function getStylesheetURL(props: FEAASCDNStylesheetProps): string;
+export declare function fetchAndRevalidateComponent(props: FEAASCDNComponentProps, callback?: (html: string) => void, dontRevalidate?: boolean): Promise<import("./fetch.js").ValidatableRequest & Required<Pick<import("./fetch.js").ValidatableRequest, "response">>>;
+/** Fetches HTML of a component. */
+export declare function fetchComponent(props: FEAASCDNComponentProps | string): Promise<{
+    template: string;
+    lastModified: string;
+    cdn?: string;
+    revision?: number | "staging" | "published" | "saved";
+    library: string;
+    component: string;
+    version: string;
+    /** @deprecated Use `cdn` instead */
+    hostname?: string;
+    instance?: string;
+} | {
+    template: string;
+    lastModified: string;
+    src: string;
+    instance?: string;
+}>;
+export type ValidatableStylesheetCallback = (css: string, phase: ValidatableRequestPhase) => void;
+export declare function fetchAndRevalidateStylesheet(props: FEAASCDNStylesheetProps | string, callback: ValidatableStylesheetCallback): Promise<Response>;
+//# sourceMappingURL=cdn.d.ts.map

package/types/cdn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdn.d.ts","sourceRoot":"","sources":["../src/cdn.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,uBAAuB,EACxB,MAAM,YAAY,CAAA;AAEnB,eAAO,MAAM,eAAe,wDAAwD,CAAA;AACpF,MAAM,MAAM,uBAAuB,GAAG;IACpC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,MAAM,CAAA;IACrD,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IAEf,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AACD,MAAM,MAAM,uBAAuB,GAAG;IACpC,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AACD,MAAM,MAAM,qCAAqC,GAAG;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AACD,MAAM,MAAM,sBAAsB,GAAG,CAAC,uBAAuB,GAAG,uBAAuB,CAAC,GACtF,qCAAqC,CAAA;AAEvC,MAAM,WAAW,wBAAwB;IACvC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,MAAM,CAAA;IAErD,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AACD,MAAM,MAAM,uBAAuB,GAAG,wBAAwB,GAAG,wBAAwB,CAAA;AAEzF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,uBAAuB,CAM5E;AACD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,UAahE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,UAIlE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,wBAAwB,CAM9E;AACD,wBAAgB,eAAe,CAAC,KAAK,EAAE,sBAAsB,UAS5D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,uBAAuB,UAS9D;AAED,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,sBAAsB,EAC7B,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EACjC,cAAc,UAAQ,0HA8CvB;AAED,mCAAmC;AACnC,wBAAsB,cAAc,CAAC,KAAK,EAAE,sBAAsB,GAAG,MAAM;;;;;;;;IAvIzE,oCAAoC;;;;;;;;GAkJrC;AAED,MAAM,MAAM,6BAA6B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,uBAAuB,KAAK,IAAI,CAAA;AACjG,wBAAsB,4BAA4B,CAChD,KAAK,EAAE,uBAAuB,GAAG,MAAM,EACvC,QAAQ,EAAE,6BAA6B,qBAoBxC"}

package/types/components/FEAASBase.d.ts

@@ -1,13 +1,37 @@
-import { ReactElement, ReactNode } from 'react';
+import type { ReactElement, ReactNode } from 'react';
 import type ReactDOMClient from 'react-dom/client';
+import type ReactDOM from 'react-dom';
 import type React from 'react';
+import { ControlledPromise } from '../utils/promise.js';
 export type OptionalExcept<T, K extends keyof T> = Pick<T, K> & Partial<Omit<T, K>>;
 declare var WebComponent: {
     new (): HTMLElement;
     prototype: HTMLElement;
 };
+export interface ReactPayload {
+    React: typeof React;
+    ReactDOM: typeof ReactDOM;
+    ReactDOMClient: typeof ReactDOMClient;
+}
+/**
+ * FEAASBase is a superclass for FEAAS components with optional react support.
+ *
+ * Initialization lifecycle:
+ *
+ * - `set(props)`
+ * - `load() => payload`
+ * - `onLoad?(payload)`
+ * - `update()`
+ * - `render(payload, props)`
+ * - `whenRendered`
+ * - - / If needs to reload, e.g. bypass cache /
+ * - - `onLoad(newPayload) `
+ * - - `whenRendered`
+ * - `whenLoaded`
+ */
 export declare class FEAASBase<Props = any, Payload = any> extends WebComponent {
     static observedAttributes: string[];
+    defaultProps: Partial<Props>;
     /** Return attributes as parsed values */
     getProps(context?: HTMLElement): any;
     /** Properties parsed in current tick */
@@ -17,10 +41,11 @@ export declare class FEAASBase<Props = any, Payload = any> extends WebComponent
     nextRender: number;
     /** Is/was component in the dom? */
     connected: boolean;
-    /** Result of lazy loading */
-    payload: Payload;
     refs: Record<string, FEAASBase>;
     descendants: FEAASBase[];
+    /** Result of lazy loading */
+    payload: Payload;
+    whenLoaded: ControlledPromise<Payload>;
     constructor();
     /** Attaches shadow root if getShadowRootOptions any settings, or uses element itself */
     getRoot(): FEAASBase | HTMLElement | ShadowRoot;
@@ -28,19 +53,21 @@ export declare class FEAASBase<Props = any, Payload = any> extends WebComponent
     attributeChangedCallback(name: string, oldValue: string, newValue: string): void;
     /** Components parses its attributes when connected, and schedules rendeirng */
     connectedCallback(): void;
+    disconnectedCallback(): void;
     /**
      * Web components are initialized depth-first, making child elements render before its parents. This could here
      * attempts to avoid this and inverts the initialization logic, so that children are initialized in the context of its
      * already-initialized parents.
      *
-     * FEAAS components dispatch `feaasConnected` event that allows components to store references to each other. In
-     * addition it allows external scripts to listen for initialization of FEAAS components
+     * FEAAS components dispatch `feaasMount` event that allows components to store references to each other. In addition
+     * it allows external scripts to listen for initialization of FEAAS components
      */
-    initialize(): boolean;
+    mount(): void;
+    log(...args: any): void;
+    /** Nothing special happens on unmount, except setting a flag */
+    unmount(): void;
     getParent(onlyFeaas?: boolean): HTMLElement;
     getElements(root?: HTMLElement | ShadowRoot, onlyFeaas?: boolean): HTMLElement[];
-    /** Nothing special happens on disconnect, except setting a flag */
-    disconnectedCallback(): void;
     /** Catch-all event handler that dispatches events to callback */
     handleEvent(event: Event): void;
     /** Act on children element being removed */
@@ -53,22 +80,196 @@ export declare class FEAASBase<Props = any, Payload = any> extends WebComponent
      * are set
      */
     isReadyToLoad(): boolean;
+    /** Generic error handler */
+    onError(error: Error, where?: string, handled?: boolean): boolean;
+    shouldUpdateOnLoad(): boolean;
+    onLoad: (payload: Payload) => void;
     /** Load lazy component & render */
-    reify(): Promise<void>;
+    advance(): Promise<void>;
+    flush(): void;
     /** Invoke preloading logic that needs to finish before component can render */
     load(): Promise<any>;
-    /** Payload is inside onLoad callback. For web components that use react, it has to provide React & ReactDOM props */
-    onLoad: (payload: Payload) => void;
     /**
      * Component-specific logic that updates the DOM. Default render implementation assume react rendering, in that case
      * the component needs to provide React & ReactDOM references in its payload. Web component redefine its render to not
      * use react at all
      */
-    update(nested?: boolean): any;
+    update(): any;
     invokeReactRendering(): ReactNode;
-    reactWrapper: (props?: any) => ReactNode;
+    reactWrapper: React.FunctionComponent;
+    reactErrorBoundary: new (...args: any) => React.Component<{
+        children: any;
+        slot: string;
+    }, {
+        error: Error;
+    }>;
     reactRoot: ReactDOMClient.Root;
-    getReactWrapper(target?: FEAASBase, displayName?: string): (props?: any) => any;
+    getReactErrorBoundary(target?: FEAASBase, displayName?: string): (new (...args: any) => React.Component<{
+        children: any;
+        slot: string;
+    }, {
+        error: Error;
+    }, any>) | {
+        new (props: {
+            children: any;
+            slot: string;
+        } | Readonly<{
+            children: any;
+            slot: string;
+        }>): {
+            state: {
+                error: Error;
+            };
+            componentDidCatch(error: Error, errorInfo: any): void;
+            render(): any;
+            context: unknown;
+            setState<K extends "error">(state: {
+                error: Error;
+            } | ((prevState: Readonly<{
+                error: Error;
+            }>, props: Readonly<{
+                children: any;
+                slot: string;
+            }>) => {
+                error: Error;
+            } | Pick<{
+                error: Error;
+            }, K>) | Pick<{
+                error: Error;
+            }, K>, callback?: () => void): void;
+            forceUpdate(callback?: () => void): void;
+            readonly props: Readonly<{
+                children: any;
+                slot: string;
+            }>;
+            refs: {
+                [key: string]: React.ReactInstance;
+            };
+            componentDidMount?(): void;
+            shouldComponentUpdate?(nextProps: Readonly<{
+                children: any;
+                slot: string;
+            }>, nextState: Readonly<{
+                error: Error;
+            }>, nextContext: any): boolean;
+            componentWillUnmount?(): void;
+            getSnapshotBeforeUpdate?(prevProps: Readonly<{
+                children: any;
+                slot: string;
+            }>, prevState: Readonly<{
+                error: Error;
+            }>): any;
+            componentDidUpdate?(prevProps: Readonly<{
+                children: any;
+                slot: string;
+            }>, prevState: Readonly<{
+                error: Error;
+            }>, snapshot?: any): void;
+            componentWillMount?(): void;
+            UNSAFE_componentWillMount?(): void;
+            componentWillReceiveProps?(nextProps: Readonly<{
+                children: any;
+                slot: string;
+            }>, nextContext: any): void;
+            UNSAFE_componentWillReceiveProps?(nextProps: Readonly<{
+                children: any;
+                slot: string;
+            }>, nextContext: any): void;
+            componentWillUpdate?(nextProps: Readonly<{
+                children: any;
+                slot: string;
+            }>, nextState: Readonly<{
+                error: Error;
+            }>, nextContext: any): void;
+            UNSAFE_componentWillUpdate?(nextProps: Readonly<{
+                children: any;
+                slot: string;
+            }>, nextState: Readonly<{
+                error: Error;
+            }>, nextContext: any): void;
+        };
+        new (props: {
+            children: any;
+            slot: string;
+        }, context: any): {
+            state: {
+                error: Error;
+            };
+            componentDidCatch(error: Error, errorInfo: any): void;
+            render(): any;
+            context: unknown;
+            setState<K extends "error">(state: {
+                error: Error;
+            } | ((prevState: Readonly<{
+                error: Error;
+            }>, props: Readonly<{
+                children: any;
+                slot: string;
+            }>) => {
+                error: Error;
+            } | Pick<{
+                error: Error;
+            }, K>) | Pick<{
+                error: Error;
+            }, K>, callback?: () => void): void;
+            forceUpdate(callback?: () => void): void;
+            readonly props: Readonly<{
+                children: any;
+                slot: string;
+            }>;
+            refs: {
+                [key: string]: React.ReactInstance;
+            };
+            componentDidMount?(): void;
+            shouldComponentUpdate?(nextProps: Readonly<{
+                children: any;
+                slot: string;
+            }>, nextState: Readonly<{
+                error: Error;
+            }>, nextContext: any): boolean;
+            componentWillUnmount?(): void;
+            getSnapshotBeforeUpdate?(prevProps: Readonly<{
+                children: any;
+                slot: string;
+            }>, prevState: Readonly<{
+                error: Error;
+            }>): any;
+            componentDidUpdate?(prevProps: Readonly<{
+                children: any;
+                slot: string;
+            }>, prevState: Readonly<{
+                error: Error;
+            }>, snapshot?: any): void;
+            componentWillMount?(): void;
+            UNSAFE_componentWillMount?(): void;
+            componentWillReceiveProps?(nextProps: Readonly<{
+                children: any;
+                slot: string;
+            }>, nextContext: any): void;
+            UNSAFE_componentWillReceiveProps?(nextProps: Readonly<{
+                children: any;
+                slot: string;
+            }>, nextContext: any): void;
+            componentWillUpdate?(nextProps: Readonly<{
+                children: any;
+                slot: string;
+            }>, nextState: Readonly<{
+                error: Error;
+            }>, nextContext: any): void;
+            UNSAFE_componentWillUpdate?(nextProps: Readonly<{
+                children: any;
+                slot: string;
+            }>, nextState: Readonly<{
+                error: Error;
+            }>, nextContext: any): void;
+        };
+        getDerivedStateFromError(error: Error): {
+            error: Error;
+        };
+        contextType?: React.Context<any>;
+    };
+    getReactElement(target?: FEAASBase, props?: any): JSX.Element;
+    getReactWrapper(target?: FEAASBase, displayName?: string): React.FunctionComponent<{}>;
     uid: string;
     getUID(): string;
     forceUpdateReact: (node?: ReactNode) => void;
@@ -81,12 +282,15 @@ export declare class FEAASBase<Props = any, Payload = any> extends WebComponent
     getShadowRoot(): ShadowRoot;
     getReactRootElement(): HTMLElement | ShadowRoot;
     /** Set props and return values on new next tick */
-    set(overrides?: Partial<Props>): void;
+    set(overrides?: Partial<Props>): this;
+    import(path: string): Promise<Payload>;
     /** Schedule rendering on next tick, to batch multiple attribute changes */
+    initialized: boolean;
+    whenRendered: ControlledPromise<this>;
     scheduleRender(): void;
     formatURL(src: string, hostname: string): string;
     getContextAttribute(name: string, element?: this): string;
-    static register(tagName: string): void;
+    static register(tagName: string, win?: Window): void;
 }
 export { FEAASBase as Base };
 //# sourceMappingURL=FEAASBase.d.ts.map

package/types/components/FEAASBase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FEAASBase.d.ts","sourceRoot":"","sources":["../../src/components/FEAASBase.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"FEAASBase.d.ts","sourceRoot":"","sources":["../../src/components/FEAASBase.tsx"],"names":[],"mappings":"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"}