@meimu/mutracer 0.1.5 → 0.3.0

package/lib/scene/OpenPBRMaterial.js.map

@@ -1 +1 @@
-{"version":3,"file":"OpenPBRMaterial.js","sourceRoot":"","sources":["../../src/scene/OpenPBRMaterial.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAO1E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,OAAO,OAAO,eAAe;IAClC,4EAA4E;IAC5E,YAAY,SAAgC,EAAE;QAC5C,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACpC,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,0EAA0E;IAC1E,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,+EAA+E;IAC/E,WAAW,GAAY,eAAe,CAAC,aAAa,CAAC,CAAC;IAEtD,WAAW;IACX,yGAAyG;IACzG,GAAG,CAAW;IACd,yGAAyG;IACzG,QAAQ,CAAW;IACnB;;;;OAIG;IACH,SAAS,GAAsB,eAAe,CAAC,WAAW,CAAC,CAAC;IAC5D,oFAAoF;IACpF,WAAW,GAAW,eAAe,CAAC,aAAa,CAAC,CAAC;IACrD,6EAA6E;IAC7E,WAAW,CAAW;IACtB,gCAAgC;IAChC,SAAS,CAAW;IACpB,sDAAsD;IACtD,WAAW,GAAS,eAAe,CAAC,aAAa,CAAC,CAAC;IACnD,sFAAsF;IACtF,oBAAoB,CAAW;IAC/B,wFAAwF;IACxF,YAAY,CAAW;IACvB,uFAAuF;IACvF,YAAY,CAAW;IACvB,2FAA2F;IAC3F,eAAe,CAAW;IAC1B,iHAAiH;IACjH,WAAW,CAAW;IAEtB,4EAA4E;IAC5E,aAAa,CAAW;IACxB,iFAAiF;IACjF,gBAAgB,CAAW;IAC3B,8FAA8F;IAC9F,YAAY,CAAW;IACvB,iFAAiF;IACjF,gBAAgB,CAAW;IAC3B,kFAAkF;IAClF,iBAAiB,CAAW;IAC5B,kGAAkG;IAClG,gBAAgB,CAAW;IAG3B,mLAAmL;IACnL,uBAAuB,GAAuB,SAAS,CAAC;IACxD,8GAA8G;IAC9G,aAAa,CAAW;IACxB,wJAAwJ;IACxJ,aAAa,CAAW;IACxB,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,CAAW;IAC1B,yEAAyE;IACzE,wBAAwB,GAAiB,eAAe,CAAC,0BAA0B,CAAC,CAAC;IACrF,kEAAkE;IAClE,6BAA6B,GAAW,eAAe,CAAC,+BAA+B,CAAC,CAAC;IACzF,wFAAwF;IACxF,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,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,MAAM,EAAE,CAAC;IACT,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACA,CAAC;AAIX,MAAM,UAAU,wBAAwB,CACtC,QAAyB;IAEzB,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 type { Vec2 } from '../types.js';\nimport { ColorRGB } from '../types.js';\nimport type Texture from './Texture.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/**\n * OpenPBR 1.1 surface material.\n *\n * Property names are camelCase OpenPBR inputs plus documented compatibility names\n * (https://academysoftwarefoundation.github.io/OpenPBR/). Colors are linear\n * RGB. Length-valued inputs (`transmissionDepth`, `subsurfaceRadius`) use\n * scene units; `thinFilmThickness` is in micrometres as in OpenPBR.\n *\n * ```ts\n * const gold = new OpenPBRMaterial({\n *   baseColor: [1.0, 0.78, 0.34], baseMetalness: 1, specularRoughness: 0.2\n * });\n * ```\n *\n * Edit parameters in place; the next `engine.update()` detects the changes.\n */\nexport default class OpenPBRMaterial {\n  /** Creates a material. Omitted properties use their documented defaults. */\n  constructor(params: OpenPBRMaterialParams = {}) {\n    applyMaterialParams(this, params);\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  /** Dispersion strength; `> 0` enables spectral rendering. 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 for this material. 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?: Texture;\n  /** Standalone opacity texture sampled from its green channel, matching Three.js. Default `undefined`. */\n  alphaMap?: Texture;\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?: Texture;\n  /** Tangent-space normal map. */\n  normalMap?: Texture;\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?: Texture;\n  /** Standalone roughness texture sampled from its green channel. Default `undefined`. */\n  roughnessMap?: Texture;\n  /** Standalone metalness texture sampled from its blue channel. Default `undefined`. */\n  metalnessMap?: Texture;\n  /** Multiplies transmission weight using the texture's red channel. Default `undefined`. */\n  transmissionMap?: Texture;\n  /** Linear thickness-range texture; R and zero minimum preserve multiplication semantics. Default `undefined`. */\n  thinFilmMap?: Texture;\n\n  /** Multiplies coatWeight by the linear red channel. Default `undefined`. */\n  coatWeightMap?: Texture;\n  /** Multiplies coatRoughness by the linear green channel. Default `undefined`. */\n  coatRoughnessMap?: Texture;\n  /** Multiplies fuzzColor by RGB channels using Texture color encoding. Default `undefined`. */\n  fuzzColorMap?: Texture;\n  /** Multiplies fuzzRoughness by the linear alpha channel. Default `undefined`. */\n  fuzzRoughnessMap?: Texture;\n  /** Multiplies specularWeight by the linear alpha channel. Default `undefined`. */\n  specularWeightMap?: Texture;\n  /** Multiplies specularColor by RGB channels using Texture color encoding. Default `undefined`. */\n  specularColorMap?: Texture;\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?: Texture;\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?: Texture;\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?: Texture;\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 units; 0 removes height variation. 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 const materialAlphaModeConstants = {\n  opaque: 0,\n  mask: 1,\n  blend: 2\n} as const;\n\nexport type ResolvedMaterialAlphaMode = Exclude<MaterialAlphaMode, 'auto'>;\n\nexport function resolveMaterialAlphaMode(\n  material: OpenPBRMaterial\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 OpenPBRMaterial. */\nexport type OpenPBRMaterialParams = Partial<OpenPBRMaterial>;\n"]}
+{"version":3,"file":"OpenPBRMaterial.js","sourceRoot":"","sources":["../../src/scene/OpenPBRMaterial.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,oBAAoB,CAAC;AAI/C,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC1F,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,iBAAiB,EACjF,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEzE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,aAAa;IACxD,4EAA4E;IAC5E,YAAY,SAAgC,EAAE,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;CAsCnE","sourcesContent":["import MaterialState from './MaterialState.js';\nimport type Texture from './Texture.js';\nexport type { UVProjection, MaterialAlphaMode, ResolvedMaterialAlphaMode } from './MaterialState.js';\nexport type { MaterialTextureName } from './materialTextureNames.js';\nexport { materialAlphaModeConstants, resolveMaterialAlphaMode } from './MaterialState.js';\nexport { materialKeys, materialTextureKeys, materialGeometryKeys, materialParamKeys,\n  getMaterialHashKey, resetMaterialTextureId } from './openPbrSchema.js';\n\n/**\n * OpenPBR 1.1 surface material.\n *\n * Property names are camelCase OpenPBR inputs plus documented compatibility names\n * (https://academysoftwarefoundation.github.io/OpenPBR/). Colors are linear\n * RGB. Length-valued inputs (`transmissionDepth`, `subsurfaceRadius`) use\n * scene units; `thinFilmThickness` is in micrometres as in OpenPBR.\n *\n * ```ts\n * const gold = new OpenPBRMaterial({\n *   baseColor: [1.0, 0.78, 0.34], baseMetalness: 1, specularRoughness: 0.2\n * });\n * ```\n *\n * Edit parameters in place; the next `engine.update()` detects the changes.\n */\nexport default class OpenPBRMaterial extends MaterialState {\n  /** Creates a material. Omitted properties use their documented defaults. */\n  constructor(params: OpenPBRMaterialParams = {}) { super(params); }\n\n  /** Base color texture, multiplied with `baseColor` using Texture color encoding. Default `undefined`. */\n  declare map?: Texture;\n  /** Standalone opacity texture sampled from its green channel, matching Three.js. Default `undefined`. */\n  declare alphaMap?: Texture;\n  /** Emission texture multiplied with `emissionColor`. Default `undefined`. */\n  declare emissiveMap?: Texture;\n  /** Tangent-space normal map. Default `undefined`. */\n  declare normalMap?: Texture;\n  /** glTF-compatible B=metalness, G=specular roughness texture. Default `undefined`. */\n  declare metallicRoughnessMap?: Texture;\n  /** Standalone roughness texture sampled from its green channel. Default `undefined`. */\n  declare roughnessMap?: Texture;\n  /** Standalone metalness texture sampled from its blue channel. Default `undefined`. */\n  declare metalnessMap?: Texture;\n  /** Multiplies transmission weight using the texture's red channel. Default `undefined`. */\n  declare transmissionMap?: Texture;\n  /** Linear thickness-range texture; R and zero minimum preserve multiplication semantics. Default `undefined`. */\n  declare thinFilmMap?: Texture;\n  /** Multiplies coatWeight by the linear red channel. Default `undefined`. */\n  declare coatWeightMap?: Texture;\n  /** Multiplies coatRoughness by the linear green channel. Default `undefined`. */\n  declare coatRoughnessMap?: Texture;\n  /** Multiplies fuzzColor by RGB channels using Texture color encoding. Default `undefined`. */\n  declare fuzzColorMap?: Texture;\n  /** Multiplies fuzzRoughness by the linear alpha channel. Default `undefined`. */\n  declare fuzzRoughnessMap?: Texture;\n  /** Multiplies specularWeight by the linear alpha channel. Default `undefined`. */\n  declare specularWeightMap?: Texture;\n  /** Multiplies specularColor by RGB channels using Texture color encoding. Default `undefined`. */\n  declare specularColorMap?: Texture;\n  /** Linear RG tangent direction and B strength multiplier for the base specular layer. Default `undefined`. */\n  declare anisotropyMap?: Texture;\n  /** Independent tangent-space coat normal in linear RGB. Without a map, coat uses the surface normal before base normal mapping. Default `undefined`. */\n  declare coatNormalMap?: Texture;\n  /** Height texture (red channel) for displacement. Default `undefined`. */\n  declare displacementMap?: Texture;\n}\n\n/** Optional material properties; defaults are documented on OpenPBRMaterial. */\nexport type OpenPBRMaterialParams = Partial<OpenPBRMaterial>;\n"]}

package/lib/scene/PixelTexture.d.ts

@@ -0,0 +1,6 @@
+import TextureState from './TextureState.js';
+import type { TextureDataSource } from './textureData.js';
+export default class PixelTexture extends TextureState {
+    readonly pixels: TextureDataSource;
+    constructor(pixels: TextureDataSource);
+}

package/lib/scene/PixelTexture.js

@@ -0,0 +1,10 @@
+import TextureState from './TextureState.js';
+// Separate native pixel ownership from the portable image-dimension record.
+export default class PixelTexture extends TextureState {
+    pixels;
+    constructor(pixels) {
+        super({ width: pixels.width, height: pixels.height });
+        this.pixels = pixels;
+    }
+}
+//# sourceMappingURL=PixelTexture.js.map

package/lib/scene/PixelTexture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PixelTexture.js","sourceRoot":"","sources":["../../src/scene/PixelTexture.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,mBAAmB,CAAC;AAG7C,4EAA4E;AAC5E,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,YAAY;IAC3C,MAAM,CAAoB;IACnC,YAAY,MAAyB;QACnC,KAAK,CAAC,EAAC,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAC,CAAC,CAAC;QACpD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF","sourcesContent":["import TextureState from './TextureState.js';\nimport type { TextureDataSource } from './textureData.js';\n\n// Separate native pixel ownership from the portable image-dimension record.\nexport default class PixelTexture extends TextureState {\n  readonly pixels: TextureDataSource;\n  constructor(pixels: TextureDataSource) {\n    super({width: pixels.width, height: pixels.height});\n    this.pixels = pixels;\n  }\n}\n"]}

package/lib/scene/ProceduralSky.d.ts

@@ -0,0 +1,24 @@
+import Texture from './Texture.js';
+import { type ProceduralSkyImage } from './skyParameters.js';
+/** Settings for a clear Earth sky, with local solar time on an equinox at latitude 40°. */
+export interface ProceduralSkyOptions {
+    /** Equirectangular pixel width and height, positive integers. Default `[2048, 1024]`; limited by the active device. */
+    resolution?: readonly [number, number];
+    /** Local solar time in hours, from `0` to `24`. Default `15`. Night has no stars, moon or artificial light. */
+    time?: number;
+}
+/**
+ * Clear-sky HDR environment for EnvironmentLight.map and scene backgrounds.
+ * Change time or resolution, then call engine.update(). Supports environments
+ * and backgrounds only; cannot be used in material texture slots.
+ */
+export default class ProceduralSky extends Texture {
+    image: ProceduralSkyImage;
+    constructor(options?: ProceduralSkyOptions);
+    /** Local solar time in hours, `0`–`24`. Default `15`; edits take effect on engine.update(). */
+    get time(): number;
+    set time(value: number);
+    /** Equirectangular pixel dimensions. Default `[2048, 1024]`; resizing discards accumulated samples. */
+    get resolution(): readonly [number, number];
+    set resolution(value: readonly [number, number]);
+}

package/lib/scene/ProceduralSky.js

@@ -0,0 +1,40 @@
+import Texture from './Texture.js';
+import { DEFAULT_SKY_TIME } from './skyParameters.js';
+/**
+ * Clear-sky HDR environment for EnvironmentLight.map and scene backgrounds.
+ * Change time or resolution, then call engine.update(). Supports environments
+ * and backgrounds only; cannot be used in material texture slots.
+ */
+export default class ProceduralSky extends Texture {
+    constructor(options = {}) {
+        const [width, height] = validResolution(options.resolution ?? [2048, 1024]);
+        super({ type: 'ProceduralSky', width, height, time: validTime(options.time ?? DEFAULT_SKY_TIME) });
+        this.colorSpace = 'linear';
+    }
+    /** Local solar time in hours, `0`–`24`. Default `15`; edits take effect on engine.update(). */
+    get time() { return this.image.time; }
+    set time(value) {
+        const time = validTime(value);
+        if (time !== this.time)
+            this.image = { ...this.image, time };
+    }
+    /** Equirectangular pixel dimensions. Default `[2048, 1024]`; resizing discards accumulated samples. */
+    get resolution() { return [this.image.width, this.image.height]; }
+    set resolution(value) {
+        const [width, height] = validResolution(value);
+        if (width !== this.image.width || height !== this.image.height)
+            this.image = { ...this.image, width, height };
+    }
+}
+function validTime(time) {
+    if (!Number.isFinite(time) || time < 0 || time > 24)
+        throw new RangeError('ProceduralSky time must be between 0 and 24 hours.');
+    return time;
+}
+function validResolution(value) {
+    if (value.length !== 2 || !value.every(size => Number.isSafeInteger(size) && size > 0)) {
+        throw new RangeError('ProceduralSky resolution must contain two positive integers.');
+    }
+    return value;
+}
+//# sourceMappingURL=ProceduralSky.js.map

package/lib/scene/ProceduralSky.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProceduralSky.js","sourceRoot":"","sources":["../../src/scene/ProceduralSky.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAA2B,MAAM,oBAAoB,CAAC;AAU/E;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,OAAO;IAGhD,YAAY,UAAgC,EAAE;QAC5C,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,eAAe,CAAC,OAAO,CAAC,UAAU,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAC5E,KAAK,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,IAAI,IAAI,gBAAgB,CAAC,EAAE,CAAC,CAAC;QACnG,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC;IAC7B,CAAC;IAED,+FAA+F;IAC/F,IAAI,IAAI,KAAK,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACtC,IAAI,IAAI,CAAC,KAAa;QACpB,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,IAAI,KAAK,IAAI,CAAC,IAAI;YAAE,IAAI,CAAC,KAAK,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC;IAC/D,CAAC;IAED,uGAAuG;IACvG,IAAI,UAAU,KAAgC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC7F,IAAI,UAAU,CAAC,KAAgC;QAC7C,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QAC/C,IAAI,KAAK,KAAK,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM;YAAE,IAAI,CAAC,KAAK,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChH,CAAC;CACF;AAED,SAAS,SAAS,CAAC,IAAY;IAC7B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,EAAE;QAAE,MAAM,IAAI,UAAU,CAAC,oDAAoD,CAAC,CAAC;IAChI,OAAO,IAAI,CAAC;AACd,CAAC;AACD,SAAS,eAAe,CAAC,KAAgC;IACvD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC;QACvF,MAAM,IAAI,UAAU,CAAC,8DAA8D,CAAC,CAAC;IACvF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["import Texture from './Texture.js';\nimport { DEFAULT_SKY_TIME, type ProceduralSkyImage } from './skyParameters.js';\n\n/** Settings for a clear Earth sky, with local solar time on an equinox at latitude 40°. */\nexport interface ProceduralSkyOptions {\n  /** Equirectangular pixel width and height, positive integers. Default `[2048, 1024]`; limited by the active device. */\n  resolution?: readonly [number, number];\n  /** Local solar time in hours, from `0` to `24`. Default `15`. Night has no stars, moon or artificial light. */\n  time?: number;\n}\n\n/**\n * Clear-sky HDR environment for EnvironmentLight.map and scene backgrounds.\n * Change time or resolution, then call engine.update(). Supports environments\n * and backgrounds only; cannot be used in material texture slots.\n */\nexport default class ProceduralSky extends Texture {\n  declare image: ProceduralSkyImage;\n\n  constructor(options: ProceduralSkyOptions = {}) {\n    const [width, height] = validResolution(options.resolution ?? [2048, 1024]);\n    super({ type: 'ProceduralSky', width, height, time: validTime(options.time ?? DEFAULT_SKY_TIME) });\n    this.colorSpace = 'linear';\n  }\n\n  /** Local solar time in hours, `0`–`24`. Default `15`; edits take effect on engine.update(). */\n  get time() { return this.image.time; }\n  set time(value: number) {\n    const time = validTime(value);\n    if (time !== this.time) this.image = { ...this.image, time };\n  }\n\n  /** Equirectangular pixel dimensions. Default `[2048, 1024]`; resizing discards accumulated samples. */\n  get resolution(): readonly [number, number] { return [this.image.width, this.image.height]; }\n  set resolution(value: readonly [number, number]) {\n    const [width, height] = validResolution(value);\n    if (width !== this.image.width || height !== this.image.height) this.image = { ...this.image, width, height };\n  }\n}\n\nfunction validTime(time: number) {\n  if (!Number.isFinite(time) || time < 0 || time > 24) throw new RangeError('ProceduralSky time must be between 0 and 24 hours.');\n  return time;\n}\nfunction validResolution(value: readonly [number, number]) {\n  if (value.length !== 2 || !value.every(size => Number.isSafeInteger(size) && size > 0)) {\n    throw new RangeError('ProceduralSky resolution must contain two positive integers.');\n  }\n  return value;\n}\n"]}

package/lib/scene/RectLight.d.ts

@@ -1,21 +1,10 @@
+import RectLightState from './RectLightState.js';
 import type { ColorRGB, Vec2 } from '../types.js';
-import SceneNode from './SceneNode.js';
 import type Texture from './Texture.js';
 /** Analytic light placed with transform; local -Z is the emission direction and local +X is the IES reference. */
-export default class RectLight extends SceneNode {
-    /** Light discriminator. */
-    readonly type: "RectLight";
-    /** Width and height; transform scale is ignored. Default `[1, 1]`. */
-    size: Vec2;
-    /** Linear RGB color. Default `[1, 1, 1]`. */
-    color: ColorRGB;
-    /** Emitted radiance multiplier. Default `1`. */
-    intensity: number;
+export default class RectLight extends RectLightState {
     /** Emission texture. Default `undefined`. */
     texture: Texture | undefined;
-    /** Angular spread from 0 (collimated) to 1 (hemisphere). Default `1`. */
-    spread: number;
-    /** Creates a light; omitted options retain the field defaults. */
     constructor(params?: {
         /** Width and height; transform scale is ignored. Default `[1, 1]`. */
         size?: Vec2;

package/lib/scene/RectLight.js

@@ -1,26 +1,8 @@
-import SceneNode from './SceneNode.js';
+import RectLightState from './RectLightState.js';
 /** Analytic light placed with transform; local -Z is the emission direction and local +X is the IES reference. */
-export default class RectLight extends SceneNode {
-    /** Light discriminator. */
-    type = 'RectLight';
-    /** Width and height; transform scale is ignored. Default `[1, 1]`. */
-    size = [1, 1];
-    /** Linear RGB color. Default `[1, 1, 1]`. */
-    color = [1, 1, 1];
-    /** Emitted radiance multiplier. Default `1`. */
-    intensity = 1;
-    /** Emission texture. Default `undefined`. */
-    texture = undefined;
-    /** Angular spread from 0 (collimated) to 1 (hemisphere). Default `1`. */
-    spread = 1;
-    /** Creates a light; omitted options retain the field defaults. */
+export default class RectLight extends RectLightState {
     constructor(params = {}) {
-        super();
-        this.size = params.size ?? [1, 1];
-        this.color = params.color ?? [1, 1, 1];
-        this.intensity = params.intensity ?? 1;
-        this.texture = params.texture ?? undefined;
-        this.spread = params.spread ?? 1;
+        super(params);
     }
 }
 //# sourceMappingURL=RectLight.js.map

package/lib/scene/RectLight.js.map

@@ -1 +1 @@
-{"version":3,"file":"RectLight.js","sourceRoot":"","sources":["../../src/scene/RectLight.ts"],"names":[],"mappings":"AACA,OAAO,SAAS,MAAM,gBAAgB,CAAC;AAGvC,kHAAkH;AAClH,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,SAAS;IAC9C,2BAA2B;IAClB,IAAI,GAAG,WAAoB,CAAC;IACrC,sEAAsE;IACtE,IAAI,GAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACpB,6CAA6C;IAC7C,KAAK,GAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5B,gDAAgD;IAChD,SAAS,GAAW,CAAC,CAAC;IACtB,6CAA6C;IAC7C,OAAO,GAAwB,SAAS,CAAC;IACzC,yEAAyE;IACzE,MAAM,GAAW,CAAC,CAAC;IAEnB,kEAAkE;IAClE,YAAY,SAWR,EAAE;QACJ,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACvC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,SAAS,CAAC;QAC3C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;IACnC,CAAC;CACF","sourcesContent":["import type { ColorRGB, Vec2 } from '../types.js';\nimport SceneNode from './SceneNode.js';\nimport type Texture from './Texture.js';\n\n/** Analytic light placed with transform; local -Z is the emission direction and local +X is the IES reference. */\nexport default class RectLight extends SceneNode {\n  /** Light discriminator. */\n  readonly type = 'RectLight' as const;\n  /** Width and height; transform scale is ignored. Default `[1, 1]`. */\n  size: Vec2 = [1, 1];\n  /** Linear RGB color. Default `[1, 1, 1]`. */\n  color: ColorRGB = [1, 1, 1];\n  /** Emitted radiance multiplier. Default `1`. */\n  intensity: number = 1;\n  /** Emission texture. Default `undefined`. */\n  texture: Texture | undefined = undefined;\n  /** Angular spread from 0 (collimated) to 1 (hemisphere). Default `1`. */\n  spread: number = 1;\n\n  /** Creates a light; omitted options retain the field defaults. */\n  constructor(params: {\n    /** Width and height; transform scale is ignored. Default `[1, 1]`. */\n    size?: Vec2;\n    /** Linear RGB color. Default `[1, 1, 1]`. */\n    color?: ColorRGB;\n    /** Emitted radiance multiplier. Default `1`. */\n    intensity?: number;\n    /** Emission texture. Default `undefined`. */\n    texture?: Texture | undefined;\n    /** Angular spread from 0 (collimated) to 1 (hemisphere). Default `1`. */\n    spread?: number;\n  } = {}) {\n    super();\n    this.size = params.size ?? [1, 1];\n    this.color = params.color ?? [1, 1, 1];\n    this.intensity = params.intensity ?? 1;\n    this.texture = params.texture ?? undefined;\n    this.spread = params.spread ?? 1;\n  }\n}\n"]}
+{"version":3,"file":"RectLight.js","sourceRoot":"","sources":["../../src/scene/RectLight.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,qBAAqB,CAAC;AAIjD,kHAAkH;AAClH,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,cAAc;IAGnD,YAAY,SAWR,EAAE;QACJ,KAAK,CAAC,MAAM,CAAC,CAAC;IAChB,CAAC;CACF","sourcesContent":["import RectLightState from './RectLightState.js';\nimport type { ColorRGB, Vec2 } from '../types.js';\nimport type Texture from './Texture.js';\n\n/** Analytic light placed with transform; local -Z is the emission direction and local +X is the IES reference. */\nexport default class RectLight extends RectLightState {\n  /** Emission texture. Default `undefined`. */\n  declare texture: Texture | undefined;\n  constructor(params: {\n    /** Width and height; transform scale is ignored. Default `[1, 1]`. */\n    size?: Vec2;\n    /** Linear RGB color. Default `[1, 1, 1]`. */\n    color?: ColorRGB;\n    /** Emitted radiance multiplier. Default `1`. */\n    intensity?: number;\n    /** Emission texture. Default `undefined`. */\n    texture?: Texture | undefined;\n    /** Angular spread from 0 (collimated) to 1 (hemisphere). Default `1`. */\n    spread?: number;\n  } = {}) {\n    super(params);\n  }\n}\n"]}

package/lib/scene/RectLightState.d.ts

@@ -0,0 +1,31 @@
+import type { ColorRGB, Vec2 } from '../types.js';
+import SceneNode from './SceneNode.js';
+import type TextureState from './TextureState.js';
+/** Analytic light placed with transform; local -Z is the emission direction and local +X is the IES reference. */
+export default class RectLightState extends SceneNode {
+    /** Light discriminator. */
+    readonly type: "RectLight";
+    /** Width and height; transform scale is ignored. Default `[1, 1]`. */
+    size: Vec2;
+    /** Linear RGB color. Default `[1, 1, 1]`. */
+    color: ColorRGB;
+    /** Emitted radiance multiplier. Default `1`. */
+    intensity: number;
+    /** Emission texture. Default `undefined`. */
+    texture: TextureState | undefined;
+    /** Angular spread from 0 (collimated) to 1 (hemisphere). Default `1`. */
+    spread: number;
+    /** Creates a light; omitted options retain the field defaults. */
+    constructor(params?: {
+        /** Width and height; transform scale is ignored. Default `[1, 1]`. */
+        size?: Vec2;
+        /** Linear RGB color. Default `[1, 1, 1]`. */
+        color?: ColorRGB;
+        /** Emitted radiance multiplier. Default `1`. */
+        intensity?: number;
+        /** Emission texture. Default `undefined`. */
+        texture?: TextureState | undefined;
+        /** Angular spread from 0 (collimated) to 1 (hemisphere). Default `1`. */
+        spread?: number;
+    });
+}

package/lib/scene/RectLightState.js

@@ -0,0 +1,26 @@
+import SceneNode from './SceneNode.js';
+/** Analytic light placed with transform; local -Z is the emission direction and local +X is the IES reference. */
+export default class RectLightState extends SceneNode {
+    /** Light discriminator. */
+    type = 'RectLight';
+    /** Width and height; transform scale is ignored. Default `[1, 1]`. */
+    size = [1, 1];
+    /** Linear RGB color. Default `[1, 1, 1]`. */
+    color = [1, 1, 1];
+    /** Emitted radiance multiplier. Default `1`. */
+    intensity = 1;
+    /** Emission texture. Default `undefined`. */
+    texture = undefined;
+    /** Angular spread from 0 (collimated) to 1 (hemisphere). Default `1`. */
+    spread = 1;
+    /** Creates a light; omitted options retain the field defaults. */
+    constructor(params = {}) {
+        super();
+        this.size = params.size ?? [1, 1];
+        this.color = params.color ?? [1, 1, 1];
+        this.intensity = params.intensity ?? 1;
+        this.texture = params.texture ?? undefined;
+        this.spread = params.spread ?? 1;
+    }
+}
+//# sourceMappingURL=RectLightState.js.map

package/lib/scene/RectLightState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RectLightState.js","sourceRoot":"","sources":["../../src/scene/RectLightState.ts"],"names":[],"mappings":"AACA,OAAO,SAAS,MAAM,gBAAgB,CAAC;AAGvC,kHAAkH;AAClH,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,SAAS;IACnD,2BAA2B;IAClB,IAAI,GAAG,WAAoB,CAAC;IACrC,sEAAsE;IACtE,IAAI,GAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACpB,6CAA6C;IAC7C,KAAK,GAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5B,gDAAgD;IAChD,SAAS,GAAW,CAAC,CAAC;IACtB,6CAA6C;IAC7C,OAAO,GAA6B,SAAS,CAAC;IAC9C,yEAAyE;IACzE,MAAM,GAAW,CAAC,CAAC;IAEnB,kEAAkE;IAClE,YAAY,SAWR,EAAE;QACJ,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACvC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,SAAS,CAAC;QAC3C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;IACnC,CAAC;CACF","sourcesContent":["import type { ColorRGB, Vec2 } from '../types.js';\nimport SceneNode from './SceneNode.js';\nimport type TextureState from './TextureState.js';\n\n/** Analytic light placed with transform; local -Z is the emission direction and local +X is the IES reference. */\nexport default class RectLightState extends SceneNode {\n  /** Light discriminator. */\n  readonly type = 'RectLight' as const;\n  /** Width and height; transform scale is ignored. Default `[1, 1]`. */\n  size: Vec2 = [1, 1];\n  /** Linear RGB color. Default `[1, 1, 1]`. */\n  color: ColorRGB = [1, 1, 1];\n  /** Emitted radiance multiplier. Default `1`. */\n  intensity: number = 1;\n  /** Emission texture. Default `undefined`. */\n  texture: TextureState | undefined = undefined;\n  /** Angular spread from 0 (collimated) to 1 (hemisphere). Default `1`. */\n  spread: number = 1;\n\n  /** Creates a light; omitted options retain the field defaults. */\n  constructor(params: {\n    /** Width and height; transform scale is ignored. Default `[1, 1]`. */\n    size?: Vec2;\n    /** Linear RGB color. Default `[1, 1, 1]`. */\n    color?: ColorRGB;\n    /** Emitted radiance multiplier. Default `1`. */\n    intensity?: number;\n    /** Emission texture. Default `undefined`. */\n    texture?: TextureState | undefined;\n    /** Angular spread from 0 (collimated) to 1 (hemisphere). Default `1`. */\n    spread?: number;\n  } = {}) {\n    super();\n    this.size = params.size ?? [1, 1];\n    this.color = params.color ?? [1, 1, 1];\n    this.intensity = params.intensity ?? 1;\n    this.texture = params.texture ?? undefined;\n    this.spread = params.spread ?? 1;\n  }\n}\n"]}

package/lib/scene/Scene.d.ts

@@ -1,4 +1,4 @@
-import { ColorRGBA } from '../types.js';
+import type { ColorRGBA, Mat4 } from '../types.js';
 import AmbientLight from './AmbientLight.js';
 import DirectionalLight from './DirectionalLight.js';
 import EnvironmentLight from './EnvironmentLight.js';
@@ -12,6 +12,17 @@ import Texture from './Texture.js';
 export type AnalyticLight = RectLight | SphereLight | SpotLight | DirectionalLight;
 /** Any light that can be placed in {@link Scene.lights}. */
 export type SceneLight = AmbientLight | EnvironmentLight | AnalyticLight;
+/** An equirectangular camera background with independent orientation. */
+export interface EquirectBackground {
+    /** Equirectangular background discriminator; always `Equirect`. */
+    type: 'Equirect';
+    /** Required equirectangular texture. */
+    map: Texture;
+    /** Map-to-world rotation, column-major. Default identity; translation and positive axis scale are ignored. */
+    transform?: Mat4;
+    /** Nonnegative background RGB multiplier. Default `1`; lighting and alpha are unchanged. */
+    intensity?: number;
+}
 /**
  * Environment map projected onto a ground plane and sky dome, so objects
  * appear to stand on the photographed ground.
@@ -36,10 +47,10 @@ export interface GroundedSkyboxBackground {
 }
 /**
  * What camera rays that miss the scene show: a linear RGBA color (alpha 0
- * for a transparent canvas), an equirectangular texture, or a grounded
- * skybox. When omitted, the environment light is shown.
+ * for a transparent canvas), an equirectangular texture, an `EquirectBackground`
+ * with independent rotation, or a grounded skybox. When omitted, the environment light is shown.
  */
-export type SceneBackground = ColorRGBA | Texture | GroundedSkyboxBackground;
+export type SceneBackground = ColorRGBA | Texture | EquirectBackground | GroundedSkyboxBackground;
 /**
  * Everything the renderer draws. A plain object; mesh and light membership,
  * mesh transforms, material parameters, resource references, light parameters and background

package/lib/scene/Scene.js.map

@@ -1 +1 @@
-{"version":3,"file":"Scene.js","sourceRoot":"","sources":["../../src/scene/Scene.ts"],"names":[],"mappings":"","sourcesContent":["import { ColorRGBA } from '../types.js';\nimport AmbientLight from './AmbientLight.js';\nimport DirectionalLight from './DirectionalLight.js';\nimport EnvironmentLight from './EnvironmentLight.js';\nimport Mesh from './Mesh.js';\nimport InstancedMesh from './InstancedMesh.js';\nimport RectLight from './RectLight.js';\nimport SphereLight from './SphereLight.js';\nimport SpotLight from './SpotLight.js';\nimport Texture from './Texture.js';\n\n/** Lights with an analytic shape. */\nexport type AnalyticLight = RectLight | SphereLight | SpotLight | DirectionalLight;\n/** Any light that can be placed in {@link Scene.lights}. */\nexport type SceneLight = AmbientLight | EnvironmentLight | AnalyticLight;\n\n/**\n * Environment map projected onto a ground plane and sky dome, so objects\n * appear to stand on the photographed ground.\n */\nexport interface GroundedSkyboxBackground {\n  /** Ground projection discriminator; always `GroundedSkybox`. */\n  type: 'GroundedSkybox';\n  /** Required equirectangular environment texture. */\n  map: Texture;\n  /** Required capture height above ground in scene units. */\n  height: number;\n  /** Required projected sky-dome radius in scene units. */\n  radius: number;\n  /** Ground plane Y in scene units. Default `0`. */\n  groundHeight?: number;\n  /** Capture X/Z center in scene units. Default `[0, 0]`. */\n  center?: [number, number];\n  /** Background rotation around +Y in radians, about the capture center. Default `0`; ground stays level. */\n  rotation?: number;\n  /** Nonnegative background RGB multiplier. Default `1`; lighting and alpha are unchanged. */\n  intensity?: number;\n}\n\n/**\n * What camera rays that miss the scene show: a linear RGBA color (alpha 0\n * for a transparent canvas), an equirectangular texture, or a grounded\n * skybox. When omitted, the environment light is shown.\n */\nexport type SceneBackground = ColorRGBA | Texture | GroundedSkyboxBackground;\n/**\n * Everything the renderer draws. A plain object; mesh and light membership,\n * mesh transforms, material parameters, resource references, light parameters and background\n * values are detected automatically, including edits within existing arrays.\n * Call `markUpdated()` on a Geometry after attribute edits, and a Texture\n * after pixel or UV-array element edits.\n * InstancedMesh matrix/color elements require markUpdated() or the dedicated\n * markTransformsUpdated()/markColorsUpdated() notifications.\n */\nexport interface Scene {\n  /** Required mesh instances; use an empty array for an empty scene. */\n  meshes: (Mesh | InstancedMesh)[];\n  /** Required lights; use an empty array for an unlit scene. */\n  lights: SceneLight[];\n  /** Camera-ray background; defaults to the environment light when omitted. */\n  background?: SceneBackground;\n\n}\n"]}
+{"version":3,"file":"Scene.js","sourceRoot":"","sources":["../../src/scene/Scene.ts"],"names":[],"mappings":"","sourcesContent":["import type { ColorRGBA, Mat4 } from '../types.js';\nimport AmbientLight from './AmbientLight.js';\nimport DirectionalLight from './DirectionalLight.js';\nimport EnvironmentLight from './EnvironmentLight.js';\nimport Mesh from './Mesh.js';\nimport InstancedMesh from './InstancedMesh.js';\nimport RectLight from './RectLight.js';\nimport SphereLight from './SphereLight.js';\nimport SpotLight from './SpotLight.js';\nimport Texture from './Texture.js';\n\n/** Lights with an analytic shape. */\nexport type AnalyticLight = RectLight | SphereLight | SpotLight | DirectionalLight;\n/** Any light that can be placed in {@link Scene.lights}. */\nexport type SceneLight = AmbientLight | EnvironmentLight | AnalyticLight;\n\n/** An equirectangular camera background with independent orientation. */\nexport interface EquirectBackground {\n  /** Equirectangular background discriminator; always `Equirect`. */\n  type: 'Equirect';\n  /** Required equirectangular texture. */\n  map: Texture;\n  /** Map-to-world rotation, column-major. Default identity; translation and positive axis scale are ignored. */\n  transform?: Mat4;\n  /** Nonnegative background RGB multiplier. Default `1`; lighting and alpha are unchanged. */\n  intensity?: number;\n}\n\n/**\n * Environment map projected onto a ground plane and sky dome, so objects\n * appear to stand on the photographed ground.\n */\nexport interface GroundedSkyboxBackground {\n  /** Ground projection discriminator; always `GroundedSkybox`. */\n  type: 'GroundedSkybox';\n  /** Required equirectangular environment texture. */\n  map: Texture;\n  /** Required capture height above ground in scene units. */\n  height: number;\n  /** Required projected sky-dome radius in scene units. */\n  radius: number;\n  /** Ground plane Y in scene units. Default `0`. */\n  groundHeight?: number;\n  /** Capture X/Z center in scene units. Default `[0, 0]`. */\n  center?: [number, number];\n  /** Background rotation around +Y in radians, about the capture center. Default `0`; ground stays level. */\n  rotation?: number;\n  /** Nonnegative background RGB multiplier. Default `1`; lighting and alpha are unchanged. */\n  intensity?: number;\n}\n\n/**\n * What camera rays that miss the scene show: a linear RGBA color (alpha 0\n * for a transparent canvas), an equirectangular texture, an `EquirectBackground`\n * with independent rotation, or a grounded skybox. When omitted, the environment light is shown.\n */\nexport type SceneBackground = ColorRGBA | Texture | EquirectBackground | GroundedSkyboxBackground;\n/**\n * Everything the renderer draws. A plain object; mesh and light membership,\n * mesh transforms, material parameters, resource references, light parameters and background\n * values are detected automatically, including edits within existing arrays.\n * Call `markUpdated()` on a Geometry after attribute edits, and a Texture\n * after pixel or UV-array element edits.\n * InstancedMesh matrix/color elements require markUpdated() or the dedicated\n * markTransformsUpdated()/markColorsUpdated() notifications.\n */\nexport interface Scene {\n  /** Required mesh instances; use an empty array for an empty scene. */\n  meshes: (Mesh | InstancedMesh)[];\n  /** Required lights; use an empty array for an unlit scene. */\n  lights: SceneLight[];\n  /** Camera-ray background; defaults to the environment light when omitted. */\n  background?: SceneBackground;\n\n}\n"]}

package/lib/scene/SceneNode.js

@@ -1,3 +1,4 @@
+import { read, write } from '../math/access.js';
 import { mat4 } from '../math.js';
 /** Base class of objects positioned by a local-to-world transform. */
 export default class SceneNode {
@@ -10,19 +11,19 @@ export default class SceneNode {
     transform = mat4.create();
     /** Reads a copy of the translation, or writes it into transform. Default `[0, 0, 0]`. */
     get position() {
-        return [this.transform[12], this.transform[13], this.transform[14]];
+        return [read(this.transform, 12), read(this.transform, 13), read(this.transform, 14)];
     }
     set position(value) {
-        this.transform[12] = value[0];
-        this.transform[13] = value[1];
-        this.transform[14] = value[2];
+        write(this.transform, 12, read(value, 0));
+        write(this.transform, 13, read(value, 1));
+        write(this.transform, 14, read(value, 2));
     }
     /** Points local -Z at target, preserving position and scale. Default up `[0, 1, 0]`. */
     lookAt(target, up = [0, 1, 0]) {
         const scale = mat4.getScaling(new Float32Array(3), this.transform);
         const position = this.position;
-        const direction = [target[0] - position[0], target[1] - position[1], target[2] - position[2]];
-        const cross = [direction[1] * up[2] - direction[2] * up[1], direction[2] * up[0] - direction[0] * up[2], direction[0] * up[1] - direction[1] * up[0]];
+        const direction = [read(target, 0) - read(position, 0), read(target, 1) - read(position, 1), read(target, 2) - read(position, 2)];
+        const cross = [direction[1] * read(up, 2) - direction[2] * read(up, 1), direction[2] * read(up, 0) - direction[0] * read(up, 2), direction[0] * read(up, 1) - direction[1] * read(up, 0)];
         const effectiveUp = Math.hypot(...cross) > 1e-8 ? up
             : Math.abs(direction[2]) < Math.hypot(...direction) * .99 ? [0, 0, -1] : [1, 0, 0];
         mat4.targetTo(this.transform, position, target, effectiveUp);

package/lib/scene/SceneNode.js.map

@@ -1 +1 @@
-{"version":3,"file":"SceneNode.js","sourceRoot":"","sources":["../../src/scene/SceneNode.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAElC,sEAAsE;AACtE,MAAM,CAAC,OAAO,OAAgB,SAAS;IACrC,kDAAkD;IAClD,IAAI,GAAG,EAAE,CAAC;IACV;;;OAGG;IACH,SAAS,GAAS,IAAI,CAAC,MAAM,EAAE,CAAC;IAEhC,yFAAyF;IACzF,IAAI,QAAQ;QACV,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,QAAQ,CAAC,KAAW;QACtB,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC9B,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC9B,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC;IAED,wFAAwF;IACxF,MAAM,CAAC,MAAY,EAAE,KAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACnE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC/B,MAAM,SAAS,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9F,MAAM,KAAK,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,GAAC,EAAE,CAAC,CAAC,CAAC,GAAC,SAAS,CAAC,CAAC,CAAC,GAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,GAAC,EAAE,CAAC,CAAC,CAAC,GAAC,SAAS,CAAC,CAAC,CAAC,GAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,GAAC,EAAE,CAAC,CAAC,CAAC,GAAC,SAAS,CAAC,CAAC,CAAC,GAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACpI,MAAM,WAAW,GAAS,IAAI,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE;YACxD,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACrF,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAC7D,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC;IACd,CAAC;CACF","sourcesContent":["import type { Mat4, Vec3 } from '../types.js';\nimport { mat4 } from '../math.js';\n\n/** Base class of objects positioned by a local-to-world transform. */\nexport default abstract class SceneNode {\n  /** Optional object name. Default empty string. */\n  name = '';\n  /**\n   * Local-to-world transform: column-major 4×4 (gl-matrix layout). Default identity.\n   * Edits, including in-place element edits, are detected on the next render.\n   */\n  transform: Mat4 = mat4.create();\n\n  /** Reads a copy of the translation, or writes it into transform. Default `[0, 0, 0]`. */\n  get position(): Vec3 {\n    return [this.transform[12], this.transform[13], this.transform[14]];\n  }\n  set position(value: Vec3) {\n    this.transform[12] = value[0];\n    this.transform[13] = value[1];\n    this.transform[14] = value[2];\n  }\n\n  /** Points local -Z at target, preserving position and scale. Default up `[0, 1, 0]`. */\n  lookAt(target: Vec3, up: Vec3 = [0, 1, 0]): this {\n    const scale = mat4.getScaling(new Float32Array(3), this.transform);\n    const position = this.position;\n    const direction = [target[0] - position[0], target[1] - position[1], target[2] - position[2]];\n    const cross = [direction[1]*up[2]-direction[2]*up[1], direction[2]*up[0]-direction[0]*up[2], direction[0]*up[1]-direction[1]*up[0]];\n    const effectiveUp: Vec3 = Math.hypot(...cross) > 1e-8 ? up\n      : Math.abs(direction[2]) < Math.hypot(...direction) * .99 ? [0, 0, -1] : [1, 0, 0];\n    mat4.targetTo(this.transform, position, target, effectiveUp);\n    mat4.scale(this.transform, this.transform, scale);\n    return this;\n  }\n}\n"]}
+{"version":3,"file":"SceneNode.js","sourceRoot":"","sources":["../../src/scene/SceneNode.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Mat4, Vec3 } from '../types.js';\nimport { read, write } from '../math/access.js';\nimport { mat4 } from '../math.js';\n\n/** Base class of objects positioned by a local-to-world transform. */\nexport default abstract class SceneNode {\n  /** Optional object name. Default empty string. */\n  name = '';\n  /**\n   * Local-to-world transform: column-major 4×4 (gl-matrix layout). Default identity.\n   * Edits, including in-place element edits, are detected on the next render.\n   */\n  transform: Mat4 = mat4.create();\n\n  /** Reads a copy of the translation, or writes it into transform. Default `[0, 0, 0]`. */\n  get position(): Vec3 {\n    return [read(this.transform, 12), read(this.transform, 13), read(this.transform, 14)];\n  }\n  set position(value: Vec3) {\n    write(this.transform, 12, read(value, 0));\n    write(this.transform, 13, read(value, 1));\n    write(this.transform, 14, read(value, 2));\n  }\n\n  /** Points local -Z at target, preserving position and scale. Default up `[0, 1, 0]`. */\n  lookAt(target: Vec3, up: Vec3 = [0, 1, 0]): this {\n    const scale = mat4.getScaling(new Float32Array(3), this.transform);\n    const position = this.position;\n    const direction = [read(target, 0) - read(position, 0), read(target, 1) - read(position, 1), read(target, 2) - read(position, 2)];\n    const cross = [direction[1]*read(up, 2)-direction[2]*read(up, 1), direction[2]*read(up, 0)-direction[0]*read(up, 2), direction[0]*read(up, 1)-direction[1]*read(up, 0)];\n    const effectiveUp: Vec3 = Math.hypot(...cross) > 1e-8 ? up\n      : Math.abs(direction[2]) < Math.hypot(...direction) * .99 ? [0, 0, -1] : [1, 0, 0];\n    mat4.targetTo(this.transform, position, target, effectiveUp);\n    mat4.scale(this.transform, this.transform, scale);\n    return this;\n  }\n}\n"]}

package/lib/scene/Texture.d.ts

@@ -1,49 +1,18 @@
-/** Raw RGBA pixels, rows top to bottom. Color encoding defaults to sRGB for bytes and linear for floats. */
-export interface TextureDataSource {
-    /** Required RGBA pixels in row-major order. Uint8Array/Uint8ClampedArray default to sRGB color; Float32Array/Int32Array default to linear values. Texture.colorSpace can override color encoding; data-map channels are always linear. */
-    data: Float32Array | Uint8Array | Uint8ClampedArray | Int32Array;
-    /** Required pixel width. */
-    width: number;
-    /** Required pixel height. */
-    height: number;
-}
-/** Transfer function for material color slots; data-map channels remain linear. */
-export type TextureColorSpace = 'srgb' | 'linear';
-/** Addressing of coordinates outside a material texture's [0, 1] range. */
-export type TextureWrapMode = 'repeat' | 'clamp-to-edge' | 'mirrored-repeat';
-export declare function textureWrapIndex(mode: TextureWrapMode): number;
+import type { ProceduralSkyImage } from './skyParameters.js';
+import TextureState from './TextureState.js';
+export type { TextureColorSpace, TextureWrapMode } from './TextureState.js';
+export { textureWrapIndex } from './TextureState.js';
+import type { TextureDataSource } from './textureData.js';
+export type { TextureDataSource } from './textureData.js';
 /**
  * Image used by materials, lights and backgrounds. Material color slots default
  * to sRGB for images/bytes and linear for float data; colorSpace overrides this.
  */
-export default class Texture {
-    /** Image or raw RGBA pixels supplied to the constructor; no default. */
-    image: HTMLImageElement | HTMLCanvasElement | ImageBitmap | OffscreenCanvas | TextureDataSource;
+export default class Texture extends TextureState {
+    /** Texture source supplied to the constructor; no default. */
+    image: HTMLImageElement | HTMLCanvasElement | ImageBitmap | OffscreenCanvas | TextureDataSource | ProceduralSkyImage;
     /** Optional stable identity of the texture in an adapter such as Three.js. */
     source?: object;
-    /** Incremented by `markUpdated()`. */
-    version: number;
-    /** Flip the image vertically when uploading. Default `false`. */
-    flipY: boolean;
-    /** UV repeat applied before sampling this texture. Default `[1, 1]`. */
-    uvScale: [number, number];
-    /** UV translation applied after repeat and before wrapping. Default `[0, 0]`. */
-    uvOffset: [number, number];
-    /** Horizontal material-texture addressing after UV scale/offset. Default `'repeat'`. */
-    wrapS: TextureWrapMode;
-    /** Vertical material-texture addressing after UV scale/offset. Default `'repeat'`. */
-    wrapT: TextureWrapMode;
-    /** Material color encoding. Default undefined: sRGB for images/bytes, linear for float/integer HDR data. Data-map channels ignore this option. */
-    colorSpace?: TextureColorSpace;
-    /** Geometry UV set used by this texture (Three.js Texture.channel). Default `0`. */
-    uvChannel: 0 | 1;
-    constructor(image: HTMLImageElement | HTMLCanvasElement | ImageBitmap | OffscreenCanvas | TextureDataSource);
-    /**
-     * Call after editing image pixels or UV array elements in place. Increments
-     * version so the next render refreshes all materials, lights and backgrounds
-     * using this texture. Assigning a new image, UV array, flipY, wrapS, wrapT, colorSpace or
-     * uvChannel is detected automatically.
-     */
-    markUpdated(): this;
+    constructor(image: HTMLImageElement | HTMLCanvasElement | ImageBitmap | OffscreenCanvas | TextureDataSource | ProceduralSkyImage);
 }
 export declare function isTextureDataSource(image: unknown): image is TextureDataSource;

package/lib/scene/Texture.js

@@ -1,43 +1,14 @@
-export function textureWrapIndex(mode) {
-    return mode === 'clamp-to-edge' ? 1 : mode === 'mirrored-repeat' ? 2 : 0;
-}
+import TextureState from './TextureState.js';
+export { textureWrapIndex } from './TextureState.js';
 /**
  * Image used by materials, lights and backgrounds. Material color slots default
  * to sRGB for images/bytes and linear for float data; colorSpace overrides this.
  */
-export default class Texture {
-    /** Image or raw RGBA pixels supplied to the constructor; no default. */
-    image;
+export default class Texture extends TextureState {
     /** Optional stable identity of the texture in an adapter such as Three.js. */
     source;
-    /** Incremented by `markUpdated()`. */
-    version = 0;
-    /** Flip the image vertically when uploading. Default `false`. */
-    flipY = false;
-    /** UV repeat applied before sampling this texture. Default `[1, 1]`. */
-    uvScale = [1, 1];
-    /** UV translation applied after repeat and before wrapping. Default `[0, 0]`. */
-    uvOffset = [0, 0];
-    /** Horizontal material-texture addressing after UV scale/offset. Default `'repeat'`. */
-    wrapS = 'repeat';
-    /** Vertical material-texture addressing after UV scale/offset. Default `'repeat'`. */
-    wrapT = 'repeat';
-    /** Material color encoding. Default undefined: sRGB for images/bytes, linear for float/integer HDR data. Data-map channels ignore this option. */
-    colorSpace;
-    /** Geometry UV set used by this texture (Three.js Texture.channel). Default `0`. */
-    uvChannel = 0;
     constructor(image) {
-        this.image = image;
-    }
-    /**
-     * Call after editing image pixels or UV array elements in place. Increments
-     * version so the next render refreshes all materials, lights and backgrounds
-     * using this texture. Assigning a new image, UV array, flipY, wrapS, wrapT, colorSpace or
-     * uvChannel is detected automatically.
-     */
-    markUpdated() {
-        this.version++;
-        return this;
+        super(image);
     }
 }
 export function isTextureDataSource(image) {

package/lib/scene/Texture.js.map

@@ -1 +1 @@
-{"version":3,"file":"Texture.js","sourceRoot":"","sources":["../../src/scene/Texture.ts"],"names":[],"mappings":"AAgBA,MAAM,UAAU,gBAAgB,CAAC,IAAqB;IACpD,OAAO,IAAI,KAAK,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,OAAO;IAC1B,wEAAwE;IACxE,KAAK,CAA2F;IAChG,8EAA8E;IAC9E,MAAM,CAAU;IAChB,sCAAsC;IACtC,OAAO,GAAG,CAAC,CAAC;IAEZ,iEAAiE;IACjE,KAAK,GAAY,KAAK,CAAC;IACvB,wEAAwE;IACxE,OAAO,GAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACnC,iFAAiF;IACjF,QAAQ,GAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACpC,wFAAwF;IACxF,KAAK,GAAoB,QAAQ,CAAC;IAClC,sFAAsF;IACtF,KAAK,GAAoB,QAAQ,CAAC;IAClC,kJAAkJ;IAClJ,UAAU,CAAqB;IAC/B,oFAAoF;IACpF,SAAS,GAAU,CAAC,CAAC;IACrB,YAAY,KAA+F;QACzG,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED;;;;;OAKG;IACH,WAAW;QACT,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,MAAM,UAAU,mBAAmB,CACjC,KAAc;IAEd,OAAO,CAAC,CAAC,CAAC,KAAK,IAAK,KAA2B,CAAC,IAAI,CAAC,CAAC;AACxD,CAAC","sourcesContent":["/** Raw RGBA pixels, rows top to bottom. Color encoding defaults to sRGB for bytes and linear for floats. */\nexport interface TextureDataSource {\n  /** Required RGBA pixels in row-major order. Uint8Array/Uint8ClampedArray default to sRGB color; Float32Array/Int32Array default to linear values. Texture.colorSpace can override color encoding; data-map channels are always linear. */\n  data: Float32Array | Uint8Array | Uint8ClampedArray | Int32Array;\n  /** Required pixel width. */\n  width: number;\n  /** Required pixel height. */\n  height: number;\n}\n\n/** Transfer function for material color slots; data-map channels remain linear. */\nexport type TextureColorSpace = 'srgb' | 'linear';\n\n/** Addressing of coordinates outside a material texture's [0, 1] range. */\nexport type TextureWrapMode = 'repeat' | 'clamp-to-edge' | 'mirrored-repeat';\n\nexport function textureWrapIndex(mode: TextureWrapMode): number {\n  return mode === 'clamp-to-edge' ? 1 : mode === 'mirrored-repeat' ? 2 : 0;\n}\n\n/**\n * Image used by materials, lights and backgrounds. Material color slots default\n * to sRGB for images/bytes and linear for float data; colorSpace overrides this.\n */\nexport default class Texture {\n  /** Image or raw RGBA pixels supplied to the constructor; no default. */\n  image: HTMLImageElement | HTMLCanvasElement | ImageBitmap | OffscreenCanvas | TextureDataSource;\n  /** Optional stable identity of the texture in an adapter such as Three.js. */\n  source?: object;\n  /** Incremented by `markUpdated()`. */\n  version = 0;\n\n  /** Flip the image vertically when uploading. Default `false`. */\n  flipY: boolean = false;\n  /** UV repeat applied before sampling this texture. Default `[1, 1]`. */\n  uvScale: [number, number] = [1, 1];\n  /** UV translation applied after repeat and before wrapping. Default `[0, 0]`. */\n  uvOffset: [number, number] = [0, 0];\n  /** Horizontal material-texture addressing after UV scale/offset. Default `'repeat'`. */\n  wrapS: TextureWrapMode = 'repeat';\n  /** Vertical material-texture addressing after UV scale/offset. Default `'repeat'`. */\n  wrapT: TextureWrapMode = 'repeat';\n  /** Material color encoding. Default undefined: sRGB for images/bytes, linear for float/integer HDR data. Data-map channels ignore this option. */\n  colorSpace?: TextureColorSpace;\n  /** Geometry UV set used by this texture (Three.js Texture.channel). Default `0`. */\n  uvChannel: 0 | 1 = 0;\n  constructor(image: HTMLImageElement | HTMLCanvasElement | ImageBitmap | OffscreenCanvas | TextureDataSource) {\n    this.image = image;\n  }\n\n  /**\n   * Call after editing image pixels or UV array elements in place. Increments\n   * version so the next render refreshes all materials, lights and backgrounds\n   * using this texture. Assigning a new image, UV array, flipY, wrapS, wrapT, colorSpace or\n   * uvChannel is detected automatically.\n   */\n  markUpdated() {\n    this.version++;\n    return this;\n  }\n}\n\nexport function isTextureDataSource(\n  image: unknown\n): image is TextureDataSource {\n  return !!(image && (image as TextureDataSource).data);\n}\n\n"]}
+{"version":3,"file":"Texture.js","sourceRoot":"","sources":["../../src/scene/Texture.ts"],"names":[],"mappings":"AACA,OAAO,YAAY,MAAM,mBAAmB,CAAC;AAE7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAIrD;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,OAAQ,SAAQ,YAAY;IAG/C,8EAA8E;IAC9E,MAAM,CAAU;IAChB,YAAY,KAAoH;QAC9H,KAAK,CAAC,KAAK,CAAC,CAAC;IACf,CAAC;CACF;AAED,MAAM,UAAU,mBAAmB,CACjC,KAAc;IAEd,OAAO,CAAC,CAAC,CAAC,KAAK,IAAK,KAA2B,CAAC,IAAI,CAAC,CAAC;AACxD,CAAC","sourcesContent":["import type { ProceduralSkyImage } from './skyParameters.js';\nimport TextureState from './TextureState.js';\nexport type { TextureColorSpace, TextureWrapMode } from './TextureState.js';\nexport { textureWrapIndex } from './TextureState.js';\nimport type { TextureDataSource } from './textureData.js';\nexport type { TextureDataSource } from './textureData.js';\n\n/**\n * Image used by materials, lights and backgrounds. Material color slots default\n * to sRGB for images/bytes and linear for float data; colorSpace overrides this.\n */\nexport default class Texture extends TextureState {\n  /** Texture source supplied to the constructor; no default. */\n  declare image: HTMLImageElement | HTMLCanvasElement | ImageBitmap | OffscreenCanvas | TextureDataSource | ProceduralSkyImage;\n  /** Optional stable identity of the texture in an adapter such as Three.js. */\n  source?: object;\n  constructor(image: HTMLImageElement | HTMLCanvasElement | ImageBitmap | OffscreenCanvas | TextureDataSource | ProceduralSkyImage) {\n    super(image);\n  }\n}\n\nexport function isTextureDataSource(\n  image: unknown\n): image is TextureDataSource {\n  return !!(image && (image as TextureDataSource).data);\n}\n\n"]}

package/lib/scene/TextureState.d.ts

@@ -0,0 +1,35 @@
+/** Transfer function for material color slots; data-map channels remain linear. */
+export type TextureColorSpace = 'srgb' | 'linear';
+/** Addressing of coordinates outside a material texture's [0, 1] range. */
+export type TextureWrapMode = 'repeat' | 'clamp-to-edge' | 'mirrored-repeat';
+export declare function textureWrapIndex(mode: TextureWrapMode): number;
+export interface TextureImageSize {
+    width: number;
+    height: number;
+}
+export default class TextureState {
+    image: TextureImageSize;
+    version: number;
+    /** Flip the image vertically when uploading. Default `false`. */
+    flipY: boolean;
+    /** UV repeat applied before sampling this texture. Default `[1, 1]`. */
+    uvScale: [number, number];
+    /** UV translation applied after repeat and before wrapping. Default `[0, 0]`. */
+    uvOffset: [number, number];
+    /** Horizontal material-texture addressing after UV scale/offset. Default `'repeat'`. */
+    wrapS: TextureWrapMode;
+    /** Vertical material-texture addressing after UV scale/offset. Default `'repeat'`. */
+    wrapT: TextureWrapMode;
+    /** Material color encoding. Default undefined: sRGB for images/bytes, linear for float/integer HDR data. Data-map channels ignore this option. */
+    colorSpace?: TextureColorSpace;
+    /** Geometry UV set used by this texture (Three.js Texture.channel). Default `0`. */
+    uvChannel: 0 | 1;
+    constructor(image: TextureImageSize);
+    /**
+     * Call after editing image pixels or UV array elements in place. Increments
+     * version so the next render refreshes all materials, lights and backgrounds
+     * using this texture. Assigning a new image, UV array, flipY, wrapS, wrapT, colorSpace or
+     * uvChannel is detected automatically.
+     */
+    markUpdated(): this;
+}