@babylonjs/lite-compat 1.11.0-preview → 1.13.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/index.d.ts CHANGED
@@ -100,7 +100,15 @@ export declare abstract class AbstractAudioOutNode extends AbstractNamedAudioNod
100
100
  setVolume(value: number, options?: Partial<IAudioParameterRampOptions> | null): void;
101
101
  dispose(): void;
102
102
 
103
- export declare abstract class AbstractEngine {
104
103
  protected readonly _canvas: RenderCanvas;
104
+ export declare abstract class AbstractEngine {
105
+ /**
106
+ * Babylon.js `AbstractEngine.Version` — reports the underlying Babylon Lite
107
+ * runtime version (the build-time-resolved `VERSION` exported by
108
+ * `@babylonjs/lite`), not the upstream `@babylonjs/core` release it targets.
109
+ */
110
+ static get Version(): string;
111
+ /** Babylon.js `AbstractEngine.NpmPackage` — the npm package + version string. */
112
+ static get NpmPackage(): string;
105
113
  protected readonly _canvas: RenderCanvas;
106
114
  private readonly _options;
107
115
  protected readonly _scenes: Scene[];
108
116
  protected readonly _loopCallbacks: Array<() => void>;
@@ -1345,8 +1353,6 @@ export declare class DeviceOrientationCamera {
1345
1353
 
1346
1354
  export declare class DirectionalLight extends Light {
1347
1355
  constructor(name: string, direction: Vector3, scene?: Scene);
1348
1356
  getClassName(): string;
1349
- get intensity(): number;
1350
- set intensity(value: number);
1351
1357
  get direction(): Vector3;
1352
1358
  set direction(value: Vector3);
1353
1359
  get position(): Vector3;
@@ -1787,8 +1793,6 @@ export declare class HDRCubeTexture {
1787
1793
 
1788
1794
  export declare class HemisphericLight extends Light {
1789
1795
  constructor(name: string, direction: Vector3, scene?: Scene);
1790
1796
  getClassName(): string;
1791
- get intensity(): number;
1792
- set intensity(value: number);
1793
1797
  get direction(): Vector3;
1794
1798
  set direction(value: Vector3);
1795
1799
  get diffuse(): Color3;
@@ -2135,9 +2139,19 @@ export declare class Layer {
2135
2139
 
2136
2140
  /** Babylon.js `Light` — base class for all lights (derives from `Node`). */
2137
2141
  export declare abstract class Light extends Node_2 {
2138
2142
  protected constructor(name: string, scene?: Scene);
2139
- getClassName(): string;
2140
- abstract get intensity(): number;
2141
- abstract set intensity(value: number);
2143
+ getClassName(): string;
2142
2144
  /**
2145
+ * Babylon.js `light.intensity`. While the light is disabled the Lite light
2146
+ * carries `0`, but the getter still returns the logical value the caller set.
2147
+ */
2148
+ get intensity(): number;
2149
+ set intensity(value: number);
2150
+ /**
2151
+ * Babylon.js `light.setEnabled(false)` — toggle the light's contribution.
2152
+ * Babylon Lite has no per-light enable flag, so a disabled light is expressed
2153
+ * by zeroing its intensity in the shared lights UBO (and restoring it on
2154
+ * re-enable). The logical intensity value is preserved across the toggle.
2155
+ */
2156
+ setEnabled(value: boolean): void;
2143
2157
  /** Detach this light's shadow generator (compat for `light.shadowEnabled = false`). */
2144
2158
  set shadowEnabled(enabled: boolean);
2145
2159
  dispose(): void;
@@ -2896,8 +2910,6 @@ export declare class PointerDragBehavior {
2896
2910
 
2897
2911
  export declare class PointLight extends Light {
2898
2912
  constructor(name: string, position: Vector3, scene?: Scene);
2899
2913
  getClassName(): string;
2900
- get intensity(): number;
2901
- set intensity(value: number);
2902
2914
  get range(): number;
2903
2915
  set range(value: number);
2904
2916
  get position(): Vector3;
@@ -3550,8 +3562,6 @@ declare interface SphereOptions {
3550
3562
 
3551
3563
  export declare class SpotLight extends Light {
3552
3564
  constructor(name: string, position: Vector3, direction: Vector3, angle: number, exponent: number, scene?: Scene);
3553
3565
  getClassName(): string;
3554
- get intensity(): number;
3555
- set intensity(value: number);
3556
3566
  get angle(): number;
3557
3567
  set angle(value: number);
3558
3568
  get exponent(): number;
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, a as Mesh, T as TransformNode, l as liteBackedVector3, B as BoundingInfo, Q as Quaternion } from "./meshes-CPZtn6G5.js";
5
5
  import { A, b, c, C, d, e, f, g, h, i, G, I, j, k, m, n, o, t, p } from "./meshes-CPZtn6G5.js";
6
- import { createEngine, onBeforeRender, stopEngine, resizeEngine, setEngineSize, disposeEngine, registerSceneWithShadowSupport, registerScene, startEngine, createNullEngine, stepScene, setPhysicsTimestep, setPhysicsGravity, disposePhysics, createHavokWorld, createArcRotateCamera, attachControl, getCameraPosition, getViewMatrix, getProjectionMatrix, createGeospatialCamera, setGeospatialOrientation, attachGeospatialControls, createFreeCamera, attachFreeControl, markMaterialUboDirty, createPbrMaterial, createSolidTexture2D, createStandardMaterial, 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, createTexture2DFromPixels, updateTexture2DFromPixels, createTexture3DFromPixels, loadBasisTexture2D, loadKtxTexture2D, loadTexture2D, getContainerMeshes, 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 } from "@babylonjs/lite";
6
+ import { VERSION, createEngine, onBeforeRender, stopEngine, resizeEngine, setEngineSize, disposeEngine, registerSceneWithShadowSupport, registerScene, startEngine, createNullEngine, stepScene, setPhysicsTimestep, setPhysicsGravity, disposePhysics, createHavokWorld, createArcRotateCamera, attachControl, getCameraPosition, getViewMatrix, getProjectionMatrix, createGeospatialCamera, setGeospatialOrientation, attachGeospatialControls, createFreeCamera, attachFreeControl, markMaterialUboDirty, createPbrMaterial, createSolidTexture2D, createStandardMaterial, 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, createTexture2DFromPixels, updateTexture2DFromPixels, createTexture3DFromPixels, loadBasisTexture2D, loadKtxTexture2D, loadTexture2D, getContainerMeshes, 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 } from "@babylonjs/lite";
7
7
  class Color3 {
8
8
  constructor(r = 0, g2 = 0, b2 = 0) {
9
9
  this.r = r;
@@ -533,6 +533,18 @@ class AbstractEngine {
533
533
  }
534
534
  this._options = opts;
535
535
  }
536
+ /**
537
+ * Babylon.js `AbstractEngine.Version` — reports the underlying Babylon Lite
538
+ * runtime version (the build-time-resolved `VERSION` exported by
539
+ * `@babylonjs/lite`), not the upstream `@babylonjs/core` release it targets.
540
+ */
541
+ static get Version() {
542
+ return VERSION;
543
+ }
544
+ /** Babylon.js `AbstractEngine.NpmPackage` — the npm package + version string. */
545
+ static get NpmPackage() {
546
+ return `@babylonjs/lite-compat@${this.Version}`;
547
+ }
536
548
  /** Acquire the GPU device and build the Lite engine context. */
537
549
  async initAsync() {
538
550
  if (this._initialized) {
@@ -3012,11 +3024,74 @@ let Scene = _Scene;
3012
3024
  class Light extends Node {
3013
3025
  constructor(name, scene) {
3014
3026
  super(name, scene);
3027
+ /**
3028
+ * @internal When the light is disabled via {@link setEnabled}, its Lite
3029
+ * intensity is forced to `0` (zero contribution) and the caller-visible
3030
+ * intensity is parked here so {@link intensity} keeps reporting the real
3031
+ * value and re-enabling restores it. `null` means the light is enabled.
3032
+ */
3033
+ __publicField(this, "_disabledIntensity", null);
3034
+ /**
3035
+ * @internal Lazily-resolved bump for the underlying Lite light's
3036
+ * `_lightVersion` (see {@link ensureLightVersionBump}). Cached after first use.
3037
+ */
3038
+ __publicField(this, "_liteVersionBump", null);
3015
3039
  scene == null ? void 0 : scene._registerLight(this);
3016
3040
  }
3017
3041
  getClassName() {
3018
3042
  return "Light";
3019
3043
  }
3044
+ /** @internal Typed accessor for the Lite light's `intensity` scalar. */
3045
+ get _liteIntensity() {
3046
+ return this._lite.intensity;
3047
+ }
3048
+ set _liteIntensity(value) {
3049
+ this._lite.intensity = value;
3050
+ this._bumpLiteVersion();
3051
+ }
3052
+ /**
3053
+ * @internal Advance the underlying Lite light's `_lightVersion`. Lite's shared
3054
+ * lights-UBO refresh is gated on the sum of every light's `_lightVersion`, and
3055
+ * factory lights only bump it on observable direction/position writes — never on
3056
+ * scalar `intensity` writes. Since these wrappers mutate `intensity` directly
3057
+ * (both `intensity` and `setEnabled`), this makes those writes reach the GPU.
3058
+ */
3059
+ _bumpLiteVersion() {
3060
+ this._liteVersionBump ?? (this._liteVersionBump = ensureLightVersionBump(this._lite));
3061
+ this._liteVersionBump();
3062
+ }
3063
+ /**
3064
+ * Babylon.js `light.intensity`. While the light is disabled the Lite light
3065
+ * carries `0`, but the getter still returns the logical value the caller set.
3066
+ */
3067
+ get intensity() {
3068
+ return this._disabledIntensity ?? this._liteIntensity;
3069
+ }
3070
+ set intensity(value) {
3071
+ if (this._disabledIntensity !== null) {
3072
+ this._disabledIntensity = value;
3073
+ } else {
3074
+ this._liteIntensity = value;
3075
+ }
3076
+ }
3077
+ /**
3078
+ * Babylon.js `light.setEnabled(false)` — toggle the light's contribution.
3079
+ * Babylon Lite has no per-light enable flag, so a disabled light is expressed
3080
+ * by zeroing its intensity in the shared lights UBO (and restoring it on
3081
+ * re-enable). The logical intensity value is preserved across the toggle.
3082
+ */
3083
+ setEnabled(value) {
3084
+ if (value !== this.isEnabled()) {
3085
+ if (!value) {
3086
+ this._disabledIntensity = this._liteIntensity;
3087
+ this._liteIntensity = 0;
3088
+ } else if (this._disabledIntensity !== null) {
3089
+ this._liteIntensity = this._disabledIntensity;
3090
+ this._disabledIntensity = null;
3091
+ }
3092
+ }
3093
+ super.setEnabled(value);
3094
+ }
3020
3095
  /** Detach this light's shadow generator (compat for `light.shadowEnabled = false`). */
3021
3096
  set shadowEnabled(enabled) {
3022
3097
  if (!enabled) {
@@ -3028,6 +3103,31 @@ class Light extends Node {
3028
3103
  super.dispose();
3029
3104
  }
3030
3105
  }
3106
+ function ensureLightVersionBump(lite) {
3107
+ var _a;
3108
+ const existing = lite._bumpLightVersion;
3109
+ if (existing) {
3110
+ return existing;
3111
+ }
3112
+ const baseGet = (_a = Object.getOwnPropertyDescriptor(lite, "_lightVersion")) == null ? void 0 : _a.get;
3113
+ let extra = 0;
3114
+ Object.defineProperty(lite, "_lightVersion", {
3115
+ get() {
3116
+ return (baseGet ? baseGet.call(lite) : 0) + extra;
3117
+ },
3118
+ enumerable: false,
3119
+ configurable: true
3120
+ });
3121
+ const bump = () => {
3122
+ extra++;
3123
+ };
3124
+ Object.defineProperty(lite, "_bumpLightVersion", {
3125
+ value: bump,
3126
+ enumerable: false,
3127
+ configurable: true
3128
+ });
3129
+ return bump;
3130
+ }
3031
3131
  function readColor(tuple) {
3032
3132
  return new Color3(tuple[0], tuple[1], tuple[2]);
3033
3133
  }
@@ -3052,12 +3152,6 @@ class HemisphericLight extends Light {
3052
3152
  getClassName() {
3053
3153
  return "HemisphericLight";
3054
3154
  }
3055
- get intensity() {
3056
- return this._lite.intensity;
3057
- }
3058
- set intensity(value) {
3059
- this._lite.intensity = value;
3060
- }
3061
3155
  get direction() {
3062
3156
  return readVector(this._lite.direction);
3063
3157
  }
@@ -3096,12 +3190,6 @@ class DirectionalLight extends Light {
3096
3190
  getClassName() {
3097
3191
  return "DirectionalLight";
3098
3192
  }
3099
- get intensity() {
3100
- return this._lite.intensity;
3101
- }
3102
- set intensity(value) {
3103
- this._lite.intensity = value;
3104
- }
3105
3193
  get direction() {
3106
3194
  return readVector(this._lite.direction);
3107
3195
  }
@@ -3140,12 +3228,6 @@ class PointLight extends Light {
3140
3228
  getClassName() {
3141
3229
  return "PointLight";
3142
3230
  }
3143
- get intensity() {
3144
- return this._lite.intensity;
3145
- }
3146
- set intensity(value) {
3147
- this._lite.intensity = value;
3148
- }
3149
3231
  get range() {
3150
3232
  return this._lite.range;
3151
3233
  }
@@ -3184,12 +3266,6 @@ class SpotLight extends Light {
3184
3266
  getClassName() {
3185
3267
  return "SpotLight";
3186
3268
  }
3187
- get intensity() {
3188
- return this._lite.intensity;
3189
- }
3190
- set intensity(value) {
3191
- this._lite.intensity = value;
3192
- }
3193
3269
  get angle() {
3194
3270
  return this._lite.angle;
3195
3271
  }