@call-me-sensei/toonlab 0.4.19 → 0.4.21

package/src/water/waterSettings.js

@@ -597,6 +597,14 @@ export function createWaterSettings(options = {}) {
   const colorTone = resolveWaterColorToneName(source.colorTone ?? base.colorTone);
   // A chosen tone forces its palette (see WATER_COLOR_TONES).
   const tone = WATER_COLOR_TONES[colorTone];
+  // ...but only the *palette*. The tone's non-colour scalars (clarity
+  // distances, caustic/reflection/detail gains) are its recommended defaults,
+  // not a lock: an explicit caller value wins over them. Before this, passing
+  // `detailNormalStrength` or `reflectionStrength` alongside `colorTone:
+  // 'anime'` was silently inert, which is exactly what §6.4 of the launch spec
+  // asks for and could not get (D19-005). Callers that pass nothing are
+  // unaffected — they still resolve to the tone value, byte for byte.
+  const toneScalar = (key) => (source[key] === undefined ? tone[key] : source[key]);
 
   const quality = WATER_QUALITY_LEVELS.includes(String(source.quality).toLowerCase())
     ? String(source.quality).toLowerCase()
@@ -633,7 +641,7 @@ export function createWaterSettings(options = {}) {
     waveSetPeriod: clampedNumber(source.waveSetPeriod, base.waveSetPeriod, 8, 600),
     waveSetStrength: clampedNumber(source.waveSetStrength, base.waveSetStrength, 0, 1),
 
-    detailNormalStrength: clampedNumber(tone.detailNormalStrength ?? source.detailNormalStrength, base.detailNormalStrength, 0, 2),
+    detailNormalStrength: clampedNumber(toneScalar('detailNormalStrength'), base.detailNormalStrength, 0, 2),
     detailScale: clampedNumber(source.detailScale, base.detailScale, 0.05, 12),
     flowDirection: vector2Array(source.flowDirection, base.flowDirection),
     flowSpeed: clampedNumber(source.flowSpeed, base.flowSpeed, 0, 8),
@@ -641,8 +649,8 @@ export function createWaterSettings(options = {}) {
     shallowColor: colorArray(tone.shallowColor ?? source.shallowColor, base.shallowColor),
     midColor: colorArray(tone.midColor ?? source.midColor, base.midColor),
     deepColor: colorArray(tone.deepColor ?? source.deepColor, base.deepColor),
-    depthFadeDistance: clampedNumber(tone.depthFadeDistance ?? source.depthFadeDistance, base.depthFadeDistance, 0.01, 60),
-    deepFadeDistance: clampedNumber(tone.deepFadeDistance ?? source.deepFadeDistance, base.deepFadeDistance, 0.01, 120),
+    depthFadeDistance: clampedNumber(toneScalar('depthFadeDistance'), base.depthFadeDistance, 0.01, 60),
+    deepFadeDistance: clampedNumber(toneScalar('deepFadeDistance'), base.deepFadeDistance, 0.01, 120),
     opacity: clampedNumber(source.opacity, base.opacity, 0, 1),
     refractionStrength: clampedNumber(source.refractionStrength, base.refractionStrength, 0, 3),
     indexOfRefraction: clampedNumber(
@@ -654,7 +662,7 @@ export function createWaterSettings(options = {}) {
     underwaterTintStrength: clampedNumber(
       source.underwaterTintStrength, base.underwaterTintStrength, 0, 1,
     ),
-    causticsStrength: clampedNumber(tone.causticsStrength ?? source.causticsStrength, base.causticsStrength, 0, 4),
+    causticsStrength: clampedNumber(toneScalar('causticsStrength'), base.causticsStrength, 0, 4),
     causticsScale: clampedNumber(source.causticsScale, base.causticsScale, 0.02, 12),
     causticsSpeed: clampedNumber(source.causticsSpeed, base.causticsSpeed, 0, 8),
 
@@ -690,13 +698,13 @@ export function createWaterSettings(options = {}) {
     sceneShadowStrength: clampedNumber(source.sceneShadowStrength, base.sceneShadowStrength, 0, 1),
     fresnelStrength: clampedNumber(source.fresnelStrength, base.fresnelStrength, 0, 2),
     fresnelPower: clampedNumber(source.fresnelPower, base.fresnelPower, 0.5, 16),
-    fresnelBias: clampedNumber(tone.fresnelBias ?? source.fresnelBias, base.fresnelBias, 0, 0.6),
+    fresnelBias: clampedNumber(toneScalar('fresnelBias'), base.fresnelBias, 0, 0.6),
     fresnelColor: colorArray(tone.fresnelColor ?? source.fresnelColor, base.fresnelColor),
     skyZenithColor: colorArray(source.skyZenithColor, base.skyZenithColor),
     skyHorizonColor: colorArray(source.skyHorizonColor, base.skyHorizonColor),
-    reflectionStrength: clampedNumber(tone.reflectionStrength ?? source.reflectionStrength, base.reflectionStrength, 0, 1.5),
+    reflectionStrength: clampedNumber(toneScalar('reflectionStrength'), base.reflectionStrength, 0, 1.5),
     reflectionDistortion: clampedNumber(source.reflectionDistortion, base.reflectionDistortion, 0, 0.5),
-    reflectionSoftness: clampedNumber(tone.reflectionSoftness ?? source.reflectionSoftness, base.reflectionSoftness, 0, 1),
+    reflectionSoftness: clampedNumber(toneScalar('reflectionSoftness'), base.reflectionSoftness, 0, 1),
 
     rippleStrength: clampedNumber(source.rippleStrength, base.rippleStrength, 0, 8),
     rippleDamping: clampedNumber(source.rippleDamping, base.rippleDamping, 0.8, 0.9995),

package/types/asset-policy/catalogLicenses.d.ts

@@ -1,5 +1,7 @@
 // Source inference fallback: public names retained with permissive signatures.
 export const APPROVED_CATALOG_SPDX_LICENSES: any;
+export const CATALOG_LICENSE_UNSPECIFIED: any;
 export const REVIEWED_CATALOG_LICENSES: any;
 export function assertCatalogLicenseRelease(...args: any[]): any;
+export function describeCatalogLicense(...args: any[]): any;
 export function resolveCatalogLicense(...args: any[]): any;

package/types/asset-policy/index.d.ts

@@ -7,11 +7,13 @@ export const ASSET_SOURCE_CLASSES: any;
 export const ASSET_SOURCING_POLICY_DOCUMENT_TYPE: any;
 export const ASSET_SOURCING_POLICY_SCHEMA_VERSION: any;
 export const CALL_ME_SENSEI_STRICT_ASSET_POLICY: any;
+export const CATALOG_LICENSE_UNSPECIFIED: any;
 export const DEFAULT_ASSET_SOURCE_ORDER: any;
 export const REVIEWED_CATALOG_LICENSES: any;
 export function assertCatalogLicenseRelease(...args: any[]): any;
 export function createAssetGapRecord(...args: any[]): any;
 export function createAssetSourcingPolicy(...args: any[]): any;
+export function describeCatalogLicense(...args: any[]): any;
 export function evaluateAssetCandidate(...args: any[]): any;
 export function renderAssetGapReport(...args: any[]): any;
 export function resolveCatalogLicense(...args: any[]): any;

package/types/assetlib/loadImported.d.ts

@@ -5,10 +5,12 @@
  * LoadingManager URL modifier rewrites each request by suffix match, which
  * also covers URL-encoded variants.
  */
-export function loadImportedModel({ url, resources, dracoDecoderPath }: {
+export function loadImportedModel({ url, resources, dracoDecoderPath, ktx2TranscoderPath, renderer, }: {
     url: any;
     resources?: {};
     dracoDecoderPath?: string;
+    ktx2TranscoderPath?: string;
+    renderer?: any;
 }): Promise<THREE.Group<THREE.Object3DEventMap>>;
 /**
  * PBR texture-set maps → a tiling MeshStandardMaterial. Prefers the packed

package/types/catalog/officialCatalogLod.d.ts

@@ -1,5 +1,63 @@
-// Source inference fallback: public names retained with permissive signatures.
-export function collectCatalogLodBindings(...args: any[]): any;
-export function createCatalogLodRuntime(...args: any[]): any;
-export function normalizeCatalogLodDistances(...args: any[]): any;
-export function selectCatalogLodLevel(...args: any[]): any;
+import type { Camera, Mesh, Object3D } from 'three';
+
+export interface CatalogLodBinding {
+  readonly level: number;
+  readonly mesh: Mesh;
+  readonly originalVisible: boolean;
+}
+
+export interface CatalogLodSelectionOptions {
+  readonly availableLevels?: readonly number[];
+  readonly distance?: number;
+  readonly distances?: readonly number[];
+  readonly maxLevel?: number;
+  readonly currentLevel?: number | null;
+  readonly hysteresis?: number;
+}
+
+export interface CatalogLodRuntimeOptions {
+  readonly distances?: readonly number[];
+  readonly hysteresis?: number;
+  readonly maxLevel?: number;
+  readonly namePattern?: RegExp;
+}
+
+export interface CatalogLodUpdateOptions {
+  readonly camera?: Camera | null;
+  readonly distance?: number | null;
+}
+
+export interface CatalogLodUpdateResult {
+  readonly changed: boolean;
+  readonly distance: number;
+  readonly level: number;
+}
+
+export interface CatalogLodRuntime {
+  readonly availableLevels: readonly number[];
+  readonly bindings: readonly Readonly<CatalogLodBinding>[];
+  readonly disposed: boolean;
+  readonly level: number | null;
+  readonly thresholds: readonly number[];
+  readonly hysteresis: number;
+  dispose(): void;
+  setLevel(level: number): boolean;
+  update(options?: CatalogLodUpdateOptions): Readonly<CatalogLodUpdateResult> | null;
+}
+
+export function collectCatalogLodBindings(
+  root: Object3D,
+  options?: Readonly<{ namePattern?: RegExp }>,
+): readonly Readonly<CatalogLodBinding>[];
+
+export function normalizeCatalogLodDistances(
+  distances: readonly number[] | null | undefined,
+  levelCount?: number | null,
+): readonly number[];
+
+export function selectCatalogLodLevel(options?: CatalogLodSelectionOptions): number | null;
+
+export function createCatalogLodRuntime(
+  root: Object3D,
+  options?: CatalogLodRuntimeOptions,
+): Readonly<CatalogLodRuntime>;

package/types/character/characterRig.d.ts

@@ -9,6 +9,65 @@ export function resolveCharacterRig(targetMesh: any, { vrm }?: {
 };
 export function targetBoneNameForRole(rig: any, role: any): any;
 export function targetBoneNamesForRole(rig: any, role: any): any[];
+/**
+ * The humanoid contract itself: role -> canonical Mixamo bone name. Exported so
+ * a host can audit a rig against it (which roles resolved, which are missing)
+ * rather than inferring the answer from a bone count.
+ */
+export const MIXAMO_BONE_BY_ROLE: Readonly<{
+    hips: "mixamorigHips";
+    spine: "mixamorigSpine";
+    chest: "mixamorigSpine1";
+    upperChest: "mixamorigSpine2";
+    neck: "mixamorigNeck";
+    head: "mixamorigHead";
+    leftShoulder: "mixamorigLeftShoulder";
+    leftUpperArm: "mixamorigLeftArm";
+    leftLowerArm: "mixamorigLeftForeArm";
+    leftHand: "mixamorigLeftHand";
+    rightShoulder: "mixamorigRightShoulder";
+    rightUpperArm: "mixamorigRightArm";
+    rightLowerArm: "mixamorigRightForeArm";
+    rightHand: "mixamorigRightHand";
+    leftThumbMetacarpal: "mixamorigLeftHandThumb1";
+    leftThumbProximal: "mixamorigLeftHandThumb2";
+    leftThumbDistal: "mixamorigLeftHandThumb3";
+    leftIndexProximal: "mixamorigLeftHandIndex1";
+    leftIndexIntermediate: "mixamorigLeftHandIndex2";
+    leftIndexDistal: "mixamorigLeftHandIndex3";
+    leftMiddleProximal: "mixamorigLeftHandMiddle1";
+    leftMiddleIntermediate: "mixamorigLeftHandMiddle2";
+    leftMiddleDistal: "mixamorigLeftHandMiddle3";
+    leftRingProximal: "mixamorigLeftHandRing1";
+    leftRingIntermediate: "mixamorigLeftHandRing2";
+    leftRingDistal: "mixamorigLeftHandRing3";
+    leftLittleProximal: "mixamorigLeftHandPinky1";
+    leftLittleIntermediate: "mixamorigLeftHandPinky2";
+    leftLittleDistal: "mixamorigLeftHandPinky3";
+    rightThumbMetacarpal: "mixamorigRightHandThumb1";
+    rightThumbProximal: "mixamorigRightHandThumb2";
+    rightThumbDistal: "mixamorigRightHandThumb3";
+    rightIndexProximal: "mixamorigRightHandIndex1";
+    rightIndexIntermediate: "mixamorigRightHandIndex2";
+    rightIndexDistal: "mixamorigRightHandIndex3";
+    rightMiddleProximal: "mixamorigRightHandMiddle1";
+    rightMiddleIntermediate: "mixamorigRightHandMiddle2";
+    rightMiddleDistal: "mixamorigRightHandMiddle3";
+    rightRingProximal: "mixamorigRightHandRing1";
+    rightRingIntermediate: "mixamorigRightHandRing2";
+    rightRingDistal: "mixamorigRightHandRing3";
+    rightLittleProximal: "mixamorigRightHandPinky1";
+    rightLittleIntermediate: "mixamorigRightHandPinky2";
+    rightLittleDistal: "mixamorigRightHandPinky3";
+    leftUpperLeg: "mixamorigLeftUpLeg";
+    leftLowerLeg: "mixamorigLeftLeg";
+    leftFoot: "mixamorigLeftFoot";
+    leftToes: "mixamorigLeftToeBase";
+    rightUpperLeg: "mixamorigRightUpLeg";
+    rightLowerLeg: "mixamorigRightLeg";
+    rightFoot: "mixamorigRightFoot";
+    rightToes: "mixamorigRightToeBase";
+}>;
 export const HUMANOID_ROLES: readonly string[];
 export const MIXAMO_CHAIN_CHILD: Readonly<{
     mixamorigLeftShoulder: "mixamorigLeftArm";

package/types/character/characterRuntime.d.ts

@@ -1,4 +1,5 @@
 // Source inference fallback: public names retained with permissive signatures.
+export const CHARACTER_MATERIAL_MODES: any;
 export const CHARACTER_RUNTIME_STAGE: any;
 export const DEFAULT_CHARACTER_ANIMATION_ROLES: any;
 export function createCharacterRuntime(...args: any[]): any;

package/types/environment/environmentMaterialAdapter.d.ts

@@ -1,4 +1,4 @@
-export function applyEnvironmentShader(root: any, { assetId, bakeVertexAo, debugOutputMode, environmentBox, features, hasSun, materialLook, materialManifest, objectClass, parameters, preset, roleOverrides, scanStylize, scanStylizeParams, scenario, settings, shaderMode, openWindows, vertexAoOptions, }?: {
+export function applyEnvironmentShader(root: any, { assetId, bakeVertexAo, debugOutputMode, environmentBox, features, hasSun, materialLook, materialManifest, objectClass, parameters, preset, roleOverrides, scanStylize, scanStylizeParams, scenario, settings, shaderMode, surfaceLighting, openWindows, vertexAoOptions, }?: {
     assetId?: string;
     bakeVertexAo?: string;
     debugOutputMode?: string;
@@ -16,12 +16,14 @@ export function applyEnvironmentShader(root: any, { assetId, bakeVertexAo, debug
     scenario?: any;
     settings?: {};
     shaderMode?: string;
+    surfaceLighting?: {};
     openWindows?: boolean;
     vertexAoOptions?: {};
 }): Promise<{
     aoOverlayMeshCount: number;
     classification: any[];
     convertedMeshCount: number;
+    surfaceLightingMaterialCount: number;
     manifestWarnings: any[];
     manufacturedAssetId: string;
     manufacturedObjectClass: any;

package/types/environment/toonLabSurfaceLighting.d.ts

@@ -12,8 +12,9 @@ export function resolveToonLabSurfaceInputAdapter(inputAdapter?: "toonlab-stage"
     indirectNormalization: number;
 }>;
 /** CPU oracle for the diffuse-only direct/indirect input decomposition. */
-export function evaluateToonLabSurfaceDiffuseDecomposition({ brdfDiffuse, directInput, indirectInput, inputAdapter, nDotL, }?: {
+export function evaluateToonLabSurfaceDiffuseDecomposition({ brdfDiffuse, directStrength, directInput, indirectInput, inputAdapter, nDotL, }?: {
     brdfDiffuse?: number[];
+    directStrength?: number;
     directInput?: number[];
     indirectInput?: number[];
     inputAdapter?: "toonlab-stage";
@@ -82,6 +83,7 @@ export const TOONLAB_SURFACE_LIGHTING_CONTRACT: Readonly<{
     directDiffuse: "radiance * BRDFData.diffuse (no 1/PI)";
     indirectDiffuse: "bakedGI * BRDFData.diffuse (no 1/PI)";
     directSpecular: "TOONLAB DirectBRDFSpecular optimized GGX";
+    shadowFill: "authored fraction of the sun retained where the package sun-shadow pass reports occlusion (0 = TOONLAB literal)";
     defaultInputAdapter: "toonlab-stage";
     inputNormalization: "direct radiance and cosine-convolved indirect irradiance are normalized independently";
     threeLightInputScaleInverse: number;
@@ -96,18 +98,30 @@ export const TOONLAB_SURFACE_LIGHTING_CONTRACT: Readonly<{
     }>;
 }>;
 export class ToonLabSurfaceLightingModel extends PhysicalLightingModel {
-    constructor({ diffuseAlphaNode, indirectStrength, indirectTint, inputAdapter, perceptualRoughnessNode, specularF0Node, workflow, }?: {
+    constructor({ diffuseAlphaNode, directStrength, indirectStrength, indirectTint, indirectTintNode, indirectReplaceTintNode, indirectTintBlendNode, indirectTintMode, inputAdapter, perceptualRoughnessNode, shadowFill, shadowFillTint, useSharedSunShadow, specularF0Node, workflow, }?: {
         diffuseAlphaNode?: import("three/webgpu").VarNode<"float", import("three/webgpu").ConstNode<"float", number>>;
+        directStrength?: number;
         indirectStrength?: number;
         indirectTint?: number[];
+        indirectTintNode?: any;
+        indirectReplaceTintNode?: any;
+        indirectTintBlendNode?: any;
+        indirectTintMode?: string;
         inputAdapter?: "toonlab-stage";
         perceptualRoughnessNode?: import("three/webgpu").MaterialNode;
+        shadowFill?: number;
+        shadowFillTint?: number[];
+        useSharedSunShadow?: boolean;
         specularF0Node?: import("three/webgpu").MaterialNode;
         workflow?: string;
     });
     diffuseAlphaNode: import("three/webgpu").VarNode<"float", import("three/webgpu").ConstNode<"float", number>>;
+    directStrength: import("three/webgpu").VarNode<"float", import("three/webgpu").ConstNode<"float", number>>;
     indirectStrength: import("three/webgpu").VarNode<"float", import("three/webgpu").ConstNode<"float", number>>;
     indirectTint: import("three/webgpu").VarNode<"vec3", import("three/webgpu").ConstNode<"vec3", import("three").Vector3>>;
+    indirectReplaceTint: import("three/webgpu").VarNode<"vec3", import("three/webgpu").ConstNode<"vec3", import("three").Vector3>>;
+    indirectTintBlend: any;
+    indirectTintMode: string;
     inputAdapter: Readonly<{
         directInput: "ToonLab Light radiance pre-multiplied by PI for stock Three Lambert coexistence";
         directNormalization: number;
@@ -122,8 +136,11 @@ export class ToonLabSurfaceLightingModel extends PhysicalLightingModel {
         indirectNormalization: number;
     }>;
     perceptualRoughnessNode: import("three/webgpu").MaterialNode;
-    specularF0Node: import("three/webgpu").MaterialNode;
+    shadowFill: number;
+    shadowFillTint: number[];
+    useSharedSunShadow: boolean;
     workflow: string;
+    specularF0Node: import("three/webgpu").MaterialNode;
     direct({ lightDirection, lightColor, lightNode, reflectedLight }: {
         lightDirection: any;
         lightColor: any;