@meimu/mutracer 0.1.5 → 0.3.0

package/lib/scene/MaterialState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MaterialState.js","sourceRoot":"","sources":["../../src/scene/MaterialState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAKlE,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAO1E,iFAAiF;AACjF,MAAM,MAAM,GAAG,IAAI,OAAO,EAAyB,CAAC;AACpD,MAAM,CAAC,OAAO,OAAO,aAAa;IAChC,kIAAkI;IAClI,IAAI,KAAK,KAAa,OAAO,MAAM,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,CAAC,CAAC;IACjD,IAAI,KAAK,CAAC,KAAa,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACpE,4EAA4E;IAC5E,YAAY,SAA8B,EAAE;QAC1C,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC;QAClC,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAClC,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3E,CAAC;IAED,OAAO;IACP,yJAAyJ;IACzJ,UAAU,GAAW,eAAe,CAAC,YAAY,CAAC,CAAC;IACnD,sDAAsD;IACtD,SAAS,GAAa,eAAe,CAAC,WAAW,CAAC,CAAC;IACnD,mEAAmE;IACnE,oBAAoB,GAAW,eAAe,CAAC,sBAAsB,CAAC,CAAC;IACvE,8CAA8C;IAC9C,aAAa,GAAW,eAAe,CAAC,eAAe,CAAC,CAAC;IAEzD,WAAW;IACX,mGAAmG;IACnG,cAAc,GAAW,eAAe,CAAC,gBAAgB,CAAC,CAAC;IAC3D,wFAAwF;IACxF,aAAa,GAAa,eAAe,CAAC,eAAe,CAAC,CAAC;IAC3D,mIAAmI;IACnI,iBAAiB,GAAW,eAAe,CAAC,mBAAmB,CAAC,CAAC;IACjE,0CAA0C;IAC1C,WAAW,GAAW,eAAe,CAAC,aAAa,CAAC,CAAC;IACrD;;;OAGG;IACH,kBAAkB,GAAW,eAAe,CAAC,oBAAoB,CAAC,CAAC;IAEnE,eAAe;IACf,6EAA6E;IAC7E,kBAAkB,GAAW,eAAe,CAAC,oBAAoB,CAAC,CAAC;IACnE,0FAA0F;IAC1F,iBAAiB,GAAa,eAAe,CAAC,mBAAmB,CAAC,CAAC;IACnE,4FAA4F;IAC5F,iBAAiB,GAAW,eAAe,CAAC,mBAAmB,CAAC,CAAC;IACjE,+EAA+E;IAC/E,mBAAmB,GAAa,eAAe,CAAC,qBAAqB,CAAC,CAAC;IACvE,wEAAwE;IACxE,6BAA6B,GAAW,eAAe,CAAC,+BAA+B,CAAC,CAAC;IACzF,kIAAkI;IAClI,2BAA2B,GAAW,eAAe,CAAC,6BAA6B,CAAC,CAAC;IACrF,wDAAwD;IACxD,gCAAgC,GAAW,eAAe,CAAC,kCAAkC,CAAC,CAAC;IAE/F,aAAa;IACb,iDAAiD;IACjD,gBAAgB,GAAW,eAAe,CAAC,kBAAkB,CAAC,CAAC;IAC/D,mDAAmD;IACnD,eAAe,GAAa,eAAe,CAAC,iBAAiB,CAAC,CAAC;IAC/D,kDAAkD;IAClD,gBAAgB,GAAW,eAAe,CAAC,kBAAkB,CAAC,CAAC;IAC/D,8EAA8E;IAC9E,qBAAqB,GAAa,eAAe,CAAC,uBAAuB,CAAC,CAAC;IAC3E;;;OAGG;IACH,oBAAoB,GAAW,eAAe,CAAC,sBAAsB,CAAC,CAAC;IAEvE,eAAe;IACf,8CAA8C;IAC9C,UAAU,GAAW,eAAe,CAAC,YAAY,CAAC,CAAC;IACnD,gGAAgG;IAChG,SAAS,GAAa,eAAe,CAAC,WAAW,CAAC,CAAC;IACnD,8EAA8E;IAC9E,aAAa,GAAW,eAAe,CAAC,eAAe,CAAC,CAAC;IAEzD,OAAO;IACP,sCAAsC;IACtC,UAAU,GAAW,eAAe,CAAC,YAAY,CAAC,CAAC;IACnD,8HAA8H;IAC9H,SAAS,GAAa,eAAe,CAAC,WAAW,CAAC,CAAC;IACnD,mCAAmC;IACnC,aAAa,GAAW,eAAe,CAAC,eAAe,CAAC,CAAC;IACzD;;;OAGG;IACH,cAAc,GAAW,eAAe,CAAC,gBAAgB,CAAC,CAAC;IAC3D,+CAA+C;IAC/C,OAAO,GAAW,eAAe,CAAC,SAAS,CAAC,CAAC;IAC7C,mHAAmH;IACnH,aAAa,GAAW,eAAe,CAAC,eAAe,CAAC,CAAC;IAEzD,YAAY;IACZ,gEAAgE;IAChE,cAAc,GAAW,eAAe,CAAC,gBAAgB,CAAC,CAAC;IAC3D,kGAAkG;IAClG,iBAAiB,GAAW,eAAe,CAAC,mBAAmB,CAAC,CAAC;IACjE,+CAA+C;IAC/C,WAAW,GAAW,eAAe,CAAC,aAAa,CAAC,CAAC;IAErD,mIAAmI;IACnI,wBAAwB,GAAW,eAAe,CAAC,0BAA0B,CAAC,CAAC;IAC/E,0DAA0D;IAC1D,kBAAkB,GAAuB,eAAe,CAAC,oBAAoB,CAAC,CAAC;IAE/E,wBAAwB;IACxB,2CAA2C;IAC3C,aAAa,GAAa,eAAe,CAAC,eAAe,CAAC,CAAC;IAC3D,kEAAkE;IAClE,iBAAiB,GAAW,eAAe,CAAC,mBAAmB,CAAC,CAAC;IACjE;;;OAGG;IACH,OAAO,GAAW,eAAe,CAAC,SAAS,CAAC,CAAC;IAC7C;;;OAGG;IACH,UAAU,GAAY,eAAe,CAAC,YAAY,CAAC,CAAC;IACpD,4FAA4F;IAC5F,WAAW,GAAY,eAAe,CAAC,aAAa,CAAC,CAAC;IAEtD,WAAW;IACX,yGAAyG;IACzG,GAAG,CAAgB;IACnB,yGAAyG;IACzG,QAAQ,CAAgB;IACxB;;;;OAIG;IACH,SAAS,GAAsB,eAAe,CAAC,WAAW,CAAC,CAAC;IAC5D,oFAAoF;IACpF,WAAW,GAAW,eAAe,CAAC,aAAa,CAAC,CAAC;IACrD,6EAA6E;IAC7E,WAAW,CAAgB;IAC3B,qDAAqD;IACrD,SAAS,CAAgB;IACzB,sDAAsD;IACtD,WAAW,GAAS,eAAe,CAAC,aAAa,CAAC,CAAC;IACnD,sFAAsF;IACtF,oBAAoB,CAAgB;IACpC,wFAAwF;IACxF,YAAY,CAAgB;IAC5B,uFAAuF;IACvF,YAAY,CAAgB;IAC5B,2FAA2F;IAC3F,eAAe,CAAgB;IAC/B,iHAAiH;IACjH,WAAW,CAAgB;IAE3B,4EAA4E;IAC5E,aAAa,CAAgB;IAC7B,iFAAiF;IACjF,gBAAgB,CAAgB;IAChC,8FAA8F;IAC9F,YAAY,CAAgB;IAC5B,iFAAiF;IACjF,gBAAgB,CAAgB;IAChC,kFAAkF;IAClF,iBAAiB,CAAgB;IACjC,kGAAkG;IAClG,gBAAgB,CAAgB;IAGhC,mLAAmL;IACnL,uBAAuB,GAAuB,SAAS,CAAC;IACxD,8GAA8G;IAC9G,aAAa,CAAgB;IAC7B,wJAAwJ;IACxJ,aAAa,CAAgB;IAC7B,kFAAkF;IAClF,eAAe,GAAS,eAAe,CAAC,iBAAiB,CAAC,CAAC;IAC3D,uHAAuH;IACvH,0BAA0B,GAAW,CAAC,CAAC;IACvC,wFAAwF;IACxF,sBAAsB,GAAW,CAAC,CAAC;IAEnC,uJAAuJ;IACvJ,IAAI,2BAA2B,KAAa,OAAO,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC;IAC7E,IAAI,2BAA2B,CAAC,KAAa,IAAI,IAAI,CAAC,kBAAkB,GAAG,KAAK,CAAC,CAAC,CAAC;IAEnF,oEAAoE;IACpE,IAAI,uBAAuB,KAAa,OAAO,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC;IACrE,IAAI,uBAAuB,CAAC,KAAa,IAAI,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC,CAAC,CAAC;IAE3E,gEAAgE;IAChE,IAAI,2BAA2B,KAAa,OAAO,IAAI,CAAC,oBAAoB,CAAC,CAAC,CAAC;IAC/E,IAAI,2BAA2B,CAAC,KAAa,IAAI,IAAI,CAAC,oBAAoB,GAAG,KAAK,CAAC,CAAC,CAAC;IAErF,8EAA8E;IAC9E,IAAI,eAAe,KAAa,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACtD,IAAI,eAAe,CAAC,KAAa,IAAI,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC;IAE5D,sEAAsE;IACtE,IAAI,kBAAkB,KAAc,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IAC7D,IAAI,kBAAkB,CAAC,KAAc,IAAI,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC;IAEnE,sBAAsB;IACtB;;;OAGG;IACH,aAAa,GAAY,eAAe,CAAC,eAAe,CAAC,CAAC;IAC1D,4FAA4F;IAC5F,KAAK,GAAY,eAAe,CAAC,OAAO,CAAC,CAAC;IAC1C,kGAAkG;IAClG,SAAS,GAAW,eAAe,CAAC,WAAW,CAAC,CAAC;IACjD,iFAAiF;IACjF,aAAa,GAAwC,eAAe,CAAC,eAAe,CAAC,CAAC;IACtF,gFAAgF;IAChF,YAAY,GAAiB,eAAe,CAAC,cAAc,CAAC,CAAC;IAC7D,2DAA2D;IAC3D,iBAAiB,GAAS,eAAe,CAAC,mBAAmB,CAAC,CAAC;IAE/D,eAAe;IACf,0EAA0E;IAC1E,eAAe,CAAgB;IAC/B,yEAAyE;IACzE,wBAAwB,GAAiB,eAAe,CAAC,0BAA0B,CAAC,CAAC;IACrF,kEAAkE;IAClE,6BAA6B,GAAW,eAAe,CAAC,+BAA+B,CAAC,CAAC;IACzF,uEAAuE;IACvE,iBAAiB,GAAW,eAAe,CAAC,mBAAmB,CAAC,CAAC;IACjE,iIAAiI;IACjI,gBAAgB,GAAW,eAAe,CAAC,kBAAkB,CAAC,CAAC;IAC/D,4GAA4G;IAC5G,oBAAoB,GAAW,eAAe,CAAC,sBAAsB,CAAC,CAAC;CAExE;AACD,OAAO,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAI9E,MAAM,UAAU,wBAAwB,CACtC,QAAuB;IAEvB,IAAI,QAAQ,CAAC,SAAS,KAAK,MAAM;QAAE,OAAO,QAAQ,CAAC,SAAS,CAAC;IAC7D,IAAI,QAAQ,CAAC,WAAW,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC;IAC5C,IACE,QAAQ,CAAC,OAAO,GAAG,CAAC;QACpB,QAAQ,CAAC,aAAa,KAAK,OAAO;QAClC,QAAQ,CAAC,QAAQ,EACjB,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC","sourcesContent":["import { allocateAovId, validateAovId } from '../renderer/aov.js';\nimport type { Vec2 } from '../types.js';\nimport type { ColorRGB } from '../types.js';\nimport type TextureState from './TextureState.js';\nimport type { ThinFilmMapChannel } from './thinFilmParameters.js';\nimport { materialDefault, applyMaterialParams } from './openPbrSchema.js';\n\nexport type UVProjection = 'none' | 'triplanar' | 'spherical' | 'cylindrical';\nexport type MaterialAlphaMode = 'auto' | 'opaque' | 'mask' | 'blend';\n\nexport type { MaterialTextureName } from './materialTextureNames.js';\n\n// Shared material state; browser texture types are refined by the public facade.\nconst aovIds = new WeakMap<MaterialState, number>();\nexport default class MaterialState {\n  /** Stable unsigned material ID, excluding 0xFFFFFFFF. Default process-unique monotonic ID; assign before committing the scene. */\n  get aovId(): number { return aovIds.get(this)!; }\n  set aovId(value: number) { aovIds.set(this, validateAovId(value)); }\n  /** Creates a material. Omitted properties use their documented defaults. */\n  constructor(params: MaterialStateParams = {}) {\n    aovIds.set(this, allocateAovId());\n    applyMaterialParams(this, params);\n    if (params.aovId !== undefined) this.aovId = validateAovId(params.aovId);\n  }\n\n  // Base\n  /** Multiplier of diffuse reflection and metallic normal-incidence color; does not scale dielectric specular, transmission or subsurface. Default `1`. */\n  baseWeight: number = materialDefault('baseWeight');\n  /** Diffuse/metal color. Default `[0.8, 0.8, 0.8]`. */\n  baseColor: ColorRGB = materialDefault('baseColor');\n  /** Oren-Nayar style roughness of the diffuse lobe. Default `0`. */\n  baseDiffuseRoughness: number = materialDefault('baseDiffuseRoughness');\n  /** `0` dielectric, `1` metal. Default `0`. */\n  baseMetalness: number = materialDefault('baseMetalness');\n\n  // Specular\n  /** Dielectric specular strength (via IOR) and overall metallic Fresnel multiplier. Default `1`. */\n  specularWeight: number = materialDefault('specularWeight');\n  /** Dielectric specular tint and metallic F82 near-grazing tint. Default `[1, 1, 1]`. */\n  specularColor: ColorRGB = materialDefault('specularColor');\n  /** Microfacet roughness, `0` mirror to `1` rough; retains source perceptual roughness in `gltf` anisotropy mode. Default `0.3`. */\n  specularRoughness: number = materialDefault('specularRoughness');\n  /** Index of refraction. Default `1.5`. */\n  specularIor: number = materialDefault('specularIor');\n  /**\n   * GGX anisotropy strength, 0 to 1 (requires tangents); native OpenPBR or source glTF strength according to specularAnisotropyModel. Default `0`.\n   * @deprecated Use specularRoughnessAnisotropy.\n   */\n  specularAnisotropy: number = materialDefault('specularAnisotropy');\n\n  // Transmission\n  /** `1` makes the dielectric base fully transmissive (glass). Default `0`. */\n  transmissionWeight: number = materialDefault('transmissionWeight');\n  /** Transmission tint, or the medium color at `transmissionDepth`. Default `[1, 1, 1]`. */\n  transmissionColor: ColorRGB = materialDefault('transmissionColor');\n  /** Depth at which `transmissionColor` is reached; `0` tints at the surface. Default `0`. */\n  transmissionDepth: number = materialDefault('transmissionDepth');\n  /** Volume scattering color of the transmissive medium. Default `[0, 0, 0]`. */\n  transmissionScatter: ColorRGB = materialDefault('transmissionScatter');\n  /** Henyey-Greenstein anisotropy of the medium, -1 to 1. Default `0`. */\n  transmissionScatterAnisotropy: number = materialDefault('transmissionScatterAnisotropy');\n  /** Nonnegative dispersion strength; values above `1` are supported. `0` disables wavelength-dependent refraction. Default `0`. */\n  transmissionDispersionScale: number = materialDefault('transmissionDispersionScale');\n  /** Abbe number controlling dispersion. Default `20`. */\n  transmissionDispersionAbbeNumber: number = materialDefault('transmissionDispersionAbbeNumber');\n\n  // Subsurface\n  /** Subsurface scattering weight. Default `0`. */\n  subsurfaceWeight: number = materialDefault('subsurfaceWeight');\n  /** Subsurface color. Default `[0.8, 0.8, 0.8]`. */\n  subsurfaceColor: ColorRGB = materialDefault('subsurfaceColor');\n  /** Mean free path in scene units. Default `1`. */\n  subsurfaceRadius: number = materialDefault('subsurfaceRadius');\n  /** Per-channel multiplier of `subsurfaceRadius`. Default `[1, 0.5, 0.25]`. */\n  subsurfaceRadiusScale: ColorRGB = materialDefault('subsurfaceRadiusScale');\n  /**\n   * Scattering anisotropy, -1 to 1. Default `0`.\n   * @deprecated Use subsurfaceScatterAnisotropy.\n   */\n  subsurfaceAnisotropy: number = materialDefault('subsurfaceAnisotropy');\n\n  // Fuzz (sheen)\n  /** Fuzz (sheen) layer weight. Default `0`. */\n  fuzzWeight: number = materialDefault('fuzzWeight');\n  /** Fuzz reflection color; substrate attenuation uses white fuzz albedo. Default `[1, 1, 1]`. */\n  fuzzColor: ColorRGB = materialDefault('fuzzColor');\n  /** Fuzz roughness; imported from Three.js `sheenRoughness`. Default `0.5`. */\n  fuzzRoughness: number = materialDefault('fuzzRoughness');\n\n  // Coat\n  /** Clear coat weight. Default `0`. */\n  coatWeight: number = materialDefault('coatWeight');\n  /** Squared coat transmittance at normal incidence; colors the base and emission, not coat reflection. Default `[1, 1, 1]`. */\n  coatColor: ColorRGB = materialDefault('coatColor');\n  /** Coat roughness. Default `0`. */\n  coatRoughness: number = materialDefault('coatRoughness');\n  /**\n   * OpenPBR GGX coat anisotropy, 0 to 1; uses the base geometry tangent. Default `0`.\n   * @deprecated Use coatRoughnessAnisotropy.\n   */\n  coatAnisotropy: number = materialDefault('coatAnisotropy');\n  /** Coat index of refraction. Default `1.6`. */\n  coatIor: number = materialDefault('coatIor');\n  /** Internal-reflection darkening: 0 compensates darkening, 1 is physical; absorption remains at 0. Default `1`. */\n  coatDarkening: number = materialDefault('coatDarkening');\n\n  // Thin film\n  /** Thin-film interference weight (iridescence). Default `0`. */\n  thinFilmWeight: number = materialDefault('thinFilmWeight');\n  /** Film thickness in micrometres; maximum endpoint when thinFilmMap is present. Default `0.5`. */\n  thinFilmThickness: number = materialDefault('thinFilmThickness');\n  /** Film index of refraction. Default `1.4`. */\n  thinFilmIor: number = materialDefault('thinFilmIor');\n\n  /** Thickness at a thinFilmMap sample of zero, in micrometres; ignored without a map. May exceed thinFilmThickness. Default `0`. */\n  thinFilmThicknessMinimum: number = materialDefault('thinFilmThicknessMinimum');\n  /** Linear channel sampled by thinFilmMap. Default `r`. */\n  thinFilmMapChannel: ThinFilmMapChannel = materialDefault('thinFilmMapChannel');\n\n  // Emission and geometry\n  /** Emission color. Default `[1, 1, 1]`. */\n  emissionColor: ColorRGB = materialDefault('emissionColor');\n  /** Emitted radiance scale; `0` disables emission. Default `0`. */\n  emissionLuminance: number = materialDefault('emissionLuminance');\n  /**\n   * Coverage, `1` opaque. See `alphaMode`. Default `1`.\n   * @deprecated Use geometryOpacity.\n   */\n  opacity: number = materialDefault('opacity');\n  /**\n   * Treat the surface as an infinitely thin shell (leaves, paper). Default `false`.\n   * @deprecated Use geometryThinWalled.\n   */\n  thinWalled: boolean = materialDefault('thinWalled');\n  /** Disables geometric back-face culling and permits back-face emission. Default `false`. */\n  doubleSided: boolean = materialDefault('doubleSided');\n\n  // Textures\n  /** Base color texture, multiplied with `baseColor` using Texture color encoding. Default `undefined`. */\n  map?: TextureState;\n  /** Standalone opacity texture sampled from its green channel, matching Three.js. Default `undefined`. */\n  alphaMap?: TextureState;\n  /**\n   * Coverage for surface and shadow rays: `opaque` ignores alpha inputs,\n   * `mask` uses binary alpha testing, `blend` retains fractional coverage.\n   * `auto` derives the mode from the alpha inputs. Default `auto`.\n   */\n  alphaMode: MaterialAlphaMode = materialDefault('alphaMode');\n  /** Alpha-test threshold for `mask` mode; equality is fully covered. Default `0`. */\n  alphaCutoff: number = materialDefault('alphaCutoff');\n  /** Emission texture multiplied with `emissionColor`. Default `undefined`. */\n  emissiveMap?: TextureState;\n  /** Tangent-space normal map. Default `undefined`. */\n  normalMap?: TextureState;\n  /** Normal map strength per axis. Default `[1, 1]`. */\n  normalScale: Vec2 = materialDefault('normalScale');\n  /** glTF-compatible B=metalness, G=specular roughness texture. Default `undefined`. */\n  metallicRoughnessMap?: TextureState;\n  /** Standalone roughness texture sampled from its green channel. Default `undefined`. */\n  roughnessMap?: TextureState;\n  /** Standalone metalness texture sampled from its blue channel. Default `undefined`. */\n  metalnessMap?: TextureState;\n  /** Multiplies transmission weight using the texture's red channel. Default `undefined`. */\n  transmissionMap?: TextureState;\n  /** Linear thickness-range texture; R and zero minimum preserve multiplication semantics. Default `undefined`. */\n  thinFilmMap?: TextureState;\n\n  /** Multiplies coatWeight by the linear red channel. Default `undefined`. */\n  coatWeightMap?: TextureState;\n  /** Multiplies coatRoughness by the linear green channel. Default `undefined`. */\n  coatRoughnessMap?: TextureState;\n  /** Multiplies fuzzColor by RGB channels using Texture color encoding. Default `undefined`. */\n  fuzzColorMap?: TextureState;\n  /** Multiplies fuzzRoughness by the linear alpha channel. Default `undefined`. */\n  fuzzRoughnessMap?: TextureState;\n  /** Multiplies specularWeight by the linear alpha channel. Default `undefined`. */\n  specularWeightMap?: TextureState;\n  /** Multiplies specularColor by RGB channels using Texture color encoding. Default `undefined`. */\n  specularColorMap?: TextureState;\n\n\n  /** Source convention for base specular anisotropy. `gltf` converts textured roughness and strength before coat roughening; `openpbr` uses native parameters. Default `openpbr`. */\n  specularAnisotropyModel: 'openpbr' | 'gltf' = 'openpbr';\n  /** Linear RG tangent direction and B strength multiplier for the base specular layer. Default `undefined`. */\n  anisotropyMap?: TextureState;\n  /** Independent tangent-space coat normal in linear RGB. Without a map, coat uses the surface normal before base normal mapping. Default `undefined`. */\n  coatNormalMap?: TextureState;\n  /** XY strength of coatNormalMap; independent of normalScale. Default `[1, 1]`. */\n  coatNormalScale: Vec2 = materialDefault('coatNormalScale');\n  /** Base direction rotation in radians, counter-clockwise in tangent/bitangent space after RG decoding. Default `0`. */\n  specularAnisotropyRotation: number = 0;\n  /** Coat direction rotation in radians relative to the geometry tangent. Default `0`. */\n  coatAnisotropyRotation: number = 0;\n\n  /** GGX roughness anisotropy in [0, 1]; native OpenPBR or source glTF strength according to specularAnisotropyModel. Requires tangents. Default `0`. */\n  get specularRoughnessAnisotropy(): number { return this.specularAnisotropy; }\n  set specularRoughnessAnisotropy(value: number) { this.specularAnisotropy = value; }\n\n  /** OpenPBR coat GGX roughness anisotropy in [0, 1]. Default `0`. */\n  get coatRoughnessAnisotropy(): number { return this.coatAnisotropy; }\n  set coatRoughnessAnisotropy(value: number) { this.coatAnisotropy = value; }\n\n  /** Subsurface scattering anisotropy in [-1, 1]. Default `0`. */\n  get subsurfaceScatterAnisotropy(): number { return this.subsurfaceAnisotropy; }\n  set subsurfaceScatterAnisotropy(value: number) { this.subsurfaceAnisotropy = value; }\n\n  /** Surface coverage; alphaMode controls testing and blending. Default `1`. */\n  get geometryOpacity(): number { return this.opacity; }\n  set geometryOpacity(value: number) { this.opacity = value; }\n\n  /** Treat the surface as an infinitely thin shell. Default `false`. */\n  get geometryThinWalled(): boolean { return this.thinWalled; }\n  set geometryThinWalled(value: boolean) { this.thinWalled = value; }\n\n  // Renderer extensions\n  /**\n   * Invisible ground that only receives shadows, composited over the\n   * background. Default `false`.\n   */\n  shadowCatcher: boolean = materialDefault('shadowCatcher');\n  /** Displays emission without scattering or illuminating other surfaces. Default `false`. */\n  unlit: boolean = materialDefault('unlit');\n  /** Radius of rounded-edge shading (shader bevel) in scene units. `0` disables it. Default `0`. */\n  bevelSize: number = materialDefault('bevelSize');\n  /** How map alpha is used: ignored, opacity or transmission. Default `opaque`. */\n  mapAlphaUsage: 'opaque' | 'alpha' | 'transmission' = materialDefault('mapAlphaUsage');\n  /** Procedural UV projection for textures without (good) UVs. Default `none`. */\n  uvProjection: UVProjection = materialDefault('uvProjection');\n  /** UV scale used with `uvProjection`. Default `[1, 1]`. */\n  uvProjectionScale: Vec2 = materialDefault('uvProjectionScale');\n\n  // Displacement\n  /** Height texture (red channel) for displacement. Default `undefined`. */\n  displacementMap?: TextureState;\n  /** Procedural UV projection for the displacement map. Default `none`. */\n  displacementUvProjection: UVProjection = materialDefault('displacementUvProjection');\n  /** UV scale used with `displacementUvProjection`. Default `1`. */\n  displacementUvProjectionScale: number = materialDefault('displacementUvProjectionScale');\n  /** Height multiplier in mesh-local coordinate units. Default `0.1`. */\n  displacementScale: number = materialDefault('displacementScale');\n  /** Offset added after scaling the height map, along the normal in mesh-local units; requires a displacement map. Default `0`. */\n  displacementBias: number = materialDefault('displacementBias');\n  /** Ray-marching step in mesh-local units; 0 automatically uses abs(displacementScale) / 32. Default `0`. */\n  displacementStepSize: number = materialDefault('displacementStepSize');\n\n}\nexport { materialAlphaModeConstants } from '../renderer/materialConstants.js';\n\nexport type ResolvedMaterialAlphaMode = Exclude<MaterialAlphaMode, 'auto'>;\n\nexport function resolveMaterialAlphaMode(\n  material: MaterialState\n): ResolvedMaterialAlphaMode {\n  if (material.alphaMode !== 'auto') return material.alphaMode;\n  if (material.alphaCutoff > 0) return 'mask';\n  if (\n    material.opacity < 1 ||\n    material.mapAlphaUsage === \"alpha\" ||\n    material.alphaMap\n  ) {\n    return 'blend';\n  }\n  return 'opaque';\n}\n\nexport { materialKeys, materialTextureKeys, materialGeometryKeys, materialParamKeys, getMaterialHashKey, resetMaterialTextureId } from './openPbrSchema.js';\n\n/** Optional material properties; defaults are documented on MaterialState. */\nexport type MaterialStateParams = Partial<MaterialState>;\n"]}

package/lib/scene/Mesh.d.ts

@@ -1,14 +1,12 @@
-import Geometry from './Geometry.js';
-import SceneNode from './SceneNode.js';
-import OpenPBRMaterial from './OpenPBRMaterial.js';
+import MeshState from './MeshState.js';
+import type Geometry from './Geometry.js';
+import type OpenPBRMaterial from './OpenPBRMaterial.js';
 /**
  * A geometry rendered with one or more materials. With several materials,
  * `geometry.materialIndex` selects the material of each triangle.
  */
-export default class Mesh extends SceneNode {
+export default class Mesh extends MeshState {
     /** Materials supplied to the constructor, indexed by per-vertex materialIndex. */
     materials: OpenPBRMaterial[];
-    /** Indexed triangle geometry supplied to the constructor; no default. */
-    geometry: Geometry;
     constructor(geometry: Geometry, material: OpenPBRMaterial[] | OpenPBRMaterial);
 }

package/lib/scene/Mesh.js

@@ -1,17 +1,9 @@
-import SceneNode from './SceneNode.js';
+import MeshState from './MeshState.js';
 /**
  * A geometry rendered with one or more materials. With several materials,
  * `geometry.materialIndex` selects the material of each triangle.
  */
-export default class Mesh extends SceneNode {
-    /** Materials supplied to the constructor, indexed by per-vertex materialIndex. */
-    materials;
-    /** Indexed triangle geometry supplied to the constructor; no default. */
-    geometry;
-    constructor(geometry, material) {
-        super();
-        this.geometry = geometry;
-        this.materials = Array.isArray(material) ? material : [material];
-    }
+export default class Mesh extends MeshState {
+    constructor(geometry, material) { super(geometry, material); }
 }
 //# sourceMappingURL=Mesh.js.map

package/lib/scene/Mesh.js.map

@@ -1 +1 @@
-{"version":3,"file":"Mesh.js","sourceRoot":"","sources":["../../src/scene/Mesh.ts"],"names":[],"mappings":"AACA,OAAO,SAAS,MAAM,gBAAgB,CAAC;AAGvC;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,IAAK,SAAQ,SAAS;IACzC,kFAAkF;IAClF,SAAS,CAAoB;IAC7B,yEAAyE;IACzE,QAAQ,CAAW;IAEnB,YACE,QAAkB,EAClB,QAA6C;QAE7C,KAAK,EAAE,CAAC;QAER,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACnE,CAAC;CAEF","sourcesContent":["import Geometry from './Geometry.js';\nimport SceneNode from './SceneNode.js';\nimport OpenPBRMaterial from './OpenPBRMaterial.js';\n\n/**\n * A geometry rendered with one or more materials. With several materials,\n * `geometry.materialIndex` selects the material of each triangle.\n */\nexport default class Mesh extends SceneNode {\n  /** Materials supplied to the constructor, indexed by per-vertex materialIndex. */\n  materials: OpenPBRMaterial[];\n  /** Indexed triangle geometry supplied to the constructor; no default. */\n  geometry: Geometry;\n\n  constructor(\n    geometry: Geometry,\n    material: OpenPBRMaterial[] | OpenPBRMaterial\n  ) {\n    super();\n\n    this.geometry = geometry;\n    this.materials = Array.isArray(material) ? material : [material];\n  }\n\n}\n"]}
+{"version":3,"file":"Mesh.js","sourceRoot":"","sources":["../../src/scene/Mesh.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,gBAAgB,CAAC;AAIvC;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,IAAK,SAAQ,SAAS;IAGzC,YAAY,QAAkB,EAAE,QAA6C,IAAI,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;CAC9G","sourcesContent":["import MeshState from './MeshState.js';\nimport type Geometry from './Geometry.js';\nimport type OpenPBRMaterial from './OpenPBRMaterial.js';\n\n/**\n * A geometry rendered with one or more materials. With several materials,\n * `geometry.materialIndex` selects the material of each triangle.\n */\nexport default class Mesh extends MeshState {\n  /** Materials supplied to the constructor, indexed by per-vertex materialIndex. */\n  declare materials: OpenPBRMaterial[];\n  constructor(geometry: Geometry, material: OpenPBRMaterial[] | OpenPBRMaterial) { super(geometry, material); }\n}\n"]}

package/lib/scene/MeshState.d.ts

@@ -0,0 +1,20 @@
+import Geometry from './Geometry.js';
+import SceneNode from './SceneNode.js';
+import type MaterialState from './MaterialState.js';
+export interface InstanceData {
+    count: number;
+    transforms: Float32Array;
+    colors: Float32Array | undefined;
+    transformsVersion: number;
+    colorsVersion: number;
+}
+export default class MeshState extends SceneNode {
+    /** Stable unsigned object ID, excluding 0xFFFFFFFF. Default process-unique monotonic ID; assign before committing the scene. */
+    get aovId(): number;
+    set aovId(value: number);
+    /** Materials supplied to the constructor, indexed by per-vertex materialIndex. */
+    materials: MaterialState[];
+    /** Indexed triangle geometry supplied to the constructor; no default. */
+    geometry: Geometry;
+    constructor(geometry: Geometry, material: MaterialState[] | MaterialState);
+}

package/lib/scene/MeshState.js

@@ -0,0 +1,35 @@
+import { allocateAovId, validateAovId } from '../renderer/aov.js';
+import SceneNode from './SceneNode.js';
+/**
+ * A geometry rendered with one or more materials. With several materials,
+ * `geometry.materialIndex` selects the material of each triangle.
+ */
+const aovIds = new WeakMap();
+export default class MeshState extends SceneNode {
+    /** Stable unsigned object ID, excluding 0xFFFFFFFF. Default process-unique monotonic ID; assign before committing the scene. */
+    get aovId() { return aovIds.get(this); }
+    set aovId(value) { aovIds.set(this, validateAovId(value)); }
+    /** Materials supplied to the constructor, indexed by per-vertex materialIndex. */
+    materials;
+    /** Indexed triangle geometry supplied to the constructor; no default. */
+    geometry;
+    /** @internal */
+    _instances;
+    /** @internal */
+    get instanceData() {
+        const state = this._instances;
+        return state ? { count: state.count, transforms: state.transforms, colors: state.colors,
+            transformsVersion: state.transformsVersion, colorsVersion: state.colorsVersion } : undefined;
+    }
+    /** @internal Mutable instance state for in-place native updates. */
+    get instanceState() { return this._instances; }
+    /** @internal */
+    setInstanceState(state) { this._instances = state; }
+    constructor(geometry, material) {
+        super();
+        aovIds.set(this, allocateAovId());
+        this.geometry = geometry;
+        this.materials = Array.isArray(material) ? material : [material];
+    }
+}
+//# sourceMappingURL=MeshState.js.map

package/lib/scene/MeshState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MeshState.js","sourceRoot":"","sources":["../../src/scene/MeshState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAElE,OAAO,SAAS,MAAM,gBAAgB,CAAC;AAKvC;;;GAGG;AACH,MAAM,MAAM,GAAG,IAAI,OAAO,EAAqB,CAAC;AAChD,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,SAAS;IAC9C,gIAAgI;IAChI,IAAI,KAAK,KAAa,OAAO,MAAM,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,CAAC,CAAC;IACjD,IAAI,KAAK,CAAC,KAAa,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACpE,kFAAkF;IAClF,SAAS,CAAkB;IAC3B,yEAAyE;IACzE,QAAQ,CAAW;IAEnB,gBAAgB;IACR,UAAU,CAAiB;IACnC,gBAAgB;IAChB,IAAI,YAAY;QACd,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC;QAC9B,OAAO,KAAK,CAAC,CAAC,CAAC,EAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM;YACpF,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAChG,CAAC;IACD,oEAAoE;IACpE,IAAI,aAAa,KAAgC,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IAC1E,gBAAgB;IAChB,gBAAgB,CAAC,KAAgC,IAAI,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC;IAE/E,YACE,QAAkB,EAClB,QAAyC;QAEzC,KAAK,EAAE,CAAC;QACR,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC;QAElC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACnE,CAAC;CAEF","sourcesContent":["import { allocateAovId, validateAovId } from '../renderer/aov.js';\nimport Geometry from './Geometry.js';\nimport SceneNode from './SceneNode.js';\nimport type MaterialState from './MaterialState.js';\nimport type InstanceState from './InstanceState.js';\nexport interface InstanceData { count: number; transforms: Float32Array; colors: Float32Array | undefined; transformsVersion: number; colorsVersion: number; }\n\n/**\n * A geometry rendered with one or more materials. With several materials,\n * `geometry.materialIndex` selects the material of each triangle.\n */\nconst aovIds = new WeakMap<MeshState, number>();\nexport default class MeshState extends SceneNode {\n  /** Stable unsigned object ID, excluding 0xFFFFFFFF. Default process-unique monotonic ID; assign before committing the scene. */\n  get aovId(): number { return aovIds.get(this)!; }\n  set aovId(value: number) { aovIds.set(this, validateAovId(value)); }\n  /** Materials supplied to the constructor, indexed by per-vertex materialIndex. */\n  materials: MaterialState[];\n  /** Indexed triangle geometry supplied to the constructor; no default. */\n  geometry: Geometry;\n\n  /** @internal */\n  private _instances?: InstanceState;\n  /** @internal */\n  get instanceData(): InstanceData | undefined {\n    const state = this._instances;\n    return state ? {count: state.count, transforms: state.transforms, colors: state.colors,\n      transformsVersion: state.transformsVersion, colorsVersion: state.colorsVersion} : undefined;\n  }\n  /** @internal Mutable instance state for in-place native updates. */\n  get instanceState(): InstanceState | undefined { return this._instances; }\n  /** @internal */\n  setInstanceState(state: InstanceState | undefined) { this._instances = state; }\n\n  constructor(\n    geometry: Geometry,\n    material: MaterialState[] | MaterialState\n  ) {\n    super();\n    aovIds.set(this, allocateAovId());\n\n    this.geometry = geometry;\n    this.materials = Array.isArray(material) ? material : [material];\n  }\n\n}\n"]}

package/lib/scene/OpenPBRMaterial.d.ts

@@ -1,10 +1,9 @@
-import type { Vec2 } from '../types.js';
-import { ColorRGB } from '../types.js';
+import MaterialState from './MaterialState.js';
 import type Texture from './Texture.js';
-import type { ThinFilmMapChannel } from './thinFilmParameters.js';
-export type UVProjection = 'none' | 'triplanar' | 'spherical' | 'cylindrical';
-export type MaterialAlphaMode = 'auto' | 'opaque' | 'mask' | 'blend';
+export type { UVProjection, MaterialAlphaMode, ResolvedMaterialAlphaMode } from './MaterialState.js';
 export type { MaterialTextureName } from './materialTextureNames.js';
+export { materialAlphaModeConstants, resolveMaterialAlphaMode } from './MaterialState.js';
+export { materialKeys, materialTextureKeys, materialGeometryKeys, materialParamKeys, getMaterialHashKey, resetMaterialTextureId } from './openPbrSchema.js';
 /**
  * OpenPBR 1.1 surface material.
  *
@@ -21,122 +20,17 @@ export type { MaterialTextureName } from './materialTextureNames.js';
  *
  * Edit parameters in place; the next `engine.update()` detects the changes.
  */
-export default class OpenPBRMaterial {
+export default class OpenPBRMaterial extends MaterialState {
     /** Creates a material. Omitted properties use their documented defaults. */
     constructor(params?: OpenPBRMaterialParams);
-    /** Multiplier of diffuse reflection and metallic normal-incidence color; does not scale dielectric specular, transmission or subsurface. Default `1`. */
-    baseWeight: number;
-    /** Diffuse/metal color. Default `[0.8, 0.8, 0.8]`. */
-    baseColor: ColorRGB;
-    /** Oren-Nayar style roughness of the diffuse lobe. Default `0`. */
-    baseDiffuseRoughness: number;
-    /** `0` dielectric, `1` metal. Default `0`. */
-    baseMetalness: number;
-    /** Dielectric specular strength (via IOR) and overall metallic Fresnel multiplier. Default `1`. */
-    specularWeight: number;
-    /** Dielectric specular tint and metallic F82 near-grazing tint. Default `[1, 1, 1]`. */
-    specularColor: ColorRGB;
-    /** Microfacet roughness, `0` mirror to `1` rough; retains source perceptual roughness in `gltf` anisotropy mode. Default `0.3`. */
-    specularRoughness: number;
-    /** Index of refraction. Default `1.5`. */
-    specularIor: number;
-    /**
-     * GGX anisotropy strength, 0 to 1 (requires tangents); native OpenPBR or source glTF strength according to specularAnisotropyModel. Default `0`.
-     * @deprecated Use specularRoughnessAnisotropy.
-     */
-    specularAnisotropy: number;
-    /** `1` makes the dielectric base fully transmissive (glass). Default `0`. */
-    transmissionWeight: number;
-    /** Transmission tint, or the medium color at `transmissionDepth`. Default `[1, 1, 1]`. */
-    transmissionColor: ColorRGB;
-    /** Depth at which `transmissionColor` is reached; `0` tints at the surface. Default `0`. */
-    transmissionDepth: number;
-    /** Volume scattering color of the transmissive medium. Default `[0, 0, 0]`. */
-    transmissionScatter: ColorRGB;
-    /** Henyey-Greenstein anisotropy of the medium, -1 to 1. Default `0`. */
-    transmissionScatterAnisotropy: number;
-    /** Dispersion strength; `> 0` enables spectral rendering. Default `0`. */
-    transmissionDispersionScale: number;
-    /** Abbe number controlling dispersion. Default `20`. */
-    transmissionDispersionAbbeNumber: number;
-    /** Subsurface scattering weight. Default `0`. */
-    subsurfaceWeight: number;
-    /** Subsurface color. Default `[0.8, 0.8, 0.8]`. */
-    subsurfaceColor: ColorRGB;
-    /** Mean free path in scene units. Default `1`. */
-    subsurfaceRadius: number;
-    /** Per-channel multiplier of `subsurfaceRadius`. Default `[1, 0.5, 0.25]`. */
-    subsurfaceRadiusScale: ColorRGB;
-    /**
-     * Scattering anisotropy, -1 to 1. Default `0`.
-     * @deprecated Use subsurfaceScatterAnisotropy.
-     */
-    subsurfaceAnisotropy: number;
-    /** Fuzz (sheen) layer weight. Default `0`. */
-    fuzzWeight: number;
-    /** Fuzz reflection color; substrate attenuation uses white fuzz albedo. Default `[1, 1, 1]`. */
-    fuzzColor: ColorRGB;
-    /** Fuzz roughness; imported from Three.js `sheenRoughness`. Default `0.5`. */
-    fuzzRoughness: number;
-    /** Clear coat weight. Default `0`. */
-    coatWeight: number;
-    /** Squared coat transmittance at normal incidence; colors the base and emission, not coat reflection. Default `[1, 1, 1]`. */
-    coatColor: ColorRGB;
-    /** Coat roughness. Default `0`. */
-    coatRoughness: number;
-    /**
-     * OpenPBR GGX coat anisotropy, 0 to 1; uses the base geometry tangent. Default `0`.
-     * @deprecated Use coatRoughnessAnisotropy.
-     */
-    coatAnisotropy: number;
-    /** Coat index of refraction. Default `1.6`. */
-    coatIor: number;
-    /** Internal-reflection darkening: 0 compensates darkening, 1 is physical; absorption remains at 0. Default `1`. */
-    coatDarkening: number;
-    /** Thin-film interference weight (iridescence). Default `0`. */
-    thinFilmWeight: number;
-    /** Film thickness in micrometres; maximum endpoint when thinFilmMap is present. Default `0.5`. */
-    thinFilmThickness: number;
-    /** Film index of refraction. Default `1.4`. */
-    thinFilmIor: number;
-    /** Thickness at a thinFilmMap sample of zero, in micrometres; ignored without a map. May exceed thinFilmThickness. Default `0`. */
-    thinFilmThicknessMinimum: number;
-    /** Linear channel sampled by thinFilmMap. Default `r`. */
-    thinFilmMapChannel: ThinFilmMapChannel;
-    /** Emission color. Default `[1, 1, 1]`. */
-    emissionColor: ColorRGB;
-    /** Emitted radiance scale; `0` disables emission. Default `0`. */
-    emissionLuminance: number;
-    /**
-     * Coverage, `1` opaque. See `alphaMode`. Default `1`.
-     * @deprecated Use geometryOpacity.
-     */
-    opacity: number;
-    /**
-     * Treat the surface as an infinitely thin shell (leaves, paper). Default `false`.
-     * @deprecated Use geometryThinWalled.
-     */
-    thinWalled: boolean;
-    /** Disables geometric back-face culling for this material. Default `false`. */
-    doubleSided: boolean;
     /** Base color texture, multiplied with `baseColor` using Texture color encoding. Default `undefined`. */
     map?: Texture;
     /** Standalone opacity texture sampled from its green channel, matching Three.js. Default `undefined`. */
     alphaMap?: Texture;
-    /**
-     * Coverage for surface and shadow rays: `opaque` ignores alpha inputs,
-     * `mask` uses binary alpha testing, `blend` retains fractional coverage.
-     * `auto` derives the mode from the alpha inputs. Default `auto`.
-     */
-    alphaMode: MaterialAlphaMode;
-    /** Alpha-test threshold for `mask` mode; equality is fully covered. Default `0`. */
-    alphaCutoff: number;
     /** Emission texture multiplied with `emissionColor`. Default `undefined`. */
     emissiveMap?: Texture;
-    /** Tangent-space normal map. */
+    /** Tangent-space normal map. Default `undefined`. */
     normalMap?: Texture;
-    /** Normal map strength per axis. Default `[1, 1]`. */
-    normalScale: Vec2;
     /** glTF-compatible B=metalness, G=specular roughness texture. Default `undefined`. */
     metallicRoughnessMap?: Texture;
     /** Standalone roughness texture sampled from its green channel. Default `undefined`. */
@@ -159,68 +53,12 @@ export default class OpenPBRMaterial {
     specularWeightMap?: Texture;
     /** Multiplies specularColor by RGB channels using Texture color encoding. Default `undefined`. */
     specularColorMap?: Texture;
-    /** Source convention for base specular anisotropy. `gltf` converts textured roughness and strength before coat roughening; `openpbr` uses native parameters. Default `openpbr`. */
-    specularAnisotropyModel: 'openpbr' | 'gltf';
     /** Linear RG tangent direction and B strength multiplier for the base specular layer. Default `undefined`. */
     anisotropyMap?: Texture;
     /** Independent tangent-space coat normal in linear RGB. Without a map, coat uses the surface normal before base normal mapping. Default `undefined`. */
     coatNormalMap?: Texture;
-    /** XY strength of coatNormalMap; independent of normalScale. Default `[1, 1]`. */
-    coatNormalScale: Vec2;
-    /** Base direction rotation in radians, counter-clockwise in tangent/bitangent space after RG decoding. Default `0`. */
-    specularAnisotropyRotation: number;
-    /** Coat direction rotation in radians relative to the geometry tangent. Default `0`. */
-    coatAnisotropyRotation: number;
-    /** GGX roughness anisotropy in [0, 1]; native OpenPBR or source glTF strength according to specularAnisotropyModel. Requires tangents. Default `0`. */
-    get specularRoughnessAnisotropy(): number;
-    set specularRoughnessAnisotropy(value: number);
-    /** OpenPBR coat GGX roughness anisotropy in [0, 1]. Default `0`. */
-    get coatRoughnessAnisotropy(): number;
-    set coatRoughnessAnisotropy(value: number);
-    /** Subsurface scattering anisotropy in [-1, 1]. Default `0`. */
-    get subsurfaceScatterAnisotropy(): number;
-    set subsurfaceScatterAnisotropy(value: number);
-    /** Surface coverage; alphaMode controls testing and blending. Default `1`. */
-    get geometryOpacity(): number;
-    set geometryOpacity(value: number);
-    /** Treat the surface as an infinitely thin shell. Default `false`. */
-    get geometryThinWalled(): boolean;
-    set geometryThinWalled(value: boolean);
-    /**
-     * Invisible ground that only receives shadows, composited over the
-     * background. Default `false`.
-     */
-    shadowCatcher: boolean;
-    /** Displays emission without scattering or illuminating other surfaces. Default `false`. */
-    unlit: boolean;
-    /** Radius of rounded-edge shading (shader bevel) in scene units. `0` disables it. Default `0`. */
-    bevelSize: number;
-    /** How map alpha is used: ignored, opacity or transmission. Default `opaque`. */
-    mapAlphaUsage: 'opaque' | 'alpha' | 'transmission';
-    /** Procedural UV projection for textures without (good) UVs. Default `none`. */
-    uvProjection: UVProjection;
-    /** UV scale used with `uvProjection`. Default `[1, 1]`. */
-    uvProjectionScale: Vec2;
     /** Height texture (red channel) for displacement. Default `undefined`. */
     displacementMap?: Texture;
-    /** Procedural UV projection for the displacement map. Default `none`. */
-    displacementUvProjection: UVProjection;
-    /** UV scale used with `displacementUvProjection`. Default `1`. */
-    displacementUvProjectionScale: number;
-    /** Height multiplier in mesh-local units; 0 removes height variation. Default `0.1`. */
-    displacementScale: number;
-    /** Offset added after scaling the height map, along the normal in mesh-local units; requires a displacement map. Default `0`. */
-    displacementBias: number;
-    /** Ray-marching step in mesh-local units; 0 automatically uses abs(displacementScale) / 32. Default `0`. */
-    displacementStepSize: number;
 }
-export declare const materialAlphaModeConstants: {
-    readonly opaque: 0;
-    readonly mask: 1;
-    readonly blend: 2;
-};
-export type ResolvedMaterialAlphaMode = Exclude<MaterialAlphaMode, 'auto'>;
-export declare function resolveMaterialAlphaMode(material: OpenPBRMaterial): ResolvedMaterialAlphaMode;
-export { materialKeys, materialTextureKeys, materialGeometryKeys, materialParamKeys, getMaterialHashKey, resetMaterialTextureId } from './openPbrSchema.js';
 /** Optional material properties; defaults are documented on OpenPBRMaterial. */
 export type OpenPBRMaterialParams = Partial<OpenPBRMaterial>;

package/lib/scene/OpenPBRMaterial.js

@@ -1,4 +1,6 @@
-import { materialDefault, applyMaterialParams } from './openPbrSchema.js';
+import MaterialState from './MaterialState.js';
+export { materialAlphaModeConstants, resolveMaterialAlphaMode } from './MaterialState.js';
+export { materialKeys, materialTextureKeys, materialGeometryKeys, materialParamKeys, getMaterialHashKey, resetMaterialTextureId } from './openPbrSchema.js';
 /**
  * OpenPBR 1.1 surface material.
  *
@@ -15,228 +17,8 @@ import { materialDefault, applyMaterialParams } from './openPbrSchema.js';
  *
  * Edit parameters in place; the next `engine.update()` detects the changes.
  */
-export default class OpenPBRMaterial {
+export default class OpenPBRMaterial extends MaterialState {
     /** Creates a material. Omitted properties use their documented defaults. */
-    constructor(params = {}) {
-        applyMaterialParams(this, params);
-    }
-    // Base
-    /** Multiplier of diffuse reflection and metallic normal-incidence color; does not scale dielectric specular, transmission or subsurface. Default `1`. */
-    baseWeight = materialDefault('baseWeight');
-    /** Diffuse/metal color. Default `[0.8, 0.8, 0.8]`. */
-    baseColor = materialDefault('baseColor');
-    /** Oren-Nayar style roughness of the diffuse lobe. Default `0`. */
-    baseDiffuseRoughness = materialDefault('baseDiffuseRoughness');
-    /** `0` dielectric, `1` metal. Default `0`. */
-    baseMetalness = materialDefault('baseMetalness');
-    // Specular
-    /** Dielectric specular strength (via IOR) and overall metallic Fresnel multiplier. Default `1`. */
-    specularWeight = materialDefault('specularWeight');
-    /** Dielectric specular tint and metallic F82 near-grazing tint. Default `[1, 1, 1]`. */
-    specularColor = materialDefault('specularColor');
-    /** Microfacet roughness, `0` mirror to `1` rough; retains source perceptual roughness in `gltf` anisotropy mode. Default `0.3`. */
-    specularRoughness = materialDefault('specularRoughness');
-    /** Index of refraction. Default `1.5`. */
-    specularIor = materialDefault('specularIor');
-    /**
-     * GGX anisotropy strength, 0 to 1 (requires tangents); native OpenPBR or source glTF strength according to specularAnisotropyModel. Default `0`.
-     * @deprecated Use specularRoughnessAnisotropy.
-     */
-    specularAnisotropy = materialDefault('specularAnisotropy');
-    // Transmission
-    /** `1` makes the dielectric base fully transmissive (glass). Default `0`. */
-    transmissionWeight = materialDefault('transmissionWeight');
-    /** Transmission tint, or the medium color at `transmissionDepth`. Default `[1, 1, 1]`. */
-    transmissionColor = materialDefault('transmissionColor');
-    /** Depth at which `transmissionColor` is reached; `0` tints at the surface. Default `0`. */
-    transmissionDepth = materialDefault('transmissionDepth');
-    /** Volume scattering color of the transmissive medium. Default `[0, 0, 0]`. */
-    transmissionScatter = materialDefault('transmissionScatter');
-    /** Henyey-Greenstein anisotropy of the medium, -1 to 1. Default `0`. */
-    transmissionScatterAnisotropy = materialDefault('transmissionScatterAnisotropy');
-    /** Dispersion strength; `> 0` enables spectral rendering. Default `0`. */
-    transmissionDispersionScale = materialDefault('transmissionDispersionScale');
-    /** Abbe number controlling dispersion. Default `20`. */
-    transmissionDispersionAbbeNumber = materialDefault('transmissionDispersionAbbeNumber');
-    // Subsurface
-    /** Subsurface scattering weight. Default `0`. */
-    subsurfaceWeight = materialDefault('subsurfaceWeight');
-    /** Subsurface color. Default `[0.8, 0.8, 0.8]`. */
-    subsurfaceColor = materialDefault('subsurfaceColor');
-    /** Mean free path in scene units. Default `1`. */
-    subsurfaceRadius = materialDefault('subsurfaceRadius');
-    /** Per-channel multiplier of `subsurfaceRadius`. Default `[1, 0.5, 0.25]`. */
-    subsurfaceRadiusScale = materialDefault('subsurfaceRadiusScale');
-    /**
-     * Scattering anisotropy, -1 to 1. Default `0`.
-     * @deprecated Use subsurfaceScatterAnisotropy.
-     */
-    subsurfaceAnisotropy = materialDefault('subsurfaceAnisotropy');
-    // Fuzz (sheen)
-    /** Fuzz (sheen) layer weight. Default `0`. */
-    fuzzWeight = materialDefault('fuzzWeight');
-    /** Fuzz reflection color; substrate attenuation uses white fuzz albedo. Default `[1, 1, 1]`. */
-    fuzzColor = materialDefault('fuzzColor');
-    /** Fuzz roughness; imported from Three.js `sheenRoughness`. Default `0.5`. */
-    fuzzRoughness = materialDefault('fuzzRoughness');
-    // Coat
-    /** Clear coat weight. Default `0`. */
-    coatWeight = materialDefault('coatWeight');
-    /** Squared coat transmittance at normal incidence; colors the base and emission, not coat reflection. Default `[1, 1, 1]`. */
-    coatColor = materialDefault('coatColor');
-    /** Coat roughness. Default `0`. */
-    coatRoughness = materialDefault('coatRoughness');
-    /**
-     * OpenPBR GGX coat anisotropy, 0 to 1; uses the base geometry tangent. Default `0`.
-     * @deprecated Use coatRoughnessAnisotropy.
-     */
-    coatAnisotropy = materialDefault('coatAnisotropy');
-    /** Coat index of refraction. Default `1.6`. */
-    coatIor = materialDefault('coatIor');
-    /** Internal-reflection darkening: 0 compensates darkening, 1 is physical; absorption remains at 0. Default `1`. */
-    coatDarkening = materialDefault('coatDarkening');
-    // Thin film
-    /** Thin-film interference weight (iridescence). Default `0`. */
-    thinFilmWeight = materialDefault('thinFilmWeight');
-    /** Film thickness in micrometres; maximum endpoint when thinFilmMap is present. Default `0.5`. */
-    thinFilmThickness = materialDefault('thinFilmThickness');
-    /** Film index of refraction. Default `1.4`. */
-    thinFilmIor = materialDefault('thinFilmIor');
-    /** Thickness at a thinFilmMap sample of zero, in micrometres; ignored without a map. May exceed thinFilmThickness. Default `0`. */
-    thinFilmThicknessMinimum = materialDefault('thinFilmThicknessMinimum');
-    /** Linear channel sampled by thinFilmMap. Default `r`. */
-    thinFilmMapChannel = materialDefault('thinFilmMapChannel');
-    // Emission and geometry
-    /** Emission color. Default `[1, 1, 1]`. */
-    emissionColor = materialDefault('emissionColor');
-    /** Emitted radiance scale; `0` disables emission. Default `0`. */
-    emissionLuminance = materialDefault('emissionLuminance');
-    /**
-     * Coverage, `1` opaque. See `alphaMode`. Default `1`.
-     * @deprecated Use geometryOpacity.
-     */
-    opacity = materialDefault('opacity');
-    /**
-     * Treat the surface as an infinitely thin shell (leaves, paper). Default `false`.
-     * @deprecated Use geometryThinWalled.
-     */
-    thinWalled = materialDefault('thinWalled');
-    /** Disables geometric back-face culling for this material. Default `false`. */
-    doubleSided = materialDefault('doubleSided');
-    // Textures
-    /** Base color texture, multiplied with `baseColor` using Texture color encoding. Default `undefined`. */
-    map;
-    /** Standalone opacity texture sampled from its green channel, matching Three.js. Default `undefined`. */
-    alphaMap;
-    /**
-     * Coverage for surface and shadow rays: `opaque` ignores alpha inputs,
-     * `mask` uses binary alpha testing, `blend` retains fractional coverage.
-     * `auto` derives the mode from the alpha inputs. Default `auto`.
-     */
-    alphaMode = materialDefault('alphaMode');
-    /** Alpha-test threshold for `mask` mode; equality is fully covered. Default `0`. */
-    alphaCutoff = materialDefault('alphaCutoff');
-    /** Emission texture multiplied with `emissionColor`. Default `undefined`. */
-    emissiveMap;
-    /** Tangent-space normal map. */
-    normalMap;
-    /** Normal map strength per axis. Default `[1, 1]`. */
-    normalScale = materialDefault('normalScale');
-    /** glTF-compatible B=metalness, G=specular roughness texture. Default `undefined`. */
-    metallicRoughnessMap;
-    /** Standalone roughness texture sampled from its green channel. Default `undefined`. */
-    roughnessMap;
-    /** Standalone metalness texture sampled from its blue channel. Default `undefined`. */
-    metalnessMap;
-    /** Multiplies transmission weight using the texture's red channel. Default `undefined`. */
-    transmissionMap;
-    /** Linear thickness-range texture; R and zero minimum preserve multiplication semantics. Default `undefined`. */
-    thinFilmMap;
-    /** Multiplies coatWeight by the linear red channel. Default `undefined`. */
-    coatWeightMap;
-    /** Multiplies coatRoughness by the linear green channel. Default `undefined`. */
-    coatRoughnessMap;
-    /** Multiplies fuzzColor by RGB channels using Texture color encoding. Default `undefined`. */
-    fuzzColorMap;
-    /** Multiplies fuzzRoughness by the linear alpha channel. Default `undefined`. */
-    fuzzRoughnessMap;
-    /** Multiplies specularWeight by the linear alpha channel. Default `undefined`. */
-    specularWeightMap;
-    /** Multiplies specularColor by RGB channels using Texture color encoding. Default `undefined`. */
-    specularColorMap;
-    /** Source convention for base specular anisotropy. `gltf` converts textured roughness and strength before coat roughening; `openpbr` uses native parameters. Default `openpbr`. */
-    specularAnisotropyModel = 'openpbr';
-    /** Linear RG tangent direction and B strength multiplier for the base specular layer. Default `undefined`. */
-    anisotropyMap;
-    /** Independent tangent-space coat normal in linear RGB. Without a map, coat uses the surface normal before base normal mapping. Default `undefined`. */
-    coatNormalMap;
-    /** XY strength of coatNormalMap; independent of normalScale. Default `[1, 1]`. */
-    coatNormalScale = materialDefault('coatNormalScale');
-    /** Base direction rotation in radians, counter-clockwise in tangent/bitangent space after RG decoding. Default `0`. */
-    specularAnisotropyRotation = 0;
-    /** Coat direction rotation in radians relative to the geometry tangent. Default `0`. */
-    coatAnisotropyRotation = 0;
-    /** GGX roughness anisotropy in [0, 1]; native OpenPBR or source glTF strength according to specularAnisotropyModel. Requires tangents. Default `0`. */
-    get specularRoughnessAnisotropy() { return this.specularAnisotropy; }
-    set specularRoughnessAnisotropy(value) { this.specularAnisotropy = value; }
-    /** OpenPBR coat GGX roughness anisotropy in [0, 1]. Default `0`. */
-    get coatRoughnessAnisotropy() { return this.coatAnisotropy; }
-    set coatRoughnessAnisotropy(value) { this.coatAnisotropy = value; }
-    /** Subsurface scattering anisotropy in [-1, 1]. Default `0`. */
-    get subsurfaceScatterAnisotropy() { return this.subsurfaceAnisotropy; }
-    set subsurfaceScatterAnisotropy(value) { this.subsurfaceAnisotropy = value; }
-    /** Surface coverage; alphaMode controls testing and blending. Default `1`. */
-    get geometryOpacity() { return this.opacity; }
-    set geometryOpacity(value) { this.opacity = value; }
-    /** Treat the surface as an infinitely thin shell. Default `false`. */
-    get geometryThinWalled() { return this.thinWalled; }
-    set geometryThinWalled(value) { this.thinWalled = value; }
-    // Renderer extensions
-    /**
-     * Invisible ground that only receives shadows, composited over the
-     * background. Default `false`.
-     */
-    shadowCatcher = materialDefault('shadowCatcher');
-    /** Displays emission without scattering or illuminating other surfaces. Default `false`. */
-    unlit = materialDefault('unlit');
-    /** Radius of rounded-edge shading (shader bevel) in scene units. `0` disables it. Default `0`. */
-    bevelSize = materialDefault('bevelSize');
-    /** How map alpha is used: ignored, opacity or transmission. Default `opaque`. */
-    mapAlphaUsage = materialDefault('mapAlphaUsage');
-    /** Procedural UV projection for textures without (good) UVs. Default `none`. */
-    uvProjection = materialDefault('uvProjection');
-    /** UV scale used with `uvProjection`. Default `[1, 1]`. */
-    uvProjectionScale = materialDefault('uvProjectionScale');
-    // Displacement
-    /** Height texture (red channel) for displacement. Default `undefined`. */
-    displacementMap;
-    /** Procedural UV projection for the displacement map. Default `none`. */
-    displacementUvProjection = materialDefault('displacementUvProjection');
-    /** UV scale used with `displacementUvProjection`. Default `1`. */
-    displacementUvProjectionScale = materialDefault('displacementUvProjectionScale');
-    /** Height multiplier in mesh-local units; 0 removes height variation. Default `0.1`. */
-    displacementScale = materialDefault('displacementScale');
-    /** Offset added after scaling the height map, along the normal in mesh-local units; requires a displacement map. Default `0`. */
-    displacementBias = materialDefault('displacementBias');
-    /** Ray-marching step in mesh-local units; 0 automatically uses abs(displacementScale) / 32. Default `0`. */
-    displacementStepSize = materialDefault('displacementStepSize');
-}
-export const materialAlphaModeConstants = {
-    opaque: 0,
-    mask: 1,
-    blend: 2
-};
-export function resolveMaterialAlphaMode(material) {
-    if (material.alphaMode !== 'auto')
-        return material.alphaMode;
-    if (material.alphaCutoff > 0)
-        return 'mask';
-    if (material.opacity < 1 ||
-        material.mapAlphaUsage === "alpha" ||
-        material.alphaMap) {
-        return 'blend';
-    }
-    return 'opaque';
+    constructor(params = {}) { super(params); }
 }
-export { materialKeys, materialTextureKeys, materialGeometryKeys, materialParamKeys, getMaterialHashKey, resetMaterialTextureId } from './openPbrSchema.js';
 //# sourceMappingURL=OpenPBRMaterial.js.map