export interface UseSnapshotOptions {
    /** Path string declared by the caller (e.g. "dashboard.cards"). Optional —
     *  without it we fall back to the empty root path. */
    path?: string;
    /** Store id (set by `proxy()`); the snapshot wrapper can't recover this
     *  from the proxy alone, so callers must supply it. */
    storeId: string;
}
export declare function useTrackedSnapshot<T extends object>(target: T, opts: UseSnapshotOptions): T;
/**
 * Drop-in `useSnapshot(store)` matching valtio's signature exactly. Infers
 * the read paths from `proxy-compare`'s affected map and registers one
 * subscription per path. Recovers the storeId tagged by the instrumented
 * `proxy()`; falls back to a single root subscription when nothing is read.
 */
export declare function useSnapshot<T extends object>(target: T): T;
/** Join a visited-property path, truncated to {@link SUB_PATH_DEPTH} segments (0 ⇒ no truncation).
 * Built in ONE pass with no intermediate arrays — this runs per visited property per snapshot,
 * hot enough to chart in commit-storm profiles when written as map().slice().join(). */
export declare function truncatePath(parts: readonly (string | symbol)[]): string;