@babylonjs/lite-compat 1.37.1-preview → 1.37.2-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
@@ -122,7 +122,7 @@ overloads within a supported area may still be absent.
122
122
  | Compute + GPU buffers (`ComputeShader`, `StorageBuffer`, `UniformBuffer`) | ⚡ | WGSL compute, direct/indirect dispatch, storage buffers, and compute-oriented std140 uniform buffers forward to Lite; shader registries/preprocessing, texture bindings, in-frame immediate dispatch, and Effect-oriented UBO methods remain unsupported |
123
123
  | Scene (clear color, cameras/lights, fog, environment, observables, ready state) | ⚡ | `Node.accessibilityTag` forwards description, role, and ARIA metadata to Lite (DOM event handlers remain unsupported); sync `scene.pick` forwards to Lite's CPU triangle picker with thin-instance, predicate, normal, and UV detail; `scene.meshes` + `getMeshBy*`/`getNodeBy*` enumerate every mesh via a canonical wrapper registry; exposure/contrast/tone mapping are forwarded, while white balance and fluid rendering throw because Lite lacks their cross-cutting shader/render-pass subsystems |
124
124
  | Cameras (`ArcRotateCamera`, `FreeCamera`/`Universal`/`Target`, `FollowCamera`, `GeospatialCamera`) | ✅ | arc controls include pointer, wheel, touch, and BJS-default Arrow-key input; orthographic bounds and projection-mode switching forward to Lite; fully unconfigured orthographic extents use Lite's `halfHeight` + aspect-ratio derivation rather than Babylon.js render dimensions; XR / device-orientation / stereoscopic rigs unsupported |
125
- | Lights (`Hemispheric`, `Directional`, `Point`, `Spot`) | ✅ | `ClusteredLightContainer` clusters unshadowed point lights before engine start (⚡ partial); clustered spot lights and `RectAreaLight` unsupported |
125
+ | Lights (`Hemispheric`, `Directional`, `Point`, `Spot`, `RectAreaLight`) | ⚡ | rectangular area lights use Lite's native LTC path, including `AreaLightTextureTools` emission preprocessing; Lite is stricter for invalid negative/non-finite emitter dimensions. `ClusteredLightContainer` clusters unshadowed point lights before engine start (⚡ partial), while clustered spot lights remain unsupported |
126
126
  | Shadows (`ShadowGenerator` directional ESM/PCF, spot PCF) | ⚡ | `CascadedShadowGenerator` uses Lite's native 2–4 cascade CSM |
127
127
  | 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; mesh-blending tag helpers and validated mesh metadata forward to native Lite; `MergeMeshes` bakes positions/normals/UVs and rejects unsupported attributes/animation; polygon/extruded-polygon, decal/text/tiled builders, `GreasedLine*` (thick lines), `InstancedMesh`, LOD/edges/outline, and hardware instances unsupported |
128
128
  | CSG / CSG2 | ✅ | over Lite boolean ops |
@@ -149,7 +149,7 @@ overloads within a supported area may still be absent.
149
149
  | OpenPBR glTF material adapter | ❌ | exported at root and under `GLTF2`; throws because Lite has no OpenPBR material subsystem |
150
150
  | OpenUSD (`USDFileLoader`) | ⚡ | delegates binary import, virtual files, callbacks, diagnostics, asset containers, and disposal to Lite; all four custom runtime assets must share one directory |
151
151
  | `SceneLoader` (`ImportMeshAsync` / `AppendAsync` / `LoadAssetContainerAsync`), `AssetsManager` | ⚡ | `AssetContainer` partial |
152
- | Gaussian Splatting (`.ply` / `.splat` / `.sog` / `.spz`) | ⚡ | `GaussianSplattingMesh` wraps eager Lite loaders; BJS streaming (including range residency) and the separate stochastic WebGPU point-splatting compute path resolve to named stubs because their budget, pass-lifecycle, and rendering models do not map to Lite's sorted-splat renderer |
152
+ | Gaussian Splatting (`.ply` / `.splat` / `.sog` / `.spz`) | ⚡ | `GaussianSplattingMesh` wraps eager Lite loaders and Lite's opt-in point renderer; point render scale supports `"auto"` or exact `1 / n` multipliers for divisors 1–8. BJS streaming and standalone point-renderer/blit classes remain named stubs |
153
153
  | `OBJ` / `STL` / `FBX` / `BVH` | ❌ | parser/materializer subsystems are not in Lite — convert to glTF |
154
154
 
155
155
  > **glTF hierarchy:** `result.meshes` is a flattened view of the glTF node hierarchy (transform nodes plus the
package/index.d.ts CHANGED
@@ -125,6 +125,7 @@ export declare abstract class AbstractEngine {
125
125
  protected readonly _scenes: Scene[];
126
126
  protected readonly _loopCallbacks: Array<() => void>;
127
127
  protected _initialized: boolean;
128
+ private _disposed;
128
129
  private _startupComplete;
129
130
  private _startPromise;
130
131
  /**
131
132
  * Babylon.js `engine.useReverseDepthBuffer`. Babylon Lite owns its depth
@@ -838,6 +839,21 @@ export declare class ArcRotateCamera extends Camera {
838
839
  constructor(name: stri
839
840
  set panningSensibility(value: number);
840
841
  attachControl(canvas: HTMLCanvasElement, noPreventDefault?: boolean): void;
841
842
 
843
+ /** Babylon.js `AreaLight` hierarchy node shared by rectangular area lights. */
844
+ export declare abstract class AreaLight extends Light {
845
+ protected constructor(name: string, scene?: Scene, dontAddToScene?: boolean);
846
+ abstract get position(): Vector3;
847
+ abstract set position(value: Vector3);
848
+ }
849
+
850
+ /** Babylon.js `AreaLightTextureTools` forwarding to Lite's native emission-image processor. */
851
+ export declare class AreaLightTextureTools {
842
852
  constructor(engine: AbstractEngine);
853
+ get shaderLanguage(): ShaderLanguage;
854
+ isReady(): boolean;
855
+ processAsync(source: BaseTexture): Promise<BaseTexture | null>;
856
+ dispose(): void;
857
+ }
858
+
843
859
  export declare class AssetContainer {
844
860
  private readonly _dispose;
845
861
  private _sceneDisposeObserver;
846
862
  private _disposed;
847
863
  constructor(lite: AssetContainer_2, dispose?: () => void, ownedMeshes?: readonly Mesh_2[]);
@@ -1806,11 +1822,49 @@ export declare class DepthRenderer {
1806
1822
  constructor();
1807
1823
  }
1808
1824
 
1825
+ export declare type DeviceInput<T extends DeviceType> = T extends DeviceType.Keyboard | DeviceType.Generic ? number : T extends DeviceType.Mouse | DeviceType.Touch ? Exclude<PointerInput, PointerInput.Move | PointerInput.MouseWheelX | PointerInput.MouseWheelY | PointerInput.MouseWheelZ> : T extends DeviceType.DualShock ? DualShockInput : T extends DeviceType.Xbox ? XboxInput : T extends DeviceType.Switch ? SwitchInput : T extends DeviceType.DualSense ? DualSenseInput : never;
1826
+
1827
+ export declare const enum DeviceInputEventType {
1828
+ PointerMove = 0,
1829
+ PointerDown = 1,
1830
+ PointerUp = 2
1831
+ }
1832
+
1809
1833
  /** Babylon.js `DeviceOrientationCamera` — device-orientation input is not available in Babylon Lite. */
1810
1834
  export declare class DeviceOrientationCamera {
1811
1835
  constructor();
1812
1836
  }
1813
1837
 
1838
+ export declare class DeviceSource<T extends DeviceType> {
1839
+ readonly deviceType: T;
1840
+ readonly deviceSlot: number;
1841
+ readonly onInputChangedObservable: Observable<DeviceSourceEvent<T>>;
1842
+ constructor(_deviceInputSystem: unknown, deviceType: T, deviceSlot?: number);
1843
+ getInput(_inputIndex: DeviceInput<T>): number;
1844
+ }
1845
+
1846
+ export declare type DeviceSourceEvent<T extends DeviceType> = T extends DeviceType.Keyboard ? IKeyboardEvent : T extends DeviceType.Mouse ? IWheelEvent | IPointerEvent : T extends DeviceType.Touch ? IPointerEvent : never;
1847
+
1848
+ export declare class DeviceSourceManager {
1849
+ readonly onDeviceConnectedObservable: Observable<DeviceSource<DeviceType>>;
1850
+ readonly onDeviceDisconnectedObservable: Observable<DeviceSource<DeviceType>>;
1851
+ constructor(_engine: AbstractEngine);
1852
+ getDeviceSource<T extends DeviceType>(_deviceType: T, _deviceSlot?: number): DeviceSource<T> | null;
1853
+ getDeviceSources<T extends DeviceType>(_deviceType: T): ReadonlyArray<DeviceSource<T>>;
1854
+ dispose(): void;
1855
+ }
1856
+
1857
+ export declare enum DeviceType {
1858
+ Generic = 0,
1859
+ Keyboard = 1,
1860
+ Mouse = 2,
1861
+ Touch = 3,
1862
+ DualShock = 4,
1863
+ Xbox = 5,
1864
+ Switch = 6,
1865
+ DualSense = 7
1866
+ }
1867
+
1814
1868
  export declare class DirectionalLight extends Light {
1815
1869
  constructor(name: string, direction: Vector3, scene?: Scene);
1816
1870
  getClassName(): string;
1817
1871
  get direction(): Vector3;
@@ -1864,6 +1918,56 @@ export { DragEvent_2 as DragEvent }
1864
1918
  /** Babylon.js drag start/end payload. */
1865
1919
  export declare type DragStartEndEvent = Pick<DragEvent_2, "dragPlanePoint" | "pointerId" | "pointerInfo">;
1866
1920
 
1921
+ export declare const enum DualSenseInput {
1922
+ Cross = 0,
1923
+ Circle = 1,
1924
+ Square = 2,
1925
+ Triangle = 3,
1926
+ L1 = 4,
1927
+ R1 = 5,
1928
+ L2 = 6,
1929
+ R2 = 7,
1930
+ Create = 8,
1931
+ Options = 9,
1932
+ L3 = 10,
1933
+ R3 = 11,
1934
+ DPadUp = 12,
1935
+ DPadDown = 13,
1936
+ DPadLeft = 14,
1937
+ DPadRight = 15,
1938
+ Home = 16,
1939
+ TouchPad = 17,
1940
+ LStickXAxis = 18,
1941
+ LStickYAxis = 19,
1942
+ RStickXAxis = 20,
1943
+ RStickYAxis = 21
1944
+ }
1945
+
1946
+ export declare const enum DualShockInput {
1947
+ Cross = 0,
1948
+ Circle = 1,
1949
+ Square = 2,
1950
+ Triangle = 3,
1951
+ L1 = 4,
1952
+ R1 = 5,
1953
+ L2 = 6,
1954
+ R2 = 7,
1955
+ Share = 8,
1956
+ Options = 9,
1957
+ L3 = 10,
1958
+ R3 = 11,
1959
+ DPadUp = 12,
1960
+ DPadDown = 13,
1961
+ DPadLeft = 14,
1962
+ DPadRight = 15,
1963
+ Home = 16,
1964
+ TouchPad = 17,
1965
+ LStickXAxis = 18,
1966
+ LStickYAxis = 19,
1967
+ RStickXAxis = 20,
1968
+ RStickYAxis = 21
1969
+ }
1970
+
1867
1971
  /**
1868
1972
  * Babylon.js `DynamicTexture` — a canvas-backed texture. Draw into
1869
1973
  * `getContext()`, then call `update()` to upload the canvas pixels to the GPU.
@@ -2001,6 +2105,12 @@ export declare interface EngineOptions extends AbstractEngineOptions {
2001
2105
  /** Babylon.js-compatible scalar helpers and a small set of math constants. */
2002
2106
  export declare const Epsilon = 0.001;
2003
2107
 
2108
+ export declare class EventConstants {
2109
+ static DOM_DELTA_PIXEL: number;
2110
+ static DOM_DELTA_LINE: number;
2111
+ static DOM_DELTA_PAGE: number;
2112
+ }
2113
+
2004
2114
  /** Runs a user callback when triggered. */
2005
2115
  export declare class ExecuteCodeAction extends Action {
2006
2116
  private readonly _func;
@@ -3303,6 +3413,18 @@ export declare interface IInstallHtmlInCanvasPolyfillOptions {
3303
3413
  [key: string]: unknown;
3304
3414
  }
3305
3415
 
3416
+ export declare interface IKeyboardEvent extends IUIEvent {
3417
+ altKey: boolean;
3418
+ charCode?: number;
3419
+ code: string;
3420
+ ctrlKey: boolean;
3421
+ key: string;
3422
+ keyCode: number;
3423
+ metaKey: boolean;
3424
+ shiftKey: boolean;
3425
+ repeat?: boolean;
3426
+ }
3427
+
3306
3428
  /**
3307
3429
  * Minimal Babylon.js `ImageProcessingConfiguration` facade over Lite's image
3308
3430
  * processing state.
@@ -3358,6 +3480,33 @@ export declare interface IMeshBlendRadiusDefinition {
3358
3480
  minimumProjectedRadius: number;
3359
3481
  }
3360
3482
 
3483
+ export declare interface IMouseEvent extends IUIEvent {
3484
+ inputIndex: Exclude<PointerInput, PointerInput.Horizontal | PointerInput.Vertical>;
3485
+ altKey: boolean;
3486
+ button: number;
3487
+ buttons: number;
3488
+ clientX: number;
3489
+ clientY: number;
3490
+ ctrlKey: boolean;
3491
+ detail?: number;
3492
+ metaKey: boolean;
3493
+ movementX: number;
3494
+ movementY: number;
3495
+ mozMovementX?: number;
3496
+ mozMovementY?: number;
3497
+ msMovementX?: number;
3498
+ msMovementY?: number;
3499
+ offsetX: number;
3500
+ offsetY: number;
3501
+ pageX: number;
3502
+ pageY: number;
3503
+ shiftKey: boolean;
3504
+ webkitMovementX?: number;
3505
+ webkitMovementY?: number;
3506
+ x: number;
3507
+ y: number;
3508
+ }
3509
+
3361
3510
  /** Babylon.js `ImportMeshAsync(source, scene, options?)` — imports an asset into the scene. */
3362
3511
  export declare function ImportMeshAsync(source: string, scene: Scene, options?: ImportMeshOptions): Promise<ImportResult>;
3363
3512
 
@@ -3400,6 +3549,12 @@ export declare class InterpolatingBehavior {
3400
3549
  constructor();
3401
3550
  }
3402
3551
 
3552
+ export declare interface IPointerEvent extends IMouseEvent {
3553
+ inputIndex: Exclude<PointerInput, PointerInput.Horizontal | PointerInput.Vertical | PointerInput.MouseWheelX | PointerInput.MouseWheelY | PointerInput.MouseWheelZ>;
3554
+ pointerId: number;
3555
+ pointerType: string;
3556
+ }
3557
+
3403
3558
  /** Babylon.js raycast collision-filter options. */
3404
3559
  export declare interface IRaycastQuery {
3405
3560
  membership?: number;
@@ -3606,6 +3761,15 @@ export declare interface IThinMeshBlendingPostProcessOptions extends IMeshBlendC
3606
3761
  [key: string]: unknown;
3607
3762
  }
3608
3763
 
3764
+ export declare interface IUIEvent {
3765
+ inputIndex: number;
3766
+ currentTarget?: any;
3767
+ srcElement?: any;
3768
+ type: string;
3769
+ target: any;
3770
+ preventDefault: () => void;
3771
+ }
3772
+
3609
3773
  /** Babylon.js `IUploadImageToTexture2DArrayLayerOptions`. */
3610
3774
  export declare interface IUploadImageToTexture2DArrayLayerOptions {
3611
3775
  /** Store the source with the Y axis inverted (false by default). */
@@ -3634,6 +3798,15 @@ export declare interface IWebAudioEngineOptions extends IAudioEngineV2Options {
3634
3798
  disableIOSRingerSwitchWorkaround?: boolean;
3635
3799
  }
3636
3800
 
3801
+ export declare interface IWheelEvent extends IMouseEvent {
3802
+ inputIndex: PointerInput.MouseWheelX | PointerInput.MouseWheelY | PointerInput.MouseWheelZ;
3803
+ deltaMode: number;
3804
+ deltaX: number;
3805
+ deltaY: number;
3806
+ deltaZ: number;
3807
+ wheelDelta?: number;
3808
+ }
3809
+
3637
3810
  /**
3638
3811
  * Babylon.js `KHR_materials_variants` extension helpers. Mirrors the static
3639
3812
  * surface ported code calls (`SelectVariant` / `GetAvailableVariants` / `Reset`)
@@ -3656,7 +3829,7 @@ export declare class Layer {
3656
3829
  }
3657
3830
 
3658
3831
  /** Babylon.js `Light` — base class for all lights (derives from `Node`). */
3659
- export declare abstract class Light extends Node_2 {
3660
3832
  protected constructor(name: string, scene?: Scene);
3833
+ export declare abstract class Light extends Node_2 {
3661
3834
  protected constructor(name: string, scene?: Scene, dontAddToScene?: boolean);
3662
3835
  getClassName(): string;
3663
3836
  /**
3664
3837
  * Babylon.js `light.intensity`. While the light is disabled the Lite light
3665
3838
  * carries `0`, but the getter still returns the logical value the caller set.
@@ -5090,6 +5263,20 @@ export declare class PointerInfo {
5090
5263
  get pickInfo(): PickingInfo | null;
5091
5264
  }
5092
5265
 
5266
+ export declare enum PointerInput {
5267
+ Horizontal = 0,
5268
+ Vertical = 1,
5269
+ LeftClick = 2,
5270
+ MiddleClick = 3,
5271
+ RightClick = 4,
5272
+ BrowserBack = 5,
5273
+ BrowserForward = 6,
5274
+ MouseWheelX = 7,
5275
+ MouseWheelY = 8,
5276
+ MouseWheelZ = 9,
5277
+ Move = 12
5278
+ }
5279
+
5093
5280
  export declare class PointLight extends Light {
5094
5281
  constructor(name: string, position: Vector3, scene?: Scene);
5095
5282
  getClassName(): string;
5096
5283
  get range(): number;
@@ -5415,9 +5602,22 @@ export declare class RecastJSPlugin {
5415
5602
  constructor();
5416
5603
  }
5417
5604
 
5418
- export declare class RectAreaLight {
5419
- constructor();
5420
- }
5605
+ /** Babylon.js `RectAreaLight` over Lite's native LTC-backed rectangular emitter. */
5606
+ export declare class RectAreaLight extends AreaLight {
5421
5607
  constructor(name: string, position: Vector3, width: number, height: number, scene?: Scene, dontAddToScene?: boolean);
5608
+ getClassName(): string;
5609
+ getTypeID(): number;
5610
+ get position(): Vector3;
5611
+ set position(value: Vector3);
5612
+ get width(): number;
5613
+ set width(value: number);
5614
+ get height(): number;
5615
+ set height(value: number);
5616
+ get diffuse(): Color3;
5617
+ set diffuse(value: Color3);
5618
+ get specular(): Color3;
5619
+ set specular(value: Color3);
5620
+ get emissionTexture(): BaseTexture | null;
5621
+ set emissionTexture(value: BaseTexture | null);
5422
5622
 
5423
5623
  export declare class ReflectionProbe {
5424
5624
  constructor();
@@ -6335,6 +6535,8 @@ export declare class StandardMaterial extends PushMaterial {
6335
6535
  /** Diffuse col
6336
6536
  set diffuseColor(value: Color3);
6337
6537
  get specularColor(): Color3;
6338
6538
  set specularColor(value: Color3);
6539
+ get roughness(): number;
6540
+ set roughness(value: number);
6339
6541
  get emissiveColor(): Color3;
6340
6542
  set emissiveColor(value: Color3);
6341
6543
  get ambientColor(): Color3;
@@ -6502,6 +6704,31 @@ export declare class SurfaceMagnetismBehavior {
6502
6704
  constructor();
6503
6705
  }
6504
6706
 
6707
+ export declare const enum SwitchInput {
6708
+ B = 0,
6709
+ A = 1,
6710
+ Y = 2,
6711
+ X = 3,
6712
+ L = 4,
6713
+ R = 5,
6714
+ ZL = 6,
6715
+ ZR = 7,
6716
+ Minus = 8,
6717
+ Plus = 9,
6718
+ LS = 10,
6719
+ RS = 11,
6720
+ DPadUp = 12,
6721
+ DPadDown = 13,
6722
+ DPadLeft = 14,
6723
+ DPadRight = 15,
6724
+ Home = 16,
6725
+ Capture = 17,
6726
+ LStickXAxis = 18,
6727
+ LStickYAxis = 19,
6728
+ RStickXAxis = 20,
6729
+ RStickYAxis = 21
6730
+ }
6731
+
6505
6732
  declare interface Taggable {
6506
6733
  _tags?: Record<string, true>;
6507
6734
  }
@@ -7102,4 +7329,28 @@ export declare class WeightedSound {
7102
7329
  constructor();
7103
7330
  }
7104
7331
 
7332
+ export declare const enum XboxInput {
7333
+ A = 0,
7334
+ B = 1,
7335
+ X = 2,
7336
+ Y = 3,
7337
+ LB = 4,
7338
+ RB = 5,
7339
+ LT = 6,
7340
+ RT = 7,
7341
+ Back = 8,
7342
+ Start = 9,
7343
+ LS = 10,
7344
+ RS = 11,
7345
+ DPadUp = 12,
7346
+ DPadDown = 13,
7347
+ DPadLeft = 14,
7348
+ DPadRight = 15,
7349
+ Home = 16,
7350
+ LStickXAxis = 17,
7351
+ LStickYAxis = 18,
7352
+ RStickXAxis = 19,
7353
+ RStickYAxis = 20
7354
+ }
7355
+
7105
7356
  export { }