@brookesia/simulator 0.1.0

package/dist/env.d.ts

@@ -0,0 +1,10 @@
+import { type BrookesiaConfig, type BrookesiaState } from '@brookesia/shared-utils';
+export declare function writeEnvSh(state: BrookesiaState): void;
+export interface DetectSimulatorPathsInput {
+    projectRoot: string;
+    config: BrookesiaConfig;
+    simulatorBinary?: string;
+    guiProjectDir?: string;
+}
+export declare function detectAndSaveSimulatorPaths(input: DetectSimulatorPathsInput): BrookesiaState;
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,eAAe,EACpB,KAAK,cAAc,EACpB,MAAM,yBAAyB,CAAC;AAGjC,wBAAgB,UAAU,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CA2BtD;AAED,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,eAAe,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,yBAAyB,GAAG,cAAc,CA0B5F"}

package/dist/env.js

@@ -0,0 +1,50 @@
+import { ENV_FILE, STATE_DIR, detectRuntimeEnvPaths, resolveBundledSimulatorBinary, resolveGuiProjectDir, saveState, } from '@brookesia/shared-utils';
+import fs from 'node:fs';
+export function writeEnvSh(state) {
+    fs.mkdirSync(STATE_DIR, { recursive: true });
+    const lines = [
+        '# Generated by brookesia toolchain — source before brookesia simulate',
+    ];
+    const simBinary = state.simulators?.binary ?? state.simulators?.runtime?.binary;
+    if (simBinary) {
+        lines.push(`export BROOKESIA_SIMULATOR="${simBinary}"`);
+    }
+    if (state.boostPrefix) {
+        lines.push(`export CMAKE_PREFIX_PATH="${state.boostPrefix}:\${CMAKE_PREFIX_PATH:-}"`);
+        lines.push(`export LD_LIBRARY_PATH="${state.boostPrefix}/lib:\${LD_LIBRARY_PATH:-}"`);
+    }
+    if (state.quickjsRoot) {
+        lines.push(`export QUICKJS_ROOT="${state.quickjsRoot}"`);
+    }
+    if (state.quickjsBuildDir) {
+        lines.push(`export QUICKJS_BUILD_DIR="${state.quickjsBuildDir}"`);
+    }
+    if (state.wasmtimeCApi) {
+        lines.push(`export WASMTIME_C_API="${state.wasmtimeCApi}"`);
+        lines.push(`export LD_LIBRARY_PATH="${state.wasmtimeCApi}/lib:\${LD_LIBRARY_PATH:-}"`);
+    }
+    fs.writeFileSync(ENV_FILE, `${lines.join('\n')}\n`, 'utf8');
+}
+export function detectAndSaveSimulatorPaths(input) {
+    const binary = input.simulatorBinary ?? resolveBundledSimulatorBinary();
+    if (!binary) {
+        throw new Error('brookesia_simulator not found. Pass --simulator-binary or install esp-brookesia-toolkit with simulator/brookesia_simulator');
+    }
+    const projectDir = input.guiProjectDir?.trim()
+        ?? resolveGuiProjectDir({
+            projectRoot: input.projectRoot,
+            config: input.config,
+        });
+    const env = detectRuntimeEnvPaths();
+    const state = {
+        simulators: {
+            binary,
+            ...(projectDir ? { gui: { projectDir } } : {}),
+        },
+        ...env,
+    };
+    saveState(state);
+    writeEnvSh(state);
+    return state;
+}
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,SAAS,EACT,qBAAqB,EACrB,6BAA6B,EAC7B,oBAAoB,EACpB,SAAS,GAGV,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB,MAAM,UAAU,UAAU,CAAC,KAAqB;IAC9C,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAa;QACtB,uEAAuE;KACxE,CAAC;IAEF,MAAM,SAAS,GAAG,KAAK,CAAC,UAAU,EAAE,MAAM,IAAI,KAAK,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC;IAChF,IAAI,SAAS,EAAE,CAAC;QACd,KAAK,CAAC,IAAI,CAAC,+BAA+B,SAAS,GAAG,CAAC,CAAC;IAC1D,CAAC;IAED,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,6BAA6B,KAAK,CAAC,WAAW,2BAA2B,CAAC,CAAC;QACtF,KAAK,CAAC,IAAI,CAAC,2BAA2B,KAAK,CAAC,WAAW,6BAA6B,CAAC,CAAC;IACxF,CAAC;IACD,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,wBAAwB,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,6BAA6B,KAAK,CAAC,eAAe,GAAG,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,0BAA0B,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC;QAC5D,KAAK,CAAC,IAAI,CAAC,2BAA2B,KAAK,CAAC,YAAY,6BAA6B,CAAC,CAAC;IACzF,CAAC;IAED,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC9D,CAAC;AASD,MAAM,UAAU,2BAA2B,CAAC,KAAgC;IAC1E,MAAM,MAAM,GAAG,KAAK,CAAC,eAAe,IAAI,6BAA6B,EAAE,CAAC;IACxE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,4HAA4H,CAC7H,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GACd,KAAK,CAAC,aAAa,EAAE,IAAI,EAAE;WACxB,oBAAoB,CAAC;YACtB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,MAAM,EAAE,KAAK,CAAC,MAAM;SACrB,CAAC,CAAC;IAEL,MAAM,GAAG,GAAG,qBAAqB,EAAE,CAAC;IACpC,MAAM,KAAK,GAAmB;QAC5B,UAAU,EAAE;YACV,MAAM;YACN,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC/C;QACD,GAAG,GAAG;KACP,CAAC;IACF,SAAS,CAAC,KAAK,CAAC,CAAC;IACjB,UAAU,CAAC,KAAK,CAAC,CAAC;IAClB,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from './env.js';
+export * from './spawn-gui.js';
+export * from './spawn-runtime.js';
+export * from './toolchain-install.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from './env.js';
+export * from './spawn-gui.js';
+export * from './spawn-runtime.js';
+export * from './toolchain-install.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC"}

package/dist/spawn-gui.d.ts

@@ -0,0 +1,14 @@
+import { type ProjectContext } from '@brookesia/shared-utils';
+export interface SpawnGuiOptions {
+    ctx: ProjectContext;
+    /** Load app package JSON UI via BROOKESIA_GUI_ROOT (off by default). */
+    appPreview?: boolean;
+}
+/**
+ * Default GUI simulator: general_test built-in Settings demo (seven documents).
+ * Does not set BROOKESIA_GUI_ROOT — see simulator/gui/general_test/src/main.cpp.
+ */
+export declare function spawnSettingsGuiSimulator(projectRoot: string): Promise<number>;
+/** Optional: preview current app package JSON UI under assets/apps/<id>/res/. */
+export declare function spawnGuiSimulator(opts: SpawnGuiOptions): Promise<number>;
+//# sourceMappingURL=spawn-gui.d.ts.map

package/dist/spawn-gui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-gui.d.ts","sourceRoot":"","sources":["../src/spawn-gui.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,cAAc,EACpB,MAAM,yBAAyB,CAAC;AAKjC,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,cAAc,CAAC;IACpB,wEAAwE;IACxE,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAkBD;;;GAGG;AACH,wBAAsB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAcpF;AAED,iFAAiF;AACjF,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CA2C9E"}

package/dist/spawn-gui.js

@@ -0,0 +1,72 @@
+import { loadBrookesiaConfig, loadManifestFromDir, loadState, logStep, requireGuiSimulatorPaths, } from '@brookesia/shared-utils';
+import { execa } from 'execa';
+import fs from 'fs-extra';
+import path from 'node:path';
+function guiSpawnEnv(state) {
+    const boostPrefix = state.boostPrefix ?? process.env.BROOKESIA_BOOST_PREFIX ?? '/opt/boost-1.87';
+    const ldPaths = [
+        path.join(boostPrefix, 'lib'),
+        process.env.LD_LIBRARY_PATH,
+    ].filter(Boolean).join(':');
+    const env = {
+        ...process.env,
+        LD_LIBRARY_PATH: ldPaths,
+    };
+    delete env.BROOKESIA_GUI_ROOT;
+    delete env.BROOKESIA_GUI_SCREEN;
+    return env;
+}
+/**
+ * Default GUI simulator: general_test built-in Settings demo (seven documents).
+ * Does not set BROOKESIA_GUI_ROOT — see simulator/gui/general_test/src/main.cpp.
+ */
+export async function spawnSettingsGuiSimulator(projectRoot) {
+    const config = await loadBrookesiaConfig(projectRoot);
+    const state = loadState();
+    const { binary, projectDir } = requireGuiSimulatorPaths({ projectRoot, config, state });
+    logStep(`GUI simulator: Settings demo (${projectDir})`);
+    const result = await execa(binary, [], {
+        cwd: projectDir,
+        stdio: 'inherit',
+        env: guiSpawnEnv(state),
+    });
+    return result.exitCode ?? 0;
+}
+/** Optional: preview current app package JSON UI under assets/apps/<id>/res/. */
+export async function spawnGuiSimulator(opts) {
+    if (!opts.appPreview) {
+        return spawnSettingsGuiSimulator(opts.ctx.projectRoot);
+    }
+    const state = loadState();
+    const { binary, projectDir } = requireGuiSimulatorPaths({
+        projectRoot: opts.ctx.projectRoot,
+        config: opts.ctx.config,
+        state,
+    });
+    const assetsSyncDir = opts.ctx.config.simulator?.gui?.assetsSyncDir ?? 'assets/apps';
+    const sourceDir = opts.ctx.config.pack?.skipBuildMirror ? opts.ctx.sourceRoot : opts.ctx.buildDir;
+    const manifest = loadManifestFromDir(sourceDir);
+    const pkgId = manifest.package.id;
+    const resSrc = path.join(sourceDir, manifest.runtime.resource_dir || 'res');
+    const resDest = path.join(projectDir, assetsSyncDir, pkgId, 'res');
+    if (await fs.pathExists(resSrc)) {
+        await fs.emptyDir(resDest);
+        await fs.copy(resSrc, resDest);
+    }
+    const guiRootRel = path.posix.join(assetsSyncDir, pkgId, manifest.gui?.root ?? 'res/root.json');
+    let guiScreen = 'root';
+    if (manifest.gui?.screen_path) {
+        guiScreen = manifest.gui.screen_path.replace(/^\//, '');
+    }
+    logStep(`GUI simulator: app preview ${guiRootRel} (screen=${guiScreen})`);
+    const env = guiSpawnEnv(state);
+    env.BROOKESIA_GUI_ROOT = guiRootRel;
+    env.BROOKESIA_GUI_SCREEN = guiScreen;
+    const result = await execa(binary, [], {
+        cwd: projectDir,
+        stdio: 'inherit',
+        env,
+    });
+    return result.exitCode ?? 0;
+}
+//# sourceMappingURL=spawn-gui.js.map

package/dist/spawn-gui.js.map

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

package/dist/spawn-runtime.d.ts

@@ -0,0 +1,9 @@
+import { type ProjectContext } from '@brookesia/shared-utils';
+export interface SpawnRuntimeOptions {
+    ctx: ProjectContext;
+    bpkPath: string;
+    verify?: boolean;
+}
+export declare function findLatestBpk(distDir: string): Promise<string>;
+export declare function spawnRuntimeSimulator(opts: SpawnRuntimeOptions): Promise<number>;
+//# sourceMappingURL=spawn-runtime.d.ts.map

package/dist/spawn-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-runtime.d.ts","sourceRoot":"","sources":["../src/spawn-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,yBAAyB,CAAC;AAMjC,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,cAAc,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOpE;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqBtF"}

package/dist/spawn-runtime.js

@@ -0,0 +1,32 @@
+import { buildRuntimeSimulatorEnv, loadState, requireRuntimeBinaryPath, } from '@brookesia/shared-utils';
+import { execa } from 'execa';
+import fs from 'fs-extra';
+import os from 'node:os';
+import path from 'node:path';
+export async function findLatestBpk(distDir) {
+    const files = await fs.readdir(distDir);
+    const bpks = files.filter((f) => f.endsWith('.bpk')).sort();
+    if (bpks.length === 0) {
+        throw new Error(`No .bpk in ${distDir}; run brookesia build first`);
+    }
+    return path.join(distDir, bpks[bpks.length - 1]);
+}
+export async function spawnRuntimeSimulator(opts) {
+    const state = loadState();
+    const binary = requireRuntimeBinaryPath({
+        projectRoot: opts.ctx.projectRoot,
+        config: opts.ctx.config,
+        state,
+    });
+    const bpk = path.resolve(opts.bpkPath);
+    const inst = await fs.mkdtemp(path.join(os.tmpdir(), 'brookesia-inst-'));
+    const args = [bpk, inst];
+    if (opts.verify) {
+        const pub = path.join(opts.ctx.signDir, 'public.pem');
+        args.push(pub);
+    }
+    const env = buildRuntimeSimulatorEnv(opts.ctx.config, binary, state);
+    const result = await execa(binary, args, { stdio: 'inherit', env });
+    return result.exitCode ?? 0;
+}
+//# sourceMappingURL=spawn-runtime.js.map

package/dist/spawn-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-runtime.js","sourceRoot":"","sources":["../src/spawn-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,SAAS,EACT,wBAAwB,GAEzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAC9B,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAQ7B,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAe;IACjD,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,cAAc,OAAO,6BAA6B,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,IAAyB;IACnE,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;IAC1B,MAAM,MAAM,GAAG,wBAAwB,CAAC;QACtC,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW;QACjC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM;QACvB,KAAK;KACN,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC;IACzE,MAAM,IAAI,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAEzB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QACtD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjB,CAAC;IAED,MAAM,GAAG,GAAG,wBAAwB,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAErE,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;IACpE,OAAO,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC;AAC9B,CAAC"}

package/dist/toolchain-install.d.ts

@@ -0,0 +1,14 @@
+import { type BrookesiaConfig } from '@brookesia/shared-utils';
+import type { DoctorEffectiveProfile } from '@brookesia/doctor';
+/** Record brookesia_simulator path (no esp-brookesia SDK tree required). */
+export declare function runSimulatorBinaryInstall(simulatorBinary: string): Promise<void>;
+/** @deprecated Use {@link runSimulatorBinaryInstall}. */
+export declare function runRuntimeSimulatorInstall(runtimeBinary: string): Promise<void>;
+/**
+ * Record simulator paths and env.sh (bundled or configured brookesia_simulator + optional GUI projectDir).
+ */
+export declare function runToolchainInstall(projectRoot: string, config: BrookesiaConfig, profile: DoctorEffectiveProfile, opts?: {
+    simulatorBinary?: string;
+    guiProjectDir?: string;
+}): Promise<void>;
+//# sourceMappingURL=toolchain-install.d.ts.map

package/dist/toolchain-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolchain-install.d.ts","sourceRoot":"","sources":["../src/toolchain-install.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,eAAe,EACrB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAahE,4EAA4E;AAC5E,wBAAsB,yBAAyB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBtF;AAED,yDAAyD;AACzD,wBAAsB,0BAA0B,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAErF;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,sBAAsB,EAC/B,IAAI,CAAC,EAAE;IAAE,eAAe,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1D,OAAO,CAAC,IAAI,CAAC,CAuBf"}

package/dist/toolchain-install.js

@@ -0,0 +1,56 @@
+import { loadState, logStep, logSuccess, logWarn, mergeState, } from '@brookesia/shared-utils';
+import fs from 'node:fs';
+import path from 'node:path';
+import { detectAndSaveSimulatorPaths } from './env.js';
+function assertExecutable(filePath) {
+    try {
+        fs.accessSync(filePath, fs.constants.X_OK);
+    }
+    catch {
+        throw new Error(`Not executable: ${filePath}`);
+    }
+}
+/** Record brookesia_simulator path (no esp-brookesia SDK tree required). */
+export async function runSimulatorBinaryInstall(simulatorBinary) {
+    const resolved = path.resolve(simulatorBinary);
+    if (!fs.existsSync(resolved)) {
+        throw new Error(`brookesia_simulator not found: ${resolved}`);
+    }
+    assertExecutable(resolved);
+    logStep(`toolchain install: recording brookesia_simulator ${resolved}`);
+    const prev = loadState();
+    mergeState({
+        simulators: {
+            ...prev.simulators,
+            binary: resolved,
+        },
+    });
+    logSuccess('Wrote ~/.brookesia/state.json (simulators.binary)');
+    logSuccess('Simulate: brookesia build && brookesia simulate --target runtime|gui');
+}
+/** @deprecated Use {@link runSimulatorBinaryInstall}. */
+export async function runRuntimeSimulatorInstall(runtimeBinary) {
+    return runSimulatorBinaryInstall(runtimeBinary);
+}
+/**
+ * Record simulator paths and env.sh (bundled or configured brookesia_simulator + optional GUI projectDir).
+ */
+export async function runToolchainInstall(projectRoot, config, profile, opts) {
+    logStep(`toolchain install (profile=${profile}): brookesia_simulator`);
+    const state = detectAndSaveSimulatorPaths({
+        projectRoot,
+        config,
+        simulatorBinary: opts?.simulatorBinary,
+        guiProjectDir: opts?.guiProjectDir,
+    });
+    logSuccess('Wrote ~/.brookesia/state.json and env.sh');
+    if (profile === 'gui' && !state.simulators?.gui?.projectDir) {
+        logWarn('GUI simulate needs simulator.gui.projectDir in brookesia.config.js '
+            + '(or pass --gui-project-dir to toolchain install).');
+    }
+    if (profile !== 'pack-only' && !opts?.simulatorBinary) {
+        logWarn('To refresh the PC simulator binary, rebuild in esp-brookesia/simulator and run '
+            + 'npm run stage:simulator -- <path/to/brookesia_simulator> in the toolkit monorepo.');
+    }
+}
+//# sourceMappingURL=toolchain-install.js.map

package/dist/toolchain-install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolchain-install.js","sourceRoot":"","sources":["../src/toolchain-install.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,OAAO,EACP,UAAU,EACV,OAAO,EACP,UAAU,GAEX,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAC;AAEvD,SAAS,gBAAgB,CAAC,QAAgB;IACxC,IAAI,CAAC;QACH,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;IACjD,CAAC;AACH,CAAC;AAED,4EAA4E;AAC5E,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,eAAuB;IACrE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IAC/C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,kCAAkC,QAAQ,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC3B,OAAO,CAAC,oDAAoD,QAAQ,EAAE,CAAC,CAAC;IACxE,MAAM,IAAI,GAAG,SAAS,EAAE,CAAC;IACzB,UAAU,CAAC;QACT,UAAU,EAAE;YACV,GAAG,IAAI,CAAC,UAAU;YAClB,MAAM,EAAE,QAAQ;SACjB;KACF,CAAC,CAAC;IACH,UAAU,CAAC,mDAAmD,CAAC,CAAC;IAChE,UAAU,CAAC,sEAAsE,CAAC,CAAC;AACrF,CAAC;AAED,yDAAyD;AACzD,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,aAAqB;IACpE,OAAO,yBAAyB,CAAC,aAAa,CAAC,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,WAAmB,EACnB,MAAuB,EACvB,OAA+B,EAC/B,IAA2D;IAE3D,OAAO,CAAC,8BAA8B,OAAO,wBAAwB,CAAC,CAAC;IACvE,MAAM,KAAK,GAAG,2BAA2B,CAAC;QACxC,WAAW;QACX,MAAM;QACN,eAAe,EAAE,IAAI,EAAE,eAAe;QACtC,aAAa,EAAE,IAAI,EAAE,aAAa;KACnC,CAAC,CAAC;IACH,UAAU,CAAC,0CAA0C,CAAC,CAAC;IAEvD,IAAI,OAAO,KAAK,KAAK,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC;QAC5D,OAAO,CACL,qEAAqE;cACnE,mDAAmD,CACtD,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,KAAK,WAAW,IAAI,CAAC,IAAI,EAAE,eAAe,EAAE,CAAC;QACtD,OAAO,CACL,iFAAiF;cAC/E,mFAAmF,CACtF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@brookesia/simulator",
+  "version": "0.1.0",
+  "description": "Spawn ESP-Brookesia PC runtime and GUI simulators",
+  "type": "module",
+  "license": "Apache-2.0",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/espressif/esp-brookesia-toolkit.git",
+    "directory": "packages/simulator"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@brookesia/doctor": "0.1.0",
+    "@brookesia/shared-utils": "0.1.0",
+    "execa": "^9.5.2",
+    "fs-extra": "^11.3.0"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "typescript": "^5.7.3"
+  }
+}