@babylonjs/lite-compat 1.2.0-preview → 1.5.0-preview

package/README.md

@@ -108,52 +108,52 @@ overloads within a supported area may still be absent.
 
 | Status | Meaning                                                                 |
 | ------ | ----------------------------------------------------------------------- |
-| ✅      | Common surface implemented and tested where possible                    |
-| ⚡      | A practical subset works; some properties/overloads are absent or throw |
-| ❌      | Not supported on the current Lite API (throws `LiteCompatError`)        |
+| ✅     | Common surface implemented and tested where possible                    |
+| ⚡     | A practical subset works; some properties/overloads are absent or throw |
+| ❌     | Not supported on the current Lite API (throws `LiteCompatError`)        |
 
 ### `@babylonjs/core`
 
 | Feature area                                                                                            | Status | Notes                                                                                                    |
 | ------------------------------------------------------------------------------------------------------- | :----: | -------------------------------------------------------------------------------------------------------- |
-| Math (`Vector*`, `Color*`, `Quaternion`, `Matrix`, `Plane`, `Ray`, `Frustum`, `Scalar`, `Axis`/`Space`) |   ✅    | `Angle` / `Curve3` / `Path3D` partial                                                                    |
-| Engine (`WebGPUEngine`, `Engine`, `ThinEngine`, `NullEngine`)                                           |   ⚡    | async startup + render loop; `beginFrame`/`endFrame` and manual `scene.render()` unsupported             |
-| Scene (clear color, cameras/lights, fog, environment, observables, ready state)                         |   ⚡    | sync `scene.pick` unsupported (use async `GPUPicker`); some scene enumeration needs Lite core            |
-| Cameras (`ArcRotateCamera`, `FreeCamera`/`Universal`/`Target`, `FollowCamera`, `GeospatialCamera`)      |   ✅    | XR / device-orientation / stereoscopic rigs unsupported                                                  |
-| Lights (`Hemispheric`, `Directional`, `Point`, `Spot`)                                                  |   ✅    | `RectAreaLight` / clustered lights unsupported                                                           |
-| Shadows (`ShadowGenerator` directional ESM/PCF, spot PCF)                                               |   ⚡    | `CascadedShadowGenerator` falls back to single cascade                                                   |
-| Meshes & geometry (class chain, `MeshBuilder` primitives, transforms, thin instances, `VertexData`)     |   ⚡    | `CreateLines`/`CreateDecal`/`CreateText`, `InstancedMesh`, LOD/edges/outline, clone/instance unsupported |
-| CSG / CSG2                                                                                              |   ✅    | over Lite boolean ops                                                                                    |
-| Gizmos (position/rotation/scale/bounding-box/light/camera + `GizmoManager`)                             |   ⚡    | over Lite gizmo suite                                                                                    |
-| Materials (`StandardMaterial`, `PBRMaterial`, metallic-rough / spec-gloss, `NodeMaterial`)              |   ⚡    | `ShaderMaterial` (GLSL), `MultiMaterial`, `BackgroundMaterial` unsupported                               |
-| Textures (`Texture`, `RawTexture`, `DynamicTexture`, `CubeTexture`)                                     |   ⚡    | `HDRCubeTexture` / `RenderTargetTexture` / `MirrorTexture` unsupported                                   |
-| Animation (keyframe `Animation`, easing, `Animatable`, `AnimationGroup` incl. weighted/additive blend)  |   ⚡    | CPU evaluation; loaded glTF skeletal blending supported                                                  |
-| Morph targets (`MorphTarget` / `MorphTargetManager`)                                                    |   ✅    | over Lite morph targets                                                                                  |
-| Sprites (`SpriteManager` / `Sprite`)                                                                    |   ⚡    | camera-facing billboards; `SpriteMap` / packed atlas unsupported                                         |
-| Behaviors / Actions (`AutoRotation`, `Framing`, `ActionManager`, conditions)                            |   ⚡    | `ActionManager` is manual-dispatch; drag behaviors need Lite core                                        |
-| Misc (`Observable`, `Tools`, `SmartArray`, `Tags`, gradients, `PerformanceMonitor`)                     |   ✅    |                                                                                                          |
-| Particles, post-processes, layers (glow/highlight), probes, physics, audio, WebXR                       |   ❌    | not in Babylon Lite — use native Lite `create*Task` / Havok-V2 functions                                 |
+| Math (`Vector*`, `Color*`, `Quaternion`, `Matrix`, `Plane`, `Ray`, `Frustum`, `Scalar`, `Axis`/`Space`) |   ✅   | `Angle` / `Curve3` / `Path3D` partial                                                                    |
+| Engine (`WebGPUEngine`, `Engine`, `ThinEngine`, `NullEngine`)                                           |   ⚡   | async startup + render loop; `beginFrame`/`endFrame` and manual `scene.render()` unsupported             |
+| Scene (clear color, cameras/lights, fog, environment, observables, ready state)                         |   ⚡   | sync `scene.pick` unsupported (use async `GPUPicker`); some scene enumeration needs Lite core            |
+| Cameras (`ArcRotateCamera`, `FreeCamera`/`Universal`/`Target`, `FollowCamera`, `GeospatialCamera`)      |   ✅   | XR / device-orientation / stereoscopic rigs unsupported                                                  |
+| Lights (`Hemispheric`, `Directional`, `Point`, `Spot`)                                                  |   ✅   | `RectAreaLight` / clustered lights unsupported                                                           |
+| Shadows (`ShadowGenerator` directional ESM/PCF, spot PCF)                                               |   ⚡   | `CascadedShadowGenerator` falls back to single cascade                                                   |
+| Meshes & geometry (class chain, `MeshBuilder` primitives, transforms, thin instances, `VertexData`)     |   ⚡   | `CreateLines`/`CreateDecal`/`CreateText`, `InstancedMesh`, LOD/edges/outline, clone/instance unsupported |
+| CSG / CSG2                                                                                              |   ✅   | over Lite boolean ops                                                                                    |
+| Gizmos (position/rotation/scale/bounding-box/light/camera + `GizmoManager`)                             |   ⚡   | over Lite gizmo suite                                                                                    |
+| Materials (`StandardMaterial`, `PBRMaterial`, metallic-rough / spec-gloss, `NodeMaterial`)              |   ⚡   | `ShaderMaterial` (GLSL), `MultiMaterial`, `BackgroundMaterial` unsupported                               |
+| Textures (`Texture`, `RawTexture`, `DynamicTexture`, `CubeTexture`)                                     |   ⚡   | `HDRCubeTexture` / `RenderTargetTexture` / `MirrorTexture` unsupported                                   |
+| Animation (keyframe `Animation`, easing, `Animatable`, `AnimationGroup` incl. weighted/additive blend)  |   ⚡   | CPU evaluation; loaded glTF skeletal blending supported                                                  |
+| Morph targets (`MorphTarget` / `MorphTargetManager`)                                                    |   ✅   | over Lite morph targets                                                                                  |
+| Sprites (`SpriteManager` / `Sprite`)                                                                    |   ⚡   | camera-facing billboards; `SpriteMap` / packed atlas unsupported                                         |
+| Behaviors / Actions (`AutoRotation`, `Framing`, `ActionManager`, conditions)                            |   ⚡   | `ActionManager` is manual-dispatch; drag behaviors need Lite core                                        |
+| Misc (`Observable`, `Tools`, `SmartArray`, `Tags`, gradients, `PerformanceMonitor`)                     |   ✅   |                                                                                                          |
+| Particles, post-processes, layers (glow/highlight), probes, physics, audio, WebXR                       |   ❌   | not in Babylon Lite — use native Lite `create*Task` / Havok-V2 functions                                 |
 
 ### `@babylonjs/loaders`
 
 | Feature area                                                                                   | Status | Notes                                                           |
 | ---------------------------------------------------------------------------------------------- | :----: | --------------------------------------------------------------- |
-| glTF 2.0 (+ extensions), `.babylon`                                                            |   ✅    | via Lite `loadGltf` / `loadBabylon`                             |
-| `SceneLoader` (`ImportMeshAsync` / `AppendAsync` / `LoadAssetContainerAsync`), `AssetsManager` |   ⚡    | `AssetContainer` partial                                        |
-| Gaussian Splatting (`.ply` / `.splat` / `.sog` / `.spz`)                                       |   ⚡    | via `GaussianSplattingMesh`; LOD-streaming variants unsupported |
-| `OBJ` / `STL` / `FBX` / `BVH`                                                                  |   ❌    | not in Lite — convert to glTF                                   |
+| glTF 2.0 (+ extensions), `.babylon`                                                            |   ✅   | via Lite `loadGltf` / `loadBabylon`                             |
+| `SceneLoader` (`ImportMeshAsync` / `AppendAsync` / `LoadAssetContainerAsync`), `AssetsManager` |   ⚡   | `AssetContainer` partial                                        |
+| Gaussian Splatting (`.ply` / `.splat` / `.sog` / `.spz`)                                       |   ⚡   | via `GaussianSplattingMesh`; LOD-streaming variants unsupported |
+| `OBJ` / `STL` / `FBX` / `BVH`                                                                  |   ❌   | not in Lite — convert to glTF                                   |
 
 ### `@babylonjs/addons` · `@recast-navigation/*`
 
-| Feature area                                                     | Status | Notes                            |
-| ---------------------------------------------------------------- | :----: | -------------------------------- |
-| `RecastJSPlugin` (navmesh, crowd, path, raycast, off-mesh links, tile-cache obstacles) |   ✅    | over Lite's native Recast-V2 API |
+| Feature area                                                                           | Status | Notes                            |
+| -------------------------------------------------------------------------------------- | :----: | -------------------------------- |
+| `RecastJSPlugin` (navmesh, crowd, path, raycast, off-mesh links, tile-cache obstacles) |   ✅   | over Lite's native Recast-V2 API |
 
 ### `@babylonjs/materials`
 
 | Feature area      | Status | Notes                                                                                          |
 | ----------------- | :----: | ---------------------------------------------------------------------------------------------- |
-| Library materials |   ⚡    | mapped onto the compat material surface where a Lite equivalent exists; unsupported ones throw |
+| Library materials |   ⚡   | mapped onto the compat material surface where a Lite equivalent exists; unsupported ones throw |
 
 > Specifiers outside the supported surface (e.g. `@babylonjs/gui`,
 > `@babylonjs/inspector`) are left untouched by the bundler plugins and resolve to

package/index.d.ts

@@ -764,7 +764,6 @@ export declare class Color4 {
     add(other: Color4): Color4;
     clone(): Color4;
     equals(other: Color4): boolean;
-    toColor3(): Color3;
     asArray(): [number, number, number, number];
     static FromArray(array: ArrayLike<number>, offset?: number): Color4;
     static FromInts(r: number, g: number, b: number, a: number): Color4;
@@ -1544,6 +1543,15 @@ export declare class Matrix {
     invert(): Matrix;
     invertToRef(result: Matrix): Matrix;
     getTranslation(): Vector3;
+    /**
+     * Babylon.js `Matrix.decompose(scale?, rotation?, translation?)` — split this
+     * TRS matrix into its scale, rotation (quaternion), and translation parts,
+     * writing into any provided out-params. Returns `false` (matching BJS) when a
+     * scale axis is zero. The rotation extraction is backed by Lite's
+     * `quatFromRotationMatrix` (via `Quaternion.FromRotationMatrixToRef`); the
+     * negative-determinant `scale.y` flip matches Babylon.js exactly.
+     */
+    decompose(scale?: Vector3, rotation?: Quaternion, translation?: Vector3): boolean;
     static FromValues(m0: number, m1: number, m2: number, m3: number, m4: number, m5: number, m6: number, m7: number, m8: number, m9: number, m10: number, m11: number, m12: number, m13: number, m14: number, m15: number): Matrix;
     static FromArray(array: ArrayLike<number>, offset?: number): Matrix;
     static Identity(): Matrix;
@@ -2164,11 +2172,26 @@ export declare class Quaternion {
     length(): number;
     normalize(): this;
     conjugate(): Quaternion;
+    /**
+     * Babylon.js `Quaternion.fromRotationMatrix` — update this quaternion in place
+     * from the rotation part of `matrix`. Backed by Lite's `quatFromRotationMatrix`.
+     */
+    fromRotationMatrix(matrix: Matrix): this;
     clone(): Quaternion;
     equals(other: Quaternion): boolean;
     asArray(): [number, number, number, number];
     toEulerAngles(): Vector3;
     static Identity(): Quaternion;
+    /**
+     * Babylon.js `Quaternion.FromRotationMatrix` — create a new quaternion from the
+     * rotation part of `matrix`. Backed by Lite's `quatFromRotationMatrix`.
+     */
+    static FromRotationMatrix(matrix: Matrix): Quaternion;
+    /**
+     * Babylon.js `Quaternion.FromRotationMatrixToRef` — write the rotation part of
+     * `matrix` into `result`. Backed by Lite's `quatFromRotationMatrix`.
+     */
+    static FromRotationMatrixToRef(matrix: Matrix, result: Quaternion): Quaternion;
     static FromEulerAngles(x: number, y: number, z: number): Quaternion;
     static RotationYawPitchRoll(yaw: number, pitch: number, roll: number): Quaternion;
     static RotationAxis(axis: Vector3, angle: number): Quaternion;
@@ -3035,6 +3058,10 @@ export declare class Vector3 {
     scale(scale: number): Vector3;
     scaleInPlace(scale: number): this;
     negate(): Vector3;
+    minimizeInPlace(other: Vector3): this;
+    maximizeInPlace(other: Vector3): this;
+    minimizeInPlaceFromFloats(x: number, y: number, z: number): this;
+    maximizeInPlaceFromFloats(x: number, y: number, z: number): this;
     length(): number;
     lengthSquared(): number;
     normalize(): this;
@@ -3052,22 +3079,31 @@ export declare class Vector3 {
     static Right(): Vector3;
     static Left(): Vector3;
     static FromArray(array: ArrayLike<number>, offset?: number): Vector3;
+    static FromArrayToRef<T extends Vector3>(array: ArrayLike<number>, offset: number, result: T): T;
+    static FromFloatsToRef<T extends Vector3>(x: number, y: number, z: number, result: T): T;
     static Dot(a: Vector3, b: Vector3): number;
     static Cross(a: Vector3, b: Vector3): Vector3;
+    static CrossToRef<T extends Vector3>(a: Vector3, b: Vector3, result: T): T;
     static Distance(a: Vector3, b: Vector3): number;
     static DistanceSquared(a: Vector3, b: Vector3): number;
     static Lerp(start: Vector3, end: Vector3, amount: number): Vector3;
+    static LerpToRef<T extends Vector3>(start: Vector3, end: Vector3, amount: number, result: T): T;
     /** Midpoint between two vectors. */
     static Center(a: Vector3, b: Vector3): Vector3;
     /** Midpoint between two vectors, written into `ref`. */
     static CenterToRef(a: Vector3, b: Vector3, ref: Vector3): Vector3;
     static Normalize(vector: Vector3): Vector3;
+    static NormalizeToRef<T extends Vector3>(vector: Vector3, result: T): T;
     static Minimize(a: Vector3, b: Vector3): Vector3;
     static Maximize(a: Vector3, b: Vector3): Vector3;
     /** Transform a coordinate (point) by a matrix using the row-vector convention. */
     static TransformCoordinates(vector: Vector3, transformation: Matrix): Vector3;
+    /** Transform a coordinate (point) by a matrix using the row-vector convention. */
+    static TransformCoordinatesToRef<T extends Vector3>(vector: Vector3, transformation: Matrix, result: T): T;
     /** Transform a direction (normal) by a matrix, ignoring translation. */
     static TransformNormal(vector: Vector3, transformation: Matrix): Vector3;
+    /** Transform a direction (normal) by a matrix, ignoring translation. */
+    static TransformNormalToRef<T extends Vector3>(vector: Vector3, transformation: Matrix, result: T): T;
 }
 
 export declare class Vector4 {

package/index.js

@@ -1,8 +1,8 @@
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-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 } from "./meshes-BQZyNGmT.js";
-import { A, C, b, c, d, e, f, g, G, I, h, Q, i, j, k, m, t, n } from "./meshes-BQZyNGmT.js";
+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 } from "./meshes-a59_KvbH.js";
+import { A, C, b, c, d, e, f, g, G, I, h, Q, i, j, k, m, t, n } from "./meshes-a59_KvbH.js";
 import { createEngine, onBeforeRender, stopEngine, resizeEngine, setEngineSize, disposeEngine, registerSceneWithShadowSupport, registerScene, startEngine, createArcRotateCamera, attachControl, getCameraPosition, getViewMatrix, getProjectionMatrix, createGeospatialCamera, setGeospatialOrientation, attachGeospatialControls, createFreeCamera, attachFreeControl, markMaterialUboDirty, createPbrMaterial, createSolidTexture2D, createStandardMaterial, setAnimationAdditive, playAnimation, pauseAnimation, goToFrame, stopAnimation, createSceneContext, updateAnimationManager, setFog, setClipPlane, 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, 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 } from "@babylonjs/lite";
 class Color3 {
   constructor(r = 0, g2 = 0, b2 = 0) {
@@ -122,9 +122,6 @@ class Color4 {
   equals(other) {
     return this.r === other.r && this.g === other.g && this.b === other.b && this.a === other.a;
   }
-  toColor3() {
-    return new Color3(this.r, this.g, this.b);
-  }
   asArray() {
     return [this.r, this.g, this.b, this.a];
   }
@@ -2135,7 +2132,7 @@ class AnimationGroup {
   get animatables() {
     if (this._lite) {
       const frameRate = this._lite.frameRate ?? 60;
-      return [{ masterFrame: this._lite.currentFrame * frameRate }];
+      return [{ masterFrame: this._lite.currentTime * frameRate }];
     }
     return [];
   }
@@ -2160,7 +2157,7 @@ class AnimationGroup {
     if (this._lite) {
       const frameRate = this._lite.frameRate ?? 60;
       if (from !== void 0) {
-        this._lite.currentFrame = from / frameRate;
+        this._lite.currentTime = from / frameRate;
       }
       this._lite.speedRatio = speedRatio;
       this._lite.loopAnimation = loop;