@nodecraft/rendermite 1.0.4 → 1.0.6

package/dist/{generators-CCB8h0mP.d.ts → generators-DhRov4RB.d.ts}

@@ -1,4 +1,4 @@
-import { n as MapResourceManager } from "./synthetic-CDsj--li.js";
+import { n as MapResourceManager } from "./synthetic-Qk-BSUXO.js";
 //#region src/dynamic/generators.d.ts
 declare const TRIM_MATERIALS: readonly ["quartz", "iron", "gold", "diamond", "netherite", "redstone", "copper", "emerald", "lapis", "amethyst", "resin"];
 /** Materials with a darker variant used when the trim matches the armor metal. */

package/dist/{geo-u8rndjLA.js → geo-Diky41Tw.js}

@@ -1,8 +1,9 @@
-import { n as ResourceLocator } from "./locator-ycZzh_6z.js";
 import { n as displayMatrix } from "./vector-CCxLae_T.js";
+import { n as ResourceLocator } from "./locator-ycZzh_6z.js";
 import { s as toFloatTexture } from "./blend-CHP2-j9U.js";
-import { t as combineFaceBuffers } from "./compose-qjhyBvnS.js";
-import { n as renderFace, t as faceMaxZ } from "./face-D-N1amV4.js";
+import { t as combineFaceBuffers } from "./compose-CQCb2LVv.js";
+import { i as createFaceBuffer } from "./rasterizer-76qO8TDh.js";
+import { n as renderFace, t as faceMaxZ } from "./face-DmCiHUd5.js";
 import { c as lightsForProfile } from "./lighting--5myudVu.js";
 //#region src/render/geo.ts
 /**
@@ -322,8 +323,10 @@ async function renderGeo(geo, texture, textures, options) {
 	});
 	renderable.sort((a, b) => a.maxZ - b.maxZ);
 	const buffers = [];
+	const scratch = createFaceBuffer(renderSize, renderSize);
+	const shadeCache = /* @__PURE__ */ new WeakMap();
 	for (const face of renderable) {
-		const buffer = renderFace(face, renderSize, renderSize, transformation);
+		const buffer = renderFace(face, renderSize, renderSize, transformation, scratch, shadeCache);
 		if (buffer) buffers.push(buffer);
 	}
 	if (buffers.length === 0) return null;

package/dist/index.d.ts

@@ -1,20 +1,20 @@
 import { n as ResourceLocator, t as InvalidResourceLocatorError } from "./locator-jDbdUeTd.js";
-import { a as ResourceManager, i as ResourceKindName, n as LayeredResourceManager, r as ResourceKind, t as FolderResourceManager } from "./manager-CoZaeQTu.js";
-import { a as TextureMeta, i as TextureLoader, o as TextureResolutionError, r as Texture, t as AnimatedTexture } from "./loader-TFFNV4Jl.js";
-import { d as parseAtlasSources, n as AtlasSource, r as AtlasSourceError, s as ResolvedSprite, t as AtlasResolver, u as createAtlasResolver } from "./sources-DH9dk3KF.js";
-import { s as builtinDynamicResources } from "./generators-CCB8h0mP.js";
-import { a as resolveTexture, n as ModelResolutionError, o as salvageJson, r as ResolvedModel, t as ModelLoader } from "./loader-C-6QN3xv.js";
-import { c as toFloatTexture, s as toByteTexture, t as FloatTexture } from "./blend-Qvrn6YgK.js";
+import { a as ResourceManager, i as ResourceKindName, n as LayeredResourceManager, r as ResourceKind, t as FolderResourceManager } from "./manager-Cv1NeFyF.js";
+import { a as TextureMeta, i as TextureLoader, o as TextureResolutionError, r as Texture, t as AnimatedTexture } from "./loader-Myy22TDL.js";
+import { d as parseAtlasSources, n as AtlasSource, r as AtlasSourceError, s as ResolvedSprite, t as AtlasResolver, u as createAtlasResolver } from "./sources-B9X9w3qP.js";
+import { s as builtinDynamicResources } from "./generators-DhRov4RB.js";
+import { a as resolveTexture, n as ModelResolutionError, o as salvageJson, r as ResolvedModel, t as ModelLoader } from "./loader-D22zZME7.js";
+import { c as toFloatTexture, s as toByteTexture, t as FloatTexture } from "./blend-CyDIxCne.js";
 import { a as LightingProfileName, i as LightingProfile, r as LightSource, u as lightsForProfile } from "./lighting-3FGRC3Af.js";
-import { a as pointResize, i as boxDownscale, n as RenderOptions, o as renderModel, r as RenderedFrames, s as renderModelFrames, t as ItemRenderError } from "./renderer-nbMCw1Pl.js";
+import { a as RenderedFrames, c as renderModel, i as RenderOptions, l as renderModelFrames, o as boxDownscale, r as ItemRenderError, s as pointResize } from "./renderer-DVsZHAvf.js";
 import { c as defaultProperties, i as ItemRenderInstruction, l as evaluateItemModel, n as InvalidItemDefinitionError, o as TintDefinition, r as ItemProperties, s as UNKNOWN_MODEL } from "./definition-BwX6Xxv0.js";
-import { a as resolveItem, i as discoverItems, n as ItemDiscoveryOptions, r as ItemResolutionError, t as DiscoveredItem } from "./discovery-D89pVVJA.js";
-import { a as resolveTint, i as parseTintValue, n as InvalidTinterDefinitionError, o as resolveTints, t as DYE_COLORS } from "./tints-txt-8xI5.js";
-import { i as EncodedIcon, n as EncodeOptions, o as encodeAnimatedIcon, r as EncodedAnimatedIcon, s as encodeIcon, t as AnimatedEncodeOptions } from "./encode-C5kdAm45.js";
+import { a as resolveItem, i as discoverItems, n as ItemDiscoveryOptions, r as ItemResolutionError, t as DiscoveredItem } from "./discovery-wiJBGryo.js";
+import { a as resolveTint, i as parseTintValue, n as InvalidTinterDefinitionError, o as resolveTints, t as DYE_COLORS } from "./tints-DLBExVWN.js";
+import { i as EncodedIcon, n as EncodeOptions, o as encodeAnimatedIcon, r as EncodedAnimatedIcon, s as encodeIcon, t as AnimatedEncodeOptions } from "./encode-DaNQF28M.js";
 import { t as minifyStylesheet } from "./minify-CIV6enbr.js";
-import { a as compareVersions, o as eraForVersion, s as prepareVersionResources } from "./prepare-wfWtaz_X.js";
-import { i as prepareModResources } from "./prepare-DnnGGv9k.js";
+import { a as compareVersions, o as eraForVersion, s as prepareVersionResources } from "./prepare-Cs6QDqie.js";
+import { i as prepareModResources } from "./prepare-CPxO0kKz.js";
 import { i as itemClass, n as StylesheetOptions, r as generateStylesheet, t as ItemStyle } from "./stylesheet-i-t_7sZ7.js";
-import { i as run, n as RunOptions, r as RunResult, t as ItemFailure } from "./run-BlSZw9Qk.js";
-import { n as UnsafeJarError, r as isUnsafeEntryPath, t as JarResourceManager } from "./jar-6T3xdgaL.js";
+import { i as run, n as RunOptions, r as RunResult, t as ItemFailure } from "./run-CKUtynTy.js";
+import { n as UnsafeJarError, r as isUnsafeEntryPath, t as JarResourceManager } from "./jar-CFkA-VgT.js";
 export { type AnimatedEncodeOptions, AnimatedTexture, type AtlasResolver, type AtlasSource, AtlasSourceError, DYE_COLORS, type DiscoveredItem, type EncodeOptions, type EncodedAnimatedIcon, type EncodedIcon, type FloatTexture, FolderResourceManager, InvalidItemDefinitionError, InvalidResourceLocatorError, InvalidTinterDefinitionError, type ItemDiscoveryOptions, type ItemFailure, type ItemProperties, ItemRenderError, type ItemRenderInstruction, ItemResolutionError, type ItemStyle, JarResourceManager, LayeredResourceManager, type LightSource, LightingProfile, type LightingProfileName, ModelLoader, ModelResolutionError, type RenderOptions, type RenderedFrames, type ResolvedModel, type ResolvedSprite, ResourceKind, type ResourceKindName, ResourceLocator, type ResourceManager, type RunOptions, type RunResult, type StylesheetOptions, type Texture, TextureLoader, type TextureMeta, TextureResolutionError, type TintDefinition, UNKNOWN_MODEL, UnsafeJarError, boxDownscale, builtinDynamicResources, compareVersions, createAtlasResolver, defaultProperties, discoverItems, encodeAnimatedIcon, encodeIcon, eraForVersion, evaluateItemModel, generateStylesheet, isUnsafeEntryPath, itemClass, lightsForProfile, minifyStylesheet, parseAtlasSources, parseTintValue, pointResize, prepareModResources, prepareVersionResources, renderModel, renderModelFrames, resolveItem, resolveTexture, resolveTint, resolveTints, run, salvageJson, toByteTexture, toFloatTexture };

package/dist/index.js

@@ -1,20 +1,20 @@
-import { n as ResourceLocator, t as InvalidResourceLocatorError } from "./locator-ycZzh_6z.js";
-import { n as LayeredResourceManager, r as ResourceKind, t as FolderResourceManager } from "./manager-dfI7b9N4.js";
-import { n as UnsafeJarError, r as isUnsafeEntryPath, t as JarResourceManager } from "./jar-Bt3i0ls4.js";
-import { o as createAtlasResolver, s as parseAtlasSources, t as AtlasSourceError } from "./sources-Bxk-WOzH.js";
-import { a as builtinDynamicResources } from "./generators-CcVRG30y.js";
 import { a as defaultProperties, i as UNKNOWN_MODEL, n as InvalidItemDefinitionError, o as evaluateItemModel } from "./definition-3MBm8ar_.js";
-import { n as discoverItems, r as resolveItem, t as ItemResolutionError } from "./discovery-iph0P2F2.js";
-import { a as salvageJson, i as resolveTexture, n as ModelResolutionError, t as ModelLoader } from "./loader-A-BZa8J4.js";
+import { n as ResourceLocator, t as InvalidResourceLocatorError } from "./locator-ycZzh_6z.js";
+import { n as LayeredResourceManager, r as ResourceKind, t as FolderResourceManager } from "./manager-CkletR5K.js";
+import { n as UnsafeJarError, r as isUnsafeEntryPath, t as JarResourceManager } from "./jar-D9z-X7tA.js";
+import { n as discoverItems, r as resolveItem, t as ItemResolutionError } from "./discovery-0SM0cTLw.js";
 import { o as toByteTexture, s as toFloatTexture } from "./blend-CHP2-j9U.js";
-import { n as encodeIcon, t as encodeAnimatedIcon } from "./encode-3u49i-eD.js";
+import { n as encodeIcon, t as encodeAnimatedIcon } from "./encode-D6dQu2dJ.js";
+import { a as builtinDynamicResources } from "./generators-BlG4KmtP.js";
 import { t as minifyStylesheet } from "./minify-bjMRmr5J.js";
 import { n as itemClass, t as generateStylesheet } from "./stylesheet-CovT3B2S.js";
 import { c as lightsForProfile, r as LightingProfile } from "./lighting--5myudVu.js";
-import { a as renderModelFrames, i as renderModel, n as boxDownscale, r as pointResize, t as ItemRenderError } from "./renderer-BeOinVC8.js";
+import { a as salvageJson, i as resolveTexture, n as ModelResolutionError, t as ModelLoader } from "./loader-B8NJO7pR.js";
+import { a as renderModelFrames, i as renderModel, n as boxDownscale, r as pointResize, t as ItemRenderError } from "./renderer-CjT19tHd.js";
 import { a as resolveTints, i as resolveTint, n as InvalidTinterDefinitionError, r as parseTintValue, t as DYE_COLORS } from "./tints-BtbHegpI.js";
-import { n as TextureLoader, r as TextureResolutionError, t as AnimatedTexture } from "./loader-CBzn3Koc.js";
-import { t as run } from "./run-DI-cB38y.js";
-import { a as prepareVersionResources, i as eraForVersion, r as compareVersions } from "./prepare-DROxBZp1.js";
-import { n as prepareModResources } from "./prepare-Bvc5ve2m.js";
+import { o as createAtlasResolver, s as parseAtlasSources, t as AtlasSourceError } from "./sources-Bxk-WOzH.js";
+import { n as TextureLoader, r as TextureResolutionError, t as AnimatedTexture } from "./loader-CfXMxcEV.js";
+import { t as run } from "./run-BnICOF4I.js";
+import { a as prepareVersionResources, i as eraForVersion, r as compareVersions } from "./prepare-Cc8QZ3j0.js";
+import { n as prepareModResources } from "./prepare-BESRrh6K.js";
 export { AnimatedTexture, AtlasSourceError, DYE_COLORS, FolderResourceManager, InvalidItemDefinitionError, InvalidResourceLocatorError, InvalidTinterDefinitionError, ItemRenderError, ItemResolutionError, JarResourceManager, LayeredResourceManager, LightingProfile, ModelLoader, ModelResolutionError, ResourceKind, ResourceLocator, TextureLoader, TextureResolutionError, UNKNOWN_MODEL, UnsafeJarError, boxDownscale, builtinDynamicResources, compareVersions, createAtlasResolver, defaultProperties, discoverItems, encodeAnimatedIcon, encodeIcon, eraForVersion, evaluateItemModel, generateStylesheet, isUnsafeEntryPath, itemClass, lightsForProfile, minifyStylesheet, parseAtlasSources, parseTintValue, pointResize, prepareModResources, prepareVersionResources, renderModel, renderModelFrames, resolveItem, resolveTexture, resolveTint, resolveTints, run, salvageJson, toByteTexture, toFloatTexture };

package/dist/{item-styles-DJ3LWZS2.js → item-styles-upgEO1yP.js}

@@ -1,4 +1,4 @@
-import { i as TRIM_MATERIALS, n as POTTERY_SHERDS, r as TRIM_DARKER_MATERIALS, t as ARMOR_ITEM_TYPES } from "./generators-CcVRG30y.js";
+import { i as TRIM_MATERIALS, n as POTTERY_SHERDS, r as TRIM_DARKER_MATERIALS, t as ARMOR_ITEM_TYPES } from "./generators-BlG4KmtP.js";
 //#region src/output/item-styles.ts
 /**
 * Per-item CSS style classification, ported from upstream's ItemStyleGenerators

package/dist/items/discovery.d.ts

@@ -1,2 +1,2 @@
-import { a as resolveItem, i as discoverItems, n as ItemDiscoveryOptions, r as ItemResolutionError, t as DiscoveredItem } from "../discovery-D89pVVJA.js";
+import { a as resolveItem, i as discoverItems, n as ItemDiscoveryOptions, r as ItemResolutionError, t as DiscoveredItem } from "../discovery-wiJBGryo.js";
 export { DiscoveredItem, ItemDiscoveryOptions, ItemResolutionError, discoverItems, resolveItem };

package/dist/items/discovery.js

@@ -1,2 +1,2 @@
-import { n as discoverItems, r as resolveItem, t as ItemResolutionError } from "../discovery-iph0P2F2.js";
+import { n as discoverItems, r as resolveItem, t as ItemResolutionError } from "../discovery-0SM0cTLw.js";
 export { ItemResolutionError, discoverItems, resolveItem };

package/dist/{jar-6T3xdgaL.d.ts → jar-CFkA-VgT.d.ts}

@@ -1,5 +1,5 @@
 import { n as ResourceLocator } from "./locator-jDbdUeTd.js";
-import { a as ResourceManager, i as ResourceKindName } from "./manager-CoZaeQTu.js";
+import { a as ResourceManager, i as ResourceKindName, s as ResourceDescriptor } from "./manager-Cv1NeFyF.js";
 //#region src/resources/jar.d.ts
 /** Jar entries that could escape the archive get the whole jar rejected. */
 declare function isUnsafeEntryPath(entryPath: string): boolean;
@@ -15,6 +15,7 @@ declare class JarResourceManager implements ResourceManager {
   getAllResources(kind: ResourceKindName, locator: ResourceLocator): Promise<Buffer[]>;
   listResources(kind: ResourceKindName, namespace: string): Promise<ResourceLocator[]>;
   listNamespaces(): Promise<string[]>;
+  describe(): ResourceDescriptor;
   close(): Promise<void>;
 }
 //#endregion

package/dist/{jar-Bt3i0ls4.js → jar-D9z-X7tA.js}

@@ -1,6 +1,6 @@
 import { n as ResourceLocator } from "./locator-ycZzh_6z.js";
-import { r as ResourceKind } from "./manager-dfI7b9N4.js";
-import { open } from "yauzl";
+import { r as ResourceKind } from "./manager-CkletR5K.js";
+import { t as openZip } from "./zip-reader-BSbJKUT1.js";
 //#region src/resources/jar.ts
 /**
 * Reads resources directly out of a jar/zip — no extraction step, unlike the
@@ -19,15 +19,9 @@ var JarResourceManager = class {
 		this.jarPath = jarPath;
 	}
 	getIndex() {
-		this.index ??= new Promise((resolve, reject) => {
-			open(this.jarPath, {
-				lazyEntries: true,
-				autoClose: false
-			}, (err, zip) => {
-				if (err) {
-					reject(err);
-					return;
-				}
+		this.index ??= (async () => {
+			const zip = await openZip(this.jarPath);
+			return new Promise((resolve, reject) => {
 				const entries = /* @__PURE__ */ new Map();
 				const entriesLower = /* @__PURE__ */ new Map();
 				const namespaces = /* @__PURE__ */ new Set();
@@ -55,7 +49,7 @@ var JarResourceManager = class {
 				zip.on("error", reject);
 				zip.readEntry();
 			});
-		});
+		})();
 		return this.index;
 	}
 	entryPath(kind, locator) {
@@ -108,6 +102,12 @@ var JarResourceManager = class {
 	async listNamespaces() {
 		return [...(await this.getIndex()).namespaces].toSorted((left, right) => left.localeCompare(right));
 	}
+	describe() {
+		return {
+			kind: "jar",
+			path: this.jarPath
+		};
+	}
 	async close() {
 		if (this.index) {
 			(await this.index).zip.close();

package/dist/{legacy-reshape-CewShfF3.js → legacy-reshape-C05SfAPR.js}

@@ -1,4 +1,4 @@
-import { n as MapResourceManager } from "./synthetic-DC2bSnGe.js";
+import { n as MapResourceManager } from "./synthetic-ZAUjXT7E.js";
 import { open } from "yauzl";
 import sharp from "sharp";
 //#region src/versions/legacy-reshape.ts

package/dist/{loader-A-BZa8J4.js → loader-B8NJO7pR.js}

@@ -1,4 +1,5 @@
 import { n as ResourceLocator } from "./locator-ycZzh_6z.js";
+import { t as LruCache } from "./cache-Cr2ON3RQ.js";
 //#region src/models/loader.ts
 var ModelResolutionError = class extends Error {};
 const MAX_PARENT_DEPTH = 64;
@@ -248,12 +249,20 @@ function salvageJson(text) {
 	}
 	return null;
 }
+/**
+* Resolved models and their source JSON are small but there are a lot of them:
+* a full modded run walks thousands of namespaces in one process, so the caches
+* are bounded rather than kept for the life of the run.
+*/
+const MAX_CACHED_MODELS = 4096;
 var ModelLoader = class {
 	resources;
-	cache = /* @__PURE__ */ new Map();
-	jsonCache = /* @__PURE__ */ new Map();
-	constructor(resources) {
+	cache;
+	jsonCache;
+	constructor(resources, maxCachedModels = MAX_CACHED_MODELS) {
 		this.resources = resources;
+		this.cache = new LruCache(maxCachedModels);
+		this.jsonCache = new LruCache(maxCachedModels);
 	}
 	readModelJson(locator) {
 		const key = locator.toString();

package/dist/{loader-CBzn3Koc.js → loader-CfXMxcEV.js}

@@ -1,6 +1,10 @@
+import { t as LruCache } from "./cache-Cr2ON3RQ.js";
 import sharp from "sharp";
 //#region src/textures/loader.ts
 var TextureResolutionError = class extends Error {};
+/** Decoded-pixel budget and hard entry cap for one loader's texture cache. */
+const MAX_TEXTURE_CACHE_BYTES = 134217728;
+const MAX_TEXTURE_CACHE_ENTRIES = 8192;
 /**
 * Animation-aware texture access: frame extraction over strips and grids with
 * mcmeta frame lists, per-frame times, and interpolation (upstream semantics:
@@ -42,6 +46,25 @@ var AnimatedTexture = class {
 		}
 		return this.frameCount * frameTime;
 	}
+	/**
+	* Ticks within one cycle at which the displayed frame changes. Used to emit
+	* exactly the frames an animation actually has instead of walking every tick
+	* of a combined timeline that can run to tens of thousands.
+	*/
+	frameStartTicks() {
+		const animation = this.meta?.animation;
+		if (!animation || this.frameCount <= 1) return [0];
+		const frameTime = animation.frametime ?? 1;
+		const frames = animation.frames;
+		if (!frames?.length) return Array.from({ length: this.frameCount }, (_, index) => index * frameTime);
+		const starts = [];
+		let tick = 0;
+		for (const entry of frames) {
+			starts.push(tick);
+			tick += typeof entry === "number" ? frameTime : entry.time ?? frameTime;
+		}
+		return starts;
+	}
 	/** Which physical frame index shows at a tick, and the interpolation factor. */
 	resolveFrame(tick) {
 		const animation = this.meta?.animation;
@@ -107,10 +130,14 @@ var AnimatedTexture = class {
 };
 var TextureLoader = class {
 	resources;
-	cache = /* @__PURE__ */ new Map();
+	cache;
 	atlas = null;
-	constructor(resources) {
+	constructor(resources, maxCacheBytes = MAX_TEXTURE_CACHE_BYTES) {
 		this.resources = resources;
+		this.cache = new LruCache(MAX_TEXTURE_CACHE_ENTRIES, {
+			maxWeight: maxCacheBytes,
+			weigh: (pending) => pending.bytes ?? 0
+		});
 	}
 	async decode(locator) {
 		let raw = await this.resources.getResource("texture", locator);
@@ -183,11 +210,14 @@ var TextureLoader = class {
 	*/
 	async load(locator) {
 		const key = locator.toString();
-		let pending = this.cache.get(key);
-		if (!pending) {
-			pending = this.decode(locator);
-			this.cache.set(key, pending);
-		}
+		const cached = this.cache.get(key);
+		if (cached) return cached;
+		const pending = this.decode(locator);
+		this.cache.set(key, pending);
+		pending.then((texture) => {
+			Object.assign(pending, { bytes: texture ? texture.data.length : 0 });
+			this.cache.settle(key, pending);
+		}).catch(() => {});
 		return pending;
 	}
 };

package/dist/{loader-C-6QN3xv.d.ts → loader-D22zZME7.d.ts}

@@ -1,5 +1,5 @@
 import { n as ResourceLocator } from "./locator-jDbdUeTd.js";
-import { a as ResourceManager } from "./manager-CoZaeQTu.js";
+import { a as ResourceManager } from "./manager-Cv1NeFyF.js";
 import { c as ModelJson, n as DisplayTransformJson, o as ModelElementJson, t as DisplayPosition } from "./types-COGbtA1t.js";
 //#region src/models/loader.d.ts
 /**
@@ -54,7 +54,7 @@ declare class ModelLoader {
   private readonly resources;
   private readonly cache;
   private readonly jsonCache;
-  constructor(resources: ResourceManager);
+  constructor(resources: ResourceManager, maxCachedModels?: number);
   private readModelJson;
   private loadModelJson;
   private resolve;

package/dist/{loader-TFFNV4Jl.d.ts → loader-Myy22TDL.d.ts}

@@ -1,5 +1,5 @@
 import { n as ResourceLocator } from "./locator-jDbdUeTd.js";
-import { a as ResourceManager } from "./manager-CoZaeQTu.js";
+import { a as ResourceManager } from "./manager-Cv1NeFyF.js";
 //#region src/textures/loader.d.ts
 /** Structural interface for atlas resolvers (avoids a circular module edge). */
 interface AtlasResolverLike {
@@ -48,6 +48,12 @@ declare class AnimatedTexture {
   get interpolated(): boolean;
   /** Total animation length in game ticks (1 for unanimated). */
   get tickLength(): number;
+  /**
+   * Ticks within one cycle at which the displayed frame changes. Used to emit
+   * exactly the frames an animation actually has instead of walking every tick
+   * of a combined timeline that can run to tens of thousands.
+   */
+  frameStartTicks(): number[];
   /** Which physical frame index shows at a tick, and the interpolation factor. */
   resolveFrame(tick: number): {
     frame: number;
@@ -62,7 +68,7 @@ declare class TextureLoader {
   private readonly resources;
   private readonly cache;
   private atlas;
-  constructor(resources: ResourceManager);
+  constructor(resources: ResourceManager, maxCacheBytes?: number);
   private decode;
   private readMeta;
   /**

package/dist/{manager-dfI7b9N4.js → manager-CkletR5K.js}

@@ -1,7 +1,7 @@
 import { n as ResourceLocator } from "./locator-ycZzh_6z.js";
 import path from "node:path";
 import { existsSync } from "node:fs";
-import { readFile, readdir } from "node:fs/promises";
+import { readFile, readdir, stat } from "node:fs/promises";
 //#region src/resources/manager.ts
 /**
 * A category of resource inside a pack, mapping to a directory under
@@ -65,7 +65,11 @@ var FolderResourceManager = class {
 		}
 	}
 	async hasResource(kind, locator) {
-		return await this.getResource(kind, locator) !== null;
+		try {
+			return (await stat(this.resolve(kind, locator))).isFile();
+		} catch {
+			return false;
+		}
 	}
 	async getAllResources(kind, locator) {
 		const resource = await this.getResource(kind, locator);
@@ -102,6 +106,12 @@ var FolderResourceManager = class {
 			throw err;
 		}
 	}
+	describe() {
+		return {
+			kind: "folder",
+			root: this.root
+		};
+	}
 };
 /**
 * Layers several managers; earlier managers win, matching resource-pack precedence.
@@ -145,6 +155,23 @@ var LayeredResourceManager = class {
 		for (const layer of this.layers) for (const namespace of await layer.listNamespaces()) namespaces.add(namespace);
 		return [...namespaces].toSorted((left, right) => left.localeCompare(right));
 	}
+	describe() {
+		const layers = [];
+		for (const layer of this.layers) {
+			const described = describeLayer(layer);
+			if (!described) return null;
+			layers.push(described);
+		}
+		return {
+			kind: "layered",
+			layers
+		};
+	}
 };
+/** Local copy of describeResources, avoiding an import cycle with descriptor.ts. */
+function describeLayer(manager) {
+	const describable = manager;
+	return typeof describable.describe === "function" ? describable.describe() : null;
+}
 //#endregion
 export { LayeredResourceManager as n, ResourceKind as r, FolderResourceManager as t };

package/dist/{manager-CoZaeQTu.d.ts → manager-Cv1NeFyF.d.ts}

@@ -1,4 +1,29 @@
 import { n as ResourceLocator } from "./locator-jDbdUeTd.js";
+//#region src/resources/descriptor.d.ts
+type ResourceDescriptor = {
+  kind: 'folder';
+  root: string;
+} | {
+  kind: 'jar';
+  path: string;
+} | {
+  kind: 'map';
+  entries: Array<[string, Uint8Array]>;
+} | {
+  kind: 'layered';
+  layers: ResourceDescriptor[];
+} | {
+  kind: 'kindFiltered';
+  inner: ResourceDescriptor;
+  kinds: ResourceKindName[];
+};
+/** Managers that can cross a worker boundary implement this. */
+interface DescribableResourceManager extends ResourceManager {
+  describe(): ResourceDescriptor | null;
+}
+declare function describeResources(manager: ResourceManager): ResourceDescriptor | null;
+declare function restoreResources(descriptor: ResourceDescriptor): ResourceManager;
+//#endregion
 //#region src/resources/manager.d.ts
 /**
  * A category of resource inside a pack, mapping to a directory under
@@ -70,6 +95,7 @@ declare class FolderResourceManager implements ResourceManager {
   getAllResources(kind: ResourceKindName, locator: ResourceLocator): Promise<Buffer[]>;
   listResources(kind: ResourceKindName, namespace: string): Promise<ResourceLocator[]>;
   listNamespaces(): Promise<string[]>;
+  describe(): ResourceDescriptor;
 }
 /**
  * Layers several managers; earlier managers win, matching resource-pack precedence.
@@ -83,6 +109,7 @@ declare class LayeredResourceManager implements ResourceManager {
   getAllResources(kind: ResourceKindName, locator: ResourceLocator): Promise<Buffer[]>;
   listResources(kind: ResourceKindName, namespace: string): Promise<ResourceLocator[]>;
   listNamespaces(): Promise<string[]>;
+  describe(): ResourceDescriptor | null;
 }
 //#endregion
-export { ResourceManager as a, ResourceKindName as i, LayeredResourceManager as n, ResourceKind as r, FolderResourceManager as t };
+export { ResourceManager as a, describeResources as c, ResourceKindName as i, restoreResources as l, LayeredResourceManager as n, DescribableResourceManager as o, ResourceKind as r, ResourceDescriptor as s, FolderResourceManager as t };

package/dist/models/loader.d.ts

@@ -1,2 +1,2 @@
-import { a as resolveTexture, i as flattenLoaderModel, n as ModelResolutionError, o as salvageJson, r as ResolvedModel, t as ModelLoader } from "../loader-C-6QN3xv.js";
+import { a as resolveTexture, i as flattenLoaderModel, n as ModelResolutionError, o as salvageJson, r as ResolvedModel, t as ModelLoader } from "../loader-D22zZME7.js";
 export { ModelLoader, ModelResolutionError, ResolvedModel, flattenLoaderModel, resolveTexture, salvageJson };

package/dist/models/loader.js

@@ -1,2 +1,2 @@
-import { a as salvageJson, i as resolveTexture, n as ModelResolutionError, r as flattenLoaderModel, t as ModelLoader } from "../loader-A-BZa8J4.js";
+import { a as salvageJson, i as resolveTexture, n as ModelResolutionError, r as flattenLoaderModel, t as ModelLoader } from "../loader-B8NJO7pR.js";
 export { ModelLoader, ModelResolutionError, flattenLoaderModel, resolveTexture, salvageJson };

package/dist/mods/prepare.d.ts

@@ -1,2 +1,2 @@
-import { i as prepareModResources, n as ModPreparation, r as PrepareModsOptions, t as LOADER_NAMESPACES } from "../prepare-DnnGGv9k.js";
+import { i as prepareModResources, n as ModPreparation, r as PrepareModsOptions, t as LOADER_NAMESPACES } from "../prepare-CPxO0kKz.js";
 export { LOADER_NAMESPACES, ModPreparation, PrepareModsOptions, prepareModResources };

package/dist/mods/prepare.js

@@ -1,2 +1,2 @@
-import { n as prepareModResources, t as LOADER_NAMESPACES } from "../prepare-Bvc5ve2m.js";
+import { n as prepareModResources, t as LOADER_NAMESPACES } from "../prepare-BESRrh6K.js";
 export { LOADER_NAMESPACES, prepareModResources };

package/dist/mods/synthesize.d.ts

@@ -1,5 +1,5 @@
-import { a as ResourceManager } from "../manager-CoZaeQTu.js";
-import { n as MapResourceManager } from "../synthetic-CDsj--li.js";
+import { a as ResourceManager } from "../manager-Cv1NeFyF.js";
+import { n as MapResourceManager } from "../synthetic-Qk-BSUXO.js";
 //#region src/mods/synthesize.d.ts
 interface SynthesisResult {
   models: MapResourceManager;

package/dist/mods/synthesize.js

@@ -1,2 +1,2 @@
-import { t as synthesizeItemModels } from "../synthesize-CRgSEmEp.js";
+import { t as synthesizeItemModels } from "../synthesize-3Q0aaOnK.js";
 export { synthesizeItemModels };

package/dist/mods/tints.d.ts

@@ -0,0 +1,28 @@
+import { a as ResourceManager } from "../manager-Cv1NeFyF.js";
+import { n as MapResourceManager } from "../synthetic-Qk-BSUXO.js";
+//#region src/mods/tints.d.ts
+interface HarvestTintsOptions {
+  /** Assets from 1.21.4+ releases of the same mods, read only for their tints. */
+  donors: ResourceManager;
+  /** The tree being rendered; only items it already models are given overrides. */
+  target: ResourceManager;
+  /** Namespaces to harvest; defaults to every mod namespace the donors declare. */
+  namespaces?: string[];
+}
+interface HarvestedTints {
+  overrides: MapResourceManager;
+  /** Items given a tint override — reported so a harvest is never silent. */
+  harvested: number;
+}
+/**
+ * Copy resolvable tints from a donor's item definitions onto the target's own
+ * item models. Only the static GUI branch of a donor definition is read, and
+ * only when it resolves to a single model: a composite has no one old model to
+ * bind to. Slots the donor leaves to runtime state are held open rather than
+ * dropped, keeping every later tint on the layer it belongs to.
+ */
+declare function harvestTintOverrides(options: HarvestTintsOptions): Promise<HarvestedTints>;
+/** The vendored curated overrides (see assets/mod-tints/README.md). */
+declare function curatedTintOverrides(): ResourceManager;
+//#endregion
+export { HarvestTintsOptions, HarvestedTints, curatedTintOverrides, harvestTintOverrides };

package/dist/mods/tints.js

@@ -0,0 +1,2 @@
+import { n as harvestTintOverrides, t as curatedTintOverrides } from "../tints-B8UJmZMu.js";
+export { curatedTintOverrides, harvestTintOverrides };

package/dist/output/encode.d.ts

@@ -1,2 +1,2 @@
-import { a as RasterAssetFormat, c as encodeRasterAsset, i as EncodedIcon, n as EncodeOptions, o as encodeAnimatedIcon, r as EncodedAnimatedIcon, s as encodeIcon, t as AnimatedEncodeOptions } from "../encode-C5kdAm45.js";
+import { a as RasterAssetFormat, c as encodeRasterAsset, i as EncodedIcon, n as EncodeOptions, o as encodeAnimatedIcon, r as EncodedAnimatedIcon, s as encodeIcon, t as AnimatedEncodeOptions } from "../encode-DaNQF28M.js";
 export { AnimatedEncodeOptions, EncodeOptions, EncodedAnimatedIcon, EncodedIcon, RasterAssetFormat, encodeAnimatedIcon, encodeIcon, encodeRasterAsset };

package/dist/output/encode.js

@@ -1,2 +1,2 @@
-import { n as encodeIcon, r as encodeRasterAsset, t as encodeAnimatedIcon } from "../encode-3u49i-eD.js";
+import { n as encodeIcon, r as encodeRasterAsset, t as encodeAnimatedIcon } from "../encode-D6dQu2dJ.js";
 export { encodeAnimatedIcon, encodeIcon, encodeRasterAsset };

package/dist/output/item-styles.js

@@ -1,2 +1,2 @@
-import { t as classifyItemStyle } from "../item-styles-DJ3LWZS2.js";
+import { t as classifyItemStyle } from "../item-styles-upgEO1yP.js";
 export { classifyItemStyle };