@call-me-sensei/toonlab 0.4.21 → 0.4.23

package/src/water/waterSurface.js

@@ -13,6 +13,7 @@ import {
   setWaterDebugMode,
   updateWaterMaterialCamera,
 } from './waterMaterial.js';
+import { WaterDynamics } from './waterDynamics.js';
 import { WaterCurrentField } from './waterCurrentField.js';
 import {
   buildNearshorePhaseField,
@@ -127,6 +128,7 @@ export class WaterSurface extends THREE.Mesh {
     passes = {},
     interaction = {},
     currentField = null,
+    dynamics = null,
     nearshorePhase = false,
     shoreState = false,
     underwaterAtmosphere = true,
@@ -138,8 +140,8 @@ export class WaterSurface extends THREE.Mesh {
     ...settingsOptions
   } = {}) {
     const settings = createWaterSettings(settingsOptions);
-    const segmentsX = Math.min(maxSegments, Math.max(16, Math.round(width * segmentsPerMeter)));
-    const segmentsZ = Math.min(maxSegments, Math.max(16, Math.round(depth * segmentsPerMeter)));
+    const segmentsX = dynamics ? (dynamics.columns ?? 96) - 1 : Math.min(maxSegments, Math.max(16, Math.round(width * segmentsPerMeter)));
+    const segmentsZ = dynamics ? (dynamics.rows ?? 96) - 1 : Math.min(maxSegments, Math.max(16, Math.round(depth * segmentsPerMeter)));
     const geometry = new THREE.PlaneGeometry(width, depth, segmentsX, segmentsZ);
     geometry.rotateX(-Math.PI / 2);
 
@@ -147,7 +149,7 @@ export class WaterSurface extends THREE.Mesh {
     // (graph shape must be known at creation); createWaterSettings drops the
     // key, so the classic ShaderMaterial path is untouched by it.
     super(geometry, createWaterMaterial(
-      typeof bedHeight === 'function' ? { ...settings, shoaling: true } : settings,
+      { ...settings, shoaling: typeof bedHeight === 'function', dynamics: Boolean(dynamics) },
     ));
     this.name = 'WaterSurface';
     markFactoryStyleMaterial(this.material, 'WaterSurface');
@@ -236,7 +238,7 @@ export class WaterSurface extends THREE.Mesh {
       this.material.defines = { ...this.material.defines, WATER_SHOALING: 1 };
     }
 
-    this.simulationEnabled = simulation !== false;
+    this.simulationEnabled = simulation !== false && !dynamics;
     this.ripples = this.simulationEnabled
       ? new WaterRippleSimulation({
         resolution: simulation.resolution ?? 256,
@@ -305,7 +307,7 @@ export class WaterSurface extends THREE.Mesh {
     // so foam transport and wet-sand memory do not enlarge the already-dense
     // main water material (important for WebGPU's private-memory limit).
     const shoreStateOptions = shoreState === true ? {} : shoreState;
-    this.shoreState = this.bedHeightSampler && shoreStateOptions
+    this.shoreState = !dynamics && this.bedHeightSampler && shoreStateOptions
       ? new WaterShoreStateField({
         region: {
           centerX: 0,
@@ -320,6 +322,7 @@ export class WaterSurface extends THREE.Mesh {
       : null;
     this.shoreStateMaterials = new Set();
 
+    this.dynamics = dynamics ? new WaterDynamics(this, dynamics) : null;
     this.syncSimulationParameters();
     this.bindShoreState();
   }
@@ -506,7 +509,7 @@ export class WaterSurface extends THREE.Mesh {
   attachShoreStateMaterial(material) {
     if (!material) return this;
     this.shoreStateMaterials.add(material);
-    updateWaterShoreMaterial(material, { stateField: this.shoreState });
+    updateWaterShoreMaterial(material, { stateField: this.dynamics ?? this.shoreState });
     return this;
   }
 
@@ -517,7 +520,11 @@ export class WaterSurface extends THREE.Mesh {
 
   bindShoreState() {
     const uniforms = this.material.uniforms;
-    if (this.shoreState) {
+    if (this.dynamics) {
+      uniforms.uShoreStateMap.value = this.dynamics.texture;
+      uniforms.uUseShoreState.value = 1;
+      this.dynamics.getRegion(uniforms.uShoreStateRegion.value);
+    } else if (this.shoreState) {
       uniforms.uShoreStateMap.value = this.shoreState.texture;
       uniforms.uUseShoreState.value = 1;
       this.shoreState.getRegion(uniforms.uShoreStateRegion.value);
@@ -525,7 +532,7 @@ export class WaterSurface extends THREE.Mesh {
       uniforms.uUseShoreState.value = 0;
     }
     for (const material of this.shoreStateMaterials ?? []) {
-      updateWaterShoreMaterial(material, { stateField: this.shoreState });
+      updateWaterShoreMaterial(material, { stateField: this.dynamics ?? this.shoreState });
     }
     return this;
   }
@@ -828,11 +835,12 @@ export class WaterSurface extends THREE.Mesh {
     return surfaceY + this.relativeSurfaceHeightAt(x, z, surfaceY);
   }
 
-  // Surface height relative to the rest level — the exact CPU mirror of the
-  // vertex shader's shoaling/breaking/swash displacement, so buoyancy, swim
-  // floats, and splash anchors sit on the rendered surface everywhere,
-  // including the surf zone and the run-up film on the beach.
+  // Approximate CPU height relative to rest level. Mirrors vertical shoreline
+  // shaping but does not invert Gerstner horizontal displacement or read GPU
+  // ripples. Do not use this as an exact Eulerian contact/volume solver; see
+  // docs/audits/water-shader-lab-2026-09-05.md.
   relativeSurfaceHeightAt(x, z, surfaceY) {
+    if (this.dynamics?.gridSignature) return this.dynamics.sample(x, z).height - surfaceY;
     if (!this.bedHeightSampler) {
       return sampleGerstnerHeight(this.gerstnerWaves, x, z, this.time);
     }
@@ -888,7 +896,7 @@ export class WaterSurface extends THREE.Mesh {
       swashFrame.primaryDirectionX ?? waves[0]?.dirX ?? settings.flowDirection?.[0] ?? 0,
       swashFrame.cycle,
       swashFrame.edgeShape,
-    );
+    ) * swashFrame.activity * (maximumDistance > 0 ? 1 : 0);
     const edgeHead = edgeDistance * safeSlope + edgeOffset * safeSlope;
     const filmHead = restDepth + edgeHead;
     const film = THREE.MathUtils.clamp(filmHead * 0.45 + 0.008, 0.003, 0.045);
@@ -916,6 +924,10 @@ export class WaterSurface extends THREE.Mesh {
   // their traveling face flow; explicit swash adds uphill uprush and downhill
   // backwash so gameplay objects move with the rendered shoreline.
   getFlowAt(x, z, out = new THREE.Vector2()) {
+    if (this.dynamics?.gridSignature) {
+      const sample = this.dynamics.sample(x, z);
+      return out.set(sample.velocityX, sample.velocityZ);
+    }
     out.set(0, 0);
     if (this.currentField) {
       this.currentField.sampleAt(x, z, currentSampleScratch);
@@ -946,7 +958,7 @@ export class WaterSurface extends THREE.Mesh {
         swashFrame.primaryDirectionX ?? this.gerstnerWaves[0]?.dirX ?? 0,
         swashFrame.cycle,
         swashFrame.edgeShape,
-      );
+      ) * swashFrame.activity;
       const maximumDistance = this.settings.runupDistance;
       const edgeDistance = swashFrame.edgeDistance;
       const head = edgeDistance * slope + offset * slope;
@@ -964,7 +976,7 @@ export class WaterSurface extends THREE.Mesh {
             frame.primaryDirectionX ?? this.gerstnerWaves[0]?.dirX ?? 0,
             frame.cycle,
             frame.edgeShape,
-          );
+          ) * frame.activity;
         };
         const before = totalEdgeAt(this.time - dt);
         const after = totalEdgeAt(this.time + dt);
@@ -1128,6 +1140,7 @@ export class WaterSurface extends THREE.Mesh {
   // breakerAmount setting and rebuilds the break line whenever the surface
   // moves or the swell energy shifts enough to relocate the collapse depth.
   updateBreakers() {
+    if (this.dynamics) return;
     const enabled = shouldUseDedicatedBreakerShell(this.settings, Boolean(this.bedHeightSampler));
     if (!enabled) {
       if (this.breakers) {
@@ -1190,6 +1203,7 @@ export class WaterSurface extends THREE.Mesh {
   // Composite splash at a world position: particles + a downward impulse and
   // an outward ring wave in the ripple simulation.
   splash(worldPoint, { strength = 1, radius = 0.5 } = {}) {
+    this.dynamics?.impulse(worldPoint.x, worldPoint.z, strength, radius);
     const local = this.worldToLocalPoint(worldPoint);
     local.y = this.relativeSurfaceHeightAt(
       worldPoint.x ?? 0, worldPoint.z ?? 0, worldPositionScratch.y);
@@ -1210,6 +1224,7 @@ export class WaterSurface extends THREE.Mesh {
 
   // Plain ripple impulse (no particles) — wakes, rain, gentle touches.
   addRipple(worldPoint, { radius = 0.4, strength = 0.4 } = {}) {
+    this.dynamics?.impulse(worldPoint.x, worldPoint.z, strength * this.settings.rippleStrength, radius);
     this.ripples?.addImpulse(worldPoint.x, worldPoint.z, {
       radius,
       strength: strength * this.settings.rippleStrength,
@@ -1235,6 +1250,18 @@ export class WaterSurface extends THREE.Mesh {
     this.interactions.remove(id);
   }
 
+  // Hosts with buoyant actors may prepare the field before moving actors;
+  // update() then captures that same field without advancing it a second time.
+  prepareDynamics(delta) {
+    if (this.dynamics) {
+      this.dynamics.update(Math.max(0, Math.min(delta, 0.1)));
+      this.time = this.dynamics.time;
+      this.dynamicsPrepared = true;
+      this.bindShoreState();
+    }
+    return this;
+  }
+
   // Call once per frame before rendering the scene.
   update(renderer, scene, camera, delta) {
     // A preceding frame's underwater atmosphere must never leak into the
@@ -1259,7 +1286,12 @@ export class WaterSurface extends THREE.Mesh {
         this.bakeShoalingDepths();
       }
     }
-    this.updateBreakers();
+    if (this.dynamics) {
+      if (!this.dynamicsPrepared) this.dynamics.update(clampedDelta);
+      this.dynamicsPrepared = false;
+      this.time = this.dynamics.time;
+      this.bindShoreState();
+    } else this.updateBreakers();
 
     if (this.ripples) {
       this.getWorldPosition(worldPositionScratch);
@@ -1344,11 +1376,18 @@ export class WaterSurface extends THREE.Mesh {
     updateWaterMaterialCamera(this.material, renderer, camera);
     this.getWorldPosition(worldPositionScratch);
     const cameraPosition = camera.getWorldPosition(followScratch);
-    const cameraBelow = cameraPosition.y < worldPositionScratch.y;
+    // Use the animated local column, including finite XZ and the authored
+    // bed. A flat rest-plane test misclassified cameras inside crests, above
+    // troughs, or below dry terrain. Capture passes consume this same flag.
+    const cameraSurfaceY = this.getHeightAt(cameraPosition.x, cameraPosition.z);
+    const cameraBedY = this.bedHeightSampler?.(cameraPosition.x, cameraPosition.z) ?? -Infinity;
+    const cameraBelow = this.containsPoint(cameraPosition.x, cameraPosition.z)
+      && cameraPosition.y < cameraSurfaceY && cameraPosition.y > cameraBedY
+      && (!this.dynamics || this.dynamics.sample(cameraPosition.x, cameraPosition.z).wet);
     uniforms.uCameraBelow.value = cameraBelow ? 1 : 0;
     const renderedSettings = this.renderedSettings ?? this.settings;
     updateProjectedWaterCaustics({
-      enabled: cameraBelow && renderedSettings.causticsStrength > 0.001,
+      enabled: (cameraBelow || Boolean(this.dynamics)) && renderedSettings.causticsStrength > 0.001,
       time: this.time,
       waterLevel: worldPositionScratch.y,
       centerX: worldPositionScratch.x,
@@ -1361,6 +1400,8 @@ export class WaterSurface extends THREE.Mesh {
       speed: renderedSettings.causticsSpeed,
       flowDirection: renderedSettings.flowDirection,
       waveDistortion: 0.035 + renderedSettings.detailNormalStrength * 0.08,
+      surfaceMap: this.dynamics?.causticTexture ?? null,
+      surfaceRegion: this.dynamics?.causticRegion ?? null,
       depthAttenuation: 1 / Math.max(
         renderedSettings.depthFadeDistance + renderedSettings.deepFadeDistance,
         0.25,
@@ -1389,12 +1430,15 @@ export class WaterSurface extends THREE.Mesh {
       waterZ: worldPositionScratch.z,
       width: this.width,
       depth: this.depth,
+      surfaceY: cameraSurfaceY,
+      bedY: cameraBedY,
       settings: renderedSettings,
     });
     return this;
   }
 
   dispose() {
+    this.dynamics?.dispose();
     this.volumeSkirt?.geometry.dispose();
     this.volumeSkirt?.material.dispose();
     this.geometry.dispose();

package/src/water/waterUnderwaterAtmosphere.js

@@ -1,4 +1,5 @@
 import * as THREE from 'three';
+import { cameraPosition, clamp, exp, Fn, length, max, mix, output, positionWorld, uniform, vec3, vec4 } from 'three/tsl';
 
 export const DEFAULT_WATER_UNDERWATER_ATMOSPHERE = Object.freeze({
   enabled: true,
@@ -55,6 +56,7 @@ export function createWaterUnderwaterAtmosphereOptions(options = true) {
     clipToSurfaceBounds: source.clipToSurfaceBounds ?? true,
     boundsMargin: Math.max(0, finiteOr(source.boundsMargin, 0)),
     clearFogNode: source.clearFogNode ?? true,
+    waterPathFog: source.waterPathFog ?? false,
   };
 }
 
@@ -65,6 +67,8 @@ export function resolveWaterUnderwaterAtmosphereState({
   waterX = 0,
   waterY = 0,
   waterZ = 0,
+  surfaceY = waterY,
+  bedY = -Infinity,
   width = Infinity,
   depth = Infinity,
   settings = {},
@@ -76,10 +80,12 @@ export function resolveWaterUnderwaterAtmosphereState({
     Math.abs(cameraX - waterX) <= Math.max(0, width * 0.5) + boundsMargin
     && Math.abs(cameraZ - waterZ) <= Math.max(0, depth * 0.5) + boundsMargin
   );
-  const submergedDepth = Math.max(waterY - cameraY, 0);
+  const submergedDepth = Math.max(surfaceY - cameraY, 0);
   const active = Boolean(
     resolvedOptions.enabled
-    && cameraY < waterY
+    && cameraY < surfaceY
+    && cameraY > bedY
+    && surfaceY > bedY
     && insideBounds
   );
   const midColor = colorArray(
@@ -98,7 +104,10 @@ export function resolveWaterUnderwaterAtmosphereState({
     fogFar: resolvedOptions.fogFar,
     overlayOpacity: resolvedOptions.overlayOpacity,
     clearFogNode: resolvedOptions.clearFogNode,
+    waterPathFog: resolvedOptions.waterPathFog ?? false,
     waterY,
+    surfaceY,
+    bedY,
   };
 }
 
@@ -220,7 +229,25 @@ function applySelectedAtmosphere(scene, state) {
   state.ownedFog.far = selected.fogFar;
   scene.background = state.ownedBackground;
   scene.fog = state.ownedFog;
-  if (selected.clearFogNode) scene.fogNode = null;
+  if (selected.waterPathFog) {
+    if (!state.opticalFog) {
+      const color = uniform(new THREE.Color()), level = uniform(0), density = uniform(1);
+      const node = Fn(() => {
+        const ray = positionWorld.sub(cameraPosition);
+        // Main camera is submerged. Above-water geometry only accumulates
+        // attenuation up to the interface, never over its segment in air.
+        const fraction = clamp(level.sub(cameraPosition.y).div(max(ray.y, 1e-5)), 0.0, 1.0);
+        const waterDistance = length(ray).mul(fraction);
+        const transmission = exp(vec3(0.18,0.065,0.04).mul(waterDistance).mul(density).negate());
+        return vec4(output.rgb.mul(transmission).add(color.mul(transmission.oneMinus())), output.a);
+      })();
+      state.opticalFog = { color, level, density, node };
+    }
+    state.opticalFog.color.value.setRGB(...selected.color, THREE.SRGBColorSpace);
+    state.opticalFog.level.value = selected.surfaceY ?? selected.waterY;
+    state.opticalFog.density.value = 32 / Math.max(selected.fogFar, 1);
+    scene.fogNode = state.opticalFog.node;
+  } else if (selected.clearFogNode) scene.fogNode = null;
   placeAtmosphereOverlay(
     ensureAtmosphereOverlay(scene, state),
     selected.camera,

package/types/catalog/officialCatalog.d.ts

@@ -2,3 +2,4 @@ export * from "./officialCatalogProvider.js";
 export * from "./officialCatalogAssetRuntime.js";
 export * from "./officialCatalogLod.js";
 export * from "./officialCatalogPlacement.js";
+export * from "./officialCatalogRockPackage.js";

package/types/catalog/officialCatalogPlacement.d.ts

@@ -18,6 +18,9 @@ export interface OfficialCatalogPlacementOptions {
   rotation?: CatalogVector3;
   scale?: CatalogVector3;
   targetId?: string | null;
+  textures?: Readonly<Record<string, unknown>>;
+  usePublishedRockSurface?: boolean;
+  variation?: number;
 }
 export interface OfficialCatalogPlacement {
   readonly asset: unknown;
@@ -32,6 +35,7 @@ export interface OfficialCatalogPlacement {
   };
   readonly normalization: Readonly<Record<string, unknown>>;
   readonly object: Object3D;
+  readonly publishedRockSurface: unknown;
   readonly quality: unknown;
   readonly released: boolean;
   readonly style: StyleApplicationResult;

package/types/catalog/officialCatalogRockPackage.d.ts

@@ -0,0 +1,68 @@
+import type { Texture, TextureLoader } from 'three';
+
+export const OFFICIAL_ROCK_GALLERY_RECIPE_SCHEMA: 'toonlab/rock-gallery-recipe';
+export const OFFICIAL_ROCK_MATERIAL_SCHEMA: 'toonlab.pro-rock-material';
+
+export interface OfficialCatalogArtifact {
+  readonly byteSize: number;
+  readonly contentType: string;
+  readonly name: string;
+  readonly sha256: string;
+  readonly url: string | null;
+}
+
+export interface OfficialCatalogRockPackageFiles {
+  readonly collisionModelUrl: string | null;
+  readonly controlModelUrl: string | null;
+  readonly lodModelUrls: readonly (string | null)[];
+  readonly manifestUrl: string | null;
+  readonly materialConfigUrl: string | null;
+  readonly natureProvenanceUrl: string | null;
+  readonly natureReferenceUrl: string | null;
+  readonly realisticModelUrl: string;
+  readonly realisticPreviewUrl: string | null;
+  readonly recipeUrl: string | null;
+  readonly retainedHighModelUrl: string | null;
+  readonly stylizedModelUrl: string | null;
+  readonly stylizedPreviewUrl: string | null;
+}
+
+export interface OfficialCatalogRockPackage {
+  readonly asset: Readonly<Record<string, unknown>>;
+  readonly files: OfficialCatalogRockPackageFiles;
+  readonly manifest: Readonly<Record<string, unknown>> | null;
+  readonly materialConfig: Readonly<Record<string, unknown>> | null;
+  readonly natureProvenance: Readonly<Record<string, unknown>> | null;
+  readonly recipe: Readonly<Record<string, unknown>> | null;
+}
+
+export interface OfficialCatalogRockShaderInput {
+  readonly materialConfig: Readonly<Record<string, unknown>>;
+  readonly settings: Readonly<Record<string, unknown>>;
+  readonly textures: Readonly<Record<string, Texture>>;
+}
+
+export function findOfficialCatalogArtifact(
+  asset: { readonly artifacts?: readonly OfficialCatalogArtifact[] },
+  ...names: string[]
+): OfficialCatalogArtifact | null;
+export function getOfficialCatalogArtifactUrl(
+  asset: { readonly artifacts?: readonly OfficialCatalogArtifact[] },
+  ...names: string[]
+): string | null;
+export function loadOfficialCatalogRockPackage(
+  asset: Readonly<Record<string, unknown>>,
+  options?: {
+    readonly fetchImpl?: typeof globalThis.fetch;
+    readonly includeManifest?: boolean;
+    readonly includeNatureProvenance?: boolean;
+  },
+): Promise<OfficialCatalogRockPackage>;
+export function loadOfficialCatalogRockShaderInput(
+  rockPackage: OfficialCatalogRockPackage,
+  options?: { readonly textureLoader?: TextureLoader },
+): Promise<OfficialCatalogRockShaderInput | null>;
+export function createOfficialCatalogRockEditorDescriptor(
+  asset: Readonly<Record<string, unknown>>,
+  rockPackage?: OfficialCatalogRockPackage | null,
+): Readonly<Record<string, unknown>> | null;

package/types/cloud/noise/baseShapeVolume.d.ts

@@ -44,7 +44,7 @@ export function createCloudBaseShapeVolume({ dims, seed, }?: {
     seed?: number;
 }): import("three").Data3DTexture;
 /**
- * Cached base-shape volume, keyed by resolution and seed. A tier switch that
+ * Cached canonical base-shape volume, keyed by resolution. A tier switch that
  * returns to a resolution already baked pays nothing, and the shadow/env-map
  * bakes share the runtime's volumes.
  */

package/types/cloud/noise/textureCache.d.ts

@@ -0,0 +1,12 @@
+export function getCloudTextureCacheStats(): {
+    retainedBytes: number;
+    retainedEntries: number;
+    maxBytes: number;
+    maxEntries: number;
+};
+export function createCloudTextureCache(namespace: any): {
+    get(key: any): any;
+    set(key: any, texture: any): void;
+    values(): Generator<any, void, unknown>;
+    clear(): void;
+};

package/types/core/sha256.d.ts

@@ -0,0 +1,2 @@
+/** Synchronous browser-safe SHA-256 used for portable document identities. */
+export function sha256Hex(value: any): string;

package/types/index.d.ts

@@ -243,6 +243,11 @@ export const DEFAULT_WATER_INTERACTION_CONFIG: any;
 export const DEFAULT_WATER_SCENARIO: any;
 export const DEFAULT_WATER_SETTINGS: any;
 export const DEFAULT_WATER_UNDERWATER_ATMOSPHERE: any;
+export const DENSE_FIELD_ROCK_CULL_BELOW_PIXELS: any;
+export const DENSE_FIELD_ROCK_LOD_LEVELS: any;
+export const DENSE_FIELD_ROCK_PIXEL_THRESHOLDS: any;
+export const DENSE_FIELD_ROCK_PRODUCTION_RULE: any;
+export const DENSE_FIELD_ROCK_TRIANGLE_CEILINGS: any;
 export const ENVIRONMENT_DEBUG_MODES: any;
 export const ENVIRONMENT_MATERIAL_ROLES: any;
 export const ENVIRONMENT_PRESET_ALIASES: any;
@@ -347,6 +352,8 @@ export const MOON_DISC_NORMALISATION: any;
 export const MULTI_SCATTERING_LUT_SIZE: any;
 export class ManufacturedStyleLabelingError { constructor(...args: any[]); [key: string]: any; }
 export const NATIVE_LOCOMOTION_CLIP_NAMES: any;
+export const NATURAL_ROCK_MAP_ROLES: any;
+export const NATURAL_ROCK_SURFACE_PROFILES: any;
 export const NEEDLE_LEAF_SHAPES: any;
 export const NEUTRAL_ENVIRONMENT_PRESET: any;
 export const NEUTRAL_ENVIRONMENT_RESOLVED_SETTINGS: any;
@@ -371,6 +378,8 @@ export const NIGHT_SKY_PARAM_KEYS: any;
 export const NIGHT_SKY_PARAM_SCHEMA: any;
 export const OFFICIAL_CATALOG_ASSET_VERSION: any;
 export const OFFICIAL_CATALOG_PROVIDER_TRANSPORTS: any;
+export const OFFICIAL_ROCK_GALLERY_RECIPE_SCHEMA: any;
+export const OFFICIAL_ROCK_MATERIAL_SCHEMA: any;
 export class OfficialCatalogProviderError { constructor(...args: any[]); [key: string]: any; }
 export const POST_GENERATOR_DOMAIN: any;
 export const POST_PROCESSING_PRESETS: any;
@@ -397,6 +406,7 @@ export const RESOLVED_SCENE_LOOK_DOCUMENT_TYPE: any;
 export const RESOLVED_SCENE_LOOK_DOCUMENT_VERSION: any;
 export const REVIEWED_CATALOG_LICENSES: any;
 export const RIM_LIGHT_MODES: any;
+export const ROCKGEN_MAX_MESH_CUT_OPERATIONS: any;
 export const ROCKGEN_MAX_MESH_EDIT_DELTAS: any;
 export const ROCKGEN_MAX_MESH_EDIT_OPERATIONS: any;
 export const ROCKGEN_MESH_EDIT_ENCODING: any;
@@ -777,6 +787,9 @@ export function createBranchTubeGeometry(...args: any[]): any;
 export function createBranchingTreeSkeleton(...args: any[]): any;
 export function createC7GeologyMapData(...args: any[]): any;
 export function createC7SurfaceSpecification(...args: any[]): any;
+export function createC8ReferenceAuthoritySourceId(...args: any[]): any;
+export function createC8ReferenceGeometrySourceId(...args: any[]): any;
+export function createC8ReferenceSurfaceSourceId(...args: any[]): any;
 export function createCallMeSenseiGrassField(...args: any[]): any;
 export function createCallMeSenseiGrassMaterial(...args: any[]): any;
 export function createCallMeSenseiSkyLightProbe(...args: any[]): any;
@@ -809,6 +822,7 @@ export function createCurlNoiseVolume(...args: any[]): any;
 export function createCurveFrame(...args: any[]): any;
 export function createDebugEnvironmentMaterial(...args: any[]): any;
 export function createDefaultRockShaderTextureSet(...args: any[]): any;
+export function createDenseFieldRockLodRuntime(...args: any[]): any;
 export function createDensityWeightMask(...args: any[]): any;
 export function createDirectionalLightDescriptor(...args: any[]): any;
 export function createDiscAreaLightDescriptor(...args: any[]): any;
@@ -896,10 +910,13 @@ export function createManufacturedMaterialLook(...args: any[]): any;
 export function createMaterialMapSettings(...args: any[]): any;
 export function createMoonAlbedoData(...args: any[]): any;
 export function createMoonAlbedoTexture(...args: any[]): any;
+export function createNaturalRockMapData(...args: any[]): any;
+export function createNaturalRockSurfaceSpecification(...args: any[]): any;
 export function createNightSky(...args: any[]): any;
 export function createNoisePatchMask(...args: any[]): any;
 export function createOfficialCatalogAssetRuntime(...args: any[]): any;
 export function createOfficialCatalogProvider(...args: any[]): any;
+export function createOfficialCatalogRockEditorDescriptor(...args: any[]): any;
 export function createOrganLeafSpriteTexture(...args: any[]): any;
 export function createOssStyleBundleProvider(...args: any[]): any;
 export function createOutlineSettings(...args: any[]): any;
@@ -1031,6 +1048,7 @@ export function deriveCanopyPalette(...args: any[]): any;
 export function describeCatalogLicense(...args: any[]): any;
 export function describeNeutralStyleCoverage(...args: any[]): any;
 export function describeTexture(...args: any[]): any;
+export function describeToonLabDirectionalBeddingProjection(...args: any[]): any;
 export function deserializeLightingLook(...args: any[]): any;
 export function deserializeLightingLookPreset(...args: any[]): any;
 export function deserializeLightingRecipe(...args: any[]): any;
@@ -1059,6 +1077,7 @@ export const environmentStateUniforms: any;
 export function environmentUsesAlphaCutout(...args: any[]): any;
 export function erodeHeightfield(...args: any[]): any;
 export function erodeHeightfieldStylized(...args: any[]): any;
+export function estimateCatalogProjectedPixels(...args: any[]): any;
 export function estimateSurfaceNetsResolution(...args: any[]): any;
 export function evaluateAssetCandidate(...args: any[]): any;
 export function evaluateField(...args: any[]): any;
@@ -1073,6 +1092,7 @@ export const fallbackEnvironmentNormalTexture: any;
 export const fallbackEnvironmentWhiteTexture: any;
 export function fetchStyleBundle(...args: any[]): any;
 export function findCloudLayerCrossing(...args: any[]): any;
+export function findOfficialCatalogArtifact(...args: any[]): any;
 export function findPrimarySkinnedMesh(...args: any[]): any;
 export function finiteDepthWaveNumberRatio(...args: any[]): any;
 export function fitModelForController(...args: any[]): any;
@@ -1101,6 +1121,7 @@ export function getLightingStyleGeneratorFamilyOptions(...args: any[]): any;
 export function getLightingStylePresetOptions(...args: any[]): any;
 export function getLightingTypeCapability(...args: any[]): any;
 export function getMoonAlbedoTexture(...args: any[]): any;
+export function getOfficialCatalogArtifactUrl(...args: any[]): any;
 export function getPostGeneratorFamilyOptions(...args: any[]): any;
 export function getPostProcessingPresetOptions(...args: any[]): any;
 export function getRenderLayer(...args: any[]): any;
@@ -1133,6 +1154,7 @@ export function hashGeometry(...args: any[]): any;
 export function henyeyGreensteinPhaseNode(...args: any[]): any;
 export function heroCloudSkyOverrides(...args: any[]): any;
 export function hourFromDayCycleTime(...args: any[]): any;
+export function inferDenseFieldRockClass(...args: any[]): any;
 export function inferManufacturedObjectClass(...args: any[]): any;
 export function inspectRockGeometryTangents(...args: any[]): any;
 export function inspectRockRegionBinding(...args: any[]): any;
@@ -1147,6 +1169,7 @@ export function isEnvironmentShadowMesh(...args: any[]): any;
 export function isFoliageMaterial(...args: any[]): any;
 export function isPostProcessingEnabled(...args: any[]): any;
 export function isRockHelperPiece(...args: any[]): any;
+export function isRockSourceMeshReference(...args: any[]): any;
 export function isScanAssetMaterial(...args: any[]): any;
 export function isUtilityTextureLabel(...args: any[]): any;
 export function isVegetationSharedShaderGroup(...args: any[]): any;
@@ -1162,6 +1185,8 @@ export function loadEnvironmentTexture(...args: any[]): any;
 export function loadIdleClipForTarget(...args: any[]): any;
 export function loadJumpClipForTarget(...args: any[]): any;
 export function loadOfficialCatalogAsset(...args: any[]): any;
+export function loadOfficialCatalogRockPackage(...args: any[]): any;
+export function loadOfficialCatalogRockShaderInput(...args: any[]): any;
 export function loadPackagedLocomotionClipsForTarget(...args: any[]): any;
 export function loadRetargetedMixamoClipForTarget(...args: any[]): any;
 export function loadRunningClipForTarget(...args: any[]): any;
@@ -1340,6 +1365,7 @@ export function resolveLuminairePreset(...args: any[]): any;
 export function resolveManufacturedMaterialLook(...args: any[]): any;
 export function resolveMarchBudget(...args: any[]): any;
 export function resolveNativeLocomotionClips(...args: any[]): any;
+export function resolveNaturalRockProjection(...args: any[]): any;
 export function resolveOfficialCatalogUrl(...args: any[]): any;
 export function resolveOutlineForMaterial(...args: any[]): any;
 export function resolvePadPruning(...args: any[]): any;
@@ -1432,6 +1458,7 @@ export function sceneCollisionRuntimeFor(...args: any[]): any;
 export function sculptEditBounds(...args: any[]): any;
 export function searchSurfaceNetsResolution(...args: any[]): any;
 export function selectCatalogLodLevel(...args: any[]): any;
+export function selectCatalogLodLevelByProjectedPixels(...args: any[]): any;
 export function serializableTreeOptions(...args: any[]): any;
 export function serializeGrassPreset(...args: any[]): any;
 export function serializeGroundShaderPreset(...args: any[]): any;
@@ -1520,6 +1547,8 @@ export function toMaterialArray(...args: any[]): any;
 export function toSerializableCloudStyleParams(...args: any[]): any;
 export function toSerializableSkyColorParams(...args: any[]): any;
 export function toSerializableSkyParams(...args: any[]): any;
+export function toonLabDirectionalBeddingColor(...args: any[]): any;
+export function toonLabDirectionalBeddingNormal(...args: any[]): any;
 export function toonLabMountainProfileFromResolvedMaterial(...args: any[]): any;
 export function toonLabRockProfileFromResolvedMaterial(...args: any[]): any;
 export function toonLabScalar(...args: any[]): any;
@@ -1542,6 +1571,7 @@ export function usesAlphaBlend(...args: any[]): any;
 export function validateAssetSourcingPolicy(...args: any[]): any;
 export function validateCollisionMetadata(...args: any[]): any;
 export function validateCompiledTreeManifest(...args: any[]): any;
+export function validateDenseFieldRockLodTargets(...args: any[]): any;
 export function validateEnvironmentPresetDocument(...args: any[]): any;
 export function validateGrassPresetDocument(...args: any[]): any;
 export function validateGroundShaderPresetDocument(...args: any[]): any;

package/types/rock-shader/rockMaterial.d.ts

@@ -9,12 +9,15 @@ export const TOONLAB_ROCK_PROFILE_DEFAULTS: any;
 export const TOONLAB_ROCK_SHADER_GUID: any;
 export function createToonLabMountainMaterial(...args: any[]): any;
 export function createToonRockMaterial(...args: any[]): any;
+export function describeToonLabDirectionalBeddingProjection(...args: any[]): any;
 export function loadToonLabMountainMaterial(...args: any[]): any;
 export function loadToonRockMaterial(...args: any[]): any;
 export function loadToonRockMaterialInputs(...args: any[]): any;
 export function normalizeToonLabMountainProfile(...args: any[]): any;
 export function normalizeToonLabRockProfile(...args: any[]): any;
 export function tangentNormalToView(...args: any[]): any;
+export function toonLabDirectionalBeddingColor(...args: any[]): any;
+export function toonLabDirectionalBeddingNormal(...args: any[]): any;
 export function toonLabMountainProfileFromResolvedMaterial(...args: any[]): any;
 export function toonLabRockProfileFromResolvedMaterial(...args: any[]): any;
 export function toonLabTriplanarColor(...args: any[]): any;

package/types/rock-shader/rockShaderSettings.d.ts

@@ -70,6 +70,8 @@ export const DEFAULT_ROCK_SHADER_SETTINGS: Readonly<{
 }>;
 export const CALL_ME_SENSEI_ROCK_SHADER_SETTINGS: Readonly<{
     projection: Readonly<{
+        mode: "triplanar";
+        upAxis: "y";
         scale: 48;
         saturation: 1;
         contrast: 1;

package/types/rockgen/index.d.ts

@@ -10,3 +10,4 @@ export * from "./mesh/meshDocument.js";
 export * from "./lod/index.js";
 export * from "./export/glbExport.js";
 export * from "./surface/c7GeologySurface.js";
+export { C8_FIRST12_LITHOLOGY_PROFILES as NATURAL_ROCK_SURFACE_PROFILES, C8_FIRST12_MAP_ROLES as NATURAL_ROCK_MAP_ROLES, createC8First12GeologyMapData as createNaturalRockMapData, createC8First12SurfaceSpecification as createNaturalRockSurfaceSpecification, resolveC8First12Projection as resolveNaturalRockProjection } from "./surface/naturalRockSurface.js";

package/types/rockgen/lod/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./rockLodMetrics.js";
+export * from "./rockDenseFieldPolicy.js";
 export * from "./rockLodPlanner.js";
 export * from "./rockLodPolicy.js";
 export * from "./rockLodRuntime.js";