import { NavigationRuntimeApi } from "@trackunit/iris-app-runtime-core-api";
/**
 * Hook to navigate programmatically within the Trackunit Manager or between Iris Apps.
 *
 * ### When to use
 * Use `useNavigateInHost` when you need to navigate between Manager pages, entity home
 * pages, or Iris Apps from component logic (e.g. after a mutation, on row click, in a
 * redirect guard). Use the `get*Url` methods when you need an href for an `<a>` tag.
 * Use `hasAccessTo` before showing navigation options the user may not have access to.
 *
 * ### When not to use
 * Do not use for in-page anchor scrolling or query-param changes within the same
 * Iris App — use your router directly.
 *
 * @requires NavigationContext
 * @example
 * import { useNavigateInHost } from "@trackunit/react-core-hooks";
 * const { gotoAssetHome, gotoFleetApp } = useNavigateInHost();
 *
 * gotoAssetHome("abc-123", { page: "status" });
 * gotoFleetApp({ page: "assets" });
 * @see {@link NavigationRuntimeApi}
 */
export declare const useNavigateInHost: () => NavigationRuntimeApi;