@bkm016/calcite 0.1.0 → 0.3.0

package/dist/mods.js

@@ -0,0 +1,164 @@
+import { createHash } from 'node:crypto';
+import { copyFile, mkdir, readdir, readFile, rm, stat, writeFile } from 'node:fs/promises';
+import { basename, join, resolve } from 'node:path';
+import { download, httpJson } from './net.js';
+import { CalciteError } from './types.js';
+const MODRINTH_API = 'https://api.modrinth.com/v2';
+const MANIFEST = '.calcite-mods.json';
+function safeName(name) {
+    const clean = basename(name.replace(/\\/g, '/'));
+    if (!clean || clean.startsWith('.') || !clean.toLowerCase().endsWith('.jar')) {
+        throw new CalciteError('bad_mod', `Not a mod jar: "${name}"`);
+    }
+    return clean;
+}
+async function modrinthVersion(project, version, mc, loader) {
+    const query = `loaders=${encodeURIComponent(JSON.stringify([loader]))}&game_versions=${encodeURIComponent(JSON.stringify([mc]))}`;
+    let versions;
+    try {
+        versions = await httpJson(`${MODRINTH_API}/project/${encodeURIComponent(project)}/version?${query}`);
+    }
+    catch (err) {
+        if (err.status === 404)
+            throw new CalciteError('mod_not_found', `Modrinth has no project "${project}"`);
+        throw err;
+    }
+    const pick = version
+        ? versions.find((v) => v.version_number === version || v.id === version)
+        : (versions.find((v) => v.version_type === 'release') ?? versions[0]);
+    if (!pick) {
+        throw new CalciteError('mod_not_found', `Modrinth project "${project}" has no ${version ? `version "${version}"` : 'version'} for ${loader} on Minecraft ${mc}`);
+    }
+    return pick;
+}
+async function modrinthFile(paths, v) {
+    const f = v.files.find((x) => x.primary) ?? v.files[0];
+    if (!f)
+        throw new CalciteError('mod_not_found', `Modrinth version ${v.id} has no files`);
+    const name = safeName(f.filename);
+    const file = join(paths.mods, 'modrinth', f.hashes.sha1, name);
+    await download(f.url, file, { sha1: f.hashes.sha1 });
+    return { name, file };
+}
+async function localJars(spec) {
+    const path = resolve(spec);
+    let info;
+    try {
+        info = await stat(path);
+    }
+    catch {
+        throw new CalciteError('mod_not_found', `Mod file or folder not found: ${path}`);
+    }
+    if (!info.isDirectory())
+        return [path];
+    return (await readdir(path)).filter((n) => n.toLowerCase().endsWith('.jar')).sort().map((n) => join(path, n));
+}
+/**
+ * Resolves mod specs to local jars: a jar or folder of jars, an http(s) URL, or "modrinth:<project>[@<version>]"
+ * (the newest release for this Minecraft version and loader, plus its required dependencies).
+ */
+export async function resolveMods(paths, specs, mc, loader) {
+    const mods = [];
+    const projects = new Set();
+    const pending = [];
+    for (const raw of specs) {
+        const spec = raw.trim();
+        if (!spec)
+            continue;
+        const modrinth = /^modrinth:([^@\s]+)(?:@(\S+))?$/i.exec(spec);
+        if (modrinth) {
+            pending.push({ project: modrinth[1], version: modrinth[2], source: spec });
+        }
+        else if (/^https?:\/\//i.test(spec)) {
+            const url = new URL(spec);
+            const name = safeName(decodeURIComponent(url.pathname));
+            const file = join(paths.mods, 'url', createHash('sha256').update(spec).digest('hex').slice(0, 16), name);
+            await download(spec, file);
+            mods.push({ name, file, source: spec });
+        }
+        else {
+            for (const file of await localJars(spec))
+                mods.push({ name: safeName(file), file, source: spec });
+        }
+    }
+    // Modrinth projects and their required dependencies, breadth first
+    while (pending.length) {
+        const next = pending.shift();
+        const v = await modrinthVersion(next.project, next.version, mc, loader);
+        if (projects.has(v.project_id))
+            continue;
+        projects.add(v.project_id);
+        mods.push({ ...(await modrinthFile(paths, v)), source: next.source });
+        for (const dep of v.dependencies) {
+            if (dep.dependency_type !== 'required' || !dep.project_id || projects.has(dep.project_id))
+                continue;
+            pending.push({ project: dep.project_id, source: `${next.source} → dependency` });
+        }
+    }
+    const seen = new Map();
+    for (const m of mods) {
+        const other = seen.get(m.name);
+        if (other && other !== m.file)
+            throw new CalciteError('bad_mod', `Two mods share the file name ${m.name}`);
+        seen.set(m.name, m.file);
+    }
+    return mods.filter((m, i) => mods.findIndex((x) => x.name === m.name) === i);
+}
+/**
+ * Makes {@code gameDir}/mods contain exactly the given Calcite-managed mods. Files Calcite did not place there are
+ * left alone; managed files no longer requested are removed.
+ */
+export async function syncMods(gameDir, mods) {
+    const dir = join(gameDir, 'mods');
+    const manifest = join(dir, MANIFEST);
+    let previous = [];
+    try {
+        previous = JSON.parse(await readFile(manifest, 'utf8')).files ?? [];
+    }
+    catch {
+        // first sync
+    }
+    const wanted = new Set(mods.map((m) => m.name));
+    for (const name of previous) {
+        if (!wanted.has(name))
+            await rm(join(dir, basename(name)), { force: true });
+    }
+    if (!mods.length) {
+        await rm(manifest, { force: true });
+        return;
+    }
+    await mkdir(dir, { recursive: true });
+    for (const m of mods)
+        await copyFile(m.file, join(dir, m.name));
+    await writeFile(manifest, JSON.stringify({ files: [...wanted] }, null, 2));
+}
+/** Resolves extension specs (local jars or http(s) URLs, downloaded once) to absolute jar paths. */
+export async function resolveExtensions(paths, specs) {
+    const jars = [];
+    for (const raw of specs) {
+        const spec = raw.trim();
+        if (!spec)
+            continue;
+        if (/^https?:\/\//i.test(spec)) {
+            const name = safeName(decodeURIComponent(new URL(spec).pathname));
+            const file = join(paths.mods, 'extensions', createHash('sha256').update(spec).digest('hex').slice(0, 16), name);
+            await download(spec, file);
+            jars.push(file);
+            continue;
+        }
+        const file = resolve(spec);
+        let info;
+        try {
+            info = await stat(file);
+        }
+        catch {
+            throw new CalciteError('extension_not_found', `Extension jar not found: ${file}`);
+        }
+        if (!info.isFile())
+            throw new CalciteError('extension_not_found', `Extension is not a file: ${file}`);
+        safeName(file);
+        jars.push(file);
+    }
+    return [...new Set(jars)];
+}
+//# sourceMappingURL=mods.js.map

package/dist/mods.js.map

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

package/dist/mojang.d.ts

@@ -51,20 +51,4 @@ export declare function ensureClientJar(paths: CalcitePaths, json: VersionJson):
 export declare function requiredJavaMajor(json: VersionJson): number;
 /** Whether the game understands --quickPlayMultiplayer (1.20+); older versions use --server/--port. */
 export declare function supportsQuickPlay(json: VersionJson): boolean;
-export type NameMode = {
-    kind: 'mappings';
-    file: string;
-} | {
-    kind: 'official';
-} | {
-    kind: 'unsupported';
-    reason: string;
-};
-/**
- * How the probe can find game classes: Mojang mappings (obfuscated 1.14.4+), official names (unobfuscated
- * releases such as 26.1+), or unsupported (obfuscated versions without published mappings, before 1.14.4).
- */
-export declare function resolveNames(paths: CalcitePaths, json: VersionJson, clientJar: string): Promise<NameMode>;
-/** Checks the zip central directory for an entry name (no full extraction). */
-export declare function zipContains(file: string, entry: string): Promise<boolean>;
 export {};

package/dist/mojang.js

@@ -1,4 +1,4 @@
-import { mkdir, open, readFile, stat, writeFile } from 'node:fs/promises';
+import { mkdir, readFile, stat, writeFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { download, httpJson } from './net.js';
 export const MANIFEST_URL = 'https://piston-meta.mojang.com/mc/game/version_manifest_v2.json';
@@ -70,40 +70,4 @@ export function requiredJavaMajor(json) {
 export function supportsQuickPlay(json) {
     return JSON.stringify(json.arguments?.game ?? []).includes('quickPlayMultiplayer');
 }
-/**
- * How the probe can find game classes: Mojang mappings (obfuscated 1.14.4+), official names (unobfuscated
- * releases such as 26.1+), or unsupported (obfuscated versions without published mappings, before 1.14.4).
- */
-export async function resolveNames(paths, json, clientJar) {
-    if (json.downloads.client_mappings) {
-        const file = join(paths.mappings, `${json.id}-client.txt`);
-        await download(json.downloads.client_mappings.url, file, { sha1: json.downloads.client_mappings.sha1 });
-        return { kind: 'mappings', file };
-    }
-    if (await zipContains(clientJar, 'net/minecraft/client/Minecraft.class')) {
-        return { kind: 'official' };
-    }
-    return { kind: 'unsupported', reason: `Minecraft ${json.id} is obfuscated and Mojang published no mappings for it (needs 1.14.4+)` };
-}
-/** Checks the zip central directory for an entry name (no full extraction). */
-export async function zipContains(file, entry) {
-    const handle = await open(file, 'r');
-    try {
-        const { size } = await handle.stat();
-        const tailSize = Math.min(size, 65_557);
-        const tail = Buffer.alloc(tailSize);
-        await handle.read(tail, 0, tailSize, size - tailSize);
-        const eocd = tail.lastIndexOf(Buffer.from([0x50, 0x4b, 0x05, 0x06]));
-        if (eocd < 0)
-            throw new Error(`Not a zip file: ${file}`);
-        const cdSize = tail.readUInt32LE(eocd + 12);
-        const cdOffset = tail.readUInt32LE(eocd + 16);
-        const cd = Buffer.alloc(cdSize);
-        await handle.read(cd, 0, cdSize, cdOffset);
-        return cd.includes(Buffer.from(entry, 'utf8'));
-    }
-    finally {
-        await handle.close();
-    }
-}
 //# sourceMappingURL=mojang.js.map

package/dist/mojang.js.map

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

package/dist/names.d.ts

@@ -0,0 +1,53 @@
+import { type InstalledLoader } from './loaders.js';
+import type { VersionJson } from './mojang.js';
+import type { CalcitePaths } from './paths.js';
+/** Probe name candidate meaning "the game runs with official (Mojang) names". */
+export declare const OFFICIAL = "official";
+/**
+ * How the probe finds game classes: candidate name tables (mapping files or {@link OFFICIAL}), tried in order by the
+ * probe until one matches the running game; or unsupported (no names known for this game).
+ */
+export type NameMode = {
+    kind: 'probe';
+    candidates: string[];
+} | {
+    kind: 'unsupported';
+    reason: string;
+};
+/**
+ * Name candidates for the probe. Vanilla and loaders running on Mojang names use Mojang's mappings (or official
+ * names on unobfuscated releases such as 26.1+); Fabric uses intermediary names and Forge/NeoForge before 1.20.5/6
+ * use SRG member names, both composed with Mojang's mappings.
+ */
+export declare function resolveNames(paths: CalcitePaths, json: VersionJson, clientJar: string, loader?: InstalledLoader): Promise<NameMode>;
+/** Names of obfuscated members in some namespace, keyed by obfuscated owner (internal name), name and descriptor. */
+export interface TargetNames {
+    classes: Map<string, string>;
+    /** "owner.name:desc" and "owner.name" */
+    fields: Map<string, string>;
+    /** "owner.name(desc)" */
+    methods: Map<string, string>;
+}
+/** Fabric tiny v1 or v2 mappings, "official" → "intermediary". */
+export declare function parseTiny(text: string): TargetNames;
+/** MCPConfig/NeoForm tsrg (v1) or tsrg2 mappings, obfuscated → SRG. */
+export declare function parseTsrg(text: string): TargetNames;
+interface MojangClass {
+    named: string;
+    obf: string;
+    members: {
+        text: string;
+        name: string;
+        type: string;
+        params?: string[];
+        obf: string;
+    }[];
+}
+export declare function parseMojang(text: string): MojangClass[];
+/**
+ * Composes Mojang's mappings (named → obfuscated) with {@code target} (obfuscated → runtime) into a ProGuard style
+ * file named → runtime, which the probe reads like Mojang's own. Members the target does not rename keep their
+ * name when it is not obfuscated; other unmapped members are left out.
+ */
+export declare function compose(mojang: MojangClass[], target: TargetNames, classRuntime: (cls: MojangClass) => string | undefined): string;
+export {};

package/dist/names.js

@@ -0,0 +1,267 @@
+import { mkdir, readFile, rename, rm, stat, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { loaderGameArg } from './loaders.js';
+import { download } from './net.js';
+import { readZipEntry, zipContains } from './zip.js';
+/** Probe name candidate meaning "the game runs with official (Mojang) names". */
+export const OFFICIAL = 'official';
+/** Bumped when the composed mapping format changes, so cached files are rebuilt. */
+const COMPOSE_FORMAT = 1;
+// releases where the loaders changed the runtime names of Minecraft
+const FORGE_MOJANG_CLASSES = Date.parse('2021-06-08T00:00:00Z'); // 1.17: Mojang class names + SRG members
+const NEOFORGE_MOJMAP = Date.parse('2024-04-23T00:00:00Z'); // 1.20.5: NeoForge runs on Mojang names
+const FORGE_MOJMAP = Date.parse('2024-04-29T00:00:00Z'); // 1.20.6: Forge runs on Mojang names
+/**
+ * Name candidates for the probe. Vanilla and loaders running on Mojang names use Mojang's mappings (or official
+ * names on unobfuscated releases such as 26.1+); Fabric uses intermediary names and Forge/NeoForge before 1.20.5/6
+ * use SRG member names, both composed with Mojang's mappings.
+ */
+export async function resolveNames(paths, json, clientJar, loader) {
+    if (!json.downloads.client_mappings) {
+        if (await zipContains(clientJar, 'net/minecraft/client/Minecraft.class'))
+            return { kind: 'probe', candidates: [OFFICIAL] };
+        return { kind: 'unsupported', reason: `Minecraft ${json.id} is obfuscated and Mojang published no mappings for it (needs 1.14.4+)` };
+    }
+    const mojang = join(paths.mappings, `${json.id}-client.txt`);
+    await download(json.downloads.client_mappings.url, mojang, { sha1: json.downloads.client_mappings.sha1 });
+    if (!loader)
+        return { kind: 'probe', candidates: [mojang] };
+    const released = Date.parse(json.releaseTime);
+    if (loader.kind === 'fabric') {
+        return { kind: 'probe', candidates: [await composeFabric(paths, json.id, mojang, loader)] };
+    }
+    if ((loader.kind === 'forge' && released >= FORGE_MOJMAP) || (loader.kind === 'neoforge' && released >= NEOFORGE_MOJMAP)) {
+        return { kind: 'probe', candidates: [OFFICIAL] };
+    }
+    if (loader.kind === 'forge' && released < FORGE_MOJANG_CLASSES) {
+        return { kind: 'unsupported', reason: `Forge for Minecraft ${json.id} runs on MCP names, which the probe does not support (needs 1.17+)` };
+    }
+    // the exact switch to Mojang names is not tied to a version number for every build: let the probe check both
+    const srg = await composeSrg(paths, json.id, mojang, loader);
+    return { kind: 'probe', candidates: srg ? [srg, OFFICIAL] : [OFFICIAL] };
+}
+function emptyTarget() {
+    return { classes: new Map(), fields: new Map(), methods: new Map() };
+}
+function addField(t, owner, name, desc, value) {
+    if (desc)
+        t.fields.set(`${owner}.${name}:${desc}`, value);
+    const plain = `${owner}.${name}`;
+    // obfuscated field names repeat with different types; a bare key is only usable when unique
+    if (t.fields.has(plain) && t.fields.get(plain) !== value)
+        t.fields.set(plain, '');
+    else
+        t.fields.set(plain, value);
+}
+/** Fabric tiny v1 or v2 mappings, "official" → "intermediary". */
+export function parseTiny(text) {
+    const t = emptyTarget();
+    const lines = text.split(/\r?\n/);
+    const header = lines[0]?.split('\t') ?? [];
+    if (header[0] === 'v1') {
+        const from = header.indexOf('official') - 1;
+        const to = header.indexOf('intermediary') - 1;
+        if (from < 0 || to < 0)
+            throw new Error('tiny v1 mappings without official/intermediary namespaces');
+        for (const line of lines.slice(1)) {
+            const p = line.split('\t');
+            if (p[0] === 'CLASS')
+                t.classes.set(p[1 + from], p[1 + to]);
+            else if (p[0] === 'FIELD')
+                addField(t, p[1], p[3 + from], p[2], p[3 + to]);
+            else if (p[0] === 'METHOD')
+                t.methods.set(`${p[1]}.${p[3 + from]}${p[2]}`, p[3 + to]);
+        }
+        return t;
+    }
+    if (header[0] === 'tiny' && header[1] === '2') {
+        const ns = header.slice(3);
+        const from = ns.indexOf('official');
+        const to = ns.indexOf('intermediary');
+        if (from < 0 || to < 0)
+            throw new Error('tiny v2 mappings without official/intermediary namespaces');
+        let owner = '';
+        for (const line of lines.slice(1)) {
+            if (line.startsWith('c\t')) {
+                const p = line.split('\t').slice(1);
+                owner = p[from];
+                t.classes.set(owner, p[to]);
+            }
+            else if (line.startsWith('\tf\t') || line.startsWith('\tm\t')) {
+                const p = line.split('\t').slice(2);
+                const desc = p[0]; // descriptors use the first namespace
+                const names = p.slice(1);
+                if (from !== 0)
+                    continue; // descriptors would need remapping; Fabric's files always start with official
+                if (line[1] === 'f')
+                    addField(t, owner, names[from], desc, names[to]);
+                else
+                    t.methods.set(`${owner}.${names[from]}${desc}`, names[to]);
+            }
+        }
+        return t;
+    }
+    throw new Error(`Unknown tiny mappings header: ${lines[0]}`);
+}
+/** MCPConfig/NeoForm tsrg (v1) or tsrg2 mappings, obfuscated → SRG. */
+export function parseTsrg(text) {
+    const t = emptyTarget();
+    let owner = '';
+    for (const line of text.split(/\r?\n/)) {
+        if (!line || line.startsWith('tsrg2 ') || line.startsWith('\t\t'))
+            continue;
+        const p = line.trim().split(' ');
+        if (line[0] !== '\t') {
+            owner = p[0];
+            t.classes.set(owner, p[1]);
+        }
+        else if (p[1]?.startsWith('(')) {
+            t.methods.set(`${owner}.${p[0]}${p[1]}`, p[2]);
+        }
+        else if (p.length >= 2) {
+            addField(t, owner, p[0], undefined, p[1]);
+        }
+    }
+    return t;
+}
+// ---------------------------------------------------------------- composition
+const PRIMITIVES = { boolean: 'Z', byte: 'B', char: 'C', short: 'S', int: 'I', long: 'J', float: 'F', double: 'D', void: 'V' };
+export function parseMojang(text) {
+    const classes = [];
+    let current;
+    for (const line of text.split(/\r?\n/)) {
+        if (!line || line[0] === '#')
+            continue;
+        if (line[0] !== ' ') {
+            const m = /^(\S+) -> (\S+):$/.exec(line);
+            current = m ? { named: m[1], obf: m[2], members: [] } : undefined;
+            if (current)
+                classes.push(current);
+            continue;
+        }
+        const m = /^\s+(?:\d+:\d+:)?(\S+) ([^\s(]+)(?:\((.*)\))?(?::\d+:\d+)? -> (\S+)$/.exec(line);
+        if (!current || !m)
+            continue;
+        const [, type, name, params, obf] = m;
+        current.members.push({
+            text: params === undefined ? `${type} ${name}` : `${type} ${name}(${params})`,
+            name,
+            type,
+            params: params === undefined ? undefined : params ? params.split(',') : [],
+            obf,
+        });
+    }
+    return classes;
+}
+/**
+ * Composes Mojang's mappings (named → obfuscated) with {@code target} (obfuscated → runtime) into a ProGuard style
+ * file named → runtime, which the probe reads like Mojang's own. Members the target does not rename keep their
+ * name when it is not obfuscated; other unmapped members are left out.
+ */
+export function compose(mojang, target, classRuntime) {
+    const obfOf = new Map(mojang.map((c) => [c.named, c.obf]));
+    const desc = (type) => {
+        let dims = 0;
+        while (type.endsWith('[]')) {
+            dims++;
+            type = type.slice(0, -2);
+        }
+        const base = PRIMITIVES[type] ?? `L${(obfOf.get(type) ?? type).replace(/\./g, '/')};`;
+        return '['.repeat(dims) + base;
+    };
+    const out = [];
+    for (const cls of mojang) {
+        const runtime = classRuntime(cls);
+        if (!runtime)
+            continue;
+        out.push(`${cls.named} -> ${runtime}:`);
+        const owner = cls.obf.replace(/\./g, '/');
+        for (const m of cls.members) {
+            if (m.name === '<init>' || m.name === '<clinit>')
+                continue;
+            let mapped;
+            if (m.params === undefined) {
+                mapped = target.fields.get(`${owner}.${m.obf}:${desc(m.type)}`) || target.fields.get(`${owner}.${m.obf}`) || undefined;
+            }
+            else {
+                mapped = target.methods.get(`${owner}.${m.obf}(${m.params.map(desc).join('')})${desc(m.type)}`);
+            }
+            if (!mapped && m.obf === m.name)
+                mapped = m.name;
+            if (mapped)
+                out.push(`    ${m.text} -> ${mapped}`);
+        }
+    }
+    return `${out.join('\n')}\n`;
+}
+async function exists(file) {
+    try {
+        await stat(file);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function writeComposed(file, build) {
+    if (await exists(file))
+        return file;
+    const text = await build();
+    await mkdir(join(file, '..'), { recursive: true });
+    const tmp = `${file}.${process.pid}.tmp`;
+    await writeFile(tmp, text);
+    await rename(tmp, file).catch(async (err) => {
+        await rm(tmp, { force: true });
+        if (!(await exists(file)))
+            throw err;
+    });
+    return file;
+}
+function mavenPath(group, artifact, version, ext = 'jar') {
+    return `${group.replace(/\./g, '/')}/${artifact}/${version}/${artifact}-${version}.${ext}`;
+}
+/** A library from the shared libraries directory, downloaded from {@code repo} when HeadlessMC did not fetch it. */
+async function library(paths, repo, relative) {
+    const file = join(paths.minecraft, 'libraries', ...relative.split('/'));
+    if (!(await exists(file)))
+        await download(`${repo}/${relative}`, file);
+    return file;
+}
+async function composeFabric(paths, mc, mojangFile, loader) {
+    const lib = loader.json.libraries?.find((l) => l.name.startsWith('net.fabricmc:intermediary:'));
+    const version = lib?.name.split(':')[2] ?? mc;
+    const file = join(paths.mappings, `${mc}-intermediary-${version}-c${COMPOSE_FORMAT}.txt`);
+    return writeComposed(file, async () => {
+        const jar = await library(paths, 'https://maven.fabricmc.net', mavenPath('net.fabricmc', 'intermediary', version));
+        const tiny = await readZipEntry(jar, 'mappings/mappings.tiny');
+        if (!tiny)
+            throw new Error(`${jar} contains no mappings/mappings.tiny`);
+        const target = parseTiny(tiny.toString('utf8'));
+        return compose(parseMojang(await readFile(mojangFile, 'utf8')), target, (c) => target.classes.get(c.obf.replace(/\./g, '/'))?.replace(/\//g, '.') ?? (c.obf === c.named ? c.named : undefined));
+    });
+}
+/** Mojang class names with SRG member names (Forge 1.17-1.20.5, NeoForge 1.20.1-1.20.4); null when unknown. */
+async function composeSrg(paths, mc, mojangFile, loader) {
+    const mcp = loaderGameArg(loader.json, '--fml.mcpVersion');
+    const neoForm = loaderGameArg(loader.json, '--fml.neoFormVersion');
+    const source = neoForm
+        ? { repo: 'https://maven.neoforged.net/releases', path: mavenPath('net.neoforged', 'neoform', `${mc}-${neoForm}`, 'zip'), tag: `neoform-${neoForm}` }
+        : mcp
+            ? { repo: 'https://maven.minecraftforge.net', path: mavenPath('de.oceanlabs.mcp', 'mcp_config', `${mc}-${mcp}`, 'zip'), tag: `mcp-${mcp}` }
+            : null;
+    if (!source)
+        return null;
+    const file = join(paths.mappings, `${mc}-srg-${source.tag}-c${COMPOSE_FORMAT}.txt`);
+    return writeComposed(file, async () => {
+        const zip = await library(paths, source.repo, source.path);
+        let entry = 'config/joined.tsrg';
+        const config = await readZipEntry(zip, 'config.json');
+        if (config)
+            entry = JSON.parse(config.toString('utf8')).data?.mappings ?? entry;
+        const tsrg = await readZipEntry(zip, entry);
+        if (!tsrg)
+            throw new Error(`${zip} contains no ${entry}`);
+        return compose(parseMojang(await readFile(mojangFile, 'utf8')), parseTsrg(tsrg.toString('utf8')), (c) => c.named);
+    });
+}
+//# sourceMappingURL=names.js.map

package/dist/names.js.map

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

package/dist/net.d.ts

@@ -8,6 +8,11 @@ export declare class HttpError extends Error {
 export declare function bypassProxy(target: URL, noProxy?: string): boolean;
 /** The proxy to use for {@code target}, honouring HTTPS_PROXY / HTTP_PROXY / NO_PROXY (any case). */
 export declare function proxyFor(target: URL): URL | undefined;
+/**
+ * Java system properties that route a JVM (HeadlessMC, the game) through the HTTPS_PROXY / HTTP_PROXY / NO_PROXY
+ * proxies; Java ignores those variables. Proxy credentials are not supported by Java's CONNECT handling.
+ */
+export declare function javaProxyProps(): Record<string, string>;
 export declare function httpText(url: string): Promise<string>;
 export declare function httpJson<T>(url: string): Promise<T>;
 export declare function hashFile(file: string, algorithm: 'sha1' | 'sha256'): Promise<string>;