mooncat-browser 0.1.0 → 0.2.0

package/dist/config.d.ts

@@ -1,61 +1,82 @@
-/** 解析后的运行时配置。 */
-export interface ResolvedConfig {
-    /** browserd RPC 端口（client 连这里）。默认 17322。 */
+/** 端口默认值(仅在 init 生成配置 / --temp 时使用,不作为运行时兜底)。 */
+export declare const DEFAULT_RPC_PORT = 17322;
+export declare const DEFAULT_HEALTH_PORT = 17440;
+export declare const DEFAULT_EXTENSION_PORT = 17321;
+/** 实例路由模式。第一版只保证 cdp 多实例;extension 路保持单实例。 */
+export type RouteMode = "auto" | "cdp" | "extension";
+/**
+ * 一个 browser 实例的完整配置 = 一组端口 + 一份 profile + 一套 state/log。
+ * 实例之间在文件系统与端口上完全隔离,互不串扰。
+ */
+export interface BrowserInstanceConfig {
+    /** 实例名(配置里 instances 的 key)。 */
+    name: string;
+    /** browserd RPC 端口(client 连这里)。 */
     rpcPort: number;
-    /** 服务包装层 health 端口。默认 17440。 */
+    /** 服务包装层 health 端口。 */
     healthPort: number;
-    /** Chrome user-data-dir（绝对路径）。 */
-    profile: string;
-    /** Chrome 可执行文件路径（未指定时为 undefined，交给 browserd 自动探测）。 */
-    chromePath?: string;
-    /** 日志目录（绝对路径）。 */
+    /** extension WS 端口(每实例独立;由 prepare-extension 写入实例扩展目录)。 */
+    extensionPort: number;
+    /** Chrome user-data-dir(绝对路径)。 */
+    profileDir: string;
+    /** wrapper/browserd 运行态目录(绝对路径),放 service.json 等。 */
+    stateDir: string;
+    /** 日志目录(绝对路径)。 */
     logsDir: string;
-    /** 配置文件路径（绝对路径）。 */
-    configPath: string;
+    /** 实例扩展目录(绝对路径),prepare-extension 生成的 unpacked 扩展落点。 */
+    extensionDir: string;
+    /** Chrome 可执行文件路径(可选,未指定交给 browserd 自动探测)。 */
+    chromePath?: string;
+    /** 路由模式。第一版多实例只走 cdp;auto/extension 由 browserd 内部决策。 */
+    routeMode?: RouteMode;
 }
-/** 默认端口常量。 */
-export declare const DEFAULT_RPC_PORT = 17322;
-export declare const DEFAULT_HEALTH_PORT = 17440;
-/** CLI 传入的覆盖项（全部可选，未传则按优先级回退）。 */
+/** CLI 高级覆盖项(覆盖配置文件里某实例的字段)。 */
 export interface CliOverrides {
     rpcPort?: number;
-    /** CLI 的 --port 别名（语义同 rpcPort：client 连接的 RPC 端口）。 */
+    /** CLI 的 --port 别名(语义同 rpcPort)。 */
     port?: number;
     healthPort?: number;
-    profile?: string;
+    extensionPort?: number;
+    profileDir?: string;
+    stateDir?: string;
+    logsDir?: string;
+    extensionDir?: string;
     chromePath?: string;
-    configPath?: string;
+    routeMode?: RouteMode;
 }
-/** 跨平台 app-data 根目录（不含 mooncat-browser 子目录）。 */
-export declare function appDataRoot(): string;
-/** mooncat-browser 的数据根目录：<appDataRoot>/mooncat-browser。 */
-export declare function appDataDir(): string;
-/** 默认配置文件路径。 */
-export declare function defaultConfigPath(): string;
-/** 默认 profile（user-data-dir）路径。 */
-export declare function defaultProfile(): string;
-/** 默认日志目录。 */
-export declare function defaultLogsDir(): string;
-interface RawConfigFile {
+/** 配置文件里单个实例的原始字段(全部可选,缺字段由 init 期已写齐)。 */
+export interface RawInstance {
     rpcPort?: number;
     healthPort?: number;
-    profile?: string;
+    extensionPort?: number;
+    profileDir?: string;
+    stateDir?: string;
+    logsDir?: string;
+    extensionDir?: string;
     chromePath?: string;
+    routeMode?: RouteMode;
+}
+/** 项目配置文件整体 shape。 */
+export interface ProjectConfigFile {
+    /** 实例表,key = 实例名。 */
+    instances: Record<string, RawInstance>;
 }
-/** 读取配置文件（不存在返回空对象；解析失败返回空对象并打印警告到 stderr）。 */
-export declare function loadConfigFile(path: string): RawConfigFile;
+/** 项目级配置文件候选名(在项目根下查找)。 */
+export declare const CONFIG_FILE_NAMES: readonly ["mooncat-browser.config.json", "config/browser.json"];
+/** 读取并解析项目配置文件。不存在返回 null;解析失败抛错。 */
+export declare function loadProjectConfig(path: string): ProjectConfigFile | null;
 /**
- * 解析最终配置。优先级：cli > env > configFile > default。
- *
- * @param cli CLI 覆盖项（可选）
- * @param configPathHint 配置文件路径提示（默认走 defaultConfigPath）
+ * 把"配置文件里某实例 + CLI 覆盖"合并成一份完整的 BrowserInstanceConfig。
+ * 不做全局兜底:文件里没填、CLI 也没给的字段,用 DEFAULT_* 填(保证总能装出一个实例)。
+ * 相对路径基于 projectRoot 解析成绝对路径。
  */
-export declare function resolveConfig(cli?: CliOverrides, configPathHint?: string): ResolvedConfig;
+export declare function resolveInstance(name: string, raw: RawInstance | null | undefined, cli: CliOverrides, projectRoot: string): BrowserInstanceConfig;
+/** 确保实例的数据目录存在(profile/state/logs 父目录)。 */
+export declare function ensureInstanceDirs(cfg: BrowserInstanceConfig): void;
 /**
- * 把解析后的配置翻译成 browserd 子进程需要的环境变量。
- * browserd.cjs 原生读取：BROWSERD_PORT / BROWSER_OP_USERDATA / BROWSER_OP_CHROME_PATH。
- * 这里做一次语义桥接，避免改动 browserd 核心。
+ * 把解析后的实例配置翻译成 browserd 子进程的环境变量。
+ * browserd.cjs 原生读取 BROWSERD_PORT / BROWSER_OP_USERDATA / BROWSER_OP_CHROME_PATH。
+ * 多实例下加 BROWSER_OP_WS_PORT(extension WS 端口)+ BROWSER_OP_EXTENSION_DIR(实例扩展目录)。
  */
-export declare function browserdEnv(cfg: ResolvedConfig): Record<string, string>;
-export {};
+export declare function browserdEnv(cfg: BrowserInstanceConfig): Record<string, string>;
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAqBA,iBAAiB;AACjB,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,cAAc;AACd,eAAO,MAAM,gBAAgB,QAAQ,CAAC;AACtC,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AAEzC,kCAAkC;AAClC,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,gDAAgD;AAChD,wBAAgB,WAAW,IAAI,MAAM,CAUpC;AAED,4DAA4D;AAC5D,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,gBAAgB;AAChB,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,mCAAmC;AACnC,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,cAAc;AACd,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,UAAU,aAAa;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,+CAA+C;AAC/C,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAU1D;AAeD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,GAAE,YAAiB,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,cAAc,CAmC7F;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQvE"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAWA,iDAAiD;AACjD,eAAO,MAAM,gBAAgB,QAAQ,CAAC;AACtC,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AACzC,eAAO,MAAM,sBAAsB,QAAQ,CAAC;AAE5C,8CAA8C;AAC9C,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,KAAK,GAAG,WAAW,CAAC;AAErD;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,aAAa,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,gCAAgC;AAChC,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,2CAA2C;AAC3C,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,sBAAsB;AACtB,MAAM,WAAW,iBAAiB;IAChC,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACxC;AAED,2BAA2B;AAC3B,eAAO,MAAM,iBAAiB,iEAAkE,CAAC;AAEjG,qCAAqC;AACrC,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAexE;AAoBD;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,EACnC,GAAG,EAAE,YAAY,EACjB,WAAW,EAAE,MAAM,GAClB,qBAAqB,CAmDvB;AAED,2CAA2C;AAC3C,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,qBAAqB,GAAG,IAAI,CAQnE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAY9E"}

package/dist/config.js

@@ -1,66 +1,37 @@
 // -*- coding: utf-8 -*-
-// config.ts — @mooncat/browser 配置解析。
+// config.ts — @mooncat/browser 实例配置。
 //
-// 优先级（高 -> 低）：CLI 参数 > 环境变量 > 配置文件 > 默认值。
+// mooncat-browser 是独立包:不写全局 appData,不假设 mooncat space 目录。
+// 所有运行数据(profile/state/logs)由项目配置显式声明,见 instance.ts 的查找逻辑。
 //
-// 环境变量：
-//   MOONCAT_BROWSERD_PORT   browserd RPC 端口（client 连这里，默认 17322）
-//   MOONCAT_BROWSER_PORT    服务包装层 health 端口（默认 17440）
-//   MOONCAT_BROWSER_PROFILE Chrome user-data-dir（默认 <appData>/mooncat-browser/profile）
-//   MOONCAT_BROWSER_CHROME  Chrome 可执行文件路径（可选，不传则自动探测）
-//
-// 配置文件（JSON）：
-//   Windows:  %LOCALAPPDATA%\mooncat-browser\config.json
-//   macOS:    ~/Library/Application Support/mooncat-browser/config.json
-//   Linux:    $XDG_DATA_HOME/mooncat-browser/config.json (~/.local/share/...)
-//   可用 MOONCAT_BROWSER_CONFIG 覆盖路径。
+// 配置优先级(单实例内):CLI 高级覆盖 > 配置文件该实例 > 报错(无全局兜底)。
 import { existsSync, mkdirSync, readFileSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { homedir, platform } from "node:os";
-/** 默认端口常量。 */
+import { join, resolve } from "node:path";
+/** 端口默认值(仅在 init 生成配置 / --temp 时使用,不作为运行时兜底)。 */
 export const DEFAULT_RPC_PORT = 17322;
 export const DEFAULT_HEALTH_PORT = 17440;
-/** 跨平台 app-data 根目录（不含 mooncat-browser 子目录）。 */
-export function appDataRoot() {
-    const p = platform();
-    if (p === "win32") {
-        return process.env.LOCALAPPDATA || join(homedir(), "AppData", "Local");
-    }
-    if (p === "darwin") {
-        return join(homedir(), "Library", "Application Support");
-    }
-    // linux / 其它：XDG_DATA_HOME 或 ~/.local/share
-    return process.env.XDG_DATA_HOME || join(homedir(), ".local", "share");
-}
-/** mooncat-browser 的数据根目录：<appDataRoot>/mooncat-browser。 */
-export function appDataDir() {
-    return join(appDataRoot(), "mooncat-browser");
-}
-/** 默认配置文件路径。 */
-export function defaultConfigPath() {
-    return process.env.MOONCAT_BROWSER_CONFIG || join(appDataDir(), "config.json");
-}
-/** 默认 profile（user-data-dir）路径。 */
-export function defaultProfile() {
-    return join(appDataDir(), "profile");
-}
-/** 默认日志目录。 */
-export function defaultLogsDir() {
-    return join(appDataDir(), "logs");
-}
-/** 读取配置文件（不存在返回空对象；解析失败返回空对象并打印警告到 stderr）。 */
-export function loadConfigFile(path) {
+export const DEFAULT_EXTENSION_PORT = 17321;
+/** 项目级配置文件候选名(在项目根下查找)。 */
+export const CONFIG_FILE_NAMES = ["mooncat-browser.config.json", "config/browser.json"];
+/** 读取并解析项目配置文件。不存在返回 null;解析失败抛错。 */
+export function loadProjectConfig(path) {
     if (!path || !existsSync(path))
-        return {};
+        return null;
+    const raw = readFileSync(path, "utf8");
+    let obj;
     try {
-        const raw = readFileSync(path, "utf8");
-        const obj = JSON.parse(raw);
-        return obj && typeof obj === "object" ? obj : {};
+        obj = JSON.parse(raw);
     }
     catch (e) {
-        console.error(`[mooncat-browser] config file parse failed (${path}): ${e.message}`);
-        return {};
+        throw new Error(`config file parse failed (${path}): ${e.message}`);
+    }
+    if (!obj || typeof obj !== "object")
+        return null;
+    const file = obj;
+    if (!file.instances || typeof file.instances !== "object") {
+        throw new Error(`config file missing "instances" object (${path})`);
     }
+    return file;
 }
 function firstDefined(...vals) {
     for (const v of vals) {
@@ -75,45 +46,70 @@ function toPort(v, fallback) {
         return Math.floor(n);
     return fallback;
 }
+function toAbs(unknown, projectRoot, fallback) {
+    const p = typeof unknown === "string" ? unknown : fallback;
+    return resolve(projectRoot, p);
+}
 /**
- * 解析最终配置。优先级：cli > env > configFile > default。
- *
- * @param cli CLI 覆盖项（可选）
- * @param configPathHint 配置文件路径提示（默认走 defaultConfigPath）
+ * 把"配置文件里某实例 + CLI 覆盖"合并成一份完整的 BrowserInstanceConfig。
+ * 不做全局兜底:文件里没填、CLI 也没给的字段,用 DEFAULT_* 填(保证总能装出一个实例)。
+ * 相对路径基于 projectRoot 解析成绝对路径。
  */
-export function resolveConfig(cli = {}, configPathHint) {
-    const configPath = configPathHint || cli.configPath || defaultConfigPath();
-    const file = loadConfigFile(configPath);
-    // rpcPort：cli.port 是 cli.rpcPort 的别名（--port 语义）
-    const rpcPort = toPort(firstDefined(cli.rpcPort, cli.port, process.env.MOONCAT_BROWSERD_PORT, file.rpcPort), DEFAULT_RPC_PORT);
-    const healthPort = toPort(firstDefined(cli.healthPort, process.env.MOONCAT_BROWSER_PORT, file.healthPort), DEFAULT_HEALTH_PORT);
-    const profile = firstDefined(cli.profile, process.env.MOONCAT_BROWSER_PROFILE, file.profile) || defaultProfile();
-    const chromePath = firstDefined(cli.chromePath, process.env.MOONCAT_BROWSER_CHROME, file.chromePath);
-    const logsDir = defaultLogsDir();
-    // 确保数据目录存在（profile/logs 父目录）
-    for (const dir of [appDataDir(), dirname(profile), logsDir]) {
+export function resolveInstance(name, raw, cli, projectRoot) {
+    const rpcPort = toPort(firstDefined(cli.rpcPort, cli.port, raw?.rpcPort), DEFAULT_RPC_PORT);
+    const healthPort = toPort(firstDefined(cli.healthPort, raw?.healthPort), DEFAULT_HEALTH_PORT);
+    const extensionPort = toPort(firstDefined(cli.extensionPort, raw?.extensionPort), DEFAULT_EXTENSION_PORT);
+    // 相对路径基于项目根。若文件/CLI 都没给,落到 <projectRoot>/.browser/<name>/... (init 期默认值)
+    const baseFallback = join(".browser", name);
+    const profileDir = toAbs(firstDefined(cli.profileDir, raw?.profileDir), projectRoot, join(baseFallback, "profile"));
+    const stateDir = toAbs(firstDefined(cli.stateDir, raw?.stateDir), projectRoot, join(baseFallback, "state"));
+    const logsDir = toAbs(firstDefined(cli.logsDir, raw?.logsDir), projectRoot, join(baseFallback, "logs"));
+    // 实例扩展目录:prepare-extension 把包内 dist copy 到这里 + 换端口。
+    const extensionDir = toAbs(firstDefined(cli.extensionDir, raw?.extensionDir), projectRoot, join(baseFallback, "extension"));
+    const chromePath = firstDefined(cli.chromePath, raw?.chromePath);
+    const routeMode = firstDefined(cli.routeMode, raw?.routeMode);
+    return {
+        name,
+        rpcPort,
+        healthPort,
+        extensionPort,
+        profileDir,
+        stateDir,
+        logsDir,
+        extensionDir,
+        chromePath,
+        routeMode,
+    };
+}
+/** 确保实例的数据目录存在(profile/state/logs 父目录)。 */
+export function ensureInstanceDirs(cfg) {
+    for (const dir of [cfg.profileDir, cfg.stateDir, cfg.logsDir]) {
         try {
             mkdirSync(dir, { recursive: true });
         }
         catch {
-            /* 忽略：并发创建或权限问题，后续 IO 自行报错 */
+            /* 并发创建或权限问题,后续 IO 自行报错 */
         }
     }
-    return { rpcPort, healthPort, profile, chromePath, logsDir, configPath };
 }
 /**
- * 把解析后的配置翻译成 browserd 子进程需要的环境变量。
- * browserd.cjs 原生读取：BROWSERD_PORT / BROWSER_OP_USERDATA / BROWSER_OP_CHROME_PATH。
- * 这里做一次语义桥接，避免改动 browserd 核心。
+ * 把解析后的实例配置翻译成 browserd 子进程的环境变量。
+ * browserd.cjs 原生读取 BROWSERD_PORT / BROWSER_OP_USERDATA / BROWSER_OP_CHROME_PATH。
+ * 多实例下加 BROWSER_OP_WS_PORT(extension WS 端口)+ BROWSER_OP_EXTENSION_DIR(实例扩展目录)。
  */
 export function browserdEnv(cfg) {
     const env = {
         BROWSERD_PORT: String(cfg.rpcPort),
         IPC_PORT: String(cfg.rpcPort), // browserd 旧名兼容
-        BROWSER_OP_USERDATA: cfg.profile,
+        BROWSER_OP_USERDATA: cfg.profileDir,
+        BROWSER_OP_INSTANCE_NAME: cfg.name,
+        BROWSER_OP_WS_PORT: String(cfg.extensionPort),
+        BROWSER_OP_EXTENSION_DIR: cfg.extensionDir,
     };
     if (cfg.chromePath)
         env.BROWSER_OP_CHROME_PATH = cfg.chromePath;
+    if (cfg.routeMode)
+        env.BROWSER_OP_ROUTE_MODE = cfg.routeMode;
     return env;
 }
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/instance.d.ts

@@ -0,0 +1,57 @@
+import { BrowserInstanceConfig, CliOverrides, ProjectConfigFile } from "./config.js";
+/** 未初始化错误(命令层捕获后输出友好提示并退出)。 */
+export declare class NotInitializedError extends Error {
+    searchedFrom: string;
+    constructor(searchedFrom: string);
+}
+/** 找不到某实例名错误。 */
+export declare class InstanceNotFoundError extends Error {
+    name: string;
+    available: string[];
+    constructor(name: string, available: string[]);
+}
+/** 项目配置查找结果。 */
+export interface ProjectConfigHandle {
+    /** 配置文件绝对路径。 */
+    configPath: string;
+    /** 配置文件所在目录视为项目根(相对路径以此解析)。 */
+    projectRoot: string;
+    /** 解析后的配置对象。 */
+    config: ProjectConfigFile;
+}
+/**
+ * 从 startDir 向上递归查找项目配置。
+ * 候选名:mooncat-browser.config.json,然后 config/browser.json(同一目录两级)。
+ * 找不到抛 NotInitializedError。
+ */
+export declare function findProjectConfig(startDir: string): ProjectConfigHandle;
+/** 列出配置里所有实例名。 */
+export declare function listInstanceNames(handle: ProjectConfigHandle): string[];
+/**
+ * 加载指定实例:从配置读 raw + 合 CLI 覆盖 + 解析成 BrowserInstanceConfig。
+ * 实例不存在抛 InstanceNotFoundError。
+ * 同时确保数据目录存在。
+ */
+export declare function loadInstance(name: string, handle: ProjectConfigHandle, cli?: CliOverrides): BrowserInstanceConfig;
+/**
+ * 生成 --temp 临时实例:在系统 temp 下建随机目录,用默认端口。
+ * 不读项目配置,不留登录态,退出时由调用方清理。
+ */
+export declare function tempInstance(name?: string, cli?: CliOverrides): {
+    cfg: BrowserInstanceConfig;
+    cleanup: () => void;
+};
+/**
+ * init 生成默认实例配置对象(供 cli init 命令写入文件)。
+ * 默认实例名 default,数据落到 <projectRoot>/.browser/default/{profile,state,logs,extension}。
+ */
+export declare function defaultInstanceEntry(name?: string): {
+    rpcPort: number;
+    healthPort: number;
+    extensionPort: number;
+    profileDir: string;
+    stateDir: string;
+    logsDir: string;
+    extensionDir: string;
+};
+//# sourceMappingURL=instance.d.ts.map

package/dist/instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.d.ts","sourceRoot":"","sources":["../src/instance.ts"],"names":[],"mappings":"AAaA,OAAO,EACL,qBAAqB,EACrB,YAAY,EAKZ,iBAAiB,EAIlB,MAAM,aAAa,CAAC;AAErB,+BAA+B;AAC/B,qBAAa,mBAAoB,SAAQ,KAAK;IACzB,YAAY,EAAE,MAAM;gBAApB,YAAY,EAAE,MAAM;CAWxC;AAED,iBAAiB;AACjB,qBAAa,qBAAsB,SAAQ,KAAK;IAC3B,IAAI,EAAE,MAAM;IAAS,SAAS,EAAE,MAAM,EAAE;gBAAxC,IAAI,EAAE,MAAM,EAAS,SAAS,EAAE,MAAM,EAAE;CAM5D;AAED,gBAAgB;AAChB,MAAM,WAAW,mBAAmB;IAClC,gBAAgB;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB;IAChB,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB,CAkBvE;AAED,kBAAkB;AAClB,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,EAAE,CAEvE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,mBAAmB,EAC3B,GAAG,GAAE,YAAiB,GACrB,qBAAqB,CASvB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,SAAS,EAAE,GAAG,GAAE,YAAiB,GAAG;IACnE,GAAG,EAAE,qBAAqB,CAAC;IAC3B,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CA6BA;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,SAAY;;;;;;;;EAUpD"}

package/dist/instance.js

@@ -0,0 +1,128 @@
+// -*- coding: utf-8 -*-
+// instance.ts — 项目配置查找 + 实例加载。
+//
+// mooncat-browser 是独立包,运行必须基于项目配置:
+//   - 向上递归查找 mooncat-browser.config.json / config/browser.json
+//   - 找不到 → fail fast,提示 npx mooncat-browser init
+//   - 不写全局 appData,不在随机 cwd 偷建目录
+//
+// 唯一例外:start --temp 用系统 temp 下的随机目录,退出清理,仅供快速试用。
+import { existsSync, mkdtempSync, rmSync } from "node:fs";
+import { join, resolve, dirname } from "node:path";
+import { tmpdir } from "node:os";
+import { CONFIG_FILE_NAMES, DEFAULT_EXTENSION_PORT, DEFAULT_HEALTH_PORT, DEFAULT_RPC_PORT, ensureInstanceDirs, loadProjectConfig, resolveInstance, } from "./config.js";
+/** 未初始化错误(命令层捕获后输出友好提示并退出)。 */
+export class NotInitializedError extends Error {
+    searchedFrom;
+    constructor(searchedFrom) {
+        super(`mooncat-browser is not initialized in this project.\n\n` +
+            `Expected one of:\n` +
+            `  ./${CONFIG_FILE_NAMES[0]}\n` +
+            `  ./${CONFIG_FILE_NAMES[1]}\n\n` +
+            `Run:\n` +
+            `  npx mooncat-browser init`);
+        this.searchedFrom = searchedFrom;
+        this.name = "NotInitializedError";
+    }
+}
+/** 找不到某实例名错误。 */
+export class InstanceNotFoundError extends Error {
+    name;
+    available;
+    constructor(name, available) {
+        super(`instance "${name}" not found in config. available: ${available.join(", ") || "(none)"}`);
+        this.name = name;
+        this.available = available;
+        this.name = "InstanceNotFoundError";
+    }
+}
+/**
+ * 从 startDir 向上递归查找项目配置。
+ * 候选名:mooncat-browser.config.json,然后 config/browser.json(同一目录两级)。
+ * 找不到抛 NotInitializedError。
+ */
+export function findProjectConfig(startDir) {
+    let dir = resolve(startDir);
+    // 向上递归到文件系统根
+    for (;;) {
+        for (const name of CONFIG_FILE_NAMES) {
+            const p = join(dir, name);
+            if (existsSync(p)) {
+                const config = loadProjectConfig(p);
+                if (config) {
+                    return { configPath: p, projectRoot: dir, config };
+                }
+            }
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            break; // 到根了
+        dir = parent;
+    }
+    throw new NotInitializedError(startDir);
+}
+/** 列出配置里所有实例名。 */
+export function listInstanceNames(handle) {
+    return Object.keys(handle.config.instances);
+}
+/**
+ * 加载指定实例:从配置读 raw + 合 CLI 覆盖 + 解析成 BrowserInstanceConfig。
+ * 实例不存在抛 InstanceNotFoundError。
+ * 同时确保数据目录存在。
+ */
+export function loadInstance(name, handle, cli = {}) {
+    const names = listInstanceNames(handle);
+    if (!(name in handle.config.instances)) {
+        throw new InstanceNotFoundError(name, names);
+    }
+    const raw = handle.config.instances[name];
+    const cfg = resolveInstance(name, raw, cli, handle.projectRoot);
+    ensureInstanceDirs(cfg);
+    return cfg;
+}
+/**
+ * 生成 --temp 临时实例:在系统 temp 下建随机目录,用默认端口。
+ * 不读项目配置,不留登录态,退出时由调用方清理。
+ */
+export function tempInstance(name = "temp", cli = {}) {
+    const root = mkdtempSync(join(tmpdir(), `mooncat-browser-`));
+    const cfg = resolveInstance(name, {
+        rpcPort: DEFAULT_RPC_PORT,
+        healthPort: DEFAULT_HEALTH_PORT,
+        extensionPort: DEFAULT_EXTENSION_PORT,
+        profileDir: join(root, "profile"),
+        stateDir: join(root, "state"),
+        logsDir: join(root, "logs"),
+        // temp 不走 extension 路(临时试用,无扩展)。extensionDir 给一个占位路径,
+        // 用户不显式 prepare-extension 就不会用到。
+        extensionDir: join(root, "extension"),
+    }, cli, root);
+    ensureInstanceDirs(cfg);
+    return {
+        cfg,
+        cleanup: () => {
+            try {
+                rmSync(root, { recursive: true, force: true });
+            }
+            catch {
+                /* 临时目录清理失败不阻塞 */
+            }
+        },
+    };
+}
+/**
+ * init 生成默认实例配置对象(供 cli init 命令写入文件)。
+ * 默认实例名 default,数据落到 <projectRoot>/.browser/default/{profile,state,logs,extension}。
+ */
+export function defaultInstanceEntry(name = "default") {
+    return {
+        rpcPort: DEFAULT_RPC_PORT,
+        healthPort: DEFAULT_HEALTH_PORT,
+        extensionPort: DEFAULT_EXTENSION_PORT,
+        profileDir: `.browser/${name}/profile`,
+        stateDir: `.browser/${name}/state`,
+        logsDir: `.browser/${name}/logs`,
+        extensionDir: `.browser/${name}/extension`,
+    };
+}
+//# sourceMappingURL=instance.js.map

package/dist/instance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.js","sourceRoot":"","sources":["../src/instance.ts"],"names":[],"mappings":"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"}

package/dist/prepare-extension.d.ts

@@ -0,0 +1,37 @@
+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

package/dist/prepare-extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare-extension.d.ts","sourceRoot":"","sources":["../src/prepare-extension.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAIzD,qDAAqD;AACrD,eAAO,MAAM,uBAAuB,oCAAoC,CAAC;AAEzE,qFAAqF;AACrF,wBAAgB,oBAAoB,IAAI,MAAM,CAK7C;AAED,6BAA6B;AAC7B,eAAO,MAAM,iBAAiB,2BAA2B,CAAC;AAE1D,mBAAmB;AACnB,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAoCD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,qBAAqB,GAAG;IAC5D,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,yBAAyB,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC;CACrB,CA8CA;AAED,8CAA8C;AAC9C,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,qBAAqB,GAAG,yBAAyB,GAAG,IAAI,CAQjG;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,qBAAqB,GAAG,MAAM,GAAG,IAAI,CAwBjF"}