import type { BrowserInstanceConfig } from "./config.js";
/** 源码 offscreen/main.ts 里的占位符,wxt build 保留字符串字面量。 */
export declare const HOST_WS_URL_PLACEHOLDER = "__MOONCAT_BROWSER_HOST_WS_URL__";
/** 包内 webplater 扩展模板目录。dist/cli.js -> ../../browser-op/webplater/dist/chrome-mv3。 */
export declare function extensionTemplateDir(): string;
/** 实例扩展目录内的 metadata 文件名。 */
export declare const METADATA_FILENAME = ".mooncat-instance.json";
/** metadata 结构。 */
export interface InstanceExtensionMetadata {
    instance: string;
    extensionPort: number;
    hostWsUrl: string;
    generatedAt: string;
    /** 模板来源的 manifest version(用于检测包升级后需要重 prepare)。 */
    sourceBuildVersion: string;
}
/**
 * 为实例生成 unpacked 扩展目录。
 *
 * 步骤:rm 旧目录 → mkdir → copy 模板 → 替换占位符 → 写 metadata。
 * 幂等:重复调用会清空重建。
 *
 * @returns 被替换占位符的文件数 + metadata
 */
export declare function prepareExtension(cfg: BrowserInstanceConfig): {
    replacedFiles: number;
    metadata: InstanceExtensionMetadata;
    templateDir: string;
};
/** 读实例 extensionDir 的 metadata。不存在返回 null。 */
export declare function readInstanceMetadata(cfg: BrowserInstanceConfig): InstanceExtensionMetadata | null;
/**
 * 校验实例 extensionDir 是否就绪(用于 start --route extension 前置检查)。
 * 返回 null 表示就绪;返回字符串表示需要重 prepare 的原因。
 */
export declare function verifyInstanceExtension(cfg: BrowserInstanceConfig): string | null;
//# sourceMappingURL=prepare-extension.d.ts.map