minerender 2.1.0-alpha.143 → 2.1.0-alpha.145

package/README.md

@@ -1,6 +1,6 @@
 # MineRender V2
 
-A TypeScript library for interactive Minecraft skins, models, blocks, entities, and worlds.
+A TypeScript library for interactive Minecraft skins, models, blocks, entities, GUIs, and worlds.
 V2 is in beta. See the [roadmap](https://github.com/InventivetalentDev/MineRender/blob/main/ROADMAP.md) for feature parity and remaining work.
 
 Live examples and usage docs: [beta.minerender.org](https://beta.minerender.org/). API reference: [beta-docs.minerender.org](https://beta-docs.minerender.org/).
@@ -29,6 +29,11 @@ an injected WebGL 2 context or the optional native `gl` backend. See
 
 Requires Node.js 22.12+ or a browser with WebGL 2, Fetch, `AbortSignal.any()`, and `AbortSignal.timeout()`.
 
+The library prints only warnings and errors. To see debug output, call
+`Logging.configure({ level: "debug" })`, or set the `minerender:log` localStorage key
+in a browser or the `MINERENDER_LOG` environment variable in Node. See
+[Logging](https://beta-docs.minerender.org/concepts#logging).
+
 ## Resource-pack ZIPs
 
 Register a browser `File` or `Blob` before loading models or textures:
@@ -123,3 +128,7 @@ Supported object types are `skin`, `block`, `item`, `model`, `entity`, and `gui`
 Positions use model units (16 per block); JSON rotations use radians.
 
 Callers apply the saved camera settings and select the matching asset version.
+
+`encodeSceneDocument` and `decodeSceneDocument` convert a document to and from the compact
+link format used by the editor. To show a scene on another page without bundling the library,
+use the [iframe embed page](https://beta-docs.minerender.org/embeds).

package/dist/browser/esm/env/browser/BrowserEnv.mjs

@@ -1,7 +1,9 @@
 // src/env/browser/BrowserEnv.ts
 import { Env } from "../../Env.mjs";
+import { logger } from "../../util/log.mjs";
 import { BrowserCache } from "./BrowserCache.mjs";
 import { probeImageSize } from "./probeImageSize.mjs";
+var log = logger("BrowserEnv");
 function lazyLocalForage(options) {
   let instance;
   const store = () => instance ?? (instance = import("localforage").then((module) => module.default.createInstance(options)));
@@ -17,7 +19,8 @@ function lazyLocalForage(options) {
   };
 }
 var BrowserEnv = class {
-  constructor() {
+  constructor(options = {}) {
+    this.options = options;
     this.name = "browser";
   }
   createCanvas(width, height) {
@@ -46,14 +49,18 @@ var BrowserEnv = class {
   createWorker(name) {
     if (name !== "section" || typeof Worker === "undefined") return void 0;
     try {
+      const sectionWorker = this.options.sectionWorker;
+      if (typeof sectionWorker === "function") return sectionWorker();
+      if (sectionWorker !== void 0) return new Worker(sectionWorker, { type: "module" });
       return new Worker(new URL("./section.worker.mjs", import.meta.url), { type: "module" });
-    } catch {
+    } catch (error) {
+      log.warn("Could not start the section worker, so sections build on the main thread. Pass sectionWorker to registerBrowserEnv to load it from another URL.", error);
       return void 0;
     }
   }
 };
-function registerBrowserEnv() {
-  const env = new BrowserEnv();
+function registerBrowserEnv(options) {
+  const env = new BrowserEnv(options);
   Env.register(env);
   return env;
 }

package/dist/browser/esm/env/browser/BrowserEnv.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../src/env/browser/BrowserEnv.ts"],"sourcesContent":["import { Env, EnvProvider, ImageSizeInfo } from \"../../Env\";\nimport type { CompatCanvas, CompatImage } from \"../../canvas/CanvasCompat\";\nimport type { PersistentCache } from \"../../cache/PersistentCache\";\nimport { BrowserCache } from \"./BrowserCache\";\nimport { probeImageSize } from \"./probeImageSize\";\n\n/** A LocalForage that imports the library and opens the store on the first call. */\nfunction lazyLocalForage(options: LocalForageOptions): LocalForage {\n    let instance: Promise<LocalForage> | undefined;\n    const store = () => instance ??= import(\"localforage\").then(module => module.default.createInstance(options));\n    return {\n        ready: (...args: Parameters<LocalForage[\"ready\"]>) => store().then(value => value.ready(...args)),\n        getItem: (...args: Parameters<LocalForage[\"getItem\"]>) => store().then(value => value.getItem(...args)),\n        setItem: (...args: Parameters<LocalForage[\"setItem\"]>) => store().then(value => value.setItem(...args)),\n        removeItem: (...args: Parameters<LocalForage[\"removeItem\"]>) => store().then(value => value.removeItem(...args)),\n        clear: (...args: Parameters<LocalForage[\"clear\"]>) => store().then(value => value.clear(...args)),\n        length: (...args: Parameters<LocalForage[\"length\"]>) => store().then(value => value.length(...args)),\n        keys: (...args: Parameters<LocalForage[\"keys\"]>) => store().then(value => value.keys(...args)),\n        iterate: (...args: Parameters<LocalForage[\"iterate\"]>) => store().then(value => value.iterate(...args))\n    } as LocalForage;\n}\n\n/**\n * {@link EnvProvider} backed by the DOM. Uses nothing outside of standard browser APIs and\n * localforage, so it stays free of Node polyfills.\n */\nexport class BrowserEnv implements EnvProvider {\n\n    public readonly name = \"browser\";\n\n    createCanvas(width: number, height: number): CompatCanvas {\n        const canvas = document.createElement(\"canvas\");\n        canvas.width = width;\n        canvas.height = height;\n        return canvas;\n    }\n\n    createImage(width?: number, height?: number): CompatImage {\n        const image = document.createElement(\"img\");\n        image.crossOrigin = \"anonymous\";\n        if (width) image.width = width;\n        if (height) image.height = height;\n        return image;\n    }\n\n    imageSize(data: Uint8Array): ImageSizeInfo {\n        return probeImageSize(data);\n    }\n\n    openCache(name: string, version: number): PersistentCache {\n        return new BrowserCache(lazyLocalForage({\n            // IndexedDB schema upgrades retain records; each cache generation needs its own database.\n            name: name + version,\n            version: version\n        }));\n    }\n\n    createWorker(name: \"section\"): Worker | undefined {\n        if (name !== \"section\" || typeof Worker === \"undefined\") return undefined;\n        try {\n            // Keep the literal URL so bundlers emit the worker file next to the entry.\n            return new Worker(new URL(\"./section.worker.mjs\", import.meta.url), { type: \"module\" });\n        } catch {\n            // No import.meta.url outside ESM, or a cross-origin module worker.\n            return undefined;\n        }\n    }\n\n}\n\n/** Installs the browser provider. The browser package entry calls this automatically. */\nexport function registerBrowserEnv(): BrowserEnv {\n    const env = new BrowserEnv();\n    Env.register(env);\n    return env;\n}\n"],"mappings":";AAAA,SAAS,WAAuC;AAGhD,SAAS,oBAAoB;AAC7B,SAAS,sBAAsB;AAG/B,SAAS,gBAAgB,SAA0C;AAC/D,MAAI;AACJ,QAAM,QAAQ,MAAM,wBAAa,OAAO,aAAa,EAAE,KAAK,YAAU,OAAO,QAAQ,eAAe,OAAO,CAAC;AAC5G,SAAO;AAAA,IACH,OAAO,IAAI,SAA2C,MAAM,EAAE,KAAK,WAAS,MAAM,MAAM,GAAG,IAAI,CAAC;AAAA,IAChG,SAAS,IAAI,SAA6C,MAAM,EAAE,KAAK,WAAS,MAAM,QAAQ,GAAG,IAAI,CAAC;AAAA,IACtG,SAAS,IAAI,SAA6C,MAAM,EAAE,KAAK,WAAS,MAAM,QAAQ,GAAG,IAAI,CAAC;AAAA,IACtG,YAAY,IAAI,SAAgD,MAAM,EAAE,KAAK,WAAS,MAAM,WAAW,GAAG,IAAI,CAAC;AAAA,IAC/G,OAAO,IAAI,SAA2C,MAAM,EAAE,KAAK,WAAS,MAAM,MAAM,GAAG,IAAI,CAAC;AAAA,IAChG,QAAQ,IAAI,SAA4C,MAAM,EAAE,KAAK,WAAS,MAAM,OAAO,GAAG,IAAI,CAAC;AAAA,IACnG,MAAM,IAAI,SAA0C,MAAM,EAAE,KAAK,WAAS,MAAM,KAAK,GAAG,IAAI,CAAC;AAAA,IAC7F,SAAS,IAAI,SAA6C,MAAM,EAAE,KAAK,WAAS,MAAM,QAAQ,GAAG,IAAI,CAAC;AAAA,EAC1G;AACJ;AAMO,IAAM,aAAN,MAAwC;AAAA,EAAxC;AAEH,SAAgB,OAAO;AAAA;AAAA,EAEvB,aAAa,OAAe,QAA8B;AACtD,UAAM,SAAS,SAAS,cAAc,QAAQ;AAC9C,WAAO,QAAQ;AACf,WAAO,SAAS;AAChB,WAAO;AAAA,EACX;AAAA,EAEA,YAAY,OAAgB,QAA8B;AACtD,UAAM,QAAQ,SAAS,cAAc,KAAK;AAC1C,UAAM,cAAc;AACpB,QAAI,MAAO,OAAM,QAAQ;AACzB,QAAI,OAAQ,OAAM,SAAS;AAC3B,WAAO;AAAA,EACX;AAAA,EAEA,UAAU,MAAiC;AACvC,WAAO,eAAe,IAAI;AAAA,EAC9B;AAAA,EAEA,UAAU,MAAc,SAAkC;AACtD,WAAO,IAAI,aAAa,gBAAgB;AAAA;AAAA,MAEpC,MAAM,OAAO;AAAA,MACb;AAAA,IACJ,CAAC,CAAC;AAAA,EACN;AAAA,EAEA,aAAa,MAAqC;AAC9C,QAAI,SAAS,aAAa,OAAO,WAAW,YAAa,QAAO;AAChE,QAAI;AAEA,aAAO,IAAI,OAAO,IAAI,IAAI,wBAAwB,YAAY,GAAG,GAAG,EAAE,MAAM,SAAS,CAAC;AAAA,IAC1F,QAAQ;AAEJ,aAAO;AAAA,IACX;AAAA,EACJ;AAEJ;AAGO,SAAS,qBAAiC;AAC7C,QAAM,MAAM,IAAI,WAAW;AAC3B,MAAI,SAAS,GAAG;AAChB,SAAO;AACX;","names":[]}
+{"version":3,"sources":["../../../../../src/env/browser/BrowserEnv.ts"],"sourcesContent":["import { Env, EnvProvider, ImageSizeInfo } from \"../../Env\";\nimport type { CompatCanvas, CompatImage } from \"../../canvas/CanvasCompat\";\nimport type { PersistentCache } from \"../../cache/PersistentCache\";\nimport { logger } from \"../../util/log\";\nimport { BrowserCache } from \"./BrowserCache\";\nimport { probeImageSize } from \"./probeImageSize\";\n\nconst log = logger(\"BrowserEnv\");\n\n/** Settings for {@link BrowserEnv} and {@link registerBrowserEnv}. */\nexport interface BrowserEnvOptions {\n    /**\n     * Section worker script, as a URL, or a function that creates the worker.\n     * Set it when the bundle has no `import.meta.url`, such as the script-tag build: serve\n     * `minerender/section.worker` from the page's origin and pass its URL.\n     * Register before creating a world; the worker starts on the first section build.\n     */\n    sectionWorker?: string | URL | (() => Worker);\n}\n\n/** A LocalForage that imports the library and opens the store on the first call. */\nfunction lazyLocalForage(options: LocalForageOptions): LocalForage {\n    let instance: Promise<LocalForage> | undefined;\n    const store = () => instance ??= import(\"localforage\").then(module => module.default.createInstance(options));\n    return {\n        ready: (...args: Parameters<LocalForage[\"ready\"]>) => store().then(value => value.ready(...args)),\n        getItem: (...args: Parameters<LocalForage[\"getItem\"]>) => store().then(value => value.getItem(...args)),\n        setItem: (...args: Parameters<LocalForage[\"setItem\"]>) => store().then(value => value.setItem(...args)),\n        removeItem: (...args: Parameters<LocalForage[\"removeItem\"]>) => store().then(value => value.removeItem(...args)),\n        clear: (...args: Parameters<LocalForage[\"clear\"]>) => store().then(value => value.clear(...args)),\n        length: (...args: Parameters<LocalForage[\"length\"]>) => store().then(value => value.length(...args)),\n        keys: (...args: Parameters<LocalForage[\"keys\"]>) => store().then(value => value.keys(...args)),\n        iterate: (...args: Parameters<LocalForage[\"iterate\"]>) => store().then(value => value.iterate(...args))\n    } as LocalForage;\n}\n\n/**\n * {@link EnvProvider} backed by the DOM. Uses nothing outside of standard browser APIs and\n * localforage, so it stays free of Node polyfills.\n */\nexport class BrowserEnv implements EnvProvider {\n\n    public readonly name = \"browser\";\n\n    constructor(public readonly options: BrowserEnvOptions = {}) {}\n\n    createCanvas(width: number, height: number): CompatCanvas {\n        const canvas = document.createElement(\"canvas\");\n        canvas.width = width;\n        canvas.height = height;\n        return canvas;\n    }\n\n    createImage(width?: number, height?: number): CompatImage {\n        const image = document.createElement(\"img\");\n        image.crossOrigin = \"anonymous\";\n        if (width) image.width = width;\n        if (height) image.height = height;\n        return image;\n    }\n\n    imageSize(data: Uint8Array): ImageSizeInfo {\n        return probeImageSize(data);\n    }\n\n    openCache(name: string, version: number): PersistentCache {\n        return new BrowserCache(lazyLocalForage({\n            // IndexedDB schema upgrades retain records; each cache generation needs its own database.\n            name: name + version,\n            version: version\n        }));\n    }\n\n    createWorker(name: \"section\"): Worker | undefined {\n        if (name !== \"section\" || typeof Worker === \"undefined\") return undefined;\n        try {\n            const sectionWorker = this.options.sectionWorker;\n            if (typeof sectionWorker === \"function\") return sectionWorker();\n            if (sectionWorker !== undefined) return new Worker(sectionWorker, { type: \"module\" });\n            // Keep the literal URL so bundlers emit the worker file next to the entry.\n            return new Worker(new URL(\"./section.worker.mjs\", import.meta.url), { type: \"module\" });\n        } catch (error) {\n            log.warn(\"Could not start the section worker, so sections build on the main thread. Pass sectionWorker to registerBrowserEnv to load it from another URL.\", error);\n            return undefined;\n        }\n    }\n\n}\n\n/** Installs the browser provider. The browser package entry calls this automatically. */\nexport function registerBrowserEnv(options?: BrowserEnvOptions): BrowserEnv {\n    const env = new BrowserEnv(options);\n    Env.register(env);\n    return env;\n}\n"],"mappings":";AAAA,SAAS,WAAuC;AAGhD,SAAS,cAAc;AACvB,SAAS,oBAAoB;AAC7B,SAAS,sBAAsB;AAE/B,IAAM,MAAM,OAAO,YAAY;AAc/B,SAAS,gBAAgB,SAA0C;AAC/D,MAAI;AACJ,QAAM,QAAQ,MAAM,wBAAa,OAAO,aAAa,EAAE,KAAK,YAAU,OAAO,QAAQ,eAAe,OAAO,CAAC;AAC5G,SAAO;AAAA,IACH,OAAO,IAAI,SAA2C,MAAM,EAAE,KAAK,WAAS,MAAM,MAAM,GAAG,IAAI,CAAC;AAAA,IAChG,SAAS,IAAI,SAA6C,MAAM,EAAE,KAAK,WAAS,MAAM,QAAQ,GAAG,IAAI,CAAC;AAAA,IACtG,SAAS,IAAI,SAA6C,MAAM,EAAE,KAAK,WAAS,MAAM,QAAQ,GAAG,IAAI,CAAC;AAAA,IACtG,YAAY,IAAI,SAAgD,MAAM,EAAE,KAAK,WAAS,MAAM,WAAW,GAAG,IAAI,CAAC;AAAA,IAC/G,OAAO,IAAI,SAA2C,MAAM,EAAE,KAAK,WAAS,MAAM,MAAM,GAAG,IAAI,CAAC;AAAA,IAChG,QAAQ,IAAI,SAA4C,MAAM,EAAE,KAAK,WAAS,MAAM,OAAO,GAAG,IAAI,CAAC;AAAA,IACnG,MAAM,IAAI,SAA0C,MAAM,EAAE,KAAK,WAAS,MAAM,KAAK,GAAG,IAAI,CAAC;AAAA,IAC7F,SAAS,IAAI,SAA6C,MAAM,EAAE,KAAK,WAAS,MAAM,QAAQ,GAAG,IAAI,CAAC;AAAA,EAC1G;AACJ;AAMO,IAAM,aAAN,MAAwC;AAAA,EAI3C,YAA4B,UAA6B,CAAC,GAAG;AAAjC;AAF5B,SAAgB,OAAO;AAAA,EAEuC;AAAA,EAE9D,aAAa,OAAe,QAA8B;AACtD,UAAM,SAAS,SAAS,cAAc,QAAQ;AAC9C,WAAO,QAAQ;AACf,WAAO,SAAS;AAChB,WAAO;AAAA,EACX;AAAA,EAEA,YAAY,OAAgB,QAA8B;AACtD,UAAM,QAAQ,SAAS,cAAc,KAAK;AAC1C,UAAM,cAAc;AACpB,QAAI,MAAO,OAAM,QAAQ;AACzB,QAAI,OAAQ,OAAM,SAAS;AAC3B,WAAO;AAAA,EACX;AAAA,EAEA,UAAU,MAAiC;AACvC,WAAO,eAAe,IAAI;AAAA,EAC9B;AAAA,EAEA,UAAU,MAAc,SAAkC;AACtD,WAAO,IAAI,aAAa,gBAAgB;AAAA;AAAA,MAEpC,MAAM,OAAO;AAAA,MACb;AAAA,IACJ,CAAC,CAAC;AAAA,EACN;AAAA,EAEA,aAAa,MAAqC;AAC9C,QAAI,SAAS,aAAa,OAAO,WAAW,YAAa,QAAO;AAChE,QAAI;AACA,YAAM,gBAAgB,KAAK,QAAQ;AACnC,UAAI,OAAO,kBAAkB,WAAY,QAAO,cAAc;AAC9D,UAAI,kBAAkB,OAAW,QAAO,IAAI,OAAO,eAAe,EAAE,MAAM,SAAS,CAAC;AAEpF,aAAO,IAAI,OAAO,IAAI,IAAI,wBAAwB,YAAY,GAAG,GAAG,EAAE,MAAM,SAAS,CAAC;AAAA,IAC1F,SAAS,OAAO;AACZ,UAAI,KAAK,mJAAmJ,KAAK;AACjK,aAAO;AAAA,IACX;AAAA,EACJ;AAEJ;AAGO,SAAS,mBAAmB,SAAyC;AACxE,QAAM,MAAM,IAAI,WAAW,OAAO;AAClC,MAAI,SAAS,GAAG;AAChB,SAAO;AACX;","names":[]}

package/dist/browser/esm/index.browser.d.mts

@@ -4022,6 +4022,8 @@ declare class SectionModels {
         pick(position?: Readonly<TripleArray>): SectionMeshTemplate[];
         biomeTint?: boolean;
     } | undefined>;
+    /** Starts loading the state's models and atlases so a later `prepareState` with the same properties finds them loaded. */
+    preload(blockState: BlockState, properties?: BlockStateProperties): Promise<void>;
     private state;
     /** Returns the shared still/flow atlas used by per-block fluid objects. */
     fluidAtlas(kind: FluidKind, root?: string): Promise<TextureAtlas>;
@@ -4136,6 +4138,7 @@ declare class Chunk<SectionMeshing extends boolean = false> {
     /** Replaces every cell from parsed section data. The caller refreshes neighbor culling. */
     placeSection(data: ChunkData): Promise<void>;
     private replaceSection;
+    private createBlockObject;
     private positionAt;
     /** Refreshes saved lighting after adjacent columns load or unload, including columns with only light data. */
     refreshLight(indices?: Iterable<number>): Promise<void>;
@@ -4323,7 +4326,7 @@ declare class MineRenderWorld<SectionMeshing extends boolean = false> {
 interface MineRenderWorldOptions<SectionMeshing extends boolean = boolean> {
     /** Render supported saved mobs at their position and yaw, including supported appearance fields. Defaults to false. */
     renderEntities?: boolean;
-    /** Merge static opaque cubes into section meshes. Merged blocks have no individual object. */
+    /** Merge block models of any shape and fluid surfaces into per-section meshes; block entities keep individual objects. Merged blocks have no individual object. */
     sectionMeshing?: SectionMeshing;
     /** Shade blocks and fluids with saved sky/block light. Missing or invalid data keeps preview brightness. Defaults to false. Requires `sectionMeshing`. */
     savedLighting?: boolean;
@@ -4333,7 +4336,7 @@ interface MineRenderWorldOptions<SectionMeshing extends boolean = boolean> {
     ambientOcclusion?: boolean;
     /** Average neighboring biome colors within this horizontal radius, from 0 to 7 blocks. Defaults to 0 (off). Requires `sectionMeshing`. */
     biomeBlendRadius?: number;
-    /** Maximum width and height of each section atlas page, in pixels. */
+    /** Maximum width and height of each section atlas page, in pixels. Defaults to 2048. */
     maxAtlasSize?: number;
 }
 
@@ -4426,12 +4429,24 @@ declare class WorldStreamer {
     private key;
 }
 
+/** Settings for {@link BrowserEnv} and {@link registerBrowserEnv}. */
+interface BrowserEnvOptions {
+    /**
+     * Section worker script, as a URL, or a function that creates the worker.
+     * Set it when the bundle has no `import.meta.url`, such as the script-tag build: serve
+     * `minerender/section.worker` from the page's origin and pass its URL.
+     * Register before creating a world; the worker starts on the first section build.
+     */
+    sectionWorker?: string | URL | (() => Worker);
+}
 /**
  * {@link EnvProvider} backed by the DOM. Uses nothing outside of standard browser APIs and
  * localforage, so it stays free of Node polyfills.
  */
 declare class BrowserEnv implements EnvProvider {
+    readonly options: BrowserEnvOptions;
     readonly name = "browser";
+    constructor(options?: BrowserEnvOptions);
     createCanvas(width: number, height: number): CompatCanvas;
     createImage(width?: number, height?: number): CompatImage;
     imageSize(data: Uint8Array): ImageSizeInfo;
@@ -4439,7 +4454,7 @@ declare class BrowserEnv implements EnvProvider {
     createWorker(name: "section"): Worker | undefined;
 }
 /** Installs the browser provider. The browser package entry calls this automatically. */
-declare function registerBrowserEnv(): BrowserEnv;
+declare function registerBrowserEnv(options?: BrowserEnvOptions): BrowserEnv;
 
 /**
  * {@link PersistentCache} backed by localforage (IndexedDB / WebSQL / localStorage).
@@ -4469,4 +4484,4 @@ declare class BrowserCache extends PersistentCache<LocalForage> {
  */
 declare function probeImageSize(data: Uint8Array): ImageSizeInfo;
 
-export { AXES, type AnimationFrame, type AnimationMeta, type AnimatorFunction, type AnvilChunk, type AnvilEntityChunk, type AnvilExternalChunkReader, type AnvilParseOptions, AnvilParser, type AnvilRegion, type AnvilRegionReader, AnvilWorldSource, type AnvilWorldSourceOptions, ArchiveAssetSource, type ArchiveAssetSourceOptions, type ArchiveEntry, type ArchiveProxy, AssetKey, AssetLoadError, AssetLoader, AssetParser, AssetSource, type AssetType, Assets, Axis, BUILTIN_ENTITY, BUILTIN_GENERATED, type BannerPattern, type BannerPatternDraw, BannerPatterns, BasicAssetKey, type BasicMinecraftAsset, BatchedExecutor, type BedrockBone, type BedrockCube, type BedrockEntityDescription, type BedrockEntityFile, type BedrockGeometry, type BedrockGeometryFile, type BinaryAsset, type Biome, type BiomeColorKind, Biomes, type BitmapFont, type BitmapGlyph, type Block, BlockEntities, type BlockEntityEntry, type BlockEntityIndex, type BlockEntityPart, type BlockEntityRotation, type BlockFluidState, type BlockInfo, type BlockModel, type BlockModelTextures, BlockObject, type BlockObjectOptions, type BlockState, type BlockStateMultipart, type BlockStateProperties, type BlockStateProperty, type BlockStatePropertyDefaults, type BlockStatePropertyValue, BlockStateResolver, type BlockStateVariant, type BlockStateVariants, BlockStates, BlockTints, type BoxGeometryKey, BrowserArchiveProxy, BrowserCache, BrowserEnv, CUBE_FACES, CUBE_FACE_OFFSETS, type CacheKey, Caching, type CameraOptions, CanvasImage, type CapeLayout, Chunk, ChunkData, Colormaps, type CompatCanvas, type CompatImage, type ComposerOptions, type ControlsMode, type ControlsOptions, CubeFace, CubeFaceIndex, DEFAULT_ELEMENTS, DEFAULT_NAMESPACE, DEFAULT_ROOT, DEFAULT_UV, DISPLAY_POSITIONS, DYE_COLORS, type DebugOptions, type DecoratedPotSide, DecoratedPots, type DeepPartial, DefaultBlockStates, DisplayPosition, DisplayTransforms, type Disposable, type DoubleArray, type DyeColor, ENTITY_ANIMATION_CHANNELS, type ElementFace, type ElementRotation, Entities, type EntityAnimation, type EntityAnimationBone, type EntityAnimationChannel, type EntityAnimationFile, type EntityAnimationKeyframe, type EntityAnimationOptions, EntityAnimationPlayer, type EntityAnimationPose, type EntityLayer, type EntityModel, type EntityModelCube, type EntityModelFile, type EntityModelLayer, type EntityModelOptions, type EntityModelPart, type EntityModelPass, EntityObject, type EntityObjectOptions, type EntityRenderMode, type EntityTransformOp, Env, type EnvProvider, type ExtractableImageData, type FluidKind, FluidModelObject, type FluidQuads, type FluidRules, type FluidSample, type FluidSampler, type FlyAction, FlyControls, type FlyControlsEventMap, Fonts, type FrameCallback, type FromTo, GUI_CONTAINER_LAYOUTS, Geometries, type GuiBookButtonState, type GuiBookOptions, type GuiBossBarColor, type GuiBossBarOptions, type GuiContainerType, GuiHelper, type GuiItemLayer, type GuiLayer, GuiLight, GuiObject, type GuiObjectOptions, type GuiRecipe, type GuiRecipeIngredient, type GuiRecipeOptions, type GuiSpriteScaling, type GuiText, type GuiTextLayer, type GuiTextLayout, type GuiTextOptions, type GuiTextRun, type GuiTextStyle, type GuiTextureLayer, type GuiTooltipOptions, HostedAssetSource, type IModelTextures, ITEM_GENERATED, type ImageInfo, ImageLoader, type ImageSizeInfo, InstanceManager, InstanceReference, type Instanceable, ItemDefaults, ItemGlint, type ItemModel, type ItemModelContext, type ItemModelTextures, type ItemTintColor, type ItemTintSource, ItemTints, type ListAsset, LitematicaParser, type LitematicaRegion, type LitematicaStructure, type LoadedSceneDocument, type LoadedSceneObject, type LogHandler, type LogLevel, type LogThreshold, type Logger, Logging, type LoggingOptions, MapControls, type MaterialKey, Materials, type Maybe, type MeshKey, Meshes, MineRenderData, type MineRenderDataManifest, type MineRenderDatasets, MineRenderError, MineRenderScene, type MineRenderSceneOptions, MineRenderWorld, type MineRenderWorldOptions, type MinecraftAsset, MinecraftCubeTexture, MinecraftFaceUV, type MinecraftTextureMeta, type Model, ModelCulling, type ModelDisplay, type ModelElement, type ModelFaces, ModelGenerator, ModelMerger, ModelObject, type ModelObjectOptions, ModelTextures, Models, type MultiBlockBlock, type MultiBlockEntity, type MultiBlockStructure, type MultipartCondition, type NBTAsset, NBTHelper, OrbitControls, type PackFormat, PackFormats, PackMetadata, PersistentCache, PlayerHeadTextures, type PositionedGuiGlyph, type QuadArray, type RawImageKey, type RenameKind, Renames, type RenderOptions, Renderer, type RendererControls, type RendererFrame, type RendererOptions, type RendererSurface, type RequestConfig, RequestError, type RequestResponse, Requests, type ResolvedBlockEntity, type ResolvedMineRenderData, type ResponseParser, SCENE_DOCUMENT_MAX_BYTES, SKIN_PARTS, type SavedLightSample, type SceneBlockDefinition, type SceneDocument, SceneDocumentLoader, type SceneEntityDefinition, SceneExporter, type SceneGLTFExportOptions, type SceneGuiDefinition, type SceneGuiLayer, SceneInspector, type SceneItemContext, type SceneModelDefinition, SceneObject, type SceneObjectDefinition, type SceneObjectDefinitionBase, type SceneObjectOptions, type SceneSkinDefinition, type SceneSkinPosePart, SceneStats, SceneStatsDisplay, SchematicParser, type SchematicParserOptions, type SectionAtlasSize, type SectionFluidInput, type SectionFluidKind, type SectionFluids, type SectionGeometryInput, type SectionGeometryPage, type SectionLightData, SectionMesh, type SectionMeshEntry, type SectionMeshTemplate, SectionModels, type SectionTemplateData, SectionWorker, type Serializable, type SkinGeometries, SkinImage, SkinObject, type SkinObjectOptions, SkinPart, type SkinTexture, type SkinTextureCoordinates, SkinTextures, Skins, type SpecialItemPart, type SpecialItemRenderer, SpecialItems, SpongeSchematicParser, type StructureNBT, StructureParser, type TextureAsset, TextureAtlas, type TextureKey, TextureLoader, Textures, Ticker, type TickerFunction, TintColors, type Transformable, type TripleArray, UVMapper, type VideoExportOptions, VideoExporter, type WorldBlockIntersection, type WorldChunkSource, type WorldEntityIntersection, WorldStreamer, type WorldStreamerOptions, WrappedImage, addBox3WireframeToObject, addWireframeToMesh, addWireframeToObject, applyElementRotation, applyGenericRotation, axisToVec3, base64decode, base64encode, buildFluidQuads, buildSectionGeometry, capeTextureSizes, captureException, changeEvent, clampRotationDegrees, classicSkinGeometries, classicSkinTextureCoordinates, computeMorphedAttributes, copySectionLight, createCanvas, createFluidGeometry, createGuiTextGeometry, createGuiTextureGeometry, createImage, decodeSceneDocument, encodeSceneDocument, entityAnimationTime, estimateBytesUsed, fluidKindOf, getBlockFluidState, getFluidKind, interleaveAttributes, isAssetKey, isBasicAssetKey, isBlockObject, isDisposable, isDoubleArray, isEntityObject, isFlyControls, isGuiObject, isInstanceManager, isInstanceReference, isInstanceable, isInstancedMesh, isMesh, isMineRenderScene, isModelObject, isObject3D, isOrthographicCamera, isPerspectiveCamera, isQuadArray, isResourceLocation, isSceneObject, isTransformable, isTripleArray, isVector3, layoutGuiText, logger, md5, mergeBufferAttributes, mergeBufferGeometries, mergeVertices, parseSceneDocument, prefix, probeImageSize, registerBrowserEnv, resolveBlockFluidState, resolveLegacyBlock, resolveLegacyBlockState, sampleEntityAnimation, sampleEntityKeyframes, sampleFluid, sampleSectionLight, sectionGeometryTransferables, serializeBoxGeometryKey, serializeImageKey, serializeMaterialKey, serializeMeshKey, serializeTextureKey, sha1, sha256, sha512, shutdown, sleep, slimSkinGeometries, slimSkinTextureCoordinates, timingEnd, timingStart, toDegrees, toRadians, toTrianglesDrawMode, trimCanvas, validateAnimationWeights, yieldToEventLoop };
+export { AXES, type AnimationFrame, type AnimationMeta, type AnimatorFunction, type AnvilChunk, type AnvilEntityChunk, type AnvilExternalChunkReader, type AnvilParseOptions, AnvilParser, type AnvilRegion, type AnvilRegionReader, AnvilWorldSource, type AnvilWorldSourceOptions, ArchiveAssetSource, type ArchiveAssetSourceOptions, type ArchiveEntry, type ArchiveProxy, AssetKey, AssetLoadError, AssetLoader, AssetParser, AssetSource, type AssetType, Assets, Axis, BUILTIN_ENTITY, BUILTIN_GENERATED, type BannerPattern, type BannerPatternDraw, BannerPatterns, BasicAssetKey, type BasicMinecraftAsset, BatchedExecutor, type BedrockBone, type BedrockCube, type BedrockEntityDescription, type BedrockEntityFile, type BedrockGeometry, type BedrockGeometryFile, type BinaryAsset, type Biome, type BiomeColorKind, Biomes, type BitmapFont, type BitmapGlyph, type Block, BlockEntities, type BlockEntityEntry, type BlockEntityIndex, type BlockEntityPart, type BlockEntityRotation, type BlockFluidState, type BlockInfo, type BlockModel, type BlockModelTextures, BlockObject, type BlockObjectOptions, type BlockState, type BlockStateMultipart, type BlockStateProperties, type BlockStateProperty, type BlockStatePropertyDefaults, type BlockStatePropertyValue, BlockStateResolver, type BlockStateVariant, type BlockStateVariants, BlockStates, BlockTints, type BoxGeometryKey, BrowserArchiveProxy, BrowserCache, BrowserEnv, type BrowserEnvOptions, CUBE_FACES, CUBE_FACE_OFFSETS, type CacheKey, Caching, type CameraOptions, CanvasImage, type CapeLayout, Chunk, ChunkData, Colormaps, type CompatCanvas, type CompatImage, type ComposerOptions, type ControlsMode, type ControlsOptions, CubeFace, CubeFaceIndex, DEFAULT_ELEMENTS, DEFAULT_NAMESPACE, DEFAULT_ROOT, DEFAULT_UV, DISPLAY_POSITIONS, DYE_COLORS, type DebugOptions, type DecoratedPotSide, DecoratedPots, type DeepPartial, DefaultBlockStates, DisplayPosition, DisplayTransforms, type Disposable, type DoubleArray, type DyeColor, ENTITY_ANIMATION_CHANNELS, type ElementFace, type ElementRotation, Entities, type EntityAnimation, type EntityAnimationBone, type EntityAnimationChannel, type EntityAnimationFile, type EntityAnimationKeyframe, type EntityAnimationOptions, EntityAnimationPlayer, type EntityAnimationPose, type EntityLayer, type EntityModel, type EntityModelCube, type EntityModelFile, type EntityModelLayer, type EntityModelOptions, type EntityModelPart, type EntityModelPass, EntityObject, type EntityObjectOptions, type EntityRenderMode, type EntityTransformOp, Env, type EnvProvider, type ExtractableImageData, type FluidKind, FluidModelObject, type FluidQuads, type FluidRules, type FluidSample, type FluidSampler, type FlyAction, FlyControls, type FlyControlsEventMap, Fonts, type FrameCallback, type FromTo, GUI_CONTAINER_LAYOUTS, Geometries, type GuiBookButtonState, type GuiBookOptions, type GuiBossBarColor, type GuiBossBarOptions, type GuiContainerType, GuiHelper, type GuiItemLayer, type GuiLayer, GuiLight, GuiObject, type GuiObjectOptions, type GuiRecipe, type GuiRecipeIngredient, type GuiRecipeOptions, type GuiSpriteScaling, type GuiText, type GuiTextLayer, type GuiTextLayout, type GuiTextOptions, type GuiTextRun, type GuiTextStyle, type GuiTextureLayer, type GuiTooltipOptions, HostedAssetSource, type IModelTextures, ITEM_GENERATED, type ImageInfo, ImageLoader, type ImageSizeInfo, InstanceManager, InstanceReference, type Instanceable, ItemDefaults, ItemGlint, type ItemModel, type ItemModelContext, type ItemModelTextures, type ItemTintColor, type ItemTintSource, ItemTints, type ListAsset, LitematicaParser, type LitematicaRegion, type LitematicaStructure, type LoadedSceneDocument, type LoadedSceneObject, type LogHandler, type LogLevel, type LogThreshold, type Logger, Logging, type LoggingOptions, MapControls, type MaterialKey, Materials, type Maybe, type MeshKey, Meshes, MineRenderData, type MineRenderDataManifest, type MineRenderDatasets, MineRenderError, MineRenderScene, type MineRenderSceneOptions, MineRenderWorld, type MineRenderWorldOptions, type MinecraftAsset, MinecraftCubeTexture, MinecraftFaceUV, type MinecraftTextureMeta, type Model, ModelCulling, type ModelDisplay, type ModelElement, type ModelFaces, ModelGenerator, ModelMerger, ModelObject, type ModelObjectOptions, ModelTextures, Models, type MultiBlockBlock, type MultiBlockEntity, type MultiBlockStructure, type MultipartCondition, type NBTAsset, NBTHelper, OrbitControls, type PackFormat, PackFormats, PackMetadata, PersistentCache, PlayerHeadTextures, type PositionedGuiGlyph, type QuadArray, type RawImageKey, type RenameKind, Renames, type RenderOptions, Renderer, type RendererControls, type RendererFrame, type RendererOptions, type RendererSurface, type RequestConfig, RequestError, type RequestResponse, Requests, type ResolvedBlockEntity, type ResolvedMineRenderData, type ResponseParser, SCENE_DOCUMENT_MAX_BYTES, SKIN_PARTS, type SavedLightSample, type SceneBlockDefinition, type SceneDocument, SceneDocumentLoader, type SceneEntityDefinition, SceneExporter, type SceneGLTFExportOptions, type SceneGuiDefinition, type SceneGuiLayer, SceneInspector, type SceneItemContext, type SceneModelDefinition, SceneObject, type SceneObjectDefinition, type SceneObjectDefinitionBase, type SceneObjectOptions, type SceneSkinDefinition, type SceneSkinPosePart, SceneStats, SceneStatsDisplay, SchematicParser, type SchematicParserOptions, type SectionAtlasSize, type SectionFluidInput, type SectionFluidKind, type SectionFluids, type SectionGeometryInput, type SectionGeometryPage, type SectionLightData, SectionMesh, type SectionMeshEntry, type SectionMeshTemplate, SectionModels, type SectionTemplateData, SectionWorker, type Serializable, type SkinGeometries, SkinImage, SkinObject, type SkinObjectOptions, SkinPart, type SkinTexture, type SkinTextureCoordinates, SkinTextures, Skins, type SpecialItemPart, type SpecialItemRenderer, SpecialItems, SpongeSchematicParser, type StructureNBT, StructureParser, type TextureAsset, TextureAtlas, type TextureKey, TextureLoader, Textures, Ticker, type TickerFunction, TintColors, type Transformable, type TripleArray, UVMapper, type VideoExportOptions, VideoExporter, type WorldBlockIntersection, type WorldChunkSource, type WorldEntityIntersection, WorldStreamer, type WorldStreamerOptions, WrappedImage, addBox3WireframeToObject, addWireframeToMesh, addWireframeToObject, applyElementRotation, applyGenericRotation, axisToVec3, base64decode, base64encode, buildFluidQuads, buildSectionGeometry, capeTextureSizes, captureException, changeEvent, clampRotationDegrees, classicSkinGeometries, classicSkinTextureCoordinates, computeMorphedAttributes, copySectionLight, createCanvas, createFluidGeometry, createGuiTextGeometry, createGuiTextureGeometry, createImage, decodeSceneDocument, encodeSceneDocument, entityAnimationTime, estimateBytesUsed, fluidKindOf, getBlockFluidState, getFluidKind, interleaveAttributes, isAssetKey, isBasicAssetKey, isBlockObject, isDisposable, isDoubleArray, isEntityObject, isFlyControls, isGuiObject, isInstanceManager, isInstanceReference, isInstanceable, isInstancedMesh, isMesh, isMineRenderScene, isModelObject, isObject3D, isOrthographicCamera, isPerspectiveCamera, isQuadArray, isResourceLocation, isSceneObject, isTransformable, isTripleArray, isVector3, layoutGuiText, logger, md5, mergeBufferAttributes, mergeBufferGeometries, mergeVertices, parseSceneDocument, prefix, probeImageSize, registerBrowserEnv, resolveBlockFluidState, resolveLegacyBlock, resolveLegacyBlockState, sampleEntityAnimation, sampleEntityKeyframes, sampleFluid, sampleSectionLight, sectionGeometryTransferables, serializeBoxGeometryKey, serializeImageKey, serializeMaterialKey, serializeMeshKey, serializeTextureKey, sha1, sha256, sha512, shutdown, sleep, slimSkinGeometries, slimSkinTextureCoordinates, timingEnd, timingStart, toDegrees, toRadians, toTrianglesDrawMode, trimCanvas, validateAnimationWeights, yieldToEventLoop };

package/dist/browser/esm/index.browser.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/index.browser.ts"],"sourcesContent":["// Browser entry point. Built to dist/browser/ and dist/bundle.js.\n//\n// The register import must stay first: it installs the browser EnvProvider before any other\n// module body runs.\nimport \"./env/browser/register\";\n\nexport * from \"./index\";\nexport { BrowserEnv, registerBrowserEnv } from \"./env/browser/BrowserEnv\";\nexport { BrowserCache } from \"./env/browser/BrowserCache\";\nexport { probeImageSize } from \"./env/browser/probeImageSize\";\n"],"mappings":";AAIA,OAAO;AAEP,cAAc;AACd,SAAS,YAAY,0BAA0B;AAC/C,SAAS,oBAAoB;AAC7B,SAAS,sBAAsB;","names":[]}
+{"version":3,"sources":["../../../src/index.browser.ts"],"sourcesContent":["// Browser entry point. Built to dist/browser/ and dist/bundle.js.\n//\n// The register import must stay first: it installs the browser EnvProvider before any other\n// module body runs.\nimport \"./env/browser/register\";\n\nexport * from \"./index\";\nexport { BrowserEnv, registerBrowserEnv } from \"./env/browser/BrowserEnv\";\nexport type { BrowserEnvOptions } from \"./env/browser/BrowserEnv\";\nexport { BrowserCache } from \"./env/browser/BrowserCache\";\nexport { probeImageSize } from \"./env/browser/probeImageSize\";\n"],"mappings":";AAIA,OAAO;AAEP,cAAc;AACd,SAAS,YAAY,0BAA0B;AAE/C,SAAS,oBAAoB;AAC7B,SAAS,sBAAsB;","names":[]}

package/dist/browser/esm/world/Chunk.mjs

@@ -1,4 +1,5 @@
 // src/world/Chunk.ts
+import { BlockObject } from "../model/block/scene/BlockObject.mjs";
 import { Color, Vector3 } from "three";
 import { ChunkData } from "./ChunkData.mjs";
 import { BlockStates } from "../assets/BlockStates.mjs";
@@ -269,8 +270,10 @@ var Chunk = class _Chunk {
       if (rejected?.status === "rejected") throw rejected.reason;
     }
     const positions = [];
-    let failed = false, failure;
-    for (const { index, key, block } of placements) {
+    const jobs = /* @__PURE__ */ new Map();
+    let failureOrder = Infinity, failure;
+    for (const [order, { index, key, block }] of placements.entries()) {
+      jobs.delete(index);
       this.hiddenBlocks.delete(index);
       this.data.assign(index, this.data.intern(block), block?.nbt);
       const readBlock = this.data.snapshot(index);
@@ -286,7 +289,6 @@ var Chunk = class _Chunk {
         this.z * 16 + Math.floor(index / 16) % 16
       );
       positions.push(worldPos);
-      let object;
       try {
         if (!readBlock) continue;
         const resolved = resolutions.get(key);
@@ -308,7 +310,7 @@ var Chunk = class _Chunk {
           this.sectionBlocks.set(index, templates.map((template) => ({ index, template, cullMask: 0, biomeTint: context?.tint })));
           this.meshDirty = true;
         } else {
-          object = await this.scene.addBlock(blockState, {
+          jobs.set(index, { order, readBlock, blockState, position: MineRenderWorld.worldToScenePosition(worldPos), options: {
             mergeMeshes: true,
             instanceMeshes: true,
             maxInstanceCount: 2e3,
@@ -316,13 +318,12 @@ var Chunk = class _Chunk {
             variantPosition,
             biome: context?.biome,
             biomePosition: this.biomePosition(index, blockState, stored)
-          });
-          object.setPosition(MineRenderWorld.worldToScenePosition(worldPos));
+          } });
+          continue;
         }
         this.renderedBlocks.set(index, { get block() {
           return readBlock();
-        }, object });
-        if (object) this.objectBlocks.add(index);
+        }, object: void 0 });
       } catch (error) {
         if (preserveDataOnFailure && readBlock) {
           this.renderedBlocks.set(index, { get block() {
@@ -330,12 +331,35 @@ var Chunk = class _Chunk {
           }, object: void 0 });
         } else this.data.assign(index, 0);
         this.fluidCells[index] = 0;
-        object?.removeFromScene();
-        if (!failed) failure = error;
-        failed = true;
+        if (order < failureOrder) {
+          failureOrder = order;
+          failure = error;
+        }
       }
     }
-    if (failed) throw failure;
+    const pending = [...jobs];
+    const objects = await Promise.allSettled(pending.map(([, job]) => this.createBlockObject(job.blockState, job.position, job.options)));
+    for (const [i, [index, { order, readBlock }]] of pending.entries()) {
+      const result = objects[i];
+      if (result.status === "fulfilled") {
+        this.renderedBlocks.set(index, { get block() {
+          return readBlock();
+        }, object: result.value });
+        this.objectBlocks.add(index);
+      } else {
+        if (preserveDataOnFailure) {
+          this.renderedBlocks.set(index, { get block() {
+            return readBlock();
+          }, object: void 0 });
+        } else this.data.assign(index, 0);
+        this.fluidCells[index] = 0;
+        if (order < failureOrder) {
+          failureOrder = order;
+          failure = result.reason;
+        }
+      }
+    }
+    if (failureOrder < Infinity) throw failure;
     return positions;
   }
   /** Replaces every cell from parsed section data. The caller refreshes neighbor culling. */
@@ -406,37 +430,42 @@ var Chunk = class _Chunk {
         failed = true;
       }
     }
-    for (const { index, blockState, biome } of perBlocks) {
-      let object;
-      try {
-        object = await this.scene.addBlock(blockState, {
-          mergeMeshes: true,
-          instanceMeshes: true,
-          maxInstanceCount: 2e3,
-          initialState: this.data.stateAt(this.data.idAt(index)).properties,
-          variantPosition: this.positionAt(index),
-          biome,
-          biomePosition: this.biomePosition(index, blockState, this.data.stateAt(this.data.idAt(index)))
-        });
-        object.setPosition(new Vector3(
-          this.x * 256 + index % 16 * 16,
-          this.y * 256 + Math.floor(index / 256) * 16,
-          this.z * 256 + Math.floor(index / 16) % 16 * 16
-        ));
-        this.renderedBlocks.get(index).object = object;
+    const objects = await Promise.allSettled(perBlocks.map(({ index, blockState, biome }) => this.createBlockObject(blockState, new Vector3(
+      this.x * 256 + index % 16 * 16,
+      this.y * 256 + Math.floor(index / 256) * 16,
+      this.z * 256 + Math.floor(index / 16) % 16 * 16
+    ), {
+      mergeMeshes: true,
+      instanceMeshes: true,
+      maxInstanceCount: 2e3,
+      initialState: this.data.stateAt(this.data.idAt(index)).properties,
+      variantPosition: this.positionAt(index),
+      biome,
+      biomePosition: this.biomePosition(index, blockState, this.data.stateAt(this.data.idAt(index)))
+    })));
+    for (const [i, { index }] of perBlocks.entries()) {
+      const result = objects[i];
+      if (result.status === "fulfilled") {
+        this.renderedBlocks.get(index).object = result.value;
         this.objectBlocks.add(index);
-      } catch (error) {
+      } else {
         this.data.assign(index, 0);
         this.fluidCells[index] = 0;
         this.renderedBlocks.delete(index);
         this.objectBlocks.delete(index);
-        object?.removeFromScene();
-        if (!failed) failure = error;
+        if (!failed) failure = result.reason;
         failed = true;
       }
     }
     if (failed) throw failure;
   }
+  createBlockObject(blockState, position, options) {
+    return this.scene.addSceneObject(blockState, () => {
+      const object = new BlockObject(blockState, options);
+      object.position.copy(position);
+      return object;
+    }, options);
+  }
   positionAt(index) {
     return [this.x * 16 + index % 16, this.y * 16 + Math.floor(index / 256), this.z * 16 + Math.floor(index / 16) % 16];
   }