genshin-engine 4.1.2 → 4.3.1

package/README.md

@@ -71,7 +71,7 @@ A web worker generating the ground imports its generators from the `genshin-engi
 
 ## <a name="documentation">📖 Documentation</a>
 
-We highly recommend you take a look at the [documentation](https://esposter.com/docs/api/modules/genshin-engine.html) to level up. The engine's design, from the order a frame runs in to each module's job, is its [architecture page](https://esposter.com/docs/genshin/engine-architecture), and the look it draws is its [rendering style](https://esposter.com/docs/genshin/rendering-style).
+We highly recommend you take a look at the [documentation](https://github.com/Esposter/Esposter/tree/main/openspec/specs/genshin) to level up. The engine's design, from the order a frame runs in to each module's job, is its [architecture page](https://github.com/Esposter/Esposter/blob/main/openspec/specs/genshin/engine-architecture/design.md), and the look it draws is its [rendering style](https://github.com/Esposter/Esposter/blob/main/openspec/specs/genshin/rendering-style/design.md).
 
 ## <a name="license">⚖️ License</a>
 

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { A as CliffFeature, C as GroundLayerField, D as GroundBand, E as GroundLayers, O as GaussianHills, S as GroundPathSegment, T as GroundLayer, _ as TerrainOptions, a as createTerrainShapeHeight, b as PlateauFeature, c as computeTerrainTile, d as TerrainTileOptions, f as TerrainShape, g as TerrainResidualClearing, h as TerrainResidualFade, i as getTerrainTileColumn, j as TerrainFeatureKind, k as GaussianHill, l as createSeededRandom, m as TerrainResidual, n as getTerrainTileRow, o as createGroundPaintColor, p as TerrainTile, r as getTerrainTileLevel, s as createGroundLayerWeights, t as computeScatterPoints, u as ScatterOptions, v as TerrainFeature, w as GroundLayerColors, x as GroundPaint, y as RidgeFeature } from "./terrainWorker-CLOYYKT1.js";
 import { Box3, BufferAttribute, BufferGeometry, Camera, CanvasTexture, Color, ColorRepresentation, Data3DTexture, DataTexture, DirectionalLight, Frustum, HemisphereLight, InstancedBufferGeometry, InstancedMesh, Material, Matrix3, Matrix4, Mesh, Object3D, OrthographicCamera, PerspectiveCamera, Quaternion, Scene, Skeleton, SkinnedMesh, Sprite, Texture, ToneMapping, Vector2, Vector3, Vector3Like, Vector3Tuple, Vector4Tuple } from "three";
-import { LightingModel, LightingModelDirectInput, Material as Material$1, MeshBasicNodeMaterial, MeshToonNodeMaterial, MeshToonNodeMaterialParameters, Node, NodeBuilder, NodeFrame, NodeMaterial, PassNode, RenderPipeline, RenderTarget, Renderer, Texture as Texture$1, TextureNode, ToonOutlinePassNode, UniformArrayNode, UniformNode, WebGPURenderer } from "three/webgpu";
+import { IndirectStorageBufferAttribute, LightingModel, LightingModelDirectInput, Material as Material$1, MeshBasicNodeMaterial, MeshToonNodeMaterial, MeshToonNodeMaterialParameters, Node, NodeBuilder, NodeFrame, NodeMaterial, PassNode, RenderPipeline, RenderTarget, Renderer, StorageBufferAttribute, Texture as Texture$1, TextureNode, ToonOutlinePassNode, UniformArrayNode, UniformNode, WebGPURenderer } from "three/webgpu";
 import { CSMShadowNode, CSMShadowNodeData } from "three/examples/jsm/csm/CSMShadowNode.js";
 import { Capsule } from "three/examples/jsm/math/Capsule.js";
 import GTAONode from "three/examples/jsm/tsl/display/GTAONode.js";
@@ -260,6 +260,7 @@ export declare enum WeatherKind {
   Rain = "Rain",
   Sandstorm = "Sandstorm",
   Snow = "Snow",
+  Snowstorm = "Snowstorm",
   Thunderstorm = "Thunderstorm"
 }
 //#endregion
@@ -640,6 +641,7 @@ export declare const transformFourier: (real: Float64Array, imaginary: Float64Ar
 export interface FollowCameraSettings {
   defaultDistance: number;
   horizontalSensitivity: number;
+  slopePitch: boolean;
   verticalSensitivity: number;
 }
 //#endregion
@@ -658,6 +660,7 @@ export declare const FOLLOW_CAMERA_MIN_DISTANCE = 1;
 export declare const FOLLOW_CAMERA_MAX_DISTANCE = 6;
 export declare const FOLLOW_CAMERA_DISTANCE_PER_ZOOM_STEP = .5;
 export declare const FOLLOW_CAMERA_EASE_OUT_SPEED = 4;
+export declare const FOLLOW_CAMERA_SLOPE_PITCH_SPEED = 4;
 export declare const FOLLOW_CAMERA_CLEARANCE = .2;
 export declare const FOLLOW_CAMERA_ARM_STEP = .25;
 //#endregion
@@ -722,6 +725,7 @@ export interface FollowCamera {
   follow: (pivot: Vector3, origin: Vector3, frameSeconds: number) => void;
   look: (input: InputState, facing: number) => void;
   reset: (facing: number) => void;
+  returnToDefaultDistance: () => void;
   readonly yaw: number;
 }
 //#endregion
@@ -776,11 +780,21 @@ export interface FreeCameraOptions {
 //#region src/camera/createFreeCamera.d.ts
 export declare const createFreeCamera: ({ camera, ground }: FreeCameraOptions) => FreeCamera;
 //#endregion
+//#region src/models/character/PmxSphereMode.d.ts
+export declare enum PmxSphereMode {
+  Disabled = 0,
+  Multiply = 1,
+  Add = 2,
+  AdditionalUv = 3
+}
+//#endregion
+//#region src/character/checkIsPmxSphereDrawn.d.ts
+export declare const checkIsPmxSphereDrawn: (sphereMode: PmxSphereMode) => sphereMode is PmxSphereMode.Add | PmxSphereMode.Multiply;
+//#endregion
 //#region src/character/checkTransparentTexels.d.ts
 export declare const checkTransparentTexels: (image: ImageBitmap) => boolean;
 //#endregion
 //#region src/character/constants.d.ts
-export declare const PMX_UNIT_METRES = .08;
 export declare const SHARED_TOON_RAMP_SHADES: readonly number[];
 //#endregion
 //#region src/models/character/CharacterMaterialKind.d.ts
@@ -821,6 +835,12 @@ export interface ShadingRegionToggles {
   two: boolean;
 }
 //#endregion
+//#region src/models/nodes/OutlineWidthKnots.d.ts
+export interface OutlineWidthKnots {
+  depths: Vector3Tuple;
+  scales: Vector3Tuple;
+}
+//#endregion
 //#region src/models/character/CharacterShadingInputs.d.ts
 export interface CharacterShadingInputs {
   brightness: number;
@@ -847,13 +867,12 @@ export interface CharacterShadingInputs {
   metalDarkColor: Vector3Tuple;
   metalLightColor: Vector3Tuple;
   metalTexture?: Texture;
-  outlineDepths: Vector3Tuple;
   outlineOffset?: {
     blockBChannel: number;
     size: number;
   };
   outlineRegions?: OutlineRegions;
-  outlineScales: Vector3Tuple;
+  outlineWidthKnots: OutlineWidthKnots;
   rampLayout: RampLayout;
   rampTexture: Texture;
   rampWidth: number;
@@ -864,18 +883,14 @@ export interface CharacterShadingInputs {
   specularColor: Vector3Tuple;
   specularInShadow: number;
   specularMultiplier: number;
+  sphere?: {
+    mode: PmxSphereMode.Add | PmxSphereMode.Multiply;
+    texture: Texture;
+  };
   vertexAo: number;
   vertexRampWidth: number;
 }
 //#endregion
-//#region src/models/character/PmxSphereMode.d.ts
-export declare enum PmxSphereMode {
-  Disabled = 0,
-  Multiply = 1,
-  Add = 2,
-  AdditionalUv = 3
-}
-//#endregion
 //#region src/models/character/PmxMaterial.d.ts
 export interface PmxMaterial {
   ambientColor: Vector3Tuple;
@@ -907,12 +922,6 @@ export interface CharacterMaterialOptions {
   toonTexture?: Texture;
 }
 //#endregion
-//#region src/models/nodes/OutlineWidthKnots.d.ts
-export interface OutlineWidthKnots {
-  depths: Vector3Tuple;
-  scales: Vector3Tuple;
-}
-//#endregion
 //#region src/models/nodes/ToonEdge.d.ts
 export interface ToonEdge {
   color: Node<"vec4"> | Vector4Tuple;
@@ -929,6 +938,7 @@ export interface ToonEdge {
 export declare class ToonNodeMaterial extends MeshToonNodeMaterial {
   edge?: ToonEdge;
   emissiveNode: Node | null;
+  instanceMatrix?: Node<"mat4">;
   readonly isMeshToonMaterial: boolean;
   override readonly isMeshToonNodeMaterial: boolean;
   sphereMap?: Texture$1;
@@ -939,7 +949,7 @@ export declare class ToonNodeMaterial extends MeshToonNodeMaterial {
 export declare const createCharacterMaterial: ({ isTextureTransparent, lightUniforms, pmxMaterial: { diffuseColor: [red, green, blue, opacity], edgeColor, edgeSize, isDoubleSided, isOutlined, isToonShared, specularColor, specularity, sphereMode, toonIndex }, rampTexture, shadingInputs: gameShadingInputs, sphereTexture, texture: diffuseTexture, toonTexture }: CharacterMaterialOptions) => ToonNodeMaterial;
 //#endregion
 //#region src/character/createCharacterShadingInputs.d.ts
-export type CharacterShadingOverrides = Partial<CharacterShadingInputs> & {
+type CharacterShadingOverrides = Partial<CharacterShadingInputs> & {
   rampTexture: Texture;
 };
 export declare const createCharacterShadingInputs: (overrides: CharacterShadingOverrides) => CharacterShadingInputs;
@@ -1059,7 +1069,7 @@ export interface PmxModel {
 export declare const createPmxGeometry: ({ indices, materials, vertices: { normals, positions, skinIndices, skinWeights, subUvs, uvs } }: Pick<PmxModel, "indices" | "materials" | "vertices">) => BufferGeometry;
 //#endregion
 //#region src/character/createPmxMesh.d.ts
-export declare const createPmxMesh: <TMaterial extends Material>(pmxModel: PmxModel, materials: TMaterial[]) => SkinnedMesh<BufferGeometry, TMaterial[]>;
+export declare const createPmxMesh: <TMaterial extends Material>(pmxModel: PmxModel, materials: TMaterial[], unitMetres: number) => SkinnedMesh<BufferGeometry, TMaterial[]>;
 //#endregion
 //#region src/character/createPmxSkeleton.d.ts
 export declare const createPmxSkeleton: (pmxBones: readonly PmxBone[]) => Skeleton;
@@ -1251,7 +1261,7 @@ export interface LocomotionPhase {
 export interface CharacterPoser {
   update: (update: CharacterPoseUpdate) => void;
 }
-export interface CharacterPoseUpdate {
+interface CharacterPoseUpdate {
   delta: number;
   locomotion: Locomotion;
   phase: LocomotionPhase;
@@ -1279,6 +1289,7 @@ export declare const MINIMUM_RAMP_WIDTH_VERTEX = .01;
 export declare const MINIMUM_OUTLINE_KNOT_SPAN = .001;
 export declare const OUTLINE_PROJECTION_SCALE = 2.414;
 export declare const OUTLINE_WIDTH_SCALE = .41425;
+export declare const UNIT_OUTLINE_WIDTH_KNOTS: OutlineWidthKnots;
 export declare const OUTLINE_MAIN_TEXTURE_SHARE = .2;
 export declare const DESATURATION_WEIGHTS: readonly [number, number, number];
 export declare const HALF_LAMBERT_SCALE = .4975;
@@ -1358,7 +1369,7 @@ export declare const getShadingRegion: (alpha: number, toggles: ShadingRegionTog
 export declare const getToneColour: (colour: Vector3, desaturateScale: number, contrastScale: number) => Vector3;
 //#endregion
 //#region src/character/shading/getToonThreshold.d.ts
-export interface ToonThresholdInputs {
+interface ToonThresholdInputs {
   isLightMapAo: boolean;
   isVertexAo: boolean;
   lightMapGreen: number;
@@ -1400,6 +1411,46 @@ export declare const createLandmarkCollider: () => LandmarkCollider;
 //#region src/constants.d.ts
 export declare const MAX_BYTE = 255;
 //#endregion
+//#region src/culling/constants.d.ts
+export declare const CULLING_FRUSTUM_MARGIN = .1;
+export declare const CULLING_INDIRECT_ARGUMENT_COUNT = 5;
+export declare const CULLING_INDEX_COUNT_INDEX = 0;
+export declare const CULLING_INSTANCE_COUNT_INDEX = 1;
+export declare const CULLING_MIN_SIZE = 1e-4;
+export declare const CULLING_MATRIX_COLUMN_COUNT = 4;
+export declare const CULLING_MATRIX_ELEMENT_COUNT: number;
+//#endregion
+//#region src/culling/createFrustumVisibility.d.ts
+export declare const createFrustumVisibility: (clipFromModel: UniformNode<"mat4", Matrix4>, point: Node<"vec3">) => Node<"float">;
+//#endregion
+//#region src/models/culling/InstanceCulling.d.ts
+export interface InstanceCulling {
+  cull: (renderer: Renderer) => void;
+  dispose: () => void;
+  indirect: IndirectStorageBufferAttribute;
+  survivor: Node<"float">;
+}
+//#endregion
+//#region src/culling/createInstanceCulling.d.ts
+interface InstanceCullingOptions {
+  count: number;
+  indexCount: number;
+  isVisible: (instance: Node<"float">) => Node<"float">;
+}
+export declare const createInstanceCulling: ({ count, indexCount, isVisible }: InstanceCullingOptions) => InstanceCulling;
+//#endregion
+//#region src/culling/createInstanceMatrixBuffer.d.ts
+export declare const createInstanceMatrixBuffer: (matrices: Matrix4[]) => StorageBufferAttribute;
+//#endregion
+//#region src/culling/createInstanceMatrixNode.d.ts
+export declare const createInstanceMatrixNode: (attribute: StorageBufferAttribute, instance: Node<"float">) => Node<"mat4">;
+//#endregion
+//#region src/culling/createInstancedGeometry.d.ts
+export declare const createInstancedGeometry: (geometry: BufferGeometry, instanceCount: number) => InstancedBufferGeometry;
+//#endregion
+//#region src/culling/createSurvivorIndices.d.ts
+export declare const createSurvivorIndices: (count: number) => Uint32Array;
+//#endregion
 //#region src/input/InputActionBindingMap.d.ts
 export declare const InputActionBindingMap: Readonly<Record<InputAction, readonly (readonly string[])[]>>;
 //#endregion
@@ -1456,8 +1507,29 @@ export interface Input {
   turn: (lookYaw: number, lookPitch: number) => void;
 }
 //#endregion
+//#region src/models/input/InputGamepad.d.ts
+export interface InputGamepad {
+  axes: readonly number[];
+  buttons: readonly {
+    pressed: boolean;
+  }[];
+}
+//#endregion
+//#region src/models/input/InputTarget.d.ts
+export interface InputTarget extends Pick<Window, "addEventListener"> {
+  document: {
+    activeElement: null | {
+      matches: (selectors: string) => boolean;
+    };
+    pointerLockElement: null | object;
+  };
+  navigator: {
+    getGamepads: () => (InputGamepad | null)[];
+  };
+}
+//#endregion
 //#region src/input/createInput.d.ts
-export declare const createInput: (target: Window) => Input;
+export declare const createInput: (target: InputTarget) => Input;
 //#endregion
 //#region src/kits/architecture/createBoxesGeometry.d.ts
 export declare const createBoxesGeometry: (boxes: readonly (readonly number[])[]) => BufferGeometry;
@@ -1688,6 +1760,7 @@ export interface Stamina {
   checkCanSpend: (amount: number) => boolean;
   maximum: number;
   refill: () => void;
+  restore: (amount: number) => void;
   spend: (amount: number) => void;
   step: (phase: LocomotionPhase, isEntered: boolean, isMoving: boolean, stepSeconds: number) => void;
   value: number;
@@ -1708,16 +1781,22 @@ export interface CharacterController {
 }
 //#endregion
 //#region src/models/locomotion/CharacterControllerOptions.d.ts
-export interface CharacterControllerOptions {
+export type CharacterControllerOptions = ({
   getStaminaConsumptionMultiplier?: () => number;
+  stamina?: never;
+  staminaMaximum: number;
+} | {
+  getStaminaConsumptionMultiplier?: never;
+  stamina: Stamina;
+  staminaMaximum?: never;
+}) & {
   ground: GroundQuery;
   landmarkCollider: LandmarkCollider;
   position: Vector3;
-  staminaMaximum: number;
-}
+};
 //#endregion
 //#region src/locomotion/createCharacterController.d.ts
-export declare const createCharacterController: ({ getStaminaConsumptionMultiplier, ground, landmarkCollider, position, staminaMaximum }: CharacterControllerOptions) => CharacterController;
+export declare const createCharacterController: (options: CharacterControllerOptions) => CharacterController;
 //#endregion
 //#region src/locomotion/createStamina.d.ts
 export declare const createStamina: (maximum: number, getStaminaConsumptionMultiplier?: () => number) => Stamina;
@@ -1771,6 +1850,20 @@ export declare enum PmxWeightDeform {
   DualQuaternion = 4
 }
 //#endregion
+//#region src/models/culling/PlantCullingOptions.d.ts
+export interface PlantCullingOptions {
+  attribute: StorageBufferAttribute;
+  bounds: {
+    bottom: number;
+    halfWidth: number;
+    height: number;
+  };
+  clipFromModel: UniformNode<"mat4", Matrix4>;
+  drawDistance: number;
+  eye: UniformNode<"vec3", Vector3>;
+  indexCount: number;
+}
+//#endregion
 //#region src/models/vegetation/Impostor.d.ts
 export interface Impostor {
   albedoTarget: RenderTarget;
@@ -1784,6 +1877,7 @@ export interface Impostor {
 export interface ImpostorMaterialOptions {
   fade: Node<"float">;
   impostor: Impostor;
+  instanceMatrix?: Node<"mat4">;
   lightUniforms: LightUniforms;
   rampTexture: DataTexture;
 }
@@ -1913,6 +2007,7 @@ export interface SurfaceDetail {
 export interface ToonMaterialOptions {
   color?: ColorRepresentation;
   detail?: SurfaceDetail;
+  instanceMatrix?: Node<"mat4">;
   isObjectSurface?: boolean;
   isOutlined?: boolean;
   isVertexColors?: boolean;
@@ -1921,7 +2016,7 @@ export interface ToonMaterialOptions {
 }
 //#endregion
 //#region src/models/nodes/createOutlineMaterial.d.ts
-export declare const createOutlineMaterial: (colorNode: Node<"vec4">, thicknessNode: Node<"float">) => NodeMaterial;
+export declare const createOutlineMaterial: (colorNode: Node<"vec4">, thicknessNode: Node<"float">, instanceMatrix?: Node<"mat4">) => NodeMaterial;
 export declare const createGameOutlineMaterial: (colorNode: Node<"vec4">, widthNode: Node<"float">, offsetNode: Node<"float">) => NodeMaterial;
 //#endregion
 //#region src/models/nodes/getGameOutlineOffset.d.ts
@@ -2047,12 +2142,11 @@ export interface TerrainSelection {
 //#endregion
 //#region src/models/streaming/TileStreamer.d.ts
 export interface TileStreamer<TTile> {
+  checkIsSettled: (key: number) => boolean;
   dispose: () => void;
   fail: (key: number) => boolean;
   get: (key: number) => TTile | undefined;
   has: (key: number) => boolean;
-  isSettled: (key: number) => boolean;
-  pendingKeys: () => number[];
   receive: (key: number, tile: TTile) => void;
   refresh: (checkIsChanged: (key: number) => boolean) => void;
   update: (wanted: TerrainSelection, drawn: TerrainSelection, surrounding: TerrainSelection) => void;
@@ -2092,6 +2186,14 @@ export interface GrassBlade {
   positions: Float32Array;
 }
 //#endregion
+//#region src/models/vegetation/GrassCell.d.ts
+export interface GrassCell {
+  angle: Node<"float">;
+  captured: Node<"vec4">;
+  ground: Node<"vec2">;
+  size: Node<"float">;
+}
+//#endregion
 //#region src/models/vegetation/GrassRing.d.ts
 export interface GrassRing {
   cellsPerSide: number;
@@ -2102,12 +2204,47 @@ export interface GrassRing {
   spacing: number;
 }
 //#endregion
+//#region src/models/vegetation/GrassCellOptions.d.ts
+export interface GrassCellOptions {
+  cameraGround: UniformNode<"vec2", Vector2>;
+  density: UniformNode<"float", number>;
+  groundCapture: GroundCapture;
+  index: Node<"float">;
+  ring: GrassRing;
+  waterUniforms: Pick<WaterUniforms, "level">;
+}
+//#endregion
+//#region src/models/vegetation/GrassTrail.d.ts
+export interface GrassTrail {
+  bends: Float32Array;
+  cells: Float64Array;
+  center: UniformNode<"vec2", Vector2>;
+  data: Uint8Array;
+  texture: DataTexture;
+}
+//#endregion
+//#region src/models/vegetation/GrassCullingOptions.d.ts
+export interface GrassCullingOptions {
+  bladeHeight: number;
+  cameraGround: UniformNode<"vec2", Vector2>;
+  clipFromModel: UniformNode<"mat4", Matrix4>;
+  density: UniformNode<"float", number>;
+  grassTrail: GrassTrail;
+  groundCapture: GroundCapture;
+  ring: GrassRing;
+  segmentCount: number;
+  waterUniforms: Pick<WaterUniforms, "level">;
+  windUniforms: WindUniforms;
+}
+//#endregion
 //#region src/models/vegetation/GrassOptions.d.ts
 export interface GrassOptions {
   bladeHeight: number;
   bladeWidth: number;
   cameraGround: UniformNode<"vec2", Vector2>;
+  cellIndex: Node<"float">;
   density: UniformNode<"float", number>;
+  grassTrail: GrassTrail;
   groundCapture: GroundCapture;
   lightUniforms: LightUniforms;
   rampTexture: DataTexture;
@@ -2120,7 +2257,7 @@ export interface GrassOptions {
 export interface ImpostorPart {
   color: ColorRepresentation;
   geometry: BufferGeometry;
-  opacityNode?: Node<"float">;
+  maskNode?: Node<"bool">;
 }
 //#endregion
 //#region src/models/water/RiverCoursePoint.d.ts
@@ -2174,12 +2311,19 @@ export declare const computeStoneHarmonics: ([x, y, z]: readonly number[], harmo
 export declare const computeStoneRampCoordinate: (facing: number, visibility: number) => number;
 //#endregion
 //#region src/nodes/computeSurfaceOctaves.d.ts
-export interface SurfaceOctave {
+interface SurfaceOctave {
   amplitude: number;
   frequency: number;
 }
 export declare const computeSurfaceOctaves: ({ bands, metresPerTexel, variance }: SurfaceDetail) => SurfaceOctave[];
 //#endregion
+//#region src/nodes/computeWindGust.d.ts
+export declare const computeWindGust: (downwind: number, time: number, { gustSpeed, gustStrength, gustWidth }: {
+  gustSpeed: number;
+  gustStrength: number;
+  gustWidth: number;
+}) => number;
+//#endregion
 //#region src/nodes/constants.d.ts
 export declare const LEAST_DIVISOR = 1e-4;
 export declare const STONE_SHADOW_EXPONENT = .2;
@@ -2193,7 +2337,7 @@ export declare const WET_SHEEN_POWER = 32;
 export declare const WET_SHEEN_STRENGTH = .25;
 export declare const SURFACE_DETAIL_BAND_SIGMAS: number[];
 export declare const SURFACE_OCTAVE_TEXEL_FREQUENCIES: number[];
-export declare const SURFACE_DETAIL_RENDER_GAIN = 4;
+export declare const SURFACE_OCTAVE_RESPONSES: number[][];
 export declare const OBJECT_SURFACE_KEY = "surface";
 export declare const OBJECT_FADE_KEY = "fade";
 export declare const LEAF_SHAPE_WIDTH = .8;
@@ -2209,13 +2353,13 @@ export declare const createCloudLayerNode: ({ center, curl, curlAmplitude, curlS
 export declare const createDitherFadeNode: (visibility: Node<"float">) => Node<"bool">;
 //#endregion
 //#region src/nodes/createImpostorMaterial.d.ts
-export declare const createImpostorMaterial: ({ fade, impostor, lightUniforms, rampTexture }: ImpostorMaterialOptions) => ToonNodeMaterial;
+export declare const createImpostorMaterial: ({ fade, impostor, instanceMatrix, lightUniforms, rampTexture }: ImpostorMaterialOptions) => ToonNodeMaterial;
 //#endregion
 //#region src/nodes/createLeafMaterial.d.ts
-export declare const createLeafMaterial: (toonMaterialOptions: ToonMaterialOptions, windUniforms?: WindUniforms) => ToonNodeMaterial;
+export declare const createLeafMaterial: (toonMaterialOptions: ToonMaterialOptions, windUniforms?: WindUniforms, maskNode?: Node<"bool">) => ToonNodeMaterial;
 //#endregion
 //#region src/nodes/createLeafShapeNode.d.ts
-export declare const createLeafShapeNode: () => Node<"float">;
+export declare const createLeafShapeNode: () => Node<"bool">;
 //#endregion
 //#region src/nodes/createLightUniforms.d.ts
 export declare const createLightUniforms: () => LightUniforms;
@@ -2223,6 +2367,9 @@ export declare const createLightUniforms: () => LightUniforms;
 //#region src/nodes/createLightningBoltMaterial.d.ts
 export declare const createLightningBoltMaterial: (flash: UniformNode<"float", number>) => MeshBasicNodeMaterial;
 //#endregion
+//#region src/nodes/createMaterialDetailNode.d.ts
+export declare const createMaterialDetailNode: (detail: SurfaceDetail) => Node<"float">;
+//#endregion
 //#region src/nodes/createObjectFadeNode.d.ts
 export declare const createObjectFadeNode: () => Node<"float">;
 //#endregion
@@ -2235,6 +2382,9 @@ export declare const createPrecipitationMaterial: ({ lightUniforms, precipitatio
 //#region src/nodes/createRimNode.d.ts
 export declare const createRimNode: ({ rimColor, rimStrength, sunDirection }: LightUniforms) => Node<"vec3">;
 //#endregion
+//#region src/nodes/createRiverMaterial.d.ts
+export declare const createRiverMaterial: (lightUniforms: LightUniforms, skyUniforms: SkyUniforms, waterUniforms: WaterUniforms) => MeshBasicNodeMaterial;
+//#endregion
 //#region src/nodes/createSkyColorNode.d.ts
 export declare const createSkyColorNode: ({ frontBackBlend, haloColor, haloHeight, horizonBackColor, horizonBand, horizonColor, sunDirection, sunHaloColor, sunHaloSize, zenithBackColor, zenithColor }: SkyUniforms, gradient: Texture, direction: Node<"vec3">) => Node<"vec3">;
 //#endregion
@@ -2260,7 +2410,7 @@ export declare const createSunVisibilityNode: (lightColor: Node, sunRadiance: Un
 export declare const createSurfaceDetailNode: (amplitudes: Node<"float">[], texelsPerMetre: Node<"float">) => Node<"float">;
 //#endregion
 //#region src/nodes/createToonMaterial.d.ts
-export declare const createToonMaterial: ({ color, detail, isObjectSurface, isOutlined, isVertexColors, lightUniforms, rampTexture }: ToonMaterialOptions) => ToonNodeMaterial;
+export declare const createToonMaterial: ({ color, detail, instanceMatrix, isObjectSurface, isOutlined, isVertexColors, lightUniforms, rampTexture }: ToonMaterialOptions) => ToonNodeMaterial;
 //#endregion
 //#region src/nodes/createWaterMaterial.d.ts
 export declare const createWaterMaterial: ({ lightColor, sunDirection }: Pick<LightUniforms, "lightColor" | "sunDirection">, { horizonColor, zenithColor }: Pick<SkyUniforms, "horizonColor" | "zenithColor">, { deepColor, deepDepth, foamColor, foamDepth, shallowColor }: WaterUniforms, { direction, speed }: WaterFlow, bendFoam?: Node<"float">) => MeshBasicNodeMaterial;
@@ -2283,6 +2433,9 @@ export declare const getCloudSunColors: ({ cloudFrontBackBlend, cloudLitBackColo
   shade: Node<"vec3">;
 };
 //#endregion
+//#region src/nodes/sampleGrassTrail.d.ts
+export declare const sampleGrassTrail: (grassTrail: GrassTrail, ground: Node<"vec2">) => Node<"vec2">;
+//#endregion
 //#region src/nodes/sampleGroundCapture.d.ts
 export declare const sampleGroundCapture: (groundCapture: GroundCapture, ground: Node<"vec2">) => {
   captured: Node<"vec4">;
@@ -2509,6 +2662,18 @@ export declare const bakeImpostor: (renderer: Renderer, parts: readonly Impostor
 //#region src/vegetation/computeGrassBlade.d.ts
 export declare const computeGrassBlade: (segmentCount: number) => GrassBlade;
 //#endregion
+//#region src/vegetation/computeGrassTrailCell.d.ts
+export declare const computeGrassTrailCell: (coordinate: number, texelSize: number) => number;
+//#endregion
+//#region src/vegetation/computeGrassTrailTexel.d.ts
+export declare const computeGrassTrailTexel: (cell: number) => number;
+//#endregion
+//#region src/vegetation/computeGrassTrailTexelIndex.d.ts
+export declare const computeGrassTrailTexelIndex: (cellX: number, cellZ: number) => number;
+//#endregion
+//#region src/vegetation/computeImpostorFade.d.ts
+export declare const computeImpostorFade: (distance: number, impostorHeight: number) => number;
+//#endregion
 //#region src/vegetation/constants.d.ts
 export declare const IMPOSTOR_RESOLUTION = 256;
 export declare const IMPOSTOR_SWITCH_HEIGHTS = 10;
@@ -2516,6 +2681,16 @@ export declare const IMPOSTOR_CROSSFADE_SHARE = .1;
 export declare const FLOWER_BEND_PER_WIND = .12;
 export declare const FLOWER_MATRIX_ATTRIBUTE_NAMES: readonly ["flowerMatrix0", "flowerMatrix1", "flowerMatrix2", "flowerMatrix3"];
 export declare const FLOWER_COLOR_ATTRIBUTE_NAME = "flowerColor";
+export declare const GRASS_TRAIL_EXTENT = 16;
+export declare const GRASS_TRAIL_TEXELS = 64;
+export declare const GRASS_TRAIL_TEXEL_SIZE: number;
+export declare const GRASS_TRAIL_STAMP_RADIUS = .6;
+export declare const GRASS_TRAIL_FADE_SECONDS = 1.5;
+export declare const GRASS_TRAIL_BEND_SHARE = .9;
+export declare const GRASS_TRAIL_FADE_START_SHARE = .8;
+export declare const GRASS_TRAIL_FADE_END_SHARE = .95;
+export declare const GRASS_BEND_PER_WIND = .9;
+export declare const GRASS_DIP_PER_BEND = .3;
 //#endregion
 //#region src/vegetation/createFlowerGeometry.d.ts
 export declare const createFlowerGeometry: () => BufferGeometry;
@@ -2526,18 +2701,46 @@ export declare const createFlowerMaterial: (toonMaterialOptions: Pick<ToonMateri
 //#region src/vegetation/createFlowerTileGeometry.d.ts
 export declare const createFlowerTileGeometry: (matrices: Float32Array, colors: Float32Array) => InstancedBufferGeometry;
 //#endregion
+//#region src/vegetation/createGrassBladePoint.d.ts
+interface GrassBladePointOptions {
+  bladeHeight: number;
+  captured: Node<"vec4">;
+  grassTrail: GrassTrail;
+  ground: Node<"vec2">;
+  offset: Node<"vec2">;
+  size: Node<"float">;
+  up: Node<"float">;
+  windUniforms: WindUniforms;
+}
+export declare const createGrassBladePoint: ({ bladeHeight, captured, grassTrail, ground, offset, size, up, windUniforms }: GrassBladePointOptions) => Node<"vec3">;
+//#endregion
+//#region src/vegetation/createGrassCell.d.ts
+export declare const createGrassCell: ({ cameraGround, density, groundCapture, index, ring, waterUniforms }: GrassCellOptions) => GrassCell;
+//#endregion
+//#region src/vegetation/createGrassCulling.d.ts
+export declare const createGrassCulling: ({ bladeHeight, cameraGround, clipFromModel, density, grassTrail, groundCapture, ring, segmentCount, waterUniforms, windUniforms }: GrassCullingOptions) => InstanceCulling;
+//#endregion
 //#region src/vegetation/createGrassGeometry.d.ts
 export declare const createGrassGeometry: (segmentCount: number, bladeCount: number) => InstancedBufferGeometry;
 //#endregion
 //#region src/vegetation/createGrassMaterial.d.ts
-export declare const createGrassMaterial: ({ bladeHeight, bladeWidth, cameraGround, density, groundCapture, lightUniforms, rampTexture, ring, waterUniforms, windUniforms }: GrassOptions) => ToonNodeMaterial;
+export declare const createGrassMaterial: ({ bladeHeight, bladeWidth, cameraGround, cellIndex, density, grassTrail, groundCapture, lightUniforms, rampTexture, ring, waterUniforms, windUniforms }: GrassOptions) => ToonNodeMaterial;
+//#endregion
+//#region src/vegetation/createGrassTrail.d.ts
+export declare const createGrassTrail: () => GrassTrail;
 //#endregion
 //#region src/vegetation/createGroundCapture.d.ts
 export declare const createGroundCapture: (size: number, resolution: number) => GroundCapture;
 //#endregion
+//#region src/vegetation/createPlantCulling.d.ts
+export declare const createPlantCulling: ({ attribute, bounds: { bottom, halfWidth, height }, clipFromModel, drawDistance, eye, indexCount }: PlantCullingOptions) => InstanceCulling;
+//#endregion
 //#region src/vegetation/renderGroundCapture.d.ts
 export declare const renderGroundCapture: (renderer: Renderer, scene: Scene, { camera, center, material, renderTarget }: GroundCapture, { maxHeight }: Pick<TerrainOptions, "maxHeight">, worldCenter: Vector3Like, origin: Vector3Like) => void;
 //#endregion
+//#region src/vegetation/stepGrassTrail.d.ts
+export declare const stepGrassTrail: (trail: GrassTrail, position: Vector2, velocity: Vector2, delta: number) => void;
+//#endregion
 //#region src/water/constants.d.ts
 export declare const RIVER_BEND_FOAM_ATTRIBUTE = "bendFoam";
 export declare const BEND_FOAM_FULL_RADIUS_WIDTHS = 2;