sample-cross-fx 0.14.29 → 0.15.0-beta.4466

package/app/index.d.ts

@@ -7,7 +7,6 @@ import * as Riot from 'riot';
 import * as SolidJs from 'solid-js';
 import * as ReactRouter from 'react-router';
 import * as AngularCore from '@angular/core';
-import * as LibreAtom from '@libre/atom';
 
 declare module "sample-cross-fx" {
   /**
@@ -113,9 +112,47 @@ declare module "sample-cross-fx" {
   }
 
   /**
-   * Describes the metadata transported by a pilet.
+   * Describes the metadata of a pilet available in its API.
    */
-  export type PiletMetadata = (SinglePiletMetadata | MultiPiletMetadata) & PiletRuntimeMetadata;
+  export interface PiletMetadata {
+    /**
+     * The name of the pilet, i.e., the package id.
+     */
+    name: string;
+    /**
+     * The version of the pilet. Should be semantically versioned.
+     */
+    version: string;
+    /**
+     * Provides the version of the specification for this pilet.
+     */
+    spec: string;
+    /**
+     * Provides some custom metadata for the pilet.
+     */
+    custom?: any;
+    /**
+     * Optionally indicates the global require reference, if any.
+     */
+    requireRef?: string;
+    /**
+     * Additional shared dependencies from the pilet.
+     */
+    dependencies: Record<string, string>;
+    /**
+     * Provides some configuration to be used in the pilet.
+     */
+    config: Record<string, any>;
+    /**
+     * The URL of the main script of the pilet.
+     */
+    link: string;
+    /**
+     * The base path to the pilet. Can be used to make resource requests
+     * and override the public path.
+     */
+    basePath: string;
+  }
 
   /**
    * Listener for Piral app shell events.
@@ -458,7 +495,7 @@ declare module "sample-cross-fx" {
   /**
    * The meta data registered for a page.
    */
-  export interface PiralPageMeta extends PiralCustomPageMeta {}
+  export interface PiralPageMeta extends PiralCustomPageMeta, PiralCustomPageMeta {}
 
   /**
    * The shape of an implicit unregister function.
@@ -489,23 +526,6 @@ declare module "sample-cross-fx" {
     (): void;
   }
 
-  /**
-   * The metadata response for a single pilet.
-   */
-  export type SinglePiletMetadata = PiletMetadataV0 | PiletMetadataV1 | PiletMetadataV2 | PiletMetadataVx;
-
-  /**
-   * The metadata response for a multi pilet.
-   */
-  export type MultiPiletMetadata = PiletMetadataBundle;
-
-  /**
-   * Additional metadata that may be added to the runtime information.
-   */
-  export interface PiletRuntimeMetadata {
-    basePath?: string;
-  }
-
   /**
    * Custom events defined outside of piral-core.
    */
@@ -939,158 +959,6 @@ declare module "sample-cross-fx" {
     name: TName;
   }
 
-  /**
-   * Metadata for pilets using the v0 schema.
-   */
-  export type PiletMetadataV0 = PiletMetadataV0Content | PiletMetadataV0Link;
-
-  /**
-   * Metadata for pilets using the v1 schema.
-   */
-  export interface PiletMetadataV1 {
-    /**
-     * The name of the pilet, i.e., the package id.
-     */
-    name: string;
-    /**
-     * The version of the pilet. Should be semantically versioned.
-     */
-    version: string;
-    /**
-     * Optionally provides the version of the specification for this pilet.
-     */
-    spec?: "v1";
-    /**
-     * The link for retrieving the content of the pilet.
-     */
-    link: string;
-    /**
-     * The reference name for the global require.
-     */
-    requireRef: string;
-    /**
-     * The computed integrity of the pilet. Will be used to set the
-     * integrity value of the script.
-     */
-    integrity?: string;
-    /**
-     * Optionally provides some custom metadata for the pilet.
-     */
-    custom?: any;
-    /**
-     * Optionally provides some configuration to be used in the pilet.
-     */
-    config?: Record<string, any>;
-    /**
-     * Additional shared dependency script files.
-     */
-    dependencies?: Record<string, string>;
-  }
-
-  /**
-   * Metadata for pilets using the v2 schema.
-   */
-  export interface PiletMetadataV2 {
-    /**
-     * The name of the pilet, i.e., the package id.
-     */
-    name: string;
-    /**
-     * The version of the pilet. Should be semantically versioned.
-     */
-    version: string;
-    /**
-     * Provides the version of the specification for this pilet.
-     */
-    spec: "v2";
-    /**
-     * The reference name for the global require.
-     */
-    requireRef: string;
-    /**
-     * The computed integrity of the pilet.
-     */
-    integrity?: string;
-    /**
-     * The link for retrieving the content of the pilet.
-     */
-    link: string;
-    /**
-     * Optionally provides some custom metadata for the pilet.
-     */
-    custom?: any;
-    /**
-     * Optionally provides some configuration to be used in the pilet.
-     */
-    config?: Record<string, any>;
-    /**
-     * Additional shared dependency script files.
-     */
-    dependencies?: Record<string, string>;
-  }
-
-  export interface PiletMetadataVx {
-    /**
-     * The name of the pilet, i.e., the package id.
-     */
-    name: string;
-    /**
-     * The version of the pilet. Should be semantically versioned.
-     */
-    version: string;
-    /**
-     * Provides an identifier for the custom specification.
-     */
-    spec: string;
-    /**
-     * Optionally provides some custom metadata for the pilet.
-     */
-    custom?: any;
-    /**
-     * Optionally provides some configuration to be used in the pilet.
-     */
-    config?: Record<string, any>;
-    /**
-     * Additional shared dependency script files.
-     */
-    dependencies?: Record<string, string>;
-  }
-
-  /**
-   * Metadata for pilets using the bundle schema.
-   */
-  export interface PiletMetadataBundle {
-    /**
-     * The name of the bundle pilet, i.e., the package id.
-     */
-    name?: string;
-    /**
-     * Optionally provides the version of the specification for this pilet.
-     */
-    spec?: "v1";
-    /**
-     * The link for retrieving the bundle content of the pilet.
-     */
-    link: string;
-    /**
-     * The reference name for the global bundle-shared require.
-     */
-    bundle: string;
-    /**
-     * The computed integrity of the pilet. Will be used to set the
-     * integrity value of the script.
-     */
-    integrity?: string;
-    /**
-     * Optionally provides some custom metadata for the pilet.
-     */
-    custom?: any;
-    /**
-     * Additional shared dependency script files.
-     */
-    dependencies?: Record<string, string>;
-  }
-
   /**
    * Options passed through to Angular `bootstrapModule`.
    * 
@@ -1232,41 +1100,12 @@ declare module "sample-cross-fx" {
     defaults: any;
   }
 
-  /**
-   * Metadata for pilets using the v0 schema with a content.
-   */
-  export interface PiletMetadataV0Content extends PiletMetadataV0Base {
-    /**
-     * The content of the pilet. If the content is not available
-     * the link will be used (unless caching has been activated).
-     */
-    content: string;
-    /**
-     * If available indicates that the pilet should not be cached.
-     * In case of a string this is interpreted as the expiration time
-     * of the cache. In case of an accurate hash this should not be
-     * required or set.
-     */
-    noCache?: boolean | string;
-  }
-
-  /**
-   * Metadata for pilets using the v0 schema with a link.
-   */
-  export interface PiletMetadataV0Link extends PiletMetadataV0Base {
-    /**
-     * The link for retrieving the content of the pilet.
-     */
-    link: string;
-  }
-
   /**
    * The context to be transported into the generic components.
    */
   export interface ComponentContext {
-    router: ReactRouter.RouteComponentProps;
-    state: LibreAtom.Atom<GlobalState>;
-    readState: PiralActions["readState"];
+    navigation: NavigationApi;
+    publicPath: string;
   }
 
   /**
@@ -1279,779 +1118,94 @@ declare module "sample-cross-fx" {
     pilet: string;
   }
 
-  export type WrappedComponent<TProps> = React.ComponentType<Without<TProps, keyof BaseComponentProps>>;
+  export type WrappedComponent<TProps> = React.ComponentType<React.PropsWithChildren<Without<TProps, keyof BaseComponentProps>>>;
 
-  /**
-   * Basic metadata for pilets using the v0 schema.
-   */
-  export interface PiletMetadataV0Base {
-    /**
-     * The name of the pilet, i.e., the package id.
-     */
-    name: string;
-    /**
-     * The version of the pilet. Should be semantically versioned.
-     */
-    version: string;
+  export interface NavigationApi {
     /**
-     * Optionally provides the version of the specification for this pilet.
+     * Pushes a new location onto the history stack.
      */
-    spec?: "v0";
+    push(target: string, state?: any): void;
     /**
-     * The computed hash value of the pilet's content. Should be
-     * accurate to allow caching.
+     * Replaces the current location with another.
      */
-    hash: string;
+    replace(target: string, state?: any): void;
     /**
-     * Optionally provides some custom metadata for the pilet.
+     * Changes the current index in the history stack by a given delta.
      */
-    custom?: any;
+    go(n: number): void;
     /**
-     * Optionally provides some configuration to be used in the pilet.
+     * Prevents changes to the history stack from happening.
+     * This is useful when you want to prevent the user navigating
+     * away from the current page, for example when they have some
+     * unsaved data on the current page.
+     * @param blocker The function being called with a transition request.
+     * @returns The disposable for stopping the block.
      */
-    config?: Record<string, any>;
+    block(blocker: NavigationBlocker): Disposable;
     /**
-     * Additional shared dependency script files.
+     * Starts listening for location changes and calls the given
+     * callback with an Update when it does.
+     * @param listener The function being called when the route changes.
+     * @returns The disposable for stopping the block.
      */
-    dependencies?: Record<string, string>;
+    listen(listener: NavigationListener): Disposable;
   }
 
-  /**
-   * The Piral global app state container.
-   */
-  export interface GlobalState extends PiralCustomState {
-    /**
-     * The relevant state for the app itself.
-     */
-    app: AppState;
-    /**
-     * The relevant state for rendering errors of the app.
-     */
-    errorComponents: ErrorComponentsState;
-    /**
-     * The relevant state for rendering parts of the app.
-     */
-    components: ComponentsState;
-    /**
-     * The relevant state for the registered components.
-     */
-    registry: RegistryState;
-    /**
-     * Gets the loaded modules.
-     */
-    modules: Array<PiletMetadata>;
-    /**
-     * The foreign component portals to render.
-     */
-    portals: Record<string, Array<React.ReactPortal>>;
-    /**
-     * The application's shared data.
-     */
-    data: Dict<SharedDataItem>;
-    /**
-     * The used (exact) application routes.
-     */
-    routes: Dict<React.ComponentType<ReactRouter.RouteComponentProps<any>>>;
-    /**
-     * The current provider.
-     */
-    provider?: React.ComponentType;
-  }
+  export type Without<T, K> = Pick<T, Exclude<keyof T, K>>;
 
-  /**
-   * The globally defined actions.
-   */
-  export interface PiralActions extends PiralCustomActions {
-    /**
-     * Initializes the application shell.
-     * @param loading The current loading state.
-     * @param error The application error, if any.
-     * @param modules The loaded pilets.
-     */
-    initialize(loading: boolean, error: Error | undefined, modules: Array<Pilet>): void;
-    /**
-     * Injects a pilet at runtime - removes the pilet from registry first if available.
-     * @param pilet The pilet to be injected.
-     */
-    injectPilet(pilet: Pilet): void;
-    /**
-     * Defines a single action for Piral.
-     * @param actionName The name of the action to define.
-     * @param action The action to include.
-     */
-    defineAction<T extends keyof PiralActions>(actionName: T, action: PiralAction<PiralActions[T]>): void;
-    /**
-     * Defines a set of actions for Piral.
-     * @param actions The actions to define.
-     */
-    defineActions(actions: PiralDefineActions): void;
-    /**
-     * Reads the value of a shared data item.
-     * @param name The name of the shared item.
-     */
-    readDataValue(name: string): any;
-    /**
-     * Tries to write a shared data item. The write access is only
-     * possible if the name belongs to the provided owner or has not
-     * been taken yet.
-     * Setting the value to null will release it.
-     * @param name The name of the shared data item.
-     * @param value The value of the shared data item.
-     * @param owner The owner of the shared data item.
-     * @param target The target storage locatation.
-     * @param expiration The time for when to dispose the shared item.
-     */
-    tryWriteDataItem(name: string, value: any, owner: string, target: DataStoreTarget, expiration: number): boolean;
-    /**
-     * Performs a layout change.
-     * @param current The layout to take.
-     */
-    changeLayout(current: LayoutType): void;
-    /**
-     * Registers a new route to be resolved.
-     * @param route The route to register.
-     * @param value The page to be rendered on the route.
-     */
-    registerPage(route: string, value: PageRegistration): void;
-    /**
-     * Unregisters an existing route.
-     * @param route The route to be removed.
-     */
-    unregisterPage(route: string): void;
-    /**
-     * Registers a new extension.
-     * @param name The name of the extension category.
-     * @param value The extension registration.
-     */
-    registerExtension(name: string, value: ExtensionRegistration): void;
-    /**
-     * Unregisters an existing extension.
-     * @param name The name of the extension category.
-     * @param value The extension that will be removed.
-     */
-    unregisterExtension(name: string, reference: any): void;
-    /**
-     * Sets the common component to render.
-     * @param name The name of the component.
-     * @param component The component to use for rendering.
-     */
-    setComponent<TKey extends keyof ComponentsState>(name: TKey, component: ComponentsState[TKey]): void;
-    /**
-     * Sets the error component to render.
-     * @param type The type of the error.
-     * @param component The component to use for rendering.
-     */
-    setErrorComponent<TKey extends keyof ErrorComponentsState>(type: TKey, component: ErrorComponentsState[TKey]): void;
-    /**
-     * Sets the common routes to render.
-     * @param path The name of the component.
-     * @param component The component to use for rendering.
-     */
-    setRoute<T = {}>(path: string, component: React.ComponentType<ReactRouter.RouteComponentProps<T>>): void;
-    /**
-     * Includes a new provider as a sub-provider to the current provider.
-     * @param provider The provider to include.
-     */
-    includeProvider(provider: JSX.Element): void;
-    /**
-     * Destroys (i.e., resets) the given portal instance.
-     * @param id The id of the portal to destroy.
-     */
-    destroyPortal(id: string): void;
-    /**
-     * Includes the provided portal in the rendering pipeline.
-     * @param id The id of the portal to use.
-     * @param entry The child to render.
-     */
-    showPortal(id: string, entry: React.ReactPortal): void;
-    /**
-     * Hides the provided portal in the rendering pipeline.
-     * @param id The id of the portal to use.
-     * @param entry The child to remove.
-     */
-    hidePortal(id: string, entry: React.ReactPortal): void;
-    /**
-     * Updates the provided portal in the rendering pipeline.
-     * @param id The id of the portal to use.
-     * @param current The currently displayed child.
-     * @param next The updated child that should be displayed.
-     */
-    updatePortal(id: string, current: React.ReactPortal, next: React.ReactPortal): void;
-    /**
-     * Dispatches a state change.
-     * @param update The update function creating a new state.
-     */
-    dispatch(update: (state: GlobalState) => GlobalState): void;
-    /**
-     * Reads the selected part of the global state.
-     * @param select The selector for getting the desired part.
-     * @returns The desired part.
-     */
-    readState<S>(select: (state: GlobalState) => S): S;
+  export interface NavigationBlocker {
+    (tx: NavigationTransition): void;
   }
 
-  export type Without<T, K> = Pick<T, Exclude<keyof T, K>>;
+  export interface NavigationListener {
+    (update: NavigationUpdate): void;
+  }
 
-  /**
-   * Custom state extensions defined outside of piral-core.
-   */
-  export interface PiralCustomState {}
+  export interface NavigationTransition extends NavigationUpdate {
+    retry(): void;
+  }
 
-  /**
-   * The Piral global app sub-state container for app information.
-   */
-  export interface AppState {
-    /**
-     * Information for the layout computation.
-     */
-    layout: LayoutType;
-    /**
-     * Gets if the application is currently performing a background loading
-     * activity, e.g., for loading modules asynchronously or fetching
-     * translations.
-     */
-    loading: boolean;
-    /**
-     * Gets an unrecoverable application error, if any.
-     */
-    error: Error | undefined;
-    /**
-     * Gets the public path of the application.
-     */
-    publicPath: string;
+  export interface NavigationUpdate {
+    action: NavigationAction;
+    location: NavigationLocation;
   }
 
-  export type ErrorComponentsState = {
-    [P in keyof Errors]?: React.ComponentType<Errors[P]>;
-  };
+  export type NavigationAction = "POP" | "PUSH" | "REPLACE";
 
-  /**
-   * The Piral global app sub-state container for shared components.
-   */
-  export interface ComponentsState extends PiralCustomComponentsState {
+  export interface NavigationLocation {
     /**
-     * The loading indicator renderer.
+     * The fully qualified URL incl. the origin and base path.
      */
-    LoadingIndicator: React.ComponentType<LoadingIndicatorProps>;
+    href: string;
     /**
-     * The error renderer.
+     * The location.pathname property is a string that contains an initial "/"
+     * followed by the remainder of the URL up to the ?.
      */
-    ErrorInfo: React.ComponentType<ErrorInfoProps>;
+    pathname: string;
     /**
-     * The router context.
+     * The location.search property is a string that contains an initial "?"
+     * followed by the key=value pairs in the query string. If there are no
+     * parameters, this value may be the empty string (i.e. '').
      */
-    Router: React.ComponentType<RouterProps>;
+    search: string;
     /**
-     * The layout used for pages.
+     * The location.hash property is a string that contains an initial "#"
+     * followed by fragment identifier of the URL. If there is no fragment
+     * identifier, this value may be the empty string (i.e. '').
      */
-    Layout: React.ComponentType<LayoutProps>;
+    hash: string;
     /**
-     * The route switch used for determining the route registration.
+     * The location.state property is a user-supplied State object that is
+     * associated with this location. This can be a useful place to store
+     * any information you do not want to put in the URL, e.g. session-specific
+     * data.
      */
-    RouteSwitch: React.ComponentType<RouteSwitchProps>;
+    state: unknown;
     /**
-     * A component that can be used for debugging purposes.
+     * The location.key property is a unique string associated with this location.
+     * On the initial location, this will be the string default. On all subsequent
+     * locations, this string will be a unique identifier.
      */
-    Debug?: React.ComponentType;
-  }
-
-  /**
-   * The Piral global app sub-state container for component registrations.
-   */
-  export interface RegistryState extends PiralCustomRegistryState {
-    /**
-     * The registered page components for the router.
-     */
-    pages: Dict<PageRegistration>;
-    /**
-     * The registered extension components for extension slots.
-     */
-    extensions: Dict<Array<ExtensionRegistration>>;
-    /**
-     * The registered wrappers for any component.
-     */
-    wrappers: Dict<React.ComponentType<any>>;
-  }
-
-  export type Dict<T> = Record<string, T>;
-
-  /**
-   * Defines the shape of a shared data item.
-   */
-  export interface SharedDataItem<TValue = any> {
-    /**
-     * Gets the associated value.
-     */
-    value: TValue;
-    /**
-     * Gets the owner of the item.
-     */
-    owner: string;
-    /**
-     * Gets the storage location.
-     */
-    target: DataStoreTarget;
-    /**
-     * Gets the expiration of the item.
-     */
-    expires: number;
-  }
-
-  /**
-   * Custom actions defined outside of piral-core.
-   */
-  export interface PiralCustomActions {
-    /**
-     * Registers a new tile.
-     * @param name The name of the tile.
-     * @param value The tile registration.
-     */
-    registerTile(name: string, value: TileRegistration): void;
-    /**
-     * Unregisters an existing tile.
-     * @param name The name of the tile to be removed.
-     */
-    unregisterTile(name: string): void;
-  }
-
-  /**
-   * An evaluated pilet, i.e., a full pilet: functionality and metadata.
-   */
-  export type Pilet = SinglePilet | MultiPilet;
-
-  /**
-   * The shape of an app action in Piral.
-   */
-  export interface PiralAction<T extends (...args: any) => any> {
-    (ctx: GlobalStateContext, ...args: Parameters<T>): ReturnType<T>;
-  }
-
-  /**
-   * A subset of the available app actions in Piral.
-   */
-  export type PiralDefineActions = Partial<{
-    [P in keyof PiralActions]: PiralAction<PiralActions[P]>;
-  }>;
-
-  /**
-   * The different known layout types.
-   */
-  export type LayoutType = "mobile" | "tablet" | "desktop";
-
-  /**
-   * The interface modeling the registration of a pilet page component.
-   */
-  export interface PageRegistration extends BaseRegistration {
-    /**
-     * The registered page component.
-     */
-    component: WrappedComponent<PageComponentProps>;
-    /**
-     * The page's associated metadata.
-     */
-    meta: PiralPageMeta;
-  }
-
-  /**
-   * Map of all error types to their respective props.
-   */
-  export interface Errors extends PiralCustomErrors {
-    /**
-     * The props type for an extension error.
-     */
-    extension: ExtensionErrorInfoProps;
-    /**
-     * The props type for a loading error.
-     */
-    loading: LoadingErrorInfoProps;
-    /**
-     * The props type for a page error.
-     */
-    page: PageErrorInfoProps;
-    /**
-     * The props type for a not found error.
-     */
-    not_found: NotFoundErrorInfoProps;
-    /**
-     * The props type for an unknown error.
-     */
-    unknown: UnknownErrorInfoProps;
-  }
-
-  /**
-   * Custom parts of the global custom component state defined outside of piral-core.
-   */
-  export interface PiralCustomComponentsState {
-    /**
-     * The dashboard container component.
-     */
-    DashboardContainer: React.ComponentType<DashboardContainerProps>;
-    /**
-     * The dashboard tile component.
-     */
-    DashboardTile: React.ComponentType<DashboardTileProps>;
-  }
-
-  /**
-   * The props of a Loading indicator component.
-   */
-  export interface LoadingIndicatorProps {}
-
-  /**
-   * The props for the ErrorInfo component.
-   */
-  export type ErrorInfoProps = UnionOf<Errors>;
-
-  /**
-   * The props of a Router component.
-   */
-  export interface RouterProps {}
-
-  /**
-   * The props of a Layout component.
-   */
-  export interface LayoutProps {
-    /**
-     * The currently selected layout type.
-     */
-    currentLayout: LayoutType;
-  }
-
-  /**
-   * The props of the RouteSwitch component.
-   */
-  export interface RouteSwitchProps extends ReactRouter.SwitchProps {
-    /**
-     * The component that should be used in case nothing was found.
-     */
-    NotFound: React.ComponentType<ReactRouter.RouteComponentProps>;
-    /**
-     * The component to register for the different paths.
-     */
-    paths: Array<{
-      /**
-       * The exact path to use.
-       */
-      path: string;
-      /**
-       * The component to register for this path.
-       */
-      Component: React.ComponentType<ReactRouter.RouteComponentProps>;
-    }>;
-  }
-
-  /**
-   * Custom parts of the global registry state defined outside of piral-core.
-   */
-  export interface PiralCustomRegistryState {
-    /**
-     * The registered tile components for a dashboard.
-     */
-    tiles: Dict<TileRegistration>;
-  }
-
-  export interface TileRegistration extends BaseRegistration {
-    component: WrappedComponent<TileComponentProps>;
-    preferences: TilePreferences;
-  }
-
-  /**
-   * An evaluated single pilet.
-   */
-  export type SinglePilet = SinglePiletApp & SinglePiletMetadata;
-
-  /**
-   * An evaluated multi pilet.
-   */
-  export type MultiPilet = MultiPiletApp & MultiPiletMetadata;
-
-  /**
-   * The Piral app instance context.
-   */
-  export interface GlobalStateContext extends PiralActions, EventEmitter {
-    /**
-     * The global state context atom.
-     * Changes to the state should always be dispatched via the `dispatch` action.
-     */
-    state: LibreAtom.Atom<GlobalState>;
-    /**
-     * The API objects created for the loaded pilets.
-     */
-    apis: PiletsBag;
-    /**
-     * The available component converters.
-     */
-    converters: ComponentConverters<any>;
-    /**
-     * The initial options.
-     */
-    options: LoadPiletsOptions;
-  }
-
-  /**
-   * Custom errors defined outside of piral-core.
-   */
-  export interface PiralCustomErrors {
-    tile: TileErrorInfoProps;
-  }
-
-  /**
-   * The error used when a registered extension component crashed.
-   */
-  export interface ExtensionErrorInfoProps {
-    /**
-     * The type of the error.
-     */
-    type: "extension";
-    /**
-     * The provided error details.
-     */
-    error: any;
-    /**
-     * The name of the pilet emitting the error.
-     */
-    pilet?: string;
-  }
-
-  /**
-   * The error used when the app could not be loaded.
-   */
-  export interface LoadingErrorInfoProps {
-    /**
-     * The type of the error.
-     */
-    type: "loading";
-    /**
-     * The provided error details.
-     */
-    error: any;
-  }
-
-  /**
-   * The error used when a registered page component crashes.
-   */
-  export interface PageErrorInfoProps extends ReactRouter.RouteComponentProps {
-    /**
-     * The type of the error.
-     */
-    type: "page";
-    /**
-     * The provided error details.
-     */
-    error: any;
-    /**
-     * The name of the pilet emitting the error.
-     */
-    pilet?: string;
-  }
-
-  /**
-   * The error used when a route cannot be resolved.
-   */
-  export interface NotFoundErrorInfoProps extends ReactRouter.RouteComponentProps {
-    /**
-     * The type of the error.
-     */
-    type: "not_found";
-  }
-
-  /**
-   * The error used when the exact type is unknown.
-   */
-  export interface UnknownErrorInfoProps {
-    /**
-     * The type of the error.
-     */
-    type: "unknown";
-    /**
-     * The provided error details.
-     */
-    error: any;
-    /**
-     * The name of the pilet emitting the error.
-     */
-    pilet?: string;
-  }
-
-  export interface DashboardContainerProps extends ReactRouter.RouteComponentProps {}
-
-  export interface DashboardTileProps {
-    /**
-     * The currently used number of columns.
-     */
-    columns: number;
-    /**
-     * The currently used number of rows.
-     */
-    rows: number;
-    /**
-     * The resizable status.
-     */
-    resizable: boolean;
-    /**
-     * The provided tile preferences.
-     */
-    meta: TilePreferences;
-  }
-
-  export type UnionOf<T> = {
-    [K in keyof T]: T[K];
-  }[keyof T];
-
-  /**
-   * The pilet app, i.e., the functional exports.
-   */
-  export interface SinglePiletApp {
-    /**
-     * Integrates the evaluated pilet into the application.
-     * @param api The API to access the application.
-     */
-    setup(api: PiletApi): void | Promise<void>;
-    /**
-     * Optional function for cleanup.
-     * @param api The API to access the application.
-     */
-    teardown?(api: PiletApi): void;
-  }
-
-  /**
-   * The pilet app, i.e., the functional exports.
-   */
-  export interface MultiPiletApp {
-    /**
-     * Integrates the evaluated pilet into the application.
-     * @param api The API to access the application.
-     */
-    setup(apiFactory: PiletApiCreator): void | Promise<void>;
-  }
-
-  /**
-   * Represents the dictionary of the loaded pilets and their APIs.
-   */
-  export interface PiletsBag {
-    [name: string]: PiletApi;
-  }
-
-  /**
-   * The options for loading pilets.
-   */
-  export interface LoadPiletsOptions {
-    /**
-     * The callback function for creating an API object.
-     * The API object is passed on to a specific pilet.
-     */
-    createApi: PiletApiCreator;
-    /**
-     * The callback for fetching the dynamic pilets.
-     */
-    fetchPilets: PiletRequester;
-    /**
-     * Optionally, some already existing evaluated pilets, e.g.,
-     * helpful when debugging or in SSR scenarios.
-     */
-    pilets?: Array<Pilet>;
-    /**
-     * Optionally, configures the default loader.
-     */
-    config?: DefaultLoaderConfig;
-    /**
-     * Optionally, defines the default way how to load a pilet.
-     */
-    loadPilet?: PiletLoader;
-    /**
-     * Optionally, defines loaders for custom specifications.
-     */
-    loaders?: CustomSpecLoaders;
-    /**
-     * Gets the map of globally available dependencies with their names
-     * as keys and their evaluated pilet content as value.
-     */
-    dependencies?: AvailableDependencies;
-    /**
-     * Optionally, defines the loading strategy to use.
-     */
-    strategy?: PiletLoadingStrategy;
-  }
-
-  export interface TileErrorInfoProps {
-    /**
-     * The type of the error.
-     */
-    type: "tile";
-    /**
-     * The provided error details.
-     */
-    error: any;
-    /**
-     * The currently used number of columns.
-     */
-    columns: number;
-    /**
-     * The currently used number of rows.
-     */
-    rows: number;
-    /**
-     * The name of the pilet emitting the error.
-     */
-    pilet?: string;
-  }
-
-  /**
-   * The creator function for the pilet API.
-   */
-  export interface PiletApiCreator {
-    (target: PiletMetadata): PiletApi;
-  }
-
-  /**
-   * The interface describing a function capable of fetching pilets.
-   */
-  export interface PiletRequester {
-    (): Promise<Array<PiletMetadata>>;
-  }
-
-  /**
-   * Additional configuration options for the default loader.
-   */
-  export interface DefaultLoaderConfig {
-    /**
-     * Sets the cross-origin attribute of potential script tags.
-     * For pilets v1 this may be useful. Otherwise, only pilets that
-     * have an integrity defined will be set to "anonymous".
-     */
-    crossOrigin?: string;
-  }
-
-  /**
-   * The callback to be used to load a single pilet.
-   */
-  export interface PiletLoader {
-    (meta: PiletMetadata): Promise<Pilet>;
-  }
-
-  /**
-   * Defines the spec identifiers for custom loading.
-   */
-  export type CustomSpecLoaders = Record<string, PiletLoader>;
-
-  /**
-   * The record containing all available dependencies.
-   */
-  export interface AvailableDependencies {
-    [name: string]: any;
-  }
-
-  /**
-   * The strategy for how pilets are loaded at runtime.
-   */
-  export interface PiletLoadingStrategy {
-    (options: LoadPiletsOptions, pilets: PiletsLoaded): PromiseLike<void>;
-  }
-
-  /**
-   * The callback to be used when pilets have been loaded.
-   */
-  export interface PiletsLoaded {
-    (error: Error | undefined, pilets: Array<Pilet>): void;
+    key: string;
   }
 }