@nodecraft/rendermite 0.0.1 → 1.0.1

package/dist/vector-CCxLae_T.js

@@ -0,0 +1,190 @@
+//#region src/render/vector.ts
+function vec3(x, y, z) {
+	return [
+		x,
+		y,
+		z
+	];
+}
+function normalize(v) {
+	const length = Math.hypot(v[0], v[1], v[2]);
+	if (length === 0) return [
+		0,
+		0,
+		0
+	];
+	return [
+		v[0] / length,
+		v[1] / length,
+		v[2] / length
+	];
+}
+function dot(a, b) {
+	return a[0] * b[0] + a[1] * b[1] + a[2] * b[2];
+}
+function cross(a, b) {
+	return [
+		a[1] * b[2] - a[2] * b[1],
+		a[2] * b[0] - a[0] * b[2],
+		a[0] * b[1] - a[1] * b[0]
+	];
+}
+function sub(a, b) {
+	return [
+		a[0] - b[0],
+		a[1] - b[1],
+		a[2] - b[2]
+	];
+}
+function identity() {
+	const m = /* @__PURE__ */ new Float64Array(16);
+	m[0] = 1;
+	m[5] = 1;
+	m[10] = 1;
+	m[15] = 1;
+	return m;
+}
+/** this * other, both column-major. */
+function multiply(a, b) {
+	const out = /* @__PURE__ */ new Float64Array(16);
+	for (let col = 0; col < 4; col++) for (let row = 0; row < 4; row++) {
+		let sum = 0;
+		for (let k = 0; k < 4; k++) sum += a[row + k * 4] * b[k + col * 4];
+		out[row + col * 4] = sum;
+	}
+	return out;
+}
+function translation(x, y, z) {
+	const m = identity();
+	m[12] = x;
+	m[13] = y;
+	m[14] = z;
+	return m;
+}
+function scaling(x, y, z) {
+	const m = identity();
+	m[0] = x;
+	m[5] = y;
+	m[10] = z;
+	return m;
+}
+function rotationX(angle) {
+	const c = Math.cos(angle);
+	const s = Math.sin(angle);
+	const m = identity();
+	m[5] = c;
+	m[9] = -s;
+	m[6] = s;
+	m[10] = c;
+	return m;
+}
+function rotationY(angle) {
+	const c = Math.cos(angle);
+	const s = Math.sin(angle);
+	const m = identity();
+	m[0] = c;
+	m[8] = s;
+	m[2] = -s;
+	m[10] = c;
+	return m;
+}
+function rotationZ(angle) {
+	const c = Math.cos(angle);
+	const s = Math.sin(angle);
+	const m = identity();
+	m[0] = c;
+	m[4] = -s;
+	m[1] = s;
+	m[5] = c;
+	return m;
+}
+/** Standard unit-quaternion rotation matrix. */
+function fromQuaternion(x, y, z, w) {
+	const m = identity();
+	m[0] = 1 - 2 * (y * y + z * z);
+	m[4] = 2 * (x * y - z * w);
+	m[8] = 2 * (x * z + y * w);
+	m[1] = 2 * (x * y + z * w);
+	m[5] = 1 - 2 * (x * x + z * z);
+	m[9] = 2 * (y * z - x * w);
+	m[2] = 2 * (x * z - y * w);
+	m[6] = 2 * (y * z + x * w);
+	m[10] = 1 - 2 * (x * x + y * y);
+	return m;
+}
+/** Euler → quaternion in YXZ order, matching Matrix4::rotateEulerRadians. */
+function rotationEuler(x, y, z) {
+	const cx = Math.cos(x / 2);
+	const sx = Math.sin(x / 2);
+	const cy = Math.cos(y / 2);
+	const sy = Math.sin(y / 2);
+	const cz = Math.cos(z / 2);
+	const sz = Math.sin(z / 2);
+	return fromQuaternion(sx * cy * cz + cx * sy * sz, cx * sy * cz - sx * cy * sz, cx * cy * sz - sx * sy * cz, cx * cy * cz + sx * sy * sz);
+}
+/** Row · (x, y, z, 1), dividing by w only when w is neither 0 nor 1 (upstream quirk). */
+function transformVector(m, v) {
+	const x = m[0] * v[0] + m[4] * v[1] + m[8] * v[2] + m[12];
+	const y = m[1] * v[0] + m[5] * v[1] + m[9] * v[2] + m[13];
+	const z = m[2] * v[0] + m[6] * v[1] + m[10] * v[2] + m[14];
+	const w = m[3] * v[0] + m[7] * v[1] + m[11] * v[2] + m[15];
+	if (w !== 0 && w !== 1) return [
+		x / w,
+		y / w,
+		z / w
+	];
+	return [
+		x,
+		y,
+		z
+	];
+}
+/** Upper-left 3x3 only — for normals and light directions. */
+function transformDirection(m, v) {
+	return [
+		m[0] * v[0] + m[4] * v[1] + m[8] * v[2],
+		m[1] * v[0] + m[5] * v[1] + m[9] * v[2],
+		m[2] * v[0] + m[6] * v[1] + m[10] * v[2]
+	];
+}
+/**
+* Item-definition `transformation`: either a flat 16-number column-major array or
+* {translation, left_rotation quat, scale, right_rotation quat} applied in that order.
+*/
+function fromItemTransform(data) {
+	if (Array.isArray(data) && data.length === 16 && data.every((n) => typeof n === "number")) return Float64Array.from(data);
+	if (typeof data === "object" && data !== null) {
+		const record = data;
+		let m = identity();
+		if (record.translation) m = multiply(m, translation(record.translation[0], record.translation[1], record.translation[2]));
+		if (record.left_rotation) {
+			const [x, y, z, w] = record.left_rotation;
+			m = multiply(m, fromQuaternion(x, y, z, w));
+		}
+		if (record.scale) m = multiply(m, scaling(record.scale[0], record.scale[1], record.scale[2]));
+		if (record.right_rotation) {
+			const [x, y, z, w] = record.right_rotation;
+			m = multiply(m, fromQuaternion(x, y, z, w));
+		}
+		return m;
+	}
+	return identity();
+}
+/**
+* The gui display transform, pivot (0.5, 0.5, 0.5):
+* T(+.5) · T(translation/16) · S(scale) · Rz(-rz) · Rx(rx) · Ry(ry) · T(-.5)
+* — note the negated Z rotation and Y-innermost order, matching ModelDisplaySettings.
+*/
+function displayMatrix(rotation, translationVec, scale) {
+	const toRadians = Math.PI / 180;
+	let m = translation(.5, .5, .5);
+	m = multiply(m, translation(translationVec[0] / 16, translationVec[1] / 16, translationVec[2] / 16));
+	m = multiply(m, rotationX(rotation[0] * toRadians));
+	m = multiply(m, rotationY(rotation[1] * toRadians));
+	m = multiply(m, rotationZ(rotation[2] * toRadians));
+	m = multiply(m, scaling(scale[0], scale[1], scale[2]));
+	m = multiply(m, translation(-.5, -.5, -.5));
+	return m;
+}
+//#endregion
+export { translation as _, fromQuaternion as a, normalize as c, rotationY as d, rotationZ as f, transformVector as g, transformDirection as h, fromItemTransform as i, rotationEuler as l, sub as m, displayMatrix as n, identity as o, scaling as p, dot as r, multiply as s, cross as t, rotationX as u, vec3 as v };

package/dist/vector-DRKRi4--.d.ts

@@ -0,0 +1,43 @@
+//#region src/render/vector.d.ts
+/**
+ * Vector/matrix math mirroring renderchest's Vector3/Matrix4 semantics exactly
+ * (column-major 4x4, YXZ euler quaternions, w-divide only when w is not 0/1).
+ * Kept as plain arrays/functions — these run in the hot path.
+ */
+type Vec3 = [number, number, number];
+/** Column-major, m[row + col * 4]. */
+type Mat4 = Float64Array;
+declare function vec3(x: number, y: number, z: number): Vec3;
+declare function normalize(v: Vec3): Vec3;
+declare function dot(a: Vec3, b: Vec3): number;
+declare function cross(a: Vec3, b: Vec3): Vec3;
+declare function sub(a: Vec3, b: Vec3): Vec3;
+declare function identity(): Mat4;
+/** this * other, both column-major. */
+declare function multiply(a: Mat4, b: Mat4): Mat4;
+declare function translation(x: number, y: number, z: number): Mat4;
+declare function scaling(x: number, y: number, z: number): Mat4;
+declare function rotationX(angle: number): Mat4;
+declare function rotationY(angle: number): Mat4;
+declare function rotationZ(angle: number): Mat4;
+/** Standard unit-quaternion rotation matrix. */
+declare function fromQuaternion(x: number, y: number, z: number, w: number): Mat4;
+/** Euler → quaternion in YXZ order, matching Matrix4::rotateEulerRadians. */
+declare function rotationEuler(x: number, y: number, z: number): Mat4;
+/** Row · (x, y, z, 1), dividing by w only when w is neither 0 nor 1 (upstream quirk). */
+declare function transformVector(m: Mat4, v: Vec3): Vec3;
+/** Upper-left 3x3 only — for normals and light directions. */
+declare function transformDirection(m: Mat4, v: Vec3): Vec3;
+/**
+ * Item-definition `transformation`: either a flat 16-number column-major array or
+ * {translation, left_rotation quat, scale, right_rotation quat} applied in that order.
+ */
+declare function fromItemTransform(data: unknown): Mat4;
+/**
+ * The gui display transform, pivot (0.5, 0.5, 0.5):
+ * T(+.5) · T(translation/16) · S(scale) · Rz(-rz) · Rx(rx) · Ry(ry) · T(-.5)
+ * — note the negated Z rotation and Y-innermost order, matching ModelDisplaySettings.
+ */
+declare function displayMatrix(rotation: Vec3, translationVec: Vec3, scale: Vec3): Mat4;
+//#endregion
+export { transformDirection as _, dot as a, vec3 as b, identity as c, rotationEuler as d, rotationX as f, sub as g, scaling as h, displayMatrix as i, multiply as l, rotationZ as m, Vec3 as n, fromItemTransform as o, rotationY as p, cross as r, fromQuaternion as s, Mat4 as t, normalize as u, transformVector as v, translation as y };

package/dist/versions/download.d.ts

@@ -0,0 +1,9 @@
+//#region src/versions/download.d.ts
+/**
+ * Client jar acquisition: resolves versions through mcversions.net's index
+ * (stable + snapshot channels) and downloads from Mojang, caching by version.
+ * Shared by the CLI's --version flag and the test fixtures.
+ */
+declare function downloadClientJar(version: string, cacheDir: string): Promise<string>;
+//#endregion
+export { downloadClientJar };

package/dist/versions/download.js

@@ -0,0 +1,2 @@
+import { t as downloadClientJar } from "../download-D9aARBFp.js";
+export { downloadClientJar };

package/dist/versions/legacy-reshape.d.ts

@@ -0,0 +1,9 @@
+import { a as ResourceManager } from "../manager-CoZaeQTu.js";
+//#region src/versions/legacy-reshape.d.ts
+/**
+ * Build an in-memory texture layer for a pre-1.6 jar. `sheets` selects the
+ * ≤1.4.7 stitched-sheet path; otherwise the 1.5.x individual-file path.
+ */
+declare function reshapeLegacyAssets(jarPath: string, referenceJar: string, sheets: boolean): Promise<ResourceManager>;
+//#endregion
+export { reshapeLegacyAssets };

package/dist/versions/legacy-reshape.js

@@ -0,0 +1,2 @@
+import { t as reshapeLegacyAssets } from "../legacy-reshape-CewShfF3.js";
+export { reshapeLegacyAssets };

package/dist/versions/prepare.d.ts

@@ -0,0 +1,2 @@
+import { a as compareVersions, i as PrepareOptions, n as EraName, o as eraForVersion, r as GEOMETRY_DONOR_VERSIONS, s as prepareVersionResources, t as Era } from "../prepare-wfWtaz_X.js";
+export { Era, EraName, GEOMETRY_DONOR_VERSIONS, PrepareOptions, compareVersions, eraForVersion, prepareVersionResources };

package/dist/versions/prepare.js

@@ -0,0 +1,2 @@
+import { a as prepareVersionResources, i as eraForVersion, n as GEOMETRY_DONOR_VERSIONS, r as compareVersions, t as Era } from "../prepare-DROxBZp1.js";
+export { Era, GEOMETRY_DONOR_VERSIONS, compareVersions, eraForVersion, prepareVersionResources };

package/dist/workers/pool.d.ts

@@ -0,0 +1,23 @@
+//#region src/workers/pool.d.ts
+/**
+ * Worker-thread pool for parallel item rendering. Design goals born from the
+ * PHP tool's failure modes (docs/research/mod-failure-taxonomy.md): errors
+ * cross the worker boundary as structured data, a dead worker's queue items are
+ * requeued not orphaned, and results stream back so output lands incrementally.
+ */
+interface WorkerTask {
+  id: string;
+}
+interface WorkerResult<T> {
+  id: string;
+  result?: T;
+  error?: string;
+}
+interface PoolOptions {
+  workerUrl: URL;
+  workerData: unknown;
+  concurrency: number;
+}
+declare function runPool<T>(tasks: WorkerTask[], options: PoolOptions, onResult: (result: WorkerResult<T>) => void): Promise<void>;
+//#endregion
+export { PoolOptions, WorkerResult, WorkerTask, runPool };

package/dist/workers/pool.js

@@ -0,0 +1,67 @@
+import { Worker } from "node:worker_threads";
+//#region src/workers/pool.ts
+/**
+* Worker-thread pool for parallel item rendering. Design goals born from the
+* PHP tool's failure modes (docs/research/mod-failure-taxonomy.md): errors
+* cross the worker boundary as structured data, a dead worker's queue items are
+* requeued not orphaned, and results stream back so output lands incrementally.
+*/
+async function runPool(tasks, options, onResult) {
+	const queue = [...tasks];
+	const inFlight = /* @__PURE__ */ new Map();
+	await new Promise((resolve) => {
+		let active = 0;
+		const spawn = () => {
+			const worker = new Worker(options.workerUrl, { workerData: options.workerData });
+			active++;
+			const next = () => {
+				const task = queue.shift();
+				if (task === void 0) {
+					worker.terminate().catch(() => {});
+					active--;
+					if (active === 0) resolve();
+					return;
+				}
+				inFlight.set(worker, task);
+				worker.postMessage(task);
+			};
+			worker.on("message", (message) => {
+				inFlight.delete(worker);
+				onResult(message);
+				next();
+			});
+			worker.on("error", (err) => {
+				const task = inFlight.get(worker);
+				inFlight.delete(worker);
+				if (task) onResult({
+					id: task.id,
+					error: `Worker crashed: ${err.message}`
+				});
+				active--;
+				if (queue.length > 0) spawn();
+				else if (active === 0) resolve();
+			});
+			worker.on("exit", (code) => {
+				const task = inFlight.get(worker);
+				if (task && code !== 0) {
+					inFlight.delete(worker);
+					onResult({
+						id: task.id,
+						error: `Worker exited with code ${code}`
+					});
+					active--;
+					if (queue.length > 0) spawn();
+					else if (active === 0) resolve();
+				}
+			});
+			next();
+		};
+		if (queue.length === 0) {
+			resolve();
+			return;
+		}
+		for (let i = 0; i < Math.min(options.concurrency, queue.length); i++) spawn();
+	});
+}
+//#endregion
+export { runPool };

package/package.json

@@ -1,24 +1,73 @@
 {
-  "name": "@nodecraft/rendermite",
-  "version": "0.0.1",
-  "description": "",
-  "main": "index.js",
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/nodecraft/rendermite.git"
-  },
-  "keywords": [],
-  "author": "James Ross <james@jross.me> (https://jross.me/)",
-  "license": "MIT",
-  "type": "commonjs",
-  "bugs": {
-    "url": "https://github.com/nodecraft/rendermite/issues"
-  },
-  "homepage": "https://github.com/nodecraft/rendermite#readme",
-  "publishConfig": {
-    "access": "restricted"
-  }
+	"name": "@nodecraft/rendermite",
+	"version": "1.0.1",
+	"description": "Minecraft item icon renderer: renders inventory-identical item icons from vanilla and modded assets across game versions, outputting optimized PNG/WebP/AVIF plus CSS and a JSON item library.",
+	"type": "module",
+	"license": "MIT",
+	"author": "James Ross <james@jross.me> (https://jross.me/)",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/nodecraft/rendermite.git"
+	},
+	"homepage": "https://github.com/nodecraft/rendermite#readme",
+	"bugs": {
+		"url": "https://github.com/nodecraft/rendermite/issues"
+	},
+	"keywords": [
+		"minecraft",
+		"icons",
+		"renderer",
+		"resource-pack",
+		"webp",
+		"sprites"
+	],
+	"bin": {
+		"rendermite": "./dist/cli.js"
+	},
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		}
+	},
+	"files": [
+		"dist",
+		"assets"
+	],
+	"publishConfig": {
+		"access": "restricted"
+	},
+	"scripts": {
+		"build": "rimraf dist && tsdown",
+		"lint": "eslint . --fix",
+		"lint:ci": "eslint .",
+		"test": "vitest run",
+		"test:watch": "vitest",
+		"typecheck": "tsc --noEmit",
+		"semantic-release": "semantic-release"
+	},
+	"engines": {
+		"node": ">=24",
+		"npm": ">=11"
+	},
+	"dependencies": {
+		"lightningcss": "1.33.0",
+		"sharp": "0.35.3",
+		"yauzl": "3.4.0"
+	},
+	"devDependencies": {
+		"@nodecraft/eslint-config": "50.2.0",
+		"@semantic-release/changelog": "7.0.0",
+		"@types/node": "24.13.3",
+		"@types/yauzl": "3.4.0",
+		"@types/yazl": "3.3.1",
+		"eslint": "10.8.0",
+		"rimraf": "6.1.3",
+		"semantic-release": "25.0.9",
+		"tsdown": "0.22.14",
+		"typescript": "6.0.3",
+		"typescript-eslint": "8.66.0",
+		"vitest": "4.1.10",
+		"yazl": "3.3.1"
+	}
 }