@opys/java 0.1.2

package/README.md

@@ -0,0 +1,63 @@
+# @opys/java
+
+OpenJDK runtime support for opys — auto-installs an [Eclipse Temurin](https://adoptium.net) JDK and exposes `${java_home}` and `${java_bin}` as standardized vars so loader templates can reference a portable Java binary.
+
+## Install
+
+```sh
+npm install @opys/java
+```
+
+## Usage
+
+```ts
+import { resolveJava } from '@opys/java';
+import { resolveLwjgl3ify } from '@opys/lwjgl3ify';
+
+const lw = await resolveLwjgl3ify({ version: '3.0.16' });
+const jav = await resolveJava({ version: '21' });
+
+return {
+  manifest: {
+    artifacts: [lw.artifacts, jav.artifacts],
+    vars: { ...lw.vars, ...jav.vars },
+    launch: lw.launch, // launch.command is `${java_bin}` already
+  },
+};
+```
+
+### Version input
+
+- **Major** — `'21'`, `'17'` — resolves to the latest GA release for that major.
+- **Full version** — `'21.0.11+10'` — exact Adoptium release name (`jdk-` prefix and `-LTS` suffix are tolerated).
+
+### Options
+
+```ts
+resolveJava({
+  version: string,
+  vendor?: 'openjdk',         // only OpenJDK (Temurin) is supported today
+  platforms?: JavaPlatform[], // override the default OS/arch matrix
+  apiBase?: string,           // override the Adoptium API base URL
+});
+```
+
+## How it works
+
+1. Resolves the requested `version` against `https://api.adoptium.net/v3/`. Major versions hit `/feature_releases/<n>/ga` (latest GA); full versions hit `/release_name/eclipse/jdk-<v>` (exact).
+2. Queries each platform (linux/osx/windows × x86_64+aarch64) in parallel; soft-skips combinations that don't ship a binary.
+3. Emits one `Artifact` per platform pointing at the GitHub-hosted release asset, with sha256 from the API and OS+arch rules so only the matching binary downloads at install time.
+4. Each artifact has an `extract: dump` rule pointing at `${root}/runtimes/jdk-<major>/`, so the JDK lands at `${root}/runtimes/jdk-<major>/jdk-<full>/`.
+5. Sets `java_home` (per OS — macOS gets the `/Contents/Home` suffix) and `java_bin` (`${java_home}/bin/java` on POSIX, `${java_home}/bin/java.exe` on Windows).
+
+`@opys/installer` extracts both `.zip` (Windows) and `.tar.gz` / `.tgz` (Linux/macOS) archives, preserving the executable bit on tar entries so `bin/java` stays runnable without a chmod step.
+
+## Standard `${java_home}` and `${java_bin}` vars
+
+Every opys template returned by `@opys/minecraft` (and by any loader built on it) now sets `launch.command = '${java_bin}'`, with `java_bin` defaulting to the literal `'java'` (PATH lookup). When you spread `@opys/java`'s vars over the loader's, the var resolves to the auto-installed JDK instead — without any change to the launch command.
+
+## Notes
+
+- **Vendor**: only `openjdk` (Eclipse Temurin) is supported. Adding Liberica, Zulu, GraalVM is a matter of plugging in another resolver.
+- **macOS app bundles**: macOS Temurin tarballs ship as `.app` bundles with `Contents/MacOS/_CodeSignature/...`. `${java_home}` includes the `/Contents/Home` suffix automatically.
+- **Disk usage**: each JDK is ~200 MB compressed, ~500 MB extracted. The archive is downloaded into `${root}/runtimes/` as a sibling of the `jdk-<major>/` extract target — delete the leftover `.tar.gz`/`.zip` archive there to reclaim space.

package/dist/index.cjs

@@ -0,0 +1,257 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+let _opys_dev = require("@opys/dev");
+let _opys_core = require("@opys/core");
+
+//#region lib/resolver.ts
+/**
+* Resolver for OpenJDK builds from the Eclipse Adoptium (Temurin) distribution.
+*
+* Adoptium publishes a public asset API at `https://api.adoptium.net/v3/`.
+* We use two endpoints depending on the version input shape:
+*
+*   - Major-only (`'21'`, `'17'`)  → `/feature_releases/<major>/ga` (latest GA)
+*   - Full version                 → `/release_name/<vendor>/<release-name>`
+*     (exact, pinned build). Adoptium release names differ by line — Java 8
+*     is `jdk8u<update>-b<build>` (no hyphen), Java 9+ is `jdk-<version>`.
+*     A full input is accepted bare (`'8u492-b09'`, `'21.0.13+11'`) or as a
+*     complete release name (`'jdk8u492-b09'`, `'jdk-21.0.13+11'`).
+*
+* Each platform (os × arch) is queried separately with `image_type=jdk` and
+* `jvm_impl=hotspot`. Releases that don't ship a binary for a given platform
+* are soft-skipped — the resulting `JavaRelease` only contains the platforms
+* with a real binary.
+*/
+const ADOPTIUM_BASE = "https://api.adoptium.net/v3";
+const VENDOR = "eclipse";
+const DEFAULT_PLATFORMS = [
+	{
+		os: "linux",
+		arch: "x86_64",
+		adoptiumOs: "linux",
+		adoptiumArch: "x64",
+		homeSuffix: ""
+	},
+	{
+		os: "linux",
+		arch: "aarch64",
+		adoptiumOs: "linux",
+		adoptiumArch: "aarch64",
+		homeSuffix: ""
+	},
+	{
+		os: "osx",
+		arch: "x86_64",
+		adoptiumOs: "mac",
+		adoptiumArch: "x64",
+		homeSuffix: "/Contents/Home"
+	},
+	{
+		os: "osx",
+		arch: "aarch64",
+		adoptiumOs: "mac",
+		adoptiumArch: "aarch64",
+		homeSuffix: "/Contents/Home"
+	},
+	{
+		os: "windows",
+		arch: "x86_64",
+		adoptiumOs: "windows",
+		adoptiumArch: "x64",
+		homeSuffix: ""
+	},
+	{
+		os: "windows",
+		arch: "aarch64",
+		adoptiumOs: "windows",
+		adoptiumArch: "aarch64",
+		homeSuffix: ""
+	}
+];
+function normalizeInput(input) {
+	const v = input.trim().replace(/-LTS$/, "");
+	if (/^\d+$/.test(v)) return {
+		kind: "major",
+		raw: v
+	};
+	if (v.startsWith("jdk")) return {
+		kind: "full",
+		raw: v
+	};
+	return {
+		kind: "full",
+		raw: /^\d+u/.test(v) ? `jdk${v}` : `jdk-${v}`
+	};
+}
+function adoptiumQuery(platform) {
+	return new URLSearchParams({
+		image_type: "jdk",
+		architecture: platform.adoptiumArch,
+		os: platform.adoptiumOs,
+		jvm_impl: "hotspot",
+		heap_size: "normal",
+		vendor: VENDOR
+	}).toString();
+}
+async function fetchPlatform(apiBase, platform, version) {
+	const res = await (0, _opys_core.fetchWithRetry)(`${apiBase}${version.kind === "major" ? `/assets/feature_releases/${version.raw}/ga?${adoptiumQuery(platform)}&page_size=1&sort_order=DESC` : `/assets/release_name/${VENDOR}/${encodeURIComponent(version.raw)}?${adoptiumQuery(platform)}`}`, { headers: { Accept: "application/json" } });
+	if (res.status === 404) return null;
+	if (!res.ok) throw new Error(`Adoptium API ${res.status} ${res.statusText} for ${platform.adoptiumOs}/${platform.adoptiumArch}`);
+	const body = await res.json();
+	const release = Array.isArray(body) ? body[0] : body;
+	if (!release || !release.binaries || release.binaries.length === 0) return null;
+	const binary = release.binaries.find((b) => b.architecture === platform.adoptiumArch && b.os === platform.adoptiumOs && b.image_type === "jdk");
+	if (!binary) return null;
+	return {
+		release,
+		binary
+	};
+}
+/**
+* Resolve an OpenJDK release across all requested platforms. Returns a
+* single `JavaRelease` with one entry per platform that has a binary
+* available — platforms that don't ship a build for this release are
+* silently dropped from `binaries`, so callers don't have to handle the
+* "linux x64 exists, windows aarch64 doesn't" case explicitly.
+*/
+async function resolveOpenjdk(version, options = {}) {
+	const apiBase = options.apiBase ?? ADOPTIUM_BASE;
+	const platforms = options.platforms ?? DEFAULT_PLATFORMS;
+	const parsed = normalizeInput(version);
+	const matched = (await Promise.all(platforms.map(async (p) => {
+		const found = await fetchPlatform(apiBase, p, parsed);
+		return found ? {
+			platform: p,
+			...found
+		} : null;
+	}))).filter((x) => x !== null);
+	if (matched.length === 0) throw new Error(`No OpenJDK binaries found for version '${version}' across requested platforms.`);
+	const nameCounts = /* @__PURE__ */ new Map();
+	for (const m of matched) nameCounts.set(m.release.release_name, (nameCounts.get(m.release.release_name) ?? 0) + 1);
+	const releaseName = [...nameCounts.entries()].sort((a, b) => b[1] - a[1] || b[0].localeCompare(a[0]))[0][0];
+	const consistent = matched.filter((m) => m.release.release_name === releaseName);
+	const binaries = consistent.map((m) => ({
+		platform: m.platform,
+		filename: m.binary.package.name,
+		url: m.binary.package.link,
+		size: m.binary.package.size,
+		sha256: m.binary.package.checksum
+	}));
+	return {
+		releaseName,
+		extractDir: releaseName,
+		major: consistent[0].release.version_data.major,
+		binaries
+	};
+}
+
+//#endregion
+//#region lib/template.ts
+function osArchRuleset(os, arch) {
+	return [{
+		action: "allow",
+		os: { name: os }
+	}, {
+		action: "allow",
+		os: { arch }
+	}];
+}
+function osRuleset(os) {
+	return [{
+		action: "allow",
+		os: { name: os }
+	}];
+}
+/**
+* Build a opys template fragment that auto-installs an OpenJDK runtime
+* (Eclipse Temurin) and exposes `${java_home}` + `${java_bin}` vars.
+*
+* Each platform's archive is emitted as its own `Artifact` with an
+* OS+arch rule, so only the matching binary downloads at install time.
+* The archive is extracted into `${root}/runtimes/jdk-<major>/`, with
+* the Adoptium release directory as the immediate child (e.g.
+* `jdk-21.0.11+10/`). On macOS, `${java_home}` includes the
+* `/Contents/Home` suffix that Mac JDK bundles use.
+*
+* Spread the result into your loader's vars + artifacts:
+*
+* ```ts
+* const jav = await resolveJava({ version: '21' });
+* return {
+*   artifacts: [lw.artifacts, jav.artifacts],
+*   vars: { ...lw.vars, ...jav.vars },
+*   command: lw.command, // command.command is `${java_bin}` already
+* };
+* ```
+*/
+async function resolveJava(options) {
+	if (options.vendor && options.vendor !== "openjdk") throw new Error(`@opys/java: vendor '${options.vendor}' is not yet supported (only 'openjdk').`);
+	const release = await resolveOpenjdk(options.version, {
+		platforms: options.platforms,
+		apiBase: options.apiBase
+	});
+	const javaRoot = `\${java_runtime_dir}/jdk-${release.major}`;
+	const artifacts = release.binaries.map((b) => ({
+		path: `\${java_runtime_dir}/${b.filename}`,
+		source: (0, _opys_core.sourceUrl)(b.url),
+		size: b.size,
+		rules: osArchRuleset(b.platform.os, b.platform.arch),
+		integrity: { sha256: b.sha256 },
+		extract: [(0, _opys_core.extractDump)(javaRoot)]
+	}));
+	const seenOses = new Set(release.binaries.map((b) => b.platform.os));
+	const javaHomeArms = [];
+	const javaBinArms = [];
+	for (const os of seenOses) {
+		const platform = release.binaries.find((b) => b.platform.os === os).platform;
+		const home = `${javaRoot}/${release.extractDir}${platform.homeSuffix}`;
+		javaHomeArms.push({
+			value: home,
+			rules: osRuleset(os)
+		});
+		const exe = os === "windows" ? "java.exe" : "java";
+		javaBinArms.push({
+			value: `\${java_home}/bin/${exe}`,
+			rules: osRuleset(os)
+		});
+	}
+	return {
+		artifacts,
+		vars: {
+			java_runtime_dir: "${root}/runtimes",
+			java_home: javaHomeArms,
+			java_bin: javaBinArms
+		},
+		release
+	};
+}
+
+//#endregion
+//#region lib/plugin.ts
+/**
+* Provision an OpenJDK runtime (Eclipse Temurin). Solely owns the
+* `java_home` / `java_bin` vars and exposes `bin` as a launch group, so a
+* config wires the launch command with `command: ({ java }) => java.bin`.
+*/
+function java(version, opts = {}) {
+	return (0, _opys_dev.definePlugin)({
+		name: "java",
+		async build(ctx) {
+			const t = await resolveJava({
+				version,
+				...opts
+			});
+			ctx.log("java", `OpenJDK ${t.release.releaseName.replace(/^jdk-?/, "")}`);
+			return {
+				artifacts: t.artifacts,
+				vars: t.vars,
+				launch: { bin: "${java_bin}" }
+			};
+		}
+	});
+}
+
+//#endregion
+exports.DEFAULT_PLATFORMS = DEFAULT_PLATFORMS;
+exports.java = java;
+exports.resolveJava = resolveJava;
+exports.resolveOpenjdk = resolveOpenjdk;

package/dist/index.d.cts

@@ -0,0 +1,115 @@
+import { OpysPlugin } from "@opys/dev";
+import { Artifact, OsArch, OsName, ValDefs } from "@opys/core";
+
+//#region lib/resolver.d.ts
+/** Adoptium-side platform descriptor + how it maps onto opys's OS/arch enums. */
+interface JavaPlatform {
+  /** opys OS name. */
+  readonly os: OsName;
+  /** opys arch. `x86_64` is Adoptium's `x64`. */
+  readonly arch: OsArch;
+  /** Adoptium API `os` value (`linux`, `mac`, `windows`). */
+  readonly adoptiumOs: 'linux' | 'mac' | 'windows';
+  /** Adoptium API `architecture` value. */
+  readonly adoptiumArch: 'x64' | 'aarch64';
+  /**
+   * Path appended to the extracted top-level directory to reach JAVA_HOME.
+   * Empty on Linux/Windows; `/Contents/Home` on macOS bundles.
+   */
+  readonly homeSuffix: string;
+}
+declare const DEFAULT_PLATFORMS: readonly JavaPlatform[];
+/** A resolved binary for one (os, arch) platform. */
+interface JavaBinary {
+  readonly platform: JavaPlatform;
+  /** Asset filename, e.g. `OpenJDK21U-jdk_x64_linux_hotspot_21.0.11_10.tar.gz`. */
+  readonly filename: string;
+  /** Direct download URL (GitHub release asset). */
+  readonly url: string;
+  /** Asset size in bytes. */
+  readonly size: number;
+  /** sha256 of the asset (hex). */
+  readonly sha256: string;
+}
+interface JavaRelease {
+  /** Adoptium release name, e.g. `jdk-21.0.11+10`. */
+  readonly releaseName: string;
+  /** Top-level directory after extraction (matches `releaseName`). */
+  readonly extractDir: string;
+  /** Major version, e.g. `21`. */
+  readonly major: number;
+  /** Per-platform binaries that exist for this release. */
+  readonly binaries: JavaBinary[];
+}
+interface ResolveOpenjdkOptions {
+  /** Override the platform set. Default: linux/mac/windows × x64+aarch64. */
+  platforms?: readonly JavaPlatform[];
+  /** Optional override for the Adoptium API base URL. */
+  apiBase?: string;
+}
+/**
+ * Resolve an OpenJDK release across all requested platforms. Returns a
+ * single `JavaRelease` with one entry per platform that has a binary
+ * available — platforms that don't ship a build for this release are
+ * silently dropped from `binaries`, so callers don't have to handle the
+ * "linux x64 exists, windows aarch64 doesn't" case explicitly.
+ */
+declare function resolveOpenjdk(version: string, options?: ResolveOpenjdkOptions): Promise<JavaRelease>;
+//#endregion
+//#region lib/template.d.ts
+interface JavaOptions {
+  /**
+   * OpenJDK version. Accepts:
+   *   - Major:        `'21'` — resolves to the latest GA for that major.
+   *   - Full version: `'21.0.11+10'` — exact Adoptium release name (`jdk-…` prefix and `-LTS` suffix are tolerated).
+   */
+  version: string;
+  /** Distribution to fetch from. Only `'openjdk'` (Eclipse Temurin) is supported today. */
+  vendor?: 'openjdk';
+  /** Override the platform set. Default covers linux/osx/windows × x86_64+aarch64. */
+  platforms?: readonly JavaPlatform[];
+  /** Optional override for the Adoptium API base URL. */
+  apiBase?: string;
+}
+interface JavaTemplate {
+  /** Per-platform JDK archives, scoped by OS+arch rules and extracted on first install. */
+  artifacts: Artifact[];
+  /** `java_home` and `java_bin` per OS — spread into your loader's vars. */
+  vars: ValDefs;
+  /** Resolved release metadata. */
+  release: JavaRelease;
+}
+/**
+ * Build a opys template fragment that auto-installs an OpenJDK runtime
+ * (Eclipse Temurin) and exposes `${java_home}` + `${java_bin}` vars.
+ *
+ * Each platform's archive is emitted as its own `Artifact` with an
+ * OS+arch rule, so only the matching binary downloads at install time.
+ * The archive is extracted into `${root}/runtimes/jdk-<major>/`, with
+ * the Adoptium release directory as the immediate child (e.g.
+ * `jdk-21.0.11+10/`). On macOS, `${java_home}` includes the
+ * `/Contents/Home` suffix that Mac JDK bundles use.
+ *
+ * Spread the result into your loader's vars + artifacts:
+ *
+ * ```ts
+ * const jav = await resolveJava({ version: '21' });
+ * return {
+ *   artifacts: [lw.artifacts, jav.artifacts],
+ *   vars: { ...lw.vars, ...jav.vars },
+ *   command: lw.command, // command.command is `${java_bin}` already
+ * };
+ * ```
+ */
+declare function resolveJava(options: JavaOptions): Promise<JavaTemplate>;
+//#endregion
+//#region lib/plugin.d.ts
+/**
+ * Provision an OpenJDK runtime (Eclipse Temurin). Solely owns the
+ * `java_home` / `java_bin` vars and exposes `bin` as a launch group, so a
+ * config wires the launch command with `command: ({ java }) => java.bin`.
+ */
+declare function java(version: string, opts?: Omit<JavaOptions, 'version'>): OpysPlugin;
+//#endregion
+export { DEFAULT_PLATFORMS, type JavaBinary, type JavaOptions, type JavaPlatform, type JavaRelease, type JavaTemplate, type ResolveOpenjdkOptions, java, resolveJava, resolveOpenjdk };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../lib/resolver.ts","../lib/template.ts","../lib/plugin.ts"],"mappings":";;;;;UAyBiB,YAAA;;WAEN,EAAA,EAAI,MAAA;EAFc;EAAA,SAIlB,IAAA,EAAM,MAAA;EAAM;EAAA,SAEZ,UAAA;EAJI;EAAA,SAMJ,YAAA;EAJM;;;;EAAA,SASN,UAAA;AAAA;AAAA,cAGE,iBAAA,WAA4B,YAAA;;UA8CxB,UAAA;EAAA,SACN,QAAA,EAAU,YAAA;EA/CgC;EAAA,SAiD1C,QAAA;EAHgB;EAAA,SAKhB,GAAA;EAJsB;EAAA,SAMtB,IAAA;EANU;EAAA,SAQV,MAAA;AAAA;AAAA,UAGM,WAAA;EAHN;EAAA,SAKA,WAAA;EALM;EAAA,SAON,UAAA;EAJiB;EAAA,SAMjB,KAAA;EAEoB;EAAA,SAApB,QAAA,EAAU,UAAA;AAAA;AAAA,UAGJ,qBAAA;EAHN;EAKT,SAAA,YAAqB,YAAA;EALQ;EAO7B,OAAA;AAAA;;;;;;;;iBA6FoB,cAAA,CACpB,OAAA,UACA,OAAA,GAAS,qBAAA,GACR,OAAA,CAAQ,WAAA;;;UCnMM,WAAA;;ADUjB;;;;ECJE,OAAA;EDMa;ECJb,MAAA;EDMe;ECJf,SAAA,YAAqB,YAAA;EDQZ;ECNT,OAAA;AAAA;AAAA,UAGe,YAAA;EDWJ;ECTX,SAAA,EAAW,QAAA;;EAEX,IAAA,EAAM,OAAA;EDO6C;ECLnD,OAAA,EAAS,WAAA;AAAA;;;;;;;;;;;AD+DX;;;;;;;;;;;AAWA;iBCtCsB,WAAA,CAAY,OAAA,EAAS,WAAA,GAAc,OAAA,CAAQ,YAAA;;;;;AD/CjE;;;iBEjBgB,IAAA,CACd,OAAA,UACA,IAAA,GAAM,IAAA,CAAK,WAAA,eACV,UAAA"}

package/dist/index.d.mts

@@ -0,0 +1,115 @@
+import { OpysPlugin } from "@opys/dev";
+import { Artifact, OsArch, OsName, ValDefs } from "@opys/core";
+
+//#region lib/resolver.d.ts
+/** Adoptium-side platform descriptor + how it maps onto opys's OS/arch enums. */
+interface JavaPlatform {
+  /** opys OS name. */
+  readonly os: OsName;
+  /** opys arch. `x86_64` is Adoptium's `x64`. */
+  readonly arch: OsArch;
+  /** Adoptium API `os` value (`linux`, `mac`, `windows`). */
+  readonly adoptiumOs: 'linux' | 'mac' | 'windows';
+  /** Adoptium API `architecture` value. */
+  readonly adoptiumArch: 'x64' | 'aarch64';
+  /**
+   * Path appended to the extracted top-level directory to reach JAVA_HOME.
+   * Empty on Linux/Windows; `/Contents/Home` on macOS bundles.
+   */
+  readonly homeSuffix: string;
+}
+declare const DEFAULT_PLATFORMS: readonly JavaPlatform[];
+/** A resolved binary for one (os, arch) platform. */
+interface JavaBinary {
+  readonly platform: JavaPlatform;
+  /** Asset filename, e.g. `OpenJDK21U-jdk_x64_linux_hotspot_21.0.11_10.tar.gz`. */
+  readonly filename: string;
+  /** Direct download URL (GitHub release asset). */
+  readonly url: string;
+  /** Asset size in bytes. */
+  readonly size: number;
+  /** sha256 of the asset (hex). */
+  readonly sha256: string;
+}
+interface JavaRelease {
+  /** Adoptium release name, e.g. `jdk-21.0.11+10`. */
+  readonly releaseName: string;
+  /** Top-level directory after extraction (matches `releaseName`). */
+  readonly extractDir: string;
+  /** Major version, e.g. `21`. */
+  readonly major: number;
+  /** Per-platform binaries that exist for this release. */
+  readonly binaries: JavaBinary[];
+}
+interface ResolveOpenjdkOptions {
+  /** Override the platform set. Default: linux/mac/windows × x64+aarch64. */
+  platforms?: readonly JavaPlatform[];
+  /** Optional override for the Adoptium API base URL. */
+  apiBase?: string;
+}
+/**
+ * Resolve an OpenJDK release across all requested platforms. Returns a
+ * single `JavaRelease` with one entry per platform that has a binary
+ * available — platforms that don't ship a build for this release are
+ * silently dropped from `binaries`, so callers don't have to handle the
+ * "linux x64 exists, windows aarch64 doesn't" case explicitly.
+ */
+declare function resolveOpenjdk(version: string, options?: ResolveOpenjdkOptions): Promise<JavaRelease>;
+//#endregion
+//#region lib/template.d.ts
+interface JavaOptions {
+  /**
+   * OpenJDK version. Accepts:
+   *   - Major:        `'21'` — resolves to the latest GA for that major.
+   *   - Full version: `'21.0.11+10'` — exact Adoptium release name (`jdk-…` prefix and `-LTS` suffix are tolerated).
+   */
+  version: string;
+  /** Distribution to fetch from. Only `'openjdk'` (Eclipse Temurin) is supported today. */
+  vendor?: 'openjdk';
+  /** Override the platform set. Default covers linux/osx/windows × x86_64+aarch64. */
+  platforms?: readonly JavaPlatform[];
+  /** Optional override for the Adoptium API base URL. */
+  apiBase?: string;
+}
+interface JavaTemplate {
+  /** Per-platform JDK archives, scoped by OS+arch rules and extracted on first install. */
+  artifacts: Artifact[];
+  /** `java_home` and `java_bin` per OS — spread into your loader's vars. */
+  vars: ValDefs;
+  /** Resolved release metadata. */
+  release: JavaRelease;
+}
+/**
+ * Build a opys template fragment that auto-installs an OpenJDK runtime
+ * (Eclipse Temurin) and exposes `${java_home}` + `${java_bin}` vars.
+ *
+ * Each platform's archive is emitted as its own `Artifact` with an
+ * OS+arch rule, so only the matching binary downloads at install time.
+ * The archive is extracted into `${root}/runtimes/jdk-<major>/`, with
+ * the Adoptium release directory as the immediate child (e.g.
+ * `jdk-21.0.11+10/`). On macOS, `${java_home}` includes the
+ * `/Contents/Home` suffix that Mac JDK bundles use.
+ *
+ * Spread the result into your loader's vars + artifacts:
+ *
+ * ```ts
+ * const jav = await resolveJava({ version: '21' });
+ * return {
+ *   artifacts: [lw.artifacts, jav.artifacts],
+ *   vars: { ...lw.vars, ...jav.vars },
+ *   command: lw.command, // command.command is `${java_bin}` already
+ * };
+ * ```
+ */
+declare function resolveJava(options: JavaOptions): Promise<JavaTemplate>;
+//#endregion
+//#region lib/plugin.d.ts
+/**
+ * Provision an OpenJDK runtime (Eclipse Temurin). Solely owns the
+ * `java_home` / `java_bin` vars and exposes `bin` as a launch group, so a
+ * config wires the launch command with `command: ({ java }) => java.bin`.
+ */
+declare function java(version: string, opts?: Omit<JavaOptions, 'version'>): OpysPlugin;
+//#endregion
+export { DEFAULT_PLATFORMS, type JavaBinary, type JavaOptions, type JavaPlatform, type JavaRelease, type JavaTemplate, type ResolveOpenjdkOptions, java, resolveJava, resolveOpenjdk };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../lib/resolver.ts","../lib/template.ts","../lib/plugin.ts"],"mappings":";;;;;UAyBiB,YAAA;;WAEN,EAAA,EAAI,MAAA;EAFc;EAAA,SAIlB,IAAA,EAAM,MAAA;EAAM;EAAA,SAEZ,UAAA;EAJI;EAAA,SAMJ,YAAA;EAJM;;;;EAAA,SASN,UAAA;AAAA;AAAA,cAGE,iBAAA,WAA4B,YAAA;;UA8CxB,UAAA;EAAA,SACN,QAAA,EAAU,YAAA;EA/CgC;EAAA,SAiD1C,QAAA;EAHgB;EAAA,SAKhB,GAAA;EAJsB;EAAA,SAMtB,IAAA;EANU;EAAA,SAQV,MAAA;AAAA;AAAA,UAGM,WAAA;EAHN;EAAA,SAKA,WAAA;EALM;EAAA,SAON,UAAA;EAJiB;EAAA,SAMjB,KAAA;EAEoB;EAAA,SAApB,QAAA,EAAU,UAAA;AAAA;AAAA,UAGJ,qBAAA;EAHN;EAKT,SAAA,YAAqB,YAAA;EALQ;EAO7B,OAAA;AAAA;;;;;;;;iBA6FoB,cAAA,CACpB,OAAA,UACA,OAAA,GAAS,qBAAA,GACR,OAAA,CAAQ,WAAA;;;UCnMM,WAAA;;ADUjB;;;;ECJE,OAAA;EDMa;ECJb,MAAA;EDMe;ECJf,SAAA,YAAqB,YAAA;EDQZ;ECNT,OAAA;AAAA;AAAA,UAGe,YAAA;EDWJ;ECTX,SAAA,EAAW,QAAA;;EAEX,IAAA,EAAM,OAAA;EDO6C;ECLnD,OAAA,EAAS,WAAA;AAAA;;;;;;;;;;;AD+DX;;;;;;;;;;;AAWA;iBCtCsB,WAAA,CAAY,OAAA,EAAS,WAAA,GAAc,OAAA,CAAQ,YAAA;;;;;AD/CjE;;;iBEjBgB,IAAA,CACd,OAAA,UACA,IAAA,GAAM,IAAA,CAAK,WAAA,eACV,UAAA"}

package/dist/index.mjs

@@ -0,0 +1,254 @@
+import { definePlugin } from "@opys/dev";
+import { extractDump, fetchWithRetry, sourceUrl } from "@opys/core";
+
+//#region lib/resolver.ts
+/**
+* Resolver for OpenJDK builds from the Eclipse Adoptium (Temurin) distribution.
+*
+* Adoptium publishes a public asset API at `https://api.adoptium.net/v3/`.
+* We use two endpoints depending on the version input shape:
+*
+*   - Major-only (`'21'`, `'17'`)  → `/feature_releases/<major>/ga` (latest GA)
+*   - Full version                 → `/release_name/<vendor>/<release-name>`
+*     (exact, pinned build). Adoptium release names differ by line — Java 8
+*     is `jdk8u<update>-b<build>` (no hyphen), Java 9+ is `jdk-<version>`.
+*     A full input is accepted bare (`'8u492-b09'`, `'21.0.13+11'`) or as a
+*     complete release name (`'jdk8u492-b09'`, `'jdk-21.0.13+11'`).
+*
+* Each platform (os × arch) is queried separately with `image_type=jdk` and
+* `jvm_impl=hotspot`. Releases that don't ship a binary for a given platform
+* are soft-skipped — the resulting `JavaRelease` only contains the platforms
+* with a real binary.
+*/
+const ADOPTIUM_BASE = "https://api.adoptium.net/v3";
+const VENDOR = "eclipse";
+const DEFAULT_PLATFORMS = [
+	{
+		os: "linux",
+		arch: "x86_64",
+		adoptiumOs: "linux",
+		adoptiumArch: "x64",
+		homeSuffix: ""
+	},
+	{
+		os: "linux",
+		arch: "aarch64",
+		adoptiumOs: "linux",
+		adoptiumArch: "aarch64",
+		homeSuffix: ""
+	},
+	{
+		os: "osx",
+		arch: "x86_64",
+		adoptiumOs: "mac",
+		adoptiumArch: "x64",
+		homeSuffix: "/Contents/Home"
+	},
+	{
+		os: "osx",
+		arch: "aarch64",
+		adoptiumOs: "mac",
+		adoptiumArch: "aarch64",
+		homeSuffix: "/Contents/Home"
+	},
+	{
+		os: "windows",
+		arch: "x86_64",
+		adoptiumOs: "windows",
+		adoptiumArch: "x64",
+		homeSuffix: ""
+	},
+	{
+		os: "windows",
+		arch: "aarch64",
+		adoptiumOs: "windows",
+		adoptiumArch: "aarch64",
+		homeSuffix: ""
+	}
+];
+function normalizeInput(input) {
+	const v = input.trim().replace(/-LTS$/, "");
+	if (/^\d+$/.test(v)) return {
+		kind: "major",
+		raw: v
+	};
+	if (v.startsWith("jdk")) return {
+		kind: "full",
+		raw: v
+	};
+	return {
+		kind: "full",
+		raw: /^\d+u/.test(v) ? `jdk${v}` : `jdk-${v}`
+	};
+}
+function adoptiumQuery(platform) {
+	return new URLSearchParams({
+		image_type: "jdk",
+		architecture: platform.adoptiumArch,
+		os: platform.adoptiumOs,
+		jvm_impl: "hotspot",
+		heap_size: "normal",
+		vendor: VENDOR
+	}).toString();
+}
+async function fetchPlatform(apiBase, platform, version) {
+	const res = await fetchWithRetry(`${apiBase}${version.kind === "major" ? `/assets/feature_releases/${version.raw}/ga?${adoptiumQuery(platform)}&page_size=1&sort_order=DESC` : `/assets/release_name/${VENDOR}/${encodeURIComponent(version.raw)}?${adoptiumQuery(platform)}`}`, { headers: { Accept: "application/json" } });
+	if (res.status === 404) return null;
+	if (!res.ok) throw new Error(`Adoptium API ${res.status} ${res.statusText} for ${platform.adoptiumOs}/${platform.adoptiumArch}`);
+	const body = await res.json();
+	const release = Array.isArray(body) ? body[0] : body;
+	if (!release || !release.binaries || release.binaries.length === 0) return null;
+	const binary = release.binaries.find((b) => b.architecture === platform.adoptiumArch && b.os === platform.adoptiumOs && b.image_type === "jdk");
+	if (!binary) return null;
+	return {
+		release,
+		binary
+	};
+}
+/**
+* Resolve an OpenJDK release across all requested platforms. Returns a
+* single `JavaRelease` with one entry per platform that has a binary
+* available — platforms that don't ship a build for this release are
+* silently dropped from `binaries`, so callers don't have to handle the
+* "linux x64 exists, windows aarch64 doesn't" case explicitly.
+*/
+async function resolveOpenjdk(version, options = {}) {
+	const apiBase = options.apiBase ?? ADOPTIUM_BASE;
+	const platforms = options.platforms ?? DEFAULT_PLATFORMS;
+	const parsed = normalizeInput(version);
+	const matched = (await Promise.all(platforms.map(async (p) => {
+		const found = await fetchPlatform(apiBase, p, parsed);
+		return found ? {
+			platform: p,
+			...found
+		} : null;
+	}))).filter((x) => x !== null);
+	if (matched.length === 0) throw new Error(`No OpenJDK binaries found for version '${version}' across requested platforms.`);
+	const nameCounts = /* @__PURE__ */ new Map();
+	for (const m of matched) nameCounts.set(m.release.release_name, (nameCounts.get(m.release.release_name) ?? 0) + 1);
+	const releaseName = [...nameCounts.entries()].sort((a, b) => b[1] - a[1] || b[0].localeCompare(a[0]))[0][0];
+	const consistent = matched.filter((m) => m.release.release_name === releaseName);
+	const binaries = consistent.map((m) => ({
+		platform: m.platform,
+		filename: m.binary.package.name,
+		url: m.binary.package.link,
+		size: m.binary.package.size,
+		sha256: m.binary.package.checksum
+	}));
+	return {
+		releaseName,
+		extractDir: releaseName,
+		major: consistent[0].release.version_data.major,
+		binaries
+	};
+}
+
+//#endregion
+//#region lib/template.ts
+function osArchRuleset(os, arch) {
+	return [{
+		action: "allow",
+		os: { name: os }
+	}, {
+		action: "allow",
+		os: { arch }
+	}];
+}
+function osRuleset(os) {
+	return [{
+		action: "allow",
+		os: { name: os }
+	}];
+}
+/**
+* Build a opys template fragment that auto-installs an OpenJDK runtime
+* (Eclipse Temurin) and exposes `${java_home}` + `${java_bin}` vars.
+*
+* Each platform's archive is emitted as its own `Artifact` with an
+* OS+arch rule, so only the matching binary downloads at install time.
+* The archive is extracted into `${root}/runtimes/jdk-<major>/`, with
+* the Adoptium release directory as the immediate child (e.g.
+* `jdk-21.0.11+10/`). On macOS, `${java_home}` includes the
+* `/Contents/Home` suffix that Mac JDK bundles use.
+*
+* Spread the result into your loader's vars + artifacts:
+*
+* ```ts
+* const jav = await resolveJava({ version: '21' });
+* return {
+*   artifacts: [lw.artifacts, jav.artifacts],
+*   vars: { ...lw.vars, ...jav.vars },
+*   command: lw.command, // command.command is `${java_bin}` already
+* };
+* ```
+*/
+async function resolveJava(options) {
+	if (options.vendor && options.vendor !== "openjdk") throw new Error(`@opys/java: vendor '${options.vendor}' is not yet supported (only 'openjdk').`);
+	const release = await resolveOpenjdk(options.version, {
+		platforms: options.platforms,
+		apiBase: options.apiBase
+	});
+	const javaRoot = `\${java_runtime_dir}/jdk-${release.major}`;
+	const artifacts = release.binaries.map((b) => ({
+		path: `\${java_runtime_dir}/${b.filename}`,
+		source: sourceUrl(b.url),
+		size: b.size,
+		rules: osArchRuleset(b.platform.os, b.platform.arch),
+		integrity: { sha256: b.sha256 },
+		extract: [extractDump(javaRoot)]
+	}));
+	const seenOses = new Set(release.binaries.map((b) => b.platform.os));
+	const javaHomeArms = [];
+	const javaBinArms = [];
+	for (const os of seenOses) {
+		const platform = release.binaries.find((b) => b.platform.os === os).platform;
+		const home = `${javaRoot}/${release.extractDir}${platform.homeSuffix}`;
+		javaHomeArms.push({
+			value: home,
+			rules: osRuleset(os)
+		});
+		const exe = os === "windows" ? "java.exe" : "java";
+		javaBinArms.push({
+			value: `\${java_home}/bin/${exe}`,
+			rules: osRuleset(os)
+		});
+	}
+	return {
+		artifacts,
+		vars: {
+			java_runtime_dir: "${root}/runtimes",
+			java_home: javaHomeArms,
+			java_bin: javaBinArms
+		},
+		release
+	};
+}
+
+//#endregion
+//#region lib/plugin.ts
+/**
+* Provision an OpenJDK runtime (Eclipse Temurin). Solely owns the
+* `java_home` / `java_bin` vars and exposes `bin` as a launch group, so a
+* config wires the launch command with `command: ({ java }) => java.bin`.
+*/
+function java(version, opts = {}) {
+	return definePlugin({
+		name: "java",
+		async build(ctx) {
+			const t = await resolveJava({
+				version,
+				...opts
+			});
+			ctx.log("java", `OpenJDK ${t.release.releaseName.replace(/^jdk-?/, "")}`);
+			return {
+				artifacts: t.artifacts,
+				vars: t.vars,
+				launch: { bin: "${java_bin}" }
+			};
+		}
+	});
+}
+
+//#endregion
+export { DEFAULT_PLATFORMS, java, resolveJava, resolveOpenjdk };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../lib/resolver.ts","../lib/template.ts","../lib/plugin.ts"],"sourcesContent":["/**\n * Resolver for OpenJDK builds from the Eclipse Adoptium (Temurin) distribution.\n *\n * Adoptium publishes a public asset API at `https://api.adoptium.net/v3/`.\n * We use two endpoints depending on the version input shape:\n *\n *   - Major-only (`'21'`, `'17'`)  → `/feature_releases/<major>/ga` (latest GA)\n *   - Full version                 → `/release_name/<vendor>/<release-name>`\n *     (exact, pinned build). Adoptium release names differ by line — Java 8\n *     is `jdk8u<update>-b<build>` (no hyphen), Java 9+ is `jdk-<version>`.\n *     A full input is accepted bare (`'8u492-b09'`, `'21.0.13+11'`) or as a\n *     complete release name (`'jdk8u492-b09'`, `'jdk-21.0.13+11'`).\n *\n * Each platform (os × arch) is queried separately with `image_type=jdk` and\n * `jvm_impl=hotspot`. Releases that don't ship a binary for a given platform\n * are soft-skipped — the resulting `JavaRelease` only contains the platforms\n * with a real binary.\n */\nimport { fetchWithRetry } from '@opys/core';\nimport type { OsName, OsArch } from '@opys/core';\n\nconst ADOPTIUM_BASE = 'https://api.adoptium.net/v3';\nconst VENDOR = 'eclipse';\n\n/** Adoptium-side platform descriptor + how it maps onto opys's OS/arch enums. */\nexport interface JavaPlatform {\n  /** opys OS name. */\n  readonly os: OsName;\n  /** opys arch. `x86_64` is Adoptium's `x64`. */\n  readonly arch: OsArch;\n  /** Adoptium API `os` value (`linux`, `mac`, `windows`). */\n  readonly adoptiumOs: 'linux' | 'mac' | 'windows';\n  /** Adoptium API `architecture` value. */\n  readonly adoptiumArch: 'x64' | 'aarch64';\n  /**\n   * Path appended to the extracted top-level directory to reach JAVA_HOME.\n   * Empty on Linux/Windows; `/Contents/Home` on macOS bundles.\n   */\n  readonly homeSuffix: string;\n}\n\nexport const DEFAULT_PLATFORMS: readonly JavaPlatform[] = [\n  {\n    os: 'linux',\n    arch: 'x86_64',\n    adoptiumOs: 'linux',\n    adoptiumArch: 'x64',\n    homeSuffix: '',\n  },\n  {\n    os: 'linux',\n    arch: 'aarch64',\n    adoptiumOs: 'linux',\n    adoptiumArch: 'aarch64',\n    homeSuffix: '',\n  },\n  {\n    os: 'osx',\n    arch: 'x86_64',\n    adoptiumOs: 'mac',\n    adoptiumArch: 'x64',\n    homeSuffix: '/Contents/Home',\n  },\n  {\n    os: 'osx',\n    arch: 'aarch64',\n    adoptiumOs: 'mac',\n    adoptiumArch: 'aarch64',\n    homeSuffix: '/Contents/Home',\n  },\n  {\n    os: 'windows',\n    arch: 'x86_64',\n    adoptiumOs: 'windows',\n    adoptiumArch: 'x64',\n    homeSuffix: '',\n  },\n  {\n    os: 'windows',\n    arch: 'aarch64',\n    adoptiumOs: 'windows',\n    adoptiumArch: 'aarch64',\n    homeSuffix: '',\n  },\n];\n\n/** A resolved binary for one (os, arch) platform. */\nexport interface JavaBinary {\n  readonly platform: JavaPlatform;\n  /** Asset filename, e.g. `OpenJDK21U-jdk_x64_linux_hotspot_21.0.11_10.tar.gz`. */\n  readonly filename: string;\n  /** Direct download URL (GitHub release asset). */\n  readonly url: string;\n  /** Asset size in bytes. */\n  readonly size: number;\n  /** sha256 of the asset (hex). */\n  readonly sha256: string;\n}\n\nexport interface JavaRelease {\n  /** Adoptium release name, e.g. `jdk-21.0.11+10`. */\n  readonly releaseName: string;\n  /** Top-level directory after extraction (matches `releaseName`). */\n  readonly extractDir: string;\n  /** Major version, e.g. `21`. */\n  readonly major: number;\n  /** Per-platform binaries that exist for this release. */\n  readonly binaries: JavaBinary[];\n}\n\nexport interface ResolveOpenjdkOptions {\n  /** Override the platform set. Default: linux/mac/windows × x64+aarch64. */\n  platforms?: readonly JavaPlatform[];\n  /** Optional override for the Adoptium API base URL. */\n  apiBase?: string;\n}\n\ninterface AdoptiumPackage {\n  checksum: string;\n  link: string;\n  name: string;\n  size: number;\n}\n\ninterface AdoptiumBinary {\n  architecture: string;\n  os: string;\n  image_type: string;\n  jvm_impl: string;\n  package: AdoptiumPackage;\n}\n\ninterface AdoptiumRelease {\n  release_name: string;\n  binaries: AdoptiumBinary[];\n  version_data: { major: number };\n}\n\n/** Normalized version input: a bare major, or a full Adoptium version. */\ntype VersionInput = { kind: 'major' | 'full'; raw: string };\n\nfunction normalizeInput(input: string): VersionInput {\n  const v = input.trim().replace(/-LTS$/, '');\n  if (/^\\d+$/.test(v)) return { kind: 'major', raw: v };\n  // A `full` input resolves to an exact Adoptium release name. A value that\n  // already carries the `jdk` prefix is a complete release name; a bare\n  // version is prefixed to match — `jdk` (no hyphen) for the Java 8\n  // `8u…-b…` form, `jdk-` for the Java 9+ `<major>.<minor>.<patch>+<build>`.\n  if (v.startsWith('jdk')) return { kind: 'full', raw: v };\n  return { kind: 'full', raw: /^\\d+u/.test(v) ? `jdk${v}` : `jdk-${v}` };\n}\n\nfunction adoptiumQuery(platform: JavaPlatform): string {\n  const params = new URLSearchParams({\n    image_type: 'jdk',\n    architecture: platform.adoptiumArch,\n    os: platform.adoptiumOs,\n    jvm_impl: 'hotspot',\n    // `heap_size=normal` excludes the `large` (huge-pages) variant;\n    // `vendor=eclipse` pins the distribution to Temurin.\n    heap_size: 'normal',\n    vendor: VENDOR,\n  });\n  return params.toString();\n}\n\nasync function fetchPlatform(\n  apiBase: string,\n  platform: JavaPlatform,\n  version: VersionInput,\n): Promise<{ release: AdoptiumRelease; binary: AdoptiumBinary } | null> {\n  const path =\n    version.kind === 'major'\n      ? `/assets/feature_releases/${version.raw}/ga?${adoptiumQuery(platform)}&page_size=1&sort_order=DESC`\n      : `/assets/release_name/${VENDOR}/${encodeURIComponent(version.raw)}?${adoptiumQuery(platform)}`;\n\n  const url = `${apiBase}${path}`;\n  const res = await fetchWithRetry(url, {\n    headers: { Accept: 'application/json' },\n  });\n  if (res.status === 404) return null;\n  if (!res.ok) {\n    throw new Error(\n      `Adoptium API ${res.status} ${res.statusText} for ${platform.adoptiumOs}/${platform.adoptiumArch}`,\n    );\n  }\n  const body = (await res.json()) as AdoptiumRelease | AdoptiumRelease[];\n  const release = Array.isArray(body) ? body[0] : body;\n  if (!release || !release.binaries || release.binaries.length === 0)\n    return null;\n  const binary = release.binaries.find(\n    (b) =>\n      b.architecture === platform.adoptiumArch &&\n      b.os === platform.adoptiumOs &&\n      b.image_type === 'jdk',\n  );\n  if (!binary) return null;\n  return { release, binary };\n}\n\n/**\n * Resolve an OpenJDK release across all requested platforms. Returns a\n * single `JavaRelease` with one entry per platform that has a binary\n * available — platforms that don't ship a build for this release are\n * silently dropped from `binaries`, so callers don't have to handle the\n * \"linux x64 exists, windows aarch64 doesn't\" case explicitly.\n */\nexport async function resolveOpenjdk(\n  version: string,\n  options: ResolveOpenjdkOptions = {},\n): Promise<JavaRelease> {\n  const apiBase = options.apiBase ?? ADOPTIUM_BASE;\n  const platforms = options.platforms ?? DEFAULT_PLATFORMS;\n  const parsed = normalizeInput(version);\n\n  const fetched = await Promise.all(\n    platforms.map(async (p) => {\n      const found = await fetchPlatform(apiBase, p, parsed);\n      return found ? { platform: p, ...found } : null;\n    }),\n  );\n\n  const matched = fetched.filter((x): x is NonNullable<typeof x> => x !== null);\n  if (matched.length === 0) {\n    throw new Error(\n      `No OpenJDK binaries found for version '${version}' across requested platforms.`,\n    );\n  }\n\n  // All platforms should agree on release_name when querying a specific\n  // release_name; for major queries each platform may resolve to a\n  // different latest GA — we anchor to the most-common release_name to\n  // keep the bundle coherent (and skip mismatched binaries).\n  const nameCounts = new Map<string, number>();\n  for (const m of matched) {\n    nameCounts.set(\n      m.release.release_name,\n      (nameCounts.get(m.release.release_name) ?? 0) + 1,\n    );\n  }\n  // count desc, then newest/lexicographically-largest release name wins on a tie\n  const releaseName = [...nameCounts.entries()].sort(\n    (a, b) => b[1] - a[1] || b[0].localeCompare(a[0]),\n  )[0]![0];\n\n  const consistent = matched.filter(\n    (m) => m.release.release_name === releaseName,\n  );\n\n  const binaries: JavaBinary[] = consistent.map((m) => ({\n    platform: m.platform,\n    filename: m.binary.package.name,\n    url: m.binary.package.link,\n    size: m.binary.package.size,\n    sha256: m.binary.package.checksum,\n  }));\n\n  return {\n    releaseName,\n    extractDir: releaseName,\n    major: consistent[0]!.release.version_data.major,\n    binaries,\n  };\n}\n","import {\n  type Artifact,\n  type ValDefs,\n  type ConditionalVal,\n  sourceUrl,\n  extractDump,\n} from '@opys/core';\nimport type { OsName, OsArch, Ruleset } from '@opys/core';\nimport {\n  resolveOpenjdk,\n  type JavaPlatform,\n  type JavaRelease,\n  type ResolveOpenjdkOptions,\n} from './resolver';\n\nexport interface JavaOptions {\n  /**\n   * OpenJDK version. Accepts:\n   *   - Major:        `'21'` — resolves to the latest GA for that major.\n   *   - Full version: `'21.0.11+10'` — exact Adoptium release name (`jdk-…` prefix and `-LTS` suffix are tolerated).\n   */\n  version: string;\n  /** Distribution to fetch from. Only `'openjdk'` (Eclipse Temurin) is supported today. */\n  vendor?: 'openjdk';\n  /** Override the platform set. Default covers linux/osx/windows × x86_64+aarch64. */\n  platforms?: readonly JavaPlatform[];\n  /** Optional override for the Adoptium API base URL. */\n  apiBase?: string;\n}\n\nexport interface JavaTemplate {\n  /** Per-platform JDK archives, scoped by OS+arch rules and extracted on first install. */\n  artifacts: Artifact[];\n  /** `java_home` and `java_bin` per OS — spread into your loader's vars. */\n  vars: ValDefs;\n  /** Resolved release metadata. */\n  release: JavaRelease;\n}\n\nfunction osArchRuleset(os: OsName, arch: OsArch): Ruleset {\n  return [\n    { action: 'allow', os: { name: os } },\n    { action: 'allow', os: { arch } },\n  ];\n}\n\nfunction osRuleset(os: OsName): Ruleset {\n  return [{ action: 'allow', os: { name: os } }];\n}\n\n/**\n * Build a opys template fragment that auto-installs an OpenJDK runtime\n * (Eclipse Temurin) and exposes `${java_home}` + `${java_bin}` vars.\n *\n * Each platform's archive is emitted as its own `Artifact` with an\n * OS+arch rule, so only the matching binary downloads at install time.\n * The archive is extracted into `${root}/runtimes/jdk-<major>/`, with\n * the Adoptium release directory as the immediate child (e.g.\n * `jdk-21.0.11+10/`). On macOS, `${java_home}` includes the\n * `/Contents/Home` suffix that Mac JDK bundles use.\n *\n * Spread the result into your loader's vars + artifacts:\n *\n * ```ts\n * const jav = await resolveJava({ version: '21' });\n * return {\n *   artifacts: [lw.artifacts, jav.artifacts],\n *   vars: { ...lw.vars, ...jav.vars },\n *   command: lw.command, // command.command is `${java_bin}` already\n * };\n * ```\n */\nexport async function resolveJava(options: JavaOptions): Promise<JavaTemplate> {\n  if (options.vendor && options.vendor !== 'openjdk') {\n    throw new Error(\n      `@opys/java: vendor '${options.vendor}' is not yet supported (only 'openjdk').`,\n    );\n  }\n  const release = await resolveOpenjdk(options.version, {\n    platforms: options.platforms,\n    apiBase: options.apiBase,\n  } satisfies ResolveOpenjdkOptions);\n\n  // JDK runtimes install under the `java_runtime_dir` var (default\n  // `${root}/runtimes`) — override it in the config's `vars` to relocate.\n  // Archives download directly into it: a sibling of, never nested inside,\n  // the extract target, so no `.cache` special-casing is needed.\n  const javaRoot = `\\${java_runtime_dir}/jdk-${release.major}`;\n\n  const artifacts: Artifact[] = release.binaries.map((b) => ({\n    path: `\\${java_runtime_dir}/${b.filename}`,\n    source: sourceUrl(b.url),\n    size: b.size,\n    rules: osArchRuleset(b.platform.os, b.platform.arch),\n    integrity: { sha256: b.sha256 },\n    extract: [extractDump(javaRoot)],\n  }));\n\n  // `java_home` only varies by OS (Linux/Windows have no suffix; macOS\n  // bundles add `/Contents/Home`). Both x86_64 and aarch64 archives\n  // extract to the same top-level directory, so we don't need to split\n  // by arch here.\n  const seenOses = new Set(release.binaries.map((b) => b.platform.os));\n  const javaHomeArms: ConditionalVal[] = [];\n  const javaBinArms: ConditionalVal[] = [];\n  for (const os of seenOses) {\n    const platform = release.binaries.find(\n      (b) => b.platform.os === os,\n    )!.platform;\n    const home = `${javaRoot}/${release.extractDir}${platform.homeSuffix}`;\n    javaHomeArms.push({ value: home, rules: osRuleset(os) });\n    const exe = os === 'windows' ? 'java.exe' : 'java';\n    javaBinArms.push({\n      value: `\\${java_home}/bin/${exe}`,\n      rules: osRuleset(os),\n    });\n  }\n\n  const vars: ValDefs = {\n    java_runtime_dir: '${root}/runtimes',\n    java_home: javaHomeArms,\n    java_bin: javaBinArms,\n  };\n\n  return { artifacts, vars, release };\n}\n","import { definePlugin, type OpysPlugin } from '@opys/dev';\nimport { resolveJava, type JavaOptions } from './template';\n\n/**\n * Provision an OpenJDK runtime (Eclipse Temurin). Solely owns the\n * `java_home` / `java_bin` vars and exposes `bin` as a launch group, so a\n * config wires the launch command with `command: ({ java }) => java.bin`.\n */\nexport function java(\n  version: string,\n  opts: Omit<JavaOptions, 'version'> = {},\n): OpysPlugin {\n  return definePlugin({\n    name: 'java',\n    async build(ctx) {\n      const t = await resolveJava({ version, ...opts });\n      // The resolved build, e.g. `OpenJDK 21.0.13+11` / `OpenJDK 8u492-b09`.\n      ctx.log('java', `OpenJDK ${t.release.releaseName.replace(/^jdk-?/, '')}`);\n      return {\n        artifacts: t.artifacts,\n        vars: t.vars,\n        launch: { bin: '${java_bin}' },\n      };\n    },\n  });\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@opys/java",
+  "version": "0.1.2",
+  "type": "module",
+  "main": "./dist/index.js",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "scripts": {
+    "build": "tsdown lib/index.ts --format esm,cjs --dts --clean",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run tests/unit --passWithNoTests",
+    "test:int": "vitest run tests/integration --testTimeout=120000"
+  },
+  "dependencies": {
+    "@opys/core": "^0.1.2",
+    "@opys/dev": "^0.1.2"
+  },
+  "peerDependencies": {
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "tsdown": "*",
+    "vitest": "*"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/harmoniya-net/opys.git",
+    "directory": "packages/java"
+  }
+}