minerender 2.1.0-alpha.116 → 2.1.0-alpha.117

package/dist/browser/index.d.mts

@@ -1346,6 +1346,7 @@ interface MineRenderDataManifest {
 interface ResolvedMineRenderData {
     requestedVersion: string;
     version: string;
+    /** Registry lookup root. Rootless requests still allow registered sources to override this URL. */
     root: string;
     manifest: MineRenderDataManifest;
 }
@@ -1355,7 +1356,8 @@ declare class MineRenderData {
     static get<K extends keyof MineRenderDatasets>(dataset: K, root?: string): Promise<MineRenderDatasets[K]>;
     /**
      * Uses the exact version when published. Otherwise, selects the nearest patch in the same
-     * release line (older on ties), then the latest earlier release. Unpublished snapshots reject.
+     * release line (older on ties), then the latest earlier release or the oldest published release.
+     * Unpublished snapshots reject.
      */
     static resolve(root?: string): Promise<ResolvedMineRenderData>;
     private static manifest;
@@ -1392,7 +1394,6 @@ declare class Models {
     static componentValue(components: Record<string, unknown>, id: string): unknown;
     private static snapshotContext;
     private static applyDefaults;
-    private static sourceCheck;
     private static contextKey;
     private static snapshotJson;
     private static propertyValue;
@@ -3622,7 +3623,6 @@ declare class AnvilParser {
      * @returns The chunk with absolute coordinates, or `undefined` if the region has no chunk there.
      */
     static parseChunk(data: RegionInput, localX: number, localZ: number, options?: AnvilParseOptions): Promise<AnvilChunk | undefined>;
-    private static assetGuard;
     /**
      * Decodes one chunk from an `entities/r.x.z.mca` file without migrating its NBT.
      * @param localX - Chunk x within the region, from 0 to 31.

package/dist/browser/index.d.ts

@@ -1346,6 +1346,7 @@ interface MineRenderDataManifest {
 interface ResolvedMineRenderData {
     requestedVersion: string;
     version: string;
+    /** Registry lookup root. Rootless requests still allow registered sources to override this URL. */
     root: string;
     manifest: MineRenderDataManifest;
 }
@@ -1355,7 +1356,8 @@ declare class MineRenderData {
     static get<K extends keyof MineRenderDatasets>(dataset: K, root?: string): Promise<MineRenderDatasets[K]>;
     /**
      * Uses the exact version when published. Otherwise, selects the nearest patch in the same
-     * release line (older on ties), then the latest earlier release. Unpublished snapshots reject.
+     * release line (older on ties), then the latest earlier release or the oldest published release.
+     * Unpublished snapshots reject.
      */
     static resolve(root?: string): Promise<ResolvedMineRenderData>;
     private static manifest;
@@ -1392,7 +1394,6 @@ declare class Models {
     static componentValue(components: Record<string, unknown>, id: string): unknown;
     private static snapshotContext;
     private static applyDefaults;
-    private static sourceCheck;
     private static contextKey;
     private static snapshotJson;
     private static propertyValue;
@@ -3622,7 +3623,6 @@ declare class AnvilParser {
      * @returns The chunk with absolute coordinates, or `undefined` if the region has no chunk there.
      */
     static parseChunk(data: RegionInput, localX: number, localZ: number, options?: AnvilParseOptions): Promise<AnvilChunk | undefined>;
-    private static assetGuard;
     /**
      * Decodes one chunk from an `entities/r.x.z.mca` file without migrating its NBT.
      * @param localX - Chunk x within the region, from 0 to 31.

package/dist/browser/index.js

@@ -1607,7 +1607,8 @@ var init_MineRenderData = __esm({
       }
       /**
        * Uses the exact version when published. Otherwise, selects the nearest patch in the same
-       * release line (older on ties), then the latest earlier release. Unpublished snapshots reject.
+       * release line (older on ties), then the latest earlier release or the oldest published release.
+       * Unpublished snapshots reject.
        */
       static async resolve(root) {
         const requestRoot = root?.replace(/\/+$/, "");
@@ -1616,11 +1617,11 @@ var init_MineRenderData = __esm({
         const scope = AssetLoader.persistentScope;
         return this.cached(`resolve:${requestRoot === void 0 ? "sources" : "explicit"}:${root}`, scope, defaultRoot, async () => {
           const requestedVersion = root.slice(root.lastIndexOf("/") + 1);
-          let manifest = await this.manifest(root, release(requestedVersion) ? requestedVersion : void 0, requestRoot);
+          let manifest = await this.manifest(root, requestRoot !== void 0 && release(requestedVersion) ? requestedVersion : void 0, requestRoot);
           if (manifest) return { requestedVersion, version: manifest.minecraftVersion, root, manifest };
           const requested = release(requestedVersion);
-          if (!requested || compare(requested, [1, 16, 5]) < 0) {
-            throw new Error(`No MineRender data is published for ${requestedVersion}; automatic fallback requires a release from 1.16.5 onward`);
+          if (!requested) {
+            throw new Error(`No MineRender data is published for ${requestedVersion}; automatic fallback requires a release`);
           }
           const base = root.slice(0, root.lastIndexOf("/"));
           const index = await this.cached(`versions:${base}`, scope, defaultRoot, async () => {
@@ -1630,9 +1631,9 @@ var init_MineRenderData = __esm({
             }
             return value.versions;
           });
-          const versions = index.map((entry) => ({ name: entry.name, number: release(entry.name) })).filter((entry) => !!entry.number && compare(entry.number, [1, 16, 5]) >= 0).sort((left, right) => compare(left.number, right.number));
+          const versions = index.map((entry) => ({ name: entry.name, number: release(entry.name) })).filter((entry) => !!entry.number).sort((left, right) => compare(left.number, right.number));
           const sameLine = versions.filter((entry) => entry.number[0] === requested[0] && entry.number[1] === requested[1]);
-          const selected = sameLine.sort((left, right) => Math.abs((left.number[2] ?? 0) - (requested[2] ?? 0)) - Math.abs((right.number[2] ?? 0) - (requested[2] ?? 0)) || compare(left.number, right.number))[0] ?? versions.filter((entry) => compare(entry.number, requested) <= 0).pop();
+          const selected = sameLine.sort((left, right) => Math.abs((left.number[2] ?? 0) - (requested[2] ?? 0)) - Math.abs((right.number[2] ?? 0) - (requested[2] ?? 0)) || compare(left.number, right.number))[0] ?? versions.filter((entry) => compare(entry.number, requested) <= 0).pop() ?? versions[0];
           if (!selected) throw new Error(`No compatible MineRender data is published for ${requestedVersion}`);
           const resolvedRoot = `${base}/${selected.name}`;
           manifest = await this.manifest(resolvedRoot, selected.name, resolvedRoot);
@@ -1748,12 +1749,7 @@ var init_BannerPatterns = __esm({
       static async getLayers(value, target, root) {
         if (value === void 0) return [];
         if (!Array.isArray(value)) throw new Error("banner_patterns must be an array");
-        const activeRoot = AssetLoader.ROOT, scope = AssetLoader.persistentScope;
-        const checkSources = () => {
-          if (activeRoot !== AssetLoader.ROOT || scope !== AssetLoader.persistentScope) throw new Error("Asset sources changed while loading banner patterns; retry the request");
-        };
         const colors = value.length ? await this.getColors(root) : void 0;
-        checkSources();
         return Promise.all(value.slice(0, 16).map(async (layer) => {
           if (!layer || typeof layer !== "object" || Array.isArray(layer)) throw new Error("Each banner pattern requires a pattern and dye color");
           if (typeof layer.color !== "string" || !Object.prototype.hasOwnProperty.call(colors, layer.color)) throw new Error(`Unsupported dye color ${layer.color}`);
@@ -1763,7 +1759,6 @@ var init_BannerPatterns = __esm({
             const id = this.identifier(pattern2);
             const key = new AssetKey(id.namespace, id.getFullPath(), "banner_pattern", void 0, "data", ".json", root);
             pattern2 = await Caching.bannerPatternCache.get(key.serialize(), () => AssetLoader.get(key, "json" /* JSON */));
-            checkSources();
             if (!pattern2) throw new Error(`Missing banner pattern ${layer.pattern}`);
           }
           if (!pattern2 || typeof pattern2 !== "object" || Array.isArray(pattern2) || typeof pattern2.translation_key !== "string") throw new Error("Banner patterns require asset_id and translation_key");
@@ -2048,30 +2043,24 @@ var init_Models = __esm({
         }).then((r) => r?.files ?? []);
       }
       static async loadAndMerge(key, context = {}) {
-        const checkSources = this.sourceCheck();
         const model = key.type === "item" ? await this.getItemModel(key, context) : await this.getRaw(key);
         if (!model) {
           return void 0;
         }
         const merged = await ModelMerger.mergeWithParents(model);
-        checkSources();
         return merged;
       }
       static async getItemModel(key, context = {}) {
-        const checkSources = this.sourceCheck();
         const preview = this.snapshotContext(key, context);
         const dataKey = await this.applyDefaults(key, preview);
-        checkSources();
         return this.getPreparedItemModel(key, preview, dataKey);
       }
       static async getPreparedItemModel(key, preview, dataKey) {
-        const checkSources = this.sourceCheck();
         const itemId = `${key.namespace}:${key.path}`;
         const itemKey2 = new AssetKey(key.namespace, key.path, "items", void 0, key.rootType, ".json", key.root);
         const cacheKey = itemKey2.serialize() + this.contextKey(preview) + dataKey;
         const model = await this.PERSISTENT_CACHE.getOrLoad(`${this.ITEM_CACHE_VERSION}:${AssetLoader.persistentKey(cacheKey)}`, async () => {
           const result = await AssetLoader.getFirst([itemKey2, key], "json" /* JSON */);
-          checkSources();
           if (!result) return void 0;
           if (result.key.assetType !== "items") return { ...result.asset, key, itemId, components: preview.components };
           const load = async (selected) => {
@@ -2090,10 +2079,8 @@ var init_Models = __esm({
             return { ...model3, itemId, components: preview.components, ...selected.special && { special: selected.special }, ...selected.tints && { tints: selected.tints } };
           };
           const model2 = await load(this.selectItemModel(result.asset.model, key, preview));
-          checkSources();
           return model2;
         });
-        checkSources();
         const restore = (model2) => ({
           ...model2,
           key: Object.assign(new AssetKey("", ""), model2.key),
@@ -2157,22 +2144,14 @@ var init_Models = __esm({
       }
       static async applyDefaults(key, preview) {
         if (key.type !== "item") return "";
-        const root = AssetLoader.ROOT, scope = AssetLoader.persistentScope;
         const resolved = await MineRenderData.resolve(key.root);
         const defaults = await ItemDefaults.get(`${key.namespace}:${key.path}`, key.root);
         preview.components = { ...defaults, ...preview.components };
         if (resolved.manifest.dataVersion < 3337 && key.namespace === DEFAULT_NAMESPACE && ["potion", "splash_potion", "lingering_potion"].includes(key.path) && !Object.prototype.hasOwnProperty.call(preview.components, "minecraft:enchantment_glint_override") && await ItemTints.hasPotionEffects(preview.components["minecraft:potion_contents"], key.root)) {
           preview.components["minecraft:enchantment_glint_override"] = true;
         }
-        if (AssetLoader.ROOT !== root || AssetLoader.persistentScope !== scope) throw new Error("Asset sources changed while loading item defaults; retry the request");
         return `|data:${resolved.root}:${resolved.manifest.datasets.itemDefaults?.sha256}:${resolved.manifest.datasets.potionColors?.sha256}`;
       }
-      static sourceCheck() {
-        const root = AssetLoader.ROOT, scope = AssetLoader.persistentScope;
-        return () => {
-          if (AssetLoader.ROOT !== root || AssetLoader.persistentScope !== scope) throw new Error("Asset sources changed while loading item models; retry the request");
-        };
-      }
       static contextKey(context) {
         const itemReferences = Object.fromEntries(Object.entries(context.itemReferences).map(([id, key]) => [id, key.serialize()]));
         return `|${this.ITEM_CACHE_VERSION}:${JSON.stringify(this.snapshotJson({ ...context, itemReferences }))}`;
@@ -2359,7 +2338,6 @@ var init_Models = __esm({
        * @param key - Model key, for example `AssetKey.parse("models", "minecraft:item/diamond_sword")`.
        */
       static async getMerged(key, context = {}) {
-        const checkSources = this.sourceCheck();
         if (!key.assetType) {
           key.assetType = "models";
         }
@@ -2368,15 +2346,12 @@ var init_Models = __esm({
         }
         const preview = this.snapshotContext(key, context);
         const dataKey = await this.applyDefaults(key, preview);
-        checkSources();
         const keyStr = AssetLoader.persistentKey(key.serialize() + (key.type === "item" ? this.contextKey(preview) + dataKey : ""));
         const model = await Caching.mergedModelCache.get(keyStr, async () => {
           const raw = key.type === "item" ? await this.getPreparedItemModel(key, preview, dataKey) : await this.getRaw(key);
           const merged = raw ? await ModelMerger.mergeWithParents(raw) : void 0;
-          checkSources();
           return merged;
         });
-        checkSources();
         return model;
       }
       /** Alias for {@link getMerged}. */
@@ -12531,7 +12506,6 @@ init_AssetKey();
 init_ModelCulling();
 init_FluidGeometry();
 init_MineRenderData();
-init_AssetLoader();
 init_Entities();
 var _BlockObject = class _BlockObject extends SceneObject {
   constructor(blockState3, options) {
@@ -12556,19 +12530,12 @@ var _BlockObject = class _BlockObject extends SceneObject {
     this.biomePosition = options?.biomePosition ? [...options.biomePosition] : void 0;
   }
   async init() {
-    const root = AssetLoader.ROOT, scope = AssetLoader.persistentScope;
-    const checkSources = () => {
-      if (root !== AssetLoader.ROOT || scope !== AssetLoader.persistentScope) throw new Error("Asset sources changed while loading a block; retry the request");
-    };
     this._fluidRules = await MineRenderData.get("fluids", this.blockState.key?.root);
-    checkSources();
     if (this.options.applyDefaultState) {
       this._setState(await BlockStateResolver.defaults(this.blockState));
-      checkSources();
     }
     if (this.options.initialState !== void 0) this._setState(this.options.initialState);
     await this.recreateModels();
-    checkSources();
   }
   dispose() {
     this.clearModels();
@@ -16483,7 +16450,6 @@ init_util2();
 // src/world/AnvilParser.ts
 init_MineRenderError();
 init_MineRenderData();
-init_AssetLoader();
 init_NBTHelper();
 
 // src/world/ChunkData.ts
@@ -16754,14 +16720,12 @@ var AnvilParser = class {
   /** Decodes all stored chunks. Gzip, zlib, LZ4, and uncompressed payloads are supported. */
   static async parse(data, options = {}) {
     options = { ...options };
-    const checkSources = this.assetGuard();
     options.signal?.throwIfAborted();
     const bytes = this.bytes(data);
     const chunks = [];
     for (const location of this.locations(bytes)) {
       chunks.push(await this.abortable(this.readChunk(bytes, location, options), options.signal));
     }
-    checkSources();
     return { chunks };
   }
   /**
@@ -16772,22 +16736,12 @@ var AnvilParser = class {
    */
   static async parseChunk(data, localX, localZ, options = {}) {
     options = { ...options };
-    const checkSources = this.assetGuard();
     options.signal?.throwIfAborted();
     const bytes = this.bytes(data);
     const location = this.location(bytes, localX, localZ);
     const chunk = location ? await this.abortable(this.readChunk(bytes, location, options), options.signal) : void 0;
-    checkSources();
     return chunk;
   }
-  static assetGuard() {
-    const root = AssetLoader.ROOT, scope = AssetLoader.persistentScope;
-    return () => {
-      if (AssetLoader.ROOT !== root || AssetLoader.persistentScope !== scope) {
-        throw new MineRenderError("Asset sources changed while parsing Anvil data; retry the request");
-      }
-    };
-  }
   /**
    * Decodes one chunk from an `entities/r.x.z.mca` file without migrating its NBT.
    * @param localX - Chunk x within the region, from 0 to 31.
@@ -17508,7 +17462,6 @@ function resolveSavedEntity(entity) {
 
 // src/world/_entities/WorldEntities.ts
 init_BannerPatterns();
-init_AssetLoader();
 var WorldEntities = class {
   constructor(scene) {
     this.scene = scene;
@@ -17516,10 +17469,6 @@ var WorldEntities = class {
   }
   /** Captures column ownership before asynchronous block or asset loading starts. */
   prepare(entities = [], column) {
-    const root = AssetLoader.ROOT, scope = AssetLoader.persistentScope;
-    const checkSources = () => {
-      if (root !== AssetLoader.ROOT || scope !== AssetLoader.persistentScope) throw new Error("Asset sources changed while loading saved entities; retry the request");
-    };
     const placements = entities.flatMap((entity) => {
       const resolved = resolveSavedEntity(entity);
       if (!resolved) return [];
@@ -17535,17 +17484,13 @@ var WorldEntities = class {
         let object4;
         try {
           if (!current()) return;
-          checkSources();
           const models = await Entities.getEntityList();
-          checkSources();
           if (!models.includes(placement.key.path) || !current()) return;
           const model = await Entities.getEntity(placement.key, placement.texture, { when: placement.when });
-          checkSources();
           if (!model || !current()) return;
           let tints = placement.tints;
           if (placement.woolDye) {
             const dye = (await BannerPatterns.getColors(placement.key.root))[placement.woolDye];
-            checkSources();
             const tint = placement.woolDye === "white" ? 15132390 : Math.floor((dye >> 16 & 255) * 0.75) << 16 | Math.floor((dye >> 8 & 255) * 0.75) << 8 | Math.floor((dye & 255) * 0.75);
             tints = { ...tints, wool_color: tint };
           }
@@ -17555,7 +17500,6 @@ var WorldEntities = class {
           object4.position.fromArray(placement.position).multiplyScalar(16).addScalar(-8);
           object4.rotation.y = placement.yaw;
           await object4.init();
-          checkSources();
           if (!current()) return;
           placement.owner.add(object4);
           this.scene.add(object4);