import { DazzleWebHash, DazzleWebVectorIndex, VectorSearchHit } from './dazzle_web';
/**
 * Initialise the WASM module + restore an OPFS snapshot, exactly once.
 *
 * Returns:
 *   - `ready`  — true once initialise() resolved
 *   - `error`  — the Error if loading failed (e.g. missing <script> tag)
 *
 * Use this once near the root of your tree:
 *
 * ```tsx
 * const { ready, error } = useDazzleInit();
 * if (error) return <ErrorScreen error={error} />;
 * if (!ready) return <Spinner />;
 * return <App />;   // children can use useDazzleHash / useVectorIndex
 * ```
 */
export declare function useDazzleInit(opts?: {
    opfsFileName?: string;
}): {
    ready: boolean;
    error: Error | null;
};
/**
 * Returns a stable handle to the hash at `key`.  The handle methods
 * (set / get / etc.) are synchronous because the WASM call is
 * in-process — no need for useEffect / loading states.
 *
 * If `useDazzleInit` hasn't resolved yet, calling any handle method
 * will throw.  Render-gate behind `ready`.
 */
export declare function useDazzleHash(key: string): DazzleWebHash;
/**
 * Returns a stable handle to the vector index at `name`.
 */
export declare function useVectorIndex(name: string): DazzleWebVectorIndex;
/**
 * Run a vector search and re-render when the query changes.
 *
 * `query` is treated by reference identity — wrap it in `useMemo` if
 * you compute it from props/state, otherwise the search runs every
 * render.
 */
export declare function useVectorSearch(indexName: string, query: Float32Array | null, opts?: {
    topK?: number;
    ef?: number;
}): {
    hits: VectorSearchHit[];
    refresh: () => void;
};
/**
 * Auto-persist on unmount.  Drops the snapshot to OPFS when the
 * component using this hook unmounts (e.g. on app navigation away).
 * Useful as a fire-and-forget call site near the app root.
 */
export declare function useAutoPersist(): void;
//# sourceMappingURL=hooks.d.ts.map