@meimu/mutracer 0.0.0-stage → 0.1.1

package/lib/scene/OpenPBRMaterial.js

@@ -0,0 +1,240 @@
+import { materialDefault, applyMaterialParams } from './openPbrSchema.js';
+/**
+ * OpenPBR 1.1 surface material.
+ *
+ * Property names are camelCase OpenPBR inputs plus documented compatibility names
+ * (https://academysoftwarefoundation.github.io/OpenPBR/). Colors are linear
+ * RGB. Length-valued inputs (`transmissionDepth`, `subsurfaceRadius`) use
+ * scene units; `thinFilmThickness` is in micrometres as in OpenPBR.
+ *
+ * ```ts
+ * const gold = new OpenPBRMaterial({
+ *   baseColor: [1.0, 0.78, 0.34], baseMetalness: 1, specularRoughness: 0.2
+ * });
+ * ```
+ *
+ * Edit parameters in place; the next `engine.update()` detects the changes.
+ */
+export default class OpenPBRMaterial {
+    /** 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 shares the existing shading normal. 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 coordinate units. Default `0.1`. */
+    displacementScale = materialDefault('displacementScale');
+    /** Ray-marching step for projective displacement. Default `0.01`. */
+    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';
+}
+export { materialKeys, materialTextureKeys, materialGeometryKeys, materialParamKeys, getMaterialHashKey, resetMaterialTextureId } from './openPbrSchema.js';
+//# sourceMappingURL=OpenPBRMaterial.js.map

package/lib/scene/OpenPBRMaterial.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenPBRMaterial.js","sourceRoot":"","sources":["../../src/scene/OpenPBRMaterial.ts"],"names":[],"mappings":"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","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 shares the existing shading normal. 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 coordinate units. Default `0.1`. */\n  displacementScale: number = materialDefault('displacementScale');\n  /** Ray-marching step for projective displacement. Default `0.01`. */\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"]}

package/lib/scene/RectLight.d.ts

@@ -0,0 +1,31 @@
+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;
+    /** 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;
+        /** Linear RGB color. Default `[1, 1, 1]`. */
+        color?: ColorRGB;
+        /** Emitted radiance multiplier. Default `1`. */
+        intensity?: number;
+        /** Emission texture. Default `undefined`. */
+        texture?: Texture | undefined;
+        /** Angular spread from 0 (collimated) to 1 (hemisphere). Default `1`. */
+        spread?: number;
+    });
+}

package/lib/scene/RectLight.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 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. */
+    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=RectLight.js.map

package/lib/scene/RectLight.js.map

@@ -0,0 +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"]}

package/lib/scene/Scene.d.ts

@@ -0,0 +1,55 @@
+import { ColorRGBA } from '../types.js';
+import AmbientLight from './AmbientLight.js';
+import DirectionalLight from './DirectionalLight.js';
+import EnvironmentLight from './EnvironmentLight.js';
+import Mesh from './Mesh.js';
+import InstancedMesh from './InstancedMesh.js';
+import RectLight from './RectLight.js';
+import SphereLight from './SphereLight.js';
+import SpotLight from './SpotLight.js';
+import Texture from './Texture.js';
+/** Lights with an analytic shape. */
+export type AnalyticLight = RectLight | SphereLight | SpotLight | DirectionalLight;
+/** Any light that can be placed in {@link Scene.lights}. */
+export type SceneLight = AmbientLight | EnvironmentLight | AnalyticLight;
+/**
+ * Environment map projected onto a ground plane and sky dome, so objects
+ * appear to stand on the photographed ground.
+ */
+export interface GroundedSkyboxBackground {
+    /** Ground projection discriminator; always `GroundedSkybox`. */
+    type: 'GroundedSkybox';
+    /** Required equirectangular environment texture. */
+    map: Texture;
+    /** Required capture height above ground in scene units. */
+    height: number;
+    /** Required projected sky-dome radius in scene units. */
+    radius: number;
+    /** Ground plane Y in scene units. Default `0`. */
+    groundHeight?: number;
+    /** Capture X/Z center in scene units. Default `[0, 0]`. */
+    center?: [number, number];
+}
+/**
+ * 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.
+ */
+export type SceneBackground = ColorRGBA | Texture | GroundedSkyboxBackground;
+/**
+ * Everything the renderer draws. A plain object; mesh and light membership,
+ * mesh transforms, material parameters, resource references, light parameters and background
+ * values are detected automatically, including edits within existing arrays.
+ * Call `markUpdated()` on a Geometry after attribute edits, and a Texture
+ * after pixel or UV-array element edits.
+ * InstancedMesh matrix/color elements require markUpdated() or the dedicated
+ * markTransformsUpdated()/markColorsUpdated() notifications.
+ */
+export interface Scene {
+    /** Required mesh instances; use an empty array for an empty scene. */
+    meshes: (Mesh | InstancedMesh)[];
+    /** Required lights; use an empty array for an unlit scene. */
+    lights: SceneLight[];
+    /** Camera-ray background; defaults to the environment light when omitted. */
+    background?: SceneBackground;
+}

package/lib/scene/Scene.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Scene.js.map

package/lib/scene/Scene.js.map

@@ -0,0 +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}\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"]}

package/lib/scene/SceneNode.d.ts

@@ -0,0 +1,16 @@
+import type { Mat4, Vec3 } from '../types.js';
+/** Base class of objects positioned by a local-to-world transform. */
+export default abstract class SceneNode {
+    /** Optional object name. Default empty string. */
+    name: string;
+    /**
+     * Local-to-world transform: column-major 4×4 (gl-matrix layout). Default identity.
+     * Edits, including in-place element edits, are detected on the next render.
+     */
+    transform: Mat4;
+    /** Reads a copy of the translation, or writes it into transform. Default `[0, 0, 0]`. */
+    get position(): Vec3;
+    set position(value: Vec3);
+    /** Points local -Z at target, preserving position and scale. Default up `[0, 1, 0]`. */
+    lookAt(target: Vec3, up?: Vec3): this;
+}

package/lib/scene/SceneNode.js

@@ -0,0 +1,33 @@
+import { mat4 } from '../math.js';
+/** Base class of objects positioned by a local-to-world transform. */
+export default class SceneNode {
+    /** Optional object name. Default empty string. */
+    name = '';
+    /**
+     * Local-to-world transform: column-major 4×4 (gl-matrix layout). Default identity.
+     * Edits, including in-place element edits, are detected on the next render.
+     */
+    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]];
+    }
+    set position(value) {
+        this.transform[12] = value[0];
+        this.transform[13] = value[1];
+        this.transform[14] = 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 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);
+        mat4.scale(this.transform, this.transform, scale);
+        return this;
+    }
+}
+//# sourceMappingURL=SceneNode.js.map

package/lib/scene/SceneNode.js.map

@@ -0,0 +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"]}

package/lib/scene/SphereLight.d.ts

@@ -0,0 +1,22 @@
+import type { ColorRGB } from '../types.js';
+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 SphereLight extends SceneNode {
+    /** Light discriminator. */
+    readonly type: "SphereLight";
+    /** Linear RGB color. Default `[1, 1, 1]`. */
+    color: ColorRGB;
+    /** Emitted radiance multiplier. Default `1`. */
+    intensity: number;
+    /** Emitter radius in scene units; 0 is a point light. Default `1`. */
+    radius: number;
+    /** Creates a light; omitted options retain the field defaults. */
+    constructor(params?: {
+        /** Linear RGB color. Default `[1, 1, 1]`. */
+        color?: ColorRGB;
+        /** Emitted radiance multiplier. Default `1`. */
+        intensity?: number;
+        /** Emitter radius in scene units; 0 is a point light. Default `1`. */
+        radius?: number;
+    });
+}

package/lib/scene/SphereLight.js

@@ -0,0 +1,20 @@
+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 SphereLight extends SceneNode {
+    /** Light discriminator. */
+    type = 'SphereLight';
+    /** Linear RGB color. Default `[1, 1, 1]`. */
+    color = [1, 1, 1];
+    /** Emitted radiance multiplier. Default `1`. */
+    intensity = 1;
+    /** Emitter radius in scene units; 0 is a point light. Default `1`. */
+    radius = 1;
+    /** Creates a light; omitted options retain the field defaults. */
+    constructor(params = {}) {
+        super();
+        this.color = params.color ?? [1, 1, 1];
+        this.intensity = params.intensity ?? 1;
+        this.radius = params.radius ?? 1;
+    }
+}
+//# sourceMappingURL=SphereLight.js.map

package/lib/scene/SphereLight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SphereLight.js","sourceRoot":"","sources":["../../src/scene/SphereLight.ts"],"names":[],"mappings":"AACA,OAAO,SAAS,MAAM,gBAAgB,CAAC;AAEvC,kHAAkH;AAClH,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,SAAS;IAChD,2BAA2B;IAClB,IAAI,GAAG,aAAsB,CAAC;IACvC,6CAA6C;IAC7C,KAAK,GAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5B,gDAAgD;IAChD,SAAS,GAAW,CAAC,CAAC;IACtB,sEAAsE;IACtE,MAAM,GAAW,CAAC,CAAC;IAEnB,kEAAkE;IAClE,YAAY,SAOR,EAAE;QACJ,KAAK,EAAE,CAAC;QACR,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,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;IACnC,CAAC;CACF","sourcesContent":["import type { ColorRGB } from '../types.js';\nimport SceneNode from './SceneNode.js';\n\n/** Analytic light placed with transform; local -Z is the emission direction and local +X is the IES reference. */\nexport default class SphereLight extends SceneNode {\n  /** Light discriminator. */\n  readonly type = 'SphereLight' as const;\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  /** Emitter radius in scene units; 0 is a point light. Default `1`. */\n  radius: number = 1;\n\n  /** Creates a light; omitted options retain the field defaults. */\n  constructor(params: {\n    /** Linear RGB color. Default `[1, 1, 1]`. */\n    color?: ColorRGB;\n    /** Emitted radiance multiplier. Default `1`. */\n    intensity?: number;\n    /** Emitter radius in scene units; 0 is a point light. Default `1`. */\n    radius?: number;\n  } = {}) {\n    super();\n    this.color = params.color ?? [1, 1, 1];\n    this.intensity = params.intensity ?? 1;\n    this.radius = params.radius ?? 1;\n  }\n}\n"]}

package/lib/scene/SpotLight.d.ts

@@ -0,0 +1,35 @@
+import type { ColorRGB } from '../types.js';
+import SceneNode from './SceneNode.js';
+import type IESProfile from './IESProfile.js';
+/** Analytic light placed with transform; local -Z is the emission direction and local +X is the IES reference. */
+export default class SpotLight extends SceneNode {
+    /** Light discriminator. */
+    readonly type: "SpotLight";
+    /** Linear RGB color. Default `[1, 1, 1]`. */
+    color: ColorRGB;
+    /** Axial intensity in candela. Default `1`. */
+    intensity: number;
+    /** Emitter radius in scene units; 0 is a point emitter. Default `0.01`. */
+    radius: number;
+    /** Full-intensity cone half-angle in degrees. Default `30`. */
+    innerAngle: number;
+    /** Cutoff cone half-angle in degrees, at most 180. Default `45`. */
+    outerAngle: number;
+    /** Optional photometric emission profile. Default `undefined`. */
+    iesProfile: IESProfile | undefined;
+    /** Creates a light; omitted options retain the field defaults. */
+    constructor(params?: {
+        /** Linear RGB color. Default `[1, 1, 1]`. */
+        color?: ColorRGB;
+        /** Axial intensity in candela. Default `1`. */
+        intensity?: number;
+        /** Emitter radius in scene units; 0 is a point emitter. Default `0.01`. */
+        radius?: number;
+        /** Full-intensity cone half-angle in degrees. Default `30`. */
+        innerAngle?: number;
+        /** Cutoff cone half-angle in degrees, at most 180. Default `45`. */
+        outerAngle?: number;
+        /** Optional photometric emission profile. Default `undefined`. */
+        iesProfile?: IESProfile | undefined;
+    });
+}

package/lib/scene/SpotLight.js

@@ -0,0 +1,29 @@
+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 SpotLight extends SceneNode {
+    /** Light discriminator. */
+    type = 'SpotLight';
+    /** Linear RGB color. Default `[1, 1, 1]`. */
+    color = [1, 1, 1];
+    /** Axial intensity in candela. Default `1`. */
+    intensity = 1;
+    /** Emitter radius in scene units; 0 is a point emitter. Default `0.01`. */
+    radius = 0.01;
+    /** Full-intensity cone half-angle in degrees. Default `30`. */
+    innerAngle = 30;
+    /** Cutoff cone half-angle in degrees, at most 180. Default `45`. */
+    outerAngle = 45;
+    /** Optional photometric emission profile. Default `undefined`. */
+    iesProfile = undefined;
+    /** Creates a light; omitted options retain the field defaults. */
+    constructor(params = {}) {
+        super();
+        this.color = params.color ?? [1, 1, 1];
+        this.intensity = params.intensity ?? 1;
+        this.radius = params.radius ?? 0.01;
+        this.innerAngle = params.innerAngle ?? 30;
+        this.outerAngle = params.outerAngle ?? 45;
+        this.iesProfile = params.iesProfile ?? undefined;
+    }
+}
+//# sourceMappingURL=SpotLight.js.map

package/lib/scene/SpotLight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpotLight.js","sourceRoot":"","sources":["../../src/scene/SpotLight.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,6CAA6C;IAC7C,KAAK,GAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5B,+CAA+C;IAC/C,SAAS,GAAW,CAAC,CAAC;IACtB,2EAA2E;IAC3E,MAAM,GAAW,IAAI,CAAC;IACtB,+DAA+D;IAC/D,UAAU,GAAW,EAAE,CAAC;IACxB,oEAAoE;IACpE,UAAU,GAAW,EAAE,CAAC;IACxB,kEAAkE;IAClE,UAAU,GAA2B,SAAS,CAAC;IAE/C,kEAAkE;IAClE,YAAY,SAaR,EAAE;QACJ,KAAK,EAAE,CAAC;QACR,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,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC;QACpC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;QAC1C,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;QAC1C,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,SAAS,CAAC;IACnD,CAAC;CACF","sourcesContent":["import type { ColorRGB } from '../types.js';\nimport SceneNode from './SceneNode.js';\nimport type IESProfile from './IESProfile.js';\n\n/** Analytic light placed with transform; local -Z is the emission direction and local +X is the IES reference. */\nexport default class SpotLight extends SceneNode {\n  /** Light discriminator. */\n  readonly type = 'SpotLight' as const;\n  /** Linear RGB color. Default `[1, 1, 1]`. */\n  color: ColorRGB = [1, 1, 1];\n  /** Axial intensity in candela. Default `1`. */\n  intensity: number = 1;\n  /** Emitter radius in scene units; 0 is a point emitter. Default `0.01`. */\n  radius: number = 0.01;\n  /** Full-intensity cone half-angle in degrees. Default `30`. */\n  innerAngle: number = 30;\n  /** Cutoff cone half-angle in degrees, at most 180. Default `45`. */\n  outerAngle: number = 45;\n  /** Optional photometric emission profile. Default `undefined`. */\n  iesProfile: IESProfile | undefined = undefined;\n\n  /** Creates a light; omitted options retain the field defaults. */\n  constructor(params: {\n    /** Linear RGB color. Default `[1, 1, 1]`. */\n    color?: ColorRGB;\n    /** Axial intensity in candela. Default `1`. */\n    intensity?: number;\n    /** Emitter radius in scene units; 0 is a point emitter. Default `0.01`. */\n    radius?: number;\n    /** Full-intensity cone half-angle in degrees. Default `30`. */\n    innerAngle?: number;\n    /** Cutoff cone half-angle in degrees, at most 180. Default `45`. */\n    outerAngle?: number;\n    /** Optional photometric emission profile. Default `undefined`. */\n    iesProfile?: IESProfile | undefined;\n  } = {}) {\n    super();\n    this.color = params.color ?? [1, 1, 1];\n    this.intensity = params.intensity ?? 1;\n    this.radius = params.radius ?? 0.01;\n    this.innerAngle = params.innerAngle ?? 30;\n    this.outerAngle = params.outerAngle ?? 45;\n    this.iesProfile = params.iesProfile ?? undefined;\n  }\n}\n"]}