minerender 2.1.0-alpha.128 → 2.1.0-alpha.129

package/dist/node/index.d.mts

@@ -2651,6 +2651,9 @@ interface BedrockGeometryFile {
 
 /** Shared in-memory caches for loaded assets and render resources. Persistent stores are managed separately. */
 declare class Caching {
+    private static _generation;
+    /** Changes when shared assets are cleared, so derived caches can discard their old values. */
+    static get generation(): number;
     static readonly rawImageCache: AsyncLoadingCache<CacheKey, ImageInfo>;
     static readonly imageDataCache: AsyncLoadingCache<CacheKey, ImageData>;
     static readonly canvasImageDataCache: AsyncLoadingCache<CacheKey, ExtractableImageData>;
@@ -3788,6 +3791,7 @@ interface SectionTemplateData {
     colors: Float32Array;
     indices: Uint16Array;
     cullFaces: Uint8Array;
+    biomeTint?: Uint8Array;
     atlas: number;
     layer: number;
     ambientOcclusion?: boolean;
@@ -3820,6 +3824,8 @@ interface SectionGeometryInput {
     indices: Uint16Array;
     templates: Uint16Array;
     cullMasks: Uint8Array;
+    /** Linear RGB per placement; three NaN values preserve the template's colors. */
+    biomeTints?: Float32Array;
     templateData: SectionTemplateData[];
     atlases: SectionAtlasSize[];
     maxAtlasSize: number;
@@ -3860,6 +3866,8 @@ interface SectionMeshTemplate {
     geometry: BufferGeometry;
     atlas: TextureAtlas;
     cullFaces: Uint8Array;
+    /** Quads that accept a placement's biome tint, stored as zero or one. */
+    biomeTint?: Uint8Array;
     occludes: boolean;
     /** Whether the model permits corner shading from neighboring full cubes. */
     ambientOcclusion?: boolean;
@@ -3870,6 +3878,8 @@ interface SectionMeshEntry {
     index: number;
     template: SectionMeshTemplate;
     cullMask: number;
+    /** Linear RGB replacing automatic biome colors on eligible quads. */
+    biomeTint?: readonly [number, number, number];
 }
 /** Fluid cells for one section and the shared atlases of the kinds present. */
 interface SectionFluids {
@@ -3903,9 +3913,10 @@ declare class SectionModels {
     constructor(maxAtlasSize?: number);
     /** Returns templates for the matched parts, or `undefined` when the block needs an individual render object. */
     get(blockState: BlockState, properties?: BlockStateProperties, position?: Readonly<TripleArray>, biome?: string): Promise<SectionMeshTemplate[] | undefined>;
-    /** Resolves section templates for one tint palette, with a synchronous weighted choice for each cell. */
-    prepareState(blockState: BlockState, properties?: BlockStateProperties, biomeColor?: number | (() => Promise<number | undefined>)): Promise<{
+    /** Resolves shared templates; dynamic biome tints are supplied on section placements instead of cached geometry. */
+    prepareState(blockState: BlockState, properties?: BlockStateProperties, biomeColor?: number | (() => Promise<number | undefined>), dynamicBiomeTint?: boolean): Promise<{
         pick(position?: Readonly<TripleArray>): SectionMeshTemplate[];
+        biomeTint?: boolean;
     } | undefined>;
     private state;
     /** Returns the shared still/flow atlas used by per-block fluid objects. */
@@ -3916,6 +3927,20 @@ declare class SectionModels {
     clear(): void;
 }
 
+/** Caches horizontal color averages for saved quart-resolution biome samples. */
+declare class BiomeBlend {
+    private readonly biomeAt;
+    private readonly tiles;
+    private generation;
+    private _radius;
+    constructor(biomeAt: (x: number, y: number, z: number) => string | undefined, radius: number);
+    get radius(): number;
+    clear(): void;
+    invalidateColumn(x: number, z: number): void;
+    getColor(kind: BiomeColorKind, origin: AssetKey | undefined, position: Readonly<TripleArray>): Promise<number | undefined>;
+    private buildTile;
+}
+
 /** The nearest rendered block triangle hit by a world raycast. */
 interface WorldBlockIntersection {
     /** Integer world block coordinates of the geometry's owner. */
@@ -3946,6 +3971,7 @@ declare class Chunk<SectionMeshing extends boolean = false> {
     private readonly lightAt?;
     private readonly onLightCleared?;
     private readonly ambientLight;
+    private readonly biomeBlend?;
     readonly scene: MineRenderScene;
     readonly x: number;
     readonly y: number;
@@ -3963,7 +3989,9 @@ declare class Chunk<SectionMeshing extends boolean = false> {
     private meshDirty;
     private meshGeneration;
     private ambientOcclusionCells?;
-    constructor(scene: MineRenderScene, x: number, y: number, z: number, onBlocksChanged?: ((positions: Vector3[]) => Promise<void>) | undefined, sectionModels?: SectionModels | undefined, neighborCell?: ((x: number, y: number, z: number) => number) | undefined, biomeAt?: ((x: number, y: number, z: number) => Maybe<string>) | undefined, onBiomesChanged?: ((biomes?: readonly string[]) => Promise<void>) | undefined, lightAt?: ((x: number, y: number, z: number) => number) | undefined, onLightCleared?: (() => Promise<void>) | undefined, ambientLight?: number);
+    private readonly blockChanges;
+    private biomeChange?;
+    constructor(scene: MineRenderScene, x: number, y: number, z: number, onBlocksChanged?: ((positions: Vector3[]) => Promise<void>) | undefined, sectionModels?: SectionModels | undefined, neighborCell?: ((x: number, y: number, z: number) => number) | undefined, biomeAt?: ((x: number, y: number, z: number) => Maybe<string>) | undefined, onBiomesChanged?: ((biomes?: readonly string[]) => Promise<void>) | undefined, lightAt?: ((x: number, y: number, z: number) => number) | undefined, onLightCleared?: (() => Promise<void>) | undefined, ambientLight?: number, biomeBlend?: (() => BiomeBlend | undefined) | undefined);
     /** Finds the nearest owned block hit across sections, testing each shared mesh once. */
     static raycast<SectionMeshing extends boolean>(chunks: Iterable<Chunk<SectionMeshing>>, raycaster: Raycaster): WorldBlockIntersection | undefined;
     getBlockAt(x: number, y: number, z: number): Maybe<BlockInfo<SectionMeshing>>;
@@ -3976,7 +4004,11 @@ declare class Chunk<SectionMeshing extends boolean = false> {
     /** Copies 64 biome IDs in x + z * 4 + y * 16 order and refreshes placed blocks. Omit the array to clear biome data. */
     setBiomes(biomes?: readonly string[]): Promise<void>;
     /** Rebuilds biome-tinted blocks while preserving hidden blocks and unrelated render objects. */
-    refreshBiomes(): Promise<void>;
+    refreshBiomes(columns?: readonly {
+        x: number;
+        z: number;
+    }[]): Promise<void>;
+    private refreshBiomeBlocks;
     /**
      * Places a block at integer world block coordinates. Pass `undefined` to remove it.
      */
@@ -3992,8 +4024,11 @@ declare class Chunk<SectionMeshing extends boolean = false> {
         index: number;
         block: Maybe<Block>;
     }[]): Promise<Vector3[]>;
+    private changeBlocks;
+    private replaceBlocks;
     /** Replaces every cell from parsed section data. The caller refreshes neighbor culling. */
     placeSection(data: ChunkData): Promise<void>;
+    private replaceSection;
     private positionAt;
     /** Refreshes saved lighting after adjacent columns load or unload, including columns with only light data. */
     refreshLight(indices?: Iterable<number>): Promise<void>;
@@ -4005,6 +4040,7 @@ declare class Chunk<SectionMeshing extends boolean = false> {
     private setWaterTint;
     /** Changes visibility at world block coordinates while preserving the block's data. */
     setBlockVisibleAt(pos: Vector3, visible: boolean): Promise<void>;
+    private setBlockVisibility;
     isBlockVisibleAt(pos: Vector3): boolean;
     /** Reports whether a cell has a visible render object or section entry. */
     isBlockVisibleIndex(index: number): boolean;
@@ -4069,6 +4105,10 @@ declare class MineRenderWorld<SectionMeshing extends boolean = false> {
     private readonly ambientLight;
     private _ambientOcclusion;
     private ambientOcclusionPending;
+    private _biomeBlendRadius;
+    private biomeBlend?;
+    private readonly pendingBiomes;
+    private biomeRefreshing?;
     private readonly sectionModels?;
     private readonly entities?;
     private readonly pendingCulling;
@@ -4089,6 +4129,12 @@ declare class MineRenderWorld<SectionMeshing extends boolean = false> {
     get ambientOcclusion(): boolean;
     /** Rebuilds loaded blocks with or without corner shading. Block data and saved lighting are preserved. */
     setAmbientOcclusion(enabled: boolean): Promise<void>;
+    /** Horizontal biome-color sampling radius, from 0 to 7 blocks. Zero disables blending. */
+    get biomeBlendRadius(): number;
+    /** Refreshes loaded grass, foliage, and water colors without reloading their source chunks. */
+    setBiomeBlendRadius(radius: number): Promise<void>;
+    private markBiomesChanged;
+    private refreshBiomes;
     /** Returns a placed block at world block coordinates, or `undefined` for an empty position. */
     getBlockAt(x: number, y: number, z: number): Maybe<BlockInfo<SectionMeshing>>;
     getBlockAt(pos: Vector3): Maybe<BlockInfo<SectionMeshing>>;
@@ -4164,6 +4210,8 @@ interface MineRenderWorldOptions<SectionMeshing extends boolean = boolean> {
     ambientLight?: number;
     /** Bake corner shading from neighboring opaque full cubes. Defaults to false; no per-frame shading pass is added. Requires `sectionMeshing`. */
     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. */
     maxAtlasSize?: number;
 }

package/dist/node/index.d.ts

@@ -2651,6 +2651,9 @@ interface BedrockGeometryFile {
 
 /** Shared in-memory caches for loaded assets and render resources. Persistent stores are managed separately. */
 declare class Caching {
+    private static _generation;
+    /** Changes when shared assets are cleared, so derived caches can discard their old values. */
+    static get generation(): number;
     static readonly rawImageCache: AsyncLoadingCache<CacheKey, ImageInfo>;
     static readonly imageDataCache: AsyncLoadingCache<CacheKey, ImageData>;
     static readonly canvasImageDataCache: AsyncLoadingCache<CacheKey, ExtractableImageData>;
@@ -3788,6 +3791,7 @@ interface SectionTemplateData {
     colors: Float32Array;
     indices: Uint16Array;
     cullFaces: Uint8Array;
+    biomeTint?: Uint8Array;
     atlas: number;
     layer: number;
     ambientOcclusion?: boolean;
@@ -3820,6 +3824,8 @@ interface SectionGeometryInput {
     indices: Uint16Array;
     templates: Uint16Array;
     cullMasks: Uint8Array;
+    /** Linear RGB per placement; three NaN values preserve the template's colors. */
+    biomeTints?: Float32Array;
     templateData: SectionTemplateData[];
     atlases: SectionAtlasSize[];
     maxAtlasSize: number;
@@ -3860,6 +3866,8 @@ interface SectionMeshTemplate {
     geometry: BufferGeometry;
     atlas: TextureAtlas;
     cullFaces: Uint8Array;
+    /** Quads that accept a placement's biome tint, stored as zero or one. */
+    biomeTint?: Uint8Array;
     occludes: boolean;
     /** Whether the model permits corner shading from neighboring full cubes. */
     ambientOcclusion?: boolean;
@@ -3870,6 +3878,8 @@ interface SectionMeshEntry {
     index: number;
     template: SectionMeshTemplate;
     cullMask: number;
+    /** Linear RGB replacing automatic biome colors on eligible quads. */
+    biomeTint?: readonly [number, number, number];
 }
 /** Fluid cells for one section and the shared atlases of the kinds present. */
 interface SectionFluids {
@@ -3903,9 +3913,10 @@ declare class SectionModels {
     constructor(maxAtlasSize?: number);
     /** Returns templates for the matched parts, or `undefined` when the block needs an individual render object. */
     get(blockState: BlockState, properties?: BlockStateProperties, position?: Readonly<TripleArray>, biome?: string): Promise<SectionMeshTemplate[] | undefined>;
-    /** Resolves section templates for one tint palette, with a synchronous weighted choice for each cell. */
-    prepareState(blockState: BlockState, properties?: BlockStateProperties, biomeColor?: number | (() => Promise<number | undefined>)): Promise<{
+    /** Resolves shared templates; dynamic biome tints are supplied on section placements instead of cached geometry. */
+    prepareState(blockState: BlockState, properties?: BlockStateProperties, biomeColor?: number | (() => Promise<number | undefined>), dynamicBiomeTint?: boolean): Promise<{
         pick(position?: Readonly<TripleArray>): SectionMeshTemplate[];
+        biomeTint?: boolean;
     } | undefined>;
     private state;
     /** Returns the shared still/flow atlas used by per-block fluid objects. */
@@ -3916,6 +3927,20 @@ declare class SectionModels {
     clear(): void;
 }
 
+/** Caches horizontal color averages for saved quart-resolution biome samples. */
+declare class BiomeBlend {
+    private readonly biomeAt;
+    private readonly tiles;
+    private generation;
+    private _radius;
+    constructor(biomeAt: (x: number, y: number, z: number) => string | undefined, radius: number);
+    get radius(): number;
+    clear(): void;
+    invalidateColumn(x: number, z: number): void;
+    getColor(kind: BiomeColorKind, origin: AssetKey | undefined, position: Readonly<TripleArray>): Promise<number | undefined>;
+    private buildTile;
+}
+
 /** The nearest rendered block triangle hit by a world raycast. */
 interface WorldBlockIntersection {
     /** Integer world block coordinates of the geometry's owner. */
@@ -3946,6 +3971,7 @@ declare class Chunk<SectionMeshing extends boolean = false> {
     private readonly lightAt?;
     private readonly onLightCleared?;
     private readonly ambientLight;
+    private readonly biomeBlend?;
     readonly scene: MineRenderScene;
     readonly x: number;
     readonly y: number;
@@ -3963,7 +3989,9 @@ declare class Chunk<SectionMeshing extends boolean = false> {
     private meshDirty;
     private meshGeneration;
     private ambientOcclusionCells?;
-    constructor(scene: MineRenderScene, x: number, y: number, z: number, onBlocksChanged?: ((positions: Vector3[]) => Promise<void>) | undefined, sectionModels?: SectionModels | undefined, neighborCell?: ((x: number, y: number, z: number) => number) | undefined, biomeAt?: ((x: number, y: number, z: number) => Maybe<string>) | undefined, onBiomesChanged?: ((biomes?: readonly string[]) => Promise<void>) | undefined, lightAt?: ((x: number, y: number, z: number) => number) | undefined, onLightCleared?: (() => Promise<void>) | undefined, ambientLight?: number);
+    private readonly blockChanges;
+    private biomeChange?;
+    constructor(scene: MineRenderScene, x: number, y: number, z: number, onBlocksChanged?: ((positions: Vector3[]) => Promise<void>) | undefined, sectionModels?: SectionModels | undefined, neighborCell?: ((x: number, y: number, z: number) => number) | undefined, biomeAt?: ((x: number, y: number, z: number) => Maybe<string>) | undefined, onBiomesChanged?: ((biomes?: readonly string[]) => Promise<void>) | undefined, lightAt?: ((x: number, y: number, z: number) => number) | undefined, onLightCleared?: (() => Promise<void>) | undefined, ambientLight?: number, biomeBlend?: (() => BiomeBlend | undefined) | undefined);
     /** Finds the nearest owned block hit across sections, testing each shared mesh once. */
     static raycast<SectionMeshing extends boolean>(chunks: Iterable<Chunk<SectionMeshing>>, raycaster: Raycaster): WorldBlockIntersection | undefined;
     getBlockAt(x: number, y: number, z: number): Maybe<BlockInfo<SectionMeshing>>;
@@ -3976,7 +4004,11 @@ declare class Chunk<SectionMeshing extends boolean = false> {
     /** Copies 64 biome IDs in x + z * 4 + y * 16 order and refreshes placed blocks. Omit the array to clear biome data. */
     setBiomes(biomes?: readonly string[]): Promise<void>;
     /** Rebuilds biome-tinted blocks while preserving hidden blocks and unrelated render objects. */
-    refreshBiomes(): Promise<void>;
+    refreshBiomes(columns?: readonly {
+        x: number;
+        z: number;
+    }[]): Promise<void>;
+    private refreshBiomeBlocks;
     /**
      * Places a block at integer world block coordinates. Pass `undefined` to remove it.
      */
@@ -3992,8 +4024,11 @@ declare class Chunk<SectionMeshing extends boolean = false> {
         index: number;
         block: Maybe<Block>;
     }[]): Promise<Vector3[]>;
+    private changeBlocks;
+    private replaceBlocks;
     /** Replaces every cell from parsed section data. The caller refreshes neighbor culling. */
     placeSection(data: ChunkData): Promise<void>;
+    private replaceSection;
     private positionAt;
     /** Refreshes saved lighting after adjacent columns load or unload, including columns with only light data. */
     refreshLight(indices?: Iterable<number>): Promise<void>;
@@ -4005,6 +4040,7 @@ declare class Chunk<SectionMeshing extends boolean = false> {
     private setWaterTint;
     /** Changes visibility at world block coordinates while preserving the block's data. */
     setBlockVisibleAt(pos: Vector3, visible: boolean): Promise<void>;
+    private setBlockVisibility;
     isBlockVisibleAt(pos: Vector3): boolean;
     /** Reports whether a cell has a visible render object or section entry. */
     isBlockVisibleIndex(index: number): boolean;
@@ -4069,6 +4105,10 @@ declare class MineRenderWorld<SectionMeshing extends boolean = false> {
     private readonly ambientLight;
     private _ambientOcclusion;
     private ambientOcclusionPending;
+    private _biomeBlendRadius;
+    private biomeBlend?;
+    private readonly pendingBiomes;
+    private biomeRefreshing?;
     private readonly sectionModels?;
     private readonly entities?;
     private readonly pendingCulling;
@@ -4089,6 +4129,12 @@ declare class MineRenderWorld<SectionMeshing extends boolean = false> {
     get ambientOcclusion(): boolean;
     /** Rebuilds loaded blocks with or without corner shading. Block data and saved lighting are preserved. */
     setAmbientOcclusion(enabled: boolean): Promise<void>;
+    /** Horizontal biome-color sampling radius, from 0 to 7 blocks. Zero disables blending. */
+    get biomeBlendRadius(): number;
+    /** Refreshes loaded grass, foliage, and water colors without reloading their source chunks. */
+    setBiomeBlendRadius(radius: number): Promise<void>;
+    private markBiomesChanged;
+    private refreshBiomes;
     /** Returns a placed block at world block coordinates, or `undefined` for an empty position. */
     getBlockAt(x: number, y: number, z: number): Maybe<BlockInfo<SectionMeshing>>;
     getBlockAt(pos: Vector3): Maybe<BlockInfo<SectionMeshing>>;
@@ -4164,6 +4210,8 @@ interface MineRenderWorldOptions<SectionMeshing extends boolean = boolean> {
     ambientLight?: number;
     /** Bake corner shading from neighboring opaque full cubes. Defaults to false; no per-frame shading pass is added. Requires `sectionMeshing`. */
     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. */
     maxAtlasSize?: number;
 }