@babylonjs/lite-compat 1.20.0-preview → 1.21.0-preview

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -121,7 +121,7 @@ overloads within a supported area may still be absent.
121
121
  | Engine (`WebGPUEngine`, `Engine`, `ThinEngine`, `NullEngine`) | ⚡ | async startup + render loop; `beginFrame`/`endFrame`, MSAA/alpha-to-coverage (`currentSampleCount`/`get`/`setAlphaToCoverage`), and manual `scene.render()` unsupported |
122
122
  | Scene (clear color, cameras/lights, fog, environment, observables, ready state) | ⚡ | sync `scene.pick` unsupported (use async `GPUPicker`); `scene.meshes` + `getMeshBy*`/`getNodeBy*` now enumerate every mesh via a canonical wrapper registry |
123
123
  | Cameras (`ArcRotateCamera`, `FreeCamera`/`Universal`/`Target`, `FollowCamera`, `GeospatialCamera`) | ✅ | XR / device-orientation / stereoscopic rigs unsupported |
124
- | Lights (`Hemispheric`, `Directional`, `Point`, `Spot`) | ✅ | `RectAreaLight` / clustered lights unsupported |
124
+ | Lights (`Hemispheric`, `Directional`, `Point`, `Spot`) | ✅ | `ClusteredLightContainer` clusters point lights (⚡ partial); `RectAreaLight` unsupported |
125
125
  | Shadows (`ShadowGenerator` directional ESM/PCF, spot PCF) | ⚡ | `CascadedShadowGenerator` falls back to single cascade |
126
126
  | Meshes & geometry (class chain, `MeshBuilder` primitives, transforms, thin instances, `clone`, `VertexData`, `Mesh.MergeMeshes`) | ⚡ | `CreateLines`/`CreateLineSystem` support fixed-topology line lists and RGBA point colors; `CreateDashedLines` supports uniform-color dashed line lists; `MergeMeshes` bakes positions/normals/UVs and rejects unsupported attributes/animation; `CreateDecal`/`CreateText`/`CreateTiledBox`/`CreateTiledPlane`, `GreasedLine*` (thick lines), `InstancedMesh`, LOD/edges/outline, hardware instances unsupported |
127
127
  | CSG / CSG2 | ✅ | over Lite boolean ops |
package/index.d.ts CHANGED
@@ -1179,8 +1179,62 @@ export declare class CircleEase extends EasingFunction {
1179
1179
  easeInCore(gradient: number): number;
1180
1180
  }
1181
1181
 
1182
- export declare class ClusteredLightContainer {
1183
- constructor();
1182
+ /**
1183
+ * Babylon.js `ClusteredLightContainer` — a `Light` that renders a large set of
1184
+ * point lights through a clustered / forward+ system.
1185
+ */
1186
+ export declare class ClusteredLightContainer extends Light {
1184
1187
  private _maxRange;
1188
+ private _selfIntensity;
1189
+ /**
1190
+ * True if a point/spot light can be clustered by this container. Babylon Lite
1191
+ * clusters point lights only.
1192
+ */
1193
+ static IsLightSupported(light: Light): boolean;
1194
+ /**
1195
+ * Creates a new clustered light container.
1196
+ *
1197
+ * @param name - The container's node name.
1198
+ * @param lights - Initial lights to cluster (point lights).
1199
+ * @param scene - Owning scene; when supplied the container is registered and
1200
+ * built into the Lite scene at engine start.
1201
+ */
1202
+ constructor(name: string, lights?: Light[], scene?: Scene);
1203
+ getClassName(): string;
1204
+ /** Babylon.js `light.getTypeID()` — `LIGHTTYPEID_CLUSTERED_CONTAINER`. */
1205
+ getTypeID(): number;
1206
+ /** True when clustered lighting is available (Babylon Lite backs it on WebGPU). */
1207
+ get isSupported(): boolean;
1208
+ /** The lights added to this clustering system. */
1209
+ get lights(): readonly Light[];
1210
+ /** Number of cluster tiles across the screen horizontally (default `64`). */
1211
+ get horizontalTiles(): number;
1212
+ set horizontalTiles(value: number);
1213
+ /** Number of cluster tiles across the screen vertically (default `64`). */
1214
+ get verticalTiles(): number;
1215
+ set verticalTiles(value: number);
1216
+ /** Number of depth slices used to bin lights along view-space Z (default `16`). */
1217
+ get depthSlices(): number;
1218
+ set depthSlices(value: number);
1219
+ /**
1220
+ * Upper bound applied to clustered light ranges. Babylon Lite manages range
1221
+ * binning internally, so this is stored for API-shape parity and does not
1222
+ * re-cluster the lights.
1223
+ */
1224
+ get maxRange(): number;
1225
+ set maxRange(value: number);
1226
+ /** Babylon.js `container.addLight(light)`. Only point lights are clustered. */
1227
+ addLight(light: Light): void;
1228
+ /**
1229
+ * Babylon.js `container.removeLight(light)`. Returns the index the light held
1230
+ * in the container's light list, or `-1` if it was not present.
1231
+ */
1232
+ removeLight(light: Light): number;
1185
1233
  /** Container-level intensity (Babylon.js inherits it from `Light`; each child light carries its own). */
1234
+ get intensity(): number;
1235
+ set intensity(value: number);
1236
+ /** Clustered lights do not cast shadows in Babylon.js; the toggle is a no-op. */
1237
+ set shadowEnabled(_enabled: boolean);
1238
+ protected _onEffectiveEnabledStateChanged(_enabled: boolean): void;
1239
+ dispose(): void;
1186
1240
  }
1187
1241
 
1188
1242
  /**
package/index.js CHANGED
@@ -3,7 +3,7 @@ var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { en
3
3
  var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
4
4
  import { V as Vector3, u as unsupported, L as LiteCompatError, N as Node, M as Matrix, C as Color3, S as StandardMaterial, a as Color4, b as Mesh, T as TransformNode, l as liteBackedVector3, Q as Quaternion } from "./meshes-eNVvq5sm.js";
5
5
  import { A, B, c, d, e, f, g, h, i, j, k, m, n, o, p, q, G, I, r, s, t, P, v, w, x, y, z, D, E, F, H, J, K, O, R } from "./meshes-eNVvq5sm.js";
6
- import { VERSION, createEngine, onBeforeRender, stopEngine, resizeEngine, setEngineSize, disposeEngine, uploadImageToArrayLayer, enableMirroredMeshes, registerSceneWithShadowSupport, registerScene, startEngine, createNullEngine, stepScene, setPhysicsTimestep, setPhysicsGravity, disposePhysics, createHavokWorld, createArcRotateCamera, attachControl, getCameraPosition, getViewMatrix, getProjectionMatrix, createGeospatialCamera, setGeospatialOrientation, attachGeospatialControls, createFreeCamera, attachFreeControl, setAnimationAdditive, playAnimation, pauseAnimation, goToFrame, stopAnimation, createSceneContext, updateAnimationManager, setFog, setClipPlane, loadHdrEnvironment, loadDdsEnvironment, loadEnvironment, createDefaultCamera, addToScene, createHemisphericLight, createAnimationManager, enableAnimationBlending, addAnimationGroup, disposeScene, createDirectionalLight, createPointLight, createSpotLight, createCsgFromMesh, csgSubtract, csgIntersect, csgUnion, createMeshFromCsg, createCsg2FromMesh, csg2Subtract, csg2Intersect, csg2Add, createMeshesFromCsg2, disposeCsg2, initializeCsg2Async, createMorphTargets, setMorphTargetWeights, createTransformNode, bakeCurrentTransformIntoVertices, loadSOG, loadSPZ, loadSplat, createDynamicTexture, updateDynamicTexture, createTexture2DFromPixels, updateTexture2DFromPixels, createTexture3DFromPixels, loadBasisTexture2D, loadKtxTexture2D, loadTexture2D, createTexture2DArrayFromUrls, createTexture2DArrayFromKtx2, loadImageToArrayLayer, createTexture2DArray, createTexture2DArrayFromPixels, updateTexture2DArrayFromPixels, loadBabylon, loadGltf, resetVariant, getVariantNames, selectVariant, disposePicker, createGpuPicker, pickAsync, createAxisDragGizmo, attachAxisDragGizmoToNode, disposeAxisDragGizmo, createAxisScaleGizmo, attachAxisScaleGizmoToNode, disposeAxisScaleGizmo, createBoundingBoxGizmo, attachBoundingBoxGizmoToNode, disposeBoundingBoxGizmo, createCameraGizmo, attachCameraGizmoToCamera, disposeCameraGizmo, createLightGizmo, attachLightGizmoToLight, disposeLightGizmo, createPlaneDragGizmo, attachPlaneDragGizmoToNode, disposePlaneDragGizmo, createPlaneRotationGizmo, attachPlaneRotationGizmoToNode, disposePlaneRotationGizmo, createPositionGizmo, setPositionGizmoLocalCoordinates, attachPositionGizmoToNode, disposePositionGizmo, createRotationGizmo, setRotationGizmoLocalCoordinates, attachRotationGizmoToNode, disposeRotationGizmo, createScaleGizmo, setScaleGizmoLocalCoordinates, attachScaleGizmoToNode, disposeScaleGizmo, createUtilityLayer, registerUtilityLayer, disposeUtilityLayer, addBillboardSpriteIndex, updateBillboardSpriteIndex, loadSpriteAtlas, createFacingBillboardSystem, addFacingBillboardSystem, billboardBlendAdditive, billboardBlendAlpha, spriteBlendPremultiplied, spriteBlendAdditive, spriteBlendAlpha, createSprite2DLayer, addSprite2DIndex, createSpriteRenderer, registerSpriteRenderer, updateSprite2DIndex, createPcfSpotlightShadowGenerator, createPcfDirectionalShadowGenerator, createEsmDirectionalShadowGenerator, setShadowTaskCasterMeshes, parseNodeMaterialFromSnippet, createGridMaterial, getByteFrequencyData, getFloatFrequencyData, getByteTimeDomainData, getFloatTimeDomainData, enableAnalyzer, setSpatialPosition, setSpatialOrientation, enableSpatial, setSpatialListenerPosition, setSpatialListener, updateSpatialAudio, enableStereo, setStereoPan, disposeAudioBus, setBusVolume, getMasterVolume, setMasterVolume, unlockAudioEngineAsync, createSoundAsync, createSoundBufferAsync, createStreamingSoundAsync, createAudioBusAsync, createSoundSourceAsync, createMicrophoneSoundSourceAsync, disposeAudioEngine, createAudioEngineAsync, disposeSoundSource, setSoundSourceVolume, playSound, pauseSound, resumeSound, stopSound, disposeSound, setSoundVolume, playStreamingSound, pauseStreamingSound, resumeStreamingSound, stopStreamingSound, preloadStreamingInstanceAsync, preloadStreamingInstancesAsync, disposeStreamingSound, setStreamingSoundVolume, startParticleSystem, animateParticleSystem, stopParticleSystem, createParticleBillboard, syncParticleBillboard, parseNodeParticleSetFromSnippet, registerNodeParticleSet } from "@babylonjs/lite";
6
+ import { VERSION, createEngine, onBeforeRender, stopEngine, resizeEngine, setEngineSize, disposeEngine, uploadImageToArrayLayer, enableMirroredMeshes, registerSceneWithShadowSupport, registerScene, startEngine, createNullEngine, stepScene, setPhysicsTimestep, setPhysicsGravity, disposePhysics, createHavokWorld, createArcRotateCamera, attachControl, getCameraPosition, getViewMatrix, getProjectionMatrix, createGeospatialCamera, setGeospatialOrientation, attachGeospatialControls, createFreeCamera, attachFreeControl, setAnimationAdditive, playAnimation, pauseAnimation, goToFrame, stopAnimation, createSceneContext, updateAnimationManager, setFog, setClipPlane, loadHdrEnvironment, loadDdsEnvironment, loadEnvironment, createDefaultCamera, addToScene, createHemisphericLight, createAnimationManager, enableAnimationBlending, addAnimationGroup, disposeScene, createDirectionalLight, createPointLight, createSpotLight, createClusteredLightContainer, createClusteredPointLight, removeFromScene, addClusteredLightContainer, markClusteredLightContainerDirty, createCsgFromMesh, csgSubtract, csgIntersect, csgUnion, createMeshFromCsg, createCsg2FromMesh, csg2Subtract, csg2Intersect, csg2Add, createMeshesFromCsg2, disposeCsg2, initializeCsg2Async, createMorphTargets, setMorphTargetWeights, createTransformNode, bakeCurrentTransformIntoVertices, loadSOG, loadSPZ, loadSplat, createDynamicTexture, updateDynamicTexture, createTexture2DFromPixels, updateTexture2DFromPixels, createTexture3DFromPixels, loadBasisTexture2D, loadKtxTexture2D, loadTexture2D, createTexture2DArrayFromUrls, createTexture2DArrayFromKtx2, loadImageToArrayLayer, createTexture2DArray, createTexture2DArrayFromPixels, updateTexture2DArrayFromPixels, loadBabylon, loadGltf, resetVariant, getVariantNames, selectVariant, disposePicker, createGpuPicker, pickAsync, createAxisDragGizmo, attachAxisDragGizmoToNode, disposeAxisDragGizmo, createAxisScaleGizmo, attachAxisScaleGizmoToNode, disposeAxisScaleGizmo, createBoundingBoxGizmo, attachBoundingBoxGizmoToNode, disposeBoundingBoxGizmo, createCameraGizmo, attachCameraGizmoToCamera, disposeCameraGizmo, createLightGizmo, attachLightGizmoToLight, disposeLightGizmo, createPlaneDragGizmo, attachPlaneDragGizmoToNode, disposePlaneDragGizmo, createPlaneRotationGizmo, attachPlaneRotationGizmoToNode, disposePlaneRotationGizmo, createPositionGizmo, setPositionGizmoLocalCoordinates, attachPositionGizmoToNode, disposePositionGizmo, createRotationGizmo, setRotationGizmoLocalCoordinates, attachRotationGizmoToNode, disposeRotationGizmo, createScaleGizmo, setScaleGizmoLocalCoordinates, attachScaleGizmoToNode, disposeScaleGizmo, createUtilityLayer, registerUtilityLayer, disposeUtilityLayer, addBillboardSpriteIndex, updateBillboardSpriteIndex, loadSpriteAtlas, createFacingBillboardSystem, addFacingBillboardSystem, billboardBlendAdditive, billboardBlendAlpha, spriteBlendPremultiplied, spriteBlendAdditive, spriteBlendAlpha, createSprite2DLayer, addSprite2DIndex, createSpriteRenderer, registerSpriteRenderer, updateSprite2DIndex, createPcfSpotlightShadowGenerator, createPcfDirectionalShadowGenerator, createEsmDirectionalShadowGenerator, setShadowTaskCasterMeshes, parseNodeMaterialFromSnippet, createGridMaterial, getByteFrequencyData, getFloatFrequencyData, getByteTimeDomainData, getFloatTimeDomainData, enableAnalyzer, setSpatialPosition, setSpatialOrientation, enableSpatial, setSpatialListenerPosition, setSpatialListener, updateSpatialAudio, enableStereo, setStereoPan, disposeAudioBus, setBusVolume, getMasterVolume, setMasterVolume, unlockAudioEngineAsync, createSoundAsync, createSoundBufferAsync, createStreamingSoundAsync, createAudioBusAsync, createSoundSourceAsync, createMicrophoneSoundSourceAsync, disposeAudioEngine, createAudioEngineAsync, disposeSoundSource, setSoundSourceVolume, playSound, pauseSound, resumeSound, stopSound, disposeSound, setSoundVolume, playStreamingSound, pauseStreamingSound, resumeStreamingSound, stopStreamingSound, preloadStreamingInstanceAsync, preloadStreamingInstancesAsync, disposeStreamingSound, setStreamingSoundVolume, startParticleSystem, animateParticleSystem, stopParticleSystem, createParticleBillboard, syncParticleBillboard, parseNodeParticleSetFromSnippet, registerNodeParticleSet } from "@babylonjs/lite";
7
7
  const Epsilon = 1e-3;
8
8
  const ToRadians = Math.PI / 180;
9
9
  const ToDegrees = 180 / Math.PI;
@@ -879,6 +879,7 @@ class AbstractEngine {
879
879
  scene._bakeGroundUvs();
880
880
  scene._flushPendingAdds();
881
881
  scene._buildMorphTargets();
882
+ scene._buildClusteredContainers();
882
883
  await scene._loadPendingEnvironment();
883
884
  await enableMirroredMeshes(scene._lite);
884
885
  if (scene._hasShadows()) {
@@ -2144,6 +2145,8 @@ const _Scene = class _Scene extends AbstractScene {
2144
2145
  __publicField(this, "_nodeMaterials", []);
2145
2146
  /** Babylon.js `scene.uniqueId` — a process-unique numeric id. */
2146
2147
  __publicField(this, "uniqueId", ++_Scene._uidCounter);
2148
+ /** @internal Clustered light containers to register on the Lite scene at engine start. */
2149
+ __publicField(this, "_pendingClusteredContainers", []);
2147
2150
  /** Babylon.js `scene.performancePriority` — accepted for parity; Babylon Lite tunes its own pipeline. */
2148
2151
  __publicField(this, "performancePriority", 0);
2149
2152
  /**
@@ -2318,6 +2321,33 @@ const _Scene = class _Scene extends AbstractScene {
2318
2321
  }
2319
2322
  this._pendingMorphBuilds.length = 0;
2320
2323
  }
2324
+ /** @internal Register a compat `ClusteredLightContainer` to be wired into the scene at engine start. */
2325
+ _registerClusteredLightContainer(container) {
2326
+ this._pendingClusteredContainers.push(container);
2327
+ }
2328
+ /** @internal Drop a container from the pending list (it was disposed before engine start). */
2329
+ _unregisterClusteredLightContainer(container) {
2330
+ const i2 = this._pendingClusteredContainers.indexOf(container);
2331
+ if (i2 !== -1) {
2332
+ this._pendingClusteredContainers.splice(i2, 1);
2333
+ }
2334
+ }
2335
+ /**
2336
+ * @internal Register all clustered light containers on the Lite scene. Called by
2337
+ * the engine after meshes/materials are settled (clustered wiring reads the
2338
+ * scene's materials) and before `registerScene`. Containers disposed before this
2339
+ * point are skipped — registering one would build GPU state for an object the
2340
+ * caller has already thrown away. The list is drained up front so a container
2341
+ * disposed while another builds cannot perturb the iteration.
2342
+ */
2343
+ _buildClusteredContainers() {
2344
+ const containers = this._pendingClusteredContainers.splice(0);
2345
+ for (const container of containers) {
2346
+ if (!container.isDisposed()) {
2347
+ container._build();
2348
+ }
2349
+ }
2350
+ }
2321
2351
  /** @internal Whether any shadow generator is present (engine uses shadow-aware registration). */
2322
2352
  _hasShadows() {
2323
2353
  return this._shadowGenerators.length > 0;
@@ -2790,6 +2820,14 @@ let Scene = _Scene;
2790
2820
  class Light extends Node {
2791
2821
  constructor(name, scene) {
2792
2822
  super(name, scene);
2823
+ /**
2824
+ * @internal The {@link ClusteredLightContainer} that owns this light, if any.
2825
+ * Babylon.js moves a light out of the normal light path when it is added to a
2826
+ * clustered container; this back-link mirrors BJS's `light._clusteredContainer`
2827
+ * so a light cannot be added to two containers. Typed loosely to avoid a cycle
2828
+ * with the container module.
2829
+ */
2830
+ __publicField(this, "_clusteredContainer", null);
2793
2831
  /**
2794
2832
  * @internal When the light is effectively disabled, its Lite intensity is
2795
2833
  * forced to `0` (zero contribution) and the caller-visible intensity is
@@ -3069,6 +3107,198 @@ class SpotLight extends Light {
3069
3107
  writeColor(this._lite.specular, value);
3070
3108
  }
3071
3109
  }
3110
+ const LIGHTTYPEID_CLUSTERED_CONTAINER = 5;
3111
+ class ClusteredLightContainer extends Light {
3112
+ /**
3113
+ * Creates a new clustered light container.
3114
+ *
3115
+ * @param name - The container's node name.
3116
+ * @param lights - Initial lights to cluster (point lights).
3117
+ * @param scene - Owning scene; when supplied the container is registered and
3118
+ * built into the Lite scene at engine start.
3119
+ */
3120
+ constructor(name, lights = [], scene) {
3121
+ super(name, scene);
3122
+ /**
3123
+ * @internal The underlying Babylon Lite clustered light container. The base
3124
+ * `Light._lite` is typed as `LightBase`, but a clustered container is a distinct
3125
+ * Lite object (not a punctual light); every base member that dereferences `_lite`
3126
+ * as a light is overridden below, so the value is only ever read back through
3127
+ * {@link _container}.
3128
+ */
3129
+ __publicField(this, "_lite");
3130
+ /** @internal Point lights added to this container (Babylon.js `container.lights`). */
3131
+ __publicField(this, "_childLights", []);
3132
+ /** @internal Lite clustered point lights, parallel to {@link _childLights}. */
3133
+ __publicField(this, "_liteLights", []);
3134
+ /** @internal Whether the container has been registered on the Lite scene (engine start). */
3135
+ __publicField(this, "_built", false);
3136
+ __publicField(this, "_maxRange", 16383);
3137
+ __publicField(this, "_selfIntensity", 1);
3138
+ this._lite = createClusteredLightContainer();
3139
+ if (scene) {
3140
+ scene._registerClusteredLightContainer(this);
3141
+ }
3142
+ for (const light of lights) {
3143
+ this.addLight(light);
3144
+ }
3145
+ }
3146
+ /** @internal Typed handle to the Lite clustered container held in {@link _lite}. */
3147
+ get _container() {
3148
+ return this._lite;
3149
+ }
3150
+ /**
3151
+ * True if a point/spot light can be clustered by this container. Babylon Lite
3152
+ * clusters point lights only.
3153
+ */
3154
+ static IsLightSupported(light) {
3155
+ return light instanceof PointLight;
3156
+ }
3157
+ getClassName() {
3158
+ return "ClusteredLightContainer";
3159
+ }
3160
+ /** Babylon.js `light.getTypeID()` — `LIGHTTYPEID_CLUSTERED_CONTAINER`. */
3161
+ getTypeID() {
3162
+ return LIGHTTYPEID_CLUSTERED_CONTAINER;
3163
+ }
3164
+ /** True when clustered lighting is available (Babylon Lite backs it on WebGPU). */
3165
+ get isSupported() {
3166
+ return true;
3167
+ }
3168
+ /** The lights added to this clustering system. */
3169
+ get lights() {
3170
+ return this._childLights;
3171
+ }
3172
+ /** Number of cluster tiles across the screen horizontally (default `64`). */
3173
+ get horizontalTiles() {
3174
+ return this._container.horizontalTiles;
3175
+ }
3176
+ set horizontalTiles(value) {
3177
+ this._container.horizontalTiles = value;
3178
+ this._markDirty();
3179
+ }
3180
+ /** Number of cluster tiles across the screen vertically (default `64`). */
3181
+ get verticalTiles() {
3182
+ return this._container.verticalTiles;
3183
+ }
3184
+ set verticalTiles(value) {
3185
+ this._container.verticalTiles = value;
3186
+ this._markDirty();
3187
+ }
3188
+ /** Number of depth slices used to bin lights along view-space Z (default `16`). */
3189
+ get depthSlices() {
3190
+ return this._container.zSlices;
3191
+ }
3192
+ set depthSlices(value) {
3193
+ this._container.zSlices = value;
3194
+ this._markDirty();
3195
+ }
3196
+ /**
3197
+ * Upper bound applied to clustered light ranges. Babylon Lite manages range
3198
+ * binning internally, so this is stored for API-shape parity and does not
3199
+ * re-cluster the lights.
3200
+ */
3201
+ get maxRange() {
3202
+ return this._maxRange;
3203
+ }
3204
+ set maxRange(value) {
3205
+ this._maxRange = value;
3206
+ }
3207
+ /** Babylon.js `container.addLight(light)`. Only point lights are clustered. */
3208
+ addLight(light) {
3209
+ if (!ClusteredLightContainer.IsLightSupported(light) || light._clusteredContainer) {
3210
+ return;
3211
+ }
3212
+ const point = light;
3213
+ light._clusteredContainer = this;
3214
+ const pos = point.position;
3215
+ const diffuse = point.diffuse;
3216
+ const liteLight = createClusteredPointLight(this._container, {
3217
+ position: [pos.x, pos.y, pos.z],
3218
+ diffuse: [diffuse.r, diffuse.g, diffuse.b],
3219
+ range: point.range,
3220
+ intensity: point.intensity
3221
+ });
3222
+ this._childLights.push(point);
3223
+ this._liteLights.push(liteLight);
3224
+ const lightScene = point.getScene();
3225
+ if (lightScene) {
3226
+ lightScene._unregisterNode(point);
3227
+ removeFromScene(lightScene._lite, point._lite);
3228
+ }
3229
+ this._markDirty();
3230
+ }
3231
+ /**
3232
+ * Babylon.js `container.removeLight(light)`. Returns the index the light held
3233
+ * in the container's light list, or `-1` if it was not present.
3234
+ */
3235
+ removeLight(light) {
3236
+ const index = this._childLights.indexOf(light);
3237
+ if (index === -1) {
3238
+ return -1;
3239
+ }
3240
+ this._childLights.splice(index, 1);
3241
+ const liteLight = this._liteLights.splice(index, 1)[0];
3242
+ const pool = this._container.pointLights;
3243
+ const j2 = liteLight ? pool.indexOf(liteLight) : -1;
3244
+ if (j2 !== -1) {
3245
+ pool.splice(j2, 1);
3246
+ }
3247
+ light._clusteredContainer = null;
3248
+ const point = light;
3249
+ const lightScene = point.getScene();
3250
+ if (lightScene) {
3251
+ lightScene._registerLight(point);
3252
+ addToScene(lightScene._lite, point._lite);
3253
+ }
3254
+ this._markDirty();
3255
+ return index;
3256
+ }
3257
+ /**
3258
+ * @internal Register the container on the Lite scene, wiring its clustered
3259
+ * lights into the scene's PBR materials. Deferred to engine start so meshes and
3260
+ * materials are settled; skipped on the device-less `NullEngine` and after
3261
+ * disposal. `_built` only flips once registration actually happened, so a skipped
3262
+ * build leaves the container re-buildable and keeps {@link _markDirty} from
3263
+ * touching GPU state that was never created.
3264
+ */
3265
+ _build() {
3266
+ if (this._built || this.isDisposed()) {
3267
+ return;
3268
+ }
3269
+ const scene = this._scene;
3270
+ if (!scene || scene.getEngine()._headless) {
3271
+ return;
3272
+ }
3273
+ this._built = true;
3274
+ addClusteredLightContainer(scene._lite, this._container);
3275
+ }
3276
+ /** @internal Force a GPU re-upload of the clustered light set on the next frame (post-build). */
3277
+ _markDirty() {
3278
+ if (this._built) {
3279
+ markClusteredLightContainerDirty(this._container);
3280
+ }
3281
+ }
3282
+ // ─── Base `Light` members overridden: a clustered container is not a punctual
3283
+ // Lite light, so intensity/shadow/enable/dispose must not touch `_lite`. ───
3284
+ /** Container-level intensity (Babylon.js inherits it from `Light`; each child light carries its own). */
3285
+ get intensity() {
3286
+ return this._selfIntensity;
3287
+ }
3288
+ set intensity(value) {
3289
+ this._selfIntensity = value;
3290
+ }
3291
+ /** Clustered lights do not cast shadows in Babylon.js; the toggle is a no-op. */
3292
+ set shadowEnabled(_enabled) {
3293
+ }
3294
+ _onEffectiveEnabledStateChanged(_enabled) {
3295
+ }
3296
+ dispose() {
3297
+ var _a;
3298
+ (_a = this._scene) == null ? void 0 : _a._unregisterClusteredLightContainer(this);
3299
+ super.dispose();
3300
+ }
3301
+ }
3072
3302
  function deferAddCsgMesh(mesh, scene, material) {
3073
3303
  scene._deferAdd(() => {
3074
3304
  const engine = scene.getEngine()._lite;
@@ -7026,11 +7256,6 @@ class RectAreaLight {
7026
7256
  unsupported("RectAreaLight", "Area lights are not implemented in Babylon Lite. Use Point/Spot/Directional/Hemispheric lights.");
7027
7257
  }
7028
7258
  }
7029
- class ClusteredLightContainer {
7030
- constructor() {
7031
- unsupported("ClusteredLightContainer", "Clustered lighting is not exposed by the Babylon Lite public API; the compat layer cannot wrap it.");
7032
- }
7033
- }
7034
7259
  class GPUParticleSystem {
7035
7260
  constructor() {
7036
7261
  unsupported(