sample-piral 0.14.28 → 0.15.0-beta.4465

package/app/index.d.ts

@@ -1,6 +1,5 @@
 import * as React from 'react';
 import * as ReactRouter from 'react-router';
-import * as LibreAtom from '@libre/atom';
 
 declare module "sample-piral" {
   /**
@@ -40,7 +39,7 @@ declare module "sample-piral" {
   /**
    * Custom Pilet API parts defined outside of piral-core.
    */
-  export interface PiletCustomApi extends PiletLocaleApi, PiletDashboardApi, PiletMenuApi, PiletNotificationsApi, PiletModalsApi, PiletFeedsApi, PiletSearchApi, PiralAuthApi {}
+  export interface PiletCustomApi extends PiletLocaleApi, PiletDashboardApi, PiletMenuApi, PiletNotificationsApi, PiletModalsApi, PiletFeedsApi, PiletSearchApi, PiletAuthApi {}
 
   /**
    * Defines the Pilet API from piral-core.
@@ -106,9 +105,47 @@ declare module "sample-piral" {
   }
 
   /**
-   * 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.
@@ -272,7 +309,7 @@ declare module "sample-piral" {
     unregisterSearchProvider(name: string): void;
   }
 
-  export interface PiralAuthApi {
+  export interface PiletAuthApi {
     /**
      * Gets the currently authenticated user, if any.
      */
@@ -309,7 +346,7 @@ declare module "sample-piral" {
   /**
    * 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.
@@ -340,23 +377,6 @@ declare module "sample-piral" {
     (): 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.
    */
@@ -651,158 +671,6 @@ declare module "sample-piral" {
     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>;
-  }
-
   export interface PiralSelectLanguageEvent {
     /**
      * Gets the previously selected language.
@@ -988,34 +856,6 @@ declare module "sample-piral" {
     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;
-  }
-
   export type StandardMenuType = "general" | "admin" | "user" | "header" | "footer";
 
   export interface PiralCustomMenuTypes {}
@@ -1031,7 +871,6 @@ declare module "sample-piral" {
    */
   export interface ComponentContext {
     router: ReactRouter.RouteComponentProps;
-    state: LibreAtom.Atom<GlobalState>;
     readState: PiralActions["readState"];
   }
 
@@ -1045,117 +884,52 @@ declare module "sample-piral" {
     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.
+   * The globally defined actions.
    */
-  export interface PiletMetadataV0Base {
-    /**
-     * The name of the pilet, i.e., the package id.
-     */
-    name: string;
+  export interface PiralActions extends PiralCustomActions {
     /**
-     * The version of the pilet. Should be semantically versioned.
+     * Initializes the application shell.
+     * @param loading The current loading state.
+     * @param error The application error, if any.
+     * @param modules The loaded pilets.
      */
-    version: string;
+    initialize(loading: boolean, error: Error | undefined, modules: Array<Pilet>): void;
     /**
-     * Optionally provides the version of the specification for this pilet.
+     * Injects an evaluated pilet at runtime - removes the pilet from registry first if available.
+     * @param pilet The pilet to be injected.
+     * @returns The injected pilet.
      */
-    spec?: "v0";
+    injectPilet(pilet: Pilet): Pilet;
     /**
-     * The computed hash value of the pilet's content. Should be
-     * accurate to allow caching.
+     * Adds a pilet at runtime by loading it, evaluating it, and then injecting it.
+     * @param pilet The pilet to be added.
+     * @returns The promise indicating when the pilet was fully added.
      */
-    hash: string;
+    addPilet(pilet: PiletEntry): Promise<void>;
     /**
-     * Optionally provides some custom metadata for the pilet.
+     * Removes a pilet by unloading it and deleting all component registrations.
+     * @param name The name of the pilet to remove.
      */
-    custom?: any;
+    removePilet(name: string): Promise<void>;
     /**
-     * Optionally provides some configuration to be used in the pilet.
+     * Defines a single action for Piral.
+     * @param actionName The name of the action to define.
+     * @param action The action to include.
      */
-    config?: Record<string, any>;
+    defineAction<T extends keyof PiralActions>(actionName: T, action: PiralAction<PiralActions[T]>): void;
     /**
-     * Additional shared dependency script files.
+     * Defines a set of actions for Piral.
+     * @param actions The actions to define.
      */
-    dependencies?: Record<string, string>;
-  }
-
-  /**
-   * The Piral global app state container.
-   */
-  export interface GlobalState extends PiralCustomState {
+    defineActions(actions: PiralDefineActions): void;
     /**
-     * The relevant state for the app itself.
+     * Reads the value of a shared data item.
+     * @param name The name of the shared item.
      */
-    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;
-  }
-
-  /**
-   * 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;
+    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
@@ -1168,11 +942,6 @@ declare module "sample-piral" {
      * @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.
@@ -1254,152 +1023,15 @@ declare module "sample-piral" {
      * @returns The desired part.
      */
     readState<S>(select: (state: GlobalState) => S): S;
-  }
-
-  export type Without<T, K> = Pick<T, Exclude<keyof T, K>>;
-
-  /**
-   * Custom state extensions defined outside of piral-core.
-   */
-  export interface PiralCustomState {
-    /**
-     * Information for the language display.
-     */
-    language: {
-      /**
-       * Gets if languages are currently loading.
-       */
-      loading: boolean;
-      /**
-       * The selected, i.e., active, language.
-       */
-      selected: string;
-      /**
-       * The available languages.
-       */
-      available: Array<string>;
-    };
-    /**
-     * The currently open notifications.
-     */
-    notifications: Array<OpenNotification>;
-    /**
-     * The currently open modal dialogs.
-     */
-    modals: Array<OpenModalDialog>;
-    /**
-     * The relevant state for the registered feeds.
-     */
-    feeds: FeedsState;
-    /**
-     * The relevant state for the in-site search.
-     */
-    search: SearchState;
-    /**
-     * The currently authenticated user, if any.
-     */
-    user: UserInfo | undefined;
-  }
-
-  /**
-   * 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 type ErrorComponentsState = {
-    [P in keyof Errors]?: React.ComponentType<Errors[P]>;
-  };
-
-  /**
-   * The Piral global app sub-state container for shared components.
-   */
-  export interface ComponentsState extends PiralCustomComponentsState {
-    /**
-     * The loading indicator renderer.
-     */
-    LoadingIndicator: React.ComponentType<LoadingIndicatorProps>;
-    /**
-     * The error renderer.
-     */
-    ErrorInfo: React.ComponentType<ErrorInfoProps>;
-    /**
-     * The router context.
-     */
-    Router: React.ComponentType<RouterProps>;
-    /**
-     * The layout used for pages.
-     */
-    Layout: React.ComponentType<LayoutProps>;
-    /**
-     * The route switch used for determining the route registration.
-     */
-    RouteSwitch: React.ComponentType<RouteSwitchProps>;
-    /**
-     * A component that can be used for debugging purposes.
-     */
-    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.
+     * Performs a navigation.
+     * @param path The path to navigate to.
+     * @param state The optional state for the navigation.
      */
-    wrappers: Dict<React.ComponentType<any>>;
+    navigate(path: string, state?: any): void;
   }
 
-  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;
-  }
+  export type Without<T, K> = Pick<T, Exclude<keyof T, K>>;
 
   /**
    * Custom actions defined outside of piral-core.
@@ -1558,6 +1190,11 @@ declare module "sample-piral" {
    */
   export type Pilet = SinglePilet | MultiPilet;
 
+  /**
+   * Pilet entry representing part of a response from the feed service.
+   */
+  export type PiletEntry = MultiPiletEntry | SinglePiletEntry;
+
   /**
    * The shape of an app action in Piral.
    */
@@ -1572,11 +1209,6 @@ declare module "sample-piral" {
     [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.
    */
@@ -1591,303 +1223,826 @@ declare module "sample-piral" {
     meta: PiralPageMeta;
   }
 
-  export interface OpenNotification {
-    id: string;
-    component: React.ComponentType<BareNotificationProps>;
-    options: NotificationOptions;
-    close(): void;
-  }
-
-  export interface OpenModalDialog {
+  /**
+   * The Piral global app sub-state container for shared components.
+   */
+  export interface ComponentsState extends PiralCustomComponentsState {
     /**
-     * Gets the ID of the modal to open. For tracking its state.
+     * The loading indicator renderer.
      */
-    id: string;
+    LoadingIndicator: React.ComponentType<LoadingIndicatorProps>;
     /**
-     * Specifies the fully qualified name of the dialog to show.
+     * The error renderer.
      */
-    name: string;
+    ErrorInfo: React.ComponentType<ErrorInfoProps>;
     /**
-     * Specifies the alternative (original) name of the dialog to show.
+     * The router context.
      */
-    alternative?: string;
+    Router: React.ComponentType<RouterProps>;
     /**
-     * Defines the transported options.
+     * The layout used for pages.
      */
-    options: BaseModalOptions;
+    Layout: React.ComponentType<LayoutProps>;
     /**
-     * Closes the modal dialog.
+     * The route switch used for determining the route registration.
      */
-    close(): void;
+    RouteSwitch: React.ComponentType<RouteSwitchProps>;
+    /**
+     * A component that can be used for debugging purposes.
+     */
+    Debug?: React.ComponentType;
   }
 
-  export interface FeedsState {
-    [id: string]: FeedDataState;
-  }
+  export type ErrorComponentsState = {
+    [P in keyof Errors]?: React.ComponentType<Errors[P]>;
+  };
 
-  export interface SearchState {
+  /**
+   * 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<Pilet>;
+    /**
+     * 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 interface LanguageData {
+    global: Translations;
+    locals: Array<{
+      name: string;
+      value: Translations;
+    }>;
+  }
+
+  export interface TileRegistration extends BaseRegistration {
+    component: WrappedComponent<TileComponentProps>;
+    preferences: TilePreferences;
+  }
+
+  export interface MenuItemRegistration extends BaseRegistration {
+    component: WrappedComponent<MenuComponentProps>;
+    settings: MenuSettings;
+  }
+
+  export interface OpenNotification {
+    id: string;
+    component: React.ComponentType<BareNotificationProps>;
+    options: NotificationOptions;
+    close(): void;
+  }
+
+  export interface OpenModalDialog {
+    /**
+     * Gets the ID of the modal to open. For tracking its state.
+     */
+    id: string;
+    /**
+     * Specifies the fully qualified name of the dialog to show.
+     */
+    name: string;
+    /**
+     * Specifies the alternative (original) name of the dialog to show.
+     */
+    alternative?: string;
+    /**
+     * Defines the transported options.
+     */
+    options: BaseModalOptions;
+    /**
+     * Closes the modal dialog.
+     */
+    close(): void;
+  }
+
+  export interface ModalRegistration extends BaseRegistration {
+    name: string;
+    component: WrappedComponent<ModalComponentProps<any>>;
+    defaults: any;
+    layout: ModalLayoutOptions;
+  }
+
+  export interface ConnectorDetails<TData, TItem, TReducers extends FeedConnectorReducers<TData> = {}> extends FeedConnectorOptions<TData, TItem, TReducers> {
+    /**
+     * The ID of the connector.
+     */
+    id: string;
+    /**
+     * The dispose function if active.
+     */
+    dispose?(): void;
+  }
+
+  export interface SearchProviderRegistration extends BaseRegistration {
+    search: SearchHandler;
+    cancel(): void;
+    clear(): void;
+    onlyImmediate: boolean;
+  }
+
+  /**
+   * An evaluated single pilet.
+   */
+  export type SinglePilet = SinglePiletApp & PiletMetadata;
+
+  /**
+   * An evaluated multi pilet.
+   */
+  export type MultiPilet = MultiPiletApp & PiletMetadata;
+
+  /**
+   * The metadata response for a multi pilet.
+   */
+  export type MultiPiletEntry = PiletBundleEntry;
+
+  /**
+   * The metadata response for a single pilet.
+   */
+  export type SinglePiletEntry = PiletV0Entry | PiletV1Entry | PiletV2Entry | PiletVxEntry;
+
+  /**
+   * 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: UseBoundStore<GlobalState>;
+    /**
+     * The API objects created for the loaded pilets.
+     */
+    apis: PiletsBag;
+    /**
+     * The available component converters.
+     */
+    converters: ComponentConverters<any>;
+    /**
+     * The initial options.
+     */
+    options: LoadPiletsOptions;
+  }
+
+  /**
+   * Custom parts of the global custom component state defined outside of piral-core.
+   */
+  export interface PiralCustomComponentsState {
+    /**
+     * Represents the component for rendering a language selection.
+     */
+    LanguagesPicker: React.ComponentType<LanguagesPickerProps>;
+    /**
+     * The dashboard container component.
+     */
+    DashboardContainer: React.ComponentType<DashboardContainerProps>;
+    /**
+     * The dashboard tile component.
+     */
+    DashboardTile: React.ComponentType<DashboardTileProps>;
+    /**
+     * The menu container component.
+     */
+    MenuContainer: React.ComponentType<MenuContainerProps>;
+    /**
+     * The menu item component.
+     */
+    MenuItem: React.ComponentType<MenuItemProps>;
+    /**
+     * The host component for notifications.
+     */
+    NotificationsHost: React.ComponentType<NotificationsHostProps>;
+    /**
+     * The notification toast component.
+     */
+    NotificationsToast: React.ComponentType<NotificationsToastProps>;
+    /**
+     * The host component for modal dialogs.
+     */
+    ModalsHost: React.ComponentType<ModalsHostProps>;
+    /**
+     * The modal dialog component.
+     */
+    ModalsDialog: React.ComponentType<ModalsDialogProps>;
+    /**
+     * The component for showing the results of the search.
+     */
+    SearchResult: React.ComponentType<SearchResultProps>;
+    /**
+     * The container for showing search.
+     */
+    SearchContainer: React.ComponentType<SearchContainerProps>;
+    /**
+     * The input component for search capability.
+     */
+    SearchInput: React.ComponentType<SearchInputProps>;
+  }
+
+  /**
+   * 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 content to be rendered inside the router.
+     */
+    children?: React.ReactNode;
+  }
+
+  /**
+   * The props of a Layout component.
+   */
+  export interface LayoutProps {
+    /**
+     * The currently selected layout type.
+     */
+    currentLayout: LayoutType;
+    /**
+     * The page's content.
+     */
+    children: React.ReactNode;
+  }
+
+  /**
+   * 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<AppPath>;
+  }
+
+  /**
+   * 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 state extensions defined outside of piral-core.
+   */
+  export interface PiralCustomState {
+    /**
+     * Information for the language display.
+     */
+    language: {
+      /**
+       * Gets if languages are currently loading.
+       */
+      loading: boolean;
+      /**
+       * The selected, i.e., active, language.
+       */
+      selected: string;
+      /**
+       * The available languages.
+       */
+      available: Array<string>;
+    };
+    /**
+     * The currently open notifications.
+     */
+    notifications: Array<OpenNotification>;
+    /**
+     * The currently open modal dialogs.
+     */
+    modals: Array<OpenModalDialog>;
+    /**
+     * The relevant state for the registered feeds.
+     */
+    feeds: FeedsState;
+    /**
+     * The relevant state for the in-site search.
+     */
+    search: SearchState;
+    /**
+     * The currently authenticated user, if any.
+     */
+    user: UserInfo | undefined;
+  }
+
+  /**
+   * The Piral global app sub-state container for app information.
+   */
+  export interface AppState {
+    /**
+     * Gets if the application is currently performing a background loading
+     * activity, e.g., for loading modules asynchronously or fetching
+     * translations.
+     */
+    loading: boolean;
     /**
-     * Gets the current input value.
+     * Gets an unrecoverable application error, if any.
      */
-    input: string;
+    error: Error | undefined;
     /**
-     * Gets the current result state.
+     * Gets the public path of the application.
      */
-    results: {
-      /**
-       * Gets weather the search is still loading.
-       */
-      loading: boolean;
-      /**
-       * The results to display for the current search.
-       */
-      items: Array<React.ReactChild>;
-    };
+    publicPath: string;
   }
 
   /**
-   * Map of all error types to their respective props.
+   * The Piral global app sub-state container for component registrations.
    */
-  export interface Errors extends PiralCustomErrors {
+  export interface RegistryState extends PiralCustomRegistryState {
     /**
-     * The props type for an extension error.
+     * The registered page components for the router.
      */
-    extension: ExtensionErrorInfoProps;
+    pages: Dict<PageRegistration>;
     /**
-     * The props type for a loading error.
+     * 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;
+  }
+
+  export interface SearchHandler {
+    (options: SearchOptions): Promise<Array<React.ReactChild>>;
+  }
+
+  /**
+   * 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>;
+  }
+
+  /**
+   * Metadata for pilets using the bundle schema.
+   */
+  export interface PiletBundleEntry {
+    /**
+     * 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>;
+  }
+
+  /**
+   * Metadata for pilets using the v0 schema.
+   */
+  export type PiletV0Entry = PiletV0ContentEntry | PiletV0LinkEntry;
+
+  /**
+   * Metadata for pilets using the v1 schema.
+   */
+  export interface PiletV1Entry {
+    /**
+     * 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 PiletV2Entry {
+    /**
+     * 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 PiletVxEntry {
+    /**
+     * 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>;
+  }
+
+  export type UseBoundStore<T extends State, CustomStoreApi extends StoreApi<T> = StoreApi<T>> = {
+    (): T;
+    <U>(selector: StateSelector<T, U>, equalityFn?: EqualityChecker<U>): U;
+  } & CustomStoreApi;
+
+  /**
+   * 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.
      */
-    loading: LoadingErrorInfoProps;
+    createApi: PiletApiCreator;
     /**
-     * The props type for a page error.
+     * The callback for fetching the dynamic pilets.
      */
-    page: PageErrorInfoProps;
+    fetchPilets: PiletRequester;
     /**
-     * The props type for a not found error.
+     * Optionally, some already existing evaluated pilets, e.g.,
+     * helpful when debugging or in SSR scenarios.
      */
-    not_found: NotFoundErrorInfoProps;
+    pilets?: Array<Pilet>;
     /**
-     * The props type for an unknown error.
+     * Optionally, configures the default loader.
      */
-    unknown: UnknownErrorInfoProps;
-  }
-
-  /**
-   * Custom parts of the global custom component state defined outside of piral-core.
-   */
-  export interface PiralCustomComponentsState {
+    config?: DefaultLoaderConfig;
     /**
-     * Represents the component for rendering a language selection.
+     * Optionally, defines the default way how to load a pilet.
      */
-    LanguagesPicker: React.ComponentType<LanguagesPickerProps>;
+    loadPilet?: PiletLoader;
     /**
-     * The dashboard container component.
+     * Optionally, defines loaders for custom specifications.
      */
-    DashboardContainer: React.ComponentType<DashboardContainerProps>;
+    loaders?: CustomSpecLoaders;
     /**
-     * The dashboard tile component.
+     * Optionally, defines a set of loading hooks to be used.
      */
-    DashboardTile: React.ComponentType<DashboardTileProps>;
+    hooks?: PiletLifecycleHooks;
     /**
-     * The menu container component.
+     * Gets the map of globally available dependencies with their names
+     * as keys and their evaluated pilet content as value.
      */
-    MenuContainer: React.ComponentType<MenuContainerProps>;
+    dependencies?: AvailableDependencies;
     /**
-     * The menu item component.
+     * Optionally, defines the loading strategy to use.
      */
-    MenuItem: React.ComponentType<MenuItemProps>;
+    strategy?: PiletLoadingStrategy;
+  }
+
+  export interface LanguagesPickerProps {
     /**
-     * The host component for notifications.
+     * The currently selected language.
      */
-    NotificationsHost: React.ComponentType<NotificationsHostProps>;
+    selected: string;
     /**
-     * The notification toast component.
+     * The languages available for selection.
      */
-    NotificationsToast: React.ComponentType<NotificationsToastProps>;
+    available: Array<string>;
+  }
+
+  export interface DashboardContainerProps extends ReactRouter.RouteComponentProps {
     /**
-     * The host component for modal dialogs.
+     * The tiles to display.
      */
-    ModalsHost: React.ComponentType<ModalsHostProps>;
+    children?: React.ReactNode;
+  }
+
+  export interface DashboardTileProps {
     /**
-     * The modal dialog component.
+     * The currently used number of columns.
      */
-    ModalsDialog: React.ComponentType<ModalsDialogProps>;
+    columns: number;
     /**
-     * The component for showing the results of the search.
+     * The currently used number of rows.
      */
-    SearchResult: React.ComponentType<SearchResultProps>;
+    rows: number;
     /**
-     * The container for showing search.
+     * The resizable status.
      */
-    SearchContainer: React.ComponentType<SearchContainerProps>;
+    resizable: boolean;
     /**
-     * The input component for search capability.
+     * The provided tile preferences.
      */
-    SearchInput: React.ComponentType<SearchInputProps>;
-  }
-
-  /**
-   * 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 {
+    meta: TilePreferences;
     /**
-     * The currently selected layout type.
+     * The content of the tile to display.
      */
-    currentLayout: LayoutType;
+    children?: React.ReactNode;
   }
 
-  /**
-   * The props of the RouteSwitch component.
-   */
-  export interface RouteSwitchProps extends ReactRouter.SwitchProps {
+  export interface MenuContainerProps {
     /**
-     * The component that should be used in case nothing was found.
+     * The type of the menu.
      */
-    NotFound: React.ComponentType<ReactRouter.RouteComponentProps>;
+    type: MenuType;
     /**
-     * The component to register for the different paths.
+     * The menu items to display.
      */
-    paths: Array<{
-      /**
-       * The exact path to use.
-       */
-      path: string;
-      /**
-       * The component to register for this path.
-       */
-      Component: React.ComponentType<ReactRouter.RouteComponentProps>;
-    }>;
+    children?: React.ReactNode;
   }
 
-  /**
-   * 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 MenuItemProps {
     /**
-     * The registered menu items for global display.
+     * The type of the menu.
      */
-    menuItems: Dict<MenuItemRegistration>;
+    type: MenuType;
     /**
-     * The registered modal dialog components.
+     * The provided menu settings.
      */
-    modals: Dict<ModalRegistration>;
+    meta: MenuSettings;
     /**
-     * The registered search providers for context aware search.
+     * The content of the menu item.
      */
-    searchProviders: Dict<SearchProviderRegistration>;
-  }
-
-  export interface LanguageData {
-    global: Translations;
-    locals: Array<{
-      name: string;
-      value: Translations;
-    }>;
-  }
-
-  export interface TileRegistration extends BaseRegistration {
-    component: WrappedComponent<TileComponentProps>;
-    preferences: TilePreferences;
+    children?: React.ReactNode;
   }
 
-  export interface MenuItemRegistration extends BaseRegistration {
-    component: WrappedComponent<MenuComponentProps>;
-    settings: MenuSettings;
+  export interface NotificationsHostProps {
+    /**
+     * The notifications to display.
+     */
+    children?: React.ReactNode;
   }
 
-  export interface ModalRegistration extends BaseRegistration {
-    name: string;
-    component: WrappedComponent<ModalComponentProps<any>>;
-    defaults: any;
-    layout: ModalLayoutOptions;
+  export interface NotificationsToastProps extends BareNotificationProps {
+    /**
+     * The content of the toast to display.
+     */
+    children?: React.ReactNode;
   }
 
-  export interface ConnectorDetails<TData, TItem, TReducers extends FeedConnectorReducers<TData> = {}> extends FeedConnectorOptions<TData, TItem, TReducers> {
+  export interface ModalsHostProps {
     /**
-     * The ID of the connector.
+     * Gets if the modal is currently open or closed.
      */
-    id: string;
+    open: boolean;
     /**
-     * The dispose function if active.
+     * Callback to invoke closing the modal dialog.
      */
-    dispose?(): void;
-  }
-
-  export interface SearchProviderRegistration extends BaseRegistration {
-    search: SearchHandler;
-    cancel(): void;
-    clear(): void;
-    onlyImmediate: boolean;
+    close(): void;
+    /**
+     * The dialogs to display.
+     */
+    children?: React.ReactNode;
   }
 
-  /**
-   * 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 {
+  export interface ModalsDialogProps extends OpenModalDialog {
     /**
-     * The global state context atom.
-     * Changes to the state should always be dispatched via the `dispatch` action.
+     * The layout options given for the current dialog.
      */
-    state: LibreAtom.Atom<GlobalState>;
+    layout: ModalLayoutOptions;
     /**
-     * The API objects created for the loaded pilets.
+     * The provided default options.
      */
-    apis: PiletsBag;
+    defaults: any;
     /**
-     * The available component converters.
+     * The content of the dialog to display.
      */
-    converters: ComponentConverters<any>;
+    children?: React.ReactNode;
+  }
+
+  export interface SearchResultProps {
     /**
-     * The initial options.
+     * The search results to display.
      */
-    options: LoadPiletsOptions;
+    children?: React.ReactNode;
   }
 
-  export interface FeedDataState {
+  export interface SearchContainerProps {
     /**
-     * Determines if the feed data is currently loading.
+     * Gets if the results are still gathered.
      */
     loading: boolean;
     /**
-     * Indicates if the feed data was already loaded and is active.
+     * The search to display.
      */
-    loaded: boolean;
+    children?: React.ReactNode;
+  }
+
+  export interface SearchInputProps {
+    setValue(value: string): void;
+    value: string;
+  }
+
+  export type UnionOf<T> = {
+    [K in keyof T]: T[K];
+  }[keyof T];
+
+  /**
+   * The different known layout types.
+   */
+  export type LayoutType = "mobile" | "tablet" | "desktop";
+
+  /**
+   * Represents a path in the app registration.
+   */
+  export interface AppPath {
     /**
-     * Stores the potential error when initializing or loading the feed.
+     * The exact path to use.
      */
-    error: any;
+    path: string;
     /**
-     * The currently stored feed data.
+     * The component to register for this path.
      */
-    data: any;
+    Component: React.ComponentType<ReactRouter.RouteComponentProps>;
   }
 
   /**
@@ -1978,171 +2133,161 @@ declare module "sample-piral" {
     pilet?: string;
   }
 
-  export interface LanguagesPickerProps {
+  export interface FeedsState {
+    [id: string]: FeedDataState;
+  }
+
+  export interface SearchState {
     /**
-     * The currently selected language.
+     * Gets the current input value.
      */
-    selected: string;
+    input: string;
     /**
-     * The languages available for selection.
+     * Gets the current result state.
      */
-    available: Array<string>;
+    results: {
+      /**
+       * Gets weather the search is still loading.
+       */
+      loading: boolean;
+      /**
+       * The results to display for the current search.
+       */
+      items: Array<React.ReactChild>;
+    };
   }
 
-  export interface DashboardContainerProps extends ReactRouter.RouteComponentProps {}
-
-  export interface DashboardTileProps {
+  /**
+   * Custom parts of the global registry state defined outside of piral-core.
+   */
+  export interface PiralCustomRegistryState {
     /**
-     * The currently used number of columns.
+     * The registered tile components for a dashboard.
      */
-    columns: number;
+    tiles: Dict<TileRegistration>;
     /**
-     * The currently used number of rows.
+     * The registered menu items for global display.
      */
-    rows: number;
+    menuItems: Dict<MenuItemRegistration>;
     /**
-     * The resizable status.
+     * The registered modal dialog components.
      */
-    resizable: boolean;
+    modals: Dict<ModalRegistration>;
     /**
-     * The provided tile preferences.
+     * The registered search providers for context aware search.
      */
-    meta: TilePreferences;
+    searchProviders: Dict<SearchProviderRegistration>;
   }
 
-  export interface MenuContainerProps {
-    /**
-     * The type of the menu.
-     */
-    type: MenuType;
+  /**
+   * The creator function for the pilet API.
+   */
+  export interface PiletApiCreator {
+    (target: PiletMetadata): PiletApi;
   }
 
-  export interface MenuItemProps {
+  /**
+   * Metadata for pilets using the v0 schema with a content.
+   */
+  export interface PiletV0ContentEntry extends PiletV0BaseEntry {
     /**
-     * The type of the menu.
+     * The content of the pilet. If the content is not available
+     * the link will be used (unless caching has been activated).
      */
-    type: MenuType;
+    content: string;
     /**
-     * The provided menu settings.
+     * 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.
      */
-    meta: MenuSettings;
+    noCache?: boolean | string;
   }
 
-  export interface NotificationsHostProps {}
-
-  export interface NotificationsToastProps extends BareNotificationProps {}
-
-  export interface ModalsHostProps {
-    /**
-     * Gets if the modal is currently open or closed.
-     */
-    open: boolean;
+  /**
+   * Metadata for pilets using the v0 schema with a link.
+   */
+  export interface PiletV0LinkEntry extends PiletV0BaseEntry {
     /**
-     * Callback to invoke closing the modal dialog.
+     * The link for retrieving the content of the pilet.
      */
-    close(): void;
-  }
-
-  export interface ModalsDialogProps extends OpenModalDialog {
-    layout: ModalLayoutOptions;
-    defaults: any;
+    link: string;
   }
 
-  export interface SearchResultProps {}
+  export type StateSelector<T extends State, U> = (state: T) => U;
 
-  export interface SearchContainerProps {
-    /**
-     * Gets if the results are still gathered.
-     */
-    loading: boolean;
-  }
+  export type EqualityChecker<T> = (state: T, newState: T) => boolean;
 
-  export interface SearchInputProps {
-    setValue(value: string): void;
-    value: string;
-  }
+  export type State = object;
 
-  export type UnionOf<T> = {
-    [K in keyof T]: T[K];
-  }[keyof T];
+  export type StoreApi<T extends State> = {
+    setState: SetState<T>;
+    getState: GetState<T>;
+    subscribe: Subscribe<T>;
+    destroy: Destroy;
+  };
 
-  export interface SearchHandler {
-    (options: SearchOptions): Promise<Array<React.ReactChild>>;
+  /**
+   * The interface describing a function capable of fetching pilets.
+   */
+  export interface PiletRequester {
+    (): Promise<PiletEntries>;
   }
 
   /**
-   * The pilet app, i.e., the functional exports.
+   * Additional configuration options for the default loader.
    */
-  export interface SinglePiletApp {
-    /**
-     * Integrates the evaluated pilet into the application.
-     * @param api The API to access the application.
-     */
-    setup(api: PiletApi): void | Promise<void>;
+  export interface DefaultLoaderConfig {
     /**
-     * Optional function for cleanup.
-     * @param api The API to access the application.
+     * 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".
      */
-    teardown?(api: PiletApi): void;
+    crossOrigin?: string;
   }
 
   /**
-   * The pilet app, i.e., the functional exports.
+   * The callback to be used to load a single pilet.
    */
-  export interface MultiPiletApp {
-    /**
-     * Integrates the evaluated pilet into the application.
-     * @param api The API to access the application.
-     */
-    setup(apiFactory: PiletApiCreator): void | Promise<void>;
+  export interface PiletLoader {
+    (entry: PiletEntry): Promise<Pilet>;
   }
 
   /**
-   * Represents the dictionary of the loaded pilets and their APIs.
+   * Defines the spec identifiers for custom loading.
    */
-  export interface PiletsBag {
-    [name: string]: PiletApi;
-  }
+  export type CustomSpecLoaders = Record<string, PiletLoader>;
 
   /**
-   * The options for loading pilets.
+   * A set of pipeline hooks used by the Piral loading orchestrator.
    */
-  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;
+  export interface PiletLifecycleHooks {
     /**
-     * Optionally, defines loaders for custom specifications.
+     * Hook fired before a pilet is loaded.
      */
-    loaders?: CustomSpecLoaders;
+    loadPilet?(pilet: PiletMetadata): void;
     /**
-     * Gets the map of globally available dependencies with their names
-     * as keys and their evaluated pilet content as value.
+     * Hook fired before a pilet is being set up.
      */
-    dependencies?: AvailableDependencies;
+    setupPilet?(pilet: Pilet): void;
     /**
-     * Optionally, defines the loading strategy to use.
+     * Hook fired before a pilet is being cleaned up.
      */
-    strategy?: PiletLoadingStrategy;
+    cleanupPilet?(pilet: Pilet): void;
+  }
+
+  /**
+   * 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>;
   }
 
   export interface TileErrorInfoProps {
@@ -2230,62 +2375,96 @@ declare module "sample-piral" {
     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>>;
+  export interface FeedDataState {
+    /**
+     * Determines if the feed data is currently loading.
+     */
+    loading: boolean;
+    /**
+     * Indicates if the feed data was already loaded and is active.
+     */
+    loaded: boolean;
+    /**
+     * Stores the potential error when initializing or loading the feed.
+     */
+    error: any;
+    /**
+     * The currently stored feed data.
+     */
+    data: any;
   }
 
   /**
-   * Additional configuration options for the default loader.
+   * Basic metadata for pilets using the v0 schema.
    */
-  export interface DefaultLoaderConfig {
+  export interface PiletV0BaseEntry {
     /**
-     * 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".
+     * The name of the pilet, i.e., the package id.
      */
-    crossOrigin?: string;
+    name: string;
+    /**
+     * The version of the pilet. Should be semantically versioned.
+     */
+    version: string;
+    /**
+     * Optionally provides the version of the specification for this pilet.
+     */
+    spec?: "v0";
+    /**
+     * The computed hash value of the pilet's content. Should be
+     * accurate to allow caching.
+     */
+    hash: 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>;
   }
 
-  /**
-   * The callback to be used to load a single pilet.
-   */
-  export interface PiletLoader {
-    (meta: PiletMetadata): Promise<Pilet>;
-  }
+  export type SetState<T extends State> = {
+    <K1 extends keyof T, K2 extends keyof T = K1, K3 extends keyof T = K2, K4 extends keyof T = K3>(partial: PartialState<T, K1, K2, K3, K4>, replace?: boolean): void;
+  };
+
+  export type GetState<T extends State> = () => T;
+
+  export type Subscribe<T extends State> = {
+    (listener: StateListener<T>): () => void;
+    <StateSlice>(listener: StateSliceListener<StateSlice>, selector?: StateSelector<T, StateSlice>, equalityFn?: EqualityChecker<StateSlice>): () => void;
+  };
+
+  export type Destroy = () => void;
 
   /**
-   * Defines the spec identifiers for custom loading.
+   * The entries representing pilets from a feed service response.
    */
-  export type CustomSpecLoaders = Record<string, PiletLoader>;
+  export type PiletEntries = Array<PiletEntry>;
 
   /**
-   * The record containing all available dependencies.
+   * The callback to be used when pilets have been loaded.
    */
-  export interface AvailableDependencies {
-    [name: string]: any;
+  export interface PiletsLoaded {
+    (error: Error | undefined, pilets: Array<Pilet>): void;
   }
 
   /**
-   * The strategy for how pilets are loaded at runtime.
+   * @deprecated Use the builtin `Partial<T>` instead of `PartialState<T>`.
+   * Additionally turn on `--exactOptionalPropertyTypes` tsc flag.
+   * `PartialState` will be removed in next major
    */
-  export interface PiletLoadingStrategy {
-    (options: LoadPiletsOptions, pilets: PiletsLoaded): PromiseLike<void>;
-  }
+  export type PartialState<T extends State, K1 extends keyof T = keyof T, K2 extends keyof T = K1, K3 extends keyof T = K2, K4 extends keyof T = K3> = (Pick<T, K1> | Pick<T, K2> | Pick<T, K3> | Pick<T, K4> | T) | ((state: T) => Pick<T, K1> | Pick<T, K2> | Pick<T, K3> | Pick<T, K4> | T);
+
+  export type StateListener<T> = (state: T, previousState: T) => void;
 
   /**
-   * The callback to be used when pilets have been loaded.
+   * @deprecated Use `StateListener<T>` instead of `StateSliceListener<T>`.
    */
-  export interface PiletsLoaded {
-    (error: Error | undefined, pilets: Array<Pilet>): void;
-  }
+  export type StateSliceListener<T> = (slice: T, previousSlice: T) => void;
 }