minerender 2.1.0-alpha.67 → 2.1.0-alpha.69

package/dist/node/index.d.mts

@@ -522,8 +522,29 @@ declare class MinecraftCubeTexture {
 }
 
 interface MinecraftTextureMeta extends MinecraftAsset {
-    animation: AnimationMeta;
+    animation?: AnimationMeta;
+    gui?: {
+        scaling?: GuiSpriteScaling;
+    };
 }
+type GuiSpriteScaling = {
+    type: "stretch";
+} | {
+    type: "tile";
+    width: number;
+    height: number;
+} | {
+    type: "nine_slice";
+    width: number;
+    height: number;
+    border: number | {
+        left: number;
+        top: number;
+        right: number;
+        bottom: number;
+    };
+    stretch_inner?: boolean;
+};
 interface AnimationMeta {
     interpolate: boolean;
     width: number;
@@ -972,6 +993,27 @@ interface EntityModelOptions {
     textures?: Record<string, BasicAssetKey>;
 }
 
+interface BitmapGlyph {
+    image?: CompatCanvas;
+    /** Source rectangle in the bitmap sheet, before applying scale. */
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    scale: number;
+    ascent: number;
+    advance: number;
+}
+interface BitmapFont {
+    glyphs: Map<string, BitmapGlyph>;
+}
+declare class Fonts {
+    static get(key?: AssetKey | string): Promise<BitmapFont>;
+    private static relatedKey;
+    private static load;
+    private static bitmap;
+}
+
 declare class Models {
     private static _persistentCache;
     private static get PERSISTENT_CACHE();
@@ -1291,18 +1333,61 @@ interface EntityObjectOptions extends SceneObjectOptions {
 }
 declare function isEntityObject(obj: any): obj is EntityObject;
 
+interface GuiTextStyle {
+    /** sRGB 0xRRGGBB; defaults to white. */
+    color?: number;
+    bold?: boolean;
+    italic?: boolean;
+}
+interface GuiTextRun extends GuiTextStyle {
+    text: string;
+}
+/** Literal text, or styled runs. Newlines are preserved. */
+type GuiText = string | readonly GuiTextRun[];
+interface GuiTextOptions extends GuiTextStyle {
+    /** Font resource ID; defaults to minecraft:default. */
+    font?: AssetKey | string;
+    /** Draws a one-pixel shadow; defaults to true. */
+    shadow?: boolean;
+    /** Wrap width in GUI pixels. Long words break at glyph boundaries. */
+    maxWidth?: number;
+    /** Distance between line origins; defaults to 9 GUI pixels. */
+    lineHeight?: number;
+}
+interface PositionedGuiGlyph {
+    character: string;
+    glyph?: BitmapGlyph;
+    x: number;
+    y: number;
+    advance: number;
+    style: Required<GuiTextStyle>;
+}
+interface GuiTextLayout {
+    glyphs: PositionedGuiGlyph[];
+    lineWidths: number[];
+    width: number;
+    height: number;
+}
+/** Measures and wraps text using the same glyph advances used for rendering. */
+declare function layoutGuiText(text: GuiText, options?: GuiTextOptions): Promise<GuiTextLayout>;
+/** Creates glyph batches in painter order. Unsupported characters use an outlined missing glyph. */
+declare function createGuiTextGeometry(layout: GuiTextLayout, shadow?: boolean): {
+    image?: CompatCanvas;
+    geometry: BufferGeometry;
+}[];
+
 /** GUI layers use pixel coordinates. Later layers draw above earlier layers. */
-type GuiLayer = GuiTextureLayer | GuiItemLayer;
+type GuiLayer = GuiTextureLayer | GuiItemLayer | GuiTextLayer;
 interface GuiLayerLayout {
     name?: string;
     /** Top-left position; x grows right and y grows down. Defaults to [0, 0]. */
     position?: [number, number];
-    /** Output width and height; defaults to the texture crop size or [16, 16] for items. */
+    /** Output size; defaults to native texture/text dimensions, and [16, 16] for items. */
     size?: [number, number];
 }
 interface GuiTextureLayer extends GuiLayerLayout {
     texture: AssetKey | string;
-    /** Source-image pixels: [x, y, width, height], measured from the top left. */
+    /** Source-image pixels: [x, y, width, height], measured from the top left. Crops ignore sprite scaling. */
     crop?: [number, number, number, number];
 }
 interface GuiItemLayer extends GuiLayerLayout {
@@ -1311,6 +1396,9 @@ interface GuiItemLayer extends GuiLayerLayout {
     /** sRGB 0xRRGGBB colors by face tint index; omitted indices stay white. */
     tints?: Record<number, number>;
 }
+interface GuiTextLayer extends GuiLayerLayout, GuiTextOptions {
+    text: GuiText;
+}
 
 declare class GuiObject extends SceneObject {
     readonly textureLayers: readonly GuiLayer[];
@@ -1319,6 +1407,7 @@ declare class GuiObject extends SceneObject {
     readonly bounds: Box2;
     private readonly geometries;
     private readonly ownedMaterials;
+    private readonly textMaterials;
     private initialized;
     constructor(textureLayers: readonly GuiLayer[], options?: Partial<GuiObjectOptions>);
     init(): Promise<void>;
@@ -1814,6 +1903,7 @@ declare class Caching {
     static readonly entityTextureCache: AsyncLoadingCache<CacheKey, AssetKey>;
     static readonly entityAnimationCache: AsyncLoadingCache<CacheKey, EntityAnimationFile>;
     static readonly blockEntityIndexCache: AsyncLoadingCache<CacheKey, BlockEntityIndex>;
+    static readonly fontCache: AsyncLoadingCache<CacheKey, BitmapFont>;
     private static createAssetCache;
     /** Every cache above, so clear()/end() can never fall out of sync with the field list again. */
     private static get all();
@@ -1856,10 +1946,18 @@ declare class SceneExporter {
 }
 
 declare class GuiHelper {
+    /** Sizes a tooltip around supplied text; the first entry is its title. */
+    static tooltip(lines: readonly GuiText[], options?: GuiTooltipOptions): Promise<GuiLayer[]>;
     static inventorySlot(slot: number | [number, number], origin?: [number, number], offset?: [number, number], rowSize?: number): [number, number];
     /** Creates crafting-table layers for ingredients and the result; stack counts are not drawn. */
     static recipe(recipe: GuiRecipe, options?: GuiRecipeOptions): GuiLayer[];
 }
+interface GuiTooltipOptions extends GuiTextOptions {
+    /** Top-left text position, inside the tooltip's padding. */
+    position?: [number, number];
+    /** Extra space after the title, in pixels. Defaults to 2. */
+    titleGap?: number;
+}
 type GuiRecipeIngredientValue = string | {
     item: string;
 } | {
@@ -1887,6 +1985,9 @@ interface GuiRecipeOptions {
     resolveIngredient?: (ingredient: GuiRecipeIngredient) => string | AssetKey;
 }
 
+/** Builds one centered mesh; explicit source-pixel crops always stretch. */
+declare function createGuiTextureGeometry(width: number, height: number, imageWidth: number, imageHeight: number, crop?: [number, number, number, number], scaling?: GuiSpriteScaling): BufferGeometry;
+
 declare class OrbitControls {
     constructor(object: Camera, domElement?: HTMLElement);
 
@@ -2428,4 +2529,4 @@ declare class NodeCache extends PersistentCache<LocalStorage> {
     forEach<T>(callback: (v: T, k: string) => void): Promise<void>;
 }
 
-export { AXES, type AnimationFrame, type AnimationMeta, type AnimatorFunction, type AnvilChunk, AnvilParser, type AnvilRegion, ArchiveAssetSource, type ArchiveEntry, type ArchiveProxy, AssetKey, AssetLoadError, AssetLoader, AssetParser, AssetSource, type AssetType, Assets, Axis, BUILTIN_ENTITY, BUILTIN_GENERATED, BasicAssetKey, type BasicMinecraftAsset, BatchedExecutor, type BedrockBone, type BedrockCube, type BedrockEntityDescription, type BedrockEntityFile, type BedrockGeometry, type BedrockGeometryFile, 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 ControlsOptions, CubeFace, CubeFaceIndex, DEFAULT_ELEMENTS, DEFAULT_NAMESPACE, DEFAULT_ROOT, DEFAULT_UV, DISPLAY_POSITIONS, type DebugOptions, type DeepPartial, DefaultBlockStates, DisplayPosition, DisplayTransforms, type Disposable, type DoubleArray, 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 FluidSample, type FluidSampler, type FrameCallback, type FromTo, Geometries, GuiHelper, type GuiItemLayer, type GuiLayer, GuiLight, GuiObject, type GuiObjectOptions, type GuiRecipe, type GuiRecipeIngredient, type GuiRecipeOptions, type GuiTextureLayer, HostedAssetSource, type IModelTextures, ITEM_GENERATED, type ImageInfo, ImageLoader, type ImageSizeInfo, InstanceManager, InstanceReference, type Instanceable, type ItemModel, type ItemModelTextures, type ItemTintColor, type ItemTintSource, ItemTints, type ListAsset, MapControls, type MaterialKey, Materials, type Maybe, type MeshKey, Meshes, 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, OrbitControls, PersistentCache, type QuadArray, type RawImageKey, type RenderOptions, Renderer, type RendererFrame, type RendererOptions, type RequestConfig, RequestError, type RequestResponse, Requests, type ResolvedBlockEntity, type ResponseParser, SKIN_PARTS, SceneExporter, type SceneGLTFExportOptions, SceneInspector, SceneObject, type SceneObjectOptions, SceneStats, SceneStatsDisplay, SchematicParser, SectionMesh, type SectionMeshEntry, type SectionMeshTemplate, SectionModels, type Serializable, type SkinGeometries, SkinImage, SkinObject, type SkinObjectOptions, SkinPart, type SkinTexture, type SkinTextureCoordinates, SkinTextures, Skins, type SpecialItemPart, type SpecialItemRenderer, SpecialItems, type StructureNBT, StructureParser, type TextureAsset, TextureAtlas, type TextureKey, TextureLoader, Textures, Ticker, type TickerFunction, TintColors, type Transformable, type TripleArray, UVMapper, WrappedImage, addBox3WireframeToObject, addWireframeToMesh, addWireframeToObject, applyElementRotation, applyGenericRotation, axisToVec3, base64decode, base64encode, capeTextureSizes, captureException, changeEvent, clampRotationDegrees, classicSkinGeometries, classicSkinTextureCoordinates, computeMorphedAttributes, createCanvas, createFluidGeometry, createImage, entityAnimationTime, estimateBytesUsed, getBlockFluidState, getFluidKind, interleaveAttributes, isAssetKey, isBasicAssetKey, isBlockObject, isDisposable, isDoubleArray, isEntityObject, isGuiObject, isInstanceManager, isInstanceReference, isInstanceable, isInstancedMesh, isMesh, isMineRenderScene, isModelObject, isObject3D, isOrthographicCamera, isPerspectiveCamera, isQuadArray, isSceneObject, isTransformable, isTripleArray, isVector3, md5, mergeBufferAttributes, mergeBufferGeometries, mergeVertices, prefix, registerNodeEnv, sampleEntityAnimation, sampleEntityKeyframes, sampleFluid, serializeBoxGeometryKey, serializeImageKey, serializeMaterialKey, serializeMeshKey, serializeTextureKey, sha1, sha256, sha512, shutdown, sleep, slimSkinGeometries, slimSkinTextureCoordinates, timingEnd, timingStart, toDegrees, toRadians, toTrianglesDrawMode, trimCanvas };
+export { AXES, type AnimationFrame, type AnimationMeta, type AnimatorFunction, type AnvilChunk, AnvilParser, type AnvilRegion, ArchiveAssetSource, type ArchiveEntry, type ArchiveProxy, AssetKey, AssetLoadError, AssetLoader, AssetParser, AssetSource, type AssetType, Assets, Axis, BUILTIN_ENTITY, BUILTIN_GENERATED, BasicAssetKey, type BasicMinecraftAsset, BatchedExecutor, type BedrockBone, type BedrockCube, type BedrockEntityDescription, type BedrockEntityFile, type BedrockGeometry, type BedrockGeometryFile, 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 ControlsOptions, CubeFace, CubeFaceIndex, DEFAULT_ELEMENTS, DEFAULT_NAMESPACE, DEFAULT_ROOT, DEFAULT_UV, DISPLAY_POSITIONS, type DebugOptions, type DeepPartial, DefaultBlockStates, DisplayPosition, DisplayTransforms, type Disposable, type DoubleArray, 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 FluidSample, type FluidSampler, Fonts, type FrameCallback, type FromTo, Geometries, 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, type ItemModel, type ItemModelTextures, type ItemTintColor, type ItemTintSource, ItemTints, type ListAsset, MapControls, type MaterialKey, Materials, type Maybe, type MeshKey, Meshes, 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, OrbitControls, PersistentCache, type PositionedGuiGlyph, type QuadArray, type RawImageKey, type RenderOptions, Renderer, type RendererFrame, type RendererOptions, type RequestConfig, RequestError, type RequestResponse, Requests, type ResolvedBlockEntity, type ResponseParser, SKIN_PARTS, SceneExporter, type SceneGLTFExportOptions, SceneInspector, SceneObject, type SceneObjectOptions, SceneStats, SceneStatsDisplay, SchematicParser, SectionMesh, type SectionMeshEntry, type SectionMeshTemplate, SectionModels, type Serializable, type SkinGeometries, SkinImage, SkinObject, type SkinObjectOptions, SkinPart, type SkinTexture, type SkinTextureCoordinates, SkinTextures, Skins, type SpecialItemPart, type SpecialItemRenderer, SpecialItems, type StructureNBT, StructureParser, type TextureAsset, TextureAtlas, type TextureKey, TextureLoader, Textures, Ticker, type TickerFunction, TintColors, type Transformable, type TripleArray, UVMapper, WrappedImage, addBox3WireframeToObject, addWireframeToMesh, addWireframeToObject, applyElementRotation, applyGenericRotation, axisToVec3, base64decode, base64encode, capeTextureSizes, captureException, changeEvent, clampRotationDegrees, classicSkinGeometries, classicSkinTextureCoordinates, computeMorphedAttributes, createCanvas, createFluidGeometry, createGuiTextGeometry, createGuiTextureGeometry, createImage, entityAnimationTime, estimateBytesUsed, getBlockFluidState, getFluidKind, interleaveAttributes, isAssetKey, isBasicAssetKey, isBlockObject, isDisposable, isDoubleArray, isEntityObject, isGuiObject, isInstanceManager, isInstanceReference, isInstanceable, isInstancedMesh, isMesh, isMineRenderScene, isModelObject, isObject3D, isOrthographicCamera, isPerspectiveCamera, isQuadArray, isSceneObject, isTransformable, isTripleArray, isVector3, layoutGuiText, md5, mergeBufferAttributes, mergeBufferGeometries, mergeVertices, prefix, registerNodeEnv, sampleEntityAnimation, sampleEntityKeyframes, sampleFluid, serializeBoxGeometryKey, serializeImageKey, serializeMaterialKey, serializeMeshKey, serializeTextureKey, sha1, sha256, sha512, shutdown, sleep, slimSkinGeometries, slimSkinTextureCoordinates, timingEnd, timingStart, toDegrees, toRadians, toTrianglesDrawMode, trimCanvas };

package/dist/node/index.d.ts

@@ -522,8 +522,29 @@ declare class MinecraftCubeTexture {
 }
 
 interface MinecraftTextureMeta extends MinecraftAsset {
-    animation: AnimationMeta;
+    animation?: AnimationMeta;
+    gui?: {
+        scaling?: GuiSpriteScaling;
+    };
 }
+type GuiSpriteScaling = {
+    type: "stretch";
+} | {
+    type: "tile";
+    width: number;
+    height: number;
+} | {
+    type: "nine_slice";
+    width: number;
+    height: number;
+    border: number | {
+        left: number;
+        top: number;
+        right: number;
+        bottom: number;
+    };
+    stretch_inner?: boolean;
+};
 interface AnimationMeta {
     interpolate: boolean;
     width: number;
@@ -972,6 +993,27 @@ interface EntityModelOptions {
     textures?: Record<string, BasicAssetKey>;
 }
 
+interface BitmapGlyph {
+    image?: CompatCanvas;
+    /** Source rectangle in the bitmap sheet, before applying scale. */
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    scale: number;
+    ascent: number;
+    advance: number;
+}
+interface BitmapFont {
+    glyphs: Map<string, BitmapGlyph>;
+}
+declare class Fonts {
+    static get(key?: AssetKey | string): Promise<BitmapFont>;
+    private static relatedKey;
+    private static load;
+    private static bitmap;
+}
+
 declare class Models {
     private static _persistentCache;
     private static get PERSISTENT_CACHE();
@@ -1291,18 +1333,61 @@ interface EntityObjectOptions extends SceneObjectOptions {
 }
 declare function isEntityObject(obj: any): obj is EntityObject;
 
+interface GuiTextStyle {
+    /** sRGB 0xRRGGBB; defaults to white. */
+    color?: number;
+    bold?: boolean;
+    italic?: boolean;
+}
+interface GuiTextRun extends GuiTextStyle {
+    text: string;
+}
+/** Literal text, or styled runs. Newlines are preserved. */
+type GuiText = string | readonly GuiTextRun[];
+interface GuiTextOptions extends GuiTextStyle {
+    /** Font resource ID; defaults to minecraft:default. */
+    font?: AssetKey | string;
+    /** Draws a one-pixel shadow; defaults to true. */
+    shadow?: boolean;
+    /** Wrap width in GUI pixels. Long words break at glyph boundaries. */
+    maxWidth?: number;
+    /** Distance between line origins; defaults to 9 GUI pixels. */
+    lineHeight?: number;
+}
+interface PositionedGuiGlyph {
+    character: string;
+    glyph?: BitmapGlyph;
+    x: number;
+    y: number;
+    advance: number;
+    style: Required<GuiTextStyle>;
+}
+interface GuiTextLayout {
+    glyphs: PositionedGuiGlyph[];
+    lineWidths: number[];
+    width: number;
+    height: number;
+}
+/** Measures and wraps text using the same glyph advances used for rendering. */
+declare function layoutGuiText(text: GuiText, options?: GuiTextOptions): Promise<GuiTextLayout>;
+/** Creates glyph batches in painter order. Unsupported characters use an outlined missing glyph. */
+declare function createGuiTextGeometry(layout: GuiTextLayout, shadow?: boolean): {
+    image?: CompatCanvas;
+    geometry: BufferGeometry;
+}[];
+
 /** GUI layers use pixel coordinates. Later layers draw above earlier layers. */
-type GuiLayer = GuiTextureLayer | GuiItemLayer;
+type GuiLayer = GuiTextureLayer | GuiItemLayer | GuiTextLayer;
 interface GuiLayerLayout {
     name?: string;
     /** Top-left position; x grows right and y grows down. Defaults to [0, 0]. */
     position?: [number, number];
-    /** Output width and height; defaults to the texture crop size or [16, 16] for items. */
+    /** Output size; defaults to native texture/text dimensions, and [16, 16] for items. */
     size?: [number, number];
 }
 interface GuiTextureLayer extends GuiLayerLayout {
     texture: AssetKey | string;
-    /** Source-image pixels: [x, y, width, height], measured from the top left. */
+    /** Source-image pixels: [x, y, width, height], measured from the top left. Crops ignore sprite scaling. */
     crop?: [number, number, number, number];
 }
 interface GuiItemLayer extends GuiLayerLayout {
@@ -1311,6 +1396,9 @@ interface GuiItemLayer extends GuiLayerLayout {
     /** sRGB 0xRRGGBB colors by face tint index; omitted indices stay white. */
     tints?: Record<number, number>;
 }
+interface GuiTextLayer extends GuiLayerLayout, GuiTextOptions {
+    text: GuiText;
+}
 
 declare class GuiObject extends SceneObject {
     readonly textureLayers: readonly GuiLayer[];
@@ -1319,6 +1407,7 @@ declare class GuiObject extends SceneObject {
     readonly bounds: Box2;
     private readonly geometries;
     private readonly ownedMaterials;
+    private readonly textMaterials;
     private initialized;
     constructor(textureLayers: readonly GuiLayer[], options?: Partial<GuiObjectOptions>);
     init(): Promise<void>;
@@ -1814,6 +1903,7 @@ declare class Caching {
     static readonly entityTextureCache: AsyncLoadingCache<CacheKey, AssetKey>;
     static readonly entityAnimationCache: AsyncLoadingCache<CacheKey, EntityAnimationFile>;
     static readonly blockEntityIndexCache: AsyncLoadingCache<CacheKey, BlockEntityIndex>;
+    static readonly fontCache: AsyncLoadingCache<CacheKey, BitmapFont>;
     private static createAssetCache;
     /** Every cache above, so clear()/end() can never fall out of sync with the field list again. */
     private static get all();
@@ -1856,10 +1946,18 @@ declare class SceneExporter {
 }
 
 declare class GuiHelper {
+    /** Sizes a tooltip around supplied text; the first entry is its title. */
+    static tooltip(lines: readonly GuiText[], options?: GuiTooltipOptions): Promise<GuiLayer[]>;
     static inventorySlot(slot: number | [number, number], origin?: [number, number], offset?: [number, number], rowSize?: number): [number, number];
     /** Creates crafting-table layers for ingredients and the result; stack counts are not drawn. */
     static recipe(recipe: GuiRecipe, options?: GuiRecipeOptions): GuiLayer[];
 }
+interface GuiTooltipOptions extends GuiTextOptions {
+    /** Top-left text position, inside the tooltip's padding. */
+    position?: [number, number];
+    /** Extra space after the title, in pixels. Defaults to 2. */
+    titleGap?: number;
+}
 type GuiRecipeIngredientValue = string | {
     item: string;
 } | {
@@ -1887,6 +1985,9 @@ interface GuiRecipeOptions {
     resolveIngredient?: (ingredient: GuiRecipeIngredient) => string | AssetKey;
 }
 
+/** Builds one centered mesh; explicit source-pixel crops always stretch. */
+declare function createGuiTextureGeometry(width: number, height: number, imageWidth: number, imageHeight: number, crop?: [number, number, number, number], scaling?: GuiSpriteScaling): BufferGeometry;
+
 declare class OrbitControls {
     constructor(object: Camera, domElement?: HTMLElement);
 
@@ -2428,4 +2529,4 @@ declare class NodeCache extends PersistentCache<LocalStorage> {
     forEach<T>(callback: (v: T, k: string) => void): Promise<void>;
 }
 
-export { AXES, type AnimationFrame, type AnimationMeta, type AnimatorFunction, type AnvilChunk, AnvilParser, type AnvilRegion, ArchiveAssetSource, type ArchiveEntry, type ArchiveProxy, AssetKey, AssetLoadError, AssetLoader, AssetParser, AssetSource, type AssetType, Assets, Axis, BUILTIN_ENTITY, BUILTIN_GENERATED, BasicAssetKey, type BasicMinecraftAsset, BatchedExecutor, type BedrockBone, type BedrockCube, type BedrockEntityDescription, type BedrockEntityFile, type BedrockGeometry, type BedrockGeometryFile, 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 ControlsOptions, CubeFace, CubeFaceIndex, DEFAULT_ELEMENTS, DEFAULT_NAMESPACE, DEFAULT_ROOT, DEFAULT_UV, DISPLAY_POSITIONS, type DebugOptions, type DeepPartial, DefaultBlockStates, DisplayPosition, DisplayTransforms, type Disposable, type DoubleArray, 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 FluidSample, type FluidSampler, type FrameCallback, type FromTo, Geometries, GuiHelper, type GuiItemLayer, type GuiLayer, GuiLight, GuiObject, type GuiObjectOptions, type GuiRecipe, type GuiRecipeIngredient, type GuiRecipeOptions, type GuiTextureLayer, HostedAssetSource, type IModelTextures, ITEM_GENERATED, type ImageInfo, ImageLoader, type ImageSizeInfo, InstanceManager, InstanceReference, type Instanceable, type ItemModel, type ItemModelTextures, type ItemTintColor, type ItemTintSource, ItemTints, type ListAsset, MapControls, type MaterialKey, Materials, type Maybe, type MeshKey, Meshes, 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, OrbitControls, PersistentCache, type QuadArray, type RawImageKey, type RenderOptions, Renderer, type RendererFrame, type RendererOptions, type RequestConfig, RequestError, type RequestResponse, Requests, type ResolvedBlockEntity, type ResponseParser, SKIN_PARTS, SceneExporter, type SceneGLTFExportOptions, SceneInspector, SceneObject, type SceneObjectOptions, SceneStats, SceneStatsDisplay, SchematicParser, SectionMesh, type SectionMeshEntry, type SectionMeshTemplate, SectionModels, type Serializable, type SkinGeometries, SkinImage, SkinObject, type SkinObjectOptions, SkinPart, type SkinTexture, type SkinTextureCoordinates, SkinTextures, Skins, type SpecialItemPart, type SpecialItemRenderer, SpecialItems, type StructureNBT, StructureParser, type TextureAsset, TextureAtlas, type TextureKey, TextureLoader, Textures, Ticker, type TickerFunction, TintColors, type Transformable, type TripleArray, UVMapper, WrappedImage, addBox3WireframeToObject, addWireframeToMesh, addWireframeToObject, applyElementRotation, applyGenericRotation, axisToVec3, base64decode, base64encode, capeTextureSizes, captureException, changeEvent, clampRotationDegrees, classicSkinGeometries, classicSkinTextureCoordinates, computeMorphedAttributes, createCanvas, createFluidGeometry, createImage, entityAnimationTime, estimateBytesUsed, getBlockFluidState, getFluidKind, interleaveAttributes, isAssetKey, isBasicAssetKey, isBlockObject, isDisposable, isDoubleArray, isEntityObject, isGuiObject, isInstanceManager, isInstanceReference, isInstanceable, isInstancedMesh, isMesh, isMineRenderScene, isModelObject, isObject3D, isOrthographicCamera, isPerspectiveCamera, isQuadArray, isSceneObject, isTransformable, isTripleArray, isVector3, md5, mergeBufferAttributes, mergeBufferGeometries, mergeVertices, prefix, registerNodeEnv, sampleEntityAnimation, sampleEntityKeyframes, sampleFluid, serializeBoxGeometryKey, serializeImageKey, serializeMaterialKey, serializeMeshKey, serializeTextureKey, sha1, sha256, sha512, shutdown, sleep, slimSkinGeometries, slimSkinTextureCoordinates, timingEnd, timingStart, toDegrees, toRadians, toTrianglesDrawMode, trimCanvas };
+export { AXES, type AnimationFrame, type AnimationMeta, type AnimatorFunction, type AnvilChunk, AnvilParser, type AnvilRegion, ArchiveAssetSource, type ArchiveEntry, type ArchiveProxy, AssetKey, AssetLoadError, AssetLoader, AssetParser, AssetSource, type AssetType, Assets, Axis, BUILTIN_ENTITY, BUILTIN_GENERATED, BasicAssetKey, type BasicMinecraftAsset, BatchedExecutor, type BedrockBone, type BedrockCube, type BedrockEntityDescription, type BedrockEntityFile, type BedrockGeometry, type BedrockGeometryFile, 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 ControlsOptions, CubeFace, CubeFaceIndex, DEFAULT_ELEMENTS, DEFAULT_NAMESPACE, DEFAULT_ROOT, DEFAULT_UV, DISPLAY_POSITIONS, type DebugOptions, type DeepPartial, DefaultBlockStates, DisplayPosition, DisplayTransforms, type Disposable, type DoubleArray, 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 FluidSample, type FluidSampler, Fonts, type FrameCallback, type FromTo, Geometries, 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, type ItemModel, type ItemModelTextures, type ItemTintColor, type ItemTintSource, ItemTints, type ListAsset, MapControls, type MaterialKey, Materials, type Maybe, type MeshKey, Meshes, 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, OrbitControls, PersistentCache, type PositionedGuiGlyph, type QuadArray, type RawImageKey, type RenderOptions, Renderer, type RendererFrame, type RendererOptions, type RequestConfig, RequestError, type RequestResponse, Requests, type ResolvedBlockEntity, type ResponseParser, SKIN_PARTS, SceneExporter, type SceneGLTFExportOptions, SceneInspector, SceneObject, type SceneObjectOptions, SceneStats, SceneStatsDisplay, SchematicParser, SectionMesh, type SectionMeshEntry, type SectionMeshTemplate, SectionModels, type Serializable, type SkinGeometries, SkinImage, SkinObject, type SkinObjectOptions, SkinPart, type SkinTexture, type SkinTextureCoordinates, SkinTextures, Skins, type SpecialItemPart, type SpecialItemRenderer, SpecialItems, type StructureNBT, StructureParser, type TextureAsset, TextureAtlas, type TextureKey, TextureLoader, Textures, Ticker, type TickerFunction, TintColors, type Transformable, type TripleArray, UVMapper, WrappedImage, addBox3WireframeToObject, addWireframeToMesh, addWireframeToObject, applyElementRotation, applyGenericRotation, axisToVec3, base64decode, base64encode, capeTextureSizes, captureException, changeEvent, clampRotationDegrees, classicSkinGeometries, classicSkinTextureCoordinates, computeMorphedAttributes, createCanvas, createFluidGeometry, createGuiTextGeometry, createGuiTextureGeometry, createImage, entityAnimationTime, estimateBytesUsed, getBlockFluidState, getFluidKind, interleaveAttributes, isAssetKey, isBasicAssetKey, isBlockObject, isDisposable, isDoubleArray, isEntityObject, isGuiObject, isInstanceManager, isInstanceReference, isInstanceable, isInstancedMesh, isMesh, isMineRenderScene, isModelObject, isObject3D, isOrthographicCamera, isPerspectiveCamera, isQuadArray, isSceneObject, isTransformable, isTripleArray, isVector3, layoutGuiText, md5, mergeBufferAttributes, mergeBufferGeometries, mergeVertices, prefix, registerNodeEnv, sampleEntityAnimation, sampleEntityKeyframes, sampleFluid, serializeBoxGeometryKey, serializeImageKey, serializeMaterialKey, serializeMeshKey, serializeTextureKey, sha1, sha256, sha512, shutdown, sleep, slimSkinGeometries, slimSkinTextureCoordinates, timingEnd, timingStart, toDegrees, toRadians, toTrianglesDrawMode, trimCanvas };