@call-me-sensei/toonlab 0.4.21 → 0.4.22

package/src/version.js

@@ -1,3 +1,3 @@
 // Single runtime source of truth for package consumers and ToonLab Pro/MCP.
 // Keep this value synchronized with package.json during release preparation.
-export const TOONLAB_VERSION = '0.4.21';
+export const TOONLAB_VERSION = '0.4.22';

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/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;
@@ -371,6 +376,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;
@@ -777,6 +784,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 +819,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;
@@ -900,6 +911,7 @@ 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 +1043,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 +1072,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 +1087,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 +1116,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 +1149,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 +1164,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 +1180,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;
@@ -1432,6 +1452,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 +1541,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 +1565,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/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";

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

@@ -0,0 +1,181 @@
+export function inferDenseFieldRockClass({ scaleClass, targetHeightMetres }?: {
+    scaleClass?: any;
+    targetHeightMetres?: any;
+}): "landmark" | "formation" | "ordinary";
+export function validateDenseFieldRockLodTargets(targets: any, { assetClass, }?: {
+    assetClass?: string;
+}): Readonly<{
+    assetClass: string;
+    ceilings: any;
+    errors: readonly string[];
+    valid: boolean;
+    values: readonly number[];
+}>;
+/**
+ * Install the mandatory dense-field rock behavior on an authored LOD0-LOD4
+ * root. The final tier is geometry-only silhouette support; it never casts a
+ * shadow and the root is culled once its projected diameter drops below the
+ * production pixel threshold.
+ */
+export function createDenseFieldRockLodRuntime(root: any, { cullBelowPixels, hysteresis, maxLevel, pixelThresholds, referenceDiameter, requireComplete, }?: {
+    cullBelowPixels?: number;
+    hysteresis?: number;
+    maxLevel?: number;
+    pixelThresholds?: readonly number[];
+    referenceDiameter?: any;
+    requireComplete?: boolean;
+}): Readonly<{
+    policy: Readonly<{
+        cullBelowPixels: 5;
+        farShadowLastLevel: 2;
+        levelCount: 5;
+        levels: readonly (Readonly<{
+            id: "LOD0";
+            level: 0;
+            purpose: "hero-close";
+        }> | Readonly<{
+            id: "LOD1";
+            level: 1;
+            purpose: "near-gameplay";
+        }> | Readonly<{
+            id: "LOD2";
+            level: 2;
+            purpose: "mid-gameplay";
+        }> | Readonly<{
+            id: "LOD3";
+            level: 3;
+            purpose: "far-simplified";
+        }> | Readonly<{
+            id: "LOD4";
+            level: 4;
+            purpose: "very-far-silhouette";
+        }>)[];
+        pixelThresholds: readonly number[];
+        selectionBasis: "projected-object-diameter-pixels";
+        triangleCeilings: Readonly<{
+            ordinary: Readonly<{
+                LOD3: 1200;
+                LOD4: 350;
+            }>;
+            formation: Readonly<{
+                LOD3: 1800;
+                LOD4: 600;
+            }>;
+            landmark: Readonly<{
+                LOD3: 2500;
+                LOD4: 800;
+            }>;
+        }>;
+        veryFar: Readonly<{
+            allowedSurfaceChannels: readonly string[];
+            castShadow: false;
+            preserve: readonly string[];
+            remove: readonly string[];
+            silhouetteOnly: true;
+        }>;
+    }>;
+    dispose(): void;
+    availableLevels: readonly any[];
+    bindings: readonly any[];
+    disposed: boolean;
+    level: any;
+    setLevel: (level: any) => boolean;
+    cullBelowPixels: number;
+    pixelThresholds: readonly any[];
+    referenceDiameter: number;
+    thresholds: readonly any[];
+    hysteresis: number;
+    update: (options?: {}) => Readonly<{
+        changed: boolean;
+        culled: boolean;
+        distance: number;
+        level: any;
+        projectedPixels: number;
+    }>;
+}>;
+export const DENSE_FIELD_ROCK_LOD_LEVELS: readonly (Readonly<{
+    id: "LOD0";
+    level: 0;
+    purpose: "hero-close";
+}> | Readonly<{
+    id: "LOD1";
+    level: 1;
+    purpose: "near-gameplay";
+}> | Readonly<{
+    id: "LOD2";
+    level: 2;
+    purpose: "mid-gameplay";
+}> | Readonly<{
+    id: "LOD3";
+    level: 3;
+    purpose: "far-simplified";
+}> | Readonly<{
+    id: "LOD4";
+    level: 4;
+    purpose: "very-far-silhouette";
+}>)[];
+export const DENSE_FIELD_ROCK_PIXEL_THRESHOLDS: readonly number[];
+export const DENSE_FIELD_ROCK_CULL_BELOW_PIXELS: 5;
+export const DENSE_FIELD_ROCK_TRIANGLE_CEILINGS: Readonly<{
+    ordinary: Readonly<{
+        LOD3: 1200;
+        LOD4: 350;
+    }>;
+    formation: Readonly<{
+        LOD3: 1800;
+        LOD4: 600;
+    }>;
+    landmark: Readonly<{
+        LOD3: 2500;
+        LOD4: 800;
+    }>;
+}>;
+export const DENSE_FIELD_ROCK_PRODUCTION_RULE: Readonly<{
+    cullBelowPixels: 5;
+    farShadowLastLevel: 2;
+    levelCount: 5;
+    levels: readonly (Readonly<{
+        id: "LOD0";
+        level: 0;
+        purpose: "hero-close";
+    }> | Readonly<{
+        id: "LOD1";
+        level: 1;
+        purpose: "near-gameplay";
+    }> | Readonly<{
+        id: "LOD2";
+        level: 2;
+        purpose: "mid-gameplay";
+    }> | Readonly<{
+        id: "LOD3";
+        level: 3;
+        purpose: "far-simplified";
+    }> | Readonly<{
+        id: "LOD4";
+        level: 4;
+        purpose: "very-far-silhouette";
+    }>)[];
+    pixelThresholds: readonly number[];
+    selectionBasis: "projected-object-diameter-pixels";
+    triangleCeilings: Readonly<{
+        ordinary: Readonly<{
+            LOD3: 1200;
+            LOD4: 350;
+        }>;
+        formation: Readonly<{
+            LOD3: 1800;
+            LOD4: 600;
+        }>;
+        landmark: Readonly<{
+            LOD3: 2500;
+            LOD4: 800;
+        }>;
+    }>;
+    veryFar: Readonly<{
+        allowedSurfaceChannels: readonly string[];
+        castShadow: false;
+        preserve: readonly string[];
+        remove: readonly string[];
+        silhouetteOnly: true;
+    }>;
+}>;