export declare const ZHIN_PROJECT_ROOT_ENV = "ZHIN_PROJECT_ROOT";
export type ZhinInstanceKind = 'project' | 'global';
export interface ZhinProjectInstance {
    kind: 'project';
    root: string;
}
export interface ZhinGlobalInstance {
    kind: 'global';
    root: string;
}
export type ZhinInstance = ZhinProjectInstance | ZhinGlobalInstance;
/** 全局 Zhin 实例目录（`~/.zhin`） */
export declare function globalZhinHome(homeDir?: string): string;
/** `package.json` 是否声明 `zhin.js` 依赖 */
export declare function hasZhinPackageJson(dir: string): boolean;
export declare function hasZhinConfig(dir: string): boolean;
export declare function hasNodeModules(dir: string): boolean;
/** 当前目录是否为 Zhin 项目根 */
export declare function findProjectInstance(cwd?: string): ZhinProjectInstance | null;
/** `~/.zhin` 是否已初始化为全局实例 */
export declare function findGlobalInstance(homeDir?: string): ZhinGlobalInstance | null;
/**
 * 选择启动目标：当前目录的 **project** 优先，否则 **global**（`~/.zhin`）。
 */
export declare function resolveProjectOrGlobal(cwd?: string, homeDir?: string): ZhinInstance | null;
/**
 * 构建子进程环境：剔除 pnpm 注入的 npm_*，并设置 `ZHIN_PROJECT_ROOT`。
 */
export declare function buildSpawnEnv(instanceRoot: string, extra?: Record<string, string | undefined>): Record<string, string | undefined>;
//# sourceMappingURL=zhin-home.d.ts.map