minerender 2.1.0-beta.7 → 2.1.0-beta.8

package/dist/browser/esm/world/WorldStreamer.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/world/WorldStreamer.ts"],"sourcesContent":["import type { AnvilChunk } from \"./AnvilParser\";\nimport type { MineRenderWorld } from \"./MineRenderWorld\";\nimport type { WorldChunkSource } from \"./WorldChunkSource\";\n\nexport interface WorldStreamerOptions {\n    /** Loads a square of chunk columns around the center. Integer from 0 to 32; defaults to 2. */\n    loadRadius?: number;\n    /** Retains loaded columns within this radius. Defaults to loadRadius + 1, capped at 32. */\n    unloadRadius?: number;\n}\n\ninterface ChunkPosition {\n    x: number;\n    z: number;\n}\n\n/**\n * Loads nearby chunk columns in distance order and unloads distant columns.\n * Updates coalesce to the latest center and serialize world mutations. Use a dedicated world:\n * the streamer replaces columns it loads, and callers must await disposal before editing that world.\n * The source remains caller-owned. Lighting, biome tint, and LOD are not added by streaming.\n */\nexport class WorldStreamer {\n    private readonly loadRadius: number;\n    private readonly unloadRadius: number;\n    private readonly loaded = new Map<string, ChunkPosition>();\n    private readonly owned = new Map<string, ChunkPosition>();\n    private readonly missing = new Map<string, ChunkPosition>();\n    private readonly failed = new Map<string, ChunkPosition & { error: unknown }>();\n    private desired: ChunkPosition[] = [];\n    private center?: ChunkPosition;\n    private loading?: { position: ChunkPosition; controller: AbortController };\n    private running?: Promise<void>;\n    private disposal?: Promise<void>;\n    private disposed = false;\n\n    constructor(\n        private readonly world: Pick<MineRenderWorld<boolean>, \"placeChunk\" | \"unloadChunkColumns\">,\n        private readonly source: WorldChunkSource,\n        options: WorldStreamerOptions = {}\n    ) {\n        this.loadRadius = options.loadRadius ?? 2;\n        this.unloadRadius = options.unloadRadius ?? Math.min(32, this.loadRadius + 1);\n        if (![this.loadRadius, this.unloadRadius].every(value => Number.isInteger(value) && value >= 0 && value <= 32)\n            || this.unloadRadius < this.loadRadius) {\n            throw new RangeError(\"Chunk radii must be integers from 0 to 32, with unloadRadius at least loadRadius\");\n        }\n    }\n\n    /** Returns absolute coordinates of successfully placed columns, including retained columns. */\n    public get loadedChunks(): readonly { x: number; z: number }[] {\n        return [...this.loaded.values()].map(position => ({ ...position }));\n    }\n\n    /** Returns source failures retained within the unload radius. Failed columns do not block other loads. */\n    public get failedChunks(): readonly { x: number; z: number; error: unknown }[] {\n        return [...this.failed.values()].map(failure => ({ ...failure }));\n    }\n\n    /** Counts desired columns still waiting for a source read or placement, including the active column. */\n    public get pendingChunks(): number {\n        return this.desired.filter(position => this.needsLoad(position)).length;\n    }\n\n    /**\n     * Updates the center in absolute chunk coordinates. Repeated calls share the active drain.\n     * Source failures are recorded in failedChunks; other columns continue loading. Missing and failed\n     * columns are remembered within the retention radius. Call retryFailedChunks to retry source failures.\n     * Placement and unload failures reject the drain; call update again to retry those operations.\n     * Reads outside the latest load radius receive an abort signal; placement finishes before unloading.\n     * Sources should represent an unchanged world during streaming.\n     */\n    public async update(x: number, z: number): Promise<void> {\n        if (this.disposed) throw new Error(\"WorldStreamer is disposed\");\n        if (![x, z].every(value => Number.isSafeInteger(value)\n            && Number.isSafeInteger(value - this.unloadRadius) && Number.isSafeInteger(value + this.unloadRadius))) {\n            throw new RangeError(\"Chunk coordinates must be safe integers within the streaming radius\");\n        }\n        if (!this.center || this.center.x !== x || this.center.z !== z) {\n            this.center = { x, z };\n            this.desired = [];\n            for (let dz = -this.loadRadius; dz <= this.loadRadius; dz++) {\n                for (let dx = -this.loadRadius; dx <= this.loadRadius; dx++) {\n                    this.desired.push({ x: x + dx, z: z + dz });\n                }\n            }\n            this.desired.sort((a, b) => (a.x - x) ** 2 + (a.z - z) ** 2 - (b.x - x) ** 2 - (b.z - z) ** 2);\n            if (this.loading && !this.within(this.loading.position, this.loadRadius)) {\n                this.loading.controller.abort();\n            }\n        }\n        return this.running ??= Promise.resolve().then(() => this.drain());\n    }\n\n    /** Updates from a camera or view-center position in scene units. One chunk spans 256 scene units. */\n    public async updatePosition(position: { x: number; z: number }): Promise<void> {\n        if (![position.x, position.z].every(Number.isFinite)) throw new RangeError(\"Scene coordinates must be finite\");\n        return this.update(Math.floor(position.x / 256), Math.floor(position.z / 256));\n    }\n\n    /** Forgets recorded source failures and retries desired columns at the latest center. */\n    public async retryFailedChunks(): Promise<void> {\n        if (this.disposed) throw new Error(\"WorldStreamer is disposed\");\n        this.failed.clear();\n        if (this.center) await this.update(this.center.x, this.center.z);\n    }\n\n    /** Aborts source reads, waits for active work, then unloads owned columns. The world and source remain caller-owned. */\n    public dispose(): Promise<void> {\n        this.disposed = true;\n        this.desired = [];\n        this.center = undefined;\n        this.loading?.controller.abort();\n        return this.disposal ??= Promise.resolve().then(async () => {\n            await this.running?.catch(() => undefined);\n            try {\n                await this.unloadMany([...this.owned.values()]);\n            } finally {\n                this.missing.clear();\n                this.failed.clear();\n            }\n        }).catch(error => {\n            this.disposal = undefined;\n            throw error;\n        });\n    }\n\n    private async drain(): Promise<void> {\n        try {\n            while (!this.disposed) {\n                for (const [key, position] of this.missing) {\n                    if (!this.within(position, this.unloadRadius)) this.missing.delete(key);\n                }\n                for (const [key, position] of this.failed) {\n                    if (!this.within(position, this.unloadRadius)) this.failed.delete(key);\n                }\n                // Failed placements remain owned until cleanup succeeds, even inside the retained area.\n                const obsolete = [...this.owned.values()].filter(position =>\n                    !this.loaded.has(this.key(position)) || !this.within(position, this.unloadRadius));\n                if (obsolete.length) {\n                    await this.unloadMany(obsolete);\n                    continue;\n                }\n                const position = this.desired.find(position => this.needsLoad(position));\n                if (!position) return;\n                let chunk: AnvilChunk | undefined;\n                const controller = new AbortController();\n                this.loading = { position, controller };\n                try {\n                    chunk = await this.source.getChunk(position.x, position.z, controller.signal);\n                    if (chunk) this.validateChunk(chunk, position);\n                } catch (error) {\n                    if (!controller.signal.aborted && !this.disposed && this.within(position, this.loadRadius)) {\n                        this.failed.set(this.key(position), { ...position, error });\n                    }\n                    continue;\n                } finally {\n                    this.loading = undefined;\n                }\n                if (controller.signal.aborted || this.disposed || !this.within(position, this.loadRadius)) continue;\n                if (!chunk) {\n                    this.missing.set(this.key(position), position);\n                    continue;\n                }\n                this.owned.set(this.key(position), position);\n                try {\n                    await this.world.placeChunk(chunk);\n                    this.loaded.set(this.key(position), position);\n                } catch (error) {\n                    try {\n                        await this.unloadMany([position]);\n                    } catch (cleanupError) {\n                        const failure = error instanceof Error ? error : new Error(String(error));\n                        try {\n                            Object.defineProperty(failure, \"cause\", { value: cleanupError, configurable: true });\n                        } catch {\n                            throw Object.assign(new Error(failure.message), { cause: cleanupError });\n                        }\n                        throw failure;\n                    }\n                    throw error;\n                }\n            }\n        } finally {\n            this.running = undefined;\n        }\n    }\n\n    private needsLoad(position: ChunkPosition): boolean {\n        const key = this.key(position);\n        return !this.loaded.has(key) && !this.missing.has(key) && !this.failed.has(key);\n    }\n\n    private async unloadMany(positions: readonly ChunkPosition[]): Promise<void> {\n        if (!positions.length) return;\n        try {\n            await this.world.unloadChunkColumns(positions.map(({ x, z }) => ({ x, z })));\n        } catch (error) {\n            // A rejected batch may have removed any subset; retry every owner before reloading it.\n            for (const position of positions) this.loaded.delete(this.key(position));\n            throw error;\n        }\n        for (const position of positions) {\n            this.owned.delete(this.key(position));\n            this.loaded.delete(this.key(position));\n        }\n    }\n\n    private validateChunk(chunk: AnvilChunk, position: ChunkPosition): void {\n        if (chunk.x !== position.x || chunk.z !== position.z) {\n            throw new Error(`World source returned chunk ${chunk.x},${chunk.z} for ${position.x},${position.z}`);\n        }\n    }\n\n    private within(position: ChunkPosition, radius: number): boolean {\n        return !!this.center && Math.abs(position.x - this.center.x) <= radius && Math.abs(position.z - this.center.z) <= radius;\n    }\n\n    private key(position: ChunkPosition): string {\n        return `${position.x},${position.z}`;\n    }\n}\n"],"mappings":";AAsBO,IAAM,gBAAN,MAAoB;AAAA,EAcvB,YACqB,OACA,QACjB,UAAgC,CAAC,GACnC;AAHmB;AACA;AAbrB,SAAiB,SAAS,oBAAI,IAA2B;AACzD,SAAiB,QAAQ,oBAAI,IAA2B;AACxD,SAAiB,UAAU,oBAAI,IAA2B;AAC1D,SAAiB,SAAS,oBAAI,IAAgD;AAC9E,SAAQ,UAA2B,CAAC;AAKpC,SAAQ,WAAW;AAOf,SAAK,aAAa,QAAQ,cAAc;AACxC,SAAK,eAAe,QAAQ,gBAAgB,KAAK,IAAI,IAAI,KAAK,aAAa,CAAC;AAC5E,QAAI,CAAC,CAAC,KAAK,YAAY,KAAK,YAAY,EAAE,MAAM,WAAS,OAAO,UAAU,KAAK,KAAK,SAAS,KAAK,SAAS,EAAE,KACtG,KAAK,eAAe,KAAK,YAAY;AACxC,YAAM,IAAI,WAAW,kFAAkF;AAAA,IAC3G;AAAA,EACJ;AAAA;AAAA,EAGA,IAAW,eAAoD;AAC3D,WAAO,CAAC,GAAG,KAAK,OAAO,OAAO,CAAC,EAAE,IAAI,eAAa,EAAE,GAAG,SAAS,EAAE;AAAA,EACtE;AAAA;AAAA,EAGA,IAAW,eAAoE;AAC3E,WAAO,CAAC,GAAG,KAAK,OAAO,OAAO,CAAC,EAAE,IAAI,cAAY,EAAE,GAAG,QAAQ,EAAE;AAAA,EACpE;AAAA;AAAA,EAGA,IAAW,gBAAwB;AAC/B,WAAO,KAAK,QAAQ,OAAO,cAAY,KAAK,UAAU,QAAQ,CAAC,EAAE;AAAA,EACrE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAa,OAAO,GAAW,GAA0B;AACrD,QAAI,KAAK,SAAU,OAAM,IAAI,MAAM,2BAA2B;AAC9D,QAAI,CAAC,CAAC,GAAG,CAAC,EAAE,MAAM,WAAS,OAAO,cAAc,KAAK,KAC9C,OAAO,cAAc,QAAQ,KAAK,YAAY,KAAK,OAAO,cAAc,QAAQ,KAAK,YAAY,CAAC,GAAG;AACxG,YAAM,IAAI,WAAW,qEAAqE;AAAA,IAC9F;AACA,QAAI,CAAC,KAAK,UAAU,KAAK,OAAO,MAAM,KAAK,KAAK,OAAO,MAAM,GAAG;AAC5D,WAAK,SAAS,EAAE,GAAG,EAAE;AACrB,WAAK,UAAU,CAAC;AAChB,eAAS,KAAK,CAAC,KAAK,YAAY,MAAM,KAAK,YAAY,MAAM;AACzD,iBAAS,KAAK,CAAC,KAAK,YAAY,MAAM,KAAK,YAAY,MAAM;AACzD,eAAK,QAAQ,KAAK,EAAE,GAAG,IAAI,IAAI,GAAG,IAAI,GAAG,CAAC;AAAA,QAC9C;AAAA,MACJ;AACA,WAAK,QAAQ,KAAK,CAAC,GAAG,OAAO,EAAE,IAAI,MAAM,KAAK,EAAE,IAAI,MAAM,KAAK,EAAE,IAAI,MAAM,KAAK,EAAE,IAAI,MAAM,CAAC;AAC7F,UAAI,KAAK,WAAW,CAAC,KAAK,OAAO,KAAK,QAAQ,UAAU,KAAK,UAAU,GAAG;AACtE,aAAK,QAAQ,WAAW,MAAM;AAAA,MAClC;AAAA,IACJ;AACA,WAAO,KAAK,YAAL,KAAK,UAAY,QAAQ,QAAQ,EAAE,KAAK,MAAM,KAAK,MAAM,CAAC;AAAA,EACrE;AAAA;AAAA,EAGA,MAAa,eAAe,UAAmD;AAC3E,QAAI,CAAC,CAAC,SAAS,GAAG,SAAS,CAAC,EAAE,MAAM,OAAO,QAAQ,EAAG,OAAM,IAAI,WAAW,kCAAkC;AAC7G,WAAO,KAAK,OAAO,KAAK,MAAM,SAAS,IAAI,GAAG,GAAG,KAAK,MAAM,SAAS,IAAI,GAAG,CAAC;AAAA,EACjF;AAAA;AAAA,EAGA,MAAa,oBAAmC;AAC5C,QAAI,KAAK,SAAU,OAAM,IAAI,MAAM,2BAA2B;AAC9D,SAAK,OAAO,MAAM;AAClB,QAAI,KAAK,OAAQ,OAAM,KAAK,OAAO,KAAK,OAAO,GAAG,KAAK,OAAO,CAAC;AAAA,EACnE;AAAA;AAAA,EAGO,UAAyB;AAC5B,SAAK,WAAW;AAChB,SAAK,UAAU,CAAC;AAChB,SAAK,SAAS;AACd,SAAK,SAAS,WAAW,MAAM;AAC/B,WAAO,KAAK,aAAL,KAAK,WAAa,QAAQ,QAAQ,EAAE,KAAK,YAAY;AACxD,YAAM,KAAK,SAAS,MAAM,MAAM,MAAS;AACzC,UAAI;AACA,cAAM,KAAK,WAAW,CAAC,GAAG,KAAK,MAAM,OAAO,CAAC,CAAC;AAAA,MAClD,UAAE;AACE,aAAK,QAAQ,MAAM;AACnB,aAAK,OAAO,MAAM;AAAA,MACtB;AAAA,IACJ,CAAC,EAAE,MAAM,WAAS;AACd,WAAK,WAAW;AAChB,YAAM;AAAA,IACV,CAAC;AAAA,EACL;AAAA,EAEA,MAAc,QAAuB;AACjC,QAAI;AACA,aAAO,CAAC,KAAK,UAAU;AACnB,mBAAW,CAAC,KAAKA,SAAQ,KAAK,KAAK,SAAS;AACxC,cAAI,CAAC,KAAK,OAAOA,WAAU,KAAK,YAAY,EAAG,MAAK,QAAQ,OAAO,GAAG;AAAA,QAC1E;AACA,mBAAW,CAAC,KAAKA,SAAQ,KAAK,KAAK,QAAQ;AACvC,cAAI,CAAC,KAAK,OAAOA,WAAU,KAAK,YAAY,EAAG,MAAK,OAAO,OAAO,GAAG;AAAA,QACzE;AAEA,cAAM,WAAW,CAAC,GAAG,KAAK,MAAM,OAAO,CAAC,EAAE,OAAO,CAAAA,cAC7C,CAAC,KAAK,OAAO,IAAI,KAAK,IAAIA,SAAQ,CAAC,KAAK,CAAC,KAAK,OAAOA,WAAU,KAAK,YAAY,CAAC;AACrF,YAAI,SAAS,QAAQ;AACjB,gBAAM,KAAK,WAAW,QAAQ;AAC9B;AAAA,QACJ;AACA,cAAM,WAAW,KAAK,QAAQ,KAAK,CAAAA,cAAY,KAAK,UAAUA,SAAQ,CAAC;AACvE,YAAI,CAAC,SAAU;AACf,YAAI;AACJ,cAAM,aAAa,IAAI,gBAAgB;AACvC,aAAK,UAAU,EAAE,UAAU,WAAW;AACtC,YAAI;AACA,kBAAQ,MAAM,KAAK,OAAO,SAAS,SAAS,GAAG,SAAS,GAAG,WAAW,MAAM;AAC5E,cAAI,MAAO,MAAK,cAAc,OAAO,QAAQ;AAAA,QACjD,SAAS,OAAO;AACZ,cAAI,CAAC,WAAW,OAAO,WAAW,CAAC,KAAK,YAAY,KAAK,OAAO,UAAU,KAAK,UAAU,GAAG;AACxF,iBAAK,OAAO,IAAI,KAAK,IAAI,QAAQ,GAAG,EAAE,GAAG,UAAU,MAAM,CAAC;AAAA,UAC9D;AACA;AAAA,QACJ,UAAE;AACE,eAAK,UAAU;AAAA,QACnB;AACA,YAAI,WAAW,OAAO,WAAW,KAAK,YAAY,CAAC,KAAK,OAAO,UAAU,KAAK,UAAU,EAAG;AAC3F,YAAI,CAAC,OAAO;AACR,eAAK,QAAQ,IAAI,KAAK,IAAI,QAAQ,GAAG,QAAQ;AAC7C;AAAA,QACJ;AACA,aAAK,MAAM,IAAI,KAAK,IAAI,QAAQ,GAAG,QAAQ;AAC3C,YAAI;AACA,gBAAM,KAAK,MAAM,WAAW,KAAK;AACjC,eAAK,OAAO,IAAI,KAAK,IAAI,QAAQ,GAAG,QAAQ;AAAA,QAChD,SAAS,OAAO;AACZ,cAAI;AACA,kBAAM,KAAK,WAAW,CAAC,QAAQ,CAAC;AAAA,UACpC,SAAS,cAAc;AACnB,kBAAM,UAAU,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;AACxE,gBAAI;AACA,qBAAO,eAAe,SAAS,SAAS,EAAE,OAAO,cAAc,cAAc,KAAK,CAAC;AAAA,YACvF,QAAQ;AACJ,oBAAM,OAAO,OAAO,IAAI,MAAM,QAAQ,OAAO,GAAG,EAAE,OAAO,aAAa,CAAC;AAAA,YAC3E;AACA,kBAAM;AAAA,UACV;AACA,gBAAM;AAAA,QACV;AAAA,MACJ;AAAA,IACJ,UAAE;AACE,WAAK,UAAU;AAAA,IACnB;AAAA,EACJ;AAAA,EAEQ,UAAU,UAAkC;AAChD,UAAM,MAAM,KAAK,IAAI,QAAQ;AAC7B,WAAO,CAAC,KAAK,OAAO,IAAI,GAAG,KAAK,CAAC,KAAK,QAAQ,IAAI,GAAG,KAAK,CAAC,KAAK,OAAO,IAAI,GAAG;AAAA,EAClF;AAAA,EAEA,MAAc,WAAW,WAAoD;AACzE,QAAI,CAAC,UAAU,OAAQ;AACvB,QAAI;AACA,YAAM,KAAK,MAAM,mBAAmB,UAAU,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC;AAAA,IAC/E,SAAS,OAAO;AAEZ,iBAAW,YAAY,UAAW,MAAK,OAAO,OAAO,KAAK,IAAI,QAAQ,CAAC;AACvE,YAAM;AAAA,IACV;AACA,eAAW,YAAY,WAAW;AAC9B,WAAK,MAAM,OAAO,KAAK,IAAI,QAAQ,CAAC;AACpC,WAAK,OAAO,OAAO,KAAK,IAAI,QAAQ,CAAC;AAAA,IACzC;AAAA,EACJ;AAAA,EAEQ,cAAc,OAAmB,UAA+B;AACpE,QAAI,MAAM,MAAM,SAAS,KAAK,MAAM,MAAM,SAAS,GAAG;AAClD,YAAM,IAAI,MAAM,+BAA+B,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,SAAS,CAAC,IAAI,SAAS,CAAC,EAAE;AAAA,IACvG;AAAA,EACJ;AAAA,EAEQ,OAAO,UAAyB,QAAyB;AAC7D,WAAO,CAAC,CAAC,KAAK,UAAU,KAAK,IAAI,SAAS,IAAI,KAAK,OAAO,CAAC,KAAK,UAAU,KAAK,IAAI,SAAS,IAAI,KAAK,OAAO,CAAC,KAAK;AAAA,EACtH;AAAA,EAEQ,IAAI,UAAiC;AACzC,WAAO,GAAG,SAAS,CAAC,IAAI,SAAS,CAAC;AAAA,EACtC;AACJ;","names":["position"]}
+{"version":3,"sources":["../../../../src/world/WorldStreamer.ts"],"sourcesContent":["import type { AnvilChunk } from \"./AnvilParser\";\nimport type { MineRenderWorld } from \"./MineRenderWorld\";\nimport type { WorldChunkSource } from \"./WorldChunkSource\";\n\nexport interface WorldStreamerOptions {\n    /** Loads a square of chunk columns around the center. Integer from 0 to 32; defaults to 2. */\n    loadRadius?: number;\n    /** Retains loaded columns within this radius. Defaults to loadRadius + 1, capped at 32. */\n    unloadRadius?: number;\n}\n\ninterface ChunkPosition {\n    x: number;\n    z: number;\n}\n\ninterface ChunkRead {\n    position: ChunkPosition;\n    controller: AbortController;\n    promise: Promise<void>;\n    ready: boolean;\n    chunk?: AnvilChunk;\n    failed: boolean;\n    error?: unknown;\n}\n\nconst MAX_PREFETCHED_COLUMNS = 4;\n\n/**\n * Loads nearby chunk columns in distance order and unloads distant columns.\n * Updates coalesce to the latest center and serialize world mutations. Use a dedicated world:\n * the streamer replaces columns it loads, and callers must await disposal before editing that world.\n * The source remains caller-owned. Lighting, biome tint, and LOD are not added by streaming.\n */\nexport class WorldStreamer {\n    private readonly loadRadius: number;\n    private readonly unloadRadius: number;\n    private readonly loaded = new Map<string, ChunkPosition>();\n    private readonly owned = new Map<string, ChunkPosition>();\n    private readonly missing = new Map<string, ChunkPosition>();\n    private readonly failed = new Map<string, ChunkPosition & { error: unknown }>();\n    private desired: ChunkPosition[] = [];\n    private center?: ChunkPosition;\n    private loading?: { position: ChunkPosition; controller: AbortController };\n    private readonly reads = new Map<string, ChunkRead>();\n    private running?: Promise<void>;\n    private disposal?: Promise<void>;\n    private disposed = false;\n\n    constructor(\n        private readonly world: Pick<MineRenderWorld<boolean>, \"placeChunk\" | \"unloadChunkColumns\">\n            & Partial<Pick<MineRenderWorld<boolean>, \"placeChunks\">>,\n        private readonly source: WorldChunkSource,\n        options: WorldStreamerOptions = {}\n    ) {\n        this.loadRadius = options.loadRadius ?? 2;\n        this.unloadRadius = options.unloadRadius ?? Math.min(32, this.loadRadius + 1);\n        if (![this.loadRadius, this.unloadRadius].every(value => Number.isInteger(value) && value >= 0 && value <= 32)\n            || this.unloadRadius < this.loadRadius) {\n            throw new RangeError(\"Chunk radii must be integers from 0 to 32, with unloadRadius at least loadRadius\");\n        }\n    }\n\n    /** Returns absolute coordinates of successfully placed columns, including retained columns. */\n    public get loadedChunks(): readonly { x: number; z: number }[] {\n        return [...this.loaded.values()].map(position => ({ ...position }));\n    }\n\n    /** Returns source failures retained within the unload radius. Failed columns do not block other loads. */\n    public get failedChunks(): readonly { x: number; z: number; error: unknown }[] {\n        return [...this.failed.values()].map(failure => ({ ...failure }));\n    }\n\n    /** Counts desired columns still waiting for a source read or placement, including the active column. */\n    public get pendingChunks(): number {\n        return this.desired.filter(position => this.needsLoad(position)).length;\n    }\n\n    /**\n     * Updates the center in absolute chunk coordinates. Repeated calls share the active drain.\n     * Source failures are recorded in failedChunks; other columns continue loading. Missing and failed\n     * columns are remembered within the retention radius. Call retryFailedChunks to retry source failures.\n     * Placement and unload failures reject the drain; call update again to retry those operations.\n     * Reads outside the latest load radius receive an abort signal; placement finishes before unloading.\n     * Sources should represent an unchanged world during streaming.\n     */\n    public async update(x: number, z: number): Promise<void> {\n        if (this.disposed) throw new Error(\"WorldStreamer is disposed\");\n        if (![x, z].every(value => Number.isSafeInteger(value)\n            && Number.isSafeInteger(value - this.unloadRadius) && Number.isSafeInteger(value + this.unloadRadius))) {\n            throw new RangeError(\"Chunk coordinates must be safe integers within the streaming radius\");\n        }\n        if (!this.center || this.center.x !== x || this.center.z !== z) {\n            this.center = { x, z };\n            this.desired = [];\n            for (let dz = -this.loadRadius; dz <= this.loadRadius; dz++) {\n                for (let dx = -this.loadRadius; dx <= this.loadRadius; dx++) {\n                    this.desired.push({ x: x + dx, z: z + dz });\n                }\n            }\n            this.desired.sort((a, b) => (a.x - x) ** 2 + (a.z - z) ** 2 - (b.x - x) ** 2 - (b.z - z) ** 2);\n            if (this.loading && !this.within(this.loading.position, this.loadRadius)) {\n                this.loading.controller.abort();\n            }\n            for (const [key, read] of this.reads) {\n                if (!this.within(read.position, this.loadRadius)) {\n                    read.controller.abort();\n                    if (read.ready) this.reads.delete(key);\n                }\n            }\n        }\n        return this.running ??= Promise.resolve().then(() => this.drain());\n    }\n\n    /** Updates from a camera or view-center position in scene units. One chunk spans 256 scene units. */\n    public async updatePosition(position: { x: number; z: number }): Promise<void> {\n        if (![position.x, position.z].every(Number.isFinite)) throw new RangeError(\"Scene coordinates must be finite\");\n        return this.update(Math.floor(position.x / 256), Math.floor(position.z / 256));\n    }\n\n    /** Forgets recorded source failures and retries desired columns at the latest center. */\n    public async retryFailedChunks(): Promise<void> {\n        if (this.disposed) throw new Error(\"WorldStreamer is disposed\");\n        this.failed.clear();\n        if (this.center) await this.update(this.center.x, this.center.z);\n    }\n\n    /** Aborts source reads, waits for active work, then unloads owned columns. The world and source remain caller-owned. */\n    public dispose(): Promise<void> {\n        this.disposed = true;\n        this.desired = [];\n        this.center = undefined;\n        this.loading?.controller.abort();\n        for (const read of this.reads.values()) read.controller.abort();\n        return this.disposal ??= Promise.resolve().then(async () => {\n            await this.running?.catch(() => undefined);\n            await Promise.all([...this.reads.values()].map(read => read.promise));\n            this.reads.clear();\n            try {\n                await this.unloadMany([...this.owned.values()]);\n            } finally {\n                this.missing.clear();\n                this.failed.clear();\n            }\n        }).catch(error => {\n            this.disposal = undefined;\n            throw error;\n        });\n    }\n\n    private async drain(): Promise<void> {\n        try {\n            while (!this.disposed) {\n                for (const [key, position] of this.missing) {\n                    if (!this.within(position, this.unloadRadius)) this.missing.delete(key);\n                }\n                for (const [key, position] of this.failed) {\n                    if (!this.within(position, this.unloadRadius)) this.failed.delete(key);\n                }\n                // Failed placements remain owned until cleanup succeeds, even inside the retained area.\n                const obsolete = [...this.owned.values()].filter(position =>\n                    !this.loaded.has(this.key(position)) || !this.within(position, this.unloadRadius));\n                if (obsolete.length) {\n                    await this.unloadMany(obsolete);\n                    continue;\n                }\n                if (this.world.placeChunks) {\n                    if (await this.placeReadyChunks()) continue;\n                    return;\n                }\n                const position = this.desired.find(position => this.needsLoad(position));\n                if (!position) return;\n                let chunk: AnvilChunk | undefined;\n                const controller = new AbortController();\n                this.loading = { position, controller };\n                try {\n                    chunk = await this.source.getChunk(position.x, position.z, controller.signal);\n                    if (chunk) this.validateChunk(chunk, position);\n                } catch (error) {\n                    if (!controller.signal.aborted && !this.disposed && this.within(position, this.loadRadius)) {\n                        this.failed.set(this.key(position), { ...position, error });\n                    }\n                    continue;\n                } finally {\n                    this.loading = undefined;\n                }\n                if (controller.signal.aborted || this.disposed || !this.within(position, this.loadRadius)) continue;\n                if (!chunk) {\n                    this.missing.set(this.key(position), position);\n                    continue;\n                }\n                this.owned.set(this.key(position), position);\n                await this.placeOwnedColumns([position], () => this.world.placeChunk(chunk!));\n            }\n        } finally {\n            for (const [key, read] of this.reads) {\n                read.controller.abort();\n                if (read.ready) this.reads.delete(key);\n            }\n            this.running = undefined;\n        }\n    }\n\n    private fillReadSlots(): void {\n        while (!this.disposed && this.reads.size < MAX_PREFETCHED_COLUMNS) {\n            const position = this.desired.find(position => this.needsLoad(position) && !this.reads.has(this.key(position)));\n            if (!position) return;\n            const key = this.key(position);\n            const read: ChunkRead = {\n                position, controller: new AbortController(), promise: Promise.resolve(), ready: false, failed: false\n            };\n            this.reads.set(key, read);\n            read.promise = (async () => {\n                try {\n                    read.chunk = await this.source.getChunk(position.x, position.z, read.controller.signal);\n                    if (read.chunk) this.validateChunk(read.chunk, position);\n                } catch (error) {\n                    read.failed = true;\n                    read.error = error;\n                } finally {\n                    read.ready = true;\n                    if (read.controller.signal.aborted || this.disposed || !this.within(position, this.loadRadius)) {\n                        this.reads.delete(key);\n                    }\n                }\n            })();\n        }\n    }\n\n    /** Places only the ready prefix, so later source reads cannot delay the nearest ready column. */\n    private async placeReadyChunks(): Promise<boolean> {\n        this.fillReadSlots();\n        const position = this.desired.find(position => this.needsLoad(position));\n        if (!position) {\n            if (!this.reads.size) return false;\n            await Promise.all([...this.reads.values()].map(read => read.promise));\n            return true;\n        }\n        const head = this.reads.get(this.key(position));\n        if (!head) {\n            for (let index = this.desired.length - 1; index >= 0; index--) {\n                const key = this.key(this.desired[index]);\n                if (this.reads.get(key)?.ready) {\n                    this.reads.delete(key);\n                    return true;\n                }\n            }\n            // Aborted reads still occupy slots until their source work settles.\n            await Promise.race([...this.reads.values()].map(read => read.promise));\n            return true;\n        }\n        if (!head.ready) {\n            await head.promise;\n            return true;\n        }\n        const chunks: AnvilChunk[] = [], positions: ChunkPosition[] = [];\n        for (const desired of this.desired) {\n            if (!this.needsLoad(desired)) continue;\n            const key = this.key(desired), read = this.reads.get(key);\n            if (!read?.ready) break;\n            this.reads.delete(key);\n            if (read.failed) this.failed.set(key, { ...desired, error: read.error });\n            else if (!read.chunk) this.missing.set(key, desired);\n            else {\n                chunks.push(read.chunk);\n                positions.push(desired);\n            }\n        }\n        if (!chunks.length) return true;\n        for (const position of positions) this.owned.set(this.key(position), position);\n        await this.placeOwnedColumns(positions, () => this.world.placeChunks!(chunks));\n        return true;\n    }\n\n    private async placeOwnedColumns(positions: readonly ChunkPosition[], place: () => Promise<void>): Promise<void> {\n        try {\n            await place();\n            for (const position of positions) this.loaded.set(this.key(position), position);\n        } catch (error) {\n            try {\n                await this.unloadMany(positions);\n            } catch (cleanupError) {\n                const failure = error instanceof Error ? error : new Error(String(error));\n                try {\n                    Object.defineProperty(failure, \"cause\", { value: cleanupError, configurable: true });\n                } catch {\n                    throw Object.assign(new Error(failure.message), { cause: cleanupError });\n                }\n                throw failure;\n            }\n            throw error;\n        }\n    }\n\n    private needsLoad(position: ChunkPosition): boolean {\n        const key = this.key(position);\n        return !this.loaded.has(key) && !this.missing.has(key) && !this.failed.has(key);\n    }\n\n    private async unloadMany(positions: readonly ChunkPosition[]): Promise<void> {\n        if (!positions.length) return;\n        try {\n            await this.world.unloadChunkColumns(positions.map(({ x, z }) => ({ x, z })));\n        } catch (error) {\n            // A rejected batch may have removed any subset; retry every owner before reloading it.\n            for (const position of positions) this.loaded.delete(this.key(position));\n            throw error;\n        }\n        for (const position of positions) {\n            this.owned.delete(this.key(position));\n            this.loaded.delete(this.key(position));\n        }\n    }\n\n    private validateChunk(chunk: AnvilChunk, position: ChunkPosition): void {\n        if (chunk.x !== position.x || chunk.z !== position.z) {\n            throw new Error(`World source returned chunk ${chunk.x},${chunk.z} for ${position.x},${position.z}`);\n        }\n    }\n\n    private within(position: ChunkPosition, radius: number): boolean {\n        return !!this.center && Math.abs(position.x - this.center.x) <= radius && Math.abs(position.z - this.center.z) <= radius;\n    }\n\n    private key(position: ChunkPosition): string {\n        return `${position.x},${position.z}`;\n    }\n}\n"],"mappings":"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","names":["position"]}

package/dist/browser/index.d.ts

@@ -249,6 +249,15 @@ interface EntityLayer {
     render?: EntityRenderMode;
     /** Label of the state colour that multiplies the texture, from the pass that selected this draw. */
     tint?: string;
+    /** Fixed sRGB colour that multiplies the texture. A tint label with a colour in `EntityObjectOptions.tints` takes precedence. */
+    color?: number;
+    /** Recolours pixels matching `key` with the colour at the same index in `permutation`, as vanilla's `paletted_permutations` does. */
+    palette?: {
+        key: AssetKey;
+        permutation: AssetKey;
+    };
+    /** Draws vanilla's armor enchantment glint over this draw. */
+    glint?: boolean;
 }
 /** Selected entity data returned by {@link Entities.getEntity} for rendering. */
 interface EntityModel extends EntityLayer {
@@ -783,7 +792,10 @@ declare function toRadians(degrees: number): number;
 declare function toDegrees(radians: number): number;
 /** Resolves after a delay in milliseconds. */
 declare function sleep(timeout: number): Promise<void>;
-/** Yields to the next macrotask without timer clamping when the platform supports it. */
+/**
+ * Yields to the next macrotask without timer clamping when the platform supports it.
+ * Not `scheduler.yield()`: Chrome runs its continuations ahead of rendering, so chained yields delay frames.
+ */
 declare function yieldToEventLoop(): Promise<void>;
 /** Reduces an angle modulo 360, retaining a negative sign for negative inputs. */
 declare function clampRotationDegrees(deg: number): number;
@@ -913,6 +925,30 @@ declare class MinecraftFaceUV {
  */
 declare function shutdown(): void;
 
+type ArmorSlot = "head" | "chest" | "legs" | "feet";
+interface ArmorTrim {
+    /** `trim_pattern` registry ID, such as `minecraft:sentry`. */
+    pattern: string;
+    /** `trim_material` registry ID, such as `minecraft:iron`. */
+    material: string;
+}
+/** An equipment asset ID, such as `minecraft:diamond`, or the asset with the worn item's state. */
+type ArmorPiece = string | {
+    asset: string;
+    /** `dyed_color` as an RGB integer. */
+    color?: number;
+    trim?: ArmorTrim;
+    /** Draws the enchantment glint, as an enchanted item does. */
+    glint?: boolean;
+};
+type ArmorSet = Partial<Record<ArmorSlot, ArmorPiece>>;
+/** Resolves humanoid equipment assets into armor draws. */
+declare class Armor {
+    /** Loads 1.21.4+ armor in SkinObject's frame, or returns undefined when no layer draws. */
+    static getEntity(armor: ArmorSet): Promise<Maybe<EntityModel>>;
+    private static identifier;
+}
+
 declare const DEFAULT_ROOT = "https://assets.mcasset.cloud/1.21.11";
 declare const DEFAULT_NAMESPACE = "minecraft";
 
@@ -1259,9 +1295,16 @@ declare function sampleEntityAnimation(animation: EntityAnimation, time: number,
 
 /** Loads entity and block-entity geometry, texture selections, and animation clips from the dataset. */
 declare class Entities {
+    /**
+     * Resolves `root` (default: the active version). Uses the exact dataset when published or when the
+     * version is not a release; otherwise selects the nearest published release, like {@link MineRenderData.resolve}.
+     * Textures keep the requested root.
+     */
+    static getDatasetRoot(root?: string): Promise<Maybe<string>>;
     /** Lists model paths in the `minecraft` namespace, including subdirectories and excluding `.json`. */
     static getEntityList(): Promise<string[]>;
-    private static getModelFile;
+    /** @internal */
+    static getModelFile(modelKey: BasicAssetKey): Promise<Maybe<EntityModelFile>>;
     /** Returns selectable geometry-layer names, or an empty list when the model is missing. */
     static getLayerList(modelKey: BasicAssetKey): Promise<string[]>;
     /** The dataset's extra draws on top of `main`; their `when` labels are the states `EntityModelOptions.when` can enable. */
@@ -1675,6 +1718,7 @@ declare class EntityObject extends SceneObject {
     age: number;
     private readonly animationPlayers;
     private readonly partPoses;
+    private glint?;
     constructor(entity: EntityModel, options?: Partial<EntityObjectOptions>);
     /** An optional shared material replaces texture loading for every selected draw; its owner retains disposal. */
     init(material?: Material): Promise<void>;
@@ -1732,7 +1776,7 @@ interface EntityObjectOptions extends SceneObjectOptions {
      * By default the model's dataset transform is used, or the flip for models without one.
      */
     flip?: boolean;
-    /** Colours for the dataset's tint labels, e.g. `{ wool_color: 0xf9801d }`; a pass whose label is absent stays untinted. */
+    /** Colours for the dataset's tint labels, e.g. `{ wool_color: 0xf9801d }`; an absent label uses the draw's fixed colour, if any. */
     tints?: Record<string, ColorRepresentation>;
     /** Cube faces by layer key; omitted layers draw all six faces. */
     faces?: Record<string, CubeFace[]>;
@@ -1783,6 +1827,7 @@ declare class BlockObject extends SceneObject {
      */
     private createBlockEntities;
     private placeEntities;
+    private placeEntity;
     get isOccluding(): boolean;
     private getModelMatrix;
     private getModelCullMask;
@@ -1905,7 +1950,9 @@ declare enum SkinPart {
     LEFT_SLEEVE = "leftSleeve",
     RIGHT_TROUSERS = "rightTrousers",
     LEFT_TROUSERS = "leftTrousers",
-    CAPE = "cape"
+    CAPE = "cape",
+    LEFT_EAR = "leftEar",
+    RIGHT_EAR = "rightEar"
 }
 declare const SKIN_PARTS: SkinPart[];
 
@@ -1921,6 +1968,9 @@ declare class SkinObject extends SceneObject {
     private skinMaterial?;
     private skinLoad;
     private capeLoad;
+    private armorLoad;
+    private armorObjects;
+    private model?;
     constructor(options?: DeepPartial<SkinObjectOptions>);
     init(): Promise<void>;
     protected removeMeshes(): void;
@@ -1936,9 +1986,20 @@ declare class SkinObject extends SceneObject {
     setSkinTexture(src: string): Promise<void>;
     /** Load a cape texture in the selected layout, or pass undefined to remove the cape. */
     setCapeTexture(src?: string, layout?: CapeLayout): Promise<void>;
+    /**
+     * Loads armor from 1.21.4+ equipment assets, or pass undefined to remove it.
+     * Each piece moves with the skin part it covers.
+     */
+    setArmor(armor?: ArmorSet): Promise<void>;
     /** Select the arm model, or pass undefined to use texture detection. */
     setSlim(slim?: boolean): void;
     private updateSlim;
+    /** Shows or hides deadmau5's ears, which vanilla draws from the skin texture at 24,0 for that player only. */
+    setEars(ears: boolean): void;
+    private updateEars;
+    /** Turns the player upside down, as vanilla does for players named Dinnerbone or Grumm. */
+    setUpsideDown(upsideDown: boolean): void;
+    private updateUpsideDown;
     /** Select the texture layout, or pass undefined to detect it from image dimensions. */
     setLegacy(legacy?: boolean): Promise<void>;
     dispose(): void;
@@ -1950,6 +2011,10 @@ interface SkinObjectOptions extends SceneObjectOptions {
     slim?: boolean;
     /** Forces the legacy (`true`) or modern (`false`) texture layout. Omit it to detect the layout. */
     legacy?: boolean;
+    /** Draws deadmau5's ears from the skin texture. Vanilla shows them only for that player name. */
+    ears?: boolean;
+    /** Turns the player upside down. Vanilla does this for players named Dinnerbone or Grumm. */
+    upsideDown?: boolean;
 }
 
 /** Text appearance set on a GUI text layer or overridden by an individual text run. */
@@ -2222,7 +2287,7 @@ declare class ItemGlint {
     static create(owner: SceneObject, baseMap?: Texture, root?: string, entityMeshes?: readonly {
         mesh: Mesh;
         parent?: Mesh;
-    }[]): Promise<ItemGlint>;
+    }[], kind?: "item" | "armor"): Promise<ItemGlint>;
     /**
      * Maps glint before model centering and display transforms. Ordinary sprites approximate Minecraft's shared atlas density.
      * @internal
@@ -2733,6 +2798,8 @@ interface UnihexFile {
 
 /** Shared in-memory caches for loaded assets and render resources. Persistent stores are managed separately. */
 declare class Caching {
+    /** Cached in place of a missing asset. The caches drop `undefined` results, which would request the asset again. */
+    static readonly MISSING: false;
     private static _generation;
     /** Changes when shared assets are cleared, so derived caches can discard their old values. */
     static get generation(): number;
@@ -2745,7 +2812,7 @@ declare class Caching {
     static readonly materialCache: SimpleCache<CacheKey, Material>;
     static readonly boxMeshCache: SimpleCache<CacheKey, Mesh>;
     static readonly textureAssetCache: AsyncLoadingCache<CacheKey, TextureAsset>;
-    static readonly textureMetaCache: AsyncLoadingCache<CacheKey, MinecraftTextureMeta>;
+    static readonly textureMetaCache: AsyncLoadingCache<CacheKey, MinecraftTextureMeta | typeof Caching.MISSING>;
     static readonly rawModelCache: AsyncLoadingCache<CacheKey, Model>;
     static readonly mergedModelCache: AsyncLoadingCache<CacheKey, Model>;
     static readonly modelTextureAtlasCache: AsyncLoadingCache<CacheKey, TextureAtlas>;
@@ -2753,12 +2820,15 @@ declare class Caching {
     static readonly listAssetCache: AsyncLoadingCache<CacheKey, ListAsset>;
     static readonly blockTintCache: AsyncLoadingCache<CacheKey, number>;
     static readonly entityModelCache: AsyncLoadingCache<CacheKey, EntityModelFile>;
-    static readonly entityTextureCache: AsyncLoadingCache<CacheKey, AssetKey>;
+    static readonly entityTextureCache: AsyncLoadingCache<CacheKey, AssetKey | typeof Caching.MISSING>;
     static readonly entityAnimationCache: AsyncLoadingCache<CacheKey, EntityAnimationFile>;
     static readonly blockEntityIndexCache: AsyncLoadingCache<CacheKey, BlockEntityIndex>;
+    static readonly entityDatasetVersionCache: AsyncLoadingCache<CacheKey, string>;
     static readonly unihexCache: AsyncLoadingCache<CacheKey, UnihexFile>;
     static readonly fontCache: AsyncLoadingCache<CacheKey, BitmapFont>;
     static readonly bannerPatternCache: AsyncLoadingCache<CacheKey, BannerPattern>;
+    static readonly equipmentCache: AsyncLoadingCache<CacheKey, unknown>;
+    static readonly trimCache: AsyncLoadingCache<CacheKey, unknown>;
     static readonly mineRenderDataCache: AsyncLoadingCache<CacheKey, unknown>;
     static readonly usernameUuidCache: AsyncLoadingCache<CacheKey, string>;
     static readonly biomeCache: AsyncLoadingCache<CacheKey, Biome>;
@@ -3442,9 +3512,12 @@ interface SceneSkinDefinition extends SceneObjectDefinitionBase {
         texture: string;
         layout?: CapeLayout;
     };
+    armor?: ArmorSet;
     options?: {
         slim?: boolean;
         legacy?: boolean;
+        ears?: boolean;
+        upsideDown?: boolean;
     };
     /** Mesh names from SkinPart; hiding a base part does not hide its overlay. */
     hiddenParts?: string[];
@@ -3491,8 +3564,17 @@ interface SceneEntityDefinition extends SceneObjectDefinitionBase {
         wireframe?: boolean;
         tints?: Record<string, string | number>;
     };
-    animation?: {
+    /** Plays one named clip or blends clips with weights defaulting to 1, without normalization. */
+    animation?: ({
         name: string;
+        clips?: never;
+    } | {
+        name?: never;
+        clips: {
+            name: string;
+            weight?: number;
+        }[];
+    }) & {
         loop?: boolean;
         speed?: number;
         time?: number;
@@ -3640,6 +3722,14 @@ declare class Colormaps {
     static getColor(kind: "grass" | "foliage" | "dry_foliage", origin?: AssetKey, temperature?: number, downfall?: number): Promise<number>;
 }
 
+/** Recolours textures using indexed pairs of palette images. */
+declare class PalettedTextures {
+    /** Loads a texture with a palette permutation, sharing the resulting canvas between callers. */
+    static get(texture: AssetKey, key: AssetKey, permutation: AssetKey): Promise<Maybe<ExtractableImageData>>;
+    /** @internal */
+    static permute(pixels: Uint8ClampedArray, key: Uint8ClampedArray, permutation: Uint8ClampedArray): Uint8ClampedArray;
+}
+
 /** Creates sRGB textures immediately and fills their pixels after asynchronous image loading. */
 declare class TextureLoader {
     private static readonly failedTextures;
@@ -4003,6 +4093,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>;
@@ -4117,6 +4209,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>;
@@ -4266,6 +4359,12 @@ declare class MineRenderWorld<SectionMeshing extends boolean = false> {
     private placeChunkGroups;
     /** Replaces a chunk column's blocks, biomes, and saved light and, with `renderEntities`, its supported saved mobs. */
     placeChunk(chunk: AnvilChunk, executor?: BatchedExecutor): Promise<void>;
+    /**
+     * Replaces parsed columns in input order, then refreshes neighboring geometry once.
+     * Duplicate coordinates retain their order. A failed column stops placement; queued refreshes finish before rejection.
+     */
+    placeChunks(chunks: readonly AnvilChunk[]): Promise<void>;
+    private placeColumn;
     /**
      * Removes blocks and owned entities at chunk-column coordinates, then refreshes neighboring faces and fluids.
      * Coordinates match AnvilChunk.x/z, not block positions. Missing columns are ignored.
@@ -4298,7 +4397,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;
@@ -4308,7 +4407,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;
 }
 
@@ -4353,10 +4452,11 @@ declare class WorldStreamer {
     private desired;
     private center?;
     private loading?;
+    private readonly reads;
     private running?;
     private disposal?;
     private disposed;
-    constructor(world: Pick<MineRenderWorld<boolean>, "placeChunk" | "unloadChunkColumns">, source: WorldChunkSource, options?: WorldStreamerOptions);
+    constructor(world: Pick<MineRenderWorld<boolean>, "placeChunk" | "unloadChunkColumns"> & Partial<Pick<MineRenderWorld<boolean>, "placeChunks">>, source: WorldChunkSource, options?: WorldStreamerOptions);
     /** Returns absolute coordinates of successfully placed columns, including retained columns. */
     get loadedChunks(): readonly {
         x: number;
@@ -4389,6 +4489,10 @@ declare class WorldStreamer {
     /** Aborts source reads, waits for active work, then unloads owned columns. The world and source remain caller-owned. */
     dispose(): Promise<void>;
     private drain;
+    private fillReadSlots;
+    /** Places only the ready prefix, so later source reads cannot delay the nearest ready column. */
+    private placeReadyChunks;
+    private placeOwnedColumns;
     private needsLoad;
     private unloadMany;
     private validateChunk;
@@ -4396,12 +4500,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;
@@ -4409,7 +4525,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).
@@ -4439,4 +4555,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, Armor, type ArmorPiece, type ArmorSet, type ArmorSlot, type ArmorTrim, 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, PalettedTextures, 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 };