@meimu/mutracer 0.0.0-stage → 0.1.1

package/lib/scene/Geometry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Geometry.js","sourceRoot":"","sources":["../../src/scene/Geometry.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Vec3 } from '../types.js';\nimport { generateVertexNormals } from '../util/geometry.js';\nimport { vec3 } from '../math.js';\n\ntype AttributeData = Float32Array | Uint16Array | Uint32Array | Int32Array;\nexport class Attribute<T extends AttributeData = AttributeData> {\n  array: T;\n  itemSize: number;\n  constructor(array: T, itemSize: number) {\n    this.array = array;\n    this.itemSize = itemSize;\n  }\n\n  static getItem(attr: Attribute, out: number[], vertexIndex: number) {\n    const array = attr.array;\n    const itemSize = attr.itemSize;\n    const offset = vertexIndex * itemSize;\n    for (let i = 0; i < itemSize; i++) {\n      out[i] = array[offset + i];\n    }\n  }\n\n  static getCount(attr: Attribute) {\n    return attr.array.length / attr.itemSize;\n  }\n}\n\nexport type AttributeName =\n  | 'position'\n  | 'normal'\n  | 'tangent'\n  | 'uv'\n  | 'uv1'\n  | 'color';\nexport const AVAILABLE_ATTRIBUTES: AttributeName[] = [\n  'position',\n  'normal',\n  'tangent',\n  'uv',\n  'uv1',\n  'color'\n];\n\n/** Triangle geometry construction data. */\nexport interface GeometryInit {\n  /** Required vertex positions in scene units, itemSize 3. */\n  position: Attribute<Float32Array>;\n  /** Triangle vertex indices, itemSize 1. Default: sequential indices 0..vertexCount-1. */\n  indices?: Attribute<Uint16Array | Uint32Array>;\n  /** Vertex normals, itemSize 3. Default: generated smooth area-weighted normals. */\n  normal?: Attribute<Float32Array>;\n  /** Vertex tangents (XYZ, optional W handedness). Default undefined. */\n  tangent?: Attribute<Float32Array>;\n  /** Primary UV coordinates. Default undefined. */\n  uv?: Attribute<Float32Array>;\n  /** Secondary UV coordinates. Default undefined. */\n  uv1?: Attribute<Float32Array>;\n  /** Vertex RGB colors. Default undefined. */\n  color?: Attribute<Float32Array>;\n  /** Raw per-vertex material indices, itemSize 1. Default undefined selects material 0. */\n  materialIndex?: Attribute<Int32Array>;\n}\n\n/** Triangle mesh data. Only position is required; missing indices and normals are generated at construction. */\nexport default class Geometry {\n  /** Incremented by either update method. Default `0`. */\n  version = 0;\n  private _topologyVersion = 0;\n  /** Index/material-index revision, advanced by markUpdated(). Default `0`. */\n  get topologyVersion() { return this._topologyVersion; }\n  /**\n   * Hint that vertices change often (skinning, morph targets). Keeps a built-in\n   * BVH2 layout that can be refit in place. Default `false`.\n   */\n  dynamic = false;\n  /** Required vertex positions in scene units; provided by the constructor. */\n  position: Attribute<Float32Array>;\n  /** Vertex normals; supplied or generated at construction. */\n  normal: Attribute<Float32Array>;\n  /** Optional vertex tangents (XYZ, optional W handedness). Default undefined. */\n  tangent?: Attribute<Float32Array>;\n  /** Optional primary texture coordinates. Default undefined. */\n  uv?: Attribute<Float32Array>;\n  /** Optional secondary UV set (glTF TEXCOORD_1 / Three.js uv1). Default undefined. */\n  uv1?: Attribute<Float32Array>;\n  /** Optional vertex RGB colors. Default undefined. */\n  color?: Attribute<Float32Array>;\n  /** Required triangle vertex indices; three entries per triangle. */\n  indices: Attribute<Uint16Array | Uint32Array>;\n  /** Optional per-vertex raw material indices, itemSize 1. All three triangle corners must match. Default undefined selects material 0. */\n  materialIndex?: Attribute<Int32Array>;\n\n  /** Local-space bounds in scene units; initial min/max are `[0, 0, 0]`. */\n  boundingBox: { min: Vec3; max: Vec3 } = {\n    min: vec3.create(),\n    max: vec3.create()\n  };\n  constructor(data: GeometryInit) {\n    this.position = data.position;\n    this.indices = data.indices ?? new Attribute(Uint32Array.from({ length: this.vertexCount }, (_, index) => index), 1);\n    this.normal = data.normal ?? new Attribute(new Float32Array(this.vertexCount * 3), 3);\n    if (!data.normal) generateVertexNormals(this);\n\n    this.tangent = data.tangent;\n    this.uv = data.uv;\n    this.uv1 = data.uv1;\n    this.color = data.color;\n    this.materialIndex = data.materialIndex;\n  }\n\n  /**\n   * Call after index/material-index edits or a general geometry update.\n   * Advances version and topologyVersion to request topology processing and\n   * BVH rebuilding. For vertex-only edits with unchanged indices\n   * and materialIndex, use markVerticesUpdated() to allow refitting instead.\n   * Neither notification recalculates normals or tangents.\n   * Replacing a mesh's Geometry object is detected without this call.\n   */\n  markUpdated() {\n    this._topologyVersion++;\n    this.version++;\n    return this;\n  }\n\n  /**\n   * Call after editing vertex attributes without changing indices or materialIndex.\n   * Advances version while preserving topologyVersion, allowing vertex-only uploads.\n   * With stable arrays, lengths and item sizes, the next render refits supported\n   * BVHs or rebuilds when needed. Changed storage or displacement still requires\n   * full scene data preparation. Does not recalculate normals or tangents.\n   */\n  markVerticesUpdated() {\n    this.version++;\n    return this;\n  }\n\n  /** Returns the number of vertices in the position attribute. */\n  get vertexCount() {\n    return this.position.array.length / this.position.itemSize;\n  }\n\n  /** Number of triangles in the index attribute. */\n  get triangleCount() {\n    return this.indices.array.length / 3;\n  }\n\n\n\n\n}\n"]}

package/lib/scene/IESProfile.d.ts

@@ -0,0 +1,19 @@
+export declare class IESParseError extends Error {
+    constructor(message: string, profileName?: string);
+}
+export default class IESProfile {
+    readonly name: string;
+    readonly verticalAngles: number[];
+    readonly horizontalAngles: number[];
+    readonly candelaValues: number[];
+    readonly peakCandela: number;
+    readonly data: Float32Array;
+    readonly type: "IESProfile";
+    readonly size = 128;
+    constructor(name: string, verticalAngles: number[], horizontalAngles: number[], candelaValues: number[], peakCandela: number, data: Float32Array);
+    /** Bilinear LM-63 candela lookup, normalized so the source peak is exactly 1. */
+    evaluateAngles(verticalDegrees: number, horizontalDegrees: number): number;
+    /** CPU reference for the manual bilinear lookup used by the WebGL/WGSL paths. */
+    sampleBaked(verticalRadians: number, horizontalRadians: number, rotationRadians?: number): number;
+}
+export declare function parseIESProfile(source: string, profileName?: string): IESProfile;

package/lib/scene/IESProfile.js

@@ -0,0 +1,165 @@
+const BAKED_SIZE = 128;
+export class IESParseError extends Error {
+    constructor(message, profileName = 'IES profile') {
+        super(`${profileName}: ${message}`);
+        this.name = 'IESParseError';
+    }
+}
+function angleIndex(angle, angles) {
+    if (angles.length === 1 || angle <= angles[0])
+        return 0;
+    const last = angles.length - 1;
+    if (angle >= angles[last])
+        return last;
+    for (let i = 1; i <= last; i++) {
+        if (angle <= angles[i]) {
+            return i - 1 + (angle - angles[i - 1]) / (angles[i] - angles[i - 1]);
+        }
+    }
+    return last;
+}
+function lerp(a, b, t) {
+    return a + (b - a) * t;
+}
+export default class IESProfile {
+    name;
+    verticalAngles;
+    horizontalAngles;
+    candelaValues;
+    peakCandela;
+    data;
+    type = 'IESProfile';
+    size = BAKED_SIZE;
+    constructor(name, verticalAngles, horizontalAngles, candelaValues, peakCandela, data) {
+        this.name = name;
+        this.verticalAngles = verticalAngles;
+        this.horizontalAngles = horizontalAngles;
+        this.candelaValues = candelaValues;
+        this.peakCandela = peakCandela;
+        this.data = data;
+    }
+    /** Bilinear LM-63 candela lookup, normalized so the source peak is exactly 1. */
+    evaluateAngles(verticalDegrees, horizontalDegrees) {
+        if (verticalDegrees > this.verticalAngles[this.verticalAngles.length - 1]) {
+            return 0;
+        }
+        let horizontal = horizontalDegrees;
+        const lastHorizontal = this.horizontalAngles[this.horizontalAngles.length - 1];
+        if (lastHorizontal <= 180) {
+            horizontal = Math.abs(horizontal);
+            if (lastHorizontal === 90 && horizontal > 90) {
+                horizontal = 180 - horizontal;
+            }
+        }
+        else if (horizontal < 0) {
+            horizontal += 360;
+        }
+        const v = angleIndex(verticalDegrees, this.verticalAngles);
+        const h = angleIndex(horizontal, this.horizontalAngles);
+        const v0 = Math.floor(v);
+        const v1 = Math.ceil(v);
+        const h0 = Math.floor(h);
+        const h1 = Math.ceil(h);
+        const vf = v - v0;
+        const hf = h - h0;
+        const n = this.verticalAngles.length;
+        const a = this.candelaValues[h0 * n + v0];
+        const b = this.candelaValues[h0 * n + v1];
+        const c = this.candelaValues[h1 * n + v0];
+        const d = this.candelaValues[h1 * n + v1];
+        return lerp(lerp(a, b, vf), lerp(c, d, vf), hf) / this.peakCandela;
+    }
+    /** CPU reference for the manual bilinear lookup used by the WebGL/WGSL paths. */
+    sampleBaked(verticalRadians, horizontalRadians, rotationRadians = 0) {
+        const u = verticalRadians / Math.PI;
+        const v = (horizontalRadians - rotationRadians) / (2 * Math.PI) + 0.5;
+        const px = u * BAKED_SIZE - 0.5;
+        const py = v * BAKED_SIZE - 0.5;
+        const x0 = Math.floor(px);
+        const y0 = Math.floor(py);
+        const fx = px - x0;
+        const fy = py - y0;
+        const wrap = (value) => ((value % BAKED_SIZE) + BAKED_SIZE) % BAKED_SIZE;
+        const at = (x, y) => this.data[wrap(y) * BAKED_SIZE + wrap(x)];
+        return lerp(lerp(at(x0, y0), at(x0 + 1, y0), fx), lerp(at(x0, y0 + 1), at(x0 + 1, y0 + 1), fx), fy);
+    }
+}
+const SUPPORTED_HEADERS = [
+    'IESNA:LM-63-1986',
+    'IESNA:LM-63-1991',
+    'IESNA91',
+    'IESNA:LM-63-1995',
+    'IESNA:LM-63-2002',
+    'ERCO Leuchten'
+];
+export function parseIESProfile(source, profileName = 'IES profile') {
+    const lines = source.replace(/\r/g, '').split('\n');
+    const header = lines[0]?.trim();
+    if (!SUPPORTED_HEADERS.includes(header)) {
+        throw new IESParseError(`unsupported LM-63 header "${header || '<empty>'}"`, profileName);
+    }
+    const tiltIndex = lines.findIndex((line) => line.trim().startsWith('TILT='));
+    if (tiltIndex < 0)
+        throw new IESParseError('missing TILT record', profileName);
+    if (lines[tiltIndex].trim() !== 'TILT=NONE') {
+        throw new IESParseError('only TILT=NONE is supported', profileName);
+    }
+    const tokens = lines
+        .slice(tiltIndex + 1)
+        .join(' ')
+        .trim()
+        .split(/[\s,]+/)
+        .filter(Boolean);
+    const values = tokens.map((token) => Number(token));
+    const invalid = values.findIndex((value) => !Number.isFinite(value));
+    if (invalid >= 0) {
+        throw new IESParseError(`invalid numeric token "${tokens[invalid]}"`, profileName);
+    }
+    if (values.length < 13) {
+        throw new IESParseError('incomplete numeric header', profileName);
+    }
+    const verticalCount = values[3];
+    const horizontalCount = values[4];
+    if (!Number.isInteger(verticalCount) ||
+        verticalCount < 1 ||
+        !Number.isInteger(horizontalCount) ||
+        horizontalCount < 1) {
+        throw new IESParseError('angle counts must be positive integers', profileName);
+    }
+    if (values[5] !== 1) {
+        throw new IESParseError('only Type C photometry is supported', profileName);
+    }
+    const expected = 13 + verticalCount + horizontalCount + verticalCount * horizontalCount;
+    if (values.length !== expected) {
+        throw new IESParseError(`numeric data size is ${values.length}, expected ${expected}`, profileName);
+    }
+    const verticalAngles = values.slice(13, 13 + verticalCount);
+    const horizontalAngles = values.slice(13 + verticalCount, 13 + verticalCount + horizontalCount);
+    const candelaValues = values.slice(13 + verticalCount + horizontalCount);
+    const validateAngles = (angles, label, max) => {
+        if (angles.some((v, i) => v < 0 || v > max || (i > 0 && v <= angles[i - 1]))) {
+            throw new IESParseError(`${label} angles must be finite, strictly increasing, and within 0..${max}`, profileName);
+        }
+    };
+    validateAngles(verticalAngles, 'vertical', 180);
+    validateAngles(horizontalAngles, 'horizontal', 360);
+    if (verticalAngles[0] !== 0 || horizontalAngles[0] !== 0) {
+        throw new IESParseError('Type C angle tables must begin at 0 degrees', profileName);
+    }
+    if (candelaValues.some((v) => v < 0)) {
+        throw new IESParseError('candela values must be non-negative', profileName);
+    }
+    const peakCandela = Math.max(...candelaValues);
+    if (!(peakCandela > 0)) {
+        throw new IESParseError('candela peak must be greater than zero', profileName);
+    }
+    const profile = new IESProfile(profileName, verticalAngles, horizontalAngles, candelaValues, peakCandela, new Float32Array(BAKED_SIZE * BAKED_SIZE));
+    for (let y = 0; y < BAKED_SIZE; y++) {
+        const horizontal = (y * 360) / BAKED_SIZE - 180;
+        for (let x = 0; x < BAKED_SIZE; x++) {
+            profile.data[y * BAKED_SIZE + x] = profile.evaluateAngles((x * 180) / BAKED_SIZE, horizontal);
+        }
+    }
+    return profile;
+}
+//# sourceMappingURL=IESProfile.js.map

package/lib/scene/IESProfile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IESProfile.js","sourceRoot":"","sources":["../../src/scene/IESProfile.ts"],"names":[],"mappings":"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","sourcesContent":["const BAKED_SIZE = 128;\n\nexport class IESParseError extends Error {\n  constructor(message: string, profileName = 'IES profile') {\n    super(`${profileName}: ${message}`);\n    this.name = 'IESParseError';\n  }\n}\n\nfunction angleIndex(angle: number, angles: number[]) {\n  if (angles.length === 1 || angle <= angles[0]) return 0;\n  const last = angles.length - 1;\n  if (angle >= angles[last]) return last;\n  for (let i = 1; i <= last; i++) {\n    if (angle <= angles[i]) {\n      return i - 1 + (angle - angles[i - 1]) / (angles[i] - angles[i - 1]);\n    }\n  }\n  return last;\n}\n\nfunction lerp(a: number, b: number, t: number) {\n  return a + (b - a) * t;\n}\n\nexport default class IESProfile {\n  readonly type = 'IESProfile' as const;\n  readonly size = BAKED_SIZE;\n\n  constructor(\n    readonly name: string,\n    readonly verticalAngles: number[],\n    readonly horizontalAngles: number[],\n    readonly candelaValues: number[],\n    readonly peakCandela: number,\n    readonly data: Float32Array\n  ) {}\n\n  /** Bilinear LM-63 candela lookup, normalized so the source peak is exactly 1. */\n  evaluateAngles(verticalDegrees: number, horizontalDegrees: number) {\n    if (verticalDegrees > this.verticalAngles[this.verticalAngles.length - 1]) {\n      return 0;\n    }\n    let horizontal = horizontalDegrees;\n    const lastHorizontal =\n      this.horizontalAngles[this.horizontalAngles.length - 1];\n    if (lastHorizontal <= 180) {\n      horizontal = Math.abs(horizontal);\n      if (lastHorizontal === 90 && horizontal > 90) {\n        horizontal = 180 - horizontal;\n      }\n    } else if (horizontal < 0) {\n      horizontal += 360;\n    }\n    const v = angleIndex(verticalDegrees, this.verticalAngles);\n    const h = angleIndex(horizontal, this.horizontalAngles);\n    const v0 = Math.floor(v);\n    const v1 = Math.ceil(v);\n    const h0 = Math.floor(h);\n    const h1 = Math.ceil(h);\n    const vf = v - v0;\n    const hf = h - h0;\n    const n = this.verticalAngles.length;\n    const a = this.candelaValues[h0 * n + v0];\n    const b = this.candelaValues[h0 * n + v1];\n    const c = this.candelaValues[h1 * n + v0];\n    const d = this.candelaValues[h1 * n + v1];\n    return lerp(lerp(a, b, vf), lerp(c, d, vf), hf) / this.peakCandela;\n  }\n\n  /** CPU reference for the manual bilinear lookup used by the WebGL/WGSL paths. */\n  sampleBaked(\n    verticalRadians: number,\n    horizontalRadians: number,\n    rotationRadians = 0\n  ) {\n    const u = verticalRadians / Math.PI;\n    const v = (horizontalRadians - rotationRadians) / (2 * Math.PI) + 0.5;\n    const px = u * BAKED_SIZE - 0.5;\n    const py = v * BAKED_SIZE - 0.5;\n    const x0 = Math.floor(px);\n    const y0 = Math.floor(py);\n    const fx = px - x0;\n    const fy = py - y0;\n    const wrap = (value: number) =>\n      ((value % BAKED_SIZE) + BAKED_SIZE) % BAKED_SIZE;\n    const at = (x: number, y: number) =>\n      this.data[wrap(y) * BAKED_SIZE + wrap(x)];\n    return lerp(\n      lerp(at(x0, y0), at(x0 + 1, y0), fx),\n      lerp(at(x0, y0 + 1), at(x0 + 1, y0 + 1), fx),\n      fy\n    );\n  }\n}\n\nconst SUPPORTED_HEADERS = [\n  'IESNA:LM-63-1986',\n  'IESNA:LM-63-1991',\n  'IESNA91',\n  'IESNA:LM-63-1995',\n  'IESNA:LM-63-2002',\n  'ERCO Leuchten'\n];\n\nexport function parseIESProfile(source: string, profileName = 'IES profile') {\n  const lines = source.replace(/\\r/g, '').split('\\n');\n  const header = lines[0]?.trim();\n  if (!SUPPORTED_HEADERS.includes(header)) {\n    throw new IESParseError(\n      `unsupported LM-63 header \"${header || '<empty>'}\"`,\n      profileName\n    );\n  }\n  const tiltIndex = lines.findIndex((line) => line.trim().startsWith('TILT='));\n  if (tiltIndex < 0) throw new IESParseError('missing TILT record', profileName);\n  if (lines[tiltIndex].trim() !== 'TILT=NONE') {\n    throw new IESParseError('only TILT=NONE is supported', profileName);\n  }\n  const tokens = lines\n    .slice(tiltIndex + 1)\n    .join(' ')\n    .trim()\n    .split(/[\\s,]+/)\n    .filter(Boolean);\n  const values = tokens.map((token) => Number(token));\n  const invalid = values.findIndex((value) => !Number.isFinite(value));\n  if (invalid >= 0) {\n    throw new IESParseError(\n      `invalid numeric token \"${tokens[invalid]}\"`,\n      profileName\n    );\n  }\n  if (values.length < 13) {\n    throw new IESParseError('incomplete numeric header', profileName);\n  }\n  const verticalCount = values[3];\n  const horizontalCount = values[4];\n  if (\n    !Number.isInteger(verticalCount) ||\n    verticalCount < 1 ||\n    !Number.isInteger(horizontalCount) ||\n    horizontalCount < 1\n  ) {\n    throw new IESParseError('angle counts must be positive integers', profileName);\n  }\n  if (values[5] !== 1) {\n    throw new IESParseError('only Type C photometry is supported', profileName);\n  }\n  const expected =\n    13 + verticalCount + horizontalCount + verticalCount * horizontalCount;\n  if (values.length !== expected) {\n    throw new IESParseError(\n      `numeric data size is ${values.length}, expected ${expected}`,\n      profileName\n    );\n  }\n  const verticalAngles = values.slice(13, 13 + verticalCount);\n  const horizontalAngles = values.slice(\n    13 + verticalCount,\n    13 + verticalCount + horizontalCount\n  );\n  const candelaValues = values.slice(13 + verticalCount + horizontalCount);\n  const validateAngles = (angles: number[], label: string, max: number) => {\n    if (\n      angles.some(\n        (v, i) => v < 0 || v > max || (i > 0 && v <= angles[i - 1])\n      )\n    ) {\n      throw new IESParseError(\n        `${label} angles must be finite, strictly increasing, and within 0..${max}`,\n        profileName\n      );\n    }\n  };\n  validateAngles(verticalAngles, 'vertical', 180);\n  validateAngles(horizontalAngles, 'horizontal', 360);\n  if (verticalAngles[0] !== 0 || horizontalAngles[0] !== 0) {\n    throw new IESParseError(\n      'Type C angle tables must begin at 0 degrees',\n      profileName\n    );\n  }\n  if (candelaValues.some((v) => v < 0)) {\n    throw new IESParseError('candela values must be non-negative', profileName);\n  }\n  const peakCandela = Math.max(...candelaValues);\n  if (!(peakCandela > 0)) {\n    throw new IESParseError(\n      'candela peak must be greater than zero',\n      profileName\n    );\n  }\n\n  const profile = new IESProfile(\n    profileName,\n    verticalAngles,\n    horizontalAngles,\n    candelaValues,\n    peakCandela,\n    new Float32Array(BAKED_SIZE * BAKED_SIZE)\n  );\n  for (let y = 0; y < BAKED_SIZE; y++) {\n    const horizontal = (y * 360) / BAKED_SIZE - 180;\n    for (let x = 0; x < BAKED_SIZE; x++) {\n      profile.data[y * BAKED_SIZE + x] = profile.evaluateAngles(\n        (x * 180) / BAKED_SIZE,\n        horizontal\n      );\n    }\n  }\n  return profile;\n}\n"]}

package/lib/scene/InstancedMesh.d.ts

@@ -0,0 +1,43 @@
+import Mesh from './Mesh.js';
+import Geometry from './Geometry.js';
+import OpenPBRMaterial from './OpenPBRMaterial.js';
+/** Options for a batch sharing geometry and materials. */
+export interface InstancedMeshOptions {
+    /** Required active instance count; a nonnegative integer. */
+    count: number;
+    /** Column-major local matrices, at least 16 * count floats. Default: count identity matrices. The array is retained. */
+    transforms?: Float32Array;
+    /** Linear RGB multipliers, at least 3 * count floats. Default undefined (white). The array is retained. */
+    colors?: Float32Array;
+}
+/** A batch of instances. World matrices are transform * transforms[i]. */
+export default class InstancedMesh extends Mesh {
+    /** Local column-major matrices. Default: count identities. Call markTransformsUpdated after element edits. */
+    transforms: Float32Array;
+    /** Active prefix length. Default: constructor count; must fit transforms and colors. Changes are detected by engine.update. */
+    count: number;
+    /** Linear RGB multipliers, 3 floats per instance. Default undefined (white). Call markColorsUpdated after element edits. */
+    colors: Float32Array | undefined;
+    /** Advanced by any update notification. Default 0. */
+    get version(): number;
+    private _version;
+    private _transformVersion;
+    private _colorVersion;
+    constructor(geometry: Geometry, material: OpenPBRMaterial | OpenPBRMaterial[], options: InstancedMeshOptions);
+    /**
+     * Notify edits to both local matrices and colors for all active instances.
+     * Advances version once. Does not notify geometry or material edits. Returns this.
+     * Use the dedicated methods for single-property edits to avoid unnecessary work.
+     */
+    markUpdated(): this;
+    /**
+     * Notify edited local matrices, avoiding copies of unchanged colors.
+     * Defaults: start 0, count all active matrices from start. Returns this.
+     */
+    markTransformsUpdated(start?: number, count?: number): this;
+    /**
+     * Notify edited colors without copying matrices or updating BVHs.
+     * Defaults: start 0, count all active instances from start. Returns this.
+     */
+    markColorsUpdated(start?: number, count?: number): this;
+}

package/lib/scene/InstancedMesh.js

@@ -0,0 +1,79 @@
+import Mesh from './Mesh.js';
+/** A batch of instances. World matrices are transform * transforms[i]. */
+export default class InstancedMesh extends Mesh {
+    /** Local column-major matrices. Default: count identities. Call markTransformsUpdated after element edits. */
+    transforms;
+    /** Active prefix length. Default: constructor count; must fit transforms and colors. Changes are detected by engine.update. */
+    count;
+    /** Linear RGB multipliers, 3 floats per instance. Default undefined (white). Call markColorsUpdated after element edits. */
+    colors;
+    /** Advanced by any update notification. Default 0. */
+    get version() { return this._version; }
+    _version = 0;
+    _transformVersion = 0;
+    _colorVersion = 0;
+    /** @internal */
+    get transformsVersion() { return this._transformVersion; }
+    /** @internal */
+    get colorsVersion() { return this._colorVersion; }
+    constructor(geometry, material, options) {
+        super(geometry, material);
+        this.count = options.count;
+        this.transforms = options.transforms ?? new Float32Array(this.count * 16);
+        this.colors = options.colors;
+        this.validate();
+        if (!options.transforms)
+            for (let i = 0; i < this.count; i++) {
+                const offset = i * 16;
+                this.transforms[offset] = this.transforms[offset + 5] = this.transforms[offset + 10] = this.transforms[offset + 15] = 1;
+            }
+    }
+    /**
+     * Notify edits to both local matrices and colors for all active instances.
+     * Advances version once. Does not notify geometry or material edits. Returns this.
+     * Use the dedicated methods for single-property edits to avoid unnecessary work.
+     */
+    markUpdated() {
+        this.validate();
+        this._transformVersion++;
+        this._colorVersion++;
+        this._version++;
+        return this;
+    }
+    /**
+     * Notify edited local matrices, avoiding copies of unchanged colors.
+     * Defaults: start 0, count all active matrices from start. Returns this.
+     */
+    markTransformsUpdated(start = 0, count = this.count - start) {
+        this.validate();
+        if (!Number.isInteger(start) || !Number.isInteger(count) || start < 0 || count < 0 || start + count > this.count) {
+            throw new RangeError('Instance transform range must fit the active count.');
+        }
+        this._transformVersion++;
+        this._version++;
+        return this;
+    }
+    /**
+     * Notify edited colors without copying matrices or updating BVHs.
+     * Defaults: start 0, count all active instances from start. Returns this.
+     */
+    markColorsUpdated(start = 0, count = this.count - start) {
+        this.validate();
+        if (!Number.isInteger(start) || !Number.isInteger(count) || start < 0 || count < 0 || start + count > this.count) {
+            throw new RangeError('Instance color range must fit the active count.');
+        }
+        this._colorVersion++;
+        this._version++;
+        return this;
+    }
+    /** @internal */
+    validate() {
+        if (!Number.isInteger(this.count) || this.count < 0 || !(this.transforms instanceof Float32Array) || this.transforms.length < this.count * 16) {
+            throw new RangeError('InstancedMesh requires a nonnegative count and at least 16 * count Float32 transforms.');
+        }
+        if (this.colors !== undefined && (!(this.colors instanceof Float32Array) || this.colors.length < this.count * 3)) {
+            throw new RangeError('InstancedMesh colors must contain at least 3 * count Float32 values.');
+        }
+    }
+}
+//# sourceMappingURL=InstancedMesh.js.map

package/lib/scene/InstancedMesh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InstancedMesh.js","sourceRoot":"","sources":["../../src/scene/InstancedMesh.ts"],"names":[],"mappings":"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","sourcesContent":["import Mesh from './Mesh.js';\nimport Geometry from './Geometry.js';\nimport OpenPBRMaterial from './OpenPBRMaterial.js';\n\n/** Options for a batch sharing geometry and materials. */\nexport interface InstancedMeshOptions {\n  /** Required active instance count; a nonnegative integer. */\n  count: number;\n  /** Column-major local matrices, at least 16 * count floats. Default: count identity matrices. The array is retained. */\n  transforms?: Float32Array;\n  /** Linear RGB multipliers, at least 3 * count floats. Default undefined (white). The array is retained. */\n  colors?: Float32Array;\n}\n\n/** A batch of instances. World matrices are transform * transforms[i]. */\nexport default class InstancedMesh extends Mesh {\n  /** Local column-major matrices. Default: count identities. Call markTransformsUpdated after element edits. */\n  transforms: Float32Array;\n  /** Active prefix length. Default: constructor count; must fit transforms and colors. Changes are detected by engine.update. */\n  count: number;\n  /** Linear RGB multipliers, 3 floats per instance. Default undefined (white). Call markColorsUpdated after element edits. */\n  colors: Float32Array | undefined;\n  /** Advanced by any update notification. Default 0. */\n  get version(): number { return this._version; }\n  private _version = 0;\n  private _transformVersion = 0;\n  private _colorVersion = 0;\n  /** @internal */\n  get transformsVersion(): number { return this._transformVersion; }\n  /** @internal */\n  get colorsVersion(): number { return this._colorVersion; }\n\n  constructor(geometry: Geometry, material: OpenPBRMaterial | OpenPBRMaterial[], options: InstancedMeshOptions) {\n    super(geometry, material);\n    this.count = options.count;\n    this.transforms = options.transforms ?? new Float32Array(this.count * 16);\n    this.colors = options.colors;\n    this.validate();\n    if (!options.transforms) for (let i = 0; i < this.count; i++) {\n      const offset = i * 16;\n      this.transforms[offset] = this.transforms[offset + 5] = this.transforms[offset + 10] = this.transforms[offset + 15] = 1;\n    }\n  }\n  /**\n   * Notify edits to both local matrices and colors for all active instances.\n   * Advances version once. Does not notify geometry or material edits. Returns this.\n   * Use the dedicated methods for single-property edits to avoid unnecessary work.\n   */\n  markUpdated(): this {\n    this.validate();\n    this._transformVersion++; this._colorVersion++; this._version++;\n    return this;\n  }\n  /**\n   * Notify edited local matrices, avoiding copies of unchanged colors.\n   * Defaults: start 0, count all active matrices from start. Returns this.\n   */\n  markTransformsUpdated(start = 0, count = this.count - start): this {\n    this.validate();\n    if (!Number.isInteger(start) || !Number.isInteger(count) || start < 0 || count < 0 || start + count > this.count) {\n      throw new RangeError('Instance transform range must fit the active count.');\n    }\n    this._transformVersion++; this._version++;\n    return this;\n  }\n  /**\n   * Notify edited colors without copying matrices or updating BVHs.\n   * Defaults: start 0, count all active instances from start. Returns this.\n   */\n  markColorsUpdated(start = 0, count = this.count - start): this {\n    this.validate();\n    if (!Number.isInteger(start) || !Number.isInteger(count) || start < 0 || count < 0 || start + count > this.count) {\n      throw new RangeError('Instance color range must fit the active count.');\n    }\n    this._colorVersion++; this._version++;\n    return this;\n  }\n  /** @internal */\n  validate() {\n    if (!Number.isInteger(this.count) || this.count < 0 || !(this.transforms instanceof Float32Array) || this.transforms.length < this.count * 16) {\n      throw new RangeError('InstancedMesh requires a nonnegative count and at least 16 * count Float32 transforms.');\n    }\n    if (this.colors !== undefined && (!(this.colors instanceof Float32Array) || this.colors.length < this.count * 3)) {\n      throw new RangeError('InstancedMesh colors must contain at least 3 * count Float32 values.');\n    }\n  }\n}\n"]}

package/lib/scene/Mesh.d.ts

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

package/lib/scene/Mesh.js

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

package/lib/scene/Mesh.js.map

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

package/lib/scene/OpenPBRMaterial.d.ts

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