minerender 2.1.0-alpha.142 → 2.1.0-alpha.144

package/dist/node/index.d.mts

@@ -785,7 +785,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;
@@ -4021,6 +4024,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>;
@@ -4135,6 +4140,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>;
@@ -4284,6 +4290,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.
@@ -4316,7 +4328,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;
@@ -4326,7 +4338,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;
 }
 
@@ -4371,10 +4383,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;
@@ -4407,6 +4420,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;

package/dist/node/index.d.ts

@@ -785,7 +785,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;
@@ -4021,6 +4024,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>;
@@ -4135,6 +4140,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>;
@@ -4284,6 +4290,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.
@@ -4316,7 +4328,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;
@@ -4326,7 +4338,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;
 }
 
@@ -4371,10 +4383,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;
@@ -4407,6 +4420,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;