import type { ActionReturn } from "svelte/action";
import type { Params, NavigationOptions } from "@real-router/core";
export interface LinkActionParams {
    name: string;
    params?: Params;
    options?: NavigationOptions;
}
type LinkAction = (node: HTMLElement, params: LinkActionParams) => ActionReturn<LinkActionParams>;
/**
 * Factory function that captures router context during component initialization.
 * Must be called during component init (not inside event handlers or effects).
 *
 * @returns Action function for use with `use:` directive
 * @throws Error if called outside RouterProvider
 *
 * @example
 * ```svelte
 * <script>
 *   import { createLinkAction } from '@real-router/svelte';
 *   const link = createLinkAction();
 * </script>
 *
 * <button use:link={{ name: 'home' }}>Home</button>
 * <a use:link={{ name: 'users', params: { id: '123' } }}>User Profile</a>
 * ```
 */
export declare function createLinkAction(): LinkAction;
export {};