/**
 * @traffical/svelte - Hooks
 *
 * Svelte 5 hooks for parameter resolution and decision tracking.
 * Uses $state with event-driven recomputation for cross-package reactivity.
 *
 * IMPORTANT — Reactivity & Destructuring:
 * `params` is returned as a deep $state proxy. Destructuring it is safe:
 *   const { params } = useTraffical({ defaults: { ... } });
 *   {params['my.key']}  // reactive ✅
 *
 * `decision`, `ready`, `error` are primitives/objects behind getters.
 * Access them through the returned object for reactivity:
 *   const t = useTraffical({ defaults: { ... } });
 *   {t.ready}      // reactive ✅
 *   {t.decision}   // reactive ✅
 */
import type { ParameterValue, TrackEventMap } from "@traffical/core";
import type { TrafficalPlugin, TrafficalClient } from "@traffical/js-client";
import type { UseTrafficalOptions, UseTrafficalResult, TrackRewardOptions } from "./types.js";
/**
 * Primary hook for Traffical parameter resolution and decision tracking.
 *
 * Returns reactive values that automatically update when the config bundle changes.
 * On first render, returns defaults immediately (no blocking).
 * When the config bundle loads, recomputes and returns resolved values.
 *
 * @example
 * ```svelte
 * <script>
 *   import { useTraffical } from '@traffical/svelte';
 *
 *   // Destructuring `params` is safe — it's a deep reactive proxy.
 *   // For `ready`/`decision`, access via the object for reactivity.
 *   const { params, trackExposure } = useTraffical({
 *     defaults: { "checkout.ctaText": "Buy Now" },
 *   });
 * </script>
 *
 * <button>{params['checkout.ctaText']}</button>
 * ```
 *
 * @example
 * ```svelte
 * <script>
 *   // Access decision/ready through the object (not destructured)
 *   const t = useTraffical({
 *     defaults: { "checkout.ctaText": "Buy Now" },
 *     tracking: "decision",
 *   });
 * </script>
 *
 * {#if t.ready}
 *   <button onclick={() => t.trackExposure()}>
 *     {t.params['checkout.ctaText']}
 *   </button>
 * {/if}
 * ```
 *
 * @example
 * ```svelte
 * <script>
 *   // No tracking - for SSR, tests, or internal logic
 *   const { params } = useTraffical({
 *     defaults: { "ui.hero.title": "Welcome" },
 *     tracking: "none",
 *   });
 * </script>
 * ```
 */
export declare function useTraffical<T extends Record<string, ParameterValue>, TEvents extends TrackEventMap = TrackEventMap>(options: UseTrafficalOptions<T>): UseTrafficalResult<T, TEvents>;
/**
 * Hook to track user events.
 *
 * @example
 * ```svelte
 * <script>
 *   import { useTrafficalTrack } from '@traffical/svelte';
 *
 *   const track = useTrafficalTrack();
 *
 *   function handlePurchase(amount: number) {
 *     track({
 *       event: 'purchase',
 *       properties: { value: amount, orderId: 'ord_123' },
 *     });
 *   }
 * </script>
 * ```
 */
export declare function useTrafficalTrack<TEvents extends TrackEventMap = TrackEventMap>(): {
    <E extends Extract<keyof TEvents, string>>(options: {
        event: E;
        properties?: TEvents[E];
        decisionId?: string;
    }): void;
};
/**
 * @deprecated Use useTrafficalTrack() instead.
 *
 * Hook to track rewards (conversions, revenue, etc.).
 *
 * @example
 * ```svelte
 * <script>
 *   import { useTraffical, useTrafficalReward } from '@traffical/svelte';
 *
 *   const t = useTraffical({
 *     defaults: { 'checkout.ctaText': 'Buy Now' },
 *   });
 *
 *   const trackReward = useTrafficalReward();
 *
 *   function handlePurchase(amount: number) {
 *     trackReward({
 *       reward: amount,
 *       rewardType: 'revenue',
 *       decisionId: t.decision?.decisionId,
 *     });
 *   }
 * </script>
 * ```
 */
export declare function useTrafficalReward(): (options: TrackRewardOptions) => void;
/**
 * Hook to access the Traffical client directly.
 *
 * @example
 * ```svelte
 * <script>
 *   import { useTrafficalClient } from '@traffical/svelte';
 *
 *   const { client, ready, error } = useTrafficalClient();
 *
 *   $effect(() => {
 *     if (ready && client) {
 *       const version = client.getConfigVersion();
 *       const stableId = client.getStableId();
 *       console.log('Config version:', version, 'Stable ID:', stableId);
 *     }
 *   });
 * </script>
 * ```
 */
export declare function useTrafficalClient(): {
    readonly client: TrafficalClient | null;
    readonly ready: boolean;
    readonly error: Error | null;
};
/**
 * Hook to access a registered plugin by name.
 * Plugins are registered at initialization and don't change at runtime.
 *
 * @example
 * ```svelte
 * <script>
 *   import { useTrafficalPlugin } from '@traffical/svelte';
 *   import type { DOMBindingPlugin } from '@traffical/js-client';
 *
 *   const domPlugin = useTrafficalPlugin<DOMBindingPlugin>('dom-binding');
 *   domPlugin?.applyBindings();
 * </script>
 * ```
 */
export declare function useTrafficalPlugin<T extends TrafficalPlugin = TrafficalPlugin>(name: string): T | undefined;
//# sourceMappingURL=hooks.svelte.d.ts.map