@nodecraft/rendermite 1.1.4 → 1.2.0

package/dist/{entity-fallback-Cu22uEIK.js → entity-fallback-DNO0Ta9C.js}

@@ -1,5 +1,6 @@
-import { n as ResourceLocator } from "./locator-ycZzh_6z.js";
-import { i as renderModel } from "./renderer-DB1Oe7xs.js";
+import { n as ResourceLocator } from "./locator-COMEtEn9.js";
+import { a as findChestTexture, i as findBedTexture, l as findMobTexture, n as HEAD_LAYOUTS, o as findEntityTexture, r as coversSheet, t as DYE_COLORS, u as tokens } from "./entity-textures-DFRIVdF1.js";
+import { c as renderModel } from "./obj-BEjq3_Ao.js";
 //#region src/render/entity-fallback.ts
 /**
 * Heuristic rendering for mod items that parent `builtin/entity` — chests,
@@ -10,60 +11,6 @@ import { i as renderModel } from "./renderer-DB1Oe7xs.js";
 * chest icon for a chest item beats no icon, but nothing here ever guesses
 * across item kinds.
 */
-/** Tokens too generic to identify a texture on their own. */
-const FILLER_TOKENS = /* @__PURE__ */ new Set([
-	"chest",
-	"chests",
-	"crate",
-	"crates",
-	"trapped",
-	"big",
-	"small",
-	"the",
-	"of"
-]);
-/** Double-chest halves, lid states, boat sheets, seasonal skins — never icon textures. */
-const SKIP_TOKENS = /* @__PURE__ */ new Set([
-	"left",
-	"right",
-	"open",
-	"opened",
-	"christmas",
-	"boat",
-	"raft",
-	"minecart"
-]);
-function tokens(name) {
-	return name.split(/[./_]/).filter((token) => token.length > 1);
-}
-/**
-* Find the mod's own chest sheet for a chest-like item by token overlap over
-* the FULL texture path — mods keep variant sheets in per-wood directories
-* (quark's `quark_variant_chests/acacia/normal.png`), not just under entity/.
-*/
-async function findChestTexture(resources, namespace, itemName) {
-	const wanted = tokens(itemName).filter((token) => !FILLER_TOKENS.has(token));
-	const wantTrapped = itemName.includes("trapped");
-	let best = null;
-	let bestScore = 0;
-	let bestNoise = Infinity;
-	for (const locator of await resources.listResources("texture", namespace)) {
-		if (!locator.path.includes("chest") && !locator.path.includes("crate")) continue;
-		const candidate = tokens(locator.path);
-		if (candidate.some((token) => SKIP_TOKENS.has(token))) continue;
-		if (wantTrapped !== (candidate.includes("trapped") || candidate.includes("trap"))) continue;
-		let score = 0;
-		for (const token of wanted) if (candidate.includes(token)) score++;
-		if (locator.path.endsWith(`/${itemName}`) || locator.path.endsWith(`/${itemName}_0`)) score++;
-		if (wanted.length > 0 && score === 0) continue;
-		if (best === null || score > bestScore || score === bestScore && candidate.length < bestNoise) {
-			best = locator;
-			bestScore = score;
-			bestNoise = candidate.length;
-		}
-	}
-	return best;
-}
 /**
 * An item's English display name, slugified, or null. Mods do not always put the
 * kind in the id — lootr's Loot Chest is `lootr_inventory` — and the lang file is
@@ -95,74 +42,7 @@ const WHITE_BANNER = {
 	g: 252 / 255,
 	b: 251 / 255
 };
-/** Vanilla DyeColor diffuse colors, keyed by the dye name mods prefix with. */
-const DYE_COLORS = {
-	white: 16383998,
-	orange: 16351261,
-	magenta: 13061821,
-	light_blue: 3847130,
-	yellow: 16701501,
-	lime: 8439583,
-	pink: 15961002,
-	gray: 4673362,
-	light_gray: 10329495,
-	cyan: 1481884,
-	purple: 8991416,
-	blue: 3949738,
-	brown: 8606770,
-	green: 6192150,
-	red: 11546150,
-	black: 1908001
-};
 const DYE_PREFIX = new RegExp(`^(${Object.keys(DYE_COLORS).join("|")})_(.+)$`);
-/** Skin sheet sizes the mobheads pack has base geometry for. */
-const HEAD_LAYOUTS = {
-	"64x32": "head_64_32",
-	"64x64": "head_64_64",
-	"32x32": "head_32_32"
-};
-/**
-* The entity sheet for a mob, preferring a file named exactly after it. Sheets
-* live at entity/<mob>.png or entity/<mob>/<mob>.png depending on the mod, and a
-* head only ever wants the base skin — never a blink or armour overlay.
-*/
-async function findMobTexture(resources, namespace, mob) {
-	for (const source of [namespace, "minecraft"]) {
-		for (const candidate of [`entity/${mob}`, `entity/${mob}/${mob}`]) {
-			const locator = new ResourceLocator(source, candidate);
-			if (await resources.hasResource("texture", locator)) return locator;
-		}
-		let best = null;
-		for (const locator of await resources.listResources("texture", source)) {
-			const leaf = locator.path.split("/").pop();
-			if (!locator.path.startsWith("entity/") || leaf !== mob) continue;
-			if (best === null || locator.path.length < best.path.length) best = locator;
-		}
-		if (best) return best;
-	}
-	return null;
-}
-/** Find a full modded bed entity sheet, preferring every distinguishing item-name token. */
-async function findBedTexture(resources, namespace, itemName) {
-	const wanted = tokens(itemName).filter((token) => token !== "bed");
-	const hasDye = wanted.some((token) => Object.hasOwn(DYE_COLORS, token));
-	let best = null;
-	let bestScore = 0;
-	let bestNoise = Infinity;
-	for (const locator of await resources.listResources("texture", namespace)) {
-		if (!locator.path.startsWith("entity/") || !locator.path.includes("bed")) continue;
-		const candidate = tokens(locator.path);
-		let score = hasDye ? 0 : candidate.includes("undyed") ? 1 : 0;
-		for (const token of wanted) if (candidate.includes(token)) score++;
-		if (score === 0) continue;
-		if (best === null || score > bestScore || score === bestScore && candidate.length < bestNoise) {
-			best = locator;
-			bestScore = score;
-			bestNoise = candidate.length;
-		}
-	}
-	return best;
-}
 /** The dye name a `<dye>_<thing>` mod item is prefixed with, or null. */
 function dyeVariantName(id) {
 	const locator = ResourceLocator.tryParse(id);
@@ -394,38 +274,6 @@ async function renderEntityFallback(id, models, textures, resources, options) {
 	return null;
 }
 /**
-* Whether a sheet is a whole skin rather than an overlay. Vanilla's shulker
-* covers 44% of its sheet; a tier trim covers under 5%.
-*/
-async function coversSheet(textures, locator) {
-	const texture = await textures.load(locator).catch(() => null);
-	if (!texture) return false;
-	let opaque = 0;
-	for (let offset = 3; offset < texture.data.length; offset += 4) if (texture.data[offset] > 16) opaque++;
-	return opaque / (texture.width * texture.height) > .2;
-}
-/**
-* A mod's entity sheet for a kind, preferring the one its item name points at.
-* Not restricted to `entity/`: lootr files its whole-skin sheets straight under
-* `textures/` (`lootr:shulker`), and the caller gates on coverage anyway.
-*/
-async function findEntityTexture(resources, namespace, itemName, kind) {
-	const wanted = tokens(itemName).filter((token) => token !== kind && token !== "box");
-	let best = null;
-	let bestScore = -1;
-	for (const locator of await resources.listResources("texture", namespace)) {
-		if (!locator.path.includes(kind)) continue;
-		const candidate = tokens(locator.path);
-		let score = locator.path.startsWith("entity/") ? 1 : 0;
-		for (const token of wanted) if (candidate.includes(token)) score += 2;
-		if (score > bestScore) {
-			best = locator;
-			bestScore = score;
-		}
-	}
-	return best;
-}
-/**
 * A trident's entity sheet. Vanilla's is `entity/trident` (32×32) and mods
 * that reuse the vanilla model ship the same path under their own namespace;
 * a mod that names its sheet after the item instead (an `iron_trident` with

package/dist/entity-textures-DFRIVdF1.js

@@ -0,0 +1,209 @@
+import { n as ResourceLocator } from "./locator-COMEtEn9.js";
+//#region src/resources/entity-textures.ts
+/**
+* Finding a mod's own entity sheet for a thing the game draws in Java.
+*
+* A chest, a mob head, a bed or a shulker box carries no texture in its model,
+* and mods put theirs wherever they like: quark nests variant chests under
+* `quark_variant_chests/acacia/normal`, lootr files whole skins straight under
+* `textures/`. So the sheet is searched for by token overlap with the block or
+* item name rather than assumed from a path.
+*
+* Shared by the icon renderer's `builtin/entity` fallback and the block pack's
+* substitution table, which are the same problem seen from two directions.
+*/
+/** Tokens too generic to identify a texture on their own. */
+const FILLER_TOKENS = /* @__PURE__ */ new Set([
+	"chest",
+	"chests",
+	"crate",
+	"crates",
+	"trapped",
+	"big",
+	"small",
+	"the",
+	"of"
+]);
+/** Double-chest halves, lid states, boat sheets, seasonal skins — never icon textures. */
+const SKIP_TOKENS = /* @__PURE__ */ new Set([
+	"left",
+	"right",
+	"open",
+	"opened",
+	"christmas",
+	"boat",
+	"raft",
+	"minecart"
+]);
+function tokens(name) {
+	return name.split(/[./_]/).filter((token) => token.length > 1);
+}
+/** Vanilla DyeColor diffuse colors, keyed by the dye name mods prefix with. */
+const DYE_COLORS = {
+	white: 16383998,
+	orange: 16351261,
+	magenta: 13061821,
+	light_blue: 3847130,
+	yellow: 16701501,
+	lime: 8439583,
+	pink: 15961002,
+	gray: 4673362,
+	light_gray: 10329495,
+	cyan: 1481884,
+	purple: 8991416,
+	blue: 3949738,
+	brown: 8606770,
+	green: 6192150,
+	red: 11546150,
+	black: 1908001
+};
+/** Skin sheet sizes the mobheads pack has base geometry for. */
+const HEAD_LAYOUTS = {
+	"64x32": "head_64_32",
+	"64x64": "head_64_64",
+	"32x32": "head_32_32"
+};
+/**
+* The entity sheet for a mob, preferring a file named exactly after it. Sheets
+* live at entity/<mob>.png or entity/<mob>/<mob>.png depending on the mod, and a
+* head only ever wants the base skin — never a blink or armour overlay.
+*/
+async function findMobTexture(resources, namespace, mob) {
+	for (const source of [namespace, "minecraft"]) {
+		for (const candidate of [`entity/${mob}`, `entity/${mob}/${mob}`]) {
+			const locator = new ResourceLocator(source, candidate);
+			if (await resources.hasResource("texture", locator)) return locator;
+		}
+		let best = null;
+		for (const locator of await resources.listResources("texture", source)) {
+			const leaf = locator.path.split("/").pop();
+			if (!locator.path.startsWith("entity/") || leaf !== mob) continue;
+			if (best === null || locator.path.length < best.path.length) best = locator;
+		}
+		if (best) return best;
+	}
+	return null;
+}
+/**
+* Find the mod's own chest sheet for a chest-like item by token overlap over
+* the FULL texture path — mods keep variant sheets in per-wood directories
+* (quark's `quark_variant_chests/acacia/normal.png`), not just under entity/.
+*/
+async function findChestTexture(resources, namespace, itemName) {
+	const wanted = tokens(itemName).filter((token) => !FILLER_TOKENS.has(token));
+	const wantTrapped = itemName.includes("trapped");
+	let best = null;
+	let bestScore = 0;
+	let bestNoise = Infinity;
+	for (const locator of await resources.listResources("texture", namespace)) {
+		if (!locator.path.includes("chest") && !locator.path.includes("crate")) continue;
+		const candidate = tokens(locator.path);
+		if (candidate.some((token) => SKIP_TOKENS.has(token))) continue;
+		if (wantTrapped !== (candidate.includes("trapped") || candidate.includes("trap"))) continue;
+		let score = 0;
+		for (const token of wanted) if (candidate.includes(token)) score++;
+		if (locator.path.endsWith(`/${itemName}`) || locator.path.endsWith(`/${itemName}_0`)) score++;
+		if (wanted.length > 0 && score === 0) continue;
+		if (best === null || score > bestScore || score === bestScore && candidate.length < bestNoise) {
+			best = locator;
+			bestScore = score;
+			bestNoise = candidate.length;
+		}
+	}
+	return best;
+}
+/** Find a full modded bed entity sheet, preferring every distinguishing item-name token. */
+async function findBedTexture(resources, namespace, itemName) {
+	const wanted = tokens(itemName).filter((token) => token !== "bed");
+	const hasDye = wanted.some((token) => Object.hasOwn(DYE_COLORS, token));
+	let best = null;
+	let bestScore = 0;
+	let bestNoise = Infinity;
+	for (const locator of await resources.listResources("texture", namespace)) {
+		if (!locator.path.startsWith("entity/") || !locator.path.includes("bed")) continue;
+		const candidate = tokens(locator.path);
+		let score = hasDye ? 0 : candidate.includes("undyed") ? 1 : 0;
+		for (const token of wanted) if (candidate.includes(token)) score++;
+		if (score === 0) continue;
+		if (best === null || score > bestScore || score === bestScore && candidate.length < bestNoise) {
+			best = locator;
+			bestScore = score;
+			bestNoise = candidate.length;
+		}
+	}
+	return best;
+}
+/**
+* Whether a sheet is a whole skin rather than an overlay. Vanilla's shulker
+* covers 44% of its sheet; a tier trim covers under 5%.
+*/
+async function coversSheet(textures, locator) {
+	const texture = await textures.load(locator).catch(() => null);
+	if (!texture) return false;
+	let opaque = 0;
+	for (let offset = 3; offset < texture.data.length; offset += 4) if (texture.data[offset] > 16) opaque++;
+	return opaque / (texture.width * texture.height) > .2;
+}
+/**
+* A mod's entity sheet for a kind, preferring the one its item name points at.
+* Not restricted to `entity/`: lootr files its whole-skin sheets straight under
+* `textures/` (`lootr:shulker`), and the caller gates on coverage anyway.
+*/
+async function findEntityTexture(resources, namespace, itemName, kind) {
+	const wanted = tokens(itemName).filter((token) => token !== kind && token !== "box");
+	let best = null;
+	let bestScore = -1;
+	for (const locator of await resources.listResources("texture", namespace)) {
+		if (!locator.path.includes(kind)) continue;
+		const candidate = tokens(locator.path);
+		let score = locator.path.startsWith("entity/") ? 1 : 0;
+		for (const token of wanted) if (candidate.includes(token)) score += 2;
+		if (score > bestScore) {
+			best = locator;
+			bestScore = score;
+		}
+	}
+	return best;
+}
+/**
+* The still sprite for a fluid block. A fluid's two frames are `<name>_still`
+* and `<name>_flow` by a convention every loader follows, but where they live
+* is up to the mod — Create puts them under `fluid/`, Immersive Engineering
+* under `block/fluid/`, Mekanism under `liquid/` — and the block is named for
+* the fluid with a suffix the mod picks.
+*/
+async function findFluidStill(resources, namespace, blockName) {
+	const wanted = tokens(blockName.replace(/_?(?:fluid|liquid|block|source)$/, "")).filter((token) => token !== "fluid" && token !== "liquid" && token !== "block");
+	if (wanted.length === 0) return null;
+	let best = null;
+	let bestScore = 0;
+	let bestNoise = Infinity;
+	for (const locator of await resources.listResources("texture", namespace)) {
+		if (!locator.path.endsWith("_still")) continue;
+		const candidate = tokens(locator.path.slice(0, -6));
+		const score = wanted.filter((token) => candidate.includes(token)).length;
+		if (score < wanted.length) continue;
+		if (best === null || score > bestScore || score === bestScore && candidate.length < bestNoise) {
+			best = locator;
+			bestScore = score;
+			bestNoise = candidate.length;
+		}
+	}
+	return best;
+}
+/**
+* A sheet filed beside a fluid's still one — its flow frames, or the overlay
+* drawn where it meets a solid face. Vanilla and most mods spell flow `_flow`;
+* some spell it `_flowing`. Only water has an overlay, and deriving it as a
+* sibling is what keeps lava from borrowing water's.
+*/
+async function findFluidSibling(resources, still, suffixes) {
+	const base = still.path.slice(0, -6);
+	for (const suffix of suffixes) {
+		const candidate = new ResourceLocator(still.namespace, base + suffix);
+		if (await resources.hasResource("texture", candidate)) return candidate;
+	}
+	return null;
+}
+//#endregion
+export { findChestTexture as a, findFluidStill as c, findBedTexture as i, findMobTexture as l, HEAD_LAYOUTS as n, findEntityTexture as o, coversSheet as r, findFluidSibling as s, DYE_COLORS as t, tokens as u };

package/dist/export-BIpqNU3H.d.ts

@@ -0,0 +1,44 @@
+import { a as ResourceManager } from "./manager-Cv1NeFyF.js";
+//#region src/blocks/export.d.ts
+interface ExportBlockPackOptions {
+  resources: ResourceManager;
+  /** Directory the pack is written into; the pack *is* the directory. */
+  output: string;
+  /** Recorded in meta.json. One version per pack, immutable once published. */
+  version: string;
+  namespaces?: string[];
+  /**
+   * Path to the vendored builtin pack (`src/builtin.ts`'s `builtinPackPath`).
+   * Layered *under* the input so it only supplies the `renderchest:` and
+   * `mobheads:` namespaces nothing else has, never shadowing a real one. It is
+   * what gives chests, shulker boxes and the rest a shape; without it those
+   * blocks stay empty and are recorded as such.
+   */
+  builtin?: string;
+  /** Edge-extended border per sprite side (default 4). */
+  padding?: number;
+  /** Ceiling on an atlas page's dimensions (default 4096). */
+  maxPageSize?: number;
+  onProgress?: (stage: string, done: number, total: number) => void;
+}
+interface BlockPackFailure {
+  id: string;
+  /**
+   * `intentional` is not a failure: it marks a block that is empty because the
+   * game draws nothing for it. Filter it out to get the real gaps.
+   */
+  kind: 'blockstate' | 'model' | 'texture' | 'sprite' | 'geometry' | 'tint' | 'intentional';
+  reason: string;
+}
+interface BlockPackResult {
+  blocks: number;
+  models: number;
+  sprites: number;
+  pages: number;
+  /** Files actually written — the only trustworthy success signal. */
+  writtenFiles: number;
+  failures: BlockPackFailure[];
+}
+declare function exportBlockPack(options: ExportBlockPackOptions): Promise<BlockPackResult>;
+//#endregion
+export { exportBlockPack as i, BlockPackResult as n, ExportBlockPackOptions as r, BlockPackFailure as t };