minerender 2.1.0-beta.6 → 2.1.0-beta.8

package/dist/node/index.d.ts

@@ -251,6 +251,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 {
@@ -785,7 +794,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;
@@ -915,6 +927,33 @@ 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";
+
 /** Runs queued tasks in bounded batches. Idle executors do not keep a timer running. */
 declare class BatchedExecutor {
     readonly interval: number;
@@ -932,6 +971,34 @@ declare class BatchedExecutor {
 }
 type Task<T = unknown> = () => T | Promise<T>;
 
+/** Severity of a log message, from most to least verbose. */
+type LogLevel = "debug" | "info" | "warn" | "error";
+/** The lowest level that is printed, or `"silent"` to print nothing. */
+type LogThreshold = LogLevel | "silent";
+/** Receives each message that passes the threshold. `args` are the logger call's arguments, without a tag. */
+type LogHandler = (level: LogLevel, namespace: string, args: unknown[]) => void;
+interface LoggingOptions {
+    /** Threshold for namespaces without an override. Starts at `"warn"`. */
+    level?: LogThreshold;
+    /** Thresholds by logger name, such as `{ UVMapper: "debug" }`. Replaces earlier overrides. */
+    namespaces?: Record<string, LogThreshold>;
+}
+interface Logger {
+    debug(...args: unknown[]): void;
+    info(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+}
+/** Global log settings for every MineRender logger. */
+declare class Logging {
+    /** Updates the given settings and keeps the others. */
+    static configure(options: LoggingOptions): void;
+    /** Sends messages to `handler` instead of the console. Call without an argument to restore console output. */
+    static setHandler(handler?: LogHandler): void;
+}
+/** Creates a logger whose messages are tagged and filtered as `namespace`. */
+declare function logger(namespace: string): Logger;
+/** @deprecated Use {@link logger}. */
 declare function prefix(prefix?: string): string;
 
 /** Rotates geometry in place around the element's origin. The supplied angle is in degrees. */
@@ -943,8 +1010,11 @@ declare function addWireframeToObject(obj: Object3D, color?: number, w?: number)
 /** Adds edge and axis helpers to a mesh and returns a function that disposes their resources. */
 declare function addWireframeToMesh(geo: BufferGeometry, mesh: Mesh, color?: number, w?: number): () => void;
 
+/** @deprecated Unused by MineRender. */
 declare function captureException(e: any, ...extra: any[]): void;
+/** @deprecated Unused by MineRender. */
 declare function timingStart(marker: string): void;
+/** @deprecated Unused by MineRender. */
 declare function timingEnd(marker: string): void;
 
 declare function sha1(str: string): string;
@@ -1059,8 +1129,6 @@ type MultipartCondition = Record<string, string> | {
     AND: MultipartCondition[];
 };
 
-declare const DEFAULT_ROOT = "https://assets.mcasset.cloud/1.21.11";
-declare const DEFAULT_NAMESPACE = "minecraft";
 /** Convenience accessors for model and blockstate loading. */
 declare class Assets {
     /**
@@ -1229,9 +1297,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. */
@@ -1645,6 +1720,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>;
@@ -1702,7 +1778,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[]>;
@@ -1753,6 +1829,7 @@ declare class BlockObject extends SceneObject {
      */
     private createBlockEntities;
     private placeEntities;
+    private placeEntity;
     get isOccluding(): boolean;
     private getModelMatrix;
     private getModelCullMask;
@@ -1875,7 +1952,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[];
 
@@ -1891,6 +1970,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;
@@ -1906,9 +1988,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;
@@ -1920,6 +2013,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. */
@@ -2192,7 +2289,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
@@ -2461,11 +2558,21 @@ interface Palette {
     };
 }
 interface PaletteEntry {
-    Name: {
+    Name?: {
         type: "string";
         value: string;
     };
-    Properties: {
+    id?: {
+        type: "string";
+        value: string;
+    };
+    Properties?: {
+        type: "compound";
+        value: {
+            [property: string]: PalettePropertyValue;
+        };
+    };
+    properties?: {
         type: "compound";
         value: {
             [property: string]: PalettePropertyValue;
@@ -2693,6 +2800,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;
@@ -2705,7 +2814,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>;
@@ -2713,12 +2822,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>;
@@ -3402,9 +3514,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[];
@@ -3451,8 +3566,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;
@@ -3600,6 +3724,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;
@@ -3963,6 +4095,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>;
@@ -4036,7 +4170,7 @@ declare class Chunk<SectionMeshing extends boolean = false> {
     private ambientOcclusionCells?;
     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);
+    constructor(scene: MineRenderScene, x: number, y: number, z: number, onBlocksChanged?: ((positions: Vector3[], deferCulling?: boolean) => 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>>;
@@ -4048,11 +4182,14 @@ declare class Chunk<SectionMeshing extends boolean = false> {
     getBiomeAt(pos: TripleArray): Maybe<string>;
     /** 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. */
+    /**
+     * Rebuilds biome-tinted blocks while preserving hidden blocks and unrelated render objects.
+     * The owning world can defer neighbor culling until all affected chunks are refreshed.
+     */
     refreshBiomes(columns?: readonly {
         x: number;
         z: number;
-    }[]): Promise<void>;
+    }[], deferCulling?: boolean): Promise<void>;
     private refreshBiomeBlocks;
     /**
      * Places a block at integer world block coordinates. Pass `undefined` to remove it.
@@ -4063,7 +4200,7 @@ declare class Chunk<SectionMeshing extends boolean = false> {
     /**
      * Places a block at integer chunk-local coordinates from 0 to 15.
      */
-    setBlockInChunkAt(pos: Vector3, block?: Block, worldPos?: Vector3, onBlocksChanged?: ((positions: Vector3[]) => Promise<void>) | undefined): Promise<Maybe<BlockInfo<SectionMeshing>>>;
+    setBlockInChunkAt(pos: Vector3, block?: Block, worldPos?: Vector3, onBlocksChanged?: ((positions: Vector3[], deferCulling?: boolean) => Promise<void>) | undefined): Promise<Maybe<BlockInfo<SectionMeshing>>>;
     /** Places cells in input order and returns changed world positions without refreshing neighbors. */
     placeBlocks(blocks: readonly {
         index: number;
@@ -4074,6 +4211,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>;
@@ -4223,11 +4361,25 @@ 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.
      */
     unloadChunkColumn(x: number, z: number): Promise<void>;
+    /**
+     * Removes chunk columns together and refreshes surviving neighbors once.
+     * Coordinates are absolute chunk columns. Duplicate and missing columns are ignored.
+     */
+    unloadChunkColumns(positions: readonly {
+        x: number;
+        z: number;
+    }[]): Promise<void>;
     private clearChunkColumn;
     private markSectionChanged;
     /** Removes all chunks and releases their blocks, section meshes, and owned entities. */
@@ -4247,7 +4399,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;
@@ -4257,7 +4409,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;
 }
 
@@ -4302,10 +4454,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" | "unloadChunkColumn">, 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;
@@ -4338,8 +4491,12 @@ 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 unload;
+    private unloadMany;
     private validateChunk;
     private within;
     private key;
@@ -4373,6 +4530,7 @@ declare function registerNodeEnv(): NodeEnv;
  */
 declare class NodeCache extends PersistentCache<LocalStorage> {
     private initialized;
+    private readonly pendingWrites;
     constructor(backing: LocalStorage);
     private ready;
     get<T>(key: string): Promise<T>;
@@ -4418,4 +4576,4 @@ declare class NodeRenderer extends Renderer {
     dispose(): void;
 }
 
-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, 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, 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, NodeCache, NodeEnv, type NodeImageOptions, NodeRenderer, type NodeRendererOptions, 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, md5, mergeBufferAttributes, mergeBufferGeometries, mergeVertices, parseSceneDocument, prefix, registerNodeEnv, 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, 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, NodeCache, NodeEnv, type NodeImageOptions, NodeRenderer, type NodeRendererOptions, 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, registerNodeEnv, 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 };