/**
 * Native addon loader with graceful fallback to WASM.
 *
 * Tries to load the platform-specific napi-rs binary built from
 * crates/codegraph-core.  If unavailable the caller should fall back
 * to the existing WASM pipeline.
 */
import type { NativeAddon } from '../types.js';
/**
 * Try to load the native napi addon.
 * Returns the module on success, null on failure.
 *
 * Load order:
 *   1. NAPI_RS_NATIVE_LIBRARY_PATH env var (explicit override)
 *   2. locally compiled binary in crates/codegraph-core/ (dev mode — preferred
 *      over the npm package so that Rust changes are picked up immediately
 *      without publishing a new release)
 *   3. npm platform package (production path)
 */
export declare function loadNative(): NativeAddon | null;
/**
 * Check whether the native engine is available on this platform.
 */
export declare function isNativeAvailable(): boolean;
/**
 * Read the version from the platform-specific npm package.json.
 * Returns null if the package is not installed or has no version.
 *
 * Note: always reports the npm package version. When the local dev binary or
 * NAPI_RS_NATIVE_LIBRARY_PATH is loaded instead, this version may not match
 * the running binary.
 */
export declare function getNativePackageVersion(): string | null;
/**
 * Return the native module or throw if not available.
 */
export declare function getNative(): NativeAddon;
//# sourceMappingURL=native.d.ts.map