cyclops-clientdevbridge-cli 0.1.1

package/dist/detect.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Exit codes are part of the CLI's contract with the agent driving it:
+ * 0 success, 1 a protocol-level failure, 2 a session or connection failure.
+ */
+export declare const EXIT_OK = 0;
+export declare const EXIT_PROTOCOL = 1;
+export declare const EXIT_SESSION = 2;
+/** A failure that should be reported with a specific exit code, without a stack trace. */
+export declare class CliError extends Error {
+    readonly exitCode: number;
+    readonly hint: string | undefined;
+    constructor(message: string, exitCode?: number, hint?: string);
+}
+/** The mod answered with a JSON-RPC error object. */
+export declare class ProtocolError extends CliError {
+    readonly code: number;
+    readonly data: unknown;
+    constructor(code: number, message: string, data?: unknown);
+}
+/** Nothing is listening, or the session is stale. Always carries the same actionable hint. */
+export declare class SessionError extends CliError {
+    constructor(message: string, hint?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,OAAO,IAAI,CAAC;AACzB,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,eAAO,MAAM,YAAY,IAAI,CAAC;AAE9B,0FAA0F;AAC1F,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;gBAEtB,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAqB,EAAE,IAAI,CAAC,EAAE,MAAM;CAMnF;AAED,qDAAqD;AACrD,qBAAa,aAAc,SAAQ,QAAQ;IACzC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,IAAI,EAAE,OAAO,CAAC;gBAEX,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;CAMjE;AAED,8FAA8F;AAC9F,qBAAa,YAAa,SAAQ,QAAQ;gBACrB,OAAO,EAAE,MAAM,EAAE,IAAI,SAAuG;CAIhJ"}

package/dist/errors.js

@@ -0,0 +1,37 @@
+/**
+ * Exit codes are part of the CLI's contract with the agent driving it:
+ * 0 success, 1 a protocol-level failure, 2 a session or connection failure.
+ */
+export const EXIT_OK = 0;
+export const EXIT_PROTOCOL = 1;
+export const EXIT_SESSION = 2;
+/** A failure that should be reported with a specific exit code, without a stack trace. */
+export class CliError extends Error {
+    exitCode;
+    hint;
+    constructor(message, exitCode = EXIT_SESSION, hint) {
+        super(message);
+        this.name = 'CliError';
+        this.exitCode = exitCode;
+        this.hint = hint;
+    }
+}
+/** The mod answered with a JSON-RPC error object. */
+export class ProtocolError extends CliError {
+    code;
+    data;
+    constructor(code, message, data) {
+        super(message, EXIT_PROTOCOL);
+        this.name = 'ProtocolError';
+        this.code = code;
+        this.data = data;
+    }
+}
+/** Nothing is listening, or the session is stale. Always carries the same actionable hint. */
+export class SessionError extends CliError {
+    constructor(message, hint = "Run 'clientdevbridge status' to see the session state, or 'clientdevbridge logs' for the game log.") {
+        super(message, EXIT_SESSION, hint);
+        this.name = 'SessionError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAC;AACzB,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC;AAC/B,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC;AAE9B,0FAA0F;AAC1F,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjB,QAAQ,CAAS;IACjB,IAAI,CAAqB;IAEzC,YAAmB,OAAe,EAAE,WAAmB,YAAY,EAAE,IAAa;QAChF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,qDAAqD;AACrD,MAAM,OAAO,aAAc,SAAQ,QAAQ;IACzB,IAAI,CAAS;IACb,IAAI,CAAU;IAE9B,YAAmB,IAAY,EAAE,OAAe,EAAE,IAAc;QAC9D,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,8FAA8F;AAC9F,MAAM,OAAO,YAAa,SAAQ,QAAQ;IACxC,YAAmB,OAAe,EAAE,IAAI,GAAG,oGAAoG;QAC7I,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF"}

package/dist/hotswap.d.ts

@@ -0,0 +1,58 @@
+export interface ClassFile {
+    readonly binaryName: string;
+    readonly file: string;
+    readonly hash: string;
+}
+/**
+ * Finds every compiled class under a project's build output, keyed by its binary name.
+ *
+ * Both loaders compile the shared sources into each loader module, so the same binary name can
+ * appear more than once; the first one found wins, which matches what the running JVM loaded.
+ */
+export declare function scanClasses(projectDir: string): Map<string, ClassFile>;
+export interface SnapshotFile {
+    version: 1;
+    takenAt: string;
+    classes: Record<string, string>;
+}
+export declare function readPreviousSnapshot(stateDir: string): SnapshotFile | null;
+export declare function writeSnapshot(stateDir: string, classes: Map<string, ClassFile>): void;
+/**
+ * Which classes changed since the last hotswap or start.
+ *
+ * With no previous snapshot nothing is reported as changed: swapping every class in the project
+ * on the first run would be slow and would mostly fail, and the useful baseline is "since I last
+ * looked", not "since the JVM started".
+ */
+export declare function diffClasses(previous: SnapshotFile | null, current: Map<string, ClassFile>): {
+    changed: ClassFile[];
+    added: string[];
+};
+export interface SwapResult {
+    readonly swapped: string[];
+    /** Classes the JVM refused to redefine, which is what actually forces a restart. */
+    readonly failed: {
+        name: string;
+        reason: string;
+    }[];
+    /**
+     * Classes not loaded in the client yet. These are not failures: the new definition is simply
+     * picked up the first time the class is used, so reporting them as needing a restart would send
+     * the caller off to do something pointless.
+     */
+    readonly pending: string[];
+    readonly needsRestart: boolean;
+}
+/**
+ * Redefines classes in the running client over JDWP.
+ *
+ * The JDI classes live in the `jdk.jdi` module, which is not on a plain `java` command's module
+ * path, so rather than shipping a Java helper jar the swap is driven by a small Java source file
+ * compiled and run on demand with `java --add-modules jdk.jdi`. That keeps the npm package free of
+ * a compiled Java artifact, which would otherwise have to be rebuilt and re-signed on every release.
+ */
+export declare function redefineClasses(jdwpPort: number, classes: readonly ClassFile[]): SwapResult;
+/** True when the running JVM is a JetBrains Runtime, which can redefine far more than stock HotSpot. */
+export declare function detectJetBrainsRuntime(): boolean;
+export declare function gradleCompile(projectDir: string, gradleWrapper: string, javaVersion?: number): string;
+//# sourceMappingURL=hotswap.d.ts.map

package/dist/hotswap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hotswap.d.ts","sourceRoot":"","sources":["../src/hotswap.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CA+BtE;AAiBD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAU1E;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAI,CAQrF;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,YAAY,GAAG,IAAI,EAC7B,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,GAC9B;IAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAe3C;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAC3B,oFAAoF;IACpF,QAAQ,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACpD;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAChC;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,SAAS,EAAE,GAAG,UAAU,CAsD3F;AAaD,wGAAwG;AACxG,wBAAgB,sBAAsB,IAAI,OAAO,CAQhD;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,SAAK,GAAG,MAAM,CAkBjG"}

package/dist/hotswap.js

@@ -0,0 +1,284 @@
+import { execFileSync, spawnSync } from 'node:child_process';
+import * as crypto from 'node:crypto';
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { CliError } from './errors.js';
+import { resolveJavaHome } from './java.js';
+/**
+ * Finds every compiled class under a project's build output, keyed by its binary name.
+ *
+ * Both loaders compile the shared sources into each loader module, so the same binary name can
+ * appear more than once; the first one found wins, which matches what the running JVM loaded.
+ */
+export function scanClasses(projectDir) {
+    const classes = new Map();
+    const roots = [];
+    for (const entry of fs.readdirSync(projectDir, { withFileTypes: true })) {
+        if (!entry.isDirectory()) {
+            continue;
+        }
+        const candidate = path.join(projectDir, entry.name, 'build', 'classes', 'java', 'main');
+        if (fs.existsSync(candidate)) {
+            roots.push(candidate);
+        }
+    }
+    const single = path.join(projectDir, 'build', 'classes', 'java', 'main');
+    if (fs.existsSync(single)) {
+        roots.push(single);
+    }
+    for (const root of roots) {
+        for (const file of walkClassFiles(root)) {
+            const binaryName = path
+                .relative(root, file)
+                .replace(/\.class$/, '')
+                .split(path.sep)
+                .join('.');
+            if (!classes.has(binaryName)) {
+                classes.set(binaryName, { binaryName, file, hash: hashFile(file) });
+            }
+        }
+    }
+    return classes;
+}
+function* walkClassFiles(directory) {
+    for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
+        const full = path.join(directory, entry.name);
+        if (entry.isDirectory()) {
+            yield* walkClassFiles(full);
+        }
+        else if (entry.name.endsWith('.class')) {
+            yield full;
+        }
+    }
+}
+function hashFile(file) {
+    return crypto.createHash('sha256').update(fs.readFileSync(file)).digest('hex');
+}
+export function readPreviousSnapshot(stateDir) {
+    const file = path.join(stateDir, 'classes.json');
+    if (!fs.existsSync(file)) {
+        return null;
+    }
+    try {
+        return JSON.parse(fs.readFileSync(file, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+export function writeSnapshot(stateDir, classes) {
+    fs.mkdirSync(stateDir, { recursive: true });
+    const record = {};
+    for (const [name, entry] of classes) {
+        record[name] = entry.hash;
+    }
+    const snapshot = { version: 1, takenAt: new Date().toISOString(), classes: record };
+    fs.writeFileSync(path.join(stateDir, 'classes.json'), `${JSON.stringify(snapshot, null, 2)}\n`, 'utf8');
+}
+/**
+ * Which classes changed since the last hotswap or start.
+ *
+ * With no previous snapshot nothing is reported as changed: swapping every class in the project
+ * on the first run would be slow and would mostly fail, and the useful baseline is "since I last
+ * looked", not "since the JVM started".
+ */
+export function diffClasses(previous, current) {
+    if (previous === null) {
+        return { changed: [], added: [] };
+    }
+    const changed = [];
+    const added = [];
+    for (const [name, entry] of current) {
+        const before = previous.classes[name];
+        if (before === undefined) {
+            added.push(name);
+        }
+        else if (before !== entry.hash) {
+            changed.push(entry);
+        }
+    }
+    return { changed, added };
+}
+/**
+ * Redefines classes in the running client over JDWP.
+ *
+ * The JDI classes live in the `jdk.jdi` module, which is not on a plain `java` command's module
+ * path, so rather than shipping a Java helper jar the swap is driven by a small Java source file
+ * compiled and run on demand with `java --add-modules jdk.jdi`. That keeps the npm package free of
+ * a compiled Java artifact, which would otherwise have to be rebuilt and re-signed on every release.
+ */
+export function redefineClasses(jdwpPort, classes) {
+    if (classes.length === 0) {
+        return { swapped: [], failed: [], pending: [], needsRestart: false };
+    }
+    const workDir = fs.mkdtempSync(path.join(os.tmpdir(), 'clientdevbridge-hotswap-'));
+    try {
+        const helper = path.join(workDir, 'HotSwap.java');
+        fs.writeFileSync(helper, HOT_SWAP_SOURCE, 'utf8');
+        const payload = path.join(workDir, 'classes.txt');
+        fs.writeFileSync(payload, classes.map((entry) => `${entry.binaryName}\t${entry.file}`).join('\n'), 'utf8');
+        const result = spawnSync(javaExecutable(), ['--add-modules', 'jdk.jdi', helper, String(jdwpPort), payload], { encoding: 'utf8', timeout: 120_000 });
+        if (result.error !== undefined) {
+            throw new CliError(`Could not run the hotswap helper: ${result.error.message}`, 2);
+        }
+        const stdout = result.stdout ?? '';
+        const swapped = [];
+        const failed = [];
+        const pending = [];
+        for (const rawLine of stdout.split('\n')) {
+            const okMatch = /^OK\t(.+)$/.exec(rawLine);
+            if (okMatch !== null) {
+                swapped.push(okMatch[1]);
+                continue;
+            }
+            const pendingMatch = /^PENDING\t(.+)$/.exec(rawLine);
+            if (pendingMatch !== null) {
+                pending.push(pendingMatch[1]);
+                continue;
+            }
+            const failMatch = /^FAIL\t([^\t]+)\t(.*)$/.exec(rawLine);
+            if (failMatch !== null) {
+                failed.push({ name: failMatch[1], reason: failMatch[2] });
+            }
+        }
+        if (swapped.length === 0 && failed.length === 0 && pending.length === 0) {
+            throw new CliError(`The hotswap helper produced no result.\n${result.stderr ?? ''}`, 2, `Check that the client was started with --jdwp-port ${jdwpPort}.`);
+        }
+        return { swapped, failed, pending, needsRestart: failed.length > 0 };
+    }
+    finally {
+        fs.rmSync(workDir, { recursive: true, force: true });
+    }
+}
+function javaExecutable() {
+    const javaHome = process.env['JAVA_HOME'];
+    if (javaHome !== undefined && javaHome.length > 0) {
+        const candidate = path.join(javaHome, 'bin', process.platform === 'win32' ? 'java.exe' : 'java');
+        if (fs.existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    return 'java';
+}
+/** True when the running JVM is a JetBrains Runtime, which can redefine far more than stock HotSpot. */
+export function detectJetBrainsRuntime() {
+    try {
+        const output = spawnSync(javaExecutable(), ['-version'], { encoding: 'utf8' }).stderr ?? '';
+        return /jetbrains/i.test(output) || /JBR/.test(output);
+    }
+    catch {
+        return false;
+    }
+}
+export function gradleCompile(projectDir, gradleWrapper, javaVersion = 21) {
+    // Same reason as in the launcher: Gradle runs on JAVA_HOME, and the loader plugins refuse to
+    // configure at all when that JDK is older than the Minecraft version needs.
+    const java = resolveJavaHome(javaVersion);
+    try {
+        return execFileSync(gradleWrapper, ['compileJava', '--console=plain', '--no-daemon'], {
+            cwd: projectDir,
+            encoding: 'utf8',
+            timeout: 600_000,
+            env: { ...process.env, ...(java.javaHome === null ? {} : { JAVA_HOME: java.javaHome }) },
+        });
+    }
+    catch (error) {
+        const failure = error;
+        throw new CliError(`Compilation failed, so nothing was swapped.\n${failure.stdout ?? ''}${failure.stderr ?? ''}`, 1);
+    }
+}
+/**
+ * A single-file Java program run with `java HotSwap.java`, which the launcher compiles in memory.
+ */
+const HOT_SWAP_SOURCE = `import com.sun.jdi.VirtualMachine;
+import com.sun.jdi.ReferenceType;
+import com.sun.jdi.connect.AttachingConnector;
+import com.sun.jdi.connect.Connector;
+import com.sun.jdi.Bootstrap;
+
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * Attaches to the running client and redefines the classes listed in the given file.
+ *
+ * Each class is redefined on its own, so one rejected class (a schema change HotSpot cannot apply)
+ * does not stop the rest from going through.
+ */
+public class HotSwap {
+
+    public static void main(String[] args) throws Exception {
+        int port = Integer.parseInt(args[0]);
+        List<String[]> entries = new ArrayList<>();
+        for (String line : Files.readAllLines(Path.of(args[1]))) {
+            if (!line.isBlank()) {
+                entries.add(line.split("\\\\t", 2));
+            }
+        }
+
+        AttachingConnector connector = null;
+        for (Connector candidate : Bootstrap.virtualMachineManager().attachingConnectors()) {
+            if ("com.sun.jdi.SocketAttach".equals(candidate.name())) {
+                connector = (AttachingConnector) candidate;
+                break;
+            }
+        }
+        if (connector == null) {
+            System.err.println("No SocketAttach connector is available in this JDK.");
+            System.exit(2);
+        }
+
+        Map<String, Connector.Argument> arguments = connector.defaultArguments();
+        arguments.get("hostname").setValue("127.0.0.1");
+        arguments.get("port").setValue(String.valueOf(port));
+
+        VirtualMachine vm;
+        try {
+            vm = connector.attach(arguments);
+        } catch (Exception e) {
+            System.err.println("Could not attach to 127.0.0.1:" + port + ": " + e.getMessage());
+            System.exit(2);
+            return;
+        }
+
+        try {
+            if (!vm.canRedefineClasses()) {
+                System.err.println("This JVM does not support class redefinition.");
+                System.exit(2);
+            }
+            for (String[] entry : entries) {
+                String binaryName = entry[0];
+                Path classFile = Path.of(entry[1]);
+                List<ReferenceType> loaded = vm.classesByName(binaryName);
+                if (loaded.isEmpty()) {
+                    // Not loaded yet: the new definition is picked up on first use, so this is
+                    // not a failure and must not send the caller off to restart.
+                    System.out.println("PENDING\\t" + binaryName);
+                    continue;
+                }
+                byte[] bytes = Files.readAllBytes(classFile);
+                Map<ReferenceType, byte[]> redefinition = new HashMap<>();
+                for (ReferenceType type : loaded) {
+                    redefinition.put(type, bytes);
+                }
+                try {
+                    vm.redefineClasses(redefinition);
+                    System.out.println("OK\\t" + binaryName);
+                } catch (UnsupportedOperationException e) {
+                    System.out.println("FAIL\\t" + binaryName + "\\tschema change: " + e.getMessage());
+                } catch (Exception e) {
+                    System.out.println("FAIL\\t" + binaryName + "\\t" + e.getClass().getSimpleName() + ": " + e.getMessage());
+                }
+            }
+        } finally {
+            vm.dispose();
+        }
+    }
+}
+`;
+//# sourceMappingURL=hotswap.js.map

package/dist/hotswap.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export * from './artifacts.js';
+export * from './detect.js';
+export * from './errors.js';
+export * from './initscript.js';
+export * from './launcher.js';
+export * from './paths.js';
+export * from './protocol/client.js';
+export * from './protocol/types.js';
+export * from './session.js';
+export * from './xvfb.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,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+export * from './artifacts.js';
+export * from './detect.js';
+export * from './errors.js';
+export * from './initscript.js';
+export * from './launcher.js';
+export * from './paths.js';
+export * from './protocol/client.js';
+export * from './protocol/types.js';
+export * from './session.js';
+export * from './xvfb.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,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC"}

package/dist/initscript.d.ts

@@ -0,0 +1,49 @@
+import type { Loader } from './detect.js';
+export interface InitScriptOptions {
+    readonly minecraftVersion: string;
+    readonly loader: Loader;
+    readonly bridgeVersion: string;
+    readonly port: number;
+    readonly evalEnabled: boolean;
+    readonly world: string | null;
+    readonly username: string;
+    readonly width: number;
+    readonly height: number;
+    readonly jdwpPort: number | null;
+    /** The consumer project root, so the mod can resolve committed world templates. */
+    readonly projectDir: string;
+    /**
+     * The Gradle path of the module whose client is being launched, e.g. `:loader-neoforge`, or an
+     * empty string for a single-module project.
+     */
+    readonly targetProjectPath: string;
+    /** Extra `-D` properties, exposed for tests and for `--gradle-args` style overrides. */
+    readonly extraJvmArgs?: readonly string[];
+}
+/**
+ * Generates the init script the CLI injects at launch, so that a consumer repository never has to
+ * be edited to be driveable (plan §4).
+ *
+ * The run task is configured through `JavaExec` rather than through Loom's or NeoGradle's own run
+ * DSL: both plugins' `runClient` tasks are `JavaExec` subclasses, so one code path covers both
+ * loaders and does not break when either plugin reshuffles its extensions.
+ */
+export declare function renderInitScript(options: InitScriptOptions): string;
+/**
+ * The client options that make screenshots reproducible from one run to the next.
+ *
+ * Anything that animates, adapts to the machine, or depends on focus is turned off; without this,
+ * `compare` against a golden image is noise.
+ */
+export declare const DETERMINISM_OPTIONS: Readonly<Record<string, string>>;
+export interface PinResult {
+    readonly created: boolean;
+    readonly changed: readonly string[];
+}
+/**
+ * Writes the determinism options into the run directory's `options.txt`.
+ *
+ * Keys the caller did not ask about are preserved, so a hand-tuned dev options file survives.
+ */
+export declare function pinOptions(runDir: string): PinResult;
+//# sourceMappingURL=initscript.d.ts.map

package/dist/initscript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initscript.d.ts","sourceRoot":"","sources":["../src/initscript.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,mFAAmF;IACnF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,wFAAwF;IACxF,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C;AAMD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAkInE;AAED;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAmBhE,CAAC;AAEF,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAiCpD"}