cyclops-clientdevbridge-cli 0.1.1

package/dist/commands/snapshot.js

@@ -0,0 +1,133 @@
+import { line, printJson, printPath } from '../output.js';
+import { findNodes, formatOutline } from '../snapshot/outline.js';
+import { centre, label, simpleType, snapshotSchema } from '../snapshot/model.js';
+import { CliError } from '../errors.js';
+import { timestampName, withClient, writeBase64 } from './context.js';
+export async function fetchSnapshot(client, options = {}) {
+    const params = {};
+    if (options.includeHidden === true) {
+        params['includeHidden'] = true;
+    }
+    if (options.maxDepth !== undefined) {
+        params['maxDepth'] = options.maxDepth;
+    }
+    const raw = await client.call('screen.snapshot', params);
+    const parsed = snapshotSchema.safeParse(raw);
+    if (!parsed.success) {
+        throw new CliError(`The mod sent a snapshot this CLI cannot read: ${parsed.error.issues.map((issue) => `${issue.path.join('.')}: ${issue.message}`).join('; ')}`, 1, 'This usually means the CLI and the mod are from different releases. Update whichever is older.');
+    }
+    return parsed.data;
+}
+export async function runSnapshot(global, options) {
+    await withClient(global, async ({ client }) => {
+        const snapshot = await fetchSnapshot(client, {
+            includeHidden: options.includeHidden,
+            maxDepth: options.maxDepth === undefined ? undefined : Number(options.maxDepth),
+        });
+        if (global.json) {
+            printJson(snapshot);
+            return;
+        }
+        line(formatOutline(snapshot, { includeHidden: options.includeHidden }));
+    });
+}
+export async function runFind(global, text, options) {
+    await withClient(global, async ({ client }) => {
+        const snapshot = await fetchSnapshot(client);
+        const matches = findNodes(snapshot, text, options.type);
+        if (global.json) {
+            printJson(matches.map((match) => ({ path: match.node.path, type: match.node.type, centre: match.centre })));
+            return;
+        }
+        if (matches.length === 0) {
+            line(`No widget matches '${text}'${options.type === undefined ? '' : ` of type '${options.type}'`}.`);
+            line('Run `clientdevbridge snapshot` to see what is on screen.');
+            process.exitCode = 1;
+            return;
+        }
+        for (const match of matches) {
+            const at = match.centre === null ? 'no bounds' : `click at ${match.centre.x},${match.centre.y}`;
+            line(`${simpleType(match.node)} "${label(match.node)}"  ${at}  ${match.node.path}`);
+        }
+    });
+}
+/**
+ * Turns a `--widget` argument into a point to click.
+ *
+ * Ambiguity is an error rather than a guess: silently clicking the wrong one of two similarly
+ * labelled buttons is far worse than being told to be more specific.
+ */
+export async function resolveWidget(client, query) {
+    const snapshot = await fetchSnapshot(client);
+    const matches = findNodes(snapshot, query);
+    if (matches.length === 0) {
+        throw new CliError(`No widget matches '${query}' on ${snapshot.screenClass ?? 'this screen'}.`, 1, 'Run `clientdevbridge snapshot` to see the widgets, then pass a label or a /root/children[N] path.');
+    }
+    if (matches.length > 1) {
+        const listed = matches
+            .slice(0, 8)
+            .map((match) => `  ${simpleType(match.node)} "${label(match.node)}"  ${match.node.path}`)
+            .join('\n');
+        throw new CliError(`'${query}' matches ${matches.length} widgets:\n${listed}`, 1, 'Pass the exact path instead, e.g. --widget /root/children[3]');
+    }
+    const match = matches[0];
+    const point = centre(match.node);
+    if (point === null) {
+        throw new CliError(`The widget '${query}' (${match.node.path}) reports no bounds, so there is nowhere to click.`, 1, 'Use --at x,y with coordinates read off a screenshot.');
+    }
+    return point;
+}
+export async function runTooltip(global, options) {
+    await withClient(global, async ({ client }) => {
+        let point;
+        if (options.widget !== undefined) {
+            point = await resolveWidget(client, options.widget);
+        }
+        else if (options.at !== undefined) {
+            const { parsePoint } = await import('./input.js');
+            point = parsePoint(options.at, '--at');
+        }
+        else {
+            throw new CliError('tooltip needs either --at x,y or --widget <text-or-path>.', 1);
+        }
+        const result = await client.call('screen.tooltip', point);
+        if (global.json) {
+            printJson(result);
+            return;
+        }
+        if (result.lines.length === 0) {
+            line(`No tooltip at ${point.x},${point.y} (source: ${result.source}).`);
+            return;
+        }
+        for (const entry of result.lines) {
+            line(entry);
+        }
+    });
+}
+/**
+ * The composite an agent reaches for most: open a block's GUI, wait for it, and produce both the
+ * outline and a screenshot path in one round trip.
+ */
+export async function runInspectGui(global, x, y, z, options) {
+    await withClient(global, async ({ client, paths }) => {
+        const opened = await client.call('screen.open', { blockPos: [Number(x), Number(y), Number(z)], approach: options.approach }, 60_000);
+        if (opened['opened'] !== true) {
+            line(`No screen opened for the block at ${x},${y},${z}. ${opened['hint'] ?? ''}`.trim());
+            process.exitCode = 1;
+            return;
+        }
+        // One tick so the freshly opened screen has laid itself out before it is described.
+        await client.call('wait.ticks', { ticks: 2 });
+        const snapshot = await fetchSnapshot(client);
+        const shot = await client.call('screenshot', {});
+        const file = writeBase64(paths.screenshots, options.name ?? timestampName('inspect-gui'), String(shot['png']));
+        if (global.json) {
+            printJson({ snapshot, screenshot: file });
+            return;
+        }
+        line(formatOutline(snapshot));
+        line('');
+        printPath(file);
+    });
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/commands/snapshot.js.map

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

package/dist/commands/world.d.ts

@@ -0,0 +1,27 @@
+import { type GlobalOptions } from './context.js';
+export interface WorldResetOptions {
+    readonly name?: string | undefined;
+    readonly template?: string | undefined;
+    readonly setup?: string | undefined;
+}
+export declare function runWorldReset(global: GlobalOptions, options: WorldResetOptions): Promise<void>;
+export declare function runWorldLoad(global: GlobalOptions, name: string): Promise<void>;
+export declare function runWorldLeave(global: GlobalOptions): Promise<void>;
+export declare function runWorldList(global: GlobalOptions): Promise<void>;
+export declare function runCommand(global: GlobalOptions, command: string): Promise<void>;
+export declare function runBlock(global: GlobalOptions, x: string, y: string, z: string, options: {
+    nbt: boolean;
+}): Promise<void>;
+export declare function runSetblock(global: GlobalOptions, x: string, y: string, z: string, block: string): Promise<void>;
+export declare function runGive(global: GlobalOptions, item: string, count: string): Promise<void>;
+export declare function runTeleport(global: GlobalOptions, x: string, y: string, z: string, options: {
+    yaw?: string | undefined;
+    pitch?: string | undefined;
+}): Promise<void>;
+export declare function runLook(global: GlobalOptions, options: {
+    at?: string | undefined;
+    yaw?: string | undefined;
+    pitch?: string | undefined;
+}): Promise<void>;
+export declare function runInventory(global: GlobalOptions): Promise<void>;
+//# sourceMappingURL=world.d.ts.map

package/dist/commands/world.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"world.d.ts","sourceRoot":"","sources":["../../src/commands/world.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,aAAa,EAAc,MAAM,cAAc,CAAC;AAG9D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED,wBAAsB,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BpG;AAED,wBAAsB,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWrF;AAED,wBAAsB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAWxE;AAED,wBAAsB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAevE;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBtF;AAUD,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,aAAa,EACrB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,OAAO,EAAE;IAAE,GAAG,EAAE,OAAO,CAAA;CAAE,GACxB,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,aAAa,EACrB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAGf;AAED,wBAAsB,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/F;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,aAAa,EACrB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,OAAO,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAChE,OAAO,CAAC,IAAI,CAAC,CA2Bf;AAED,wBAAsB,OAAO,CAC3B,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE;IAAE,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GACzF,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED,wBAAsB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBvE"}

package/dist/commands/world.js

@@ -0,0 +1,203 @@
+import { line, printJson } from '../output.js';
+import { withClient } from './context.js';
+import { CliError, EXIT_PROTOCOL } from '../errors.js';
+export async function runWorldReset(global, options) {
+    await withClient(global, async ({ client }) => {
+        const params = {};
+        if (options.name !== undefined) {
+            params['name'] = options.name;
+        }
+        if (options.template !== undefined) {
+            params['template'] = options.template;
+        }
+        if (options.setup !== undefined) {
+            params['setup'] = options.setup;
+        }
+        // Generating and joining a world under software rendering is slow; give it its own budget.
+        const result = await client.call('world.reset', params, 180_000);
+        if (global.json) {
+            printJson(result);
+            return;
+        }
+        if (!global.quiet) {
+            const spawn = result['spawn'];
+            line(`World '${result['world']}' is ready` +
+                `${result['template'] === null ? ' (fresh creative superflat)' : ` (from template ${result['template']})`}` +
+                `, player at ${spawn.join(', ')}.`);
+        }
+    });
+}
+export async function runWorldLoad(global, name) {
+    await withClient(global, async ({ client }) => {
+        const result = await client.call('world.load', { name }, 180_000);
+        if (global.json) {
+            printJson(result);
+            return;
+        }
+        if (!global.quiet) {
+            line(`Loaded world '${result['world']}'.`);
+        }
+    });
+}
+export async function runWorldLeave(global) {
+    await withClient(global, async ({ client }) => {
+        const result = await client.call('world.leave', {}, 60_000);
+        if (global.json) {
+            printJson(result);
+            return;
+        }
+        if (!global.quiet) {
+            line('Left the world.');
+        }
+    });
+}
+export async function runWorldList(global) {
+    await withClient(global, async ({ client }) => {
+        const result = await client.call('world.list');
+        if (global.json) {
+            printJson(result);
+            return;
+        }
+        if (result.worlds.length === 0) {
+            line('No worlds yet. Create one with: clientdevbridge world-reset');
+            return;
+        }
+        for (const world of result.worlds) {
+            line(world);
+        }
+    });
+}
+export async function runCommand(global, command) {
+    await withClient(global, async ({ client }) => {
+        const result = await client.call('world.command', { command }, 60_000);
+        if (global.json) {
+            printJson(result);
+        }
+        else if (result.output.length === 0) {
+            if (!global.quiet) {
+                line(result.success ? '(the command produced no output)' : '(the command failed with no output)');
+            }
+        }
+        else {
+            for (const entry of result.output) {
+                line(entry);
+            }
+        }
+        // A failing command still prints something, so without this a scripted setup would sail past
+        // a scene that was never built and leave the caller debugging a phantom.
+        if (!result.success) {
+            process.exitCode = EXIT_PROTOCOL;
+        }
+    });
+}
+function parsePosition(x, y, z) {
+    const parsed = { x: Number(x), y: Number(y), z: Number(z) };
+    if (Number.isNaN(parsed.x) || Number.isNaN(parsed.y) || Number.isNaN(parsed.z)) {
+        throw new CliError(`Expected three numbers for a block position, but got '${x} ${y} ${z}'.`, 1);
+    }
+    return parsed;
+}
+export async function runBlock(global, x, y, z, options) {
+    await withClient(global, async ({ client }) => {
+        const position = parsePosition(x, y, z);
+        const result = await client.call('world.block', { ...position, nbt: options.nbt });
+        if (global.json) {
+            printJson(result);
+            return;
+        }
+        line(String(result['state']));
+        const blockEntity = result['blockEntity'];
+        if (blockEntity !== null) {
+            line(`block entity: ${blockEntity['type']}`);
+            if (blockEntity['nbt'] !== undefined) {
+                line(String(blockEntity['nbt']));
+            }
+        }
+    });
+}
+export async function runSetblock(global, x, y, z, block) {
+    const position = parsePosition(x, y, z);
+    await runCommand(global, `setblock ${position.x} ${position.y} ${position.z} ${block}`);
+}
+export async function runGive(global, item, count) {
+    await runCommand(global, `give @s ${item} ${count}`);
+}
+export async function runTeleport(global, x, y, z, options) {
+    await withClient(global, async ({ client }) => {
+        const position = parsePosition(x, y, z);
+        const params = { ...position };
+        if (options.yaw !== undefined) {
+            params['yaw'] = Number(options.yaw);
+        }
+        if (options.pitch !== undefined) {
+            params['pitch'] = Number(options.pitch);
+        }
+        const result = await client.call('player.teleport', params);
+        if (global.json) {
+            printJson(result);
+            return;
+        }
+        if (!global.quiet) {
+            const pos = result['pos'];
+            const requested = result['requested'];
+            const at = pos.map((value) => value.toFixed(2)).join(', ');
+            line(`Player at ${at}, facing ${result['yaw']}/${result['pitch']}.`);
+            // Gravity acts between the teleport and the reply, so the reported y can be lower than the
+            // one asked for. Saying so is the difference between a confusing number and an expected one.
+            if (requested !== undefined && requested.some((value, index) => Math.abs(value - (pos[index] ?? 0)) > 0.01)) {
+                line(`(asked for ${requested.map((value) => value.toFixed(2)).join(', ')}; the player has since fallen or been pushed)`);
+            }
+        }
+    });
+}
+export async function runLook(global, options) {
+    await withClient(global, async ({ client }) => {
+        const params = {};
+        if (options.at !== undefined) {
+            const parts = options.at.split(',').map((part) => Number(part.trim()));
+            if (parts.length !== 3 || parts.some((value) => Number.isNaN(value))) {
+                throw new CliError(`--at must be 'x,y,z', but was '${options.at}'.`, 1);
+            }
+            params['at'] = parts;
+        }
+        else {
+            if (options.yaw !== undefined) {
+                params['yaw'] = Number(options.yaw);
+            }
+            if (options.pitch !== undefined) {
+                params['pitch'] = Number(options.pitch);
+            }
+            if (Object.keys(params).length === 0) {
+                throw new CliError('look needs --at x,y,z, or --yaw and/or --pitch.', 1);
+            }
+        }
+        const result = await client.call('player.look', params);
+        if (global.json) {
+            printJson(result);
+            return;
+        }
+        if (!global.quiet) {
+            line(`Facing ${Number(result['yaw']).toFixed(1)}/${Number(result['pitch']).toFixed(1)}.`);
+        }
+    });
+}
+export async function runInventory(global) {
+    await withClient(global, async ({ client }) => {
+        const result = await client.call('player.inventory');
+        if (global.json) {
+            printJson(result);
+            return;
+        }
+        for (const slot of result.slots) {
+            if (slot.item === null) {
+                continue;
+            }
+            const marker = slot.index === result.selected ? '>' : ' ';
+            line(`${marker} [${String(slot.index).padStart(2)}] ${slot.item} x${slot.count}`);
+        }
+        if (!global.quiet) {
+            line(`# selected hotbar slot ${result.selected}`);
+        }
+    });
+}
+//# sourceMappingURL=world.js.map

package/dist/commands/world.js.map

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

package/dist/detect.d.ts

@@ -0,0 +1,58 @@
+export type Loader = 'fabric' | 'neoforge';
+export interface ProjectInfo {
+    readonly projectDir: string;
+    readonly minecraftVersion: string;
+    readonly loader: Loader;
+    /** The Gradle task that launches the client, e.g. `:loader-neoforge:runClient`. */
+    readonly gradleTask: string;
+    /** Where that task's working directory is, used to pin `options.txt`. */
+    readonly runDir: string;
+    readonly gradleWrapper: string;
+    /**
+     * The Java version the project declares. The loader plugins check the JDK Gradle itself runs on,
+     * so this is not a toolchain hint that Gradle can satisfy on its own.
+     */
+    readonly javaVersion: number;
+    /** How each value was arrived at, so `doctor` can explain itself. */
+    readonly detected: {
+        minecraftVersion: string;
+        loader: string;
+        gradleTask: string;
+    };
+}
+export declare function readGradleProperties(projectDir: string): Record<string, string>;
+/**
+ * Detects which loaders a checkout can run, by looking for the Gradle plugin each one applies.
+ * ModDevGradle / NeoGradle mean NeoForge; Loom means Fabric.
+ */
+export declare function detectLoaders(projectDir: string): Loader[];
+/**
+ * Picks the Gradle task that runs the client. Multiloader checkouts (the Cyclops layout) expose it
+ * per loader module; a single-module mod exposes a plain `runClient`.
+ */
+export declare function detectGradleTask(projectDir: string, loader: Loader): {
+    task: string;
+    runDir: string;
+};
+/**
+ * Picks the directory the client will use as its game directory.
+ *
+ * There is no single answer to guess at: the run directory is chosen by the Gradle plugin, and the
+ * conventions disagree. NeoGradle and the multiloader Loom convention use `runs/client`;
+ * ModDevGradle 2, which is what the Minecraft 26 line builds on, uses `run`. Getting this wrong is
+ * not loud — the determinism options are simply pinned into a file the game never reads, and the
+ * first hint is a screenshot that does not match its golden.
+ *
+ * So: believe the evidence on disk when a previous run left some, and fall back to the convention
+ * order otherwise. `start` corrects a wrong guess against the game directory the client reports
+ * once it is up.
+ */
+export declare function detectRunDir(baseDir: string, projectDir?: string, loader?: Loader): string;
+/** Minecraft 1.21 needs Java 21 and Minecraft 26 needs 25; the project states which. */
+export declare function declaredJavaVersion(properties: Record<string, string>): number;
+export interface DetectOverrides {
+    readonly minecraftVersion?: string | undefined;
+    readonly loader?: Loader | undefined;
+}
+export declare function detectProject(projectDir: string, overrides?: DetectOverrides): ProjectInfo;
+//# sourceMappingURL=detect.d.ts.map

package/dist/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../src/detect.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE3C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,mFAAmF;IACnF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,yEAAyE;IACzE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE;QAAE,gBAAgB,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CACrF;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAiB/E;AAwBD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAc1D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAOrG;AAQD;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,SAAU,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAyB3F;AA2BD,wFAAwF;AACxF,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAG9E;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,GAAE,eAAoB,GAAG,WAAW,CA2D9F"}

package/dist/detect.js

@@ -0,0 +1,185 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { CliError } from './errors.js';
+export function readGradleProperties(projectDir) {
+    const file = path.join(projectDir, 'gradle.properties');
+    if (!fs.existsSync(file)) {
+        return {};
+    }
+    const properties = {};
+    for (const rawLine of fs.readFileSync(file, 'utf8').split('\n')) {
+        const line = rawLine.trim();
+        if (line.length === 0 || line.startsWith('#') || line.startsWith('!')) {
+            continue;
+        }
+        const separator = line.indexOf('=');
+        if (separator > 0) {
+            properties[line.slice(0, separator).trim()] = line.slice(separator + 1).trim();
+        }
+    }
+    return properties;
+}
+function readIfExists(file) {
+    return fs.existsSync(file) ? fs.readFileSync(file, 'utf8') : '';
+}
+/** Every Gradle script that could say how this project is configured, as one blob to search. */
+function buildSources(projectDir) {
+    return [
+        readIfExists(path.join(projectDir, 'build.gradle')),
+        readIfExists(path.join(projectDir, 'build.gradle.kts')),
+        readIfExists(path.join(projectDir, 'settings.gradle')),
+        ...['loader-fabric', 'loader-neoforge'].flatMap((module) => [
+            readIfExists(path.join(projectDir, module, 'build.gradle')),
+            readIfExists(path.join(projectDir, module, 'build.gradle.kts')),
+        ]),
+        ...(fs.existsSync(path.join(projectDir, 'buildSrc/src/main/groovy'))
+            ? fs
+                .readdirSync(path.join(projectDir, 'buildSrc/src/main/groovy'))
+                .map((entry) => readIfExists(path.join(projectDir, 'buildSrc/src/main/groovy', entry)))
+            : []),
+    ].join('\n');
+}
+/**
+ * Detects which loaders a checkout can run, by looking for the Gradle plugin each one applies.
+ * ModDevGradle / NeoGradle mean NeoForge; Loom means Fabric.
+ */
+export function detectLoaders(projectDir) {
+    const sources = buildSources(projectDir);
+    const loaders = [];
+    if (/fabric-loom/.test(sources) || fs.existsSync(path.join(projectDir, 'loader-fabric'))) {
+        loaders.push('fabric');
+    }
+    if (/net\.neoforged\.(moddev|gradle)/.test(sources) ||
+        fs.existsSync(path.join(projectDir, 'loader-neoforge'))) {
+        loaders.push('neoforge');
+    }
+    return loaders;
+}
+/**
+ * Picks the Gradle task that runs the client. Multiloader checkouts (the Cyclops layout) expose it
+ * per loader module; a single-module mod exposes a plain `runClient`.
+ */
+export function detectGradleTask(projectDir, loader) {
+    const moduleName = `loader-${loader}`;
+    if (fs.existsSync(path.join(projectDir, moduleName))) {
+        const moduleDir = path.join(projectDir, moduleName);
+        return { task: `:${moduleName}:runClient`, runDir: detectRunDir(moduleDir, projectDir, loader) };
+    }
+    return { task: 'runClient', runDir: detectRunDir(projectDir, projectDir, loader) };
+}
+/**
+ * Files and directories only the game itself creates. `options.txt` is deliberately not among
+ * them: the CLI writes that one, so finding it proves nothing about where the game runs.
+ */
+const RUN_DIR_EVIDENCE = ['logs', 'saves', 'crash-reports', 'usercache.json'];
+/**
+ * Picks the directory the client will use as its game directory.
+ *
+ * There is no single answer to guess at: the run directory is chosen by the Gradle plugin, and the
+ * conventions disagree. NeoGradle and the multiloader Loom convention use `runs/client`;
+ * ModDevGradle 2, which is what the Minecraft 26 line builds on, uses `run`. Getting this wrong is
+ * not loud — the determinism options are simply pinned into a file the game never reads, and the
+ * first hint is a screenshot that does not match its golden.
+ *
+ * So: believe the evidence on disk when a previous run left some, and fall back to the convention
+ * order otherwise. `start` corrects a wrong guess against the game directory the client reports
+ * once it is up.
+ */
+export function detectRunDir(baseDir, projectDir = baseDir, loader) {
+    const candidates = [path.join(baseDir, 'runs', 'client'), path.join(baseDir, 'run')];
+    let best = null;
+    for (const candidate of candidates) {
+        for (const marker of RUN_DIR_EVIDENCE) {
+            let usedAt;
+            try {
+                usedAt = fs.statSync(path.join(candidate, marker)).mtimeMs;
+            }
+            catch {
+                continue;
+            }
+            // A checkout that switched Gradle plugins has both; the one used most recently is the live one.
+            if (best === null || usedAt > best.usedAt) {
+                best = { dir: candidate, usedAt };
+            }
+        }
+    }
+    if (best !== null) {
+        return best.dir;
+    }
+    // Nothing has run yet, so ask the build what it is going to do. Getting this right on a cold
+    // checkout is what keeps the very first launch deterministic -- and keeps `start` from opening
+    // with a correction notice about a directory the caller never mentioned.
+    const declared = declaredRunDir(buildSources(projectDir), loader);
+    return declared === null ? candidates[0] : path.join(baseDir, ...declared.split('/'));
+}
+/**
+ * The run directory the build declares, as a path relative to the module.
+ *
+ * Loom's multiloader convention states it outright. The NeoForge plugins do not, and the two
+ * generations disagree: NeoGradle runs in `runs/<name>`, ModDevGradle 2 -- which the Minecraft 26
+ * line builds on -- in `run`.
+ *
+ * @return the declared directory, or null when the build says nothing useful
+ */
+function declaredRunDir(sources, loader) {
+    if (loader === 'fabric') {
+        const explicit = /\brunDir\s*[( ]\s*['"]([^'"]+)['"]/.exec(sources);
+        return explicit === null ? null : explicit[1];
+    }
+    if (loader === 'neoforge') {
+        if (/net\.neoforged\.moddev/.test(sources)) {
+            return 'run';
+        }
+        if (/net\.neoforged\.gradle/.test(sources)) {
+            return 'runs/client';
+        }
+    }
+    return null;
+}
+/** Minecraft 1.21 needs Java 21 and Minecraft 26 needs 25; the project states which. */
+export function declaredJavaVersion(properties) {
+    const declared = Number(properties['java_version'] ?? '21');
+    return Number.isNaN(declared) ? 21 : declared;
+}
+export function detectProject(projectDir, overrides = {}) {
+    const resolved = path.resolve(projectDir);
+    const wrapper = path.join(resolved, process.platform === 'win32' ? 'gradlew.bat' : 'gradlew');
+    if (!fs.existsSync(wrapper)) {
+        throw new CliError(`${resolved} does not look like a Gradle mod project: no gradlew wrapper found.`, 2, 'Pass --project <dir> pointing at the mod checkout you want to launch.');
+    }
+    const properties = readGradleProperties(resolved);
+    const minecraftVersion = overrides.minecraftVersion ?? properties['minecraft_version'];
+    if (minecraftVersion === undefined || minecraftVersion.length === 0) {
+        throw new CliError(`Could not determine the Minecraft version of ${resolved}: no 'minecraft_version' in gradle.properties.`, 2, 'Pass --mc-version <version> explicitly.');
+    }
+    const available = detectLoaders(resolved);
+    let loader = overrides.loader;
+    if (loader === undefined) {
+        if (available.length === 0) {
+            throw new CliError(`Could not determine the mod loader of ${resolved}: found neither Loom (Fabric) nor ModDevGradle/NeoGradle (NeoForge).`, 2, 'Pass --loader fabric|neoforge explicitly.');
+        }
+        // NeoForge first when both are present: it is the primary loader in the Cyclops layout.
+        loader = available.includes('neoforge') ? 'neoforge' : available[0];
+    }
+    else if (available.length > 0 && !available.includes(loader)) {
+        throw new CliError(`${resolved} does not appear to support the ${loader} loader (detected: ${available.join(', ') || 'none'}).`, 2, 'Drop --loader to use the detected one.');
+    }
+    const { task, runDir } = detectGradleTask(resolved, loader);
+    return {
+        projectDir: resolved,
+        minecraftVersion,
+        loader,
+        gradleTask: task,
+        runDir,
+        javaVersion: declaredJavaVersion(properties),
+        gradleWrapper: wrapper,
+        detected: {
+            minecraftVersion: overrides.minecraftVersion === undefined ? "gradle.properties 'minecraft_version'" : '--mc-version',
+            loader: overrides.loader === undefined ? `applied Gradle plugins (${available.join(', ')})` : '--loader',
+            gradleTask: fs.existsSync(path.join(resolved, `loader-${loader}`))
+                ? 'multiloader layout'
+                : 'single-module layout',
+        },
+    };
+}
+//# sourceMappingURL=detect.js.map