/**
 * Navigate to a URL. Uses stxRouter if available, otherwise falls back to location.href.
 *
 * @example
 * ```ts
 * navigate('/about')
 * navigate('https://example.com')
 * ```
 */
export declare function navigate(url: string): void;
/**
 * Go back in browser history.
 */
export declare function goBack(): void;
/**
 * Go forward in browser history.
 */
export declare function goForward(): void;
/**
 * Get reactive route information.
 *
 * @example
 * ```ts
 * const route = useRoute()
 * console.log(route.path)   // '/about'
 * console.log(route.query)  // { page: '2' }
 * ```
 */
export declare function useRoute(): RouteInfo;
/**
 * Set route params (called by server injection or page scripts).
 */
export declare function setRouteParams(params: Record<string, string>): void;
/**
 * Reactive URL search parameters with get/set/setAll methods.
 *
 * @example
 * ```ts
 * const search = useSearchParams()
 * search.set('page', '2')
 * console.log(search.get('page')) // '2'
 * ```
 */
export declare function useSearchParams(): SearchParamsRef;
/**
 * useRouter - Navigation composable for STX applications
 *
 * Provides clean APIs for navigation without raw `window.location` or `window.history`.
 * These are server-safe stubs; the actual runtime implementations live in signals.ts.
 */
export declare interface RouteInfo {
  path: string
  fullPath: string
  hash: string
  query: Record<string, string>
  params: Record<string, string>
}
export declare interface SearchParamsRef {
  data: { (): Record<string, string>, set: (v: Record<string, string>) => void }
  get: (key: string) => string | undefined
  set: (key: string, value: string) => void
  setAll: (obj: Record<string, string>) => void
}
