sample-piral 0.15.0-beta.4633 → 0.15.0-beta.4670

package/app/index.d.ts

@@ -1,981 +1,983 @@
 import * as React from 'react';
 import * as ReactRouter from 'react-router';
 
-declare module "sample-piral" {
-  /**
-   * Defines the API accessible from pilets.
-   */
-  export interface PiletApi extends EventEmitter, PiletCustomApi, PiletCoreApi {
-    /**
-     * Gets the metadata of the current pilet.
-     */
-    meta: PiletMetadata;
-  }
-
-  /**
-   * The emitter for Piral app shell events.
-   */
-  export interface EventEmitter {
-    /**
-     * Attaches a new event listener.
-     * @param type The type of the event to listen for.
-     * @param callback The callback to trigger.
-     */
-    on<K extends keyof PiralEventMap>(type: K, callback: Listener<PiralEventMap[K]>): EventEmitter;
-    /**
-     * Detaches an existing event listener.
-     * @param type The type of the event to listen for.
-     * @param callback The callback to trigger.
-     */
-    off<K extends keyof PiralEventMap>(type: K, callback: Listener<PiralEventMap[K]>): EventEmitter;
-    /**
-     * Emits a new event with the given type.
-     * @param type The type of the event to emit.
-     * @param arg The payload of the event.
-     */
-    emit<K extends keyof PiralEventMap>(type: K, arg: PiralEventMap[K]): EventEmitter;
-  }
-
-  /**
-   * Custom Pilet API parts defined outside of piral-core.
-   */
-  export interface PiletCustomApi extends PiletLocaleApi, PiletDashboardApi, PiletMenuApi, PiletNotificationsApi, PiletModalsApi, PiletFeedsApi, PiletSearchApi, PiletAuthApi {}
-
-  /**
-   * Defines the Pilet API from piral-core.
-   * This interface will be consumed by pilet developers so that their pilet can interact with the piral instance.
-   */
-  export interface PiletCoreApi {
-    /**
-     * Gets a shared data value.
-     * @param name The name of the data to retrieve.
-     */
-    getData<TKey extends string>(name: TKey): SharedData[TKey];
-    /**
-     * Sets the data using a given name. The name needs to be used exclusively by the current pilet.
-     * Using the name occupied by another pilet will result in no change.
-     * @param name The name of the data to store.
-     * @param value The value of the data to store.
-     * @param options The optional configuration for storing this piece of data.
-     * @returns True if the data could be set, otherwise false.
-     */
-    setData<TKey extends string>(name: TKey, value: SharedData[TKey], options?: DataStoreOptions): boolean;
-    /**
-     * Registers a route for predefined page component.
-     * The route needs to be unique and can contain params.
-     * Params are following the path-to-regexp notation, e.g., :id for an id parameter.
-     * @param route The route to register.
-     * @param Component The component to render the page.
-     * @param meta The optional metadata to use.
-     */
-    registerPage(route: string, Component: AnyComponent<PageComponentProps>, meta?: PiralPageMeta): RegistrationDisposer;
-    /**
-     * Unregisters the page identified by the given route.
-     * @param route The route that was previously registered.
-     */
-    unregisterPage(route: string): void;
-    /**
-     * Registers an extension component with a predefined extension component.
-     * The name must refer to the extension slot.
-     * @param name The global name of the extension slot.
-     * @param Component The component to be rendered.
-     * @param defaults Optionally, sets the default values for the expected data.
-     */
-    registerExtension<TName>(name: TName extends string ? TName : string, Component: AnyExtensionComponent<TName>, defaults?: Partial<ExtensionParams<TName>>): RegistrationDisposer;
-    /**
-     * Unregisters a global extension component.
-     * Only previously registered extension components can be unregistered.
-     * @param name The name of the extension slot to unregister from.
-     * @param Component The registered extension component to unregister.
-     */
-    unregisterExtension<TName>(name: TName extends string ? TName : string, Component: AnyExtensionComponent<TName>): void;
-    /**
-     * React component for displaying extensions for a given name.
-     * @param props The extension's rendering props.
-     * @return The created React element.
-     */
-    Extension<TName>(props: ExtensionSlotProps<TName>): React.ReactElement | null;
-    /**
-     * Renders an extension in a plain DOM component.
-     * @param element The DOM element or shadow root as a container for rendering the extension.
-     * @param props The extension's rendering props.
-     * @return The disposer to clear the extension.
-     */
-    renderHtmlExtension<TName>(element: HTMLElement | ShadowRoot, props: ExtensionSlotProps<TName>): Disposable;
-  }
-
-  /**
-   * Describes the metadata of a pilet available in its API.
-   */
-  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.
-   */
-  export interface Listener<T> {
-    (arg: T): void;
-  }
-
-  /**
-   * The map of known Piral app shell events.
-   */
-  export interface PiralEventMap extends PiralCustomEventMap {
-    "unload-pilet": PiralUnloadPiletEvent;
-    [custom: string]: any;
-    "store-data": PiralStoreDataEvent;
-  }
-
-  export interface PiletLocaleApi {
-    /**
-     * Gets the currently selected language directly.
-     */
-    getCurrentLanguage(): string;
-    /**
-     * Gets the currently selected language in a callback that is also invoked when the
-     * selected language changes. Returns a disposable to stop the notifications.
-     */
-    getCurrentLanguage(cb: (currently: string) => void): Disposable;
-    /**
-     * Translates the given tag (using the optional variables) into a string using the current language.
-     * The used template can contain placeholders in form of `{{variableName}}`.
-     * @param tag The tag to translate.
-     * @param variables The optional variables to fill into the temnplate.
-     */
-    translate<T = Record<string, string>>(tag: string, variables?: T): string;
-    /**
-     * Provides translations to the application.
-     * The translations will be exclusively used for retrieving translations for the pilet.
-     * @param messages The messages to use as translation basis.
-     */
-    setTranslations(messages: LocalizationMessages): void;
-    /**
-     * Gets the currently provided translations by the pilet.
-     */
-    getTranslations(): LocalizationMessages;
-  }
-
-  export interface PiletDashboardApi {
-    /**
-     * Registers a tile with a predefined tile components.
-     * The name has to be unique within the current pilet.
-     * @param name The name of the tile.
-     * @param Component The component to be rendered within the Dashboard.
-     * @param preferences The optional preferences to be supplied to the Dashboard for the tile.
-     */
-    registerTile(name: string, Component: AnyComponent<TileComponentProps>, preferences?: TilePreferences): RegistrationDisposer;
-    /**
-     * Registers a tile for predefined tile components.
-     * @param Component The component to be rendered within the Dashboard.
-     * @param preferences The optional preferences to be supplied to the Dashboard for the tile.
-     */
-    registerTile(Component: AnyComponent<TileComponentProps>, preferences?: TilePreferences): RegistrationDisposer;
-    /**
-     * Unregisters a tile known by the given name.
-     * Only previously registered tiles can be unregistered.
-     * @param name The name of the tile to unregister.
-     */
-    unregisterTile(name: string): void;
-  }
-
-  export interface PiletMenuApi {
-    /**
-     * Registers a menu item for a predefined menu component.
-     * The name has to be unique within the current pilet.
-     * @param name The name of the menu item.
-     * @param Component The component to be rendered within the menu.
-     * @param settings The optional configuration for the menu item.
-     */
-    registerMenu(name: string, Component: AnyComponent<MenuComponentProps>, settings?: MenuSettings): RegistrationDisposer;
-    /**
-     * Registers a menu item for a predefined menu component.
-     * @param Component The component to be rendered within the menu.
-     * @param settings The optional configuration for the menu item.
-     */
-    registerMenu(Component: AnyComponent<MenuComponentProps>, settings?: MenuSettings): RegistrationDisposer;
-    /**
-     * Unregisters a menu item known by the given name.
-     * Only previously registered menu items can be unregistered.
-     * @param name The name of the menu item to unregister.
-     */
-    unregisterMenu(name: string): void;
-  }
-
-  export interface PiletNotificationsApi {
-    /**
-     * Shows a notification in the determined spot using the provided content.
-     * @param content The content to display. Normally, a string would be sufficient.
-     * @param options The options to consider for showing the notification.
-     * @returns A callback to trigger closing the notification.
-     */
-    showNotification(content: string | React.ReactElement<any, any> | AnyComponent<NotificationComponentProps>, options?: NotificationOptions): Disposable;
-  }
-
-  export interface PiletModalsApi {
-    /**
-     * Shows a modal dialog with the given name.
-     * The modal can be optionally programmatically closed using the returned callback.
-     * @param name The name of the registered modal.
-     * @param options Optional arguments for creating the modal.
-     * @returns A callback to trigger closing the modal.
-     */
-    showModal<T>(name: T extends string ? T : string, options?: ModalOptions<T>): Disposable;
-    /**
-     * Registers a modal dialog using a React component.
-     * The name needs to be unique to be used without the pilet's name.
-     * @param name The name of the modal to register.
-     * @param Component The component to render the page.
-     * @param defaults Optionally, sets the default values for the inserted options.
-     * @param layout Optionally, sets the layout options for the dialog wrapper.
-     */
-    registerModal<T>(name: T extends string ? T : string, Component: AnyComponent<ModalComponentProps<T>>, defaults?: ModalOptions<T>, layout?: ModalLayoutOptions): RegistrationDisposer;
-    /**
-     * Unregisters a modal by its name.
-     * @param name The name that was previously registered.
-     */
-    unregisterModal<T>(name: T extends string ? T : string): void;
-  }
-
-  export interface PiletFeedsApi {
-    /**
-     * Creates a connector for wrapping components with data relations.
-     * @param resolver The resolver for the initial data set.
-     */
-    createConnector<T>(resolver: FeedResolver<T>): FeedConnector<T>;
-    /**
-     * Creates a connector for wrapping components with data relations.
-     * @param options The options for creating the connector.
-     */
-    createConnector<TData, TItem, TReducers extends FeedConnectorReducers<TData>>(options: FeedConnectorOptions<TData, TItem, TReducers>): FeedConnector<TData, TReducers>;
-  }
-
-  export interface PiletSearchApi {
-    /**
-     * Registers a search provider to respond to search queries.
-     * The name has to be unique within the current pilet.
-     * @param name The name of the search provider.
-     * @param provider The callback to be used for searching.
-     * @param settings The optional settings for the search provider.
-     */
-    registerSearchProvider(name: string, provider: SearchProvider, settings?: SearchSettings): RegistrationDisposer;
-    /**
-     * Registers a search provider to respond to search queries.
-     * @param provider The callback to be used for searching.
-     * @param settings The optional settings for the search provider.
-     */
-    registerSearchProvider(provider: SearchProvider, settings?: SearchSettings): RegistrationDisposer;
-    /**
-     * Unregisters a search provider known by the given name.
-     * Only previously registered search providers can be unregistered.
-     * @param name The name of the search provider to unregister.
-     */
-    unregisterSearchProvider(name: string): void;
-  }
-
-  export interface PiletAuthApi {
-    /**
-     * Gets the currently authenticated user, if any.
-     */
-    getUser(): UserInfo | undefined;
-  }
-
-  /**
-   * Defines the shape of the data store for storing shared data.
-   */
-  export interface SharedData<TValue = any> {
-    [key: string]: TValue;
-  }
-
-  /**
-   * Defines the options to be used for storing data.
-   */
-  export type DataStoreOptions = DataStoreTarget | CustomDataStoreOptions;
-
-  /**
-   * Possible shapes for a component.
-   */
-  export type AnyComponent<T> = React.ComponentType<T> | FirstParametersOf<ComponentConverters<T>>;
-
-  /**
-   * The props used by a page component.
-   */
-  export interface PageComponentProps<T = any, S = any> extends RouteBaseProps<T, S> {
-    /**
-     * The meta data registered with the page.
-     */
-    meta: PiralPageMeta;
-  }
-
-  /**
-   * The meta data registered for a page.
-   */
-  export interface PiralPageMeta extends PiralCustomPageMeta, PiralCustomPageMeta {}
-
-  /**
-   * The shape of an implicit unregister function.
-   */
-  export interface RegistrationDisposer {
-    (): void;
-  }
-
-  /**
-   * Shorthand for the definition of an extension component.
-   */
-  export type AnyExtensionComponent<TName> = TName extends keyof PiralExtensionSlotMap ? AnyComponent<ExtensionComponentProps<TName>> : TName extends string ? AnyComponent<ExtensionComponentProps<any>> : AnyComponent<ExtensionComponentProps<TName>>;
-
-  /**
-   * Gives the extension params shape for the given extension slot name.
-   */
-  export type ExtensionParams<TName> = TName extends keyof PiralExtensionSlotMap ? PiralExtensionSlotMap[TName] : TName extends string ? any : TName;
-
-  /**
-   * The props for defining an extension slot.
-   */
-  export type ExtensionSlotProps<TName = string> = BaseExtensionSlotProps<TName extends string ? TName : string, ExtensionParams<TName>>;
-
-  /**
-   * Can be implemented by functions to be used for disposal purposes.
-   */
-  export interface Disposable {
-    (): void;
-  }
-
-  /**
-   * Custom events defined outside of piral-core.
+/**
+ * Defines the API accessible from pilets.
+ */
+export interface PiletApi extends EventEmitter, PiletCustomApi, PiletCoreApi {
+  /**
+   * Gets the metadata of the current pilet.
+   */
+  meta: PiletMetadata;
+}
+
+/**
+ * The emitter for Piral app shell events.
+ */
+export interface EventEmitter {
+  /**
+   * Attaches a new event listener.
+   * @param type The type of the event to listen for.
+   * @param callback The callback to trigger.
+   */
+  on<K extends keyof PiralEventMap>(type: K, callback: Listener<PiralEventMap[K]>): EventEmitter;
+  /**
+   * Detaches an existing event listener.
+   * @param type The type of the event to listen for.
+   * @param callback The callback to trigger.
+   */
+  off<K extends keyof PiralEventMap>(type: K, callback: Listener<PiralEventMap[K]>): EventEmitter;
+  /**
+   * Emits a new event with the given type.
+   * @param type The type of the event to emit.
+   * @param arg The payload of the event.
+   */
+  emit<K extends keyof PiralEventMap>(type: K, arg: PiralEventMap[K]): EventEmitter;
+}
+
+/**
+ * Custom Pilet API parts defined outside of piral-core.
+ */
+export interface PiletCustomApi extends PiletLocaleApi, PiletDashboardApi, PiletMenuApi, PiletNotificationsApi, PiletModalsApi, PiletFeedsApi, PiletSearchApi, PiletAuthApi {}
+
+/**
+ * Defines the Pilet API from piral-core.
+ * This interface will be consumed by pilet developers so that their pilet can interact with the piral instance.
+ */
+export interface PiletCoreApi {
+  /**
+   * Gets a shared data value.
+   * @param name The name of the data to retrieve.
+   */
+  getData<TKey extends string>(name: TKey): SharedData[TKey];
+  /**
+   * Sets the data using a given name. The name needs to be used exclusively by the current pilet.
+   * Using the name occupied by another pilet will result in no change.
+   * @param name The name of the data to store.
+   * @param value The value of the data to store.
+   * @param options The optional configuration for storing this piece of data.
+   * @returns True if the data could be set, otherwise false.
+   */
+  setData<TKey extends string>(name: TKey, value: SharedData[TKey], options?: DataStoreOptions): boolean;
+  /**
+   * Registers a route for predefined page component.
+   * The route needs to be unique and can contain params.
+   * Params are following the path-to-regexp notation, e.g., :id for an id parameter.
+   * @param route The route to register.
+   * @param Component The component to render the page.
+   * @param meta The optional metadata to use.
+   */
+  registerPage(route: string, Component: AnyComponent<PageComponentProps>, meta?: PiralPageMeta): RegistrationDisposer;
+  /**
+   * Unregisters the page identified by the given route.
+   * @param route The route that was previously registered.
+   */
+  unregisterPage(route: string): void;
+  /**
+   * Registers an extension component with a predefined extension component.
+   * The name must refer to the extension slot.
+   * @param name The global name of the extension slot.
+   * @param Component The component to be rendered.
+   * @param defaults Optionally, sets the default values for the expected data.
+   */
+  registerExtension<TName>(name: TName extends string ? TName : string, Component: AnyExtensionComponent<TName>, defaults?: Partial<ExtensionParams<TName>>): RegistrationDisposer;
+  /**
+   * Unregisters a global extension component.
+   * Only previously registered extension components can be unregistered.
+   * @param name The name of the extension slot to unregister from.
+   * @param Component The registered extension component to unregister.
+   */
+  unregisterExtension<TName>(name: TName extends string ? TName : string, Component: AnyExtensionComponent<TName>): void;
+  /**
+   * React component for displaying extensions for a given name.
+   * @param props The extension's rendering props.
+   * @return The created React element.
+   */
+  Extension<TName>(props: ExtensionSlotProps<TName>): React.ReactElement | null;
+  /**
+   * Renders an extension in a plain DOM component.
+   * @param element The DOM element or shadow root as a container for rendering the extension.
+   * @param props The extension's rendering props.
+   * @return The disposer to clear the extension.
+   */
+  renderHtmlExtension<TName>(element: HTMLElement | ShadowRoot, props: ExtensionSlotProps<TName>): Disposable;
+}
+
+/**
+ * Describes the metadata of a pilet available in its API.
+ */
+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.
+ */
+export interface Listener<T> {
+  (arg: T): void;
+}
+
+/**
+ * The map of known Piral app shell events.
+ */
+export interface PiralEventMap extends PiralCustomEventMap {
+  "unload-pilet": PiralUnloadPiletEvent;
+  [custom: string]: any;
+  "store-data": PiralStoreDataEvent;
+}
+
+export interface PiletLocaleApi {
+  /**
+   * Gets the currently selected language directly.
+   */
+  getCurrentLanguage(): string;
+  /**
+   * Gets the currently selected language in a callback that is also invoked when the
+   * selected language changes. Returns a disposable to stop the notifications.
+   */
+  getCurrentLanguage(cb: (currently: string) => void): Disposable;
+  /**
+   * Translates the given tag (using the optional variables) into a string using the current language.
+   * The used template can contain placeholders in form of `{{variableName}}`.
+   * @param tag The tag to translate.
+   * @param variables The optional variables to fill into the temnplate.
+   */
+  translate<T = Record<string, string>>(tag: string, variables?: T): string;
+  /**
+   * Provides translations to the application.
+   * The translations will be exclusively used for retrieving translations for the pilet.
+   * @param messages The messages to use as translation basis.
+   */
+  setTranslations(messages: LocalizationMessages): void;
+  /**
+   * Gets the currently provided translations by the pilet.
+   */
+  getTranslations(): LocalizationMessages;
+}
+
+export interface PiletDashboardApi {
+  /**
+   * Registers a tile with a predefined tile components.
+   * The name has to be unique within the current pilet.
+   * @param name The name of the tile.
+   * @param Component The component to be rendered within the Dashboard.
+   * @param preferences The optional preferences to be supplied to the Dashboard for the tile.
+   */
+  registerTile(name: string, Component: AnyComponent<TileComponentProps>, preferences?: TilePreferences): RegistrationDisposer;
+  /**
+   * Registers a tile for predefined tile components.
+   * @param Component The component to be rendered within the Dashboard.
+   * @param preferences The optional preferences to be supplied to the Dashboard for the tile.
+   */
+  registerTile(Component: AnyComponent<TileComponentProps>, preferences?: TilePreferences): RegistrationDisposer;
+  /**
+   * Unregisters a tile known by the given name.
+   * Only previously registered tiles can be unregistered.
+   * @param name The name of the tile to unregister.
+   */
+  unregisterTile(name: string): void;
+}
+
+export interface PiletMenuApi {
+  /**
+   * Registers a menu item for a predefined menu component.
+   * The name has to be unique within the current pilet.
+   * @param name The name of the menu item.
+   * @param Component The component to be rendered within the menu.
+   * @param settings The optional configuration for the menu item.
+   */
+  registerMenu(name: string, Component: AnyComponent<MenuComponentProps>, settings?: MenuSettings): RegistrationDisposer;
+  /**
+   * Registers a menu item for a predefined menu component.
+   * @param Component The component to be rendered within the menu.
+   * @param settings The optional configuration for the menu item.
+   */
+  registerMenu(Component: AnyComponent<MenuComponentProps>, settings?: MenuSettings): RegistrationDisposer;
+  /**
+   * Unregisters a menu item known by the given name.
+   * Only previously registered menu items can be unregistered.
+   * @param name The name of the menu item to unregister.
+   */
+  unregisterMenu(name: string): void;
+}
+
+export interface PiletNotificationsApi {
+  /**
+   * Shows a notification in the determined spot using the provided content.
+   * @param content The content to display. Normally, a string would be sufficient.
+   * @param options The options to consider for showing the notification.
+   * @returns A callback to trigger closing the notification.
+   */
+  showNotification(content: string | React.ReactElement<any, any> | AnyComponent<NotificationComponentProps>, options?: NotificationOptions): Disposable;
+}
+
+export interface PiletModalsApi {
+  /**
+   * Shows a modal dialog with the given name.
+   * The modal can be optionally programmatically closed using the returned callback.
+   * @param name The name of the registered modal.
+   * @param options Optional arguments for creating the modal.
+   * @returns A callback to trigger closing the modal.
+   */
+  showModal<T>(name: T extends string ? T : string, options?: ModalOptions<T>): Disposable;
+  /**
+   * Registers a modal dialog using a React component.
+   * The name needs to be unique to be used without the pilet's name.
+   * @param name The name of the modal to register.
+   * @param Component The component to render the page.
+   * @param defaults Optionally, sets the default values for the inserted options.
+   * @param layout Optionally, sets the layout options for the dialog wrapper.
+   */
+  registerModal<T>(name: T extends string ? T : string, Component: AnyComponent<ModalComponentProps<T>>, defaults?: ModalOptions<T>, layout?: ModalLayoutOptions): RegistrationDisposer;
+  /**
+   * Unregisters a modal by its name.
+   * @param name The name that was previously registered.
+   */
+  unregisterModal<T>(name: T extends string ? T : string): void;
+}
+
+export interface PiletFeedsApi {
+  /**
+   * Creates a connector for wrapping components with data relations.
+   * @param resolver The resolver for the initial data set.
+   */
+  createConnector<T>(resolver: FeedResolver<T>): FeedConnector<T>;
+  /**
+   * Creates a connector for wrapping components with data relations.
+   * @param options The options for creating the connector.
+   */
+  createConnector<TData, TItem, TReducers extends FeedConnectorReducers<TData>>(options: FeedConnectorOptions<TData, TItem, TReducers>): FeedConnector<TData, TReducers>;
+}
+
+export interface PiletSearchApi {
+  /**
+   * Registers a search provider to respond to search queries.
+   * The name has to be unique within the current pilet.
+   * @param name The name of the search provider.
+   * @param provider The callback to be used for searching.
+   * @param settings The optional settings for the search provider.
+   */
+  registerSearchProvider(name: string, provider: SearchProvider, settings?: SearchSettings): RegistrationDisposer;
+  /**
+   * Registers a search provider to respond to search queries.
+   * @param provider The callback to be used for searching.
+   * @param settings The optional settings for the search provider.
+   */
+  registerSearchProvider(provider: SearchProvider, settings?: SearchSettings): RegistrationDisposer;
+  /**
+   * Unregisters a search provider known by the given name.
+   * Only previously registered search providers can be unregistered.
+   * @param name The name of the search provider to unregister.
+   */
+  unregisterSearchProvider(name: string): void;
+}
+
+export interface PiletAuthApi {
+  /**
+   * Gets the currently authenticated user, if any.
+   */
+  getUser(): UserInfo | undefined;
+}
+
+/**
+ * Defines the shape of the data store for storing shared data.
+ */
+export interface SharedData<TValue = any> {
+  [key: string]: TValue;
+}
+
+/**
+ * Defines the options to be used for storing data.
+ */
+export type DataStoreOptions = DataStoreTarget | CustomDataStoreOptions;
+
+/**
+ * Possible shapes for a component.
+ */
+export type AnyComponent<T> = React.ComponentType<T> | FirstParametersOf<ComponentConverters<T>>;
+
+/**
+ * The props used by a page component.
+ */
+export interface PageComponentProps<T = any, S = any> extends RouteBaseProps<T, S> {
+  /**
+   * The meta data registered with the page.
+   */
+  meta: PiralPageMeta;
+}
+
+/**
+ * The meta data registered for a page.
+ */
+export interface PiralPageMeta extends PiralCustomPageMeta, PiralCustomPageMeta {}
+
+/**
+ * The shape of an implicit unregister function.
+ */
+export interface RegistrationDisposer {
+  (): void;
+}
+
+/**
+ * Shorthand for the definition of an extension component.
+ */
+export type AnyExtensionComponent<TName> = TName extends keyof PiralExtensionSlotMap ? AnyComponent<ExtensionComponentProps<TName>> : TName extends string ? AnyComponent<ExtensionComponentProps<any>> : AnyComponent<ExtensionComponentProps<TName>>;
+
+/**
+ * Gives the extension params shape for the given extension slot name.
+ */
+export type ExtensionParams<TName> = TName extends keyof PiralExtensionSlotMap ? PiralExtensionSlotMap[TName] : TName extends string ? any : TName;
+
+/**
+ * The props for defining an extension slot.
+ */
+export type ExtensionSlotProps<TName = string> = BaseExtensionSlotProps<TName extends string ? TName : string, ExtensionParams<TName>>;
+
+/**
+ * Can be implemented by functions to be used for disposal purposes.
+ */
+export interface Disposable {
+  (): void;
+}
+
+/**
+ * Custom events defined outside of piral-core.
+ */
+export interface PiralCustomEventMap {
+  "select-language": PiralSelectLanguageEvent;
+  "change-user": PiralChangeUserEvent;
+}
+
+/**
+ * Gets fired when a pilet gets unloaded.
+ */
+export interface PiralUnloadPiletEvent {
+  /**
+   * The name of the pilet to be unloaded.
+   */
+  name: string;
+}
+
+/**
+ * Gets fired when a data item gets stored in piral.
+ */
+export interface PiralStoreDataEvent<TValue = any> {
+  /**
+   * The name of the item that was stored.
+   */
+  name: string;
+  /**
+   * The storage target of the item.
+   */
+  target: string;
+  /**
+   * The value that was stored.
+   */
+  value: TValue;
+  /**
+   * The owner of the item.
+   */
+  owner: string;
+  /**
+   * The expiration of the item.
+   */
+  expires: number;
+}
+
+export interface LocalizationMessages {
+  [lang: string]: Translations;
+}
+
+export type TileComponentProps = BaseComponentProps & BareTileComponentProps;
+
+export interface TilePreferences extends PiralCustomTilePreferences {
+  /**
+   * Sets the desired initial number of columns.
+   * This may be overridden either by the user (if resizable true), or by the dashboard.
+   */
+  initialColumns?: number;
+  /**
+   * Sets the desired initial number of rows.
+   * This may be overridden either by the user (if resizable true), or by the dashboard.
+   */
+  initialRows?: number;
+  /**
+   * Determines if the tile can be resized by the user.
+   * By default the size of the tile is fixed.
+   */
+  resizable?: boolean;
+  /**
+   * Declares a set of custom properties to be used with user-specified values.
+   */
+  customProperties?: Array<string>;
+}
+
+export interface MenuComponentProps extends BaseComponentProps {}
+
+export interface MenuSettings extends PiralCustomMenuSettings {
+  /**
+   * Sets the type of the menu to attach to.
+   * @default "general"
+   */
+  type?: MenuType;
+}
+
+export type NotificationComponentProps = BaseComponentProps & BareNotificationProps;
+
+export interface NotificationOptions extends PiralCustomNotificationOptions {
+  /**
+   * The title of the notification, if any.
+   */
+  title?: string;
+  /**
+   * Determines when the notification should automatically close in milliseconds.
+   * A value of 0 or undefined forces the user to close the notification.
+   */
+  autoClose?: number;
+  /**
+   * The type of the notification used when displaying the message.
+   * By default info is used.
+   */
+  type?: "info" | "success" | "warning" | "error";
+}
+
+export type ModalOptions<T> = T extends keyof PiralModalsMap ? PiralModalsMap[T] & BaseModalOptions : T extends string ? BaseModalOptions : T;
+
+export type ModalComponentProps<T> = BaseComponentProps & BareModalComponentProps<ModalOptions<T>>;
+
+/**
+ * The options provided for the dialog layout.
+ */
+export interface ModalLayoutOptions {}
+
+export interface FeedResolver<TData> {
+  (): Promise<TData>;
+}
+
+export type FeedConnector<TData, TReducers = {}> = GetActions<TReducers> & {
+  <TProps>(component: React.ComponentType<TProps & FeedConnectorProps<TData>>): React.FC<TProps>;
+  /**
+   * Invalidates the underlying feed connector.
+   * Forces a reload on next use.
+   */
+  invalidate(): void;
+};
+
+export interface FeedConnectorOptions<TData, TItem, TReducers extends FeedConnectorReducers<TData> = {}> {
+  /**
+   * Function to derive the initial set of data.
+   * @returns The promise for retrieving the initial data set.
+   */
+  initialize: FeedResolver<TData>;
+  /**
+   * Function to be called for connecting to a live data feed.
+   * @param callback The function to call when an item updated.
+   * @returns A callback for disconnecting from the feed.
+   */
+  connect?: FeedSubscriber<TItem>;
+  /**
+   * Function to be called when some data updated.
+   * @param data The current set of data.
+   * @param item The updated item to include.
+   * @returns The promise for retrieving the updated data set or the updated data set.
+   */
+  update?: FeedReducer<TData, TItem>;
+  /**
+   * Defines the optional reducers for modifying the data state.
+   */
+  reducers?: TReducers;
+  /**
+   * Optional flag to avoid lazy loading and initialize the data directly.
+   */
+  immediately?: boolean;
+}
+
+export interface FeedConnectorReducers<TData> {
+  [name: string]: (data: TData, ...args: any) => Promise<TData> | TData;
+}
+
+export interface SearchProvider {
+  (options: SearchOptions, api: PiletApi): Promise<SearchResultType | Array<SearchResultType>>;
+}
+
+export interface SearchSettings {
+  /**
+   * Only invoke the search provider if its an immediate search.
+   */
+  onlyImmediate?: boolean;
+  /**
+   * Callback to be fired when the search is cleared.
+   */
+  onClear?(): void;
+  /**
+   * Callback to be fired when an existing search is cancelled.
+   */
+  onCancel?(): void;
+}
+
+export interface UserInfo {
+  id: string;
+  firstName: string;
+  lastName: string;
+  mail: string;
+  language: string;
+  permissions: UserPermissions;
+  features: UserFeatures;
+}
+
+/**
+ * Defines the potential targets when storing data.
+ */
+export type DataStoreTarget = "memory" | "local" | "remote";
+
+/**
+ * Defines the custom options for storing data.
+ */
+export interface CustomDataStoreOptions {
+  /**
+   * The target data store. By default the data is only stored in memory.
+   */
+  target?: DataStoreTarget;
+  /**
+   * Optionally determines when the data expires.
+   */
+  expires?: "never" | Date | number;
+}
+
+export type FirstParametersOf<T> = {
+  [K in keyof T]: T[K] extends (arg: any) => any ? FirstParameter<T[K]> : never;
+}[keyof T];
+
+/**
+ * Mapping of available component converters.
+ */
+export interface ComponentConverters<TProps> extends PiralCustomComponentConverters<TProps> {
+  /**
+   * Converts the HTML component to a framework-independent component.
+   * @param component The vanilla JavaScript component to be converted.
+   */
+  html(component: HtmlComponent<TProps>): ForeignComponent<TProps>;
+}
+
+/**
+ * The props that every registered page component obtains.
+ */
+export interface RouteBaseProps<UrlParams = any, UrlState = any> extends ReactRouter.RouteComponentProps<UrlParams, {}, UrlState>, BaseComponentProps {}
+
+/**
+ * Custom meta data to include for pages.
+ */
+export interface PiralCustomPageMeta {}
+
+/**
+ * The props of an extension component.
+ */
+export interface ExtensionComponentProps<T> extends BaseComponentProps {
+  /**
+   * The provided parameters for showing the extension.
+   */
+  params: T extends keyof PiralExtensionSlotMap ? PiralExtensionSlotMap[T] : T extends string ? any : T;
+  /**
+   * The optional children to receive, if any.
+   */
+  children?: React.ReactNode;
+}
+
+/**
+ * The mapping of the existing (known) extension slots.
+ */
+export interface PiralExtensionSlotMap extends PiralCustomExtensionSlotMap {}
+
+/**
+ * The basic props for defining an extension slot.
+ */
+export interface BaseExtensionSlotProps<TName, TParams> {
+  /**
+   * The children to transport, if any.
+   */
+  children?: React.ReactNode;
+  /**
+   * Defines what should be rendered when no components are available
+   * for the specified extension.
+   */
+  empty?(): React.ReactNode;
+  /**
+   * Determines if the `render` function should be called in case no
+   * components are available for the specified extension.
+   * 
+   * If true, `empty` will be called and returned from the slot.
+   * If false, `render` will be called with the result of calling `empty`.
+   * The result of calling `render` will then be returned from the slot.
+   */
+  emptySkipsRender?: boolean;
+  /**
+   * Defines the order of the components to render.
+   * May be more convient than using `render` w.r.t. ordering extensions
+   * by their supplied metadata.
+   * @param extensions The registered extensions.
+   * @returns The ordered extensions.
+   */
+  order?(extensions: Array<ExtensionRegistration>): Array<ExtensionRegistration>;
+  /**
+   * Defines how the provided nodes should be rendered.
+   * @param nodes The rendered extension nodes.
+   * @returns The rendered nodes, i.e., an ReactElement.
    */
-  export interface PiralCustomEventMap {
-    "select-language": PiralSelectLanguageEvent;
-    "change-user": PiralChangeUserEvent;
-  }
+  render?(nodes: Array<React.ReactNode>): React.ReactElement<any, any> | null;
+  /**
+   * The custom parameters for the given extension.
+   */
+  params?: TParams;
+  /**
+   * The name of the extension to render.
+   */
+  name: TName;
+}
 
+export interface PiralSelectLanguageEvent {
+  /**
+   * Gets the previously selected language.
+   */
+  previousLanguage: string;
   /**
-   * Gets fired when a pilet gets unloaded.
+   * Gets the currently selected language.
    */
-  export interface PiralUnloadPiletEvent {
-    /**
-     * The name of the pilet to be unloaded.
-     */
-    name: string;
-  }
+  currentLanguage: string;
+}
+
+export interface PiralChangeUserEvent {
+  previous: UserInfo;
+  current: UserInfo;
+}
+
+export interface Translations {
+  [tag: string]: string;
+}
 
+/**
+ * The props that every registered component obtains.
+ */
+export interface BaseComponentProps {
+  /**
+   * The currently used pilet API.
+   */
+  piral: PiletApi;
+}
+
+export interface BareTileComponentProps {
+  /**
+   * The currently used number of columns.
+   */
+  columns: number;
+  /**
+   * The currently used number of rows.
+   */
+  rows: number;
+}
+
+export interface PiralCustomTilePreferences {}
+
+export interface PiralCustomMenuSettings {}
+
+export type MenuType = StandardMenuType | keyof PiralCustomMenuTypes;
+
+export interface BareNotificationProps {
+  /**
+   * Callback for closing the notification programmatically.
+   */
+  onClose(): void;
+  /**
+   * Provides the passed in options for this particular notification.
+   */
+  options: NotificationOptions;
+}
+
+export interface PiralCustomNotificationOptions {}
+
+export interface BaseModalOptions {}
+
+export interface PiralModalsMap extends PiralCustomModalsMap {}
+
+export interface BareModalComponentProps<TOpts> {
+  /**
+   * Callback for closing the modal programmatically.
+   */
+  onClose(): void;
   /**
-   * Gets fired when a data item gets stored in piral.
+   * Provides the passed in options for this particular modal.
    */
-  export interface PiralStoreDataEvent<TValue = any> {
-    /**
-     * The name of the item that was stored.
-     */
-    name: string;
-    /**
-     * The storage target of the item.
-     */
-    target: string;
-    /**
-     * The value that was stored.
-     */
-    value: TValue;
-    /**
-     * The owner of the item.
-     */
-    owner: string;
-    /**
-     * The expiration of the item.
-     */
-    expires: number;
-  }
+  options?: TOpts;
+}
 
-  export interface LocalizationMessages {
-    [lang: string]: Translations;
-  }
-
-  export type TileComponentProps = BaseComponentProps & BareTileComponentProps;
-
-  export interface TilePreferences extends PiralCustomTilePreferences {
-    /**
-     * Sets the desired initial number of columns.
-     * This may be overridden either by the user (if resizable true), or by the dashboard.
-     */
-    initialColumns?: number;
-    /**
-     * Sets the desired initial number of rows.
-     * This may be overridden either by the user (if resizable true), or by the dashboard.
-     */
-    initialRows?: number;
-    /**
-     * Determines if the tile can be resized by the user.
-     * By default the size of the tile is fixed.
-     */
-    resizable?: boolean;
-    /**
-     * Declares a set of custom properties to be used with user-specified values.
-     */
-    customProperties?: Array<string>;
-  }
-
-  export interface MenuComponentProps extends BaseComponentProps {}
-
-  export interface MenuSettings extends PiralCustomMenuSettings {
-    /**
-     * Sets the type of the menu to attach to.
-     * @default "general"
-     */
-    type?: MenuType;
-  }
-
-  export type NotificationComponentProps = BaseComponentProps & BareNotificationProps;
-
-  export interface NotificationOptions extends PiralCustomNotificationOptions {
-    /**
-     * The title of the notification, if any.
-     */
-    title?: string;
-    /**
-     * Determines when the notification should automatically close in milliseconds.
-     * A value of 0 or undefined forces the user to close the notification.
-     */
-    autoClose?: number;
-    /**
-     * The type of the notification used when displaying the message.
-     * By default info is used.
-     */
-    type?: "info" | "success" | "warning" | "error";
-  }
-
-  export type ModalOptions<T> = T extends keyof PiralModalsMap ? PiralModalsMap[T] & BaseModalOptions : T extends string ? BaseModalOptions : T;
-
-  export type ModalComponentProps<T> = BaseComponentProps & BareModalComponentProps<ModalOptions<T>>;
-
-  /**
-   * The options provided for the dialog layout.
-   */
-  export interface ModalLayoutOptions {}
-
-  export interface FeedResolver<TData> {
-    (): Promise<TData>;
-  }
-
-  export type FeedConnector<TData, TReducers = {}> = GetActions<TReducers> & {
-    <TProps>(component: React.ComponentType<TProps & FeedConnectorProps<TData>>): React.FC<TProps>;
-    /**
-     * Invalidates the underlying feed connector.
-     * Forces a reload on next use.
-     */
-    invalidate(): void;
-  };
-
-  export interface FeedConnectorOptions<TData, TItem, TReducers extends FeedConnectorReducers<TData> = {}> {
-    /**
-     * Function to derive the initial set of data.
-     * @returns The promise for retrieving the initial data set.
-     */
-    initialize: FeedResolver<TData>;
-    /**
-     * Function to be called for connecting to a live data feed.
-     * @param callback The function to call when an item updated.
-     * @returns A callback for disconnecting from the feed.
-     */
-    connect?: FeedSubscriber<TItem>;
-    /**
-     * Function to be called when some data updated.
-     * @param data The current set of data.
-     * @param item The updated item to include.
-     * @returns The promise for retrieving the updated data set or the updated data set.
-     */
-    update?: FeedReducer<TData, TItem>;
-    /**
-     * Defines the optional reducers for modifying the data state.
-     */
-    reducers?: TReducers;
-    /**
-     * Optional flag to avoid lazy loading and initialize the data directly.
-     */
-    immediately?: boolean;
-  }
-
-  export interface FeedConnectorReducers<TData> {
-    [name: string]: (data: TData, ...args: any) => Promise<TData> | TData;
-  }
-
-  export interface SearchProvider {
-    (options: SearchOptions, api: PiletApi): Promise<SearchResultType | Array<SearchResultType>>;
-  }
-
-  export interface SearchSettings {
-    /**
-     * Only invoke the search provider if its an immediate search.
-     */
-    onlyImmediate?: boolean;
-    /**
-     * Callback to be fired when the search is cleared.
-     */
-    onClear?(): void;
-    /**
-     * Callback to be fired when an existing search is cancelled.
-     */
-    onCancel?(): void;
-  }
-
-  export interface UserInfo {
-    id: string;
-    firstName: string;
-    lastName: string;
-    mail: string;
-    language: string;
-    permissions: UserPermissions;
-    features: UserFeatures;
-  }
-
-  /**
-   * Defines the potential targets when storing data.
-   */
-  export type DataStoreTarget = "memory" | "local" | "remote";
-
-  /**
-   * Defines the custom options for storing data.
-   */
-  export interface CustomDataStoreOptions {
-    /**
-     * The target data store. By default the data is only stored in memory.
-     */
-    target?: DataStoreTarget;
-    /**
-     * Optionally determines when the data expires.
-     */
-    expires?: "never" | Date | number;
-  }
-
-  export type FirstParametersOf<T> = {
-    [K in keyof T]: T[K] extends (arg: any) => any ? FirstParameter<T[K]> : never;
-  }[keyof T];
-
-  /**
-   * Mapping of available component converters.
-   */
-  export interface ComponentConverters<TProps> extends PiralCustomComponentConverters<TProps> {
-    /**
-     * Converts the HTML component to a framework-independent component.
-     * @param component The vanilla JavaScript component to be converted.
-     */
-    html(component: HtmlComponent<TProps>): ForeignComponent<TProps>;
-  }
-
-  /**
-   * The props that every registered page component obtains.
-   */
-  export interface RouteBaseProps<UrlParams = any, UrlState = any> extends ReactRouter.RouteComponentProps<UrlParams, {}, UrlState>, BaseComponentProps {}
-
-  /**
-   * Custom meta data to include for pages.
-   */
-  export interface PiralCustomPageMeta {}
-
-  /**
-   * The props of an extension component.
-   */
-  export interface ExtensionComponentProps<T> extends BaseComponentProps {
-    /**
-     * The provided parameters for showing the extension.
-     */
-    params: T extends keyof PiralExtensionSlotMap ? PiralExtensionSlotMap[T] : T extends string ? any : T;
-    /**
-     * The optional children to receive, if any.
-     */
-    children?: React.ReactNode;
-  }
-
-  /**
-   * The mapping of the existing (known) extension slots.
-   */
-  export interface PiralExtensionSlotMap extends PiralCustomExtensionSlotMap {}
-
-  /**
-   * The basic props for defining an extension slot.
-   */
-  export interface BaseExtensionSlotProps<TName, TParams> {
-    /**
-     * The children to transport, if any.
-     */
-    children?: React.ReactNode;
-    /**
-     * Defines what should be rendered when no components are available
-     * for the specified extension.
-     */
-    empty?(): React.ReactNode;
-    /**
-     * Determines if the `render` function should be called in case no
-     * components are available for the specified extension.
-     * 
-     * If true, `empty` will be called and returned from the slot.
-     * If false, `render` will be called with the result of calling `empty`.
-     * The result of calling `render` will then be returned from the slot.
-     */
-    emptySkipsRender?: boolean;
-    /**
-     * Defines the order of the components to render.
-     * May be more convient than using `render` w.r.t. ordering extensions
-     * by their supplied metadata.
-     * @param extensions The registered extensions.
-     * @returns The ordered extensions.
-     */
-    order?(extensions: Array<ExtensionRegistration>): Array<ExtensionRegistration>;
-    /**
-     * Defines how the provided nodes should be rendered.
-     * @param nodes The rendered extension nodes.
-     * @returns The rendered nodes, i.e., an ReactElement.
-     */
-    render?(nodes: Array<React.ReactNode>): React.ReactElement<any, any> | null;
-    /**
-     * The custom parameters for the given extension.
-     */
-    params?: TParams;
-    /**
-     * The name of the extension to render.
-     */
-    name: TName;
-  }
-
-  export interface PiralSelectLanguageEvent {
-    /**
-     * Gets the previously selected language.
-     */
-    previousLanguage: string;
-    /**
-     * Gets the currently selected language.
-     */
-    currentLanguage: string;
-  }
-
-  export interface PiralChangeUserEvent {
-    previous: UserInfo;
-    current: UserInfo;
-  }
-
-  export interface Translations {
-    [tag: string]: string;
-  }
-
-  /**
-   * The props that every registered component obtains.
-   */
-  export interface BaseComponentProps {
-    /**
-     * The currently used pilet API.
-     */
-    piral: PiletApi;
-  }
-
-  export interface BareTileComponentProps {
-    /**
-     * The currently used number of columns.
-     */
-    columns: number;
-    /**
-     * The currently used number of rows.
-     */
-    rows: number;
-  }
-
-  export interface PiralCustomTilePreferences {}
-
-  export interface PiralCustomMenuSettings {}
-
-  export type MenuType = StandardMenuType | keyof PiralCustomMenuTypes;
-
-  export interface BareNotificationProps {
-    /**
-     * Callback for closing the notification programmatically.
-     */
-    onClose(): void;
-    /**
-     * Provides the passed in options for this particular notification.
-     */
-    options: NotificationOptions;
-  }
-
-  export interface PiralCustomNotificationOptions {}
-
-  export interface BaseModalOptions {}
-
-  export interface PiralModalsMap extends PiralCustomModalsMap {}
-
-  export interface BareModalComponentProps<TOpts> {
-    /**
-     * Callback for closing the modal programmatically.
-     */
-    onClose(): void;
-    /**
-     * Provides the passed in options for this particular modal.
-     */
-    options?: TOpts;
-  }
-
-  export type GetActions<TReducers> = {
-    [P in keyof TReducers]: (...args: RemainingArgs<TReducers[P]>) => void;
-  };
-
-  export interface FeedConnectorProps<TData> {
-    /**
-     * The current data from the feed.
-     */
-    data: TData;
-  }
-
-  export interface FeedSubscriber<TItem> {
-    (callback: (value: TItem) => void): Disposable;
-  }
-
-  export interface FeedReducer<TData, TAction> {
-    (data: TData, item: TAction): Promise<TData> | TData;
-  }
-
-  export interface SearchOptions {
-    /**
-     * Gets the query for the search. This is currently available input
-     * value.
-     */
-    query: string;
-    /**
-     * Gets if the search was requested immediately, e.g., via pressing
-     * the enter key.
-     */
-    immediate: boolean;
-  }
-
-  export type SearchResultType = string | React.ReactElement<any> | AnyComponent<SearchResultComponentProps>;
-
-  export type UserPermissions = Record<string, any>;
-
-  export type UserFeatures = Record<string, boolean>;
-
-  export type FirstParameter<T extends (arg: any) => any> = T extends (arg: infer P) => any ? P : never;
+export type GetActions<TReducers> = {
+  [P in keyof TReducers]: (...args: RemainingArgs<TReducers[P]>) => void;
+};
 
+export interface FeedConnectorProps<TData> {
   /**
-   * Custom component converters defined outside of piral-core.
-   */
-  export interface PiralCustomComponentConverters<TProps> {}
-
-  /**
-   * Definition of a vanilla JavaScript component.
-   */
-  export interface HtmlComponent<TProps> {
-    /**
-     * Renders a component into the provided element using the given props and context.
-     */
-    component: ForeignComponent<TProps>;
-    /**
-     * The type of the HTML component.
-     */
-    type: "html";
-  }
-
-  /**
-   * Generic definition of a framework-independent component.
-   */
-  export interface ForeignComponent<TProps> {
-    /**
-     * Called when the component is mounted.
-     * @param element The container hosting the element.
-     * @param props The props to transport.
-     * @param ctx The associated context.
-     * @param locals The local state of this component instance.
-     */
-    mount(element: HTMLElement, props: TProps, ctx: ComponentContext, locals: Record<string, any>): void;
-    /**
-     * Called when the component should be updated.
-     * @param element The container hosting the element.
-     * @param props The props to transport.
-     * @param ctx The associated context.
-     * @param locals The local state of this component instance.
-     */
-    update?(element: HTMLElement, props: TProps, ctx: ComponentContext, locals: Record<string, any>): void;
-    /**
-     * Called when a component is unmounted.
-     * @param element The container that was hosting the element.
-     * @param locals The local state of this component instance.
-     */
-    unmount?(element: HTMLElement, locals: Record<string, any>): void;
-  }
-
-  /**
-   * Custom extension slots outside of piral-core.
-   */
-  export interface PiralCustomExtensionSlotMap {}
-
-  /**
-   * The interface modeling the registration of a pilet extension component.
-   */
-  export interface ExtensionRegistration extends BaseRegistration {
-    /**
-     * The wrapped registered extension component.
-     */
-    component: WrappedComponent<ExtensionComponentProps<string>>;
-    /**
-     * The original extension component that has been registered.
-     */
-    reference: any;
-    /**
-     * The default params (i.e., meta) of the extension.
-     */
-    defaults: any;
-  }
-
-  export type StandardMenuType = "general" | "admin" | "user" | "header" | "footer";
-
-  export interface PiralCustomMenuTypes {}
-
-  export interface PiralCustomModalsMap {}
-
-  export type RemainingArgs<T> = T extends (_: any, ...args: infer U) => any ? U : never;
-
-  export interface SearchResultComponentProps extends BaseComponentProps {}
-
-  /**
-   * The context to be transported into the generic components.
-   */
-  export interface ComponentContext {
-    navigation: NavigationApi;
-    publicPath: string;
-  }
-
-  /**
-   * The base type for pilet component registration in the global state context.
-   */
-  export interface BaseRegistration {
-    /**
-     * The pilet registering the component.
-     */
-    pilet: string;
-  }
-
-  export type WrappedComponent<TProps> = React.ComponentType<React.PropsWithChildren<Without<TProps, keyof BaseComponentProps>>>;
-
-  export interface NavigationApi {
-    /**
-     * Pushes a new location onto the history stack.
-     */
-    push(target: string, state?: any): void;
-    /**
-     * Replaces the current location with another.
-     */
-    replace(target: string, state?: any): void;
-    /**
-     * Changes the current index in the history stack by a given delta.
-     */
-    go(n: number): void;
-    /**
-     * 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.
-     */
-    block(blocker: NavigationBlocker): Disposable;
-    /**
-     * 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.
-     */
-    listen(listener: NavigationListener): Disposable;
-    /**
-     * The original router behind the navigation.
-     */
-    router: any;
-  }
-
-  export type Without<T, K> = Pick<T, Exclude<keyof T, K>>;
-
-  export interface NavigationBlocker {
-    (tx: NavigationTransition): void;
-  }
-
-  export interface NavigationListener {
-    (update: NavigationUpdate): void;
-  }
-
-  export interface NavigationTransition extends NavigationUpdate {
-    retry(): void;
-  }
-
-  export interface NavigationUpdate {
-    action: NavigationAction;
-    location: NavigationLocation;
-  }
-
-  export type NavigationAction = "POP" | "PUSH" | "REPLACE";
-
-  export interface NavigationLocation {
-    /**
-     * The fully qualified URL incl. the origin and base path.
-     */
-    href: string;
-    /**
-     * The location.pathname property is a string that contains an initial "/"
-     * followed by the remainder of the URL up to the ?.
-     */
-    pathname: string;
-    /**
-     * 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. '').
-     */
-    search: string;
-    /**
-     * 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. '').
-     */
-    hash: string;
-    /**
-     * 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.
-     */
-    state: unknown;
-    /**
-     * 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.
-     */
-    key: string;
-  }
+   * The current data from the feed.
+   */
+  data: TData;
+}
+
+export interface FeedSubscriber<TItem> {
+  (callback: (value: TItem) => void): Disposable;
+}
+
+export interface FeedReducer<TData, TAction> {
+  (data: TData, item: TAction): Promise<TData> | TData;
+}
+
+export interface SearchOptions {
+  /**
+   * Gets the query for the search. This is currently available input
+   * value.
+   */
+  query: string;
+  /**
+   * Gets if the search was requested immediately, e.g., via pressing
+   * the enter key.
+   */
+  immediate: boolean;
+}
+
+export type SearchResultType = string | React.ReactElement<any> | AnyComponent<SearchResultComponentProps>;
+
+export type UserPermissions = Record<string, any>;
+
+export type UserFeatures = Record<string, boolean>;
+
+export type FirstParameter<T extends (arg: any) => any> = T extends (arg: infer P) => any ? P : never;
+
+/**
+ * Custom component converters defined outside of piral-core.
+ */
+export interface PiralCustomComponentConverters<TProps> {}
+
+/**
+ * Definition of a vanilla JavaScript component.
+ */
+export interface HtmlComponent<TProps> {
+  /**
+   * Renders a component into the provided element using the given props and context.
+   */
+  component: ForeignComponent<TProps>;
+  /**
+   * The type of the HTML component.
+   */
+  type: "html";
+}
+
+/**
+ * Generic definition of a framework-independent component.
+ */
+export interface ForeignComponent<TProps> {
+  /**
+   * Called when the component is mounted.
+   * @param element The container hosting the element.
+   * @param props The props to transport.
+   * @param ctx The associated context.
+   * @param locals The local state of this component instance.
+   */
+  mount(element: HTMLElement, props: TProps, ctx: ComponentContext, locals: Record<string, any>): void;
+  /**
+   * Called when the component should be updated.
+   * @param element The container hosting the element.
+   * @param props The props to transport.
+   * @param ctx The associated context.
+   * @param locals The local state of this component instance.
+   */
+  update?(element: HTMLElement, props: TProps, ctx: ComponentContext, locals: Record<string, any>): void;
+  /**
+   * Called when a component is unmounted.
+   * @param element The container that was hosting the element.
+   * @param locals The local state of this component instance.
+   */
+  unmount?(element: HTMLElement, locals: Record<string, any>): void;
+}
+
+/**
+ * Custom extension slots outside of piral-core.
+ */
+export interface PiralCustomExtensionSlotMap {}
+
+/**
+ * The interface modeling the registration of a pilet extension component.
+ */
+export interface ExtensionRegistration extends BaseRegistration {
+  /**
+   * The wrapped registered extension component.
+   */
+  component: WrappedComponent<ExtensionComponentProps<string>>;
+  /**
+   * The original extension component that has been registered.
+   */
+  reference: any;
+  /**
+   * The default params (i.e., meta) of the extension.
+   */
+  defaults: any;
+}
+
+export type StandardMenuType = "general" | "admin" | "user" | "header" | "footer";
+
+export interface PiralCustomMenuTypes {}
+
+export interface PiralCustomModalsMap {}
+
+export type RemainingArgs<T> = T extends (_: any, ...args: infer U) => any ? U : never;
+
+export interface SearchResultComponentProps extends BaseComponentProps {}
+
+/**
+ * The context to be transported into the generic components.
+ */
+export interface ComponentContext {
+  navigation: NavigationApi;
+  publicPath: string;
+}
+
+/**
+ * The base type for pilet component registration in the global state context.
+ */
+export interface BaseRegistration {
+  /**
+   * The pilet registering the component.
+   */
+  pilet: string;
+}
+
+export type WrappedComponent<TProps> = React.ComponentType<React.PropsWithChildren<Without<TProps, keyof BaseComponentProps>>>;
+
+export interface NavigationApi {
+  /**
+   * Pushes a new location onto the history stack.
+   */
+  push(target: string, state?: any): void;
+  /**
+   * Replaces the current location with another.
+   */
+  replace(target: string, state?: any): void;
+  /**
+   * Changes the current index in the history stack by a given delta.
+   */
+  go(n: number): void;
+  /**
+   * 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.
+   */
+  block(blocker: NavigationBlocker): Disposable;
+  /**
+   * 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.
+   */
+  listen(listener: NavigationListener): Disposable;
+  /**
+   * Gets the current path.
+   */
+  path: string;
+  /**
+   * The original router behind the navigation.
+   */
+  router: any;
+}
+
+export type Without<T, K> = Pick<T, Exclude<keyof T, K>>;
+
+export interface NavigationBlocker {
+  (tx: NavigationTransition): void;
+}
+
+export interface NavigationListener {
+  (update: NavigationUpdate): void;
+}
+
+export interface NavigationTransition extends NavigationUpdate {
+  retry(): void;
+}
+
+export interface NavigationUpdate {
+  action: NavigationAction;
+  location: NavigationLocation;
+}
+
+export type NavigationAction = "POP" | "PUSH" | "REPLACE";
+
+export interface NavigationLocation {
+  /**
+   * The fully qualified URL incl. the origin and base path.
+   */
+  href: string;
+  /**
+   * The location.pathname property is a string that contains an initial "/"
+   * followed by the remainder of the URL up to the ?.
+   */
+  pathname: string;
+  /**
+   * 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. '').
+   */
+  search: string;
+  /**
+   * 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. '').
+   */
+  hash: string;
+  /**
+   * 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.
+   */
+  state: unknown;
+  /**
+   * 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.
+   */
+  key: string;
 }